@posthog/convex 1.0.10 → 2.0.1

package/package.json

@@ -11,7 +11,7 @@
     "url": "https://github.com/PostHog/posthog-js/issues"
   },
   "author": "PostHog Inc.",
-  "version": "1.0.10",
+  "version": "2.0.1",
   "license": "MIT",
   "keywords": [
     "convex",
@@ -48,14 +48,14 @@
   "types": "./dist/client/index.d.ts",
   "module": "./dist/client/index.js",
   "dependencies": {
-    "@posthog/core": "1.29.12",
-    "posthog-node": "5.35.5"
+    "posthog-node": "5.35.6",
+    "@posthog/core": "1.29.13"
   },
   "devDependencies": {
     "@edge-runtime/vm": "^5.0.0",
     "@jest/globals": "^29.7.0",
     "@types/node": "^24.10.12",
-    "convex": "1.31.7",
+    "convex": "1.39.1",
     "convex-test": "0.0.41",
     "globals": "^17.3.0",
     "jest": "29.7.0",
@@ -64,12 +64,13 @@
     "vite": "7.3.1"
   },
   "peerDependencies": {
-    "convex": "^1.31.7"
+    "convex": "^1.39.0"
   },
   "scripts": {
     "prebuild": "node -p \"'export const version = \\'' + require('./package.json').version + '\\''\" > src/component/version.ts",
     "build": "tsc --project ./tsconfig.build.json",
-    "build:codegen": "npx convex codegen --component-dir ./src/component && pnpm build",
+    "setup:codegen": "test -f .env.local || npx convex dev --once --configure new --dev-deployment local --project posthog-convex-component --typecheck disable || true",
+    "build:codegen": "pnpm run setup:codegen && npx convex codegen --component-dir ./src/component --typecheck disable && pnpm build",
     "clean": "rm -rf dist *.tsbuildinfo && pnpm build:codegen",
     "typecheck": "tsc --noEmit",
     "lint": "eslint src",

package/src/client/index.test.ts

@@ -12,41 +12,25 @@ function mockSchedulerCtx() {
 }
 
 describe('PostHog client', () => {
-  test('constructor uses defaults from env', async () => {
-    process.env.POSTHOG_API_KEY = '  test-key\n'
-    process.env.POSTHOG_HOST = '  https://test.posthog.com\t '
-
-    const component = { lib: { capture: 'capture_ref' } }
-    const posthog = new PostHog(component as never)
-    const ctx = mockSchedulerCtx()
-
-    await posthog.capture(ctx as never, {
-      distinctId: 'user-1',
-      event: 'test-event',
-    })
-
-    const [, , args] = ctx.scheduler.runAfter.mock.calls[0]
-    expect(args.apiKey).toBe('test-key')
-    expect(args.host).toBe('https://test.posthog.com')
-
-    delete process.env.POSTHOG_API_KEY
-    delete process.env.POSTHOG_HOST
+  test('constructor accepts no options', () => {
+    const posthog = new PostHog({} as never)
+    expect(posthog).toBeInstanceOf(PostHog)
   })
 
-  test('constructor accepts explicit options', () => {
+  test('constructor accepts identify and beforeSend callbacks', () => {
     const posthog = new PostHog({} as never, {
-      apiKey: 'explicit-key',
-      host: 'https://custom.posthog.com',
+      identify: async () => null,
+      beforeSend: (event) => event,
     })
     expect(posthog).toBeInstanceOf(PostHog)
   })
 
-  test('trims apiKey and host before scheduling events', async () => {
+  test('does not forward credentials to component calls (env-driven config)', async () => {
+    // Credentials live on the component as env vars (POSTHOG_PROJECT_TOKEN, POSTHOG_HOST,
+    // POSTHOG_PERSONAL_API_KEY) declared in convex.config.ts and read inside each action.
+    // The client must not plumb them through every call site.
     const component = { lib: { capture: 'capture_ref' } }
-    const posthog = new PostHog(component as never, {
-      apiKey: '  explicit-key\n',
-      host: '  https://custom.posthog.com/\t ',
-    })
+    const posthog = new PostHog(component as never)
     const ctx = mockSchedulerCtx()
 
     await posthog.capture(ctx as never, {
@@ -55,12 +39,13 @@ describe('PostHog client', () => {
     })
 
     const [, , args] = ctx.scheduler.runAfter.mock.calls[0]
-    expect(args.apiKey).toBe('explicit-key')
-    expect(args.host).toBe('https://custom.posthog.com/')
+    expect(args).not.toHaveProperty('apiKey')
+    expect(args).not.toHaveProperty('host')
+    expect(args).not.toHaveProperty('personalApiKey')
   })
 
   test('exposes capture, identify, groupIdentify, alias, captureException methods', () => {
-    const posthog = new PostHog({} as never, { apiKey: 'test' })
+    const posthog = new PostHog({} as never)
 
     expect(typeof posthog.capture).toBe('function')
     expect(typeof posthog.identify).toBe('function')
@@ -70,7 +55,7 @@ describe('PostHog client', () => {
   })
 
   test('exposes feature flag methods', () => {
-    const posthog = new PostHog({} as never, { apiKey: 'test' })
+    const posthog = new PostHog({} as never)
 
     expect(typeof posthog.getFeatureFlag).toBe('function')
     expect(typeof posthog.isFeatureEnabled).toBe('function')
@@ -80,6 +65,21 @@ describe('PostHog client', () => {
     expect(typeof posthog.getAllFlagsAndPayloads).toBe('function')
   })
 
+  test('exposes reloadFeatureFlags method (parity with posthog-node)', () => {
+    const posthog = new PostHog({} as never)
+    expect(typeof posthog.reloadFeatureFlags).toBe('function')
+  })
+
+  test('reloadFeatureFlags forwards to the component refresh action with no args', async () => {
+    const component = { lib: { refreshFlagDefinitions: 'refresh_ref' } }
+    const posthog = new PostHog(component as never)
+    const ctx = { runAction: jest.fn(async () => ({ status: 'updated' })) }
+
+    await posthog.reloadFeatureFlags(ctx as never)
+
+    expect(ctx.runAction).toHaveBeenCalledWith('refresh_ref', {})
+  })
+
   test('getFeatureFlagPayload with matchValue does not require a distinctId', async () => {
     // The matchValue path is a pure key+value payload lookup; resolving a distinctId would
     // force callers to configure an identify callback or pass an ID they don't have.
@@ -105,9 +105,9 @@ describe('PostHog client', () => {
       cohorts: {},
     })
     const component = { lib: { getFlagDefinitions: 'getFlagDefinitions_ref' } }
-    const posthog = new PostHog(component as never, { apiKey: 'key' })
+    const posthog = new PostHog(component as never)
     const ctx = {
-      runQuery: jest.fn(async () => ({ data: definitions, fetchedAt: Date.now() })),
+      runQuery: jest.fn(async () => ({ localEvalConfigured: true, data: definitions, fetchedAt: Date.now() })),
     }
 
     const payload = await posthog.getFeatureFlagPayload(ctx as never, { key: 'flag', matchValue: 'red' })
@@ -115,6 +115,44 @@ describe('PostHog client', () => {
   })
 })
 
+describe('local-eval configuration', () => {
+  // When `POSTHOG_PERSONAL_API_KEY` isn't set on the component the cron never runs and local eval
+  // can never produce a verdict. The client throws so callers don't silently get `undefined` and
+  // wonder why their flag rollouts aren't taking effect.
+  test('throws when local eval is not configured (no PAK)', async () => {
+    const component = { lib: { getFlagDefinitions: 'getFlagDefinitions_ref' } }
+    const posthog = new PostHog(component as never)
+    const ctx = {
+      runQuery: jest.fn(async () => ({
+        localEvalConfigured: false,
+        data: null,
+        fetchedAt: null,
+      })),
+    }
+
+    await expect(posthog.getFeatureFlag(ctx as never, { key: 'my-flag', distinctId: 'u1' })).rejects.toThrow(
+      'local feature flag evaluation is not configured'
+    )
+  })
+
+  // PAK *is* set but the first cron tick hasn't landed yet — graceful degradation rather than
+  // throwing, so callers' fallback paths still work during the brief warm-up window.
+  test('returns undefined when PAK is configured but definitions have not been cached yet', async () => {
+    const component = { lib: { getFlagDefinitions: 'getFlagDefinitions_ref' } }
+    const posthog = new PostHog(component as never)
+    const ctx = {
+      runQuery: jest.fn(async () => ({
+        localEvalConfigured: true,
+        data: null,
+        fetchedAt: null,
+      })),
+    }
+
+    const value = await posthog.getFeatureFlag(ctx as never, { key: 'my-flag', distinctId: 'u1' })
+    expect(value).toBeUndefined()
+  })
+})
+
 describe('normalizeError', () => {
   test('extracts message, stack, and name from Error instances', () => {
     const error = new Error('test error')
@@ -170,7 +208,7 @@ describe('captureException', () => {
     const component = {
       lib: { captureException: 'captureException_ref' },
     }
-    const posthog = new PostHog(component as never, { apiKey: 'key' })
+    const posthog = new PostHog(component as never)
     const ctx = mockSchedulerCtx()
 
     await posthog.captureException(ctx as never, {
@@ -194,7 +232,7 @@ describe('captureException', () => {
     const component = {
       lib: { captureException: 'captureException_ref' },
     }
-    const posthog = new PostHog(component as never, { apiKey: 'key' })
+    const posthog = new PostHog(component as never)
     const ctx = mockSchedulerCtx()
 
     await posthog.captureException(ctx as never, {
@@ -211,7 +249,7 @@ describe('captureException', () => {
 describe('$-prefixed property serialization', () => {
   test('serializes properties with $-prefixed keys as JSON strings', async () => {
     const component = { lib: { capture: 'capture_ref' } }
-    const posthog = new PostHog(component as never, { apiKey: 'key' })
+    const posthog = new PostHog(component as never)
     const ctx = mockSchedulerCtx()
 
     await posthog.capture(ctx as never, {
@@ -237,7 +275,7 @@ describe('$-prefixed property serialization', () => {
 
   test('serializes identify properties with $set and $set_once', async () => {
     const component = { lib: { identify: 'identify_ref' } }
-    const posthog = new PostHog(component as never, { apiKey: 'key' })
+    const posthog = new PostHog(component as never)
     const ctx = mockSchedulerCtx()
 
     await posthog.identify(ctx as never, {
@@ -258,7 +296,7 @@ describe('$-prefixed property serialization', () => {
 
   test('passes undefined when properties are not provided', async () => {
     const component = { lib: { capture: 'capture_ref' } }
-    const posthog = new PostHog(component as never, { apiKey: 'key' })
+    const posthog = new PostHog(component as never)
     const ctx = mockSchedulerCtx()
 
     await posthog.capture(ctx as never, {
@@ -272,7 +310,7 @@ describe('$-prefixed property serialization', () => {
 
   test('preserves nested objects and arrays through serialization', async () => {
     const component = { lib: { capture: 'capture_ref' } }
-    const posthog = new PostHog(component as never, { apiKey: 'key' })
+    const posthog = new PostHog(component as never)
     const ctx = mockSchedulerCtx()
 
     const properties = {
@@ -296,7 +334,7 @@ describe('$-prefixed property serialization', () => {
 
   test('serializes groups with string and number values', async () => {
     const component = { lib: { capture: 'capture_ref' } }
-    const posthog = new PostHog(component as never, { apiKey: 'key' })
+    const posthog = new PostHog(component as never)
     const ctx = mockSchedulerCtx()
 
     await posthog.capture(ctx as never, {
@@ -312,7 +350,7 @@ describe('$-prefixed property serialization', () => {
 
   test('serializes captureException additionalProperties', async () => {
     const component = { lib: { captureException: 'captureException_ref' } }
-    const posthog = new PostHog(component as never, { apiKey: 'key' })
+    const posthog = new PostHog(component as never)
     const ctx = mockSchedulerCtx()
 
     await posthog.captureException(ctx as never, {
@@ -331,7 +369,7 @@ describe('$-prefixed property serialization', () => {
 
   test('handles empty objects', async () => {
     const component = { lib: { capture: 'capture_ref' } }
-    const posthog = new PostHog(component as never, { apiKey: 'key' })
+    const posthog = new PostHog(component as never)
     const ctx = mockSchedulerCtx()
 
     await posthog.capture(ctx as never, {
@@ -350,7 +388,7 @@ describe('$-prefixed property serialization', () => {
 describe('beforeSend', () => {
   test('allows events through when no beforeSend is configured', async () => {
     const component = { lib: { capture: 'capture_ref' } }
-    const posthog = new PostHog(component as never, { apiKey: 'key' })
+    const posthog = new PostHog(component as never)
     const ctx = mockSchedulerCtx()
 
     await posthog.capture(ctx as never, {
@@ -365,7 +403,6 @@ describe('beforeSend', () => {
     const component = { lib: { capture: 'capture_ref' } }
     const beforeSend: BeforeSendFn = () => null
     const posthog = new PostHog(component as never, {
-      apiKey: 'key',
       beforeSend,
     })
     const ctx = mockSchedulerCtx()
@@ -385,7 +422,6 @@ describe('beforeSend', () => {
       properties: { ...event.properties, injected: true },
     })
     const posthog = new PostHog(component as never, {
-      apiKey: 'key',
       beforeSend,
     })
     const ctx = mockSchedulerCtx()
@@ -411,7 +447,6 @@ describe('beforeSend', () => {
       properties: { ...event.properties, second: true },
     })
     const posthog = new PostHog(component as never, {
-      apiKey: 'key',
       beforeSend: [fn1, fn2],
     })
     const ctx = mockSchedulerCtx()
@@ -430,7 +465,6 @@ describe('beforeSend', () => {
     const fn1: BeforeSendFn = () => null
     const fn2: BeforeSendFn = jest.fn((event) => event)
     const posthog = new PostHog(component as never, {
-      apiKey: 'key',
       beforeSend: [fn1, fn2],
     })
     const ctx = mockSchedulerCtx()
@@ -451,7 +485,6 @@ describe('beforeSend', () => {
       return null
     }
     const posthog = new PostHog(component as never, {
-      apiKey: 'key',
       beforeSend,
     })
     const ctx = mockSchedulerCtx()
@@ -470,7 +503,6 @@ describe('beforeSend', () => {
       return event
     }
     const posthog = new PostHog(component as never, {
-      apiKey: 'key',
       beforeSend,
     })
     const ctx = mockSchedulerCtx()
@@ -492,7 +524,6 @@ describe('beforeSend', () => {
       return null
     }
     const posthog = new PostHog(component as never, {
-      apiKey: 'key',
       beforeSend,
     })
     const ctx = mockSchedulerCtx()
@@ -513,7 +544,6 @@ describe('beforeSend', () => {
       return event
     }
     const posthog = new PostHog(component as never, {
-      apiKey: 'key',
       beforeSend,
     })
     const ctx = mockSchedulerCtx()
@@ -535,7 +565,6 @@ describe('identify callback', () => {
   test('uses identify callback result for capture', async () => {
     const component = { lib: { capture: 'capture_ref' } }
     const posthog = new PostHog(component as never, {
-      apiKey: 'key',
       identify: identifyReturning('auth-user-1'),
     })
     const ctx = mockSchedulerCtx()
@@ -549,7 +578,6 @@ describe('identify callback', () => {
   test('falls back to explicit distinctId when identify returns null', async () => {
     const component = { lib: { capture: 'capture_ref' } }
     const posthog = new PostHog(component as never, {
-      apiKey: 'key',
       identify: identifyReturningNull,
     })
     const ctx = mockSchedulerCtx()
@@ -566,7 +594,6 @@ describe('identify callback', () => {
   test('throws when neither identify nor explicit distinctId resolves', async () => {
     const component = { lib: { capture: 'capture_ref' } }
     const posthog = new PostHog(component as never, {
-      apiKey: 'key',
       identify: identifyReturningNull,
     })
     const ctx = mockSchedulerCtx()
@@ -576,7 +603,7 @@ describe('identify callback', () => {
 
   test('throws when no identify configured and no explicit distinctId', async () => {
     const component = { lib: { capture: 'capture_ref' } }
-    const posthog = new PostHog(component as never, { apiKey: 'key' })
+    const posthog = new PostHog(component as never)
     const ctx = mockSchedulerCtx()
 
     await expect(posthog.capture(ctx as never, { event: 'test_event' })).rejects.toThrow('Could not resolve distinctId')
@@ -585,7 +612,6 @@ describe('identify callback', () => {
   test('identify callback takes precedence over explicit distinctId', async () => {
     const component = { lib: { capture: 'capture_ref' } }
     const posthog = new PostHog(component as never, {
-      apiKey: 'key',
       identify: identifyReturning('auth-user'),
     })
     const ctx = mockSchedulerCtx()
@@ -603,7 +629,6 @@ describe('identify callback', () => {
     const component = { lib: { capture: 'capture_ref' } }
     const identify = jest.fn(async () => ({ distinctId: 'resolved' }))
     const posthog = new PostHog(component as never, {
-      apiKey: 'key',
       identify,
     })
     const ctx = mockSchedulerCtx()
@@ -616,7 +641,6 @@ describe('identify callback', () => {
   test('works with identify method', async () => {
     const component = { lib: { identify: 'identify_ref' } }
     const posthog = new PostHog(component as never, {
-      apiKey: 'key',
       identify: identifyReturning('auth-user'),
     })
     const ctx = mockSchedulerCtx()
@@ -630,7 +654,6 @@ describe('identify callback', () => {
   test('works with alias method', async () => {
     const component = { lib: { alias: 'alias_ref' } }
     const posthog = new PostHog(component as never, {
-      apiKey: 'key',
       identify: identifyReturning('auth-user'),
     })
     const ctx = mockSchedulerCtx()
@@ -645,7 +668,7 @@ describe('identify callback', () => {
     const component = {
       lib: { captureException: 'captureException_ref' },
     }
-    const posthog = new PostHog(component as never, { apiKey: 'key' })
+    const posthog = new PostHog(component as never)
     const ctx = mockSchedulerCtx()
 
     await posthog.captureException(ctx as never, {
@@ -662,7 +685,6 @@ describe('identify callback', () => {
       lib: { captureException: 'captureException_ref' },
     }
     const posthog = new PostHog(component as never, {
-      apiKey: 'key',
       identify: identifyReturning('auth-user'),
     })
     const ctx = mockSchedulerCtx()
@@ -682,11 +704,11 @@ describe('identify callback', () => {
     try {
       const component = { lib: { getFlagDefinitions: 'getFlagDefinitions_ref' } }
       const posthog = new PostHog(component as never, {
-        apiKey: 'key',
         identify: identifyReturning('auth-user'),
       })
       // Stub real-looking flag definitions so `loadEvaluator` returns an instance.
       const definitions = {
+        localEvalConfigured: true,
         data: JSON.stringify({ flags: [], groupTypeMapping: {}, cohorts: {} }),
         fetchedAt: Date.now(),
       }
@@ -706,7 +728,7 @@ describe('identify callback', () => {
 
   test('explicit distinctId still works without identify callback', async () => {
     const component = { lib: { capture: 'capture_ref' } }
-    const posthog = new PostHog(component as never, { apiKey: 'key' })
+    const posthog = new PostHog(component as never)
     const ctx = mockSchedulerCtx()
 
     await posthog.capture(ctx as never, {

package/src/client/index.ts

@@ -14,6 +14,9 @@ type SchedulerCtx = { scheduler: Scheduler }
 /** Context with runQuery — available in queries, mutations, and actions. */
 type RunQueryCtx = { runQuery: (reference: any, args: any) => Promise<any> }
 
+/** Context with runAction — available in actions. Used by remote flag evaluation methods. */
+type RunActionCtx = { runAction: (reference: any, args: any) => Promise<any> }
+
 type FeatureFlagOptions = {
   groups?: Record<string, string>
   personProperties?: Record<string, any>
@@ -23,17 +26,6 @@ type FeatureFlagOptions = {
 
 type AllFlagsOptions = FeatureFlagOptions & { flagKeys?: string[] }
 
-const DEFAULT_HOST = 'https://us.i.posthog.com'
-
-function normalizeApiKey(value?: unknown): string {
-  return typeof value === 'string' ? value.trim() : ''
-}
-
-function normalizeHost(value?: unknown): string {
-  const normalizedValue = typeof value === 'string' ? value.trim() : ''
-  return normalizedValue || DEFAULT_HOST
-}
-
 export type { FeatureFlagResult, FeatureFlagValue, JsonType }
 
 export type PostHogEvent = {
@@ -77,52 +69,37 @@ export function normalizeError(error: unknown): {
   return { message: String(error) }
 }
 
-/** Context with runAction — available in actions. Used by `refreshFlagDefinitions`. */
-type RunActionCtx = { runAction: (reference: any, args: any) => Promise<any> }
-
+/**
+ * Client-side wrapper around the PostHog Convex component.
+ *
+ * Credentials (`POSTHOG_PROJECT_TOKEN`, `POSTHOG_HOST`, `POSTHOG_PERSONAL_API_KEY`) are declared on the
+ * component in `convex.config.ts` and read directly inside the component's actions — they don't
+ * need to be plumbed through every call site. Configure callbacks (identify, beforeSend) on the
+ * client; everything else lives in env vars.
+ */
 export class PostHog {
-  private apiKey: string
-  private personalApiKey: string
-  private host: string
   private beforeSend?: BeforeSendFn | BeforeSendFn[]
   private identifyFn?: IdentifyFn
 
   constructor(
     public component: ComponentApi,
     options?: {
-      apiKey?: string
-      /**
-       * Either a [feature flags secure API key](https://posthog.com/docs/feature-flags/local-evaluation#step-1-find-your-feature-flags-secure-api-key)
-       * (`phs_…`, recommended) or a personal API key (`phx_…`) with feature-flag read access.
-       * Required for local feature flag evaluation; defaults to `process.env.POSTHOG_PERSONAL_API_KEY`.
-       * The key is captured at construction time and forwarded to the component whenever you call
-       * `refreshFlagDefinitions(ctx)`.
-       */
-      personalApiKey?: string
-      host?: string
       beforeSend?: BeforeSendFn | BeforeSendFn[]
       identify?: IdentifyFn
     }
   ) {
-    this.apiKey = normalizeApiKey(options?.apiKey ?? process.env.POSTHOG_API_KEY)
-    this.personalApiKey = normalizeApiKey(options?.personalApiKey ?? process.env.POSTHOG_PERSONAL_API_KEY)
-    this.host = normalizeHost(options?.host ?? process.env.POSTHOG_HOST)
     this.beforeSend = options?.beforeSend
     this.identifyFn = options?.identify
   }
 
   /**
-   * Trigger a refresh of the cached feature flag definitions. Must be called from an action
-   * context (typically a cron handler) — the component fetches `/flags/definitions` and writes
-   * the result to its singleton table. Returns the component's status object so callers can log
-   * misconfiguration without throwing.
+   * Trigger a one-off refresh of the cached feature flag definitions. Named for parity with
+   * `posthog-node`'s `reloadFeatureFlags()`. The component already refreshes on a cron when
+   * `POSTHOG_PERSONAL_API_KEY` is set, so call this only when you need an immediate refresh
+   * (e.g. after creating a flag in development). Requires an action context.
    */
-  async refreshFlagDefinitions(ctx: RunActionCtx): Promise<unknown> {
-    return await ctx.runAction(this.component.lib.refreshFlagDefinitions, {
-      apiKey: this.apiKey,
-      personalApiKey: this.personalApiKey,
-      host: this.host,
-    })
+  async reloadFeatureFlags(ctx: RunActionCtx): Promise<unknown> {
+    return await ctx.runAction(this.component.lib.refreshFlagDefinitions, {})
   }
 
   private async resolveDistinctId(ctx: unknown, argsDistinctId?: string): Promise<string> {
@@ -150,11 +127,25 @@ export class PostHog {
 
   private async loadEvaluator(ctx: RunQueryCtx): Promise<LocalFeatureFlagEvaluator | null> {
     const row = (await ctx.runQuery(this.component.lib.getFlagDefinitions, {})) as {
-      data: string
-      fetchedAt: number
+      localEvalConfigured: boolean
+      data: string | null
+      fetchedAt: number | null
       etag?: string
-    } | null
-    if (!row) return null
+    }
+    if (!row.localEvalConfigured) {
+      // Loud failure rather than silent `undefined`: a caller invoking a local-eval method
+      // without `POSTHOG_PERSONAL_API_KEY` configured almost certainly meant to use a remote
+      // `evaluate*` method instead. Throwing tells them exactly what to do.
+      throw new Error(
+        'PostHog: local feature flag evaluation is not configured. ' +
+          'Set POSTHOG_PERSONAL_API_KEY on your Convex deployment, or call the remote ' +
+          '`evaluateFlag` / `evaluateFlagPayload` / `evaluateAllFlags` methods instead ' +
+          '(action context only).'
+      )
+    }
+    // PAK is set but the cron hasn't populated the cache yet — return null so callers fall
+    // back to their `undefined` graceful-degrade path until definitions land.
+    if (!row.data) return null
     let parsed: FlagDefinitions
     try {
       parsed = JSON.parse(row.data) as FlagDefinitions
@@ -189,8 +180,6 @@ export class PostHog {
     if (!result) return
 
     await ctx.scheduler.runAfter(0, this.component.lib.capture, {
-      apiKey: this.apiKey,
-      host: this.host,
       distinctId: result.distinctId,
       event: result.event,
       properties: result.properties ? JSON.stringify(result.properties) : undefined,
@@ -223,8 +212,6 @@ export class PostHog {
     if (!result) return
 
     await ctx.scheduler.runAfter(0, this.component.lib.identify, {
-      apiKey: this.apiKey,
-      host: this.host,
       distinctId: result.distinctId,
       properties: result.properties ? JSON.stringify(result.properties) : undefined,
       disableGeoip: args.disableGeoip,
@@ -249,8 +236,6 @@ export class PostHog {
     if (!result) return
 
     await ctx.scheduler.runAfter(0, this.component.lib.groupIdentify, {
-      apiKey: this.apiKey,
-      host: this.host,
       groupType: args.groupType,
       groupKey: args.groupKey,
       properties: result.properties ? JSON.stringify(result.properties) : undefined,
@@ -278,8 +263,6 @@ export class PostHog {
     if (!result) return
 
     await ctx.scheduler.runAfter(0, this.component.lib.alias, {
-      apiKey: this.apiKey,
-      host: this.host,
       distinctId: result.distinctId,
       alias: args.alias,
       disableGeoip: args.disableGeoip,
@@ -311,8 +294,6 @@ export class PostHog {
     if (!result) return
 
     await ctx.scheduler.runAfter(0, this.component.lib.captureException, {
-      apiKey: this.apiKey,
-      host: this.host,
       distinctId: result.distinctId || undefined,
       errorMessage: message,
       errorStack: stack,
@@ -469,8 +450,6 @@ export class PostHog {
   ): Promise<FeatureFlagValue | null> {
     const distinctId = await this.resolveDistinctId(ctx, args.distinctId)
     return (await ctx.runAction(this.component.lib.evaluateFlag, {
-      apiKey: this.apiKey,
-      host: this.host,
       key: args.key,
       distinctId,
       groups: args.groups,
@@ -490,8 +469,6 @@ export class PostHog {
   ): Promise<JsonType | null> {
     const distinctId = await this.resolveDistinctId(ctx, args.distinctId)
     return (await ctx.runAction(this.component.lib.evaluateFlagPayload, {
-      apiKey: this.apiKey,
-      host: this.host,
       key: args.key,
       distinctId,
       groups: args.groups,
@@ -515,8 +492,6 @@ export class PostHog {
   }> {
     const distinctId = await this.resolveDistinctId(ctx, args.distinctId)
     return (await ctx.runAction(this.component.lib.evaluateAllFlags, {
-      apiKey: this.apiKey,
-      host: this.host,
       distinctId,
       groups: args.groups,
       personProperties: args.personProperties,

package/src/component/_generated/api.ts

@@ -8,7 +8,9 @@
  * @module
  */
 
+import type * as crons from "../crons.js";
 import type * as lib from "../lib.js";
+import type * as version from "../version.js";
 
 import type {
   ApiFromModules,
@@ -18,7 +20,9 @@ import type {
 import { anyApi, componentsGeneric } from "convex/server";
 
 const fullApi: ApiFromModules<{
+  crons: typeof crons;
   lib: typeof lib;
+  version: typeof version;
 }> = anyApi as any;
 
 /**