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

package/dist/streams/group-reader.js

@@ -0,0 +1,187 @@
+import { inEventScope } from '@ddd-ts-kit/kernel';
+import { closeRedis } from '../connection/close-redis.js';
+import { claimDue } from './claim-due.js';
+import { entriesByStream } from './codec/entries-by-stream.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';
+import { Settlement } from './settlement.js';
+import { createGroup } from './topology/create-group.js';
+import { groupOf } from './topology/group-of.js';
+const NO_HANDLER = new Set();
+/**
+ * One consumer on its dedicated connection: a blocking read must not hold up the connection
+ * that publishes and acknowledges. The consumer is a group on each stream it subscribed to,
+ * and this process one member of it. A turn takes back the pending entries that are due, then
+ * waits for new ones for a bounded time; the entries of a stream are handled in their order,
+ * one at a time.
+ */
+export class GroupReader {
+    consumer;
+    link;
+    settings;
+    subscriptions = new Map();
+    declared = new Set();
+    settlement;
+    running;
+    interrupt;
+    stopping = false;
+    unsettled = 0;
+    failures = 0;
+    sweptAt = 0;
+    constructor(consumer, link, settings) {
+        this.consumer = consumer;
+        this.link = link;
+        this.settings = settings;
+        this.settlement = new Settlement(link.client, { ...settings, consumer });
+    }
+    /** Entries read by this reader and not settled yet. */
+    get inFlight() {
+        return this.unsettled;
+    }
+    get idle() {
+        return this.subscriptions.size === 0;
+    }
+    bindings() {
+        return [...this.subscriptions.values()].map(({ type }) => ({ consumer: this.consumer, type }));
+    }
+    subscribe(type, handler) {
+        const stream = this.settings.streamOf(type);
+        const subscription = this.subscriptions.get(stream) ?? { type, handlers: new Set() };
+        const { scope } = this.settings;
+        const scoped = scope === undefined ? handler : inEventScope(scope, { consumer: this.consumer }, handler);
+        subscription.handlers.add(scoped);
+        this.subscriptions.set(stream, subscription);
+        this.running ??= this.run();
+        return {
+            unsubscribe: () => {
+                this.remove(stream, scoped);
+            },
+        };
+    }
+    /** Creates the group on every stream subscribed to so far that does not have it yet. */
+    async declare(client) {
+        for (const { consumer, type } of this.bindings()) {
+            const group = groupOf(this.settings, { consumer, type });
+            if (!this.declared.has(group.stream)) {
+                await createGroup(client, group);
+                this.declared.add(group.stream);
+            }
+        }
+    }
+    /** Reads nothing more, lets the batch in progress finish and settle, then leaves the group. */
+    async stop() {
+        this.stopping = true;
+        this.interrupt?.();
+        await this.running;
+    }
+    // The group stays, with its position: the consumer keeps accumulating, it only stopped reading.
+    remove(stream, handler) {
+        const subscription = this.subscriptions.get(stream);
+        subscription?.handlers.delete(handler);
+        if (subscription?.handlers.size === 0) {
+            this.subscriptions.delete(stream);
+        }
+    }
+    async run() {
+        const reader = this.link.reader();
+        while (!this.stopping) {
+            try {
+                await this.turn(reader);
+                this.failures = 0;
+            }
+            catch (error) {
+                await this.recover(error);
+            }
+        }
+        await this.leave(reader);
+    }
+    async turn(reader) {
+        await this.declare(await this.link.ready());
+        const streams = [...this.subscriptions.keys()];
+        if (this.sweepIsDue()) {
+            const due = await Promise.all(streams.map((stream) => claimDue(reader, stream, this.redelivery())));
+            await this.handle(due.flat());
+        }
+        if (!this.stopping && streams.length > 0) {
+            await this.handle(await this.read(reader, streams));
+        }
+    }
+    sweepIsDue() {
+        const { blockMs, retry } = this.settings;
+        if (Date.now() - this.sweptAt < Math.min(blockMs, retry.delayMs)) {
+            return false;
+        }
+        this.sweptAt = Date.now();
+        return true;
+    }
+    redelivery() {
+        const { instance, batchSize, retry } = this.settings;
+        // Never below the retry delay: an entry waiting for its retry is not an abandoned one.
+        const visibilityTimeoutMs = Math.max(this.settings.visibilityTimeoutMs, retry.delayMs);
+        return { consumer: this.consumer, instance, batchSize, retryDelayMs: retry.delayMs, visibilityTimeoutMs };
+    }
+    async handle(deliveries) {
+        this.unsettled += deliveries.length;
+        const streams = [...new Set(deliveries.map((delivery) => delivery.stream))];
+        await Promise.all(streams.map((stream) => this.inOrder(deliveries.filter((delivery) => delivery.stream === stream))));
+    }
+    async inOrder(deliveries) {
+        for (const delivery of deliveries) {
+            const handlers = this.subscriptions.get(delivery.stream)?.handlers ?? NO_HANDLER;
+            await this.settlement.settle(delivery, handlers);
+            this.unsettled -= 1;
+        }
+    }
+    async read(reader, streams) {
+        const { instance, batchSize, blockMs } = this.settings;
+        const ids = streams.map(() => '>');
+        // The named command, not `call`: ioredis maps the reply of the commands it knows to its classic shape.
+        const reply = await reader.xreadgroup('GROUP', this.consumer, instance, 'COUNT', batchSize, 'BLOCK', blockMs, 'STREAMS', ...streams, ...ids);
+        return [...entriesByStream(reply)].flatMap(([stream, entries]) => entries.map((entry) => ({ stream, entry, attempt: 1 })));
+    }
+    /**
+     * After a failure the groups are created again before the next read: a server that came
+     * back without its data has lost them. The link already reported a connection that is down.
+     */
+    async recover(error) {
+        this.declared.clear();
+        if (!(error instanceof BrokerUnavailableError) && !(error instanceof EventBusClosedError)) {
+            this.settings.onFailure({ kind: 'connection', code: failureCode(error) });
+        }
+        this.failures += 1;
+        await this.rest(reconnectDelay(this.settings.reconnect, this.failures));
+    }
+    rest(ms) {
+        if (this.stopping) {
+            return Promise.resolve();
+        }
+        return new Promise((resolve) => {
+            const timer = setTimeout(resolve, ms);
+            this.interrupt = () => {
+                clearTimeout(timer);
+                resolve();
+            };
+        });
+    }
+    async leave(reader) {
+        await this.retire().catch(() => undefined);
+        await closeRedis(reader);
+    }
+    /**
+     * Removes this process from its groups, where it leaves nothing pending: deleting a
+     * consumer drops its pending entries, and those must stay for another instance to claim.
+     */
+    async retire() {
+        const { client } = this.link;
+        const { instance } = this.settings;
+        for (const stream of this.declared) {
+            const pending = await client.xpending(stream, this.consumer, '-', '+', 1, instance);
+            if (pending.length === 0) {
+                await client.xgroup('DELCONSUMER', stream, this.consumer, instance);
+            }
+        }
+    }
+}
+//# sourceMappingURL=group-reader.js.map

package/dist/streams/group-reader.js.map

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

package/dist/streams/messaging-system.d.ts

@@ -0,0 +1,3 @@
+/** The name of the transport in what the bus says of itself and of each delivery. */
+export declare const MESSAGING_SYSTEM = "redis";
+//# sourceMappingURL=messaging-system.d.ts.map

package/dist/streams/messaging-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging-system.d.ts","sourceRoot":"","sources":["../../src/streams/messaging-system.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,eAAO,MAAM,gBAAgB,UAAU,CAAC"}

package/dist/streams/messaging-system.js

@@ -0,0 +1,3 @@
+/** The name of the transport in what the bus says of itself and of each delivery. */
+export const MESSAGING_SYSTEM = 'redis';
+//# sourceMappingURL=messaging-system.js.map

package/dist/streams/messaging-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging-system.js","sourceRoot":"","sources":["../../src/streams/messaging-system.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC"}

package/dist/streams/options/deduplication-options.d.ts

@@ -0,0 +1,5 @@
+export interface DeduplicationOptions {
+    /** How long the id of a published event is remembered. A relay retry within it appends nothing. */
+    readonly windowMs: number;
+}
+//# sourceMappingURL=deduplication-options.d.ts.map

package/dist/streams/options/deduplication-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deduplication-options.d.ts","sourceRoot":"","sources":["../../../src/streams/options/deduplication-options.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,mGAAmG;IACnG,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B"}

package/dist/streams/options/deduplication-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=deduplication-options.js.map

package/dist/streams/options/deduplication-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deduplication-options.js","sourceRoot":"","sources":["../../../src/streams/options/deduplication-options.ts"],"names":[],"mappings":""}

package/dist/streams/options/default-prefix.d.ts

@@ -0,0 +1,2 @@
+export declare const DEFAULT_PREFIX = "integration-events";
+//# sourceMappingURL=default-prefix.d.ts.map

package/dist/streams/options/default-prefix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-prefix.d.ts","sourceRoot":"","sources":["../../../src/streams/options/default-prefix.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,uBAAuB,CAAC"}

package/dist/streams/options/default-prefix.js

@@ -0,0 +1,2 @@
+export const DEFAULT_PREFIX = 'integration-events';
+//# sourceMappingURL=default-prefix.js.map

package/dist/streams/options/default-prefix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-prefix.js","sourceRoot":"","sources":["../../../src/streams/options/default-prefix.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,oBAAoB,CAAC"}

package/dist/streams/options/reconnect-delay.d.ts

@@ -0,0 +1,4 @@
+import type { ReconnectOptions } from './reconnect-options.js';
+/** The delay before the given attempt, counted from 1: it grows by the factor up to the bound. */
+export declare function reconnectDelay(reconnect: Required<ReconnectOptions>, attempt: number): number;
+//# sourceMappingURL=reconnect-delay.d.ts.map

package/dist/streams/options/reconnect-delay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconnect-delay.d.ts","sourceRoot":"","sources":["../../../src/streams/options/reconnect-delay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,kGAAkG;AAClG,wBAAgB,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7F"}

package/dist/streams/options/reconnect-delay.js

@@ -0,0 +1,5 @@
+/** The delay before the given attempt, counted from 1: it grows by the factor up to the bound. */
+export function reconnectDelay(reconnect, attempt) {
+    return Math.min(reconnect.maxMs, reconnect.initialMs * reconnect.factor ** (attempt - 1));
+}
+//# sourceMappingURL=reconnect-delay.js.map

package/dist/streams/options/reconnect-delay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconnect-delay.js","sourceRoot":"","sources":["../../../src/streams/options/reconnect-delay.ts"],"names":[],"mappings":"AAEA,kGAAkG;AAClG,MAAM,UAAU,cAAc,CAAC,SAAqC,EAAE,OAAe;IACnF,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,SAAS,GAAG,SAAS,CAAC,MAAM,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;AAC5F,CAAC"}

package/dist/streams/options/reconnect-options.d.ts

@@ -0,0 +1,9 @@
+export interface ReconnectOptions {
+    /** Delay before the first reconnection attempt. Default 200. */
+    readonly initialMs?: number;
+    /** Multiplier applied at each further attempt. Default 2. */
+    readonly factor?: number;
+    /** Upper bound of the delay. Default 30000. */
+    readonly maxMs?: number;
+}
+//# sourceMappingURL=reconnect-options.d.ts.map

package/dist/streams/options/reconnect-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconnect-options.d.ts","sourceRoot":"","sources":["../../../src/streams/options/reconnect-options.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/dist/streams/options/reconnect-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=reconnect-options.js.map

package/dist/streams/options/reconnect-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconnect-options.js","sourceRoot":"","sources":["../../../src/streams/options/reconnect-options.ts"],"names":[],"mappings":""}

package/dist/streams/options/redis-streams-delivery.d.ts

@@ -0,0 +1,13 @@
+/** One entry settled by a consumer of this bus. Counted by outcome, it is the metric to watch. */
+export interface RedisStreamsDelivery {
+    readonly stream: string;
+    readonly consumer: string;
+    /** Which delivery of the entry this was, starting at 1: the delivery counter of the pending entry list. */
+    readonly attempt: number;
+    /**
+     * `acknowledged`: every handler resolved. `retried`: left pending for another delivery.
+     * `dead`: attempts spent, moved to the dead stream. `poison`: not an envelope, moved there too.
+     */
+    readonly outcome: 'acknowledged' | 'retried' | 'dead' | 'poison';
+}
+//# sourceMappingURL=redis-streams-delivery.d.ts.map

package/dist/streams/options/redis-streams-delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-streams-delivery.d.ts","sourceRoot":"","sources":["../../../src/streams/options/redis-streams-delivery.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,2GAA2G;IAC3G,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;CAClE"}

package/dist/streams/options/redis-streams-delivery.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=redis-streams-delivery.js.map

package/dist/streams/options/redis-streams-delivery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-streams-delivery.js","sourceRoot":"","sources":["../../../src/streams/options/redis-streams-delivery.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,48 @@
+import type { ExecutionScope } from '@ddd-ts-kit/kernel';
+import type { RedisSource } from '../../connection/redis-source.js';
+import type { DeduplicationOptions } from './deduplication-options.js';
+import type { ReconnectOptions } from './reconnect-options.js';
+import type { RedisStreamsDelivery } from './redis-streams-delivery.js';
+import type { RedisStreamsFailure } from './redis-streams-failure.js';
+import type { RetentionOptions } from './retention-options.js';
+import type { RetryOptions } from './retry-options.js';
+export interface RedisStreamsEventBusOptions {
+    /**
+     * A connection URL, ioredis options, or a client the application already owns. The bus
+     * publishes and acknowledges on it, and duplicates it for each blocking reader. It closes
+     * what it opened; a client it was handed stays open.
+     */
+    readonly connection: RedisSource;
+    /** Events of a type go to the stream `<prefix>:<type>`. Default `integration-events`. */
+    readonly prefix?: string;
+    /** The stream of an event type, when `<prefix>:<type>` does not suit. Publishers and consumers must agree. */
+    readonly streamOf?: (type: string) => string;
+    /** The consuming context `subscribe` reads for: the name of its consumer group. See also `forConsumer`. */
+    readonly consumer?: string;
+    /** The name of this process inside its groups. Default: host, process id and a random suffix. */
+    readonly instance?: string;
+    /** Entries read at once per stream, then handled one after the other. Default 10. */
+    readonly batchSize?: number;
+    /** How long a read waits for new entries. It bounds `close()` and the precision of the retry delay. Default 1000. */
+    readonly blockMs?: number;
+    /**
+     * Idle time after which the pending entries of ANOTHER instance are taken over: it crashed,
+     * or it is stuck. Keep it above the worst case of a whole batch. Default 60000.
+     */
+    readonly visibilityTimeoutMs?: number;
+    /** Where a group created by this bus starts: entries published from now on (default), or the whole stream. */
+    readonly startFrom?: 'new' | 'beginning';
+    readonly retry?: RetryOptions;
+    readonly reconnect?: ReconnectOptions;
+    /** Default: none, streams grow until trimmed by the operator. */
+    readonly retention?: RetentionOptions;
+    /** A publish-side guard against the duplicates of a relay retry. Default: none, consumers deduplicate. */
+    readonly deduplication?: DeduplicationOptions;
+    /** When given, every handler runs inside it, in the execution context of its event. */
+    readonly scope?: ExecutionScope;
+    /** Observability hook. It receives codes only, so it is safe to log as is. */
+    readonly onFailure?: (failure: RedisStreamsFailure) => void;
+    /** Metrics hook, called once per entry a consumer settles, before it is acknowledged. */
+    readonly onDelivery?: (delivery: RedisStreamsDelivery) => void;
+}
+//# sourceMappingURL=redis-streams-event-bus-options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redis-streams-event-bus-options.d.ts","sourceRoot":"","sources":["../../../src/streams/options/redis-streams-event-bus-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,2BAA2B;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;IAEjC,yFAAyF;IACzF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB,8GAA8G;IAC9G,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAE7C,2GAA2G;IAC3G,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B,iGAAiG;IACjG,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B,qFAAqF;IACrF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,qHAAqH;IACrH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAEtC,8GAA8G;IAC9G,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,WAAW,CAAC;IAEzC,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAE9B,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAEtC,iEAAiE;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAEtC,0GAA0G;IAC1G,QAAQ,CAAC,aAAa,CAAC,EAAE,oBAAoB,CAAC;IAE9C,uFAAuF;IACvF,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC;IAEhC,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAE5D,yFAAyF;IACzF,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,IAAI,CAAC;CAChE"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=redis-streams-event-bus-options.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redis-streams-event-bus-options.js","sourceRoot":"","sources":["../../../src/streams/options/redis-streams-event-bus-options.ts"],"names":[],"mappings":""}

package/dist/streams/options/redis-streams-failure.d.ts

@@ -0,0 +1,19 @@
+export type RedisStreamsFailure = {
+    readonly kind: 'handler';
+    readonly stream: string;
+    readonly consumer: string;
+    readonly eventId: string;
+    readonly eventType: string;
+    readonly code: string;
+    readonly attempt: number;
+    readonly dead: boolean;
+} | {
+    readonly kind: 'poison';
+    readonly stream: string;
+    readonly consumer: string;
+    readonly code: string;
+} | {
+    readonly kind: 'connection';
+    readonly code: string;
+};
+//# sourceMappingURL=redis-streams-failure.d.ts.map

package/dist/streams/options/redis-streams-failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-streams-failure.d.ts","sourceRoot":"","sources":["../../../src/streams/options/redis-streams-failure.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAC3B;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACtG;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/streams/options/redis-streams-failure.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=redis-streams-failure.js.map

package/dist/streams/options/redis-streams-failure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-streams-failure.js","sourceRoot":"","sources":["../../../src/streams/options/redis-streams-failure.ts"],"names":[],"mappings":""}

package/dist/streams/options/retention-options.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Trimming applied by each publication, approximately (`~`). It drops the oldest entries
+ * whether or not every consumer group has read them: an opt-in, never a default.
+ */
+export type RetentionOptions = {
+    readonly maxLength: number;
+} | {
+    readonly maxAgeMs: number;
+};
+//# sourceMappingURL=retention-options.d.ts.map

package/dist/streams/options/retention-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention-options.d.ts","sourceRoot":"","sources":["../../../src/streams/options/retention-options.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAA+D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC3F;IAAwF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/streams/options/retention-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=retention-options.js.map

package/dist/streams/options/retention-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention-options.js","sourceRoot":"","sources":["../../../src/streams/options/retention-options.ts"],"names":[],"mappings":""}

package/dist/streams/options/retry-options.d.ts

@@ -0,0 +1,7 @@
+export interface RetryOptions {
+    /** Deliveries after which an entry goes to the dead stream. Default 5. */
+    readonly maxAttempts?: number;
+    /** Time a failed entry waits before it is delivered again. Default 5000. */
+    readonly delayMs?: number;
+}
+//# sourceMappingURL=retry-options.d.ts.map

package/dist/streams/options/retry-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-options.d.ts","sourceRoot":"","sources":["../../../src/streams/options/retry-options.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B"}

package/dist/streams/options/retry-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=retry-options.js.map

package/dist/streams/options/retry-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-options.js","sourceRoot":"","sources":["../../../src/streams/options/retry-options.ts"],"names":[],"mappings":""}

package/dist/streams/options/settings-of.d.ts

@@ -0,0 +1,4 @@
+import type { RedisStreamsEventBusOptions } from './redis-streams-event-bus-options.js';
+import type { Settings } from './settings.js';
+export declare function settingsOf(options: RedisStreamsEventBusOptions): Settings;
+//# sourceMappingURL=settings-of.d.ts.map

package/dist/streams/options/settings-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-of.d.ts","sourceRoot":"","sources":["../../../src/streams/options/settings-of.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AAExF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,wBAAgB,UAAU,CAAC,OAAO,EAAE,2BAA2B,GAAG,QAAQ,CAmBzE"}

package/dist/streams/options/settings-of.js

@@ -0,0 +1,47 @@
+import { hostname } from 'node:os';
+import { randomBytes } from 'node:crypto';
+import { DEFAULT_PREFIX } from './default-prefix.js';
+export function settingsOf(options) {
+    const prefix = options.prefix ?? DEFAULT_PREFIX;
+    return {
+        streamOf: options.streamOf ?? ((type) => `${prefix}:${type}`),
+        consumer: options.consumer,
+        instance: options.instance ?? processName(),
+        batchSize: options.batchSize ?? 10,
+        blockMs: options.blockMs ?? 1_000,
+        visibilityTimeoutMs: options.visibilityTimeoutMs ?? 60_000,
+        startFrom: options.startFrom ?? 'new',
+        retry: retryOf(options.retry),
+        reconnect: reconnectOf(options.reconnect),
+        retention: options.retention,
+        deduplication: options.deduplication,
+        scope: options.scope,
+        onFailure: guarded(options.onFailure),
+        onDelivery: guarded(options.onDelivery),
+    };
+}
+function processName() {
+    return `${hostname()}-${String(process.pid)}-${randomBytes(4).toString('hex')}`;
+}
+function retryOf(retry = {}) {
+    return { maxAttempts: retry.maxAttempts ?? 5, delayMs: retry.delayMs ?? 5_000 };
+}
+function reconnectOf(reconnect = {}) {
+    return {
+        initialMs: reconnect.initialMs ?? 200,
+        factor: reconnect.factor ?? 2,
+        maxMs: reconnect.maxMs ?? 30_000,
+    };
+}
+// A hook that throws must not leave an entry unsettled or stop a reader.
+function guarded(hook) {
+    return (value) => {
+        try {
+            hook?.(value);
+        }
+        catch {
+            return;
+        }
+    };
+}
+//# sourceMappingURL=settings-of.js.map

package/dist/streams/options/settings-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-of.js","sourceRoot":"","sources":["../../../src/streams/options/settings-of.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAMrD,MAAM,UAAU,UAAU,CAAC,OAAoC;IAC7D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC;IAEhD,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC;QAC7D,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,WAAW,EAAE;QAC3C,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;QAClC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK;QACjC,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,IAAI,MAAM;QAC1D,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,KAAK;QACrC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;QAC7B,SAAS,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;QACzC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;QACrC,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;KACxC,CAAC;AACJ,CAAC;AAED,SAAS,WAAW;IAClB,OAAO,GAAG,QAAQ,EAAE,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;AAClF,CAAC;AAED,SAAS,OAAO,CAAC,KAAK,GAAiB,EAAE;IACvC,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,KAAK,EAAE,CAAC;AAClF,CAAC;AAED,SAAS,WAAW,CAAC,SAAS,GAAqB,EAAE;IACnD,OAAO;QACL,SAAS,EAAE,SAAS,CAAC,SAAS,IAAI,GAAG;QACrC,MAAM,EAAE,SAAS,CAAC,MAAM,IAAI,CAAC;QAC7B,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,MAAM;KACjC,CAAC;AACJ,CAAC;AAED,yEAAyE;AACzE,SAAS,OAAO,CAAI,IAAsC;IACxD,OAAO,CAAC,KAAK,EAAE,EAAE;QACf,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/streams/options/settings.d.ts

@@ -0,0 +1,28 @@
+import type { ExecutionScope } from '@ddd-ts-kit/kernel';
+import type { DeduplicationOptions } from './deduplication-options.js';
+import type { ReconnectOptions } from './reconnect-options.js';
+import type { RedisStreamsDelivery } from './redis-streams-delivery.js';
+import type { RedisStreamsFailure } from './redis-streams-failure.js';
+import type { RetentionOptions } from './retention-options.js';
+import type { RetryOptions } from './retry-options.js';
+/**
+ * The options of a bus with their defaults applied. The connection is not among them: a URL
+ * may carry a password, and nothing that outlives the constructor keeps it.
+ */
+export interface Settings {
+    readonly streamOf: (type: string) => string;
+    readonly consumer: string | undefined;
+    readonly instance: string;
+    readonly batchSize: number;
+    readonly blockMs: number;
+    readonly visibilityTimeoutMs: number;
+    readonly startFrom: 'new' | 'beginning';
+    readonly retry: Required<RetryOptions>;
+    readonly reconnect: Required<ReconnectOptions>;
+    readonly retention: RetentionOptions | undefined;
+    readonly deduplication: DeduplicationOptions | undefined;
+    readonly scope: ExecutionScope | undefined;
+    readonly onFailure: (failure: RedisStreamsFailure) => void;
+    readonly onDelivery: (delivery: RedisStreamsDelivery) => void;
+}
+//# sourceMappingURL=settings.d.ts.map

package/dist/streams/options/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../../src/streams/options/settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,WAAW,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,aAAa,EAAE,oBAAoB,GAAG,SAAS,CAAC;IACzD,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC3D,QAAQ,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,IAAI,CAAC;CAC/D"}

package/dist/streams/options/settings.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=settings.js.map

package/dist/streams/options/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../../src/streams/options/settings.ts"],"names":[],"mappings":""}

package/dist/streams/publications.d.ts

@@ -0,0 +1,22 @@
+import type { Redis } from 'ioredis';
+import type { IntegrationEvent } from '@ddd-ts-kit/kernel';
+import type { DeduplicationOptions } from './options/deduplication-options.js';
+import type { RetentionOptions } from './options/retention-options.js';
+export interface PublicationSettings {
+    readonly streamOf: (type: string) => string;
+    readonly retention: RetentionOptions | undefined;
+    readonly deduplication: DeduplicationOptions | undefined;
+}
+/**
+ * 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 declare class Publications {
+    private readonly settings;
+    constructor(settings: PublicationSettings);
+    /** Resolves when every event has an entry; rejects with the first failure otherwise. */
+    publish(client: Redis, events: readonly IntegrationEvent[]): Promise<void>;
+    private append;
+}
+//# sourceMappingURL=publications.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"publications.d.ts","sourceRoot":"","sources":["../../src/streams/publications.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAsB,KAAK,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAI3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,aAAa,EAAE,oBAAoB,GAAG,SAAS,CAAC;CAC1D;AAiBD;;;;GAIG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAArC,YAA6B,QAAQ,EAAE,mBAAmB,EAAI;IAE9D,wFAAwF;IAClF,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB/E;IAED,OAAO,CAAC,MAAM;CAWf"}