@automate.ax/integration-contracts 0.139.2 → 0.142.0

package/dist/meta-ads/events.d.ts

@@ -0,0 +1,391 @@
+import * as z from "zod";
+export declare const META_ADS_AD_ACCOUNT_FIELDS: readonly ["ad_recommendations", "creative_fatigue", "effective_status", "in_process_ad_objects", "subscriptions", "with_issues_ad_objects"];
+export declare const META_ADS_EVENT_SCHEMA: z.ZodObject<{
+    accountId: z.ZodString;
+    field: z.ZodString;
+    occurredAt: z.ZodNumber;
+    value: z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>;
+}, z.core.$strip>;
+export declare const META_ADS_EFFECTIVE_STATUS_EVENT_SCHEMA: z.ZodObject<{
+    accountId: z.ZodString;
+    occurredAt: z.ZodNumber;
+    field: z.ZodLiteral<"field_changed">;
+    value: z.ZodObject<{
+        changedFields: z.ZodArray<z.ZodLiteral<"effective_status">>;
+        objectId: z.ZodString;
+        objectType: z.ZodEnum<{
+            ad: "ad";
+            adset: "adset";
+            campaign: "campaign";
+        }>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const META_ADS_SUBSCRIPTION_EVENT_SCHEMA: z.ZodObject<{
+    accountId: z.ZodString;
+    occurredAt: z.ZodNumber;
+    field: z.ZodLiteral<"subscriptions">;
+    value: z.ZodObject<{
+        accountId: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+        currentValue: z.ZodOptional<z.ZodString>;
+        field: z.ZodOptional<z.ZodString>;
+        objectId: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+        objectType: z.ZodEnum<{
+            ad: "ad";
+            adset: "adset";
+            campaign: "campaign";
+        }>;
+        subscriptionId: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const META_ADS_CREATIVE_FATIGUE_EVENT_SCHEMA: z.ZodObject<{
+    accountId: z.ZodString;
+    occurredAt: z.ZodNumber;
+    field: z.ZodLiteral<"creative_fatigue">;
+    value: z.ZodObject<{
+        adAccountId: z.ZodString;
+        adgroupId: z.ZodString;
+        creativeFatigueLevel: z.ZodEnum<{
+            HIGH: "HIGH";
+            LOW: "LOW";
+            MEDIUM: "MEDIUM";
+        }>;
+        creativeFatigueMessage: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const META_ADS_RECOMMENDATION_EVENT_SCHEMA: z.ZodObject<{
+    accountId: z.ZodString;
+    occurredAt: z.ZodNumber;
+    field: z.ZodLiteral<"ad_recommendations">;
+    value: z.ZodObject<{
+        adAccountId: z.ZodString;
+        adObjectIds: z.ZodArray<z.ZodString>;
+        recommendationHash: z.ZodString;
+        recommendationMessage: z.ZodString;
+        recommendationSignature: z.ZodString;
+        recommendationStage: z.ZodString;
+        recommendationType: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const META_ADS_PROCESSING_EVENT_SCHEMA: z.ZodObject<{
+    accountId: z.ZodString;
+    occurredAt: z.ZodNumber;
+    field: z.ZodLiteral<"in_process_ad_objects">;
+    value: z.ZodObject<{
+        id: z.ZodString;
+        level: z.ZodEnum<{
+            AD: "AD";
+            AD_SET: "AD_SET";
+            CAMPAIGN: "CAMPAIGN";
+            CREATIVE: "CREATIVE";
+        }>;
+        statusName: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const META_ADS_ISSUES_EVENT_SCHEMA: z.ZodObject<{
+    accountId: z.ZodString;
+    occurredAt: z.ZodNumber;
+    field: z.ZodLiteral<"with_issues_ad_objects">;
+    value: z.ZodObject<{
+        errorCode: z.ZodString;
+        errorMessage: z.ZodString;
+        errorSummary: z.ZodString;
+        id: z.ZodString;
+        level: z.ZodEnum<{
+            AD: "AD";
+            AD_SET: "AD_SET";
+            CAMPAIGN: "CAMPAIGN";
+            CREATIVE: "CREATIVE";
+        }>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const META_ADS_LEAD_CREATED_EVENT_SCHEMA: z.ZodObject<{
+    adId: z.ZodOptional<z.ZodString>;
+    adgroupId: z.ZodOptional<z.ZodString>;
+    createdTime: z.ZodNumber;
+    formId: z.ZodString;
+    leadgenId: z.ZodString;
+    pageId: z.ZodString;
+}, z.core.$strip>;
+export declare const META_ADS_TRIGGER_CONFIG_SCHEMA: z.ZodObject<{
+    account: z.ZodOptional<z.ZodString>;
+    adAccountId: z.ZodString;
+}, z.core.$strip>;
+export declare const META_ADS_LEAD_TRIGGER_CONFIG_SCHEMA: z.ZodObject<{
+    account: z.ZodOptional<z.ZodString>;
+    pageId: z.ZodString;
+}, z.core.$strip>;
+export interface NormalizedMetaAdsWebhook {
+    adAccountEvents: z.output<typeof META_ADS_EVENT_SCHEMA>[];
+    leadEvents: z.output<typeof META_ADS_LEAD_CREATED_EVENT_SCHEMA>[];
+}
+export declare const metaAdsTriggerContracts: {
+    readonly "meta-ads.ad.effectiveStatusChanged": {
+        readonly configSchema: z.ZodObject<{
+            account: z.ZodOptional<z.ZodString>;
+            adAccountId: z.ZodString;
+        }, z.core.$strip>;
+        readonly eventSchema: z.ZodObject<{
+            accountId: z.ZodString;
+            occurredAt: z.ZodNumber;
+            field: z.ZodLiteral<"field_changed">;
+            value: z.ZodObject<{
+                changedFields: z.ZodArray<z.ZodLiteral<"effective_status">>;
+                objectId: z.ZodString;
+                objectType: z.ZodEnum<{
+                    ad: "ad";
+                    adset: "adset";
+                    campaign: "campaign";
+                }>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+    };
+    readonly "meta-ads.ad.recommendation": {
+        readonly configSchema: z.ZodObject<{
+            account: z.ZodOptional<z.ZodString>;
+            adAccountId: z.ZodString;
+        }, z.core.$strip>;
+        readonly eventSchema: z.ZodObject<{
+            accountId: z.ZodString;
+            occurredAt: z.ZodNumber;
+            field: z.ZodLiteral<"ad_recommendations">;
+            value: z.ZodObject<{
+                adAccountId: z.ZodString;
+                adObjectIds: z.ZodArray<z.ZodString>;
+                recommendationHash: z.ZodString;
+                recommendationMessage: z.ZodString;
+                recommendationSignature: z.ZodString;
+                recommendationStage: z.ZodString;
+                recommendationType: z.ZodString;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+    };
+    readonly "meta-ads.adObject.issuesChanged": {
+        readonly configSchema: z.ZodObject<{
+            account: z.ZodOptional<z.ZodString>;
+            adAccountId: z.ZodString;
+        }, z.core.$strip>;
+        readonly eventSchema: z.ZodObject<{
+            accountId: z.ZodString;
+            occurredAt: z.ZodNumber;
+            field: z.ZodLiteral<"with_issues_ad_objects">;
+            value: z.ZodObject<{
+                errorCode: z.ZodString;
+                errorMessage: z.ZodString;
+                errorSummary: z.ZodString;
+                id: z.ZodString;
+                level: z.ZodEnum<{
+                    AD: "AD";
+                    AD_SET: "AD_SET";
+                    CAMPAIGN: "CAMPAIGN";
+                    CREATIVE: "CREATIVE";
+                }>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+    };
+    readonly "meta-ads.adObject.processingCompleted": {
+        readonly configSchema: z.ZodObject<{
+            account: z.ZodOptional<z.ZodString>;
+            adAccountId: z.ZodString;
+        }, z.core.$strip>;
+        readonly eventSchema: z.ZodObject<{
+            accountId: z.ZodString;
+            occurredAt: z.ZodNumber;
+            field: z.ZodLiteral<"in_process_ad_objects">;
+            value: z.ZodObject<{
+                id: z.ZodString;
+                level: z.ZodEnum<{
+                    AD: "AD";
+                    AD_SET: "AD_SET";
+                    CAMPAIGN: "CAMPAIGN";
+                    CREATIVE: "CREATIVE";
+                }>;
+                statusName: z.ZodString;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+    };
+    readonly "meta-ads.adSet.effectiveStatusChanged": {
+        readonly configSchema: z.ZodObject<{
+            account: z.ZodOptional<z.ZodString>;
+            adAccountId: z.ZodString;
+        }, z.core.$strip>;
+        readonly eventSchema: z.ZodObject<{
+            accountId: z.ZodString;
+            occurredAt: z.ZodNumber;
+            field: z.ZodLiteral<"field_changed">;
+            value: z.ZodObject<{
+                changedFields: z.ZodArray<z.ZodLiteral<"effective_status">>;
+                objectId: z.ZodString;
+                objectType: z.ZodEnum<{
+                    ad: "ad";
+                    adset: "adset";
+                    campaign: "campaign";
+                }>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+    };
+    readonly "meta-ads.campaign.effectiveStatusChanged": {
+        readonly configSchema: z.ZodObject<{
+            account: z.ZodOptional<z.ZodString>;
+            adAccountId: z.ZodString;
+        }, z.core.$strip>;
+        readonly eventSchema: z.ZodObject<{
+            accountId: z.ZodString;
+            occurredAt: z.ZodNumber;
+            field: z.ZodLiteral<"field_changed">;
+            value: z.ZodObject<{
+                changedFields: z.ZodArray<z.ZodLiteral<"effective_status">>;
+                objectId: z.ZodString;
+                objectType: z.ZodEnum<{
+                    ad: "ad";
+                    adset: "adset";
+                    campaign: "campaign";
+                }>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+    };
+    readonly "meta-ads.creativeFatigue.changed": {
+        readonly configSchema: z.ZodObject<{
+            account: z.ZodOptional<z.ZodString>;
+            adAccountId: z.ZodString;
+        }, z.core.$strip>;
+        readonly eventSchema: z.ZodObject<{
+            accountId: z.ZodString;
+            occurredAt: z.ZodNumber;
+            field: z.ZodLiteral<"creative_fatigue">;
+            value: z.ZodObject<{
+                adAccountId: z.ZodString;
+                adgroupId: z.ZodString;
+                creativeFatigueLevel: z.ZodEnum<{
+                    HIGH: "HIGH";
+                    LOW: "LOW";
+                    MEDIUM: "MEDIUM";
+                }>;
+                creativeFatigueMessage: z.ZodString;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+    };
+    readonly "meta-ads.event": {
+        readonly configSchema: z.ZodObject<{
+            account: z.ZodOptional<z.ZodString>;
+            adAccountId: z.ZodString;
+        }, z.core.$strip>;
+        readonly eventSchema: z.ZodObject<{
+            accountId: z.ZodString;
+            field: z.ZodString;
+            occurredAt: z.ZodNumber;
+            value: z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>;
+        }, z.core.$strip>;
+    };
+    readonly "meta-ads.insights.milestoneReached": {
+        readonly configSchema: z.ZodObject<{
+            account: z.ZodOptional<z.ZodString>;
+            adAccountId: z.ZodString;
+        }, z.core.$strip>;
+        readonly eventSchema: z.ZodObject<{
+            accountId: z.ZodString;
+            occurredAt: z.ZodNumber;
+            field: z.ZodLiteral<"subscriptions">;
+            value: z.ZodObject<{
+                accountId: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+                currentValue: z.ZodOptional<z.ZodString>;
+                field: z.ZodOptional<z.ZodString>;
+                objectId: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+                objectType: z.ZodEnum<{
+                    ad: "ad";
+                    adset: "adset";
+                    campaign: "campaign";
+                }>;
+                subscriptionId: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+    };
+    readonly "meta-ads.insights.updated": {
+        readonly configSchema: z.ZodObject<{
+            account: z.ZodOptional<z.ZodString>;
+            adAccountId: z.ZodString;
+        }, z.core.$strip>;
+        readonly eventSchema: z.ZodObject<{
+            accountId: z.ZodString;
+            occurredAt: z.ZodNumber;
+            field: z.ZodLiteral<"subscriptions">;
+            value: z.ZodObject<{
+                accountId: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+                currentValue: z.ZodOptional<z.ZodString>;
+                field: z.ZodOptional<z.ZodString>;
+                objectId: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+                objectType: z.ZodEnum<{
+                    ad: "ad";
+                    adset: "adset";
+                    campaign: "campaign";
+                }>;
+                subscriptionId: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+    };
+    readonly "meta-ads.lead.created": {
+        readonly configSchema: z.ZodObject<{
+            account: z.ZodOptional<z.ZodString>;
+            pageId: z.ZodString;
+        }, z.core.$strip>;
+        readonly eventSchema: z.ZodObject<{
+            adId: z.ZodOptional<z.ZodString>;
+            adgroupId: z.ZodOptional<z.ZodString>;
+            createdTime: z.ZodNumber;
+            formId: z.ZodString;
+            leadgenId: z.ZodString;
+            pageId: z.ZodString;
+        }, z.core.$strip>;
+    };
+    readonly "meta-ads.object.created": {
+        readonly configSchema: z.ZodObject<{
+            account: z.ZodOptional<z.ZodString>;
+            adAccountId: z.ZodString;
+        }, z.core.$strip>;
+        readonly eventSchema: z.ZodObject<{
+            accountId: z.ZodString;
+            occurredAt: z.ZodNumber;
+            field: z.ZodLiteral<"subscriptions">;
+            value: z.ZodObject<{
+                accountId: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+                currentValue: z.ZodOptional<z.ZodString>;
+                field: z.ZodOptional<z.ZodString>;
+                objectId: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+                objectType: z.ZodEnum<{
+                    ad: "ad";
+                    adset: "adset";
+                    campaign: "campaign";
+                }>;
+                subscriptionId: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+    };
+    readonly "meta-ads.object.updated": {
+        readonly configSchema: z.ZodObject<{
+            account: z.ZodOptional<z.ZodString>;
+            adAccountId: z.ZodString;
+        }, z.core.$strip>;
+        readonly eventSchema: z.ZodObject<{
+            accountId: z.ZodString;
+            occurredAt: z.ZodNumber;
+            field: z.ZodLiteral<"subscriptions">;
+            value: z.ZodObject<{
+                accountId: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+                currentValue: z.ZodOptional<z.ZodString>;
+                field: z.ZodOptional<z.ZodString>;
+                objectId: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+                objectType: z.ZodEnum<{
+                    ad: "ad";
+                    adset: "adset";
+                    campaign: "campaign";
+                }>;
+                subscriptionId: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+    };
+};
+/**
+ * Normalizes Meta's Page and ad-account envelopes into stable public events.
+ *
+ * @param input - Untrusted provider webhook envelope.
+ */
+export declare function normalizeMetaAdsWebhook(input: unknown): NormalizedMetaAdsWebhook;

package/dist/meta-ads/events.js

@@ -0,0 +1,193 @@
+import { encodableSchema } from "@automate.ax/codec";
+import * as z from "zod";
+import { fromMeta } from "./api.js";
+import { META_ADS_ID_SCHEMA, META_ADS_WEBHOOK_ENVELOPE_SCHEMA } from "./schemas.js";
+export const META_ADS_AD_ACCOUNT_FIELDS = [
+    "ad_recommendations",
+    "creative_fatigue",
+    "effective_status",
+    "in_process_ad_objects",
+    "subscriptions",
+    "with_issues_ad_objects",
+];
+const META_ADS_EVENT_BASE_SCHEMA = z.object({
+    accountId: META_ADS_ID_SCHEMA,
+    field: z.string(),
+    occurredAt: z.number().int().nonnegative(),
+});
+export const META_ADS_EVENT_SCHEMA = META_ADS_EVENT_BASE_SCHEMA.extend({
+    value: encodableSchema,
+});
+export const META_ADS_EFFECTIVE_STATUS_EVENT_SCHEMA = META_ADS_EVENT_BASE_SCHEMA.extend({
+    field: z.literal("field_changed"),
+    value: z.object({
+        changedFields: z.literal("effective_status").array(),
+        objectId: META_ADS_ID_SCHEMA,
+        objectType: z.enum(["ad", "adset", "campaign"]),
+    }),
+});
+export const META_ADS_SUBSCRIPTION_EVENT_SCHEMA = META_ADS_EVENT_BASE_SCHEMA.extend({
+    field: z.literal("subscriptions"),
+    value: z.object({
+        accountId: z.union([META_ADS_ID_SCHEMA, z.number()]).transform(String),
+        currentValue: z.string().optional(),
+        field: z.string().optional(),
+        objectId: z.union([META_ADS_ID_SCHEMA, z.number()]).transform(String),
+        objectType: z.enum(["ad", "adset", "campaign"]),
+        subscriptionId: z
+            .union([META_ADS_ID_SCHEMA, z.number()])
+            .transform(String),
+    }),
+});
+export const META_ADS_CREATIVE_FATIGUE_EVENT_SCHEMA = META_ADS_EVENT_BASE_SCHEMA.extend({
+    field: z.literal("creative_fatigue"),
+    value: z.object({
+        adAccountId: META_ADS_ID_SCHEMA,
+        adgroupId: META_ADS_ID_SCHEMA,
+        creativeFatigueLevel: z.enum(["HIGH", "LOW", "MEDIUM"]),
+        creativeFatigueMessage: z.string(),
+    }),
+});
+export const META_ADS_RECOMMENDATION_EVENT_SCHEMA = META_ADS_EVENT_BASE_SCHEMA.extend({
+    field: z.literal("ad_recommendations"),
+    value: z.object({
+        adAccountId: META_ADS_ID_SCHEMA,
+        adObjectIds: META_ADS_ID_SCHEMA.array(),
+        recommendationHash: z.string(),
+        recommendationMessage: z.string(),
+        recommendationSignature: z.string(),
+        recommendationStage: z.string(),
+        recommendationType: z.string(),
+    }),
+});
+export const META_ADS_PROCESSING_EVENT_SCHEMA = META_ADS_EVENT_BASE_SCHEMA.extend({
+    field: z.literal("in_process_ad_objects"),
+    value: z.object({
+        id: META_ADS_ID_SCHEMA,
+        level: z.enum(["AD", "AD_SET", "CAMPAIGN", "CREATIVE"]),
+        statusName: z.string(),
+    }),
+});
+export const META_ADS_ISSUES_EVENT_SCHEMA = META_ADS_EVENT_BASE_SCHEMA.extend({
+    field: z.literal("with_issues_ad_objects"),
+    value: z.object({
+        errorCode: z.string(),
+        errorMessage: z.string(),
+        errorSummary: z.string(),
+        id: META_ADS_ID_SCHEMA,
+        level: z.enum(["AD", "AD_SET", "CAMPAIGN", "CREATIVE"]),
+    }),
+});
+export const META_ADS_LEAD_CREATED_EVENT_SCHEMA = z.object({
+    adId: z.string().optional(),
+    adgroupId: z.string().optional(),
+    createdTime: z.number().int().nonnegative(),
+    formId: META_ADS_ID_SCHEMA,
+    leadgenId: META_ADS_ID_SCHEMA,
+    pageId: META_ADS_ID_SCHEMA,
+});
+export const META_ADS_TRIGGER_CONFIG_SCHEMA = z.object({
+    account: z.string().optional(),
+    adAccountId: META_ADS_ID_SCHEMA,
+});
+export const META_ADS_LEAD_TRIGGER_CONFIG_SCHEMA = z.object({
+    account: z.string().optional(),
+    pageId: META_ADS_ID_SCHEMA,
+});
+export const metaAdsTriggerContracts = {
+    "meta-ads.ad.effectiveStatusChanged": {
+        configSchema: META_ADS_TRIGGER_CONFIG_SCHEMA,
+        eventSchema: META_ADS_EFFECTIVE_STATUS_EVENT_SCHEMA,
+    },
+    "meta-ads.ad.recommendation": {
+        configSchema: META_ADS_TRIGGER_CONFIG_SCHEMA,
+        eventSchema: META_ADS_RECOMMENDATION_EVENT_SCHEMA,
+    },
+    "meta-ads.adObject.issuesChanged": {
+        configSchema: META_ADS_TRIGGER_CONFIG_SCHEMA,
+        eventSchema: META_ADS_ISSUES_EVENT_SCHEMA,
+    },
+    "meta-ads.adObject.processingCompleted": {
+        configSchema: META_ADS_TRIGGER_CONFIG_SCHEMA,
+        eventSchema: META_ADS_PROCESSING_EVENT_SCHEMA,
+    },
+    "meta-ads.adSet.effectiveStatusChanged": {
+        configSchema: META_ADS_TRIGGER_CONFIG_SCHEMA,
+        eventSchema: META_ADS_EFFECTIVE_STATUS_EVENT_SCHEMA,
+    },
+    "meta-ads.campaign.effectiveStatusChanged": {
+        configSchema: META_ADS_TRIGGER_CONFIG_SCHEMA,
+        eventSchema: META_ADS_EFFECTIVE_STATUS_EVENT_SCHEMA,
+    },
+    "meta-ads.creativeFatigue.changed": {
+        configSchema: META_ADS_TRIGGER_CONFIG_SCHEMA,
+        eventSchema: META_ADS_CREATIVE_FATIGUE_EVENT_SCHEMA,
+    },
+    "meta-ads.event": {
+        configSchema: META_ADS_TRIGGER_CONFIG_SCHEMA,
+        eventSchema: META_ADS_EVENT_SCHEMA,
+    },
+    "meta-ads.insights.milestoneReached": {
+        configSchema: META_ADS_TRIGGER_CONFIG_SCHEMA,
+        eventSchema: META_ADS_SUBSCRIPTION_EVENT_SCHEMA,
+    },
+    "meta-ads.insights.updated": {
+        configSchema: META_ADS_TRIGGER_CONFIG_SCHEMA,
+        eventSchema: META_ADS_SUBSCRIPTION_EVENT_SCHEMA,
+    },
+    "meta-ads.lead.created": {
+        configSchema: META_ADS_LEAD_TRIGGER_CONFIG_SCHEMA,
+        eventSchema: META_ADS_LEAD_CREATED_EVENT_SCHEMA,
+    },
+    "meta-ads.object.created": {
+        configSchema: META_ADS_TRIGGER_CONFIG_SCHEMA,
+        eventSchema: META_ADS_SUBSCRIPTION_EVENT_SCHEMA,
+    },
+    "meta-ads.object.updated": {
+        configSchema: META_ADS_TRIGGER_CONFIG_SCHEMA,
+        eventSchema: META_ADS_SUBSCRIPTION_EVENT_SCHEMA,
+    },
+};
+/**
+ * Normalizes Meta's Page and ad-account envelopes into stable public events.
+ *
+ * @param input - Untrusted provider webhook envelope.
+ */
+export function normalizeMetaAdsWebhook(input) {
+    const envelope = META_ADS_WEBHOOK_ENVELOPE_SCHEMA.parse(input);
+    const adAccountEvents = [];
+    const leadEvents = [];
+    for (const entry of envelope.entry) {
+        for (const change of entry.changes) {
+            if (envelope.object === "page" && change.field === "leadgen") {
+                const value = z
+                    .object({
+                    ad_id: z.string().optional(),
+                    adgroup_id: z.string().optional(),
+                    created_time: z.number().int().nonnegative(),
+                    form_id: z.string(),
+                    leadgen_id: z.string(),
+                    page_id: z.string(),
+                })
+                    .parse(change.value);
+                leadEvents.push({
+                    adId: value.ad_id,
+                    adgroupId: value.adgroup_id,
+                    createdTime: value.created_time,
+                    formId: value.form_id,
+                    leadgenId: value.leadgen_id,
+                    pageId: value.page_id,
+                });
+            }
+            else if (envelope.object === "ad_account") {
+                adAccountEvents.push({
+                    accountId: entry.id,
+                    field: change.field,
+                    occurredAt: entry.time,
+                    value: encodableSchema.parse(fromMeta(change.value)),
+                });
+            }
+        }
+    }
+    return { adAccountEvents, leadEvents };
+}

package/dist/meta-ads/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./api.js";
+export * from "./events.js";
+export * from "./schemas.js";

package/dist/meta-ads/index.js

@@ -0,0 +1,3 @@
+export * from "./api.js";
+export * from "./events.js";
+export * from "./schemas.js";