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

package/README.md

@@ -0,0 +1,73 @@
+# @walkeros/server-destination-customerio
+
+Server-side Customer.io destination for
+[walkerOS](https://github.com/elbwalker/walkerOS). Forwards events to
+Customer.io via the official `customerio-node` SDK with support for Track,
+Identify, Page View, Transactional Messaging, and Customer Lifecycle management.
+
+## Installation
+
+```bash
+npm install @walkeros/server-destination-customerio
+```
+
+## Quick Start
+
+```json
+{
+  "destinations": {
+    "customerio": {
+      "package": "@walkeros/server-destination-customerio",
+      "config": {
+        "settings": {
+          "siteId": "YOUR_SITE_ID",
+          "apiKey": "YOUR_API_KEY",
+          "customerId": "user.id",
+          "anonymousId": "user.session"
+        }
+      }
+    }
+  }
+}
+```
+
+## Settings
+
+| Setting       | Type             | Required | Default          | Description                                                  |
+| ------------- | ---------------- | -------- | ---------------- | ------------------------------------------------------------ |
+| `siteId`      | string           | Yes      | --               | Customer.io Site ID                                          |
+| `apiKey`      | string           | Yes      | --               | Customer.io API Key                                          |
+| `appApiKey`   | string           | No       | --               | App API Key for transactional messaging (sendEmail/sendPush) |
+| `region`      | `'us'` \| `'eu'` | No       | `'us'`           | Data center region                                           |
+| `timeout`     | number           | No       | `10000`          | HTTP request timeout in ms                                   |
+| `customerId`  | string           | No       | `'user.id'`      | Mapping path to resolve customerId from events               |
+| `anonymousId` | string           | No       | `'user.session'` | Mapping path to resolve anonymousId from events              |
+| `identify`    | MappingValue     | No       | --               | Destination-level identity mapping                           |
+
+## Mapping Settings
+
+Per-event mapping settings control which Customer.io methods are called:
+
+| Setting        | Effect                                         | Use with `skip: true` |
+| -------------- | ---------------------------------------------- | --------------------- |
+| `identify`     | Calls `identify()` with attributes             | Yes, for login events |
+| `page`         | Calls `trackPageView()` with url               | Yes, for page views   |
+| `destroy`      | Permanently deletes person                     | Yes                   |
+| `suppress`     | Stops messaging (keeps data)                   | Yes                   |
+| `unsuppress`   | Resumes messaging                              | Yes                   |
+| `addDevice`    | Registers push device                          | Yes                   |
+| `deleteDevice` | Removes push device                            | Yes                   |
+| `merge`        | Merges duplicate profiles                      | Yes                   |
+| `sendEmail`    | Sends transactional email (requires appApiKey) | Yes                   |
+| `sendPush`     | Sends transactional push (requires appApiKey)  | Yes                   |
+
+## Identity
+
+Customer.io uses `customerId` as the primary identifier. When `customerId`
+cannot be resolved but `anonymousId` is available, the destination automatically
+falls back to `trackAnonymous()` for data preservation.
+
+## Shutdown
+
+The destination implements `destroy()` by clearing SDK client references. No
+flush is needed since `customerio-node` does not batch internally.

package/dist/dev.d.mts

@@ -0,0 +1,205 @@
+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<{
+    siteId: z.ZodString;
+    apiKey: z.ZodString;
+    appApiKey: z.ZodOptional<z.ZodString>;
+    region: z.ZodOptional<z.ZodEnum<{
+        us: "us";
+        eu: "eu";
+    }>>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    customerId: z.ZodOptional<z.ZodString>;
+    anonymousId: z.ZodOptional<z.ZodString>;
+    identify: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+type Settings$1 = z.infer<typeof SettingsSchema>;
+
+declare const MappingSchema: z.ZodObject<{
+    identify: z.ZodOptional<z.ZodUnknown>;
+    page: z.ZodOptional<z.ZodUnknown>;
+    destroy: z.ZodOptional<z.ZodBoolean>;
+    suppress: z.ZodOptional<z.ZodBoolean>;
+    unsuppress: z.ZodOptional<z.ZodBoolean>;
+    addDevice: z.ZodOptional<z.ZodUnknown>;
+    deleteDevice: z.ZodOptional<z.ZodUnknown>;
+    merge: z.ZodOptional<z.ZodUnknown>;
+    sendEmail: z.ZodOptional<z.ZodUnknown>;
+    sendPush: 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 };
+}
+
+/**
+ * Mock-friendly interface for the TrackClient methods the
+ * destination actually calls. Tests provide this via env.trackClient
+ * instead of the real SDK.
+ */
+interface CustomerIoTrackClientMock {
+    identify: (customerId: string | number, attributes: Record<string, unknown>) => Promise<void>;
+    track: (customerId: string | number, eventData: {
+        name: string;
+        data?: Record<string, unknown>;
+        timestamp?: number;
+    }) => Promise<void>;
+    trackAnonymous: (anonymousId: string, eventData: {
+        name: string;
+        data?: Record<string, unknown>;
+        timestamp?: number;
+    }) => Promise<void>;
+    trackPageView: (customerId: string | number, url: string, data?: Record<string, unknown>) => Promise<void>;
+    destroy: (customerId: string | number) => Promise<void>;
+    suppress: (customerId: string | number) => Promise<void>;
+    unsuppress: (customerId: string | number) => Promise<void>;
+    addDevice: (customerId: string | number, deviceId: string, platform: string, data?: Record<string, unknown>) => Promise<void>;
+    deleteDevice: (customerId: string | number, deviceId: string, platform: string) => Promise<void>;
+    mergeCustomers: (primaryType: string, primaryId: string, secondaryType: string, secondaryId: string) => Promise<void>;
+}
+/**
+ * Mock-friendly interface for the APIClient methods the
+ * destination actually calls. Tests provide this via env.apiClient
+ * instead of the real SDK.
+ */
+interface CustomerIoApiClientMock {
+    sendEmail: (request: unknown) => Promise<void>;
+    sendPush: (request: unknown) => Promise<void>;
+}
+interface Settings {
+    /** Customer.io Site ID (required for Track API). */
+    siteId: string;
+    /** Customer.io API Key (required for Track API). */
+    apiKey: string;
+    /** App API Key for transactional messaging (optional). */
+    appApiKey?: string;
+    /** Region: 'us' or 'eu'. Default: 'us'. */
+    region?: 'us' | 'eu';
+    /** HTTP request timeout in ms. Default: 10000. */
+    timeout?: number;
+    /** walkerOS mapping value path to resolve customerId from each event. */
+    customerId?: string;
+    /** walkerOS mapping value path to resolve anonymousId from each event. */
+    anonymousId?: string;
+    /** Destination-level identify mapping (fires identify() on first push / change). */
+    identify?: Mapping$1.Value;
+    /** Runtime state -- not user-facing. */
+    _trackClient?: CustomerIoTrackClientMock;
+    _apiClient?: CustomerIoApiClientMock;
+    _state?: RuntimeState;
+}
+interface RuntimeState {
+    lastIdentity?: {
+        customerId?: string;
+        attributesHash?: string;
+    };
+}
+/**
+ * Env -- optional SDK override. Production leaves this undefined and the
+ * destination creates real TrackClient/APIClient instances. Tests provide
+ * mocks via env.trackClient and env.apiClient.
+ */
+interface Env extends DestinationServer.Env {
+    trackClient?: CustomerIoTrackClientMock;
+    apiClient?: CustomerIoApiClientMock;
+}
+
+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 CustomerIoStepExample = Flow.StepExample & {
+    settings?: Partial<Settings>;
+};
+/**
+ * Default event forwarding -- trackClient.track() with event name and data.
+ * customerId resolved from default settings.customerId = 'user.id'.
+ */
+declare const defaultTrack: CustomerIoStepExample;
+/**
+ * Mapped event name -- mapping.name renames the event for Customer.io.
+ */
+declare const mappedEventName: CustomerIoStepExample;
+/**
+ * Track with mapped data properties.
+ */
+declare const mappedData: CustomerIoStepExample;
+/**
+ * Anonymous event -- no customerId resolved, falls back to trackAnonymous().
+ */
+declare const anonymousTrack: CustomerIoStepExample;
+/**
+ * Destination-level identify -- fires trackClient.identify() on first push
+ * when settings.identify mapping resolves. Then fires trackClient.track().
+ */
+declare const destinationIdentify: CustomerIoStepExample;
+/**
+ * Per-event identify with skip -- user login fires identify() only.
+ */
+declare const userLoginIdentify: CustomerIoStepExample;
+/**
+ * Page view -- fires trackClient.trackPageView() with url.
+ * skip: true suppresses track(); settings.page fires trackPageView().
+ */
+declare const pageView: CustomerIoStepExample;
+/**
+ * Destroy -- permanently deletes a person from Customer.io.
+ */
+declare const destroyPerson: CustomerIoStepExample;
+/**
+ * Suppress -- stops messaging without deleting data.
+ */
+declare const suppressPerson: CustomerIoStepExample;
+/**
+ * Unsuppress -- resumes messaging for a suppressed person.
+ */
+declare const unsuppressPerson: CustomerIoStepExample;
+/**
+ * Wildcard ignore -- the event matches a mapping rule with ignore: true.
+ * The destination fires zero SDK calls.
+ */
+declare const wildcardIgnored: CustomerIoStepExample;
+
+type step_CustomerIoStepExample = CustomerIoStepExample;
+declare const step_anonymousTrack: typeof anonymousTrack;
+declare const step_defaultTrack: typeof defaultTrack;
+declare const step_destinationIdentify: typeof destinationIdentify;
+declare const step_destroyPerson: typeof destroyPerson;
+declare const step_mappedData: typeof mappedData;
+declare const step_mappedEventName: typeof mappedEventName;
+declare const step_pageView: typeof pageView;
+declare const step_suppressPerson: typeof suppressPerson;
+declare const step_unsuppressPerson: typeof unsuppressPerson;
+declare const step_userLoginIdentify: typeof userLoginIdentify;
+declare const step_wildcardIgnored: typeof wildcardIgnored;
+declare namespace step {
+  export { type step_CustomerIoStepExample as CustomerIoStepExample, step_anonymousTrack as anonymousTrack, step_defaultTrack as defaultTrack, step_destinationIdentify as destinationIdentify, step_destroyPerson as destroyPerson, step_mappedData as mappedData, step_mappedEventName as mappedEventName, step_pageView as pageView, step_suppressPerson as suppressPerson, step_unsuppressPerson as unsuppressPerson, 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,205 @@
+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<{
+    siteId: z.ZodString;
+    apiKey: z.ZodString;
+    appApiKey: z.ZodOptional<z.ZodString>;
+    region: z.ZodOptional<z.ZodEnum<{
+        us: "us";
+        eu: "eu";
+    }>>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    customerId: z.ZodOptional<z.ZodString>;
+    anonymousId: z.ZodOptional<z.ZodString>;
+    identify: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+type Settings$1 = z.infer<typeof SettingsSchema>;
+
+declare const MappingSchema: z.ZodObject<{
+    identify: z.ZodOptional<z.ZodUnknown>;
+    page: z.ZodOptional<z.ZodUnknown>;
+    destroy: z.ZodOptional<z.ZodBoolean>;
+    suppress: z.ZodOptional<z.ZodBoolean>;
+    unsuppress: z.ZodOptional<z.ZodBoolean>;
+    addDevice: z.ZodOptional<z.ZodUnknown>;
+    deleteDevice: z.ZodOptional<z.ZodUnknown>;
+    merge: z.ZodOptional<z.ZodUnknown>;
+    sendEmail: z.ZodOptional<z.ZodUnknown>;
+    sendPush: 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 };
+}
+
+/**
+ * Mock-friendly interface for the TrackClient methods the
+ * destination actually calls. Tests provide this via env.trackClient
+ * instead of the real SDK.
+ */
+interface CustomerIoTrackClientMock {
+    identify: (customerId: string | number, attributes: Record<string, unknown>) => Promise<void>;
+    track: (customerId: string | number, eventData: {
+        name: string;
+        data?: Record<string, unknown>;
+        timestamp?: number;
+    }) => Promise<void>;
+    trackAnonymous: (anonymousId: string, eventData: {
+        name: string;
+        data?: Record<string, unknown>;
+        timestamp?: number;
+    }) => Promise<void>;
+    trackPageView: (customerId: string | number, url: string, data?: Record<string, unknown>) => Promise<void>;
+    destroy: (customerId: string | number) => Promise<void>;
+    suppress: (customerId: string | number) => Promise<void>;
+    unsuppress: (customerId: string | number) => Promise<void>;
+    addDevice: (customerId: string | number, deviceId: string, platform: string, data?: Record<string, unknown>) => Promise<void>;
+    deleteDevice: (customerId: string | number, deviceId: string, platform: string) => Promise<void>;
+    mergeCustomers: (primaryType: string, primaryId: string, secondaryType: string, secondaryId: string) => Promise<void>;
+}
+/**
+ * Mock-friendly interface for the APIClient methods the
+ * destination actually calls. Tests provide this via env.apiClient
+ * instead of the real SDK.
+ */
+interface CustomerIoApiClientMock {
+    sendEmail: (request: unknown) => Promise<void>;
+    sendPush: (request: unknown) => Promise<void>;
+}
+interface Settings {
+    /** Customer.io Site ID (required for Track API). */
+    siteId: string;
+    /** Customer.io API Key (required for Track API). */
+    apiKey: string;
+    /** App API Key for transactional messaging (optional). */
+    appApiKey?: string;
+    /** Region: 'us' or 'eu'. Default: 'us'. */
+    region?: 'us' | 'eu';
+    /** HTTP request timeout in ms. Default: 10000. */
+    timeout?: number;
+    /** walkerOS mapping value path to resolve customerId from each event. */
+    customerId?: string;
+    /** walkerOS mapping value path to resolve anonymousId from each event. */
+    anonymousId?: string;
+    /** Destination-level identify mapping (fires identify() on first push / change). */
+    identify?: Mapping$1.Value;
+    /** Runtime state -- not user-facing. */
+    _trackClient?: CustomerIoTrackClientMock;
+    _apiClient?: CustomerIoApiClientMock;
+    _state?: RuntimeState;
+}
+interface RuntimeState {
+    lastIdentity?: {
+        customerId?: string;
+        attributesHash?: string;
+    };
+}
+/**
+ * Env -- optional SDK override. Production leaves this undefined and the
+ * destination creates real TrackClient/APIClient instances. Tests provide
+ * mocks via env.trackClient and env.apiClient.
+ */
+interface Env extends DestinationServer.Env {
+    trackClient?: CustomerIoTrackClientMock;
+    apiClient?: CustomerIoApiClientMock;
+}
+
+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 CustomerIoStepExample = Flow.StepExample & {
+    settings?: Partial<Settings>;
+};
+/**
+ * Default event forwarding -- trackClient.track() with event name and data.
+ * customerId resolved from default settings.customerId = 'user.id'.
+ */
+declare const defaultTrack: CustomerIoStepExample;
+/**
+ * Mapped event name -- mapping.name renames the event for Customer.io.
+ */
+declare const mappedEventName: CustomerIoStepExample;
+/**
+ * Track with mapped data properties.
+ */
+declare const mappedData: CustomerIoStepExample;
+/**
+ * Anonymous event -- no customerId resolved, falls back to trackAnonymous().
+ */
+declare const anonymousTrack: CustomerIoStepExample;
+/**
+ * Destination-level identify -- fires trackClient.identify() on first push
+ * when settings.identify mapping resolves. Then fires trackClient.track().
+ */
+declare const destinationIdentify: CustomerIoStepExample;
+/**
+ * Per-event identify with skip -- user login fires identify() only.
+ */
+declare const userLoginIdentify: CustomerIoStepExample;
+/**
+ * Page view -- fires trackClient.trackPageView() with url.
+ * skip: true suppresses track(); settings.page fires trackPageView().
+ */
+declare const pageView: CustomerIoStepExample;
+/**
+ * Destroy -- permanently deletes a person from Customer.io.
+ */
+declare const destroyPerson: CustomerIoStepExample;
+/**
+ * Suppress -- stops messaging without deleting data.
+ */
+declare const suppressPerson: CustomerIoStepExample;
+/**
+ * Unsuppress -- resumes messaging for a suppressed person.
+ */
+declare const unsuppressPerson: CustomerIoStepExample;
+/**
+ * Wildcard ignore -- the event matches a mapping rule with ignore: true.
+ * The destination fires zero SDK calls.
+ */
+declare const wildcardIgnored: CustomerIoStepExample;
+
+type step_CustomerIoStepExample = CustomerIoStepExample;
+declare const step_anonymousTrack: typeof anonymousTrack;
+declare const step_defaultTrack: typeof defaultTrack;
+declare const step_destinationIdentify: typeof destinationIdentify;
+declare const step_destroyPerson: typeof destroyPerson;
+declare const step_mappedData: typeof mappedData;
+declare const step_mappedEventName: typeof mappedEventName;
+declare const step_pageView: typeof pageView;
+declare const step_suppressPerson: typeof suppressPerson;
+declare const step_unsuppressPerson: typeof unsuppressPerson;
+declare const step_userLoginIdentify: typeof userLoginIdentify;
+declare const step_wildcardIgnored: typeof wildcardIgnored;
+declare namespace step {
+  export { type step_CustomerIoStepExample as CustomerIoStepExample, step_anonymousTrack as anonymousTrack, step_defaultTrack as defaultTrack, step_destinationIdentify as destinationIdentify, step_destroyPerson as destroyPerson, step_mappedData as mappedData, step_mappedEventName as mappedEventName, step_pageView as pageView, step_suppressPerson as suppressPerson, step_unsuppressPerson as unsuppressPerson, 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,i=Object.getOwnPropertyNames,r=Object.prototype.hasOwnProperty,a=(e,t)=>{for(var i in t)s(e,i,{get:t[i],enumerable:!0})},n={};a(n,{examples:()=>v,schemas:()=>o}),module.exports=(e=n,((e,a,n,o)=>{if(a&&"object"==typeof a||"function"==typeof a)for(let p of i(a))r.call(e,p)||p===n||s(e,p,{get:()=>a[p],enumerable:!(o=t(a,p))||o.enumerable});return e})(s({},"__esModule",{value:!0}),e));var o={};a(o,{MappingSchema:()=>d,SettingsSchema:()=>l,mapping:()=>g,settings:()=>c});var p=require("@walkeros/core/dev"),u=require("@walkeros/core/dev"),l=u.z.object({siteId:u.z.string().min(1).describe("Customer.io Site ID. Find it in Settings > Workspace Settings > API Credentials."),apiKey:u.z.string().min(1).describe("Customer.io API Key. Find it in Settings > Workspace Settings > API Credentials."),appApiKey:u.z.string().describe("App API Key for transactional messaging (sendEmail/sendPush). Find it in Settings > Workspace Settings > API Credentials > App API Keys.").optional(),region:u.z.enum(["us","eu"]).describe("Data center region. Must match where your Customer.io workspace was created. Default: us.").optional(),timeout:u.z.number().int().positive().describe("HTTP request timeout in milliseconds. Default: 10000.").optional(),customerId:u.z.string().describe("walkerOS mapping value path to resolve customerId from each event (like user.id).").optional(),anonymousId:u.z.string().describe("walkerOS mapping value path to resolve anonymousId from each event (like user.session).").optional(),identify:u.z.unknown().describe("Destination-level identity mapping. Resolves to { email?, first_name?, ... } attributes. Fires identify() on first push and re-fires when values change.").optional()}),m=require("@walkeros/core/dev"),d=m.z.object({identify:m.z.unknown().describe("Per-event identify attributes. Resolves to { email?, first_name?, ... }. Use with skip: true on login/identify events.").optional(),page:m.z.unknown().describe("Per-event page view. Resolves to { url, ... }. Calls trackPageView(). Use with skip: true.").optional(),destroy:m.z.boolean().describe("Permanently delete person from Customer.io. Set true on delete events with skip: true.").optional(),suppress:m.z.boolean().describe("Suppress person (stop messaging without deleting data). Set true with skip: true.").optional(),unsuppress:m.z.boolean().describe("Unsuppress person (resume messaging). Set true with skip: true.").optional(),addDevice:m.z.unknown().describe("Register push device. Resolves to { deviceId, platform, data? }. Use with skip: true.").optional(),deleteDevice:m.z.unknown().describe("Remove push device. Resolves to { deviceId, platform }. Use with skip: true.").optional(),merge:m.z.unknown().describe("Merge duplicate profiles. Resolves to { primaryType, primaryId, secondaryType, secondaryId }. Use with skip: true.").optional(),sendEmail:m.z.unknown().describe("Send transactional email. Resolves to { to, transactional_message_id, message_data?, identifiers? }. Requires appApiKey. Use with skip: true.").optional(),sendPush:m.z.unknown().describe("Send transactional push. Resolves to { transactional_message_id, message_data?, identifiers? }. Requires appApiKey. Use with skip: true.").optional()}),c=(0,p.zodToSchema)(l),g=(0,p.zodToSchema)(d),v={};a(v,{env:()=>k,step:()=>b});var k={};a(k,{push:()=>f,simulation:()=>h});var y=()=>Promise.resolve(),w=()=>Promise.resolve();var f={trackClient:{identify:()=>Promise.resolve(),track:()=>Promise.resolve(),trackAnonymous:()=>Promise.resolve(),trackPageView:()=>Promise.resolve(),destroy:y,suppress:y,unsuppress:y,addDevice:()=>Promise.resolve(),deleteDevice:()=>Promise.resolve(),mergeCustomers:()=>Promise.resolve()},apiClient:{sendEmail:w,sendPush:w}},h=["call:trackClient.identify","call:trackClient.track","call:trackClient.trackAnonymous","call:trackClient.trackPageView","call:trackClient.destroy","call:trackClient.suppress","call:trackClient.unsuppress","call:trackClient.addDevice","call:trackClient.deleteDevice","call:trackClient.mergeCustomers","call:apiClient.sendEmail","call:apiClient.sendPush"],b={};a(b,{anonymousTrack:()=>S,defaultTrack:()=>P,destinationIdentify:()=>E,destroyPerson:()=>R,mappedData:()=>I,mappedEventName:()=>z,pageView:()=>A,suppressPerson:()=>D,unsuppressPerson:()=>U,userLoginIdentify:()=>_,wildcardIgnored:()=>O});var C=require("@walkeros/core"),P={in:(0,C.getEvent)("product view",{timestamp:1700000100,user:{id:"us3r",session:"s3ss10n"}}),out:[["trackClient.track","us3r",{name:"product view",data:{},timestamp:17e5}]]},z={in:(0,C.getEvent)("order complete",{timestamp:1700000101,user:{id:"us3r",session:"s3ss10n"}}),mapping:{name:"purchase"},out:[["trackClient.track","us3r",{name:"purchase",data:{},timestamp:17e5}]]},I={in:(0,C.getEvent)("order complete",{timestamp:1700000102,user:{id:"us3r",session:"s3ss10n"},data:{id:"0rd3r1d",total:555,currency:"EUR"}}),mapping:{name:"purchase",data:{map:{order_id:"data.id",value:"data.total",currency:"data.currency"}}},out:[["trackClient.track","us3r",{name:"purchase",data:{order_id:"0rd3r1d",value:555,currency:"EUR"},timestamp:17e5}]]},S={in:(0,C.getEvent)("product view",{timestamp:1700000103,user:{session:"s3ss10n"}}),settings:{customerId:void 0},out:[["trackClient.trackAnonymous","s3ss10n",{name:"product view",data:{},timestamp:17e5}]]},E={in:(0,C.getEvent)("page view",{timestamp:1700000104,user:{id:"us3r",session:"s3ss10n",email:"user@example.com"}}),settings:{identify:{map:{email:"user.email"}}},out:[["trackClient.identify","us3r",{email:"user@example.com"}],["trackClient.track","us3r",{name:"page view",data:{},timestamp:17e5}]]},_={in:(0,C.getEvent)("user login",{timestamp:1700000105,user:{id:"us3r",session:"s3ss10n"},data:{email:"user@acme.com",first_name:"Jane",plan:"premium"}}),mapping:{skip:!0,settings:{identify:{map:{email:"data.email",first_name:"data.first_name",plan:"data.plan"}}}},out:[["trackClient.identify","us3r",{email:"user@acme.com",first_name:"Jane",plan:"premium"}]]},A={in:(0,C.getEvent)("page view",{timestamp:1700000106,user:{id:"us3r",session:"s3ss10n"},data:{url:"https://example.com/pricing",referrer:"https://google.com"}}),mapping:{skip:!0,settings:{page:{map:{url:"data.url",referrer:"data.referrer"}}}},out:[["trackClient.trackPageView","us3r","https://example.com/pricing",{referrer:"https://google.com"}]]},R={in:(0,C.getEvent)("user delete",{timestamp:1700000107,user:{id:"us3r",session:"s3ss10n"}}),mapping:{skip:!0,settings:{destroy:!0}},out:[["trackClient.destroy","us3r"]]},D={in:(0,C.getEvent)("user suppress",{timestamp:1700000108,user:{id:"us3r",session:"s3ss10n"}}),mapping:{skip:!0,settings:{suppress:!0}},out:[["trackClient.suppress","us3r"]]},U={in:(0,C.getEvent)("user unsuppress",{timestamp:1700000109,user:{id:"us3r",session:"s3ss10n"}}),mapping:{skip:!0,settings:{unsuppress:!0}},out:[["trackClient.unsuppress","us3r"]]},O={in:(0,C.getEvent)("debug noise",{timestamp:1700000110,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  siteId: z\n    .string()\n    .min(1)\n    .describe(\n      'Customer.io Site ID. Find it in Settings > Workspace Settings > API Credentials.',\n    ),\n  apiKey: z\n    .string()\n    .min(1)\n    .describe(\n      'Customer.io API Key. Find it in Settings > Workspace Settings > API Credentials.',\n    ),\n  appApiKey: z\n    .string()\n    .describe(\n      'App API Key for transactional messaging (sendEmail/sendPush). Find it in Settings > Workspace Settings > API Credentials > App API Keys.',\n    )\n    .optional(),\n  region: z\n    .enum(['us', 'eu'])\n    .describe(\n      'Data center region. Must match where your Customer.io workspace was created. Default: us.',\n    )\n    .optional(),\n  timeout: z\n    .number()\n    .int()\n    .positive()\n    .describe('HTTP request timeout in milliseconds. Default: 10000.')\n    .optional(),\n  customerId: z\n    .string()\n    .describe(\n      'walkerOS mapping value path to resolve customerId 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  identify: z\n    .unknown()\n    .describe(\n      'Destination-level identity mapping. Resolves to { email?, first_name?, ... } attributes. Fires identify() on first push and re-fires when values change.',\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 identify attributes. Resolves to { email?, first_name?, ... }. Use with skip: true on login/identify events.',\n    )\n    .optional(),\n  page: z\n    .unknown()\n    .describe(\n      'Per-event page view. Resolves to { url, ... }. Calls trackPageView(). Use with skip: true.',\n    )\n    .optional(),\n  destroy: z\n    .boolean()\n    .describe(\n      'Permanently delete person from Customer.io. Set true on delete events with skip: true.',\n    )\n    .optional(),\n  suppress: z\n    .boolean()\n    .describe(\n      'Suppress person (stop messaging without deleting data). Set true with skip: true.',\n    )\n    .optional(),\n  unsuppress: z\n    .boolean()\n    .describe('Unsuppress person (resume messaging). Set true with skip: true.')\n    .optional(),\n  addDevice: z\n    .unknown()\n    .describe(\n      'Register push device. Resolves to { deviceId, platform, data? }. Use with skip: true.',\n    )\n    .optional(),\n  deleteDevice: z\n    .unknown()\n    .describe(\n      'Remove push device. Resolves to { deviceId, platform }. Use with skip: true.',\n    )\n    .optional(),\n  merge: z\n    .unknown()\n    .describe(\n      'Merge duplicate profiles. Resolves to { primaryType, primaryId, secondaryType, secondaryId }. Use with skip: true.',\n    )\n    .optional(),\n  sendEmail: z\n    .unknown()\n    .describe(\n      'Send transactional email. Resolves to { to, transactional_message_id, message_data?, identifiers? }. Requires appApiKey. Use with skip: true.',\n    )\n    .optional(),\n  sendPush: z\n    .unknown()\n    .describe(\n      'Send transactional push. Resolves to { transactional_message_id, message_data?, identifiers? }. Requires appApiKey. 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 {\n  Env,\n  CustomerIoTrackClientMock,\n  CustomerIoApiClientMock,\n} from '../types';\n\ntype TrackNoArg = () => Promise<void>;\ntype TrackOne = (_id: string | number) => Promise<void>;\ntype TrackIdentify = (\n  _id: string | number,\n  _attrs: Record<string, unknown>,\n) => Promise<void>;\ntype TrackEvent = (\n  _id: string | number,\n  _event: {\n    name: string;\n    data?: Record<string, unknown>;\n    timestamp?: number;\n  },\n) => Promise<void>;\ntype TrackAnonymous = (\n  _id: string,\n  _event: {\n    name: string;\n    data?: Record<string, unknown>;\n    timestamp?: number;\n  },\n) => Promise<void>;\ntype TrackPage = (\n  _id: string | number,\n  _url: string,\n  _data?: Record<string, unknown>,\n) => Promise<void>;\ntype TrackAddDevice = (\n  _id: string | number,\n  _deviceId: string,\n  _platform: string,\n  _data?: Record<string, unknown>,\n) => Promise<void>;\ntype TrackDeleteDevice = (\n  _id: string | number,\n  _deviceId: string,\n  _platform: string,\n) => Promise<void>;\ntype TrackMerge = (\n  _pt: string,\n  _pi: string,\n  _st: string,\n  _si: string,\n) => Promise<void>;\ntype ApiSend = (_request: unknown) => Promise<void>;\n\nconst asyncIdentify: TrackIdentify = () => Promise.resolve();\nconst asyncEvent: TrackEvent = () => Promise.resolve();\nconst asyncAnonymous: TrackAnonymous = () => Promise.resolve();\nconst asyncPage: TrackPage = () => Promise.resolve();\nconst asyncOne: TrackOne = () => Promise.resolve();\nconst asyncAddDevice: TrackAddDevice = () => Promise.resolve();\nconst asyncDeleteDevice: TrackDeleteDevice = () => Promise.resolve();\nconst asyncMerge: TrackMerge = () => Promise.resolve();\nconst asyncSend: ApiSend = () => Promise.resolve();\n\n// Suppress unused warning for narrow helper aliases used below.\nvoid (null as unknown as TrackNoArg);\n\nfunction createMockTrackClient(): CustomerIoTrackClientMock {\n  return {\n    identify: asyncIdentify,\n    track: asyncEvent,\n    trackAnonymous: asyncAnonymous,\n    trackPageView: asyncPage,\n    destroy: asyncOne,\n    suppress: asyncOne,\n    unsuppress: asyncOne,\n    addDevice: asyncAddDevice,\n    deleteDevice: asyncDeleteDevice,\n    mergeCustomers: asyncMerge,\n  };\n}\n\nfunction createMockApiClient(): CustomerIoApiClientMock {\n  return {\n    sendEmail: asyncSend,\n    sendPush: asyncSend,\n  };\n}\n\nexport const push: Env = {\n  trackClient: createMockTrackClient(),\n  apiClient: createMockApiClient(),\n};\n\nexport const simulation = [\n  'call:trackClient.identify',\n  'call:trackClient.track',\n  'call:trackClient.trackAnonymous',\n  'call:trackClient.trackPageView',\n  'call:trackClient.destroy',\n  'call:trackClient.suppress',\n  'call:trackClient.unsuppress',\n  'call:trackClient.addDevice',\n  'call:trackClient.deleteDevice',\n  'call:trackClient.mergeCustomers',\n  'call:apiClient.sendEmail',\n  'call:apiClient.sendPush',\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 CustomerIoStepExample = Flow.StepExample & {\n  settings?: Partial<Settings>;\n};\n\n/**\n * Default event forwarding -- trackClient.track() with event name and data.\n * customerId resolved from default settings.customerId = 'user.id'.\n */\nexport const defaultTrack: CustomerIoStepExample = {\n  in: getEvent('product view', {\n    timestamp: 1700000100,\n    user: { id: 'us3r', session: 's3ss10n' },\n  }),\n  out: [\n    [\n      'trackClient.track',\n      'us3r',\n      {\n        name: 'product view',\n        data: {},\n        timestamp: 1700000,\n      },\n    ],\n  ],\n};\n\n/**\n * Mapped event name -- mapping.name renames the event for Customer.io.\n */\nexport const mappedEventName: CustomerIoStepExample = {\n  in: getEvent('order complete', {\n    timestamp: 1700000101,\n    user: { id: 'us3r', session: 's3ss10n' },\n  }),\n  mapping: {\n    name: 'purchase',\n  },\n  out: [\n    [\n      'trackClient.track',\n      'us3r',\n      {\n        name: 'purchase',\n        data: {},\n        timestamp: 1700000,\n      },\n    ],\n  ],\n};\n\n/**\n * Track with mapped data properties.\n */\nexport const mappedData: CustomerIoStepExample = {\n  in: getEvent('order complete', {\n    timestamp: 1700000102,\n    user: { id: 'us3r', session: 's3ss10n' },\n    data: { id: '0rd3r1d', total: 555, currency: 'EUR' },\n  }),\n  mapping: {\n    name: 'purchase',\n    data: {\n      map: {\n        order_id: 'data.id',\n        value: 'data.total',\n        currency: 'data.currency',\n      },\n    },\n  },\n  out: [\n    [\n      'trackClient.track',\n      'us3r',\n      {\n        name: 'purchase',\n        data: { order_id: '0rd3r1d', value: 555, currency: 'EUR' },\n        timestamp: 1700000,\n      },\n    ],\n  ],\n};\n\n/**\n * Anonymous event -- no customerId resolved, falls back to trackAnonymous().\n */\nexport const anonymousTrack: CustomerIoStepExample = {\n  in: getEvent('product view', {\n    timestamp: 1700000103,\n    user: { session: 's3ss10n' },\n  }),\n  settings: {\n    customerId: undefined,\n  },\n  out: [\n    [\n      'trackClient.trackAnonymous',\n      's3ss10n',\n      {\n        name: 'product view',\n        data: {},\n        timestamp: 1700000,\n      },\n    ],\n  ],\n};\n\n/**\n * Destination-level identify -- fires trackClient.identify() on first push\n * when settings.identify mapping resolves. Then fires trackClient.track().\n */\nexport const destinationIdentify: CustomerIoStepExample = {\n  in: getEvent('page view', {\n    timestamp: 1700000104,\n    user: { id: 'us3r', session: 's3ss10n', email: 'user@example.com' },\n  }),\n  settings: {\n    identify: {\n      map: {\n        email: 'user.email',\n      },\n    },\n  },\n  out: [\n    ['trackClient.identify', 'us3r', { email: 'user@example.com' }],\n    [\n      'trackClient.track',\n      'us3r',\n      {\n        name: 'page view',\n        data: {},\n        timestamp: 1700000,\n      },\n    ],\n  ],\n};\n\n/**\n * Per-event identify with skip -- user login fires identify() only.\n */\nexport const userLoginIdentify: CustomerIoStepExample = {\n  in: getEvent('user login', {\n    timestamp: 1700000105,\n    user: { id: 'us3r', session: 's3ss10n' },\n    data: {\n      email: 'user@acme.com',\n      first_name: 'Jane',\n      plan: 'premium',\n    },\n  }),\n  mapping: {\n    skip: true,\n    settings: {\n      identify: {\n        map: {\n          email: 'data.email',\n          first_name: 'data.first_name',\n          plan: 'data.plan',\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'trackClient.identify',\n      'us3r',\n      { email: 'user@acme.com', first_name: 'Jane', plan: 'premium' },\n    ],\n  ],\n};\n\n/**\n * Page view -- fires trackClient.trackPageView() with url.\n * skip: true suppresses track(); settings.page fires trackPageView().\n */\nexport const pageView: CustomerIoStepExample = {\n  in: getEvent('page view', {\n    timestamp: 1700000106,\n    user: { id: 'us3r', session: 's3ss10n' },\n    data: {\n      url: 'https://example.com/pricing',\n      referrer: 'https://google.com',\n    },\n  }),\n  mapping: {\n    skip: true,\n    settings: {\n      page: {\n        map: {\n          url: 'data.url',\n          referrer: 'data.referrer',\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'trackClient.trackPageView',\n      'us3r',\n      'https://example.com/pricing',\n      { referrer: 'https://google.com' },\n    ],\n  ],\n};\n\n/**\n * Destroy -- permanently deletes a person from Customer.io.\n */\nexport const destroyPerson: CustomerIoStepExample = {\n  in: getEvent('user delete', {\n    timestamp: 1700000107,\n    user: { id: 'us3r', session: 's3ss10n' },\n  }),\n  mapping: {\n    skip: true,\n    settings: {\n      destroy: true,\n    },\n  },\n  out: [['trackClient.destroy', 'us3r']],\n};\n\n/**\n * Suppress -- stops messaging without deleting data.\n */\nexport const suppressPerson: CustomerIoStepExample = {\n  in: getEvent('user suppress', {\n    timestamp: 1700000108,\n    user: { id: 'us3r', session: 's3ss10n' },\n  }),\n  mapping: {\n    skip: true,\n    settings: {\n      suppress: true,\n    },\n  },\n  out: [['trackClient.suppress', 'us3r']],\n};\n\n/**\n * Unsuppress -- resumes messaging for a suppressed person.\n */\nexport const unsuppressPerson: CustomerIoStepExample = {\n  in: getEvent('user unsuppress', {\n    timestamp: 1700000109,\n    user: { id: 'us3r', session: 's3ss10n' },\n  }),\n  mapping: {\n    skip: true,\n    settings: {\n      unsuppress: true,\n    },\n  },\n  out: [['trackClient.unsuppress', 'us3r']],\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: CustomerIoStepExample = {\n  in: getEvent('debug noise', {\n    timestamp: 1700000110,\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,t)=>{for(var i in t)e(s,i,{get:t[i],enumerable:!0})},t={};s(t,{MappingSchema:()=>o,SettingsSchema:()=>a,mapping:()=>l,settings:()=>p});import{zodToSchema as i}from"@walkeros/core/dev";import{z as r}from"@walkeros/core/dev";var a=r.object({siteId:r.string().min(1).describe("Customer.io Site ID. Find it in Settings > Workspace Settings > API Credentials."),apiKey:r.string().min(1).describe("Customer.io API Key. Find it in Settings > Workspace Settings > API Credentials."),appApiKey:r.string().describe("App API Key for transactional messaging (sendEmail/sendPush). Find it in Settings > Workspace Settings > API Credentials > App API Keys.").optional(),region:r.enum(["us","eu"]).describe("Data center region. Must match where your Customer.io workspace was created. Default: us.").optional(),timeout:r.number().int().positive().describe("HTTP request timeout in milliseconds. Default: 10000.").optional(),customerId:r.string().describe("walkerOS mapping value path to resolve customerId from each event (like user.id).").optional(),anonymousId:r.string().describe("walkerOS mapping value path to resolve anonymousId from each event (like user.session).").optional(),identify:r.unknown().describe("Destination-level identity mapping. Resolves to { email?, first_name?, ... } attributes. Fires identify() on first push and re-fires when values change.").optional()});import{z as n}from"@walkeros/core/dev";var o=n.object({identify:n.unknown().describe("Per-event identify attributes. Resolves to { email?, first_name?, ... }. Use with skip: true on login/identify events.").optional(),page:n.unknown().describe("Per-event page view. Resolves to { url, ... }. Calls trackPageView(). Use with skip: true.").optional(),destroy:n.boolean().describe("Permanently delete person from Customer.io. Set true on delete events with skip: true.").optional(),suppress:n.boolean().describe("Suppress person (stop messaging without deleting data). Set true with skip: true.").optional(),unsuppress:n.boolean().describe("Unsuppress person (resume messaging). Set true with skip: true.").optional(),addDevice:n.unknown().describe("Register push device. Resolves to { deviceId, platform, data? }. Use with skip: true.").optional(),deleteDevice:n.unknown().describe("Remove push device. Resolves to { deviceId, platform }. Use with skip: true.").optional(),merge:n.unknown().describe("Merge duplicate profiles. Resolves to { primaryType, primaryId, secondaryType, secondaryId }. Use with skip: true.").optional(),sendEmail:n.unknown().describe("Send transactional email. Resolves to { to, transactional_message_id, message_data?, identifiers? }. Requires appApiKey. Use with skip: true.").optional(),sendPush:n.unknown().describe("Send transactional push. Resolves to { transactional_message_id, message_data?, identifiers? }. Requires appApiKey. Use with skip: true.").optional()}),p=i(a),l=i(o),u={};s(u,{env:()=>m,step:()=>v});var m={};s(m,{push:()=>g,simulation:()=>k});var d=()=>Promise.resolve(),c=()=>Promise.resolve();var g={trackClient:{identify:()=>Promise.resolve(),track:()=>Promise.resolve(),trackAnonymous:()=>Promise.resolve(),trackPageView:()=>Promise.resolve(),destroy:d,suppress:d,unsuppress:d,addDevice:()=>Promise.resolve(),deleteDevice:()=>Promise.resolve(),mergeCustomers:()=>Promise.resolve()},apiClient:{sendEmail:c,sendPush:c}},k=["call:trackClient.identify","call:trackClient.track","call:trackClient.trackAnonymous","call:trackClient.trackPageView","call:trackClient.destroy","call:trackClient.suppress","call:trackClient.unsuppress","call:trackClient.addDevice","call:trackClient.deleteDevice","call:trackClient.mergeCustomers","call:apiClient.sendEmail","call:apiClient.sendPush"],v={};s(v,{anonymousTrack:()=>C,defaultTrack:()=>f,destinationIdentify:()=>P,destroyPerson:()=>S,mappedData:()=>h,mappedEventName:()=>w,pageView:()=>I,suppressPerson:()=>A,unsuppressPerson:()=>R,userLoginIdentify:()=>b,wildcardIgnored:()=>_});import{getEvent as y}from"@walkeros/core";var f={in:y("product view",{timestamp:1700000100,user:{id:"us3r",session:"s3ss10n"}}),out:[["trackClient.track","us3r",{name:"product view",data:{},timestamp:17e5}]]},w={in:y("order complete",{timestamp:1700000101,user:{id:"us3r",session:"s3ss10n"}}),mapping:{name:"purchase"},out:[["trackClient.track","us3r",{name:"purchase",data:{},timestamp:17e5}]]},h={in:y("order complete",{timestamp:1700000102,user:{id:"us3r",session:"s3ss10n"},data:{id:"0rd3r1d",total:555,currency:"EUR"}}),mapping:{name:"purchase",data:{map:{order_id:"data.id",value:"data.total",currency:"data.currency"}}},out:[["trackClient.track","us3r",{name:"purchase",data:{order_id:"0rd3r1d",value:555,currency:"EUR"},timestamp:17e5}]]},C={in:y("product view",{timestamp:1700000103,user:{session:"s3ss10n"}}),settings:{customerId:void 0},out:[["trackClient.trackAnonymous","s3ss10n",{name:"product view",data:{},timestamp:17e5}]]},P={in:y("page view",{timestamp:1700000104,user:{id:"us3r",session:"s3ss10n",email:"user@example.com"}}),settings:{identify:{map:{email:"user.email"}}},out:[["trackClient.identify","us3r",{email:"user@example.com"}],["trackClient.track","us3r",{name:"page view",data:{},timestamp:17e5}]]},b={in:y("user login",{timestamp:1700000105,user:{id:"us3r",session:"s3ss10n"},data:{email:"user@acme.com",first_name:"Jane",plan:"premium"}}),mapping:{skip:!0,settings:{identify:{map:{email:"data.email",first_name:"data.first_name",plan:"data.plan"}}}},out:[["trackClient.identify","us3r",{email:"user@acme.com",first_name:"Jane",plan:"premium"}]]},I={in:y("page view",{timestamp:1700000106,user:{id:"us3r",session:"s3ss10n"},data:{url:"https://example.com/pricing",referrer:"https://google.com"}}),mapping:{skip:!0,settings:{page:{map:{url:"data.url",referrer:"data.referrer"}}}},out:[["trackClient.trackPageView","us3r","https://example.com/pricing",{referrer:"https://google.com"}]]},S={in:y("user delete",{timestamp:1700000107,user:{id:"us3r",session:"s3ss10n"}}),mapping:{skip:!0,settings:{destroy:!0}},out:[["trackClient.destroy","us3r"]]},A={in:y("user suppress",{timestamp:1700000108,user:{id:"us3r",session:"s3ss10n"}}),mapping:{skip:!0,settings:{suppress:!0}},out:[["trackClient.suppress","us3r"]]},R={in:y("user unsuppress",{timestamp:1700000109,user:{id:"us3r",session:"s3ss10n"}}),mapping:{skip:!0,settings:{unsuppress:!0}},out:[["trackClient.unsuppress","us3r"]]},_={in:y("debug noise",{timestamp:1700000110,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  siteId: z\n    .string()\n    .min(1)\n    .describe(\n      'Customer.io Site ID. Find it in Settings > Workspace Settings > API Credentials.',\n    ),\n  apiKey: z\n    .string()\n    .min(1)\n    .describe(\n      'Customer.io API Key. Find it in Settings > Workspace Settings > API Credentials.',\n    ),\n  appApiKey: z\n    .string()\n    .describe(\n      'App API Key for transactional messaging (sendEmail/sendPush). Find it in Settings > Workspace Settings > API Credentials > App API Keys.',\n    )\n    .optional(),\n  region: z\n    .enum(['us', 'eu'])\n    .describe(\n      'Data center region. Must match where your Customer.io workspace was created. Default: us.',\n    )\n    .optional(),\n  timeout: z\n    .number()\n    .int()\n    .positive()\n    .describe('HTTP request timeout in milliseconds. Default: 10000.')\n    .optional(),\n  customerId: z\n    .string()\n    .describe(\n      'walkerOS mapping value path to resolve customerId 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  identify: z\n    .unknown()\n    .describe(\n      'Destination-level identity mapping. Resolves to { email?, first_name?, ... } attributes. Fires identify() on first push and re-fires when values change.',\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 identify attributes. Resolves to { email?, first_name?, ... }. Use with skip: true on login/identify events.',\n    )\n    .optional(),\n  page: z\n    .unknown()\n    .describe(\n      'Per-event page view. Resolves to { url, ... }. Calls trackPageView(). Use with skip: true.',\n    )\n    .optional(),\n  destroy: z\n    .boolean()\n    .describe(\n      'Permanently delete person from Customer.io. Set true on delete events with skip: true.',\n    )\n    .optional(),\n  suppress: z\n    .boolean()\n    .describe(\n      'Suppress person (stop messaging without deleting data). Set true with skip: true.',\n    )\n    .optional(),\n  unsuppress: z\n    .boolean()\n    .describe('Unsuppress person (resume messaging). Set true with skip: true.')\n    .optional(),\n  addDevice: z\n    .unknown()\n    .describe(\n      'Register push device. Resolves to { deviceId, platform, data? }. Use with skip: true.',\n    )\n    .optional(),\n  deleteDevice: z\n    .unknown()\n    .describe(\n      'Remove push device. Resolves to { deviceId, platform }. Use with skip: true.',\n    )\n    .optional(),\n  merge: z\n    .unknown()\n    .describe(\n      'Merge duplicate profiles. Resolves to { primaryType, primaryId, secondaryType, secondaryId }. Use with skip: true.',\n    )\n    .optional(),\n  sendEmail: z\n    .unknown()\n    .describe(\n      'Send transactional email. Resolves to { to, transactional_message_id, message_data?, identifiers? }. Requires appApiKey. Use with skip: true.',\n    )\n    .optional(),\n  sendPush: z\n    .unknown()\n    .describe(\n      'Send transactional push. Resolves to { transactional_message_id, message_data?, identifiers? }. Requires appApiKey. 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 {\n  Env,\n  CustomerIoTrackClientMock,\n  CustomerIoApiClientMock,\n} from '../types';\n\ntype TrackNoArg = () => Promise<void>;\ntype TrackOne = (_id: string | number) => Promise<void>;\ntype TrackIdentify = (\n  _id: string | number,\n  _attrs: Record<string, unknown>,\n) => Promise<void>;\ntype TrackEvent = (\n  _id: string | number,\n  _event: {\n    name: string;\n    data?: Record<string, unknown>;\n    timestamp?: number;\n  },\n) => Promise<void>;\ntype TrackAnonymous = (\n  _id: string,\n  _event: {\n    name: string;\n    data?: Record<string, unknown>;\n    timestamp?: number;\n  },\n) => Promise<void>;\ntype TrackPage = (\n  _id: string | number,\n  _url: string,\n  _data?: Record<string, unknown>,\n) => Promise<void>;\ntype TrackAddDevice = (\n  _id: string | number,\n  _deviceId: string,\n  _platform: string,\n  _data?: Record<string, unknown>,\n) => Promise<void>;\ntype TrackDeleteDevice = (\n  _id: string | number,\n  _deviceId: string,\n  _platform: string,\n) => Promise<void>;\ntype TrackMerge = (\n  _pt: string,\n  _pi: string,\n  _st: string,\n  _si: string,\n) => Promise<void>;\ntype ApiSend = (_request: unknown) => Promise<void>;\n\nconst asyncIdentify: TrackIdentify = () => Promise.resolve();\nconst asyncEvent: TrackEvent = () => Promise.resolve();\nconst asyncAnonymous: TrackAnonymous = () => Promise.resolve();\nconst asyncPage: TrackPage = () => Promise.resolve();\nconst asyncOne: TrackOne = () => Promise.resolve();\nconst asyncAddDevice: TrackAddDevice = () => Promise.resolve();\nconst asyncDeleteDevice: TrackDeleteDevice = () => Promise.resolve();\nconst asyncMerge: TrackMerge = () => Promise.resolve();\nconst asyncSend: ApiSend = () => Promise.resolve();\n\n// Suppress unused warning for narrow helper aliases used below.\nvoid (null as unknown as TrackNoArg);\n\nfunction createMockTrackClient(): CustomerIoTrackClientMock {\n  return {\n    identify: asyncIdentify,\n    track: asyncEvent,\n    trackAnonymous: asyncAnonymous,\n    trackPageView: asyncPage,\n    destroy: asyncOne,\n    suppress: asyncOne,\n    unsuppress: asyncOne,\n    addDevice: asyncAddDevice,\n    deleteDevice: asyncDeleteDevice,\n    mergeCustomers: asyncMerge,\n  };\n}\n\nfunction createMockApiClient(): CustomerIoApiClientMock {\n  return {\n    sendEmail: asyncSend,\n    sendPush: asyncSend,\n  };\n}\n\nexport const push: Env = {\n  trackClient: createMockTrackClient(),\n  apiClient: createMockApiClient(),\n};\n\nexport const simulation = [\n  'call:trackClient.identify',\n  'call:trackClient.track',\n  'call:trackClient.trackAnonymous',\n  'call:trackClient.trackPageView',\n  'call:trackClient.destroy',\n  'call:trackClient.suppress',\n  'call:trackClient.unsuppress',\n  'call:trackClient.addDevice',\n  'call:trackClient.deleteDevice',\n  'call:trackClient.mergeCustomers',\n  'call:apiClient.sendEmail',\n  'call:apiClient.sendPush',\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 CustomerIoStepExample = Flow.StepExample & {\n  settings?: Partial<Settings>;\n};\n\n/**\n * Default event forwarding -- trackClient.track() with event name and data.\n * customerId resolved from default settings.customerId = 'user.id'.\n */\nexport const defaultTrack: CustomerIoStepExample = {\n  in: getEvent('product view', {\n    timestamp: 1700000100,\n    user: { id: 'us3r', session: 's3ss10n' },\n  }),\n  out: [\n    [\n      'trackClient.track',\n      'us3r',\n      {\n        name: 'product view',\n        data: {},\n        timestamp: 1700000,\n      },\n    ],\n  ],\n};\n\n/**\n * Mapped event name -- mapping.name renames the event for Customer.io.\n */\nexport const mappedEventName: CustomerIoStepExample = {\n  in: getEvent('order complete', {\n    timestamp: 1700000101,\n    user: { id: 'us3r', session: 's3ss10n' },\n  }),\n  mapping: {\n    name: 'purchase',\n  },\n  out: [\n    [\n      'trackClient.track',\n      'us3r',\n      {\n        name: 'purchase',\n        data: {},\n        timestamp: 1700000,\n      },\n    ],\n  ],\n};\n\n/**\n * Track with mapped data properties.\n */\nexport const mappedData: CustomerIoStepExample = {\n  in: getEvent('order complete', {\n    timestamp: 1700000102,\n    user: { id: 'us3r', session: 's3ss10n' },\n    data: { id: '0rd3r1d', total: 555, currency: 'EUR' },\n  }),\n  mapping: {\n    name: 'purchase',\n    data: {\n      map: {\n        order_id: 'data.id',\n        value: 'data.total',\n        currency: 'data.currency',\n      },\n    },\n  },\n  out: [\n    [\n      'trackClient.track',\n      'us3r',\n      {\n        name: 'purchase',\n        data: { order_id: '0rd3r1d', value: 555, currency: 'EUR' },\n        timestamp: 1700000,\n      },\n    ],\n  ],\n};\n\n/**\n * Anonymous event -- no customerId resolved, falls back to trackAnonymous().\n */\nexport const anonymousTrack: CustomerIoStepExample = {\n  in: getEvent('product view', {\n    timestamp: 1700000103,\n    user: { session: 's3ss10n' },\n  }),\n  settings: {\n    customerId: undefined,\n  },\n  out: [\n    [\n      'trackClient.trackAnonymous',\n      's3ss10n',\n      {\n        name: 'product view',\n        data: {},\n        timestamp: 1700000,\n      },\n    ],\n  ],\n};\n\n/**\n * Destination-level identify -- fires trackClient.identify() on first push\n * when settings.identify mapping resolves. Then fires trackClient.track().\n */\nexport const destinationIdentify: CustomerIoStepExample = {\n  in: getEvent('page view', {\n    timestamp: 1700000104,\n    user: { id: 'us3r', session: 's3ss10n', email: 'user@example.com' },\n  }),\n  settings: {\n    identify: {\n      map: {\n        email: 'user.email',\n      },\n    },\n  },\n  out: [\n    ['trackClient.identify', 'us3r', { email: 'user@example.com' }],\n    [\n      'trackClient.track',\n      'us3r',\n      {\n        name: 'page view',\n        data: {},\n        timestamp: 1700000,\n      },\n    ],\n  ],\n};\n\n/**\n * Per-event identify with skip -- user login fires identify() only.\n */\nexport const userLoginIdentify: CustomerIoStepExample = {\n  in: getEvent('user login', {\n    timestamp: 1700000105,\n    user: { id: 'us3r', session: 's3ss10n' },\n    data: {\n      email: 'user@acme.com',\n      first_name: 'Jane',\n      plan: 'premium',\n    },\n  }),\n  mapping: {\n    skip: true,\n    settings: {\n      identify: {\n        map: {\n          email: 'data.email',\n          first_name: 'data.first_name',\n          plan: 'data.plan',\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'trackClient.identify',\n      'us3r',\n      { email: 'user@acme.com', first_name: 'Jane', plan: 'premium' },\n    ],\n  ],\n};\n\n/**\n * Page view -- fires trackClient.trackPageView() with url.\n * skip: true suppresses track(); settings.page fires trackPageView().\n */\nexport const pageView: CustomerIoStepExample = {\n  in: getEvent('page view', {\n    timestamp: 1700000106,\n    user: { id: 'us3r', session: 's3ss10n' },\n    data: {\n      url: 'https://example.com/pricing',\n      referrer: 'https://google.com',\n    },\n  }),\n  mapping: {\n    skip: true,\n    settings: {\n      page: {\n        map: {\n          url: 'data.url',\n          referrer: 'data.referrer',\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'trackClient.trackPageView',\n      'us3r',\n      'https://example.com/pricing',\n      { referrer: 'https://google.com' },\n    ],\n  ],\n};\n\n/**\n * Destroy -- permanently deletes a person from Customer.io.\n */\nexport const destroyPerson: CustomerIoStepExample = {\n  in: getEvent('user delete', {\n    timestamp: 1700000107,\n    user: { id: 'us3r', session: 's3ss10n' },\n  }),\n  mapping: {\n    skip: true,\n    settings: {\n      destroy: true,\n    },\n  },\n  out: [['trackClient.destroy', 'us3r']],\n};\n\n/**\n * Suppress -- stops messaging without deleting data.\n */\nexport const suppressPerson: CustomerIoStepExample = {\n  in: getEvent('user suppress', {\n    timestamp: 1700000108,\n    user: { id: 'us3r', session: 's3ss10n' },\n  }),\n  mapping: {\n    skip: true,\n    settings: {\n      suppress: true,\n    },\n  },\n  out: [['trackClient.suppress', 'us3r']],\n};\n\n/**\n * Unsuppress -- resumes messaging for a suppressed person.\n */\nexport const unsuppressPerson: CustomerIoStepExample = {\n  in: getEvent('user unsuppress', {\n    timestamp: 1700000109,\n    user: { id: 'us3r', session: 's3ss10n' },\n  }),\n  mapping: {\n    skip: true,\n    settings: {\n      unsuppress: true,\n    },\n  },\n  out: [['trackClient.unsuppress', 'us3r']],\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: CustomerIoStepExample = {\n  in: getEvent('debug noise', {\n    timestamp: 1700000110,\n    user: { id: 'us3r', session: 's3ss10n' },\n  }),\n  mapping: { ignore: true },\n  out: [],\n};\n"],"mappings":"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","names":["z"]}