@sendora/sdk 1.1.0

package/dist/messages.js

@@ -0,0 +1,68 @@
+import { paginate } from "./pagination.js";
+/** The message log of the token's server and each message's timeline. */
+export class MessagesResource {
+    #transport;
+    constructor(transport) {
+        this.#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, options = {}) {
+        return this.#transport.request({
+            method: 'GET',
+            path: `/v1/messages/${encodeURIComponent(messageId)}`,
+            idempotent: true,
+            signal: options.signal,
+        });
+    }
+    /**
+     * 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 = {}, options = {}) {
+        return this.#transport.request({
+            method: 'POST',
+            path: '/v1/messages/search',
+            body: encodeSearch(search),
+            idempotent: true,
+            signal: options.signal,
+        });
+    }
+    /**
+     * 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 = {}, options = {}) {
+        return paginate((after) => this.search({ ...search, after }, options), (page) => page.messages, (page) => page.next, search.after);
+    }
+}
+/** The body as the API takes it: times as ISO 8601 strings. */
+export function encodeSearch(search) {
+    const { from, to, ...fields } = search;
+    const body = { ...fields };
+    if (from !== undefined) {
+        body.from = isoOf(from);
+    }
+    if (to !== undefined) {
+        body.to = isoOf(to);
+    }
+    return body;
+}
+function isoOf(value) {
+    return typeof value === 'string' ? value : value.toISOString();
+}
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAW3C,yEAAyE;AACzE,MAAM,OAAO,gBAAgB;IAClB,UAAU,CAAY;IAE/B,YAAY,SAAoB;QAC9B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED;;;;;;;;OAQG;IACH,GAAG,CAAC,SAAiB,EAAE,UAA0B,EAAE;QACjD,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAgB;YAC5C,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,EAAE;YACrD,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,SAAwB,EAAE,EAAE,UAA0B,EAAE;QAC7D,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAc;YAC1C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,qBAAqB;YAC3B,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC;YAC1B,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,SAAS,CAAC,SAAwB,EAAE,EAAE,UAA0B,EAAE;QAChE,OAAO,QAAQ,CACb,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,EACrD,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,EACvB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EACnB,MAAM,CAAC,KAAK,CACb,CAAC;IACJ,CAAC;CACF;AAED,+DAA+D;AAC/D,MAAM,UAAU,YAAY,CAAC,MAAqB;IAChD,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC;IACvC,MAAM,IAAI,GAAsB,EAAE,GAAG,MAAM,EAAE,CAAC;IAC9C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACrB,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,KAAK,CAAC,KAAoB;IACjC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;AACjE,CAAC"}

package/dist/pagination.d.ts

@@ -0,0 +1,3 @@
+/** Walks a cursor-paged list: fetches a page, yields its items, follows `next` until it is null. */
+export declare function paginate<Page, Item>(fetchPage: (after: string | undefined) => Promise<Page>, itemsOf: (page: Page) => Item[], nextOf: (page: Page) => string | null, start: string | undefined): AsyncGenerator<Item, void, undefined>;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../src/pagination.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,wBAAuB,QAAQ,CAAC,IAAI,EAAE,IAAI,EACxC,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,EACvD,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,EAAE,EAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,GAAG,IAAI,EACrC,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAWvC"}

package/dist/pagination.js

@@ -0,0 +1,14 @@
+/** Walks a cursor-paged list: fetches a page, yields its items, follows `next` until it is null. */
+export async function* paginate(fetchPage, itemsOf, nextOf, start) {
+    let after = start;
+    for (;;) {
+        const page = await fetchPage(after);
+        yield* itemsOf(page);
+        const next = nextOf(page);
+        if (next === null) {
+            return;
+        }
+        after = next;
+    }
+}
+//# sourceMappingURL=pagination.js.map

package/dist/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../src/pagination.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,QAAQ,CAC7B,SAAuD,EACvD,OAA+B,EAC/B,MAAqC,EACrC,KAAyB;IAEzB,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,SAAS,CAAC;QACR,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;QACpC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACrB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,KAAK,GAAG,IAAI,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/retry.d.ts

@@ -0,0 +1,6 @@
+export declare const DEFAULT_MAX_RETRIES = 2;
+/** The most a call waits across all its retries; a longer Retry-After is handed to the caller instead. */
+export declare const MAX_TOTAL_WAIT_MS = 5000;
+/** Retry-After in full when the API gave one; otherwise 500 ms doubling to 2 s, jittered between half and one and a half. */
+export declare function retryDelayMs(attempt: number, retryAfterSeconds: number | null, random: () => number): number;
+//# sourceMappingURL=retry.d.ts.map

package/dist/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,0GAA0G;AAC1G,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAKtC,6HAA6H;AAC7H,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,MAAM,GAAG,IAAI,EAChC,MAAM,EAAE,MAAM,MAAM,GACnB,MAAM,CAMR"}

package/dist/retry.js

@@ -0,0 +1,14 @@
+export const DEFAULT_MAX_RETRIES = 2;
+/** The most a call waits across all its retries; a longer Retry-After is handed to the caller instead. */
+export const MAX_TOTAL_WAIT_MS = 5000;
+const BASE_DELAY_MS = 500;
+const MAX_BACKOFF_MS = 2000;
+/** Retry-After in full when the API gave one; otherwise 500 ms doubling to 2 s, jittered between half and one and a half. */
+export function retryDelayMs(attempt, retryAfterSeconds, random) {
+    if (retryAfterSeconds !== null) {
+        return retryAfterSeconds * 1000;
+    }
+    const backoff = Math.min(BASE_DELAY_MS * 2 ** attempt, MAX_BACKOFF_MS);
+    return Math.round(backoff * (0.5 + random()));
+}
+//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAErC,0GAA0G;AAC1G,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAEtC,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,MAAM,cAAc,GAAG,IAAI,CAAC;AAE5B,6HAA6H;AAC7H,MAAM,UAAU,YAAY,CAC1B,OAAe,EACf,iBAAgC,EAChC,MAAoB;IAEpB,IAAI,iBAAiB,KAAK,IAAI,EAAE,CAAC;QAC/B,OAAO,iBAAiB,GAAG,IAAI,CAAC;IAClC,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,GAAG,CAAC,IAAI,OAAO,EAAE,cAAc,CAAC,CAAC;IACvE,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,GAAG,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;AAChD,CAAC"}

package/dist/streams.d.ts

@@ -0,0 +1,45 @@
+import type { Transport } from './transport.ts';
+import type { CreateStreamRequest, RequestOptions, Stream, StreamList, UpdateStreamRequest } from './types.ts';
+/** The streams of the token's own server: the default transactional one, and any the account added. */
+export declare class StreamsResource {
+    #private;
+    constructor(transport: Transport);
+    /**
+     * Adds a stream to the server. A transactional stream is available to
+     * every account; a broadcast stream needs broadcast enabled for the
+     * account (`broadcast_not_enabled`); an inbound stream receives mail at
+     * its own address, one live per server (`inbound_stream_exists`), on an
+     * active account (`tenant_not_active`). A taken name answers
+     * `stream_exists` with `existingId`.
+     *
+     * @example
+     * const stream = await sendora.streams.create({ kind: 'transactional', name: 'Aviseringar' });
+     * await sendora.email.send({ ...message, streamId: stream.streamId });
+     */
+    create(request: CreateStreamRequest, options?: RequestOptions): Promise<Stream>;
+    /** Every stream of the server, archived ones included, oldest first. */
+    list(options?: RequestOptions): Promise<StreamList>;
+    /** One stream by id. */
+    get(streamId: string, options?: RequestOptions): Promise<Stream>;
+    /**
+     * Renames a stream, or sets how long an inbound stream keeps received
+     * content; the id stays. A name another stream of the server carries
+     * answers `stream_exists`.
+     *
+     * @example
+     * await sendora.streams.update(streamId, { name: 'Driftinformation' });
+     * await sendora.streams.update(inboundStreamId, { contentRetentionDays: 7 });
+     */
+    update(streamId: string, request: UpdateStreamRequest, options?: RequestOptions): Promise<Stream>;
+    /**
+     * The stream takes no new messages from now on; what it already holds
+     * is still delivered. Archiving again changes nothing. The default
+     * stream cannot be archived (`default_stream`).
+     *
+     * @example
+     * const archived = await sendora.streams.archive(streamId);
+     * console.log(archived.archivedAt);
+     */
+    archive(streamId: string, options?: RequestOptions): Promise<Stream>;
+}
+//# sourceMappingURL=streams.d.ts.map

package/dist/streams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streams.d.ts","sourceRoot":"","sources":["../src/streams.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACd,MAAM,EACN,UAAU,EACV,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,uGAAuG;AACvG,qBAAa,eAAe;;gBAGd,SAAS,EAAE,SAAS;IAIhC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAUnF,wEAAwE;IACxE,IAAI,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IASvD,wBAAwB;IACxB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IASpE;;;;;;;;OAQG;IACH,MAAM,CACJ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,mBAAmB,EAC5B,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,MAAM,CAAC;IAUlB;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;CAQzE"}

package/dist/streams.js

@@ -0,0 +1,82 @@
+/** The streams of the token's own server: the default transactional one, and any the account added. */
+export class StreamsResource {
+    #transport;
+    constructor(transport) {
+        this.#transport = transport;
+    }
+    /**
+     * Adds a stream to the server. A transactional stream is available to
+     * every account; a broadcast stream needs broadcast enabled for the
+     * account (`broadcast_not_enabled`); an inbound stream receives mail at
+     * its own address, one live per server (`inbound_stream_exists`), on an
+     * active account (`tenant_not_active`). A taken name answers
+     * `stream_exists` with `existingId`.
+     *
+     * @example
+     * const stream = await sendora.streams.create({ kind: 'transactional', name: 'Aviseringar' });
+     * await sendora.email.send({ ...message, streamId: stream.streamId });
+     */
+    create(request, options = {}) {
+        return this.#transport.request({
+            method: 'POST',
+            path: '/v1/streams',
+            body: request,
+            idempotent: false,
+            signal: options.signal,
+        });
+    }
+    /** Every stream of the server, archived ones included, oldest first. */
+    list(options = {}) {
+        return this.#transport.request({
+            method: 'GET',
+            path: '/v1/streams',
+            idempotent: true,
+            signal: options.signal,
+        });
+    }
+    /** One stream by id. */
+    get(streamId, options = {}) {
+        return this.#transport.request({
+            method: 'GET',
+            path: `/v1/streams/${encodeURIComponent(streamId)}`,
+            idempotent: true,
+            signal: options.signal,
+        });
+    }
+    /**
+     * Renames a stream, or sets how long an inbound stream keeps received
+     * content; the id stays. A name another stream of the server carries
+     * answers `stream_exists`.
+     *
+     * @example
+     * await sendora.streams.update(streamId, { name: 'Driftinformation' });
+     * await sendora.streams.update(inboundStreamId, { contentRetentionDays: 7 });
+     */
+    update(streamId, request, options = {}) {
+        return this.#transport.request({
+            method: 'PATCH',
+            path: `/v1/streams/${encodeURIComponent(streamId)}`,
+            body: request,
+            idempotent: true,
+            signal: options.signal,
+        });
+    }
+    /**
+     * The stream takes no new messages from now on; what it already holds
+     * is still delivered. Archiving again changes nothing. The default
+     * stream cannot be archived (`default_stream`).
+     *
+     * @example
+     * const archived = await sendora.streams.archive(streamId);
+     * console.log(archived.archivedAt);
+     */
+    archive(streamId, options = {}) {
+        return this.#transport.request({
+            method: 'POST',
+            path: `/v1/streams/${encodeURIComponent(streamId)}/archive`,
+            idempotent: true,
+            signal: options.signal,
+        });
+    }
+}
+//# sourceMappingURL=streams.js.map

package/dist/streams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streams.js","sourceRoot":"","sources":["../src/streams.ts"],"names":[],"mappings":"AASA,uGAAuG;AACvG,MAAM,OAAO,eAAe;IACjB,UAAU,CAAY;IAE/B,YAAY,SAAoB;QAC9B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,OAA4B,EAAE,UAA0B,EAAE;QAC/D,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAS;YACrC,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,wEAAwE;IACxE,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,wBAAwB;IACxB,GAAG,CAAC,QAAgB,EAAE,UAA0B,EAAE;QAChD,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAS;YACrC,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;;;;;;;;OAQG;IACH,MAAM,CACJ,QAAgB,EAChB,OAA4B,EAC5B,UAA0B,EAAE;QAE5B,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAS;YACrC,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,eAAe,kBAAkB,CAAC,QAAQ,CAAC,EAAE;YACnD,IAAI,EAAE,OAAO;YACb,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAgB,EAAE,UAA0B,EAAE;QACpD,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAS;YACrC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,eAAe,kBAAkB,CAAC,QAAQ,CAAC,UAAU;YAC3D,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/suppressions.d.ts

@@ -0,0 +1,37 @@
+import type { Transport } from './transport.ts';
+import type { DeleteSuppressionRequest, RequestOptions, Suppression, SuppressionPage, SuppressionQuery } from './types.ts';
+/** The addresses the token's server no longer sends to, one list per stream. */
+export declare class SuppressionsResource {
+    #private;
+    constructor(transport: Transport);
+    /**
+     * One page of a stream's list, newest first: hard bounces, spam
+     * complaints and addresses added by hand. The default stream's list
+     * unless `streamId` names another. A send to any of them is refused
+     * with `recipient_suppressed`.
+     *
+     * @example
+     * const { suppressions, next } = await sendora.suppressions.list({ streamId, limit: 200 });
+     */
+    list(query?: SuppressionQuery, options?: RequestOptions): Promise<SuppressionPage>;
+    /**
+     * Every suppressed address, page by page, for `for await`.
+     *
+     * @example
+     * for await (const entry of sendora.suppressions.listAll()) {
+     *   console.log(entry.address, entry.reason);
+     * }
+     */
+    listAll(query?: SuppressionQuery, options?: RequestOptions): AsyncIterable<Suppression>;
+    /**
+     * Lifts a hard bounce or a manual entry from a stream's list so the
+     * server may send to the address again on that stream; the default
+     * stream's list unless `streamId` names another. A spam complaint cannot
+     * be lifted this way: `spam_complaint_locked`.
+     *
+     * @example
+     * await sendora.suppressions.delete({ address: 'anna@example.com' });
+     */
+    delete(request: DeleteSuppressionRequest, options?: RequestOptions): Promise<void>;
+}
+//# sourceMappingURL=suppressions.d.ts.map

package/dist/suppressions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suppressions.d.ts","sourceRoot":"","sources":["../src/suppressions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EACV,wBAAwB,EACxB,cAAc,EACd,WAAW,EACX,eAAe,EACf,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,gFAAgF;AAChF,qBAAa,oBAAoB;;gBAGnB,SAAS,EAAE,SAAS;IAIhC;;;;;;;;OAQG;IACH,IAAI,CAAC,KAAK,GAAE,gBAAqB,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAU1F;;;;;;;OAOG;IACH,OAAO,CAAC,KAAK,GAAE,gBAAqB,EAAE,OAAO,GAAE,cAAmB,GAAG,aAAa,CAAC,WAAW,CAAC;IAS/F;;;;;;;;OAQG;IACH,MAAM,CAAC,OAAO,EAAE,wBAAwB,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CASvF"}

package/dist/suppressions.js

@@ -0,0 +1,56 @@
+import { paginate } from "./pagination.js";
+/** The addresses the token's server no longer sends to, one list per stream. */
+export class SuppressionsResource {
+    #transport;
+    constructor(transport) {
+        this.#transport = transport;
+    }
+    /**
+     * One page of a stream's list, newest first: hard bounces, spam
+     * complaints and addresses added by hand. The default stream's list
+     * unless `streamId` names another. A send to any of them is refused
+     * with `recipient_suppressed`.
+     *
+     * @example
+     * const { suppressions, next } = await sendora.suppressions.list({ streamId, limit: 200 });
+     */
+    list(query = {}, options = {}) {
+        return this.#transport.request({
+            method: 'GET',
+            path: '/v1/suppressions',
+            query: { streamId: query.streamId, limit: query.limit, after: query.after },
+            idempotent: true,
+            signal: options.signal,
+        });
+    }
+    /**
+     * Every suppressed address, page by page, for `for await`.
+     *
+     * @example
+     * for await (const entry of sendora.suppressions.listAll()) {
+     *   console.log(entry.address, entry.reason);
+     * }
+     */
+    listAll(query = {}, options = {}) {
+        return paginate((after) => this.list({ ...query, after }, options), (page) => page.suppressions, (page) => page.next, query.after);
+    }
+    /**
+     * Lifts a hard bounce or a manual entry from a stream's list so the
+     * server may send to the address again on that stream; the default
+     * stream's list unless `streamId` names another. A spam complaint cannot
+     * be lifted this way: `spam_complaint_locked`.
+     *
+     * @example
+     * await sendora.suppressions.delete({ address: 'anna@example.com' });
+     */
+    delete(request, options = {}) {
+        return this.#transport.request({
+            method: 'POST',
+            path: '/v1/suppressions/delete',
+            body: request,
+            idempotent: true,
+            signal: options.signal,
+        });
+    }
+}
+//# sourceMappingURL=suppressions.js.map

package/dist/suppressions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suppressions.js","sourceRoot":"","sources":["../src/suppressions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAU3C,gFAAgF;AAChF,MAAM,OAAO,oBAAoB;IACtB,UAAU,CAAY;IAE/B,YAAY,SAAoB;QAC9B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CAAC,QAA0B,EAAE,EAAE,UAA0B,EAAE;QAC7D,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAkB;YAC9C,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,kBAAkB;YACxB,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE;YAC3E,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,QAA0B,EAAE,EAAE,UAA0B,EAAE;QAChE,OAAO,QAAQ,CACb,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,EAClD,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,EAC3B,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EACnB,KAAK,CAAC,KAAK,CACZ,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,OAAiC,EAAE,UAA0B,EAAE;QACpE,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAY;YACxC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,yBAAyB;YAC/B,IAAI,EAAE,OAAO;YACb,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/tokens.d.ts

@@ -0,0 +1,28 @@
+import type { Transport } from './transport.ts';
+import type { CreatedToken, CreateTokenRequest, RequestOptions, Token, TokenList } from './types.ts';
+/** The API tokens of the token's own server. Every token of a server has the same rights. */
+export declare class TokensResource {
+    #private;
+    constructor(transport: Transport);
+    /**
+     * Creates another live token and answers its value once; it is never
+     * shown again, so store it at once.
+     *
+     * @example
+     * const { token, tokenId } = await sendora.tokens.create({ name: 'Fakturasystemet' });
+     */
+    create(request: CreateTokenRequest, options?: RequestOptions): Promise<CreatedToken>;
+    /** Every token of the server, revoked ones included. */
+    list(options?: RequestOptions): Promise<TokenList>;
+    /** One token by id; its value is never part of the answer. */
+    get(tokenId: string, options?: RequestOptions): Promise<Token>;
+    /**
+     * The token stops working at once. The last live token of a server
+     * cannot be revoked (`last_token`), so a server is never locked out.
+     *
+     * @example
+     * await sendora.tokens.revoke(tokenId);
+     */
+    revoke(tokenId: string, options?: RequestOptions): Promise<void>;
+}
+//# sourceMappingURL=tokens.d.ts.map

package/dist/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,KAAK,EACL,SAAS,EACV,MAAM,YAAY,CAAC;AAEpB,6FAA6F;AAC7F,qBAAa,cAAc;;gBAGb,SAAS,EAAE,SAAS;IAIhC;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IAUxF,wDAAwD;IACxD,IAAI,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,SAAS,CAAC;IAStD,8DAA8D;IAC9D,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,KAAK,CAAC;IASlE;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CAQrE"}

package/dist/tokens.js

@@ -0,0 +1,57 @@
+/** The API tokens of the token's own server. Every token of a server has the same rights. */
+export class TokensResource {
+    #transport;
+    constructor(transport) {
+        this.#transport = transport;
+    }
+    /**
+     * Creates another live token and answers its value once; it is never
+     * shown again, so store it at once.
+     *
+     * @example
+     * const { token, tokenId } = await sendora.tokens.create({ name: 'Fakturasystemet' });
+     */
+    create(request, options = {}) {
+        return this.#transport.request({
+            method: 'POST',
+            path: '/v1/tokens',
+            body: request,
+            idempotent: false,
+            signal: options.signal,
+        });
+    }
+    /** Every token of the server, revoked ones included. */
+    list(options = {}) {
+        return this.#transport.request({
+            method: 'GET',
+            path: '/v1/tokens',
+            idempotent: true,
+            signal: options.signal,
+        });
+    }
+    /** One token by id; its value is never part of the answer. */
+    get(tokenId, options = {}) {
+        return this.#transport.request({
+            method: 'GET',
+            path: `/v1/tokens/${encodeURIComponent(tokenId)}`,
+            idempotent: true,
+            signal: options.signal,
+        });
+    }
+    /**
+     * The token stops working at once. The last live token of a server
+     * cannot be revoked (`last_token`), so a server is never locked out.
+     *
+     * @example
+     * await sendora.tokens.revoke(tokenId);
+     */
+    revoke(tokenId, options = {}) {
+        return this.#transport.request({
+            method: 'DELETE',
+            path: `/v1/tokens/${encodeURIComponent(tokenId)}`,
+            idempotent: true,
+            signal: options.signal,
+        });
+    }
+}
+//# sourceMappingURL=tokens.js.map

package/dist/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AASA,6FAA6F;AAC7F,MAAM,OAAO,cAAc;IAChB,UAAU,CAAY;IAE/B,YAAY,SAAoB;QAC9B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,OAA2B,EAAE,UAA0B,EAAE;QAC9D,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAe;YAC3C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,OAAO;YACb,UAAU,EAAE,KAAK;YACjB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;IAED,wDAAwD;IACxD,IAAI,CAAC,UAA0B,EAAE;QAC/B,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAY;YACxC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,YAAY;YAClB,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;IAED,8DAA8D;IAC9D,GAAG,CAAC,OAAe,EAAE,UAA0B,EAAE;QAC/C,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAQ;YACpC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,cAAc,kBAAkB,CAAC,OAAO,CAAC,EAAE;YACjD,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,OAAe,EAAE,UAA0B,EAAE;QAClD,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAY;YACxC,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,cAAc,kBAAkB,CAAC,OAAO,CAAC,EAAE;YACjD,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/transport.d.ts

@@ -0,0 +1,34 @@
+export type Method = 'GET' | 'POST' | 'PATCH' | 'DELETE';
+export interface RequestSpec {
+    method: Method;
+    path: string;
+    query?: Record<string, string | number | undefined> | undefined;
+    body?: unknown;
+    headers?: Record<string, string> | undefined;
+    /** Safe to send again after a lost connection: reads, deletes and sends under an idempotency key. */
+    idempotent: boolean;
+    signal?: AbortSignal | undefined;
+}
+export interface TransportOptions {
+    baseUrl: string;
+    token: string;
+    fetch: typeof fetch;
+    timeoutMs: number;
+    maxRetries: number;
+    userAgent: string;
+    /** Waits between attempts; tests replace it. */
+    sleep?: ((ms: number) => Promise<void>) | undefined;
+    /** The jitter source in [0, 1); tests pin it. */
+    random?: (() => number) | undefined;
+}
+/**
+ * One request path for every resource: builds the request, sends it,
+ * turns the answer into a value or a SendoraError, and repeats it within
+ * the retry budget when repeating could help and cannot cause harm.
+ */
+export declare class Transport {
+    #private;
+    constructor(options: TransportOptions);
+    request<T>(spec: RequestSpec): Promise<T>;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEzD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IAChE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAC7C,qGAAqG;IACrG,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;IACpD,iDAAiD;IACjD,MAAM,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAC;CACrC;AAID;;;;GAIG;AACH,qBAAa,SAAS;;gBAKR,OAAO,EAAE,gBAAgB;IAM/B,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;CAwHhD"}

package/dist/transport.js

@@ -0,0 +1,146 @@
+import { errorFromAnswer, SendoraError } from "./error.js";
+import { MAX_TOTAL_WAIT_MS, retryDelayMs } from "./retry.js";
+/**
+ * One request path for every resource: builds the request, sends it,
+ * turns the answer into a value or a SendoraError, and repeats it within
+ * the retry budget when repeating could help and cannot cause harm.
+ */
+export class Transport {
+    #options;
+    #sleep;
+    #random;
+    constructor(options) {
+        this.#options = options;
+        this.#sleep = options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+        this.#random = options.random ?? Math.random;
+    }
+    async request(spec) {
+        const url = this.#url(spec);
+        const body = spec.body === undefined ? undefined : JSON.stringify(spec.body);
+        let waitedMs = 0;
+        for (let attempt = 0;; attempt += 1) {
+            const outcome = await this.#attempt(spec, url, body);
+            if (outcome.ok) {
+                return outcome.value;
+            }
+            const { error } = outcome;
+            const mayRepeat = spec.idempotent || error.code === 'rate_limited' || error.code === 'sending_disabled';
+            if (attempt >= this.#options.maxRetries || !error.retryable || !mayRepeat) {
+                throw error;
+            }
+            const delay = retryDelayMs(attempt, error.retryAfter, this.#random);
+            if (waitedMs + delay > MAX_TOTAL_WAIT_MS) {
+                throw error;
+            }
+            waitedMs += delay;
+            await this.#sleep(delay);
+        }
+    }
+    async #attempt(spec, url, body) {
+        const timeout = AbortSignal.timeout(this.#options.timeoutMs);
+        const signal = spec.signal === undefined ? timeout : AbortSignal.any([spec.signal, timeout]);
+        const init = {
+            method: spec.method,
+            headers: this.#headers(spec, body),
+            signal,
+            redirect: 'manual',
+        };
+        if (body !== undefined) {
+            init.body = body;
+        }
+        let response;
+        try {
+            response = await this.#options.fetch(url, init);
+        }
+        catch (cause) {
+            if (spec.signal?.aborted) {
+                throw cause;
+            }
+            if (timeout.aborted) {
+                return {
+                    ok: false,
+                    error: new SendoraError({
+                        code: 'timeout',
+                        status: null,
+                        message: `The API did not answer within ${String(this.#options.timeoutMs)} ms.`,
+                        cause,
+                    }),
+                };
+            }
+            return {
+                ok: false,
+                error: new SendoraError({
+                    code: 'connection_failed',
+                    status: null,
+                    message: 'The connection to the API failed.',
+                    cause,
+                }),
+            };
+        }
+        if (response.status === 204) {
+            await response.body?.cancel();
+            return { ok: true, value: undefined };
+        }
+        const json = parseJson(await response.text());
+        if (response.status === 0 || (response.status >= 300 && response.status < 400)) {
+            return {
+                ok: false,
+                error: new SendoraError({
+                    code: 'unexpected_response',
+                    status: response.status,
+                    message: `The API answered a redirect; check baseUrl (${this.#options.baseUrl}).`,
+                }),
+            };
+        }
+        if (response.ok) {
+            if (json === undefined) {
+                return {
+                    ok: false,
+                    error: new SendoraError({
+                        code: 'unexpected_response',
+                        status: response.status,
+                        message: `The API answered ${String(response.status)} without a JSON body.`,
+                    }),
+                };
+            }
+            return { ok: true, value: json };
+        }
+        return {
+            ok: false,
+            error: errorFromAnswer(response.status, json, response.headers.get('retry-after')),
+        };
+    }
+    #headers(spec, body) {
+        const headers = {
+            authorization: `Bearer ${this.#options.token}`,
+            accept: 'application/json',
+            'user-agent': this.#options.userAgent,
+            ...spec.headers,
+        };
+        if (body !== undefined) {
+            headers['content-type'] = 'application/json';
+        }
+        return headers;
+    }
+    #url(spec) {
+        const url = new URL(`${this.#options.baseUrl.replace(/\/+$/, '')}${spec.path}`);
+        for (const [name, value] of Object.entries(spec.query ?? {})) {
+            if (value !== undefined) {
+                url.searchParams.set(name, String(value));
+            }
+        }
+        return url.toString();
+    }
+}
+function parseJson(text) {
+    if (text === '') {
+        return undefined;
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=transport.js.map