@walkeros/server-destination-snapchat 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,162 @@
+# @walkeros/server-destination-snapchat
+
+Server-side Snapchat Conversions API destination for walkerOS. Sends conversion
+events directly to Snapchat's Conversions API v3 via HTTP POST for reliable
+server-to-server tracking.
+
+## Installation
+
+```bash
+npm install @walkeros/server-destination-snapchat
+```
+
+## Quick Start
+
+```json
+{
+  "destinations": {
+    "snapchat": {
+      "package": "@walkeros/server-destination-snapchat",
+      "config": {
+        "settings": {
+          "pixelId": "YOUR_PIXEL_ID",
+          "accessToken": "YOUR_ACCESS_TOKEN"
+        },
+        "mapping": {
+          "order": {
+            "complete": {
+              "name": "PURCHASE",
+              "data": {
+                "map": {
+                  "custom_data": {
+                    "map": {
+                      "value": "data.total",
+                      "currency": "data.currency",
+                      "transaction_id": "data.id"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+## Settings
+
+| Setting         | Type     | Required | Default                       | Description                                                 |
+| --------------- | -------- | -------- | ----------------------------- | ----------------------------------------------------------- |
+| `accessToken`   | string   | Yes      | --                            | Long-lived CAPI token from Snapchat Ads Manager             |
+| `pixelId`       | string   | Yes      | --                            | Snap Pixel ID                                               |
+| `url`           | string   | No       | `https://tr.snapchat.com/v3/` | Custom Conversions API base URL                             |
+| `action_source` | string   | No       | `WEB`                         | One of `WEB`, `MOBILE_APP`, `OFFLINE`                       |
+| `doNotHash`     | string[] | No       | `[]`                          | User data fields to skip SHA-256 hashing                    |
+| `user_data`     | object   | No       | --                            | Default user data mapping (e.g. `{ em: 'user.email' }`)     |
+| `testMode`      | boolean  | No       | `false`                       | Send to `/events/validate` for testing instead of `/events` |
+
+## Event Mapping
+
+| walkerOS Event     | Snapchat Standard Event (UPPERCASE) |
+| ------------------ | ----------------------------------- |
+| `page view`        | `PAGE_VIEW`                         |
+| `product view`     | `VIEW_CONTENT`                      |
+| `product add`      | `ADD_CART`                          |
+| `wishlist add`     | `ADD_TO_WISHLIST`                   |
+| `checkout start`   | `START_CHECKOUT`                    |
+| `checkout payment` | `ADD_BILLING`                       |
+| `order complete`   | `PURCHASE`                          |
+| `form submit`      | `SIGN_UP`                           |
+| `search submit`    | `SEARCH`                            |
+| `subscribe submit` | `SUBSCRIBE`                         |
+| `user login`       | `LOGIN`                             |
+
+Set the Snapchat event name via the rule's `name` field. Use UPPERCASE for
+standard events; custom event names may use `CUSTOM_EVENT_1..5` or any string.
+
+## User Data & Hashing
+
+The following 11 identity fields are automatically SHA-256 hashed before
+sending. They match Meta's CAPI semantics:
+
+| Field         | Hashed | Description                                  |
+| ------------- | ------ | -------------------------------------------- |
+| `em`          | Yes    | Email (lowercased, trimmed)                  |
+| `ph`          | Yes    | Phone number (E.164 digits)                  |
+| `fn`          | Yes    | First name (lowercase)                       |
+| `ln`          | Yes    | Last name (lowercase)                        |
+| `db`          | Yes    | Date of birth (YYYYMMDD)                     |
+| `ge`          | Yes    | Gender (`m`, `f`)                            |
+| `ct`          | Yes    | City (lowercase)                             |
+| `st`          | Yes    | State (lowercase)                            |
+| `zp`          | Yes    | Zip or postal code                           |
+| `country`     | Yes    | Country code (ISO 3166-1 alpha-2, lowercase) |
+| `external_id` | Yes    | External/customer identifier                 |
+
+These user data fields are **never** hashed and pass through as-is:
+
+| Field               | Hashed | Description                        |
+| ------------------- | ------ | ---------------------------------- |
+| `sc_cookie1`        | No     | Snap Pixel cookie                  |
+| `client_ip_address` | No     | Client IP address (IPv4 or IPv6)   |
+| `client_user_agent` | No     | Browser user agent string          |
+| `sc_click_id`       | No     | Snap click ID                      |
+| `idfv`              | No     | iOS IDFV                           |
+| `madid`             | No     | Mobile advertiser ID (IDFA / AAID) |
+
+Use the `doNotHash` setting to skip hashing for pre-hashed values.
+
+## custom_data Structure
+
+Properties must be nested under `custom_data` (unlike Meta's CAPI which puts
+them flat on the event root). Map them via `data.map.custom_data.map`:
+
+```json
+{
+  "data": {
+    "map": {
+      "custom_data": {
+        "map": {
+          "value": "data.total",
+          "currency": "data.currency",
+          "transaction_id": "data.id",
+          "contents": {
+            "loop": [
+              "nested",
+              {
+                "map": {
+                  "id": "data.id",
+                  "item_price": "data.price",
+                  "quantity": { "key": "data.quantity", "value": 1 }
+                }
+              }
+            ]
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+## Deduplication
+
+The destination uses `event.id` as Snapchat's `event_id`. When using both the
+Snap Pixel client-side and this server destination, Snapchat deduplicates
+matching events across channels within a 48h window by `event_id` +
+`event_name`.
+
+## Test Mode
+
+Set `"testMode": true` in settings to send events to Snapchat's
+`/events/validate` endpoint instead of `/events`. Snapchat returns detailed
+validation feedback without counting the event toward ads delivery. Switch off
+before going live.
+
+## Links
+
+- [Snapchat Conversions API Documentation](https://businesshelp.snapchat.com/s/article/conversions-api)
+- [walkerOS Documentation](https://www.walkeros.io)

package/dist/dev.d.mts

@@ -0,0 +1,120 @@
+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';
+
+/**
+ * Standard Snapchat Conversions API event names (UPPERCASE).
+ * https://businesshelp.snapchat.com/s/article/capi-parameters
+ */
+declare const StandardEventNameSchema: z.ZodUnion<readonly [z.ZodEnum<{
+    PAGE_VIEW: "PAGE_VIEW";
+    VIEW_CONTENT: "VIEW_CONTENT";
+    ADD_CART: "ADD_CART";
+    ADD_TO_WISHLIST: "ADD_TO_WISHLIST";
+    START_CHECKOUT: "START_CHECKOUT";
+    ADD_BILLING: "ADD_BILLING";
+    PURCHASE: "PURCHASE";
+    SIGN_UP: "SIGN_UP";
+    SEARCH: "SEARCH";
+    SAVE: "SAVE";
+    SUBSCRIBE: "SUBSCRIBE";
+    COMPLETE_TUTORIAL: "COMPLETE_TUTORIAL";
+    START_TRIAL: "START_TRIAL";
+    AD_CLICK: "AD_CLICK";
+    AD_VIEW: "AD_VIEW";
+    APP_OPEN: "APP_OPEN";
+    LEVEL_COMPLETE: "LEVEL_COMPLETE";
+    INVITE: "INVITE";
+    LOGIN: "LOGIN";
+    SHARE: "SHARE";
+    RESERVE: "RESERVE";
+    ACHIEVEMENT_UNLOCKED: "ACHIEVEMENT_UNLOCKED";
+    SPENT_CREDITS: "SPENT_CREDITS";
+    RATE: "RATE";
+    LIST_VIEW: "LIST_VIEW";
+    CUSTOM_EVENT_1: "CUSTOM_EVENT_1";
+    CUSTOM_EVENT_2: "CUSTOM_EVENT_2";
+    CUSTOM_EVENT_3: "CUSTOM_EVENT_3";
+    CUSTOM_EVENT_4: "CUSTOM_EVENT_4";
+    CUSTOM_EVENT_5: "CUSTOM_EVENT_5";
+}>, z.ZodString]>;
+
+declare const SettingsSchema: z.ZodObject<{
+    accessToken: z.ZodString;
+    pixelId: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+    action_source: z.ZodOptional<z.ZodEnum<{
+        WEB: "WEB";
+        MOBILE_APP: "MOBILE_APP";
+        OFFLINE: "OFFLINE";
+    }>>;
+    doNotHash: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    user_data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    testMode: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type Settings = z.infer<typeof SettingsSchema>;
+
+/**
+ * Snapchat Conversions API Mapping Schema
+ * Snapchat CAPI has no event-level mapping configuration
+ */
+declare const MappingSchema: z.ZodObject<{}, z.core.$strip>;
+/**
+ * Type inference from MappingSchema
+ */
+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;
+type index$1_Settings = Settings;
+declare const index$1_SettingsSchema: typeof SettingsSchema;
+declare const index$1_StandardEventNameSchema: typeof StandardEventNameSchema;
+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 index$1_Settings as Settings, index$1_SettingsSchema as SettingsSchema, index$1_StandardEventNameSchema as StandardEventNameSchema, index$1_mapping as mapping, index$1_settings as settings };
+}
+
+interface Env extends DestinationServer.Env {
+    sendServer?: typeof sendServer;
+}
+
+/**
+ * Standard mock environment for push operations.
+ *
+ * Use this for testing Snapchat Conversions API events without making
+ * actual HTTP requests to Snapchat's servers.
+ */
+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 };
+}
+
+declare const purchase: Flow.StepExample;
+declare const addToCart: Flow.StepExample;
+declare const pageView: Flow.StepExample;
+declare const lead: Flow.StepExample;
+
+declare const step_addToCart: typeof addToCart;
+declare const step_lead: typeof lead;
+declare const step_pageView: typeof pageView;
+declare const step_purchase: typeof purchase;
+declare namespace step {
+  export { step_addToCart as addToCart, step_lead as lead, step_pageView as pageView, step_purchase as purchase };
+}
+
+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,120 @@
+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';
+
+/**
+ * Standard Snapchat Conversions API event names (UPPERCASE).
+ * https://businesshelp.snapchat.com/s/article/capi-parameters
+ */
+declare const StandardEventNameSchema: z.ZodUnion<readonly [z.ZodEnum<{
+    PAGE_VIEW: "PAGE_VIEW";
+    VIEW_CONTENT: "VIEW_CONTENT";
+    ADD_CART: "ADD_CART";
+    ADD_TO_WISHLIST: "ADD_TO_WISHLIST";
+    START_CHECKOUT: "START_CHECKOUT";
+    ADD_BILLING: "ADD_BILLING";
+    PURCHASE: "PURCHASE";
+    SIGN_UP: "SIGN_UP";
+    SEARCH: "SEARCH";
+    SAVE: "SAVE";
+    SUBSCRIBE: "SUBSCRIBE";
+    COMPLETE_TUTORIAL: "COMPLETE_TUTORIAL";
+    START_TRIAL: "START_TRIAL";
+    AD_CLICK: "AD_CLICK";
+    AD_VIEW: "AD_VIEW";
+    APP_OPEN: "APP_OPEN";
+    LEVEL_COMPLETE: "LEVEL_COMPLETE";
+    INVITE: "INVITE";
+    LOGIN: "LOGIN";
+    SHARE: "SHARE";
+    RESERVE: "RESERVE";
+    ACHIEVEMENT_UNLOCKED: "ACHIEVEMENT_UNLOCKED";
+    SPENT_CREDITS: "SPENT_CREDITS";
+    RATE: "RATE";
+    LIST_VIEW: "LIST_VIEW";
+    CUSTOM_EVENT_1: "CUSTOM_EVENT_1";
+    CUSTOM_EVENT_2: "CUSTOM_EVENT_2";
+    CUSTOM_EVENT_3: "CUSTOM_EVENT_3";
+    CUSTOM_EVENT_4: "CUSTOM_EVENT_4";
+    CUSTOM_EVENT_5: "CUSTOM_EVENT_5";
+}>, z.ZodString]>;
+
+declare const SettingsSchema: z.ZodObject<{
+    accessToken: z.ZodString;
+    pixelId: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+    action_source: z.ZodOptional<z.ZodEnum<{
+        WEB: "WEB";
+        MOBILE_APP: "MOBILE_APP";
+        OFFLINE: "OFFLINE";
+    }>>;
+    doNotHash: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    user_data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    testMode: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type Settings = z.infer<typeof SettingsSchema>;
+
+/**
+ * Snapchat Conversions API Mapping Schema
+ * Snapchat CAPI has no event-level mapping configuration
+ */
+declare const MappingSchema: z.ZodObject<{}, z.core.$strip>;
+/**
+ * Type inference from MappingSchema
+ */
+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;
+type index$1_Settings = Settings;
+declare const index$1_SettingsSchema: typeof SettingsSchema;
+declare const index$1_StandardEventNameSchema: typeof StandardEventNameSchema;
+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 index$1_Settings as Settings, index$1_SettingsSchema as SettingsSchema, index$1_StandardEventNameSchema as StandardEventNameSchema, index$1_mapping as mapping, index$1_settings as settings };
+}
+
+interface Env extends DestinationServer.Env {
+    sendServer?: typeof sendServer;
+}
+
+/**
+ * Standard mock environment for push operations.
+ *
+ * Use this for testing Snapchat Conversions API events without making
+ * actual HTTP requests to Snapchat's servers.
+ */
+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 };
+}
+
+declare const purchase: Flow.StepExample;
+declare const addToCart: Flow.StepExample;
+declare const pageView: Flow.StepExample;
+declare const lead: Flow.StepExample;
+
+declare const step_addToCart: typeof addToCart;
+declare const step_lead: typeof lead;
+declare const step_pageView: typeof pageView;
+declare const step_purchase: typeof purchase;
+declare namespace step {
+  export { step_addToCart as addToCart, step_lead as lead, step_pageView as pageView, step_purchase as purchase };
+}
+
+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,a=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,n=Object.prototype.hasOwnProperty,s=(e,a)=>{for(var r in a)t(e,r,{get:a[r],enumerable:!0})},i={};s(i,{examples:()=>E,schemas:()=>o}),module.exports=(e=i,((e,s,i,o)=>{if(s&&"object"==typeof s||"function"==typeof s)for(let c of r(s))n.call(e,c)||c===i||t(e,c,{get:()=>s[c],enumerable:!(o=a(s,c))||o.enumerable});return e})(t({},"__esModule",{value:!0}),e));var o={};s(o,{MappingSchema:()=>p,SettingsSchema:()=>u,StandardEventNameSchema:()=>_,mapping:()=>v,settings:()=>l});var c=require("@walkeros/core/dev"),d=require("@walkeros/core/dev"),u=d.z.object({accessToken:d.z.string().min(1).describe("Long-lived Conversions API access token from Snapchat Ads Manager"),pixelId:d.z.string().min(1).describe("Snap Pixel ID"),url:d.z.string().url().describe("Custom Conversions API base URL (default https://tr.snapchat.com/v3/)").optional(),action_source:d.z.enum(["WEB","MOBILE_APP","OFFLINE"]).describe("Event action source (default WEB)").optional(),doNotHash:d.z.array(d.z.string()).describe("User data fields to skip hashing (like ['em', 'ph'])").optional(),user_data:d.z.record(d.z.string(),d.z.string()).describe("Mapping for user data fields (like { em: 'user.email' })").optional(),testMode:d.z.boolean().describe("When true, sends events to /events/validate instead of /events for testing").optional()}),p=require("@walkeros/core/dev").z.object({}),m=require("@walkeros/core/dev"),_=m.z.union([m.z.enum(["PAGE_VIEW","VIEW_CONTENT","ADD_CART","ADD_TO_WISHLIST","START_CHECKOUT","ADD_BILLING","PURCHASE","SIGN_UP","SEARCH","SAVE","SUBSCRIBE","COMPLETE_TUTORIAL","START_TRIAL","AD_CLICK","AD_VIEW","APP_OPEN","LEVEL_COMPLETE","INVITE","LOGIN","SHARE","RESERVE","ACHIEVEMENT_UNLOCKED","SPENT_CREDITS","RATE","LIST_VIEW","CUSTOM_EVENT_1","CUSTOM_EVENT_2","CUSTOM_EVENT_3","CUSTOM_EVENT_4","CUSTOM_EVENT_5"]),m.z.string()]),l=(0,c.zodToSchema)(u),v=(0,c.zodToSchema)(p),E={};s(E,{env:()=>S,step:()=>y});var S={};s(S,{push:()=>g,simulation:()=>h});var g={sendServer:async()=>({ok:!0,data:{status:"OK",request_id:"mock-123"}})},h=["sendServer"],y={};s(y,{addToCart:()=>O,lead:()=>C,pageView:()=>A,purchase:()=>f});var T=require("@walkeros/core"),b="https://tr.snapchat.com/v3/p1x3l1d/events?access_token=s3cr3t",f={in:(0,T.getEvent)("order complete",{timestamp:17000009e5,data:{id:"ORD-300",total:249.99,currency:"EUR"},nested:[{entity:"product",data:{id:"SKU-A1",name:"Widget Pro",price:124.99,quantity:2}}],user:{id:"user-123",device:"device-456"},source:{type:"server",id:"https://shop.example.com/checkout/complete",previous_id:""}}),mapping:{name:"PURCHASE",data:{map:{custom_data:{map:{value:"data.total",currency:{key:"data.currency",value:"EUR"},transaction_id:"data.id",contents:{loop:["nested",{condition:e=>(0,T.isObject)(e)&&"product"===e.entity,map:{id:"data.id",item_price:"data.price",quantity:{key:"data.quantity",value:1}}}]}}},user_data:{map:{external_id:"user.id"}}}}},out:[["sendServer",b,JSON.stringify({data:[{event_name:"PURCHASE",event_time:1700000900,action_source:"WEB",event_id:"1700000900000-gr0up-1",user_data:{external_id:"fcdec6df4d44dbc637c7c5b58efface52a7f8a88535423430255be0bb89bedd8"},custom_data:{value:249.99,currency:"EUR",transaction_id:"ORD-300",contents:[{id:"SKU-A1",item_price:124.99,quantity:2}]},event_source_url:"https://shop.example.com/checkout/complete"}]})]]},O={in:(0,T.getEvent)("product add",{timestamp:1700000901e3,data:{id:"SKU-B2",name:"Running Shoes",price:89.99,color:"blue"},nested:[{entity:"product",data:{id:"SKU-B2",name:"Running Shoes",price:89.99,quantity:1}}],source:{type:"server",id:"https://shop.example.com/products/running-shoes",previous_id:""}}),mapping:{name:"ADD_CART",data:{map:{custom_data:{map:{value:"data.price",currency:{value:"EUR"},contents:{loop:["nested",{condition:e=>(0,T.isObject)(e)&&"product"===e.entity,map:{id:"data.id",item_price:"data.price",quantity:{key:"data.quantity",value:1}}}]}}}}}},out:[["sendServer",b,JSON.stringify({data:[{event_name:"ADD_CART",event_time:1700000901,action_source:"WEB",event_id:"1700000901000-gr0up-1",user_data:{},custom_data:{value:89.99,currency:"EUR",contents:[{id:"SKU-B2",item_price:89.99,quantity:1}]},event_source_url:"https://shop.example.com/products/running-shoes"}]})]]},A={in:(0,T.getEvent)("page view",{timestamp:1700000902e3,source:{type:"server",id:"https://example.com/docs/",previous_id:""}}),mapping:void 0,out:[["sendServer",b,JSON.stringify({data:[{event_name:"page view",event_time:1700000902,action_source:"WEB",event_id:"1700000902000-gr0up-1",user_data:{},custom_data:{},event_source_url:"https://example.com/docs/"}]})]]},C={in:(0,T.getEvent)("form submit",{timestamp:1700000903e3,data:{type:"newsletter"},user:{email:"user@example.com"},source:{type:"server",id:"https://example.com/contact",previous_id:""}}),mapping:{name:"SIGN_UP",data:{map:{user_data:{map:{em:"user.email"}},custom_data:{map:{sign_up_method:{value:"newsletter"}}}}}},out:[["sendServer",b,JSON.stringify({data:[{event_name:"SIGN_UP",event_time:1700000903,action_source:"WEB",event_id:"1700000903000-gr0up-1",user_data:{em:"b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514"},custom_data:{sign_up_method:"newsletter"},event_source_url:"https://example.com/contact"}]})]]};//# 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/schemas/primitives.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';\n\nexport const SettingsSchema = z.object({\n  accessToken: z\n    .string()\n    .min(1)\n    .describe(\n      'Long-lived Conversions API access token from Snapchat Ads Manager',\n    ),\n  pixelId: z.string().min(1).describe('Snap Pixel ID'),\n  url: z\n    .string()\n    .url()\n    .describe(\n      'Custom Conversions API base URL (default https://tr.snapchat.com/v3/)',\n    )\n    .optional(),\n  action_source: z\n    .enum(['WEB', 'MOBILE_APP', 'OFFLINE'])\n    .describe('Event action source (default WEB)')\n    .optional(),\n  doNotHash: z\n    .array(z.string())\n    .describe(\"User data fields to skip hashing (like ['em', 'ph'])\")\n    .optional(),\n  user_data: z\n    .record(z.string(), z.string())\n    .describe(\"Mapping for user data fields (like { em: 'user.email' })\")\n    .optional(),\n  testMode: z\n    .boolean()\n    .describe(\n      'When true, sends events to /events/validate instead of /events for testing',\n    )\n    .optional(),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { z } from '@walkeros/core/dev';\n\n/**\n * Snapchat Conversions API Mapping Schema\n * Snapchat CAPI has no event-level mapping configuration\n */\nexport const MappingSchema = z.object({});\n\n/**\n * Type inference from MappingSchema\n */\nexport type Mapping = z.infer<typeof MappingSchema>;\n","import { z } from '@walkeros/core/dev';\n\n/**\n * Standard Snapchat Conversions API event names (UPPERCASE).\n * https://businesshelp.snapchat.com/s/article/capi-parameters\n */\nexport const StandardEventNameSchema = z.union([\n  z.enum([\n    'PAGE_VIEW',\n    'VIEW_CONTENT',\n    'ADD_CART',\n    'ADD_TO_WISHLIST',\n    'START_CHECKOUT',\n    'ADD_BILLING',\n    'PURCHASE',\n    'SIGN_UP',\n    'SEARCH',\n    'SAVE',\n    'SUBSCRIBE',\n    'COMPLETE_TUTORIAL',\n    'START_TRIAL',\n    'AD_CLICK',\n    'AD_VIEW',\n    'APP_OPEN',\n    'LEVEL_COMPLETE',\n    'INVITE',\n    'LOGIN',\n    'SHARE',\n    'RESERVE',\n    'ACHIEVEMENT_UNLOCKED',\n    'SPENT_CREDITS',\n    'RATE',\n    'LIST_VIEW',\n    'CUSTOM_EVENT_1',\n    'CUSTOM_EVENT_2',\n    'CUSTOM_EVENT_3',\n    'CUSTOM_EVENT_4',\n    'CUSTOM_EVENT_5',\n  ]),\n  z.string(), // Allow custom event names\n]);\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 Snapchat Conversions API destination.\n *\n * These environments provide standardized mock structures for testing\n * and development without requiring actual HTTP requests.\n */\n\ntype MockSendServer = (\n  url: string,\n  data?: SendDataValue,\n  options?: SendServerOptions,\n) => Promise<SendResponse>;\n\nconst mockSendServer: MockSendServer = async () => ({\n  ok: true,\n  data: {\n    status: 'OK',\n    request_id: 'mock-123',\n  },\n});\n\n/**\n * Standard mock environment for push operations.\n *\n * Use this for testing Snapchat Conversions API events without making\n * actual HTTP requests to Snapchat's servers.\n */\nexport const push: Env = {\n  sendServer: mockSendServer,\n};\n\nexport const simulation = ['sendServer'];\n","import type { Flow } from '@walkeros/core';\nimport { getEvent, isObject } from '@walkeros/core';\n\n/**\n * Snapchat Conversions API step examples.\n *\n * At push time, the destination calls `env.sendServer(url, body)` where\n * `url` is `${settings.url}${settings.pixelId}/${path}?access_token=${settings.accessToken}`\n * with `path` = `events` (or `events/validate` when `testMode` is set),\n * and `body` is the JSON-stringified `{ data: [snapchatEvent] }` payload.\n *\n * The test fixture pins `accessToken = 's3cr3t'` and `pixelId = 'p1x3l1d'`,\n * so every endpoint resolves to:\n *   https://tr.snapchat.com/v3/p1x3l1d/events?access_token=s3cr3t\n *\n * Body fields are emitted in the order the destination constructs them\n * (insertion order matters for `JSON.stringify` string equality):\n *   1. event_name\n *   2. event_time (unix seconds; `Math.round(event.timestamp / 1000)`)\n *   3. action_source (default 'WEB')\n *   4. event_id\n *   5. user_data (hashed per Snapchat's PII requirements)\n *   6. custom_data (mapped event data, excluding user_data/custom_data keys)\n *   7. event_source_url (appended last when action_source === 'WEB')\n */\nconst ENDPOINT =\n  'https://tr.snapchat.com/v3/p1x3l1d/events?access_token=s3cr3t';\n\nexport const purchase: Flow.StepExample = {\n  in: getEvent('order complete', {\n    timestamp: 1700000900000,\n    data: { id: 'ORD-300', total: 249.99, currency: 'EUR' },\n    nested: [\n      {\n        entity: 'product',\n        data: { id: 'SKU-A1', name: 'Widget Pro', price: 124.99, quantity: 2 },\n      },\n    ],\n    user: { id: 'user-123', device: 'device-456' },\n    source: {\n      type: 'server',\n      id: 'https://shop.example.com/checkout/complete',\n      previous_id: '',\n    },\n  }),\n  mapping: {\n    name: 'PURCHASE',\n    data: {\n      map: {\n        custom_data: {\n          map: {\n            value: 'data.total',\n            currency: { key: 'data.currency', value: 'EUR' },\n            transaction_id: 'data.id',\n            contents: {\n              loop: [\n                'nested',\n                {\n                  condition: (entity: unknown) =>\n                    isObject(entity) && entity.entity === 'product',\n                  map: {\n                    id: 'data.id',\n                    item_price: 'data.price',\n                    quantity: { key: 'data.quantity', value: 1 },\n                  },\n                },\n              ],\n            },\n          },\n        },\n        user_data: {\n          map: {\n            external_id: 'user.id',\n          },\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'sendServer',\n      ENDPOINT,\n      JSON.stringify({\n        data: [\n          {\n            event_name: 'PURCHASE',\n            event_time: 1700000900,\n            action_source: 'WEB',\n            event_id: '1700000900000-gr0up-1',\n            user_data: {\n              external_id:\n                'fcdec6df4d44dbc637c7c5b58efface52a7f8a88535423430255be0bb89bedd8',\n            },\n            custom_data: {\n              value: 249.99,\n              currency: 'EUR',\n              transaction_id: 'ORD-300',\n              contents: [{ id: 'SKU-A1', item_price: 124.99, quantity: 2 }],\n            },\n            event_source_url: 'https://shop.example.com/checkout/complete',\n          },\n        ],\n      }),\n    ],\n  ],\n};\n\nexport const addToCart: Flow.StepExample = {\n  in: getEvent('product add', {\n    timestamp: 1700000901000,\n    data: {\n      id: 'SKU-B2',\n      name: 'Running Shoes',\n      price: 89.99,\n      color: 'blue',\n    },\n    nested: [\n      {\n        entity: 'product',\n        data: {\n          id: 'SKU-B2',\n          name: 'Running Shoes',\n          price: 89.99,\n          quantity: 1,\n        },\n      },\n    ],\n    source: {\n      type: 'server',\n      id: 'https://shop.example.com/products/running-shoes',\n      previous_id: '',\n    },\n  }),\n  mapping: {\n    name: 'ADD_CART',\n    data: {\n      map: {\n        custom_data: {\n          map: {\n            value: 'data.price',\n            currency: { value: 'EUR' },\n            contents: {\n              loop: [\n                'nested',\n                {\n                  condition: (entity: unknown) =>\n                    isObject(entity) && entity.entity === 'product',\n                  map: {\n                    id: 'data.id',\n                    item_price: 'data.price',\n                    quantity: { key: 'data.quantity', value: 1 },\n                  },\n                },\n              ],\n            },\n          },\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'sendServer',\n      ENDPOINT,\n      JSON.stringify({\n        data: [\n          {\n            event_name: 'ADD_CART',\n            event_time: 1700000901,\n            action_source: 'WEB',\n            event_id: '1700000901000-gr0up-1',\n            user_data: {},\n            custom_data: {\n              value: 89.99,\n              currency: 'EUR',\n              contents: [{ id: 'SKU-B2', item_price: 89.99, quantity: 1 }],\n            },\n            event_source_url: 'https://shop.example.com/products/running-shoes',\n          },\n        ],\n      }),\n    ],\n  ],\n};\n\nexport const pageView: Flow.StepExample = {\n  in: getEvent('page view', {\n    timestamp: 1700000902000,\n    source: {\n      type: 'server',\n      id: 'https://example.com/docs/',\n      previous_id: '',\n    },\n  }),\n  mapping: undefined,\n  out: [\n    [\n      'sendServer',\n      ENDPOINT,\n      JSON.stringify({\n        data: [\n          {\n            event_name: 'page view',\n            event_time: 1700000902,\n            action_source: 'WEB',\n            event_id: '1700000902000-gr0up-1',\n            user_data: {},\n            custom_data: {},\n            event_source_url: 'https://example.com/docs/',\n          },\n        ],\n      }),\n    ],\n  ],\n};\n\nexport const lead: Flow.StepExample = {\n  in: getEvent('form submit', {\n    timestamp: 1700000903000,\n    data: { type: 'newsletter' },\n    user: { email: 'user@example.com' },\n    source: {\n      type: 'server',\n      id: 'https://example.com/contact',\n      previous_id: '',\n    },\n  }),\n  mapping: {\n    name: 'SIGN_UP',\n    data: {\n      map: {\n        user_data: {\n          map: {\n            em: 'user.email',\n          },\n        },\n        custom_data: {\n          map: {\n            sign_up_method: { value: 'newsletter' },\n          },\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'sendServer',\n      ENDPOINT,\n      JSON.stringify({\n        data: [\n          {\n            event_name: 'SIGN_UP',\n            event_time: 1700000903,\n            action_source: 'WEB',\n            event_id: '1700000903000-gr0up-1',\n            user_data: {\n              // sha256('user@example.com')\n              em: 'b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514',\n            },\n            custom_data: {\n              sign_up_method: 'newsletter',\n            },\n            event_source_url: 'https://example.com/contact',\n          },\n        ],\n      }),\n    ],\n  ],\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAAAA,cAA4B;;;ACA5B,iBAAkB;AAEX,IAAM,iBAAiB,aAAE,OAAO;AAAA,EACrC,aAAa,aACV,OAAO,EACP,IAAI,CAAC,EACL;AAAA,IACC;AAAA,EACF;AAAA,EACF,SAAS,aAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,eAAe;AAAA,EACnD,KAAK,aACF,OAAO,EACP,IAAI,EACJ;AAAA,IACC;AAAA,EACF,EACC,SAAS;AAAA,EACZ,eAAe,aACZ,KAAK,CAAC,OAAO,cAAc,SAAS,CAAC,EACrC,SAAS,mCAAmC,EAC5C,SAAS;AAAA,EACZ,WAAW,aACR,MAAM,aAAE,OAAO,CAAC,EAChB,SAAS,sDAAsD,EAC/D,SAAS;AAAA,EACZ,WAAW,aACR,OAAO,aAAE,OAAO,GAAG,aAAE,OAAO,CAAC,EAC7B,SAAS,0DAA0D,EACnE,SAAS;AAAA,EACZ,UAAU,aACP,QAAQ,EACR;AAAA,IACC;AAAA,EACF,EACC,SAAS;AACd,CAAC;;;ACnCD,IAAAC,cAAkB;AAMX,IAAM,gBAAgB,cAAE,OAAO,CAAC,CAAC;;;ACNxC,IAAAC,cAAkB;AAMX,IAAM,0BAA0B,cAAE,MAAM;AAAA,EAC7C,cAAE,KAAK;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAAA,EACD,cAAE,OAAO;AAAA;AACX,CAAC;;;AH9BM,IAAM,eAAW,yBAAY,cAAc;AAC3C,IAAM,cAAU,yBAAY,aAAa;;;AIXhD;AAAA;AAAA;AAAA;AAAA;;;ACAA;AAAA;AAAA;AAAA;AAAA;AAiBA,IAAM,iBAAiC,aAAa;AAAA,EAClD,IAAI;AAAA,EACJ,MAAM;AAAA,IACJ,QAAQ;AAAA,IACR,YAAY;AAAA,EACd;AACF;AAQO,IAAM,OAAY;AAAA,EACvB,YAAY;AACd;AAEO,IAAM,aAAa,CAAC,YAAY;;;ACnCvC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,kBAAmC;AAwBnC,IAAM,WACJ;AAEK,IAAM,WAA6B;AAAA,EACxC,QAAI,sBAAS,kBAAkB;AAAA,IAC7B,WAAW;AAAA,IACX,MAAM,EAAE,IAAI,WAAW,OAAO,QAAQ,UAAU,MAAM;AAAA,IACtD,QAAQ;AAAA,MACN;AAAA,QACE,QAAQ;AAAA,QACR,MAAM,EAAE,IAAI,UAAU,MAAM,cAAc,OAAO,QAAQ,UAAU,EAAE;AAAA,MACvE;AAAA,IACF;AAAA,IACA,MAAM,EAAE,IAAI,YAAY,QAAQ,aAAa;AAAA,IAC7C,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,IAAI;AAAA,MACJ,aAAa;AAAA,IACf;AAAA,EACF,CAAC;AAAA,EACD,SAAS;AAAA,IACP,MAAM;AAAA,IACN,MAAM;AAAA,MACJ,KAAK;AAAA,QACH,aAAa;AAAA,UACX,KAAK;AAAA,YACH,OAAO;AAAA,YACP,UAAU,EAAE,KAAK,iBAAiB,OAAO,MAAM;AAAA,YAC/C,gBAAgB;AAAA,YAChB,UAAU;AAAA,cACR,MAAM;AAAA,gBACJ;AAAA,gBACA;AAAA,kBACE,WAAW,CAAC,eACV,sBAAS,MAAM,KAAK,OAAO,WAAW;AAAA,kBACxC,KAAK;AAAA,oBACH,IAAI;AAAA,oBACJ,YAAY;AAAA,oBACZ,UAAU,EAAE,KAAK,iBAAiB,OAAO,EAAE;AAAA,kBAC7C;AAAA,gBACF;AAAA,cACF;AAAA,YACF;AAAA,UACF;AAAA,QACF;AAAA,QACA,WAAW;AAAA,UACT,KAAK;AAAA,YACH,aAAa;AAAA,UACf;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EACA,KAAK;AAAA,IACH;AAAA,MACE;AAAA,MACA;AAAA,MACA,KAAK,UAAU;AAAA,QACb,MAAM;AAAA,UACJ;AAAA,YACE,YAAY;AAAA,YACZ,YAAY;AAAA,YACZ,eAAe;AAAA,YACf,UAAU;AAAA,YACV,WAAW;AAAA,cACT,aACE;AAAA,YACJ;AAAA,YACA,aAAa;AAAA,cACX,OAAO;AAAA,cACP,UAAU;AAAA,cACV,gBAAgB;AAAA,cAChB,UAAU,CAAC,EAAE,IAAI,UAAU,YAAY,QAAQ,UAAU,EAAE,CAAC;AAAA,YAC9D;AAAA,YACA,kBAAkB;AAAA,UACpB;AAAA,QACF;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AACF;AAEO,IAAM,YAA8B;AAAA,EACzC,QAAI,sBAAS,eAAe;AAAA,IAC1B,WAAW;AAAA,IACX,MAAM;AAAA,MACJ,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO;AAAA,IACT;AAAA,IACA,QAAQ;AAAA,MACN;AAAA,QACE,QAAQ;AAAA,QACR,MAAM;AAAA,UACJ,IAAI;AAAA,UACJ,MAAM;AAAA,UACN,OAAO;AAAA,UACP,UAAU;AAAA,QACZ;AAAA,MACF;AAAA,IACF;AAAA,IACA,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,IAAI;AAAA,MACJ,aAAa;AAAA,IACf;AAAA,EACF,CAAC;AAAA,EACD,SAAS;AAAA,IACP,MAAM;AAAA,IACN,MAAM;AAAA,MACJ,KAAK;AAAA,QACH,aAAa;AAAA,UACX,KAAK;AAAA,YACH,OAAO;AAAA,YACP,UAAU,EAAE,OAAO,MAAM;AAAA,YACzB,UAAU;AAAA,cACR,MAAM;AAAA,gBACJ;AAAA,gBACA;AAAA,kBACE,WAAW,CAAC,eACV,sBAAS,MAAM,KAAK,OAAO,WAAW;AAAA,kBACxC,KAAK;AAAA,oBACH,IAAI;AAAA,oBACJ,YAAY;AAAA,oBACZ,UAAU,EAAE,KAAK,iBAAiB,OAAO,EAAE;AAAA,kBAC7C;AAAA,gBACF;AAAA,cACF;AAAA,YACF;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EACA,KAAK;AAAA,IACH;AAAA,MACE;AAAA,MACA;AAAA,MACA,KAAK,UAAU;AAAA,QACb,MAAM;AAAA,UACJ;AAAA,YACE,YAAY;AAAA,YACZ,YAAY;AAAA,YACZ,eAAe;AAAA,YACf,UAAU;AAAA,YACV,WAAW,CAAC;AAAA,YACZ,aAAa;AAAA,cACX,OAAO;AAAA,cACP,UAAU;AAAA,cACV,UAAU,CAAC,EAAE,IAAI,UAAU,YAAY,OAAO,UAAU,EAAE,CAAC;AAAA,YAC7D;AAAA,YACA,kBAAkB;AAAA,UACpB;AAAA,QACF;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AACF;AAEO,IAAM,WAA6B;AAAA,EACxC,QAAI,sBAAS,aAAa;AAAA,IACxB,WAAW;AAAA,IACX,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,IAAI;AAAA,MACJ,aAAa;AAAA,IACf;AAAA,EACF,CAAC;AAAA,EACD,SAAS;AAAA,EACT,KAAK;AAAA,IACH;AAAA,MACE;AAAA,MACA;AAAA,MACA,KAAK,UAAU;AAAA,QACb,MAAM;AAAA,UACJ;AAAA,YACE,YAAY;AAAA,YACZ,YAAY;AAAA,YACZ,eAAe;AAAA,YACf,UAAU;AAAA,YACV,WAAW,CAAC;AAAA,YACZ,aAAa,CAAC;AAAA,YACd,kBAAkB;AAAA,UACpB;AAAA,QACF;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AACF;AAEO,IAAM,OAAyB;AAAA,EACpC,QAAI,sBAAS,eAAe;AAAA,IAC1B,WAAW;AAAA,IACX,MAAM,EAAE,MAAM,aAAa;AAAA,IAC3B,MAAM,EAAE,OAAO,mBAAmB;AAAA,IAClC,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,IAAI;AAAA,MACJ,aAAa;AAAA,IACf;AAAA,EACF,CAAC;AAAA,EACD,SAAS;AAAA,IACP,MAAM;AAAA,IACN,MAAM;AAAA,MACJ,KAAK;AAAA,QACH,WAAW;AAAA,UACT,KAAK;AAAA,YACH,IAAI;AAAA,UACN;AAAA,QACF;AAAA,QACA,aAAa;AAAA,UACX,KAAK;AAAA,YACH,gBAAgB,EAAE,OAAO,aAAa;AAAA,UACxC;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EACA,KAAK;AAAA,IACH;AAAA,MACE;AAAA,MACA;AAAA,MACA,KAAK,UAAU;AAAA,QACb,MAAM;AAAA,UACJ;AAAA,YACE,YAAY;AAAA,YACZ,YAAY;AAAA,YACZ,eAAe;AAAA,YACf,UAAU;AAAA,YACV,WAAW;AAAA;AAAA,cAET,IAAI;AAAA,YACN;AAAA,YACA,aAAa;AAAA,cACX,gBAAgB;AAAA,YAClB;AAAA,YACA,kBAAkB;AAAA,UACpB;AAAA,QACF;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AACF;","names":["import_dev","import_dev","import_dev"]}

package/dist/dev.mjs

@@ -0,0 +1 @@
+var e=Object.defineProperty,t=(t,a)=>{for(var r in a)e(t,r,{get:a[r],enumerable:!0})},a={};t(a,{MappingSchema:()=>o,SettingsSchema:()=>n,StandardEventNameSchema:()=>c,mapping:()=>m,settings:()=>p});import{zodToSchema as r}from"@walkeros/core/dev";import{z as s}from"@walkeros/core/dev";var n=s.object({accessToken:s.string().min(1).describe("Long-lived Conversions API access token from Snapchat Ads Manager"),pixelId:s.string().min(1).describe("Snap Pixel ID"),url:s.string().url().describe("Custom Conversions API base URL (default https://tr.snapchat.com/v3/)").optional(),action_source:s.enum(["WEB","MOBILE_APP","OFFLINE"]).describe("Event action source (default WEB)").optional(),doNotHash:s.array(s.string()).describe("User data fields to skip hashing (like ['em', 'ph'])").optional(),user_data:s.record(s.string(),s.string()).describe("Mapping for user data fields (like { em: 'user.email' })").optional(),testMode:s.boolean().describe("When true, sends events to /events/validate instead of /events for testing").optional()});import{z as i}from"@walkeros/core/dev";var o=i.object({});import{z as d}from"@walkeros/core/dev";var c=d.union([d.enum(["PAGE_VIEW","VIEW_CONTENT","ADD_CART","ADD_TO_WISHLIST","START_CHECKOUT","ADD_BILLING","PURCHASE","SIGN_UP","SEARCH","SAVE","SUBSCRIBE","COMPLETE_TUTORIAL","START_TRIAL","AD_CLICK","AD_VIEW","APP_OPEN","LEVEL_COMPLETE","INVITE","LOGIN","SHARE","RESERVE","ACHIEVEMENT_UNLOCKED","SPENT_CREDITS","RATE","LIST_VIEW","CUSTOM_EVENT_1","CUSTOM_EVENT_2","CUSTOM_EVENT_3","CUSTOM_EVENT_4","CUSTOM_EVENT_5"]),d.string()]),p=r(n),m=r(o),u={};t(u,{env:()=>_,step:()=>E});var _={};t(_,{push:()=>v,simulation:()=>l});var v={sendServer:async()=>({ok:!0,data:{status:"OK",request_id:"mock-123"}})},l=["sendServer"],E={};t(E,{addToCart:()=>y,lead:()=>A,pageView:()=>f,purchase:()=>T});import{getEvent as S,isObject as g}from"@walkeros/core";var h="https://tr.snapchat.com/v3/p1x3l1d/events?access_token=s3cr3t",T={in:S("order complete",{timestamp:17000009e5,data:{id:"ORD-300",total:249.99,currency:"EUR"},nested:[{entity:"product",data:{id:"SKU-A1",name:"Widget Pro",price:124.99,quantity:2}}],user:{id:"user-123",device:"device-456"},source:{type:"server",id:"https://shop.example.com/checkout/complete",previous_id:""}}),mapping:{name:"PURCHASE",data:{map:{custom_data:{map:{value:"data.total",currency:{key:"data.currency",value:"EUR"},transaction_id:"data.id",contents:{loop:["nested",{condition:e=>g(e)&&"product"===e.entity,map:{id:"data.id",item_price:"data.price",quantity:{key:"data.quantity",value:1}}}]}}},user_data:{map:{external_id:"user.id"}}}}},out:[["sendServer",h,JSON.stringify({data:[{event_name:"PURCHASE",event_time:1700000900,action_source:"WEB",event_id:"1700000900000-gr0up-1",user_data:{external_id:"fcdec6df4d44dbc637c7c5b58efface52a7f8a88535423430255be0bb89bedd8"},custom_data:{value:249.99,currency:"EUR",transaction_id:"ORD-300",contents:[{id:"SKU-A1",item_price:124.99,quantity:2}]},event_source_url:"https://shop.example.com/checkout/complete"}]})]]},y={in:S("product add",{timestamp:1700000901e3,data:{id:"SKU-B2",name:"Running Shoes",price:89.99,color:"blue"},nested:[{entity:"product",data:{id:"SKU-B2",name:"Running Shoes",price:89.99,quantity:1}}],source:{type:"server",id:"https://shop.example.com/products/running-shoes",previous_id:""}}),mapping:{name:"ADD_CART",data:{map:{custom_data:{map:{value:"data.price",currency:{value:"EUR"},contents:{loop:["nested",{condition:e=>g(e)&&"product"===e.entity,map:{id:"data.id",item_price:"data.price",quantity:{key:"data.quantity",value:1}}}]}}}}}},out:[["sendServer",h,JSON.stringify({data:[{event_name:"ADD_CART",event_time:1700000901,action_source:"WEB",event_id:"1700000901000-gr0up-1",user_data:{},custom_data:{value:89.99,currency:"EUR",contents:[{id:"SKU-B2",item_price:89.99,quantity:1}]},event_source_url:"https://shop.example.com/products/running-shoes"}]})]]},f={in:S("page view",{timestamp:1700000902e3,source:{type:"server",id:"https://example.com/docs/",previous_id:""}}),mapping:void 0,out:[["sendServer",h,JSON.stringify({data:[{event_name:"page view",event_time:1700000902,action_source:"WEB",event_id:"1700000902000-gr0up-1",user_data:{},custom_data:{},event_source_url:"https://example.com/docs/"}]})]]},A={in:S("form submit",{timestamp:1700000903e3,data:{type:"newsletter"},user:{email:"user@example.com"},source:{type:"server",id:"https://example.com/contact",previous_id:""}}),mapping:{name:"SIGN_UP",data:{map:{user_data:{map:{em:"user.email"}},custom_data:{map:{sign_up_method:{value:"newsletter"}}}}}},out:[["sendServer",h,JSON.stringify({data:[{event_name:"SIGN_UP",event_time:1700000903,action_source:"WEB",event_id:"1700000903000-gr0up-1",user_data:{em:"b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514"},custom_data:{sign_up_method:"newsletter"},event_source_url:"https://example.com/contact"}]})]]};export{u as examples,a as schemas};//# sourceMappingURL=dev.mjs.map

package/dist/dev.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schemas/index.ts","../src/schemas/settings.ts","../src/schemas/mapping.ts","../src/schemas/primitives.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';\n\nexport const SettingsSchema = z.object({\n  accessToken: z\n    .string()\n    .min(1)\n    .describe(\n      'Long-lived Conversions API access token from Snapchat Ads Manager',\n    ),\n  pixelId: z.string().min(1).describe('Snap Pixel ID'),\n  url: z\n    .string()\n    .url()\n    .describe(\n      'Custom Conversions API base URL (default https://tr.snapchat.com/v3/)',\n    )\n    .optional(),\n  action_source: z\n    .enum(['WEB', 'MOBILE_APP', 'OFFLINE'])\n    .describe('Event action source (default WEB)')\n    .optional(),\n  doNotHash: z\n    .array(z.string())\n    .describe(\"User data fields to skip hashing (like ['em', 'ph'])\")\n    .optional(),\n  user_data: z\n    .record(z.string(), z.string())\n    .describe(\"Mapping for user data fields (like { em: 'user.email' })\")\n    .optional(),\n  testMode: z\n    .boolean()\n    .describe(\n      'When true, sends events to /events/validate instead of /events for testing',\n    )\n    .optional(),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { z } from '@walkeros/core/dev';\n\n/**\n * Snapchat Conversions API Mapping Schema\n * Snapchat CAPI has no event-level mapping configuration\n */\nexport const MappingSchema = z.object({});\n\n/**\n * Type inference from MappingSchema\n */\nexport type Mapping = z.infer<typeof MappingSchema>;\n","import { z } from '@walkeros/core/dev';\n\n/**\n * Standard Snapchat Conversions API event names (UPPERCASE).\n * https://businesshelp.snapchat.com/s/article/capi-parameters\n */\nexport const StandardEventNameSchema = z.union([\n  z.enum([\n    'PAGE_VIEW',\n    'VIEW_CONTENT',\n    'ADD_CART',\n    'ADD_TO_WISHLIST',\n    'START_CHECKOUT',\n    'ADD_BILLING',\n    'PURCHASE',\n    'SIGN_UP',\n    'SEARCH',\n    'SAVE',\n    'SUBSCRIBE',\n    'COMPLETE_TUTORIAL',\n    'START_TRIAL',\n    'AD_CLICK',\n    'AD_VIEW',\n    'APP_OPEN',\n    'LEVEL_COMPLETE',\n    'INVITE',\n    'LOGIN',\n    'SHARE',\n    'RESERVE',\n    'ACHIEVEMENT_UNLOCKED',\n    'SPENT_CREDITS',\n    'RATE',\n    'LIST_VIEW',\n    'CUSTOM_EVENT_1',\n    'CUSTOM_EVENT_2',\n    'CUSTOM_EVENT_3',\n    'CUSTOM_EVENT_4',\n    'CUSTOM_EVENT_5',\n  ]),\n  z.string(), // Allow custom event names\n]);\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 Snapchat Conversions API destination.\n *\n * These environments provide standardized mock structures for testing\n * and development without requiring actual HTTP requests.\n */\n\ntype MockSendServer = (\n  url: string,\n  data?: SendDataValue,\n  options?: SendServerOptions,\n) => Promise<SendResponse>;\n\nconst mockSendServer: MockSendServer = async () => ({\n  ok: true,\n  data: {\n    status: 'OK',\n    request_id: 'mock-123',\n  },\n});\n\n/**\n * Standard mock environment for push operations.\n *\n * Use this for testing Snapchat Conversions API events without making\n * actual HTTP requests to Snapchat's servers.\n */\nexport const push: Env = {\n  sendServer: mockSendServer,\n};\n\nexport const simulation = ['sendServer'];\n","import type { Flow } from '@walkeros/core';\nimport { getEvent, isObject } from '@walkeros/core';\n\n/**\n * Snapchat Conversions API step examples.\n *\n * At push time, the destination calls `env.sendServer(url, body)` where\n * `url` is `${settings.url}${settings.pixelId}/${path}?access_token=${settings.accessToken}`\n * with `path` = `events` (or `events/validate` when `testMode` is set),\n * and `body` is the JSON-stringified `{ data: [snapchatEvent] }` payload.\n *\n * The test fixture pins `accessToken = 's3cr3t'` and `pixelId = 'p1x3l1d'`,\n * so every endpoint resolves to:\n *   https://tr.snapchat.com/v3/p1x3l1d/events?access_token=s3cr3t\n *\n * Body fields are emitted in the order the destination constructs them\n * (insertion order matters for `JSON.stringify` string equality):\n *   1. event_name\n *   2. event_time (unix seconds; `Math.round(event.timestamp / 1000)`)\n *   3. action_source (default 'WEB')\n *   4. event_id\n *   5. user_data (hashed per Snapchat's PII requirements)\n *   6. custom_data (mapped event data, excluding user_data/custom_data keys)\n *   7. event_source_url (appended last when action_source === 'WEB')\n */\nconst ENDPOINT =\n  'https://tr.snapchat.com/v3/p1x3l1d/events?access_token=s3cr3t';\n\nexport const purchase: Flow.StepExample = {\n  in: getEvent('order complete', {\n    timestamp: 1700000900000,\n    data: { id: 'ORD-300', total: 249.99, currency: 'EUR' },\n    nested: [\n      {\n        entity: 'product',\n        data: { id: 'SKU-A1', name: 'Widget Pro', price: 124.99, quantity: 2 },\n      },\n    ],\n    user: { id: 'user-123', device: 'device-456' },\n    source: {\n      type: 'server',\n      id: 'https://shop.example.com/checkout/complete',\n      previous_id: '',\n    },\n  }),\n  mapping: {\n    name: 'PURCHASE',\n    data: {\n      map: {\n        custom_data: {\n          map: {\n            value: 'data.total',\n            currency: { key: 'data.currency', value: 'EUR' },\n            transaction_id: 'data.id',\n            contents: {\n              loop: [\n                'nested',\n                {\n                  condition: (entity: unknown) =>\n                    isObject(entity) && entity.entity === 'product',\n                  map: {\n                    id: 'data.id',\n                    item_price: 'data.price',\n                    quantity: { key: 'data.quantity', value: 1 },\n                  },\n                },\n              ],\n            },\n          },\n        },\n        user_data: {\n          map: {\n            external_id: 'user.id',\n          },\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'sendServer',\n      ENDPOINT,\n      JSON.stringify({\n        data: [\n          {\n            event_name: 'PURCHASE',\n            event_time: 1700000900,\n            action_source: 'WEB',\n            event_id: '1700000900000-gr0up-1',\n            user_data: {\n              external_id:\n                'fcdec6df4d44dbc637c7c5b58efface52a7f8a88535423430255be0bb89bedd8',\n            },\n            custom_data: {\n              value: 249.99,\n              currency: 'EUR',\n              transaction_id: 'ORD-300',\n              contents: [{ id: 'SKU-A1', item_price: 124.99, quantity: 2 }],\n            },\n            event_source_url: 'https://shop.example.com/checkout/complete',\n          },\n        ],\n      }),\n    ],\n  ],\n};\n\nexport const addToCart: Flow.StepExample = {\n  in: getEvent('product add', {\n    timestamp: 1700000901000,\n    data: {\n      id: 'SKU-B2',\n      name: 'Running Shoes',\n      price: 89.99,\n      color: 'blue',\n    },\n    nested: [\n      {\n        entity: 'product',\n        data: {\n          id: 'SKU-B2',\n          name: 'Running Shoes',\n          price: 89.99,\n          quantity: 1,\n        },\n      },\n    ],\n    source: {\n      type: 'server',\n      id: 'https://shop.example.com/products/running-shoes',\n      previous_id: '',\n    },\n  }),\n  mapping: {\n    name: 'ADD_CART',\n    data: {\n      map: {\n        custom_data: {\n          map: {\n            value: 'data.price',\n            currency: { value: 'EUR' },\n            contents: {\n              loop: [\n                'nested',\n                {\n                  condition: (entity: unknown) =>\n                    isObject(entity) && entity.entity === 'product',\n                  map: {\n                    id: 'data.id',\n                    item_price: 'data.price',\n                    quantity: { key: 'data.quantity', value: 1 },\n                  },\n                },\n              ],\n            },\n          },\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'sendServer',\n      ENDPOINT,\n      JSON.stringify({\n        data: [\n          {\n            event_name: 'ADD_CART',\n            event_time: 1700000901,\n            action_source: 'WEB',\n            event_id: '1700000901000-gr0up-1',\n            user_data: {},\n            custom_data: {\n              value: 89.99,\n              currency: 'EUR',\n              contents: [{ id: 'SKU-B2', item_price: 89.99, quantity: 1 }],\n            },\n            event_source_url: 'https://shop.example.com/products/running-shoes',\n          },\n        ],\n      }),\n    ],\n  ],\n};\n\nexport const pageView: Flow.StepExample = {\n  in: getEvent('page view', {\n    timestamp: 1700000902000,\n    source: {\n      type: 'server',\n      id: 'https://example.com/docs/',\n      previous_id: '',\n    },\n  }),\n  mapping: undefined,\n  out: [\n    [\n      'sendServer',\n      ENDPOINT,\n      JSON.stringify({\n        data: [\n          {\n            event_name: 'page view',\n            event_time: 1700000902,\n            action_source: 'WEB',\n            event_id: '1700000902000-gr0up-1',\n            user_data: {},\n            custom_data: {},\n            event_source_url: 'https://example.com/docs/',\n          },\n        ],\n      }),\n    ],\n  ],\n};\n\nexport const lead: Flow.StepExample = {\n  in: getEvent('form submit', {\n    timestamp: 1700000903000,\n    data: { type: 'newsletter' },\n    user: { email: 'user@example.com' },\n    source: {\n      type: 'server',\n      id: 'https://example.com/contact',\n      previous_id: '',\n    },\n  }),\n  mapping: {\n    name: 'SIGN_UP',\n    data: {\n      map: {\n        user_data: {\n          map: {\n            em: 'user.email',\n          },\n        },\n        custom_data: {\n          map: {\n            sign_up_method: { value: 'newsletter' },\n          },\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'sendServer',\n      ENDPOINT,\n      JSON.stringify({\n        data: [\n          {\n            event_name: 'SIGN_UP',\n            event_time: 1700000903,\n            action_source: 'WEB',\n            event_id: '1700000903000-gr0up-1',\n            user_data: {\n              // sha256('user@example.com')\n              em: 'b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514',\n            },\n            custom_data: {\n              sign_up_method: 'newsletter',\n            },\n            event_source_url: 'https://example.com/contact',\n          },\n        ],\n      }),\n    ],\n  ],\n};\n"],"mappings":"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","names":["z","z"]}

package/dist/examples/index.d.mts

@@ -0,0 +1,36 @@
+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.
+ *
+ * Use this for testing Snapchat Conversions API events without making
+ * actual HTTP requests to Snapchat's servers.
+ */
+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 };
+}
+
+declare const purchase: Flow.StepExample;
+declare const addToCart: Flow.StepExample;
+declare const pageView: Flow.StepExample;
+declare const lead: Flow.StepExample;
+
+declare const step_addToCart: typeof addToCart;
+declare const step_lead: typeof lead;
+declare const step_pageView: typeof pageView;
+declare const step_purchase: typeof purchase;
+declare namespace step {
+  export { step_addToCart as addToCart, step_lead as lead, step_pageView as pageView, step_purchase as purchase };
+}
+
+export { env, step };

package/dist/examples/index.d.ts

@@ -0,0 +1,36 @@
+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.
+ *
+ * Use this for testing Snapchat Conversions API events without making
+ * actual HTTP requests to Snapchat's servers.
+ */
+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 };
+}
+
+declare const purchase: Flow.StepExample;
+declare const addToCart: Flow.StepExample;
+declare const pageView: Flow.StepExample;
+declare const lead: Flow.StepExample;
+
+declare const step_addToCart: typeof addToCart;
+declare const step_lead: typeof lead;
+declare const step_pageView: typeof pageView;
+declare const step_purchase: typeof purchase;
+declare namespace step {
+  export { step_addToCart as addToCart, step_lead as lead, step_pageView as pageView, step_purchase as purchase };
+}
+
+export { env, step };