@ddd-ts-kit/redis 0.0.0-stage → 0.1.1

package/dist/streams/publications.js

@@ -0,0 +1,75 @@
+import { encode } from './codec/encode.js';
+import { failureCode } from './errors/failure-code.js';
+import { PublishNotConfirmedError } from './errors/publish-not-confirmed-error.js';
+/**
+ * Appends unless the event id was appended within the window, and answers the entry id either
+ * way. The append comes first: were the mark written first, a failed append would make the
+ * retry believe the event is there. KEYS: mark, stream. ARGV: window, then the arguments of
+ * `XADD` after the key.
+ */
+const GUARDED_APPEND = `
+local known = redis.call('GET', KEYS[1])
+if known then
+  return known
+end
+local entry = redis.call('XADD', KEYS[2], unpack(ARGV, 2))
+redis.call('SET', KEYS[1], entry, 'PX', ARGV[1])
+return entry`;
+/**
+ * Publishing: one `XADD` per event, the whole batch in one `MULTI`. A publication succeeds
+ * only once the server answered an entry id for every event, which is what lets an outbox
+ * relay mark them published.
+ */
+export class Publications {
+    settings;
+    constructor(settings) {
+        this.settings = settings;
+    }
+    /** Resolves when every event has an entry; rejects with the first failure otherwise. */
+    async publish(client, events) {
+        const transaction = client.multi();
+        for (const event of events) {
+            this.append(transaction, event);
+        }
+        const answers = await executed(transaction, events);
+        events.forEach((event, index) => {
+            const [error, entryId] = answers[index] ?? [new Error('no answer'), undefined];
+            if (error !== null) {
+                throw new PublishNotConfirmedError(event.id, failureCode(error));
+            }
+            if (typeof entryId !== 'string') {
+                throw new PublishNotConfirmedError(event.id, 'NO_ENTRY_ID');
+            }
+        });
+    }
+    append(transaction, event) {
+        const stream = this.settings.streamOf(event.type);
+        const entry = [...trimming(this.settings.retention), '*', ...encode(event)];
+        const { deduplication } = this.settings;
+        if (deduplication === undefined) {
+            transaction.call('XADD', stream, ...entry);
+        }
+        else {
+            transaction.eval(GUARDED_APPEND, 2, `${stream}:${event.id}:published`, stream, deduplication.windowMs, ...entry);
+        }
+    }
+}
+/** A transaction the server did not answer, or refused as a whole, confirms none of its events. */
+async function executed(transaction, events) {
+    try {
+        return (await transaction.exec()) ?? [];
+    }
+    catch (error) {
+        throw new PublishNotConfirmedError(events[0]?.id ?? '', failureCode(error));
+    }
+}
+function trimming(retention) {
+    if (retention === undefined) {
+        return [];
+    }
+    if ('maxLength' in retention) {
+        return ['MAXLEN', '~', String(retention.maxLength)];
+    }
+    return ['MINID', '~', `${String(Date.now() - retention.maxAgeMs)}-0`];
+}
+//# sourceMappingURL=publications.js.map

package/dist/streams/publications.js.map

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

package/dist/streams/redis-streams-event-bus.d.ts

@@ -0,0 +1,55 @@
+import { inspect } from 'node:util';
+import type { EventBus, IntegrationEvent, IntegrationEventCallback, IntegrationEventSubscriber, Subscription } from '@ddd-ts-kit/kernel';
+import type { RedisStreamsEventBusOptions } from './options/redis-streams-event-bus-options.js';
+import type { ConsumerBinding } from './topology/consumer-binding.js';
+import type { RedisStreamsTopology } from './topology/redis-streams-topology.js';
+/**
+ * The provider on Redis Streams, for Redis, Dragonfly and Valkey.
+ *
+ * Publishing: one stream per event type, one `XADD` per event, and `publish` resolves only
+ * when the server answered an entry id for every event, so it is a safe target for the outbox
+ * relay. Consuming: one consumer group per consumer name, a blocking read on a dedicated
+ * connection, `XACK` after the handlers resolved, a bounded number of delayed redeliveries
+ * from the pending entry list, then a dead stream. Delivery is at least once: consumers
+ * deduplicate.
+ */
+export declare class RedisStreamsEventBus implements EventBus {
+    /** Read by what observes the bus from outside: the name of the transport. */
+    readonly messagingSystem = "redis";
+    private readonly settings;
+    private readonly link;
+    private readonly publications;
+    private readonly consumption;
+    private closed;
+    constructor(options: RedisStreamsEventBusOptions);
+    /** Entries delivered to this bus whose handlers have not finished yet. */
+    get deliveriesInFlight(): number;
+    /**
+     * Resolves when the server acknowledged every event, rejects otherwise: nothing is buffered
+     * for later, so the caller (the outbox relay) knows what to retry.
+     */
+    publish(events: readonly IntegrationEvent[]): Promise<void>;
+    /** Subscribes the consumer named by the `consumer` option. */
+    subscribe(type: string, handler: IntegrationEventCallback): Subscription;
+    /** A subscriber for one consuming context, with a reading connection of its own. */
+    forConsumer(consumer: string): IntegrationEventSubscriber;
+    /**
+     * Connects if needed and creates the streams and the groups of the subscriptions made so
+     * far. Idempotent: a group that exists keeps its position.
+     */
+    assertTopology(): Promise<void>;
+    describeTopology(): RedisStreamsTopology;
+    /**
+     * Moves up to `limit` entries from the dead stream of a consumer back to the stream of
+     * their type, for that consumer only, with a fresh attempt budget. Returns how many moved.
+     */
+    replayDead(binding: ConsumerBinding, limit?: number): Promise<number>;
+    /** Stops reading, waits for the handlers in progress to settle, disconnects what it opened. */
+    close(): Promise<void>;
+    /** What a serialisation shows of the bus: its name, never its connection. */
+    toJSON(): string;
+    /** What `console.log` and `util.inspect` show of the bus: the same. */
+    [inspect.custom](): string;
+    private bind;
+}
+//# sourceMappingURL=redis-streams-event-bus.d.ts.map

package/dist/streams/redis-streams-event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-streams-event-bus.d.ts","sourceRoot":"","sources":["../../src/streams/redis-streams-event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EACV,QAAQ,EACR,gBAAgB,EAChB,wBAAwB,EACxB,0BAA0B,EAC1B,YAAY,EACb,MAAM,oBAAoB,CAAC;AAK5B,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8CAA8C,CAAC;AAOhG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAMjF;;;;;;;;;GASG;AACH,qBAAa,oBAAqB,YAAW,QAAQ;IACnD,6EAA6E;IAC7E,QAAQ,CAAC,eAAe,WAAoB;IAE5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IAEpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAElC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAE5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAE1C,OAAO,CAAC,MAAM,CAAS;IAEvB,YAAY,OAAO,EAAE,2BAA2B,EAY/C;IAED,0EAA0E;IAC1E,IAAI,kBAAkB,IAAI,MAAM,CAE/B;IAED;;;OAGG;IACG,OAAO,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAchE;IAED,8DAA8D;IAC9D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,GAAG,YAAY,CAMvE;IAED,oFAAoF;IACpF,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,0BAA0B,CAMxD;IAED;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpC;IAED,gBAAgB,IAAI,oBAAoB,CAEvC;IAED;;;OAGG;IACG,UAAU,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,SAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKvE;IAED,+FAA+F;IACzF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAQ3B;IAED,6EAA6E;IAC7E,MAAM,IAAI,MAAM,CAEf;IAED,uEAAuE;IACvE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAEzB;IAED,OAAO,CAAC,IAAI;CAOb"}

package/dist/streams/redis-streams-event-bus.js

@@ -0,0 +1,120 @@
+import { inspect } from 'node:util';
+import { replay } from './replay.js';
+import { Consumption } from './consumption.js';
+import { ConsumerNameRequiredError } from './errors/consumer-name-required-error.js';
+import { EventBusClosedError } from './errors/event-bus-closed-error.js';
+import { MESSAGING_SYSTEM } from './messaging-system.js';
+import { settingsOf } from './options/settings-of.js';
+import { conceal } from '../secrecy/conceal.js';
+import { Publications } from './publications.js';
+import { ServerLink } from './server-link.js';
+import { declareTopology } from './topology/declare-topology.js';
+import { streamNamesOf } from './topology/stream-names-of.js';
+import { topologyOf } from './topology/topology-of.js';
+const DESCRIPTION = 'RedisStreamsEventBus [connection concealed]';
+/**
+ * The provider on Redis Streams, for Redis, Dragonfly and Valkey.
+ *
+ * Publishing: one stream per event type, one `XADD` per event, and `publish` resolves only
+ * when the server answered an entry id for every event, so it is a safe target for the outbox
+ * relay. Consuming: one consumer group per consumer name, a blocking read on a dedicated
+ * connection, `XACK` after the handlers resolved, a bounded number of delayed redeliveries
+ * from the pending entry list, then a dead stream. Delivery is at least once: consumers
+ * deduplicate.
+ */
+export class RedisStreamsEventBus {
+    /** Read by what observes the bus from outside: the name of the transport. */
+    messagingSystem = MESSAGING_SYSTEM;
+    settings;
+    link;
+    publications;
+    consumption;
+    closed = false;
+    constructor(options) {
+        this.settings = settingsOf(options);
+        const { reconnect, blockMs } = this.settings;
+        this.link = new ServerLink({ connection: options.connection, reconnect, blockMs }, (code) => {
+            this.settings.onFailure({ kind: 'connection', code });
+        });
+        this.publications = new Publications(this.settings);
+        this.consumption = new Consumption(this.link, this.settings);
+        conceal(this);
+    }
+    /** Entries delivered to this bus whose handlers have not finished yet. */
+    get deliveriesInFlight() {
+        return this.consumption.inFlight;
+    }
+    /**
+     * Resolves when the server acknowledged every event, rejects otherwise: nothing is buffered
+     * for later, so the caller (the outbox relay) knows what to retry.
+     */
+    async publish(events) {
+        if (events.length === 0) {
+            return;
+        }
+        if (this.closed) {
+            throw new EventBusClosedError();
+        }
+        const client = await this.link.ready();
+        // The groups of this bus exist before it publishes: it never misses its own events.
+        await this.consumption.declare(client);
+        await this.publications.publish(client, events);
+    }
+    /** Subscribes the consumer named by the `consumer` option. */
+    subscribe(type, handler) {
+        if (this.settings.consumer === undefined) {
+            throw new ConsumerNameRequiredError();
+        }
+        return this.bind({ consumer: this.settings.consumer, type }, handler);
+    }
+    /** A subscriber for one consuming context, with a reading connection of its own. */
+    forConsumer(consumer) {
+        if (consumer.length === 0) {
+            throw new ConsumerNameRequiredError();
+        }
+        return { subscribe: (type, handler) => this.bind({ consumer, type }, handler) };
+    }
+    /**
+     * Connects if needed and creates the streams and the groups of the subscriptions made so
+     * far. Idempotent: a group that exists keeps its position.
+     */
+    async assertTopology() {
+        await declareTopology(await this.link.ready(), this.describeTopology());
+    }
+    describeTopology() {
+        return topologyOf(this.settings, this.consumption.bindings());
+    }
+    /**
+     * Moves up to `limit` entries from the dead stream of a consumer back to the stream of
+     * their type, for that consumer only, with a fresh attempt budget. Returns how many moved.
+     */
+    async replayDead(binding, limit = 100) {
+        const { events, dead } = streamNamesOf(binding, this.settings.streamOf);
+        const client = await this.link.ready();
+        return replay(client, { stream: events, deadStream: dead, consumer: binding.consumer, limit });
+    }
+    /** Stops reading, waits for the handlers in progress to settle, disconnects what it opened. */
+    async close() {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        await this.consumption.drain();
+        await this.link.close();
+    }
+    /** What a serialisation shows of the bus: its name, never its connection. */
+    toJSON() {
+        return DESCRIPTION;
+    }
+    /** What `console.log` and `util.inspect` show of the bus: the same. */
+    [inspect.custom]() {
+        return DESCRIPTION;
+    }
+    bind(binding, handler) {
+        if (this.closed) {
+            throw new EventBusClosedError();
+        }
+        return this.consumption.add(binding, handler);
+    }
+}
+//# sourceMappingURL=redis-streams-event-bus.js.map

package/dist/streams/redis-streams-event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-streams-event-bus.js","sourceRoot":"","sources":["../../src/streams/redis-streams-event-bus.ts"],"names":[],"mappings":"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"}

package/dist/streams/replay.d.ts

@@ -0,0 +1,13 @@
+import type { Redis } from 'ioredis';
+export interface Replay {
+    readonly stream: string;
+    readonly deadStream: string;
+    readonly consumer: string;
+    readonly limit: number;
+}
+/**
+ * Moves up to `limit` dead entries back, oldest first, and answers how many. The new entry
+ * names the consumer it is for: the other groups of the stream acknowledge it unseen.
+ */
+export declare function replay(client: Redis, { stream, deadStream, consumer, limit }: Replay): Promise<number>;
+//# sourceMappingURL=replay.d.ts.map

package/dist/streams/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../src/streams/replay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAIrC,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAcD;;;GAGG;AACH,wBAAsB,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS5G"}

package/dist/streams/replay.js

@@ -0,0 +1,26 @@
+import { entriesOf } from './codec/entries-of.js';
+import { replayFields } from './codec/replay-fields.js';
+/**
+ * Appends a dead entry to its stream again and deletes it from the dead stream, unless
+ * another replay took it meanwhile. KEYS: dead stream, stream. ARGV: dead entry id, then the
+ * fields of the new entry.
+ */
+const REPLAY = `
+if #redis.call('XRANGE', KEYS[1], ARGV[1], ARGV[1]) == 0 then
+  return 0
+end
+redis.call('XADD', KEYS[2], '*', unpack(ARGV, 2))
+return redis.call('XDEL', KEYS[1], ARGV[1])`;
+/**
+ * Moves up to `limit` dead entries back, oldest first, and answers how many. The new entry
+ * names the consumer it is for: the other groups of the stream acknowledge it unseen.
+ */
+export async function replay(client, { stream, deadStream, consumer, limit }) {
+    const dead = entriesOf(await client.xrange(deadStream, '-', '+', 'COUNT', limit));
+    let replayed = 0;
+    for (const entry of dead) {
+        replayed += Number(await client.eval(REPLAY, 2, deadStream, stream, entry.id, ...replayFields(entry, consumer)));
+    }
+    return replayed;
+}
+//# sourceMappingURL=replay.js.map

package/dist/streams/replay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.js","sourceRoot":"","sources":["../../src/streams/replay.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AASxD;;;;GAIG;AACH,MAAM,MAAM,GAAG;;;;;4CAK6B,CAAC;AAE7C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,MAAa,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAU;IACzF,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IAClF,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;QACzB,QAAQ,IAAI,MAAM,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,GAAG,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACnH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/streams/server-link.d.ts

@@ -0,0 +1,45 @@
+import { inspect } from 'node:util';
+import { Redis } from 'ioredis';
+import type { RedisSource } from '../connection/redis-source.js';
+import type { ReconnectOptions } from './options/reconnect-options.js';
+export interface LinkSettings {
+    readonly connection: RedisSource;
+    readonly reconnect: Required<ReconnectOptions>;
+    readonly blockMs: number;
+}
+/**
+ * The connection the bus publishes and acknowledges on, and the source of the connections
+ * its readers block on. ioredis reconnects by itself; the link reports what happens to the
+ * connection as codes and answers at once, instead of queueing, while the server is away.
+ */
+export declare class ServerLink {
+    private readonly connection;
+    private readonly owned;
+    private readonly blockMs;
+    private readonly failed;
+    private reason;
+    private wasReady;
+    private closed;
+    constructor(settings: LinkSettings, failed: (code: string) => void);
+    /** The connection for commands that answer at once. A command sent while the server is away fails by the rules of the client. */
+    get client(): Redis;
+    /**
+     * The live connection. Waits for the first connection in progress and fails at once between
+     * two reconnection attempts, so that a publisher never hangs on a server that is down.
+     */
+    ready(): Promise<Redis>;
+    /**
+     * A connection of its own for a blocking reader. Its command timeout leaves the server the
+     * time to answer a read that found nothing; beyond it the connection is deemed dead.
+     */
+    reader(): Redis;
+    close(): Promise<void>;
+    toJSON(): string;
+    [inspect.custom](): string;
+    private refuseOnceClosed;
+    private readonly onReady;
+    private readonly onError;
+    private readonly onClose;
+    private lost;
+}
+//# sourceMappingURL=server-link.d.ts.map

package/dist/streams/server-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-link.d.ts","sourceRoot":"","sources":["../../src/streams/server-link.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAMjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAID;;;;GAIG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IAEnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAEhC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAEhD,OAAO,CAAC,MAAM,CAAmB;IAEjC,OAAO,CAAC,QAAQ,CAAU;IAE1B,OAAO,CAAC,MAAM,CAAS;IAEvB,YAAY,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAUjE;IAED,iIAAiI;IACjI,IAAI,MAAM,IAAI,KAAK,CAElB;IAED;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,CAyB5B;IAED;;;OAGG;IACH,MAAM,IAAI,KAAK,CAQd;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAQ3B;IAED,MAAM,IAAI,MAAM,CAEf;IAED,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAEzB;IAED,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAEtB;IAEF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAEtB;IAEF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAItB;IAEF,OAAO,CAAC,IAAI;CAQb"}

package/dist/streams/server-link.js

@@ -0,0 +1,129 @@
+import { inspect } from 'node:util';
+import { Redis } from 'ioredis';
+import { closeRedis } from '../connection/close-redis.js';
+import { FAIL_FAST } from '../connection/fail-fast.js';
+import { conceal } from '../secrecy/conceal.js';
+import { BrokerUnavailableError } from './errors/broker-unavailable-error.js';
+import { EventBusClosedError } from './errors/event-bus-closed-error.js';
+import { failureCode } from './errors/failure-code.js';
+import { reconnectDelay } from './options/reconnect-delay.js';
+const DESCRIPTION = 'ServerLink [connection concealed]';
+/**
+ * The connection the bus publishes and acknowledges on, and the source of the connections
+ * its readers block on. ioredis reconnects by itself; the link reports what happens to the
+ * connection as codes and answers at once, instead of queueing, while the server is away.
+ */
+export class ServerLink {
+    connection;
+    owned;
+    blockMs;
+    failed;
+    reason = 'NOT_CONNECTED';
+    wasReady;
+    closed = false;
+    constructor(settings, failed) {
+        const { connection } = settings;
+        this.owned = !(connection instanceof Redis);
+        this.connection = connection instanceof Redis ? connection : opened(connection, settings.reconnect);
+        this.blockMs = settings.blockMs;
+        this.failed = failed;
+        this.wasReady = this.connection.status === 'ready';
+        this.connection.on('ready', this.onReady).on('error', this.onError).on('close', this.onClose);
+        conceal(this);
+    }
+    /** The connection for commands that answer at once. A command sent while the server is away fails by the rules of the client. */
+    get client() {
+        return this.connection;
+    }
+    /**
+     * The live connection. Waits for the first connection in progress and fails at once between
+     * two reconnection attempts, so that a publisher never hangs on a server that is down.
+     */
+    async ready() {
+        this.refuseOnceClosed();
+        const client = this.connection;
+        if (client.status === 'ready') {
+            return client;
+        }
+        if (client.status === 'wait') {
+            void client.connect().catch(ignore);
+        }
+        if (!CONNECTING.has(client.status)) {
+            throw new BrokerUnavailableError(this.reason);
+        }
+        await connected(client);
+        this.refuseOnceClosed();
+        if (!this.wasReady) {
+            throw new BrokerUnavailableError(this.reason);
+        }
+        return client;
+    }
+    /**
+     * A connection of its own for a blocking reader. Its command timeout leaves the server the
+     * time to answer a read that found nothing; beyond it the connection is deemed dead.
+     */
+    reader() {
+        const patience = this.connection.options.commandTimeout ?? FAIL_FAST.commandTimeout ?? 0;
+        const reader = this.connection.duplicate({ commandTimeout: this.blockMs + patience });
+        // Without a handler ioredis prints connection errors; the reader reports its own failures.
+        reader.on('error', ignore);
+        return reader;
+    }
+    async close() {
+        this.closed = true;
+        this.connection.off('ready', this.onReady).off('error', this.onError).off('close', this.onClose);
+        if (this.owned) {
+            this.connection.on('error', ignore);
+            await closeRedis(this.connection);
+        }
+    }
+    toJSON() {
+        return DESCRIPTION;
+    }
+    [inspect.custom]() {
+        return DESCRIPTION;
+    }
+    refuseOnceClosed() {
+        if (this.closed) {
+            throw new EventBusClosedError();
+        }
+    }
+    onReady = () => {
+        this.wasReady = true;
+    };
+    onError = (error) => {
+        this.lost(failureCode(error));
+    };
+    onClose = () => {
+        if (this.wasReady) {
+            this.lost('CONNECTION_LOST');
+        }
+    };
+    lost(code) {
+        this.wasReady = false;
+        this.reason = code;
+        if (!this.closed) {
+            this.failed(code);
+        }
+    }
+}
+const CONNECTING = new Set(['wait', 'connecting', 'connect']);
+function opened(source, reconnect) {
+    const retryStrategy = (attempt) => reconnectDelay(reconnect, attempt);
+    const defaults = { ...FAIL_FAST, retryStrategy };
+    return typeof source === 'string' ? new Redis(source, defaults) : new Redis({ ...defaults, ...source });
+}
+/** Resolves when the connection in progress succeeded or failed. */
+function connected(client) {
+    return new Promise((resolve) => {
+        const settle = () => {
+            client.off('ready', settle).off('close', settle).off('end', settle);
+            resolve();
+        };
+        client.once('ready', settle).once('close', settle).once('end', settle);
+    });
+}
+function ignore() {
+    return undefined;
+}
+//# sourceMappingURL=server-link.js.map

package/dist/streams/server-link.js.map

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

package/dist/streams/settlement.d.ts

@@ -0,0 +1,46 @@
+import type { Redis } from 'ioredis';
+import type { IntegrationEventCallback } from '@ddd-ts-kit/kernel';
+import type { Delivery } from './delivery.js';
+import type { RedisStreamsDelivery } from './options/redis-streams-delivery.js';
+import type { RedisStreamsFailure } from './options/redis-streams-failure.js';
+import type { RetryOptions } from './options/retry-options.js';
+export interface SettlementSettings {
+    /** The consumer name, which is the name of its group. */
+    readonly consumer: string;
+    readonly instance: string;
+    readonly retry: Required<RetryOptions>;
+    readonly onFailure: (failure: RedisStreamsFailure) => void;
+    readonly onDelivery: (delivery: RedisStreamsDelivery) => void;
+}
+export declare const POISON_ENTRY = "POISON_ENTRY";
+/** The code of an entry that used its deliveries up without a handler answering: its consumers crashed on it. */
+export declare const ATTEMPTS_EXHAUSTED = "ATTEMPTS_EXHAUSTED";
+/**
+ * What becomes of a delivered entry: acknowledged once every handler resolved; left pending
+ * after a failure, to be claimed again after the delay; copied to the dead stream when its
+ * attempts are spent or when it does not hold an envelope.
+ */
+export declare class Settlement {
+    private readonly client;
+    private readonly settings;
+    constructor(client: Redis, settings: SettlementSettings);
+    /** Never rejects: an entry that could not be settled stays pending and is delivered again. */
+    settle(delivery: Delivery, handlers: ReadonlySet<IntegrationEventCallback>): Promise<void>;
+    private decide;
+    /** A replayed dead entry is addressed to the consumer it died for. */
+    private isForAnotherConsumer;
+    private acknowledge;
+    private buryPoison;
+    private handle;
+    private deliveryOf;
+    private fail;
+    private settled;
+    private bury;
+    /**
+     * The entry stays pending; claiming it for ourselves without reading it (`JUSTID`) restarts
+     * its idle time and leaves its delivery counter alone, so the retry delay runs from the
+     * failure, not from the delivery.
+     */
+    private postpone;
+}
+//# sourceMappingURL=settlement.d.ts.map

package/dist/streams/settlement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settlement.d.ts","sourceRoot":"","sources":["../../src/streams/settlement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAmC,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAYpG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG/D,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IAEvC,QAAQ,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAE3D,QAAQ,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,IAAI,CAAC;CAC/D;AAED,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C,iHAAiH;AACjH,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AAEvD;;;;GAIG;AACH,qBAAa,UAAU;IAEnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAF3B,YACmB,MAAM,EAAE,KAAK,EACb,QAAQ,EAAE,kBAAkB,EAC3C;IAEJ,8FAA8F;IACxF,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,wBAAwB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAM/F;YAEa,MAAM;IAkBpB,sEAAsE;IACtE,OAAO,CAAC,oBAAoB;YAMd,WAAW;YAIX,UAAU;YAQV,MAAM;IAepB,OAAO,CAAC,UAAU;YAMJ,IAAI;IAyBlB,OAAO,CAAC,OAAO;YAID,IAAI;IAoBlB;;;;OAIG;YACW,QAAQ;CAGvB"}