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

package/dist/streams/settlement.js

@@ -0,0 +1,139 @@
+import { bury } from './bury.js';
+import { decode } from './codec/decode.js';
+import { ATTEMPT_FIELD, CONSUMER_FIELD, DEAD_REASON_FIELD, ENTRY_ID_FIELD, ERROR_CODE_FIELD, REPLAY_FOR_FIELD, } from './codec/entry-fields.js';
+import { failureCode } from './errors/failure-code.js';
+import { MESSAGING_SYSTEM } from './messaging-system.js';
+import { deadStreamOf } from './topology/dead-stream-of.js';
+export 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 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 class Settlement {
+    client;
+    settings;
+    constructor(client, settings) {
+        this.client = client;
+        this.settings = settings;
+    }
+    /** Never rejects: an entry that could not be settled stays pending and is delivered again. */
+    async settle(delivery, handlers) {
+        try {
+            await this.decide(delivery, handlers);
+        }
+        catch {
+            return;
+        }
+    }
+    async decide(delivery, handlers) {
+        if (this.isForAnotherConsumer(delivery.entry)) {
+            await this.acknowledge(delivery);
+            return;
+        }
+        const event = decode(delivery.entry);
+        if (event === undefined) {
+            await this.buryPoison(delivery);
+        }
+        else if (delivery.attempt > this.settings.retry.maxAttempts) {
+            await this.fail(delivery, event, ATTEMPTS_EXHAUSTED);
+        }
+        else if (handlers.size > 0) {
+            await this.handle(delivery, event, handlers);
+        }
+    }
+    /** A replayed dead entry is addressed to the consumer it died for. */
+    isForAnotherConsumer(entry) {
+        const addressee = entry.fields.get(REPLAY_FOR_FIELD);
+        return addressee !== undefined && addressee !== this.settings.consumer;
+    }
+    async acknowledge({ stream, entry }) {
+        await this.client.xack(stream, this.settings.consumer, entry.id);
+    }
+    async buryPoison(delivery) {
+        const { stream } = delivery;
+        this.settings.onFailure({ kind: 'poison', stream, consumer: this.settings.consumer, code: POISON_ENTRY });
+        this.settled(delivery, 'poison');
+        await this.bury(delivery, { [ERROR_CODE_FIELD]: POISON_ENTRY, [DEAD_REASON_FIELD]: 'poison' });
+    }
+    async handle(delivery, event, handlers) {
+        const code = await failureOf(handlers, event, this.deliveryOf(delivery));
+        if (code === undefined) {
+            this.settled(delivery, 'acknowledged');
+            await this.acknowledge(delivery);
+        }
+        else {
+            await this.fail(delivery, event, code);
+        }
+    }
+    deliveryOf({ stream, attempt }) {
+        const { consumer, retry } = this.settings;
+        return { attempt, maxAttempts: retry.maxAttempts, system: MESSAGING_SYSTEM, destination: stream, consumer };
+    }
+    async fail(delivery, event, code) {
+        const { stream, attempt } = delivery;
+        const { consumer, retry } = this.settings;
+        const dead = attempt >= retry.maxAttempts;
+        this.settings.onFailure({
+            kind: 'handler',
+            stream,
+            consumer,
+            eventId: event.id,
+            eventType: event.type,
+            code,
+            attempt,
+            dead,
+        });
+        this.settled(delivery, dead ? 'dead' : 'retried');
+        if (dead) {
+            await this.bury(delivery, { [ERROR_CODE_FIELD]: code, [DEAD_REASON_FIELD]: 'max-attempts' });
+        }
+        else {
+            await this.postpone(delivery);
+        }
+    }
+    settled({ stream, attempt }, outcome) {
+        this.settings.onDelivery({ stream, consumer: this.settings.consumer, attempt, outcome });
+    }
+    async bury(delivery, reason) {
+        const { stream, entry, attempt } = delivery;
+        const { consumer } = this.settings;
+        const annotations = {
+            ...reason,
+            [ATTEMPT_FIELD]: String(attempt),
+            [CONSUMER_FIELD]: consumer,
+            [ENTRY_ID_FIELD]: entry.id,
+        };
+        await bury(this.client, {
+            stream,
+            group: consumer,
+            deadStream: deadStreamOf(stream, consumer),
+            entry,
+            annotations,
+        });
+    }
+    /**
+     * 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.
+     */
+    async postpone({ stream, entry }) {
+        await this.client.xclaim(stream, this.settings.consumer, this.settings.instance, 0, entry.id, 'JUSTID');
+    }
+}
+/** Runs every handler, so one that fails does not starve the others; gives the first code. */
+async function failureOf(handlers, event, delivery) {
+    let code;
+    for (const handler of [...handlers]) {
+        try {
+            await handler(event, delivery);
+        }
+        catch (error) {
+            code ??= failureCode(error);
+        }
+    }
+    return code;
+}
+//# sourceMappingURL=settlement.js.map

package/dist/streams/settlement.js.map

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

package/dist/streams/topology/consumer-binding.d.ts

@@ -0,0 +1,5 @@
+export interface ConsumerBinding {
+    readonly consumer: string;
+    readonly type: string;
+}
+//# sourceMappingURL=consumer-binding.d.ts.map

package/dist/streams/topology/consumer-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-binding.d.ts","sourceRoot":"","sources":["../../../src/streams/topology/consumer-binding.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB"}

package/dist/streams/topology/consumer-binding.js

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

package/dist/streams/topology/consumer-binding.js.map

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

package/dist/streams/topology/create-group.d.ts

@@ -0,0 +1,4 @@
+import type { Redis } from 'ioredis';
+import type { GroupDescription } from './group-description.js';
+export declare function createGroup(client: Redis, group: GroupDescription): Promise<void>;
+//# sourceMappingURL=create-group.d.ts.map

package/dist/streams/topology/create-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-group.d.ts","sourceRoot":"","sources":["../../../src/streams/topology/create-group.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI/D,wBAAsB,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQvF"}

package/dist/streams/topology/create-group.js

@@ -0,0 +1,13 @@
+import { failureCode } from '../errors/failure-code.js';
+const GROUP_EXISTS = 'REDIS_BUSYGROUP';
+export async function createGroup(client, group) {
+    try {
+        await client.xgroup('CREATE', group.stream, group.name, group.startFrom === 'new' ? '$' : '0', 'MKSTREAM');
+    }
+    catch (error) {
+        if (failureCode(error) !== GROUP_EXISTS) {
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=create-group.js.map

package/dist/streams/topology/create-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-group.js","sourceRoot":"","sources":["../../../src/streams/topology/create-group.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGxD,MAAM,YAAY,GAAG,iBAAiB,CAAC;AAEvC,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAa,EAAE,KAAuB;IACtE,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAC7G,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,WAAW,CAAC,KAAK,CAAC,KAAK,YAAY,EAAE,CAAC;YACxC,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/streams/topology/dead-stream-of.d.ts

@@ -0,0 +1,3 @@
+/** Dead letters are a fact of one consumer: each has its own dead stream beside the stream it reads. */
+export declare function deadStreamOf(stream: string, consumer: string): string;
+//# sourceMappingURL=dead-stream-of.d.ts.map

package/dist/streams/topology/dead-stream-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-stream-of.d.ts","sourceRoot":"","sources":["../../../src/streams/topology/dead-stream-of.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErE"}

package/dist/streams/topology/dead-stream-of.js

@@ -0,0 +1,5 @@
+/** Dead letters are a fact of one consumer: each has its own dead stream beside the stream it reads. */
+export function deadStreamOf(stream, consumer) {
+    return `${stream}:${consumer}:dead`;
+}
+//# sourceMappingURL=dead-stream-of.js.map

package/dist/streams/topology/dead-stream-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-stream-of.js","sourceRoot":"","sources":["../../../src/streams/topology/dead-stream-of.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,QAAgB;IAC3D,OAAO,GAAG,MAAM,IAAI,QAAQ,OAAO,CAAC;AACtC,CAAC"}

package/dist/streams/topology/declare-topology.d.ts

@@ -0,0 +1,5 @@
+import type { Redis } from 'ioredis';
+import type { RedisStreamsTopology } from './redis-streams-topology.js';
+/** Idempotent: a group that exists is left where it is, a stream that does not is created empty. */
+export declare function declareTopology(client: Redis, topology: RedisStreamsTopology): Promise<void>;
+//# sourceMappingURL=declare-topology.d.ts.map

package/dist/streams/topology/declare-topology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declare-topology.d.ts","sourceRoot":"","sources":["../../../src/streams/topology/declare-topology.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAExE,oGAAoG;AACpG,wBAAsB,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAIlG"}

package/dist/streams/topology/declare-topology.js

@@ -0,0 +1,8 @@
+import { createGroup } from './create-group.js';
+/** Idempotent: a group that exists is left where it is, a stream that does not is created empty. */
+export async function declareTopology(client, topology) {
+    for (const group of topology.groups) {
+        await createGroup(client, group);
+    }
+}
+//# sourceMappingURL=declare-topology.js.map

package/dist/streams/topology/declare-topology.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declare-topology.js","sourceRoot":"","sources":["../../../src/streams/topology/declare-topology.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,oGAAoG;AACpG,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAa,EAAE,QAA8B;IACjF,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpC,MAAM,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;AACH,CAAC"}

package/dist/streams/topology/group-description.d.ts

@@ -0,0 +1,7 @@
+export interface GroupDescription {
+    readonly stream: string;
+    /** The consumer name. */
+    readonly name: string;
+    readonly startFrom: 'new' | 'beginning';
+}
+//# sourceMappingURL=group-description.d.ts.map

package/dist/streams/topology/group-description.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-description.d.ts","sourceRoot":"","sources":["../../../src/streams/topology/group-description.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,yBAAyB;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,WAAW,CAAC;CACzC"}

package/dist/streams/topology/group-description.js

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

package/dist/streams/topology/group-description.js.map

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

package/dist/streams/topology/group-of.d.ts

@@ -0,0 +1,5 @@
+import type { ConsumerBinding } from './consumer-binding.js';
+import type { GroupDescription } from './group-description.js';
+import type { TopologySettings } from './topology-settings.js';
+export declare function groupOf(settings: TopologySettings, binding: ConsumerBinding): GroupDescription;
+//# sourceMappingURL=group-of.d.ts.map

package/dist/streams/topology/group-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-of.d.ts","sourceRoot":"","sources":["../../../src/streams/topology/group-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,wBAAgB,OAAO,CAAC,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,eAAe,GAAG,gBAAgB,CAE9F"}

package/dist/streams/topology/group-of.js

@@ -0,0 +1,4 @@
+export function groupOf(settings, binding) {
+    return { stream: settings.streamOf(binding.type), name: binding.consumer, startFrom: settings.startFrom };
+}
+//# sourceMappingURL=group-of.js.map

package/dist/streams/topology/group-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-of.js","sourceRoot":"","sources":["../../../src/streams/topology/group-of.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,OAAO,CAAC,QAA0B,EAAE,OAAwB;IAC1E,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC;AAC5G,CAAC"}

package/dist/streams/topology/redis-streams-topology.d.ts

@@ -0,0 +1,8 @@
+import type { GroupDescription } from './group-description.js';
+import type { StreamDescription } from './stream-description.js';
+/** Everything the bus creates on the server, as data: for documentation and reviews. */
+export interface RedisStreamsTopology {
+    readonly streams: readonly StreamDescription[];
+    readonly groups: readonly GroupDescription[];
+}
+//# sourceMappingURL=redis-streams-topology.d.ts.map

package/dist/streams/topology/redis-streams-topology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-streams-topology.d.ts","sourceRoot":"","sources":["../../../src/streams/topology/redis-streams-topology.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,wFAAwF;AACxF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC9C"}

package/dist/streams/topology/redis-streams-topology.js

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

package/dist/streams/topology/redis-streams-topology.js.map

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

package/dist/streams/topology/stream-description.d.ts

@@ -0,0 +1,12 @@
+import type { RetentionOptions } from '../options/retention-options.js';
+export interface StreamDescription {
+    readonly name: string;
+    /** `events` is published to and read by every group; `dead` keeps what one consumer gave up on. */
+    readonly role: 'events' | 'dead';
+    readonly type: string;
+    /** The consumer a dead stream belongs to. */
+    readonly consumer?: string;
+    /** The trimming each publication applies to an events stream, when one is configured. */
+    readonly retention?: RetentionOptions;
+}
+//# sourceMappingURL=stream-description.d.ts.map

package/dist/streams/topology/stream-description.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-description.d.ts","sourceRoot":"","sources":["../../../src/streams/topology/stream-description.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAExE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,mGAAmG;IACnG,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IAEjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B,yFAAyF;IACzF,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;CACvC"}

package/dist/streams/topology/stream-description.js

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

package/dist/streams/topology/stream-description.js.map

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

package/dist/streams/topology/stream-names-of.d.ts

@@ -0,0 +1,5 @@
+import type { ConsumerBinding } from './consumer-binding.js';
+import type { StreamNames } from './stream-names.js';
+/** The streams of a consumer for a type. `streamOf` is the mapping the bus was built with, the default one otherwise. */
+export declare function streamNamesOf({ consumer, type }: ConsumerBinding, streamOf?: (type: string) => string): StreamNames;
+//# sourceMappingURL=stream-names-of.d.ts.map

package/dist/streams/topology/stream-names-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-names-of.d.ts","sourceRoot":"","sources":["../../../src/streams/topology/stream-names-of.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,yHAAyH;AACzH,wBAAgB,aAAa,CAC3B,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,eAAe,EACnC,QAAQ,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAwB,GACnD,WAAW,CAIb"}

package/dist/streams/topology/stream-names-of.js

@@ -0,0 +1,11 @@
+import { DEFAULT_PREFIX } from '../options/default-prefix.js';
+import { deadStreamOf } from './dead-stream-of.js';
+/** The streams of a consumer for a type. `streamOf` is the mapping the bus was built with, the default one otherwise. */
+export function streamNamesOf({ consumer, type }, streamOf = defaultStreamOf) {
+    const events = streamOf(type);
+    return { events, dead: deadStreamOf(events, consumer) };
+}
+function defaultStreamOf(type) {
+    return `${DEFAULT_PREFIX}:${type}`;
+}
+//# sourceMappingURL=stream-names-of.js.map

package/dist/streams/topology/stream-names-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-names-of.js","sourceRoot":"","sources":["../../../src/streams/topology/stream-names-of.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,yHAAyH;AACzH,MAAM,UAAU,aAAa,CAC3B,EAAE,QAAQ,EAAE,IAAI,EAAmB,EACnC,QAAQ,GAA6B,eAAe;IAEpD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE9B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;AAC1D,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,GAAG,cAAc,IAAI,IAAI,EAAE,CAAC;AACrC,CAAC"}

package/dist/streams/topology/stream-names.d.ts

@@ -0,0 +1,5 @@
+export interface StreamNames {
+    readonly events: string;
+    readonly dead: string;
+}
+//# sourceMappingURL=stream-names.d.ts.map

package/dist/streams/topology/stream-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-names.d.ts","sourceRoot":"","sources":["../../../src/streams/topology/stream-names.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB"}

package/dist/streams/topology/stream-names.js

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

package/dist/streams/topology/stream-names.js.map

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

package/dist/streams/topology/topology-of.d.ts

@@ -0,0 +1,5 @@
+import type { ConsumerBinding } from './consumer-binding.js';
+import type { RedisStreamsTopology } from './redis-streams-topology.js';
+import type { TopologySettings } from './topology-settings.js';
+export declare function topologyOf(settings: TopologySettings, bindings: readonly ConsumerBinding[]): RedisStreamsTopology;
+//# sourceMappingURL=topology-of.d.ts.map

package/dist/streams/topology/topology-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topology-of.d.ts","sourceRoot":"","sources":["../../../src/streams/topology/topology-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,wBAAgB,UAAU,CAAC,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,SAAS,eAAe,EAAE,GAAG,oBAAoB,CAUjH"}

package/dist/streams/topology/topology-of.js

@@ -0,0 +1,21 @@
+import { groupOf } from './group-of.js';
+import { streamNamesOf } from './stream-names-of.js';
+export function topologyOf(settings, bindings) {
+    const types = [...new Set(bindings.map((binding) => binding.type))];
+    return {
+        streams: [
+            ...types.map((type) => eventsStreamOf(settings, type)),
+            ...bindings.map((binding) => deadLettersOf(settings, binding)),
+        ],
+        groups: bindings.map((binding) => groupOf(settings, binding)),
+    };
+}
+function eventsStreamOf(settings, type) {
+    const { retention } = settings;
+    return { name: settings.streamOf(type), role: 'events', type, ...(retention === undefined ? {} : { retention }) };
+}
+function deadLettersOf(settings, binding) {
+    const { dead } = streamNamesOf(binding, settings.streamOf);
+    return { name: dead, role: 'dead', type: binding.type, consumer: binding.consumer };
+}
+//# sourceMappingURL=topology-of.js.map

package/dist/streams/topology/topology-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topology-of.js","sourceRoot":"","sources":["../../../src/streams/topology/topology-of.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,MAAM,UAAU,UAAU,CAAC,QAA0B,EAAE,QAAoC;IACzF,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAEpE,OAAO;QACL,OAAO,EAAE;YACP,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YACtD,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;SAC/D;QACD,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;KAC9D,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,QAA0B,EAAE,IAAY;IAC9D,MAAM,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC;IAE/B,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;AACpH,CAAC;AAED,SAAS,aAAa,CAAC,QAA0B,EAAE,OAAwB;IACzE,MAAM,EAAE,IAAI,EAAE,GAAG,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAE3D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;AACtF,CAAC"}

package/dist/streams/topology/topology-settings.d.ts

@@ -0,0 +1,7 @@
+import type { RetentionOptions } from '../options/retention-options.js';
+export interface TopologySettings {
+    readonly streamOf: (type: string) => string;
+    readonly startFrom: 'new' | 'beginning';
+    readonly retention: RetentionOptions | undefined;
+}
+//# sourceMappingURL=topology-settings.d.ts.map

package/dist/streams/topology/topology-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topology-settings.d.ts","sourceRoot":"","sources":["../../../src/streams/topology/topology-settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAExE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,WAAW,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,GAAG,SAAS,CAAC;CAClD"}

package/dist/streams/topology/topology-settings.js

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

package/dist/streams/topology/topology-settings.js.map

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

package/dist/testing.d.ts

@@ -0,0 +1,2 @@
+export { cacheContract, lockContract, rateLimiterContract, type CacheContractOptions, type LockContractOptions, type RateLimiterContractOptions, } from '@ddd-ts-kit/testing/contracts';
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,GAChC,MAAM,+BAA+B,CAAC"}

package/dist/testing.js

@@ -0,0 +1,2 @@
+export { cacheContract, lockContract, rateLimiterContract, } from '@ddd-ts-kit/testing/contracts';
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,YAAY,EACZ,mBAAmB,GAIpB,MAAM,+BAA+B,CAAC"}

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "@ddd-ts-kit/redis",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Adapters of the kernel ports on the Redis protocol (Redis, Dragonfly, Valkey): cache, distributed lock, rate limiter, relay wake-up signal, and an integration event provider on Redis Streams.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gbourgeat/ddd-ts-kit.git",
+    "directory": "packages/redis"
+  },
+  "homepage": "https://github.com/gbourgeat/ddd-ts-kit/tree/main/packages/redis#readme",
+  "bugs": "https://github.com/gbourgeat/ddd-ts-kit/issues",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./event-bus": {
+      "types": "./dist/event-bus.d.ts",
+      "default": "./dist/event-bus.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "default": "./dist/testing.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@ddd-ts-kit/kernel": "0.1.1"
+  },
+  "peerDependencies": {
+    "ioredis": "^5.0.0 || ^6.0.0",
+    "@ddd-ts-kit/testing": "0.1.1"
+  },
+  "peerDependenciesMeta": {
+    "@ddd-ts-kit/testing": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "ioredis": "^6.0.0",
+    "@ddd-ts-kit/events": "0.1.1",
+    "@ddd-ts-kit/testing": "0.1.1"
+  }
+}