@automate.ax/integration-contracts 0.139.1 → 0.141.0

package/dist/meta-ads/api.js

@@ -0,0 +1,260 @@
+import * as z from "zod";
+import { META_ADS_PAGE_INFO_SCHEMA } from "./schemas.js";
+export const META_ADS_GRAPH_API_VERSION = "v26.0";
+const META_ADS_API_BASE_URL = `https://graph.facebook.com/${META_ADS_GRAPH_API_VERSION}/`;
+const META_ADS_API_ORIGIN = new URL(META_ADS_API_BASE_URL).origin;
+export const META_ADS_OAUTH_SECRET_SCHEMA = z.object({
+    accessToken: z.string().min(1),
+    expiresAt: z.number().nullable(),
+    tokenType: z.string(),
+});
+const META_ERROR_SCHEMA = z.looseObject({
+    code: z.number().optional(),
+    errorSubcode: z.number().optional(),
+    errorUserMessage: z.string().optional(),
+    fbtraceId: z.string().optional(),
+    isTransient: z.boolean().optional(),
+    message: z.string(),
+    type: z.string().optional(),
+});
+const ERROR_ENVELOPE_SCHEMA = z.looseObject({ error: META_ERROR_SCHEMA });
+const PAGE_SCHEMA = z.looseObject({
+    data: z.unknown(),
+    paging: z
+        .looseObject({
+        cursors: z
+            .looseObject({
+            after: z.string().optional(),
+            before: z.string().optional(),
+        })
+            .optional(),
+        next: z.string().optional(),
+        previous: z.string().optional(),
+    })
+        .optional(),
+});
+/** Structured Graph API failure with Meta quota and trace diagnostics. */
+export class MetaAdsApiError extends Error {
+    appUsage;
+    businessUseCaseUsage;
+    code;
+    fbtraceId;
+    isTransient;
+    adAccountUsage;
+    errorSubcode;
+    retryAfter;
+    status;
+    /**
+     * Creates a structured Meta Ads failure.
+     *
+     * @param options - Transport, provider, and quota details.
+     * @param options.adAccountUsage - Raw ad-account usage header.
+     * @param options.appUsage - Raw app usage header.
+     * @param options.businessUseCaseUsage - Raw business-use-case usage header.
+     * @param options.error - Parsed provider error.
+     * @param options.retryAfter - Retry delay in seconds.
+     * @param options.status - HTTP response status.
+     */
+    constructor(options) {
+        const providerError = options.error;
+        super(providerError?.message
+            ? `Meta Ads API error (${providerError.code ?? options.status}): ${providerError.message}`
+            : `Meta Ads API request failed with status ${options.status}.`);
+        this.name = "MetaAdsApiError";
+        this.adAccountUsage = options.adAccountUsage;
+        this.appUsage = options.appUsage;
+        this.businessUseCaseUsage = options.businessUseCaseUsage;
+        this.code = providerError?.code;
+        this.errorSubcode = providerError?.errorSubcode;
+        this.fbtraceId = providerError?.fbtraceId;
+        this.isTransient = providerError?.isTransient ?? false;
+        this.retryAfter = options.retryAfter;
+        this.status = options.status;
+    }
+}
+/**
+ * Creates the authenticated Graph API helper used by packaged and custom
+ * actions.
+ *
+ * @param account - Resolved Meta Ads OAuth account.
+ * @throws When the connection method or stored credential is invalid.
+ */
+export function getMetaAdsApi(account) {
+    if (account.connectionMethodId !== "oauth") {
+        throw new Error(`Unsupported Meta Ads connection method: ${account.connectionMethodId}`);
+    }
+    const { accessToken } = META_ADS_OAUTH_SECRET_SCHEMA.parse(account.secret);
+    /**
+     * Calls one Graph endpoint and validates its normalized result.
+     *
+     * @param path - Path relative to the pinned Graph root.
+     * @param options - Request options and response schema.
+     */
+    async function call(path, options) {
+        return options.responseSchema.parse(fromMeta(await rawRequest(path, options)));
+    }
+    /**
+     * Calls one Graph edge and preserves cursor metadata.
+     *
+     * @param path - Path relative to the pinned Graph root.
+     * @param options - Request options and item schema.
+     */
+    async function page(path, options) {
+        const parsed = PAGE_SCHEMA.parse(await rawRequest(path, options));
+        const paging = parsed.paging;
+        return {
+            items: options.responseSchema.parse(fromMeta(parsed.data)),
+            ...(paging && {
+                pageInfo: META_ADS_PAGE_INFO_SCHEMA.parse({
+                    after: paging.cursors?.after,
+                    before: paging.cursors?.before,
+                    next: paging.next,
+                    previous: paging.previous,
+                }),
+            }),
+        };
+    }
+    /**
+     * Executes one authenticated request and returns its raw JSON value.
+     *
+     * @param path - Path relative to the pinned Graph root.
+     * @param options - Request method, query, and body.
+     */
+    async function rawRequest(path, options) {
+        const url = new URL(path.replace(/^\/+/, ""), META_ADS_API_BASE_URL);
+        if (url.origin !== META_ADS_API_ORIGIN ||
+            !url.pathname.startsWith(`/${META_ADS_GRAPH_API_VERSION}/`)) {
+            throw new Error(`Meta Ads API paths must remain under /${META_ADS_GRAPH_API_VERSION}.`);
+        }
+        for (const [name, value] of Object.entries(options.query ?? {})) {
+            if (value !== undefined) {
+                url.searchParams.set(toSnakeCase(name), Array.isArray(value) ? value.join(",") : String(value));
+            }
+        }
+        const body = options.body === undefined ? undefined : toFormData(options.body);
+        const response = await fetch(url, {
+            body,
+            headers: { Authorization: `Bearer ${accessToken}` },
+            method: options.method ?? (body ? "POST" : "GET"),
+        });
+        const payload = parseJson(await response.text());
+        if (!response.ok) {
+            const error = ERROR_ENVELOPE_SCHEMA.safeParse(fromMeta(payload));
+            throw new MetaAdsApiError({
+                adAccountUsage: response.headers.get("X-Ad-Account-Usage") ?? undefined,
+                appUsage: response.headers.get("X-App-Usage") ?? undefined,
+                businessUseCaseUsage: response.headers.get("X-Business-Use-Case-Usage") ?? undefined,
+                error: error.success ? error.data.error : undefined,
+                retryAfter: numberOrUndefined(response.headers.get("Retry-After")),
+                status: response.status,
+            });
+        }
+        return payload;
+    }
+    return { call, page };
+}
+/**
+ * Encodes one public request body for Graph's form boundary.
+ *
+ * @param value - Codec-safe public request body.
+ * @throws When the body is not an object.
+ */
+function toFormData(value) {
+    if (!isRecord(value))
+        throw new Error("Meta Ads request bodies must be objects.");
+    const form = new URLSearchParams();
+    for (const [name, item] of Object.entries(value)) {
+        if (item === undefined)
+            continue;
+        form.set(toSnakeCase(name), typeof item === "string" ||
+            typeof item === "number" ||
+            typeof item === "boolean"
+            ? String(item)
+            : item instanceof Date
+                ? item.toISOString()
+                : JSON.stringify(toMeta(item)));
+    }
+    return form;
+}
+/**
+ * Converts public camelCase object keys to Meta wire keys recursively.
+ *
+ * @param value - Codec-safe public value.
+ */
+export function toMeta(value) {
+    if (value instanceof Date)
+        return value.toISOString();
+    if (Array.isArray(value))
+        return value.map(toMeta);
+    if (!isRecord(value))
+        return value;
+    return Object.fromEntries(Object.entries(value).map(([key, item]) => [
+        toSnakeCase(key),
+        toMeta(item),
+    ]));
+}
+/**
+ * Converts Meta wire keys to public camelCase keys recursively.
+ *
+ * @param value - Provider value.
+ */
+export function fromMeta(value) {
+    if (Array.isArray(value))
+        return value.map(fromMeta);
+    if (!isRecord(value))
+        return value;
+    return Object.fromEntries(Object.entries(value).map(([key, item]) => [
+        toCamelCase(key),
+        fromMeta(item),
+    ]));
+}
+/**
+ * Converts one camelCase key to snake_case.
+ *
+ * @param value - Public key.
+ */
+function toSnakeCase(value) {
+    return value.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`);
+}
+/**
+ * Converts one snake_case key to camelCase.
+ *
+ * @param value - Provider key.
+ */
+function toCamelCase(value) {
+    return value.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
+}
+/**
+ * Parses a response body while retaining non-JSON provider failures.
+ *
+ * @param text - Raw response body.
+ */
+function parseJson(text) {
+    if (text === "")
+        return undefined;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+/**
+ * Parses an optional finite numeric header.
+ *
+ * @param value - Raw header value.
+ */
+function numberOrUndefined(value) {
+    if (value === null)
+        return undefined;
+    const number = Number(value);
+    return Number.isFinite(number) ? number : undefined;
+}
+/**
+ * Narrows one codec-safe object value.
+ *
+ * @param value - Unknown value.
+ */
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}

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;