@automate.ax/integration-contracts 0.139.2 → 0.142.0

package/dist/google-ads/schemas.js

@@ -0,0 +1,249 @@
+import * as z from "zod";
+import { GOOGLE_ADS_CUSTOMER_ID_SCHEMA } from "./api.js";
+const DECIMAL_STRING_SCHEMA = z.string().regex(/^\d+$/);
+const GOOGLE_ADS_STATUS_SCHEMA = z.enum([
+    "UNSPECIFIED",
+    "UNKNOWN",
+    "ENABLED",
+    "PAUSED",
+    "REMOVED",
+]);
+export const GOOGLE_ADS_CUSTOMER_SCHEMA = z
+    .object({
+    autoTaggingEnabled: z.boolean().optional(),
+    currencyCode: z.string().optional(),
+    descriptiveName: z.string().optional(),
+    id: DECIMAL_STRING_SCHEMA.optional(),
+    manager: z.boolean().optional(),
+    resourceName: z.string(),
+    testAccount: z.boolean().optional(),
+    timeZone: z.string().optional(),
+})
+    .catchall(z.json());
+export const GOOGLE_ADS_CUSTOMER_CLIENT_SCHEMA = z
+    .object({
+    clientCustomer: z.string(),
+    currencyCode: z.string().optional(),
+    descriptiveName: z.string().optional(),
+    hidden: z.boolean().optional(),
+    id: DECIMAL_STRING_SCHEMA.optional(),
+    level: z.string().optional(),
+    manager: z.boolean().optional(),
+    resourceName: z.string(),
+    testAccount: z.boolean().optional(),
+    timeZone: z.string().optional(),
+})
+    .catchall(z.json());
+export const GOOGLE_ADS_CAMPAIGN_SCHEMA = z
+    .object({
+    advertisingChannelSubType: z.string().optional(),
+    advertisingChannelType: z.string().optional(),
+    campaignBudget: z.string().optional(),
+    endDateTime: z.string().optional(),
+    id: DECIMAL_STRING_SCHEMA.optional(),
+    name: z.string().optional(),
+    resourceName: z.string(),
+    servingStatus: z.string().optional(),
+    startDateTime: z.string().optional(),
+    status: GOOGLE_ADS_STATUS_SCHEMA.optional(),
+})
+    .catchall(z.json());
+export const GOOGLE_ADS_CAMPAIGN_BUDGET_SCHEMA = z
+    .object({
+    amountMicros: DECIMAL_STRING_SCHEMA.optional(),
+    deliveryMethod: z.string().optional(),
+    explicitlyShared: z.boolean().optional(),
+    id: DECIMAL_STRING_SCHEMA.optional(),
+    name: z.string().optional(),
+    resourceName: z.string(),
+    status: z.string().optional(),
+    totalAmountMicros: DECIMAL_STRING_SCHEMA.optional(),
+})
+    .catchall(z.json());
+export const GOOGLE_ADS_AD_GROUP_SCHEMA = z
+    .object({
+    campaign: z.string().optional(),
+    cpcBidMicros: DECIMAL_STRING_SCHEMA.optional(),
+    id: DECIMAL_STRING_SCHEMA.optional(),
+    name: z.string().optional(),
+    resourceName: z.string(),
+    status: GOOGLE_ADS_STATUS_SCHEMA.optional(),
+    targetCpaMicros: DECIMAL_STRING_SCHEMA.optional(),
+    type: z.string().optional(),
+})
+    .catchall(z.json());
+export const GOOGLE_ADS_AD_SCHEMA = z
+    .object({
+    finalUrls: z.string().array().optional(),
+    id: DECIMAL_STRING_SCHEMA.optional(),
+    name: z.string().optional(),
+    resourceName: z.string(),
+    responsiveSearchAd: z
+        .object({
+        descriptions: z
+            .object({ text: z.string() })
+            .catchall(z.json())
+            .array()
+            .optional(),
+        headlines: z
+            .object({ text: z.string() })
+            .catchall(z.json())
+            .array()
+            .optional(),
+        path1: z.string().optional(),
+        path2: z.string().optional(),
+    })
+        .catchall(z.json())
+        .optional(),
+    type: z.string().optional(),
+})
+    .catchall(z.json());
+export const GOOGLE_ADS_AD_GROUP_AD_SCHEMA = z
+    .object({
+    ad: GOOGLE_ADS_AD_SCHEMA.optional(),
+    adGroup: z.string().optional(),
+    policySummary: z.record(z.string(), z.json()).optional(),
+    resourceName: z.string(),
+    status: GOOGLE_ADS_STATUS_SCHEMA.optional(),
+})
+    .catchall(z.json());
+export const GOOGLE_ADS_ASSET_SCHEMA = z
+    .object({
+    id: DECIMAL_STRING_SCHEMA.optional(),
+    name: z.string().optional(),
+    resourceName: z.string(),
+    type: z.string().optional(),
+})
+    .catchall(z.json());
+export const GOOGLE_ADS_CONVERSION_ACTION_SCHEMA = z
+    .object({
+    category: z.string().optional(),
+    clickThroughLookbackWindowDays: z.string().optional(),
+    countingType: z.string().optional(),
+    id: DECIMAL_STRING_SCHEMA.optional(),
+    name: z.string().optional(),
+    primaryForGoal: z.boolean().optional(),
+    resourceName: z.string(),
+    status: z
+        .enum(["UNSPECIFIED", "UNKNOWN", "ENABLED", "REMOVED", "HIDDEN"])
+        .optional(),
+    type: z.string().optional(),
+    valueSettings: z
+        .object({
+        alwaysUseDefaultValue: z.boolean().optional(),
+        defaultCurrencyCode: z.string().optional(),
+        defaultValue: z.number().optional(),
+    })
+        .catchall(z.json())
+        .optional(),
+})
+    .catchall(z.json());
+export const GOOGLE_ADS_AUDIENCE_SCHEMA = z
+    .object({
+    description: z.string().optional(),
+    dimensions: z.json().array().optional(),
+    id: DECIMAL_STRING_SCHEMA.optional(),
+    name: z.string().optional(),
+    resourceName: z.string(),
+    status: GOOGLE_ADS_STATUS_SCHEMA.optional(),
+})
+    .catchall(z.json());
+export const GOOGLE_ADS_USER_LIST_SCHEMA = z
+    .object({
+    description: z.string().optional(),
+    id: DECIMAL_STRING_SCHEMA.optional(),
+    membershipLifeSpan: z.string().optional(),
+    membershipStatus: z.string().optional(),
+    name: z.string().optional(),
+    resourceName: z.string(),
+    sizeForDisplay: DECIMAL_STRING_SCHEMA.optional(),
+    sizeForSearch: DECIMAL_STRING_SCHEMA.optional(),
+    type: z.string().optional(),
+})
+    .catchall(z.json());
+export const GOOGLE_ADS_SEARCH_ROW_SCHEMA = z
+    .object({
+    adGroup: GOOGLE_ADS_AD_GROUP_SCHEMA.optional(),
+    adGroupAd: GOOGLE_ADS_AD_GROUP_AD_SCHEMA.optional(),
+    asset: GOOGLE_ADS_ASSET_SCHEMA.optional(),
+    audience: GOOGLE_ADS_AUDIENCE_SCHEMA.optional(),
+    campaign: GOOGLE_ADS_CAMPAIGN_SCHEMA.optional(),
+    campaignBudget: GOOGLE_ADS_CAMPAIGN_BUDGET_SCHEMA.optional(),
+    conversionAction: GOOGLE_ADS_CONVERSION_ACTION_SCHEMA.optional(),
+    customer: GOOGLE_ADS_CUSTOMER_SCHEMA.optional(),
+    customerClient: GOOGLE_ADS_CUSTOMER_CLIENT_SCHEMA.optional(),
+    metrics: z.record(z.string(), z.json()).optional(),
+    segments: z.record(z.string(), z.json()).optional(),
+    userList: GOOGLE_ADS_USER_LIST_SCHEMA.optional(),
+})
+    .catchall(z.json());
+export const GOOGLE_ADS_SEARCH_PAGE_SCHEMA = z.object({
+    fieldMask: z.string().optional(),
+    nextPageToken: z.string().optional(),
+    queryResourceConsumption: z.string().optional(),
+    results: GOOGLE_ADS_SEARCH_ROW_SCHEMA.array().prefault([]),
+    summaryRow: GOOGLE_ADS_SEARCH_ROW_SCHEMA.optional(),
+    totalResultsCount: DECIMAL_STRING_SCHEMA.optional(),
+});
+export const GOOGLE_ADS_MUTATE_RESULT_SCHEMA = z.object({
+    resourceName: z.string(),
+});
+export const GOOGLE_ADS_MUTATE_RESPONSE_SCHEMA = z.object({
+    results: GOOGLE_ADS_MUTATE_RESULT_SCHEMA.array(),
+});
+export const GOOGLE_ADS_CUSTOMER_CONTEXT_SCHEMA = z.object({
+    customerId: GOOGLE_ADS_CUSTOMER_ID_SCHEMA,
+    loginCustomerId: GOOGLE_ADS_CUSTOMER_ID_SCHEMA.optional(),
+});
+export const GOOGLE_ADS_CHANGE_RESOURCE_TYPE_SCHEMA = z.enum([
+    "UNSPECIFIED",
+    "UNKNOWN",
+    "AD",
+    "AD_GROUP",
+    "AD_GROUP_AD",
+    "AD_GROUP_ASSET",
+    "AD_GROUP_BID_MODIFIER",
+    "AD_GROUP_CRITERION",
+    "AD_GROUP_FEED",
+    "ASSET",
+    "ASSET_SET",
+    "ASSET_SET_ASSET",
+    "CAMPAIGN",
+    "CAMPAIGN_ASSET",
+    "CAMPAIGN_ASSET_SET",
+    "CAMPAIGN_BUDGET",
+    "CAMPAIGN_CRITERION",
+    "CAMPAIGN_FEED",
+    "CUSTOMER_ASSET",
+    "FEED",
+    "FEED_ITEM",
+]);
+export const GOOGLE_ADS_CHANGE_EVENT_SCHEMA = z.object({
+    adGroup: z.string().optional(),
+    asset: z.string().optional(),
+    campaign: z.string().optional(),
+    changeDateTime: z.string(),
+    changeResourceName: z.string(),
+    changeResourceType: GOOGLE_ADS_CHANGE_RESOURCE_TYPE_SCHEMA,
+    changedFields: z.string().optional(),
+    clientType: z.string().optional(),
+    newResource: z.record(z.string(), z.json()).optional(),
+    oldResource: z.record(z.string(), z.json()).optional(),
+    resourceChangeOperation: z.enum([
+        "UNSPECIFIED",
+        "UNKNOWN",
+        "CREATE",
+        "UPDATE",
+        "REMOVE",
+    ]),
+    resourceName: z.string(),
+    userEmail: z.string().optional(),
+});
+export const GOOGLE_ADS_CHANGE_TRIGGER_CONFIG_SCHEMA = z.object({
+    customerId: GOOGLE_ADS_CUSTOMER_ID_SCHEMA,
+    loginCustomerId: GOOGLE_ADS_CUSTOMER_ID_SCHEMA.optional(),
+});
+export const GOOGLE_ADS_CHANGE_EVENT_PAYLOAD_SCHEMA = z.object({
+    customerId: GOOGLE_ADS_CUSTOMER_ID_SCHEMA,
+    event: GOOGLE_ADS_CHANGE_EVENT_SCHEMA,
+});

package/dist/google-drive/index.d.ts

@@ -44,13 +44,13 @@ export declare const GOOGLE_DRIVE_EVENT_SCHEMA: z.ZodObject<{
         cancelled: "cancelled";
         completed: "completed";
         deleted: "deleted";
+        resolved: "resolved";
         moved: "moved";
         contentChanged: "contentChanged";
         edited: "edited";
         reopened: "reopened";
         renamed: "renamed";
         reset: "reset";
-        resolved: "resolved";
         responded: "responded";
         reviewersChanged: "reviewersChanged";
         trashed: "trashed";
@@ -71,8 +71,8 @@ export declare const GOOGLE_DRIVE_EVENT_SCHEMA: z.ZodObject<{
     resourceIds: z.ZodArray<z.ZodString>;
     resourceType: z.ZodEnum<{
         file: "file";
-        reply: "reply";
         comment: "comment";
+        reply: "reply";
         accessProposal: "accessProposal";
         approval: "approval";
         permission: "permission";
@@ -958,13 +958,13 @@ export declare const googleDriveTriggerContracts: {
                 cancelled: "cancelled";
                 completed: "completed";
                 deleted: "deleted";
+                resolved: "resolved";
                 moved: "moved";
                 contentChanged: "contentChanged";
                 edited: "edited";
                 reopened: "reopened";
                 renamed: "renamed";
                 reset: "reset";
-                resolved: "resolved";
                 responded: "responded";
                 reviewersChanged: "reviewersChanged";
                 trashed: "trashed";
@@ -985,8 +985,8 @@ export declare const googleDriveTriggerContracts: {
             resourceIds: z.ZodArray<z.ZodString>;
             resourceType: z.ZodEnum<{
                 file: "file";
-                reply: "reply";
                 comment: "comment";
+                reply: "reply";
                 accessProposal: "accessProposal";
                 approval: "approval";
                 permission: "permission";
@@ -1038,7 +1038,7 @@ export declare function toGoogleDriveTriggerType(providerEventType: string): Goo
  * @param eventType - Stable internal semantic event type.
  */
 export declare function parseGoogleDriveTriggerType(eventType: GoogleDriveTriggerType): {
-    action: "created" | "cancelled" | "completed" | "deleted" | "moved" | "contentChanged" | "edited" | "reopened" | "renamed" | "reset" | "resolved" | "responded" | "reviewersChanged" | "trashed" | "untrashed";
-    resourceType: "file" | "reply" | "comment" | "accessProposal" | "approval" | "permission";
+    action: "created" | "cancelled" | "completed" | "deleted" | "resolved" | "moved" | "contentChanged" | "edited" | "reopened" | "renamed" | "reset" | "responded" | "reviewersChanged" | "trashed" | "untrashed";
+    resourceType: "file" | "comment" | "reply" | "accessProposal" | "approval" | "permission";
 };
 export {};

package/dist/linear/schemas.d.ts

@@ -4412,8 +4412,7 @@ export declare const LINEAR_PROVIDER_PROJECT_SCHEMA: z.ZodObject<{
     state: z.ZodString;
     color: z.ZodString;
     content: z.ZodNullable<z.ZodString>;
-    icon: z.ZodNullable<z.ZodString>;
-    lead: z.ZodNullable<z.ZodObject<{
+    creator: z.ZodNullable<z.ZodObject<{
         active: z.ZodBoolean;
         avatarUrl: z.ZodNullable<z.ZodString>;
         displayName: z.ZodString;
@@ -4422,7 +4421,8 @@ export declare const LINEAR_PROVIDER_PROJECT_SCHEMA: z.ZodObject<{
         name: z.ZodString;
     }, z.core.$strip>>;
     startDate: z.ZodNullable<z.ZodISODate>;
-    creator: z.ZodNullable<z.ZodObject<{
+    icon: z.ZodNullable<z.ZodString>;
+    lead: z.ZodNullable<z.ZodObject<{
         active: z.ZodBoolean;
         avatarUrl: z.ZodNullable<z.ZodString>;
         displayName: z.ZodString;

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

@@ -0,0 +1,90 @@
+import type { Encodable } from "@automate.ax/codec";
+import * as z from "zod";
+import { META_ADS_PAGE_INFO_SCHEMA } from "./schemas.js";
+export declare const META_ADS_GRAPH_API_VERSION = "v26.0";
+export declare const META_ADS_OAUTH_SECRET_SCHEMA: z.ZodObject<{
+    accessToken: z.ZodString;
+    expiresAt: z.ZodNullable<z.ZodNumber>;
+    tokenType: z.ZodString;
+}, z.core.$strip>;
+declare const META_ERROR_SCHEMA: z.ZodObject<{
+    code: z.ZodOptional<z.ZodNumber>;
+    errorSubcode: z.ZodOptional<z.ZodNumber>;
+    errorUserMessage: z.ZodOptional<z.ZodString>;
+    fbtraceId: z.ZodOptional<z.ZodString>;
+    isTransient: z.ZodOptional<z.ZodBoolean>;
+    message: z.ZodString;
+    type: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+/** Query values serialized by the shared Graph client. */
+type QueryValue = boolean | number | string | string[] | undefined;
+export interface MetaAdsResolvedAccount {
+    connectionMethodId: string;
+    secret: Record<string, unknown>;
+    serviceId: "meta-ads";
+}
+export interface MetaAdsRequestOptions<TSchema extends z.ZodType> {
+    body?: Encodable;
+    method?: "DELETE" | "GET" | "PATCH" | "POST";
+    query?: Record<string, QueryValue>;
+    responseSchema: TSchema;
+}
+export interface MetaAdsPage<T> {
+    items: T;
+    pageInfo?: z.output<typeof META_ADS_PAGE_INFO_SCHEMA>;
+}
+/** Structured Graph API failure with Meta quota and trace diagnostics. */
+export declare class MetaAdsApiError extends Error {
+    readonly appUsage?: string;
+    readonly businessUseCaseUsage?: string;
+    readonly code?: number;
+    readonly fbtraceId?: string;
+    readonly isTransient: boolean;
+    readonly adAccountUsage?: string;
+    readonly errorSubcode?: number;
+    readonly retryAfter?: number;
+    readonly status: number;
+    /**
+     * 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: {
+        adAccountUsage?: string;
+        appUsage?: string;
+        businessUseCaseUsage?: string;
+        error?: z.output<typeof META_ERROR_SCHEMA>;
+        retryAfter?: number;
+        status: number;
+    });
+}
+/**
+ * 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 declare function getMetaAdsApi(account: MetaAdsResolvedAccount): {
+    call: <TSchema extends z.ZodType>(path: string, options: MetaAdsRequestOptions<TSchema>) => Promise<z.output<TSchema>>;
+    page: <TSchema extends z.ZodType>(path: string, options: MetaAdsRequestOptions<TSchema>) => Promise<MetaAdsPage<z.output<TSchema>>>;
+};
+/**
+ * Converts public camelCase object keys to Meta wire keys recursively.
+ *
+ * @param value - Codec-safe public value.
+ */
+export declare function toMeta(value: Encodable): Encodable;
+/**
+ * Converts Meta wire keys to public camelCase keys recursively.
+ *
+ * @param value - Provider value.
+ */
+export declare function fromMeta(value: unknown): unknown;
+export {};

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);
+}