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

package/LICENSE

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

package/README.md

@@ -0,0 +1,69 @@
+<p align="left">
+  <a href="https://www.walkeros.io">
+    <img alt="walkerOS" title="walkerOS" src="https://www.walkeros.io/img/walkerOS_logo.svg" width="256px"/>
+  </a>
+</p>
+
+# Meta (CAPI) Destination for walkerOS
+
+[Source Code](https://github.com/elbwalker/walkerOS/tree/main/packages/server/destinations/meta)
+&bull;
+[NPM Package](https://www.npmjs.com/package/@walkeros/server-destination-meta)
+
+walkerOS follows a **source → collector → destination** architecture. This Meta
+CAPI destination receives processed events from the walkerOS collector and sends
+them server-to-server to Meta's Conversions API, providing enhanced data
+accuracy and attribution for Meta advertising campaigns while bypassing browser
+limitations.
+
+## Installation
+
+```sh
+npm install @walkeros/server-destination-meta
+```
+
+## Usage
+
+Here's a basic example of how to use the Meta CAPI destination:
+
+```typescript
+import { startFlow } from '@walkeros/collector';
+import { destinationMeta } from '@walkeros/server-destination-meta';
+
+await startFlow({
+  destinations: {
+    meta: {
+      code: destinationMeta,
+      config: {
+        settings: {
+          accessToken: 'YOUR_ACCESS_TOKEN',
+          pixelId: 'YOUR_PIXEL_ID',
+        },
+      },
+    },
+  },
+});
+```
+
+## Configuration
+
+| Name              | Type                  | Description                                               | Required | Example                                        |
+| ----------------- | --------------------- | --------------------------------------------------------- | -------- | ---------------------------------------------- |
+| `accessToken`     | `string`              | Meta access token for Conversions API authentication      | Yes      | `'your_access_token'`                          |
+| `pixelId`         | `string`              | Meta Pixel ID from your Facebook Business account         | Yes      | `'1234567890'`                                 |
+| `action_source`   | `ActionSource`        | Source of the event (website, app, phone_call, etc.)      | No       | `'website'`                                    |
+| `doNotHash`       | `string[]`            | Array of user_data fields that should not be hashed       | No       | `['client_ip_address', 'client_user_agent']`   |
+| `test_event_code` | `string`              | Test event code for debugging Meta Conversions API events | No       | `'TEST12345'`                                  |
+| `url`             | `string`              | Custom URL for Meta Conversions API endpoint              | No       | `'https://graph.facebook.com/v17.0'`           |
+| `user_data`       | `WalkerOSMapping.Map` | Mapping configuration for user data fields                | No       | `{ email: 'user.email', phone: 'user.phone' }` |
+
+## Contribute
+
+Feel free to contribute by submitting an
+[issue](https://github.com/elbwalker/walkerOS/issues), starting a
+[discussion](https://github.com/elbwalker/walkerOS/discussions), or getting in
+[contact](https://calendly.com/elb-alexander/30min).
+
+## License
+
+This project is licensed under the MIT License.

package/dist/dev.d.mts

@@ -0,0 +1,154 @@
+import * as _walkeros_core_dev from '@walkeros/core/dev';
+import { z } from '@walkeros/core/dev';
+import { DestinationServer, sendServer } from '@walkeros/server-core';
+import { Flow } from '@walkeros/core';
+
+/** mParticle data pod (regional endpoint selector). */
+declare const PodSchema: z.ZodEnum<{
+    us1: "us1";
+    us2: "us2";
+    eu1: "eu1";
+    au1: "au1";
+}>;
+/** Target environment for the batch. */
+declare const EnvironmentSchema: z.ZodEnum<{
+    production: "production";
+    development: "development";
+}>;
+/** Supported mParticle event types emitted by this destination. */
+declare const EventTypeSchema: z.ZodEnum<{
+    custom_event: "custom_event";
+    screen_view: "screen_view";
+    commerce_event: "commerce_event";
+}>;
+/** mParticle custom event category for `custom_event`. */
+declare const CustomEventTypeSchema: z.ZodEnum<{
+    navigation: "navigation";
+    location: "location";
+    search: "search";
+    transaction: "transaction";
+    user_content: "user_content";
+    user_preference: "user_preference";
+    social: "social";
+    media: "media";
+    attribution: "attribution";
+    other: "other";
+}>;
+
+declare const SettingsSchema: z.ZodObject<{
+    apiKey: z.ZodString;
+    apiSecret: z.ZodString;
+    pod: z.ZodOptional<z.ZodEnum<{
+        us1: "us1";
+        us2: "us2";
+        eu1: "eu1";
+        au1: "au1";
+    }>>;
+    environment: z.ZodOptional<z.ZodEnum<{
+        production: "production";
+        development: "development";
+    }>>;
+    userIdentities: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    userAttributes: z.ZodOptional<z.ZodUnknown>;
+    consent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    ip: z.ZodOptional<z.ZodUnknown>;
+    sourceRequestId: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+type Settings = z.infer<typeof SettingsSchema>;
+
+declare const MappingSchema: z.ZodObject<{
+    eventType: z.ZodOptional<z.ZodEnum<{
+        custom_event: "custom_event";
+        screen_view: "screen_view";
+        commerce_event: "commerce_event";
+    }>>;
+    customEventType: z.ZodOptional<z.ZodEnum<{
+        navigation: "navigation";
+        location: "location";
+        search: "search";
+        transaction: "transaction";
+        user_content: "user_content";
+        user_preference: "user_preference";
+        social: "social";
+        media: "media";
+        attribution: "attribution";
+        other: "other";
+    }>>;
+    commerce: z.ZodOptional<z.ZodUnknown>;
+    userIdentities: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    userAttributes: 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;
+
+declare const index$1_CustomEventTypeSchema: typeof CustomEventTypeSchema;
+declare const index$1_EnvironmentSchema: typeof EnvironmentSchema;
+declare const index$1_EventTypeSchema: typeof EventTypeSchema;
+type index$1_Mapping = Mapping;
+declare const index$1_MappingSchema: typeof MappingSchema;
+declare const index$1_PodSchema: typeof PodSchema;
+type index$1_Settings = Settings;
+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 { index$1_CustomEventTypeSchema as CustomEventTypeSchema, index$1_EnvironmentSchema as EnvironmentSchema, index$1_EventTypeSchema as EventTypeSchema, type index$1_Mapping as Mapping, index$1_MappingSchema as MappingSchema, index$1_PodSchema as PodSchema, type index$1_Settings as Settings, index$1_SettingsSchema as SettingsSchema, index$1_mapping as mapping, index$1_settings as settings };
+}
+
+interface Env extends DestinationServer.Env {
+    sendServer?: typeof sendServer;
+}
+
+/**
+ * Standard mock environment for push operations.
+ */
+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 };
+}
+
+/**
+ * Default custom_event — a walkerOS event with no `eventType` mapping.
+ * mParticle wraps it as a `custom_event` with the default `other` category.
+ * user_identities are resolved at the batch level from
+ * `settings.userIdentities`.
+ */
+declare const customEvent: Flow.StepExample;
+/**
+ * screen_view event — mapping.settings.eventType switches the mParticle
+ * event shape. Uses event name as the `screen_name`.
+ */
+declare const screenView: Flow.StepExample;
+/**
+ * commerce_event — mapping.settings.eventType: 'commerce_event' plus a
+ * `commerce` mapping resolves a ProductAction block. Products, currency,
+ * and transaction metadata are all driven by the commerce mapping value.
+ */
+declare const commercePurchase: Flow.StepExample;
+/**
+ * Identity + attributes — verifies `user_identities` and `user_attributes`
+ * come from the batch-level settings mappings, not the event payload.
+ */
+declare const identityAndAttributes: Flow.StepExample;
+
+declare const step_commercePurchase: typeof commercePurchase;
+declare const step_customEvent: typeof customEvent;
+declare const step_identityAndAttributes: typeof identityAndAttributes;
+declare const step_screenView: typeof screenView;
+declare namespace step {
+  export { step_commercePurchase as commercePurchase, step_customEvent as customEvent, step_identityAndAttributes as identityAndAttributes, step_screenView as screenView };
+}
+
+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,154 @@
+import * as _walkeros_core_dev from '@walkeros/core/dev';
+import { z } from '@walkeros/core/dev';
+import { DestinationServer, sendServer } from '@walkeros/server-core';
+import { Flow } from '@walkeros/core';
+
+/** mParticle data pod (regional endpoint selector). */
+declare const PodSchema: z.ZodEnum<{
+    us1: "us1";
+    us2: "us2";
+    eu1: "eu1";
+    au1: "au1";
+}>;
+/** Target environment for the batch. */
+declare const EnvironmentSchema: z.ZodEnum<{
+    production: "production";
+    development: "development";
+}>;
+/** Supported mParticle event types emitted by this destination. */
+declare const EventTypeSchema: z.ZodEnum<{
+    custom_event: "custom_event";
+    screen_view: "screen_view";
+    commerce_event: "commerce_event";
+}>;
+/** mParticle custom event category for `custom_event`. */
+declare const CustomEventTypeSchema: z.ZodEnum<{
+    navigation: "navigation";
+    location: "location";
+    search: "search";
+    transaction: "transaction";
+    user_content: "user_content";
+    user_preference: "user_preference";
+    social: "social";
+    media: "media";
+    attribution: "attribution";
+    other: "other";
+}>;
+
+declare const SettingsSchema: z.ZodObject<{
+    apiKey: z.ZodString;
+    apiSecret: z.ZodString;
+    pod: z.ZodOptional<z.ZodEnum<{
+        us1: "us1";
+        us2: "us2";
+        eu1: "eu1";
+        au1: "au1";
+    }>>;
+    environment: z.ZodOptional<z.ZodEnum<{
+        production: "production";
+        development: "development";
+    }>>;
+    userIdentities: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    userAttributes: z.ZodOptional<z.ZodUnknown>;
+    consent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    ip: z.ZodOptional<z.ZodUnknown>;
+    sourceRequestId: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+type Settings = z.infer<typeof SettingsSchema>;
+
+declare const MappingSchema: z.ZodObject<{
+    eventType: z.ZodOptional<z.ZodEnum<{
+        custom_event: "custom_event";
+        screen_view: "screen_view";
+        commerce_event: "commerce_event";
+    }>>;
+    customEventType: z.ZodOptional<z.ZodEnum<{
+        navigation: "navigation";
+        location: "location";
+        search: "search";
+        transaction: "transaction";
+        user_content: "user_content";
+        user_preference: "user_preference";
+        social: "social";
+        media: "media";
+        attribution: "attribution";
+        other: "other";
+    }>>;
+    commerce: z.ZodOptional<z.ZodUnknown>;
+    userIdentities: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    userAttributes: 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;
+
+declare const index$1_CustomEventTypeSchema: typeof CustomEventTypeSchema;
+declare const index$1_EnvironmentSchema: typeof EnvironmentSchema;
+declare const index$1_EventTypeSchema: typeof EventTypeSchema;
+type index$1_Mapping = Mapping;
+declare const index$1_MappingSchema: typeof MappingSchema;
+declare const index$1_PodSchema: typeof PodSchema;
+type index$1_Settings = Settings;
+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 { index$1_CustomEventTypeSchema as CustomEventTypeSchema, index$1_EnvironmentSchema as EnvironmentSchema, index$1_EventTypeSchema as EventTypeSchema, type index$1_Mapping as Mapping, index$1_MappingSchema as MappingSchema, index$1_PodSchema as PodSchema, type index$1_Settings as Settings, index$1_SettingsSchema as SettingsSchema, index$1_mapping as mapping, index$1_settings as settings };
+}
+
+interface Env extends DestinationServer.Env {
+    sendServer?: typeof sendServer;
+}
+
+/**
+ * Standard mock environment for push operations.
+ */
+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 };
+}
+
+/**
+ * Default custom_event — a walkerOS event with no `eventType` mapping.
+ * mParticle wraps it as a `custom_event` with the default `other` category.
+ * user_identities are resolved at the batch level from
+ * `settings.userIdentities`.
+ */
+declare const customEvent: Flow.StepExample;
+/**
+ * screen_view event — mapping.settings.eventType switches the mParticle
+ * event shape. Uses event name as the `screen_name`.
+ */
+declare const screenView: Flow.StepExample;
+/**
+ * commerce_event — mapping.settings.eventType: 'commerce_event' plus a
+ * `commerce` mapping resolves a ProductAction block. Products, currency,
+ * and transaction metadata are all driven by the commerce mapping value.
+ */
+declare const commercePurchase: Flow.StepExample;
+/**
+ * Identity + attributes — verifies `user_identities` and `user_attributes`
+ * come from the batch-level settings mappings, not the event payload.
+ */
+declare const identityAndAttributes: Flow.StepExample;
+
+declare const step_commercePurchase: typeof commercePurchase;
+declare const step_customEvent: typeof customEvent;
+declare const step_identityAndAttributes: typeof identityAndAttributes;
+declare const step_screenView: typeof screenView;
+declare namespace step {
+  export { step_commercePurchase as commercePurchase, step_customEvent as customEvent, step_identityAndAttributes as identityAndAttributes, step_screenView as screenView };
+}
+
+declare const index_env: typeof env;
+declare const index_step: typeof step;
+declare namespace index {
+  export { index_env as env, index_step as step };
+}
+
+export { index as examples, index$1 as schemas };

package/dist/dev.js

@@ -0,0 +1 @@
+"use strict";var e,t=Object.defineProperty,r=Object.getOwnPropertyDescriptor,i=Object.getOwnPropertyNames,n=Object.prototype.hasOwnProperty,o=(e,r)=>{for(var i in r)t(e,i,{get:r[i],enumerable:!0})},s={};o(s,{examples:()=>f,schemas:()=>a}),module.exports=(e=s,((e,o,s,a)=>{if(o&&"object"==typeof o||"function"==typeof o)for(let c of i(o))n.call(e,c)||c===s||t(e,c,{get:()=>o[c],enumerable:!(a=r(o,c))||a.enumerable});return e})(t({},"__esModule",{value:!0}),e));var a={};o(a,{CustomEventTypeSchema:()=>l,EnvironmentSchema:()=>d,EventTypeSchema:()=>v,MappingSchema:()=>h,PodSchema:()=>m,SettingsSchema:()=>_,mapping:()=>b,settings:()=>y});var c=require("@walkeros/core/dev"),u=require("@walkeros/core/dev"),p=require("@walkeros/core/dev"),m=p.z.enum(["us1","us2","eu1","au1"]),d=p.z.enum(["production","development"]),v=p.z.enum(["custom_event","screen_view","commerce_event"]),l=p.z.enum(["navigation","location","search","transaction","user_content","user_preference","social","media","attribution","other"]),_=u.z.object({apiKey:u.z.string().min(1).describe("mParticle input feed API key from the mParticle dashboard (Setup > Inputs > Feeds)."),apiSecret:u.z.string().min(1).describe("mParticle input feed API secret paired with apiKey. Used for HTTP Basic auth."),pod:m.describe("mParticle data pod selecting the regional endpoint. Default: 'us1'.").optional(),environment:d.describe("Environment the batch targets. Default: 'production'.").optional(),userIdentities:u.z.record(u.z.string(),u.z.unknown()).describe("Mapping that resolves to user_identities per batch. Keys are mParticle identity types (like customer_id, email); values are walkerOS mapping values.").optional(),userAttributes:u.z.unknown().describe("Mapping value that resolves to the user_attributes object placed on the batch.").optional(),consent:u.z.record(u.z.string(),u.z.unknown()).describe("Static consent_state envelope forwarded verbatim on the batch. See mParticle consent_state docs.").optional(),ip:u.z.unknown().describe("Mapping value resolving to the client IP for the batch.").optional(),sourceRequestId:u.z.unknown().describe("Mapping value resolving to the source_request_id for the batch. Falls back to event.id when unset.").optional()}),g=require("@walkeros/core/dev"),h=g.z.object({eventType:v.describe("Per-event mParticle event type. Default: 'custom_event'.").optional(),customEventType:l.describe("Custom event type category for 'custom_event'. Default: 'other'.").optional(),commerce:g.z.unknown().describe("Mapping value resolving to the commerce fields (product_action, currency_code, products, ...) for a commerce_event.").optional(),userIdentities:g.z.record(g.z.string(),g.z.unknown()).describe("Per-event override mapping for user_identities. Merged over settings.userIdentities.").optional(),userAttributes:g.z.unknown().describe("Per-event override mapping for user_attributes.").optional()}),y=(0,c.zodToSchema)(_),b=(0,c.zodToSchema)(h),f={};o(f,{env:()=>w,step:()=>k});var w={};o(w,{push:()=>S,simulation:()=>z});var S={sendServer:async()=>({ok:!0,data:{}})},z=["sendServer"],k={};o(k,{commercePurchase:()=>T,customEvent:()=>E,identityAndAttributes:()=>j,screenView:()=>q});var P=require("@walkeros/core"),O="https://s2s.mparticle.com/v2/events",x={headers:{Authorization:"Basic a2V5OnNlY3JldA==","Content-Type":"application/json"}},E={in:(0,P.getEvent)("product view",{timestamp:17000001e5,data:{id:"SKU-A1",name:"Shoe",price:129.99},user:{id:"user-123"},source:{type:"server",id:"https://shop.example.com",previous_id:""}}),mapping:void 0,out:[["sendServer",O,JSON.stringify({events:[{event_type:"custom_event",data:{event_name:"product view",custom_event_type:"other",timestamp_unixtime_ms:17000001e5,source_message_id:"1700000100000-gr0up-1"}}],environment:"production",user_identities:{customer_id:"user-123"},source_request_id:"1700000100000-gr0up-1"}),x]]},q={in:(0,P.getEvent)("page view",{timestamp:17000002e5,data:{title:"Checkout",path:"/checkout"},user:{id:"user-123"},source:{type:"server",id:"https://shop.example.com",previous_id:""}}),mapping:{settings:{eventType:"screen_view"}},out:[["sendServer",O,JSON.stringify({events:[{event_type:"screen_view",data:{screen_name:"page view",timestamp_unixtime_ms:17000002e5,source_message_id:"1700000200000-gr0up-1"}}],environment:"production",user_identities:{customer_id:"user-123"},source_request_id:"1700000200000-gr0up-1"}),x]]},T={in:(0,P.getEvent)("order complete",{timestamp:17000003e5,data:{id:"ORD-300",total:249.99,currency:"EUR"},user:{id:"user-123"},source:{type:"server",id:"https://shop.example.com",previous_id:""}}),mapping:{settings:{eventType:"commerce_event",commerce:{map:{currency_code:"data.currency",product_action:{map:{action:{value:"purchase"},transaction_id:"data.id",total_amount:"data.total"}}}}}},out:[["sendServer",O,JSON.stringify({events:[{event_type:"commerce_event",data:{currency_code:"EUR",product_action:{action:"purchase",transaction_id:"ORD-300",total_amount:249.99},timestamp_unixtime_ms:17000003e5,source_message_id:"1700000300000-gr0up-1"}}],environment:"production",user_identities:{customer_id:"user-123"},source_request_id:"1700000300000-gr0up-1"}),x]]},j={in:(0,P.getEvent)("form submit",{timestamp:17000004e5,data:{type:"newsletter"},user:{id:"user-123",email:"user@example.com"},source:{type:"server",id:"https://example.com",previous_id:""}}),mapping:void 0,out:[["sendServer",O,JSON.stringify({events:[{event_type:"custom_event",data:{event_name:"form submit",custom_event_type:"other",timestamp_unixtime_ms:17000004e5,source_message_id:"1700000400000-gr0up-1"}}],environment:"production",user_identities:{customer_id:"user-123",email:"user@example.com"},source_request_id:"1700000400000-gr0up-1"}),x]]};//# 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/primitives.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 * from './primitives';\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';\nimport { EnvironmentSchema, PodSchema } from './primitives';\n\nexport const SettingsSchema = z.object({\n  apiKey: z\n    .string()\n    .min(1)\n    .describe(\n      'mParticle input feed API key from the mParticle dashboard (Setup > Inputs > Feeds).',\n    ),\n  apiSecret: z\n    .string()\n    .min(1)\n    .describe(\n      'mParticle input feed API secret paired with apiKey. Used for HTTP Basic auth.',\n    ),\n  pod: PodSchema.describe(\n    \"mParticle data pod selecting the regional endpoint. Default: 'us1'.\",\n  ).optional(),\n  environment: EnvironmentSchema.describe(\n    \"Environment the batch targets. Default: 'production'.\",\n  ).optional(),\n  userIdentities: z\n    .record(z.string(), z.unknown())\n    .describe(\n      'Mapping that resolves to user_identities per batch. Keys are mParticle identity types (like customer_id, email); values are walkerOS mapping values.',\n    )\n    .optional(),\n  userAttributes: z\n    .unknown()\n    .describe(\n      'Mapping value that resolves to the user_attributes object placed on the batch.',\n    )\n    .optional(),\n  consent: z\n    .record(z.string(), z.unknown())\n    .describe(\n      'Static consent_state envelope forwarded verbatim on the batch. See mParticle consent_state docs.',\n    )\n    .optional(),\n  ip: z\n    .unknown()\n    .describe('Mapping value resolving to the client IP for the batch.')\n    .optional(),\n  sourceRequestId: z\n    .unknown()\n    .describe(\n      'Mapping value resolving to the source_request_id for the batch. Falls back to event.id when unset.',\n    )\n    .optional(),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { z } from '@walkeros/core/dev';\n\n/** mParticle data pod (regional endpoint selector). */\nexport const PodSchema = z.enum(['us1', 'us2', 'eu1', 'au1']);\n\n/** Target environment for the batch. */\nexport const EnvironmentSchema = z.enum(['production', 'development']);\n\n/** Supported mParticle event types emitted by this destination. */\nexport const EventTypeSchema = z.enum([\n  'custom_event',\n  'screen_view',\n  'commerce_event',\n]);\n\n/** mParticle custom event category for `custom_event`. */\nexport const CustomEventTypeSchema = z.enum([\n  'navigation',\n  'location',\n  'search',\n  'transaction',\n  'user_content',\n  'user_preference',\n  'social',\n  'media',\n  'attribution',\n  'other',\n]);\n","import { z } from '@walkeros/core/dev';\nimport { CustomEventTypeSchema, EventTypeSchema } from './primitives';\n\nexport const MappingSchema = z.object({\n  eventType: EventTypeSchema.describe(\n    \"Per-event mParticle event type. Default: 'custom_event'.\",\n  ).optional(),\n  customEventType: CustomEventTypeSchema.describe(\n    \"Custom event type category for 'custom_event'. Default: 'other'.\",\n  ).optional(),\n  commerce: z\n    .unknown()\n    .describe(\n      'Mapping value resolving to the commerce fields (product_action, currency_code, products, ...) for a commerce_event.',\n    )\n    .optional(),\n  userIdentities: z\n    .record(z.string(), z.unknown())\n    .describe(\n      'Per-event override mapping for user_identities. Merged over settings.userIdentities.',\n    )\n    .optional(),\n  userAttributes: z\n    .unknown()\n    .describe('Per-event override mapping for user_attributes.')\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 { SendDataValue, SendResponse } from '@walkeros/core';\nimport type { SendServerOptions } from '@walkeros/server-core';\nimport type { Env } from '../types';\n\n/**\n * Example environment configurations for mParticle Events API destination.\n *\n * Provides a standardized mock `sendServer` so tests and simulations can\n * run without making real HTTP calls to mParticle.\n */\n\ntype MockSendServer = (\n  url: string,\n  data?: SendDataValue,\n  options?: SendServerOptions,\n) => Promise<SendResponse>;\n\nconst mockSendServer: MockSendServer = async () => {\n  // Simulates mParticle's typical 202 Accepted response for the Events API.\n  return {\n    ok: true,\n    data: {},\n  };\n};\n\n/**\n * Standard mock environment for push operations.\n */\nexport const push: Env = {\n  sendServer: mockSendServer,\n};\n\nexport const simulation = ['sendServer'];\n","import type { Flow } from '@walkeros/core';\nimport { getEvent } from '@walkeros/core';\n\n/**\n * mParticle Events API step examples.\n *\n * At push time, the destination calls\n * `env.sendServer(endpoint, JSON.stringify(batch), options)` where\n *   endpoint = `buildEndpoint(pod)`  (default pod `us1` → `https://s2s.mparticle.com/v2/events`)\n *   batch    = the mParticle v2 batch envelope\n *\n * Test fixture pins `apiKey = 'key'`, `apiSecret = 'secret'`, pod `us1`, so\n * every call targets that endpoint with `Authorization: Basic a2V5OnNlY3JldA==`.\n *\n * The batch keys appear in the order the destination constructs them:\n *   1. events (always a single-element array)\n *   2. environment ('production' by default)\n *   3. user_identities (only when resolved)\n *   4. user_attributes (only when resolved)\n *   5. ip (only when mapped)\n *   6. source_request_id (falls back to `event.id`)\n *   7. consent_state, context (unused here)\n *\n * `options` carries Authorization + Content-Type headers.\n */\nconst ENDPOINT = 'https://s2s.mparticle.com/v2/events';\nconst OPTIONS = {\n  headers: {\n    // Basic base64('key:secret')\n    Authorization: 'Basic a2V5OnNlY3JldA==',\n    'Content-Type': 'application/json',\n  },\n};\n\n/**\n * Default custom_event — a walkerOS event with no `eventType` mapping.\n * mParticle wraps it as a `custom_event` with the default `other` category.\n * user_identities are resolved at the batch level from\n * `settings.userIdentities`.\n */\nexport const customEvent: Flow.StepExample = {\n  in: getEvent('product view', {\n    timestamp: 1700000100000,\n    data: { id: 'SKU-A1', name: 'Shoe', price: 129.99 },\n    user: { id: 'user-123' },\n    source: { type: 'server', id: 'https://shop.example.com', previous_id: '' },\n  }),\n  mapping: undefined,\n  out: [\n    [\n      'sendServer',\n      ENDPOINT,\n      JSON.stringify({\n        events: [\n          {\n            event_type: 'custom_event',\n            data: {\n              event_name: 'product view',\n              custom_event_type: 'other',\n              timestamp_unixtime_ms: 1700000100000,\n              source_message_id: '1700000100000-gr0up-1',\n            },\n          },\n        ],\n        environment: 'production',\n        user_identities: {\n          customer_id: 'user-123',\n        },\n        source_request_id: '1700000100000-gr0up-1',\n      }),\n      OPTIONS,\n    ],\n  ],\n};\n\n/**\n * screen_view event — mapping.settings.eventType switches the mParticle\n * event shape. Uses event name as the `screen_name`.\n */\nexport const screenView: Flow.StepExample = {\n  in: getEvent('page view', {\n    timestamp: 1700000200000,\n    data: { title: 'Checkout', path: '/checkout' },\n    user: { id: 'user-123' },\n    source: { type: 'server', id: 'https://shop.example.com', previous_id: '' },\n  }),\n  mapping: {\n    settings: { eventType: 'screen_view' },\n  },\n  out: [\n    [\n      'sendServer',\n      ENDPOINT,\n      JSON.stringify({\n        events: [\n          {\n            event_type: 'screen_view',\n            data: {\n              screen_name: 'page view',\n              timestamp_unixtime_ms: 1700000200000,\n              source_message_id: '1700000200000-gr0up-1',\n            },\n          },\n        ],\n        environment: 'production',\n        user_identities: {\n          customer_id: 'user-123',\n        },\n        source_request_id: '1700000200000-gr0up-1',\n      }),\n      OPTIONS,\n    ],\n  ],\n};\n\n/**\n * commerce_event — mapping.settings.eventType: 'commerce_event' plus a\n * `commerce` mapping resolves a ProductAction block. Products, currency,\n * and transaction metadata are all driven by the commerce mapping value.\n */\nexport const commercePurchase: Flow.StepExample = {\n  in: getEvent('order complete', {\n    timestamp: 1700000300000,\n    data: { id: 'ORD-300', total: 249.99, currency: 'EUR' },\n    user: { id: 'user-123' },\n    source: { type: 'server', id: 'https://shop.example.com', previous_id: '' },\n  }),\n  mapping: {\n    settings: {\n      eventType: 'commerce_event',\n      commerce: {\n        map: {\n          currency_code: 'data.currency',\n          product_action: {\n            map: {\n              action: { value: 'purchase' },\n              transaction_id: 'data.id',\n              total_amount: 'data.total',\n            },\n          },\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'sendServer',\n      ENDPOINT,\n      JSON.stringify({\n        events: [\n          {\n            event_type: 'commerce_event',\n            data: {\n              currency_code: 'EUR',\n              product_action: {\n                action: 'purchase',\n                transaction_id: 'ORD-300',\n                total_amount: 249.99,\n              },\n              timestamp_unixtime_ms: 1700000300000,\n              source_message_id: '1700000300000-gr0up-1',\n            },\n          },\n        ],\n        environment: 'production',\n        user_identities: {\n          customer_id: 'user-123',\n        },\n        source_request_id: '1700000300000-gr0up-1',\n      }),\n      OPTIONS,\n    ],\n  ],\n};\n\n/**\n * Identity + attributes — verifies `user_identities` and `user_attributes`\n * come from the batch-level settings mappings, not the event payload.\n */\nexport const identityAndAttributes: Flow.StepExample = {\n  in: getEvent('form submit', {\n    timestamp: 1700000400000,\n    data: { type: 'newsletter' },\n    user: {\n      id: 'user-123',\n      email: 'user@example.com',\n    },\n    source: { type: 'server', id: 'https://example.com', previous_id: '' },\n  }),\n  mapping: undefined,\n  out: [\n    [\n      'sendServer',\n      ENDPOINT,\n      JSON.stringify({\n        events: [\n          {\n            event_type: 'custom_event',\n            data: {\n              event_name: 'form submit',\n              custom_event_type: 'other',\n              timestamp_unixtime_ms: 1700000400000,\n              source_message_id: '1700000400000-gr0up-1',\n            },\n          },\n        ],\n        environment: 'production',\n        user_identities: {\n          customer_id: 'user-123',\n          email: 'user@example.com',\n        },\n        source_request_id: '1700000400000-gr0up-1',\n      }),\n      OPTIONS,\n    ],\n  ],\n};\n"],"mappings":"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","names":["import_dev","import_dev","import_dev"]}

package/dist/dev.mjs

@@ -0,0 +1 @@
+var e=Object.defineProperty,t=(t,r)=>{for(var i in r)e(t,i,{get:r[i],enumerable:!0})},r={};t(r,{CustomEventTypeSchema:()=>u,EnvironmentSchema:()=>a,EventTypeSchema:()=>c,MappingSchema:()=>d,PodSchema:()=>o,SettingsSchema:()=>p,mapping:()=>_,settings:()=>v});import{zodToSchema as i}from"@walkeros/core/dev";import{z as n}from"@walkeros/core/dev";import{z as s}from"@walkeros/core/dev";var o=s.enum(["us1","us2","eu1","au1"]),a=s.enum(["production","development"]),c=s.enum(["custom_event","screen_view","commerce_event"]),u=s.enum(["navigation","location","search","transaction","user_content","user_preference","social","media","attribution","other"]),p=n.object({apiKey:n.string().min(1).describe("mParticle input feed API key from the mParticle dashboard (Setup > Inputs > Feeds)."),apiSecret:n.string().min(1).describe("mParticle input feed API secret paired with apiKey. Used for HTTP Basic auth."),pod:o.describe("mParticle data pod selecting the regional endpoint. Default: 'us1'.").optional(),environment:a.describe("Environment the batch targets. Default: 'production'.").optional(),userIdentities:n.record(n.string(),n.unknown()).describe("Mapping that resolves to user_identities per batch. Keys are mParticle identity types (like customer_id, email); values are walkerOS mapping values.").optional(),userAttributes:n.unknown().describe("Mapping value that resolves to the user_attributes object placed on the batch.").optional(),consent:n.record(n.string(),n.unknown()).describe("Static consent_state envelope forwarded verbatim on the batch. See mParticle consent_state docs.").optional(),ip:n.unknown().describe("Mapping value resolving to the client IP for the batch.").optional(),sourceRequestId:n.unknown().describe("Mapping value resolving to the source_request_id for the batch. Falls back to event.id when unset.").optional()});import{z as m}from"@walkeros/core/dev";var d=m.object({eventType:c.describe("Per-event mParticle event type. Default: 'custom_event'.").optional(),customEventType:u.describe("Custom event type category for 'custom_event'. Default: 'other'.").optional(),commerce:m.unknown().describe("Mapping value resolving to the commerce fields (product_action, currency_code, products, ...) for a commerce_event.").optional(),userIdentities:m.record(m.string(),m.unknown()).describe("Per-event override mapping for user_identities. Merged over settings.userIdentities.").optional(),userAttributes:m.unknown().describe("Per-event override mapping for user_attributes.").optional()}),v=i(p),_=i(d),l={};t(l,{env:()=>h,step:()=>b});var h={};t(h,{push:()=>g,simulation:()=>y});var g={sendServer:async()=>({ok:!0,data:{}})},y=["sendServer"],b={};t(b,{commercePurchase:()=>x,customEvent:()=>k,identityAndAttributes:()=>A,screenView:()=>P});import{getEvent as f}from"@walkeros/core";var w="https://s2s.mparticle.com/v2/events",S={headers:{Authorization:"Basic a2V5OnNlY3JldA==","Content-Type":"application/json"}},k={in:f("product view",{timestamp:17000001e5,data:{id:"SKU-A1",name:"Shoe",price:129.99},user:{id:"user-123"},source:{type:"server",id:"https://shop.example.com",previous_id:""}}),mapping:void 0,out:[["sendServer",w,JSON.stringify({events:[{event_type:"custom_event",data:{event_name:"product view",custom_event_type:"other",timestamp_unixtime_ms:17000001e5,source_message_id:"1700000100000-gr0up-1"}}],environment:"production",user_identities:{customer_id:"user-123"},source_request_id:"1700000100000-gr0up-1"}),S]]},P={in:f("page view",{timestamp:17000002e5,data:{title:"Checkout",path:"/checkout"},user:{id:"user-123"},source:{type:"server",id:"https://shop.example.com",previous_id:""}}),mapping:{settings:{eventType:"screen_view"}},out:[["sendServer",w,JSON.stringify({events:[{event_type:"screen_view",data:{screen_name:"page view",timestamp_unixtime_ms:17000002e5,source_message_id:"1700000200000-gr0up-1"}}],environment:"production",user_identities:{customer_id:"user-123"},source_request_id:"1700000200000-gr0up-1"}),S]]},x={in:f("order complete",{timestamp:17000003e5,data:{id:"ORD-300",total:249.99,currency:"EUR"},user:{id:"user-123"},source:{type:"server",id:"https://shop.example.com",previous_id:""}}),mapping:{settings:{eventType:"commerce_event",commerce:{map:{currency_code:"data.currency",product_action:{map:{action:{value:"purchase"},transaction_id:"data.id",total_amount:"data.total"}}}}}},out:[["sendServer",w,JSON.stringify({events:[{event_type:"commerce_event",data:{currency_code:"EUR",product_action:{action:"purchase",transaction_id:"ORD-300",total_amount:249.99},timestamp_unixtime_ms:17000003e5,source_message_id:"1700000300000-gr0up-1"}}],environment:"production",user_identities:{customer_id:"user-123"},source_request_id:"1700000300000-gr0up-1"}),S]]},A={in:f("form submit",{timestamp:17000004e5,data:{type:"newsletter"},user:{id:"user-123",email:"user@example.com"},source:{type:"server",id:"https://example.com",previous_id:""}}),mapping:void 0,out:[["sendServer",w,JSON.stringify({events:[{event_type:"custom_event",data:{event_name:"form submit",custom_event_type:"other",timestamp_unixtime_ms:17000004e5,source_message_id:"1700000400000-gr0up-1"}}],environment:"production",user_identities:{customer_id:"user-123",email:"user@example.com"},source_request_id:"1700000400000-gr0up-1"}),S]]};export{l as examples,r 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/primitives.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 * from './primitives';\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';\nimport { EnvironmentSchema, PodSchema } from './primitives';\n\nexport const SettingsSchema = z.object({\n  apiKey: z\n    .string()\n    .min(1)\n    .describe(\n      'mParticle input feed API key from the mParticle dashboard (Setup > Inputs > Feeds).',\n    ),\n  apiSecret: z\n    .string()\n    .min(1)\n    .describe(\n      'mParticle input feed API secret paired with apiKey. Used for HTTP Basic auth.',\n    ),\n  pod: PodSchema.describe(\n    \"mParticle data pod selecting the regional endpoint. Default: 'us1'.\",\n  ).optional(),\n  environment: EnvironmentSchema.describe(\n    \"Environment the batch targets. Default: 'production'.\",\n  ).optional(),\n  userIdentities: z\n    .record(z.string(), z.unknown())\n    .describe(\n      'Mapping that resolves to user_identities per batch. Keys are mParticle identity types (like customer_id, email); values are walkerOS mapping values.',\n    )\n    .optional(),\n  userAttributes: z\n    .unknown()\n    .describe(\n      'Mapping value that resolves to the user_attributes object placed on the batch.',\n    )\n    .optional(),\n  consent: z\n    .record(z.string(), z.unknown())\n    .describe(\n      'Static consent_state envelope forwarded verbatim on the batch. See mParticle consent_state docs.',\n    )\n    .optional(),\n  ip: z\n    .unknown()\n    .describe('Mapping value resolving to the client IP for the batch.')\n    .optional(),\n  sourceRequestId: z\n    .unknown()\n    .describe(\n      'Mapping value resolving to the source_request_id for the batch. Falls back to event.id when unset.',\n    )\n    .optional(),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { z } from '@walkeros/core/dev';\n\n/** mParticle data pod (regional endpoint selector). */\nexport const PodSchema = z.enum(['us1', 'us2', 'eu1', 'au1']);\n\n/** Target environment for the batch. */\nexport const EnvironmentSchema = z.enum(['production', 'development']);\n\n/** Supported mParticle event types emitted by this destination. */\nexport const EventTypeSchema = z.enum([\n  'custom_event',\n  'screen_view',\n  'commerce_event',\n]);\n\n/** mParticle custom event category for `custom_event`. */\nexport const CustomEventTypeSchema = z.enum([\n  'navigation',\n  'location',\n  'search',\n  'transaction',\n  'user_content',\n  'user_preference',\n  'social',\n  'media',\n  'attribution',\n  'other',\n]);\n","import { z } from '@walkeros/core/dev';\nimport { CustomEventTypeSchema, EventTypeSchema } from './primitives';\n\nexport const MappingSchema = z.object({\n  eventType: EventTypeSchema.describe(\n    \"Per-event mParticle event type. Default: 'custom_event'.\",\n  ).optional(),\n  customEventType: CustomEventTypeSchema.describe(\n    \"Custom event type category for 'custom_event'. Default: 'other'.\",\n  ).optional(),\n  commerce: z\n    .unknown()\n    .describe(\n      'Mapping value resolving to the commerce fields (product_action, currency_code, products, ...) for a commerce_event.',\n    )\n    .optional(),\n  userIdentities: z\n    .record(z.string(), z.unknown())\n    .describe(\n      'Per-event override mapping for user_identities. Merged over settings.userIdentities.',\n    )\n    .optional(),\n  userAttributes: z\n    .unknown()\n    .describe('Per-event override mapping for user_attributes.')\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 { SendDataValue, SendResponse } from '@walkeros/core';\nimport type { SendServerOptions } from '@walkeros/server-core';\nimport type { Env } from '../types';\n\n/**\n * Example environment configurations for mParticle Events API destination.\n *\n * Provides a standardized mock `sendServer` so tests and simulations can\n * run without making real HTTP calls to mParticle.\n */\n\ntype MockSendServer = (\n  url: string,\n  data?: SendDataValue,\n  options?: SendServerOptions,\n) => Promise<SendResponse>;\n\nconst mockSendServer: MockSendServer = async () => {\n  // Simulates mParticle's typical 202 Accepted response for the Events API.\n  return {\n    ok: true,\n    data: {},\n  };\n};\n\n/**\n * Standard mock environment for push operations.\n */\nexport const push: Env = {\n  sendServer: mockSendServer,\n};\n\nexport const simulation = ['sendServer'];\n","import type { Flow } from '@walkeros/core';\nimport { getEvent } from '@walkeros/core';\n\n/**\n * mParticle Events API step examples.\n *\n * At push time, the destination calls\n * `env.sendServer(endpoint, JSON.stringify(batch), options)` where\n *   endpoint = `buildEndpoint(pod)`  (default pod `us1` → `https://s2s.mparticle.com/v2/events`)\n *   batch    = the mParticle v2 batch envelope\n *\n * Test fixture pins `apiKey = 'key'`, `apiSecret = 'secret'`, pod `us1`, so\n * every call targets that endpoint with `Authorization: Basic a2V5OnNlY3JldA==`.\n *\n * The batch keys appear in the order the destination constructs them:\n *   1. events (always a single-element array)\n *   2. environment ('production' by default)\n *   3. user_identities (only when resolved)\n *   4. user_attributes (only when resolved)\n *   5. ip (only when mapped)\n *   6. source_request_id (falls back to `event.id`)\n *   7. consent_state, context (unused here)\n *\n * `options` carries Authorization + Content-Type headers.\n */\nconst ENDPOINT = 'https://s2s.mparticle.com/v2/events';\nconst OPTIONS = {\n  headers: {\n    // Basic base64('key:secret')\n    Authorization: 'Basic a2V5OnNlY3JldA==',\n    'Content-Type': 'application/json',\n  },\n};\n\n/**\n * Default custom_event — a walkerOS event with no `eventType` mapping.\n * mParticle wraps it as a `custom_event` with the default `other` category.\n * user_identities are resolved at the batch level from\n * `settings.userIdentities`.\n */\nexport const customEvent: Flow.StepExample = {\n  in: getEvent('product view', {\n    timestamp: 1700000100000,\n    data: { id: 'SKU-A1', name: 'Shoe', price: 129.99 },\n    user: { id: 'user-123' },\n    source: { type: 'server', id: 'https://shop.example.com', previous_id: '' },\n  }),\n  mapping: undefined,\n  out: [\n    [\n      'sendServer',\n      ENDPOINT,\n      JSON.stringify({\n        events: [\n          {\n            event_type: 'custom_event',\n            data: {\n              event_name: 'product view',\n              custom_event_type: 'other',\n              timestamp_unixtime_ms: 1700000100000,\n              source_message_id: '1700000100000-gr0up-1',\n            },\n          },\n        ],\n        environment: 'production',\n        user_identities: {\n          customer_id: 'user-123',\n        },\n        source_request_id: '1700000100000-gr0up-1',\n      }),\n      OPTIONS,\n    ],\n  ],\n};\n\n/**\n * screen_view event — mapping.settings.eventType switches the mParticle\n * event shape. Uses event name as the `screen_name`.\n */\nexport const screenView: Flow.StepExample = {\n  in: getEvent('page view', {\n    timestamp: 1700000200000,\n    data: { title: 'Checkout', path: '/checkout' },\n    user: { id: 'user-123' },\n    source: { type: 'server', id: 'https://shop.example.com', previous_id: '' },\n  }),\n  mapping: {\n    settings: { eventType: 'screen_view' },\n  },\n  out: [\n    [\n      'sendServer',\n      ENDPOINT,\n      JSON.stringify({\n        events: [\n          {\n            event_type: 'screen_view',\n            data: {\n              screen_name: 'page view',\n              timestamp_unixtime_ms: 1700000200000,\n              source_message_id: '1700000200000-gr0up-1',\n            },\n          },\n        ],\n        environment: 'production',\n        user_identities: {\n          customer_id: 'user-123',\n        },\n        source_request_id: '1700000200000-gr0up-1',\n      }),\n      OPTIONS,\n    ],\n  ],\n};\n\n/**\n * commerce_event — mapping.settings.eventType: 'commerce_event' plus a\n * `commerce` mapping resolves a ProductAction block. Products, currency,\n * and transaction metadata are all driven by the commerce mapping value.\n */\nexport const commercePurchase: Flow.StepExample = {\n  in: getEvent('order complete', {\n    timestamp: 1700000300000,\n    data: { id: 'ORD-300', total: 249.99, currency: 'EUR' },\n    user: { id: 'user-123' },\n    source: { type: 'server', id: 'https://shop.example.com', previous_id: '' },\n  }),\n  mapping: {\n    settings: {\n      eventType: 'commerce_event',\n      commerce: {\n        map: {\n          currency_code: 'data.currency',\n          product_action: {\n            map: {\n              action: { value: 'purchase' },\n              transaction_id: 'data.id',\n              total_amount: 'data.total',\n            },\n          },\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'sendServer',\n      ENDPOINT,\n      JSON.stringify({\n        events: [\n          {\n            event_type: 'commerce_event',\n            data: {\n              currency_code: 'EUR',\n              product_action: {\n                action: 'purchase',\n                transaction_id: 'ORD-300',\n                total_amount: 249.99,\n              },\n              timestamp_unixtime_ms: 1700000300000,\n              source_message_id: '1700000300000-gr0up-1',\n            },\n          },\n        ],\n        environment: 'production',\n        user_identities: {\n          customer_id: 'user-123',\n        },\n        source_request_id: '1700000300000-gr0up-1',\n      }),\n      OPTIONS,\n    ],\n  ],\n};\n\n/**\n * Identity + attributes — verifies `user_identities` and `user_attributes`\n * come from the batch-level settings mappings, not the event payload.\n */\nexport const identityAndAttributes: Flow.StepExample = {\n  in: getEvent('form submit', {\n    timestamp: 1700000400000,\n    data: { type: 'newsletter' },\n    user: {\n      id: 'user-123',\n      email: 'user@example.com',\n    },\n    source: { type: 'server', id: 'https://example.com', previous_id: '' },\n  }),\n  mapping: undefined,\n  out: [\n    [\n      'sendServer',\n      ENDPOINT,\n      JSON.stringify({\n        events: [\n          {\n            event_type: 'custom_event',\n            data: {\n              event_name: 'form submit',\n              custom_event_type: 'other',\n              timestamp_unixtime_ms: 1700000400000,\n              source_message_id: '1700000400000-gr0up-1',\n            },\n          },\n        ],\n        environment: 'production',\n        user_identities: {\n          customer_id: 'user-123',\n          email: 'user@example.com',\n        },\n        source_request_id: '1700000400000-gr0up-1',\n      }),\n      OPTIONS,\n    ],\n  ],\n};\n"],"mappings":"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","names":["z","z","z","z"]}

package/dist/examples/index.d.mts

@@ -0,0 +1,52 @@
+import { DestinationServer, sendServer } from '@walkeros/server-core';
+import { Flow } from '@walkeros/core';
+
+interface Env extends DestinationServer.Env {
+    sendServer?: typeof sendServer;
+}
+
+/**
+ * Standard mock environment for push operations.
+ */
+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 };
+}
+
+/**
+ * Default custom_event — a walkerOS event with no `eventType` mapping.
+ * mParticle wraps it as a `custom_event` with the default `other` category.
+ * user_identities are resolved at the batch level from
+ * `settings.userIdentities`.
+ */
+declare const customEvent: Flow.StepExample;
+/**
+ * screen_view event — mapping.settings.eventType switches the mParticle
+ * event shape. Uses event name as the `screen_name`.
+ */
+declare const screenView: Flow.StepExample;
+/**
+ * commerce_event — mapping.settings.eventType: 'commerce_event' plus a
+ * `commerce` mapping resolves a ProductAction block. Products, currency,
+ * and transaction metadata are all driven by the commerce mapping value.
+ */
+declare const commercePurchase: Flow.StepExample;
+/**
+ * Identity + attributes — verifies `user_identities` and `user_attributes`
+ * come from the batch-level settings mappings, not the event payload.
+ */
+declare const identityAndAttributes: Flow.StepExample;
+
+declare const step_commercePurchase: typeof commercePurchase;
+declare const step_customEvent: typeof customEvent;
+declare const step_identityAndAttributes: typeof identityAndAttributes;
+declare const step_screenView: typeof screenView;
+declare namespace step {
+  export { step_commercePurchase as commercePurchase, step_customEvent as customEvent, step_identityAndAttributes as identityAndAttributes, step_screenView as screenView };
+}
+
+export { env, step };

package/dist/examples/index.d.ts

@@ -0,0 +1,52 @@
+import { DestinationServer, sendServer } from '@walkeros/server-core';
+import { Flow } from '@walkeros/core';
+
+interface Env extends DestinationServer.Env {
+    sendServer?: typeof sendServer;
+}
+
+/**
+ * Standard mock environment for push operations.
+ */
+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 };
+}
+
+/**
+ * Default custom_event — a walkerOS event with no `eventType` mapping.
+ * mParticle wraps it as a `custom_event` with the default `other` category.
+ * user_identities are resolved at the batch level from
+ * `settings.userIdentities`.
+ */
+declare const customEvent: Flow.StepExample;
+/**
+ * screen_view event — mapping.settings.eventType switches the mParticle
+ * event shape. Uses event name as the `screen_name`.
+ */
+declare const screenView: Flow.StepExample;
+/**
+ * commerce_event — mapping.settings.eventType: 'commerce_event' plus a
+ * `commerce` mapping resolves a ProductAction block. Products, currency,
+ * and transaction metadata are all driven by the commerce mapping value.
+ */
+declare const commercePurchase: Flow.StepExample;
+/**
+ * Identity + attributes — verifies `user_identities` and `user_attributes`
+ * come from the batch-level settings mappings, not the event payload.
+ */
+declare const identityAndAttributes: Flow.StepExample;
+
+declare const step_commercePurchase: typeof commercePurchase;
+declare const step_customEvent: typeof customEvent;
+declare const step_identityAndAttributes: typeof identityAndAttributes;
+declare const step_screenView: typeof screenView;
+declare namespace step {
+  export { step_commercePurchase as commercePurchase, step_customEvent as customEvent, step_identityAndAttributes as identityAndAttributes, step_screenView as screenView };
+}
+
+export { env, step };