@bumail/queue 0.1.0

package/dist/queue/options.d.ts

@@ -0,0 +1,111 @@
+import type { MxResolver, SendMailAuth, SendMailOptions, SendMailResult, SendMailTimeouts, TlsMode } from '@bumail/smtp/client';
+import type { QueueStore } from '../contract/queue-store';
+/** What delivers one message to one destination: `sendMail` of `@bumail/smtp/client`, or a fake in a spec. */
+export type Sender = (message: Uint8Array, options: SendMailOptions) => Promise<SendMailResult>;
+/** What the queue reads the time from, in milliseconds since the epoch: `Date.now` but in a spec. */
+export interface Clock {
+    now(): number;
+}
+/** A host that takes every message for a route: an ISP's relay, a provider's submission port. */
+export interface Smarthost {
+    readonly host: string;
+    /** Default 465 with `secure`, else 25 (587 for submission is yours to give). */
+    readonly port?: number;
+    /** TLS from the first byte (port 465). */
+    readonly secure?: boolean;
+    /** Default `required` with `auth` or `secure`, else `opportunistic`. */
+    readonly tls?: TlsMode;
+    /** Sent only once TLS checked the host's certificate. */
+    readonly auth?: SendMailAuth;
+    /** Certificates to trust besides the system's, PEM. */
+    readonly ca?: string | readonly string[];
+}
+/** `'mx'`: the recipient domain's own mail hosts, by its MX records. Otherwise, a smarthost. */
+export type Route = 'mx' | Smarthost;
+/**
+ * When to try a deferred recipient again: `first` after the first
+ * attempt, then each wait `factor` times the one before, at most `max`,
+ * each plus up to `jitter` of itself at random. Past `giveUpAfter` since
+ * the message was enqueued, a recipient still deferred fails. Milliseconds.
+ */
+export interface RetrySchedule {
+    /** Default 30 minutes, RFC 5321 §4.5.4.1's least. */
+    readonly first?: number;
+    /** Default 2. */
+    readonly factor?: number;
+    /** Default 4 hours. */
+    readonly max?: number;
+    /** A fraction from 0 to 1. Default 0.1. */
+    readonly jitter?: number;
+    /** Default 5 days (RFC 5321 §4.5.4.1: "at least 4-5 days"). */
+    readonly giveUpAfter?: number;
+}
+/** The bounds of what the queue takes and keeps. */
+export interface QueueLimits {
+    /** Bytes. Default 25 MiB. */
+    readonly maxMessageSize?: number;
+    /** Recipients per message. Default 100 (RFC 5321 §4.5.3.1.8). */
+    readonly maxRecipients?: number;
+    /** Items the store may hold; `enqueue` refuses past it. Default: no limit. */
+    readonly maxItems?: number;
+    /** Characters of a reply kept per recipient, from 64 to 900. Default 512. */
+    readonly maxReplyText?: number;
+    /** Bytes of the original message a DSN returns. Default 64 KiB. */
+    readonly maxDsnReturn?: number;
+}
+/** Delivery status notifications (RFC 3464), sent back to the sender. */
+export interface DsnOptions {
+    /** The DSN's From address. Default `postmaster@<hostname>`. */
+    readonly from?: string;
+    /**
+     * Milliseconds after enqueuing before a "delayed" DSN for recipients
+     * still deferred; `false` for none. Default 4 hours.
+     */
+    readonly delayAfter?: number | false;
+    /**
+     * `headers`: the original's header fields (`text/rfc822-headers`).
+     * `full`: the whole original (`message/rfc822`) when it fits
+     * `maxDsnReturn`, its headers otherwise. Default `headers`.
+     */
+    readonly returnContent?: 'headers' | 'full';
+}
+export interface QueueOptions {
+    /** Where items are kept: `MemoryQueueStore`, `SqliteQueueStore`, or your own. */
+    readonly store: QueueStore;
+    /** This server's public name: given in EHLO, as the DSN's Reporting-MTA, and in the DSN's From. */
+    readonly hostname: string;
+    /** The default route. Default `'mx'`. */
+    readonly route?: Route;
+    /** A route per recipient domain, over `route`. */
+    readonly routes?: Readonly<Record<string, Route>>;
+    /** Needed by the `'mx'` route: `@bumail/dns`'s resolver, or any of its shape. */
+    readonly resolver?: MxResolver;
+    /** The port of MX hosts. Default 25; another one is for a test. */
+    readonly mxPort?: number;
+    /** TLS to MX hosts. Default `opportunistic`. */
+    readonly mxTls?: TlsMode;
+    /** Each step's timeout, in seconds, as `sendMail` takes them. */
+    readonly timeouts?: SendMailTimeouts;
+    /** Seconds one session may take, DNS included. Default 1800. */
+    readonly deadline?: number;
+    readonly retry?: RetrySchedule;
+    readonly dsn?: DsnOptions;
+    readonly limits?: QueueLimits;
+    /** Items delivered at once, by this worker, each with one session per recipient domain. Default 20. */
+    readonly concurrency?: number;
+    /** Sessions at once to one recipient domain, by this worker. Default 2. */
+    readonly perDomain?: number;
+    /** How long a claim holds an item, renewed while it is delivered; milliseconds, 1000 to 6 442 450 941. Default 10 minutes. */
+    readonly leaseMs?: number;
+    /** How often `start()` looks for due items; milliseconds, at most 2 147 483 647. Default 5000. */
+    readonly pollInterval?: number;
+    /** This worker's name on its leases. Default a random UUID. */
+    readonly owner?: string;
+    /** Default `Date.now`. */
+    readonly clock?: Clock;
+    /** Default `sendMail` of `@bumail/smtp/client`. */
+    readonly send?: Sender;
+    /** For the jitter. Default `Math.random`. */
+    readonly random?: () => number;
+}
+//# sourceMappingURL=options.d.ts.map

package/dist/queue/options.d.ts.map

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

package/dist/queue/outcome.d.ts

@@ -0,0 +1,26 @@
+import type { Reply, SendMailResult, SmtpError } from '@bumail/smtp/client';
+import type { Diagnostic, RecipientUpdate } from '../contract/types';
+/**
+ * An `SmtpError`, read by its `name`: a second copy of `@bumail/smtp` (a
+ * different version installed for the app) throws errors of another
+ * class, which `instanceof` would take for unknown ones.
+ */
+export declare const isSmtpError: (error: unknown) => error is SmtpError;
+/**
+ * `sendMail` refused its options: the route is misconfigured (a smarthost
+ * it cannot use, a bad timeout), not the recipient. Retried, never bounced
+ * at once: fixing the configuration and restarting delivers the message.
+ */
+export declare const isRouteError: (error: unknown) => boolean;
+/** What a reply says, bounded and cleaned. */
+export declare function diagnosticOf(reply: Reply, max: number, host?: string): Diagnostic;
+/** Each recipient of a delivery `sendMail` resolved: taken, or refused one by one. */
+export declare function outcomesOf(result: SendMailResult, group: readonly string[], max: number): RecipientUpdate[];
+/**
+ * Each recipient of a delivery `sendMail` rejected: by its own reply when
+ * the server refused every one, else all alike — deferred when the error
+ * is temporary (a 4xx, the network, a timeout) or the route's own
+ * (`INVALID_OPTION`, X.3.5), failed otherwise.
+ */
+export declare function outcomesOfError(error: unknown, group: readonly string[], max: number, host?: string): RecipientUpdate[];
+//# sourceMappingURL=outcome.d.ts.map

package/dist/queue/outcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outcome.d.ts","sourceRoot":"","sources":["../../src/queue/outcome.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,KAAK,EACL,cAAc,EACd,SAAS,EAET,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGrE;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,SAGC,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,OACQ,CAAC;AAKvD,8CAA8C;AAC9C,wBAAgB,YAAY,CAC3B,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,MAAM,GACX,UAAU,CAWZ;AAsCD,sFAAsF;AACtF,wBAAgB,UAAU,CACzB,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,GAAG,EAAE,MAAM,GACT,eAAe,EAAE,CA0BnB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC9B,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,MAAM,GACX,eAAe,EAAE,CAuBnB"}

package/dist/queue/queue.d.ts

@@ -0,0 +1,43 @@
+import type { QueueItem, QueueListOptions } from '../contract/types';
+import { type MessageSource, type QueueEnvelope } from './envelope';
+import { type QueueEvents, type QueueListener } from './events';
+import type { QueueOptions } from './options';
+/** The outbound queue: what the app enqueues, delivered across restarts. */
+export interface Queue {
+    /** This worker's name on its leases. */
+    readonly owner: string;
+    /**
+     * Takes a message to send — already signed, as it will leave — with its
+     * envelope, and keeps it in the store, every recipient pending, due at
+     * once. Refuses with `INVALID`, `MESSAGE_TOO_BIG`,
+     * `TOO_MANY_RECIPIENTS` or `QUEUE_FULL`. The queue sends whatever it is
+     * given: authenticate the submitter before you enqueue.
+     */
+    enqueue(message: MessageSource, envelope: QueueEnvelope): Promise<QueueItem>;
+    /** One pass by hand: delivers every item due now; resolves with how many it claimed. */
+    deliverDue(): Promise<number>;
+    /** Delivers in the background: a pass every `pollInterval`, and at once after `enqueue`. */
+    start(): void;
+    /** Claims nothing more, lets the deliveries under way end, and gives back the rest. */
+    stop(): Promise<void>;
+    /** Listens to an event; returns what stops listening. */
+    on<E extends keyof QueueEvents>(event: E, listener: QueueListener<E>): () => void;
+    /** The items in the queue, the next due first. */
+    list(options?: QueueListOptions): Promise<QueueItem[]>;
+    get(id: string): Promise<QueueItem | undefined>;
+    /**
+     * Makes an item due now, and wakes the worker. False when there is no
+     * such item, or when a worker is delivering it: its outcome sets the
+     * next attempt, so asking now would change nothing.
+     */
+    retryNow(id: string): Promise<boolean>;
+    /** Drops an item, its message and its recipients, with no DSN; the item as it stood, or `undefined`. */
+    cancel(id: string): Promise<QueueItem | undefined>;
+}
+/**
+ * Creates the queue over a store. Nothing is delivered until `start()`,
+ * or `deliverDue()` by hand. Several queues — in one process or several —
+ * may share a store: each claims items under its own `owner`.
+ */
+export declare function createQueue(options: QueueOptions): Queue;
+//# sourceMappingURL=queue.d.ts.map

package/dist/queue/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/queue/queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAGN,KAAK,aAAa,EAClB,KAAK,aAAa,EAElB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAU,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAI9C,4EAA4E;AAC5E,MAAM,WAAW,KAAK;IACrB,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC7E,wFAAwF;IACxF,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,4FAA4F;IAC5F,KAAK,IAAI,IAAI,CAAC;IACd,uFAAuF;IACvF,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,yDAAyD;IACzD,EAAE,CAAC,CAAC,SAAS,MAAM,WAAW,EAC7B,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GACxB,MAAM,IAAI,CAAC;IACd,kDAAkD;IAClD,IAAI,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACvD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IAChD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,wGAAwG;IACxG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;CACnD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,KAAK,CAmCxD"}

package/dist/queue/retry.d.ts

@@ -0,0 +1,16 @@
+import type { RetrySettings } from './settings';
+/**
+ * The wait after the `attempts`-th attempt failed for now: `first`, then
+ * `factor` times the wait before, at most `max`, plus up to `jitter` of
+ * itself — never less, so RFC 5321 §4.5.4.1's 30 minutes stay a floor.
+ */
+export declare function retryDelay(attempts: number, retry: RetrySettings, random: () => number): number;
+/** When a message's deferred recipients give up: `giveUpAfter` after it was enqueued. */
+export declare const giveUpAt: (createdAt: number, retry: RetrySettings) => number;
+/**
+ * The next attempt after the `attempts`-th, at `now`: the back-off, but no
+ * later than the moment of giving up, so the last try falls on it.
+ * `undefined` when that moment has come: what is still deferred fails.
+ */
+export declare function nextAttemptAt(createdAt: number, now: number, attempts: number, retry: RetrySettings, random: () => number): number | undefined;
+//# sourceMappingURL=retry.d.ts.map

package/dist/queue/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/queue/retry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;GAIG;AACH,wBAAgB,UAAU,CACzB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,MAAM,MAAM,GAClB,MAAM,CAIR;AAED,yFAAyF;AACzF,eAAO,MAAM,QAAQ,GAAI,WAAW,MAAM,EAAE,OAAO,aAAa,WAClC,CAAC;AAE/B;;;;GAIG;AACH,wBAAgB,aAAa,CAC5B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,MAAM,MAAM,GAClB,MAAM,GAAG,SAAS,CAIpB"}

package/dist/queue/route.d.ts

@@ -0,0 +1,10 @@
+import type { SendMailOptions } from '@bumail/smtp/client';
+import type { Route } from './options';
+import type { Settings } from './settings';
+/** The route for a recipient domain: its own, else the default. */
+export declare function routeOf(settings: Settings, domain: string): Route;
+/** The host an attempt goes to, as far as the route says: the smarthost, or nothing for MX. */
+export declare function hostOf(route: Route): string | undefined;
+/** What `sendMail` takes to send one domain's recipients of a message. */
+export declare function sendOptionsOf(settings: Settings, domain: string, from: string, to: readonly string[]): SendMailOptions;
+//# sourceMappingURL=route.d.ts.map

package/dist/queue/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/queue/route.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,mEAAmE;AACnE,wBAAgB,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAEjE;AAED,+FAA+F;AAC/F,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAEvD;AAED,0EAA0E;AAC1E,wBAAgB,aAAa,CAC5B,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,SAAS,MAAM,EAAE,GACnB,eAAe,CA8BjB"}

package/dist/queue/settings/dsn.d.ts

@@ -0,0 +1,8 @@
+import type { QueueOptions } from '../options';
+export interface DsnSettings {
+    readonly from: string;
+    readonly delayAfter: number | false;
+    readonly returnContent: 'headers' | 'full';
+}
+export declare function dsnOf(options: QueueOptions, hostname: string): DsnSettings;
+//# sourceMappingURL=dsn.d.ts.map

package/dist/queue/settings/dsn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsn.d.ts","sourceRoot":"","sources":["../../../src/queue/settings/dsn.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,KAAK,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,SAAS,GAAG,MAAM,CAAC;CAC3C;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAc1E"}

package/dist/queue/settings/index.d.ts

@@ -0,0 +1,25 @@
+import type { QueueOptions, Route, Sender } from '../options';
+import { type DsnSettings } from './dsn';
+import { type LimitSettings, type RetrySettings } from './limits';
+export type { DsnSettings, LimitSettings, RetrySettings };
+/** Every option checked, with its default. */
+export interface Settings {
+    readonly options: QueueOptions;
+    readonly hostname: string;
+    /** The routes by domain, in lowercase. */
+    readonly routes: ReadonlyMap<string, Route>;
+    readonly retry: RetrySettings;
+    readonly limits: LimitSettings;
+    readonly dsn: DsnSettings;
+    readonly concurrency: number;
+    readonly perDomain: number;
+    readonly leaseMs: number;
+    readonly pollInterval: number;
+    readonly owner: string;
+    readonly now: () => number;
+    readonly send: Sender;
+    readonly random: () => number;
+}
+/** The options, checked, with their defaults; `INVALID` names the first wrong one. */
+export declare function settingsOf(options: QueueOptions): Settings;
+//# sourceMappingURL=index.d.ts.map

package/dist/queue/settings/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/queue/settings/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,KAAK,WAAW,EAAS,MAAM,OAAO,CAAC;AAChD,OAAO,EACN,KAAK,aAAa,EAElB,KAAK,aAAa,EAElB,MAAM,UAAU,CAAC;AAKlB,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC;AAE1D,8CAA8C;AAC9C,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC5C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC;CAC9B;AAKD,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,QAAQ,CAqD1D"}

package/dist/queue/settings/limits.d.ts

@@ -0,0 +1,18 @@
+import type { QueueOptions } from '../options';
+export interface RetrySettings {
+    readonly first: number;
+    readonly factor: number;
+    readonly max: number;
+    readonly jitter: number;
+    readonly giveUpAfter: number;
+}
+export interface LimitSettings {
+    readonly maxMessageSize: number;
+    readonly maxRecipients: number;
+    readonly maxItems: number | undefined;
+    readonly maxReplyText: number;
+    readonly maxDsnReturn: number;
+}
+export declare function retryOf(options: QueueOptions): RetrySettings;
+export declare function limitsOf(options: QueueOptions): LimitSettings;
+//# sourceMappingURL=limits.d.ts.map

package/dist/queue/settings/limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../../../src/queue/settings/limits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,aAAa,CAU5D;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,aAAa,CAiB7D"}

package/dist/queue/settings/numbers.d.ts

@@ -0,0 +1,7 @@
+export declare const MINUTE = 60000;
+export declare const HOUR: number;
+/** The longest delay a timer takes: past it, Bun fires after 1 ms. */
+export declare const MAX_TIMER = 2147483647;
+/** A number in `[min, max]`, integer when asked, or its default. */
+export declare function numberOf(name: string, value: unknown, fallback: number, min: number, max?: number, integer?: boolean): number;
+//# sourceMappingURL=numbers.d.ts.map

package/dist/queue/settings/numbers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbers.d.ts","sourceRoot":"","sources":["../../../src/queue/settings/numbers.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM,QAAS,CAAC;AAC7B,eAAO,MAAM,IAAI,QAAc,CAAC;AAChC,sEAAsE;AACtE,eAAO,MAAM,SAAS,aAAgB,CAAC;AAEvC,oEAAoE;AACpE,wBAAgB,QAAQ,CACvB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,GAAG,SAA0B,EAC7B,OAAO,UAAO,GACZ,MAAM,CAgBR"}

package/dist/queue/settings/routes.d.ts

@@ -0,0 +1,3 @@
+import type { QueueOptions } from '../options';
+export declare function checkRoutes(options: QueueOptions): void;
+//# sourceMappingURL=routes.d.ts.map

package/dist/queue/settings/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/queue/settings/routes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,YAAY,CAAC;AAoDjE,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAYvD"}

package/dist/queue/settings/sessions.d.ts

@@ -0,0 +1,5 @@
+import type { QueueOptions } from '../options';
+export declare function checkTls(name: string, tls: unknown): void;
+/** What every session takes, whatever its route: the MX port and TLS, the timeouts. */
+export declare function checkSessions(options: QueueOptions): void;
+//# sourceMappingURL=sessions.d.ts.map

package/dist/queue/settings/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../../src/queue/settings/sessions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAoB/C,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAWzD;AAED,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAazD"}

package/dist/queue/settle.d.ts

@@ -0,0 +1,21 @@
+import type { AttemptResult, QueueItem, RecipientUpdate } from '../contract/types';
+import type { Settings } from './settings';
+/** An attempt's outcomes, sorted, and what to record and send for them. */
+export interface Settled {
+    readonly result: AttemptResult;
+    readonly delivered: readonly RecipientUpdate[];
+    /** Failed in this attempt: a 5xx, or given up. */
+    readonly failed: readonly RecipientUpdate[];
+    /** Still deferred, to try again at `result.nextAttemptAt`. */
+    readonly deferred: readonly RecipientUpdate[];
+    /** A "delayed" DSN is due for the deferred recipients. */
+    readonly delayDsn: boolean;
+}
+/**
+ * What an attempt comes to: the count, the next attempt (RFC 5321
+ * §4.5.4.1's back-off, or now when some recipients were left out because
+ * the worker is stopping), the deferred recipients that gave up, and
+ * whether the "delayed" DSN is due — once, for a sender that is not null.
+ */
+export declare function settle(item: QueueItem, updates: readonly RecipientUpdate[], skipped: boolean, now: number, settings: Settings): Settled;
+//# sourceMappingURL=settle.d.ts.map

package/dist/queue/settle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settle.d.ts","sourceRoot":"","sources":["../../src/queue/settle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,aAAa,EACb,SAAS,EACT,eAAe,EACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,2EAA2E;AAC3E,MAAM,WAAW,OAAO;IACvB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;IAC/C,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5C,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;IAC9C,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC3B;AAeD;;;;;GAKG;AACH,wBAAgB,MAAM,CACrB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,SAAS,eAAe,EAAE,EACnC,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,QAAQ,GAChB,OAAO,CAoCT"}

package/dist/queue/worker.d.ts

@@ -0,0 +1,27 @@
+import type { NotifyContext } from './notify';
+/**
+ * Claims due items and delivers them, at most `concurrency` at once,
+ * renewing each lease while its item is delivered. `start()` runs passes
+ * every `pollInterval`, or at once when woken; `stop()` lets every
+ * delivery under way finish and gives back what it had not started.
+ */
+export declare class Worker {
+    #private;
+    constructor(ctx: NotifyContext);
+    /**
+     * One pass: claims and delivers every item due, `concurrency` at a time,
+     * claiming again as each one ends — so a DSN enqueued meanwhile goes in
+     * the same pass. Resolves once all are done, with how many it claimed.
+     */
+    deliverDue(): Promise<number>;
+    /** Wakes a sleeping `start()` loop, or spares it its next sleep: something was enqueued. */
+    wake(): void;
+    start(): void;
+    /**
+     * Claims nothing more, lets every delivery under way end, and gives back
+     * what was claimed but not started, due at once for the next worker. A
+     * `start()` called meanwhile starts again once this ends.
+     */
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=worker.d.ts.map

package/dist/queue/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/queue/worker.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;;GAKG;AACH,qBAAa,MAAM;;gBAaN,GAAG,EAAE,aAAa;IAsE9B;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAgCnC,4FAA4F;IAC5F,IAAI,IAAI,IAAI;IAKZ,KAAK,IAAI,IAAI;IAqCb;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAa3B"}

package/dist/sqlite/index.d.ts

@@ -0,0 +1,2 @@
+export { SqliteQueueStore, type SqliteQueueStoreOptions } from './store';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sqlite/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,SAAS,CAAC"}