@sendora/sdk 1.1.0

package/dist/client.js

@@ -0,0 +1,69 @@
+import { DomainsResource } from "./domains.js";
+import { BroadcastsResource } from "./broadcasts.js";
+import { EmailResource } from "./email.js";
+import { MessagesResource } from "./messages.js";
+import { DEFAULT_MAX_RETRIES } from "./retry.js";
+import { StreamsResource } from "./streams.js";
+import { SuppressionsResource } from "./suppressions.js";
+import { TokensResource } from "./tokens.js";
+import { Transport } from "./transport.js";
+import { SDK_VERSION } from "./version.js";
+import { WebhooksResource } from "./webhooks.js";
+export const DEFAULT_BASE_URL = 'https://api.sendora.se';
+const DEFAULT_TIMEOUT_MS = 30_000;
+/**
+ * The client. One instance per server token; every resource hangs off it.
+ *
+ * @example
+ * import { Sendora } from '@sendora/sdk';
+ *
+ * const sendora = new Sendora({ token: process.env.SENDORA_API_TOKEN });
+ * const { messageId } = await sendora.email.send({
+ *   from: 'no-reply@example.se',
+ *   to: ['anna@example.com'],
+ *   subject: 'Välkommen',
+ *   text: 'Hej Anna!',
+ * });
+ */
+export class Sendora {
+    email;
+    broadcasts;
+    messages;
+    streams;
+    suppressions;
+    tokens;
+    webhooks;
+    domains;
+    constructor(options) {
+        if (options.token === undefined || options.token.trim() === '') {
+            throw new TypeError('Sendora needs a server API token; create one in the dashboard.');
+        }
+        const baseUrl = options.baseUrl ?? DEFAULT_BASE_URL;
+        new URL(baseUrl);
+        const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        if (!(timeoutMs > 0)) {
+            throw new TypeError('timeoutMs must be a positive number of milliseconds.');
+        }
+        const maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+        if (!Number.isInteger(maxRetries) || maxRetries < 0) {
+            throw new TypeError('maxRetries must be a whole number of zero or more.');
+        }
+        const transport = new Transport({
+            baseUrl,
+            token: options.token,
+            fetch: options.fetch ?? fetch,
+            timeoutMs,
+            maxRetries,
+            userAgent: `sendora-sdk/${SDK_VERSION}`,
+        });
+        this.email = new EmailResource(transport);
+        this.broadcasts = new BroadcastsResource(transport);
+        this.messages = new MessagesResource(transport);
+        this.streams = new StreamsResource(transport);
+        this.suppressions = new SuppressionsResource(transport);
+        this.tokens = new TokensResource(transport);
+        this.webhooks = new WebhooksResource(transport);
+        this.domains = new DomainsResource(transport);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,CAAC,MAAM,gBAAgB,GAAG,wBAAwB,CAAC;AACzD,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAmBlC;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,OAAO;IACT,KAAK,CAAgB;IACrB,UAAU,CAAqB;IAC/B,QAAQ,CAAmB;IAC3B,OAAO,CAAkB;IACzB,YAAY,CAAuB;IACnC,MAAM,CAAiB;IACvB,QAAQ,CAAmB;IAC3B,OAAO,CAAkB;IAElC,YAAY,OAAuB;QACjC,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC/D,MAAM,IAAI,SAAS,CAAC,gEAAgE,CAAC,CAAC;QACxF,CAAC;QACD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,gBAAgB,CAAC;QACpD,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QACjB,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,kBAAkB,CAAC;QAC1D,IAAI,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,SAAS,CAAC,sDAAsD,CAAC,CAAC;QAC9E,CAAC;QACD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,mBAAmB,CAAC;QAC7D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,SAAS,CAAC,oDAAoD,CAAC,CAAC;QAC5E,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC;YAC9B,OAAO;YACP,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK;YAC7B,SAAS;YACT,UAAU;YACV,SAAS,EAAE,eAAe,WAAW,EAAE;SACxC,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,GAAG,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC,UAAU,GAAG,IAAI,kBAAkB,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI,CAAC,QAAQ,GAAG,IAAI,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,GAAG,IAAI,eAAe,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,YAAY,GAAG,IAAI,oBAAoB,CAAC,SAAS,CAAC,CAAC;QACxD,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,QAAQ,GAAG,IAAI,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,GAAG,IAAI,eAAe,CAAC,SAAS,CAAC,CAAC;IAChD,CAAC;CACF"}

package/dist/domains.d.ts

@@ -0,0 +1,34 @@
+import type { Transport } from './transport.ts';
+import type { CreateDomainRequest, DomainList, RequestOptions, SendingDomain, VerifiedDomain } from './types.ts';
+/** The account's sending domains and the two DNS records each one needs. Any server's token manages them. */
+export declare class DomainsResource {
+    #private;
+    constructor(transport: Transport);
+    /**
+     * Adds a domain with its own DKIM key and answers the two records to
+     * create: a CNAME for the return path and a TXT record for the DKIM key.
+     * Mail may go out once both are seen. `domain_exists` carries the id of
+     * the domain the account already has as `existingId`.
+     *
+     * @example
+     * const domain = await sendora.domains.create({ domain: 'example.se' });
+     * console.log(domain.returnPath.host, domain.returnPath.value);
+     * console.log(domain.dkim.host, domain.dkim.value);
+     */
+    create(request: CreateDomainRequest, options?: RequestOptions): Promise<SendingDomain>;
+    /** Every sending domain of the account. */
+    list(options?: RequestOptions): Promise<DomainList>;
+    /** One domain by id, with the state of its records. */
+    get(domainId: string, options?: RequestOptions): Promise<SendingDomain>;
+    /**
+     * Looks both records up now and answers the domain as it stands plus
+     * what each lookup found: `ok`, `missing`, `mismatch` or `dns_error`.
+     *
+     * @example
+     * const { verified, check } = await sendora.domains.verify(domainId);
+     */
+    verify(domainId: string, options?: RequestOptions): Promise<VerifiedDomain>;
+    /** Removes the domain; mail from it is refused from then on and its DKIM key is gone. */
+    delete(domainId: string, options?: RequestOptions): Promise<void>;
+}
+//# sourceMappingURL=domains.d.ts.map

package/dist/domains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domains.d.ts","sourceRoot":"","sources":["../src/domains.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EACV,mBAAmB,EACnB,UAAU,EACV,cAAc,EACd,aAAa,EACb,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,6GAA6G;AAC7G,qBAAa,eAAe;;gBAGd,SAAS,EAAE,SAAS;IAIhC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;IAU1F,2CAA2C;IAC3C,IAAI,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IASvD,uDAAuD;IACvD,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;IAS3E;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;IAS/E,yFAAyF;IACzF,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CAQtE"}

package/dist/domains.js

@@ -0,0 +1,70 @@
+/** The account's sending domains and the two DNS records each one needs. Any server's token manages them. */
+export class DomainsResource {
+    #transport;
+    constructor(transport) {
+        this.#transport = transport;
+    }
+    /**
+     * Adds a domain with its own DKIM key and answers the two records to
+     * create: a CNAME for the return path and a TXT record for the DKIM key.
+     * Mail may go out once both are seen. `domain_exists` carries the id of
+     * the domain the account already has as `existingId`.
+     *
+     * @example
+     * const domain = await sendora.domains.create({ domain: 'example.se' });
+     * console.log(domain.returnPath.host, domain.returnPath.value);
+     * console.log(domain.dkim.host, domain.dkim.value);
+     */
+    create(request, options = {}) {
+        return this.#transport.request({
+            method: 'POST',
+            path: '/v1/domains',
+            body: request,
+            idempotent: false,
+            signal: options.signal,
+        });
+    }
+    /** Every sending domain of the account. */
+    list(options = {}) {
+        return this.#transport.request({
+            method: 'GET',
+            path: '/v1/domains',
+            idempotent: true,
+            signal: options.signal,
+        });
+    }
+    /** One domain by id, with the state of its records. */
+    get(domainId, options = {}) {
+        return this.#transport.request({
+            method: 'GET',
+            path: `/v1/domains/${encodeURIComponent(domainId)}`,
+            idempotent: true,
+            signal: options.signal,
+        });
+    }
+    /**
+     * Looks both records up now and answers the domain as it stands plus
+     * what each lookup found: `ok`, `missing`, `mismatch` or `dns_error`.
+     *
+     * @example
+     * const { verified, check } = await sendora.domains.verify(domainId);
+     */
+    verify(domainId, options = {}) {
+        return this.#transport.request({
+            method: 'POST',
+            path: `/v1/domains/${encodeURIComponent(domainId)}/verify`,
+            idempotent: true,
+            signal: options.signal,
+        });
+    }
+    /** Removes the domain; mail from it is refused from then on and its DKIM key is gone. */
+    delete(domainId, options = {}) {
+        return this.#transport.request({
+            method: 'DELETE',
+            path: `/v1/domains/${encodeURIComponent(domainId)}`,
+            idempotent: true,
+            signal: options.signal,
+        });
+    }
+}
+//# sourceMappingURL=domains.js.map

package/dist/domains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domains.js","sourceRoot":"","sources":["../src/domains.ts"],"names":[],"mappings":"AASA,6GAA6G;AAC7G,MAAM,OAAO,eAAe;IACjB,UAAU,CAAY;IAE/B,YAAY,SAAoB;QAC9B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,OAA4B,EAAE,UAA0B,EAAE;QAC/D,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAgB;YAC5C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,OAAO;YACb,UAAU,EAAE,KAAK;YACjB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;IAED,2CAA2C;IAC3C,IAAI,CAAC,UAA0B,EAAE;QAC/B,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAa;YACzC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,aAAa;YACnB,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;IAED,uDAAuD;IACvD,GAAG,CAAC,QAAgB,EAAE,UAA0B,EAAE;QAChD,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAgB;YAC5C,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,eAAe,kBAAkB,CAAC,QAAQ,CAAC,EAAE;YACnD,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,QAAgB,EAAE,UAA0B,EAAE;QACnD,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAiB;YAC7C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,eAAe,kBAAkB,CAAC,QAAQ,CAAC,SAAS;YAC1D,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;IAED,yFAAyF;IACzF,MAAM,CAAC,QAAgB,EAAE,UAA0B,EAAE;QACnD,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAY;YACxC,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,eAAe,kBAAkB,CAAC,QAAQ,CAAC,EAAE;YACnD,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/email.d.ts

@@ -0,0 +1,40 @@
+import type { Transport } from './transport.ts';
+import type { AcceptedEmail, Attachment, BatchResult, EncodedAttachment, SendEmailBody, SendEmailRequest, SendOptions } from './types.ts';
+/** Hands messages over for delivery, one at a time or up to 100 in a batch. */
+export declare class EmailResource {
+    #private;
+    constructor(transport: Transport);
+    /**
+     * Sends one message and answers at once with its id. Delivery, deferral,
+     * bounce and complaint arrive later as events on the message and as
+     * webhooks. Every send carries an idempotency key, yours or a random one,
+     * so the SDK's retries can never send twice.
+     *
+     * @example
+     * const { messageId } = await sendora.email.send({
+     *   from: { email: 'no-reply@example.se', name: 'Example AB' },
+     *   to: ['anna@example.com'],
+     *   subject: 'Din faktura för september',
+     *   text: 'Hej Anna, fakturan finns bifogad.',
+     *   attachments: [{ name: 'faktura.pdf', content: pdfBytes, contentType: 'application/pdf' }],
+     *   tag: 'invoice',
+     * });
+     */
+    send(request: SendEmailRequest, options?: SendOptions): Promise<AcceptedEmail>;
+    /**
+     * Sends up to 100 messages and answers one result per message, in order:
+     * accepted with its id, or refused with the same error a single send
+     * would give. The batch as a whole never fails halfway, so read
+     * `results[i].status`. A retry under the same key sends nothing twice:
+     * items accepted before come back with `replayed` set.
+     *
+     * @example
+     * const { results } = await sendora.email.sendBatch(messages, { idempotencyKey: 'invoices-2026-09' });
+     * const refused = results.filter((result) => result.status === 'error');
+     */
+    sendBatch(messages: SendEmailRequest[], options?: SendOptions): Promise<BatchResult>;
+}
+/** The body as the API takes it: attachment bytes become base64, everything else is passed through. */
+export declare function encodeSendRequest(request: SendEmailRequest): SendEmailBody;
+export declare function encodeAttachment(attachment: Attachment): EncodedAttachment;
+//# sourceMappingURL=email.d.ts.map

package/dist/email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../src/email.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,+EAA+E;AAC/E,qBAAa,aAAa;;gBAGZ,SAAS,EAAE,SAAS;IAIhC;;;;;;;;;;;;;;;OAeG;IACH,IAAI,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;IAWlF;;;;;;;;;;OAUG;IACH,SAAS,CAAC,QAAQ,EAAE,gBAAgB,EAAE,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;CAUzF;AAED,uGAAuG;AACvG,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,aAAa,CAM1E;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,iBAAiB,CAG1E"}

package/dist/email.js

@@ -0,0 +1,68 @@
+import { toBase64 } from "./base64.js";
+/** Hands messages over for delivery, one at a time or up to 100 in a batch. */
+export class EmailResource {
+    #transport;
+    constructor(transport) {
+        this.#transport = transport;
+    }
+    /**
+     * Sends one message and answers at once with its id. Delivery, deferral,
+     * bounce and complaint arrive later as events on the message and as
+     * webhooks. Every send carries an idempotency key, yours or a random one,
+     * so the SDK's retries can never send twice.
+     *
+     * @example
+     * const { messageId } = await sendora.email.send({
+     *   from: { email: 'no-reply@example.se', name: 'Example AB' },
+     *   to: ['anna@example.com'],
+     *   subject: 'Din faktura för september',
+     *   text: 'Hej Anna, fakturan finns bifogad.',
+     *   attachments: [{ name: 'faktura.pdf', content: pdfBytes, contentType: 'application/pdf' }],
+     *   tag: 'invoice',
+     * });
+     */
+    send(request, options = {}) {
+        return this.#transport.request({
+            method: 'POST',
+            path: '/v1/email',
+            body: encodeSendRequest(request),
+            headers: { 'idempotency-key': options.idempotencyKey ?? crypto.randomUUID() },
+            idempotent: true,
+            signal: options.signal,
+        });
+    }
+    /**
+     * Sends up to 100 messages and answers one result per message, in order:
+     * accepted with its id, or refused with the same error a single send
+     * would give. The batch as a whole never fails halfway, so read
+     * `results[i].status`. A retry under the same key sends nothing twice:
+     * items accepted before come back with `replayed` set.
+     *
+     * @example
+     * const { results } = await sendora.email.sendBatch(messages, { idempotencyKey: 'invoices-2026-09' });
+     * const refused = results.filter((result) => result.status === 'error');
+     */
+    sendBatch(messages, options = {}) {
+        return this.#transport.request({
+            method: 'POST',
+            path: '/v1/email/batch',
+            body: messages.map(encodeSendRequest),
+            headers: { 'idempotency-key': options.idempotencyKey ?? crypto.randomUUID() },
+            idempotent: true,
+            signal: options.signal,
+        });
+    }
+}
+/** The body as the API takes it: attachment bytes become base64, everything else is passed through. */
+export function encodeSendRequest(request) {
+    const { attachments, ...fields } = request;
+    if (attachments === undefined) {
+        return fields;
+    }
+    return { ...fields, attachments: attachments.map(encodeAttachment) };
+}
+export function encodeAttachment(attachment) {
+    const { content, ...fields } = attachment;
+    return { ...fields, content: typeof content === 'string' ? content : toBase64(content) };
+}
+//# sourceMappingURL=email.js.map

package/dist/email.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.js","sourceRoot":"","sources":["../src/email.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAYvC,+EAA+E;AAC/E,MAAM,OAAO,aAAa;IACf,UAAU,CAAY;IAE/B,YAAY,SAAoB;QAC9B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,IAAI,CAAC,OAAyB,EAAE,UAAuB,EAAE;QACvD,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAgB;YAC5C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,iBAAiB,CAAC,OAAO,CAAC;YAChC,OAAO,EAAE,EAAE,iBAAiB,EAAE,OAAO,CAAC,cAAc,IAAI,MAAM,CAAC,UAAU,EAAE,EAAE;YAC7E,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,SAAS,CAAC,QAA4B,EAAE,UAAuB,EAAE;QAC/D,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAc;YAC1C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,iBAAiB;YACvB,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,iBAAiB,CAAC;YACrC,OAAO,EAAE,EAAE,iBAAiB,EAAE,OAAO,CAAC,cAAc,IAAI,MAAM,CAAC,UAAU,EAAE,EAAE;YAC7E,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;CACF;AAED,uGAAuG;AACvG,MAAM,UAAU,iBAAiB,CAAC,OAAyB;IACzD,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3C,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,UAAsB;IACrD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,UAAU,CAAC;IAC1C,OAAO,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;AAC3F,CAAC"}

package/dist/error.d.ts

@@ -0,0 +1,67 @@
+import type { LimitScope, SuppressedRecipient, ValidationIssue } from './types.ts';
+/** Every code the API answers, the three the SDK raises when it never got a proper answer, and the two of the webhook verifier. */
+export type SendoraErrorCode = 'invalid_request' | 'unauthorized' | 'payment_required' | 'tenant_paused' | 'tenant_not_active' | 'spam_complaint_locked' | 'unsubscribe_locked' | 'not_found' | 'domain_exists' | 'webhook_exists' | 'stream_exists' | 'inbound_stream_exists' | 'default_stream' | 'last_token' | 'request_too_large' | 'from_domain_not_verified' | 'stream_not_found' | 'stream_archived' | 'stream_paused' | 'stream_not_sendable' | 'stream_not_broadcast' | 'broadcast_not_enabled' | 'broadcast_not_open' | 'substitution_missing' | 'unsubscribe_placeholder_missing' | 'list_unsubscribe_reserved' | 'recipient_suppressed' | 'idempotency_key_mismatch' | 'idempotency_key_required' | 'rate_limited' | 'monthly_cap_reached' | 'sending_disabled' | 'connection_failed' | 'timeout' | 'unexpected_response' | 'invalid_signature' | 'stale_signature';
+export interface SendoraErrorFields {
+    code: SendoraErrorCode;
+    message: string;
+    status: number | null;
+    retryAfter?: number | null;
+    scope?: LimitScope | null;
+    limit?: number | null;
+    cap?: number | null;
+    used?: number | null;
+    resetsAt?: string | null;
+    issues?: ValidationIssue[];
+    suppressed?: SuppressedRecipient[];
+    streamId?: string | null;
+    existingId?: string | null;
+    cause?: unknown;
+}
+/**
+ * What every failed call throws. Narrow on `code`; the other fields are
+ * filled where the API gives them and null or empty otherwise. Neither the
+ * token nor the request body is ever part of it.
+ *
+ * @example
+ * try {
+ *   await sendora.email.send(message);
+ * } catch (error) {
+ *   if (error instanceof SendoraError && error.code === 'recipient_suppressed') {
+ *     console.log(error.suppressed.map((entry) => entry.address));
+ *   } else {
+ *     throw error;
+ *   }
+ * }
+ */
+export declare class SendoraError extends Error {
+    readonly name = "SendoraError";
+    readonly code: SendoraErrorCode;
+    /** The HTTP status, or null when no answer arrived. */
+    readonly status: number | null;
+    /** Seconds to wait before trying again, when the API said so. */
+    readonly retryAfter: number | null;
+    /** Whose limit or cap it is, on rate_limited and monthly_cap_reached. */
+    readonly scope: LimitScope | null;
+    /** Emails per minute allowed for that scope, on rate_limited. */
+    readonly limit: number | null;
+    /** The monthly cap and what was used of it, on monthly_cap_reached. */
+    readonly cap: number | null;
+    readonly used: number | null;
+    /** When the month counter resets, on monthly_cap_reached. */
+    readonly resetsAt: string | null;
+    /** One entry per invalid field, on invalid_request. */
+    readonly issues: ValidationIssue[];
+    /** The recipients the server refused, on recipient_suppressed. */
+    readonly suppressed: SuppressedRecipient[];
+    /** The stream whose suppression list refused the send, on recipient_suppressed. */
+    readonly streamId: string | null;
+    /** The id of the domain, webhook or stream that already exists, on domain_exists, webhook_exists and stream_exists. */
+    readonly existingId: string | null;
+    constructor(fields: SendoraErrorFields);
+    /** True when waiting and calling again could succeed: a rate limit, sending paused for everyone, a lost connection, a timeout, or a server-side failure. */
+    get retryable(): boolean;
+    toJSON(): Record<string, unknown>;
+}
+/** The error a non-2xx answer amounts to; an answer without a known code is `unexpected_response`. */
+export declare function errorFromAnswer(status: number, body: unknown, retryAfterHeader: string | null): SendoraError;
+//# sourceMappingURL=error.d.ts.map

package/dist/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEnF,mIAAmI;AACnI,MAAM,MAAM,gBAAgB,GACxB,iBAAiB,GACjB,cAAc,GACd,kBAAkB,GAClB,eAAe,GACf,mBAAmB,GACnB,uBAAuB,GACvB,oBAAoB,GACpB,WAAW,GACX,eAAe,GACf,gBAAgB,GAChB,eAAe,GACf,uBAAuB,GACvB,gBAAgB,GAChB,YAAY,GACZ,mBAAmB,GACnB,0BAA0B,GAC1B,kBAAkB,GAClB,iBAAiB,GACjB,eAAe,GACf,qBAAqB,GACrB,sBAAsB,GACtB,uBAAuB,GACvB,oBAAoB,GACpB,sBAAsB,GACtB,iCAAiC,GACjC,2BAA2B,GAC3B,sBAAsB,GACtB,0BAA0B,GAC1B,0BAA0B,GAC1B,cAAc,GACd,qBAAqB,GACrB,kBAAkB,GAClB,mBAAmB,GACnB,SAAS,GACT,qBAAqB,GACrB,mBAAmB,GACnB,iBAAiB,CAAC;AAqCtB,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAkB,IAAI,kBAAkB;IACxC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAClC,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,uEAAuE;IACvE,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC;IACnC,kEAAkE;IAClE,QAAQ,CAAC,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAC3C,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,uHAAuH;IACvH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEvB,MAAM,EAAE,kBAAkB;IAgBtC,4JAA4J;IAC5J,IAAI,SAAS,IAAI,OAAO,CAQvB;IAED,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAkBlC;AAED,sGAAsG;AACtG,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAC9B,YAAY,CA0Bd"}

package/dist/error.js

@@ -0,0 +1,173 @@
+const apiCodes = new Set([
+    'invalid_request',
+    'unauthorized',
+    'payment_required',
+    'tenant_paused',
+    'tenant_not_active',
+    'spam_complaint_locked',
+    'unsubscribe_locked',
+    'not_found',
+    'domain_exists',
+    'webhook_exists',
+    'stream_exists',
+    'inbound_stream_exists',
+    'default_stream',
+    'last_token',
+    'request_too_large',
+    'from_domain_not_verified',
+    'stream_not_found',
+    'stream_archived',
+    'stream_paused',
+    'stream_not_sendable',
+    'stream_not_broadcast',
+    'broadcast_not_enabled',
+    'broadcast_not_open',
+    'substitution_missing',
+    'unsubscribe_placeholder_missing',
+    'list_unsubscribe_reserved',
+    'recipient_suppressed',
+    'idempotency_key_mismatch',
+    'idempotency_key_required',
+    'rate_limited',
+    'monthly_cap_reached',
+    'sending_disabled',
+]);
+/**
+ * What every failed call throws. Narrow on `code`; the other fields are
+ * filled where the API gives them and null or empty otherwise. Neither the
+ * token nor the request body is ever part of it.
+ *
+ * @example
+ * try {
+ *   await sendora.email.send(message);
+ * } catch (error) {
+ *   if (error instanceof SendoraError && error.code === 'recipient_suppressed') {
+ *     console.log(error.suppressed.map((entry) => entry.address));
+ *   } else {
+ *     throw error;
+ *   }
+ * }
+ */
+export class SendoraError extends Error {
+    name = 'SendoraError';
+    code;
+    /** The HTTP status, or null when no answer arrived. */
+    status;
+    /** Seconds to wait before trying again, when the API said so. */
+    retryAfter;
+    /** Whose limit or cap it is, on rate_limited and monthly_cap_reached. */
+    scope;
+    /** Emails per minute allowed for that scope, on rate_limited. */
+    limit;
+    /** The monthly cap and what was used of it, on monthly_cap_reached. */
+    cap;
+    used;
+    /** When the month counter resets, on monthly_cap_reached. */
+    resetsAt;
+    /** One entry per invalid field, on invalid_request. */
+    issues;
+    /** The recipients the server refused, on recipient_suppressed. */
+    suppressed;
+    /** The stream whose suppression list refused the send, on recipient_suppressed. */
+    streamId;
+    /** The id of the domain, webhook or stream that already exists, on domain_exists, webhook_exists and stream_exists. */
+    existingId;
+    constructor(fields) {
+        super(fields.message, { cause: fields.cause });
+        this.code = fields.code;
+        this.status = fields.status;
+        this.retryAfter = fields.retryAfter ?? null;
+        this.scope = fields.scope ?? null;
+        this.limit = fields.limit ?? null;
+        this.cap = fields.cap ?? null;
+        this.used = fields.used ?? null;
+        this.resetsAt = fields.resetsAt ?? null;
+        this.issues = fields.issues ?? [];
+        this.suppressed = fields.suppressed ?? [];
+        this.streamId = fields.streamId ?? null;
+        this.existingId = fields.existingId ?? null;
+    }
+    /** True when waiting and calling again could succeed: a rate limit, sending paused for everyone, a lost connection, a timeout, or a server-side failure. */
+    get retryable() {
+        return (this.code === 'rate_limited' ||
+            this.code === 'sending_disabled' ||
+            this.code === 'connection_failed' ||
+            this.code === 'timeout' ||
+            (this.status !== null && this.status >= 500));
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            status: this.status,
+            message: this.message,
+            retryAfter: this.retryAfter,
+            scope: this.scope,
+            limit: this.limit,
+            cap: this.cap,
+            used: this.used,
+            resetsAt: this.resetsAt,
+            issues: this.issues,
+            suppressed: this.suppressed,
+            streamId: this.streamId,
+            existingId: this.existingId,
+        };
+    }
+}
+/** The error a non-2xx answer amounts to; an answer without a known code is `unexpected_response`. */
+export function errorFromAnswer(status, body, retryAfterHeader) {
+    const answer = isRecord(body) ? body : {};
+    const code = knownCode(answer.error);
+    const issues = Array.isArray(answer.issues) ? answer.issues.filter(isIssue) : [];
+    const message = typeof answer.message === 'string'
+        ? answer.message
+        : code === 'invalid_request'
+            ? `The request is invalid: ${issues.map((issue) => `${issue.path}: ${issue.message}`).join('; ')}`
+            : `The API answered ${String(status)} without an error body.`;
+    return new SendoraError({
+        code,
+        message,
+        status,
+        retryAfter: integerOf(answer.retryAfter) ?? integerOf(retryAfterHeader),
+        scope: answer.scope === 'tenant' || answer.scope === 'server' ? answer.scope : null,
+        limit: integerOf(answer.limit),
+        cap: integerOf(answer.cap),
+        used: integerOf(answer.used),
+        resetsAt: typeof answer.resetsAt === 'string' ? answer.resetsAt : null,
+        issues,
+        suppressed: Array.isArray(answer.suppressed) ? answer.suppressed.filter(isSuppressed) : [],
+        streamId: code === 'recipient_suppressed' ? stringOf(answer.streamId) : null,
+        existingId: stringOf(answer.domainId) ?? stringOf(answer.webhookId) ?? stringOf(answer.streamId),
+    });
+}
+function stringOf(value) {
+    return typeof value === 'string' ? value : null;
+}
+function knownCode(value) {
+    return typeof value === 'string' && apiCodes.has(value)
+        ? value
+        : 'unexpected_response';
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isIssue(value) {
+    return isRecord(value) && typeof value.path === 'string' && typeof value.message === 'string';
+}
+function isSuppressed(value) {
+    return (isRecord(value) &&
+        typeof value.address === 'string' &&
+        (value.reason === 'hard_bounce' ||
+            value.reason === 'spam_complaint' ||
+            value.reason === 'manual'));
+}
+function integerOf(value) {
+    if (typeof value === 'number' && Number.isInteger(value)) {
+        return value;
+    }
+    if (typeof value === 'string' && /^\d+$/.test(value)) {
+        return Number(value);
+    }
+    return null;
+}
+//# sourceMappingURL=error.js.map

package/dist/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AA0CA,MAAM,QAAQ,GAAwB,IAAI,GAAG,CAAmB;IAC9D,iBAAiB;IACjB,cAAc;IACd,kBAAkB;IAClB,eAAe;IACf,mBAAmB;IACnB,uBAAuB;IACvB,oBAAoB;IACpB,WAAW;IACX,eAAe;IACf,gBAAgB;IAChB,eAAe;IACf,uBAAuB;IACvB,gBAAgB;IAChB,YAAY;IACZ,mBAAmB;IACnB,0BAA0B;IAC1B,kBAAkB;IAClB,iBAAiB;IACjB,eAAe;IACf,qBAAqB;IACrB,sBAAsB;IACtB,uBAAuB;IACvB,oBAAoB;IACpB,sBAAsB;IACtB,iCAAiC;IACjC,2BAA2B;IAC3B,sBAAsB;IACtB,0BAA0B;IAC1B,0BAA0B;IAC1B,cAAc;IACd,qBAAqB;IACrB,kBAAkB;CACnB,CAAC,CAAC;AAmBH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACnB,IAAI,GAAG,cAAc,CAAC;IAC/B,IAAI,CAAmB;IAChC,uDAAuD;IAC9C,MAAM,CAAgB;IAC/B,iEAAiE;IACxD,UAAU,CAAgB;IACnC,yEAAyE;IAChE,KAAK,CAAoB;IAClC,iEAAiE;IACxD,KAAK,CAAgB;IAC9B,uEAAuE;IAC9D,GAAG,CAAgB;IACnB,IAAI,CAAgB;IAC7B,6DAA6D;IACpD,QAAQ,CAAgB;IACjC,uDAAuD;IAC9C,MAAM,CAAoB;IACnC,kEAAkE;IACzD,UAAU,CAAwB;IAC3C,mFAAmF;IAC1E,QAAQ,CAAgB;IACjC,uHAAuH;IAC9G,UAAU,CAAgB;IAEnC,YAAY,MAA0B;QACpC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC;QAC5C,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC;QAClC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC;QAClC,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC;QACxC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;QAC1C,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC;QACxC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC;IAC9C,CAAC;IAED,4JAA4J;IAC5J,IAAI,SAAS;QACX,OAAO,CACL,IAAI,CAAC,IAAI,KAAK,cAAc;YAC5B,IAAI,CAAC,IAAI,KAAK,kBAAkB;YAChC,IAAI,CAAC,IAAI,KAAK,mBAAmB;YACjC,IAAI,CAAC,IAAI,KAAK,SAAS;YACvB,CAAC,IAAI,CAAC,MAAM,KAAK,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,CAC7C,CAAC;IACJ,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;IACJ,CAAC;CACF;AAED,sGAAsG;AACtG,MAAM,UAAU,eAAe,CAC7B,MAAc,EACd,IAAa,EACb,gBAA+B;IAE/B,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1C,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjF,MAAM,OAAO,GACX,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ;QAChC,CAAC,CAAC,MAAM,CAAC,OAAO;QAChB,CAAC,CAAC,IAAI,KAAK,iBAAiB;YAC1B,CAAC,CAAC,2BAA2B,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAClG,CAAC,CAAC,oBAAoB,MAAM,CAAC,MAAM,CAAC,yBAAyB,CAAC;IACpE,OAAO,IAAI,YAAY,CAAC;QACtB,IAAI;QACJ,OAAO;QACP,MAAM;QACN,UAAU,EAAE,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,SAAS,CAAC,gBAAgB,CAAC;QACvE,KAAK,EAAE,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;QACnF,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC;QAC9B,GAAG,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC;QAC1B,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC;QAC5B,QAAQ,EAAE,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;QACtE,MAAM;QACN,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE;QAC1F,QAAQ,EAAE,IAAI,KAAK,sBAAsB,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI;QAC5E,UAAU,EACR,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC;KACvF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC;QACrD,CAAC,CAAE,KAA0B;QAC7B,CAAC,CAAC,qBAAqB,CAAC;AAC5B,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC;AAChG,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;QACjC,CAAC,KAAK,CAAC,MAAM,KAAK,aAAa;YAC7B,KAAK,CAAC,MAAM,KAAK,gBAAgB;YACjC,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAC7B,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export { DEFAULT_BASE_URL, Sendora } from './client.ts';
+export type { SendoraOptions } from './client.ts';
+export type { BroadcastsResource } from './broadcasts.ts';
+export type { DomainsResource } from './domains.ts';
+export type { EmailResource } from './email.ts';
+export { SendoraError } from './error.ts';
+export type { SendoraErrorCode } from './error.ts';
+export type { MessagesResource } from './messages.ts';
+export type { StreamsResource } from './streams.ts';
+export type { SuppressionsResource } from './suppressions.ts';
+export type { TokensResource } from './tokens.ts';
+export type * from './types.ts';
+export { SDK_VERSION } from './version.ts';
+export { verifyWebhook } from './webhook-verify.ts';
+export type { VerifyWebhookInput } from './webhook-verify.ts';
+export type { WebhooksResource } from './webhooks.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,mBAAmB,YAAY,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { DEFAULT_BASE_URL, Sendora } from "./client.js";
+export { SendoraError } from "./error.js";
+export { SDK_VERSION } from "./version.js";
+export { verifyWebhook } from "./webhook-verify.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAKxD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO1C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/messages.d.ts

@@ -0,0 +1,37 @@
+import type { Transport } from './transport.ts';
+import type { Message, MessageDetail, MessagePage, MessageSearch, MessageSearchBody, RequestOptions } from './types.ts';
+/** The message log of the token's server and each message's timeline. */
+export declare class MessagesResource {
+    #private;
+    constructor(transport: Transport);
+    /**
+     * One message as the log holds it: its recipients with their state, its
+     * attachments described, and every event on its timeline. Bodies are
+     * never returned.
+     *
+     * @example
+     * const message = await sendora.messages.get(messageId);
+     * const delivered = message.recipients.every((recipient) => recipient.status === 'delivered');
+     */
+    get(messageId: string, options?: RequestOptions): Promise<MessageDetail>;
+    /**
+     * One page of the log, newest first. Every filter is optional; pass the
+     * page's `next` as `after` for the following page, or use `searchAll`.
+     *
+     * @example
+     * const page = await sendora.messages.search({ tag: 'invoice', status: 'bounced', limit: 20 });
+     */
+    search(search?: MessageSearch, options?: RequestOptions): Promise<MessagePage>;
+    /**
+     * Every message the filters match, page by page, for `for await`.
+     *
+     * @example
+     * for await (const message of sendora.messages.searchAll({ recipient: 'anna@example.com' })) {
+     *   console.log(message.messageId, message.subject);
+     * }
+     */
+    searchAll(search?: MessageSearch, options?: RequestOptions): AsyncIterable<Message>;
+}
+/** The body as the API takes it: times as ISO 8601 strings. */
+export declare function encodeSearch(search: MessageSearch): MessageSearchBody;
+//# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EACV,OAAO,EACP,aAAa,EACb,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,yEAAyE;AACzE,qBAAa,gBAAgB;;gBAGf,SAAS,EAAE,SAAS;IAIhC;;;;;;;;OAQG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;IAS5E;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,GAAE,aAAkB,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IAUtF;;;;;;;OAOG;IACH,SAAS,CAAC,MAAM,GAAE,aAAkB,EAAE,OAAO,GAAE,cAAmB,GAAG,aAAa,CAAC,OAAO,CAAC;CAQ5F;AAED,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,iBAAiB,CAUrE"}