@walkeros/server-destination-posthog 3.3.0-next-1776098542393

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 elbWalker GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,147 @@
+<p align="left">
+  <a href="https://www.walkeros.io">
+    <img alt="walkerOS" title="walkerOS" src="https://www.walkeros.io/img/walkerOS_logo.svg" width="256px"/>
+  </a>
+</p>
+
+# PostHog Server Destination for walkerOS
+
+[Source Code](https://github.com/elbwalker/walkerOS/tree/main/packages/server/destinations/posthog)
+&bull;
+[NPM Package](https://www.npmjs.com/package/@walkeros/server-destination-posthog)
+
+walkerOS follows a **source -> collector -> destination** architecture. This
+PostHog destination receives processed events from the walkerOS collector and
+sends them server-to-server to PostHog using the `posthog-node` SDK, supporting
+capture, identify, groupIdentify, groups on capture, consent, and graceful
+shutdown.
+
+## Installation
+
+```sh
+npm install @walkeros/server-destination-posthog
+```
+
+## Usage
+
+### Minimal flow.json
+
+```json
+{
+  "destinations": {
+    "posthog": {
+      "package": "@walkeros/server-destination-posthog",
+      "config": {
+        "settings": {
+          "apiKey": "phc_..."
+        }
+      }
+    }
+  }
+}
+```
+
+### Programmatic
+
+```typescript
+import { startFlow } from '@walkeros/collector';
+import { destinationPostHog } from '@walkeros/server-destination-posthog';
+
+await startFlow({
+  destinations: {
+    posthog: {
+      code: destinationPostHog,
+      config: {
+        settings: {
+          apiKey: 'phc_...',
+          host: 'https://eu.i.posthog.com',
+        },
+      },
+    },
+  },
+});
+```
+
+## Settings
+
+| Name                          | Type       | Description                                        | Required |
+| ----------------------------- | ---------- | -------------------------------------------------- | -------- |
+| `apiKey`                      | `string`   | PostHog project API key (`phc_...`)                | Yes      |
+| `host`                        | `string`   | API endpoint (default: `https://us.i.posthog.com`) | No       |
+| `flushAt`                     | `number`   | Events queued before auto-flush (default: 20)      | No       |
+| `flushInterval`               | `number`   | ms between periodic flushes (default: 10000)       | No       |
+| `personalApiKey`              | `string`   | Personal API key for local flag evaluation         | No       |
+| `featureFlagsPollingInterval` | `number`   | ms between flag definition polls (default: 30000)  | No       |
+| `disableGeoip`                | `boolean`  | Disable GeoIP lookups (GDPR)                       | No       |
+| `debug`                       | `boolean`  | Enable SDK debug logging                           | No       |
+| `identify`                    | `Mapping`  | Destination-level identity mapping                 | No       |
+| `group`                       | `Mapping`  | Destination-level group mapping                    | No       |
+| `include`                     | `string[]` | Event sections flattened into properties           | No       |
+
+## Mapping Settings
+
+Per-event mapping settings override destination-level settings.
+
+| Name       | Type      | Description                                                      |
+| ---------- | --------- | ---------------------------------------------------------------- |
+| `identify` | `Mapping` | Resolves to `{ distinctId, $set?, $set_once? }` for `identify()` |
+| `group`    | `Mapping` | Resolves to `{ type, key, properties? }` for `groupIdentify()`   |
+
+## Identity
+
+Every PostHog server call requires a `distinctId`. Resolution order:
+
+1. Mapping-level `settings.identify.map.distinctId`
+2. Destination-level `settings.identify.map.distinctId`
+3. Fallback: `event.user.id`, `event.user.hash`, `event.user.session`, or
+   `'anonymous'`
+
+When `$set` or `$set_once` are present in the resolved identify object,
+`client.identify()` is called with the person properties nested under
+`properties: { $set, $set_once }`.
+
+## Groups
+
+Group analytics associates events with companies, teams, or projects.
+
+- **With properties**:
+  `client.groupIdentify({ groupType, groupKey, properties })`
+- **Without properties**: adds `groups: { [type]: key }` to `capture()` calls
+
+## Destroy / Shutdown
+
+The destination implements `destroy()` calling `client.shutdown()` to flush all
+queued events before the server flow exits. This is critical for ensuring no
+events are lost on process shutdown.
+
+## Self-Hosted PostHog
+
+Set `host` to your self-hosted PostHog instance URL:
+
+```json
+"settings": {
+  "apiKey": "phc_...",
+  "host": "https://posthog.your-domain.com"
+}
+```
+
+## Feature Flags
+
+Pass `personalApiKey` for local feature flag evaluation. Flag evaluation is not
+a destination concern; it is exposed via the SDK client instance.
+
+## Web Destination
+
+For browser-side PostHog integration, see
+[@walkeros/web-destination-posthog](https://www.npmjs.com/package/@walkeros/web-destination-posthog).
+
+## Contribute
+
+Feel free to contribute by submitting an
+[issue](https://github.com/elbwalker/walkerOS/issues), starting a
+[discussion](https://github.com/elbwalker/walkerOS/discussions), or getting in
+[contact](https://calendly.com/elb-alexander/30min).
+
+## License
+
+This project is licensed under the MIT License.

package/dist/dev.d.mts

@@ -0,0 +1,143 @@
+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 { DestinationServer } from '@walkeros/server-core';
+import { PostHog } from 'posthog-node';
+
+declare const SettingsSchema: z.ZodObject<{
+    apiKey: z.ZodString;
+    host: z.ZodOptional<z.ZodString>;
+    flushAt: z.ZodOptional<z.ZodNumber>;
+    flushInterval: z.ZodOptional<z.ZodNumber>;
+    personalApiKey: z.ZodOptional<z.ZodString>;
+    featureFlagsPollingInterval: z.ZodOptional<z.ZodNumber>;
+    disableGeoip: z.ZodOptional<z.ZodBoolean>;
+    debug: z.ZodOptional<z.ZodBoolean>;
+    identify: z.ZodOptional<z.ZodUnknown>;
+    group: z.ZodOptional<z.ZodUnknown>;
+    include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type Settings$1 = z.infer<typeof SettingsSchema>;
+
+declare const MappingSchema: z.ZodObject<{
+    identify: z.ZodOptional<z.ZodUnknown>;
+    group: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+type Mapping = z.infer<typeof MappingSchema>;
+
+declare const settings: _walkeros_core_dev.JSONSchema;
+declare const mapping: _walkeros_core_dev.JSONSchema;
+
+type index$1_Mapping = Mapping;
+declare const index$1_MappingSchema: typeof MappingSchema;
+declare const index$1_SettingsSchema: typeof SettingsSchema;
+declare const index$1_mapping: typeof mapping;
+declare const index$1_settings: typeof settings;
+declare namespace index$1 {
+  export { type index$1_Mapping as Mapping, index$1_MappingSchema as MappingSchema, type Settings$1 as Settings, index$1_SettingsSchema as SettingsSchema, index$1_mapping as mapping, index$1_settings as settings };
+}
+
+interface Settings {
+    /** PostHog project API key (phc_...) */
+    apiKey: string;
+    /** PostHog client instance, populated by init */
+    client?: PostHog;
+    /** Destination-level identity mapping */
+    identify?: Mapping$1.Value;
+    /** Destination-level group mapping */
+    group?: Mapping$1.Value;
+    /** Event sections to flatten into capture properties */
+    include?: string[];
+    host?: string;
+    flushAt?: number;
+    flushInterval?: number;
+    personalApiKey?: string;
+    featureFlagsPollingInterval?: number;
+    disableGeoip?: boolean;
+    disableCompression?: boolean;
+    requestTimeout?: number;
+    fetchRetryCount?: number;
+    fetchRetryDelay?: number;
+    debug?: boolean;
+    disabled?: boolean;
+}
+interface Env extends DestinationServer.Env {
+    PostHog?: typeof PostHog;
+}
+
+/**
+ * Standard mock environment for push operations.
+ * Injects a mock PostHog class constructor via env.PostHog.
+ */
+declare const push: Env;
+/** Simulation tracking paths for CLI --simulate. */
+declare const simulation: string[];
+
+declare const env_push: typeof push;
+declare const env_simulation: typeof simulation;
+declare namespace env {
+  export { env_push as push, env_simulation as simulation };
+}
+
+/**
+ * PostHog server step examples carry destination-level settings and
+ * optional configInclude for the test runner to wire up.
+ */
+type PostHogStepExample = Flow.StepExample & {
+    settings?: Partial<Settings>;
+    configInclude?: string[];
+};
+/**
+ * Default event forwarding — every walkerOS event becomes
+ * client.capture({ distinctId, event, properties }). With no mapping
+ * and no include, properties is {}. distinctId falls back to event.user.id.
+ */
+declare const defaultCapture: PostHogStepExample;
+/**
+ * Capture with include — destination-level include flattens data and
+ * globals sections into prefixed properties.
+ */
+declare const captureWithInclude: PostHogStepExample;
+/**
+ * Identify with $set and $set_once — per-event mapping fires
+ * client.identify() with person properties. skip: true suppresses capture.
+ */
+declare const identifyWithSetAndSetOnce: PostHogStepExample;
+/**
+ * Group identify with properties — per-event mapping fires
+ * client.groupIdentify() with group properties. skip: true suppresses capture.
+ */
+declare const groupIdentifyWithProperties: PostHogStepExample;
+/**
+ * Capture with group context — destination-level settings.group resolves
+ * type + key (no properties). The capture call includes groups.
+ */
+declare const captureWithGroupContext: PostHogStepExample;
+/**
+ * Consent revoked — client.disable() is called.
+ */
+declare const consentRevoke: PostHogStepExample;
+/**
+ * Consent granted — client.enable() is called.
+ */
+declare const consentGrant: PostHogStepExample;
+
+type step_PostHogStepExample = PostHogStepExample;
+declare const step_captureWithGroupContext: typeof captureWithGroupContext;
+declare const step_captureWithInclude: typeof captureWithInclude;
+declare const step_consentGrant: typeof consentGrant;
+declare const step_consentRevoke: typeof consentRevoke;
+declare const step_defaultCapture: typeof defaultCapture;
+declare const step_groupIdentifyWithProperties: typeof groupIdentifyWithProperties;
+declare const step_identifyWithSetAndSetOnce: typeof identifyWithSetAndSetOnce;
+declare namespace step {
+  export { type step_PostHogStepExample as PostHogStepExample, step_captureWithGroupContext as captureWithGroupContext, step_captureWithInclude as captureWithInclude, step_consentGrant as consentGrant, step_consentRevoke as consentRevoke, step_defaultCapture as defaultCapture, step_groupIdentifyWithProperties as groupIdentifyWithProperties, step_identifyWithSetAndSetOnce as identifyWithSetAndSetOnce };
+}
+
+declare const index_env: typeof env;
+declare const index_step: typeof step;
+declare namespace index {
+  export { index_env as env, index_step as step };
+}
+
+export { index as examples, index$1 as schemas };

package/dist/dev.d.ts

@@ -0,0 +1,143 @@
+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 { DestinationServer } from '@walkeros/server-core';
+import { PostHog } from 'posthog-node';
+
+declare const SettingsSchema: z.ZodObject<{
+    apiKey: z.ZodString;
+    host: z.ZodOptional<z.ZodString>;
+    flushAt: z.ZodOptional<z.ZodNumber>;
+    flushInterval: z.ZodOptional<z.ZodNumber>;
+    personalApiKey: z.ZodOptional<z.ZodString>;
+    featureFlagsPollingInterval: z.ZodOptional<z.ZodNumber>;
+    disableGeoip: z.ZodOptional<z.ZodBoolean>;
+    debug: z.ZodOptional<z.ZodBoolean>;
+    identify: z.ZodOptional<z.ZodUnknown>;
+    group: z.ZodOptional<z.ZodUnknown>;
+    include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type Settings$1 = z.infer<typeof SettingsSchema>;
+
+declare const MappingSchema: z.ZodObject<{
+    identify: z.ZodOptional<z.ZodUnknown>;
+    group: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+type Mapping = z.infer<typeof MappingSchema>;
+
+declare const settings: _walkeros_core_dev.JSONSchema;
+declare const mapping: _walkeros_core_dev.JSONSchema;
+
+type index$1_Mapping = Mapping;
+declare const index$1_MappingSchema: typeof MappingSchema;
+declare const index$1_SettingsSchema: typeof SettingsSchema;
+declare const index$1_mapping: typeof mapping;
+declare const index$1_settings: typeof settings;
+declare namespace index$1 {
+  export { type index$1_Mapping as Mapping, index$1_MappingSchema as MappingSchema, type Settings$1 as Settings, index$1_SettingsSchema as SettingsSchema, index$1_mapping as mapping, index$1_settings as settings };
+}
+
+interface Settings {
+    /** PostHog project API key (phc_...) */
+    apiKey: string;
+    /** PostHog client instance, populated by init */
+    client?: PostHog;
+    /** Destination-level identity mapping */
+    identify?: Mapping$1.Value;
+    /** Destination-level group mapping */
+    group?: Mapping$1.Value;
+    /** Event sections to flatten into capture properties */
+    include?: string[];
+    host?: string;
+    flushAt?: number;
+    flushInterval?: number;
+    personalApiKey?: string;
+    featureFlagsPollingInterval?: number;
+    disableGeoip?: boolean;
+    disableCompression?: boolean;
+    requestTimeout?: number;
+    fetchRetryCount?: number;
+    fetchRetryDelay?: number;
+    debug?: boolean;
+    disabled?: boolean;
+}
+interface Env extends DestinationServer.Env {
+    PostHog?: typeof PostHog;
+}
+
+/**
+ * Standard mock environment for push operations.
+ * Injects a mock PostHog class constructor via env.PostHog.
+ */
+declare const push: Env;
+/** Simulation tracking paths for CLI --simulate. */
+declare const simulation: string[];
+
+declare const env_push: typeof push;
+declare const env_simulation: typeof simulation;
+declare namespace env {
+  export { env_push as push, env_simulation as simulation };
+}
+
+/**
+ * PostHog server step examples carry destination-level settings and
+ * optional configInclude for the test runner to wire up.
+ */
+type PostHogStepExample = Flow.StepExample & {
+    settings?: Partial<Settings>;
+    configInclude?: string[];
+};
+/**
+ * Default event forwarding — every walkerOS event becomes
+ * client.capture({ distinctId, event, properties }). With no mapping
+ * and no include, properties is {}. distinctId falls back to event.user.id.
+ */
+declare const defaultCapture: PostHogStepExample;
+/**
+ * Capture with include — destination-level include flattens data and
+ * globals sections into prefixed properties.
+ */
+declare const captureWithInclude: PostHogStepExample;
+/**
+ * Identify with $set and $set_once — per-event mapping fires
+ * client.identify() with person properties. skip: true suppresses capture.
+ */
+declare const identifyWithSetAndSetOnce: PostHogStepExample;
+/**
+ * Group identify with properties — per-event mapping fires
+ * client.groupIdentify() with group properties. skip: true suppresses capture.
+ */
+declare const groupIdentifyWithProperties: PostHogStepExample;
+/**
+ * Capture with group context — destination-level settings.group resolves
+ * type + key (no properties). The capture call includes groups.
+ */
+declare const captureWithGroupContext: PostHogStepExample;
+/**
+ * Consent revoked — client.disable() is called.
+ */
+declare const consentRevoke: PostHogStepExample;
+/**
+ * Consent granted — client.enable() is called.
+ */
+declare const consentGrant: PostHogStepExample;
+
+type step_PostHogStepExample = PostHogStepExample;
+declare const step_captureWithGroupContext: typeof captureWithGroupContext;
+declare const step_captureWithInclude: typeof captureWithInclude;
+declare const step_consentGrant: typeof consentGrant;
+declare const step_consentRevoke: typeof consentRevoke;
+declare const step_defaultCapture: typeof defaultCapture;
+declare const step_groupIdentifyWithProperties: typeof groupIdentifyWithProperties;
+declare const step_identifyWithSetAndSetOnce: typeof identifyWithSetAndSetOnce;
+declare namespace step {
+  export { type step_PostHogStepExample as PostHogStepExample, step_captureWithGroupContext as captureWithGroupContext, step_captureWithInclude as captureWithInclude, step_consentGrant as consentGrant, step_consentRevoke as consentRevoke, step_defaultCapture as defaultCapture, step_groupIdentifyWithProperties as groupIdentifyWithProperties, step_identifyWithSetAndSetOnce as identifyWithSetAndSetOnce };
+}
+
+declare const index_env: typeof env;
+declare const index_step: typeof step;
+declare namespace index {
+  export { index_env as env, index_step as step };
+}
+
+export { index as examples, index$1 as schemas };

package/dist/dev.js

@@ -0,0 +1 @@
+"use strict";var e,t=Object.defineProperty,o=Object.getOwnPropertyDescriptor,s=Object.getOwnPropertyNames,a=Object.prototype.hasOwnProperty,i=(e,o)=>{for(var s in o)t(e,s,{get:o[s],enumerable:!0})},n={};i(n,{examples:()=>y,schemas:()=>r}),module.exports=(e=n,((e,i,n,r)=>{if(i&&"object"==typeof i||"function"==typeof i)for(let p of s(i))a.call(e,p)||p===n||t(e,p,{get:()=>i[p],enumerable:!(r=o(i,p))||r.enumerable});return e})(t({},"__esModule",{value:!0}),e));var r={};i(r,{MappingSchema:()=>d,SettingsSchema:()=>c,mapping:()=>g,settings:()=>m});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()}),u=require("@walkeros/core/dev"),d=u.z.object({identify:u.z.unknown().describe("Per-event identity mapping. Resolves to { distinctId, $set?, $set_once? }. Fires client.identify() when $set/$set_once present.").optional(),group:u.z.unknown().describe("Group assignment. Resolves to { type, key, properties? }. Fires client.groupIdentify() when properties present, adds groups to capture().").optional()}),m=(0,p.zodToSchema)(c),g=(0,p.zodToSchema)(d),y={};i(y,{env:()=>h,step:()=>v});var h={};i(h,{push:()=>f,simulation:()=>b});var f={get PostHog(){return class{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={};i(v,{captureWithGroupContext:()=>z,captureWithInclude:()=>I,consentGrant:()=>O,consentRevoke:()=>j,defaultCapture:()=>w,groupIdentifyWithProperties:()=>P,identifyWithSetAndSetOnce:()=>k});var _=require("@walkeros/core"),w={in:(0,_.getEvent)("product view",{timestamp:1700000100}),out:["client.capture",{distinctId:"us3r",event:"product view",properties:{}}]},I={in:(0,_.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={in:(0,_.getEvent)("user login",{timestamp:1700000102,data:{user_id:"new-user-123",email:"user@acme.com",plan:"premium"}}),mapping:{skip:!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}}}]},P={in:(0,_.getEvent)("company update",{timestamp:1700000103,data:{company_id:"company_123",company_name:"Acme",plan:"enterprise"}}),mapping:{skip:!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={in:(0,_.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"}}]},j={command:"consent",in:{analytics:!1},settings:{},out:["client.disable"]},O={command:"consent",in:{analytics:!0},settings:{},out:["client.enable"]};//# sourceMappingURL=dev.js.map

package/dist/dev.js.map

@@ -0,0 +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 */\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  in: getEvent('product view', { timestamp: 1700000100 }),\n  out: [\n    'client.capture',\n    {\n      distinctId: 'us3r',\n      event: 'product view',\n      properties: {},\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  in: getEvent('order complete', { timestamp: 1700000101 }),\n  configInclude: ['data', 'globals'],\n  out: [\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 * Identify with $set and $set_once — per-event mapping fires\n * client.identify() with person properties. skip: true suppresses capture.\n */\nexport const identifyWithSetAndSetOnce: PostHogStepExample = {\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    skip: 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    '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 * Group identify with properties — per-event mapping fires\n * client.groupIdentify() with group properties. skip: true suppresses capture.\n */\nexport const groupIdentifyWithProperties: PostHogStepExample = {\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    skip: 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    '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 * 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  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    'client.capture',\n    {\n      distinctId: 'us3r',\n      event: 'page view',\n      properties: {},\n      groups: { company: 'company_123' },\n    },\n  ],\n};\n\n/**\n * Consent revoked — client.disable() is called.\n */\nexport const consentRevoke: PostHogStepExample = {\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  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

@@ -0,0 +1 @@
+var e=Object.defineProperty,t=(t,s)=>{for(var o in s)e(t,o,{get:s[o],enumerable:!0})},s={};t(s,{MappingSchema:()=>r,SettingsSchema:()=>i,mapping:()=>l,settings:()=>p});import{zodToSchema as o}from"@walkeros/core/dev";import{z as a}from"@walkeros/core/dev";var i=a.object({apiKey:a.string().min(1).describe('PostHog project API key (starts with "phc_"). Find it in PostHog project settings.'),host:a.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:a.number().describe("Number of events queued before auto-flush. Default: 20.").optional(),flushInterval:a.number().describe("Milliseconds between periodic flushes. Default: 10000.").optional(),personalApiKey:a.string().describe("Personal API key (phx_...) for local feature flag evaluation.").optional(),featureFlagsPollingInterval:a.number().describe("Milliseconds between feature flag definition polls. Default: 30000.").optional(),disableGeoip:a.boolean().describe("Disable GeoIP lookups globally. Useful for GDPR compliance.").optional(),debug:a.boolean().describe("Enable PostHog SDK debug logging. Default: false.").optional(),identify:a.unknown().describe("walkerOS mapping value resolving to an identity object. Keys: distinctId, $set, $set_once. Resolved on every push (server is stateless).").optional(),group:a.unknown().describe("walkerOS mapping value resolving to a group object. Keys: type, key, properties. Resolved on every push.").optional(),include:a.array(a.string()).describe('Event sections to flatten into capture() properties (e.g. ["data", "globals"]).').optional()});import{z as n}from"@walkeros/core/dev";var r=n.object({identify:n.unknown().describe("Per-event identity mapping. Resolves to { distinctId, $set?, $set_once? }. Fires client.identify() when $set/$set_once present.").optional(),group:n.unknown().describe("Group assignment. Resolves to { type, key, properties? }. Fires client.groupIdentify() when properties present, adds groups to capture().").optional()}),p=o(i),l=o(r),c={};t(c,{env:()=>d,step:()=>g});var d={};t(d,{push:()=>u,simulation:()=>m});var u={get PostHog(){return class{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:()=>_,captureWithInclude:()=>f,consentGrant:()=>I,consentRevoke:()=>w,defaultCapture:()=>h,groupIdentifyWithProperties:()=>v,identifyWithSetAndSetOnce:()=>b});import{getEvent as y}from"@walkeros/core";var h={in:y("product view",{timestamp:1700000100}),out:["client.capture",{distinctId:"us3r",event:"product view",properties:{}}]},f={in:y("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={in:y("user login",{timestamp:1700000102,data:{user_id:"new-user-123",email:"user@acme.com",plan:"premium"}}),mapping:{skip:!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={in:y("company update",{timestamp:1700000103,data:{company_id:"company_123",company_name:"Acme",plan:"enterprise"}}),mapping:{skip:!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"}}]},_={in:y("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"}}]},w={command:"consent",in:{analytics:!1},settings:{},out:["client.disable"]},I={command:"consent",in:{analytics:!0},settings:{},out:["client.enable"]};export{c as examples,s as schemas};//# sourceMappingURL=dev.mjs.map

package/dist/dev.mjs.map

@@ -0,0 +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 */\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  in: getEvent('product view', { timestamp: 1700000100 }),\n  out: [\n    'client.capture',\n    {\n      distinctId: 'us3r',\n      event: 'product view',\n      properties: {},\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  in: getEvent('order complete', { timestamp: 1700000101 }),\n  configInclude: ['data', 'globals'],\n  out: [\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 * Identify with $set and $set_once — per-event mapping fires\n * client.identify() with person properties. skip: true suppresses capture.\n */\nexport const identifyWithSetAndSetOnce: PostHogStepExample = {\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    skip: 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    '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 * Group identify with properties — per-event mapping fires\n * client.groupIdentify() with group properties. skip: true suppresses capture.\n */\nexport const groupIdentifyWithProperties: PostHogStepExample = {\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    skip: 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    '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 * 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  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    'client.capture',\n    {\n      distinctId: 'us3r',\n      event: 'page view',\n      properties: {},\n      groups: { company: 'company_123' },\n    },\n  ],\n};\n\n/**\n * Consent revoked — client.disable() is called.\n */\nexport const consentRevoke: PostHogStepExample = {\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  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,IAKvB,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;AAiBlB,IAAM,iBAAqC;AAAA,EAChD,IAAI,SAAS,gBAAgB,EAAE,WAAW,WAAW,CAAC;AAAA,EACtD,KAAK;AAAA,IACH;AAAA,IACA;AAAA,MACE,YAAY;AAAA,MACZ,OAAO;AAAA,MACP,YAAY,CAAC;AAAA,IACf;AAAA,EACF;AACF;AAMO,IAAM,qBAAyC;AAAA,EACpD,IAAI,SAAS,kBAAkB,EAAE,WAAW,WAAW,CAAC;AAAA,EACxD,eAAe,CAAC,QAAQ,SAAS;AAAA,EACjC,KAAK;AAAA,IACH;AAAA,IACA;AAAA,MACE,YAAY;AAAA,MACZ,OAAO;AAAA,MACP,YAAY;AAAA,QACV,SAAS;AAAA,QACT,eAAe;AAAA,QACf,eAAe;AAAA,QACf,YAAY;AAAA,QACZ,YAAY;AAAA,QACZ,mBAAmB;AAAA,MACrB;AAAA,IACF;AAAA,EACF;AACF;AAMO,IAAM,4BAAgD;AAAA,EAC3D,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,MAAM;AAAA,IACN,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,IACA;AAAA,MACE,YAAY;AAAA,MACZ,YAAY;AAAA,QACV,MAAM;AAAA,UACJ,OAAO;AAAA,UACP,MAAM;AAAA,QACR;AAAA,QACA,WAAW;AAAA,UACT,aAAa;AAAA,QACf;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAMO,IAAM,8BAAkD;AAAA,EAC7D,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,MAAM;AAAA,IACN,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,IACA;AAAA,MACE,WAAW;AAAA,MACX,UAAU;AAAA,MACV,YAAY;AAAA,QACV,MAAM;AAAA,QACN,MAAM;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACF;AAMO,IAAM,0BAA8C;AAAA,EACzD,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,IACA;AAAA,MACE,YAAY;AAAA,MACZ,OAAO;AAAA,MACP,YAAY,CAAC;AAAA,MACb,QAAQ,EAAE,SAAS,cAAc;AAAA,IACnC;AAAA,EACF;AACF;AAKO,IAAM,gBAAoC;AAAA,EAC/C,SAAS;AAAA,EACT,IAAI,EAAE,WAAW,MAAM;AAAA,EACvB,UAAU,CAAC;AAAA,EACX,KAAK,CAAC,gBAAgB;AACxB;AAKO,IAAM,eAAmC;AAAA,EAC9C,SAAS;AAAA,EACT,IAAI,EAAE,WAAW,KAAK;AAAA,EACtB,UAAU,CAAC;AAAA,EACX,KAAK,CAAC,eAAe;AACvB;","names":["z"]}

package/dist/examples/index.d.mts

@@ -0,0 +1,102 @@
+import { Mapping, Flow } from '@walkeros/core';
+import { DestinationServer } from '@walkeros/server-core';
+import { PostHog } from 'posthog-node';
+
+interface Settings {
+    /** PostHog project API key (phc_...) */
+    apiKey: string;
+    /** PostHog client instance, populated by init */
+    client?: PostHog;
+    /** Destination-level identity mapping */
+    identify?: Mapping.Value;
+    /** Destination-level group mapping */
+    group?: Mapping.Value;
+    /** Event sections to flatten into capture properties */
+    include?: string[];
+    host?: string;
+    flushAt?: number;
+    flushInterval?: number;
+    personalApiKey?: string;
+    featureFlagsPollingInterval?: number;
+    disableGeoip?: boolean;
+    disableCompression?: boolean;
+    requestTimeout?: number;
+    fetchRetryCount?: number;
+    fetchRetryDelay?: number;
+    debug?: boolean;
+    disabled?: boolean;
+}
+interface Env extends DestinationServer.Env {
+    PostHog?: typeof PostHog;
+}
+
+/**
+ * Standard mock environment for push operations.
+ * Injects a mock PostHog class constructor via env.PostHog.
+ */
+declare const push: Env;
+/** Simulation tracking paths for CLI --simulate. */
+declare const simulation: string[];
+
+declare const env_push: typeof push;
+declare const env_simulation: typeof simulation;
+declare namespace env {
+  export { env_push as push, env_simulation as simulation };
+}
+
+/**
+ * PostHog server step examples carry destination-level settings and
+ * optional configInclude for the test runner to wire up.
+ */
+type PostHogStepExample = Flow.StepExample & {
+    settings?: Partial<Settings>;
+    configInclude?: string[];
+};
+/**
+ * Default event forwarding — every walkerOS event becomes
+ * client.capture({ distinctId, event, properties }). With no mapping
+ * and no include, properties is {}. distinctId falls back to event.user.id.
+ */
+declare const defaultCapture: PostHogStepExample;
+/**
+ * Capture with include — destination-level include flattens data and
+ * globals sections into prefixed properties.
+ */
+declare const captureWithInclude: PostHogStepExample;
+/**
+ * Identify with $set and $set_once — per-event mapping fires
+ * client.identify() with person properties. skip: true suppresses capture.
+ */
+declare const identifyWithSetAndSetOnce: PostHogStepExample;
+/**
+ * Group identify with properties — per-event mapping fires
+ * client.groupIdentify() with group properties. skip: true suppresses capture.
+ */
+declare const groupIdentifyWithProperties: PostHogStepExample;
+/**
+ * Capture with group context — destination-level settings.group resolves
+ * type + key (no properties). The capture call includes groups.
+ */
+declare const captureWithGroupContext: PostHogStepExample;
+/**
+ * Consent revoked — client.disable() is called.
+ */
+declare const consentRevoke: PostHogStepExample;
+/**
+ * Consent granted — client.enable() is called.
+ */
+declare const consentGrant: PostHogStepExample;
+
+type step_PostHogStepExample = PostHogStepExample;
+declare const step_captureWithGroupContext: typeof captureWithGroupContext;
+declare const step_captureWithInclude: typeof captureWithInclude;
+declare const step_consentGrant: typeof consentGrant;
+declare const step_consentRevoke: typeof consentRevoke;
+declare const step_defaultCapture: typeof defaultCapture;
+declare const step_groupIdentifyWithProperties: typeof groupIdentifyWithProperties;
+declare const step_identifyWithSetAndSetOnce: typeof identifyWithSetAndSetOnce;
+declare namespace step {
+  export { type step_PostHogStepExample as PostHogStepExample, step_captureWithGroupContext as captureWithGroupContext, step_captureWithInclude as captureWithInclude, step_consentGrant as consentGrant, step_consentRevoke as consentRevoke, step_defaultCapture as defaultCapture, step_groupIdentifyWithProperties as groupIdentifyWithProperties, step_identifyWithSetAndSetOnce as identifyWithSetAndSetOnce };
+}
+
+export { env, step };