smartletter 0.0.0-stage → 1.0.0

package/dist/index.d.cts

@@ -0,0 +1,3950 @@
+type KeyTree = {
+    [camelKey: string]: {
+        wire: string;
+        props?: KeyTree;
+        items?: KeyTree;
+    };
+};
+interface Operation {
+    id: string;
+    method: "GET" | "POST" | "PATCH" | "DELETE";
+    path: string;
+    pathParams: string[];
+    body?: KeyTree;
+    bodyIsArray?: boolean;
+    /** Body is raw bytes (images.create), not JSON. */
+    rawBody?: boolean;
+    query?: KeyTree;
+    paginated: boolean;
+    idempotent: boolean;
+    /** Response body is returned as text (non-JSON content type, e.g. CSV). */
+    responseType?: "text";
+}
+
+interface RequestOptions {
+    idempotencyKey?: string;
+    headers?: HeadersInit;
+    signal?: AbortSignal;
+}
+type ErrorResponse = {
+    name: string;
+    message: string;
+    statusCode: number | null;
+};
+type Response<T> = {
+    data: T;
+    error: null;
+    headers: Record<string, string> | null;
+} | {
+    data: null;
+    error: ErrorResponse;
+    headers: Record<string, string> | null;
+};
+
+declare class Client {
+    readonly key: string;
+    readonly baseUrl: string;
+    private readonly userAgent;
+    constructor(key?: string, options?: {
+        baseUrl?: string;
+        userAgent?: string;
+    });
+    call(op: Operation, args: Record<string, unknown> | unknown[] | BodyInit | undefined, options?: RequestOptions): Promise<Response<unknown>>;
+}
+
+interface EmailsSendParams {
+    /**
+     * `Name <address@your-domain>`; the domain must be verified. Optional with a template that has one.
+     */
+    from: string;
+    /**
+     * Up to 50 addresses.
+     */
+    to: string | string[];
+    /**
+     * Optional with a template that has one.
+     */
+    subject: string;
+    /**
+     * Send a published template instead of `html` / `text` (which are then refused). `from`, `subject` and `reply_to` override the template's.
+     */
+    template?: {
+        /**
+         * Id or alias of a published template.
+         */
+        id: string;
+        variables?: {
+            [k: string]: string | number;
+        };
+    };
+    html?: string;
+    /**
+     * Generated from `html` when absent; `""` sends HTML only.
+     */
+    text?: string;
+    cc?: string | string[];
+    bcc?: string | string[];
+    replyTo?: string | string[];
+    headers?: {
+        [k: string]: string;
+    };
+    tags?: {
+        name: string;
+        value: string;
+    }[];
+    /**
+     * Send later: ISO 8601 (`2026-10-20T09:00:00Z`) or English like `in 1 hour`, `tomorrow at 9am`. Up to 30 days.
+     */
+    scheduledAt?: string;
+    /**
+     * Up to 20 files, 10 MB in total. Executable types (.exe, .js, .bat…) are refused.
+     */
+    attachments?: {
+        /**
+         * File content in base64. Give `content` or `path`.
+         */
+        content?: string;
+        /**
+         * https URL of the file. We download it (10 s max, redirects not followed).
+         */
+        path?: string;
+        /**
+         * Required with `content`. Taken from the URL with `path`.
+         */
+        filename?: string;
+        /**
+         * Derived from the file name when absent.
+         */
+        contentType?: string;
+        /**
+         * Makes the file an inline image: reference it as `<img src="cid:…">` in the html.
+         */
+        contentId?: string;
+    }[];
+}
+type EmailsSendResponse = {
+    id: string;
+};
+type BatchSendParams = {
+    /**
+     * `Name <address@your-domain>`; the domain must be verified. Optional with a template that has one.
+     */
+    from: string;
+    /**
+     * Up to 50 addresses.
+     */
+    to: string | string[];
+    /**
+     * Optional with a template that has one.
+     */
+    subject: string;
+    /**
+     * Send a published template instead of `html` / `text` (which are then refused). `from`, `subject` and `reply_to` override the template's.
+     */
+    template?: {
+        /**
+         * Id or alias of a published template.
+         */
+        id: string;
+        variables?: {
+            [k: string]: string | number;
+        };
+    };
+    html?: string;
+    /**
+     * Generated from `html` when absent; `""` sends HTML only.
+     */
+    text?: string;
+    cc?: string | string[];
+    bcc?: string | string[];
+    replyTo?: string | string[];
+    headers?: {
+        [k: string]: string;
+    };
+    tags?: {
+        name: string;
+        value: string;
+    }[];
+    /**
+     * Send later: ISO 8601 (`2026-10-20T09:00:00Z`) or English like `in 1 hour`, `tomorrow at 9am`. Up to 30 days.
+     */
+    scheduledAt?: string;
+}[];
+type BatchSendResponse = {
+    data: {
+        id: string;
+    }[];
+    errors?: {
+        index: number;
+        message: string;
+    }[];
+};
+interface EmailsListParams {
+    /**
+     * 1–100, default 20.
+     */
+    limit?: number;
+    /**
+     * Id of the last item of the previous page (older items).
+     */
+    after?: string;
+    /**
+     * Id of the first item of the previous page (newer items).
+     */
+    before?: string;
+}
+type EmailsListResponse = {
+    object: string;
+    has_more: boolean;
+    data: {
+        object: string;
+        id: string;
+        message_id: string | null;
+        to: string[];
+        from: string;
+        created_at: string;
+        subject: string;
+        bcc: string[];
+        cc: string[];
+        reply_to: string[];
+        last_event: string;
+        scheduled_at: string | null;
+    }[];
+};
+interface EmailsGetParams {
+    id: string;
+}
+type EmailsGetResponse = {
+    object: string;
+    id: string;
+    message_id: string | null;
+    to: string[];
+    from: string;
+    created_at: string;
+    subject: string;
+    bcc: string[];
+    cc: string[];
+    reply_to: string[];
+    last_event: string;
+    scheduled_at: string | null;
+    html: string | null;
+    text: string | null;
+    tags: {
+        name: string;
+        value: string;
+    }[];
+    status: string;
+    created_via: string;
+    attachments: {
+        filename: string;
+        content_type: string;
+        content_id: string | null;
+        size: number;
+    }[];
+    recipients: {
+        email: string;
+        type: string;
+        status: string;
+        reason: string | null;
+        bounce_type: string | null;
+        smtp_status: string | null;
+        diagnostic_code: string | null;
+        delay_type: string | null;
+        delay_expires_at: string | null;
+        last_event_at: string | null;
+    }[];
+    smtp?: {
+        client_ip: string | null;
+        message_id: string | null;
+    };
+};
+type EmailsUpdateParams = {
+    id: string;
+} & {
+    /**
+     * New send time: ISO 8601 or English like `in 2 hours`. Up to 30 days.
+     */
+    scheduledAt: string;
+};
+type EmailsUpdateResponse = {
+    object: string;
+    id: string;
+};
+interface EmailsCancelParams {
+    id: string;
+}
+type EmailsCancelResponse = {
+    object: string;
+    id: string;
+};
+interface TemplatesCreateParams {
+    name: string;
+    /**
+     * Unique in the workspace; use it instead of the id (`/templates/order-receipt`). Letters, digits, `.`, `_`, `-`.
+     */
+    alias?: string | null;
+    /**
+     * Default sender; the send's `from` wins.
+     */
+    from?: string | null;
+    /**
+     * Default subject; the send's `subject` wins. May use variables.
+     */
+    subject?: string | null;
+    replyTo?: (string | string[]) | null;
+    /**
+     * Variables as `{{{KEY}}}` or `{{KEY}}`; values are HTML-escaped.
+     */
+    html: string;
+    /**
+     * Generated from the HTML when absent; `""` sends HTML only.
+     */
+    text?: string | null;
+    variables?: {
+        /**
+         * Letters, digits, underscore (`PRODUCT_NAME`). Reserved: FIRST_NAME, LAST_NAME, EMAIL, UNSUBSCRIBE_URL, contact, this.
+         */
+        key: string;
+        type: "string" | "number";
+        /**
+         * Used when the send gives no value. Must match `type`.
+         */
+        fallbackValue?: (string | number) | null;
+        /**
+         * Without a fallback: `true` (default) refuses a send without this value, `false` renders it empty.
+         */
+        required?: boolean;
+    }[];
+}
+type TemplatesCreateResponse = {
+    object: string;
+    id: string;
+};
+interface TemplatesListParams {
+    /**
+     * 1–100, default 20.
+     */
+    limit?: number;
+    /**
+     * Id of the last item of the previous page (older items).
+     */
+    after?: string;
+    /**
+     * Id of the first item of the previous page (newer items).
+     */
+    before?: string;
+}
+type TemplatesListResponse = {
+    object: string;
+    has_more: boolean;
+    data: {
+        id: string;
+        name: string;
+        alias: string | null;
+        status: string;
+        published_at: string | null;
+        archived: boolean;
+        created_at: string;
+        updated_at: string;
+    }[];
+};
+interface TemplatesGetParams {
+    id: string;
+}
+type TemplatesGetResponse = {
+    object: string;
+    id: string;
+    current_version_id: string | null;
+    current_version_number: number | null;
+    published_version_id: string | null;
+    published_version_number: number | null;
+    alias: string | null;
+    name: string;
+    created_at: string;
+    updated_at: string;
+    status: string;
+    published_at: string | null;
+    archived: boolean;
+    from: string | null;
+    subject: string | null;
+    reply_to: string[] | null;
+    html: string;
+    text: string | null;
+    variables: {
+        id: string;
+        key: string;
+        type: string;
+        fallback_value: string | number | null;
+        required: boolean;
+        created_at: string;
+        updated_at: string;
+    }[];
+    has_unpublished_versions: boolean;
+};
+type TemplatesUpdateParams = {
+    id: string;
+} & {
+    name?: string;
+    /**
+     * Unique in the workspace; use it instead of the id (`/templates/order-receipt`). Letters, digits, `.`, `_`, `-`.
+     */
+    alias?: string | null;
+    /**
+     * Default sender; the send's `from` wins.
+     */
+    from?: string | null;
+    /**
+     * Default subject; the send's `subject` wins. May use variables.
+     */
+    subject?: string | null;
+    replyTo?: (string | string[]) | null;
+    /**
+     * Variables as `{{{KEY}}}` or `{{KEY}}`; values are HTML-escaped.
+     */
+    html?: string;
+    /**
+     * Generated from the HTML when absent; `""` sends HTML only.
+     */
+    text?: string | null;
+    variables?: {
+        /**
+         * Letters, digits, underscore (`PRODUCT_NAME`). Reserved: FIRST_NAME, LAST_NAME, EMAIL, UNSUBSCRIBE_URL, contact, this.
+         */
+        key: string;
+        type: "string" | "number";
+        /**
+         * Used when the send gives no value. Must match `type`.
+         */
+        fallbackValue?: (string | number) | null;
+        /**
+         * Without a fallback: `true` (default) refuses a send without this value, `false` renders it empty.
+         */
+        required?: boolean;
+    }[];
+    /**
+     * Saved with the new version (history).
+     */
+    changeNote?: string;
+};
+type TemplatesUpdateResponse = {
+    object: string;
+    id: string;
+};
+interface TemplatesRemoveParams {
+    id: string;
+}
+type TemplatesRemoveResponse = {
+    object: string;
+    id: string;
+    deleted: boolean;
+};
+type TemplatesPublishParams = {
+    id: string;
+} & {
+    /**
+     * Publish this version instead of the latest (rollback).
+     */
+    versionId?: string;
+};
+type TemplatesPublishResponse = {
+    object: string;
+    id: string;
+};
+interface TemplatesDuplicateParams {
+    id: string;
+}
+type TemplatesDuplicateResponse = {
+    object: string;
+    id: string;
+};
+type TemplatesVersionsParams = {
+    id: string;
+} & {
+    /**
+     * 1–100, default 20.
+     */
+    limit?: number;
+    /**
+     * Id of the last item of the previous page (older items).
+     */
+    after?: string;
+    /**
+     * Id of the first item of the previous page (newer items).
+     */
+    before?: string;
+};
+type TemplatesVersionsResponse = {
+    object: string;
+    has_more: boolean;
+    data: {
+        object: string;
+        id: string;
+        number: number;
+        subject: string | null;
+        source: string;
+        change_note: string | null;
+        created_via: string;
+        published: boolean;
+        created_at: string;
+    }[];
+};
+interface NewslettersListParams {
+    /**
+     * 1–100, default 20.
+     */
+    limit?: number;
+    /**
+     * Id of the last item of the previous page (older items).
+     */
+    after?: string;
+    /**
+     * Id of the first item of the previous page (newer items).
+     */
+    before?: string;
+    status?: "draft" | "scheduled" | "sending" | "paused" | "sent" | "failed" | "held";
+}
+type NewslettersListResponse = {
+    object: string;
+    has_more: boolean;
+    data: {
+        object: string;
+        id: string;
+        segment_id: string;
+        topic_id: unknown;
+        subject: string;
+        preheader: string;
+        status: string;
+        body: {
+            format: string;
+            content: unknown;
+            blocks: {
+                blockId: string;
+                kind: string;
+                text: string;
+            }[];
+        };
+        audience_limit: unknown;
+        scheduled_for: unknown;
+        pause_reason: unknown;
+        recipient_estimate: unknown;
+        ab_test: unknown;
+        ab_winner: unknown;
+        created_at: string;
+        updated_at: string;
+    }[];
+};
+interface NewslettersCreateParams {
+    /**
+     * Subject line.
+     */
+    subject: string;
+    /**
+     * Preview text shown after the subject.
+     */
+    preheader?: string | null;
+    /**
+     * Newsletter (segment) to send from. Optional when the workspace has a single active newsletter.
+     */
+    segmentId?: string;
+    /**
+     * Topic of that newsletter; its subscribers receive the issue.
+     */
+    topicId?: string;
+    /**
+     * Body in Markdown. Give one of `markdown`, `html` or `blocks`.
+     */
+    markdown?: string;
+    /**
+     * Body in HTML (one raw HTML block). The platform footer is added around it.
+     */
+    html?: string;
+    /**
+     * Body as blocks: heading, text, list, quote, image, button, product, divider, columns (2–4) or html. Texts accept **bold**, *italic* and [links](https://…).
+     */
+    blocks?: ({
+        kind: "heading";
+        level: 1 | 2 | 3;
+        text: string;
+    } | {
+        kind: "text";
+        text: string;
+    } | {
+        kind: "list";
+        ordered: boolean;
+        items: string[];
+    } | {
+        kind: "quote";
+        text: string;
+    } | {
+        kind: "image";
+        url: string;
+        alt?: string;
+    } | {
+        kind: "button";
+        label: string;
+        url: string;
+    } | {
+        kind: "product";
+        title: string;
+        url: string;
+        imageUrl?: string;
+        price?: string;
+        description?: string;
+        ctaLabel?: string;
+    } | {
+        kind: "divider";
+    } | {
+        kind: "html";
+        html: string;
+    } | {
+        kind: "columns";
+        columns: ({
+            kind: "heading";
+            level: 1 | 2 | 3;
+            text: string;
+        } | {
+            kind: "text";
+            text: string;
+        } | {
+            kind: "list";
+            ordered: boolean;
+            items: string[];
+        } | {
+            kind: "quote";
+            text: string;
+        } | {
+            kind: "image";
+            url: string;
+            alt?: string;
+        } | {
+            kind: "button";
+            label: string;
+            url: string;
+        } | {
+            kind: "product";
+            title: string;
+            url: string;
+            imageUrl?: string;
+            price?: string;
+            description?: string;
+            ctaLabel?: string;
+        } | {
+            kind: "divider";
+        } | {
+            kind: "html";
+            html: string;
+        })[][];
+    })[];
+    /**
+     * Saved filter (`/audience-filters`): only the matching contacts of the topic receive the issue.
+     */
+    audienceFilterId?: string | null;
+    /**
+     * Subject A/B test (Pro plan or higher): 1 to 3 alternative subjects tested against the issue's own on a random sample; after the wait the rest gets the winner. `null` removes the test.
+     */
+    abTest?: {
+        /**
+         * The alternative subjects B, C, D (1 to 3). Variant A is the issue's own subject and preheader.
+         */
+        variants: {
+            /**
+             * Subject line of this variant.
+             */
+            subject: string;
+            /**
+             * Preview text of this variant (defaults to the issue's).
+             */
+            preheader?: string | null;
+        }[];
+        /**
+         * Share of the audience in the test sample, in percent (10–50, default 20).
+         */
+        samplePct?: number;
+        /**
+         * Winner criterion: unique `opens` (default; inflated by Apple Mail Privacy Protection) or unique `clicks`.
+         */
+        metric?: "opens" | "clicks";
+        /**
+         * Hours between the end of the sample and the choice (1–48, default 4).
+         */
+        waitHours?: number;
+        /**
+         * `auto` (default) picks the best rate; `manual` waits for your choice (auto pick 24 h after the wait).
+         */
+        winnerMode?: "auto" | "manual";
+    } | null;
+}
+type NewslettersCreateResponse = {
+    object: string;
+    id: string;
+    segment_id: string;
+    topic_id: unknown;
+    subject: string;
+    preheader: string;
+    status: string;
+    body: {
+        format: string;
+        content: unknown;
+        blocks: {
+            blockId: string;
+            kind: string;
+            text: string;
+        }[];
+    };
+    audience_limit: unknown;
+    scheduled_for: unknown;
+    pause_reason: unknown;
+    recipient_estimate: unknown;
+    ab_test: unknown;
+    ab_winner: unknown;
+    created_at: string;
+    updated_at: string;
+};
+interface NewslettersGetParams {
+    id: string;
+}
+type NewslettersGetResponse = {
+    object: string;
+    id: string;
+    segment_id: string;
+    topic_id: unknown;
+    subject: string;
+    preheader: string;
+    status: string;
+    body: {
+        format: string;
+        content: unknown;
+        blocks: {
+            blockId: string;
+            kind: string;
+            text: string;
+        }[];
+    };
+    audience_limit: unknown;
+    scheduled_for: unknown;
+    pause_reason: unknown;
+    recipient_estimate: unknown;
+    ab_test: unknown;
+    ab_winner: unknown;
+    created_at: string;
+    updated_at: string;
+};
+type NewslettersUpdateParams = {
+    id: string;
+} & {
+    subject?: string;
+    preheader?: string | null;
+    topicId?: string;
+    markdown?: string;
+    html?: string;
+    /**
+     * Body as blocks: heading, text, list, quote, image, button, product, divider, columns (2–4) or html. Texts accept **bold**, *italic* and [links](https://…).
+     */
+    blocks?: ({
+        kind: "heading";
+        level: 1 | 2 | 3;
+        text: string;
+    } | {
+        kind: "text";
+        text: string;
+    } | {
+        kind: "list";
+        ordered: boolean;
+        items: string[];
+    } | {
+        kind: "quote";
+        text: string;
+    } | {
+        kind: "image";
+        url: string;
+        alt?: string;
+    } | {
+        kind: "button";
+        label: string;
+        url: string;
+    } | {
+        kind: "product";
+        title: string;
+        url: string;
+        imageUrl?: string;
+        price?: string;
+        description?: string;
+        ctaLabel?: string;
+    } | {
+        kind: "divider";
+    } | {
+        kind: "html";
+        html: string;
+    } | {
+        kind: "columns";
+        columns: ({
+            kind: "heading";
+            level: 1 | 2 | 3;
+            text: string;
+        } | {
+            kind: "text";
+            text: string;
+        } | {
+            kind: "list";
+            ordered: boolean;
+            items: string[];
+        } | {
+            kind: "quote";
+            text: string;
+        } | {
+            kind: "image";
+            url: string;
+            alt?: string;
+        } | {
+            kind: "button";
+            label: string;
+            url: string;
+        } | {
+            kind: "product";
+            title: string;
+            url: string;
+            imageUrl?: string;
+            price?: string;
+            description?: string;
+            ctaLabel?: string;
+        } | {
+            kind: "divider";
+        } | {
+            kind: "html";
+            html: string;
+        })[][];
+    })[];
+    /**
+     * Saved filter of the issue; `null` sends to the whole topic again.
+     */
+    audienceFilterId?: string | null;
+    /**
+     * Subject A/B test (Pro plan or higher): 1 to 3 alternative subjects tested against the issue's own on a random sample; after the wait the rest gets the winner. `null` removes the test.
+     */
+    abTest?: {
+        /**
+         * The alternative subjects B, C, D (1 to 3). Variant A is the issue's own subject and preheader.
+         */
+        variants: {
+            /**
+             * Subject line of this variant.
+             */
+            subject: string;
+            /**
+             * Preview text of this variant (defaults to the issue's).
+             */
+            preheader?: string | null;
+        }[];
+        /**
+         * Share of the audience in the test sample, in percent (10–50, default 20).
+         */
+        samplePct?: number;
+        /**
+         * Winner criterion: unique `opens` (default; inflated by Apple Mail Privacy Protection) or unique `clicks`.
+         */
+        metric?: "opens" | "clicks";
+        /**
+         * Hours between the end of the sample and the choice (1–48, default 4).
+         */
+        waitHours?: number;
+        /**
+         * `auto` (default) picks the best rate; `manual` waits for your choice (auto pick 24 h after the wait).
+         */
+        winnerMode?: "auto" | "manual";
+    } | null;
+};
+type NewslettersUpdateResponse = {
+    object: string;
+    id: string;
+    segment_id: string;
+    topic_id: unknown;
+    subject: string;
+    preheader: string;
+    status: string;
+    body: {
+        format: string;
+        content: unknown;
+        blocks: {
+            blockId: string;
+            kind: string;
+            text: string;
+        }[];
+    };
+    audience_limit: unknown;
+    scheduled_for: unknown;
+    pause_reason: unknown;
+    recipient_estimate: unknown;
+    ab_test: unknown;
+    ab_winner: unknown;
+    created_at: string;
+    updated_at: string;
+};
+interface NewslettersRemoveParams {
+    id: string;
+}
+type NewslettersRemoveResponse = {
+    object: string;
+    id: string;
+    deleted: boolean;
+};
+interface NewslettersDuplicateParams {
+    id: string;
+}
+type NewslettersDuplicateResponse = {
+    object: string;
+    id: string;
+    segment_id: string;
+    topic_id: unknown;
+    subject: string;
+    preheader: string;
+    status: string;
+    body: {
+        format: string;
+        content: unknown;
+        blocks: {
+            blockId: string;
+            kind: string;
+            text: string;
+        }[];
+    };
+    audience_limit: unknown;
+    scheduled_for: unknown;
+    pause_reason: unknown;
+    recipient_estimate: unknown;
+    ab_test: unknown;
+    ab_winner: unknown;
+    created_at: string;
+    updated_at: string;
+};
+interface NewslettersReviewParams {
+    id: string;
+}
+type NewslettersReviewResponse = {
+    object: string;
+    blocking: boolean;
+    items: {
+        id: string;
+        level: string;
+        values?: {
+            kb: number;
+        };
+    }[];
+};
+interface NewslettersTestParams {
+    id: string;
+}
+type NewslettersTestResponse = {
+    object: string;
+    to: string;
+};
+type NewslettersSendParams = {
+    id: string;
+} & {
+    /**
+     * Send only to the N most engaged contacts now; the rest can follow with send-more.
+     */
+    audienceLimit?: number;
+};
+type NewslettersSendResponse = {
+    object: string;
+    id: string;
+    status: string;
+};
+type NewslettersScheduleParams = {
+    id: string;
+} & {
+    /**
+     * ISO 8601 date, in the future, at most one year ahead.
+     */
+    scheduledAt: string;
+    /**
+     * Send only to the N most engaged contacts now; the rest can follow with send-more.
+     */
+    audienceLimit?: number;
+};
+type NewslettersScheduleResponse = {
+    object: string;
+    id: string;
+    status: string;
+    scheduled_for: string;
+};
+interface NewslettersUnscheduleParams {
+    id: string;
+}
+type NewslettersUnscheduleResponse = {
+    object: string;
+    id: string;
+    status: string;
+};
+interface NewslettersPauseParams {
+    id: string;
+}
+type NewslettersPauseResponse = {
+    object: string;
+    id: string;
+    status: string;
+};
+interface NewslettersResumeParams {
+    id: string;
+}
+type NewslettersResumeResponse = {
+    object: string;
+    id: string;
+    status: string;
+};
+type NewslettersSendMoreParams = {
+    id: string;
+} & {
+    /**
+     * How many of the next most engaged contacts to add.
+     */
+    count: number;
+};
+type NewslettersSendMoreResponse = {
+    object: string;
+    id: string;
+    status: string;
+};
+interface NewslettersReportParams {
+    id: string;
+}
+type NewslettersReportResponse = {
+    object: string;
+    id: string;
+    status: string;
+    totals: {
+        sent: number;
+        delivered: number;
+        opened: number;
+        clicked: number;
+        bounced: number;
+        complained: number;
+        unsubscribed: number;
+    };
+    rates: {
+        delivery: number;
+        open: number;
+        click: number;
+        bounce: number;
+        complaint: number;
+        unsubscribe: number;
+    };
+    progress: {
+        attempted: number;
+        recipient_estimate: number;
+        audience_limit: unknown;
+    };
+    providers: {
+        provider: string;
+        sent: number;
+        delivered: number;
+        opened: number;
+        clicked: number;
+        bounced: number;
+        complained: number;
+    }[];
+    ab_test: {
+        phase: string;
+        sample_pct: number;
+        metric: string;
+        wait_hours: number;
+        winner_mode: string;
+        winner: unknown;
+        decided_at: unknown;
+        decided_by: unknown;
+        decide_at: string;
+        variants: {
+            key: string;
+            subject: string;
+            preheader: string;
+            total: {
+                attempted: number;
+                sent: number;
+                delivered: number;
+                opened: number;
+                clicked: number;
+                hard_bounced: number;
+                complained: number;
+                unsubscribed: number;
+            };
+        }[];
+        report: {
+            metric: string;
+            leader: string;
+            winner: unknown;
+            p_value: number;
+            significant: boolean;
+            variants: {
+                variant: string;
+                sent: number;
+                opened: number;
+                clicked: number;
+                open_rate: number;
+                click_rate: number;
+                ci_low: number;
+                ci_high: number;
+                leader: boolean;
+            }[];
+        };
+    };
+    links: {
+        url: string;
+        label: string;
+        clicks: number;
+        unique_clickers: number;
+        share: number;
+    }[];
+    links_total: number;
+};
+type NewslettersAbWinnerParams = {
+    id: string;
+} & {
+    /**
+     * The winning variant: `A` (the issue's own subject), `B`, `C` or `D`.
+     */
+    variant: "A" | "B" | "C" | "D";
+};
+type NewslettersAbWinnerResponse = {
+    object: string;
+    id: string;
+    segment_id: string;
+    topic_id: unknown;
+    subject: string;
+    preheader: string;
+    status: string;
+    body: {
+        format: string;
+        content: unknown;
+        blocks: {
+            blockId: string;
+            kind: string;
+            text: string;
+        }[];
+    };
+    audience_limit: unknown;
+    scheduled_for: unknown;
+    pause_reason: unknown;
+    recipient_estimate: unknown;
+    ab_test: unknown;
+    ab_winner: string;
+    created_at: string;
+    updated_at: string;
+};
+interface ContactsListParams {
+    /**
+     * 1–100, default 20.
+     */
+    limit?: number;
+    /**
+     * Id of the last item of the previous page (older items).
+     */
+    after?: string;
+    /**
+     * Id of the first item of the previous page (newer items).
+     */
+    before?: string;
+    segmentId?: string;
+    status?: "active" | "pending" | "unsubscribed" | "bounced" | "complained" | "dormant";
+    /**
+     * Substring of the email address.
+     */
+    search?: string;
+    /**
+     * Only contacts with this tag (case-insensitive).
+     */
+    tag?: string;
+}
+type ContactsListResponse = {
+    object: string;
+    has_more: boolean;
+    data: {
+        object: string;
+        id: string;
+        email: string;
+        status: string;
+        segment_id: string;
+    }[];
+};
+interface ContactsCreateParams {
+    email: string;
+    /**
+     * Optional when the workspace has a single active newsletter.
+     */
+    segmentId?: string;
+    name?: string;
+    /**
+     * Used by `{{first_name}}` in your issues.
+     */
+    firstName?: string;
+    lastName?: string;
+    language?: string;
+    /**
+     * Custom field values by key (`/contact-fields`): text, number, `YYYY-MM-DD` date, boolean or one of the choices. `null` erases a value.
+     */
+    customFields?: {
+        [k: string]: string | number | boolean | null;
+    };
+    /**
+     * Added to the contact's tags (also when the contact already exists).
+     */
+    tags?: string[];
+}
+type ContactsCreateResponse = {
+    object: string;
+    id: string;
+    email: string;
+    status: string;
+    existed: boolean;
+};
+interface ContactsImportParams {
+    segmentId?: string;
+    /**
+     * You confirm every contact opted in to receive this newsletter (no bought, rented or scraped list).
+     */
+    consent: true;
+    contacts: {
+        /**
+         * Checked by the import cleaning; an invalid address is reported, not an error.
+         */
+        email: string;
+        name?: string | null;
+        firstName?: string | null;
+        lastName?: string | null;
+        language?: string | null;
+        customFields?: {
+            [k: string]: string | number | boolean | null;
+        } | null;
+        /**
+         * Open rate on your previous platform (0–1).
+         */
+        openRate?: number | null;
+        /**
+         * Click rate on your previous platform (0–1).
+         */
+        clickRate?: number | null;
+        /**
+         * Last open or click on your previous platform.
+         */
+        lastActivityAt?: string | null;
+        /**
+         * Merged into the tags of a contact already in the newsletter (never replaced).
+         */
+        tags?: string[] | null;
+        /**
+         * `unsubscribed` keeps a contact who left on your previous platform: stored unsubscribed, never emailed, and a contact already in the newsletter is unsubscribed too. Default `active`.
+         */
+        status?: ("active" | "unsubscribed") | null;
+        /**
+         * When they unsubscribed on the previous platform (with `status: "unsubscribed"`); default: the import time.
+         */
+        unsubscribedAt?: string | null;
+    }[];
+}
+type ContactsImportResponse = {
+    object: string;
+    total: number;
+    inserted: number;
+    rejected: number;
+    reasons: {
+        invalid: number;
+        typo: number;
+        spam_trap: number;
+        role: number;
+        disposable: number;
+        no_mx: number;
+        duplicate: number;
+        suppressed: number;
+        capped: number;
+    };
+    rejected_rows: {
+        line: number;
+        email: string;
+        reason: string;
+        suggestion?: string;
+    }[];
+    pending_review: boolean;
+};
+interface ContactsExportParams {
+    segmentId?: string;
+    status?: "active" | "pending" | "unsubscribed" | "bounced" | "complained" | "dormant";
+}
+type ContactsExportResponse = string;
+interface ContactsGetParams {
+    id: string;
+}
+type ContactsGetResponse = {
+    object: string;
+    id: string;
+    email: string;
+    status: string;
+    engagement: {
+        emails_sent: number;
+        emails_opened: number;
+        emails_clicked: number;
+    };
+    status_history: {
+        at: string;
+        from_status: string;
+        to_status: string;
+        source: string;
+        actor: string;
+        detail: unknown;
+    }[];
+};
+interface ContactsUnsubscribeParams {
+    id: string;
+}
+type ContactsUnsubscribeResponse = {
+    object: string;
+    id: string;
+    status: string;
+};
+interface ContactsReactivateParams {
+    id: string;
+}
+type ContactsReactivateResponse = {
+    object: string;
+    id: string;
+    status: string;
+};
+interface ContactsRemoveParams {
+    id: string;
+}
+type ContactsRemoveResponse = {
+    object: string;
+    id: string;
+    deleted: boolean;
+};
+type ContactsUpdateParams = {
+    id: string;
+} & {
+    firstName?: string | null;
+    lastName?: string | null;
+    name?: string | null;
+    language?: string | null;
+    /**
+     * Merged into the stored values; `null` erases a key.
+     */
+    customFields?: {
+        [k: string]: string | number | boolean | null;
+    };
+    /**
+     * Replaces every tag of the contact; `null` or `[]` removes them all.
+     */
+    tags?: string[] | null;
+    /**
+     * Added to the current tags.
+     */
+    addTags?: string[];
+    /**
+     * Removed from the current tags.
+     */
+    removeTags?: string[];
+};
+type ContactsUpdateResponse = {
+    object: string;
+    id: string;
+    first_name: string;
+    custom_fields: {
+        plan: string;
+    };
+};
+type ContactFieldsListParams = Record<string, never>;
+type ContactFieldsListResponse = {
+    object: string;
+    has_more: boolean;
+    data: {
+        object: string;
+        id: string;
+        key: string;
+        label: string;
+        type: string;
+        options: string[];
+        default_value: unknown;
+        in_signup: boolean;
+        position: number;
+        created_at: string;
+    }[];
+};
+interface ContactFieldsCreateParams {
+    /**
+     * Lowercase letters, digits, `_`. Used as `{{custom.<key>}}`. Immutable.
+     */
+    key: string;
+    label: string;
+    /**
+     * Immutable.
+     */
+    type: "text" | "number" | "date" | "boolean" | "choice";
+    /**
+     * Choices of a `choice` field (1–50).
+     */
+    options?: string[];
+    /**
+     * Used by personalization when a contact has no value.
+     */
+    defaultValue?: string | number | boolean | null;
+    /**
+     * Accepted from signup forms (`POST /signups`).
+     */
+    inSignup?: boolean;
+}
+type ContactFieldsCreateResponse = {
+    object: string;
+    id: string;
+    key: string;
+    label: string;
+    type: string;
+    options: string[];
+    default_value: unknown;
+    in_signup: boolean;
+    position: number;
+    created_at: string;
+};
+type ContactFieldsUpdateParams = {
+    id: string;
+} & {
+    label?: string;
+    options?: string[];
+    defaultValue?: string | number | boolean | null;
+    inSignup?: boolean;
+    position?: number;
+};
+type ContactFieldsUpdateResponse = {
+    object: string;
+    id: string;
+    key: string;
+    label: string;
+    type: string;
+    options: string[];
+    default_value: unknown;
+    in_signup: boolean;
+    position: number;
+    created_at: string;
+};
+interface ContactFieldsRemoveParams {
+    id: string;
+}
+type ContactFieldsRemoveResponse = {
+    object: string;
+    id: string;
+    deleted: boolean;
+};
+interface EventsSendParams {
+    /**
+     * Give `email` or `contact_id`.
+     */
+    email?: string;
+    contactId?: string;
+    /**
+     * Name like `purchase` or `trial.started` (letters, digits, `_ . : -`). `email.` and `contact.` are reserved.
+     */
+    event: string;
+    /**
+     * Free JSON object, 4 KB max.
+     */
+    properties?: {
+        [k: string]: unknown;
+    };
+    /**
+     * Defaults to now. Up to 13 months back, 1 hour ahead.
+     */
+    occurredAt?: string;
+    /**
+     * Create the contact when the address is unknown (as `POST /contacts`). Default `false`: 404.
+     */
+    createContact?: boolean;
+    /**
+     * Newsletter of a contact created with `create_contact`.
+     */
+    segmentId?: string;
+}
+type EventsSendResponse = {
+    object: string;
+    id: string;
+    email: string;
+    event: string;
+    properties: {
+        plan: string;
+        amount: number;
+    };
+    occurred_at: string;
+    contact_created: boolean;
+};
+interface AudienceFiltersListParams {
+    /**
+     * 1–100, default 20.
+     */
+    limit?: number;
+    /**
+     * Id of the last item of the previous page (older items).
+     */
+    after?: string;
+    /**
+     * Id of the first item of the previous page (newer items).
+     */
+    before?: string;
+}
+type AudienceFiltersListResponse = {
+    object: string;
+    has_more: boolean;
+    data: {
+        object: string;
+        id: string;
+        name: string;
+        description: unknown;
+        rules: {
+            op: string;
+            rules: {
+                field?: string;
+                op: string;
+                value?: string;
+                event?: string;
+                within_days?: number;
+            }[];
+        };
+        created_at: string;
+        updated_at: string;
+    }[];
+};
+interface AudienceFiltersCreateParams {
+    name: string;
+    description?: string | null;
+    /**
+     * AND/OR tree: `{"op":"and","rules":[{"field":"custom.plan","op":"eq","value":"pro"},{"event":"email.clicked","op":"performed","within_days":30}]}`. See the guide.
+     */
+    rules: {
+        [k: string]: unknown;
+    };
+}
+type AudienceFiltersCreateResponse = {
+    object: string;
+    id: string;
+    name: string;
+    description: unknown;
+    rules: {
+        op: string;
+        rules: {
+            field?: string;
+            op: string;
+            value?: string;
+            event?: string;
+            within_days?: number;
+        }[];
+    };
+    created_at: string;
+    updated_at: string;
+};
+interface AudienceFiltersGetParams {
+    id: string;
+}
+type AudienceFiltersGetResponse = {
+    object: string;
+    id: string;
+    name: string;
+    description: unknown;
+    rules: {
+        op: string;
+        rules: {
+            field?: string;
+            op: string;
+            value?: string;
+            event?: string;
+            within_days?: number;
+        }[];
+    };
+    created_at: string;
+    updated_at: string;
+};
+type AudienceFiltersUpdateParams = {
+    id: string;
+} & {
+    name?: string;
+    description?: string | null;
+    /**
+     * AND/OR tree: `{"op":"and","rules":[{"field":"custom.plan","op":"eq","value":"pro"},{"event":"email.clicked","op":"performed","within_days":30}]}`. See the guide.
+     */
+    rules?: {
+        [k: string]: unknown;
+    };
+};
+type AudienceFiltersUpdateResponse = {
+    object: string;
+    id: string;
+    name: string;
+    description: unknown;
+    rules: {
+        op: string;
+        rules: {
+            field?: string;
+            op: string;
+            value?: string;
+            event?: string;
+            within_days?: number;
+        }[];
+    };
+    created_at: string;
+    updated_at: string;
+};
+interface AudienceFiltersRemoveParams {
+    id: string;
+}
+type AudienceFiltersRemoveResponse = {
+    object: string;
+    id: string;
+    deleted: boolean;
+};
+interface AudienceFiltersCountParams {
+    /**
+     * A saved filter. Give `filter_id` or `rules`.
+     */
+    filterId?: string;
+    /**
+     * AND/OR tree: `{"op":"and","rules":[{"field":"custom.plan","op":"eq","value":"pro"},{"event":"email.clicked","op":"performed","within_days":30}]}`. See the guide.
+     */
+    rules?: {
+        [k: string]: unknown;
+    };
+    /**
+     * Count within one newsletter only.
+     */
+    segmentId?: string;
+}
+type AudienceFiltersCountResponse = {
+    object: string;
+    total: number;
+    active: number;
+};
+interface SignupsCreateParams {
+    email: string;
+    name?: string;
+    firstName?: string;
+    /**
+     * Optional when the workspace has a single active newsletter.
+     */
+    segmentId?: string;
+    language?: string;
+    /**
+     * Page the form was on (attribution).
+     */
+    sourceUrl?: string;
+    /**
+     * Only fields marked `in_signup` are kept; other keys and invalid values are silently dropped.
+     */
+    customFields?: {
+        [k: string]: string | number | boolean | null;
+    };
+}
+type SignupsCreateResponse = {
+    object: string;
+    status: string;
+};
+interface SegmentsListParams {
+    /**
+     * 1–100, default 20.
+     */
+    limit?: number;
+    /**
+     * Id of the last item of the previous page (older items).
+     */
+    after?: string;
+    /**
+     * Id of the first item of the previous page (newer items).
+     */
+    before?: string;
+}
+type SegmentsListResponse = {
+    object: string;
+    has_more: boolean;
+    data: {
+        object: string;
+        id: string;
+        name: string;
+        slug: string;
+    }[];
+};
+interface SegmentsCreateParams {
+    name: string;
+    slug: string;
+    language?: string;
+    description?: string;
+    themes?: string[];
+}
+type SegmentsCreateResponse = {
+    object: string;
+    id: string;
+    name: string;
+    slug: string;
+};
+interface TopicsListParams {
+    segmentId: string;
+}
+type TopicsListResponse = {
+    object: string;
+    has_more: boolean;
+    data: {
+        object: string;
+        id: string;
+        segment_id: string;
+        name: string;
+    }[];
+};
+interface SegmentsArchiveGetParams {
+    id: string;
+}
+type SegmentsArchiveGetResponse = {
+    object: string;
+    segment_id: string;
+    enabled: boolean;
+    slug: string;
+    url: string;
+    custom_domain: string;
+    description: string;
+    author: string;
+    about: unknown;
+    avatar_url: unknown;
+    links: {
+        x: string;
+    };
+};
+type SegmentsArchiveUpdateParams = {
+    id: string;
+} & {
+    /**
+     * Publish the sent issues of this newsletter on its public archive.
+     */
+    enabled?: boolean;
+    /**
+     * Archive address: `smartletter.ai/<locale>/n/<slug>`. Unique across Smartletter.
+     */
+    slug?: string;
+    /**
+     * One-line description (also the meta description).
+     */
+    description?: string | null;
+    author?: string | null;
+    /**
+     * Text of the About page (plain text, blank lines between paragraphs).
+     */
+    about?: string | null;
+    /**
+     * https URL of an avatar or logo.
+     */
+    avatarUrl?: string | null;
+    /**
+     * Social links (https). Replaces the whole set.
+     */
+    links?: {
+        website?: string | null;
+        x?: string | null;
+        linkedin?: string | null;
+        youtube?: string | null;
+        instagram?: string | null;
+        github?: string | null;
+        bluesky?: string | null;
+    };
+};
+type SegmentsArchiveUpdateResponse = {
+    object: string;
+    segment_id: string;
+    enabled: boolean;
+    slug: string;
+    url: string;
+    custom_domain: string;
+    description: string;
+    author: string;
+    about: unknown;
+    avatar_url: unknown;
+    links: {
+        x: string;
+    };
+};
+type NewslettersArchiveUpdateParams = {
+    id: string;
+} & {
+    /**
+     * Pin at the top of the archive (3 pinned issues max per newsletter).
+     */
+    pinned?: boolean;
+    /**
+     * Hide this issue from the public archive.
+     */
+    hidden?: boolean;
+};
+type NewslettersArchiveUpdateResponse = {
+    object: string;
+    id: string;
+    pinned: boolean;
+    hidden: boolean;
+};
+interface SegmentsDomainGetParams {
+    id: string;
+}
+type SegmentsDomainGetResponse = {
+    object: string;
+    id: string;
+    segment_id: string;
+    domain: string;
+    status: string;
+    uses: string[];
+    records: {
+        type: string;
+        name: string;
+        value: string;
+    }[];
+    last_checked_at: unknown;
+    verified_at: unknown;
+    last_error: unknown;
+    created_at: string;
+};
+type SegmentsDomainSetParams = {
+    id: string;
+} & {
+    /**
+     * Subdomain you own, e.g. `news.acme.com` (a CNAME to Vercel).
+     */
+    domain: string;
+};
+type SegmentsDomainSetResponse = {
+    object: string;
+    id: string;
+    segment_id: string;
+    domain: string;
+    status: string;
+    uses: string[];
+    records: {
+        type: string;
+        name: string;
+        value: string;
+    }[];
+    last_checked_at: unknown;
+    verified_at: unknown;
+    last_error: unknown;
+    created_at: string;
+};
+interface SegmentsDomainRemoveParams {
+    id: string;
+}
+type SegmentsDomainRemoveResponse = {
+    object: string;
+    segment_id: string;
+    deleted: boolean;
+};
+interface SuppressionsListParams {
+    /**
+     * 1–100, default 20.
+     */
+    limit?: number;
+    /**
+     * Id of the last item of the previous page (older items).
+     */
+    after?: string;
+    /**
+     * Id of the first item of the previous page (newer items).
+     */
+    before?: string;
+    reason?: "bounced" | "complained" | "user_unsub" | "admin" | "gdpr" | "ses_suppressed" | "soft_bounce_repeated";
+}
+type SuppressionsListResponse = {
+    object: string;
+    has_more: boolean;
+    data: {
+        object: string;
+        id: string;
+        email: string;
+        reason: string;
+        expires_at: string;
+    }[];
+};
+interface SuppressionsCreateParams {
+    email: string;
+    reason?: "bounced" | "complained" | "user_unsub" | "admin" | "gdpr";
+    notes?: string;
+}
+type SuppressionsCreateResponse = {
+    object: string;
+    id: string;
+    email: string;
+    reason: string;
+};
+interface SuppressionsRemoveParams {
+    id: string;
+}
+type SuppressionsRemoveResponse = {
+    object: string;
+    id: string;
+    deleted: boolean;
+};
+interface ImagesListParams {
+    /**
+     * 1–100, default 20.
+     */
+    limit?: number;
+    /**
+     * Id of the last item of the previous page (older items).
+     */
+    after?: string;
+    /**
+     * Id of the first item of the previous page (newer items).
+     */
+    before?: string;
+}
+type ImagesListResponse = {
+    object: string;
+    has_more: boolean;
+    data: {
+        object: string;
+        id: string;
+        url: string;
+    }[];
+};
+type ImagesCreateParams = Blob | ArrayBuffer | Uint8Array | string;
+type ImagesCreateResponse = {
+    object: string;
+    id: string;
+    url: string;
+    content_type: string;
+    size_bytes: number;
+};
+type StatsOverviewParams = Record<string, never>;
+type StatsOverviewResponse = {
+    object: string;
+    subscribers: {
+        active: number;
+        new_last_30_days: number;
+        unsubscribed_last_30_days: number;
+    };
+    daily: {
+        date: string;
+        new_subscribers: number;
+        unsubscribed: number;
+        emails_sent: number;
+    }[];
+    emails: {
+        sent_this_month: number;
+        sent_last_30_days: number;
+        newsletters_sent_last_30_days: number;
+    };
+};
+interface DomainsCreateParams {
+    name: string;
+    trackingSubdomain?: string;
+}
+type DomainsCreateResponse = {
+    object: string;
+    id: string;
+    name: string;
+    status: string;
+    created_at: string;
+    region: string;
+    records: {
+        record: string;
+        name: string;
+        type: string;
+        ttl: string;
+        status: string;
+        value: string;
+        priority?: number;
+    }[];
+    tracking_subdomain?: string;
+};
+interface DomainsListParams {
+    /**
+     * 1–100, default 20.
+     */
+    limit?: number;
+    /**
+     * Id of the last item of the previous page (older items).
+     */
+    after?: string;
+    /**
+     * Id of the first item of the previous page (newer items).
+     */
+    before?: string;
+}
+type DomainsListResponse = {
+    object: string;
+    has_more: boolean;
+    data: {
+        id: string;
+        name: string;
+        status: string;
+        created_at: string;
+        region: string;
+    }[];
+};
+interface DomainsGetParams {
+    id: string;
+}
+type DomainsGetResponse = {
+    object: string;
+    id: string;
+    name: string;
+    status: string;
+    created_at: string;
+    region: string;
+    records: {
+        record: string;
+        name: string;
+        type: string;
+        ttl: string;
+        status: string;
+        value: string;
+        priority?: number;
+    }[];
+};
+interface DomainsVerifyParams {
+    id: string;
+}
+type DomainsVerifyResponse = {
+    object: string;
+    id: string;
+};
+interface ApiKeysCreateParams {
+    name: string;
+    permission?: "full_access" | "sending_access" | "signups";
+    /**
+     * Restricts a `sending_access` key to one verified domain.
+     */
+    domainId?: string;
+}
+type ApiKeysCreateResponse = {
+    id: string;
+    token: string;
+};
+interface ApiKeysListParams {
+    /**
+     * 1–100, default 20.
+     */
+    limit?: number;
+    /**
+     * Id of the last item of the previous page (older items).
+     */
+    after?: string;
+    /**
+     * Id of the first item of the previous page (newer items).
+     */
+    before?: string;
+}
+type ApiKeysListResponse = {
+    object: string;
+    has_more: boolean;
+    data: {
+        id: string;
+        name: string;
+        created_at: string;
+        last_used_at: string | null;
+    }[];
+};
+type ApiKeysUpdateParams = {
+    id: string;
+} & {
+    name: string;
+};
+type ApiKeysUpdateResponse = {
+    object: string;
+    id: string;
+};
+interface ApiKeysRemoveParams {
+    id: string;
+}
+type ApiKeysRemoveResponse = {
+    object: string;
+    id: string;
+    deleted: boolean;
+};
+interface LogsListParams {
+    /**
+     * 1–100, default 20.
+     */
+    limit?: number;
+    /**
+     * Id of the last item of the previous page (older items).
+     */
+    after?: string;
+    /**
+     * Id of the first item of the previous page (newer items).
+     */
+    before?: string;
+}
+type LogsListResponse = {
+    object: string;
+    has_more: boolean;
+    data: {
+        id: string;
+        endpoint: string;
+        method: string;
+        response_status: number;
+        source: string;
+    }[];
+};
+interface LogsGetParams {
+    id: string;
+}
+type LogsGetResponse = {
+    object: string;
+    id: string;
+    endpoint: string;
+    request_body: Record<string, unknown>;
+    response_body: Record<string, unknown>;
+};
+type UsageGetParams = Record<string, never>;
+type UsageGetResponse = {
+    object: string;
+    emails: {
+        monthly: {
+            used: number;
+            limit: number;
+        };
+    };
+    contacts: {
+        used: number;
+        limit: unknown;
+    };
+};
+interface SequencesListParams {
+    /**
+     * Archived sequences are hidden unless `true`.
+     */
+    includeArchived?: "true" | "false";
+}
+type SequencesListResponse = {
+    object: string;
+    has_more: boolean;
+    data: {
+        object: string;
+        id: string;
+        name: string;
+        description: unknown;
+        status: string;
+        segment_id: string;
+        topic_id: unknown;
+        trigger: {
+            type: string;
+            lead_magnet_id: unknown;
+        };
+        reentry: {
+            mode: string;
+            days: unknown;
+        };
+        exit: {
+            events: string[];
+            filter_id: unknown;
+        };
+        steps: {
+            id: string;
+            type: string;
+            subject?: string;
+            preheader?: unknown;
+            doc?: {
+                type: string;
+                content: unknown[];
+            };
+            amount?: number;
+            unit?: string;
+        }[];
+        published_version: {
+            id: string;
+            number: number;
+        };
+        has_unpublished_changes: boolean;
+        activated_at: string;
+        archived_at: unknown;
+        created_at: string;
+        updated_at: string;
+    }[];
+};
+interface SequencesCreateParams {
+    name: string;
+    description?: string | null;
+    /**
+     * The newsletter the emails belong to (sender, footer, unsubscribe).
+     */
+    segmentId: string;
+    /**
+     * A topic of that newsletter: a contact who leaves it leaves the sequence.
+     */
+    topicId?: string | null;
+    /**
+     * Default `{type: "manual"}`.
+     */
+    trigger?: {
+        type: "subscribed" | "topic_subscribed" | "lead_magnet" | "event" | "email_opened" | "email_clicked" | "filter" | "manual";
+        /**
+         * subscribed: imported contacts enter too (default `false`).
+         */
+        includeImports?: boolean;
+        /**
+         * topic_subscribed.
+         */
+        topicId?: string;
+        /**
+         * lead_magnet: `null` = any lead magnet.
+         */
+        leadMagnetId?: string | null;
+        /**
+         * event: the custom event name.
+         */
+        event?: string;
+        /**
+         * email_opened / email_clicked: `null` = any issue.
+         */
+        newsletterId?: string | null;
+        /**
+         * filter: the saved filter whose new matches enter (checked every 15 minutes).
+         */
+        filterId?: string;
+        /**
+         * filter: contacts already matching at activation enter too (default `false`).
+         */
+        includeExisting?: boolean;
+        [k: string]: unknown;
+    };
+    /**
+     * Can a contact go through again? Default `once`.
+     */
+    reentry?: {
+        mode: "once" | "always" | "after_days";
+        days?: number | null;
+    };
+    exit?: {
+        /**
+         * Custom events that take the contact out.
+         */
+        events?: string[];
+        /**
+         * A saved filter: a contact who matches it leaves.
+         */
+        filterId?: string | null;
+    };
+    /**
+     * The draft tree. Activate to publish it.
+     */
+    steps?: {
+        /**
+         * Your id for the step, unique in the sequence: letters, digits, `_`, `-`. Keep it when you edit (stats follow it).
+         */
+        id: string;
+        type: "email" | "delay" | "wait_event" | "condition" | "update_contact" | "webhook" | "exit";
+        /**
+         * email: the subject (personalization tags allowed).
+         */
+        subject?: string;
+        /**
+         * email: preview text.
+         */
+        preheader?: string | null;
+        /**
+         * email: body in Markdown (stored as a visual-editor document).
+         */
+        markdown?: string;
+        /**
+         * email: body in HTML (stored as one HTML block).
+         */
+        html?: string;
+        /**
+         * email: a visual-editor document (`{type: "doc", content}`).
+         */
+        doc?: {
+            [k: string]: unknown;
+        };
+        /**
+         * email: a published transactional template instead of a body.
+         */
+        templateId?: string;
+        /**
+         * delay: how many `unit` (5 minutes to 365 days).
+         */
+        amount?: number;
+        unit?: "minutes" | "hours" | "days";
+        /**
+         * delay: wait until the next time of day instead of a fixed duration.
+         */
+        until?: {
+            /**
+             * `HH:MM`
+             */
+            time: string;
+            /**
+             * 0 = Sunday … 6; all days when absent.
+             */
+            weekdays?: number[];
+            /**
+             * `contact`: the custom field `timezone` (IANA), else the newsletter's.
+             */
+            timezone: "contact" | "newsletter";
+        };
+        /**
+         * wait_event: a custom event name, `email.opened` or `email.clicked`.
+         */
+        event?: string;
+        /**
+         * wait_event: 1 to 720.
+         */
+        timeoutHours?: number;
+        onTimeout?: "continue" | "exit";
+        /**
+         * condition: a saved filter (or give `rule`).
+         */
+        filterId?: string;
+        /**
+         * condition: a rule like the audience filters'.
+         */
+        rule?: {
+            [k: string]: unknown;
+        };
+        /**
+         * condition: steps when it matches; both branches join after the condition.
+         */
+        yes?: {
+            [k: string]: unknown;
+        }[];
+        no?: {
+            [k: string]: unknown;
+        }[];
+        /**
+         * update_contact.
+         */
+        action?: "set_field" | "subscribe_topic" | "unsubscribe_topic";
+        /**
+         * update_contact set_field: the custom field key.
+         */
+        key?: string;
+        /**
+         * update_contact set_field: `null` clears it.
+         */
+        value?: (string | number | boolean) | null;
+        /**
+         * update_contact (un)subscribe_topic.
+         */
+        topicId?: string;
+        /**
+         * webhook: one of your webhook endpoints (event `sequence.step`).
+         */
+        webhookId?: string;
+        [k: string]: unknown;
+    }[];
+}
+type SequencesCreateResponse = {
+    object: string;
+    id: string;
+    name: string;
+    description: unknown;
+    status: string;
+    segment_id: string;
+    topic_id: unknown;
+    trigger: {
+        type: string;
+        lead_magnet_id: unknown;
+    };
+    reentry: {
+        mode: string;
+        days: unknown;
+    };
+    exit: {
+        events: string[];
+        filter_id: unknown;
+    };
+    steps: {
+        id: string;
+        type: string;
+        subject?: string;
+        preheader?: unknown;
+        doc?: {
+            type: string;
+            content: unknown[];
+        };
+        amount?: number;
+        unit?: string;
+    }[];
+    published_version: unknown;
+    has_unpublished_changes: boolean;
+    activated_at: string;
+    archived_at: unknown;
+    created_at: string;
+    updated_at: string;
+};
+interface SequencesGetParams {
+    id: string;
+}
+type SequencesGetResponse = {
+    object: string;
+    id: string;
+    name: string;
+    description: unknown;
+    status: string;
+    segment_id: string;
+    topic_id: unknown;
+    trigger: {
+        type: string;
+        lead_magnet_id: unknown;
+    };
+    reentry: {
+        mode: string;
+        days: unknown;
+    };
+    exit: {
+        events: string[];
+        filter_id: unknown;
+    };
+    steps: {
+        id: string;
+        type: string;
+        subject?: string;
+        preheader?: unknown;
+        doc?: {
+            type: string;
+            content: unknown[];
+        };
+        amount?: number;
+        unit?: string;
+    }[];
+    published_version: {
+        id: string;
+        number: number;
+    };
+    has_unpublished_changes: boolean;
+    activated_at: string;
+    archived_at: unknown;
+    created_at: string;
+    updated_at: string;
+};
+type SequencesUpdateParams = {
+    id: string;
+} & {
+    name?: string;
+    description?: string | null;
+    /**
+     * Only while the sequence is a draft.
+     */
+    segmentId?: string;
+    /**
+     * A topic of that newsletter: a contact who leaves it leaves the sequence.
+     */
+    topicId?: string | null;
+    /**
+     * Default `{type: "manual"}`.
+     */
+    trigger?: {
+        type: "subscribed" | "topic_subscribed" | "lead_magnet" | "event" | "email_opened" | "email_clicked" | "filter" | "manual";
+        /**
+         * subscribed: imported contacts enter too (default `false`).
+         */
+        includeImports?: boolean;
+        /**
+         * topic_subscribed.
+         */
+        topicId?: string;
+        /**
+         * lead_magnet: `null` = any lead magnet.
+         */
+        leadMagnetId?: string | null;
+        /**
+         * event: the custom event name.
+         */
+        event?: string;
+        /**
+         * email_opened / email_clicked: `null` = any issue.
+         */
+        newsletterId?: string | null;
+        /**
+         * filter: the saved filter whose new matches enter (checked every 15 minutes).
+         */
+        filterId?: string;
+        /**
+         * filter: contacts already matching at activation enter too (default `false`).
+         */
+        includeExisting?: boolean;
+        [k: string]: unknown;
+    };
+    /**
+     * Can a contact go through again? Default `once`.
+     */
+    reentry?: {
+        mode: "once" | "always" | "after_days";
+        days?: number | null;
+    };
+    exit?: {
+        /**
+         * Custom events that take the contact out.
+         */
+        events?: string[];
+        /**
+         * A saved filter: a contact who matches it leaves.
+         */
+        filterId?: string | null;
+    };
+    /**
+     * The draft tree. Activate to publish it.
+     */
+    steps?: {
+        /**
+         * Your id for the step, unique in the sequence: letters, digits, `_`, `-`. Keep it when you edit (stats follow it).
+         */
+        id: string;
+        type: "email" | "delay" | "wait_event" | "condition" | "update_contact" | "webhook" | "exit";
+        /**
+         * email: the subject (personalization tags allowed).
+         */
+        subject?: string;
+        /**
+         * email: preview text.
+         */
+        preheader?: string | null;
+        /**
+         * email: body in Markdown (stored as a visual-editor document).
+         */
+        markdown?: string;
+        /**
+         * email: body in HTML (stored as one HTML block).
+         */
+        html?: string;
+        /**
+         * email: a visual-editor document (`{type: "doc", content}`).
+         */
+        doc?: {
+            [k: string]: unknown;
+        };
+        /**
+         * email: a published transactional template instead of a body.
+         */
+        templateId?: string;
+        /**
+         * delay: how many `unit` (5 minutes to 365 days).
+         */
+        amount?: number;
+        unit?: "minutes" | "hours" | "days";
+        /**
+         * delay: wait until the next time of day instead of a fixed duration.
+         */
+        until?: {
+            /**
+             * `HH:MM`
+             */
+            time: string;
+            /**
+             * 0 = Sunday … 6; all days when absent.
+             */
+            weekdays?: number[];
+            /**
+             * `contact`: the custom field `timezone` (IANA), else the newsletter's.
+             */
+            timezone: "contact" | "newsletter";
+        };
+        /**
+         * wait_event: a custom event name, `email.opened` or `email.clicked`.
+         */
+        event?: string;
+        /**
+         * wait_event: 1 to 720.
+         */
+        timeoutHours?: number;
+        onTimeout?: "continue" | "exit";
+        /**
+         * condition: a saved filter (or give `rule`).
+         */
+        filterId?: string;
+        /**
+         * condition: a rule like the audience filters'.
+         */
+        rule?: {
+            [k: string]: unknown;
+        };
+        /**
+         * condition: steps when it matches; both branches join after the condition.
+         */
+        yes?: {
+            [k: string]: unknown;
+        }[];
+        no?: {
+            [k: string]: unknown;
+        }[];
+        /**
+         * update_contact.
+         */
+        action?: "set_field" | "subscribe_topic" | "unsubscribe_topic";
+        /**
+         * update_contact set_field: the custom field key.
+         */
+        key?: string;
+        /**
+         * update_contact set_field: `null` clears it.
+         */
+        value?: (string | number | boolean) | null;
+        /**
+         * update_contact (un)subscribe_topic.
+         */
+        topicId?: string;
+        /**
+         * webhook: one of your webhook endpoints (event `sequence.step`).
+         */
+        webhookId?: string;
+        [k: string]: unknown;
+    }[];
+};
+type SequencesUpdateResponse = {
+    object: string;
+    id: string;
+    name: string;
+    description: unknown;
+    status: string;
+    segment_id: string;
+    topic_id: unknown;
+    trigger: {
+        type: string;
+        lead_magnet_id: unknown;
+    };
+    reentry: {
+        mode: string;
+        days: unknown;
+    };
+    exit: {
+        events: string[];
+        filter_id: unknown;
+    };
+    steps: {
+        id: string;
+        type: string;
+        subject?: string;
+        preheader?: unknown;
+        doc?: {
+            type: string;
+            content: unknown[];
+        };
+        amount?: number;
+        unit?: string;
+    }[];
+    published_version: {
+        id: string;
+        number: number;
+    };
+    has_unpublished_changes: boolean;
+    activated_at: string;
+    archived_at: unknown;
+    created_at: string;
+    updated_at: string;
+};
+interface SequencesRemoveParams {
+    id: string;
+}
+type SequencesRemoveResponse = {
+    object: string;
+    id: string;
+    deleted: boolean;
+};
+interface SequencesActivateParams {
+    id: string;
+}
+type SequencesActivateResponse = {
+    object: string;
+    id: string;
+    name: string;
+    description: unknown;
+    status: string;
+    segment_id: string;
+    topic_id: unknown;
+    trigger: {
+        type: string;
+        lead_magnet_id: unknown;
+    };
+    reentry: {
+        mode: string;
+        days: unknown;
+    };
+    exit: {
+        events: string[];
+        filter_id: unknown;
+    };
+    steps: {
+        id: string;
+        type: string;
+        subject?: string;
+        preheader?: unknown;
+        doc?: {
+            type: string;
+            content: unknown[];
+        };
+        amount?: number;
+        unit?: string;
+    }[];
+    published_version: {
+        id: string;
+        number: number;
+    };
+    has_unpublished_changes: boolean;
+    activated_at: string;
+    archived_at: unknown;
+    created_at: string;
+    updated_at: string;
+};
+interface SequencesPauseParams {
+    id: string;
+}
+type SequencesPauseResponse = {
+    object: string;
+    id: string;
+    name: string;
+    description: unknown;
+    status: string;
+    segment_id: string;
+    topic_id: unknown;
+    trigger: {
+        type: string;
+        lead_magnet_id: unknown;
+    };
+    reentry: {
+        mode: string;
+        days: unknown;
+    };
+    exit: {
+        events: string[];
+        filter_id: unknown;
+    };
+    steps: {
+        id: string;
+        type: string;
+        subject?: string;
+        preheader?: unknown;
+        doc?: {
+            type: string;
+            content: unknown[];
+        };
+        amount?: number;
+        unit?: string;
+    }[];
+    published_version: {
+        id: string;
+        number: number;
+    };
+    has_unpublished_changes: boolean;
+    activated_at: string;
+    archived_at: unknown;
+    created_at: string;
+    updated_at: string;
+};
+interface SequencesArchiveParams {
+    id: string;
+}
+type SequencesArchiveResponse = {
+    object: string;
+    id: string;
+    name: string;
+    description: unknown;
+    status: string;
+    segment_id: string;
+    topic_id: unknown;
+    trigger: {
+        type: string;
+        lead_magnet_id: unknown;
+    };
+    reentry: {
+        mode: string;
+        days: unknown;
+    };
+    exit: {
+        events: string[];
+        filter_id: unknown;
+    };
+    steps: {
+        id: string;
+        type: string;
+        subject?: string;
+        preheader?: unknown;
+        doc?: {
+            type: string;
+            content: unknown[];
+        };
+        amount?: number;
+        unit?: string;
+    }[];
+    published_version: {
+        id: string;
+        number: number;
+    };
+    has_unpublished_changes: boolean;
+    activated_at: string;
+    archived_at: string;
+    created_at: string;
+    updated_at: string;
+};
+type SequencesEnrollmentsParams = {
+    id: string;
+} & {
+    status?: "active" | "completed" | "exited";
+    /**
+     * Newest first, 1–100 (default 100).
+     */
+    limit?: number;
+};
+type SequencesEnrollmentsResponse = {
+    object: string;
+    has_more: boolean;
+    data: {
+        object: string;
+        id: string;
+        sequence_id: string;
+        contact_id: string;
+        email: string;
+        status: string;
+        exit_reason: unknown;
+        current_step_id: string;
+        next_run_at: string;
+        source: string;
+        entered_at: string;
+        completed_at: unknown;
+        exited_at: unknown;
+    }[];
+};
+type SequencesEnrollParams = {
+    id: string;
+} & {
+    /**
+     * Give `email` or `contact_id` (a contact of the sequence's newsletter).
+     */
+    email?: string;
+    contactId?: string;
+};
+type SequencesEnrollResponse = {
+    object: string;
+    id: string;
+    sequence_id: string;
+    contact_id: string;
+    status: string;
+};
+interface SequencesUnenrollParams {
+    id: string;
+    enrollmentId: string;
+}
+type SequencesUnenrollResponse = {
+    object: string;
+    id: string;
+    sequence_id: string;
+    status: string;
+};
+interface SequencesStatsParams {
+    id: string;
+}
+type SequencesStatsResponse = {
+    object: string;
+    sequence_id: string;
+    entered: number;
+    active: number;
+    completed: number;
+    exited: number;
+    steps: {
+        step_id: string;
+        passed: number;
+        waiting: number;
+        sent: number;
+        opened: number;
+        clicked: number;
+        bounced: number;
+        unsubscribed: number;
+    }[];
+};
+interface WebhooksCreateParams {
+    /**
+     * Public `https://` URL that receives the events.
+     */
+    endpoint: string;
+    /**
+     * Event types to receive.
+     */
+    events: ("email.sent" | "email.delivered" | "email.delivery_delayed" | "email.bounced" | "email.complained" | "email.opened" | "email.clicked" | "email.failed" | "email.scheduled" | "contact.created" | "contact.updated" | "contact.deleted" | "domain.created" | "domain.updated" | "domain.deleted" | "sequence.entered" | "sequence.completed" | "sequence.exited" | "inbound.received")[];
+    description?: string | null;
+    /**
+     * Also send the email events of your newsletter issues (one per recipient). Default `false`: transactional emails only.
+     */
+    includeNewsletters?: boolean;
+    /**
+     * Only newsletter events of these newsletters (segments). Empty = all.
+     */
+    segmentIds?: string[];
+    /**
+     * Only email events sent from these domains (domain of the From address). Empty = all.
+     */
+    domains?: string[];
+}
+type WebhooksCreateResponse = {
+    object: string;
+    id: string;
+    signing_secret: string;
+};
+interface WebhooksListParams {
+    /**
+     * 1–100, default 20.
+     */
+    limit?: number;
+    /**
+     * Id of the last item of the previous page (older items).
+     */
+    after?: string;
+    /**
+     * Id of the first item of the previous page (newer items).
+     */
+    before?: string;
+}
+type WebhooksListResponse = {
+    object: string;
+    has_more: boolean;
+    data: {
+        object: string;
+        id: string;
+        endpoint: string;
+        description: string;
+        events: string[];
+        include_newsletters: boolean;
+        segment_ids: unknown[];
+        domains: unknown[];
+        status: string;
+        disabled_reason: unknown;
+        consecutive_failures: number;
+        last_success_at: string;
+        last_failure_at: unknown;
+        created_at: string;
+    }[];
+};
+interface WebhooksGetParams {
+    id: string;
+}
+type WebhooksGetResponse = {
+    object: string;
+    id: string;
+    endpoint: string;
+    description: string;
+    events: string[];
+    include_newsletters: boolean;
+    segment_ids: unknown[];
+    domains: unknown[];
+    status: string;
+    disabled_reason: unknown;
+    consecutive_failures: number;
+    last_success_at: string;
+    last_failure_at: unknown;
+    created_at: string;
+};
+type WebhooksUpdateParams = {
+    id: string;
+} & {
+    /**
+     * Public `https://` URL that receives the events.
+     */
+    endpoint?: string;
+    /**
+     * Event types to receive.
+     */
+    events?: ("email.sent" | "email.delivered" | "email.delivery_delayed" | "email.bounced" | "email.complained" | "email.opened" | "email.clicked" | "email.failed" | "email.scheduled" | "contact.created" | "contact.updated" | "contact.deleted" | "domain.created" | "domain.updated" | "domain.deleted" | "sequence.entered" | "sequence.completed" | "sequence.exited" | "inbound.received")[];
+    status?: "enabled" | "disabled";
+    description?: string | null;
+    /**
+     * Also send the email events of your newsletter issues (one per recipient). Default `false`: transactional emails only.
+     */
+    includeNewsletters?: boolean;
+    /**
+     * Only newsletter events of these newsletters (segments). Empty = all.
+     */
+    segmentIds?: string[];
+    /**
+     * Only email events sent from these domains (domain of the From address). Empty = all.
+     */
+    domains?: string[];
+};
+type WebhooksUpdateResponse = {
+    object: string;
+    id: string;
+};
+interface WebhooksRemoveParams {
+    id: string;
+}
+type WebhooksRemoveResponse = {
+    object: string;
+    id: string;
+    deleted: boolean;
+};
+interface WebhooksRotateSigningSecretParams {
+    id: string;
+}
+type WebhooksRotateSigningSecretResponse = {
+    object: string;
+    id: string;
+    signing_secret: string;
+    previous_secret_expires_at: string;
+};
+type WebhooksTestParams = {
+    id: string;
+} & {
+    /**
+     * Event type of the sample payload.
+     */
+    type?: "email.sent" | "email.delivered" | "email.delivery_delayed" | "email.bounced" | "email.complained" | "email.opened" | "email.clicked" | "email.failed" | "email.scheduled" | "contact.created" | "contact.updated" | "contact.deleted" | "domain.created" | "domain.updated" | "domain.deleted" | "sequence.entered" | "sequence.completed" | "sequence.exited" | "inbound.received";
+};
+type WebhooksTestResponse = {
+    object: string;
+    id: string;
+    msg_id: string;
+    webhook_id: string;
+    event_type: string;
+    status: string;
+    attempts: number;
+    next_attempt_at: unknown;
+    last_status_code: number;
+    last_response: string;
+    last_error: unknown;
+    last_duration_ms: number;
+    payload: {
+        type: string;
+        created_at: string;
+        data: {
+            email_id: string;
+        };
+    };
+    delivered_at: string;
+    created_at: string;
+};
+type WebhooksDeliveriesParams = {
+    id: string;
+} & {
+    /**
+     * 1–100, default 20.
+     */
+    limit?: number;
+    /**
+     * Id of the last item of the previous page (older items).
+     */
+    after?: string;
+    /**
+     * Id of the first item of the previous page (newer items).
+     */
+    before?: string;
+    status?: "pending" | "processing" | "delivered" | "failed";
+};
+type WebhooksDeliveriesResponse = {
+    object: string;
+    has_more: boolean;
+    data: {
+        object: string;
+        id: string;
+        msg_id: string;
+        webhook_id: string;
+        event_type: string;
+        status: string;
+        attempts: number;
+        next_attempt_at: unknown;
+        last_status_code: number;
+        last_response: string;
+        last_error: unknown;
+        last_duration_ms: number;
+        payload: {
+            type: string;
+            created_at: string;
+            data: {
+                email_id: string;
+            };
+        };
+        delivered_at: string;
+        created_at: string;
+    }[];
+};
+interface WebhooksRetryDeliveryParams {
+    id: string;
+    deliveryId: string;
+}
+type WebhooksRetryDeliveryResponse = {
+    object: string;
+    id: string;
+    msg_id: string;
+    webhook_id: string;
+    event_type: string;
+    status: string;
+    attempts: number;
+    next_attempt_at: unknown;
+    last_status_code: number;
+    last_response: string;
+    last_error: unknown;
+    last_duration_ms: number;
+    payload: {
+        type: string;
+        created_at: string;
+        data: {
+            email_id: string;
+        };
+    };
+    delivered_at: string;
+    created_at: string;
+};
+type InboxesListParams = Record<string, never>;
+type InboxesListResponse = {
+    object: string;
+    has_more: boolean;
+    data: {
+        object: string;
+        id: string;
+        address: string;
+        name: string;
+        display_name: string;
+        description: string;
+        reply_from: unknown;
+        status: string;
+        custom_domain: boolean;
+        domain_id: unknown;
+        dropped_count: number;
+        last_dropped_at: unknown;
+        created_at: string;
+        updated_at: string;
+    }[];
+};
+interface InboxesCreateParams {
+    /**
+     * Local part: `support` gives `support-<workspace>@in.smartletter.ai` (or `support@<your receiving domain>` with `domain_id`).
+     */
+    name: string;
+    /**
+     * The agent's name, shown as the sender of its replies.
+     */
+    displayName?: string | null;
+    /**
+     * What this agent does — readable by an LLM.
+     */
+    description?: string | null;
+    /**
+     * A verified receiving domain of the workspace (dashboard: Settings > Inboxes).
+     */
+    domainId?: string | null;
+    /**
+     * Send replies from this address (a verified sending domain) instead of the inbox address. Reply-To stays the inbox.
+     */
+    replyFrom?: string | null;
+}
+type InboxesCreateResponse = {
+    object: string;
+    id: string;
+    address: string;
+    name: string;
+    display_name: string;
+    description: string;
+    reply_from: unknown;
+    status: string;
+    custom_domain: boolean;
+    domain_id: unknown;
+    dropped_count: number;
+    last_dropped_at: unknown;
+    created_at: string;
+    updated_at: string;
+};
+interface InboxesGetParams {
+    id: string;
+}
+type InboxesGetResponse = {
+    object: string;
+    id: string;
+    address: string;
+    name: string;
+    display_name: string;
+    description: string;
+    reply_from: unknown;
+    status: string;
+    custom_domain: boolean;
+    domain_id: unknown;
+    dropped_count: number;
+    last_dropped_at: unknown;
+    created_at: string;
+    updated_at: string;
+};
+type InboxesUpdateParams = {
+    id: string;
+} & {
+    /**
+     * The agent's name, shown as the sender of its replies.
+     */
+    displayName?: string | null;
+    /**
+     * What this agent does — readable by an LLM.
+     */
+    description?: string | null;
+    /**
+     * Send replies from this address (a verified sending domain) instead of the inbox address. Reply-To stays the inbox.
+     */
+    replyFrom?: string | null;
+    /**
+     * A disabled inbox drops incoming mail and cannot reply.
+     */
+    status?: "active" | "disabled";
+};
+type InboxesUpdateResponse = {
+    object: string;
+    id: string;
+    address: string;
+    name: string;
+    display_name: string;
+    description: string;
+    reply_from: unknown;
+    status: string;
+    custom_domain: boolean;
+    domain_id: unknown;
+    dropped_count: number;
+    last_dropped_at: unknown;
+    created_at: string;
+    updated_at: string;
+};
+interface InboxesRemoveParams {
+    id: string;
+}
+type InboxesRemoveResponse = {
+    object: string;
+    id: string;
+    deleted: boolean;
+};
+interface ThreadsListParams {
+    inboxId?: string;
+    /**
+     * Default: every status but `archived`.
+     */
+    status?: "open" | "pending" | "done" | "archived" | "all";
+    label?: string;
+    /**
+     * Default `exclude`.
+     */
+    spam?: "exclude" | "only" | "include";
+    assigneeAgent?: string;
+    unread?: "true" | "false";
+    /**
+     * 1–100, default 20.
+     */
+    limit?: number;
+    /**
+     * Id of the last thread of the previous page.
+     */
+    after?: string;
+}
+type ThreadsListResponse = {
+    object: string;
+    has_more: boolean;
+    data: {
+        object: string;
+        id: string;
+        inbox_id: string;
+        subject: string;
+        status: string;
+        spam: boolean;
+        labels: unknown[];
+        assignee_user_id: unknown;
+        assignee_agent: unknown;
+        message_count: number;
+        unread: boolean;
+        participants: string[];
+        last_message_at: string;
+        last_inbound_at: string;
+        created_at: string;
+        updated_at: string;
+        last_message: {
+            id: string;
+            direction: string;
+            from: string;
+            snippet: string;
+            received_at: string;
+        };
+    }[];
+};
+interface ThreadsGetParams {
+    id: string;
+}
+type ThreadsGetResponse = {
+    object: string;
+    id: string;
+    inbox_id: string;
+    subject: string;
+    status: string;
+    spam: boolean;
+    labels: unknown[];
+    assignee_user_id: unknown;
+    assignee_agent: unknown;
+    message_count: number;
+    unread: boolean;
+    participants: string[];
+    last_message_at: string;
+    last_inbound_at: string;
+    created_at: string;
+    updated_at: string;
+    messages: {
+        object: string;
+        id: string;
+        thread_id: string;
+        inbox_id: string;
+        direction: string;
+        status: string;
+        from: string;
+        from_address: string;
+        from_name: string;
+        to: string[];
+        cc: unknown[];
+        reply_to: unknown[];
+        subject: string;
+        text: string;
+        html: string;
+        snippet: string;
+        remote_images: number;
+        body_truncated: boolean;
+        message_id: string;
+        in_reply_to: unknown;
+        references: unknown[];
+        spam: {
+            score: number;
+            verdict: string;
+            virus: string;
+            spf: string;
+            dkim: string;
+            dmarc: string;
+            reasons: unknown[];
+        };
+        auto_submitted: boolean;
+        automation_reason: unknown;
+        attachments: {
+            id: string;
+            filename: string;
+            content_type: string;
+            size: number;
+            inline: boolean;
+            content_id: unknown;
+            available: boolean;
+            expires_at: string;
+        }[];
+        received_at: string;
+        created_at: string;
+    }[];
+};
+type ThreadsUpdateParams = {
+    id: string;
+} & {
+    status?: "open" | "pending" | "done" | "archived";
+    /**
+     * Replaces every label.
+     */
+    labels?: string[];
+    addLabels?: string[];
+    removeLabels?: string[];
+    /**
+     * An agent name, or `null`.
+     */
+    assigneeAgent?: string | null;
+    /**
+     * A member of the workspace, or `null`.
+     */
+    assigneeUserId?: string | null;
+    /**
+     * `true` moves every inbound message to spam; `false` back to the inbox.
+     */
+    spam?: boolean;
+    unread?: boolean;
+};
+type ThreadsUpdateResponse = {
+    object: string;
+    id: string;
+    inbox_id: string;
+    subject: string;
+    status: string;
+    spam: boolean;
+    labels: string[];
+    assignee_user_id: unknown;
+    assignee_agent: string;
+    message_count: number;
+    unread: boolean;
+    participants: string[];
+    last_message_at: string;
+    last_inbound_at: string;
+    created_at: string;
+    updated_at: string;
+};
+type ThreadsReplyParams = {
+    id: string;
+} & {
+    /**
+     * Plain-text answer. Give `text`, `html` or both.
+     */
+    text?: string;
+    html?: string;
+    /**
+     * The message answered. Default: the latest inbound message.
+     */
+    messageId?: string;
+    /**
+     * Also answer the original To / Cc (never the inbox itself).
+     */
+    replyAll?: boolean;
+    cc?: string[];
+    /**
+     * Quote the answered message under the answer. Default `true`.
+     */
+    quote?: boolean;
+    /**
+     * Save a draft instead of sending.
+     */
+    draft?: boolean;
+    /**
+     * Thread status after sending. Default `pending`.
+     */
+    status?: "open" | "pending" | "done" | "archived";
+};
+type ThreadsReplyResponse = {
+    object: string;
+    id: string;
+    thread_id: string;
+    inbox_id: string;
+    direction: string;
+    status: string;
+    from: string;
+    from_address: string;
+    from_name: string;
+    to: string[];
+    cc: unknown[];
+    reply_to: unknown[];
+    subject: string;
+    text: string;
+    html: string;
+    snippet: string;
+    remote_images: number;
+    body_truncated: boolean;
+    message_id: string;
+    in_reply_to: unknown;
+    references: unknown[];
+    spam: {
+        score: number;
+        verdict: string;
+        virus: string;
+        spf: string;
+        dkim: string;
+        dmarc: string;
+        reasons: unknown[];
+    };
+    auto_submitted: boolean;
+    automation_reason: unknown;
+    attachments: {
+        id: string;
+        filename: string;
+        content_type: string;
+        size: number;
+        inline: boolean;
+        content_id: unknown;
+        available: boolean;
+        expires_at: string;
+    }[];
+    received_at: string;
+    created_at: string;
+    email_id: string;
+    delivery: string;
+};
+interface MessagesGetParams {
+    id: string;
+}
+type MessagesGetResponse = {
+    object: string;
+    id: string;
+    thread_id: string;
+    inbox_id: string;
+    direction: string;
+    status: string;
+    from: string;
+    from_address: string;
+    from_name: string;
+    to: string[];
+    cc: unknown[];
+    reply_to: unknown[];
+    subject: string;
+    text: string;
+    html: string;
+    snippet: string;
+    remote_images: number;
+    body_truncated: boolean;
+    message_id: string;
+    in_reply_to: unknown;
+    references: unknown[];
+    spam: {
+        score: number;
+        verdict: string;
+        virus: string;
+        spf: string;
+        dkim: string;
+        dmarc: string;
+        reasons: unknown[];
+    };
+    auto_submitted: boolean;
+    automation_reason: unknown;
+    attachments: {
+        id: string;
+        filename: string;
+        content_type: string;
+        size: number;
+        inline: boolean;
+        content_id: unknown;
+        available: boolean;
+        expires_at: string;
+    }[];
+    received_at: string;
+    created_at: string;
+};
+type MessagesUpdateParams = {
+    id: string;
+} & {
+    text?: string | null;
+    html?: string | null;
+    cc?: string[];
+};
+type MessagesUpdateResponse = {
+    object: string;
+    id: string;
+    thread_id: string;
+    inbox_id: string;
+    direction: string;
+    status: string;
+    from: string;
+    from_address: string;
+    from_name: string;
+    to: string[];
+    cc: unknown[];
+    reply_to: unknown[];
+    subject: string;
+    text: string;
+    html: string;
+    snippet: string;
+    remote_images: number;
+    body_truncated: boolean;
+    message_id: string;
+    in_reply_to: unknown;
+    references: unknown[];
+    spam: {
+        score: number;
+        verdict: string;
+        virus: string;
+        spf: string;
+        dkim: string;
+        dmarc: string;
+        reasons: unknown[];
+    };
+    auto_submitted: boolean;
+    automation_reason: unknown;
+    attachments: {
+        id: string;
+        filename: string;
+        content_type: string;
+        size: number;
+        inline: boolean;
+        content_id: unknown;
+        available: boolean;
+        expires_at: string;
+    }[];
+    received_at: string;
+    created_at: string;
+};
+type MessagesSendParams = {
+    id: string;
+} & {
+    status?: "open" | "pending" | "done" | "archived";
+};
+type MessagesSendResponse = {
+    object: string;
+    id: string;
+    thread_id: string;
+    inbox_id: string;
+    direction: string;
+    status: string;
+    from: string;
+    from_address: string;
+    from_name: string;
+    to: string[];
+    cc: unknown[];
+    reply_to: unknown[];
+    subject: string;
+    text: string;
+    html: string;
+    snippet: string;
+    remote_images: number;
+    body_truncated: boolean;
+    message_id: string;
+    in_reply_to: unknown;
+    references: unknown[];
+    spam: {
+        score: number;
+        verdict: string;
+        virus: string;
+        spf: string;
+        dkim: string;
+        dmarc: string;
+        reasons: unknown[];
+    };
+    auto_submitted: boolean;
+    automation_reason: unknown;
+    attachments: {
+        id: string;
+        filename: string;
+        content_type: string;
+        size: number;
+        inline: boolean;
+        content_id: unknown;
+        available: boolean;
+        expires_at: string;
+    }[];
+    received_at: string;
+    created_at: string;
+};
+interface MessagesRemoveParams {
+    id: string;
+}
+type MessagesRemoveResponse = {
+    object: string;
+    id: string;
+    deleted: boolean;
+};
+interface MessagesAttachmentParams {
+    id: string;
+    attachmentId: string;
+}
+type MessagesAttachmentResponse = {
+    object: string;
+    id: string;
+    filename: string;
+    content_type: string;
+    size: number;
+    url: string;
+    expires_at: string;
+};
+
+interface SmartletterResources {
+    emails: {
+        send(params: EmailsSendParams, options?: RequestOptions): Promise<Response<EmailsSendResponse>>;
+        list(params?: EmailsListParams, options?: RequestOptions): Promise<Response<EmailsListResponse>>;
+        get(id: string, options?: RequestOptions): Promise<Response<EmailsGetResponse>>;
+        update(params: EmailsUpdateParams, options?: RequestOptions): Promise<Response<EmailsUpdateResponse>>;
+        cancel(id: string, options?: RequestOptions): Promise<Response<EmailsCancelResponse>>;
+    };
+    batch: {
+        send(items: BatchSendParams, options?: RequestOptions): Promise<Response<BatchSendResponse>>;
+    };
+    templates: {
+        create(params: TemplatesCreateParams, options?: RequestOptions): Promise<Response<TemplatesCreateResponse>>;
+        list(params?: TemplatesListParams, options?: RequestOptions): Promise<Response<TemplatesListResponse>>;
+        get(id: string, options?: RequestOptions): Promise<Response<TemplatesGetResponse>>;
+        update(params: TemplatesUpdateParams, options?: RequestOptions): Promise<Response<TemplatesUpdateResponse>>;
+        remove(id: string, options?: RequestOptions): Promise<Response<TemplatesRemoveResponse>>;
+        publish(params: TemplatesPublishParams, options?: RequestOptions): Promise<Response<TemplatesPublishResponse>>;
+        duplicate(id: string, options?: RequestOptions): Promise<Response<TemplatesDuplicateResponse>>;
+        versions(params: TemplatesVersionsParams, options?: RequestOptions): Promise<Response<TemplatesVersionsResponse>>;
+    };
+    newsletters: {
+        list(params?: NewslettersListParams, options?: RequestOptions): Promise<Response<NewslettersListResponse>>;
+        create(params: NewslettersCreateParams, options?: RequestOptions): Promise<Response<NewslettersCreateResponse>>;
+        get(id: string, options?: RequestOptions): Promise<Response<NewslettersGetResponse>>;
+        update(params: NewslettersUpdateParams, options?: RequestOptions): Promise<Response<NewslettersUpdateResponse>>;
+        remove(id: string, options?: RequestOptions): Promise<Response<NewslettersRemoveResponse>>;
+        duplicate(id: string, options?: RequestOptions): Promise<Response<NewslettersDuplicateResponse>>;
+        review(id: string, options?: RequestOptions): Promise<Response<NewslettersReviewResponse>>;
+        test(id: string, options?: RequestOptions): Promise<Response<NewslettersTestResponse>>;
+        send(params: NewslettersSendParams, options?: RequestOptions): Promise<Response<NewslettersSendResponse>>;
+        schedule(params: NewslettersScheduleParams, options?: RequestOptions): Promise<Response<NewslettersScheduleResponse>>;
+        unschedule(id: string, options?: RequestOptions): Promise<Response<NewslettersUnscheduleResponse>>;
+        pause(id: string, options?: RequestOptions): Promise<Response<NewslettersPauseResponse>>;
+        resume(id: string, options?: RequestOptions): Promise<Response<NewslettersResumeResponse>>;
+        sendMore(params: NewslettersSendMoreParams, options?: RequestOptions): Promise<Response<NewslettersSendMoreResponse>>;
+        report(id: string, options?: RequestOptions): Promise<Response<NewslettersReportResponse>>;
+        abWinner(params: NewslettersAbWinnerParams, options?: RequestOptions): Promise<Response<NewslettersAbWinnerResponse>>;
+        archive: {
+            update(params: NewslettersArchiveUpdateParams, options?: RequestOptions): Promise<Response<NewslettersArchiveUpdateResponse>>;
+        };
+    };
+    contacts: {
+        list(params?: ContactsListParams, options?: RequestOptions): Promise<Response<ContactsListResponse>>;
+        create(params: ContactsCreateParams, options?: RequestOptions): Promise<Response<ContactsCreateResponse>>;
+        import(params: ContactsImportParams, options?: RequestOptions): Promise<Response<ContactsImportResponse>>;
+        export(params?: ContactsExportParams, options?: RequestOptions): Promise<Response<ContactsExportResponse>>;
+        get(id: string, options?: RequestOptions): Promise<Response<ContactsGetResponse>>;
+        unsubscribe(id: string, options?: RequestOptions): Promise<Response<ContactsUnsubscribeResponse>>;
+        reactivate(id: string, options?: RequestOptions): Promise<Response<ContactsReactivateResponse>>;
+        remove(id: string, options?: RequestOptions): Promise<Response<ContactsRemoveResponse>>;
+        update(params: ContactsUpdateParams, options?: RequestOptions): Promise<Response<ContactsUpdateResponse>>;
+    };
+    contactFields: {
+        list(params?: ContactFieldsListParams, options?: RequestOptions): Promise<Response<ContactFieldsListResponse>>;
+        create(params: ContactFieldsCreateParams, options?: RequestOptions): Promise<Response<ContactFieldsCreateResponse>>;
+        update(params: ContactFieldsUpdateParams, options?: RequestOptions): Promise<Response<ContactFieldsUpdateResponse>>;
+        remove(id: string, options?: RequestOptions): Promise<Response<ContactFieldsRemoveResponse>>;
+    };
+    events: {
+        send(params: EventsSendParams, options?: RequestOptions): Promise<Response<EventsSendResponse>>;
+    };
+    audienceFilters: {
+        list(params?: AudienceFiltersListParams, options?: RequestOptions): Promise<Response<AudienceFiltersListResponse>>;
+        create(params: AudienceFiltersCreateParams, options?: RequestOptions): Promise<Response<AudienceFiltersCreateResponse>>;
+        get(id: string, options?: RequestOptions): Promise<Response<AudienceFiltersGetResponse>>;
+        update(params: AudienceFiltersUpdateParams, options?: RequestOptions): Promise<Response<AudienceFiltersUpdateResponse>>;
+        remove(id: string, options?: RequestOptions): Promise<Response<AudienceFiltersRemoveResponse>>;
+        count(params?: AudienceFiltersCountParams, options?: RequestOptions): Promise<Response<AudienceFiltersCountResponse>>;
+    };
+    signups: {
+        create(params: SignupsCreateParams, options?: RequestOptions): Promise<Response<SignupsCreateResponse>>;
+    };
+    segments: {
+        list(params?: SegmentsListParams, options?: RequestOptions): Promise<Response<SegmentsListResponse>>;
+        create(params: SegmentsCreateParams, options?: RequestOptions): Promise<Response<SegmentsCreateResponse>>;
+        archive: {
+            get(id: string, options?: RequestOptions): Promise<Response<SegmentsArchiveGetResponse>>;
+            update(params: SegmentsArchiveUpdateParams, options?: RequestOptions): Promise<Response<SegmentsArchiveUpdateResponse>>;
+        };
+        domain: {
+            get(id: string, options?: RequestOptions): Promise<Response<SegmentsDomainGetResponse>>;
+            set(params: SegmentsDomainSetParams, options?: RequestOptions): Promise<Response<SegmentsDomainSetResponse>>;
+            remove(id: string, options?: RequestOptions): Promise<Response<SegmentsDomainRemoveResponse>>;
+        };
+    };
+    topics: {
+        list(params: TopicsListParams, options?: RequestOptions): Promise<Response<TopicsListResponse>>;
+    };
+    suppressions: {
+        list(params?: SuppressionsListParams, options?: RequestOptions): Promise<Response<SuppressionsListResponse>>;
+        create(params: SuppressionsCreateParams, options?: RequestOptions): Promise<Response<SuppressionsCreateResponse>>;
+        remove(id: string, options?: RequestOptions): Promise<Response<SuppressionsRemoveResponse>>;
+    };
+    images: {
+        list(params?: ImagesListParams, options?: RequestOptions): Promise<Response<ImagesListResponse>>;
+        create(file: ImagesCreateParams, options?: RequestOptions): Promise<Response<ImagesCreateResponse>>;
+    };
+    stats: {
+        overview(params?: StatsOverviewParams, options?: RequestOptions): Promise<Response<StatsOverviewResponse>>;
+    };
+    domains: {
+        create(params: DomainsCreateParams, options?: RequestOptions): Promise<Response<DomainsCreateResponse>>;
+        list(params?: DomainsListParams, options?: RequestOptions): Promise<Response<DomainsListResponse>>;
+        get(id: string, options?: RequestOptions): Promise<Response<DomainsGetResponse>>;
+        verify(id: string, options?: RequestOptions): Promise<Response<DomainsVerifyResponse>>;
+    };
+    apiKeys: {
+        create(params: ApiKeysCreateParams, options?: RequestOptions): Promise<Response<ApiKeysCreateResponse>>;
+        list(params?: ApiKeysListParams, options?: RequestOptions): Promise<Response<ApiKeysListResponse>>;
+        update(params: ApiKeysUpdateParams, options?: RequestOptions): Promise<Response<ApiKeysUpdateResponse>>;
+        remove(id: string, options?: RequestOptions): Promise<Response<ApiKeysRemoveResponse>>;
+    };
+    logs: {
+        list(params?: LogsListParams, options?: RequestOptions): Promise<Response<LogsListResponse>>;
+        get(id: string, options?: RequestOptions): Promise<Response<LogsGetResponse>>;
+    };
+    usage: {
+        get(params?: UsageGetParams, options?: RequestOptions): Promise<Response<UsageGetResponse>>;
+    };
+    sequences: {
+        list(params?: SequencesListParams, options?: RequestOptions): Promise<Response<SequencesListResponse>>;
+        create(params: SequencesCreateParams, options?: RequestOptions): Promise<Response<SequencesCreateResponse>>;
+        get(id: string, options?: RequestOptions): Promise<Response<SequencesGetResponse>>;
+        update(params: SequencesUpdateParams, options?: RequestOptions): Promise<Response<SequencesUpdateResponse>>;
+        remove(id: string, options?: RequestOptions): Promise<Response<SequencesRemoveResponse>>;
+        activate(id: string, options?: RequestOptions): Promise<Response<SequencesActivateResponse>>;
+        pause(id: string, options?: RequestOptions): Promise<Response<SequencesPauseResponse>>;
+        archive(id: string, options?: RequestOptions): Promise<Response<SequencesArchiveResponse>>;
+        enrollments(params: SequencesEnrollmentsParams, options?: RequestOptions): Promise<Response<SequencesEnrollmentsResponse>>;
+        enroll(params: SequencesEnrollParams, options?: RequestOptions): Promise<Response<SequencesEnrollResponse>>;
+        unenroll(params: SequencesUnenrollParams, options?: RequestOptions): Promise<Response<SequencesUnenrollResponse>>;
+        stats(id: string, options?: RequestOptions): Promise<Response<SequencesStatsResponse>>;
+    };
+    webhooks: {
+        create(params: WebhooksCreateParams, options?: RequestOptions): Promise<Response<WebhooksCreateResponse>>;
+        list(params?: WebhooksListParams, options?: RequestOptions): Promise<Response<WebhooksListResponse>>;
+        get(id: string, options?: RequestOptions): Promise<Response<WebhooksGetResponse>>;
+        update(params: WebhooksUpdateParams, options?: RequestOptions): Promise<Response<WebhooksUpdateResponse>>;
+        remove(id: string, options?: RequestOptions): Promise<Response<WebhooksRemoveResponse>>;
+        rotateSigningSecret(id: string, options?: RequestOptions): Promise<Response<WebhooksRotateSigningSecretResponse>>;
+        test(params: WebhooksTestParams, options?: RequestOptions): Promise<Response<WebhooksTestResponse>>;
+        deliveries(params: WebhooksDeliveriesParams, options?: RequestOptions): Promise<Response<WebhooksDeliveriesResponse>>;
+        retryDelivery(params: WebhooksRetryDeliveryParams, options?: RequestOptions): Promise<Response<WebhooksRetryDeliveryResponse>>;
+    };
+    inboxes: {
+        list(params?: InboxesListParams, options?: RequestOptions): Promise<Response<InboxesListResponse>>;
+        create(params: InboxesCreateParams, options?: RequestOptions): Promise<Response<InboxesCreateResponse>>;
+        get(id: string, options?: RequestOptions): Promise<Response<InboxesGetResponse>>;
+        update(params: InboxesUpdateParams, options?: RequestOptions): Promise<Response<InboxesUpdateResponse>>;
+        remove(id: string, options?: RequestOptions): Promise<Response<InboxesRemoveResponse>>;
+    };
+    threads: {
+        list(params?: ThreadsListParams, options?: RequestOptions): Promise<Response<ThreadsListResponse>>;
+        get(id: string, options?: RequestOptions): Promise<Response<ThreadsGetResponse>>;
+        update(params: ThreadsUpdateParams, options?: RequestOptions): Promise<Response<ThreadsUpdateResponse>>;
+        reply(params: ThreadsReplyParams, options?: RequestOptions): Promise<Response<ThreadsReplyResponse>>;
+    };
+    messages: {
+        get(id: string, options?: RequestOptions): Promise<Response<MessagesGetResponse>>;
+        update(params: MessagesUpdateParams, options?: RequestOptions): Promise<Response<MessagesUpdateResponse>>;
+        send(params: MessagesSendParams, options?: RequestOptions): Promise<Response<MessagesSendResponse>>;
+        remove(id: string, options?: RequestOptions): Promise<Response<MessagesRemoveResponse>>;
+        attachment(params: MessagesAttachmentParams, options?: RequestOptions): Promise<Response<MessagesAttachmentResponse>>;
+    };
+}
+
+type SendAttachment = Omit<NonNullable<EmailsSendParams["attachments"]>[number], "content"> & {
+    content?: string | Uint8Array;
+};
+type ContentKeys = "from" | "subject" | "template" | "html" | "text";
+type EmailTemplate = NonNullable<EmailsSendParams["template"]>;
+/**
+ * Comme `CreateEmailOptions` de Resend 6.32 : soit un contenu (`html`, `text` ou `react`) avec `from` et
+ * `subject` obligatoires, soit un `template` publié qui fournit `from` et `subject` s'ils manquent.
+ */
+type WithContent<Base> = (Base & {
+    from: string;
+    subject: string;
+    html?: string;
+    text?: string;
+    react?: unknown;
+    template?: never;
+}) | (Base & {
+    from?: string;
+    subject?: string;
+    template: EmailTemplate;
+    html?: never;
+    text?: never;
+    react?: never;
+});
+/** Même charge utile que `emails.send` de Resend : `react`, contenu binaire et envoi par template. */
+type SendEmailParams = WithContent<Omit<EmailsSendParams, ContentKeys | "attachments"> & {
+    attachments?: SendAttachment[];
+}>;
+/** Un email de `batch.send` : comme `emails.send`, sans pièces jointes. */
+type BatchEmailParams = WithContent<Omit<BatchSendParams[number], ContentKeys>>;
+type BatchSendOptions = RequestOptions & {
+    batchValidation?: "strict" | "permissive";
+};
+
+declare class WebhookVerificationError extends Error {
+    constructor(message: string);
+}
+type WebhookEvent = {
+    type: string;
+    created_at: string;
+    data: Record<string, unknown>;
+};
+interface VerifyWebhookInput {
+    payload: string;
+    headers: {
+        id: string;
+        timestamp: string;
+        signature: string;
+    };
+    webhookSecret: string;
+}
+
+type CreateEmailOptions = SendEmailParams;
+type CreateEmailRequestOptions = RequestOptions;
+type CreateEmailResponseSuccess = EmailsSendResponse;
+type CreateEmailResponse = Response<CreateEmailResponseSuccess>;
+type GetEmailResponseSuccess = EmailsGetResponse;
+type GetEmailResponse = Response<GetEmailResponseSuccess>;
+type ListEmailsOptions = EmailsListParams;
+type ListEmail = EmailsListResponse["data"][number];
+type ListEmailsResponseSuccess = EmailsListResponse;
+type ListEmailsResponse = Response<ListEmailsResponseSuccess>;
+type UpdateEmailOptions = EmailsUpdateParams;
+type UpdateEmailResponseSuccess = EmailsUpdateResponse;
+type UpdateEmailResponse = Response<UpdateEmailResponseSuccess>;
+type CancelEmailResponseSuccess = EmailsCancelResponse;
+type CancelEmailResponse = Response<CancelEmailResponseSuccess>;
+type CreateBatchEmailOptions = BatchEmailParams;
+type CreateBatchOptions = BatchEmailParams[];
+type CreateBatchRequestOptions = BatchSendOptions;
+type CreateBatchSuccessResponse<_Options extends CreateBatchRequestOptions = CreateBatchRequestOptions> = BatchSendResponse;
+type CreateBatchResponse<Options extends CreateBatchRequestOptions = CreateBatchRequestOptions> = Response<CreateBatchSuccessResponse<Options>>;
+type CreateDomainOptions = DomainsCreateParams;
+type CreateDomainRequestOptions = RequestOptions;
+type CreateDomainResponseSuccess = DomainsCreateResponse;
+type CreateDomainResponse = Response<CreateDomainResponseSuccess>;
+type GetDomainResponseSuccess = DomainsGetResponse;
+type GetDomainResponse = Response<GetDomainResponseSuccess>;
+type ListDomainsOptions = DomainsListParams;
+type ListDomainsResponseSuccess = DomainsListResponse;
+type ListDomainsResponse = Response<ListDomainsResponseSuccess>;
+type VerifyDomainsResponseSuccess = DomainsVerifyResponse;
+type VerifyDomainsResponse = Response<VerifyDomainsResponseSuccess>;
+type CreateApiKeyOptions = ApiKeysCreateParams;
+type CreateApiKeyRequestOptions = RequestOptions;
+type CreateApiKeyResponseSuccess = ApiKeysCreateResponse;
+type CreateApiKeyResponse = Response<CreateApiKeyResponseSuccess>;
+type ListApiKeysOptions = ApiKeysListParams;
+type ListApiKeysResponseSuccess = ApiKeysListResponse;
+type ListApiKeysResponse = Response<ListApiKeysResponseSuccess>;
+type UpdateApiKeyOptions = Omit<ApiKeysUpdateParams, "id">;
+type UpdateApiKeyResponseSuccess = ApiKeysUpdateResponse;
+type UpdateApiKeyResponse = Response<UpdateApiKeyResponseSuccess>;
+type RemoveApiKeyResponseSuccess = ApiKeysRemoveResponse;
+type RemoveApiKeyResponse = Response<RemoveApiKeyResponseSuccess>;
+type CreateTemplateOptions = CreateTemplateParams;
+type CreateTemplateRequestOptions = RequestOptions;
+type CreateTemplateResponseSuccess = TemplatesCreateResponse;
+type CreateTemplateResponse = Response<CreateTemplateResponseSuccess>;
+type DuplicateTemplateResponseSuccess = TemplatesDuplicateResponse;
+type DuplicateTemplateResponse = Response<DuplicateTemplateResponseSuccess>;
+type PublishTemplateResponseSuccess = TemplatesPublishResponse;
+type PublishTemplateResponse = Response<PublishTemplateResponseSuccess>;
+type GetTemplateResponseSuccess = TemplatesGetResponse;
+type GetTemplateResponse = Response<GetTemplateResponseSuccess>;
+type ListTemplatesOptions = TemplatesListParams;
+type ListTemplatesResponseSuccess = TemplatesListResponse;
+type ListTemplatesResponse = Response<ListTemplatesResponseSuccess>;
+type UpdateTemplateOptions = Omit<TemplatesUpdateParams, "id">;
+type UpdateTemplateResponseSuccess = TemplatesUpdateResponse;
+type UpdateTemplateResponse = Response<UpdateTemplateResponseSuccess>;
+type RemoveTemplateResponseSuccess = TemplatesRemoveResponse;
+type RemoveTemplateResponse = Response<RemoveTemplateResponseSuccess>;
+type CreateWebhookOptions = WebhooksCreateParams;
+type CreateWebhookRequestOptions = RequestOptions;
+type CreateWebhookResponseSuccess = WebhooksCreateResponse;
+type CreateWebhookResponse = Response<CreateWebhookResponseSuccess>;
+type GetWebhookResponseSuccess = WebhooksGetResponse;
+type GetWebhookResponse = Response<GetWebhookResponseSuccess>;
+type ListWebhooksOptions = WebhooksListParams;
+type ListWebhooksResponseSuccess = WebhooksListResponse;
+type ListWebhooksResponse = Response<ListWebhooksResponseSuccess>;
+type UpdateWebhookOptions = Omit<WebhooksUpdateParams, "id">;
+type UpdateWebhookResponseSuccess = WebhooksUpdateResponse;
+type UpdateWebhookResponse = Response<UpdateWebhookResponseSuccess>;
+type RemoveWebhookResponseSuccess = WebhooksRemoveResponse;
+type RemoveWebhookResponse = Response<RemoveWebhookResponseSuccess>;
+type RotateWebhookSigningSecretResponseSuccess = WebhooksRotateSigningSecretResponse;
+type RotateWebhookSigningSecretResponse = Response<RotateWebhookSigningSecretResponseSuccess>;
+
+/** Résultat de `templates.create` / `templates.duplicate` : une promesse qu'on peut enchaîner avec `.publish()`. */
+type ChainableTemplateResult<T> = Promise<Response<T>> & {
+    publish(options?: RequestOptions): Promise<Response<TemplatesPublishResponse>>;
+};
+/** Comme Resend : `react` rendu en `html` via `@react-email/render`, l'un ou l'autre. */
+type CreateTemplateParams = Omit<TemplatesCreateParams, "html"> & {
+    html?: string;
+    react?: unknown;
+};
+type SendEmail = (payload: SendEmailParams, options?: RequestOptions) => Promise<Response<EmailsSendResponse>>;
+type SendBatch = (emails: BatchEmailParams[], options?: BatchSendOptions) => Promise<Response<BatchSendResponse>>;
+/** Méthodes dont Resend 6.32 impose la forme : elles remplacent celles du catalogue. */
+interface Smartletter extends Omit<SmartletterResources, "emails" | "batch" | "apiKeys" | "templates" | "webhooks"> {
+    emails: Omit<SmartletterResources["emails"], "send"> & {
+        send: SendEmail;
+        create: SendEmail;
+    };
+    batch: {
+        send: SendBatch;
+        create: SendBatch;
+    };
+    apiKeys: Omit<SmartletterResources["apiKeys"], "update"> & {
+        update(id: string, payload: Omit<ApiKeysUpdateParams, "id">, options?: RequestOptions): Promise<Response<ApiKeysUpdateResponse>>;
+    };
+    templates: Omit<SmartletterResources["templates"], "create" | "duplicate" | "publish" | "update"> & {
+        create(payload: CreateTemplateParams, options?: RequestOptions): ChainableTemplateResult<TemplatesCreateResponse>;
+        duplicate(id: string, options?: RequestOptions): ChainableTemplateResult<TemplatesDuplicateResponse>;
+        publish(id: string, options?: RequestOptions): Promise<Response<TemplatesPublishResponse>>;
+        update(id: string, payload: Omit<TemplatesUpdateParams, "id">, options?: RequestOptions): Promise<Response<TemplatesUpdateResponse>>;
+    };
+    webhooks: Omit<SmartletterResources["webhooks"], "update"> & {
+        update(id: string, payload: Omit<WebhooksUpdateParams, "id">, options?: RequestOptions): Promise<Response<WebhooksUpdateResponse>>;
+        verify(input: VerifyWebhookInput): WebhookEvent;
+    };
+}
+declare class Smartletter extends Client {
+    constructor(key?: string, options?: {
+        baseUrl?: string;
+        userAgent?: string;
+    });
+}
+
+export { Smartletter as Resend, Smartletter, WebhookVerificationError };
+export type { ApiKeysCreateParams, ApiKeysCreateResponse, ApiKeysListParams, ApiKeysListResponse, ApiKeysRemoveParams, ApiKeysRemoveResponse, ApiKeysUpdateParams, ApiKeysUpdateResponse, AudienceFiltersCountParams, AudienceFiltersCountResponse, AudienceFiltersCreateParams, AudienceFiltersCreateResponse, AudienceFiltersGetParams, AudienceFiltersGetResponse, AudienceFiltersListParams, AudienceFiltersListResponse, AudienceFiltersRemoveParams, AudienceFiltersRemoveResponse, AudienceFiltersUpdateParams, AudienceFiltersUpdateResponse, BatchEmailParams, BatchSendOptions, BatchSendParams, BatchSendResponse, CancelEmailResponse, CancelEmailResponseSuccess, ChainableTemplateResult, ContactFieldsCreateParams, ContactFieldsCreateResponse, ContactFieldsListParams, ContactFieldsListResponse, ContactFieldsRemoveParams, ContactFieldsRemoveResponse, ContactFieldsUpdateParams, ContactFieldsUpdateResponse, ContactsCreateParams, ContactsCreateResponse, ContactsExportParams, ContactsExportResponse, ContactsGetParams, ContactsGetResponse, ContactsImportParams, ContactsImportResponse, ContactsListParams, ContactsListResponse, ContactsReactivateParams, ContactsReactivateResponse, ContactsRemoveParams, ContactsRemoveResponse, ContactsUnsubscribeParams, ContactsUnsubscribeResponse, ContactsUpdateParams, ContactsUpdateResponse, CreateApiKeyOptions, CreateApiKeyRequestOptions, CreateApiKeyResponse, CreateApiKeyResponseSuccess, CreateBatchEmailOptions, CreateBatchOptions, CreateBatchRequestOptions, CreateBatchResponse, CreateBatchSuccessResponse, CreateDomainOptions, CreateDomainRequestOptions, CreateDomainResponse, CreateDomainResponseSuccess, CreateEmailOptions, CreateEmailRequestOptions, CreateEmailResponse, CreateEmailResponseSuccess, CreateTemplateOptions, CreateTemplateParams, CreateTemplateRequestOptions, CreateTemplateResponse, CreateTemplateResponseSuccess, CreateWebhookOptions, CreateWebhookRequestOptions, CreateWebhookResponse, CreateWebhookResponseSuccess, DomainsCreateParams, DomainsCreateResponse, DomainsGetParams, DomainsGetResponse, DomainsListParams, DomainsListResponse, DomainsVerifyParams, DomainsVerifyResponse, DuplicateTemplateResponse, DuplicateTemplateResponseSuccess, EmailsCancelParams, EmailsCancelResponse, EmailsGetParams, EmailsGetResponse, EmailsListParams, EmailsListResponse, EmailsSendParams, EmailsSendResponse, EmailsUpdateParams, EmailsUpdateResponse, ErrorResponse, EventsSendParams, EventsSendResponse, GetDomainResponse, GetDomainResponseSuccess, GetEmailResponse, GetEmailResponseSuccess, GetTemplateResponse, GetTemplateResponseSuccess, GetWebhookResponse, GetWebhookResponseSuccess, ImagesCreateParams, ImagesCreateResponse, ImagesListParams, ImagesListResponse, InboxesCreateParams, InboxesCreateResponse, InboxesGetParams, InboxesGetResponse, InboxesListParams, InboxesListResponse, InboxesRemoveParams, InboxesRemoveResponse, InboxesUpdateParams, InboxesUpdateResponse, ListApiKeysOptions, ListApiKeysResponse, ListApiKeysResponseSuccess, ListDomainsOptions, ListDomainsResponse, ListDomainsResponseSuccess, ListEmail, ListEmailsOptions, ListEmailsResponse, ListEmailsResponseSuccess, ListTemplatesOptions, ListTemplatesResponse, ListTemplatesResponseSuccess, ListWebhooksOptions, ListWebhooksResponse, ListWebhooksResponseSuccess, LogsGetParams, LogsGetResponse, LogsListParams, LogsListResponse, MessagesAttachmentParams, MessagesAttachmentResponse, MessagesGetParams, MessagesGetResponse, MessagesRemoveParams, MessagesRemoveResponse, MessagesSendParams, MessagesSendResponse, MessagesUpdateParams, MessagesUpdateResponse, NewslettersAbWinnerParams, NewslettersAbWinnerResponse, NewslettersArchiveUpdateParams, NewslettersArchiveUpdateResponse, NewslettersCreateParams, NewslettersCreateResponse, NewslettersDuplicateParams, NewslettersDuplicateResponse, NewslettersGetParams, NewslettersGetResponse, NewslettersListParams, NewslettersListResponse, NewslettersPauseParams, NewslettersPauseResponse, NewslettersRemoveParams, NewslettersRemoveResponse, NewslettersReportParams, NewslettersReportResponse, NewslettersResumeParams, NewslettersResumeResponse, NewslettersReviewParams, NewslettersReviewResponse, NewslettersScheduleParams, NewslettersScheduleResponse, NewslettersSendMoreParams, NewslettersSendMoreResponse, NewslettersSendParams, NewslettersSendResponse, NewslettersTestParams, NewslettersTestResponse, NewslettersUnscheduleParams, NewslettersUnscheduleResponse, NewslettersUpdateParams, NewslettersUpdateResponse, PublishTemplateResponse, PublishTemplateResponseSuccess, RemoveApiKeyResponse, RemoveApiKeyResponseSuccess, RemoveTemplateResponse, RemoveTemplateResponseSuccess, RemoveWebhookResponse, RemoveWebhookResponseSuccess, RequestOptions, Response, RotateWebhookSigningSecretResponse, RotateWebhookSigningSecretResponseSuccess, SegmentsArchiveGetParams, SegmentsArchiveGetResponse, SegmentsArchiveUpdateParams, SegmentsArchiveUpdateResponse, SegmentsCreateParams, SegmentsCreateResponse, SegmentsDomainGetParams, SegmentsDomainGetResponse, SegmentsDomainRemoveParams, SegmentsDomainRemoveResponse, SegmentsDomainSetParams, SegmentsDomainSetResponse, SegmentsListParams, SegmentsListResponse, SendEmailParams, SequencesActivateParams, SequencesActivateResponse, SequencesArchiveParams, SequencesArchiveResponse, SequencesCreateParams, SequencesCreateResponse, SequencesEnrollParams, SequencesEnrollResponse, SequencesEnrollmentsParams, SequencesEnrollmentsResponse, SequencesGetParams, SequencesGetResponse, SequencesListParams, SequencesListResponse, SequencesPauseParams, SequencesPauseResponse, SequencesRemoveParams, SequencesRemoveResponse, SequencesStatsParams, SequencesStatsResponse, SequencesUnenrollParams, SequencesUnenrollResponse, SequencesUpdateParams, SequencesUpdateResponse, SignupsCreateParams, SignupsCreateResponse, StatsOverviewParams, StatsOverviewResponse, SuppressionsCreateParams, SuppressionsCreateResponse, SuppressionsListParams, SuppressionsListResponse, SuppressionsRemoveParams, SuppressionsRemoveResponse, TemplatesCreateParams, TemplatesCreateResponse, TemplatesDuplicateParams, TemplatesDuplicateResponse, TemplatesGetParams, TemplatesGetResponse, TemplatesListParams, TemplatesListResponse, TemplatesPublishParams, TemplatesPublishResponse, TemplatesRemoveParams, TemplatesRemoveResponse, TemplatesUpdateParams, TemplatesUpdateResponse, TemplatesVersionsParams, TemplatesVersionsResponse, ThreadsGetParams, ThreadsGetResponse, ThreadsListParams, ThreadsListResponse, ThreadsReplyParams, ThreadsReplyResponse, ThreadsUpdateParams, ThreadsUpdateResponse, TopicsListParams, TopicsListResponse, UpdateApiKeyOptions, UpdateApiKeyResponse, UpdateApiKeyResponseSuccess, UpdateEmailOptions, UpdateEmailResponse, UpdateEmailResponseSuccess, UpdateTemplateOptions, UpdateTemplateResponse, UpdateTemplateResponseSuccess, UpdateWebhookOptions, UpdateWebhookResponse, UpdateWebhookResponseSuccess, UsageGetParams, UsageGetResponse, VerifyDomainsResponse, VerifyDomainsResponseSuccess, VerifyWebhookInput, WebhookEvent, WebhooksCreateParams, WebhooksCreateResponse, WebhooksDeliveriesParams, WebhooksDeliveriesResponse, WebhooksGetParams, WebhooksGetResponse, WebhooksListParams, WebhooksListResponse, WebhooksRemoveParams, WebhooksRemoveResponse, WebhooksRetryDeliveryParams, WebhooksRetryDeliveryResponse, WebhooksRotateSigningSecretParams, WebhooksRotateSigningSecretResponse, WebhooksTestParams, WebhooksTestResponse, WebhooksUpdateParams, WebhooksUpdateResponse };