@automate.ax/integration-contracts 0.139.2 → 0.141.0

package/dist/closebot/schemas.js

@@ -0,0 +1,467 @@
+import * as z from "zod";
+export const CLOSEBOT_ID_SCHEMA = z.string().trim().min(1);
+export const CLOSEBOT_DATE_SCHEMA = z
+    .union([z.date(), z.iso.datetime({ offset: true })])
+    .transform((value) => (value instanceof Date ? value : new Date(value)));
+const OPTIONAL_STRING = z.string().nullable().optional();
+const OPTIONAL_BOOLEAN = z.boolean().optional();
+const OPTIONAL_INTEGER = z.number().int().optional();
+const OPTIONAL_DATE = CLOSEBOT_DATE_SCHEMA.nullable().optional();
+export const CLOSEBOT_AGENCY_MEMBER_SCHEMA = z.object({
+    accountId: OPTIONAL_STRING,
+    authId: OPTIONAL_STRING,
+    email: OPTIONAL_STRING,
+    name: OPTIONAL_STRING,
+    role: OPTIONAL_STRING,
+    status: OPTIONAL_STRING,
+});
+export const CLOSEBOT_AGENCY_SCHEMA = z.object({
+    betaTester: OPTIONAL_BOOLEAN,
+    id: OPTIONAL_STRING,
+    members: CLOSEBOT_AGENCY_MEMBER_SCHEMA.array().nullable().optional(),
+    name: OPTIONAL_STRING,
+});
+export const CLOSEBOT_FOLLOW_UP_SEQUENCE_SCHEMA = z.object({
+    duration: OPTIONAL_INTEGER,
+    order: OPTIONAL_INTEGER,
+    unit: OPTIONAL_STRING,
+});
+export const CLOSEBOT_FOLLOW_UP_STATE_SCHEMA = z.object({
+    extraPrompt: OPTIONAL_STRING,
+    id: OPTIONAL_INTEGER,
+    isDefault: OPTIONAL_BOOLEAN,
+    name: OPTIONAL_STRING,
+    order: OPTIONAL_INTEGER,
+    repeatFinal: OPTIONAL_BOOLEAN,
+    sequences: CLOSEBOT_FOLLOW_UP_SEQUENCE_SCHEMA.array().nullable().optional(),
+});
+export const CLOSEBOT_TAG_SCHEMA = z.object({
+    approveDeny: OPTIONAL_BOOLEAN,
+    id: OPTIONAL_STRING,
+    name: OPTIONAL_STRING,
+});
+export const CLOSEBOT_TAG_FILTER_SCHEMA = z.object({
+    groups: z
+        .object({
+        operator: OPTIONAL_STRING,
+        rules: z
+            .object({
+            condition: OPTIONAL_STRING,
+            tagId: OPTIONAL_STRING,
+            tagName: OPTIONAL_STRING,
+        })
+            .array()
+            .nullable()
+            .optional(),
+    })
+        .array()
+        .nullable()
+        .optional(),
+    operator: OPTIONAL_STRING,
+});
+export const CLOSEBOT_CHANNEL_RULES_SCHEMA = z.object({
+    channels: z
+        .object({
+        channel: OPTIONAL_STRING,
+        rules: z
+            .object({ operator: OPTIONAL_STRING, value: OPTIONAL_STRING })
+            .array()
+            .nullable()
+            .optional(),
+        type: OPTIONAL_STRING,
+    })
+        .array()
+        .nullable()
+        .optional(),
+});
+export const CLOSEBOT_BOT_SOURCE_SCHEMA = z.object({
+    category: OPTIONAL_STRING,
+    channelList: z.string().array().nullable().optional(),
+    channelRules: CLOSEBOT_CHANNEL_RULES_SCHEMA.optional(),
+    enabled: OPTIONAL_BOOLEAN,
+    flowVariableValues: z.record(z.string(), z.string()).nullable().optional(),
+    id: OPTIONAL_STRING,
+    key: OPTIONAL_STRING,
+    name: OPTIONAL_STRING,
+    personaNameOverride: OPTIONAL_STRING,
+    tagFilterConfig: CLOSEBOT_TAG_FILTER_SCHEMA.optional(),
+    tags: CLOSEBOT_TAG_SCHEMA.array().nullable().optional(),
+});
+export const CLOSEBOT_BOT_VERSION_SCHEMA = z.object({
+    modifiedAt: CLOSEBOT_DATE_SCHEMA.optional(),
+    modifiedBy: OPTIONAL_STRING,
+    name: OPTIONAL_STRING,
+    published: OPTIONAL_BOOLEAN,
+    version: OPTIONAL_STRING,
+});
+export const CLOSEBOT_PERSONA_SPLIT_TEST_SOURCE_RESULT_SCHEMA = z.object({
+    averageLeadScore: z.number().optional(),
+    responseCount: OPTIONAL_INTEGER,
+    sourceId: OPTIONAL_STRING,
+    sourceName: OPTIONAL_STRING,
+    totalInstances: OPTIONAL_INTEGER,
+});
+export const CLOSEBOT_PERSONA_SPLIT_TEST_RESULTS_SCHEMA = z.object({
+    averageLeadScore: z.number().optional(),
+    computedAt: CLOSEBOT_DATE_SCHEMA.optional(),
+    personaId: OPTIONAL_STRING,
+    personaName: OPTIONAL_STRING,
+    responseCount: OPTIONAL_INTEGER,
+    sources: CLOSEBOT_PERSONA_SPLIT_TEST_SOURCE_RESULT_SCHEMA.array()
+        .nullable()
+        .optional(),
+    splitWeight: OPTIONAL_INTEGER,
+    totalInstances: OPTIONAL_INTEGER,
+});
+export const CLOSEBOT_PERSONA_SPLIT_TEST_SCHEMA = z.object({
+    endedAt: OPTIONAL_DATE,
+    id: OPTIONAL_STRING,
+    isActive: OPTIONAL_BOOLEAN,
+    personas: z
+        .object({
+        order: OPTIONAL_INTEGER,
+        personaId: OPTIONAL_STRING,
+        results: CLOSEBOT_PERSONA_SPLIT_TEST_RESULTS_SCHEMA.optional(),
+        weight: OPTIONAL_INTEGER,
+    })
+        .array()
+        .nullable()
+        .optional(),
+    startedAt: OPTIONAL_DATE,
+});
+export const CLOSEBOT_BOT_TEMPLATE_SCHEMA = z.object({
+    description: OPTIONAL_STRING,
+    id: OPTIONAL_STRING,
+    industry: OPTIONAL_STRING,
+    level: OPTIONAL_STRING,
+    name: OPTIONAL_STRING,
+    previewUrl: OPTIONAL_STRING,
+    tags: z.string().array().nullable().optional(),
+    tier: OPTIONAL_STRING,
+    videoUrl: OPTIONAL_STRING,
+});
+export const CLOSEBOT_FOLDER_SCHEMA = z.object({
+    bots: z.string().array().nullable(),
+    children: z.string().array().nullable(),
+    id: z.string().nullable(),
+    name: z.string().nullable(),
+    personas: z.string().array().nullable(),
+});
+export const CLOSEBOT_FOLDER_CREATED_SCHEMA = z.object({
+    id: z.string().nullable(),
+});
+export const CLOSEBOT_BOT_SCHEMA = z.object({
+    category: OPTIONAL_STRING,
+    favorited: OPTIONAL_BOOLEAN,
+    folderId: OPTIONAL_STRING,
+    followUpActive: OPTIONAL_BOOLEAN,
+    followUpExtraPrompt: OPTIONAL_STRING,
+    followUpRepeat: OPTIONAL_BOOLEAN,
+    followUpSequences: CLOSEBOT_FOLLOW_UP_SEQUENCE_SCHEMA.array()
+        .nullable()
+        .optional(),
+    followUpStates: CLOSEBOT_FOLLOW_UP_STATE_SCHEMA.array().nullable().optional(),
+    followUpVarianceMinutes: OPTIONAL_INTEGER,
+    id: OPTIONAL_STRING,
+    locked: OPTIONAL_BOOLEAN,
+    modifiedAt: OPTIONAL_STRING,
+    modifiedBy: OPTIONAL_STRING,
+    name: OPTIONAL_STRING,
+    personaIds: z.string().array().nullable().optional(),
+    personaSplitTest: CLOSEBOT_PERSONA_SPLIT_TEST_SCHEMA.optional(),
+    personaWeights: z.record(z.string(), z.number().int()).nullable().optional(),
+    reschedulingEnabled: OPTIONAL_BOOLEAN,
+    smartFollowUp: OPTIONAL_BOOLEAN,
+    sources: CLOSEBOT_BOT_SOURCE_SCHEMA.array().nullable().optional(),
+    tools: z
+        .object({
+        enabled: OPTIONAL_BOOLEAN,
+        id: OPTIONAL_STRING,
+        options: z.object({}).optional(),
+        type: OPTIONAL_STRING,
+    })
+        .array()
+        .nullable()
+        .optional(),
+    versions: CLOSEBOT_BOT_VERSION_SCHEMA.array().nullable().optional(),
+});
+export const CLOSEBOT_PUBLISH_BOT_RESULT_SCHEMA = z.object({
+    message: z.json().optional(),
+    version: OPTIONAL_STRING,
+});
+export const CLOSEBOT_LEAD_FIELD_SCHEMA = z.object({
+    aiProduced: OPTIONAL_BOOLEAN,
+    field: OPTIONAL_STRING,
+    name: OPTIONAL_STRING,
+    value: OPTIONAL_STRING,
+});
+export const CLOSEBOT_BOT_INSTANCE_SCHEMA = z.object({
+    botId: OPTIONAL_STRING,
+    botVersion: OPTIONAL_STRING,
+    followUpTime: OPTIONAL_DATE,
+    followUpTimezone: OPTIONAL_STRING,
+    followUpTimezoneKind: OPTIONAL_STRING,
+    isSmartFollowUpTime: OPTIONAL_BOOLEAN,
+    scheduleRespondTime: OPTIONAL_DATE,
+});
+export const CLOSEBOT_LEAD_SCHEMA = z.object({
+    contactId: OPTIONAL_STRING,
+    fields: CLOSEBOT_LEAD_FIELD_SCHEMA.array().nullable().optional(),
+    id: OPTIONAL_STRING,
+    instances: CLOSEBOT_BOT_INSTANCE_SCHEMA.array().nullable().optional(),
+    lastMessage: OPTIONAL_STRING,
+    lastMessageBotId: OPTIONAL_STRING,
+    lastMessageDirection: OPTIONAL_STRING,
+    lastMessageIsNote: OPTIONAL_BOOLEAN,
+    lastMessageTime: OPTIONAL_DATE,
+    mentionedMe: OPTIONAL_BOOLEAN,
+    mimicSourceId: OPTIONAL_STRING,
+    mostRecentFailureReason: OPTIONAL_STRING,
+    name: OPTIONAL_STRING,
+    score: z.number().int().nullable().optional(),
+    source: z.object({ id: OPTIONAL_STRING, name: OPTIONAL_STRING }).optional(),
+    starred: OPTIONAL_BOOLEAN,
+    tags: z.string().array().nullable().optional(),
+    unread: OPTIONAL_BOOLEAN,
+    wontRespondUntil: OPTIONAL_DATE,
+});
+export const CLOSEBOT_LEAD_PAGE_SCHEMA = z.object({
+    mentionsTotal: z.number().int().nullable().optional(),
+    page: z.number().int(),
+    pageSize: z.number().int(),
+    results: CLOSEBOT_LEAD_SCHEMA.array().nullable(),
+    starredTotal: z.number().int().nullable().optional(),
+    total: z.number().int(),
+});
+export const CLOSEBOT_LEAD_SEARCH_RESULT_SCHEMA = z.object({
+    leads: CLOSEBOT_LEAD_SCHEMA.array().nullable(),
+    mentionsTotal: z.number().int().nullable().optional(),
+    starredTotal: z.number().int().nullable().optional(),
+    total: z.number().int(),
+});
+export const CLOSEBOT_LEAD_AI_STATUS_SCHEMA = z.object({
+    applicable: OPTIONAL_BOOLEAN,
+    enabled: OPTIONAL_BOOLEAN,
+    reason: OPTIONAL_STRING,
+});
+export const CLOSEBOT_LEAD_HISTORY_EVENT_SCHEMA = z.object({
+    actionKey: OPTIONAL_STRING,
+    domain: OPTIONAL_STRING,
+    eventType: OPTIONAL_STRING,
+    id: OPTIONAL_STRING,
+    path: OPTIONAL_STRING,
+    points: z.number().int().nullable().optional(),
+    title: OPTIONAL_STRING,
+    triggerType: OPTIONAL_STRING,
+    url: OPTIONAL_STRING,
+    visitedAt: CLOSEBOT_DATE_SCHEMA.optional(),
+});
+export const CLOSEBOT_NOTE_RESULT_SCHEMA = z.object({
+    aiVisible: z.boolean(),
+    noteId: z.string().nullable(),
+});
+export const CLOSEBOT_SCHEDULED_MESSAGE_SCHEMA = z.object({
+    body: OPTIONAL_STRING,
+    botId: OPTIONAL_STRING,
+    cancelOnReply: z.boolean(),
+    channel: OPTIONAL_STRING,
+    createdAt: CLOSEBOT_DATE_SCHEMA,
+    createdByAccountId: z.string().nullable(),
+    createdByIconUrl: OPTIONAL_STRING,
+    createdByName: OPTIONAL_STRING,
+    id: z.string().nullable(),
+    kind: z.string().nullable(),
+    leadId: z.string().nullable(),
+    sendAt: CLOSEBOT_DATE_SCHEMA,
+    sentMessageId: OPTIONAL_STRING,
+    sourceId: OPTIONAL_STRING,
+    status: z.string().nullable(),
+    statusReason: OPTIONAL_STRING,
+});
+export const CLOSEBOT_SEND_MESSAGE_RESULT_SCHEMA = z.object({
+    messageId: z.string().nullable(),
+});
+export const CLOSEBOT_SOURCE_AVAILABILITY_SCHEMA = z.object({
+    dayOfWeekUtc: OPTIONAL_STRING,
+    duration: OPTIONAL_STRING,
+    startTimeUtc: OPTIONAL_STRING,
+});
+export const CLOSEBOT_BOT_SOURCE_AVAILABILITY_SCHEMA = CLOSEBOT_SOURCE_AVAILABILITY_SCHEMA.extend({ channel: OPTIONAL_STRING });
+export const CLOSEBOT_DO_NOT_RESPOND_WINDOW_SCHEMA = z.object({
+    end: CLOSEBOT_DATE_SCHEMA.optional(),
+    start: CLOSEBOT_DATE_SCHEMA.optional(),
+});
+export const CLOSEBOT_SOURCE_SCHEMA = z.object({
+    accountsWithAccess: z.string().array().nullable().optional(),
+    address: OPTIONAL_STRING,
+    agencyId: OPTIONAL_STRING,
+    autoShutoff: OPTIONAL_BOOLEAN,
+    botRespondWindows: CLOSEBOT_BOT_SOURCE_AVAILABILITY_SCHEMA.array()
+        .nullable()
+        .optional(),
+    bots: z
+        .object({
+        botName: OPTIONAL_STRING,
+        channelRules: CLOSEBOT_CHANNEL_RULES_SCHEMA.optional(),
+        channels: z.string().array().nullable().optional(),
+        enabled: OPTIONAL_BOOLEAN,
+        id: OPTIONAL_STRING,
+        personaNameOverride: OPTIONAL_STRING,
+        tagFilterConfig: CLOSEBOT_TAG_FILTER_SCHEMA.optional(),
+        tags: CLOSEBOT_TAG_SCHEMA.array().nullable().optional(),
+    })
+        .array()
+        .nullable()
+        .optional(),
+    category: OPTIONAL_STRING,
+    connected: OPTIONAL_BOOLEAN,
+    doNotRespondWindows: CLOSEBOT_DO_NOT_RESPOND_WINDOW_SCHEMA.array()
+        .nullable()
+        .optional(),
+    gracefulGoodbye: OPTIONAL_BOOLEAN,
+    hubSpotOwnerId: OPTIONAL_STRING,
+    isAvailabilityContactTimezone: OPTIONAL_BOOLEAN,
+    isBotRespondWindowsQuietHours: OPTIONAL_BOOLEAN,
+    key: OPTIONAL_STRING,
+    markConversationAsUnread: OPTIONAL_BOOLEAN,
+    name: OPTIONAL_STRING,
+    respondToReactions: OPTIONAL_BOOLEAN,
+    respondWindows: CLOSEBOT_SOURCE_AVAILABILITY_SCHEMA.array()
+        .nullable()
+        .optional(),
+    scriptDomainAllowList: z.string().array().nullable().optional(),
+    scriptInstalled: OPTIONAL_BOOLEAN,
+    scriptLastSeenAt: OPTIONAL_DATE,
+    scriptLastSeenDomain: OPTIONAL_STRING,
+    scriptLastSeenEndpoint: OPTIONAL_STRING,
+    sourceId: OPTIONAL_STRING,
+    summarizeAttachments: OPTIONAL_BOOLEAN,
+    timezone: OPTIONAL_STRING,
+    webhookCallback: OPTIONAL_STRING,
+});
+export const CLOSEBOT_SOURCE_PAGE_SCHEMA = z.object({
+    page: z.number().int(),
+    pageSize: z.number().int(),
+    results: CLOSEBOT_SOURCE_SCHEMA.array().nullable(),
+    total: z.number().int(),
+});
+export const CLOSEBOT_SOURCE_CALENDAR_SCHEMA = z.object({
+    id: OPTIONAL_STRING,
+    name: OPTIONAL_STRING,
+});
+export const CLOSEBOT_SOURCE_CHANNEL_SCHEMA = z.object({
+    filterType: OPTIONAL_STRING,
+    id: OPTIONAL_STRING,
+    name: OPTIONAL_STRING,
+    source: OPTIONAL_STRING,
+});
+export const CLOSEBOT_SOURCE_FIELD_SCHEMA = z.object({
+    dataType: OPTIONAL_STRING,
+    fieldKey: OPTIONAL_STRING,
+    name: OPTIONAL_STRING,
+});
+export const CLOSEBOT_SOURCE_FIELDS_SCHEMA = z.object({
+    contact: CLOSEBOT_SOURCE_FIELD_SCHEMA.array().nullable().optional(),
+    customValue: CLOSEBOT_SOURCE_FIELD_SCHEMA.array().nullable().optional(),
+    location: CLOSEBOT_SOURCE_FIELD_SCHEMA.array().nullable().optional(),
+});
+export const CLOSEBOT_SOURCE_TAG_SCHEMA = z.object({
+    id: OPTIONAL_STRING,
+    name: OPTIONAL_STRING,
+});
+export const CLOSEBOT_SOURCE_OWNER_SCHEMA = z.object({
+    email: OPTIONAL_STRING,
+    firstName: OPTIONAL_STRING,
+    lastName: OPTIONAL_STRING,
+    ownerId: OPTIONAL_STRING,
+});
+export const CLOSEBOT_LIBRARY_FILE_SOURCE_SCHEMA = z.object({
+    category: OPTIONAL_STRING,
+    id: OPTIONAL_STRING,
+    name: OPTIONAL_STRING,
+});
+export const CLOSEBOT_LIBRARY_FILE_SCHEMA = z.object({
+    accountId: OPTIONAL_STRING,
+    estimatedFileSize: z.number().int().optional(),
+    externalItemId: OPTIONAL_STRING,
+    externalLibraryResourceSyncId: OPTIONAL_STRING,
+    externalProvider: OPTIONAL_STRING,
+    externalResourceId: OPTIONAL_STRING,
+    externalResourceName: OPTIONAL_STRING,
+    externalResourceType: OPTIONAL_STRING,
+    faviconUrl: OPTIONAL_STRING,
+    fileId: OPTIONAL_STRING,
+    fileName: OPTIONAL_STRING,
+    fileSize: z.number().int().optional(),
+    fileStatus: OPTIONAL_STRING,
+    fileType: OPTIONAL_STRING,
+    lastModified: CLOSEBOT_DATE_SCHEMA.optional(),
+    lastUse: OPTIONAL_DATE,
+    sources: CLOSEBOT_LIBRARY_FILE_SOURCE_SCHEMA.array().nullable().optional(),
+    uri: OPTIONAL_STRING,
+    uses: z.number().int().nullable().optional(),
+});
+export const CLOSEBOT_LIBRARY_FILE_PREVIEW_SCHEMA = z.object({
+    chunks: z
+        .object({ chunkIndex: OPTIONAL_INTEGER, content: OPTIONAL_STRING })
+        .array()
+        .nullable()
+        .optional(),
+    content: OPTIONAL_STRING,
+    errorMessage: OPTIONAL_STRING,
+    fileId: OPTIONAL_STRING,
+    fileName: OPTIONAL_STRING,
+    fileSize: z.number().int().optional(),
+    fileStatus: OPTIONAL_STRING,
+    fileType: OPTIONAL_STRING,
+    lastModified: CLOSEBOT_DATE_SCHEMA.optional(),
+    previewSource: OPTIONAL_STRING,
+});
+export const CLOSEBOT_WEB_SCRAPE_PAGE_SCHEMA = z.object({
+    enabled: OPTIONAL_BOOLEAN,
+    url: OPTIONAL_STRING,
+});
+export const CLOSEBOT_BOT_VARIABLE_SCHEMA = z.object({
+    id: z.string().nullable(),
+    name: z.string().nullable(),
+    value: z.string().nullable(),
+});
+export const CLOSEBOT_PERSONA_SCHEMA = z.object({
+    agencyId: OPTIONAL_STRING,
+    aiProviderPreferences: z.string().array().nullable().optional(),
+    botIds: z.string().array().nullable().optional(),
+    bots: z
+        .object({ id: OPTIONAL_STRING, name: OPTIONAL_STRING })
+        .array()
+        .nullable()
+        .optional(),
+    breakupLargeMessagePercent: OPTIONAL_INTEGER,
+    color: OPTIONAL_STRING,
+    default: OPTIONAL_BOOLEAN,
+    description: OPTIONAL_STRING,
+    favorited: OPTIONAL_BOOLEAN,
+    folderId: OPTIONAL_STRING,
+    howToRespond: OPTIONAL_STRING,
+    id: OPTIONAL_STRING,
+    imageUri: OPTIONAL_STRING,
+    modifiedAt: OPTIONAL_STRING,
+    modifiedBy: OPTIONAL_STRING,
+    personaName: OPTIONAL_STRING,
+    responseDelay: OPTIONAL_INTEGER,
+    responseTime: OPTIONAL_STRING,
+    typoPercent: OPTIONAL_INTEGER,
+    voiceStyles: OPTIONAL_STRING,
+});
+export const CLOSEBOT_SMART_FAQ_STATE_SCHEMA = z.union([
+    z.literal(0),
+    z.literal(1),
+]);
+export const CLOSEBOT_SMART_FAQ_SCHEMA = z.object({
+    agencyId: OPTIONAL_STRING,
+    answer: OPTIONAL_STRING,
+    id: OPTIONAL_STRING,
+    leadIds: z.string().array().nullable().optional(),
+    question: OPTIONAL_STRING,
+    sourceId: OPTIONAL_STRING,
+    state: CLOSEBOT_SMART_FAQ_STATE_SCHEMA.optional(),
+});

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 {};