@bumail/queue 0.11.0 → 0.13.0

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

@@ -1 +1 @@
-{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/queue/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,UAAU,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,OAAO,EACP,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,8GAA8G;AAC9G,MAAM,MAAM,MAAM,GAAG,CACpB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,eAAe,KACpB,OAAO,CAAC,cAAc,CAAC,CAAC;AAE7B,qGAAqG;AACrG,MAAM,WAAW,KAAK;IACrB,GAAG,IAAI,MAAM,CAAC;CACd;AAED,iGAAiG;AACjG,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,yDAAyD;IACzD,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;IAC7B,uDAAuD;IACvD,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;CACzC;AAED,gGAAgG;AAChG,MAAM,MAAM,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC;AAErC;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC7B,qDAAqD;IACrD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB;IACjB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,uBAAuB;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,oDAAoD;AACpD,MAAM,WAAW,WAAW;IAC3B,6BAA6B;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,iEAAiE;IACjE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,6EAA6E;IAC7E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,mEAAmE;IACnE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,yEAAyE;AACzE,MAAM,WAAW,UAAU;IAC1B,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;CAC5C;AAED,MAAM,WAAW,YAAY;IAC5B,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,mGAAmG;IACnG,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,yCAAyC;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,kDAAkD;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IAClD;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAC9B,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;IAC/B,mEAAmE;IACnE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IACrC,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,uGAAuG;IACvG,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,8HAA8H;IAC9H,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,kGAAkG;IAClG,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,0BAA0B;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;CAC/B"}
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/queue/options.ts"],"names":[],"mappings":"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"}

package/dist/queue/session.d.ts

@@ -3,12 +3,16 @@ import type { DeliveryContext } from './deliver';
 import type { RecipientEvent } from './events';
 import type { Route } from './options';
 /** The route a recipient's last session took, as its events tell it. */
-export type Used = Pick<RecipientEvent, 'route' | 'fallback' | 'mxReply'>;
+export type Used = Pick<RecipientEvent, 'route' | 'fallback' | 'mxReply' | 'reused'>;
 /** One session's outcomes, and the error that ended it, if any. */
 export interface Attempt {
     readonly updates: RecipientUpdate[];
     readonly error?: unknown;
+    /** The session went over a connection that had carried a message before. */
+    readonly reused?: boolean;
 }
+/** What `used` keeps of a session's connection: `reused` when the sender said. */
+export declare const reusedOf: (a: Attempt) => Pick<Used, "reused">;
 /** One session, by `route` (the domain's own when none is given): each recipient's outcome, whatever happened. */
 export declare function session(ctx: DeliveryContext, item: QueueItem, message: Uint8Array, domain: string, group: readonly string[], route: Route, override?: Route): Promise<Attempt>;
 //# sourceMappingURL=session.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/queue/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAyCvC,wEAAwE;AACxE,MAAM,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC,CAAC;AAE1E,mEAAmE;AACnE,MAAM,WAAW,OAAO;IACvB,QAAQ,CAAC,OAAO,EAAE,eAAe,EAAE,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,kHAAkH;AAClH,wBAAsB,OAAO,CAC5B,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,KAAK,EAAE,KAAK,EACZ,QAAQ,CAAC,EAAE,KAAK,GACd,OAAO,CAAC,OAAO,CAAC,CAsBlB"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/queue/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAyCvC,wEAAwE;AACxE,MAAM,MAAM,IAAI,GAAG,IAAI,CACtB,cAAc,EACd,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAC3C,CAAC;AAEF,mEAAmE;AACnE,MAAM,WAAW,OAAO;IACvB,QAAQ,CAAC,OAAO,EAAE,eAAe,EAAE,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,kFAAkF;AAClF,eAAO,MAAM,QAAQ,GAAI,GAAG,OAAO,KAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,CACN,CAAC;AAEpD,kHAAkH;AAClH,wBAAsB,OAAO,CAC5B,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,KAAK,EAAE,KAAK,EACZ,QAAQ,CAAC,EAAE,KAAK,GACd,OAAO,CAAC,OAAO,CAAC,CAyBlB"}

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

@@ -1,6 +1,7 @@
-import type { QueueOptions, Route, Sender } from '../options';
+import type { QueueOptions, Route } from '../options';
 import { type DsnSettings } from './dsn';
 import { type LimitSettings, type RetrySettings } from './limits';
+import { type SenderSettings } from './sender';
 export type { DsnSettings, LimitSettings, RetrySettings };
 /** Every option checked, with its default. */
 export interface Settings {
@@ -17,7 +18,9 @@ export interface Settings {
     readonly pollInterval: number;
     readonly owner: string;
     readonly now: () => number;
-    readonly send: Sender;
+    readonly send: SenderSettings['send'];
+    /** Closes the queue's own connection pool, if it has one. */
+    readonly close: SenderSettings['close'];
     readonly random: () => number;
 }
 /** The options, checked, with their defaults; `INVALID` names the first wrong one. */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/queue/settings/index.ts"],"names":[],"mappings":"AAGA,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,CAkD1D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/queue/settings/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,KAAK,WAAW,EAAS,MAAM,OAAO,CAAC;AAChD,OAAO,EACN,KAAK,aAAa,EAElB,KAAK,aAAa,EAElB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,KAAK,cAAc,EAAY,MAAM,UAAU,CAAC;AAGzD,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,cAAc,CAAC,MAAM,CAAC,CAAC;IACtC,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC;CAC9B;AAKD,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,QAAQ,CAoD1D"}

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

@@ -0,0 +1,16 @@
+import type { QueueOptions, ReuseOptions, Sender } from '../options';
+/** The sender the queue delivers with, and what stops it. */
+export interface SenderSettings {
+    readonly send: Sender;
+    /** Closes the pool the queue owns, once its deliveries end; nothing when the sender is not the queue's. */
+    readonly close: () => Promise<void>;
+}
+/** `reuse` shaped: the limits given (the pool owns their defaults and checks them), or `false` for one connection per send. */
+export declare function reuseOf(options: QueueOptions): ReuseOptions | false;
+/**
+ * Your `send`, untouched; else a pool the queue owns (made on first use,
+ * and again after a `close()`, since `stop()` then `start()` is allowed);
+ * else `sendMail` with `reuse: false`.
+ */
+export declare function senderOf(options: QueueOptions): SenderSettings;
+//# sourceMappingURL=sender.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sender.d.ts","sourceRoot":"","sources":["../../../src/queue/settings/sender.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAErE,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2GAA2G;IAC3G,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED,+HAA+H;AAC/H,wBAAgB,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,GAAG,KAAK,CAcnE;AAgBD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CAiB9D"}

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

@@ -1 +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;IAsD9B;;;;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"}
+{"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;IAsD9B;;;;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;CAiB3B"}

package/docs/guide.md

@@ -260,6 +260,39 @@ createQueue({
 
 No resolver is needed when no route is `'mx'`.
 
+### Reusing connections
+
+By default the queue sends through a pool of connections it owns: a
+session to a server the queue already has an idle connection to (same
+host, address, port, EHLO name, TLS and credentials) sends its message
+over it, after an `RSET`, instead of opening a connection, a TLS
+handshake and an `AUTH` again. A connection carries 100 messages and
+waits 5 seconds idle, then closes. A `delivered`, `deferred` or `failed`
+event carries `reused: true` when the recipient's last session went over a
+connection that had carried a message before, `false` when it opened one.
+
+```ts
+createQueue({
+	store,
+	hostname: 'mail.example.net',
+	resolver,
+	reuse: { maxMessages: 50, idleSeconds: 10 }, // or the defaults, or `false`
+});
+```
+
+`reuse: false` opens one connection per session, as `sendMail` does. A
+`send` of your own is called as given: the queue never wraps it in a pool,
+and `reuse` does nothing with it, though `createQueue` still checks it.
+`reused` is on the events only if your `send` returns it.
+
+`stop()` closes the pool once the deliveries under way end, so no socket
+keeps the process alive; `start()` after it makes a new one. A connection
+that went stale while idle (the server closed it) is never a reason to
+fall back to a smarthost: the pool opens a new one to the same server.
+`@bumail/server` builds its own pool for its `send` and closes it after
+`queue.stop()`. The rules of [Falling back](#falling-back-to-a-smarthost) are
+the same with or without the pool.
+
 ### Timeouts
 
 `timeouts` and `deadline` pass to `sendMail`: each step's timeout in
@@ -1046,8 +1079,90 @@ codes, and keeps its promises:
   The queue never gives a store such text: it cleans every reply.
 
 The contract's specs, `describeQueueStore`, which every store here runs,
-are internal for now: a store written outside this package cannot run
-them yet.
+are exported as `@bumail/queue/conformance`: see
+[Holding your own store to the contract](#holding-your-own-store-to-the-contract).
+
+## Holding your own store to the contract
+
+A store you write (over a file, a database, a service) is only a
+`QueueStore` if it answers the contract above to the letter, in the cases
+nobody thinks of: a lease that expired, a DSN that fails the checks, a
+second process claiming at the same time. `describeQueueStore` is the
+suite the memory, SQLite, PostgreSQL and Redis stores run; call
+it from a spec of yours and it registers them.
+
+**It needs Bun.** The suite imports `bun:test`, so the spec runs with
+`bun test`, not with Node, Vitest or Jest. It is a development
+dependency: install `@bumail/queue` and write the spec.
+
+```sh
+bun add -d @bumail/queue
+```
+
+```ts
+// my-store.spec.ts
+import { describeQueueStore } from '@bumail/queue/conformance';
+import { MyQueueStore } from './my-store';
+
+describeQueueStore('MyQueueStore', {
+  // a new store, empty: called once per test
+  create: () => MyQueueStore.open({ url: process.env.MY_STORE_URL }),
+  // another handle on the same queue, as a second connection or process
+  share: (store) => (store as MyQueueStore).connectAgain(),
+  // closes a store `create` made, after the test that used it
+  dispose: (store) => (store as MyQueueStore).close(),
+});
+```
+
+```sh
+bun test my-store.spec.ts
+```
+
+A spec project typechecked with `tsc` needs `@types/bun` (for `bun:test`), as
+the example's `devDependencies` have it.
+
+[`examples/custom-store`](https://github.com/softistx/bumail/tree/develop/examples/custom-store)
+in the repository holds a complete one, a store over the memory store with its
+spec, that passes.
+
+### What it covers
+
+| group | what is held |
+| --- | --- |
+| `items` | `add` keeps the envelope, every recipient `pending`, due at once; the null sender; `readMessage` and every item are copies; an unknown id, or one no store could hold, is `undefined`; `list` order and paging; `cancel`; `maxItems` and `QUEUE_FULL`; what is not an item is `INVALID`; the DSN parameters (`ret`, `envid`, `notify`, `orcpt`) and their limits |
+| `claims and leases` | `claim` takes the earliest due, then the oldest, and only what is due; an expired lease is claimed again and its old owner has lost it; `renew`; `reschedule` with and without an owner; a bad request is `INVALID` |
+| `outcomes` | `complete` records each recipient, the schedule and lets go of the lease; a finished item is dropped with its message; text with a NUL or a lone surrogate is refused; a final state never changes; the DSNs stored in the same step (new ids, in order, none on a lost lease, all refused when one is bad); `mayHaveReachedMx` and `mayHaveReachedFallback` recorded and kept |
+| `several workers` | many claimers on one queue deliver every item once; a crashed worker's items are claimed again when its leases expire |
+
+### `share`: a second handle
+
+The two `several workers` tests need `share`, another handle on **the
+same queue**: a second connection to the same database, as a second
+process would open. Without it they are registered as skipped, named
+`… (skipped: harness has no share)`, because one handle cannot show that
+a claim is atomic across handles.
+
+A store that lives in one process, such as an in-memory one, may return a
+second object over the same data, as the example does. A **networked**
+store (PostgreSQL, Redis, any server) should pass a real second
+connection: that is where two workers race, and where a claim that reads
+then writes loses. Passing none for a store like that leaves the one
+property that matters unproved.
+
+### `dispose`
+
+`dispose(store)` runs after every test, for each store `create` made in
+that test, once the test is over (pass or fail). Use it to close a
+connection or remove a file. It may be async.
+
+- Every created store is disposed, even when the disposal of another
+  one fails.
+- One failure is rethrown as it is. Several in one test are thrown
+  together as an `AggregateError` (`several stores failed to dispose`),
+  each reason in its `errors`.
+- Handles returned by `share` are **not** passed to `dispose`: the
+  harness closes them, for instance in the same `dispose`, from the store
+  they were made from.
 
 ## Options
 
@@ -1077,5 +1192,6 @@ them yet.
 | `pollInterval` | `number`, to 2147483647 | 5000 | ms between passes of `start()` |
 | `owner` | `string` | a random UUID | this worker's name on its leases |
 | `clock` | `{ now(): number }` | `Date.now` | the time |
-| `send` | `Sender` | `sendMail` | delivers one session; a custom one should return `dsnOffered` (leave it out and no `relayed` DSN is ever sent) |
+| `reuse` | `false \| { maxMessages?, idleSeconds? }` | `{ maxMessages: 100, idleSeconds: 5 }` | connection pool the queue owns and `stop()` closes; `false`: one connection per session; see [Reusing connections](#reusing-connections) |
+| `send` | `Sender` | the queue's pool, or `sendMail` with `reuse: false` | delivers one session; a custom one should return `dsnOffered` (leave it out and no `relayed` DSN is ever sent) |
 | `random` | `() => number` | `Math.random` | the jitter |

package/docs/roadmap.md

@@ -6,7 +6,7 @@ only number on it.
 
 ## Now
 
-Nothing under way.
+Nothing is under way.
 
 ## Next
 
@@ -15,14 +15,11 @@ Nothing under way.
   certificate checked against the policy's MX names, and the reports.
 - **DANE (RFC 7672)** — TLSA records checked for MX hosts, once a
   resolver that validates DNSSEC can be given to the queue.
-- **One session for several messages** — the queue hands several items
-  for one domain to one SMTP session, once `@bumail/smtp`'s client reuses
-  connections.
-- **The contract's specs, exported**, so a store written outside this
-  package can hold itself to them.
 
 ## Later
 
+- **A suite that is not tied to `bun:test`** — the contract's specs run under
+  any test runner, for a store written where Bun is not the runner.
 - **REQUIRETLS (RFC 8689)** — a message that asks for TLS all the way is
   never sent in clear, and fails rather than downgrade.
 - **Retries per recipient** — a schedule of its own for each recipient,
@@ -46,6 +43,23 @@ Nothing under way.
 
 ## Shipped
 
+### 0.13.0
+
+- **One session for several messages** — the queue delivers several
+  messages for one MX over one connection, using `@bumail/smtp`'s pool of
+  reusable connections. On by default (100 messages per connection, idle 5
+  seconds); `reuse: false` turns it off, and a `send` of your own is never
+  wrapped. `stop()` closes the pool, and the events may carry `reused`. The
+  `QueueStore` contract does not change.
+
+### 0.12.0
+
+- **The contract's specs, exported** — `@bumail/queue/conformance` exports
+  `describeQueueStore(name, { create, share?, dispose? })`, run under
+  `bun test`, so a queue store written outside this package runs the same
+  contract suite as the built-in ones; a capability a store lacks shows as a
+  skipped test with its reason. Additive.
+
 ### 0.11.0
 
 - **A DSN recorded in the same step as the outcome** — the failure, relayed

package/docs/troubleshooting.md

@@ -28,6 +28,9 @@ parts shown as … vary.
 - [`QueueError: timeouts.… must be a number of seconds above 0 and at most 2147483, not …`](#queueerror-timeouts-must-be-a-number-of-seconds-above-0-and-at-most-2147483-not-)
 - [`QueueError: store must be a QueueStore, such as MemoryQueueStore`](#queueerror-store-must-be-a-queuestore-such-as-memoryqueuestore)
 - [`QueueError: … must be an integer of at least …, not …`](#queueerror--must-be-an-integer-of-at-least--not-)
+- [`QueueError: reuse must be false or an object of limits, not …`](#queueerror-reuse-must-be-false-or-an-object-of-limits-not-)
+- [`QueueError: reuse.idleSeconds must be a number of seconds above 0 and at most 2147483, not …`](#queueerror-reuseidleseconds-must-be-a-number-of-seconds-above-0-and-at-most-2147483-not-)
+- [`QueueError: reuse.maxMessages must be an integer of at least 1, not …`](#queueerror-reusemaxmessages-must-be-an-integer-of-at-least-1-not-)
 - [`QueueError: dsn.returnContent must be 'headers' or 'full', not …`](#queueerror-dsnreturncontent-must-be-headers-or-full-not-)
 - [`QueueError: createQueue() takes an options object`](#queueerror-createqueue-takes-an-options-object)
 - [`QueueError: owner must be a non-empty string`](#queueerror-owner-must-be-a-non-empty-string)
@@ -89,6 +92,11 @@ parts shown as … vary.
 - [`QueueError: reply.host must be a string`](#queueerror-replyhost-must-be-a-string)
 - [`QueueError: … holds a NUL or a lone surrogate, which a store cannot keep`](#queueerror--holds-a-nul-or-a-lone-surrogate-which-a-store-cannot-keep)
 
+**A store's spec** (`describeQueueStore`)
+
+- [`AggregateError: several stores failed to dispose`](#aggregateerror-several-stores-failed-to-dispose)
+- [`… (skipped: harness has no share)` in the test names](#-skipped-harness-has-no-share-in-the-test-names)
+
 **Delivery**
 
 - [A recipient stays `deferred` with `4.4.1` or `4.4.2`](#a-recipient-stays-deferred-with-441-or-442)
@@ -297,6 +305,29 @@ or `… must be a number from … to …, not …`. A number option out of its r
 1), `dsn.delayAfter`, `limits.*` (`limits.maxReplyText` from 64 to
 900). Times are milliseconds.
 
+### `QueueError: reuse must be false or an object of limits, not …`
+
+**Code:** `INVALID`. `reuse` was `true`, `null` or another value. Give
+`false` for one connection per session, an object of limits, or leave it out
+for the defaults.
+
+```ts
+createQueue({ store, hostname, resolver, reuse: { maxMessages: 50 } });
+createQueue({ store, hostname, resolver, reuse: false });
+```
+
+### `QueueError: reuse.idleSeconds must be a number of seconds above 0 and at most 2147483, not …`
+
+**Code:** `INVALID`. `reuse.idleSeconds` is in seconds, not milliseconds:
+`5`, not `5000`. `reuse.maxMessages` has its own entry below.
+
+### `QueueError: reuse.maxMessages must be an integer of at least 1, not …`
+
+**Code:** `INVALID`. `reuse.maxMessages` is `0`, negative, fractional or not a
+number. The pool owns the limits and checks them when `createQueue` runs;
+the message is the pool's, prefixed with `reuse.`. Pass an integer of at
+least 1, or leave it out for the default (100).
+
 ### `QueueError: dsn.returnContent must be 'headers' or 'full', not …`
 
 **Code:** `INVALID`.
@@ -545,6 +576,43 @@ it.
 default. The error from a transaction of your own on the same client is
 yours to retry.
 
+## Your own store's spec
+
+### `AggregateError: several stores failed to dispose`
+
+`describeQueueStore`, after a test. The test created more than one store
+(a spec that calls `create` again, as the several-workers tests do) and
+the `dispose` of more than one of them threw. The suite disposes every
+store it created, collects the failures and throws them together; each
+reason is in `error.errors`. A single failure is thrown as it is, not
+wrapped.
+
+**Fix:** read `error.errors`; each entry is one store's failure. The suite
+calls `dispose` once per created store, so the causes are a store's own
+`close` failing (each entry says why), or a `create` that hands back a
+shared object, so that each test's `dispose` closes the same thing. Have
+`create` return a fresh store each call. Handles from `share` are not passed
+to `dispose`; close them in the harness.
+
+```ts
+create: () => new MyQueueStore(freshPath()), // a new store each call, never a shared one
+```
+
+### `… (skipped: harness has no share)` in the test names
+
+`describeQueueStore`. The harness passed no `share`, so the two tests of
+"several workers" (many claimers race, a crashed worker's items) are
+registered as skipped. This is not a failure, but the atomicity of a claim
+across handles is then unproved.
+
+**Fix:** pass `share`, which returns another handle on the same queue (a
+second connection to the same database), and give a networked store a real
+second connection:
+
+```ts
+share: (store) => (store as MyQueueStore).connectAgain(),
+```
+
 ## The `bun:sqlite` store
 
 ### `QueueError: A SQLite queue store needs a directory`

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@bumail/queue",
-	"version": "0.11.0",
+	"version": "0.13.0",
 	"description": "The outbound mail queue of a mail server: every recipient's state, retries with back-off, delivery status notifications (RFC 3464), leases for several workers, and a memory, a bun:sqlite, a PostgreSQL (Bun.sql) and a Redis (Bun.redis) store, delivering through @bumail/smtp/client",
 	"license": "MIT",
 	"type": "module",
@@ -39,6 +39,11 @@
 			"import": "./dist/redis/index.js",
 			"default": "./dist/redis/index.js"
 		},
+		"./conformance": {
+			"types": "./dist/conformance/index.d.ts",
+			"import": "./dist/conformance/index.js",
+			"default": "./dist/conformance/index.js"
+		},
 		"./package.json": "./package.json"
 	},
 	"repository": {
@@ -61,18 +66,19 @@
 			"src/memory/index.ts",
 			"src/sqlite/index.ts",
 			"src/postgres/index.ts",
-			"src/redis/index.ts"
+			"src/redis/index.ts",
+			"src/conformance/index.ts"
 		]
 	},
 	"devDependencies": {
 		"@bumail/dns": "^0.2.2",
 		"@bumail/mime": "^0.2.0",
-		"@bumail/smtp": "^0.11.1",
+		"@bumail/smtp": "^0.12.0",
 		"@types/bun": "^1.4.2"
 	},
 	"peerDependencies": {
 		"@bumail/mime": "^0.2.0",
-		"@bumail/smtp": "^0.11.1",
+		"@bumail/smtp": "^0.12.0",
 		"typescript": "^6.0.3 || ^7.0.0"
 	},
 	"peerDependenciesMeta": {