@bumail/smtp 0.11.1 → 0.12.1

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

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

package/dist/client/pool/idle.d.ts

@@ -0,0 +1,10 @@
+import type { Clock } from '../target';
+import { type Identity } from './options';
+import { type Entry, type PoolState } from './state';
+/** Takes `entry` out of the idle list and stops its timer. */
+export declare function forget(state: PoolState, entry: Entry): void;
+/** Keeps the connection for the next message, or says goodbye when it is spent. */
+export declare function release(state: PoolState, entry: Entry): void;
+/** An idle connection to the same server, reset; none when no one is fit. */
+export declare function borrow(state: PoolState, identity: Identity, seconds: number, clock: Clock): Promise<Entry | undefined>;
+//# sourceMappingURL=idle.d.ts.map

package/dist/client/pool/idle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idle.d.ts","sourceRoot":"","sources":["../../../src/client/pool/idle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,KAAK,QAAQ,EAAgB,MAAM,WAAW,CAAC;AAExD,OAAO,EAAQ,KAAK,KAAK,EAAU,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAEnE,8DAA8D;AAC9D,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAI3D;AAED,mFAAmF;AACnF,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAwB5D;AAED,6EAA6E;AAC7E,wBAAsB,MAAM,CAC3B,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,KAAK,GACV,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAa5B"}

package/dist/client/pool/index.d.ts

@@ -0,0 +1,18 @@
+import type { MessageSource, SendMailOptions, SendMailResult } from '../options';
+import { type SmtpPoolOptions } from './options';
+export type { SmtpPoolOptions } from './options';
+/** A pool of SMTP connections: a delivery takes an idle one to the same server, as `sendMail` would open, or opens one. */
+export interface SmtpPool {
+    /** `sendMail`, over a pooled connection. `result.reused` tells whether one carried a message before. */
+    sendMail(message: MessageSource, options: SendMailOptions): Promise<SendMailResult>;
+    /** QUITs the idle connections, waits for the busy ones, and refuses any further `sendMail` with `STOPPED`. */
+    close(): Promise<void>;
+}
+/**
+ * Creates a pool. Connections are kept apart by what they are: server
+ * address, greeting name, TLS and credentials. One is reset (RSET) when it
+ * is lent, and closed after a 421, a timeout, a bad reply, a lost stream,
+ * or bytes it was not asked for.
+ */
+export declare function createSmtpPool(options?: SmtpPoolOptions): SmtpPool;
+//# sourceMappingURL=index.d.ts.map

package/dist/client/pool/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/pool/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,aAAa,EACb,eAAe,EACf,cAAc,EACd,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAI3D,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,2HAA2H;AAC3H,MAAM,WAAW,QAAQ;IACxB,wGAAwG;IACxG,QAAQ,CACP,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,eAAe,GACtB,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3B,8GAA8G;IAC9G,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,QAAQ,CAiClE"}

package/dist/client/pool/options.d.ts

@@ -0,0 +1,26 @@
+import { type ConnectionSettings } from '../settings';
+import type { Endpoint } from '../target';
+/** How a pool keeps its connections. */
+export interface SmtpPoolOptions {
+    /** Messages one connection carries before it is closed. Default 100. */
+    readonly maxMessages?: number;
+    /** Seconds an idle connection waits for another message. Default 5. */
+    readonly idleSeconds?: number;
+    /** Seconds a connection lives, from its opening. Default 300. */
+    readonly maxAgeSeconds?: number;
+    /** Idle connections kept per mail host. Default 4. */
+    readonly maxIdlePerHost?: number;
+}
+/** `SmtpPoolOptions` checked, with their defaults. */
+export type PoolLimits = Required<SmtpPoolOptions>;
+/** Checks the options; throws `INVALID_OPTION`. */
+export declare function limitsOf(options?: SmtpPoolOptions): PoolLimits;
+/** What a connection is: where it goes and how it greets, secures and authenticates. Timeouts and the envelope are the message's. */
+export interface Identity extends Endpoint {
+    readonly connection: Omit<ConnectionSettings, 'timeouts'>;
+}
+/** Whether two connections are the same, field by field: credentials included, and never joined into a string key. */
+export declare function sameIdentity(a: Identity, b: Identity): boolean;
+/** The identity of a delivery to `endpoint`. */
+export declare const identityOf: (endpoint: Endpoint, settings: ConnectionSettings) => Identity;
+//# sourceMappingURL=options.d.ts.map

package/dist/client/pool/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../src/client/pool/options.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,kBAAkB,EAAe,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC/B,wEAAwE;IACxE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,uEAAuE;IACvE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,iEAAiE;IACjE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,sDAAsD;IACtD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,sDAAsD;AACtD,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAC;AAwBnD,mDAAmD;AACnD,wBAAgB,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,UAAU,CASlE;AAED,qIAAqI;AACrI,MAAM,WAAW,QAAS,SAAQ,QAAQ;IACzC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;CAC1D;AAoBD,sHAAsH;AACtH,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAc9D;AAED,gDAAgD;AAChD,eAAO,MAAM,UAAU,GACtB,UAAU,QAAQ,EAClB,UAAU,kBAAkB,KAC1B,QAYD,CAAC"}

package/dist/client/pool/reset.d.ts

@@ -0,0 +1,9 @@
+import type { Clock } from '../target';
+import type { Entry } from './state';
+/** Seconds to wait for the reply to an RSET, at most: a silent dead connection is stale, not worth 300 s. */
+export declare const RESET_WAIT = 5;
+/** RSET, answered 250 within `seconds`; false when the connection is no good. */
+export declare function reset(entry: Entry, clock: Clock, seconds: number): Promise<boolean>;
+/** A reused connection that died before the server answered MAIL FROM: nothing was taken. */
+export declare const stale: (entry: Entry, before: number, error: unknown) => boolean;
+//# sourceMappingURL=reset.d.ts.map

package/dist/client/pool/reset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset.d.ts","sourceRoot":"","sources":["../../../src/client/pool/reset.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,6GAA6G;AAC7G,eAAO,MAAM,UAAU,IAAI,CAAC;AAE5B,iFAAiF;AACjF,wBAAsB,KAAK,CAC1B,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED,6FAA6F;AAC7F,eAAO,MAAM,KAAK,GAAI,OAAO,KAAK,EAAE,QAAQ,MAAM,EAAE,OAAO,OAAO,KAAG,OAKrC,CAAC"}

package/dist/client/pool/send.d.ts

@@ -0,0 +1,8 @@
+import type { Content } from '../content';
+import type { SendMailResult } from '../options';
+import type { ClientSettings } from '../settings';
+import { Clock, type Endpoint } from '../target';
+import { type PoolState } from './state';
+/** One delivery to one server address, over a pooled connection when there is one. */
+export declare function attempt(state: PoolState, endpoint: Endpoint, settings: ClientSettings, content: Content, clock: Clock): Promise<SendMailResult>;
+//# sourceMappingURL=send.d.ts.map

package/dist/client/pool/send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../../src/client/pool/send.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AAKjD,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AA+C7D,sFAAsF;AACtF,wBAAsB,OAAO,CAC5B,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,GACV,OAAO,CAAC,cAAc,CAAC,CAqBzB"}

package/dist/client/pool/state.d.ts

@@ -0,0 +1,28 @@
+import type { Ready } from '../session';
+import type { ClientSocket } from '../socket';
+import type { Identity, PoolLimits } from './options';
+/** A connection past its opening, between messages or lent. */
+export interface Entry {
+    readonly socket: ClientSocket;
+    readonly ready: Ready;
+    readonly identity: Identity;
+    readonly born: number;
+    messages: number;
+    timer?: Timer;
+}
+/** What a pool holds; the functions of this folder act on it. */
+export interface PoolState {
+    readonly limits: PoolLimits;
+    readonly idle: Entry[];
+    /** Messages in flight. */
+    readonly busy: Set<Promise<unknown>>;
+    /** Connections of aborted messages being reset in the background. */
+    readonly resetting: Set<Promise<void>>;
+    closed: boolean;
+}
+export declare const newState: (limits: PoolLimits) => PoolState;
+/** Closes a connection, saying QUIT first unless `polite` is false (it is dead or out of step). */
+export declare function hangUp(entry: Entry, polite?: boolean): void;
+/** Whether the connection outlived `maxAgeSeconds`. */
+export declare const aged: (state: PoolState, entry: Entry) => boolean;
+//# sourceMappingURL=state.d.ts.map

package/dist/client/pool/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/client/pool/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEtD,+DAA+D;AAC/D,MAAM,WAAW,KAAK;IACrB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC;CACd;AAED,iEAAiE;AACjE,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IACvB,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IACrC,qEAAqE;IACrE,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACvC,MAAM,EAAE,OAAO,CAAC;CAChB;AAED,eAAO,MAAM,QAAQ,GAAI,QAAQ,UAAU,KAAG,SAM5C,CAAC;AAEH,mGAAmG;AACnG,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,UAAO,GAAG,IAAI,CAIxD;AAED,uDAAuD;AACvD,eAAO,MAAM,IAAI,GAAI,OAAO,SAAS,EAAE,OAAO,KAAK,KAAG,OACc,CAAC"}

package/dist/client/send.d.ts

@@ -1,6 +1,15 @@
-import type { MessageSource, SendMailOptions, SendMailResult } from './options';
+import { type Content } from './content';
+import type { MessageSource, MxDestination, SendMailOptions, SendMailResult } from './options';
+import { type ClientSettings } from './settings';
+import { Clock, type Endpoint } from './target';
 /** The most addresses one delivery tries, every MX host together; and the most MX hosts it looks up. */
 export declare const MAX_ADDRESSES = 10;
+/** One delivery to one server address: a fresh session here, a pooled one in `pool.ts`. */
+export type Attempt = (endpoint: Endpoint, settings: ClientSettings, content: Content, clock: Clock) => Promise<SendMailResult>;
+/** Direct delivery, by `try_`: each MX host's addresses in turn, while the failures are temporary and before MAIL FROM. */
+export declare function viaMx(try_: Attempt, options: MxDestination, settings: ClientSettings, content: Content, clock: Clock): Promise<SendMailResult>;
+/** Where the options send the message: a host, or a domain's mail hosts by MX; each address is tried by `try_`. */
+export declare function deliver(try_: Attempt, options: SendMailOptions, settings: ClientSettings, content: Content, clock: Clock): Promise<SendMailResult>;
 /**
  * Delivers one message to one destination: a host (`{ host, port }`, a
  * smarthost or a submission server) or a domain's mail hosts (`{ domain,

package/dist/client/send.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../src/client/send.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACX,aAAa,EAEb,eAAe,EACf,cAAc,EACd,MAAM,WAAW,CAAC;AAcnB,wGAAwG;AACxG,eAAO,MAAM,aAAa,KAAK,CAAC;AAgIhC;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC7B,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,eAAe,GACtB,OAAO,CAAC,cAAc,CAAC,CAYzB"}
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../src/client/send.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,OAAO,EAAa,MAAM,WAAW,CAAC;AAEpD,OAAO,KAAK,EACX,aAAa,EACb,aAAa,EACb,eAAe,EACf,cAAc,EACd,MAAM,WAAW,CAAC;AAEnB,OAAO,EAEN,KAAK,cAAc,EAInB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,KAAK,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGhD,wGAAwG;AACxG,eAAO,MAAM,aAAa,KAAK,CAAC;AAKhC,2FAA2F;AAC3F,MAAM,MAAM,OAAO,GAAG,CACrB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,KACR,OAAO,CAAC,cAAc,CAAC,CAAC;AAmC7B,2HAA2H;AAC3H,wBAAsB,KAAK,CAC1B,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,GACV,OAAO,CAAC,cAAc,CAAC,CAgDzB;AAED,mHAAmH;AACnH,wBAAgB,OAAO,CACtB,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,GACV,OAAO,CAAC,cAAc,CAAC,CASzB;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC7B,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,eAAe,GACtB,OAAO,CAAC,cAAc,CAAC,CAUzB"}

package/dist/client/session.d.ts

@@ -1,4 +1,4 @@
-import type { ClientSettings } from './settings';
+import type { ConnectionSettings } from './settings';
 import type { ClientSocket } from './socket';
 import type { TlsTarget } from './target';
 /** A session past its greeting, EHLO, STARTTLS and AUTH: what the server offers. */
@@ -7,5 +7,5 @@ export interface Ready {
     readonly authenticated: boolean;
 }
 /** The greeting, EHLO, STARTTLS and AUTH: a session ready for MAIL FROM. */
-export declare function open(socket: ClientSocket, settings: ClientSettings, tls: TlsTarget): Promise<Ready>;
+export declare function open(socket: ClientSocket, settings: ConnectionSettings, tls: TlsTarget): Promise<Ready>;
 //# sourceMappingURL=session.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/client/session.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,oFAAoF;AACpF,MAAM,WAAW,KAAK;IACrB,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CAChC;AAqGD,4EAA4E;AAC5E,wBAAsB,IAAI,CACzB,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,cAAc,EACxB,GAAG,EAAE,SAAS,GACZ,OAAO,CAAC,KAAK,CAAC,CAchB"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/client/session.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,oFAAoF;AACpF,MAAM,WAAW,KAAK;IACrB,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CAChC;AAqGD,4EAA4E;AAC5E,wBAAsB,IAAI,CACzB,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,kBAAkB,EAC5B,GAAG,EAAE,SAAS,GACZ,OAAO,CAAC,KAAK,CAAC,CAchB"}

package/dist/client/settings.d.ts

@@ -3,22 +3,28 @@ import { type DsnSettings } from './dsn';
 import type { MxDestination, SendMailAuth, SendMailEnvelope, SendMailOptions, SendMailTimeouts, TlsMode } from './options';
 /** The longest delay `setTimeout` takes, in seconds: past 2^31 − 1 ms it fires after 1 ms. */
 export declare const MAX_SECONDS: number;
-/** The options, checked, with their defaults; timeouts in seconds. */
-export interface ClientSettings {
-    readonly from: string;
-    readonly to: readonly string[];
+/** What a connection is: where it greets from, how it secures and authenticates, how long each wait lasts (seconds). Shared by every message sent over it. */
+export interface ConnectionSettings {
     readonly helo: string;
     readonly tls: TlsMode;
     readonly secure: boolean;
     readonly ca?: readonly string[];
     readonly auth?: SendMailAuth;
     readonly allowPlaintextAuth: boolean;
+    readonly timeouts: Required<SendMailTimeouts>;
+}
+/** What one message is: its envelope, its size, its DSN request, how its lines end. */
+export interface EnvelopeSettings {
+    readonly from: string;
+    readonly to: readonly string[];
     readonly size?: number;
     readonly dsn: DsnSettings;
     /** An address is not ASCII, or `smtputf8` asked for it. */
     readonly smtputf8: boolean;
     readonly normalizeLineEnds: boolean;
-    readonly timeouts: Required<SendMailTimeouts>;
+}
+/** The options, checked, with their defaults: the connection's, the envelope's, and the transaction's `deadline` in seconds. */
+export interface ClientSettings extends ConnectionSettings, EnvelopeSettings {
     readonly deadline: number;
 }
 /** `INVALID_OPTION`, for an option `sendMail` cannot take. */

package/dist/client/settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/client/settings.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,OAAO,EAAE,KAAK,WAAW,EAAS,MAAM,OAAO,CAAC;AAChD,OAAO,KAAK,EACX,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,OAAO,EACP,MAAM,WAAW,CAAC;AAEnB,8FAA8F;AAC9F,eAAO,MAAM,WAAW,QAAmC,CAAC;AAc5D,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AAED,8DAA8D;AAC9D,eAAO,MAAM,OAAO,GAAI,SAAS,MAAM,cACmB,CAAC;AA4G3D,4FAA4F;AAC5F,wBAAgB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAgCnE;AAED,yEAAyE;AACzE,eAAO,MAAM,IAAI,GAChB,SAAS,eAAe,KACtB,OAAO,IAAI,gBAAgB,GAAG,aACkB,CAAC;AAEpD,0CAA0C;AAC1C,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKzE"}
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/client/settings.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,OAAO,EAAE,KAAK,WAAW,EAAS,MAAM,OAAO,CAAC;AAChD,OAAO,KAAK,EACX,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,OAAO,EACP,MAAM,WAAW,CAAC;AAEnB,8FAA8F;AAC9F,eAAO,MAAM,WAAW,QAAmC,CAAC;AAc5D,8JAA8J;AAC9J,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;CAC9C;AAED,uFAAuF;AACvF,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;CACpC;AAED,gIAAgI;AAChI,MAAM,WAAW,cAAe,SAAQ,kBAAkB,EAAE,gBAAgB;IAC3E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AAED,8DAA8D;AAC9D,eAAO,MAAM,OAAO,GAAI,SAAS,MAAM,cACmB,CAAC;AA4G3D,4FAA4F;AAC5F,wBAAgB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAgCnE;AAED,yEAAyE;AACzE,eAAO,MAAM,IAAI,GAChB,SAAS,eAAe,KACtB,OAAO,IAAI,gBAAgB,GAAG,aACkB,CAAC;AAEpD,0CAA0C;AAC1C,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKzE"}

package/dist/client/socket-events.d.ts

@@ -0,0 +1,15 @@
+import type { SocketHandler } from 'bun';
+import { SmtpError } from '../errors';
+import { type Endpoint } from './target';
+/** What a socket's events do to its `ClientSocket`. */
+export interface SocketHooks {
+    readonly receive: (chunk: Uint8Array) => void;
+    readonly drain: () => void;
+    readonly lost: () => void;
+    readonly handshake: (ok: boolean, error: Error | null) => void;
+}
+/** Bun's events for one socket: only the live one's count (`live`), the clear one's or, after STARTTLS, the TLS one's. */
+export declare function socketHandlers(live: () => boolean, hooks: SocketHooks): SocketHandler<undefined>;
+/** `error` as the connect step failed it: an `SmtpError` as it is, else `CONNECTION_FAILED`. */
+export declare const connectFailure: (endpoint: Endpoint, error: unknown) => SmtpError;
+//# sourceMappingURL=socket-events.d.ts.map

package/dist/client/socket-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-events.d.ts","sourceRoot":"","sources":["../../src/client/socket-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,KAAK,QAAQ,EAAU,MAAM,UAAU,CAAC;AAEjD,uDAAuD;AACvD,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,CAAC;CAC/D;AAED,0HAA0H;AAC1H,wBAAgB,cAAc,CAC7B,IAAI,EAAE,MAAM,OAAO,EACnB,KAAK,EAAE,WAAW,GAChB,aAAa,CAAC,SAAS,CAAC,CAe1B;AAED,gGAAgG;AAChG,eAAO,MAAM,cAAc,GAC1B,UAAU,QAAQ,EAClB,OAAO,OAAO,KACZ,SAMC,CAAC"}

package/dist/client/socket-waits.d.ts

@@ -0,0 +1,36 @@
+import type { SmtpError } from '../errors';
+import type { Reply } from '../protocol/reply';
+import type { Inbox } from './inbox';
+import type { Clock } from './target';
+/** What the waits read from their `ClientSocket`, and how they fail it. */
+export interface WaitsHooks {
+    readonly host: string;
+    readonly clock: () => Clock;
+    readonly inbox: Inbox;
+    readonly failure: () => SmtpError | undefined;
+    readonly closed: () => boolean;
+    readonly fail: (error: SmtpError) => SmtpError;
+    readonly hungUp: (otherwise: SmtpError) => SmtpError;
+}
+/** The waits of a `ClientSocket`: the reply loop and the caller's promises, each bounded by its timeout and the deadline. */
+export declare class Waits {
+    #private;
+    private readonly hooks;
+    /** Replies read so far. */
+    get replies(): number;
+    constructor(hooks: WaitsHooks);
+    /** Wakes the reply loop: something arrived, or the connection went. */
+    wakeUp(): void;
+    /** Cuts short every `within` pending: the connection is gone. */
+    release(): void;
+    /**
+     * `promise`, or a `TIMEOUT` once `seconds` passed since `start` (now by
+     * default), or the deadline did, whichever comes first.
+     */
+    race<T>(promise: Promise<T>, seconds: number, what: string, start?: number): Promise<T>;
+    /** The next reply, within `seconds` all told; `what` names it in errors: `the greeting`, `the reply to MAIL FROM`. */
+    reply(what: string, seconds: number): Promise<Reply>;
+    /** One of the caller's promises — the message stream's next part — bounded as a reply is, and cut short if the connection goes (a hang-up after it settled is none of its business). */
+    within<T>(promise: Promise<T>, seconds: number, what: string): Promise<T>;
+}
+//# sourceMappingURL=socket-waits.d.ts.map

package/dist/client/socket-waits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-waits.d.ts","sourceRoot":"","sources":["../../src/client/socket-waits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC,2EAA2E;AAC3E,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,SAAS,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,SAAS,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,SAAS,CAAC;CACrD;AAED,6HAA6H;AAC7H,qBAAa,KAAK;;IAUL,OAAO,CAAC,QAAQ,CAAC,KAAK;IALlC,2BAA2B;IAC3B,IAAI,OAAO,IAAI,MAAM,CAEpB;gBAE4B,KAAK,EAAE,UAAU;IAE9C,uEAAuE;IACvE,MAAM,IAAI,IAAI;IAMd,iEAAiE;IACjE,OAAO,IAAI,IAAI;IAIf;;;OAGG;IACH,IAAI,CAAC,CAAC,EACL,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,KAAK,SAAoB,GACvB,OAAO,CAAC,CAAC,CAAC;IASb,sHAAsH;IAChH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAuB1D,wLAAwL;IACxL,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAmBzE"}

package/dist/client/socket.d.ts

@@ -9,23 +9,33 @@ import { type Clock, type Endpoint, type TlsTarget } from './target';
 export declare class ClientSocket {
     #private;
     readonly host: string;
+    /** Times the waits; only the sender or pool sets it (a new `Clock` per transaction), never while a wait is pending. */
+    clock: Clock;
     secure: boolean;
+    /** Replies read so far: a failure with the same count as before a command got no reply to it. */
+    get replies(): number;
     /** The certificate checked out against the host name. */
     verified: boolean;
     private constructor();
-    /** Connects, with TLS from the first byte when `tls` is given. */
-    static open(endpoint: Endpoint, tls: TlsTarget | undefined, seconds: number, clock: Clock): Promise<ClientSocket>;
     /** The next reply, within `seconds` all told; `what` names it in errors: `the greeting`, `the reply to MAIL FROM`. */
     reply(what: string, seconds: number): Promise<Reply>;
     /** One of the caller's promises — the message stream's next part — bounded as a reply is, and cut short if the connection goes (a hang-up after it settled is none of its business). */
     within<T>(promise: Promise<T>, seconds: number, what: string): Promise<T>;
-    /** Queues bytes for the server; nothing once the connection failed. Whether it did queue them. */
+    /** Connects, with TLS from the first byte when `tls` is given. */
+    static open(endpoint: Endpoint, tls: TlsTarget | undefined, seconds: number, clock: Clock): Promise<ClientSocket>;
+    /** Queues bytes; false once the connection failed. */
     write(data: Uint8Array | string): boolean;
     /** Waits until the server took everything written. */
     drained(seconds: number): Promise<void>;
     /** After the 220 to STARTTLS: TLS on this connection. Anything the server sent past the 220 is an attack. */
     startTls(tls: TlsTarget, seconds: number): Promise<void>;
-    /** Hangs up; `now` at once, so a message cut short is not delivered. */
+    /** Alive and silent: nothing failed, closed, or arrived unasked. A pool checks it before it lends the connection. */
+    get quiet(): boolean;
+    /** Whether the open connection keeps the process alive: a pool unrefs an idle one. */
+    ref(keep: boolean): void;
+    /** A new message: the server's reply budget starts over. */
+    newMessage(): void;
+    /** Hangs up; `now` at once, so a cut message is not delivered. */
     close(now?: boolean): void;
 }
 //# sourceMappingURL=socket.d.ts.map

package/dist/client/socket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../src/client/socket.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,EACN,KAAK,KAAK,EACV,KAAK,QAAQ,EAEb,KAAK,SAAS,EAEd,MAAM,UAAU,CAAC;AAElB;;;;;GAKG;AACH,qBAAa,YAAY;;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAatB,MAAM,UAAS;IACf,yDAAyD;IACzD,QAAQ,UAAS;IAEjB,OAAO;IAKP,kEAAkE;WACrD,IAAI,CAChB,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,SAAS,GAAG,SAAS,EAC1B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,KAAK,GACV,OAAO,CAAC,YAAY,CAAC;IAwHxB,sHAAsH;IAChH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAkB1D,wLAAwL;IACxL,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAWzE,kGAAkG;IAClG,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO;IAQzC,sDAAsD;IAChD,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB7C,6GAA6G;IACvG,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB9D,wEAAwE;IACxE,KAAK,CAAC,GAAG,UAAQ,GAAG,IAAI;CAKxB"}
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../src/client/socket.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAK/C,OAAO,EACN,KAAK,KAAK,EACV,KAAK,QAAQ,EAEb,KAAK,SAAS,EAEd,MAAM,UAAU,CAAC;AAElB;;;;;GAKG;AACH,qBAAa,YAAY;;IAkBvB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,uHAAuH;IAChH,KAAK,EAAE,KAAK;IAXpB,MAAM,UAAS;IACf,iGAAiG;IACjG,IAAI,OAAO,IAAI,MAAM,CAEpB;IACD,yDAAyD;IACzD,QAAQ,UAAS;IAEjB,OAAO;IAgBP,sHAAsH;IACtH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAIpD,wLAAwL;IACxL,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAIzE,kEAAkE;WACrD,IAAI,CAChB,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,SAAS,GAAG,SAAS,EAC1B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,KAAK,GACV,OAAO,CAAC,YAAY,CAAC;IA2FxB,sDAAsD;IACtD,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO;IAQzC,sDAAsD;IAChD,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB7C,6GAA6G;IACvG,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB9D,qHAAqH;IACrH,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,sFAAsF;IACtF,GAAG,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAKxB,4DAA4D;IAC5D,UAAU,IAAI,IAAI;IAIlB,kEAAkE;IAClE,KAAK,CAAC,GAAG,UAAQ,GAAG,IAAI;CAKxB"}

package/dist/client/transaction.d.ts

@@ -2,7 +2,7 @@ import { type RecipientReply } from '../errors';
 import type { Reply } from '../protocol/reply';
 import { type Content } from './content';
 import type { Ready } from './session';
-import type { ClientSettings } from './settings';
+import type { ConnectionSettings, EnvelopeSettings } from './settings';
 import type { ClientSocket } from './socket';
 /** What the server said to the envelope and the message. */
 export interface Delivered {
@@ -12,6 +12,12 @@ export interface Delivered {
     /** The server lists DSN. */
     readonly dsnOffered: boolean;
 }
-/** One message: the envelope, then the content. */
-export declare function transact(socket: ClientSocket, settings: ClientSettings, content: Content, ready: Ready): Promise<Delivered>;
+/** What `transact` returns: the server's answers. */
+export interface Transacted {
+    readonly delivered: Delivered;
+}
+/** Whether `error` came from `transact` with replies in order and the connection alive (a clean 4xx/5xx refusal, not a 421, a timeout, a bad reply or a lost connection); `RSET` before reuse. */
+export declare const inStep: (error: unknown) => boolean;
+/** One message: the envelope, then the content. A refusal throws, `inStep(error)` telling whether the session can go on. */
+export declare function transact(socket: ClientSocket, settings: ConnectionSettings & EnvelopeSettings, content: Content, ready: Ready): Promise<Transacted>;
 //# sourceMappingURL=transaction.d.ts.map

package/dist/client/transaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../src/client/transaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAa,MAAM,WAAW,CAAC;AAE3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAGxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,4DAA4D;AAC5D,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,4BAA4B;IAC5B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC7B;AAqJD,mDAAmD;AACnD,wBAAsB,QAAQ,CAC7B,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,GACV,OAAO,CAAC,SAAS,CAAC,CAiBpB"}
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../src/client/transaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAa,MAAM,WAAW,CAAC;AAE3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAGxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,4DAA4D;AAC5D,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,4BAA4B;IAC5B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC7B;AAED,qDAAqD;AACrD,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC9B;AAQD,kMAAkM;AAClM,eAAO,MAAM,MAAM,GAAI,OAAO,OAAO,KAAG,OAC0B,CAAC;AA2KnE,4HAA4H;AAC5H,wBAAsB,QAAQ,CAC7B,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,kBAAkB,GAAG,gBAAgB,EAC/C,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,GACV,OAAO,CAAC,UAAU,CAAC,CAgCrB"}

package/docs/README.md

@@ -5,6 +5,6 @@ long one.
 
 | Page | Read it when |
 | --- | --- |
-| [Guide](guide.md) | running an MX, a submission server or implicit TLS; reading what a reply means; writing hooks and keeping state in `Session.data`; handling what `onData` receives; delivering into `@bumail/store`; setting TLS, limits and `greetingDelay`; running behind a TCP proxy such as Traefik with the PROXY protocol; sending mail with `@bumail/smtp/client` and trying it with Mailpit; or checking which RFC a behaviour follows |
-| [Troubleshooting](troubleshooting.md) | `createSmtpServer` threw, the server will not listen, a client reports a reply you did not expect, connections through a proxy close or show the proxy's address, or `sendMail` rejected |
-| [Roadmap](roadmap.md) | wondering what is coming — connection reuse in the client, DSN, a ready-made delivery into the store — and what is not planned |
+| [Guide](guide.md) | running an MX, a submission server or implicit TLS; reading what a reply means; writing hooks and keeping state in `Session.data`; handling what `onData` receives; delivering into `@bumail/store`; setting TLS, limits and `greetingDelay`; running behind a TCP proxy such as Traefik with the PROXY protocol; sending mail with `@bumail/smtp/client`, reusing connections with `createSmtpPool`, and trying it with Mailpit; or checking which RFC a behaviour follows |
+| [Troubleshooting](troubleshooting.md) | `createSmtpServer` threw, the server will not listen, a client reports a reply you did not expect, connections through a proxy close or show the proxy's address, `sendMail` rejected, or `createSmtpPool` threw or reported that the pool is closed |
+| [Roadmap](roadmap.md) | wondering what is coming — DSN, a ready-made delivery into the store — and what is not planned |

package/docs/guide.md

@@ -1818,6 +1818,28 @@ try {
 }
 ```
 
+### Reusing connections: `createSmtpPool`
+
+`createSmtpPool(options?)` takes the pool's own options, below, all optional. It returns a pool whose `sendMail(message, options)` takes the options of `sendMail`. A delivery borrows an idle connection to the same server when there is one, and opens one otherwise; by MX, each address is borrowed in turn, in MX order.
+
+| option | default | |
+| --- | --- | --- |
+| `maxMessages` | 100 | messages one connection carries before QUIT |
+| `idleSeconds` | 5 | an idle connection is QUITted after this |
+| `maxAgeSeconds` | 300 | a connection older than this is not lent |
+| `maxIdlePerHost` | 4 | idle connections kept per mail host |
+
+What the pool guarantees:
+
+- **Same connection, same identity.** Server address, `helo`, `tls`, `secure`, `ca`, `allowPlaintextAuth` and the credentials are compared field by field; the password is never part of a string key. The envelope, `size`, DSN options and timeouts belong to the message.
+- **RSET on every borrow**, and after a message was aborted by a refusal. A connection is never reused after a 421, a timeout, a `BAD_REPLY`, a lost stream, or bytes the server sent while it was idle.
+- **A stale connection is invisible.** One that fails the RSET, or dies before the server answered MAIL FROM, is replaced once by a fresh connection; the caller gets that delivery's result, so a queue does not fall back to a smarthost for it.
+- **Extensions are per connection**: `SIZE`, `8BITMIME`, `SMTPUTF8` and `DSN` are checked for each message against the connection that carries it.
+- **`deadline` is per message.** Neither the idle timers nor the idle sockets keep the process alive; a pool left open does not hold a script up.
+- **`close()`** QUITs idle connections and waits for the busy ones; `sendMail` on a closed pool rejects with `STOPPED`.
+
+`result.reused` is `true` when the connection had carried a message before (plain `sendMail` leaves it out).
+
 ### Delivery by MX
 
 With `{ domain, resolver }`, `resolveMx` gives the hosts in the order to
@@ -2036,9 +2058,9 @@ each one comes from.
   unrecognized`; a client sends DATA instead.
 - **A queue.** The client tries a destination once and reports;
   retrying a temporary failure is the caller's job until `@bumail/queue`.
-- **Connection reuse.** The client opens one connection per message, and
-  sends no `RSET`. Several messages to one destination over one session is
-  on the [roadmap](roadmap.md).
+- **Connection reuse in `sendMail`.** `sendMail` opens one connection per
+  message and sends no `RSET`; for several messages to one destination over
+  one session, use `createSmtpPool` (see "Reusing connections: `createSmtpPool`").
 - **A non-ASCII `ORCPT` of type `rfc822` in the client**: RFC 6533 defines
   `utf-8` for it, which both sides handle; the client leaves a non-ASCII
   `rfc822` address out of `RCPT TO`. Any other type is relayed as xtext.

package/docs/roadmap.md

@@ -6,13 +6,10 @@ number on it.
 
 ## Now
 
-Nothing is under way besides what is marked shipped below.
+Nothing is under way.
 
 ## Next
 
-- **Connection reuse in the client** — several messages to one
-  destination over one session (`RSET` between them), for a queue that
-  delivers in batches. Today each `sendMail` opens its own connection.
 - **Delivery into `@bumail/store`, ready-made** — an `onData` that puts
   each message in its recipients' inboxes, instead of the few lines the
   [guide](guide.md#delivering-into-bumailstore) shows today. The store
@@ -32,6 +29,15 @@ Nothing yet.
 
 ## Shipped
 
+### 0.12.0
+
+- **Connection reuse in the client** — `createSmtpPool(options?)` in
+  `@bumail/smtp/client` keeps connections to a server between messages, so
+  several messages to one destination go over one session (`RSET` between
+  them) instead of each `sendMail` opening its own. `SendMailResult` may
+  carry `reused`; plain `sendMail` is unchanged. `@bumail/queue` and
+  `@bumail/server` deliver through it by default.
+
 ### 0.11.0
 
 - **UTF-8 `ORCPT` (RFC 6533)**: the server decodes `ORCPT=utf-8;…`

package/docs/troubleshooting.md

@@ -131,6 +131,13 @@ A reply carries its enhanced status code (`5.7.1`, RFC 3463) only after
 - [`SmtpError: sendMail(): a message stream must give Uint8Array chunks`](#smtperror-sendmail-a-message-stream-must-give-uint8array-chunks)
 - [`SmtpError: sendMail(): a message stream can be sent once only`](#smtperror-sendmail-a-message-stream-can-be-sent-once-only)
 
+**Sending mail: the pool**
+
+- [`SmtpError: The SMTP pool is closed`](#smtperror-the-smtp-pool-is-closed)
+- [`SmtpError: createSmtpPool(): … must be an integer of at least 1, not …`](#smtperror-createsmtppool--must-be-an-integer-of-at-least-1-not-)
+- [`SmtpError: createSmtpPool(): … must be a number of seconds above 0 and at most 2147483, not …`](#smtperror-createsmtppool--must-be-a-number-of-seconds-above-0-and-at-most-2147483-not-)
+- [`SmtpError: createSmtpPool(): options must be an object`](#smtperror-createsmtppool-options-must-be-an-object)
+
 **Sending mail: the message**
 
 - [`SmtpError: sendMail(): the message holds a bare CR or LF, which a server must refuse (SMTP smuggling); end every line with CRLF, or pass normalizeLineEnds: true`](#smtperror-sendmail-the-message-holds-a-bare-cr-or-lf-which-a-server-must-refuse-smtp-smuggling-end-every-line-with-crlf-or-pass-normalizelineends-true)
@@ -2229,6 +2236,83 @@ the final dot.
 
 **Fix**: make a new stream per `sendMail`, or pass bytes.
 
+## Sending mail: the pool
+
+### `SmtpError: The SMTP pool is closed`
+
+**When**: `pool.sendMail` is called after `pool.close()` (code `STOPPED`).
+
+**Why**: `close()` sends QUIT on the idle connections and waits for the
+busy ones; after it the pool has none and opens none. A message in flight
+when `close()` was called still finishes.
+
+**Fix**: close the pool only at shutdown, and stop sending first. (The pool
+of `@bumail/queue` and of `bumail serve` is closed by their own `stop()`,
+after their deliveries.) Make a
+new pool when sending must go on:
+
+```ts
+import { createSmtpPool } from '@bumail/smtp/client';
+
+let pool = createSmtpPool();
+// … at shutdown, after the last sendMail:
+await pool.close();
+// a later pool.sendMail rejects with STOPPED; make another pool to send again
+pool = createSmtpPool();
+```
+
+### `SmtpError: createSmtpPool(): … must be an integer of at least 1, not …`
+
+**When**: `maxMessages` or `maxIdlePerHost` is `0`, negative, fractional or
+not a number (code `INVALID_OPTION`, thrown by `createSmtpPool` itself).
+
+**Why**: a connection that carries no message, or a host that keeps no idle
+connection, is no pool; to turn reuse off, use `sendMail` instead.
+
+**Fix**: pass an integer of at least 1, or leave it out for its default
+(`maxMessages` 100, `maxIdlePerHost` 4):
+
+```ts
+import { createSmtpPool } from '@bumail/smtp/client';
+
+const pool = createSmtpPool({ maxMessages: 50, maxIdlePerHost: 2 });
+```
+
+### `SmtpError: createSmtpPool(): … must be a number of seconds above 0 and at most 2147483, not …`
+
+**When**: `idleSeconds` or `maxAgeSeconds` is `0`, negative, not a number, or
+past 2 147 483 seconds.
+
+**Why**: each is a `setTimeout`, which fires after 1 ms for a delay past
+2^31 − 1 ms.
+
+**Fix**: pass seconds, fractions allowed, or leave it out
+(`idleSeconds` 5, `maxAgeSeconds` 300):
+
+```ts
+import { createSmtpPool } from '@bumail/smtp/client';
+
+const pool = createSmtpPool({ idleSeconds: 10, maxAgeSeconds: 600 });
+```
+
+### `SmtpError: createSmtpPool(): options must be an object`
+
+**When**: `createSmtpPool` is given something that is not an object, such
+as `null` or a string.
+
+**Why**: the pool options are `maxMessages`, `idleSeconds`,
+`maxAgeSeconds` and `maxIdlePerHost`. The options of a message (`host`,
+`from`, `to`, …) go to `pool.sendMail`, not here.
+
+**Fix**: pass an object, or nothing:
+
+```ts
+import { createSmtpPool } from '@bumail/smtp/client';
+
+const pool = createSmtpPool();
+await pool.sendMail(message, { host: 'relay.example.net', from: 'a@example.com', to: 'b@example.org' });
+```
+
 ## Sending mail: the message
 
 ### `SmtpError: sendMail(): the message holds a bare CR or LF, which a server must refuse (SMTP smuggling); end every line with CRLF, or pass normalizeLineEnds: true`

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@bumail/smtp",
-	"version": "0.11.1",
+	"version": "0.12.1",
 	"description": "An SMTP server on Bun.listen — RFC 5321 with PIPELINING, SIZE, 8BITMIME, SMTPUTF8, STARTTLS and AUTH after TLS, policy hooks, and no open relay — and a client that delivers a message to a smarthost or by MX",
 	"license": "MIT",
 	"type": "module",
@@ -49,7 +49,7 @@
 	"devDependencies": {
 		"@bumail/auth": "^0.5.0",
 		"@bumail/dns": "^0.2.2",
-		"@bumail/store": "^0.6.1",
+		"@bumail/store": "^0.7.1",
 		"@types/bun": "^1.4.2"
 	},
 	"peerDependencies": {