@automate.ax/integration-contracts 0.139.2 → 0.142.0

package/dist/closebot/schemas.js

@@ -0,0 +1,469 @@
+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({ local: true, offset: true })])
+    .transform((value) => value instanceof Date
+    ? value
+    : new Date(/(?:Z|[+-]\d{2}:\d{2})$/.test(value) ? value : `${value}Z`));
+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.nullable().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/google-ads/api.d.ts

@@ -0,0 +1,40 @@
+import * as z from "zod";
+export declare const GOOGLE_ADS_CUSTOMER_ID_SCHEMA: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+export declare const GOOGLE_ADS_RESOURCE_NAME_SCHEMA: z.ZodString;
+export declare const GOOGLE_ADS_SECRET_SCHEMA: z.ZodObject<{
+    accessToken: z.ZodString;
+    developerToken: z.ZodString;
+    tokenType: z.ZodString;
+}, z.core.$strip>;
+export interface GoogleAdsRequestOptions<TSchema extends z.ZodType> {
+    body?: z.input<ReturnType<typeof z.json>>;
+    loginCustomerId?: string;
+    method?: "GET" | "POST";
+    responseSchema: TSchema;
+}
+interface GoogleAdsApiErrorOptions {
+    message?: string;
+    providerStatus?: string;
+    requestId?: string;
+    retryAfter?: string;
+    status: number;
+}
+/** Structured Google Ads REST failure with correlation metadata. */
+export declare class GoogleAdsApiError extends Error {
+    readonly providerStatus?: string;
+    readonly requestId?: string;
+    readonly retryAfter?: string;
+    readonly status: number;
+    /** Creates a structured failure from one provider response. */
+    /** @param options - HTTP and Google Ads error metadata. */
+    constructor(options: GoogleAdsApiErrorOptions);
+}
+/** Creates an authenticated Google Ads v25 REST client. */
+/** @param secret - Resolved Google OAuth and platform developer credentials. */
+export declare function getGoogleAdsApi(secret: unknown): {
+    request<TSchema extends z.ZodType>(path: string, options: GoogleAdsRequestOptions<TSchema>): Promise<z.output<TSchema>>;
+};
+/** Normalizes a Google Ads customer ID for paths and headers. */
+/** @param value - Dashed or compact 10-digit customer ID. */
+export declare function normalizeGoogleAdsCustomerId(value: string): string;
+export {};

package/dist/google-ads/api.js

@@ -0,0 +1,109 @@
+import * as z from "zod";
+const GOOGLE_ADS_API_ORIGIN = "https://googleads.googleapis.com";
+const GOOGLE_ADS_API_VERSION = "v25";
+export const GOOGLE_ADS_CUSTOMER_ID_SCHEMA = z
+    .string()
+    .trim()
+    .regex(/^(?:\d{3}-?\d{3}-?\d{4})$/, "Enter a 10-digit customer ID.")
+    .transform((value) => value.replaceAll("-", ""));
+export const GOOGLE_ADS_RESOURCE_NAME_SCHEMA = z
+    .string()
+    .regex(/^customers\/\d{10}\/[A-Za-z][A-Za-z0-9]*(?:\/[^/]+)+$/);
+export const GOOGLE_ADS_SECRET_SCHEMA = z.object({
+    accessToken: z.string().min(1),
+    developerToken: z.string().min(1),
+    tokenType: z.string().min(1),
+});
+const GOOGLE_ADS_FAILURE_SCHEMA = z.looseObject({
+    error: z
+        .looseObject({
+        code: z.number().int().optional(),
+        message: z.string().optional(),
+        status: z.string().optional(),
+    })
+        .optional(),
+});
+/** Structured Google Ads REST failure with correlation metadata. */
+export class GoogleAdsApiError extends Error {
+    providerStatus;
+    requestId;
+    retryAfter;
+    status;
+    /** Creates a structured failure from one provider response. */
+    /** @param options - HTTP and Google Ads error metadata. */
+    constructor(options) {
+        super(options.message ??
+            `Google Ads API request failed with status ${options.status}.`);
+        this.name = "GoogleAdsApiError";
+        this.providerStatus = options.providerStatus;
+        this.requestId = options.requestId;
+        this.retryAfter = options.retryAfter;
+        this.status = options.status;
+    }
+}
+/** Creates an authenticated Google Ads v25 REST client. */
+/** @param secret - Resolved Google OAuth and platform developer credentials. */
+export function getGoogleAdsApi(secret) {
+    const credentials = GOOGLE_ADS_SECRET_SCHEMA.parse(secret);
+    return {
+        async request(path, options) {
+            const normalizedPath = path.replace(/^\/+/, "");
+            if (!normalizedPath ||
+                normalizedPath.includes("://") ||
+                normalizedPath.includes("\\")) {
+                throw new TypeError("Google Ads API paths must be relative.");
+            }
+            const url = new URL(`${GOOGLE_ADS_API_VERSION}/${normalizedPath}`, `${GOOGLE_ADS_API_ORIGIN}/`);
+            if (url.origin !== GOOGLE_ADS_API_ORIGIN) {
+                throw new TypeError("Google Ads API paths must remain on googleads.googleapis.com.");
+            }
+            const headers = new Headers({
+                Accept: "application/json",
+                Authorization: `${credentials.tokenType} ${credentials.accessToken}`,
+                "developer-token": credentials.developerToken,
+            });
+            if (options.loginCustomerId) {
+                headers.set("login-customer-id", GOOGLE_ADS_CUSTOMER_ID_SCHEMA.parse(options.loginCustomerId));
+            }
+            if (options.body !== undefined) {
+                headers.set("Content-Type", "application/json");
+            }
+            const response = await fetch(url, {
+                body: options.body === undefined ? undefined : JSON.stringify(options.body),
+                headers,
+                method: options.method ?? (options.body === undefined ? "GET" : "POST"),
+            });
+            const payload = parseGoogleAdsJson(await response.text());
+            if (!response.ok) {
+                const failure = GOOGLE_ADS_FAILURE_SCHEMA.safeParse(payload);
+                throw new GoogleAdsApiError({
+                    message: failure.success ? failure.data.error?.message : undefined,
+                    providerStatus: failure.success
+                        ? failure.data.error?.status
+                        : undefined,
+                    requestId: response.headers.get("request-id") ?? undefined,
+                    retryAfter: response.headers.get("retry-after") ?? undefined,
+                    status: response.status,
+                });
+            }
+            return options.responseSchema.parse(payload);
+        },
+    };
+}
+/** Normalizes a Google Ads customer ID for paths and headers. */
+/** @param value - Dashed or compact 10-digit customer ID. */
+export function normalizeGoogleAdsCustomerId(value) {
+    return GOOGLE_ADS_CUSTOMER_ID_SCHEMA.parse(value);
+}
+/** Parses an optional Google Ads JSON response body. */
+/** @param value - Raw response body. */
+function parseGoogleAdsJson(value) {
+    if (!value)
+        return undefined;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return value;
+    }
+}