@walkeros/server-destination-posthog 4.2.0 → 4.2.1-next-1781538735002

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @walkeros/server-destination-posthog
 
+## 4.2.1-next-1781538735002
+
+### Patch Changes
+
+- Updated dependencies [5cbcd23]
+  - @walkeros/core@4.2.1-next-1781538735002
+  - @walkeros/server-core@4.2.1-next-1781538735002
+
 ## 4.2.0
 
 ### Patch Changes

package/dist/dev.d.mts

@@ -1,6 +1,6 @@
 import * as _walkeros_core_dev from '@walkeros/core/dev';
 import { z } from '@walkeros/core/dev';
-import { Mapping as Mapping$1, Flow } from '@walkeros/core';
+import { Mapping as Mapping$1, Flow, WalkerOS } from '@walkeros/core';
 import { DestinationServer } from '@walkeros/server-core';
 import { PostHog } from 'posthog-node';
 
@@ -91,6 +91,8 @@ declare namespace env {
 type PostHogStepExample = Flow.StepExample & {
     settings?: Partial<Settings>;
     configInclude?: string[];
+    /** Consent granted before `in` so a gated destination is loaded first. */
+    before?: WalkerOS.Consent;
 };
 /**
  * Default event forwarding - every walkerOS event becomes
@@ -119,7 +121,10 @@ declare const groupIdentifyWithProperties: PostHogStepExample;
  */
 declare const captureWithGroupContext: PostHogStepExample;
 /**
- * Consent revoked - client.disable() is called.
+ * Consent revoked - after analytics consent is granted (PostHog loads and is
+ * enabled), revoking it calls client.disable() via the on('consent') handler.
+ * The destination is never loaded under denied consent, so the disable is a
+ * real revocation of an already-granted destination.
  */
 declare const consentRevoke: PostHogStepExample;
 /**

package/dist/dev.d.ts

@@ -1,6 +1,6 @@
 import * as _walkeros_core_dev from '@walkeros/core/dev';
 import { z } from '@walkeros/core/dev';
-import { Mapping as Mapping$1, Flow } from '@walkeros/core';
+import { Mapping as Mapping$1, Flow, WalkerOS } from '@walkeros/core';
 import { DestinationServer } from '@walkeros/server-core';
 import { PostHog } from 'posthog-node';
 
@@ -91,6 +91,8 @@ declare namespace env {
 type PostHogStepExample = Flow.StepExample & {
     settings?: Partial<Settings>;
     configInclude?: string[];
+    /** Consent granted before `in` so a gated destination is loaded first. */
+    before?: WalkerOS.Consent;
 };
 /**
  * Default event forwarding - every walkerOS event becomes
@@ -119,7 +121,10 @@ declare const groupIdentifyWithProperties: PostHogStepExample;
  */
 declare const captureWithGroupContext: PostHogStepExample;
 /**
- * Consent revoked - client.disable() is called.
+ * Consent revoked - after analytics consent is granted (PostHog loads and is
+ * enabled), revoking it calls client.disable() via the on('consent') handler.
+ * The destination is never loaded under denied consent, so the disable is a
+ * real revocation of an already-granted destination.
  */
 declare const consentRevoke: PostHogStepExample;
 /**

package/dist/dev.js

@@ -1 +1 @@
-"use strict";var e,t=Object.defineProperty,o=Object.getOwnPropertyDescriptor,i=Object.getOwnPropertyNames,n=Object.prototype.hasOwnProperty,s=(e,o)=>{for(var i in o)t(e,i,{get:o[i],enumerable:!0})},a={};s(a,{examples:()=>y,schemas:()=>r}),module.exports=(e=a,((e,s,a,r)=>{if(s&&"object"==typeof s||"function"==typeof s)for(let p of i(s))n.call(e,p)||p===a||t(e,p,{get:()=>s[p],enumerable:!(r=o(s,p))||r.enumerable});return e})(t({},"__esModule",{value:!0}),e));var r={};s(r,{MappingSchema:()=>u,SettingsSchema:()=>c,mapping:()=>m,settings:()=>g});var p=require("@walkeros/core/dev"),l=require("@walkeros/core/dev"),c=l.z.object({apiKey:l.z.string().min(1).describe('PostHog project API key (starts with "phc_"). Find it in PostHog project settings.'),host:l.z.string().describe("PostHog API host. Defaults to https://us.i.posthog.com. Use https://eu.i.posthog.com for EU or your self-hosted URL.").optional(),flushAt:l.z.number().describe("Number of events queued before auto-flush. Default: 20.").optional(),flushInterval:l.z.number().describe("Milliseconds between periodic flushes. Default: 10000.").optional(),personalApiKey:l.z.string().describe("Personal API key (phx_...) for local feature flag evaluation.").optional(),featureFlagsPollingInterval:l.z.number().describe("Milliseconds between feature flag definition polls. Default: 30000.").optional(),disableGeoip:l.z.boolean().describe("Disable GeoIP lookups globally. Useful for GDPR compliance.").optional(),debug:l.z.boolean().describe("Enable PostHog SDK debug logging. Default: false.").optional(),identify:l.z.unknown().describe("walkerOS mapping value resolving to an identity object. Keys: distinctId, $set, $set_once. Resolved on every push (server is stateless).").optional(),group:l.z.unknown().describe("walkerOS mapping value resolving to a group object. Keys: type, key, properties. Resolved on every push.").optional(),include:l.z.array(l.z.string()).describe('Event sections to flatten into capture() properties (e.g. ["data", "globals"]).').optional()}),d=require("@walkeros/core/dev"),u=d.z.object({identify:d.z.unknown().describe("Per-event identity mapping. Resolves to { distinctId, $set?, $set_once? }. Fires client.identify() when $set/$set_once present.").optional(),group:d.z.unknown().describe("Group assignment. Resolves to { type, key, properties? }. Fires client.groupIdentify() when properties present, adds groups to capture().").optional()}),g=(0,p.zodToSchema)(c),m=(0,p.zodToSchema)(u),y={};s(y,{env:()=>h,step:()=>v});var h={};s(h,{push:()=>f,simulation:()=>b});var f={get PostHog(){return class{apiKey;options;calls;constructor(e,t){this.apiKey=e,this.options=t||{},this.calls=[]}capture(e){this.calls.push({method:"capture",args:[e]})}identify(e){this.calls.push({method:"identify",args:[e]})}groupIdentify(e){this.calls.push({method:"groupIdentify",args:[e]})}flush(){return this.calls.push({method:"flush",args:[]}),Promise.resolve()}async shutdown(){this.calls.push({method:"shutdown",args:[]})}enable(){this.calls.push({method:"enable",args:[]})}disable(){this.calls.push({method:"disable",args:[]})}}}},b=["call:client.capture","call:client.identify","call:client.groupIdentify","call:client.shutdown"],v={};s(v,{captureWithGroupContext:()=>z,captureWithInclude:()=>P,consentGrant:()=>$,consentRevoke:()=>A,defaultCapture:()=>_,groupIdentifyWithProperties:()=>I,identifyWithSetAndSetOnce:()=>k});var w=require("@walkeros/core"),_={title:"Default capture",description:"A walker event becomes a PostHog capture call with the user id as distinctId and no extra properties.",in:(0,w.getEvent)("product view",{timestamp:1700000100}),out:[["client.capture",{distinctId:"us3r",event:"product view",properties:{}}]]},P={title:"Capture with include",description:"Destination-level include flattens data and globals sections into prefixed PostHog event properties.",in:(0,w.getEvent)("order complete",{timestamp:1700000101}),configInclude:["data","globals"],out:[["client.capture",{distinctId:"us3r",event:"order complete",properties:{data_id:"0rd3r1d",data_currency:"EUR",data_shipping:5.22,data_taxes:73.76,data_total:555,globals_pagegroup:"shop"}}]]},k={title:"Identify with $set",description:"A user login fires PostHog identify with $set and $set_once person properties and skips the capture.",in:(0,w.getEvent)("user login",{timestamp:1700000102,data:{user_id:"new-user-123",email:"user@acme.com",plan:"premium"}}),mapping:{silent:!0,settings:{identify:{map:{distinctId:"data.user_id",$set:{map:{email:"data.email",plan:"data.plan"}},$set_once:{map:{first_login:"timestamp"}}}}}},out:[["client.identify",{distinctId:"new-user-123",properties:{$set:{email:"user@acme.com",plan:"premium"},$set_once:{first_login:1700000102}}}]]},I={title:"Group identify",description:"A company update fires PostHog groupIdentify with group type, key, and associated group properties.",in:(0,w.getEvent)("company update",{timestamp:1700000103,data:{company_id:"company_123",company_name:"Acme",plan:"enterprise"}}),mapping:{silent:!0,settings:{group:{map:{type:{value:"company"},key:"data.company_id",properties:{map:{name:"data.company_name",plan:"data.plan"}}}}}},out:[["client.groupIdentify",{groupType:"company",groupKey:"company_123",properties:{name:"Acme",plan:"enterprise"}}]]},z={title:"Capture with group",description:"A destination-level group mapping attaches the resolved group context to every PostHog capture call.",in:(0,w.getEvent)("page view",{timestamp:1700000104,globals:{pagegroup:"docs",company_id:"company_123"}}),settings:{group:{map:{type:{value:"company"},key:"globals.company_id"}}},out:[["client.capture",{distinctId:"us3r",event:"page view",properties:{},groups:{company:"company_123"}}]]},A={title:"Consent revoked",description:"A walker consent command with analytics denied calls client.disable on the PostHog client.",command:"consent",in:{analytics:!1},settings:{},out:[["client.disable"]]},$={title:"Consent granted",description:"A walker consent command with analytics granted calls client.enable on the PostHog client.",command:"consent",in:{analytics:!0},settings:{},out:[["client.enable"]]};//# sourceMappingURL=dev.js.map
+"use strict";var e,t=Object.defineProperty,i=Object.getOwnPropertyDescriptor,o=Object.getOwnPropertyNames,n=Object.prototype.hasOwnProperty,s=(e,i)=>{for(var o in i)t(e,o,{get:i[o],enumerable:!0})},a={};s(a,{examples:()=>y,schemas:()=>r}),module.exports=(e=a,((e,s,a,r)=>{if(s&&"object"==typeof s||"function"==typeof s)for(let p of o(s))n.call(e,p)||p===a||t(e,p,{get:()=>s[p],enumerable:!(r=i(s,p))||r.enumerable});return e})(t({},"__esModule",{value:!0}),e));var r={};s(r,{MappingSchema:()=>u,SettingsSchema:()=>c,mapping:()=>m,settings:()=>g});var p=require("@walkeros/core/dev"),l=require("@walkeros/core/dev"),c=l.z.object({apiKey:l.z.string().min(1).describe('PostHog project API key (starts with "phc_"). Find it in PostHog project settings.'),host:l.z.string().describe("PostHog API host. Defaults to https://us.i.posthog.com. Use https://eu.i.posthog.com for EU or your self-hosted URL.").optional(),flushAt:l.z.number().describe("Number of events queued before auto-flush. Default: 20.").optional(),flushInterval:l.z.number().describe("Milliseconds between periodic flushes. Default: 10000.").optional(),personalApiKey:l.z.string().describe("Personal API key (phx_...) for local feature flag evaluation.").optional(),featureFlagsPollingInterval:l.z.number().describe("Milliseconds between feature flag definition polls. Default: 30000.").optional(),disableGeoip:l.z.boolean().describe("Disable GeoIP lookups globally. Useful for GDPR compliance.").optional(),debug:l.z.boolean().describe("Enable PostHog SDK debug logging. Default: false.").optional(),identify:l.z.unknown().describe("walkerOS mapping value resolving to an identity object. Keys: distinctId, $set, $set_once. Resolved on every push (server is stateless).").optional(),group:l.z.unknown().describe("walkerOS mapping value resolving to a group object. Keys: type, key, properties. Resolved on every push.").optional(),include:l.z.array(l.z.string()).describe('Event sections to flatten into capture() properties (e.g. ["data", "globals"]).').optional()}),d=require("@walkeros/core/dev"),u=d.z.object({identify:d.z.unknown().describe("Per-event identity mapping. Resolves to { distinctId, $set?, $set_once? }. Fires client.identify() when $set/$set_once present.").optional(),group:d.z.unknown().describe("Group assignment. Resolves to { type, key, properties? }. Fires client.groupIdentify() when properties present, adds groups to capture().").optional()}),g=(0,p.zodToSchema)(c),m=(0,p.zodToSchema)(u),y={};s(y,{env:()=>h,step:()=>v});var h={};s(h,{push:()=>f,simulation:()=>b});var f={get PostHog(){return class{apiKey;options;calls;constructor(e,t){this.apiKey=e,this.options=t||{},this.calls=[]}capture(e){this.calls.push({method:"capture",args:[e]})}identify(e){this.calls.push({method:"identify",args:[e]})}groupIdentify(e){this.calls.push({method:"groupIdentify",args:[e]})}flush(){return this.calls.push({method:"flush",args:[]}),Promise.resolve()}async shutdown(){this.calls.push({method:"shutdown",args:[]})}enable(){this.calls.push({method:"enable",args:[]})}disable(){this.calls.push({method:"disable",args:[]})}}}},b=["call:client.capture","call:client.identify","call:client.groupIdentify","call:client.shutdown"],v={};s(v,{captureWithGroupContext:()=>z,captureWithInclude:()=>P,consentGrant:()=>$,consentRevoke:()=>A,defaultCapture:()=>_,groupIdentifyWithProperties:()=>I,identifyWithSetAndSetOnce:()=>k});var w=require("@walkeros/core"),_={title:"Default capture",description:"A walker event becomes a PostHog capture call with the user id as distinctId and no extra properties.",in:(0,w.getEvent)("product view",{timestamp:1700000100}),out:[["client.capture",{distinctId:"us3r",event:"product view",properties:{}}]]},P={title:"Capture with include",description:"Destination-level include flattens data and globals sections into prefixed PostHog event properties.",in:(0,w.getEvent)("order complete",{timestamp:1700000101}),configInclude:["data","globals"],out:[["client.capture",{distinctId:"us3r",event:"order complete",properties:{data_id:"0rd3r1d",data_currency:"EUR",data_shipping:5.22,data_taxes:73.76,data_total:555,globals_pagegroup:"shop"}}]]},k={title:"Identify with $set",description:"A user login fires PostHog identify with $set and $set_once person properties and skips the capture.",in:(0,w.getEvent)("user login",{timestamp:1700000102,data:{user_id:"new-user-123",email:"user@acme.com",plan:"premium"}}),mapping:{silent:!0,settings:{identify:{map:{distinctId:"data.user_id",$set:{map:{email:"data.email",plan:"data.plan"}},$set_once:{map:{first_login:"timestamp"}}}}}},out:[["client.identify",{distinctId:"new-user-123",properties:{$set:{email:"user@acme.com",plan:"premium"},$set_once:{first_login:1700000102}}}]]},I={title:"Group identify",description:"A company update fires PostHog groupIdentify with group type, key, and associated group properties.",in:(0,w.getEvent)("company update",{timestamp:1700000103,data:{company_id:"company_123",company_name:"Acme",plan:"enterprise"}}),mapping:{silent:!0,settings:{group:{map:{type:{value:"company"},key:"data.company_id",properties:{map:{name:"data.company_name",plan:"data.plan"}}}}}},out:[["client.groupIdentify",{groupType:"company",groupKey:"company_123",properties:{name:"Acme",plan:"enterprise"}}]]},z={title:"Capture with group",description:"A destination-level group mapping attaches the resolved group context to every PostHog capture call.",in:(0,w.getEvent)("page view",{timestamp:1700000104,globals:{pagegroup:"docs",company_id:"company_123"}}),settings:{group:{map:{type:{value:"company"},key:"globals.company_id"}}},out:[["client.capture",{distinctId:"us3r",event:"page view",properties:{},groups:{company:"company_123"}}]]},A={title:"Consent revoked",description:"A walker consent command with analytics denied calls client.disable on the PostHog client.",command:"consent",before:{analytics:!0},in:{analytics:!1},settings:{},out:[["client.enable"],["client.disable"]]},$={title:"Consent granted",description:"A walker consent command with analytics granted calls client.enable on the PostHog client.",command:"consent",in:{analytics:!0},settings:{},out:[["client.enable"]]};//# sourceMappingURL=dev.js.map

package/dist/dev.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/dev.ts","../src/schemas/index.ts","../src/schemas/settings.ts","../src/schemas/mapping.ts","../src/examples/index.ts","../src/examples/env.ts","../src/examples/step.ts"],"sourcesContent":["export * as schemas from './schemas';\nexport * as examples from './examples';\n","import { zodToSchema } from '@walkeros/core/dev';\nimport { SettingsSchema } from './settings';\nimport { MappingSchema } from './mapping';\n\nexport { SettingsSchema, type Settings } from './settings';\nexport { MappingSchema, type Mapping } from './mapping';\n\n// JSON Schema\nexport const settings = zodToSchema(SettingsSchema);\nexport const mapping = zodToSchema(MappingSchema);\n","import { z } from '@walkeros/core/dev';\n\nexport const SettingsSchema = z.object({\n  apiKey: z\n    .string()\n    .min(1)\n    .describe(\n      'PostHog project API key (starts with \"phc_\"). Find it in PostHog project settings.',\n    ),\n  host: z\n    .string()\n    .describe(\n      'PostHog API host. Defaults to https://us.i.posthog.com. Use https://eu.i.posthog.com for EU or your self-hosted URL.',\n    )\n    .optional(),\n  flushAt: z\n    .number()\n    .describe('Number of events queued before auto-flush. Default: 20.')\n    .optional(),\n  flushInterval: z\n    .number()\n    .describe('Milliseconds between periodic flushes. Default: 10000.')\n    .optional(),\n  personalApiKey: z\n    .string()\n    .describe('Personal API key (phx_...) for local feature flag evaluation.')\n    .optional(),\n  featureFlagsPollingInterval: z\n    .number()\n    .describe(\n      'Milliseconds between feature flag definition polls. Default: 30000.',\n    )\n    .optional(),\n  disableGeoip: z\n    .boolean()\n    .describe('Disable GeoIP lookups globally. Useful for GDPR compliance.')\n    .optional(),\n  debug: z\n    .boolean()\n    .describe('Enable PostHog SDK debug logging. Default: false.')\n    .optional(),\n  identify: z\n    .unknown()\n    .describe(\n      'walkerOS mapping value resolving to an identity object. Keys: distinctId, $set, $set_once. Resolved on every push (server is stateless).',\n    )\n    .optional(),\n  group: z\n    .unknown()\n    .describe(\n      'walkerOS mapping value resolving to a group object. Keys: type, key, properties. Resolved on every push.',\n    )\n    .optional(),\n  include: z\n    .array(z.string())\n    .describe(\n      'Event sections to flatten into capture() properties (e.g. [\"data\", \"globals\"]).',\n    )\n    .optional(),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { z } from '@walkeros/core/dev';\n\nexport const MappingSchema = z.object({\n  identify: z\n    .unknown()\n    .describe(\n      'Per-event identity mapping. Resolves to { distinctId, $set?, $set_once? }. Fires client.identify() when $set/$set_once present.',\n    )\n    .optional(),\n  group: z\n    .unknown()\n    .describe(\n      'Group assignment. Resolves to { type, key, properties? }. Fires client.groupIdentify() when properties present, adds groups to capture().',\n    )\n    .optional(),\n});\n\nexport type Mapping = z.infer<typeof MappingSchema>;\n","export * as env from './env';\nexport * as step from './step';\n","import type { Env } from '../types';\n\n/**\n * Mock PostHog class that records method calls for testing.\n * Follows the BigQuery env.BigQuery constructor injection pattern.\n */\nfunction createMockPostHog() {\n  return class MockPostHog {\n    apiKey: string;\n    options: Record<string, unknown>;\n    calls: Array<{ method: string; args: unknown[] }>;\n\n    constructor(apiKey: string, options?: Record<string, unknown>) {\n      this.apiKey = apiKey;\n      this.options = options || {};\n      this.calls = [];\n    }\n\n    capture(params: Record<string, unknown>) {\n      this.calls.push({ method: 'capture', args: [params] });\n    }\n\n    identify(params: Record<string, unknown>) {\n      this.calls.push({ method: 'identify', args: [params] });\n    }\n\n    groupIdentify(params: Record<string, unknown>) {\n      this.calls.push({ method: 'groupIdentify', args: [params] });\n    }\n\n    flush() {\n      this.calls.push({ method: 'flush', args: [] });\n      return Promise.resolve();\n    }\n\n    async shutdown() {\n      this.calls.push({ method: 'shutdown', args: [] });\n    }\n\n    enable() {\n      this.calls.push({ method: 'enable', args: [] });\n    }\n\n    disable() {\n      this.calls.push({ method: 'disable', args: [] });\n    }\n  };\n}\n\n/**\n * Standard mock environment for push operations.\n * Injects a mock PostHog class constructor via env.PostHog.\n */\nexport const push: Env = {\n  get PostHog() {\n    return createMockPostHog() as unknown as Env['PostHog'];\n  },\n};\n\n/** Simulation tracking paths for CLI --simulate. */\nexport const simulation = [\n  'call:client.capture',\n  'call:client.identify',\n  'call:client.groupIdentify',\n  'call:client.shutdown',\n];\n","import type { Flow, WalkerOS } from '@walkeros/core';\nimport { getEvent } from '@walkeros/core';\nimport type { Settings } from '../types';\n\n/**\n * PostHog server step examples carry destination-level settings and\n * optional configInclude for the test runner to wire up.\n *\n * At push time the destination invokes methods on a `client` constructed\n * via `env.PostHog`. Each `out` tuple is `['client.<method>', ...args]`\n * matching the underlying SDK signature. Multiple calls (identify +\n * capture, groupIdentify + capture) are expressed as a tuple list.\n */\nexport type PostHogStepExample = Flow.StepExample & {\n  settings?: Partial<Settings>;\n  configInclude?: string[];\n};\n\n/**\n * Default event forwarding - every walkerOS event becomes\n * client.capture({ distinctId, event, properties }). With no mapping\n * and no include, properties is {}. distinctId falls back to event.user.id.\n */\nexport const defaultCapture: PostHogStepExample = {\n  title: 'Default capture',\n  description:\n    'A walker event becomes a PostHog capture call with the user id as distinctId and no extra properties.',\n  in: getEvent('product view', { timestamp: 1700000100 }),\n  out: [\n    [\n      'client.capture',\n      {\n        distinctId: 'us3r',\n        event: 'product view',\n        properties: {},\n      },\n    ],\n  ],\n};\n\n/**\n * Capture with include - destination-level include flattens data and\n * globals sections into prefixed properties.\n */\nexport const captureWithInclude: PostHogStepExample = {\n  title: 'Capture with include',\n  description:\n    'Destination-level include flattens data and globals sections into prefixed PostHog event properties.',\n  in: getEvent('order complete', { timestamp: 1700000101 }),\n  configInclude: ['data', 'globals'],\n  out: [\n    [\n      'client.capture',\n      {\n        distinctId: 'us3r',\n        event: 'order complete',\n        properties: {\n          data_id: '0rd3r1d',\n          data_currency: 'EUR',\n          data_shipping: 5.22,\n          data_taxes: 73.76,\n          data_total: 555,\n          globals_pagegroup: 'shop',\n        },\n      },\n    ],\n  ],\n};\n\n/**\n * Identify with $set and $set_once - per-event mapping fires\n * client.identify() with person properties. silent: true suppresses capture.\n */\nexport const identifyWithSetAndSetOnce: PostHogStepExample = {\n  title: 'Identify with $set',\n  description:\n    'A user login fires PostHog identify with $set and $set_once person properties and skips the capture.',\n  in: getEvent('user login', {\n    timestamp: 1700000102,\n    data: {\n      user_id: 'new-user-123',\n      email: 'user@acme.com',\n      plan: 'premium',\n    },\n  }),\n  mapping: {\n    silent: true,\n    settings: {\n      identify: {\n        map: {\n          distinctId: 'data.user_id',\n          $set: {\n            map: {\n              email: 'data.email',\n              plan: 'data.plan',\n            },\n          },\n          $set_once: {\n            map: {\n              first_login: 'timestamp',\n            },\n          },\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'client.identify',\n      {\n        distinctId: 'new-user-123',\n        properties: {\n          $set: {\n            email: 'user@acme.com',\n            plan: 'premium',\n          },\n          $set_once: {\n            first_login: 1700000102,\n          },\n        },\n      },\n    ],\n  ],\n};\n\n/**\n * Group identify with properties - per-event mapping fires\n * client.groupIdentify() with group properties. silent: true suppresses capture.\n */\nexport const groupIdentifyWithProperties: PostHogStepExample = {\n  title: 'Group identify',\n  description:\n    'A company update fires PostHog groupIdentify with group type, key, and associated group properties.',\n  in: getEvent('company update', {\n    timestamp: 1700000103,\n    data: {\n      company_id: 'company_123',\n      company_name: 'Acme',\n      plan: 'enterprise',\n    },\n  }),\n  mapping: {\n    silent: true,\n    settings: {\n      group: {\n        map: {\n          type: { value: 'company' },\n          key: 'data.company_id',\n          properties: {\n            map: {\n              name: 'data.company_name',\n              plan: 'data.plan',\n            },\n          },\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'client.groupIdentify',\n      {\n        groupType: 'company',\n        groupKey: 'company_123',\n        properties: {\n          name: 'Acme',\n          plan: 'enterprise',\n        },\n      },\n    ],\n  ],\n};\n\n/**\n * Capture with group context - destination-level settings.group resolves\n * type + key (no properties). The capture call includes groups.\n */\nexport const captureWithGroupContext: PostHogStepExample = {\n  title: 'Capture with group',\n  description:\n    'A destination-level group mapping attaches the resolved group context to every PostHog capture call.',\n  in: getEvent('page view', {\n    timestamp: 1700000104,\n    globals: { pagegroup: 'docs', company_id: 'company_123' },\n  }),\n  settings: {\n    group: {\n      map: {\n        type: { value: 'company' },\n        key: 'globals.company_id',\n      },\n    },\n  },\n  out: [\n    [\n      'client.capture',\n      {\n        distinctId: 'us3r',\n        event: 'page view',\n        properties: {},\n        groups: { company: 'company_123' },\n      },\n    ],\n  ],\n};\n\n/**\n * Consent revoked - client.disable() is called.\n */\nexport const consentRevoke: PostHogStepExample = {\n  title: 'Consent revoked',\n  description:\n    'A walker consent command with analytics denied calls client.disable on the PostHog client.',\n  command: 'consent',\n  in: { analytics: false } as WalkerOS.Consent,\n  settings: {} as Partial<Settings>,\n  out: [['client.disable']],\n};\n\n/**\n * Consent granted - client.enable() is called.\n */\nexport const consentGrant: PostHogStepExample = {\n  title: 'Consent granted',\n  description:\n    'A walker consent command with analytics granted calls client.enable on the PostHog client.',\n  command: 'consent',\n  in: { analytics: true } as WalkerOS.Consent,\n  settings: {} as Partial<Settings>,\n  out: [['client.enable']],\n};\n"],"mappings":"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","names":["import_dev","import_dev"]}
+{"version":3,"sources":["../src/dev.ts","../src/schemas/index.ts","../src/schemas/settings.ts","../src/schemas/mapping.ts","../src/examples/index.ts","../src/examples/env.ts","../src/examples/step.ts"],"sourcesContent":["export * as schemas from './schemas';\nexport * as examples from './examples';\n","import { zodToSchema } from '@walkeros/core/dev';\nimport { SettingsSchema } from './settings';\nimport { MappingSchema } from './mapping';\n\nexport { SettingsSchema, type Settings } from './settings';\nexport { MappingSchema, type Mapping } from './mapping';\n\n// JSON Schema\nexport const settings = zodToSchema(SettingsSchema);\nexport const mapping = zodToSchema(MappingSchema);\n","import { z } from '@walkeros/core/dev';\n\nexport const SettingsSchema = z.object({\n  apiKey: z\n    .string()\n    .min(1)\n    .describe(\n      'PostHog project API key (starts with \"phc_\"). Find it in PostHog project settings.',\n    ),\n  host: z\n    .string()\n    .describe(\n      'PostHog API host. Defaults to https://us.i.posthog.com. Use https://eu.i.posthog.com for EU or your self-hosted URL.',\n    )\n    .optional(),\n  flushAt: z\n    .number()\n    .describe('Number of events queued before auto-flush. Default: 20.')\n    .optional(),\n  flushInterval: z\n    .number()\n    .describe('Milliseconds between periodic flushes. Default: 10000.')\n    .optional(),\n  personalApiKey: z\n    .string()\n    .describe('Personal API key (phx_...) for local feature flag evaluation.')\n    .optional(),\n  featureFlagsPollingInterval: z\n    .number()\n    .describe(\n      'Milliseconds between feature flag definition polls. Default: 30000.',\n    )\n    .optional(),\n  disableGeoip: z\n    .boolean()\n    .describe('Disable GeoIP lookups globally. Useful for GDPR compliance.')\n    .optional(),\n  debug: z\n    .boolean()\n    .describe('Enable PostHog SDK debug logging. Default: false.')\n    .optional(),\n  identify: z\n    .unknown()\n    .describe(\n      'walkerOS mapping value resolving to an identity object. Keys: distinctId, $set, $set_once. Resolved on every push (server is stateless).',\n    )\n    .optional(),\n  group: z\n    .unknown()\n    .describe(\n      'walkerOS mapping value resolving to a group object. Keys: type, key, properties. Resolved on every push.',\n    )\n    .optional(),\n  include: z\n    .array(z.string())\n    .describe(\n      'Event sections to flatten into capture() properties (e.g. [\"data\", \"globals\"]).',\n    )\n    .optional(),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { z } from '@walkeros/core/dev';\n\nexport const MappingSchema = z.object({\n  identify: z\n    .unknown()\n    .describe(\n      'Per-event identity mapping. Resolves to { distinctId, $set?, $set_once? }. Fires client.identify() when $set/$set_once present.',\n    )\n    .optional(),\n  group: z\n    .unknown()\n    .describe(\n      'Group assignment. Resolves to { type, key, properties? }. Fires client.groupIdentify() when properties present, adds groups to capture().',\n    )\n    .optional(),\n});\n\nexport type Mapping = z.infer<typeof MappingSchema>;\n","export * as env from './env';\nexport * as step from './step';\n","import type { Env } from '../types';\n\n/**\n * Mock PostHog class that records method calls for testing.\n * Follows the BigQuery env.BigQuery constructor injection pattern.\n */\nfunction createMockPostHog() {\n  return class MockPostHog {\n    apiKey: string;\n    options: Record<string, unknown>;\n    calls: Array<{ method: string; args: unknown[] }>;\n\n    constructor(apiKey: string, options?: Record<string, unknown>) {\n      this.apiKey = apiKey;\n      this.options = options || {};\n      this.calls = [];\n    }\n\n    capture(params: Record<string, unknown>) {\n      this.calls.push({ method: 'capture', args: [params] });\n    }\n\n    identify(params: Record<string, unknown>) {\n      this.calls.push({ method: 'identify', args: [params] });\n    }\n\n    groupIdentify(params: Record<string, unknown>) {\n      this.calls.push({ method: 'groupIdentify', args: [params] });\n    }\n\n    flush() {\n      this.calls.push({ method: 'flush', args: [] });\n      return Promise.resolve();\n    }\n\n    async shutdown() {\n      this.calls.push({ method: 'shutdown', args: [] });\n    }\n\n    enable() {\n      this.calls.push({ method: 'enable', args: [] });\n    }\n\n    disable() {\n      this.calls.push({ method: 'disable', args: [] });\n    }\n  };\n}\n\n/**\n * Standard mock environment for push operations.\n * Injects a mock PostHog class constructor via env.PostHog.\n */\nexport const push: Env = {\n  get PostHog() {\n    return createMockPostHog() as unknown as Env['PostHog'];\n  },\n};\n\n/** Simulation tracking paths for CLI --simulate. */\nexport const simulation = [\n  'call:client.capture',\n  'call:client.identify',\n  'call:client.groupIdentify',\n  'call:client.shutdown',\n];\n","import type { Flow, WalkerOS } from '@walkeros/core';\nimport { getEvent } from '@walkeros/core';\nimport type { Settings } from '../types';\n\n/**\n * PostHog server step examples carry destination-level settings and\n * optional configInclude for the test runner to wire up.\n *\n * At push time the destination invokes methods on a `client` constructed\n * via `env.PostHog`. Each `out` tuple is `['client.<method>', ...args]`\n * matching the underlying SDK signature. Multiple calls (identify +\n * capture, groupIdentify + capture) are expressed as a tuple list.\n */\nexport type PostHogStepExample = Flow.StepExample & {\n  settings?: Partial<Settings>;\n  configInclude?: string[];\n  /** Consent granted before `in` so a gated destination is loaded first. */\n  before?: WalkerOS.Consent;\n};\n\n/**\n * Default event forwarding - every walkerOS event becomes\n * client.capture({ distinctId, event, properties }). With no mapping\n * and no include, properties is {}. distinctId falls back to event.user.id.\n */\nexport const defaultCapture: PostHogStepExample = {\n  title: 'Default capture',\n  description:\n    'A walker event becomes a PostHog capture call with the user id as distinctId and no extra properties.',\n  in: getEvent('product view', { timestamp: 1700000100 }),\n  out: [\n    [\n      'client.capture',\n      {\n        distinctId: 'us3r',\n        event: 'product view',\n        properties: {},\n      },\n    ],\n  ],\n};\n\n/**\n * Capture with include - destination-level include flattens data and\n * globals sections into prefixed properties.\n */\nexport const captureWithInclude: PostHogStepExample = {\n  title: 'Capture with include',\n  description:\n    'Destination-level include flattens data and globals sections into prefixed PostHog event properties.',\n  in: getEvent('order complete', { timestamp: 1700000101 }),\n  configInclude: ['data', 'globals'],\n  out: [\n    [\n      'client.capture',\n      {\n        distinctId: 'us3r',\n        event: 'order complete',\n        properties: {\n          data_id: '0rd3r1d',\n          data_currency: 'EUR',\n          data_shipping: 5.22,\n          data_taxes: 73.76,\n          data_total: 555,\n          globals_pagegroup: 'shop',\n        },\n      },\n    ],\n  ],\n};\n\n/**\n * Identify with $set and $set_once - per-event mapping fires\n * client.identify() with person properties. silent: true suppresses capture.\n */\nexport const identifyWithSetAndSetOnce: PostHogStepExample = {\n  title: 'Identify with $set',\n  description:\n    'A user login fires PostHog identify with $set and $set_once person properties and skips the capture.',\n  in: getEvent('user login', {\n    timestamp: 1700000102,\n    data: {\n      user_id: 'new-user-123',\n      email: 'user@acme.com',\n      plan: 'premium',\n    },\n  }),\n  mapping: {\n    silent: true,\n    settings: {\n      identify: {\n        map: {\n          distinctId: 'data.user_id',\n          $set: {\n            map: {\n              email: 'data.email',\n              plan: 'data.plan',\n            },\n          },\n          $set_once: {\n            map: {\n              first_login: 'timestamp',\n            },\n          },\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'client.identify',\n      {\n        distinctId: 'new-user-123',\n        properties: {\n          $set: {\n            email: 'user@acme.com',\n            plan: 'premium',\n          },\n          $set_once: {\n            first_login: 1700000102,\n          },\n        },\n      },\n    ],\n  ],\n};\n\n/**\n * Group identify with properties - per-event mapping fires\n * client.groupIdentify() with group properties. silent: true suppresses capture.\n */\nexport const groupIdentifyWithProperties: PostHogStepExample = {\n  title: 'Group identify',\n  description:\n    'A company update fires PostHog groupIdentify with group type, key, and associated group properties.',\n  in: getEvent('company update', {\n    timestamp: 1700000103,\n    data: {\n      company_id: 'company_123',\n      company_name: 'Acme',\n      plan: 'enterprise',\n    },\n  }),\n  mapping: {\n    silent: true,\n    settings: {\n      group: {\n        map: {\n          type: { value: 'company' },\n          key: 'data.company_id',\n          properties: {\n            map: {\n              name: 'data.company_name',\n              plan: 'data.plan',\n            },\n          },\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'client.groupIdentify',\n      {\n        groupType: 'company',\n        groupKey: 'company_123',\n        properties: {\n          name: 'Acme',\n          plan: 'enterprise',\n        },\n      },\n    ],\n  ],\n};\n\n/**\n * Capture with group context - destination-level settings.group resolves\n * type + key (no properties). The capture call includes groups.\n */\nexport const captureWithGroupContext: PostHogStepExample = {\n  title: 'Capture with group',\n  description:\n    'A destination-level group mapping attaches the resolved group context to every PostHog capture call.',\n  in: getEvent('page view', {\n    timestamp: 1700000104,\n    globals: { pagegroup: 'docs', company_id: 'company_123' },\n  }),\n  settings: {\n    group: {\n      map: {\n        type: { value: 'company' },\n        key: 'globals.company_id',\n      },\n    },\n  },\n  out: [\n    [\n      'client.capture',\n      {\n        distinctId: 'us3r',\n        event: 'page view',\n        properties: {},\n        groups: { company: 'company_123' },\n      },\n    ],\n  ],\n};\n\n/**\n * Consent revoked - after analytics consent is granted (PostHog loads and is\n * enabled), revoking it calls client.disable() via the on('consent') handler.\n * The destination is never loaded under denied consent, so the disable is a\n * real revocation of an already-granted destination.\n */\nexport const consentRevoke: PostHogStepExample = {\n  title: 'Consent revoked',\n  description:\n    'A walker consent command with analytics denied calls client.disable on the PostHog client.',\n  command: 'consent',\n  before: { analytics: true },\n  in: { analytics: false } as WalkerOS.Consent,\n  settings: {} as Partial<Settings>,\n  out: [['client.enable'], ['client.disable']],\n};\n\n/**\n * Consent granted - client.enable() is called.\n */\nexport const consentGrant: PostHogStepExample = {\n  title: 'Consent granted',\n  description:\n    'A walker consent command with analytics granted calls client.enable on the PostHog client.',\n  command: 'consent',\n  in: { analytics: true } as WalkerOS.Consent,\n  settings: {} as Partial<Settings>,\n  out: [['client.enable']],\n};\n"],"mappings":"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","names":["import_dev","import_dev"]}

package/dist/dev.mjs

@@ -1 +1 @@
-var e=Object.defineProperty,t=(t,i)=>{for(var o in i)e(t,o,{get:i[o],enumerable:!0})},i={};t(i,{MappingSchema:()=>r,SettingsSchema:()=>n,mapping:()=>l,settings:()=>p});import{zodToSchema as o}from"@walkeros/core/dev";import{z as s}from"@walkeros/core/dev";var n=s.object({apiKey:s.string().min(1).describe('PostHog project API key (starts with "phc_"). Find it in PostHog project settings.'),host:s.string().describe("PostHog API host. Defaults to https://us.i.posthog.com. Use https://eu.i.posthog.com for EU or your self-hosted URL.").optional(),flushAt:s.number().describe("Number of events queued before auto-flush. Default: 20.").optional(),flushInterval:s.number().describe("Milliseconds between periodic flushes. Default: 10000.").optional(),personalApiKey:s.string().describe("Personal API key (phx_...) for local feature flag evaluation.").optional(),featureFlagsPollingInterval:s.number().describe("Milliseconds between feature flag definition polls. Default: 30000.").optional(),disableGeoip:s.boolean().describe("Disable GeoIP lookups globally. Useful for GDPR compliance.").optional(),debug:s.boolean().describe("Enable PostHog SDK debug logging. Default: false.").optional(),identify:s.unknown().describe("walkerOS mapping value resolving to an identity object. Keys: distinctId, $set, $set_once. Resolved on every push (server is stateless).").optional(),group:s.unknown().describe("walkerOS mapping value resolving to a group object. Keys: type, key, properties. Resolved on every push.").optional(),include:s.array(s.string()).describe('Event sections to flatten into capture() properties (e.g. ["data", "globals"]).').optional()});import{z as a}from"@walkeros/core/dev";var r=a.object({identify:a.unknown().describe("Per-event identity mapping. Resolves to { distinctId, $set?, $set_once? }. Fires client.identify() when $set/$set_once present.").optional(),group:a.unknown().describe("Group assignment. Resolves to { type, key, properties? }. Fires client.groupIdentify() when properties present, adds groups to capture().").optional()}),p=o(n),l=o(r),c={};t(c,{env:()=>d,step:()=>g});var d={};t(d,{push:()=>u,simulation:()=>m});var u={get PostHog(){return class{apiKey;options;calls;constructor(e,t){this.apiKey=e,this.options=t||{},this.calls=[]}capture(e){this.calls.push({method:"capture",args:[e]})}identify(e){this.calls.push({method:"identify",args:[e]})}groupIdentify(e){this.calls.push({method:"groupIdentify",args:[e]})}flush(){return this.calls.push({method:"flush",args:[]}),Promise.resolve()}async shutdown(){this.calls.push({method:"shutdown",args:[]})}enable(){this.calls.push({method:"enable",args:[]})}disable(){this.calls.push({method:"disable",args:[]})}}}},m=["call:client.capture","call:client.identify","call:client.groupIdentify","call:client.shutdown"],g={};t(g,{captureWithGroupContext:()=>w,captureWithInclude:()=>f,consentGrant:()=>k,consentRevoke:()=>_,defaultCapture:()=>y,groupIdentifyWithProperties:()=>v,identifyWithSetAndSetOnce:()=>b});import{getEvent as h}from"@walkeros/core";var y={title:"Default capture",description:"A walker event becomes a PostHog capture call with the user id as distinctId and no extra properties.",in:h("product view",{timestamp:1700000100}),out:[["client.capture",{distinctId:"us3r",event:"product view",properties:{}}]]},f={title:"Capture with include",description:"Destination-level include flattens data and globals sections into prefixed PostHog event properties.",in:h("order complete",{timestamp:1700000101}),configInclude:["data","globals"],out:[["client.capture",{distinctId:"us3r",event:"order complete",properties:{data_id:"0rd3r1d",data_currency:"EUR",data_shipping:5.22,data_taxes:73.76,data_total:555,globals_pagegroup:"shop"}}]]},b={title:"Identify with $set",description:"A user login fires PostHog identify with $set and $set_once person properties and skips the capture.",in:h("user login",{timestamp:1700000102,data:{user_id:"new-user-123",email:"user@acme.com",plan:"premium"}}),mapping:{silent:!0,settings:{identify:{map:{distinctId:"data.user_id",$set:{map:{email:"data.email",plan:"data.plan"}},$set_once:{map:{first_login:"timestamp"}}}}}},out:[["client.identify",{distinctId:"new-user-123",properties:{$set:{email:"user@acme.com",plan:"premium"},$set_once:{first_login:1700000102}}}]]},v={title:"Group identify",description:"A company update fires PostHog groupIdentify with group type, key, and associated group properties.",in:h("company update",{timestamp:1700000103,data:{company_id:"company_123",company_name:"Acme",plan:"enterprise"}}),mapping:{silent:!0,settings:{group:{map:{type:{value:"company"},key:"data.company_id",properties:{map:{name:"data.company_name",plan:"data.plan"}}}}}},out:[["client.groupIdentify",{groupType:"company",groupKey:"company_123",properties:{name:"Acme",plan:"enterprise"}}]]},w={title:"Capture with group",description:"A destination-level group mapping attaches the resolved group context to every PostHog capture call.",in:h("page view",{timestamp:1700000104,globals:{pagegroup:"docs",company_id:"company_123"}}),settings:{group:{map:{type:{value:"company"},key:"globals.company_id"}}},out:[["client.capture",{distinctId:"us3r",event:"page view",properties:{},groups:{company:"company_123"}}]]},_={title:"Consent revoked",description:"A walker consent command with analytics denied calls client.disable on the PostHog client.",command:"consent",in:{analytics:!1},settings:{},out:[["client.disable"]]},k={title:"Consent granted",description:"A walker consent command with analytics granted calls client.enable on the PostHog client.",command:"consent",in:{analytics:!0},settings:{},out:[["client.enable"]]};export{c as examples,i as schemas};//# sourceMappingURL=dev.mjs.map
+var e=Object.defineProperty,t=(t,i)=>{for(var o in i)e(t,o,{get:i[o],enumerable:!0})},i={};t(i,{MappingSchema:()=>r,SettingsSchema:()=>n,mapping:()=>l,settings:()=>p});import{zodToSchema as o}from"@walkeros/core/dev";import{z as s}from"@walkeros/core/dev";var n=s.object({apiKey:s.string().min(1).describe('PostHog project API key (starts with "phc_"). Find it in PostHog project settings.'),host:s.string().describe("PostHog API host. Defaults to https://us.i.posthog.com. Use https://eu.i.posthog.com for EU or your self-hosted URL.").optional(),flushAt:s.number().describe("Number of events queued before auto-flush. Default: 20.").optional(),flushInterval:s.number().describe("Milliseconds between periodic flushes. Default: 10000.").optional(),personalApiKey:s.string().describe("Personal API key (phx_...) for local feature flag evaluation.").optional(),featureFlagsPollingInterval:s.number().describe("Milliseconds between feature flag definition polls. Default: 30000.").optional(),disableGeoip:s.boolean().describe("Disable GeoIP lookups globally. Useful for GDPR compliance.").optional(),debug:s.boolean().describe("Enable PostHog SDK debug logging. Default: false.").optional(),identify:s.unknown().describe("walkerOS mapping value resolving to an identity object. Keys: distinctId, $set, $set_once. Resolved on every push (server is stateless).").optional(),group:s.unknown().describe("walkerOS mapping value resolving to a group object. Keys: type, key, properties. Resolved on every push.").optional(),include:s.array(s.string()).describe('Event sections to flatten into capture() properties (e.g. ["data", "globals"]).').optional()});import{z as a}from"@walkeros/core/dev";var r=a.object({identify:a.unknown().describe("Per-event identity mapping. Resolves to { distinctId, $set?, $set_once? }. Fires client.identify() when $set/$set_once present.").optional(),group:a.unknown().describe("Group assignment. Resolves to { type, key, properties? }. Fires client.groupIdentify() when properties present, adds groups to capture().").optional()}),p=o(n),l=o(r),c={};t(c,{env:()=>d,step:()=>g});var d={};t(d,{push:()=>u,simulation:()=>m});var u={get PostHog(){return class{apiKey;options;calls;constructor(e,t){this.apiKey=e,this.options=t||{},this.calls=[]}capture(e){this.calls.push({method:"capture",args:[e]})}identify(e){this.calls.push({method:"identify",args:[e]})}groupIdentify(e){this.calls.push({method:"groupIdentify",args:[e]})}flush(){return this.calls.push({method:"flush",args:[]}),Promise.resolve()}async shutdown(){this.calls.push({method:"shutdown",args:[]})}enable(){this.calls.push({method:"enable",args:[]})}disable(){this.calls.push({method:"disable",args:[]})}}}},m=["call:client.capture","call:client.identify","call:client.groupIdentify","call:client.shutdown"],g={};t(g,{captureWithGroupContext:()=>w,captureWithInclude:()=>f,consentGrant:()=>k,consentRevoke:()=>_,defaultCapture:()=>y,groupIdentifyWithProperties:()=>v,identifyWithSetAndSetOnce:()=>b});import{getEvent as h}from"@walkeros/core";var y={title:"Default capture",description:"A walker event becomes a PostHog capture call with the user id as distinctId and no extra properties.",in:h("product view",{timestamp:1700000100}),out:[["client.capture",{distinctId:"us3r",event:"product view",properties:{}}]]},f={title:"Capture with include",description:"Destination-level include flattens data and globals sections into prefixed PostHog event properties.",in:h("order complete",{timestamp:1700000101}),configInclude:["data","globals"],out:[["client.capture",{distinctId:"us3r",event:"order complete",properties:{data_id:"0rd3r1d",data_currency:"EUR",data_shipping:5.22,data_taxes:73.76,data_total:555,globals_pagegroup:"shop"}}]]},b={title:"Identify with $set",description:"A user login fires PostHog identify with $set and $set_once person properties and skips the capture.",in:h("user login",{timestamp:1700000102,data:{user_id:"new-user-123",email:"user@acme.com",plan:"premium"}}),mapping:{silent:!0,settings:{identify:{map:{distinctId:"data.user_id",$set:{map:{email:"data.email",plan:"data.plan"}},$set_once:{map:{first_login:"timestamp"}}}}}},out:[["client.identify",{distinctId:"new-user-123",properties:{$set:{email:"user@acme.com",plan:"premium"},$set_once:{first_login:1700000102}}}]]},v={title:"Group identify",description:"A company update fires PostHog groupIdentify with group type, key, and associated group properties.",in:h("company update",{timestamp:1700000103,data:{company_id:"company_123",company_name:"Acme",plan:"enterprise"}}),mapping:{silent:!0,settings:{group:{map:{type:{value:"company"},key:"data.company_id",properties:{map:{name:"data.company_name",plan:"data.plan"}}}}}},out:[["client.groupIdentify",{groupType:"company",groupKey:"company_123",properties:{name:"Acme",plan:"enterprise"}}]]},w={title:"Capture with group",description:"A destination-level group mapping attaches the resolved group context to every PostHog capture call.",in:h("page view",{timestamp:1700000104,globals:{pagegroup:"docs",company_id:"company_123"}}),settings:{group:{map:{type:{value:"company"},key:"globals.company_id"}}},out:[["client.capture",{distinctId:"us3r",event:"page view",properties:{},groups:{company:"company_123"}}]]},_={title:"Consent revoked",description:"A walker consent command with analytics denied calls client.disable on the PostHog client.",command:"consent",before:{analytics:!0},in:{analytics:!1},settings:{},out:[["client.enable"],["client.disable"]]},k={title:"Consent granted",description:"A walker consent command with analytics granted calls client.enable on the PostHog client.",command:"consent",in:{analytics:!0},settings:{},out:[["client.enable"]]};export{c as examples,i as schemas};//# sourceMappingURL=dev.mjs.map

package/dist/dev.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/schemas/index.ts","../src/schemas/settings.ts","../src/schemas/mapping.ts","../src/examples/index.ts","../src/examples/env.ts","../src/examples/step.ts"],"sourcesContent":["import { zodToSchema } from '@walkeros/core/dev';\nimport { SettingsSchema } from './settings';\nimport { MappingSchema } from './mapping';\n\nexport { SettingsSchema, type Settings } from './settings';\nexport { MappingSchema, type Mapping } from './mapping';\n\n// JSON Schema\nexport const settings = zodToSchema(SettingsSchema);\nexport const mapping = zodToSchema(MappingSchema);\n","import { z } from '@walkeros/core/dev';\n\nexport const SettingsSchema = z.object({\n  apiKey: z\n    .string()\n    .min(1)\n    .describe(\n      'PostHog project API key (starts with \"phc_\"). Find it in PostHog project settings.',\n    ),\n  host: z\n    .string()\n    .describe(\n      'PostHog API host. Defaults to https://us.i.posthog.com. Use https://eu.i.posthog.com for EU or your self-hosted URL.',\n    )\n    .optional(),\n  flushAt: z\n    .number()\n    .describe('Number of events queued before auto-flush. Default: 20.')\n    .optional(),\n  flushInterval: z\n    .number()\n    .describe('Milliseconds between periodic flushes. Default: 10000.')\n    .optional(),\n  personalApiKey: z\n    .string()\n    .describe('Personal API key (phx_...) for local feature flag evaluation.')\n    .optional(),\n  featureFlagsPollingInterval: z\n    .number()\n    .describe(\n      'Milliseconds between feature flag definition polls. Default: 30000.',\n    )\n    .optional(),\n  disableGeoip: z\n    .boolean()\n    .describe('Disable GeoIP lookups globally. Useful for GDPR compliance.')\n    .optional(),\n  debug: z\n    .boolean()\n    .describe('Enable PostHog SDK debug logging. Default: false.')\n    .optional(),\n  identify: z\n    .unknown()\n    .describe(\n      'walkerOS mapping value resolving to an identity object. Keys: distinctId, $set, $set_once. Resolved on every push (server is stateless).',\n    )\n    .optional(),\n  group: z\n    .unknown()\n    .describe(\n      'walkerOS mapping value resolving to a group object. Keys: type, key, properties. Resolved on every push.',\n    )\n    .optional(),\n  include: z\n    .array(z.string())\n    .describe(\n      'Event sections to flatten into capture() properties (e.g. [\"data\", \"globals\"]).',\n    )\n    .optional(),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { z } from '@walkeros/core/dev';\n\nexport const MappingSchema = z.object({\n  identify: z\n    .unknown()\n    .describe(\n      'Per-event identity mapping. Resolves to { distinctId, $set?, $set_once? }. Fires client.identify() when $set/$set_once present.',\n    )\n    .optional(),\n  group: z\n    .unknown()\n    .describe(\n      'Group assignment. Resolves to { type, key, properties? }. Fires client.groupIdentify() when properties present, adds groups to capture().',\n    )\n    .optional(),\n});\n\nexport type Mapping = z.infer<typeof MappingSchema>;\n","export * as env from './env';\nexport * as step from './step';\n","import type { Env } from '../types';\n\n/**\n * Mock PostHog class that records method calls for testing.\n * Follows the BigQuery env.BigQuery constructor injection pattern.\n */\nfunction createMockPostHog() {\n  return class MockPostHog {\n    apiKey: string;\n    options: Record<string, unknown>;\n    calls: Array<{ method: string; args: unknown[] }>;\n\n    constructor(apiKey: string, options?: Record<string, unknown>) {\n      this.apiKey = apiKey;\n      this.options = options || {};\n      this.calls = [];\n    }\n\n    capture(params: Record<string, unknown>) {\n      this.calls.push({ method: 'capture', args: [params] });\n    }\n\n    identify(params: Record<string, unknown>) {\n      this.calls.push({ method: 'identify', args: [params] });\n    }\n\n    groupIdentify(params: Record<string, unknown>) {\n      this.calls.push({ method: 'groupIdentify', args: [params] });\n    }\n\n    flush() {\n      this.calls.push({ method: 'flush', args: [] });\n      return Promise.resolve();\n    }\n\n    async shutdown() {\n      this.calls.push({ method: 'shutdown', args: [] });\n    }\n\n    enable() {\n      this.calls.push({ method: 'enable', args: [] });\n    }\n\n    disable() {\n      this.calls.push({ method: 'disable', args: [] });\n    }\n  };\n}\n\n/**\n * Standard mock environment for push operations.\n * Injects a mock PostHog class constructor via env.PostHog.\n */\nexport const push: Env = {\n  get PostHog() {\n    return createMockPostHog() as unknown as Env['PostHog'];\n  },\n};\n\n/** Simulation tracking paths for CLI --simulate. */\nexport const simulation = [\n  'call:client.capture',\n  'call:client.identify',\n  'call:client.groupIdentify',\n  'call:client.shutdown',\n];\n","import type { Flow, WalkerOS } from '@walkeros/core';\nimport { getEvent } from '@walkeros/core';\nimport type { Settings } from '../types';\n\n/**\n * PostHog server step examples carry destination-level settings and\n * optional configInclude for the test runner to wire up.\n *\n * At push time the destination invokes methods on a `client` constructed\n * via `env.PostHog`. Each `out` tuple is `['client.<method>', ...args]`\n * matching the underlying SDK signature. Multiple calls (identify +\n * capture, groupIdentify + capture) are expressed as a tuple list.\n */\nexport type PostHogStepExample = Flow.StepExample & {\n  settings?: Partial<Settings>;\n  configInclude?: string[];\n};\n\n/**\n * Default event forwarding - every walkerOS event becomes\n * client.capture({ distinctId, event, properties }). With no mapping\n * and no include, properties is {}. distinctId falls back to event.user.id.\n */\nexport const defaultCapture: PostHogStepExample = {\n  title: 'Default capture',\n  description:\n    'A walker event becomes a PostHog capture call with the user id as distinctId and no extra properties.',\n  in: getEvent('product view', { timestamp: 1700000100 }),\n  out: [\n    [\n      'client.capture',\n      {\n        distinctId: 'us3r',\n        event: 'product view',\n        properties: {},\n      },\n    ],\n  ],\n};\n\n/**\n * Capture with include - destination-level include flattens data and\n * globals sections into prefixed properties.\n */\nexport const captureWithInclude: PostHogStepExample = {\n  title: 'Capture with include',\n  description:\n    'Destination-level include flattens data and globals sections into prefixed PostHog event properties.',\n  in: getEvent('order complete', { timestamp: 1700000101 }),\n  configInclude: ['data', 'globals'],\n  out: [\n    [\n      'client.capture',\n      {\n        distinctId: 'us3r',\n        event: 'order complete',\n        properties: {\n          data_id: '0rd3r1d',\n          data_currency: 'EUR',\n          data_shipping: 5.22,\n          data_taxes: 73.76,\n          data_total: 555,\n          globals_pagegroup: 'shop',\n        },\n      },\n    ],\n  ],\n};\n\n/**\n * Identify with $set and $set_once - per-event mapping fires\n * client.identify() with person properties. silent: true suppresses capture.\n */\nexport const identifyWithSetAndSetOnce: PostHogStepExample = {\n  title: 'Identify with $set',\n  description:\n    'A user login fires PostHog identify with $set and $set_once person properties and skips the capture.',\n  in: getEvent('user login', {\n    timestamp: 1700000102,\n    data: {\n      user_id: 'new-user-123',\n      email: 'user@acme.com',\n      plan: 'premium',\n    },\n  }),\n  mapping: {\n    silent: true,\n    settings: {\n      identify: {\n        map: {\n          distinctId: 'data.user_id',\n          $set: {\n            map: {\n              email: 'data.email',\n              plan: 'data.plan',\n            },\n          },\n          $set_once: {\n            map: {\n              first_login: 'timestamp',\n            },\n          },\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'client.identify',\n      {\n        distinctId: 'new-user-123',\n        properties: {\n          $set: {\n            email: 'user@acme.com',\n            plan: 'premium',\n          },\n          $set_once: {\n            first_login: 1700000102,\n          },\n        },\n      },\n    ],\n  ],\n};\n\n/**\n * Group identify with properties - per-event mapping fires\n * client.groupIdentify() with group properties. silent: true suppresses capture.\n */\nexport const groupIdentifyWithProperties: PostHogStepExample = {\n  title: 'Group identify',\n  description:\n    'A company update fires PostHog groupIdentify with group type, key, and associated group properties.',\n  in: getEvent('company update', {\n    timestamp: 1700000103,\n    data: {\n      company_id: 'company_123',\n      company_name: 'Acme',\n      plan: 'enterprise',\n    },\n  }),\n  mapping: {\n    silent: true,\n    settings: {\n      group: {\n        map: {\n          type: { value: 'company' },\n          key: 'data.company_id',\n          properties: {\n            map: {\n              name: 'data.company_name',\n              plan: 'data.plan',\n            },\n          },\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'client.groupIdentify',\n      {\n        groupType: 'company',\n        groupKey: 'company_123',\n        properties: {\n          name: 'Acme',\n          plan: 'enterprise',\n        },\n      },\n    ],\n  ],\n};\n\n/**\n * Capture with group context - destination-level settings.group resolves\n * type + key (no properties). The capture call includes groups.\n */\nexport const captureWithGroupContext: PostHogStepExample = {\n  title: 'Capture with group',\n  description:\n    'A destination-level group mapping attaches the resolved group context to every PostHog capture call.',\n  in: getEvent('page view', {\n    timestamp: 1700000104,\n    globals: { pagegroup: 'docs', company_id: 'company_123' },\n  }),\n  settings: {\n    group: {\n      map: {\n        type: { value: 'company' },\n        key: 'globals.company_id',\n      },\n    },\n  },\n  out: [\n    [\n      'client.capture',\n      {\n        distinctId: 'us3r',\n        event: 'page view',\n        properties: {},\n        groups: { company: 'company_123' },\n      },\n    ],\n  ],\n};\n\n/**\n * Consent revoked - client.disable() is called.\n */\nexport const consentRevoke: PostHogStepExample = {\n  title: 'Consent revoked',\n  description:\n    'A walker consent command with analytics denied calls client.disable on the PostHog client.',\n  command: 'consent',\n  in: { analytics: false } as WalkerOS.Consent,\n  settings: {} as Partial<Settings>,\n  out: [['client.disable']],\n};\n\n/**\n * Consent granted - client.enable() is called.\n */\nexport const consentGrant: PostHogStepExample = {\n  title: 'Consent granted',\n  description:\n    'A walker consent command with analytics granted calls client.enable on the PostHog client.',\n  command: 'consent',\n  in: { analytics: true } as WalkerOS.Consent,\n  settings: {} as Partial<Settings>,\n  out: [['client.enable']],\n};\n"],"mappings":";;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,SAAS,mBAAmB;;;ACA5B,SAAS,SAAS;AAEX,IAAM,iBAAiB,EAAE,OAAO;AAAA,EACrC,QAAQ,EACL,OAAO,EACP,IAAI,CAAC,EACL;AAAA,IACC;AAAA,EACF;AAAA,EACF,MAAM,EACH,OAAO,EACP;AAAA,IACC;AAAA,EACF,EACC,SAAS;AAAA,EACZ,SAAS,EACN,OAAO,EACP,SAAS,yDAAyD,EAClE,SAAS;AAAA,EACZ,eAAe,EACZ,OAAO,EACP,SAAS,wDAAwD,EACjE,SAAS;AAAA,EACZ,gBAAgB,EACb,OAAO,EACP,SAAS,+DAA+D,EACxE,SAAS;AAAA,EACZ,6BAA6B,EAC1B,OAAO,EACP;AAAA,IACC;AAAA,EACF,EACC,SAAS;AAAA,EACZ,cAAc,EACX,QAAQ,EACR,SAAS,6DAA6D,EACtE,SAAS;AAAA,EACZ,OAAO,EACJ,QAAQ,EACR,SAAS,mDAAmD,EAC5D,SAAS;AAAA,EACZ,UAAU,EACP,QAAQ,EACR;AAAA,IACC;AAAA,EACF,EACC,SAAS;AAAA,EACZ,OAAO,EACJ,QAAQ,EACR;AAAA,IACC;AAAA,EACF,EACC,SAAS;AAAA,EACZ,SAAS,EACN,MAAM,EAAE,OAAO,CAAC,EAChB;AAAA,IACC;AAAA,EACF,EACC,SAAS;AACd,CAAC;;;AC3DD,SAAS,KAAAA,UAAS;AAEX,IAAM,gBAAgBA,GAAE,OAAO;AAAA,EACpC,UAAUA,GACP,QAAQ,EACR;AAAA,IACC;AAAA,EACF,EACC,SAAS;AAAA,EACZ,OAAOA,GACJ,QAAQ,EACR;AAAA,IACC;AAAA,EACF,EACC,SAAS;AACd,CAAC;;;AFPM,IAAM,WAAW,YAAY,cAAc;AAC3C,IAAM,UAAU,YAAY,aAAa;;;AGThD;AAAA;AAAA;AAAA;AAAA;;;ACAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,oBAAoB;AAC3B,SAAO,MAAM,YAAY;AAAA,IACvB;AAAA,IACA;AAAA,IACA;AAAA,IAEA,YAAY,QAAgB,SAAmC;AAC7D,WAAK,SAAS;AACd,WAAK,UAAU,WAAW,CAAC;AAC3B,WAAK,QAAQ,CAAC;AAAA,IAChB;AAAA,IAEA,QAAQ,QAAiC;AACvC,WAAK,MAAM,KAAK,EAAE,QAAQ,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC;AAAA,IACvD;AAAA,IAEA,SAAS,QAAiC;AACxC,WAAK,MAAM,KAAK,EAAE,QAAQ,YAAY,MAAM,CAAC,MAAM,EAAE,CAAC;AAAA,IACxD;AAAA,IAEA,cAAc,QAAiC;AAC7C,WAAK,MAAM,KAAK,EAAE,QAAQ,iBAAiB,MAAM,CAAC,MAAM,EAAE,CAAC;AAAA,IAC7D;AAAA,IAEA,QAAQ;AACN,WAAK,MAAM,KAAK,EAAE,QAAQ,SAAS,MAAM,CAAC,EAAE,CAAC;AAC7C,aAAO,QAAQ,QAAQ;AAAA,IACzB;AAAA,IAEA,MAAM,WAAW;AACf,WAAK,MAAM,KAAK,EAAE,QAAQ,YAAY,MAAM,CAAC,EAAE,CAAC;AAAA,IAClD;AAAA,IAEA,SAAS;AACP,WAAK,MAAM,KAAK,EAAE,QAAQ,UAAU,MAAM,CAAC,EAAE,CAAC;AAAA,IAChD;AAAA,IAEA,UAAU;AACR,WAAK,MAAM,KAAK,EAAE,QAAQ,WAAW,MAAM,CAAC,EAAE,CAAC;AAAA,IACjD;AAAA,EACF;AACF;AAMO,IAAM,OAAY;AAAA,EACvB,IAAI,UAAU;AACZ,WAAO,kBAAkB;AAAA,EAC3B;AACF;AAGO,IAAM,aAAa;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;;;ACjEA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,SAAS,gBAAgB;AAsBlB,IAAM,iBAAqC;AAAA,EAChD,OAAO;AAAA,EACP,aACE;AAAA,EACF,IAAI,SAAS,gBAAgB,EAAE,WAAW,WAAW,CAAC;AAAA,EACtD,KAAK;AAAA,IACH;AAAA,MACE;AAAA,MACA;AAAA,QACE,YAAY;AAAA,QACZ,OAAO;AAAA,QACP,YAAY,CAAC;AAAA,MACf;AAAA,IACF;AAAA,EACF;AACF;AAMO,IAAM,qBAAyC;AAAA,EACpD,OAAO;AAAA,EACP,aACE;AAAA,EACF,IAAI,SAAS,kBAAkB,EAAE,WAAW,WAAW,CAAC;AAAA,EACxD,eAAe,CAAC,QAAQ,SAAS;AAAA,EACjC,KAAK;AAAA,IACH;AAAA,MACE;AAAA,MACA;AAAA,QACE,YAAY;AAAA,QACZ,OAAO;AAAA,QACP,YAAY;AAAA,UACV,SAAS;AAAA,UACT,eAAe;AAAA,UACf,eAAe;AAAA,UACf,YAAY;AAAA,UACZ,YAAY;AAAA,UACZ,mBAAmB;AAAA,QACrB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAMO,IAAM,4BAAgD;AAAA,EAC3D,OAAO;AAAA,EACP,aACE;AAAA,EACF,IAAI,SAAS,cAAc;AAAA,IACzB,WAAW;AAAA,IACX,MAAM;AAAA,MACJ,SAAS;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF,CAAC;AAAA,EACD,SAAS;AAAA,IACP,QAAQ;AAAA,IACR,UAAU;AAAA,MACR,UAAU;AAAA,QACR,KAAK;AAAA,UACH,YAAY;AAAA,UACZ,MAAM;AAAA,YACJ,KAAK;AAAA,cACH,OAAO;AAAA,cACP,MAAM;AAAA,YACR;AAAA,UACF;AAAA,UACA,WAAW;AAAA,YACT,KAAK;AAAA,cACH,aAAa;AAAA,YACf;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EACA,KAAK;AAAA,IACH;AAAA,MACE;AAAA,MACA;AAAA,QACE,YAAY;AAAA,QACZ,YAAY;AAAA,UACV,MAAM;AAAA,YACJ,OAAO;AAAA,YACP,MAAM;AAAA,UACR;AAAA,UACA,WAAW;AAAA,YACT,aAAa;AAAA,UACf;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAMO,IAAM,8BAAkD;AAAA,EAC7D,OAAO;AAAA,EACP,aACE;AAAA,EACF,IAAI,SAAS,kBAAkB;AAAA,IAC7B,WAAW;AAAA,IACX,MAAM;AAAA,MACJ,YAAY;AAAA,MACZ,cAAc;AAAA,MACd,MAAM;AAAA,IACR;AAAA,EACF,CAAC;AAAA,EACD,SAAS;AAAA,IACP,QAAQ;AAAA,IACR,UAAU;AAAA,MACR,OAAO;AAAA,QACL,KAAK;AAAA,UACH,MAAM,EAAE,OAAO,UAAU;AAAA,UACzB,KAAK;AAAA,UACL,YAAY;AAAA,YACV,KAAK;AAAA,cACH,MAAM;AAAA,cACN,MAAM;AAAA,YACR;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EACA,KAAK;AAAA,IACH;AAAA,MACE;AAAA,MACA;AAAA,QACE,WAAW;AAAA,QACX,UAAU;AAAA,QACV,YAAY;AAAA,UACV,MAAM;AAAA,UACN,MAAM;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAMO,IAAM,0BAA8C;AAAA,EACzD,OAAO;AAAA,EACP,aACE;AAAA,EACF,IAAI,SAAS,aAAa;AAAA,IACxB,WAAW;AAAA,IACX,SAAS,EAAE,WAAW,QAAQ,YAAY,cAAc;AAAA,EAC1D,CAAC;AAAA,EACD,UAAU;AAAA,IACR,OAAO;AAAA,MACL,KAAK;AAAA,QACH,MAAM,EAAE,OAAO,UAAU;AAAA,QACzB,KAAK;AAAA,MACP;AAAA,IACF;AAAA,EACF;AAAA,EACA,KAAK;AAAA,IACH;AAAA,MACE;AAAA,MACA;AAAA,QACE,YAAY;AAAA,QACZ,OAAO;AAAA,QACP,YAAY,CAAC;AAAA,QACb,QAAQ,EAAE,SAAS,cAAc;AAAA,MACnC;AAAA,IACF;AAAA,EACF;AACF;AAKO,IAAM,gBAAoC;AAAA,EAC/C,OAAO;AAAA,EACP,aACE;AAAA,EACF,SAAS;AAAA,EACT,IAAI,EAAE,WAAW,MAAM;AAAA,EACvB,UAAU,CAAC;AAAA,EACX,KAAK,CAAC,CAAC,gBAAgB,CAAC;AAC1B;AAKO,IAAM,eAAmC;AAAA,EAC9C,OAAO;AAAA,EACP,aACE;AAAA,EACF,SAAS;AAAA,EACT,IAAI,EAAE,WAAW,KAAK;AAAA,EACtB,UAAU,CAAC;AAAA,EACX,KAAK,CAAC,CAAC,eAAe,CAAC;AACzB;","names":["z"]}
+{"version":3,"sources":["../src/schemas/index.ts","../src/schemas/settings.ts","../src/schemas/mapping.ts","../src/examples/index.ts","../src/examples/env.ts","../src/examples/step.ts"],"sourcesContent":["import { zodToSchema } from '@walkeros/core/dev';\nimport { SettingsSchema } from './settings';\nimport { MappingSchema } from './mapping';\n\nexport { SettingsSchema, type Settings } from './settings';\nexport { MappingSchema, type Mapping } from './mapping';\n\n// JSON Schema\nexport const settings = zodToSchema(SettingsSchema);\nexport const mapping = zodToSchema(MappingSchema);\n","import { z } from '@walkeros/core/dev';\n\nexport const SettingsSchema = z.object({\n  apiKey: z\n    .string()\n    .min(1)\n    .describe(\n      'PostHog project API key (starts with \"phc_\"). Find it in PostHog project settings.',\n    ),\n  host: z\n    .string()\n    .describe(\n      'PostHog API host. Defaults to https://us.i.posthog.com. Use https://eu.i.posthog.com for EU or your self-hosted URL.',\n    )\n    .optional(),\n  flushAt: z\n    .number()\n    .describe('Number of events queued before auto-flush. Default: 20.')\n    .optional(),\n  flushInterval: z\n    .number()\n    .describe('Milliseconds between periodic flushes. Default: 10000.')\n    .optional(),\n  personalApiKey: z\n    .string()\n    .describe('Personal API key (phx_...) for local feature flag evaluation.')\n    .optional(),\n  featureFlagsPollingInterval: z\n    .number()\n    .describe(\n      'Milliseconds between feature flag definition polls. Default: 30000.',\n    )\n    .optional(),\n  disableGeoip: z\n    .boolean()\n    .describe('Disable GeoIP lookups globally. Useful for GDPR compliance.')\n    .optional(),\n  debug: z\n    .boolean()\n    .describe('Enable PostHog SDK debug logging. Default: false.')\n    .optional(),\n  identify: z\n    .unknown()\n    .describe(\n      'walkerOS mapping value resolving to an identity object. Keys: distinctId, $set, $set_once. Resolved on every push (server is stateless).',\n    )\n    .optional(),\n  group: z\n    .unknown()\n    .describe(\n      'walkerOS mapping value resolving to a group object. Keys: type, key, properties. Resolved on every push.',\n    )\n    .optional(),\n  include: z\n    .array(z.string())\n    .describe(\n      'Event sections to flatten into capture() properties (e.g. [\"data\", \"globals\"]).',\n    )\n    .optional(),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { z } from '@walkeros/core/dev';\n\nexport const MappingSchema = z.object({\n  identify: z\n    .unknown()\n    .describe(\n      'Per-event identity mapping. Resolves to { distinctId, $set?, $set_once? }. Fires client.identify() when $set/$set_once present.',\n    )\n    .optional(),\n  group: z\n    .unknown()\n    .describe(\n      'Group assignment. Resolves to { type, key, properties? }. Fires client.groupIdentify() when properties present, adds groups to capture().',\n    )\n    .optional(),\n});\n\nexport type Mapping = z.infer<typeof MappingSchema>;\n","export * as env from './env';\nexport * as step from './step';\n","import type { Env } from '../types';\n\n/**\n * Mock PostHog class that records method calls for testing.\n * Follows the BigQuery env.BigQuery constructor injection pattern.\n */\nfunction createMockPostHog() {\n  return class MockPostHog {\n    apiKey: string;\n    options: Record<string, unknown>;\n    calls: Array<{ method: string; args: unknown[] }>;\n\n    constructor(apiKey: string, options?: Record<string, unknown>) {\n      this.apiKey = apiKey;\n      this.options = options || {};\n      this.calls = [];\n    }\n\n    capture(params: Record<string, unknown>) {\n      this.calls.push({ method: 'capture', args: [params] });\n    }\n\n    identify(params: Record<string, unknown>) {\n      this.calls.push({ method: 'identify', args: [params] });\n    }\n\n    groupIdentify(params: Record<string, unknown>) {\n      this.calls.push({ method: 'groupIdentify', args: [params] });\n    }\n\n    flush() {\n      this.calls.push({ method: 'flush', args: [] });\n      return Promise.resolve();\n    }\n\n    async shutdown() {\n      this.calls.push({ method: 'shutdown', args: [] });\n    }\n\n    enable() {\n      this.calls.push({ method: 'enable', args: [] });\n    }\n\n    disable() {\n      this.calls.push({ method: 'disable', args: [] });\n    }\n  };\n}\n\n/**\n * Standard mock environment for push operations.\n * Injects a mock PostHog class constructor via env.PostHog.\n */\nexport const push: Env = {\n  get PostHog() {\n    return createMockPostHog() as unknown as Env['PostHog'];\n  },\n};\n\n/** Simulation tracking paths for CLI --simulate. */\nexport const simulation = [\n  'call:client.capture',\n  'call:client.identify',\n  'call:client.groupIdentify',\n  'call:client.shutdown',\n];\n","import type { Flow, WalkerOS } from '@walkeros/core';\nimport { getEvent } from '@walkeros/core';\nimport type { Settings } from '../types';\n\n/**\n * PostHog server step examples carry destination-level settings and\n * optional configInclude for the test runner to wire up.\n *\n * At push time the destination invokes methods on a `client` constructed\n * via `env.PostHog`. Each `out` tuple is `['client.<method>', ...args]`\n * matching the underlying SDK signature. Multiple calls (identify +\n * capture, groupIdentify + capture) are expressed as a tuple list.\n */\nexport type PostHogStepExample = Flow.StepExample & {\n  settings?: Partial<Settings>;\n  configInclude?: string[];\n  /** Consent granted before `in` so a gated destination is loaded first. */\n  before?: WalkerOS.Consent;\n};\n\n/**\n * Default event forwarding - every walkerOS event becomes\n * client.capture({ distinctId, event, properties }). With no mapping\n * and no include, properties is {}. distinctId falls back to event.user.id.\n */\nexport const defaultCapture: PostHogStepExample = {\n  title: 'Default capture',\n  description:\n    'A walker event becomes a PostHog capture call with the user id as distinctId and no extra properties.',\n  in: getEvent('product view', { timestamp: 1700000100 }),\n  out: [\n    [\n      'client.capture',\n      {\n        distinctId: 'us3r',\n        event: 'product view',\n        properties: {},\n      },\n    ],\n  ],\n};\n\n/**\n * Capture with include - destination-level include flattens data and\n * globals sections into prefixed properties.\n */\nexport const captureWithInclude: PostHogStepExample = {\n  title: 'Capture with include',\n  description:\n    'Destination-level include flattens data and globals sections into prefixed PostHog event properties.',\n  in: getEvent('order complete', { timestamp: 1700000101 }),\n  configInclude: ['data', 'globals'],\n  out: [\n    [\n      'client.capture',\n      {\n        distinctId: 'us3r',\n        event: 'order complete',\n        properties: {\n          data_id: '0rd3r1d',\n          data_currency: 'EUR',\n          data_shipping: 5.22,\n          data_taxes: 73.76,\n          data_total: 555,\n          globals_pagegroup: 'shop',\n        },\n      },\n    ],\n  ],\n};\n\n/**\n * Identify with $set and $set_once - per-event mapping fires\n * client.identify() with person properties. silent: true suppresses capture.\n */\nexport const identifyWithSetAndSetOnce: PostHogStepExample = {\n  title: 'Identify with $set',\n  description:\n    'A user login fires PostHog identify with $set and $set_once person properties and skips the capture.',\n  in: getEvent('user login', {\n    timestamp: 1700000102,\n    data: {\n      user_id: 'new-user-123',\n      email: 'user@acme.com',\n      plan: 'premium',\n    },\n  }),\n  mapping: {\n    silent: true,\n    settings: {\n      identify: {\n        map: {\n          distinctId: 'data.user_id',\n          $set: {\n            map: {\n              email: 'data.email',\n              plan: 'data.plan',\n            },\n          },\n          $set_once: {\n            map: {\n              first_login: 'timestamp',\n            },\n          },\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'client.identify',\n      {\n        distinctId: 'new-user-123',\n        properties: {\n          $set: {\n            email: 'user@acme.com',\n            plan: 'premium',\n          },\n          $set_once: {\n            first_login: 1700000102,\n          },\n        },\n      },\n    ],\n  ],\n};\n\n/**\n * Group identify with properties - per-event mapping fires\n * client.groupIdentify() with group properties. silent: true suppresses capture.\n */\nexport const groupIdentifyWithProperties: PostHogStepExample = {\n  title: 'Group identify',\n  description:\n    'A company update fires PostHog groupIdentify with group type, key, and associated group properties.',\n  in: getEvent('company update', {\n    timestamp: 1700000103,\n    data: {\n      company_id: 'company_123',\n      company_name: 'Acme',\n      plan: 'enterprise',\n    },\n  }),\n  mapping: {\n    silent: true,\n    settings: {\n      group: {\n        map: {\n          type: { value: 'company' },\n          key: 'data.company_id',\n          properties: {\n            map: {\n              name: 'data.company_name',\n              plan: 'data.plan',\n            },\n          },\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'client.groupIdentify',\n      {\n        groupType: 'company',\n        groupKey: 'company_123',\n        properties: {\n          name: 'Acme',\n          plan: 'enterprise',\n        },\n      },\n    ],\n  ],\n};\n\n/**\n * Capture with group context - destination-level settings.group resolves\n * type + key (no properties). The capture call includes groups.\n */\nexport const captureWithGroupContext: PostHogStepExample = {\n  title: 'Capture with group',\n  description:\n    'A destination-level group mapping attaches the resolved group context to every PostHog capture call.',\n  in: getEvent('page view', {\n    timestamp: 1700000104,\n    globals: { pagegroup: 'docs', company_id: 'company_123' },\n  }),\n  settings: {\n    group: {\n      map: {\n        type: { value: 'company' },\n        key: 'globals.company_id',\n      },\n    },\n  },\n  out: [\n    [\n      'client.capture',\n      {\n        distinctId: 'us3r',\n        event: 'page view',\n        properties: {},\n        groups: { company: 'company_123' },\n      },\n    ],\n  ],\n};\n\n/**\n * Consent revoked - after analytics consent is granted (PostHog loads and is\n * enabled), revoking it calls client.disable() via the on('consent') handler.\n * The destination is never loaded under denied consent, so the disable is a\n * real revocation of an already-granted destination.\n */\nexport const consentRevoke: PostHogStepExample = {\n  title: 'Consent revoked',\n  description:\n    'A walker consent command with analytics denied calls client.disable on the PostHog client.',\n  command: 'consent',\n  before: { analytics: true },\n  in: { analytics: false } as WalkerOS.Consent,\n  settings: {} as Partial<Settings>,\n  out: [['client.enable'], ['client.disable']],\n};\n\n/**\n * Consent granted - client.enable() is called.\n */\nexport const consentGrant: PostHogStepExample = {\n  title: 'Consent granted',\n  description:\n    'A walker consent command with analytics granted calls client.enable on the PostHog client.',\n  command: 'consent',\n  in: { analytics: true } as WalkerOS.Consent,\n  settings: {} as Partial<Settings>,\n  out: [['client.enable']],\n};\n"],"mappings":"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","names":["z"]}

package/dist/examples/index.d.mts

@@ -1,4 +1,4 @@
-import { Mapping, Flow } from '@walkeros/core';
+import { Mapping, Flow, WalkerOS } from '@walkeros/core';
 import { DestinationServer } from '@walkeros/server-core';
 import { PostHog } from 'posthog-node';
 
@@ -56,6 +56,8 @@ declare namespace env {
 type PostHogStepExample = Flow.StepExample & {
     settings?: Partial<Settings>;
     configInclude?: string[];
+    /** Consent granted before `in` so a gated destination is loaded first. */
+    before?: WalkerOS.Consent;
 };
 /**
  * Default event forwarding - every walkerOS event becomes
@@ -84,7 +86,10 @@ declare const groupIdentifyWithProperties: PostHogStepExample;
  */
 declare const captureWithGroupContext: PostHogStepExample;
 /**
- * Consent revoked - client.disable() is called.
+ * Consent revoked - after analytics consent is granted (PostHog loads and is
+ * enabled), revoking it calls client.disable() via the on('consent') handler.
+ * The destination is never loaded under denied consent, so the disable is a
+ * real revocation of an already-granted destination.
  */
 declare const consentRevoke: PostHogStepExample;
 /**

package/dist/examples/index.d.ts

@@ -1,4 +1,4 @@
-import { Mapping, Flow } from '@walkeros/core';
+import { Mapping, Flow, WalkerOS } from '@walkeros/core';
 import { DestinationServer } from '@walkeros/server-core';
 import { PostHog } from 'posthog-node';
 
@@ -56,6 +56,8 @@ declare namespace env {
 type PostHogStepExample = Flow.StepExample & {
     settings?: Partial<Settings>;
     configInclude?: string[];
+    /** Consent granted before `in` so a gated destination is loaded first. */
+    before?: WalkerOS.Consent;
 };
 /**
  * Default event forwarding - every walkerOS event becomes
@@ -84,7 +86,10 @@ declare const groupIdentifyWithProperties: PostHogStepExample;
  */
 declare const captureWithGroupContext: PostHogStepExample;
 /**
- * Consent revoked - client.disable() is called.
+ * Consent revoked - after analytics consent is granted (PostHog loads and is
+ * enabled), revoking it calls client.disable() via the on('consent') handler.
+ * The destination is never loaded under denied consent, so the disable is a
+ * real revocation of an already-granted destination.
  */
 declare const consentRevoke: PostHogStepExample;
 /**

package/dist/examples/index.js

@@ -250,9 +250,10 @@ var consentRevoke = {
   title: "Consent revoked",
   description: "A walker consent command with analytics denied calls client.disable on the PostHog client.",
   command: "consent",
+  before: { analytics: true },
   in: { analytics: false },
   settings: {},
-  out: [["client.disable"]]
+  out: [["client.enable"], ["client.disable"]]
 };
 var consentGrant = {
   title: "Consent granted",

package/dist/examples/index.mjs

@@ -229,9 +229,10 @@ var consentRevoke = {
   title: "Consent revoked",
   description: "A walker consent command with analytics denied calls client.disable on the PostHog client.",
   command: "consent",
+  before: { analytics: true },
   in: { analytics: false },
   settings: {},
-  out: [["client.disable"]]
+  out: [["client.enable"], ["client.disable"]]
 };
 var consentGrant = {
   title: "Consent granted",

package/dist/walkerOS.json

@@ -1,7 +1,7 @@
 {
   "$meta": {
     "package": "@walkeros/server-destination-posthog",
-    "version": "4.2.0",
+    "version": "4.2.1-next-1781538735002",
     "type": "destination",
     "platform": [
       "server"
@@ -137,7 +137,7 @@
           "consent": {
             "functional": true
           },
-          "id": "462c32df5835d1d0",
+          "id": "5bb02cf5bb227a5d",
           "trigger": "load",
           "entity": "page",
           "action": "view",
@@ -252,7 +252,7 @@
           "consent": {
             "functional": true
           },
-          "id": "dbff42a7890dd068",
+          "id": "c74328e3fff5e0f6",
           "trigger": "load",
           "entity": "order",
           "action": "complete",
@@ -303,11 +303,17 @@
         "title": "Consent revoked",
         "description": "A walker consent command with analytics denied calls client.disable on the PostHog client.",
         "command": "consent",
+        "before": {
+          "analytics": true
+        },
         "in": {
           "analytics": false
         },
         "settings": {},
         "out": [
+          [
+            "client.enable"
+          ],
           [
             "client.disable"
           ]
@@ -346,7 +352,7 @@
           "consent": {
             "functional": true
           },
-          "id": "da24a0793de931b5",
+          "id": "952430b104d6d904",
           "trigger": "load",
           "entity": "product",
           "action": "view",
@@ -406,7 +412,7 @@
           "consent": {
             "functional": true
           },
-          "id": "c84d2db167ef2ccb",
+          "id": "5da3a091489ff0bc",
           "trigger": "test",
           "entity": "company",
           "action": "update",
@@ -488,7 +494,7 @@
           "consent": {
             "functional": true
           },
-          "id": "e4ad447f30c90829",
+          "id": "693e3cb591845e92",
           "trigger": "test",
           "entity": "user",
           "action": "login",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@walkeros/server-destination-posthog",
   "description": "PostHog server destination for walkerOS",
-  "version": "4.2.0",
+  "version": "4.2.1-next-1781538735002",
   "license": "MIT",
   "exports": {
     ".": {
@@ -35,12 +35,12 @@
     "update": "npx npm-check-updates -u && npm update"
   },
   "dependencies": {
-    "@walkeros/core": "4.2.0",
-    "@walkeros/server-core": "4.2.0",
+    "@walkeros/core": "4.2.1-next-1781538735002",
+    "@walkeros/server-core": "4.2.1-next-1781538735002",
     "posthog-node": "^5.0.0"
   },
   "devDependencies": {
-    "@walkeros/collector": "4.2.0"
+    "@walkeros/collector": "4.2.1-next-1781538735002"
   },
   "repository": {
     "url": "git+https://github.com/elbwalker/walkerOS.git",