:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
import type { CommonConfig } from '~/common/config'
import { GroupRepository } from '~/common/groups/repositories/group-repository.interface'
import { PersonRepository } from '~/common/persons/repositories/person-repository'
import { logger } from '~/common/utils/logger'
import { PersonHogClient, parseRolloutTeamIds } from './client'
import { PersonHogGroupRepository } from './personhog-group-repository'
import { PersonHogPersonRepository } from './personhog-person-repository'
export { PersonHogClient } from './client'
export type { PersonHogClientConfig } from './client'
export { PersonHogGroupRepository } from './personhog-group-repository'
export { PersonHogPersonRepository } from './personhog-person-repository'
/** PersonHog gRPC client config */
export type PersonHogConfig = Pick<
CommonConfig,
| 'PERSONHOG_ENABLED'
| 'PERSONHOG_ADDR'
| 'PERSONHOG_IDENTITY_ADDR'
| 'PERSONS_STORE_MODE'
| 'PERSONHOG_GROUPS_ROLLOUT_PERCENTAGE'
| 'PERSONHOG_GROUPS_ROLLOUT_TEAM_IDS'
| 'PERSONHOG_PERSONS_ROLLOUT_PERCENTAGE'
| 'PERSONHOG_PERSONS_ROLLOUT_TEAM_IDS'
| 'PERSONHOG_TLS'
| 'PERSONHOG_TIMEOUT_MS'
| 'PERSONHOG_IDENTITY_TIMEOUT_MS'
| 'PERSONHOG_MERGE_TIMEOUT_MS'
| 'PERSONHOG_READ_MAX_BYTES'
| 'PERSONHOG_WRITE_MAX_BYTES'
| 'PERSONHOG_PING_INTERVAL_MS'
| 'PERSONHOG_PING_TIMEOUT_MS'
| 'PERSONHOG_PING_IDLE_CONNECTION'
| 'PERSONHOG_IDLE_CONNECTION_TIMEOUT_MS'
| 'PERSONHOG_STATE_MONITOR_POLL_INTERVAL_MS'
| 'PERSONHOG_INITIAL_STREAM_WINDOW_BYTES'
| 'PERSONHOG_INITIAL_CONNECTION_WINDOW_BYTES'
| 'PLUGIN_SERVER_MODE'
>
export function createPersonHogClient(config: PersonHogConfig): PersonHogClient | null {
if (!config.PERSONHOG_ENABLED || !config.PERSONHOG_ADDR) {
return null
}
logger.info('🔌', `PersonHog gRPC client connecting to ${config.PERSONHOG_ADDR}`)
return PersonHogClient.fromConfig({
addr: config.PERSONHOG_ADDR,
clientName: config.PLUGIN_SERVER_MODE ?? 'unknown',
useTls: config.PERSONHOG_TLS,
timeoutMs: config.PERSONHOG_TIMEOUT_MS,
readMaxBytes: config.PERSONHOG_READ_MAX_BYTES,
writeMaxBytes: config.PERSONHOG_WRITE_MAX_BYTES,
pingIntervalMs: config.PERSONHOG_PING_INTERVAL_MS,
pingTimeoutMs: config.PERSONHOG_PING_TIMEOUT_MS,
pingIdleConnection: config.PERSONHOG_PING_IDLE_CONNECTION,
idleConnectionTimeoutMs: config.PERSONHOG_IDLE_CONNECTION_TIMEOUT_MS,
stateMonitorPollIntervalMs: config.PERSONHOG_STATE_MONITOR_POLL_INTERVAL_MS,
initialStreamWindowBytes: config.PERSONHOG_INITIAL_STREAM_WINDOW_BYTES,
initialConnectionWindowBytes: config.PERSONHOG_INITIAL_CONNECTION_WINDOW_BYTES,
})
}
export function buildGroupRepository(
grpcClient: PersonHogClient | null,
postgresGroupRepository: GroupRepository,
rolloutPercentage: number,
rolloutTeamIdsRaw: string,
clientLabel: string
): GroupRepository {
const rolloutTeamIds = parseRolloutTeamIds(rolloutTeamIdsRaw)
if (grpcClient && (rolloutPercentage > 0 || rolloutTeamIds.size > 0)) {
logger.info(
'🔌',
`PersonHog gRPC (groups) rollout at ${rolloutPercentage}%` +
(rolloutTeamIds.size > 0 ? `, team IDs: [${[...rolloutTeamIds].join(', ')}]` : '')
)
return new PersonHogGroupRepository(
postgresGroupRepository,
grpcClient,
rolloutPercentage,
rolloutTeamIds,
clientLabel
)
}
return postgresGroupRepository
}
export function buildPersonRepository(
grpcClient: PersonHogClient | null,
postgresPersonRepository: PersonRepository,
rolloutPercentage: number,
rolloutTeamIdsRaw: string,
clientLabel: string
): PersonRepository {
const rolloutTeamIds = parseRolloutTeamIds(rolloutTeamIdsRaw)
if (grpcClient && (rolloutPercentage > 0 || rolloutTeamIds.size > 0)) {
logger.info(
'🔌',
`PersonHog gRPC (persons) rollout at ${rolloutPercentage}%` +
(rolloutTeamIds.size > 0 ? `, team IDs: [${[...rolloutTeamIds].join(', ')}]` : '')
)
return new PersonHogPersonRepository(
postgresPersonRepository,
grpcClient,
rolloutPercentage,
rolloutTeamIds,
clientLabel
)
}
return postgresPersonRepository
}