@walkeros/server-destination-rudderstack 3.4.0-next-1776749829492

package/README.md

@@ -0,0 +1,76 @@
+# @walkeros/server-destination-rudderstack
+
+Server-side RudderStack CDP destination for
+[walkerOS](https://github.com/elbwalker/walkerOS). Forwards events to
+RudderStack via the official `@rudderstack/rudder-sdk-node` SDK with full
+Segment Spec support (Track, Identify, Group, Page, Screen, Alias).
+
+## Installation
+
+```bash
+npm install @walkeros/server-destination-rudderstack
+```
+
+## Quick Start
+
+```json
+{
+  "destinations": {
+    "rudderstack": {
+      "package": "@walkeros/server-destination-rudderstack",
+      "config": {
+        "settings": {
+          "writeKey": "YOUR_RUDDERSTACK_WRITE_KEY",
+          "dataPlaneUrl": "https://your-data-plane.rudderstack.com",
+          "userId": "user.id",
+          "anonymousId": "user.session"
+        }
+      }
+    }
+  }
+}
+```
+
+## Settings
+
+| Setting         | Type         | Required | Default          | Description                                     |
+| --------------- | ------------ | -------- | ---------------- | ----------------------------------------------- |
+| `writeKey`      | string       | Yes      | --               | RudderStack source write key                    |
+| `dataPlaneUrl`  | string       | Yes      | --               | RudderStack data plane URL                      |
+| `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                 |
+| `flushAt`       | number       | No       | `20`             | Events to enqueue before flushing               |
+| `flushInterval` | number       | No       | `10000`          | Max ms before auto-flush                        |
+| `retryCount`    | number       | No       | `3`              | Retry attempts for failed batches               |
+| `gzip`          | boolean      | No       | `true`           | Enable gzip compression                         |
+| `integrations`  | Record       | No       | --               | Downstream destination filtering                |
+
+## Mapping Settings
+
+Per-event mapping settings control which RudderStack 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  |
+| `alias`    | Calls `analytics.alias()`    | Yes, for identity merges |
+
+## Identity
+
+Server-side RudderStack 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.
+
+## Alias
+
+RudderStack supports `alias()` for linking anonymous and identified user
+profiles. Configure via `mapping.settings.alias` with a `previousId` field.
+
+## Shutdown
+
+The destination implements `destroy()` calling `analytics.flush()` to ensure
+buffered events are sent before process exit.

package/dist/dev.d.mts

@@ -0,0 +1,211 @@
+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';
+
+declare const SettingsSchema: z.ZodObject<{
+    writeKey: z.ZodString;
+    dataPlaneUrl: z.ZodString;
+    userId: z.ZodOptional<z.ZodString>;
+    anonymousId: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    flushAt: z.ZodOptional<z.ZodNumber>;
+    flushInterval: z.ZodOptional<z.ZodNumber>;
+    maxQueueSize: z.ZodOptional<z.ZodNumber>;
+    maxInternalQueueSize: z.ZodOptional<z.ZodNumber>;
+    logLevel: z.ZodOptional<z.ZodString>;
+    retryCount: z.ZodOptional<z.ZodNumber>;
+    enable: z.ZodOptional<z.ZodBoolean>;
+    gzip: z.ZodOptional<z.ZodBoolean>;
+    identify: z.ZodOptional<z.ZodUnknown>;
+    group: z.ZodOptional<z.ZodUnknown>;
+    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>;
+    alias: 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 {
+    /** RudderStack source write key (required). */
+    writeKey: string;
+    /** RudderStack data plane URL (required). */
+    dataPlaneUrl: 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;
+    /** Downstream destination filtering. Passthrough to SDK integrations param. */
+    integrations?: Record<string, boolean | Record<string, unknown>>;
+    /** API path. Default: '/v1/batch'. */
+    path?: string;
+    /** Events to enqueue before flushing. Default: 20. */
+    flushAt?: number;
+    /** Max milliseconds before auto-flush. Default: 10000. */
+    flushInterval?: number;
+    /** Maximum batch payload size in bytes. Default: 460800 (~500KB). */
+    maxQueueSize?: number;
+    /** Maximum in-memory queue length. Default: 20000. */
+    maxInternalQueueSize?: number;
+    /** Log level. Default: 'info'. */
+    logLevel?: string;
+    /** Retry attempts for failed batches. Default: 3. */
+    retryCount?: number;
+    /** Completely disable the SDK. Default: false. */
+    enable?: boolean;
+    /** Enable gzip compression. Default: true. */
+    gzip?: boolean;
+    /** Runtime state -- not user-facing. Mutated by init/push. */
+    _analytics?: unknown;
+    _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?: RudderStackAnalyticsMock;
+}
+/**
+ * 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 RudderStackAnalyticsMock {
+    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;
+    alias: (params: Record<string, unknown>) => void;
+    flush: (callback?: (err?: Error, data?: unknown) => void) => 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 RudderStackStepExample = Flow.StepExample & {
+    settings?: Partial<Settings>;
+};
+/**
+ * RudderStack server destination invokes the injected `env.analytics` SDK
+ * methods (`track`, `identify`, `group`, `page`, `screen`, `alias`) — not a
+ * raw HTTP endpoint. Each `out` entry is therefore
+ * `[callable, params]` where `callable` is the dotted method name
+ * (e.g. `'analytics.track'`) and `params` is the object passed to the SDK.
+ *
+ * Examples may emit multiple calls in order (e.g. identify + track), so
+ * every `out` is wrapped as `[[callable, params], ...]`.
+ */
+/**
+ * Default event forwarding -- analytics.track() with event name and empty
+ * properties. userId resolved from default settings.userId = 'user.id'.
+ */
+declare const defaultTrack: RudderStackStepExample;
+/**
+ * Mapped event name -- mapping.name renames the event for RudderStack.
+ */
+declare const mappedEventName: RudderStackStepExample;
+/**
+ * Destination-level identify -- fires analytics.identify() on first push
+ * when settings.identify mapping resolves. Then fires analytics.track().
+ */
+declare const destinationIdentify: RudderStackStepExample;
+/**
+ * Per-event identify with skip -- user login fires identify() only.
+ */
+declare const userLoginIdentify: RudderStackStepExample;
+/**
+ * Per-event group with skip -- company update fires group() only.
+ */
+declare const companyGroup: RudderStackStepExample;
+/**
+ * Explicit page() call with properties. RudderStack requires name -- resolved
+ * from mapping. skip: true suppresses track().
+ */
+declare const pageView: RudderStackStepExample;
+/**
+ * Screen call -- server-only method for mobile app backends.
+ * RudderStack requires name -- resolved from mapping.
+ */
+declare const screenView: RudderStackStepExample;
+/**
+ * Alias call -- links anonymous user identity to registered user.
+ * skip: true suppresses track(). Requires previousId from mapping.
+ */
+declare const aliasUser: RudderStackStepExample;
+/**
+ * AnonymousId only -- no userId resolved. RudderStack accepts anonymousId alone.
+ */
+declare const anonymousOnly: RudderStackStepExample;
+/**
+ * Wildcard ignore -- the event matches a mapping rule with ignore: true.
+ * The destination fires zero SDK calls.
+ */
+declare const wildcardIgnored: RudderStackStepExample;
+
+type step_RudderStackStepExample = RudderStackStepExample;
+declare const step_aliasUser: typeof aliasUser;
+declare const step_anonymousOnly: typeof anonymousOnly;
+declare const step_companyGroup: typeof companyGroup;
+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_RudderStackStepExample as RudderStackStepExample, step_aliasUser as aliasUser, step_anonymousOnly as anonymousOnly, step_companyGroup as companyGroup, 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,211 @@
+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';
+
+declare const SettingsSchema: z.ZodObject<{
+    writeKey: z.ZodString;
+    dataPlaneUrl: z.ZodString;
+    userId: z.ZodOptional<z.ZodString>;
+    anonymousId: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    flushAt: z.ZodOptional<z.ZodNumber>;
+    flushInterval: z.ZodOptional<z.ZodNumber>;
+    maxQueueSize: z.ZodOptional<z.ZodNumber>;
+    maxInternalQueueSize: z.ZodOptional<z.ZodNumber>;
+    logLevel: z.ZodOptional<z.ZodString>;
+    retryCount: z.ZodOptional<z.ZodNumber>;
+    enable: z.ZodOptional<z.ZodBoolean>;
+    gzip: z.ZodOptional<z.ZodBoolean>;
+    identify: z.ZodOptional<z.ZodUnknown>;
+    group: z.ZodOptional<z.ZodUnknown>;
+    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>;
+    alias: 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 {
+    /** RudderStack source write key (required). */
+    writeKey: string;
+    /** RudderStack data plane URL (required). */
+    dataPlaneUrl: 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;
+    /** Downstream destination filtering. Passthrough to SDK integrations param. */
+    integrations?: Record<string, boolean | Record<string, unknown>>;
+    /** API path. Default: '/v1/batch'. */
+    path?: string;
+    /** Events to enqueue before flushing. Default: 20. */
+    flushAt?: number;
+    /** Max milliseconds before auto-flush. Default: 10000. */
+    flushInterval?: number;
+    /** Maximum batch payload size in bytes. Default: 460800 (~500KB). */
+    maxQueueSize?: number;
+    /** Maximum in-memory queue length. Default: 20000. */
+    maxInternalQueueSize?: number;
+    /** Log level. Default: 'info'. */
+    logLevel?: string;
+    /** Retry attempts for failed batches. Default: 3. */
+    retryCount?: number;
+    /** Completely disable the SDK. Default: false. */
+    enable?: boolean;
+    /** Enable gzip compression. Default: true. */
+    gzip?: boolean;
+    /** Runtime state -- not user-facing. Mutated by init/push. */
+    _analytics?: unknown;
+    _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?: RudderStackAnalyticsMock;
+}
+/**
+ * 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 RudderStackAnalyticsMock {
+    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;
+    alias: (params: Record<string, unknown>) => void;
+    flush: (callback?: (err?: Error, data?: unknown) => void) => 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 RudderStackStepExample = Flow.StepExample & {
+    settings?: Partial<Settings>;
+};
+/**
+ * RudderStack server destination invokes the injected `env.analytics` SDK
+ * methods (`track`, `identify`, `group`, `page`, `screen`, `alias`) — not a
+ * raw HTTP endpoint. Each `out` entry is therefore
+ * `[callable, params]` where `callable` is the dotted method name
+ * (e.g. `'analytics.track'`) and `params` is the object passed to the SDK.
+ *
+ * Examples may emit multiple calls in order (e.g. identify + track), so
+ * every `out` is wrapped as `[[callable, params], ...]`.
+ */
+/**
+ * Default event forwarding -- analytics.track() with event name and empty
+ * properties. userId resolved from default settings.userId = 'user.id'.
+ */
+declare const defaultTrack: RudderStackStepExample;
+/**
+ * Mapped event name -- mapping.name renames the event for RudderStack.
+ */
+declare const mappedEventName: RudderStackStepExample;
+/**
+ * Destination-level identify -- fires analytics.identify() on first push
+ * when settings.identify mapping resolves. Then fires analytics.track().
+ */
+declare const destinationIdentify: RudderStackStepExample;
+/**
+ * Per-event identify with skip -- user login fires identify() only.
+ */
+declare const userLoginIdentify: RudderStackStepExample;
+/**
+ * Per-event group with skip -- company update fires group() only.
+ */
+declare const companyGroup: RudderStackStepExample;
+/**
+ * Explicit page() call with properties. RudderStack requires name -- resolved
+ * from mapping. skip: true suppresses track().
+ */
+declare const pageView: RudderStackStepExample;
+/**
+ * Screen call -- server-only method for mobile app backends.
+ * RudderStack requires name -- resolved from mapping.
+ */
+declare const screenView: RudderStackStepExample;
+/**
+ * Alias call -- links anonymous user identity to registered user.
+ * skip: true suppresses track(). Requires previousId from mapping.
+ */
+declare const aliasUser: RudderStackStepExample;
+/**
+ * AnonymousId only -- no userId resolved. RudderStack accepts anonymousId alone.
+ */
+declare const anonymousOnly: RudderStackStepExample;
+/**
+ * Wildcard ignore -- the event matches a mapping rule with ignore: true.
+ * The destination fires zero SDK calls.
+ */
+declare const wildcardIgnored: RudderStackStepExample;
+
+type step_RudderStackStepExample = RudderStackStepExample;
+declare const step_aliasUser: typeof aliasUser;
+declare const step_anonymousOnly: typeof anonymousOnly;
+declare const step_companyGroup: typeof companyGroup;
+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_RudderStackStepExample as RudderStackStepExample, step_aliasUser as aliasUser, step_anonymousOnly as anonymousOnly, step_companyGroup as companyGroup, 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,s=Object.defineProperty,t=Object.getOwnPropertyDescriptor,a=Object.getOwnPropertyNames,n=Object.prototype.hasOwnProperty,i=(e,t)=>{for(var a in t)s(e,a,{get:t[a],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 u of a(i))n.call(e,u)||u===r||s(e,u,{get:()=>i[u],enumerable:!(o=t(i,u))||o.enumerable});return e})(s({},"__esModule",{value:!0}),e));var o={};i(o,{MappingSchema:()=>d,SettingsSchema:()=>l,mapping:()=>g,settings:()=>c});var u=require("@walkeros/core/dev"),p=require("@walkeros/core/dev"),l=p.z.object({writeKey:p.z.string().min(1).describe("RudderStack source write key. Find it in the RudderStack dashboard under Sources > Setup."),dataPlaneUrl:p.z.string().url().describe("RudderStack data plane URL. Required. Example: https://your-data-plane.rudderstack.com"),userId:p.z.string().describe("walkerOS mapping value path to resolve userId from each event (like user.id).").optional(),anonymousId:p.z.string().describe("walkerOS mapping value path to resolve anonymousId from each event (like user.session).").optional(),path:p.z.string().describe("API path route (like /v1/batch).").optional(),flushAt:p.z.number().int().positive().describe("Events to enqueue before flushing a batch. Default: 20.").optional(),flushInterval:p.z.number().int().positive().describe("Max milliseconds before auto-flush. Default: 10000.").optional(),maxQueueSize:p.z.number().int().positive().describe("Maximum batch payload size in bytes. Default: 460800 (~500KB).").optional(),maxInternalQueueSize:p.z.number().int().positive().describe("Maximum in-memory queue length. Default: 20000.").optional(),logLevel:p.z.string().describe("SDK log level: 'info', 'debug', 'error', or 'silly'. Default: 'info'.").optional(),retryCount:p.z.number().int().min(0).describe("Retry attempts for failed batches. Default: 3.").optional(),enable:p.z.boolean().describe("Set to false to no-op all SDK calls. Default: true.").optional(),gzip:p.z.boolean().describe("Enable gzip compression for requests. Default: true.").optional(),identify:p.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:p.z.unknown().describe("Destination-level group mapping. Resolves to { groupId, traits }. Fires group() on the first push and re-fires on change.").optional(),integrations:p.z.record(p.z.string(),p.z.unknown()).describe('Enable/disable downstream RudderStack destinations. Example: { "All": true, "Mixpanel": false }.').optional()}),m=require("@walkeros/core/dev"),d=m.z.object({identify:m.z.unknown().describe("Per-event identity mapping. Resolves to { userId?, traits? }. Use with rule-level skip: true on login/identify events.").optional(),group:m.z.unknown().describe("Per-event group assignment. Resolves to { groupId, traits? }. Use with rule-level skip: true on company/team events.").optional(),page:m.z.unknown().describe("Per-event page call. Resolves to { name, properties? } or true for minimal page(). RudderStack requires name (falls back to empty string). Use with skip: true.").optional(),screen:m.z.unknown().describe("Per-event screen call (mobile backends). Resolves to { name, properties? } or true for minimal screen(). RudderStack requires name (falls back to empty string). Use with skip: true.").optional(),alias:m.z.unknown().describe("Per-event alias call. Resolves to { previousId }. Links anonymous user to identified user. Use with rule-level skip: true.").optional()}),c=(0,u.zodToSchema)(l),g=(0,u.zodToSchema)(d),y={};i(y,{env:()=>v,step:()=>k});var v={};i(v,{push:()=>f,simulation:()=>w});var b=()=>{};var f={analytics:{track:b,identify:b,group:b,page:b,screen:b,alias:b,flush:()=>Promise.resolve()}},w=["call:analytics.track","call:analytics.identify","call:analytics.group","call:analytics.page","call:analytics.screen","call:analytics.alias"],k={};i(k,{aliasUser:()=>O,anonymousOnly:()=>P,companyGroup:()=>E,defaultTrack:()=>I,destinationIdentify:()=>D,mappedEventName:()=>z,pageView:()=>R,screenView:()=>x,userLoginIdentify:()=>S,wildcardIgnored:()=>_});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)}]]},R={in:(0,h.getEvent)("page view",{timestamp:1700000105,user:{id:"us3r",session:"s3ss10n"},data:{title:"Getting Started",section:"tutorials"}}),mapping:{skip:!0,settings:{page:{map:{name:"data.title",properties:{map:{section:"data.section"}}}}}},out:[["analytics.page",{userId:"us3r",anonymousId:"s3ss10n",name:"Getting Started",properties:{section:"tutorials"},timestamp:new Date(1700000105)}]]},x={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",properties:{map:{build:"data.build"}}}}}},out:[["analytics.screen",{userId:"us3r",anonymousId:"s3ss10n",name:"Welcome",properties:{build:"1.2.3"},timestamp:new Date(1700000106)}]]},O={in:(0,h.getEvent)("identity merge",{timestamp:1700000107,user:{id:"registered-456",session:"s3ss10n"},data:{anonymous_id:"anonymous-123"}}),mapping:{skip:!0,settings:{alias:{map:{previousId:"data.anonymous_id"}}}},out:[["analytics.alias",{userId:"registered-456",previousId:"anonymous-123",timestamp:new Date(1700000107)}]]},P={in:(0,h.getEvent)("product view",{timestamp:1700000108,user:{session:"s3ss10n"}}),settings:{userId:void 0},out:[["analytics.track",{anonymousId:"s3ss10n",event:"product view",properties:{},timestamp:new Date(1700000108)}]]},_={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      'RudderStack source write key. Find it in the RudderStack dashboard under Sources > Setup.',\n    ),\n  dataPlaneUrl: z\n    .string()\n    .url()\n    .describe(\n      'RudderStack data plane URL. Required. Example: https://your-data-plane.rudderstack.com',\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  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: 20.')\n    .optional(),\n  flushInterval: z\n    .number()\n    .int()\n    .positive()\n    .describe('Max milliseconds before auto-flush. Default: 10000.')\n    .optional(),\n  maxQueueSize: z\n    .number()\n    .int()\n    .positive()\n    .describe('Maximum batch payload size in bytes. Default: 460800 (~500KB).')\n    .optional(),\n  maxInternalQueueSize: z\n    .number()\n    .int()\n    .positive()\n    .describe('Maximum in-memory queue length. Default: 20000.')\n    .optional(),\n  logLevel: z\n    .string()\n    .describe(\n      \"SDK log level: 'info', 'debug', 'error', or 'silly'. Default: 'info'.\",\n    )\n    .optional(),\n  retryCount: z\n    .number()\n    .int()\n    .min(0)\n    .describe('Retry attempts for failed batches. Default: 3.')\n    .optional(),\n  enable: z\n    .boolean()\n    .describe('Set to false to no-op all SDK calls. Default: true.')\n    .optional(),\n  gzip: z\n    .boolean()\n    .describe('Enable gzip compression for requests. Default: true.')\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  integrations: z\n    .record(z.string(), z.unknown())\n    .describe(\n      'Enable/disable downstream RudderStack 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 { name, properties? } or true for minimal page(). RudderStack requires name (falls back to empty string). Use with skip: true.',\n    )\n    .optional(),\n  screen: z\n    .unknown()\n    .describe(\n      'Per-event screen call (mobile backends). Resolves to { name, properties? } or true for minimal screen(). RudderStack requires name (falls back to empty string). Use with skip: true.',\n    )\n    .optional(),\n  alias: z\n    .unknown()\n    .describe(\n      'Per-event alias call. Resolves to { previousId }. Links anonymous user to identified user. Use with rule-level 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, RudderStackAnalyticsMock } from '../types';\n\ntype SdkCall = (_params: Record<string, unknown>) => void;\ntype SdkFlush = (\n  _callback?: (err?: Error, data?: unknown) => void,\n) => Promise<void>;\n\nconst noop: SdkCall = () => {};\nconst asyncNoop: SdkFlush = () => Promise.resolve();\n\nfunction createMockAnalytics(): RudderStackAnalyticsMock {\n  return {\n    track: noop,\n    identify: noop,\n    group: noop,\n    page: noop,\n    screen: noop,\n    alias: noop,\n    flush: 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  'call:analytics.alias',\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 RudderStackStepExample = Flow.StepExample & {\n  settings?: Partial<Settings>;\n};\n\n/**\n * RudderStack server destination invokes the injected `env.analytics` SDK\n * methods (`track`, `identify`, `group`, `page`, `screen`, `alias`) — not a\n * raw HTTP endpoint. Each `out` entry is therefore\n * `[callable, params]` where `callable` is the dotted method name\n * (e.g. `'analytics.track'`) and `params` is the object passed to the SDK.\n *\n * Examples may emit multiple calls in order (e.g. identify + track), so\n * every `out` is wrapped as `[[callable, params], ...]`.\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: RudderStackStepExample = {\n  in: getEvent('product view', {\n    timestamp: 1700000100,\n    user: { id: 'us3r', session: 's3ss10n' },\n  }),\n  out: [\n    [\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/**\n * Mapped event name -- mapping.name renames the event for RudderStack.\n */\nexport const mappedEventName: RudderStackStepExample = {\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    [\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/**\n * Destination-level identify -- fires analytics.identify() on first push\n * when settings.identify mapping resolves. Then fires analytics.track().\n */\nexport const destinationIdentify: RudderStackStepExample = {\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: RudderStackStepExample = {\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    [\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/**\n * Per-event group with skip -- company update fires group() only.\n */\nexport const companyGroup: RudderStackStepExample = {\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    [\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/**\n * Explicit page() call with properties. RudderStack requires name -- resolved\n * from mapping. skip: true suppresses track().\n */\nexport const pageView: RudderStackStepExample = {\n  in: getEvent('page view', {\n    timestamp: 1700000105,\n    user: { id: 'us3r', session: 's3ss10n' },\n    data: {\n      title: 'Getting Started',\n      section: 'tutorials',\n    },\n  }),\n  mapping: {\n    skip: true,\n    settings: {\n      page: {\n        map: {\n          name: 'data.title',\n          properties: {\n            map: {\n              section: 'data.section',\n            },\n          },\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'analytics.page',\n      {\n        userId: 'us3r',\n        anonymousId: 's3ss10n',\n        name: 'Getting Started',\n        properties: { section: 'tutorials' },\n        timestamp: new Date(1700000105),\n      },\n    ],\n  ],\n};\n\n/**\n * Screen call -- server-only method for mobile app backends.\n * RudderStack requires name -- resolved from mapping.\n */\nexport const screenView: RudderStackStepExample = {\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          properties: {\n            map: {\n              build: 'data.build',\n            },\n          },\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'analytics.screen',\n      {\n        userId: 'us3r',\n        anonymousId: 's3ss10n',\n        name: 'Welcome',\n        properties: { build: '1.2.3' },\n        timestamp: new Date(1700000106),\n      },\n    ],\n  ],\n};\n\n/**\n * Alias call -- links anonymous user identity to registered user.\n * skip: true suppresses track(). Requires previousId from mapping.\n */\nexport const aliasUser: RudderStackStepExample = {\n  in: getEvent('identity merge', {\n    timestamp: 1700000107,\n    user: { id: 'registered-456', session: 's3ss10n' },\n    data: {\n      anonymous_id: 'anonymous-123',\n    },\n  }),\n  mapping: {\n    skip: true,\n    settings: {\n      alias: {\n        map: {\n          previousId: 'data.anonymous_id',\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'analytics.alias',\n      {\n        userId: 'registered-456',\n        previousId: 'anonymous-123',\n        timestamp: new Date(1700000107),\n      },\n    ],\n  ],\n};\n\n/**\n * AnonymousId only -- no userId resolved. RudderStack accepts anonymousId alone.\n */\nexport const anonymousOnly: RudderStackStepExample = {\n  in: getEvent('product view', {\n    timestamp: 1700000108,\n    user: { session: 's3ss10n' },\n  }),\n  settings: {\n    userId: undefined,\n  },\n  out: [\n    [\n      'analytics.track',\n      {\n        anonymousId: 's3ss10n',\n        event: 'product view',\n        properties: {},\n        timestamp: new Date(1700000108),\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: RudderStackStepExample = {\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":["import_dev","import_dev"]}

package/dist/dev.mjs

@@ -0,0 +1 @@
+var e=Object.defineProperty,s=(s,a)=>{for(var t in a)e(s,t,{get:a[t],enumerable:!0})},a={};s(a,{MappingSchema:()=>o,SettingsSchema:()=>n,mapping:()=>u,settings:()=>p});import{zodToSchema as t}from"@walkeros/core/dev";import{z as i}from"@walkeros/core/dev";var n=i.object({writeKey:i.string().min(1).describe("RudderStack source write key. Find it in the RudderStack dashboard under Sources > Setup."),dataPlaneUrl:i.string().url().describe("RudderStack data plane URL. Required. Example: https://your-data-plane.rudderstack.com"),userId:i.string().describe("walkerOS mapping value path to resolve userId from each event (like user.id).").optional(),anonymousId:i.string().describe("walkerOS mapping value path to resolve anonymousId from each event (like user.session).").optional(),path:i.string().describe("API path route (like /v1/batch).").optional(),flushAt:i.number().int().positive().describe("Events to enqueue before flushing a batch. Default: 20.").optional(),flushInterval:i.number().int().positive().describe("Max milliseconds before auto-flush. Default: 10000.").optional(),maxQueueSize:i.number().int().positive().describe("Maximum batch payload size in bytes. Default: 460800 (~500KB).").optional(),maxInternalQueueSize:i.number().int().positive().describe("Maximum in-memory queue length. Default: 20000.").optional(),logLevel:i.string().describe("SDK log level: 'info', 'debug', 'error', or 'silly'. Default: 'info'.").optional(),retryCount:i.number().int().min(0).describe("Retry attempts for failed batches. Default: 3.").optional(),enable:i.boolean().describe("Set to false to no-op all SDK calls. Default: true.").optional(),gzip:i.boolean().describe("Enable gzip compression for requests. Default: true.").optional(),identify:i.unknown().describe("Destination-level identity mapping. Resolves to { traits } object. Fires identify() on the first push and re-fires when values change.").optional(),group:i.unknown().describe("Destination-level group mapping. Resolves to { groupId, traits }. Fires group() on the first push and re-fires on change.").optional(),integrations:i.record(i.string(),i.unknown()).describe('Enable/disable downstream RudderStack 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 { name, properties? } or true for minimal page(). RudderStack requires name (falls back to empty string). Use with skip: true.").optional(),screen:r.unknown().describe("Per-event screen call (mobile backends). Resolves to { name, properties? } or true for minimal screen(). RudderStack requires name (falls back to empty string). Use with skip: true.").optional(),alias:r.unknown().describe("Per-event alias call. Resolves to { previousId }. Links anonymous user to identified user. Use with rule-level skip: true.").optional()}),p=t(n),u=t(o),l={};s(l,{env:()=>m,step:()=>y});var m={};s(m,{push:()=>c,simulation:()=>g});var d=()=>{};var c={analytics:{track:d,identify:d,group:d,page:d,screen:d,alias:d,flush:()=>Promise.resolve()}},g=["call:analytics.track","call:analytics.identify","call:analytics.group","call:analytics.page","call:analytics.screen","call:analytics.alias"],y={};s(y,{aliasUser:()=>S,anonymousOnly:()=>R,companyGroup:()=>I,defaultTrack:()=>b,destinationIdentify:()=>k,mappedEventName:()=>f,pageView:()=>h,screenView:()=>D,userLoginIdentify:()=>w,wildcardIgnored:()=>x});import{getEvent as v}from"@walkeros/core";var b={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)}]]},k={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)}]]},w={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:{title:"Getting Started",section:"tutorials"}}),mapping:{skip:!0,settings:{page:{map:{name:"data.title",properties:{map:{section:"data.section"}}}}}},out:[["analytics.page",{userId:"us3r",anonymousId:"s3ss10n",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",properties:{map:{build:"data.build"}}}}}},out:[["analytics.screen",{userId:"us3r",anonymousId:"s3ss10n",name:"Welcome",properties:{build:"1.2.3"},timestamp:new Date(1700000106)}]]},S={in:v("identity merge",{timestamp:1700000107,user:{id:"registered-456",session:"s3ss10n"},data:{anonymous_id:"anonymous-123"}}),mapping:{skip:!0,settings:{alias:{map:{previousId:"data.anonymous_id"}}}},out:[["analytics.alias",{userId:"registered-456",previousId:"anonymous-123",timestamp:new Date(1700000107)}]]},R={in:v("product view",{timestamp:1700000108,user:{session:"s3ss10n"}}),settings:{userId:void 0},out:[["analytics.track",{anonymousId:"s3ss10n",event:"product view",properties:{},timestamp:new Date(1700000108)}]]},x={in:v("debug noise",{timestamp:1700000109,user:{id:"us3r",session:"s3ss10n"}}),mapping:{ignore:!0},out:[]};export{l as examples,a 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      'RudderStack source write key. Find it in the RudderStack dashboard under Sources > Setup.',\n    ),\n  dataPlaneUrl: z\n    .string()\n    .url()\n    .describe(\n      'RudderStack data plane URL. Required. Example: https://your-data-plane.rudderstack.com',\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  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: 20.')\n    .optional(),\n  flushInterval: z\n    .number()\n    .int()\n    .positive()\n    .describe('Max milliseconds before auto-flush. Default: 10000.')\n    .optional(),\n  maxQueueSize: z\n    .number()\n    .int()\n    .positive()\n    .describe('Maximum batch payload size in bytes. Default: 460800 (~500KB).')\n    .optional(),\n  maxInternalQueueSize: z\n    .number()\n    .int()\n    .positive()\n    .describe('Maximum in-memory queue length. Default: 20000.')\n    .optional(),\n  logLevel: z\n    .string()\n    .describe(\n      \"SDK log level: 'info', 'debug', 'error', or 'silly'. Default: 'info'.\",\n    )\n    .optional(),\n  retryCount: z\n    .number()\n    .int()\n    .min(0)\n    .describe('Retry attempts for failed batches. Default: 3.')\n    .optional(),\n  enable: z\n    .boolean()\n    .describe('Set to false to no-op all SDK calls. Default: true.')\n    .optional(),\n  gzip: z\n    .boolean()\n    .describe('Enable gzip compression for requests. Default: true.')\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  integrations: z\n    .record(z.string(), z.unknown())\n    .describe(\n      'Enable/disable downstream RudderStack 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 { name, properties? } or true for minimal page(). RudderStack requires name (falls back to empty string). Use with skip: true.',\n    )\n    .optional(),\n  screen: z\n    .unknown()\n    .describe(\n      'Per-event screen call (mobile backends). Resolves to { name, properties? } or true for minimal screen(). RudderStack requires name (falls back to empty string). Use with skip: true.',\n    )\n    .optional(),\n  alias: z\n    .unknown()\n    .describe(\n      'Per-event alias call. Resolves to { previousId }. Links anonymous user to identified user. Use with rule-level 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, RudderStackAnalyticsMock } from '../types';\n\ntype SdkCall = (_params: Record<string, unknown>) => void;\ntype SdkFlush = (\n  _callback?: (err?: Error, data?: unknown) => void,\n) => Promise<void>;\n\nconst noop: SdkCall = () => {};\nconst asyncNoop: SdkFlush = () => Promise.resolve();\n\nfunction createMockAnalytics(): RudderStackAnalyticsMock {\n  return {\n    track: noop,\n    identify: noop,\n    group: noop,\n    page: noop,\n    screen: noop,\n    alias: noop,\n    flush: 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  'call:analytics.alias',\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 RudderStackStepExample = Flow.StepExample & {\n  settings?: Partial<Settings>;\n};\n\n/**\n * RudderStack server destination invokes the injected `env.analytics` SDK\n * methods (`track`, `identify`, `group`, `page`, `screen`, `alias`) — not a\n * raw HTTP endpoint. Each `out` entry is therefore\n * `[callable, params]` where `callable` is the dotted method name\n * (e.g. `'analytics.track'`) and `params` is the object passed to the SDK.\n *\n * Examples may emit multiple calls in order (e.g. identify + track), so\n * every `out` is wrapped as `[[callable, params], ...]`.\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: RudderStackStepExample = {\n  in: getEvent('product view', {\n    timestamp: 1700000100,\n    user: { id: 'us3r', session: 's3ss10n' },\n  }),\n  out: [\n    [\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/**\n * Mapped event name -- mapping.name renames the event for RudderStack.\n */\nexport const mappedEventName: RudderStackStepExample = {\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    [\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/**\n * Destination-level identify -- fires analytics.identify() on first push\n * when settings.identify mapping resolves. Then fires analytics.track().\n */\nexport const destinationIdentify: RudderStackStepExample = {\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: RudderStackStepExample = {\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    [\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/**\n * Per-event group with skip -- company update fires group() only.\n */\nexport const companyGroup: RudderStackStepExample = {\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    [\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/**\n * Explicit page() call with properties. RudderStack requires name -- resolved\n * from mapping. skip: true suppresses track().\n */\nexport const pageView: RudderStackStepExample = {\n  in: getEvent('page view', {\n    timestamp: 1700000105,\n    user: { id: 'us3r', session: 's3ss10n' },\n    data: {\n      title: 'Getting Started',\n      section: 'tutorials',\n    },\n  }),\n  mapping: {\n    skip: true,\n    settings: {\n      page: {\n        map: {\n          name: 'data.title',\n          properties: {\n            map: {\n              section: 'data.section',\n            },\n          },\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'analytics.page',\n      {\n        userId: 'us3r',\n        anonymousId: 's3ss10n',\n        name: 'Getting Started',\n        properties: { section: 'tutorials' },\n        timestamp: new Date(1700000105),\n      },\n    ],\n  ],\n};\n\n/**\n * Screen call -- server-only method for mobile app backends.\n * RudderStack requires name -- resolved from mapping.\n */\nexport const screenView: RudderStackStepExample = {\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          properties: {\n            map: {\n              build: 'data.build',\n            },\n          },\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'analytics.screen',\n      {\n        userId: 'us3r',\n        anonymousId: 's3ss10n',\n        name: 'Welcome',\n        properties: { build: '1.2.3' },\n        timestamp: new Date(1700000106),\n      },\n    ],\n  ],\n};\n\n/**\n * Alias call -- links anonymous user identity to registered user.\n * skip: true suppresses track(). Requires previousId from mapping.\n */\nexport const aliasUser: RudderStackStepExample = {\n  in: getEvent('identity merge', {\n    timestamp: 1700000107,\n    user: { id: 'registered-456', session: 's3ss10n' },\n    data: {\n      anonymous_id: 'anonymous-123',\n    },\n  }),\n  mapping: {\n    skip: true,\n    settings: {\n      alias: {\n        map: {\n          previousId: 'data.anonymous_id',\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'analytics.alias',\n      {\n        userId: 'registered-456',\n        previousId: 'anonymous-123',\n        timestamp: new Date(1700000107),\n      },\n    ],\n  ],\n};\n\n/**\n * AnonymousId only -- no userId resolved. RudderStack accepts anonymousId alone.\n */\nexport const anonymousOnly: RudderStackStepExample = {\n  in: getEvent('product view', {\n    timestamp: 1700000108,\n    user: { session: 's3ss10n' },\n  }),\n  settings: {\n    userId: undefined,\n  },\n  out: [\n    [\n      'analytics.track',\n      {\n        anonymousId: 's3ss10n',\n        event: 'product view',\n        properties: {},\n        timestamp: new Date(1700000108),\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: RudderStackStepExample = {\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"]}