@automate.ax/integration-contracts 0.139.2 → 0.141.0

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";

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

@@ -0,0 +1,184 @@
+import * as z from "zod";
+export declare const META_ADS_ID_SCHEMA: z.ZodString;
+export declare const META_ADS_STATUS_SCHEMA: z.ZodEnum<{
+    ACTIVE: "ACTIVE";
+    ARCHIVED: "ARCHIVED";
+    DELETED: "DELETED";
+    PAUSED: "PAUSED";
+}>;
+export declare const META_ADS_BUSINESS_SCHEMA: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    verificationStatus: z.ZodOptional<z.ZodString>;
+}, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>;
+export declare const META_ADS_ACCOUNT_SCHEMA: z.ZodObject<{
+    accountId: z.ZodOptional<z.ZodString>;
+    amountSpent: z.ZodOptional<z.ZodString>;
+    balance: z.ZodOptional<z.ZodString>;
+    business: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>>;
+    currency: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    name: z.ZodString;
+    timezoneId: z.ZodOptional<z.ZodNumber>;
+    timezoneName: z.ZodOptional<z.ZodString>;
+}, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>;
+export declare const META_ADS_CAMPAIGN_SCHEMA: z.ZodObject<{
+    buyingType: z.ZodOptional<z.ZodString>;
+    configuredStatus: z.ZodOptional<z.ZodString>;
+    effectiveStatus: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    name: z.ZodString;
+    objective: z.ZodOptional<z.ZodString>;
+    specialAdCategories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    status: z.ZodOptional<z.ZodString>;
+}, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>;
+export declare const META_ADS_AD_SET_SCHEMA: z.ZodObject<{
+    bidAmount: z.ZodOptional<z.ZodNumber>;
+    billingEvent: z.ZodOptional<z.ZodString>;
+    campaignId: z.ZodOptional<z.ZodString>;
+    configuredStatus: z.ZodOptional<z.ZodString>;
+    dailyBudget: z.ZodOptional<z.ZodString>;
+    effectiveStatus: z.ZodOptional<z.ZodString>;
+    endTime: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    lifetimeBudget: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    optimizationGoal: z.ZodOptional<z.ZodString>;
+    startTime: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    targeting: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>;
+}, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>;
+export declare const META_ADS_AD_SCHEMA: z.ZodObject<{
+    adsetId: z.ZodOptional<z.ZodString>;
+    campaignId: z.ZodOptional<z.ZodString>;
+    configuredStatus: z.ZodOptional<z.ZodString>;
+    creative: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+    }, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>>;
+    effectiveStatus: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    name: z.ZodString;
+    status: z.ZodOptional<z.ZodString>;
+}, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>;
+export declare const META_ADS_CREATIVE_SCHEMA: z.ZodObject<{
+    accountId: z.ZodOptional<z.ZodString>;
+    body: z.ZodOptional<z.ZodString>;
+    effectiveObjectStoryId: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    objectStoryId: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>;
+export declare const META_ADS_AUDIENCE_SCHEMA: z.ZodObject<{
+    accountId: z.ZodOptional<z.ZodString>;
+    approximateCountLowerBound: z.ZodOptional<z.ZodNumber>;
+    approximateCountUpperBound: z.ZodOptional<z.ZodNumber>;
+    description: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    name: z.ZodString;
+    subtype: z.ZodOptional<z.ZodString>;
+}, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>;
+export declare const META_ADS_LEAD_FORM_SCHEMA: z.ZodObject<{
+    id: z.ZodString;
+    locale: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    status: z.ZodOptional<z.ZodString>;
+}, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>;
+export declare const META_ADS_LEAD_SCHEMA: z.ZodObject<{
+    adId: z.ZodOptional<z.ZodString>;
+    adName: z.ZodOptional<z.ZodString>;
+    adsetId: z.ZodOptional<z.ZodString>;
+    adsetName: z.ZodOptional<z.ZodString>;
+    campaignId: z.ZodOptional<z.ZodString>;
+    campaignName: z.ZodOptional<z.ZodString>;
+    createdTime: z.ZodOptional<z.ZodString>;
+    fieldData: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        values: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>>;
+    formId: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    isOrganic: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>;
+export declare const META_ADS_PIXEL_SCHEMA: z.ZodObject<{
+    code: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    isUnavailable: z.ZodOptional<z.ZodBoolean>;
+    lastFiredTime: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+}, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>;
+export declare const META_ADS_INSIGHT_SCHEMA: z.ZodObject<{
+    accountId: z.ZodOptional<z.ZodString>;
+    accountName: z.ZodOptional<z.ZodString>;
+    adId: z.ZodOptional<z.ZodString>;
+    adName: z.ZodOptional<z.ZodString>;
+    adsetId: z.ZodOptional<z.ZodString>;
+    adsetName: z.ZodOptional<z.ZodString>;
+    campaignId: z.ZodOptional<z.ZodString>;
+    campaignName: z.ZodOptional<z.ZodString>;
+    clicks: z.ZodOptional<z.ZodString>;
+    cpc: z.ZodOptional<z.ZodString>;
+    cpm: z.ZodOptional<z.ZodString>;
+    ctr: z.ZodOptional<z.ZodString>;
+    dateStart: z.ZodOptional<z.ZodString>;
+    dateStop: z.ZodOptional<z.ZodString>;
+    impressions: z.ZodOptional<z.ZodString>;
+    reach: z.ZodOptional<z.ZodString>;
+    spend: z.ZodOptional<z.ZodString>;
+}, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>;
+export declare const META_ADS_SUBSCRIPTION_SCHEMA: z.ZodObject<{
+    eventType: z.ZodEnum<{
+        INSIGHTS_MILESTONE_REACHED: "INSIGHTS_MILESTONE_REACHED";
+        INSIGHTS_UPDATED: "INSIGHTS_UPDATED";
+        OBJECT_CREATED: "OBJECT_CREATED";
+        OBJECT_UPDATED: "OBJECT_UPDATED";
+    }>;
+    field: z.ZodOptional<z.ZodString>;
+    filters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        operator: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>>>;
+    operator: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    subscriptionId: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    value: z.ZodOptional<z.ZodString>;
+}, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>;
+export declare const META_ADS_SUBSCRIPTION_CREATE_RESULT_SCHEMA: z.ZodObject<{
+    subscriptionId: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+}, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>;
+export declare const META_ADS_MUTATION_RESULT_SCHEMA: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    success: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>;
+export declare const META_ADS_CONVERSION_RESULT_SCHEMA: z.ZodObject<{
+    eventsReceived: z.ZodNumber;
+    fbtraceId: z.ZodOptional<z.ZodString>;
+    messages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>;
+export declare const META_ADS_PAGE_INFO_SCHEMA: z.ZodObject<{
+    after: z.ZodOptional<z.ZodString>;
+    before: z.ZodOptional<z.ZodString>;
+    next: z.ZodOptional<z.ZodString>;
+    previous: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const META_ADS_WEBHOOK_CHANGE_SCHEMA: z.ZodObject<{
+    field: z.ZodString;
+    value: z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>;
+}, z.core.$strip>;
+export declare const META_ADS_WEBHOOK_ENVELOPE_SCHEMA: z.ZodObject<{
+    entry: z.ZodArray<z.ZodObject<{
+        changes: z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            value: z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>;
+        }, z.core.$strip>>;
+        id: z.ZodString;
+        time: z.ZodNumber;
+    }, z.core.$strip>>;
+    object: z.ZodString;
+}, z.core.$strip>;
+export type MetaAdsWebhookEnvelope = z.output<typeof META_ADS_WEBHOOK_ENVELOPE_SCHEMA>;

package/dist/meta-ads/schemas.js

@@ -0,0 +1,181 @@
+import * as z from "zod";
+import { encodableSchema } from "@automate.ax/codec";
+const metaObject = (shape) => z.object(shape).catchall(encodableSchema);
+export const META_ADS_ID_SCHEMA = z.string().trim().min(1);
+export const META_ADS_STATUS_SCHEMA = z.enum([
+    "ACTIVE",
+    "ARCHIVED",
+    "DELETED",
+    "PAUSED",
+]);
+export const META_ADS_BUSINESS_SCHEMA = metaObject({
+    id: META_ADS_ID_SCHEMA,
+    name: z.string(),
+    verificationStatus: z.string().optional(),
+});
+export const META_ADS_ACCOUNT_SCHEMA = metaObject({
+    accountId: z.string().optional(),
+    amountSpent: z.string().optional(),
+    balance: z.string().optional(),
+    business: metaObject({
+        id: z.string(),
+        name: z.string().optional(),
+    }).optional(),
+    currency: z.string().optional(),
+    id: META_ADS_ID_SCHEMA,
+    name: z.string(),
+    timezoneId: z.number().optional(),
+    timezoneName: z.string().optional(),
+});
+export const META_ADS_CAMPAIGN_SCHEMA = metaObject({
+    buyingType: z.string().optional(),
+    configuredStatus: z.string().optional(),
+    effectiveStatus: z.string().optional(),
+    id: META_ADS_ID_SCHEMA,
+    name: z.string(),
+    objective: z.string().optional(),
+    specialAdCategories: z.string().array().optional(),
+    status: z.string().optional(),
+});
+export const META_ADS_AD_SET_SCHEMA = metaObject({
+    bidAmount: z.number().optional(),
+    billingEvent: z.string().optional(),
+    campaignId: META_ADS_ID_SCHEMA.optional(),
+    configuredStatus: z.string().optional(),
+    dailyBudget: z.string().optional(),
+    effectiveStatus: z.string().optional(),
+    endTime: z.string().optional(),
+    id: META_ADS_ID_SCHEMA,
+    lifetimeBudget: z.string().optional(),
+    name: z.string(),
+    optimizationGoal: z.string().optional(),
+    startTime: z.string().optional(),
+    status: z.string().optional(),
+    targeting: z.record(z.string(), encodableSchema).optional(),
+});
+export const META_ADS_AD_SCHEMA = metaObject({
+    adsetId: META_ADS_ID_SCHEMA.optional(),
+    campaignId: META_ADS_ID_SCHEMA.optional(),
+    configuredStatus: z.string().optional(),
+    creative: metaObject({ id: z.string() }).optional(),
+    effectiveStatus: z.string().optional(),
+    id: META_ADS_ID_SCHEMA,
+    name: z.string(),
+    status: z.string().optional(),
+});
+export const META_ADS_CREATIVE_SCHEMA = metaObject({
+    accountId: z.string().optional(),
+    body: z.string().optional(),
+    effectiveObjectStoryId: z.string().optional(),
+    id: META_ADS_ID_SCHEMA,
+    name: z.string().optional(),
+    objectStoryId: z.string().optional(),
+    status: z.string().optional(),
+    title: z.string().optional(),
+});
+export const META_ADS_AUDIENCE_SCHEMA = metaObject({
+    accountId: z.string().optional(),
+    approximateCountLowerBound: z.number().optional(),
+    approximateCountUpperBound: z.number().optional(),
+    description: z.string().optional(),
+    id: META_ADS_ID_SCHEMA,
+    name: z.string(),
+    subtype: z.string().optional(),
+});
+export const META_ADS_LEAD_FORM_SCHEMA = metaObject({
+    id: META_ADS_ID_SCHEMA,
+    locale: z.string().optional(),
+    name: z.string(),
+    status: z.string().optional(),
+});
+export const META_ADS_LEAD_SCHEMA = metaObject({
+    adId: z.string().optional(),
+    adName: z.string().optional(),
+    adsetId: z.string().optional(),
+    adsetName: z.string().optional(),
+    campaignId: z.string().optional(),
+    campaignName: z.string().optional(),
+    createdTime: z.string().optional(),
+    fieldData: z
+        .object({ name: z.string(), values: z.string().array() })
+        .array()
+        .optional(),
+    formId: z.string().optional(),
+    id: META_ADS_ID_SCHEMA,
+    isOrganic: z.boolean().optional(),
+});
+export const META_ADS_PIXEL_SCHEMA = metaObject({
+    code: z.string().optional(),
+    id: META_ADS_ID_SCHEMA,
+    isUnavailable: z.boolean().optional(),
+    lastFiredTime: z.string().optional(),
+    name: z.string(),
+});
+export const META_ADS_INSIGHT_SCHEMA = metaObject({
+    accountId: z.string().optional(),
+    accountName: z.string().optional(),
+    adId: z.string().optional(),
+    adName: z.string().optional(),
+    adsetId: z.string().optional(),
+    adsetName: z.string().optional(),
+    campaignId: z.string().optional(),
+    campaignName: z.string().optional(),
+    clicks: z.string().optional(),
+    cpc: z.string().optional(),
+    cpm: z.string().optional(),
+    ctr: z.string().optional(),
+    dateStart: z.string().optional(),
+    dateStop: z.string().optional(),
+    impressions: z.string().optional(),
+    reach: z.string().optional(),
+    spend: z.string().optional(),
+});
+export const META_ADS_SUBSCRIPTION_SCHEMA = metaObject({
+    eventType: z.enum([
+        "INSIGHTS_MILESTONE_REACHED",
+        "INSIGHTS_UPDATED",
+        "OBJECT_CREATED",
+        "OBJECT_UPDATED",
+    ]),
+    field: z.string().optional(),
+    filters: z
+        .object({ field: z.string(), operator: z.string(), value: z.string() })
+        .array()
+        .optional(),
+    operator: z.string().optional(),
+    status: z.string().optional(),
+    subscriptionId: z.union([META_ADS_ID_SCHEMA, z.number()]).transform(String),
+    value: z.string().optional(),
+});
+export const META_ADS_SUBSCRIPTION_CREATE_RESULT_SCHEMA = metaObject({
+    subscriptionId: z.union([META_ADS_ID_SCHEMA, z.number()]).transform(String),
+});
+export const META_ADS_MUTATION_RESULT_SCHEMA = metaObject({
+    id: z.string().optional(),
+    success: z.boolean().optional(),
+});
+export const META_ADS_CONVERSION_RESULT_SCHEMA = metaObject({
+    eventsReceived: z.number().int().nonnegative(),
+    fbtraceId: z.string().optional(),
+    messages: z.string().array().optional(),
+});
+export const META_ADS_PAGE_INFO_SCHEMA = z.object({
+    after: z.string().optional(),
+    before: z.string().optional(),
+    next: z.string().url().optional(),
+    previous: z.string().url().optional(),
+});
+export const META_ADS_WEBHOOK_CHANGE_SCHEMA = z.object({
+    field: z.string(),
+    value: encodableSchema,
+});
+export const META_ADS_WEBHOOK_ENVELOPE_SCHEMA = z.object({
+    entry: z
+        .object({
+        changes: META_ADS_WEBHOOK_CHANGE_SCHEMA.array(),
+        id: z.string(),
+        time: z.number(),
+    })
+        .array(),
+    object: z.string(),
+});

package/dist/triggers.d.ts

@@ -19,6 +19,7 @@ import type { googleSheetsTriggerContracts } from "./google-sheets/index.js";
 import type { hubspotTriggerContracts } from "./hubspot/index.js";
 import type { linearTriggerContracts } from "./linear/index.js";
 import type { millionVerifierTriggerContracts } from "./millionverifier/index.js";
+import type { metaAdsTriggerContracts } from "./meta-ads/index.js";
 import type { notionTriggerContracts } from "./notion/index.js";
 import type { outlookTriggerContracts } from "./outlook/index.js";
 import type { redditTriggerContracts } from "./reddit/index.js";
@@ -31,7 +32,7 @@ import type { vercelTriggerContracts } from "./vercel/index.js";
 import type { webflowTriggerContracts } from "./webflow/index.js";
 import type { whatsappTriggerContracts } from "./whatsapp/index.js";
 import type { z } from "zod";
-export type TriggerContractMap = typeof airtableTriggerContracts & typeof anthropicTriggerContracts & typeof apifyTriggerContracts & typeof axiomTriggerContracts & typeof automateTriggerContracts & typeof asanaTriggerContracts & typeof brevoTriggerContracts & typeof convexTriggerContracts & typeof discordTriggerContracts & typeof closeTriggerContracts & typeof cloudflareTriggerContracts & typeof githubTriggerContracts & typeof gmailTriggerContracts & typeof googleCalendarTriggerContracts & typeof googleDriveTriggerContracts & typeof googleFormsTriggerContracts & typeof googleMeetTriggerContracts & typeof googleSheetsTriggerContracts & typeof hubspotTriggerContracts & typeof linearTriggerContracts & typeof millionVerifierTriggerContracts & typeof notionTriggerContracts & typeof outlookTriggerContracts & typeof redditTriggerContracts & typeof resendTriggerContracts & typeof slackTriggerContracts & typeof stripeTriggerContracts & typeof teamsTriggerContracts & typeof trelloTriggerContracts & typeof vercelTriggerContracts & typeof webflowTriggerContracts & typeof whatsappTriggerContracts;
+export type TriggerContractMap = typeof airtableTriggerContracts & typeof anthropicTriggerContracts & typeof apifyTriggerContracts & typeof axiomTriggerContracts & typeof automateTriggerContracts & typeof asanaTriggerContracts & typeof brevoTriggerContracts & typeof convexTriggerContracts & typeof discordTriggerContracts & typeof closeTriggerContracts & typeof cloudflareTriggerContracts & typeof githubTriggerContracts & typeof gmailTriggerContracts & typeof googleCalendarTriggerContracts & typeof googleDriveTriggerContracts & typeof googleFormsTriggerContracts & typeof googleMeetTriggerContracts & typeof googleSheetsTriggerContracts & typeof hubspotTriggerContracts & typeof linearTriggerContracts & typeof millionVerifierTriggerContracts & typeof metaAdsTriggerContracts & typeof notionTriggerContracts & typeof outlookTriggerContracts & typeof redditTriggerContracts & typeof resendTriggerContracts & typeof slackTriggerContracts & typeof stripeTriggerContracts & typeof teamsTriggerContracts & typeof trelloTriggerContracts & typeof vercelTriggerContracts & typeof webflowTriggerContracts & typeof whatsappTriggerContracts;
 export type IntegrationTriggerType = keyof TriggerContractMap;
 /** Canonical authoring configuration for one integration trigger type. */
 export type TriggerConfig<TType extends IntegrationTriggerType> = z.input<TriggerContractMap[TType]["configSchema"]> extends Record<string, never> ? object : z.input<TriggerContractMap[TType]["configSchema"]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automate.ax/integration-contracts",
-  "version": "0.139.2",
+  "version": "0.141.0",
   "description": "Shared integration payload contracts and provider primitives for Automate.ax.",
   "license": "MIT",
   "repository": {
@@ -26,9 +26,11 @@
       "./asana": "./src/asana/index.ts",
       "./brevo": "./src/brevo/index.ts",
       "./cloudflare": "./src/cloudflare/index.ts",
+      "./meta-ads": "./src/meta-ads/index.ts",
       "./convex": "./src/convex/index.ts",
       "./discord": "./src/discord/index.ts",
       "./close": "./src/close/index.ts",
+      "./closebot": "./src/closebot/index.ts",
       "./gmail": "./src/gmail/index.ts",
       "./google-calendar": "./src/google-calendar/index.ts",
       "./google-drive": "./src/google-drive/index.ts",
@@ -61,7 +63,7 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "0.123.0",
-    "@automate.ax/codec": "0.139.2",
+    "@automate.ax/codec": "0.141.0",
     "@cfworker/json-schema": "^4.1.1",
     "@googleapis/calendar": "^16.0.0",
     "@googleapis/forms": "^6.0.1",
@@ -154,6 +156,11 @@
       "types": "./dist/cloudflare/index.d.ts",
       "default": "./dist/cloudflare/index.js"
     },
+    "./meta-ads": {
+      "bun": "./src/meta-ads/index.ts",
+      "types": "./dist/meta-ads/index.d.ts",
+      "default": "./dist/meta-ads/index.js"
+    },
     "./convex": {
       "bun": "./src/convex/index.ts",
       "types": "./dist/convex/index.d.ts",
@@ -169,6 +176,11 @@
       "types": "./dist/close/index.d.ts",
       "default": "./dist/close/index.js"
     },
+    "./closebot": {
+      "bun": "./src/closebot/index.ts",
+      "types": "./dist/closebot/index.d.ts",
+      "default": "./dist/closebot/index.js"
+    },
     "./gmail": {
       "bun": "./src/gmail/index.ts",
       "types": "./dist/gmail/index.d.ts",