@walkeros/server-destination-meta 0.0.0-next-20251219153324

package/LICENSE

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

package/README.md

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

package/dist/browser-schemas.d.mts

@@ -0,0 +1,8 @@
+import * as _walkeros_core_dev from '@walkeros/core/dev';
+
+declare const schemas: {
+    settings: _walkeros_core_dev.JSONSchema;
+    mapping: _walkeros_core_dev.JSONSchema;
+};
+
+export { schemas };

package/dist/browser-schemas.d.ts

@@ -0,0 +1,8 @@
+import * as _walkeros_core_dev from '@walkeros/core/dev';
+
+declare const schemas: {
+    settings: _walkeros_core_dev.JSONSchema;
+    mapping: _walkeros_core_dev.JSONSchema;
+};
+
+export { schemas };

package/dist/browser-schemas.js

@@ -0,0 +1 @@
+"use strict";var mod,__defProp=Object.defineProperty,__getOwnPropDesc=Object.getOwnPropertyDescriptor,__getOwnPropNames=Object.getOwnPropertyNames,__hasOwnProp=Object.prototype.hasOwnProperty,browser_schemas_exports={};((target,all)=>{for(var name in all)__defProp(target,name,{get:all[name],enumerable:!0})})(browser_schemas_exports,{schemas:()=>schemas}),module.exports=(mod=browser_schemas_exports,((to,from,except,desc)=>{if(from&&"object"==typeof from||"function"==typeof from)for(let key of __getOwnPropNames(from))__hasOwnProp.call(to,key)||key===except||__defProp(to,key,{get:()=>from[key],enumerable:!(desc=__getOwnPropDesc(from,key))||desc.enumerable});return to})(__defProp({},"__esModule",{value:!0}),mod));var import_dev4=require("@walkeros/core/dev"),import_dev2=require("@walkeros/core/dev"),import_dev=require("@walkeros/core/dev"),ActionSourceSchema=import_dev.z.enum(["email","website","app","phone_call","chat","physical_store","system_generated","business_messaging","other"]),SettingsSchema=(import_dev.z.union([import_dev.z.enum(["AddPaymentInfo","AddToCart","AddToWishlist","CompleteRegistration","Contact","CustomizeProduct","Donate","FindLocation","InitiateCheckout","Lead","Purchase","Schedule","Search","StartTrial","SubmitApplication","Subscribe","ViewContent"]),import_dev.z.string()]),import_dev2.z.object({accessToken:import_dev2.z.string().min(1).describe("Meta access token for Conversions API authentication (like your_access_token)"),pixelId:import_dev2.z.string().regex(/^[0-9]+$/,"Pixel ID must contain only digits").describe("Meta Pixel ID from your Facebook Business account (like 1234567890)"),action_source:ActionSourceSchema.describe("Source of the event (website, app, phone_call, etc.) (like website)").optional(),doNotHash:import_dev2.z.array(import_dev2.z.string()).describe("Array of user_data fields that should not be hashed (like ['client_ip_address', 'client_user_agent'])").optional(),test_event_code:import_dev2.z.string().describe("Test event code for debugging Meta Conversions API events (like TEST12345)").optional(),url:import_dev2.z.string().url().describe("Custom URL for Meta Conversions API endpoint (like https://graph.facebook.com/v17.0)").optional(),user_data:import_dev2.z.record(import_dev2.z.string(),import_dev2.z.string()).describe("Mapping configuration for user data fields (like { email: 'user.email', phone: 'user.phone' })").optional()})),MappingSchema=require("@walkeros/core/dev").z.object({}),schemas={settings:(0,import_dev4.zodToSchema)(SettingsSchema),mapping:(0,import_dev4.zodToSchema)(MappingSchema)};//# sourceMappingURL=browser-schemas.js.map

package/dist/browser-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/browser-schemas.ts","../src/schemas/index.ts","../src/schemas/settings.ts","../src/schemas/primitives.ts","../src/schemas/mapping.ts"],"sourcesContent":["// Browser-safe schema-only exports\n// This file exports ONLY schemas without any Node.js dependencies\nimport { settings, mapping } from './schemas';\n\nexport const schemas = {\n  settings,\n  mapping,\n};\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"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,IAAAA,cAA4B;;;ACA5B,IAAAC,cAAkB;;;ACAlB,iBAAkB;AAOX,IAAM,qBAAqB,aAAE,KAAK;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAMM,IAAM,kBAAkB,aAAE,MAAM;AAAA,EACrC,aAAE,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,EACF,CAAC;AAAA,EACD,aAAE,OAAO;AAAA;AACX,CAAC;;;ADzCM,IAAM,iBAAiB,cAAE,OAAO;AAAA,EACrC,aAAa,cACV,OAAO,EACP,IAAI,CAAC,EACL;AAAA,IACC;AAAA,EACF;AAAA,EACF,SAAS,cACN,OAAO,EACP,MAAM,YAAY,mCAAmC,EACrD;AAAA,IACC;AAAA,EACF;AAAA,EACF,eAAe,mBAAmB;AAAA,IAChC;AAAA,EACF,EAAE,SAAS;AAAA,EACX,WAAW,cACR,MAAM,cAAE,OAAO,CAAC,EAChB;AAAA,IACC;AAAA,EACF,EACC,SAAS;AAAA,EACZ,iBAAiB,cACd,OAAO,EACP;AAAA,IACC;AAAA,EACF,EACC,SAAS;AAAA,EACZ,KAAK,cACF,OAAO,EACP,IAAI,EACJ;AAAA,IACC;AAAA,EACF,EACC,SAAS;AAAA,EACZ,WAAW,cACR,OAAO,cAAE,OAAO,GAAG,cAAE,OAAO,CAAC,EAC7B;AAAA,IACC;AAAA,EACF,EACC,SAAS;AACd,CAAC;;;AE5CD,IAAAC,cAAkB;AAMX,IAAM,gBAAgB,cAAE,OAAO,CAAC,CAAC;;;AHIjC,IAAM,eAAW,yBAAY,cAAc;AAC3C,IAAM,cAAU,yBAAY,aAAa;;;ADPzC,IAAM,UAAU;AAAA,EACrB;AAAA,EACA;AACF;","names":["import_dev","import_dev","import_dev"]}

package/dist/browser-schemas.mjs

@@ -0,0 +1 @@
+import{zodToSchema}from"@walkeros/core/dev";import{z as z2}from"@walkeros/core/dev";import{z}from"@walkeros/core/dev";var ActionSourceSchema=z.enum(["email","website","app","phone_call","chat","physical_store","system_generated","business_messaging","other"]),SettingsSchema=(z.union([z.enum(["AddPaymentInfo","AddToCart","AddToWishlist","CompleteRegistration","Contact","CustomizeProduct","Donate","FindLocation","InitiateCheckout","Lead","Purchase","Schedule","Search","StartTrial","SubmitApplication","Subscribe","ViewContent"]),z.string()]),z2.object({accessToken:z2.string().min(1).describe("Meta access token for Conversions API authentication (like your_access_token)"),pixelId:z2.string().regex(/^[0-9]+$/,"Pixel ID must contain only digits").describe("Meta Pixel ID from your Facebook Business account (like 1234567890)"),action_source:ActionSourceSchema.describe("Source of the event (website, app, phone_call, etc.) (like website)").optional(),doNotHash:z2.array(z2.string()).describe("Array of user_data fields that should not be hashed (like ['client_ip_address', 'client_user_agent'])").optional(),test_event_code:z2.string().describe("Test event code for debugging Meta Conversions API events (like TEST12345)").optional(),url:z2.string().url().describe("Custom URL for Meta Conversions API endpoint (like https://graph.facebook.com/v17.0)").optional(),user_data:z2.record(z2.string(),z2.string()).describe("Mapping configuration for user data fields (like { email: 'user.email', phone: 'user.phone' })").optional()}));import{z as z3}from"@walkeros/core/dev";var MappingSchema=z3.object({}),schemas={settings:zodToSchema(SettingsSchema),mapping:zodToSchema(MappingSchema)};export{schemas};//# sourceMappingURL=browser-schemas.mjs.map

package/dist/browser-schemas.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schemas/index.ts","../src/schemas/settings.ts","../src/schemas/primitives.ts","../src/schemas/mapping.ts","../src/browser-schemas.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","// Browser-safe schema-only exports\n// This file exports ONLY schemas without any Node.js dependencies\nimport { settings, mapping } from './schemas';\n\nexport const schemas = {\n  settings,\n  mapping,\n};\n"],"mappings":";AAAA,SAAS,mBAAmB;;;ACA5B,SAAS,KAAAA,UAAS;;;ACAlB,SAAS,SAAS;AAOX,IAAM,qBAAqB,EAAE,KAAK;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAMM,IAAM,kBAAkB,EAAE,MAAM;AAAA,EACrC,EAAE,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,EACF,CAAC;AAAA,EACD,EAAE,OAAO;AAAA;AACX,CAAC;;;ADzCM,IAAM,iBAAiBC,GAAE,OAAO;AAAA,EACrC,aAAaA,GACV,OAAO,EACP,IAAI,CAAC,EACL;AAAA,IACC;AAAA,EACF;AAAA,EACF,SAASA,GACN,OAAO,EACP,MAAM,YAAY,mCAAmC,EACrD;AAAA,IACC;AAAA,EACF;AAAA,EACF,eAAe,mBAAmB;AAAA,IAChC;AAAA,EACF,EAAE,SAAS;AAAA,EACX,WAAWA,GACR,MAAMA,GAAE,OAAO,CAAC,EAChB;AAAA,IACC;AAAA,EACF,EACC,SAAS;AAAA,EACZ,iBAAiBA,GACd,OAAO,EACP;AAAA,IACC;AAAA,EACF,EACC,SAAS;AAAA,EACZ,KAAKA,GACF,OAAO,EACP,IAAI,EACJ;AAAA,IACC;AAAA,EACF,EACC,SAAS;AAAA,EACZ,WAAWA,GACR,OAAOA,GAAE,OAAO,GAAGA,GAAE,OAAO,CAAC,EAC7B;AAAA,IACC;AAAA,EACF,EACC,SAAS;AACd,CAAC;;;AE5CD,SAAS,KAAAC,UAAS;AAMX,IAAM,gBAAgBA,GAAE,OAAO,CAAC,CAAC;;;AHIjC,IAAM,WAAW,YAAY,cAAc;AAC3C,IAAM,UAAU,YAAY,aAAa;;;AIPzC,IAAM,UAAU;AAAA,EACrB;AAAA,EACA;AACF;","names":["z","z","z"]}

package/dist/dev.d.mts

@@ -0,0 +1,404 @@
+import * as _walkeros_core_dev from '@walkeros/core/dev';
+import { z } from '@walkeros/core/dev';
+import { Mapping as Mapping$2 } from '@walkeros/core';
+import { DestinationServer, sendServer } from '@walkeros/server-core';
+
+/**
+ * Action Source Enum
+ * Where the conversion event took place
+ * https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/server-event
+ */
+declare const ActionSourceSchema: z.ZodEnum<{
+    email: "email";
+    website: "website";
+    app: "app";
+    phone_call: "phone_call";
+    chat: "chat";
+    physical_store: "physical_store";
+    system_generated: "system_generated";
+    business_messaging: "business_messaging";
+    other: "other";
+}>;
+/**
+ * Event Name
+ * Standard Meta event names or custom event identifiers
+ */
+declare const EventNameSchema: z.ZodUnion<readonly [z.ZodEnum<{
+    AddPaymentInfo: "AddPaymentInfo";
+    AddToCart: "AddToCart";
+    AddToWishlist: "AddToWishlist";
+    CompleteRegistration: "CompleteRegistration";
+    Contact: "Contact";
+    CustomizeProduct: "CustomizeProduct";
+    Donate: "Donate";
+    FindLocation: "FindLocation";
+    InitiateCheckout: "InitiateCheckout";
+    Lead: "Lead";
+    Purchase: "Purchase";
+    Schedule: "Schedule";
+    Search: "Search";
+    StartTrial: "StartTrial";
+    SubmitApplication: "SubmitApplication";
+    Subscribe: "Subscribe";
+    ViewContent: "ViewContent";
+}>, z.ZodString]>;
+
+declare const SettingsSchema: z.ZodObject<{
+    accessToken: z.ZodString;
+    pixelId: z.ZodString;
+    action_source: z.ZodOptional<z.ZodEnum<{
+        email: "email";
+        website: "website";
+        app: "app";
+        phone_call: "phone_call";
+        chat: "chat";
+        physical_store: "physical_store";
+        system_generated: "system_generated";
+        business_messaging: "business_messaging";
+        other: "other";
+    }>>;
+    doNotHash: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    test_event_code: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    user_data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+type Settings$1 = z.infer<typeof SettingsSchema>;
+
+/**
+ * Meta Conversions API Mapping Schema
+ * Meta CAPI has no event-level mapping configuration
+ */
+declare const MappingSchema: z.ZodObject<{}, z.core.$strip>;
+/**
+ * Type inference from MappingSchema
+ */
+type Mapping$1 = z.infer<typeof MappingSchema>;
+
+declare const settings: _walkeros_core_dev.JSONSchema;
+declare const mapping$1: _walkeros_core_dev.JSONSchema;
+
+declare const index$1_ActionSourceSchema: typeof ActionSourceSchema;
+declare const index$1_EventNameSchema: typeof EventNameSchema;
+declare const index$1_MappingSchema: typeof MappingSchema;
+declare const index$1_SettingsSchema: typeof SettingsSchema;
+declare const index$1_settings: typeof settings;
+declare namespace index$1 {
+  export { index$1_ActionSourceSchema as ActionSourceSchema, index$1_EventNameSchema as EventNameSchema, type Mapping$1 as Mapping, index$1_MappingSchema as MappingSchema, type Settings$1 as Settings, index$1_SettingsSchema as SettingsSchema, mapping$1 as mapping, index$1_settings as settings };
+}
+
+interface Settings {
+    accessToken: string;
+    pixelId: string;
+    action_source?: ActionSource;
+    doNotHash?: string[];
+    test_event_code?: string;
+    url?: string;
+    user_data?: Mapping$2.Map;
+}
+interface Mapping {
+}
+interface Env extends DestinationServer.Env {
+    sendServer?: typeof sendServer;
+}
+type Rule = Mapping$2.Rule<Mapping>;
+interface BodyParameters {
+    data: Array<ServerEventParameters>;
+    test_event_code?: string;
+}
+/**
+ * Represents the top‑level parameters for a server event sent via Meta's Conversions API.
+ * https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/server-event
+ */
+interface ServerEventParameters extends StandardParameters {
+    /** The event name or custom event identifier. Required for deduplication. */
+    event_name: EventName;
+    /** Unix timestamp (in seconds) when the event actually occurred. GMT timezone. */
+    event_time: number;
+    /** Map of customer information for matching (emails, phone, etc.). */
+    user_data: CustomerInformationParameters;
+    /** Additional business data about the event. */
+    custom_data?: Record<string, unknown>;
+    /** URL of the page where the event occurred. */
+    event_source_url?: string;
+    /** If true, exclude this event from ads optimization (only attribution). */
+    opt_out?: boolean;
+    /** Unique ID for deduplication across Pixel and CAPI. */
+    event_id?: string;
+    /** Source of the event (e.g., website, app). */
+    action_source: ActionSource;
+    /** Processing options (e.g., ['LDU'] for CCPA limited data use). */
+    data_processing_options?: DataProcessingOption[];
+    /** Country code for data processing option (1 = USA, 0 = auto‑geolocate). */
+    data_processing_options_country?: number;
+    /** State code for data processing option (1000 = California, 0 = auto). */
+    data_processing_options_state?: number;
+    /** App‑specific data (required if action_source is 'app'). */
+    app_data?: AppData;
+    /** HTTP referrer header of the event. */
+    referrer_url?: string;
+    /** Metadata to link delayed events to past acquisition events. */
+    original_event_data?: OriginalEventDataParameters;
+    /** User segment for more context about the customer's relationship. */
+    customer_segmentation?: CustomerSegmentation;
+}
+type EventName = 'AddPaymentInfo' | 'AddToCart' | 'AddToWishlist' | 'CompleteRegistration' | 'Contact' | 'CustomizeProduct' | 'Donate' | 'FindLocation' | 'InitiateCheckout' | 'Lead' | 'Purchase' | 'Schedule' | 'Search' | 'StartTrial' | 'SubmitApplication' | 'Subscribe' | 'ViewContent' | string;
+type ActionSource = 'email' | 'website' | 'app' | 'phone_call' | 'chat' | 'physical_store' | 'system_generated' | 'business_messaging' | 'other';
+type DataProcessingOption = 'LDU';
+type CustomerSegmentation = 'new_customer_to_business' | 'new_customer_to_business_line' | 'new_customer_to_product_area' | 'new_customer_to_medium' | 'existing_customer_to_business' | 'existing_customer_to_business_line' | 'existing_customer_to_product_area' | 'existing_customer_to_medium' | 'customer_in_loyalty_program';
+/** Extended device info for app events (Android version 'a2', iOS 'i2') */
+interface AppData {
+    /**
+     * Comma-separated array of strings with fixed order:
+     * [sdk_version, os_version, device_model, device_brand,
+     *  screen_width, screen_height, ...]
+     */
+    extinfo: string[];
+}
+interface CustomerInformationParameters {
+    /** Email(s), SHA-256 hashed, lowercase and trimmed */
+    em?: string | string[];
+    /** Phone number(s), SHA-256 hashed, E.164 format (no leading 0s or symbols) */
+    ph?: string | string[];
+    /** First name(s), SHA-256 hashed, lowercase */
+    fn?: string | string[];
+    /** Last name(s), SHA-256 hashed, lowercase */
+    ln?: string | string[];
+    /** Date(s) of birth in YYYYMMDD, SHA-256 hashed */
+    db?: string | string[];
+    /** Gender(s) in lowercase single letter ("m", "f", etc.), SHA-256 hashed */
+    ge?: string | string[];
+    /** City name(s), SHA-256 hashed, lowercase */
+    ct?: string | string[];
+    /** State abbreviation(s), SHA-256 hashed, lowercase (e.g., "ca", "ny") */
+    st?: string | string[];
+    /** ZIP or postal code(s), SHA-256 hashed, lowercase */
+    zp?: string | string[];
+    /** Country code(s), SHA-256 hashed, lowercase (ISO 3166-1 alpha-2) */
+    country?: string | string[];
+    /** External IDs, unique per user. SHA-256 hash recommended */
+    external_id?: string | string[];
+    /** IPv4 or IPv6 address of client. Do NOT hash. */
+    client_ip_address?: string;
+    /** User agent string from browser. Do NOT hash. */
+    client_user_agent?: string;
+    /** fbclid parameter value from the URL. Do NOT hash. */
+    fbclid?: string;
+    /** Facebook click ID (_fbc cookie). Do NOT hash. */
+    fbc?: string;
+    /** Facebook browser ID (_fbp cookie). Do NOT hash. */
+    fbp?: string;
+    /** Subscription ID for the transaction. Do NOT hash. */
+    subscription_id?: string;
+    /** Facebook login ID (App-Scoped ID). Do NOT hash. */
+    fb_login_id?: number;
+    /** Meta Lead Ad lead ID. Do NOT hash. */
+    lead_id?: number;
+    /** Anonymous install ID. App events only. Do NOT hash. */
+    anon_id?: string;
+    /** Mobile advertiser ID (GAID/IDFA). Do NOT hash. */
+    madid?: string;
+    /** Facebook Page ID. Do NOT hash. */
+    page_id?: string;
+    /** Messenger Page-scoped user ID. Do NOT hash. */
+    page_scoped_user_id?: string;
+    /** Click to WhatsApp ad click ID. Do NOT hash. */
+    ctwa_clid?: string;
+    /** Instagram business account ID. Do NOT hash. */
+    ig_account_id?: string;
+    /** Instagram-scoped user ID. Do NOT hash. */
+    ig_sid?: string;
+}
+interface StandardParameters {
+    availability?: string;
+    body_style?: string;
+    checkin_date?: string;
+    city?: string;
+    condition_of_vehicle?: string;
+    content_ids?: string[];
+    content_type?: 'product' | 'product_group' | string;
+    contents?: Array<{
+        id: string;
+        quantity?: number;
+        item_price?: number;
+        delivery_category?: string;
+    }>;
+    country?: string;
+    currency?: string;
+    delivery_category?: 'in_store' | 'curbside' | 'home_delivery' | string;
+    departing_arrival_date?: string;
+    departing_departure_date?: string;
+    destination_airport?: string;
+    destination_ids?: string[];
+    dma_code?: string;
+    drivetrain?: string;
+    exterior_color?: string;
+    fuel_type?: string;
+    hotel_score?: number;
+    interior_color?: string;
+    lead_event_source?: string;
+    lease_end_date?: string;
+    lease_start_date?: string;
+    listing_type?: string;
+    make?: string;
+    'mileage.unit'?: string;
+    'mileage.value'?: number;
+    model?: string;
+    neighborhood?: string;
+    net_revenue?: number;
+    num_adults?: number;
+    num_children?: number;
+    num_infants?: number;
+    num_items?: number;
+    order_id?: string;
+    origin_airport?: string;
+    postal_code?: string;
+    predicted_ltv?: number;
+    preferred_baths_range?: string;
+    preferred_beds_range?: string;
+    preferred_neighborhoods?: string[];
+    preferred_num_stops?: number;
+    preferred_price_range?: string;
+    preferred_star_ratings?: [number, number];
+    price?: string;
+    product_catalog_id?: string;
+    property_type?: string;
+    region?: string;
+    returning_arrival_date?: string;
+    returning_departure_date?: string;
+    search_string?: string;
+    state_of_vehicle?: string;
+    suggested_destinations?: string[];
+    suggested_home_listings?: string[];
+    suggested_hotels?: string[];
+    suggested_jobs?: string[];
+    suggested_local_service_businesses?: string[];
+    suggested_location_based_items?: string[];
+    suggested_vehicles?: string[];
+    transmission?: string;
+    travel_class?: string;
+    travel_end?: string;
+    travel_start?: string;
+    trim?: string;
+    fb_availability?: string;
+    fb_body_style?: string;
+    fb_checkin_date?: string;
+    fb_city?: string;
+    fb_condition_of_vehicle?: string;
+    fb_content_ids?: string[];
+    fb_content_type?: string;
+    fb_contents?: Array<{
+        id: string;
+        quantity?: number;
+        item_price?: number;
+    }>;
+    fb_country?: string;
+    fb_currency?: string;
+    fb_delivery_category?: string;
+    fb_departing_arrival_date?: string;
+    fb_departing_departure_date?: string;
+    fb_destination_airport?: string;
+    fb_destination_ids?: string[];
+    fb_dma_code?: string;
+    fb_drivetrain?: string;
+    fb_exterior_color?: string;
+    fb_fuel_type?: string;
+    fb_hotel_score?: number;
+    fb_interior_color?: string;
+    fb_lease_end_date?: string;
+    fb_lease_start_date?: string;
+    fb_listing_type?: string;
+    fb_make?: string;
+    'fb_mileage.unit'?: string;
+    'fb_mileage.value'?: number;
+    fb_model?: string;
+    fb_neighborhood?: string;
+    fb_num_adults?: number;
+    fb_num_children?: number;
+    fb_num_infants?: number;
+    fb_num_items?: number;
+    fb_order_id?: string;
+    fb_origin_airport?: string;
+    fb_postal_code?: string;
+    fb_predicted_ltv?: number;
+    fb_preferred_baths_range?: string;
+    fb_preferred_beds_range?: string;
+    fb_preferred_neighborhoods?: string[];
+    fb_preferred_num_stops?: number;
+    fb_preferred_price_range?: string;
+    fb_preferred_star_ratings?: [number, number];
+    fb_price?: string;
+    fb_product_catalog_id?: string;
+    fb_property_type?: string;
+    fb_region?: string;
+    fb_returning_arrival_date?: string;
+    fb_returning_departure_date?: string;
+    fb_search_string?: string;
+    fb_state_of_vehicle?: string;
+    fb_suggested_destinations?: string[];
+    fb_suggested_home_listings?: string[];
+    fb_suggested_hotels?: string[];
+    fb_suggested_jobs?: string[];
+    fb_suggested_local_service_businesses?: string[];
+    fb_suggested_location_based_items?: string[];
+    fb_suggested_vehicles?: string[];
+    fb_transmission?: string;
+    fb_travel_class?: string;
+    fb_travel_end?: string;
+    fb_travel_start?: string;
+    user_bucket?: string;
+    value?: number;
+    vin?: string;
+    year?: number;
+    item_number?: string;
+}
+interface OriginalEventDataParameters {
+    event_name?: EventName;
+    event_time?: number;
+    order_id?: number;
+    event_id?: string;
+}
+
+/**
+ * Standard mock environment for push operations
+ *
+ * Use this for testing Meta Conversions API events without making
+ * actual HTTP requests to Facebook'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 function Purchase$1(): BodyParameters;
+
+declare namespace events {
+  export { Purchase$1 as Purchase };
+}
+
+declare const InitUserData: Settings;
+declare const Purchase: Rule;
+declare const config: {
+    order: {
+        complete: Rule;
+    };
+};
+
+declare const mapping_InitUserData: typeof InitUserData;
+declare const mapping_Purchase: typeof Purchase;
+declare const mapping_config: typeof config;
+declare namespace mapping {
+  export { mapping_InitUserData as InitUserData, mapping_Purchase as Purchase, mapping_config as config };
+}
+
+declare const index_env: typeof env;
+declare const index_events: typeof events;
+declare const index_mapping: typeof mapping;
+declare namespace index {
+  export { index_env as env, index_events as events, index_mapping as mapping };
+}
+
+export { index as examples, index$1 as schemas };