@sendclipper/node 0.0.0-stage → 0.1.0

package/dist/esm/errors.js

@@ -0,0 +1,102 @@
+/** Base class for everything this SDK throws on purpose. */
+export class SendClipperError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'SendClipperError';
+    }
+}
+/**
+ * The API answered with a non-2xx status. `code` is the API's own
+ * machine-readable reason (`domain_not_verified`, `template_variables_missing`,
+ * `rate_limited`, …) and is the field to branch on; `message` is a sentence
+ * meant for a person.
+ */
+export class SendClipperApiError extends SendClipperError {
+    status;
+    code;
+    detail;
+    headers;
+    constructor(status, code, message, detail, headers) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.detail = detail;
+        this.headers = headers;
+        this.name = 'SendClipperApiError';
+    }
+}
+/** The request never got an answer: DNS, TLS, a reset socket or the timeout. */
+export class SendClipperConnectionError extends SendClipperError {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'SendClipperConnectionError';
+    }
+}
+/** `webhooks.verify()` refused a delivery. `reason` says which check failed. */
+export class WebhookVerificationError extends SendClipperError {
+    reason;
+    constructor(reason, message) {
+        super(message);
+        this.reason = reason;
+        this.name = 'WebhookVerificationError';
+    }
+}
+/**
+ * The API answers refusals in two shapes: the house envelope
+ * `{ error: { code, message, detail? } }` and Nest's default
+ * `{ statusCode, message: string | string[], error }` (request validation).
+ */
+export function toApiError(status, text, headers) {
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        parsed = undefined;
+    }
+    const obj = (parsed && typeof parsed === 'object' ? parsed : {});
+    const env = obj.error;
+    if (env && typeof env === 'object') {
+        const e = env;
+        return new SendClipperApiError(status, String(e.code ?? codeForStatus(status)), String(e.message ?? `HTTP ${status}`), e.detail ?? e.details, headers);
+    }
+    const msg = obj.message;
+    if (msg && typeof msg === 'object' && !Array.isArray(msg)) {
+        const inner = msg.error;
+        if (inner && typeof inner === 'object') {
+            const e = inner;
+            return new SendClipperApiError(status, String(e.code ?? codeForStatus(status)), String(e.message ?? `HTTP ${status}`), e.detail, headers);
+        }
+    }
+    if (Array.isArray(msg)) {
+        return new SendClipperApiError(status, 'validation_failed', msg.join('; '), msg, headers);
+    }
+    if (typeof msg === 'string') {
+        return new SendClipperApiError(status, codeForStatus(status), msg, undefined, headers);
+    }
+    const snippet = text.trim().slice(0, 300);
+    return new SendClipperApiError(status, codeForStatus(status), snippet || `HTTP ${status}`, undefined, headers);
+}
+function codeForStatus(status) {
+    switch (status) {
+        case 400:
+            return 'bad_request';
+        case 401:
+            return 'unauthorized';
+        case 403:
+            return 'forbidden';
+        case 404:
+            return 'not_found';
+        case 409:
+            return 'conflict';
+        case 413:
+            return 'payload_too_large';
+        case 429:
+            return 'rate_limited';
+        default:
+            return `http_${status}`;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/esm/index.d.ts

@@ -0,0 +1,52 @@
+import { type ClientOptions } from './core.js';
+import { Audiences, Contacts, Suppressions } from './resources/audience.js';
+import { Domains } from './resources/domains.js';
+import { Batch, Emails } from './resources/emails.js';
+import { Mailboxes } from './resources/mailboxes.js';
+import { Sandboxes } from './resources/sandboxes.js';
+import { Templates } from './resources/templates.js';
+import { Webhooks } from './resources/webhooks.js';
+import { ApiKeys, Automations, WorkspaceResource } from './resources/workspace.js';
+/**
+ * The SendClipper API client.
+ *
+ * ```ts
+ * import { SendClipper } from '@sendclipper/node';
+ *
+ * const sc = new SendClipper(process.env.SENDCLIPPER_API_KEY);
+ * const { data, error } = await sc.emails.send({
+ *   from: 'hello@acme.io',
+ *   to: 'ada@lumen.io',
+ *   subject: 'Hi',
+ *   html: '<p>Hi</p>',
+ * });
+ * ```
+ */
+export declare class SendClipper {
+    readonly emails: Emails;
+    readonly batch: Batch;
+    readonly domains: Domains;
+    readonly templates: Templates;
+    readonly sandboxes: Sandboxes;
+    readonly webhooks: Webhooks;
+    readonly contacts: Contacts;
+    readonly audiences: Audiences;
+    readonly suppressions: Suppressions;
+    readonly mailboxes: Mailboxes;
+    readonly automations: Automations;
+    readonly workspace: WorkspaceResource;
+    readonly apiKeys: ApiKeys;
+    /** The API origin requests go to, without `/v1`. */
+    readonly baseUrl: string;
+    constructor(apiKey?: string, options?: Omit<ClientOptions, 'apiKey'>);
+    constructor(options?: ClientOptions);
+}
+export default SendClipper;
+export { DEFAULT_BASE_URL } from './core.js';
+export type { ClientOptions, RequestOptions, DownloadedFile, Query, Result, ErrorResponse } from './core.js';
+export { SendClipperError, SendClipperApiError, SendClipperConnectionError, WebhookVerificationError, } from './errors.js';
+export { verifyWebhook, signatureHeader, signPayload, parseSignatureHeader, WEBHOOK_TOLERANCE_SECONDS, } from './webhook-signature.js';
+export type { VerifyWebhookParams, HeaderSource } from './webhook-signature.js';
+export { VERSION } from './version.js';
+export type * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEnF;;;;;;;;;;;;;;GAcG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC;gBACxD,OAAO,CAAC,EAAE,aAAa;CAoBpC;AAED,eAAe,WAAW,CAAC;AAE3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC7G,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,aAAa,EACb,eAAe,EACf,WAAW,EACX,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,mBAAmB,YAAY,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,65 @@
+import { HttpClient } from './core.js';
+import { Audiences, Contacts, Suppressions } from './resources/audience.js';
+import { Domains } from './resources/domains.js';
+import { Batch, Emails } from './resources/emails.js';
+import { Mailboxes } from './resources/mailboxes.js';
+import { Sandboxes } from './resources/sandboxes.js';
+import { Templates } from './resources/templates.js';
+import { Webhooks } from './resources/webhooks.js';
+import { ApiKeys, Automations, WorkspaceResource } from './resources/workspace.js';
+/**
+ * The SendClipper API client.
+ *
+ * ```ts
+ * import { SendClipper } from '@sendclipper/node';
+ *
+ * const sc = new SendClipper(process.env.SENDCLIPPER_API_KEY);
+ * const { data, error } = await sc.emails.send({
+ *   from: 'hello@acme.io',
+ *   to: 'ada@lumen.io',
+ *   subject: 'Hi',
+ *   html: '<p>Hi</p>',
+ * });
+ * ```
+ */
+export class SendClipper {
+    emails;
+    batch;
+    domains;
+    templates;
+    sandboxes;
+    webhooks;
+    contacts;
+    audiences;
+    suppressions;
+    mailboxes;
+    automations;
+    workspace;
+    apiKeys;
+    /** The API origin requests go to, without `/v1`. */
+    baseUrl;
+    constructor(keyOrOptions, options = {}) {
+        const opts = typeof keyOrOptions === 'string' ? { ...options, apiKey: keyOrOptions } : { ...(keyOrOptions ?? {}) };
+        const http = new HttpClient(opts);
+        this.baseUrl = http.baseUrl;
+        this.emails = new Emails(http);
+        this.batch = new Batch(http);
+        this.domains = new Domains(http);
+        this.templates = new Templates(http);
+        this.sandboxes = new Sandboxes(http);
+        this.webhooks = new Webhooks(http);
+        this.contacts = new Contacts(http);
+        this.audiences = new Audiences(http);
+        this.suppressions = new Suppressions(http);
+        this.mailboxes = new Mailboxes(http);
+        this.automations = new Automations(http);
+        this.workspace = new WorkspaceResource(http);
+        this.apiKeys = new ApiKeys(http);
+    }
+}
+export default SendClipper;
+export { DEFAULT_BASE_URL } from './core.js';
+export { SendClipperError, SendClipperApiError, SendClipperConnectionError, WebhookVerificationError, } from './errors.js';
+export { verifyWebhook, signatureHeader, signPayload, parseSignatureHeader, WEBHOOK_TOLERANCE_SECONDS, } from './webhook-signature.js';
+export { VERSION } from './version.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/esm/render.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `react` support, the way Resend does it: render a React Email component to
+ * HTML (and a plain-text alternative) with `@react-email/render`, an OPTIONAL
+ * peer dependency loaded only when a message actually carries `react`.
+ */
+/** A React element. Typed loosely so the SDK needs no React types. */
+export type ReactNodeLike = unknown;
+/** Replace `react` with the `html` (and, if absent, `text`) it renders to. */
+export declare function withRenderedReact<T extends {
+    react?: ReactNodeLike;
+    html?: string;
+    text?: string;
+}>(params: T): Promise<Omit<T, 'react'>>;
+//# sourceMappingURL=render.d.ts.map

package/dist/esm/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/render.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,sEAAsE;AACtE,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC;AAsBpC,8EAA8E;AAC9E,wBAAsB,iBAAiB,CAAC,CAAC,SAAS;IAAE,KAAK,CAAC,EAAE,aAAa,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EACvG,MAAM,EAAE,CAAC,GACR,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAO3B"}

package/dist/esm/render.js

@@ -0,0 +1,28 @@
+/**
+ * `react` support, the way Resend does it: render a React Email component to
+ * HTML (and a plain-text alternative) with `@react-email/render`, an OPTIONAL
+ * peer dependency loaded only when a message actually carries `react`.
+ */
+let cached;
+function loadRenderer() {
+    // A variable specifier keeps bundlers and tsc from resolving the module
+    // when nobody uses `react`.
+    const specifier = '@react-email/render';
+    cached ??= import(specifier).catch((err) => {
+        cached = undefined;
+        throw new Error('Sending with `react` needs @react-email/render. Install it: npm i @react-email/render ' +
+            `(${err.message})`);
+    });
+    return cached;
+}
+/** Replace `react` with the `html` (and, if absent, `text`) it renders to. */
+export async function withRenderedReact(params) {
+    if (params.react === undefined || params.react === null)
+        return params;
+    const { react, ...rest } = params;
+    const { render } = await loadRenderer();
+    const html = await render(react);
+    const text = rest.text ?? (await render(react, { plainText: true }));
+    return { ...rest, html, text };
+}
+//# sourceMappingURL=render.js.map

package/dist/esm/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/render.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,IAAI,MAAyC,CAAC;AAE9C,SAAS,YAAY;IACnB,wEAAwE;IACxE,4BAA4B;IAC5B,MAAM,SAAS,GAAG,qBAAqB,CAAC;IACxC,MAAM,KAAM,MAAM,CAAC,SAAS,CAA2B,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QAC7E,MAAM,GAAG,SAAS,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,wFAAwF;YACtF,IAAK,GAAa,CAAC,OAAO,GAAG,CAChC,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAS;IAET,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IACvE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IAClC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,YAAY,EAAE,CAAC;IACxC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,MAAM,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACrE,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,IAAI,EAAsB,CAAC;AACrD,CAAC"}

package/dist/esm/resources/audience.d.ts

@@ -0,0 +1,51 @@
+import type { HttpClient, RequestOptions, Result } from '../core.js';
+import type { Audience, Contact, ContactList, CreateContactParams, ImportContactsParams, ListContactsParams, ListSuppressionsParams, Suppression, SuppressionList } from '../types.js';
+export declare class Contacts {
+    private readonly http;
+    constructor(http: HttpClient);
+    list(params?: ListContactsParams, options?: RequestOptions): Promise<Result<ContactList>>;
+    iterate(params?: Omit<ListContactsParams, 'page'>, options?: RequestOptions): AsyncGenerator<Contact>;
+    create(params: CreateContactParams, options?: RequestOptions): Promise<Result<Contact>>;
+    /** Import a CSV or vCard file. Importing never suppresses anyone. */
+    import(params: ImportContactsParams, options?: RequestOptions): Promise<Result<Record<string, unknown>>>;
+    /** What an import would do, without importing. */
+    importPreview(params: Pick<ImportContactsParams, 'file' | 'filename'>, options?: RequestOptions): Promise<Result<Record<string, unknown>>>;
+    /** Every contact as CSV (re-importable) or vCard 4.0. */
+    export(params?: {
+        format?: 'csv' | 'vcf';
+        audience?: string;
+    }, options?: RequestOptions): Promise<Result<string>>;
+}
+export declare class Audiences {
+    private readonly http;
+    constructor(http: HttpClient);
+    list(options?: RequestOptions): Promise<Result<{
+        audiences: Audience[];
+        totalContacts: number;
+    }>>;
+}
+export declare class Suppressions {
+    private readonly http;
+    constructor(http: HttpClient);
+    list(params?: ListSuppressionsParams, options?: RequestOptions): Promise<Result<SuppressionList>>;
+    iterate(params?: Omit<ListSuppressionsParams, 'cursor'>, options?: RequestOptions): AsyncGenerator<Suppression>;
+    /**
+     * Stop all mail to an address (reason `manual`). `created` is `false` when
+     * the address was already suppressed; `row` is the entry either way.
+     */
+    create(params: {
+        email: string;
+        note?: string;
+    }, options?: RequestOptions): Promise<Result<{
+        created: boolean;
+        row: Suppression | null;
+    }>>;
+    /**
+     * Lift a suppression. `reason` (10+ characters) is recorded. Complaint and
+     * provider suppressions cannot be removed (`suppression_not_removable`).
+     */
+    remove(id: string, reason: string, options?: RequestOptions): Promise<Result<Record<string, unknown>>>;
+    /** The list as CSV. */
+    export(params?: Omit<ListSuppressionsParams, 'cursor' | 'limit'>, options?: RequestOptions): Promise<Result<string>>;
+}
+//# sourceMappingURL=audience.d.ts.map

package/dist/esm/resources/audience.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audience.d.ts","sourceRoot":"","sources":["../../../src/resources/audience.ts"],"names":[],"mappings":"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"}

package/dist/esm/resources/audience.js

@@ -0,0 +1,99 @@
+import { seg, unwrap } from '../core.js';
+export class Contacts {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    list(params = {}, options = {}) {
+        return this.http.call({ method: 'GET', path: '/contacts', query: { ...params }, ...options });
+    }
+    async *iterate(params = {}, options = {}) {
+        const pageSize = params.pageSize ?? 200;
+        for (let page = 1;; page++) {
+            const res = unwrap(await this.list({ ...params, page, pageSize }, options));
+            yield* res.items;
+            if (page >= res.totalPages || res.items.length === 0)
+                return;
+        }
+    }
+    create(params, options = {}) {
+        return this.http.call({ method: 'POST', path: '/contacts', body: params, ...options });
+    }
+    /** Import a CSV or vCard file. Importing never suppresses anyone. */
+    import(params, options = {}) {
+        return this.http.call({ method: 'POST', path: '/contacts/import', form: importForm(params), ...options });
+    }
+    /** What an import would do, without importing. */
+    importPreview(params, options = {}) {
+        return this.http.call({ method: 'POST', path: '/contacts/import/preview', form: importForm(params), ...options });
+    }
+    /** Every contact as CSV (re-importable) or vCard 4.0. */
+    export(params = {}, options = {}) {
+        return this.http.call({ method: 'GET', path: '/contacts/export', query: { ...params }, as: 'text', ...options });
+    }
+}
+export class Audiences {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    list(options = {}) {
+        return this.http.call({ method: 'GET', path: '/audiences', ...options });
+    }
+}
+export class Suppressions {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    list(params = {}, options = {}) {
+        return this.http.call({ method: 'GET', path: '/suppressions', query: { ...params }, ...options });
+    }
+    async *iterate(params = {}, options = {}) {
+        let cursor;
+        for (;;) {
+            const res = unwrap(await this.list({ ...params, cursor }, options));
+            yield* res.data;
+            if (!res.page.hasMore || !res.page.cursor)
+                return;
+            cursor = res.page.cursor;
+        }
+    }
+    /**
+     * Stop all mail to an address (reason `manual`). `created` is `false` when
+     * the address was already suppressed; `row` is the entry either way.
+     */
+    create(params, options = {}) {
+        return this.http.call({ method: 'POST', path: '/suppressions', body: params, ...options });
+    }
+    /**
+     * Lift a suppression. `reason` (10+ characters) is recorded. Complaint and
+     * provider suppressions cannot be removed (`suppression_not_removable`).
+     */
+    remove(id, reason, options = {}) {
+        return this.http.call({ method: 'DELETE', path: `/suppressions/${seg(id)}`, body: { reason }, ...options });
+    }
+    /** The list as CSV. */
+    export(params = {}, options = {}) {
+        return this.http.call({ method: 'GET', path: '/suppressions/export', query: { ...params }, as: 'text', ...options });
+    }
+}
+function importForm(params) {
+    const form = new FormData();
+    const name = params.filename ?? 'contacts.csv';
+    const type = /\.vcf$/i.test(name) ? 'text/vcard' : 'text/csv';
+    const bytes = typeof params.file === 'string' ? params.file : new Uint8Array(params.file);
+    form.append('file', new Blob([bytes], { type }), name);
+    if (params.audienceId)
+        form.append('audienceId', params.audienceId);
+    if (params.newAudience)
+        form.append('newAudience', params.newAudience);
+    if (params.createAudiences !== undefined)
+        form.append('createAudiences', String(params.createAudiences));
+    if (params.onDuplicate)
+        form.append('onDuplicate', params.onDuplicate);
+    if (params.mapping)
+        form.append('mapping', JSON.stringify(params.mapping));
+    return form;
+}
+//# sourceMappingURL=audience.js.map

package/dist/esm/resources/audience.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audience.js","sourceRoot":"","sources":["../../../src/resources/audience.ts"],"names":[],"mappings":"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"}

package/dist/esm/resources/domains.d.ts

@@ -0,0 +1,22 @@
+import type { HttpClient, RequestOptions, Result } from '../core.js';
+import type { CreateDomainParams, Domain, DomainRecords, DomainRegion } from '../types.js';
+export declare class Domains {
+    private readonly http;
+    constructor(http: HttpClient);
+    list(options?: RequestOptions): Promise<Result<Domain[]>>;
+    /** Register a sending domain. Next: `records()`, publish them, then `verify()`. */
+    create(params: CreateDomainParams, options?: RequestOptions): Promise<Result<Domain>>;
+    /** The DNS records to publish, each with its current status. */
+    records(id: string, options?: RequestOptions): Promise<Result<DomainRecords>>;
+    /** Check DNS now instead of waiting for the background check. */
+    verify(id: string, options?: RequestOptions): Promise<Result<Domain>>;
+    /** Start receiving mail on this domain. Adds receiving records; never blocks sending. */
+    enableReceiving(id: string, options?: RequestOptions): Promise<Result<Domain>>;
+    disableReceiving(id: string, options?: RequestOptions): Promise<Result<Domain>>;
+    /** Move a domain to another region. Refused (`region_immutable`) once it holds messages. */
+    setRegion(id: string, region: DomainRegion, options?: RequestOptions): Promise<Result<Domain>>;
+    /** What deleting the domain would take with it. */
+    deletionPreview(id: string, options?: RequestOptions): Promise<Result<Record<string, unknown>>>;
+    remove(id: string, options?: RequestOptions): Promise<Result<void>>;
+}
+//# sourceMappingURL=domains.d.ts.map

package/dist/esm/resources/domains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domains.d.ts","sourceRoot":"","sources":["../../../src/resources/domains.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAErE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3F,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,IAAI,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAI7D,mFAAmF;IACnF,MAAM,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAIzF,gEAAgE;IAChE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAIjF,iEAAiE;IACjE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAIzE,yFAAyF;IACzF,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAIlF,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAInF,4FAA4F;IAC5F,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAIlG,mDAAmD;IACnD,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAInG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;CAGxE"}

package/dist/esm/resources/domains.js

@@ -0,0 +1,41 @@
+import { seg } from '../core.js';
+export class Domains {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    list(options = {}) {
+        return this.http.call({ method: 'GET', path: '/domains', ...options });
+    }
+    /** Register a sending domain. Next: `records()`, publish them, then `verify()`. */
+    create(params, options = {}) {
+        return this.http.call({ method: 'POST', path: '/domains', body: params, ...options });
+    }
+    /** The DNS records to publish, each with its current status. */
+    records(id, options = {}) {
+        return this.http.call({ method: 'GET', path: `/domains/${seg(id)}/records`, ...options });
+    }
+    /** Check DNS now instead of waiting for the background check. */
+    verify(id, options = {}) {
+        return this.http.call({ method: 'POST', path: `/domains/${seg(id)}/verify`, ...options });
+    }
+    /** Start receiving mail on this domain. Adds receiving records; never blocks sending. */
+    enableReceiving(id, options = {}) {
+        return this.http.call({ method: 'POST', path: `/domains/${seg(id)}/receiving`, ...options });
+    }
+    disableReceiving(id, options = {}) {
+        return this.http.call({ method: 'DELETE', path: `/domains/${seg(id)}/receiving`, ...options });
+    }
+    /** Move a domain to another region. Refused (`region_immutable`) once it holds messages. */
+    setRegion(id, region, options = {}) {
+        return this.http.call({ method: 'PATCH', path: `/domains/${seg(id)}/region`, body: { region }, ...options });
+    }
+    /** What deleting the domain would take with it. */
+    deletionPreview(id, options = {}) {
+        return this.http.call({ method: 'GET', path: `/domains/${seg(id)}/deletion`, ...options });
+    }
+    remove(id, options = {}) {
+        return this.http.call({ method: 'DELETE', path: `/domains/${seg(id)}`, ...options });
+    }
+}
+//# sourceMappingURL=domains.js.map

package/dist/esm/resources/domains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domains.js","sourceRoot":"","sources":["../../../src/resources/domains.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAGjC,MAAM,OAAO,OAAO;IACW;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,IAAI,CAAC,UAA0B,EAAE;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,mFAAmF;IACnF,MAAM,CAAC,MAA0B,EAAE,UAA0B,EAAE;QAC7D,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxF,CAAC;IAED,gEAAgE;IAChE,OAAO,CAAC,EAAU,EAAE,UAA0B,EAAE;QAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,GAAG,CAAC,EAAE,CAAC,UAAU,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,iEAAiE;IACjE,MAAM,CAAC,EAAU,EAAE,UAA0B,EAAE;QAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,yFAAyF;IACzF,eAAe,CAAC,EAAU,EAAE,UAA0B,EAAE;QACtD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED,gBAAgB,CAAC,EAAU,EAAE,UAA0B,EAAE;QACvD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjG,CAAC;IAED,4FAA4F;IAC5F,SAAS,CAAC,EAAU,EAAE,MAAoB,EAAE,UAA0B,EAAE;QACtE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/G,CAAC;IAED,mDAAmD;IACnD,eAAe,CAAC,EAAU,EAAE,UAA0B,EAAE;QACtD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7F,CAAC;IAED,MAAM,CAAC,EAAU,EAAE,UAA0B,EAAE;QAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvF,CAAC;CACF"}

package/dist/esm/resources/emails.d.ts

@@ -0,0 +1,34 @@
+import type { HttpClient, RequestOptions, Result } from '../core.js';
+import type { EmailDetail, EmailList, EmailRow, EmailStats, ListEmailsParams, SendBatchResponse, SendEmailParams, SentEmail } from '../types.js';
+export declare class Emails {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Send one message. Resolves once SendClipper accepted it (status `queued`);
+     * delivery is reported later through `emails.get()` and webhooks.
+     *
+     * Every call carries an `Idempotency-Key`, so the SDK's own retries never
+     * send twice. Pass `idempotencyKey` yourself to make YOUR retries safe too.
+     */
+    send(params: SendEmailParams, options?: RequestOptions): Promise<Result<SentEmail>>;
+    /** Same as `batch.send()`. */
+    sendBatch(emails: SendEmailParams[], options?: RequestOptions): Promise<Result<SendBatchResponse>>;
+    /** One message with its body and event timeline. */
+    get(id: string, options?: RequestOptions): Promise<Result<EmailDetail>>;
+    /** One page of the sent-mail log, newest first. */
+    list(params?: ListEmailsParams, options?: RequestOptions): Promise<Result<EmailList>>;
+    /** Every message matching `params`, page after page. */
+    iterate(params?: Omit<ListEmailsParams, 'page'>, options?: RequestOptions): AsyncGenerator<EmailRow>;
+    /** Counts per status. */
+    stats(options?: RequestOptions): Promise<Result<EmailStats>>;
+}
+export declare class Batch {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Up to 500 messages in one request (one recipient each). Every item is
+     * accepted or refused on its own; a refused item costs its siblings nothing.
+     */
+    send(emails: SendEmailParams[], options?: RequestOptions): Promise<Result<SendBatchResponse>>;
+}
+//# sourceMappingURL=emails.d.ts.map

package/dist/esm/resources/emails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emails.d.ts","sourceRoot":"","sources":["../../../src/resources/emails.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAGrE,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,SAAS,EACV,MAAM,aAAa,CAAC;AAErB,qBAAa,MAAM;IACL,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;;;OAMG;IACG,IAAI,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAI7F,8BAA8B;IAC9B,SAAS,CAAC,MAAM,EAAE,eAAe,EAAE,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAItG,oDAAoD;IACpD,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAI3E,mDAAmD;IACnD,IAAI,CAAC,MAAM,GAAE,gBAAqB,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAI7F,wDAAwD;IACjD,OAAO,CAAC,MAAM,GAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,cAAc,CAAC,QAAQ,CAAC;IASnH,yBAAyB;IACzB,KAAK,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;CAGjE;AAED,qBAAa,KAAK;IACJ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,eAAe,EAAE,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;CAGlG"}

package/dist/esm/resources/emails.js

@@ -0,0 +1,62 @@
+import { seg, unwrap } from '../core.js';
+import { withRenderedReact } from '../render.js';
+export class Emails {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Send one message. Resolves once SendClipper accepted it (status `queued`);
+     * delivery is reported later through `emails.get()` and webhooks.
+     *
+     * Every call carries an `Idempotency-Key`, so the SDK's own retries never
+     * send twice. Pass `idempotencyKey` yourself to make YOUR retries safe too.
+     */
+    async send(params, options = {}) {
+        return this.http.call({ method: 'POST', path: '/emails', body: await withRenderedReact(params), ...options });
+    }
+    /** Same as `batch.send()`. */
+    sendBatch(emails, options = {}) {
+        return sendBatch(this.http, emails, options);
+    }
+    /** One message with its body and event timeline. */
+    get(id, options = {}) {
+        return this.http.call({ method: 'GET', path: `/emails/${seg(id)}`, ...options });
+    }
+    /** One page of the sent-mail log, newest first. */
+    list(params = {}, options = {}) {
+        return this.http.call({ method: 'GET', path: '/emails', query: { ...params }, ...options });
+    }
+    /** Every message matching `params`, page after page. */
+    async *iterate(params = {}, options = {}) {
+        const pageSize = params.pageSize ?? 100;
+        for (let page = 1;; page++) {
+            const res = unwrap(await this.list({ ...params, page, pageSize }, options));
+            yield* res.items;
+            if (res.items.length < pageSize || page * pageSize >= res.total)
+                return;
+        }
+    }
+    /** Counts per status. */
+    stats(options = {}) {
+        return this.http.call({ method: 'GET', path: '/emails/stats/summary', ...options });
+    }
+}
+export class Batch {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Up to 500 messages in one request (one recipient each). Every item is
+     * accepted or refused on its own; a refused item costs its siblings nothing.
+     */
+    send(emails, options = {}) {
+        return sendBatch(this.http, emails, options);
+    }
+}
+async function sendBatch(http, emails, options) {
+    const rendered = await Promise.all(emails.map((e) => withRenderedReact(e)));
+    return http.call({ method: 'POST', path: '/emails/batch', body: { emails: rendered }, ...options });
+}
+//# sourceMappingURL=emails.js.map