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

package/README.md

@@ -0,0 +1,69 @@
+# @walkeros/server-destination-segment
+
+Server-side Segment CDP destination for
+[walkerOS](https://github.com/elbwalker/walkerOS). Forwards events to Segment
+via the official `@segment/analytics-node` SDK with full Segment Spec support
+(Track, Identify, Group, Page, Screen).
+
+## Installation
+
+```bash
+npm install @walkeros/server-destination-segment
+```
+
+## Quick Start
+
+```json
+{
+  "destinations": {
+    "segment": {
+      "package": "@walkeros/server-destination-segment",
+      "config": {
+        "settings": {
+          "writeKey": "YOUR_SEGMENT_WRITE_KEY",
+          "userId": "user.id",
+          "anonymousId": "user.session"
+        }
+      }
+    }
+  }
+}
+```
+
+## Settings
+
+| Setting         | Type         | Required | Default                    | Description                                                    |
+| --------------- | ------------ | -------- | -------------------------- | -------------------------------------------------------------- |
+| `writeKey`      | string       | Yes      | --                         | Segment source write key                                       |
+| `userId`        | string       | No       | `'user.id'`                | Mapping path to resolve userId from events                     |
+| `anonymousId`   | string       | No       | `'user.session'`           | Mapping path to resolve anonymousId from events                |
+| `identify`      | MappingValue | No       | --                         | Destination-level identity mapping                             |
+| `group`         | MappingValue | No       | --                         | Destination-level group mapping                                |
+| `host`          | string       | No       | `'https://api.segment.io'` | API endpoint (use `https://events.eu1.segmentapis.com` for EU) |
+| `flushAt`       | number       | No       | `15`                       | Events to enqueue before flushing                              |
+| `flushInterval` | number       | No       | `10000`                    | Max ms before auto-flush                                       |
+| `maxRetries`    | number       | No       | `3`                        | Retry attempts for failed batches                              |
+| `consent`       | Record       | No       | --                         | walkerOS consent key to Segment category mapping               |
+| `integrations`  | Record       | No       | --                         | Downstream destination filtering                               |
+
+## Mapping Settings
+
+Per-event mapping settings control which Segment methods are called:
+
+| Setting    | Effect                       | Use with `skip: true`   |
+| ---------- | ---------------------------- | ----------------------- |
+| `identify` | Calls `analytics.identify()` | Yes, for login events   |
+| `group`    | Calls `analytics.group()`    | Yes, for company events |
+| `page`     | Calls `analytics.page()`     | Yes, for page views     |
+| `screen`   | Calls `analytics.screen()`   | Yes, for mobile screens |
+
+## Identity
+
+Server-side Segment requires identity on every call. The destination resolves
+`userId` and `anonymousId` from each event via the configured mapping paths and
+attaches them to every SDK call.
+
+## Shutdown
+
+The destination implements `destroy()` calling `analytics.closeAndFlush()` to
+ensure buffered events are sent before process exit.

package/dist/dev.d.mts

@@ -0,0 +1,195 @@
+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 { Analytics } from '@segment/analytics-node';
+
+declare const SettingsSchema: z.ZodObject<{
+    writeKey: z.ZodString;
+    userId: z.ZodOptional<z.ZodString>;
+    anonymousId: z.ZodOptional<z.ZodString>;
+    host: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    flushAt: z.ZodOptional<z.ZodNumber>;
+    flushInterval: z.ZodOptional<z.ZodNumber>;
+    maxRetries: z.ZodOptional<z.ZodNumber>;
+    httpRequestTimeout: z.ZodOptional<z.ZodNumber>;
+    disable: z.ZodOptional<z.ZodBoolean>;
+    identify: z.ZodOptional<z.ZodUnknown>;
+    group: z.ZodOptional<z.ZodUnknown>;
+    consent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    integrations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, 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>;
+    page: z.ZodOptional<z.ZodUnknown>;
+    screen: 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 {
+    /** Segment source write key (required). */
+    writeKey: string;
+    /** walkerOS mapping value path to resolve userId from each event. */
+    userId?: string;
+    /** walkerOS mapping value path to resolve anonymousId from each event. */
+    anonymousId?: string;
+    /** Destination-level identity mapping (fires identify() on first push / change). */
+    identify?: Mapping$1.Value;
+    /** Destination-level group mapping (fires group() on first push / change). */
+    group?: Mapping$1.Value;
+    /** walkerOS consent key -> Segment categoryPreferences key mapping. */
+    consent?: Record<string, string>;
+    /** Downstream destination filtering. Passthrough to SDK. */
+    integrations?: Record<string, boolean | Record<string, unknown>>;
+    /** Base URL of Segment API. Default: 'https://api.segment.io'. */
+    host?: string;
+    /** API path. Default: '/v1/batch'. */
+    path?: string;
+    /** Events to enqueue before flushing. Default: 15. */
+    flushAt?: number;
+    /** Max milliseconds before auto-flush. Default: 10000. */
+    flushInterval?: number;
+    /** Retry attempts for failed batches. Default: 3. */
+    maxRetries?: number;
+    /** HTTP request timeout (ms). Default: 10000. */
+    httpRequestTimeout?: number;
+    /** Completely disable the SDK. Default: false. */
+    disable?: boolean;
+    /** Runtime state -- not user-facing. Mutated by init/push. */
+    _analytics?: Analytics;
+    _state?: RuntimeState;
+}
+interface RuntimeState {
+    lastIdentity?: {
+        userId?: string;
+        anonymousId?: string;
+        traitsHash?: string;
+    };
+    lastGroup?: {
+        groupId?: string;
+        traitsHash?: string;
+    };
+}
+/**
+ * Env -- optional SDK override. Production leaves this undefined and the
+ * destination creates a real Analytics instance. Tests provide a mock via
+ * env.analytics.
+ */
+interface Env extends DestinationServer.Env {
+    analytics?: SegmentAnalyticsMock;
+}
+/**
+ * Mock-friendly interface for the Analytics instance methods the
+ * destination actually calls. Tests can provide this via env.analytics
+ * instead of the real SDK.
+ */
+interface SegmentAnalyticsMock {
+    track: (params: Record<string, unknown>) => void;
+    identify: (params: Record<string, unknown>) => void;
+    group: (params: Record<string, unknown>) => void;
+    page: (params: Record<string, unknown>) => void;
+    screen: (params: Record<string, unknown>) => void;
+    closeAndFlush: (opts?: {
+        timeout?: number;
+    }) => Promise<void>;
+}
+
+declare const push: Env;
+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 };
+}
+
+/**
+ * Extended step example that may carry destination-level settings overrides.
+ */
+type SegmentStepExample = Flow.StepExample & {
+    settings?: Partial<Settings>;
+};
+/**
+ * Default event forwarding -- analytics.track() with event name and empty
+ * properties. userId resolved from default settings.userId = 'user.id'.
+ */
+declare const defaultTrack: SegmentStepExample;
+/**
+ * Mapped event name -- mapping.name renames the event for Segment.
+ */
+declare const mappedEventName: SegmentStepExample;
+/**
+ * Destination-level identify -- fires analytics.identify() on first push
+ * when settings.identify mapping resolves. Then fires analytics.track().
+ */
+declare const destinationIdentify: SegmentStepExample;
+/**
+ * Per-event identify with skip -- user login fires identify() only.
+ */
+declare const userLoginIdentify: SegmentStepExample;
+/**
+ * Per-event group with skip -- company update fires group() only.
+ */
+declare const companyGroup: SegmentStepExample;
+/**
+ * Explicit page() call with properties -- the canonical Segment page view.
+ * skip: true suppresses track(); settings.page fires analytics.page().
+ */
+declare const pageView: SegmentStepExample;
+/**
+ * Screen call -- server-only method for mobile app backends.
+ */
+declare const screenView: SegmentStepExample;
+/**
+ * AnonymousId only -- no userId resolved. Segment accepts anonymousId alone.
+ */
+declare const anonymousOnly: SegmentStepExample;
+/**
+ * Consent context forwarding -- settings.consent maps walkerOS consent
+ * keys to Segment categoryPreferences on the context object.
+ */
+declare const consentForwarding: SegmentStepExample;
+/**
+ * Wildcard ignore -- the event matches a mapping rule with ignore: true.
+ * The destination fires zero SDK calls.
+ */
+declare const wildcardIgnored: SegmentStepExample;
+
+type step_SegmentStepExample = SegmentStepExample;
+declare const step_anonymousOnly: typeof anonymousOnly;
+declare const step_companyGroup: typeof companyGroup;
+declare const step_consentForwarding: typeof consentForwarding;
+declare const step_defaultTrack: typeof defaultTrack;
+declare const step_destinationIdentify: typeof destinationIdentify;
+declare const step_mappedEventName: typeof mappedEventName;
+declare const step_pageView: typeof pageView;
+declare const step_screenView: typeof screenView;
+declare const step_userLoginIdentify: typeof userLoginIdentify;
+declare const step_wildcardIgnored: typeof wildcardIgnored;
+declare namespace step {
+  export { type step_SegmentStepExample as SegmentStepExample, step_anonymousOnly as anonymousOnly, step_companyGroup as companyGroup, step_consentForwarding as consentForwarding, step_defaultTrack as defaultTrack, step_destinationIdentify as destinationIdentify, step_mappedEventName as mappedEventName, step_pageView as pageView, step_screenView as screenView, step_userLoginIdentify as userLoginIdentify, step_wildcardIgnored as wildcardIgnored };
+}
+
+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,195 @@
+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 { Analytics } from '@segment/analytics-node';
+
+declare const SettingsSchema: z.ZodObject<{
+    writeKey: z.ZodString;
+    userId: z.ZodOptional<z.ZodString>;
+    anonymousId: z.ZodOptional<z.ZodString>;
+    host: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    flushAt: z.ZodOptional<z.ZodNumber>;
+    flushInterval: z.ZodOptional<z.ZodNumber>;
+    maxRetries: z.ZodOptional<z.ZodNumber>;
+    httpRequestTimeout: z.ZodOptional<z.ZodNumber>;
+    disable: z.ZodOptional<z.ZodBoolean>;
+    identify: z.ZodOptional<z.ZodUnknown>;
+    group: z.ZodOptional<z.ZodUnknown>;
+    consent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    integrations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, 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>;
+    page: z.ZodOptional<z.ZodUnknown>;
+    screen: 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 {
+    /** Segment source write key (required). */
+    writeKey: string;
+    /** walkerOS mapping value path to resolve userId from each event. */
+    userId?: string;
+    /** walkerOS mapping value path to resolve anonymousId from each event. */
+    anonymousId?: string;
+    /** Destination-level identity mapping (fires identify() on first push / change). */
+    identify?: Mapping$1.Value;
+    /** Destination-level group mapping (fires group() on first push / change). */
+    group?: Mapping$1.Value;
+    /** walkerOS consent key -> Segment categoryPreferences key mapping. */
+    consent?: Record<string, string>;
+    /** Downstream destination filtering. Passthrough to SDK. */
+    integrations?: Record<string, boolean | Record<string, unknown>>;
+    /** Base URL of Segment API. Default: 'https://api.segment.io'. */
+    host?: string;
+    /** API path. Default: '/v1/batch'. */
+    path?: string;
+    /** Events to enqueue before flushing. Default: 15. */
+    flushAt?: number;
+    /** Max milliseconds before auto-flush. Default: 10000. */
+    flushInterval?: number;
+    /** Retry attempts for failed batches. Default: 3. */
+    maxRetries?: number;
+    /** HTTP request timeout (ms). Default: 10000. */
+    httpRequestTimeout?: number;
+    /** Completely disable the SDK. Default: false. */
+    disable?: boolean;
+    /** Runtime state -- not user-facing. Mutated by init/push. */
+    _analytics?: Analytics;
+    _state?: RuntimeState;
+}
+interface RuntimeState {
+    lastIdentity?: {
+        userId?: string;
+        anonymousId?: string;
+        traitsHash?: string;
+    };
+    lastGroup?: {
+        groupId?: string;
+        traitsHash?: string;
+    };
+}
+/**
+ * Env -- optional SDK override. Production leaves this undefined and the
+ * destination creates a real Analytics instance. Tests provide a mock via
+ * env.analytics.
+ */
+interface Env extends DestinationServer.Env {
+    analytics?: SegmentAnalyticsMock;
+}
+/**
+ * Mock-friendly interface for the Analytics instance methods the
+ * destination actually calls. Tests can provide this via env.analytics
+ * instead of the real SDK.
+ */
+interface SegmentAnalyticsMock {
+    track: (params: Record<string, unknown>) => void;
+    identify: (params: Record<string, unknown>) => void;
+    group: (params: Record<string, unknown>) => void;
+    page: (params: Record<string, unknown>) => void;
+    screen: (params: Record<string, unknown>) => void;
+    closeAndFlush: (opts?: {
+        timeout?: number;
+    }) => Promise<void>;
+}
+
+declare const push: Env;
+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 };
+}
+
+/**
+ * Extended step example that may carry destination-level settings overrides.
+ */
+type SegmentStepExample = Flow.StepExample & {
+    settings?: Partial<Settings>;
+};
+/**
+ * Default event forwarding -- analytics.track() with event name and empty
+ * properties. userId resolved from default settings.userId = 'user.id'.
+ */
+declare const defaultTrack: SegmentStepExample;
+/**
+ * Mapped event name -- mapping.name renames the event for Segment.
+ */
+declare const mappedEventName: SegmentStepExample;
+/**
+ * Destination-level identify -- fires analytics.identify() on first push
+ * when settings.identify mapping resolves. Then fires analytics.track().
+ */
+declare const destinationIdentify: SegmentStepExample;
+/**
+ * Per-event identify with skip -- user login fires identify() only.
+ */
+declare const userLoginIdentify: SegmentStepExample;
+/**
+ * Per-event group with skip -- company update fires group() only.
+ */
+declare const companyGroup: SegmentStepExample;
+/**
+ * Explicit page() call with properties -- the canonical Segment page view.
+ * skip: true suppresses track(); settings.page fires analytics.page().
+ */
+declare const pageView: SegmentStepExample;
+/**
+ * Screen call -- server-only method for mobile app backends.
+ */
+declare const screenView: SegmentStepExample;
+/**
+ * AnonymousId only -- no userId resolved. Segment accepts anonymousId alone.
+ */
+declare const anonymousOnly: SegmentStepExample;
+/**
+ * Consent context forwarding -- settings.consent maps walkerOS consent
+ * keys to Segment categoryPreferences on the context object.
+ */
+declare const consentForwarding: SegmentStepExample;
+/**
+ * Wildcard ignore -- the event matches a mapping rule with ignore: true.
+ * The destination fires zero SDK calls.
+ */
+declare const wildcardIgnored: SegmentStepExample;
+
+type step_SegmentStepExample = SegmentStepExample;
+declare const step_anonymousOnly: typeof anonymousOnly;
+declare const step_companyGroup: typeof companyGroup;
+declare const step_consentForwarding: typeof consentForwarding;
+declare const step_defaultTrack: typeof defaultTrack;
+declare const step_destinationIdentify: typeof destinationIdentify;
+declare const step_mappedEventName: typeof mappedEventName;
+declare const step_pageView: typeof pageView;
+declare const step_screenView: typeof screenView;
+declare const step_userLoginIdentify: typeof userLoginIdentify;
+declare const step_wildcardIgnored: typeof wildcardIgnored;
+declare namespace step {
+  export { type step_SegmentStepExample as SegmentStepExample, step_anonymousOnly as anonymousOnly, step_companyGroup as companyGroup, step_consentForwarding as consentForwarding, step_defaultTrack as defaultTrack, step_destinationIdentify as destinationIdentify, step_mappedEventName as mappedEventName, step_pageView as pageView, step_screenView as screenView, step_userLoginIdentify as userLoginIdentify, step_wildcardIgnored as wildcardIgnored };
+}
+
+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,s=Object.getOwnPropertyDescriptor,n=Object.getOwnPropertyNames,a=Object.prototype.hasOwnProperty,i=(e,s)=>{for(var n in s)t(e,n,{get:s[n],enumerable:!0})},r={};i(r,{examples:()=>y,schemas:()=>o}),module.exports=(e=r,((e,i,r,o)=>{if(i&&"object"==typeof i||"function"==typeof i)for(let p of n(i))a.call(e,p)||p===r||t(e,p,{get:()=>i[p],enumerable:!(o=s(i,p))||o.enumerable});return e})(t({},"__esModule",{value:!0}),e));var o={};i(o,{MappingSchema:()=>c,SettingsSchema:()=>u,mapping:()=>g,settings:()=>d});var p=require("@walkeros/core/dev"),m=require("@walkeros/core/dev"),u=m.z.object({writeKey:m.z.string().min(1).describe("Segment source write key. Find it in your Segment workspace under Connections > Sources > Settings > API Keys."),userId:m.z.string().describe("walkerOS mapping value path to resolve userId from each event (like user.id).").optional(),anonymousId:m.z.string().describe("walkerOS mapping value path to resolve anonymousId from each event (like user.session).").optional(),host:m.z.string().url().describe("Base URL of Segment API. Set to https://events.eu1.segmentapis.com for EU endpoint.").optional(),path:m.z.string().describe("API path route (like /v1/batch).").optional(),flushAt:m.z.number().int().positive().describe("Events to enqueue before flushing a batch. Default: 15.").optional(),flushInterval:m.z.number().int().positive().describe("Max milliseconds before auto-flush. Default: 10000.").optional(),maxRetries:m.z.number().int().min(0).describe("Retry attempts for failed batches. Default: 3.").optional(),httpRequestTimeout:m.z.number().int().positive().describe("HTTP request timeout in milliseconds. Default: 10000.").optional(),disable:m.z.boolean().describe("Completely disable the SDK (no-ops all calls). Default: false.").optional(),identify:m.z.unknown().describe("Destination-level identity mapping. Resolves to { traits } object. Fires identify() on the first push and re-fires when values change.").optional(),group:m.z.unknown().describe("Destination-level group mapping. Resolves to { groupId, traits }. Fires group() on the first push and re-fires on change.").optional(),consent:m.z.record(m.z.string(),m.z.string()).describe('Mapping from walkerOS consent keys to Segment categoryPreferences keys. Example: { "marketing": "Advertising", "analytics": "Analytics" }.').optional(),integrations:m.z.record(m.z.string(),m.z.unknown()).describe('Enable/disable downstream Segment destinations. Example: { "All": true, "Mixpanel": false }.').optional()}),l=require("@walkeros/core/dev"),c=l.z.object({identify:l.z.unknown().describe("Per-event identity mapping. Resolves to { userId?, traits? }. Use with rule-level skip: true on login/identify events.").optional(),group:l.z.unknown().describe("Per-event group assignment. Resolves to { groupId, traits? }. Use with rule-level skip: true on company/team events.").optional(),page:l.z.unknown().describe("Per-event page call. Resolves to { category?, name?, properties? } or true for minimal page(). Use with skip: true.").optional(),screen:l.z.unknown().describe("Per-event screen call (mobile backends). Resolves to { category?, name?, properties? } or true for minimal screen(). Use with skip: true.").optional()}),d=(0,p.zodToSchema)(u),g=(0,p.zodToSchema)(c),y={};i(y,{env:()=>v,step:()=>k});var v={};i(v,{push:()=>w,simulation:()=>f});var b=()=>{};var w={analytics:{track:b,identify:b,group:b,page:b,screen:b,closeAndFlush:()=>Promise.resolve()}},f=["call:analytics.track","call:analytics.identify","call:analytics.group","call:analytics.page","call:analytics.screen"],k={};i(k,{anonymousOnly:()=>O,companyGroup:()=>E,consentForwarding:()=>x,defaultTrack:()=>I,destinationIdentify:()=>D,mappedEventName:()=>z,pageView:()=>P,screenView:()=>A,userLoginIdentify:()=>S,wildcardIgnored:()=>R});var h=require("@walkeros/core"),I={in:(0,h.getEvent)("product view",{timestamp:1700000100,user:{id:"us3r",session:"s3ss10n"}}),out:["analytics.track",{userId:"us3r",anonymousId:"s3ss10n",event:"product view",properties:{},timestamp:new Date(1700000100)}]},z={in:(0,h.getEvent)("order complete",{timestamp:1700000101,user:{id:"us3r",session:"s3ss10n"}}),mapping:{name:"Order Completed"},out:["analytics.track",{userId:"us3r",anonymousId:"s3ss10n",event:"Order Completed",properties:{},timestamp:new Date(1700000101)}]},D={in:(0,h.getEvent)("page view",{timestamp:1700000102,user:{id:"us3r",session:"s3ss10n",email:"user@example.com"}}),settings:{identify:{map:{traits:{map:{email:"user.email"}}}}},out:[["analytics.identify",{userId:"us3r",anonymousId:"s3ss10n",traits:{email:"user@example.com"},timestamp:new Date(1700000102)}],["analytics.track",{userId:"us3r",anonymousId:"s3ss10n",event:"page view",properties:{},timestamp:new Date(1700000102)}]]},S={in:(0,h.getEvent)("user login",{timestamp:1700000103,user:{id:"us3r",session:"s3ss10n"},data:{user_id:"new-user-123",email:"user@acme.com",name:"Jane Doe",plan:"premium"}}),mapping:{skip:!0,settings:{identify:{map:{userId:"data.user_id",traits:{map:{email:"data.email",name:"data.name",plan:"data.plan"}}}}}},out:["analytics.identify",{userId:"new-user-123",anonymousId:"s3ss10n",traits:{email:"user@acme.com",name:"Jane Doe",plan:"premium"},timestamp:new Date(1700000103)}]},E={in:(0,h.getEvent)("company update",{timestamp:1700000104,user:{id:"us3r",session:"s3ss10n"},data:{company_id:"comp-456",company_name:"Acme",industry:"tech",employees:50}}),mapping:{skip:!0,settings:{group:{map:{groupId:"data.company_id",traits:{map:{name:"data.company_name",industry:"data.industry",employees:"data.employees"}}}}}},out:["analytics.group",{userId:"us3r",anonymousId:"s3ss10n",groupId:"comp-456",traits:{name:"Acme",industry:"tech",employees:50},timestamp:new Date(1700000104)}]},P={in:(0,h.getEvent)("page view",{timestamp:1700000105,user:{id:"us3r",session:"s3ss10n"},data:{category:"docs",title:"Getting Started",section:"tutorials"}}),mapping:{skip:!0,settings:{page:{map:{category:"data.category",name:"data.title",properties:{map:{section:"data.section"}}}}}},out:["analytics.page",{userId:"us3r",anonymousId:"s3ss10n",category:"docs",name:"Getting Started",properties:{section:"tutorials"},timestamp:new Date(1700000105)}]},A={in:(0,h.getEvent)("screen view",{timestamp:1700000106,user:{id:"us3r",session:"s3ss10n"},data:{screen_name:"Welcome",section:"onboarding",build:"1.2.3"}}),mapping:{skip:!0,settings:{screen:{map:{name:"data.screen_name",category:"data.section",properties:{map:{build:"data.build"}}}}}},out:["analytics.screen",{userId:"us3r",anonymousId:"s3ss10n",name:"Welcome",category:"onboarding",properties:{build:"1.2.3"},timestamp:new Date(1700000106)}]},O={in:(0,h.getEvent)("product view",{timestamp:1700000107,user:{session:"s3ss10n"}}),settings:{userId:void 0},out:["analytics.track",{anonymousId:"s3ss10n",event:"product view",properties:{},timestamp:new Date(1700000107)}]},x={in:(0,h.getEvent)("product view",{timestamp:1700000108,user:{id:"us3r",session:"s3ss10n"},consent:{analytics:!0,marketing:!0}}),settings:{consent:{analytics:"Analytics",marketing:"Advertising"}},out:["analytics.track",{userId:"us3r",anonymousId:"s3ss10n",event:"product view",properties:{},timestamp:new Date(1700000108),context:{consent:{categoryPreferences:{Analytics:!0,Advertising:!0}}}}]},R={in:(0,h.getEvent)("debug noise",{timestamp:1700000109,user:{id:"us3r",session:"s3ss10n"}}),mapping:{ignore:!0},out:[]};//# 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  writeKey: z\n    .string()\n    .min(1)\n    .describe(\n      'Segment source write key. Find it in your Segment workspace under Connections > Sources > Settings > API Keys.',\n    ),\n  userId: z\n    .string()\n    .describe(\n      'walkerOS mapping value path to resolve userId from each event (like user.id).',\n    )\n    .optional(),\n  anonymousId: z\n    .string()\n    .describe(\n      'walkerOS mapping value path to resolve anonymousId from each event (like user.session).',\n    )\n    .optional(),\n  host: z\n    .string()\n    .url()\n    .describe(\n      'Base URL of Segment API. Set to https://events.eu1.segmentapis.com for EU endpoint.',\n    )\n    .optional(),\n  path: z.string().describe('API path route (like /v1/batch).').optional(),\n  flushAt: z\n    .number()\n    .int()\n    .positive()\n    .describe('Events to enqueue before flushing a batch. Default: 15.')\n    .optional(),\n  flushInterval: z\n    .number()\n    .int()\n    .positive()\n    .describe('Max milliseconds before auto-flush. Default: 10000.')\n    .optional(),\n  maxRetries: z\n    .number()\n    .int()\n    .min(0)\n    .describe('Retry attempts for failed batches. Default: 3.')\n    .optional(),\n  httpRequestTimeout: z\n    .number()\n    .int()\n    .positive()\n    .describe('HTTP request timeout in milliseconds. Default: 10000.')\n    .optional(),\n  disable: z\n    .boolean()\n    .describe('Completely disable the SDK (no-ops all calls). Default: false.')\n    .optional(),\n  identify: z\n    .unknown()\n    .describe(\n      'Destination-level identity mapping. Resolves to { traits } object. Fires identify() on the first push and re-fires when values change.',\n    )\n    .optional(),\n  group: z\n    .unknown()\n    .describe(\n      'Destination-level group mapping. Resolves to { groupId, traits }. Fires group() on the first push and re-fires on change.',\n    )\n    .optional(),\n  consent: z\n    .record(z.string(), z.string())\n    .describe(\n      'Mapping from walkerOS consent keys to Segment categoryPreferences keys. Example: { \"marketing\": \"Advertising\", \"analytics\": \"Analytics\" }.',\n    )\n    .optional(),\n  integrations: z\n    .record(z.string(), z.unknown())\n    .describe(\n      'Enable/disable downstream Segment destinations. Example: { \"All\": true, \"Mixpanel\": false }.',\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 { userId?, traits? }. Use with rule-level skip: true on login/identify events.',\n    )\n    .optional(),\n  group: z\n    .unknown()\n    .describe(\n      'Per-event group assignment. Resolves to { groupId, traits? }. Use with rule-level skip: true on company/team events.',\n    )\n    .optional(),\n  page: z\n    .unknown()\n    .describe(\n      'Per-event page call. Resolves to { category?, name?, properties? } or true for minimal page(). Use with skip: true.',\n    )\n    .optional(),\n  screen: z\n    .unknown()\n    .describe(\n      'Per-event screen call (mobile backends). Resolves to { category?, name?, properties? } or true for minimal screen(). Use with skip: true.',\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, SegmentAnalyticsMock } from '../types';\n\nconst noop = () => {};\nconst asyncNoop = () => Promise.resolve();\n\nfunction createMockAnalytics(): SegmentAnalyticsMock {\n  return {\n    track: noop,\n    identify: noop,\n    group: noop,\n    page: noop,\n    screen: noop,\n    closeAndFlush: asyncNoop,\n  };\n}\n\nexport const push: Env = {\n  analytics: createMockAnalytics(),\n};\n\nexport const simulation = [\n  'call:analytics.track',\n  'call:analytics.identify',\n  'call:analytics.group',\n  'call:analytics.page',\n  'call:analytics.screen',\n];\n","import type { Flow } from '@walkeros/core';\nimport { getEvent } from '@walkeros/core';\nimport type { Settings } from '../types';\n\n/**\n * Extended step example that may carry destination-level settings overrides.\n */\nexport type SegmentStepExample = Flow.StepExample & {\n  settings?: Partial<Settings>;\n};\n\n/**\n * Default event forwarding -- analytics.track() with event name and empty\n * properties. userId resolved from default settings.userId = 'user.id'.\n */\nexport const defaultTrack: SegmentStepExample = {\n  in: getEvent('product view', {\n    timestamp: 1700000100,\n    user: { id: 'us3r', session: 's3ss10n' },\n  }),\n  out: [\n    'analytics.track',\n    {\n      userId: 'us3r',\n      anonymousId: 's3ss10n',\n      event: 'product view',\n      properties: {},\n      timestamp: new Date(1700000100),\n    },\n  ],\n};\n\n/**\n * Mapped event name -- mapping.name renames the event for Segment.\n */\nexport const mappedEventName: SegmentStepExample = {\n  in: getEvent('order complete', {\n    timestamp: 1700000101,\n    user: { id: 'us3r', session: 's3ss10n' },\n  }),\n  mapping: {\n    name: 'Order Completed',\n  },\n  out: [\n    'analytics.track',\n    {\n      userId: 'us3r',\n      anonymousId: 's3ss10n',\n      event: 'Order Completed',\n      properties: {},\n      timestamp: new Date(1700000101),\n    },\n  ],\n};\n\n/**\n * Destination-level identify -- fires analytics.identify() on first push\n * when settings.identify mapping resolves. Then fires analytics.track().\n */\nexport const destinationIdentify: SegmentStepExample = {\n  in: getEvent('page view', {\n    timestamp: 1700000102,\n    user: { id: 'us3r', session: 's3ss10n', email: 'user@example.com' },\n  }),\n  settings: {\n    identify: {\n      map: {\n        traits: {\n          map: {\n            email: 'user.email',\n          },\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'analytics.identify',\n      {\n        userId: 'us3r',\n        anonymousId: 's3ss10n',\n        traits: { email: 'user@example.com' },\n        timestamp: new Date(1700000102),\n      },\n    ],\n    [\n      'analytics.track',\n      {\n        userId: 'us3r',\n        anonymousId: 's3ss10n',\n        event: 'page view',\n        properties: {},\n        timestamp: new Date(1700000102),\n      },\n    ],\n  ],\n};\n\n/**\n * Per-event identify with skip -- user login fires identify() only.\n */\nexport const userLoginIdentify: SegmentStepExample = {\n  in: getEvent('user login', {\n    timestamp: 1700000103,\n    user: { id: 'us3r', session: 's3ss10n' },\n    data: {\n      user_id: 'new-user-123',\n      email: 'user@acme.com',\n      name: 'Jane Doe',\n      plan: 'premium',\n    },\n  }),\n  mapping: {\n    skip: true,\n    settings: {\n      identify: {\n        map: {\n          userId: 'data.user_id',\n          traits: {\n            map: {\n              email: 'data.email',\n              name: 'data.name',\n              plan: 'data.plan',\n            },\n          },\n        },\n      },\n    },\n  },\n  out: [\n    'analytics.identify',\n    {\n      userId: 'new-user-123',\n      anonymousId: 's3ss10n',\n      traits: { email: 'user@acme.com', name: 'Jane Doe', plan: 'premium' },\n      timestamp: new Date(1700000103),\n    },\n  ],\n};\n\n/**\n * Per-event group with skip -- company update fires group() only.\n */\nexport const companyGroup: SegmentStepExample = {\n  in: getEvent('company update', {\n    timestamp: 1700000104,\n    user: { id: 'us3r', session: 's3ss10n' },\n    data: {\n      company_id: 'comp-456',\n      company_name: 'Acme',\n      industry: 'tech',\n      employees: 50,\n    },\n  }),\n  mapping: {\n    skip: true,\n    settings: {\n      group: {\n        map: {\n          groupId: 'data.company_id',\n          traits: {\n            map: {\n              name: 'data.company_name',\n              industry: 'data.industry',\n              employees: 'data.employees',\n            },\n          },\n        },\n      },\n    },\n  },\n  out: [\n    'analytics.group',\n    {\n      userId: 'us3r',\n      anonymousId: 's3ss10n',\n      groupId: 'comp-456',\n      traits: { name: 'Acme', industry: 'tech', employees: 50 },\n      timestamp: new Date(1700000104),\n    },\n  ],\n};\n\n/**\n * Explicit page() call with properties -- the canonical Segment page view.\n * skip: true suppresses track(); settings.page fires analytics.page().\n */\nexport const pageView: SegmentStepExample = {\n  in: getEvent('page view', {\n    timestamp: 1700000105,\n    user: { id: 'us3r', session: 's3ss10n' },\n    data: {\n      category: 'docs',\n      title: 'Getting Started',\n      section: 'tutorials',\n    },\n  }),\n  mapping: {\n    skip: true,\n    settings: {\n      page: {\n        map: {\n          category: 'data.category',\n          name: 'data.title',\n          properties: {\n            map: {\n              section: 'data.section',\n            },\n          },\n        },\n      },\n    },\n  },\n  out: [\n    'analytics.page',\n    {\n      userId: 'us3r',\n      anonymousId: 's3ss10n',\n      category: 'docs',\n      name: 'Getting Started',\n      properties: { section: 'tutorials' },\n      timestamp: new Date(1700000105),\n    },\n  ],\n};\n\n/**\n * Screen call -- server-only method for mobile app backends.\n */\nexport const screenView: SegmentStepExample = {\n  in: getEvent('screen view', {\n    timestamp: 1700000106,\n    user: { id: 'us3r', session: 's3ss10n' },\n    data: {\n      screen_name: 'Welcome',\n      section: 'onboarding',\n      build: '1.2.3',\n    },\n  }),\n  mapping: {\n    skip: true,\n    settings: {\n      screen: {\n        map: {\n          name: 'data.screen_name',\n          category: 'data.section',\n          properties: {\n            map: {\n              build: 'data.build',\n            },\n          },\n        },\n      },\n    },\n  },\n  out: [\n    'analytics.screen',\n    {\n      userId: 'us3r',\n      anonymousId: 's3ss10n',\n      name: 'Welcome',\n      category: 'onboarding',\n      properties: { build: '1.2.3' },\n      timestamp: new Date(1700000106),\n    },\n  ],\n};\n\n/**\n * AnonymousId only -- no userId resolved. Segment accepts anonymousId alone.\n */\nexport const anonymousOnly: SegmentStepExample = {\n  in: getEvent('product view', {\n    timestamp: 1700000107,\n    user: { session: 's3ss10n' },\n  }),\n  settings: {\n    userId: undefined,\n  },\n  out: [\n    'analytics.track',\n    {\n      anonymousId: 's3ss10n',\n      event: 'product view',\n      properties: {},\n      timestamp: new Date(1700000107),\n    },\n  ],\n};\n\n/**\n * Consent context forwarding -- settings.consent maps walkerOS consent\n * keys to Segment categoryPreferences on the context object.\n */\nexport const consentForwarding: SegmentStepExample = {\n  in: getEvent('product view', {\n    timestamp: 1700000108,\n    user: { id: 'us3r', session: 's3ss10n' },\n    consent: { analytics: true, marketing: true },\n  }),\n  settings: {\n    consent: {\n      analytics: 'Analytics',\n      marketing: 'Advertising',\n    },\n  },\n  out: [\n    'analytics.track',\n    {\n      userId: 'us3r',\n      anonymousId: 's3ss10n',\n      event: 'product view',\n      properties: {},\n      timestamp: new Date(1700000108),\n      context: {\n        consent: {\n          categoryPreferences: {\n            Analytics: true,\n            Advertising: true,\n          },\n        },\n      },\n    },\n  ],\n};\n\n/**\n * Wildcard ignore -- the event matches a mapping rule with ignore: true.\n * The destination fires zero SDK calls.\n */\nexport const wildcardIgnored: SegmentStepExample = {\n  in: getEvent('debug noise', {\n    timestamp: 1700000109,\n    user: { id: 'us3r', session: 's3ss10n' },\n  }),\n  mapping: { ignore: true },\n  out: [],\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAAAA,cAA4B;;;ACA5B,iBAAkB;AAEX,IAAM,iBAAiB,aAAE,OAAO;AAAA,EACrC,UAAU,aACP,OAAO,EACP,IAAI,CAAC,EACL;AAAA,IACC;AAAA,EACF;AAAA,EACF,QAAQ,aACL,OAAO,EACP;AAAA,IACC;AAAA,EACF,EACC,SAAS;AAAA,EACZ,aAAa,aACV,OAAO,EACP;AAAA,IACC;AAAA,EACF,EACC,SAAS;AAAA,EACZ,MAAM,aACH,OAAO,EACP,IAAI,EACJ;AAAA,IACC;AAAA,EACF,EACC,SAAS;AAAA,EACZ,MAAM,aAAE,OAAO,EAAE,SAAS,kCAAkC,EAAE,SAAS;AAAA,EACvE,SAAS,aACN,OAAO,EACP,IAAI,EACJ,SAAS,EACT,SAAS,yDAAyD,EAClE,SAAS;AAAA,EACZ,eAAe,aACZ,OAAO,EACP,IAAI,EACJ,SAAS,EACT,SAAS,qDAAqD,EAC9D,SAAS;AAAA,EACZ,YAAY,aACT,OAAO,EACP,IAAI,EACJ,IAAI,CAAC,EACL,SAAS,gDAAgD,EACzD,SAAS;AAAA,EACZ,oBAAoB,aACjB,OAAO,EACP,IAAI,EACJ,SAAS,EACT,SAAS,uDAAuD,EAChE,SAAS;AAAA,EACZ,SAAS,aACN,QAAQ,EACR,SAAS,gEAAgE,EACzE,SAAS;AAAA,EACZ,UAAU,aACP,QAAQ,EACR;AAAA,IACC;AAAA,EACF,EACC,SAAS;AAAA,EACZ,OAAO,aACJ,QAAQ,EACR;AAAA,IACC;AAAA,EACF,EACC,SAAS;AAAA,EACZ,SAAS,aACN,OAAO,aAAE,OAAO,GAAG,aAAE,OAAO,CAAC,EAC7B;AAAA,IACC;AAAA,EACF,EACC,SAAS;AAAA,EACZ,cAAc,aACX,OAAO,aAAE,OAAO,GAAG,aAAE,QAAQ,CAAC,EAC9B;AAAA,IACC;AAAA,EACF,EACC,SAAS;AACd,CAAC;;;ACjFD,IAAAC,cAAkB;AAEX,IAAM,gBAAgB,cAAE,OAAO;AAAA,EACpC,UAAU,cACP,QAAQ,EACR;AAAA,IACC;AAAA,EACF,EACC,SAAS;AAAA,EACZ,OAAO,cACJ,QAAQ,EACR;AAAA,IACC;AAAA,EACF,EACC,SAAS;AAAA,EACZ,MAAM,cACH,QAAQ,EACR;AAAA,IACC;AAAA,EACF,EACC,SAAS;AAAA,EACZ,QAAQ,cACL,QAAQ,EACR;AAAA,IACC;AAAA,EACF,EACC,SAAS;AACd,CAAC;;;AFnBM,IAAM,eAAW,yBAAY,cAAc;AAC3C,IAAM,cAAU,yBAAY,aAAa;;;AGThD;AAAA;AAAA;AAAA;AAAA;;;ACAA;AAAA;AAAA;AAAA;AAAA;AAEA,IAAM,OAAO,MAAM;AAAC;AACpB,IAAM,YAAY,MAAM,QAAQ,QAAQ;AAExC,SAAS,sBAA4C;AACnD,SAAO;AAAA,IACL,OAAO;AAAA,IACP,UAAU;AAAA,IACV,OAAO;AAAA,IACP,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,eAAe;AAAA,EACjB;AACF;AAEO,IAAM,OAAY;AAAA,EACvB,WAAW,oBAAoB;AACjC;AAEO,IAAM,aAAa;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;;;AC1BA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,kBAAyB;AAclB,IAAM,eAAmC;AAAA,EAC9C,QAAI,sBAAS,gBAAgB;AAAA,IAC3B,WAAW;AAAA,IACX,MAAM,EAAE,IAAI,QAAQ,SAAS,UAAU;AAAA,EACzC,CAAC;AAAA,EACD,KAAK;AAAA,IACH;AAAA,IACA;AAAA,MACE,QAAQ;AAAA,MACR,aAAa;AAAA,MACb,OAAO;AAAA,MACP,YAAY,CAAC;AAAA,MACb,WAAW,oBAAI,KAAK,UAAU;AAAA,IAChC;AAAA,EACF;AACF;AAKO,IAAM,kBAAsC;AAAA,EACjD,QAAI,sBAAS,kBAAkB;AAAA,IAC7B,WAAW;AAAA,IACX,MAAM,EAAE,IAAI,QAAQ,SAAS,UAAU;AAAA,EACzC,CAAC;AAAA,EACD,SAAS;AAAA,IACP,MAAM;AAAA,EACR;AAAA,EACA,KAAK;AAAA,IACH;AAAA,IACA;AAAA,MACE,QAAQ;AAAA,MACR,aAAa;AAAA,MACb,OAAO;AAAA,MACP,YAAY,CAAC;AAAA,MACb,WAAW,oBAAI,KAAK,UAAU;AAAA,IAChC;AAAA,EACF;AACF;AAMO,IAAM,sBAA0C;AAAA,EACrD,QAAI,sBAAS,aAAa;AAAA,IACxB,WAAW;AAAA,IACX,MAAM,EAAE,IAAI,QAAQ,SAAS,WAAW,OAAO,mBAAmB;AAAA,EACpE,CAAC;AAAA,EACD,UAAU;AAAA,IACR,UAAU;AAAA,MACR,KAAK;AAAA,QACH,QAAQ;AAAA,UACN,KAAK;AAAA,YACH,OAAO;AAAA,UACT;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EACA,KAAK;AAAA,IACH;AAAA,MACE;AAAA,MACA;AAAA,QACE,QAAQ;AAAA,QACR,aAAa;AAAA,QACb,QAAQ,EAAE,OAAO,mBAAmB;AAAA,QACpC,WAAW,oBAAI,KAAK,UAAU;AAAA,MAChC;AAAA,IACF;AAAA,IACA;AAAA,MACE;AAAA,MACA;AAAA,QACE,QAAQ;AAAA,QACR,aAAa;AAAA,QACb,OAAO;AAAA,QACP,YAAY,CAAC;AAAA,QACb,WAAW,oBAAI,KAAK,UAAU;AAAA,MAChC;AAAA,IACF;AAAA,EACF;AACF;AAKO,IAAM,oBAAwC;AAAA,EACnD,QAAI,sBAAS,cAAc;AAAA,IACzB,WAAW;AAAA,IACX,MAAM,EAAE,IAAI,QAAQ,SAAS,UAAU;AAAA,IACvC,MAAM;AAAA,MACJ,SAAS;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAAA,EACF,CAAC;AAAA,EACD,SAAS;AAAA,IACP,MAAM;AAAA,IACN,UAAU;AAAA,MACR,UAAU;AAAA,QACR,KAAK;AAAA,UACH,QAAQ;AAAA,UACR,QAAQ;AAAA,YACN,KAAK;AAAA,cACH,OAAO;AAAA,cACP,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,QAAQ;AAAA,MACR,aAAa;AAAA,MACb,QAAQ,EAAE,OAAO,iBAAiB,MAAM,YAAY,MAAM,UAAU;AAAA,MACpE,WAAW,oBAAI,KAAK,UAAU;AAAA,IAChC;AAAA,EACF;AACF;AAKO,IAAM,eAAmC;AAAA,EAC9C,QAAI,sBAAS,kBAAkB;AAAA,IAC7B,WAAW;AAAA,IACX,MAAM,EAAE,IAAI,QAAQ,SAAS,UAAU;AAAA,IACvC,MAAM;AAAA,MACJ,YAAY;AAAA,MACZ,cAAc;AAAA,MACd,UAAU;AAAA,MACV,WAAW;AAAA,IACb;AAAA,EACF,CAAC;AAAA,EACD,SAAS;AAAA,IACP,MAAM;AAAA,IACN,UAAU;AAAA,MACR,OAAO;AAAA,QACL,KAAK;AAAA,UACH,SAAS;AAAA,UACT,QAAQ;AAAA,YACN,KAAK;AAAA,cACH,MAAM;AAAA,cACN,UAAU;AAAA,cACV,WAAW;AAAA,YACb;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EACA,KAAK;AAAA,IACH;AAAA,IACA;AAAA,MACE,QAAQ;AAAA,MACR,aAAa;AAAA,MACb,SAAS;AAAA,MACT,QAAQ,EAAE,MAAM,QAAQ,UAAU,QAAQ,WAAW,GAAG;AAAA,MACxD,WAAW,oBAAI,KAAK,UAAU;AAAA,IAChC;AAAA,EACF;AACF;AAMO,IAAM,WAA+B;AAAA,EAC1C,QAAI,sBAAS,aAAa;AAAA,IACxB,WAAW;AAAA,IACX,MAAM,EAAE,IAAI,QAAQ,SAAS,UAAU;AAAA,IACvC,MAAM;AAAA,MACJ,UAAU;AAAA,MACV,OAAO;AAAA,MACP,SAAS;AAAA,IACX;AAAA,EACF,CAAC;AAAA,EACD,SAAS;AAAA,IACP,MAAM;AAAA,IACN,UAAU;AAAA,MACR,MAAM;AAAA,QACJ,KAAK;AAAA,UACH,UAAU;AAAA,UACV,MAAM;AAAA,UACN,YAAY;AAAA,YACV,KAAK;AAAA,cACH,SAAS;AAAA,YACX;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EACA,KAAK;AAAA,IACH;AAAA,IACA;AAAA,MACE,QAAQ;AAAA,MACR,aAAa;AAAA,MACb,UAAU;AAAA,MACV,MAAM;AAAA,MACN,YAAY,EAAE,SAAS,YAAY;AAAA,MACnC,WAAW,oBAAI,KAAK,UAAU;AAAA,IAChC;AAAA,EACF;AACF;AAKO,IAAM,aAAiC;AAAA,EAC5C,QAAI,sBAAS,eAAe;AAAA,IAC1B,WAAW;AAAA,IACX,MAAM,EAAE,IAAI,QAAQ,SAAS,UAAU;AAAA,IACvC,MAAM;AAAA,MACJ,aAAa;AAAA,MACb,SAAS;AAAA,MACT,OAAO;AAAA,IACT;AAAA,EACF,CAAC;AAAA,EACD,SAAS;AAAA,IACP,MAAM;AAAA,IACN,UAAU;AAAA,MACR,QAAQ;AAAA,QACN,KAAK;AAAA,UACH,MAAM;AAAA,UACN,UAAU;AAAA,UACV,YAAY;AAAA,YACV,KAAK;AAAA,cACH,OAAO;AAAA,YACT;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EACA,KAAK;AAAA,IACH;AAAA,IACA;AAAA,MACE,QAAQ;AAAA,MACR,aAAa;AAAA,MACb,MAAM;AAAA,MACN,UAAU;AAAA,MACV,YAAY,EAAE,OAAO,QAAQ;AAAA,MAC7B,WAAW,oBAAI,KAAK,UAAU;AAAA,IAChC;AAAA,EACF;AACF;AAKO,IAAM,gBAAoC;AAAA,EAC/C,QAAI,sBAAS,gBAAgB;AAAA,IAC3B,WAAW;AAAA,IACX,MAAM,EAAE,SAAS,UAAU;AAAA,EAC7B,CAAC;AAAA,EACD,UAAU;AAAA,IACR,QAAQ;AAAA,EACV;AAAA,EACA,KAAK;AAAA,IACH;AAAA,IACA;AAAA,MACE,aAAa;AAAA,MACb,OAAO;AAAA,MACP,YAAY,CAAC;AAAA,MACb,WAAW,oBAAI,KAAK,UAAU;AAAA,IAChC;AAAA,EACF;AACF;AAMO,IAAM,oBAAwC;AAAA,EACnD,QAAI,sBAAS,gBAAgB;AAAA,IAC3B,WAAW;AAAA,IACX,MAAM,EAAE,IAAI,QAAQ,SAAS,UAAU;AAAA,IACvC,SAAS,EAAE,WAAW,MAAM,WAAW,KAAK;AAAA,EAC9C,CAAC;AAAA,EACD,UAAU;AAAA,IACR,SAAS;AAAA,MACP,WAAW;AAAA,MACX,WAAW;AAAA,IACb;AAAA,EACF;AAAA,EACA,KAAK;AAAA,IACH;AAAA,IACA;AAAA,MACE,QAAQ;AAAA,MACR,aAAa;AAAA,MACb,OAAO;AAAA,MACP,YAAY,CAAC;AAAA,MACb,WAAW,oBAAI,KAAK,UAAU;AAAA,MAC9B,SAAS;AAAA,QACP,SAAS;AAAA,UACP,qBAAqB;AAAA,YACnB,WAAW;AAAA,YACX,aAAa;AAAA,UACf;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAMO,IAAM,kBAAsC;AAAA,EACjD,QAAI,sBAAS,eAAe;AAAA,IAC1B,WAAW;AAAA,IACX,MAAM,EAAE,IAAI,QAAQ,SAAS,UAAU;AAAA,EACzC,CAAC;AAAA,EACD,SAAS,EAAE,QAAQ,KAAK;AAAA,EACxB,KAAK,CAAC;AACR;","names":["import_dev","import_dev"]}

package/dist/dev.mjs

@@ -0,0 +1 @@
+var e=Object.defineProperty,s=(s,t)=>{for(var n in t)e(s,n,{get:t[n],enumerable:!0})},t={};s(t,{MappingSchema:()=>o,SettingsSchema:()=>i,mapping:()=>m,settings:()=>p});import{zodToSchema as n}from"@walkeros/core/dev";import{z as a}from"@walkeros/core/dev";var i=a.object({writeKey:a.string().min(1).describe("Segment source write key. Find it in your Segment workspace under Connections > Sources > Settings > API Keys."),userId:a.string().describe("walkerOS mapping value path to resolve userId from each event (like user.id).").optional(),anonymousId:a.string().describe("walkerOS mapping value path to resolve anonymousId from each event (like user.session).").optional(),host:a.string().url().describe("Base URL of Segment API. Set to https://events.eu1.segmentapis.com for EU endpoint.").optional(),path:a.string().describe("API path route (like /v1/batch).").optional(),flushAt:a.number().int().positive().describe("Events to enqueue before flushing a batch. Default: 15.").optional(),flushInterval:a.number().int().positive().describe("Max milliseconds before auto-flush. Default: 10000.").optional(),maxRetries:a.number().int().min(0).describe("Retry attempts for failed batches. Default: 3.").optional(),httpRequestTimeout:a.number().int().positive().describe("HTTP request timeout in milliseconds. Default: 10000.").optional(),disable:a.boolean().describe("Completely disable the SDK (no-ops all calls). Default: false.").optional(),identify:a.unknown().describe("Destination-level identity mapping. Resolves to { traits } object. Fires identify() on the first push and re-fires when values change.").optional(),group:a.unknown().describe("Destination-level group mapping. Resolves to { groupId, traits }. Fires group() on the first push and re-fires on change.").optional(),consent:a.record(a.string(),a.string()).describe('Mapping from walkerOS consent keys to Segment categoryPreferences keys. Example: { "marketing": "Advertising", "analytics": "Analytics" }.').optional(),integrations:a.record(a.string(),a.unknown()).describe('Enable/disable downstream Segment destinations. Example: { "All": true, "Mixpanel": false }.').optional()});import{z as r}from"@walkeros/core/dev";var o=r.object({identify:r.unknown().describe("Per-event identity mapping. Resolves to { userId?, traits? }. Use with rule-level skip: true on login/identify events.").optional(),group:r.unknown().describe("Per-event group assignment. Resolves to { groupId, traits? }. Use with rule-level skip: true on company/team events.").optional(),page:r.unknown().describe("Per-event page call. Resolves to { category?, name?, properties? } or true for minimal page(). Use with skip: true.").optional(),screen:r.unknown().describe("Per-event screen call (mobile backends). Resolves to { category?, name?, properties? } or true for minimal screen(). Use with skip: true.").optional()}),p=n(i),m=n(o),u={};s(u,{env:()=>l,step:()=>y});var l={};s(l,{push:()=>c,simulation:()=>g});var d=()=>{};var c={analytics:{track:d,identify:d,group:d,page:d,screen:d,closeAndFlush:()=>Promise.resolve()}},g=["call:analytics.track","call:analytics.identify","call:analytics.group","call:analytics.page","call:analytics.screen"],y={};s(y,{anonymousOnly:()=>S,companyGroup:()=>I,consentForwarding:()=>A,defaultTrack:()=>w,destinationIdentify:()=>b,mappedEventName:()=>f,pageView:()=>h,screenView:()=>D,userLoginIdentify:()=>k,wildcardIgnored:()=>P});import{getEvent as v}from"@walkeros/core";var w={in:v("product view",{timestamp:1700000100,user:{id:"us3r",session:"s3ss10n"}}),out:["analytics.track",{userId:"us3r",anonymousId:"s3ss10n",event:"product view",properties:{},timestamp:new Date(1700000100)}]},f={in:v("order complete",{timestamp:1700000101,user:{id:"us3r",session:"s3ss10n"}}),mapping:{name:"Order Completed"},out:["analytics.track",{userId:"us3r",anonymousId:"s3ss10n",event:"Order Completed",properties:{},timestamp:new Date(1700000101)}]},b={in:v("page view",{timestamp:1700000102,user:{id:"us3r",session:"s3ss10n",email:"user@example.com"}}),settings:{identify:{map:{traits:{map:{email:"user.email"}}}}},out:[["analytics.identify",{userId:"us3r",anonymousId:"s3ss10n",traits:{email:"user@example.com"},timestamp:new Date(1700000102)}],["analytics.track",{userId:"us3r",anonymousId:"s3ss10n",event:"page view",properties:{},timestamp:new Date(1700000102)}]]},k={in:v("user login",{timestamp:1700000103,user:{id:"us3r",session:"s3ss10n"},data:{user_id:"new-user-123",email:"user@acme.com",name:"Jane Doe",plan:"premium"}}),mapping:{skip:!0,settings:{identify:{map:{userId:"data.user_id",traits:{map:{email:"data.email",name:"data.name",plan:"data.plan"}}}}}},out:["analytics.identify",{userId:"new-user-123",anonymousId:"s3ss10n",traits:{email:"user@acme.com",name:"Jane Doe",plan:"premium"},timestamp:new Date(1700000103)}]},I={in:v("company update",{timestamp:1700000104,user:{id:"us3r",session:"s3ss10n"},data:{company_id:"comp-456",company_name:"Acme",industry:"tech",employees:50}}),mapping:{skip:!0,settings:{group:{map:{groupId:"data.company_id",traits:{map:{name:"data.company_name",industry:"data.industry",employees:"data.employees"}}}}}},out:["analytics.group",{userId:"us3r",anonymousId:"s3ss10n",groupId:"comp-456",traits:{name:"Acme",industry:"tech",employees:50},timestamp:new Date(1700000104)}]},h={in:v("page view",{timestamp:1700000105,user:{id:"us3r",session:"s3ss10n"},data:{category:"docs",title:"Getting Started",section:"tutorials"}}),mapping:{skip:!0,settings:{page:{map:{category:"data.category",name:"data.title",properties:{map:{section:"data.section"}}}}}},out:["analytics.page",{userId:"us3r",anonymousId:"s3ss10n",category:"docs",name:"Getting Started",properties:{section:"tutorials"},timestamp:new Date(1700000105)}]},D={in:v("screen view",{timestamp:1700000106,user:{id:"us3r",session:"s3ss10n"},data:{screen_name:"Welcome",section:"onboarding",build:"1.2.3"}}),mapping:{skip:!0,settings:{screen:{map:{name:"data.screen_name",category:"data.section",properties:{map:{build:"data.build"}}}}}},out:["analytics.screen",{userId:"us3r",anonymousId:"s3ss10n",name:"Welcome",category:"onboarding",properties:{build:"1.2.3"},timestamp:new Date(1700000106)}]},S={in:v("product view",{timestamp:1700000107,user:{session:"s3ss10n"}}),settings:{userId:void 0},out:["analytics.track",{anonymousId:"s3ss10n",event:"product view",properties:{},timestamp:new Date(1700000107)}]},A={in:v("product view",{timestamp:1700000108,user:{id:"us3r",session:"s3ss10n"},consent:{analytics:!0,marketing:!0}}),settings:{consent:{analytics:"Analytics",marketing:"Advertising"}},out:["analytics.track",{userId:"us3r",anonymousId:"s3ss10n",event:"product view",properties:{},timestamp:new Date(1700000108),context:{consent:{categoryPreferences:{Analytics:!0,Advertising:!0}}}}]},P={in:v("debug noise",{timestamp:1700000109,user:{id:"us3r",session:"s3ss10n"}}),mapping:{ignore:!0},out:[]};export{u as examples,t 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  writeKey: z\n    .string()\n    .min(1)\n    .describe(\n      'Segment source write key. Find it in your Segment workspace under Connections > Sources > Settings > API Keys.',\n    ),\n  userId: z\n    .string()\n    .describe(\n      'walkerOS mapping value path to resolve userId from each event (like user.id).',\n    )\n    .optional(),\n  anonymousId: z\n    .string()\n    .describe(\n      'walkerOS mapping value path to resolve anonymousId from each event (like user.session).',\n    )\n    .optional(),\n  host: z\n    .string()\n    .url()\n    .describe(\n      'Base URL of Segment API. Set to https://events.eu1.segmentapis.com for EU endpoint.',\n    )\n    .optional(),\n  path: z.string().describe('API path route (like /v1/batch).').optional(),\n  flushAt: z\n    .number()\n    .int()\n    .positive()\n    .describe('Events to enqueue before flushing a batch. Default: 15.')\n    .optional(),\n  flushInterval: z\n    .number()\n    .int()\n    .positive()\n    .describe('Max milliseconds before auto-flush. Default: 10000.')\n    .optional(),\n  maxRetries: z\n    .number()\n    .int()\n    .min(0)\n    .describe('Retry attempts for failed batches. Default: 3.')\n    .optional(),\n  httpRequestTimeout: z\n    .number()\n    .int()\n    .positive()\n    .describe('HTTP request timeout in milliseconds. Default: 10000.')\n    .optional(),\n  disable: z\n    .boolean()\n    .describe('Completely disable the SDK (no-ops all calls). Default: false.')\n    .optional(),\n  identify: z\n    .unknown()\n    .describe(\n      'Destination-level identity mapping. Resolves to { traits } object. Fires identify() on the first push and re-fires when values change.',\n    )\n    .optional(),\n  group: z\n    .unknown()\n    .describe(\n      'Destination-level group mapping. Resolves to { groupId, traits }. Fires group() on the first push and re-fires on change.',\n    )\n    .optional(),\n  consent: z\n    .record(z.string(), z.string())\n    .describe(\n      'Mapping from walkerOS consent keys to Segment categoryPreferences keys. Example: { \"marketing\": \"Advertising\", \"analytics\": \"Analytics\" }.',\n    )\n    .optional(),\n  integrations: z\n    .record(z.string(), z.unknown())\n    .describe(\n      'Enable/disable downstream Segment destinations. Example: { \"All\": true, \"Mixpanel\": false }.',\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 { userId?, traits? }. Use with rule-level skip: true on login/identify events.',\n    )\n    .optional(),\n  group: z\n    .unknown()\n    .describe(\n      'Per-event group assignment. Resolves to { groupId, traits? }. Use with rule-level skip: true on company/team events.',\n    )\n    .optional(),\n  page: z\n    .unknown()\n    .describe(\n      'Per-event page call. Resolves to { category?, name?, properties? } or true for minimal page(). Use with skip: true.',\n    )\n    .optional(),\n  screen: z\n    .unknown()\n    .describe(\n      'Per-event screen call (mobile backends). Resolves to { category?, name?, properties? } or true for minimal screen(). Use with skip: true.',\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, SegmentAnalyticsMock } from '../types';\n\nconst noop = () => {};\nconst asyncNoop = () => Promise.resolve();\n\nfunction createMockAnalytics(): SegmentAnalyticsMock {\n  return {\n    track: noop,\n    identify: noop,\n    group: noop,\n    page: noop,\n    screen: noop,\n    closeAndFlush: asyncNoop,\n  };\n}\n\nexport const push: Env = {\n  analytics: createMockAnalytics(),\n};\n\nexport const simulation = [\n  'call:analytics.track',\n  'call:analytics.identify',\n  'call:analytics.group',\n  'call:analytics.page',\n  'call:analytics.screen',\n];\n","import type { Flow } from '@walkeros/core';\nimport { getEvent } from '@walkeros/core';\nimport type { Settings } from '../types';\n\n/**\n * Extended step example that may carry destination-level settings overrides.\n */\nexport type SegmentStepExample = Flow.StepExample & {\n  settings?: Partial<Settings>;\n};\n\n/**\n * Default event forwarding -- analytics.track() with event name and empty\n * properties. userId resolved from default settings.userId = 'user.id'.\n */\nexport const defaultTrack: SegmentStepExample = {\n  in: getEvent('product view', {\n    timestamp: 1700000100,\n    user: { id: 'us3r', session: 's3ss10n' },\n  }),\n  out: [\n    'analytics.track',\n    {\n      userId: 'us3r',\n      anonymousId: 's3ss10n',\n      event: 'product view',\n      properties: {},\n      timestamp: new Date(1700000100),\n    },\n  ],\n};\n\n/**\n * Mapped event name -- mapping.name renames the event for Segment.\n */\nexport const mappedEventName: SegmentStepExample = {\n  in: getEvent('order complete', {\n    timestamp: 1700000101,\n    user: { id: 'us3r', session: 's3ss10n' },\n  }),\n  mapping: {\n    name: 'Order Completed',\n  },\n  out: [\n    'analytics.track',\n    {\n      userId: 'us3r',\n      anonymousId: 's3ss10n',\n      event: 'Order Completed',\n      properties: {},\n      timestamp: new Date(1700000101),\n    },\n  ],\n};\n\n/**\n * Destination-level identify -- fires analytics.identify() on first push\n * when settings.identify mapping resolves. Then fires analytics.track().\n */\nexport const destinationIdentify: SegmentStepExample = {\n  in: getEvent('page view', {\n    timestamp: 1700000102,\n    user: { id: 'us3r', session: 's3ss10n', email: 'user@example.com' },\n  }),\n  settings: {\n    identify: {\n      map: {\n        traits: {\n          map: {\n            email: 'user.email',\n          },\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'analytics.identify',\n      {\n        userId: 'us3r',\n        anonymousId: 's3ss10n',\n        traits: { email: 'user@example.com' },\n        timestamp: new Date(1700000102),\n      },\n    ],\n    [\n      'analytics.track',\n      {\n        userId: 'us3r',\n        anonymousId: 's3ss10n',\n        event: 'page view',\n        properties: {},\n        timestamp: new Date(1700000102),\n      },\n    ],\n  ],\n};\n\n/**\n * Per-event identify with skip -- user login fires identify() only.\n */\nexport const userLoginIdentify: SegmentStepExample = {\n  in: getEvent('user login', {\n    timestamp: 1700000103,\n    user: { id: 'us3r', session: 's3ss10n' },\n    data: {\n      user_id: 'new-user-123',\n      email: 'user@acme.com',\n      name: 'Jane Doe',\n      plan: 'premium',\n    },\n  }),\n  mapping: {\n    skip: true,\n    settings: {\n      identify: {\n        map: {\n          userId: 'data.user_id',\n          traits: {\n            map: {\n              email: 'data.email',\n              name: 'data.name',\n              plan: 'data.plan',\n            },\n          },\n        },\n      },\n    },\n  },\n  out: [\n    'analytics.identify',\n    {\n      userId: 'new-user-123',\n      anonymousId: 's3ss10n',\n      traits: { email: 'user@acme.com', name: 'Jane Doe', plan: 'premium' },\n      timestamp: new Date(1700000103),\n    },\n  ],\n};\n\n/**\n * Per-event group with skip -- company update fires group() only.\n */\nexport const companyGroup: SegmentStepExample = {\n  in: getEvent('company update', {\n    timestamp: 1700000104,\n    user: { id: 'us3r', session: 's3ss10n' },\n    data: {\n      company_id: 'comp-456',\n      company_name: 'Acme',\n      industry: 'tech',\n      employees: 50,\n    },\n  }),\n  mapping: {\n    skip: true,\n    settings: {\n      group: {\n        map: {\n          groupId: 'data.company_id',\n          traits: {\n            map: {\n              name: 'data.company_name',\n              industry: 'data.industry',\n              employees: 'data.employees',\n            },\n          },\n        },\n      },\n    },\n  },\n  out: [\n    'analytics.group',\n    {\n      userId: 'us3r',\n      anonymousId: 's3ss10n',\n      groupId: 'comp-456',\n      traits: { name: 'Acme', industry: 'tech', employees: 50 },\n      timestamp: new Date(1700000104),\n    },\n  ],\n};\n\n/**\n * Explicit page() call with properties -- the canonical Segment page view.\n * skip: true suppresses track(); settings.page fires analytics.page().\n */\nexport const pageView: SegmentStepExample = {\n  in: getEvent('page view', {\n    timestamp: 1700000105,\n    user: { id: 'us3r', session: 's3ss10n' },\n    data: {\n      category: 'docs',\n      title: 'Getting Started',\n      section: 'tutorials',\n    },\n  }),\n  mapping: {\n    skip: true,\n    settings: {\n      page: {\n        map: {\n          category: 'data.category',\n          name: 'data.title',\n          properties: {\n            map: {\n              section: 'data.section',\n            },\n          },\n        },\n      },\n    },\n  },\n  out: [\n    'analytics.page',\n    {\n      userId: 'us3r',\n      anonymousId: 's3ss10n',\n      category: 'docs',\n      name: 'Getting Started',\n      properties: { section: 'tutorials' },\n      timestamp: new Date(1700000105),\n    },\n  ],\n};\n\n/**\n * Screen call -- server-only method for mobile app backends.\n */\nexport const screenView: SegmentStepExample = {\n  in: getEvent('screen view', {\n    timestamp: 1700000106,\n    user: { id: 'us3r', session: 's3ss10n' },\n    data: {\n      screen_name: 'Welcome',\n      section: 'onboarding',\n      build: '1.2.3',\n    },\n  }),\n  mapping: {\n    skip: true,\n    settings: {\n      screen: {\n        map: {\n          name: 'data.screen_name',\n          category: 'data.section',\n          properties: {\n            map: {\n              build: 'data.build',\n            },\n          },\n        },\n      },\n    },\n  },\n  out: [\n    'analytics.screen',\n    {\n      userId: 'us3r',\n      anonymousId: 's3ss10n',\n      name: 'Welcome',\n      category: 'onboarding',\n      properties: { build: '1.2.3' },\n      timestamp: new Date(1700000106),\n    },\n  ],\n};\n\n/**\n * AnonymousId only -- no userId resolved. Segment accepts anonymousId alone.\n */\nexport const anonymousOnly: SegmentStepExample = {\n  in: getEvent('product view', {\n    timestamp: 1700000107,\n    user: { session: 's3ss10n' },\n  }),\n  settings: {\n    userId: undefined,\n  },\n  out: [\n    'analytics.track',\n    {\n      anonymousId: 's3ss10n',\n      event: 'product view',\n      properties: {},\n      timestamp: new Date(1700000107),\n    },\n  ],\n};\n\n/**\n * Consent context forwarding -- settings.consent maps walkerOS consent\n * keys to Segment categoryPreferences on the context object.\n */\nexport const consentForwarding: SegmentStepExample = {\n  in: getEvent('product view', {\n    timestamp: 1700000108,\n    user: { id: 'us3r', session: 's3ss10n' },\n    consent: { analytics: true, marketing: true },\n  }),\n  settings: {\n    consent: {\n      analytics: 'Analytics',\n      marketing: 'Advertising',\n    },\n  },\n  out: [\n    'analytics.track',\n    {\n      userId: 'us3r',\n      anonymousId: 's3ss10n',\n      event: 'product view',\n      properties: {},\n      timestamp: new Date(1700000108),\n      context: {\n        consent: {\n          categoryPreferences: {\n            Analytics: true,\n            Advertising: true,\n          },\n        },\n      },\n    },\n  ],\n};\n\n/**\n * Wildcard ignore -- the event matches a mapping rule with ignore: true.\n * The destination fires zero SDK calls.\n */\nexport const wildcardIgnored: SegmentStepExample = {\n  in: getEvent('debug noise', {\n    timestamp: 1700000109,\n    user: { id: 'us3r', session: 's3ss10n' },\n  }),\n  mapping: { ignore: true },\n  out: [],\n};\n"],"mappings":"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","names":["z"]}