@walkeros/server-destination-meta 3.4.0 → 3.4.1

package/dist/dev.js

@@ -1 +1 @@
-"use strict";var e,t=Object.defineProperty,r=Object.getOwnPropertyDescriptor,a=Object.getOwnPropertyNames,i=Object.prototype.hasOwnProperty,o=(e,r)=>{for(var a in r)t(e,a,{get:r[a],enumerable:!0})},s={};o(s,{examples:()=>b,schemas:()=>n}),module.exports=(e=s,((e,o,s,n)=>{if(o&&"object"==typeof o||"function"==typeof o)for(let c of a(o))i.call(e,c)||c===s||t(e,c,{get:()=>o[c],enumerable:!(n=r(o,c))||n.enumerable});return e})(t({},"__esModule",{value:!0}),e));var n={};o(n,{ActionSourceSchema:()=>p,EventNameSchema:()=>l,MappingSchema:()=>v,SettingsSchema:()=>m,mapping:()=>h,settings:()=>_});var c=require("@walkeros/core/dev"),d=require("@walkeros/core/dev"),u=require("@walkeros/core/dev"),p=u.z.enum(["email","website","app","phone_call","chat","physical_store","system_generated","business_messaging","other"]),l=u.z.union([u.z.enum(["AddPaymentInfo","AddToCart","AddToWishlist","CompleteRegistration","Contact","CustomizeProduct","Donate","FindLocation","InitiateCheckout","Lead","Purchase","Schedule","Search","StartTrial","SubmitApplication","Subscribe","ViewContent"]),u.z.string()]),m=d.z.object({accessToken:d.z.string().min(1).describe("Meta access token for Conversions API authentication (like your_access_token)"),pixelId:d.z.string().regex(/^[0-9]+$/,"Pixel ID must contain only digits").describe("Meta Pixel ID from your Facebook Business account (like 1234567890)"),action_source:p.describe("Source of the event (website, app, phone_call, etc.) (like website)").optional(),doNotHash:d.z.array(d.z.string()).describe("Array of user_data fields that should not be hashed (like ['client_ip_address', 'client_user_agent'])").optional(),test_event_code:d.z.string().describe("Test event code for debugging Meta Conversions API events (like TEST12345)").optional(),url:d.z.string().url().describe("Custom URL for Meta Conversions API endpoint (like https://graph.facebook.com/v17.0)").optional(),user_data:d.z.record(d.z.string(),d.z.string()).describe("Mapping configuration for user data fields (like { email: 'user.email', phone: 'user.phone' })").optional()}),v=require("@walkeros/core/dev").z.object({}),_=(0,c.zodToSchema)(m),h=(0,c.zodToSchema)(v),b={};o(b,{env:()=>g,step:()=>S});var g={};o(g,{push:()=>y,simulation:()=>f});var y={sendServer:async function(e,t,r){return{ok:!0,data:{events_received:1,messages:[],fbtrace_id:"mock-trace-id"}}}},f=["sendServer"],S={};o(S,{lead:()=>w,purchase:()=>z,purchaseWithClickAttribution:()=>P});var k=require("@walkeros/core"),x="https://graph.facebook.com/v22.0/p1x3l1d/events?access_token=s3cr3t",z={in:(0,k.getEvent)("order complete",{timestamp:1700000900,data:{id:"ORD-300",total:249.99,currency:"EUR"},nested:[{entity:"product",data:{id:"SKU-A1",price:129.99,quantity:2}}],user:{id:"user-123",device:"device-456"},source:{type:"server",id:"https://shop.example.com",previous_id:""}}),mapping:{name:"Purchase",data:{map:{order_id:"data.id",currency:{key:"data.currency",value:"EUR"},value:"data.total",contents:{loop:["nested",{condition:e=>(0,k.isObject)(e)&&"product"===e.entity,map:{id:"data.id",item_price:"data.price",quantity:{key:"data.quantity",value:1}}}]},num_items:{fn:e=>e.nested.filter(e=>"product"===e.entity).length}}}},out:[["sendServer",x,JSON.stringify({data:[{event_name:"Purchase",event_id:"1700000900-gr0up-1",event_time:1700001,action_source:"website",order_id:"ORD-300",currency:"EUR",value:249.99,contents:[{id:"SKU-A1",item_price:129.99,quantity:2}],num_items:1,user_data:{},event_source_url:"https://shop.example.com"}]})]]},w={in:(0,k.getEvent)("form submit",{timestamp:1700000901,data:{type:"newsletter"},user:{email:"user@example.com"},source:{type:"server",id:"https://example.com",previous_id:""}}),mapping:void 0,out:[["sendServer",x,JSON.stringify({data:[{event_name:"form submit",event_id:"1700000901-gr0up-1",event_time:1700001,action_source:"website",user_data:{},event_source_url:"https://example.com"}]})]]},P={in:(0,k.getEvent)("order complete",{timestamp:1700000902,data:{id:"ORD-700",total:89.99,currency:"USD"},user:{id:"cust-42"},context:{fbclid:["abc123xyz",0]},source:{type:"server",id:"https://shop.example.com",previous_id:""}}),mapping:{name:"Purchase",data:{map:{currency:{key:"data.currency",value:"EUR"},value:"data.total",order_id:"data.id",user_data:{map:{external_id:"user.id",fbclid:"context.fbclid"}}}}},out:[["sendServer",x,JSON.stringify({data:[{event_name:"Purchase",event_id:"1700000902-gr0up-1",event_time:1700001,action_source:"website",currency:"USD",value:89.99,order_id:"ORD-700",user_data:{external_id:"8a3c5a67cad508582b5edf6b8352cea3ffbad7f44812c1a736b4444c0f5746aa",fbc:"fb.1.1700000902.abc123xyz,0"},event_source_url:"https://shop.example.com"}]})]]};//# sourceMappingURL=dev.js.map
+"use strict";var e,t=Object.defineProperty,r=Object.getOwnPropertyDescriptor,a=Object.getOwnPropertyNames,i=Object.prototype.hasOwnProperty,o=(e,r)=>{for(var a in r)t(e,a,{get:r[a],enumerable:!0})},s={};o(s,{examples:()=>b,schemas:()=>n}),module.exports=(e=s,((e,o,s,n)=>{if(o&&"object"==typeof o||"function"==typeof o)for(let c of a(o))i.call(e,c)||c===s||t(e,c,{get:()=>o[c],enumerable:!(n=r(o,c))||n.enumerable});return e})(t({},"__esModule",{value:!0}),e));var n={};o(n,{ActionSourceSchema:()=>p,EventNameSchema:()=>l,MappingSchema:()=>v,SettingsSchema:()=>m,mapping:()=>_,settings:()=>h});var c=require("@walkeros/core/dev"),d=require("@walkeros/core/dev"),u=require("@walkeros/core/dev"),p=u.z.enum(["email","website","app","phone_call","chat","physical_store","system_generated","business_messaging","other"]),l=u.z.union([u.z.enum(["AddPaymentInfo","AddToCart","AddToWishlist","CompleteRegistration","Contact","CustomizeProduct","Donate","FindLocation","InitiateCheckout","Lead","Purchase","Schedule","Search","StartTrial","SubmitApplication","Subscribe","ViewContent"]),u.z.string()]),m=d.z.object({accessToken:d.z.string().min(1).describe("Meta access token for Conversions API authentication (like your_access_token)"),pixelId:d.z.string().regex(/^[0-9]+$/,"Pixel ID must contain only digits").describe("Meta Pixel ID from your Facebook Business account (like 1234567890)"),action_source:p.describe("Source of the event (website, app, phone_call, etc.) (like website)").optional(),doNotHash:d.z.array(d.z.string()).describe("Array of user_data fields that should not be hashed (like ['client_ip_address', 'client_user_agent'])").optional(),test_event_code:d.z.string().describe("Test event code for debugging Meta Conversions API events (like TEST12345)").optional(),url:d.z.string().url().describe("Custom URL for Meta Conversions API endpoint (like https://graph.facebook.com/v17.0)").optional(),user_data:d.z.record(d.z.string(),d.z.string()).describe("Mapping configuration for user data fields (like { email: 'user.email', phone: 'user.phone' })").optional()}),v=require("@walkeros/core/dev").z.object({}),h=(0,c.zodToSchema)(m),_=(0,c.zodToSchema)(v),b={};o(b,{env:()=>f,step:()=>k});var f={};o(f,{push:()=>g,simulation:()=>y});var g={sendServer:async function(e,t,r){return{ok:!0,data:{events_received:1,messages:[],fbtrace_id:"mock-trace-id"}}}},y=["sendServer"],k={};o(k,{lead:()=>x,purchase:()=>w,purchaseWithClickAttribution:()=>z});var S=require("@walkeros/core"),P="https://graph.facebook.com/v22.0/p1x3l1d/events?access_token=s3cr3t",w={title:"Purchase",description:"A completed order is sent to the Meta Conversions API as a Purchase event with value, currency, and contents.",in:(0,S.getEvent)("order complete",{timestamp:1700000900,data:{id:"ORD-300",total:249.99,currency:"EUR"},nested:[{entity:"product",data:{id:"SKU-A1",price:129.99,quantity:2}}],user:{id:"user-123",device:"device-456"},source:{type:"server",id:"https://shop.example.com",previous_id:""}}),mapping:{name:"Purchase",data:{map:{order_id:"data.id",currency:{key:"data.currency",value:"EUR"},value:"data.total",contents:{loop:["nested",{condition:e=>(0,S.isObject)(e)&&"product"===e.entity,map:{id:"data.id",item_price:"data.price",quantity:{key:"data.quantity",value:1}}}]},num_items:{fn:e=>e.nested.filter(e=>"product"===e.entity).length}}}},out:[["sendServer",P,JSON.stringify({data:[{event_name:"Purchase",event_id:"1700000900-gr0up-1",event_time:1700001,action_source:"website",order_id:"ORD-300",currency:"EUR",value:249.99,contents:[{id:"SKU-A1",item_price:129.99,quantity:2}],num_items:1,user_data:{},event_source_url:"https://shop.example.com"}]})]]},x={title:"Form submit",description:"A form submission is forwarded to Meta CAPI as a custom event with the event source URL.",in:(0,S.getEvent)("form submit",{timestamp:1700000901,data:{type:"newsletter"},user:{email:"user@example.com"},source:{type:"server",id:"https://example.com",previous_id:""}}),mapping:void 0,out:[["sendServer",P,JSON.stringify({data:[{event_name:"form submit",event_id:"1700000901-gr0up-1",event_time:1700001,action_source:"website",user_data:{},event_source_url:"https://example.com"}]})]]},z={title:"Purchase with fbclid",description:"A purchase is sent to Meta CAPI with an external_id and a formatted fbc click id for ads attribution.",in:(0,S.getEvent)("order complete",{timestamp:1700000902,data:{id:"ORD-700",total:89.99,currency:"USD"},user:{id:"cust-42"},context:{fbclid:["abc123xyz",0]},source:{type:"server",id:"https://shop.example.com",previous_id:""}}),mapping:{name:"Purchase",data:{map:{currency:{key:"data.currency",value:"EUR"},value:"data.total",order_id:"data.id",user_data:{map:{external_id:"user.id",fbclid:"context.fbclid"}}}}},out:[["sendServer",P,JSON.stringify({data:[{event_name:"Purchase",event_id:"1700000902-gr0up-1",event_time:1700001,action_source:"website",currency:"USD",value:89.99,order_id:"ORD-700",user_data:{external_id:"8a3c5a67cad508582b5edf6b8352cea3ffbad7f44812c1a736b4444c0f5746aa",fbc:"fb.1.1700000902.abc123xyz,0"},event_source_url:"https://shop.example.com"}]})]]};//# sourceMappingURL=dev.js.map

package/dist/dev.js.map

@@ -1 +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 { ActionSourceSchema } from './primitives';\n\nexport const SettingsSchema = z.object({\n  accessToken: z\n    .string()\n    .min(1)\n    .describe(\n      'Meta access token for Conversions API authentication (like your_access_token)',\n    ),\n  pixelId: z\n    .string()\n    .regex(/^[0-9]+$/, 'Pixel ID must contain only digits')\n    .describe(\n      'Meta Pixel ID from your Facebook Business account (like 1234567890)',\n    ),\n  action_source: ActionSourceSchema.describe(\n    'Source of the event (website, app, phone_call, etc.) (like website)',\n  ).optional(),\n  doNotHash: z\n    .array(z.string())\n    .describe(\n      \"Array of user_data fields that should not be hashed (like ['client_ip_address', 'client_user_agent'])\",\n    )\n    .optional(),\n  test_event_code: z\n    .string()\n    .describe(\n      'Test event code for debugging Meta Conversions API events (like TEST12345)',\n    )\n    .optional(),\n  url: z\n    .string()\n    .url()\n    .describe(\n      'Custom URL for Meta Conversions API endpoint (like https://graph.facebook.com/v17.0)',\n    )\n    .optional(),\n  user_data: z\n    .record(z.string(), z.string())\n    .describe(\n      \"Mapping configuration for user data fields (like { email: 'user.email', phone: 'user.phone' })\",\n    )\n    .optional(),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { z } from '@walkeros/core/dev';\n\n/**\n * Action Source Enum\n * Where the conversion event took place\n * https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/server-event\n */\nexport const ActionSourceSchema = z.enum([\n  'email',\n  'website',\n  'app',\n  'phone_call',\n  'chat',\n  'physical_store',\n  'system_generated',\n  'business_messaging',\n  'other',\n]);\n\n/**\n * Event Name\n * Standard Meta event names or custom event identifiers\n */\nexport const EventNameSchema = z.union([\n  z.enum([\n    'AddPaymentInfo',\n    'AddToCart',\n    'AddToWishlist',\n    'CompleteRegistration',\n    'Contact',\n    'CustomizeProduct',\n    'Donate',\n    'FindLocation',\n    'InitiateCheckout',\n    'Lead',\n    'Purchase',\n    'Schedule',\n    'Search',\n    'StartTrial',\n    'SubmitApplication',\n    'Subscribe',\n    'ViewContent',\n  ]),\n  z.string(), // Allow custom event names\n]);\n","import { z } from '@walkeros/core/dev';\n\n/**\n * Meta Conversions API Mapping Schema\n * Meta 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","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 Meta Conversions API destination\n *\n * These environments provide standardized mock structures for testing\n * and development without requiring actual HTTP requests.\n */\n\n/**\n * Mock sendServer function that simulates successful HTTP responses\n */\nasync function mockSendServer(\n  url: string,\n  data?: SendDataValue,\n  options?: SendServerOptions,\n): Promise<SendResponse> {\n  // Simulate successful Meta API response\n  return {\n    ok: true,\n    data: {\n      events_received: 1,\n      messages: [],\n      fbtrace_id: 'mock-trace-id',\n    },\n  };\n}\n\n/**\n * Standard mock environment for push operations\n *\n * Use this for testing Meta Conversions API events without making\n * actual HTTP requests to Facebook's servers.\n */\nexport const push: Env = {\n  sendServer: mockSendServer,\n};\n\nexport const simulation = ['sendServer'];\n","import type { Flow, WalkerOS } from '@walkeros/core';\nimport { getEvent, isObject } from '@walkeros/core';\n\n/**\n * Meta Conversions API step examples.\n *\n * At push time, the destination calls `env.sendServer(url, body)` where\n * `url` is `${settings.url}${settings.pixelId}/events?access_token=${settings.accessToken}`\n * and `body` is the JSON-stringified `{ data: [serverEvent] }` payload.\n *\n * The public name users see when inspecting the destination is `sendServer`,\n * so each `out` tuple is `['sendServer', url, body]` with `body` as the\n * already-stringified JSON payload (mirroring the actual call signature).\n *\n * The test fixture pins `accessToken = 's3cr3t'` and `pixelId = 'p1x3l1d'`,\n * so every endpoint resolves to:\n *   https://graph.facebook.com/v22.0/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_id\n *   3. event_time (unix seconds; `Math.round(event.timestamp / 1000)`)\n *   4. action_source\n *   5. ...mapped event data (currency, value, etc.)\n *   6. user_data (hashed per Meta's PII requirements)\n *   7. event_source_url (appended after hash when action_source === 'website')\n */\nconst ENDPOINT =\n  'https://graph.facebook.com/v22.0/p1x3l1d/events?access_token=s3cr3t';\n\nexport const purchase: Flow.StepExample = {\n  in: getEvent('order complete', {\n    timestamp: 1700000900,\n    data: { id: 'ORD-300', total: 249.99, currency: 'EUR' },\n    nested: [\n      { entity: 'product', data: { id: 'SKU-A1', price: 129.99, quantity: 2 } },\n    ],\n    user: { id: 'user-123', device: 'device-456' },\n    source: { type: 'server', id: 'https://shop.example.com', previous_id: '' },\n  }),\n  mapping: {\n    name: 'Purchase',\n    data: {\n      map: {\n        order_id: 'data.id',\n        currency: { key: 'data.currency', value: 'EUR' },\n        value: 'data.total',\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        num_items: {\n          fn: (event: unknown) =>\n            (event as WalkerOS.Event).nested.filter(\n              (item) => item.entity === 'product',\n            ).length,\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'sendServer',\n      ENDPOINT,\n      JSON.stringify({\n        data: [\n          {\n            event_name: 'Purchase',\n            event_id: '1700000900-gr0up-1',\n            event_time: 1700001,\n            action_source: 'website',\n            order_id: 'ORD-300',\n            currency: 'EUR',\n            value: 249.99,\n            contents: [{ id: 'SKU-A1', item_price: 129.99, quantity: 2 }],\n            num_items: 1,\n            user_data: {},\n            event_source_url: 'https://shop.example.com',\n          },\n        ],\n      }),\n    ],\n  ],\n};\n\nexport const lead: Flow.StepExample = {\n  in: getEvent('form submit', {\n    timestamp: 1700000901,\n    data: { type: 'newsletter' },\n    user: { email: 'user@example.com' },\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        data: [\n          {\n            event_name: 'form submit',\n            event_id: '1700000901-gr0up-1',\n            event_time: 1700001,\n            action_source: 'website',\n            user_data: {},\n            event_source_url: 'https://example.com',\n          },\n        ],\n      }),\n    ],\n  ],\n};\n\nexport const purchaseWithClickAttribution: Flow.StepExample = {\n  in: getEvent('order complete', {\n    timestamp: 1700000902,\n    data: { id: 'ORD-700', total: 89.99, currency: 'USD' },\n    user: { id: 'cust-42' },\n    context: { fbclid: ['abc123xyz', 0] },\n    source: { type: 'server', id: 'https://shop.example.com', previous_id: '' },\n  }),\n  mapping: {\n    name: 'Purchase',\n    data: {\n      map: {\n        currency: { key: 'data.currency', value: 'EUR' },\n        value: 'data.total',\n        order_id: 'data.id',\n        user_data: {\n          map: {\n            external_id: 'user.id',\n            fbclid: 'context.fbclid',\n          },\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'sendServer',\n      ENDPOINT,\n      JSON.stringify({\n        data: [\n          {\n            event_name: 'Purchase',\n            event_id: '1700000902-gr0up-1',\n            event_time: 1700001,\n            action_source: 'website',\n            currency: 'USD',\n            value: 89.99,\n            order_id: 'ORD-700',\n            user_data: {\n              // sha256('cust-42')\n              external_id:\n                '8a3c5a67cad508582b5edf6b8352cea3ffbad7f44812c1a736b4444c0f5746aa',\n              // formatClickId(['abc123xyz', 0], event.timestamp) — array joins\n              // to 'abc123xyz,0' when coerced to string inside the template.\n              fbc: 'fb.1.1700000902.abc123xyz,0',\n            },\n            event_source_url: 'https://shop.example.com',\n          },\n        ],\n      }),\n    ],\n  ],\n};\n"],"mappings":"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","names":["import_dev","import_dev","import_dev"]}
+{"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 { ActionSourceSchema } from './primitives';\n\nexport const SettingsSchema = z.object({\n  accessToken: z\n    .string()\n    .min(1)\n    .describe(\n      'Meta access token for Conversions API authentication (like your_access_token)',\n    ),\n  pixelId: z\n    .string()\n    .regex(/^[0-9]+$/, 'Pixel ID must contain only digits')\n    .describe(\n      'Meta Pixel ID from your Facebook Business account (like 1234567890)',\n    ),\n  action_source: ActionSourceSchema.describe(\n    'Source of the event (website, app, phone_call, etc.) (like website)',\n  ).optional(),\n  doNotHash: z\n    .array(z.string())\n    .describe(\n      \"Array of user_data fields that should not be hashed (like ['client_ip_address', 'client_user_agent'])\",\n    )\n    .optional(),\n  test_event_code: z\n    .string()\n    .describe(\n      'Test event code for debugging Meta Conversions API events (like TEST12345)',\n    )\n    .optional(),\n  url: z\n    .string()\n    .url()\n    .describe(\n      'Custom URL for Meta Conversions API endpoint (like https://graph.facebook.com/v17.0)',\n    )\n    .optional(),\n  user_data: z\n    .record(z.string(), z.string())\n    .describe(\n      \"Mapping configuration for user data fields (like { email: 'user.email', phone: 'user.phone' })\",\n    )\n    .optional(),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { z } from '@walkeros/core/dev';\n\n/**\n * Action Source Enum\n * Where the conversion event took place\n * https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/server-event\n */\nexport const ActionSourceSchema = z.enum([\n  'email',\n  'website',\n  'app',\n  'phone_call',\n  'chat',\n  'physical_store',\n  'system_generated',\n  'business_messaging',\n  'other',\n]);\n\n/**\n * Event Name\n * Standard Meta event names or custom event identifiers\n */\nexport const EventNameSchema = z.union([\n  z.enum([\n    'AddPaymentInfo',\n    'AddToCart',\n    'AddToWishlist',\n    'CompleteRegistration',\n    'Contact',\n    'CustomizeProduct',\n    'Donate',\n    'FindLocation',\n    'InitiateCheckout',\n    'Lead',\n    'Purchase',\n    'Schedule',\n    'Search',\n    'StartTrial',\n    'SubmitApplication',\n    'Subscribe',\n    'ViewContent',\n  ]),\n  z.string(), // Allow custom event names\n]);\n","import { z } from '@walkeros/core/dev';\n\n/**\n * Meta Conversions API Mapping Schema\n * Meta 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","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 Meta Conversions API destination\n *\n * These environments provide standardized mock structures for testing\n * and development without requiring actual HTTP requests.\n */\n\n/**\n * Mock sendServer function that simulates successful HTTP responses\n */\nasync function mockSendServer(\n  url: string,\n  data?: SendDataValue,\n  options?: SendServerOptions,\n): Promise<SendResponse> {\n  // Simulate successful Meta API response\n  return {\n    ok: true,\n    data: {\n      events_received: 1,\n      messages: [],\n      fbtrace_id: 'mock-trace-id',\n    },\n  };\n}\n\n/**\n * Standard mock environment for push operations\n *\n * Use this for testing Meta Conversions API events without making\n * actual HTTP requests to Facebook's servers.\n */\nexport const push: Env = {\n  sendServer: mockSendServer,\n};\n\nexport const simulation = ['sendServer'];\n","import type { Flow, WalkerOS } from '@walkeros/core';\nimport { getEvent, isObject } from '@walkeros/core';\n\n/**\n * Meta Conversions API step examples.\n *\n * At push time, the destination calls `env.sendServer(url, body)` where\n * `url` is `${settings.url}${settings.pixelId}/events?access_token=${settings.accessToken}`\n * and `body` is the JSON-stringified `{ data: [serverEvent] }` payload.\n *\n * The public name users see when inspecting the destination is `sendServer`,\n * so each `out` tuple is `['sendServer', url, body]` with `body` as the\n * already-stringified JSON payload (mirroring the actual call signature).\n *\n * The test fixture pins `accessToken = 's3cr3t'` and `pixelId = 'p1x3l1d'`,\n * so every endpoint resolves to:\n *   https://graph.facebook.com/v22.0/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_id\n *   3. event_time (unix seconds; `Math.round(event.timestamp / 1000)`)\n *   4. action_source\n *   5. ...mapped event data (currency, value, etc.)\n *   6. user_data (hashed per Meta's PII requirements)\n *   7. event_source_url (appended after hash when action_source === 'website')\n */\nconst ENDPOINT =\n  'https://graph.facebook.com/v22.0/p1x3l1d/events?access_token=s3cr3t';\n\nexport const purchase: Flow.StepExample = {\n  title: 'Purchase',\n  description:\n    'A completed order is sent to the Meta Conversions API as a Purchase event with value, currency, and contents.',\n  in: getEvent('order complete', {\n    timestamp: 1700000900,\n    data: { id: 'ORD-300', total: 249.99, currency: 'EUR' },\n    nested: [\n      { entity: 'product', data: { id: 'SKU-A1', price: 129.99, quantity: 2 } },\n    ],\n    user: { id: 'user-123', device: 'device-456' },\n    source: { type: 'server', id: 'https://shop.example.com', previous_id: '' },\n  }),\n  mapping: {\n    name: 'Purchase',\n    data: {\n      map: {\n        order_id: 'data.id',\n        currency: { key: 'data.currency', value: 'EUR' },\n        value: 'data.total',\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        num_items: {\n          fn: (event: unknown) =>\n            (event as WalkerOS.Event).nested.filter(\n              (item) => item.entity === 'product',\n            ).length,\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'sendServer',\n      ENDPOINT,\n      JSON.stringify({\n        data: [\n          {\n            event_name: 'Purchase',\n            event_id: '1700000900-gr0up-1',\n            event_time: 1700001,\n            action_source: 'website',\n            order_id: 'ORD-300',\n            currency: 'EUR',\n            value: 249.99,\n            contents: [{ id: 'SKU-A1', item_price: 129.99, quantity: 2 }],\n            num_items: 1,\n            user_data: {},\n            event_source_url: 'https://shop.example.com',\n          },\n        ],\n      }),\n    ],\n  ],\n};\n\nexport const lead: Flow.StepExample = {\n  title: 'Form submit',\n  description:\n    'A form submission is forwarded to Meta CAPI as a custom event with the event source URL.',\n  in: getEvent('form submit', {\n    timestamp: 1700000901,\n    data: { type: 'newsletter' },\n    user: { email: 'user@example.com' },\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        data: [\n          {\n            event_name: 'form submit',\n            event_id: '1700000901-gr0up-1',\n            event_time: 1700001,\n            action_source: 'website',\n            user_data: {},\n            event_source_url: 'https://example.com',\n          },\n        ],\n      }),\n    ],\n  ],\n};\n\nexport const purchaseWithClickAttribution: Flow.StepExample = {\n  title: 'Purchase with fbclid',\n  description:\n    'A purchase is sent to Meta CAPI with an external_id and a formatted fbc click id for ads attribution.',\n  in: getEvent('order complete', {\n    timestamp: 1700000902,\n    data: { id: 'ORD-700', total: 89.99, currency: 'USD' },\n    user: { id: 'cust-42' },\n    context: { fbclid: ['abc123xyz', 0] },\n    source: { type: 'server', id: 'https://shop.example.com', previous_id: '' },\n  }),\n  mapping: {\n    name: 'Purchase',\n    data: {\n      map: {\n        currency: { key: 'data.currency', value: 'EUR' },\n        value: 'data.total',\n        order_id: 'data.id',\n        user_data: {\n          map: {\n            external_id: 'user.id',\n            fbclid: 'context.fbclid',\n          },\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'sendServer',\n      ENDPOINT,\n      JSON.stringify({\n        data: [\n          {\n            event_name: 'Purchase',\n            event_id: '1700000902-gr0up-1',\n            event_time: 1700001,\n            action_source: 'website',\n            currency: 'USD',\n            value: 89.99,\n            order_id: 'ORD-700',\n            user_data: {\n              // sha256('cust-42')\n              external_id:\n                '8a3c5a67cad508582b5edf6b8352cea3ffbad7f44812c1a736b4444c0f5746aa',\n              // formatClickId(['abc123xyz', 0], event.timestamp) — array joins\n              // to 'abc123xyz,0' when coerced to string inside the template.\n              fbc: 'fb.1.1700000902.abc123xyz,0',\n            },\n            event_source_url: 'https://shop.example.com',\n          },\n        ],\n      }),\n    ],\n  ],\n};\n"],"mappings":"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","names":["import_dev","import_dev","import_dev"]}

package/dist/dev.mjs

@@ -1 +1 @@
-var e=Object.defineProperty,t=(t,a)=>{for(var r in a)e(t,r,{get:a[r],enumerable:!0})},a={};t(a,{ActionSourceSchema:()=>s,EventNameSchema:()=>n,MappingSchema:()=>u,SettingsSchema:()=>c,mapping:()=>m,settings:()=>p});import{zodToSchema as r}from"@walkeros/core/dev";import{z as i}from"@walkeros/core/dev";import{z as o}from"@walkeros/core/dev";var s=o.enum(["email","website","app","phone_call","chat","physical_store","system_generated","business_messaging","other"]),n=o.union([o.enum(["AddPaymentInfo","AddToCart","AddToWishlist","CompleteRegistration","Contact","CustomizeProduct","Donate","FindLocation","InitiateCheckout","Lead","Purchase","Schedule","Search","StartTrial","SubmitApplication","Subscribe","ViewContent"]),o.string()]),c=i.object({accessToken:i.string().min(1).describe("Meta access token for Conversions API authentication (like your_access_token)"),pixelId:i.string().regex(/^[0-9]+$/,"Pixel ID must contain only digits").describe("Meta Pixel ID from your Facebook Business account (like 1234567890)"),action_source:s.describe("Source of the event (website, app, phone_call, etc.) (like website)").optional(),doNotHash:i.array(i.string()).describe("Array of user_data fields that should not be hashed (like ['client_ip_address', 'client_user_agent'])").optional(),test_event_code:i.string().describe("Test event code for debugging Meta Conversions API events (like TEST12345)").optional(),url:i.string().url().describe("Custom URL for Meta Conversions API endpoint (like https://graph.facebook.com/v17.0)").optional(),user_data:i.record(i.string(),i.string()).describe("Mapping configuration for user data fields (like { email: 'user.email', phone: 'user.phone' })").optional()});import{z as d}from"@walkeros/core/dev";var u=d.object({}),p=r(c),m=r(u),l={};t(l,{env:()=>v,step:()=>b});var v={};t(v,{push:()=>_,simulation:()=>h});var _={sendServer:async function(e,t,a){return{ok:!0,data:{events_received:1,messages:[],fbtrace_id:"mock-trace-id"}}}},h=["sendServer"],b={};t(b,{lead:()=>S,purchase:()=>k,purchaseWithClickAttribution:()=>x});import{getEvent as f,isObject as g}from"@walkeros/core";var y="https://graph.facebook.com/v22.0/p1x3l1d/events?access_token=s3cr3t",k={in:f("order complete",{timestamp:1700000900,data:{id:"ORD-300",total:249.99,currency:"EUR"},nested:[{entity:"product",data:{id:"SKU-A1",price:129.99,quantity:2}}],user:{id:"user-123",device:"device-456"},source:{type:"server",id:"https://shop.example.com",previous_id:""}}),mapping:{name:"Purchase",data:{map:{order_id:"data.id",currency:{key:"data.currency",value:"EUR"},value:"data.total",contents:{loop:["nested",{condition:e=>g(e)&&"product"===e.entity,map:{id:"data.id",item_price:"data.price",quantity:{key:"data.quantity",value:1}}}]},num_items:{fn:e=>e.nested.filter(e=>"product"===e.entity).length}}}},out:[["sendServer",y,JSON.stringify({data:[{event_name:"Purchase",event_id:"1700000900-gr0up-1",event_time:1700001,action_source:"website",order_id:"ORD-300",currency:"EUR",value:249.99,contents:[{id:"SKU-A1",item_price:129.99,quantity:2}],num_items:1,user_data:{},event_source_url:"https://shop.example.com"}]})]]},S={in:f("form submit",{timestamp:1700000901,data:{type:"newsletter"},user:{email:"user@example.com"},source:{type:"server",id:"https://example.com",previous_id:""}}),mapping:void 0,out:[["sendServer",y,JSON.stringify({data:[{event_name:"form submit",event_id:"1700000901-gr0up-1",event_time:1700001,action_source:"website",user_data:{},event_source_url:"https://example.com"}]})]]},x={in:f("order complete",{timestamp:1700000902,data:{id:"ORD-700",total:89.99,currency:"USD"},user:{id:"cust-42"},context:{fbclid:["abc123xyz",0]},source:{type:"server",id:"https://shop.example.com",previous_id:""}}),mapping:{name:"Purchase",data:{map:{currency:{key:"data.currency",value:"EUR"},value:"data.total",order_id:"data.id",user_data:{map:{external_id:"user.id",fbclid:"context.fbclid"}}}}},out:[["sendServer",y,JSON.stringify({data:[{event_name:"Purchase",event_id:"1700000902-gr0up-1",event_time:1700001,action_source:"website",currency:"USD",value:89.99,order_id:"ORD-700",user_data:{external_id:"8a3c5a67cad508582b5edf6b8352cea3ffbad7f44812c1a736b4444c0f5746aa",fbc:"fb.1.1700000902.abc123xyz,0"},event_source_url:"https://shop.example.com"}]})]]};export{l as examples,a as schemas};//# sourceMappingURL=dev.mjs.map
+var e=Object.defineProperty,t=(t,a)=>{for(var r in a)e(t,r,{get:a[r],enumerable:!0})},a={};t(a,{ActionSourceSchema:()=>o,EventNameSchema:()=>n,MappingSchema:()=>u,SettingsSchema:()=>c,mapping:()=>m,settings:()=>p});import{zodToSchema as r}from"@walkeros/core/dev";import{z as i}from"@walkeros/core/dev";import{z as s}from"@walkeros/core/dev";var o=s.enum(["email","website","app","phone_call","chat","physical_store","system_generated","business_messaging","other"]),n=s.union([s.enum(["AddPaymentInfo","AddToCart","AddToWishlist","CompleteRegistration","Contact","CustomizeProduct","Donate","FindLocation","InitiateCheckout","Lead","Purchase","Schedule","Search","StartTrial","SubmitApplication","Subscribe","ViewContent"]),s.string()]),c=i.object({accessToken:i.string().min(1).describe("Meta access token for Conversions API authentication (like your_access_token)"),pixelId:i.string().regex(/^[0-9]+$/,"Pixel ID must contain only digits").describe("Meta Pixel ID from your Facebook Business account (like 1234567890)"),action_source:o.describe("Source of the event (website, app, phone_call, etc.) (like website)").optional(),doNotHash:i.array(i.string()).describe("Array of user_data fields that should not be hashed (like ['client_ip_address', 'client_user_agent'])").optional(),test_event_code:i.string().describe("Test event code for debugging Meta Conversions API events (like TEST12345)").optional(),url:i.string().url().describe("Custom URL for Meta Conversions API endpoint (like https://graph.facebook.com/v17.0)").optional(),user_data:i.record(i.string(),i.string()).describe("Mapping configuration for user data fields (like { email: 'user.email', phone: 'user.phone' })").optional()});import{z as d}from"@walkeros/core/dev";var u=d.object({}),p=r(c),m=r(u),l={};t(l,{env:()=>v,step:()=>b});var v={};t(v,{push:()=>h,simulation:()=>_});var h={sendServer:async function(e,t,a){return{ok:!0,data:{events_received:1,messages:[],fbtrace_id:"mock-trace-id"}}}},_=["sendServer"],b={};t(b,{lead:()=>S,purchase:()=>k,purchaseWithClickAttribution:()=>x});import{getEvent as f,isObject as g}from"@walkeros/core";var y="https://graph.facebook.com/v22.0/p1x3l1d/events?access_token=s3cr3t",k={title:"Purchase",description:"A completed order is sent to the Meta Conversions API as a Purchase event with value, currency, and contents.",in:f("order complete",{timestamp:1700000900,data:{id:"ORD-300",total:249.99,currency:"EUR"},nested:[{entity:"product",data:{id:"SKU-A1",price:129.99,quantity:2}}],user:{id:"user-123",device:"device-456"},source:{type:"server",id:"https://shop.example.com",previous_id:""}}),mapping:{name:"Purchase",data:{map:{order_id:"data.id",currency:{key:"data.currency",value:"EUR"},value:"data.total",contents:{loop:["nested",{condition:e=>g(e)&&"product"===e.entity,map:{id:"data.id",item_price:"data.price",quantity:{key:"data.quantity",value:1}}}]},num_items:{fn:e=>e.nested.filter(e=>"product"===e.entity).length}}}},out:[["sendServer",y,JSON.stringify({data:[{event_name:"Purchase",event_id:"1700000900-gr0up-1",event_time:1700001,action_source:"website",order_id:"ORD-300",currency:"EUR",value:249.99,contents:[{id:"SKU-A1",item_price:129.99,quantity:2}],num_items:1,user_data:{},event_source_url:"https://shop.example.com"}]})]]},S={title:"Form submit",description:"A form submission is forwarded to Meta CAPI as a custom event with the event source URL.",in:f("form submit",{timestamp:1700000901,data:{type:"newsletter"},user:{email:"user@example.com"},source:{type:"server",id:"https://example.com",previous_id:""}}),mapping:void 0,out:[["sendServer",y,JSON.stringify({data:[{event_name:"form submit",event_id:"1700000901-gr0up-1",event_time:1700001,action_source:"website",user_data:{},event_source_url:"https://example.com"}]})]]},x={title:"Purchase with fbclid",description:"A purchase is sent to Meta CAPI with an external_id and a formatted fbc click id for ads attribution.",in:f("order complete",{timestamp:1700000902,data:{id:"ORD-700",total:89.99,currency:"USD"},user:{id:"cust-42"},context:{fbclid:["abc123xyz",0]},source:{type:"server",id:"https://shop.example.com",previous_id:""}}),mapping:{name:"Purchase",data:{map:{currency:{key:"data.currency",value:"EUR"},value:"data.total",order_id:"data.id",user_data:{map:{external_id:"user.id",fbclid:"context.fbclid"}}}}},out:[["sendServer",y,JSON.stringify({data:[{event_name:"Purchase",event_id:"1700000902-gr0up-1",event_time:1700001,action_source:"website",currency:"USD",value:89.99,order_id:"ORD-700",user_data:{external_id:"8a3c5a67cad508582b5edf6b8352cea3ffbad7f44812c1a736b4444c0f5746aa",fbc:"fb.1.1700000902.abc123xyz,0"},event_source_url:"https://shop.example.com"}]})]]};export{l as examples,a as schemas};//# sourceMappingURL=dev.mjs.map

package/dist/dev.mjs.map

@@ -1 +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 { ActionSourceSchema } from './primitives';\n\nexport const SettingsSchema = z.object({\n  accessToken: z\n    .string()\n    .min(1)\n    .describe(\n      'Meta access token for Conversions API authentication (like your_access_token)',\n    ),\n  pixelId: z\n    .string()\n    .regex(/^[0-9]+$/, 'Pixel ID must contain only digits')\n    .describe(\n      'Meta Pixel ID from your Facebook Business account (like 1234567890)',\n    ),\n  action_source: ActionSourceSchema.describe(\n    'Source of the event (website, app, phone_call, etc.) (like website)',\n  ).optional(),\n  doNotHash: z\n    .array(z.string())\n    .describe(\n      \"Array of user_data fields that should not be hashed (like ['client_ip_address', 'client_user_agent'])\",\n    )\n    .optional(),\n  test_event_code: z\n    .string()\n    .describe(\n      'Test event code for debugging Meta Conversions API events (like TEST12345)',\n    )\n    .optional(),\n  url: z\n    .string()\n    .url()\n    .describe(\n      'Custom URL for Meta Conversions API endpoint (like https://graph.facebook.com/v17.0)',\n    )\n    .optional(),\n  user_data: z\n    .record(z.string(), z.string())\n    .describe(\n      \"Mapping configuration for user data fields (like { email: 'user.email', phone: 'user.phone' })\",\n    )\n    .optional(),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { z } from '@walkeros/core/dev';\n\n/**\n * Action Source Enum\n * Where the conversion event took place\n * https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/server-event\n */\nexport const ActionSourceSchema = z.enum([\n  'email',\n  'website',\n  'app',\n  'phone_call',\n  'chat',\n  'physical_store',\n  'system_generated',\n  'business_messaging',\n  'other',\n]);\n\n/**\n * Event Name\n * Standard Meta event names or custom event identifiers\n */\nexport const EventNameSchema = z.union([\n  z.enum([\n    'AddPaymentInfo',\n    'AddToCart',\n    'AddToWishlist',\n    'CompleteRegistration',\n    'Contact',\n    'CustomizeProduct',\n    'Donate',\n    'FindLocation',\n    'InitiateCheckout',\n    'Lead',\n    'Purchase',\n    'Schedule',\n    'Search',\n    'StartTrial',\n    'SubmitApplication',\n    'Subscribe',\n    'ViewContent',\n  ]),\n  z.string(), // Allow custom event names\n]);\n","import { z } from '@walkeros/core/dev';\n\n/**\n * Meta Conversions API Mapping Schema\n * Meta 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","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 Meta Conversions API destination\n *\n * These environments provide standardized mock structures for testing\n * and development without requiring actual HTTP requests.\n */\n\n/**\n * Mock sendServer function that simulates successful HTTP responses\n */\nasync function mockSendServer(\n  url: string,\n  data?: SendDataValue,\n  options?: SendServerOptions,\n): Promise<SendResponse> {\n  // Simulate successful Meta API response\n  return {\n    ok: true,\n    data: {\n      events_received: 1,\n      messages: [],\n      fbtrace_id: 'mock-trace-id',\n    },\n  };\n}\n\n/**\n * Standard mock environment for push operations\n *\n * Use this for testing Meta Conversions API events without making\n * actual HTTP requests to Facebook's servers.\n */\nexport const push: Env = {\n  sendServer: mockSendServer,\n};\n\nexport const simulation = ['sendServer'];\n","import type { Flow, WalkerOS } from '@walkeros/core';\nimport { getEvent, isObject } from '@walkeros/core';\n\n/**\n * Meta Conversions API step examples.\n *\n * At push time, the destination calls `env.sendServer(url, body)` where\n * `url` is `${settings.url}${settings.pixelId}/events?access_token=${settings.accessToken}`\n * and `body` is the JSON-stringified `{ data: [serverEvent] }` payload.\n *\n * The public name users see when inspecting the destination is `sendServer`,\n * so each `out` tuple is `['sendServer', url, body]` with `body` as the\n * already-stringified JSON payload (mirroring the actual call signature).\n *\n * The test fixture pins `accessToken = 's3cr3t'` and `pixelId = 'p1x3l1d'`,\n * so every endpoint resolves to:\n *   https://graph.facebook.com/v22.0/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_id\n *   3. event_time (unix seconds; `Math.round(event.timestamp / 1000)`)\n *   4. action_source\n *   5. ...mapped event data (currency, value, etc.)\n *   6. user_data (hashed per Meta's PII requirements)\n *   7. event_source_url (appended after hash when action_source === 'website')\n */\nconst ENDPOINT =\n  'https://graph.facebook.com/v22.0/p1x3l1d/events?access_token=s3cr3t';\n\nexport const purchase: Flow.StepExample = {\n  in: getEvent('order complete', {\n    timestamp: 1700000900,\n    data: { id: 'ORD-300', total: 249.99, currency: 'EUR' },\n    nested: [\n      { entity: 'product', data: { id: 'SKU-A1', price: 129.99, quantity: 2 } },\n    ],\n    user: { id: 'user-123', device: 'device-456' },\n    source: { type: 'server', id: 'https://shop.example.com', previous_id: '' },\n  }),\n  mapping: {\n    name: 'Purchase',\n    data: {\n      map: {\n        order_id: 'data.id',\n        currency: { key: 'data.currency', value: 'EUR' },\n        value: 'data.total',\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        num_items: {\n          fn: (event: unknown) =>\n            (event as WalkerOS.Event).nested.filter(\n              (item) => item.entity === 'product',\n            ).length,\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'sendServer',\n      ENDPOINT,\n      JSON.stringify({\n        data: [\n          {\n            event_name: 'Purchase',\n            event_id: '1700000900-gr0up-1',\n            event_time: 1700001,\n            action_source: 'website',\n            order_id: 'ORD-300',\n            currency: 'EUR',\n            value: 249.99,\n            contents: [{ id: 'SKU-A1', item_price: 129.99, quantity: 2 }],\n            num_items: 1,\n            user_data: {},\n            event_source_url: 'https://shop.example.com',\n          },\n        ],\n      }),\n    ],\n  ],\n};\n\nexport const lead: Flow.StepExample = {\n  in: getEvent('form submit', {\n    timestamp: 1700000901,\n    data: { type: 'newsletter' },\n    user: { email: 'user@example.com' },\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        data: [\n          {\n            event_name: 'form submit',\n            event_id: '1700000901-gr0up-1',\n            event_time: 1700001,\n            action_source: 'website',\n            user_data: {},\n            event_source_url: 'https://example.com',\n          },\n        ],\n      }),\n    ],\n  ],\n};\n\nexport const purchaseWithClickAttribution: Flow.StepExample = {\n  in: getEvent('order complete', {\n    timestamp: 1700000902,\n    data: { id: 'ORD-700', total: 89.99, currency: 'USD' },\n    user: { id: 'cust-42' },\n    context: { fbclid: ['abc123xyz', 0] },\n    source: { type: 'server', id: 'https://shop.example.com', previous_id: '' },\n  }),\n  mapping: {\n    name: 'Purchase',\n    data: {\n      map: {\n        currency: { key: 'data.currency', value: 'EUR' },\n        value: 'data.total',\n        order_id: 'data.id',\n        user_data: {\n          map: {\n            external_id: 'user.id',\n            fbclid: 'context.fbclid',\n          },\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'sendServer',\n      ENDPOINT,\n      JSON.stringify({\n        data: [\n          {\n            event_name: 'Purchase',\n            event_id: '1700000902-gr0up-1',\n            event_time: 1700001,\n            action_source: 'website',\n            currency: 'USD',\n            value: 89.99,\n            order_id: 'ORD-700',\n            user_data: {\n              // sha256('cust-42')\n              external_id:\n                '8a3c5a67cad508582b5edf6b8352cea3ffbad7f44812c1a736b4444c0f5746aa',\n              // formatClickId(['abc123xyz', 0], event.timestamp) — array joins\n              // to 'abc123xyz,0' when coerced to string inside the template.\n              fbc: 'fb.1.1700000902.abc123xyz,0',\n            },\n            event_source_url: 'https://shop.example.com',\n          },\n        ],\n      }),\n    ],\n  ],\n};\n"],"mappings":"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","names":["z","z","z"]}
+{"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 { ActionSourceSchema } from './primitives';\n\nexport const SettingsSchema = z.object({\n  accessToken: z\n    .string()\n    .min(1)\n    .describe(\n      'Meta access token for Conversions API authentication (like your_access_token)',\n    ),\n  pixelId: z\n    .string()\n    .regex(/^[0-9]+$/, 'Pixel ID must contain only digits')\n    .describe(\n      'Meta Pixel ID from your Facebook Business account (like 1234567890)',\n    ),\n  action_source: ActionSourceSchema.describe(\n    'Source of the event (website, app, phone_call, etc.) (like website)',\n  ).optional(),\n  doNotHash: z\n    .array(z.string())\n    .describe(\n      \"Array of user_data fields that should not be hashed (like ['client_ip_address', 'client_user_agent'])\",\n    )\n    .optional(),\n  test_event_code: z\n    .string()\n    .describe(\n      'Test event code for debugging Meta Conversions API events (like TEST12345)',\n    )\n    .optional(),\n  url: z\n    .string()\n    .url()\n    .describe(\n      'Custom URL for Meta Conversions API endpoint (like https://graph.facebook.com/v17.0)',\n    )\n    .optional(),\n  user_data: z\n    .record(z.string(), z.string())\n    .describe(\n      \"Mapping configuration for user data fields (like { email: 'user.email', phone: 'user.phone' })\",\n    )\n    .optional(),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { z } from '@walkeros/core/dev';\n\n/**\n * Action Source Enum\n * Where the conversion event took place\n * https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/server-event\n */\nexport const ActionSourceSchema = z.enum([\n  'email',\n  'website',\n  'app',\n  'phone_call',\n  'chat',\n  'physical_store',\n  'system_generated',\n  'business_messaging',\n  'other',\n]);\n\n/**\n * Event Name\n * Standard Meta event names or custom event identifiers\n */\nexport const EventNameSchema = z.union([\n  z.enum([\n    'AddPaymentInfo',\n    'AddToCart',\n    'AddToWishlist',\n    'CompleteRegistration',\n    'Contact',\n    'CustomizeProduct',\n    'Donate',\n    'FindLocation',\n    'InitiateCheckout',\n    'Lead',\n    'Purchase',\n    'Schedule',\n    'Search',\n    'StartTrial',\n    'SubmitApplication',\n    'Subscribe',\n    'ViewContent',\n  ]),\n  z.string(), // Allow custom event names\n]);\n","import { z } from '@walkeros/core/dev';\n\n/**\n * Meta Conversions API Mapping Schema\n * Meta 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","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 Meta Conversions API destination\n *\n * These environments provide standardized mock structures for testing\n * and development without requiring actual HTTP requests.\n */\n\n/**\n * Mock sendServer function that simulates successful HTTP responses\n */\nasync function mockSendServer(\n  url: string,\n  data?: SendDataValue,\n  options?: SendServerOptions,\n): Promise<SendResponse> {\n  // Simulate successful Meta API response\n  return {\n    ok: true,\n    data: {\n      events_received: 1,\n      messages: [],\n      fbtrace_id: 'mock-trace-id',\n    },\n  };\n}\n\n/**\n * Standard mock environment for push operations\n *\n * Use this for testing Meta Conversions API events without making\n * actual HTTP requests to Facebook's servers.\n */\nexport const push: Env = {\n  sendServer: mockSendServer,\n};\n\nexport const simulation = ['sendServer'];\n","import type { Flow, WalkerOS } from '@walkeros/core';\nimport { getEvent, isObject } from '@walkeros/core';\n\n/**\n * Meta Conversions API step examples.\n *\n * At push time, the destination calls `env.sendServer(url, body)` where\n * `url` is `${settings.url}${settings.pixelId}/events?access_token=${settings.accessToken}`\n * and `body` is the JSON-stringified `{ data: [serverEvent] }` payload.\n *\n * The public name users see when inspecting the destination is `sendServer`,\n * so each `out` tuple is `['sendServer', url, body]` with `body` as the\n * already-stringified JSON payload (mirroring the actual call signature).\n *\n * The test fixture pins `accessToken = 's3cr3t'` and `pixelId = 'p1x3l1d'`,\n * so every endpoint resolves to:\n *   https://graph.facebook.com/v22.0/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_id\n *   3. event_time (unix seconds; `Math.round(event.timestamp / 1000)`)\n *   4. action_source\n *   5. ...mapped event data (currency, value, etc.)\n *   6. user_data (hashed per Meta's PII requirements)\n *   7. event_source_url (appended after hash when action_source === 'website')\n */\nconst ENDPOINT =\n  'https://graph.facebook.com/v22.0/p1x3l1d/events?access_token=s3cr3t';\n\nexport const purchase: Flow.StepExample = {\n  title: 'Purchase',\n  description:\n    'A completed order is sent to the Meta Conversions API as a Purchase event with value, currency, and contents.',\n  in: getEvent('order complete', {\n    timestamp: 1700000900,\n    data: { id: 'ORD-300', total: 249.99, currency: 'EUR' },\n    nested: [\n      { entity: 'product', data: { id: 'SKU-A1', price: 129.99, quantity: 2 } },\n    ],\n    user: { id: 'user-123', device: 'device-456' },\n    source: { type: 'server', id: 'https://shop.example.com', previous_id: '' },\n  }),\n  mapping: {\n    name: 'Purchase',\n    data: {\n      map: {\n        order_id: 'data.id',\n        currency: { key: 'data.currency', value: 'EUR' },\n        value: 'data.total',\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        num_items: {\n          fn: (event: unknown) =>\n            (event as WalkerOS.Event).nested.filter(\n              (item) => item.entity === 'product',\n            ).length,\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'sendServer',\n      ENDPOINT,\n      JSON.stringify({\n        data: [\n          {\n            event_name: 'Purchase',\n            event_id: '1700000900-gr0up-1',\n            event_time: 1700001,\n            action_source: 'website',\n            order_id: 'ORD-300',\n            currency: 'EUR',\n            value: 249.99,\n            contents: [{ id: 'SKU-A1', item_price: 129.99, quantity: 2 }],\n            num_items: 1,\n            user_data: {},\n            event_source_url: 'https://shop.example.com',\n          },\n        ],\n      }),\n    ],\n  ],\n};\n\nexport const lead: Flow.StepExample = {\n  title: 'Form submit',\n  description:\n    'A form submission is forwarded to Meta CAPI as a custom event with the event source URL.',\n  in: getEvent('form submit', {\n    timestamp: 1700000901,\n    data: { type: 'newsletter' },\n    user: { email: 'user@example.com' },\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        data: [\n          {\n            event_name: 'form submit',\n            event_id: '1700000901-gr0up-1',\n            event_time: 1700001,\n            action_source: 'website',\n            user_data: {},\n            event_source_url: 'https://example.com',\n          },\n        ],\n      }),\n    ],\n  ],\n};\n\nexport const purchaseWithClickAttribution: Flow.StepExample = {\n  title: 'Purchase with fbclid',\n  description:\n    'A purchase is sent to Meta CAPI with an external_id and a formatted fbc click id for ads attribution.',\n  in: getEvent('order complete', {\n    timestamp: 1700000902,\n    data: { id: 'ORD-700', total: 89.99, currency: 'USD' },\n    user: { id: 'cust-42' },\n    context: { fbclid: ['abc123xyz', 0] },\n    source: { type: 'server', id: 'https://shop.example.com', previous_id: '' },\n  }),\n  mapping: {\n    name: 'Purchase',\n    data: {\n      map: {\n        currency: { key: 'data.currency', value: 'EUR' },\n        value: 'data.total',\n        order_id: 'data.id',\n        user_data: {\n          map: {\n            external_id: 'user.id',\n            fbclid: 'context.fbclid',\n          },\n        },\n      },\n    },\n  },\n  out: [\n    [\n      'sendServer',\n      ENDPOINT,\n      JSON.stringify({\n        data: [\n          {\n            event_name: 'Purchase',\n            event_id: '1700000902-gr0up-1',\n            event_time: 1700001,\n            action_source: 'website',\n            currency: 'USD',\n            value: 89.99,\n            order_id: 'ORD-700',\n            user_data: {\n              // sha256('cust-42')\n              external_id:\n                '8a3c5a67cad508582b5edf6b8352cea3ffbad7f44812c1a736b4444c0f5746aa',\n              // formatClickId(['abc123xyz', 0], event.timestamp) — array joins\n              // to 'abc123xyz,0' when coerced to string inside the template.\n              fbc: 'fb.1.1700000902.abc123xyz,0',\n            },\n            event_source_url: 'https://shop.example.com',\n          },\n        ],\n      }),\n    ],\n  ],\n};\n"],"mappings":"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","names":["z","z","z"]}

package/dist/examples/index.js

@@ -56,6 +56,8 @@ __export(step_exports, {
 var import_core = require("@walkeros/core");
 var ENDPOINT = "https://graph.facebook.com/v22.0/p1x3l1d/events?access_token=s3cr3t";
 var purchase = {
+  title: "Purchase",
+  description: "A completed order is sent to the Meta Conversions API as a Purchase event with value, currency, and contents.",
   in: (0, import_core.getEvent)("order complete", {
     timestamp: 1700000900,
     data: { id: "ORD-300", total: 249.99, currency: "EUR" },
@@ -118,6 +120,8 @@ var purchase = {
   ]
 };
 var lead = {
+  title: "Form submit",
+  description: "A form submission is forwarded to Meta CAPI as a custom event with the event source URL.",
   in: (0, import_core.getEvent)("form submit", {
     timestamp: 1700000901,
     data: { type: "newsletter" },
@@ -145,6 +149,8 @@ var lead = {
   ]
 };
 var purchaseWithClickAttribution = {
+  title: "Purchase with fbclid",
+  description: "A purchase is sent to Meta CAPI with an external_id and a formatted fbc click id for ads attribution.",
   in: (0, import_core.getEvent)("order complete", {
     timestamp: 1700000902,
     data: { id: "ORD-700", total: 89.99, currency: "USD" },

package/dist/examples/index.mjs

@@ -35,6 +35,8 @@ __export(step_exports, {
 import { getEvent, isObject } from "@walkeros/core";
 var ENDPOINT = "https://graph.facebook.com/v22.0/p1x3l1d/events?access_token=s3cr3t";
 var purchase = {
+  title: "Purchase",
+  description: "A completed order is sent to the Meta Conversions API as a Purchase event with value, currency, and contents.",
   in: getEvent("order complete", {
     timestamp: 1700000900,
     data: { id: "ORD-300", total: 249.99, currency: "EUR" },
@@ -97,6 +99,8 @@ var purchase = {
   ]
 };
 var lead = {
+  title: "Form submit",
+  description: "A form submission is forwarded to Meta CAPI as a custom event with the event source URL.",
   in: getEvent("form submit", {
     timestamp: 1700000901,
     data: { type: "newsletter" },
@@ -124,6 +128,8 @@ var lead = {
   ]
 };
 var purchaseWithClickAttribution = {
+  title: "Purchase with fbclid",
+  description: "A purchase is sent to Meta CAPI with an external_id and a formatted fbc click id for ads attribution.",
   in: getEvent("order complete", {
     timestamp: 1700000902,
     data: { id: "ORD-700", total: 89.99, currency: "USD" },

package/dist/walkerOS.json

@@ -1,7 +1,7 @@
 {
   "$meta": {
     "package": "@walkeros/server-destination-meta",
-    "version": "3.4.0",
+    "version": "3.4.1",
     "type": "destination",
     "platform": [
       "server"
@@ -92,6 +92,8 @@
     },
     "step": {
       "lead": {
+        "title": "Form submit",
+        "description": "A form submission is forwarded to Meta CAPI as a custom event with the event source URL.",
         "in": {
           "name": "form submit",
           "data": {
@@ -139,7 +141,7 @@
           "group": "gr0up",
           "count": 1,
           "version": {
-            "source": "3.4.0",
+            "source": "3.4.1",
             "tagging": 1
           },
           "source": {
@@ -157,6 +159,8 @@
         ]
       },
       "purchase": {
+        "title": "Purchase",
+        "description": "A completed order is sent to the Meta Conversions API as a Purchase event with value, currency, and contents.",
         "in": {
           "name": "order complete",
           "data": {
@@ -202,7 +206,7 @@
           "group": "gr0up",
           "count": 1,
           "version": {
-            "source": "3.4.0",
+            "source": "3.4.1",
             "tagging": 1
           },
           "source": {
@@ -256,6 +260,8 @@
         ]
       },
       "purchaseWithClickAttribution": {
+        "title": "Purchase with fbclid",
+        "description": "A purchase is sent to Meta CAPI with an external_id and a formatted fbc click id for ads attribution.",
         "in": {
           "name": "order complete",
           "data": {
@@ -338,7 +344,7 @@
           "group": "gr0up",
           "count": 1,
           "version": {
-            "source": "3.4.0",
+            "source": "3.4.1",
             "tagging": 1
           },
           "source": {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@walkeros/server-destination-meta",
   "description": "Meta server destination for walkerOS",
-  "version": "3.4.0",
+  "version": "3.4.1",
   "license": "MIT",
   "exports": {
     ".": {
@@ -34,11 +34,11 @@
     "update": "npx npm-check-updates -u && npm update"
   },
   "dependencies": {
-    "@walkeros/core": "3.4.0",
-    "@walkeros/server-core": "3.4.0"
+    "@walkeros/core": "3.4.1",
+    "@walkeros/server-core": "3.4.1"
   },
   "devDependencies": {
-    "@walkeros/collector": "3.4.0"
+    "@walkeros/collector": "3.4.1"
   },
   "repository": {
     "url": "git+https://github.com/elbwalker/walkerOS.git",