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

package/dist/cache/cache-codec.d.ts

@@ -0,0 +1,6 @@
+/** How a value becomes the text the server stores, and back. */
+export interface CacheCodec {
+    encode(value: unknown): string;
+    decode(text: string): unknown;
+}
+//# sourceMappingURL=cache-codec.d.ts.map

package/dist/cache/cache-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-codec.d.ts","sourceRoot":"","sources":["../../src/cache/cache-codec.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IAE/B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B"}

package/dist/cache/cache-codec.js

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

package/dist/cache/cache-codec.js.map

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

package/dist/cache/cache-operation.d.ts

@@ -0,0 +1,3 @@
+/** The `operation` label of `cache_errors_total`. */
+export type CacheOperation = 'get' | 'set' | 'delete';
+//# sourceMappingURL=cache-operation.d.ts.map

package/dist/cache/cache-operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-operation.d.ts","sourceRoot":"","sources":["../../src/cache/cache-operation.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC"}

package/dist/cache/cache-operation.js

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

package/dist/cache/cache-operation.js.map

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

package/dist/cache/json-codec.d.ts

@@ -0,0 +1,4 @@
+import type { CacheCodec } from './cache-codec.js';
+/** The default: what goes in must be JSON, and a `Date` comes back as a string. */
+export declare const jsonCodec: CacheCodec;
+//# sourceMappingURL=json-codec.d.ts.map

package/dist/cache/json-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-codec.d.ts","sourceRoot":"","sources":["../../src/cache/json-codec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,mFAAmF;AACnF,eAAO,MAAM,SAAS,EAAE,UAOvB,CAAC"}

package/dist/cache/json-codec.js

@@ -0,0 +1,9 @@
+/** The default: what goes in must be JSON, and a `Date` comes back as a string. */
+export const jsonCodec = {
+    encode: (value) => JSON.stringify(value),
+    decode: (text) => {
+        const value = JSON.parse(text);
+        return value;
+    },
+};
+//# sourceMappingURL=json-codec.js.map

package/dist/cache/json-codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-codec.js","sourceRoot":"","sources":["../../src/cache/json-codec.ts"],"names":[],"mappings":"AAEA,mFAAmF;AACnF,MAAM,CAAC,MAAM,SAAS,GAAe;IACnC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;IACxC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QACf,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAExC,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAC"}

package/dist/cache/redis-cache.d.ts

@@ -0,0 +1,65 @@
+import { inspect } from 'node:util';
+import type { Redis } from 'ioredis';
+import { type Cache, type CacheEntryOptions, type CacheKey, type Lock, type Metrics } from '@ddd-ts-kit/kernel';
+import type { CacheCodec } from './cache-codec.js';
+export interface RedisCacheOptions {
+    /** Prefix of every key, typically the bounded context: two contexts never read each other's entries. */
+    readonly namespace?: string;
+    readonly codec?: CacheCodec;
+    /**
+     * What a failing server costs. `miss` (default): a read answers `undefined`, a write is
+     * dropped, and the application runs without its cache. `throw`: the failure reaches the caller.
+     */
+    readonly onError?: 'miss' | 'throw';
+    /** Counts the failures as `cache_errors_total`, by operation and namespace. */
+    readonly metrics?: Metrics;
+    /** Lets `getOrLoad` compute a missing value in one process only: see there. */
+    readonly lock?: Lock;
+}
+export interface LoadOptions extends CacheEntryOptions {
+    /** How long one process may take to compute the value before another one tries. Default 10000. */
+    readonly lockTtlMs?: number;
+    /** How long the others wait for that value before computing it themselves. Default 2000. */
+    readonly waitMs?: number;
+}
+/**
+ * The kernel `Cache` on the Redis protocol. A value that can be computed again, never the
+ * source of truth: by default a server that is away costs a miss, not a failure.
+ */
+export declare class RedisCache implements Cache {
+    private readonly client;
+    private readonly namespace;
+    private readonly codec;
+    private readonly failing;
+    private readonly errors;
+    private readonly lock;
+    private readonly loading;
+    constructor(client: Redis, options?: RedisCacheOptions);
+    get<T>(key: CacheKey<T>): Promise<T | undefined>;
+    set<T>(key: CacheKey<T>, value: T, options?: CacheEntryOptions): Promise<void>;
+    delete(key: CacheKey<unknown>): Promise<void>;
+    /**
+     * Deletes every entry of the namespace whose name starts with the prefix, and says how
+     * many. Walks the keys with `SCAN`, never `KEYS`: the server keeps answering meanwhile, and
+     * an entry written during the walk may be missed.
+     */
+    deleteByPrefix(prefix: string): Promise<number>;
+    /**
+     * Reads the entry, or computes it once and stores it. Concurrent callers of one process
+     * share a single computation. With a `lock`, the processes share it too: one computes, the
+     * others wait for its value up to `waitMs`, then compute it themselves rather than fail.
+     * `cached` of `@ddd-ts-kit/aspects` already shares the call inside a process; this is for
+     * the value that is expensive enough to protect across instances.
+     */
+    getOrLoad<T>(key: CacheKey<T>, load: () => Promise<T>, options?: LoadOptions): Promise<T>;
+    /** What a serialisation shows: a name, never the client, whose options carry the password. */
+    toJSON(): string;
+    /** What `console.log` and `util.inspect` show: the same. */
+    [inspect.custom](): string;
+    private keyOf;
+    private guarded;
+    private deleteMatching;
+    private loadOnce;
+    private lockFor;
+}
+//# sourceMappingURL=redis-cache.d.ts.map

package/dist/cache/redis-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-cache.d.ts","sourceRoot":"","sources":["../../src/cache/redis-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAEL,KAAK,KAAK,EACV,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EAEb,KAAK,IAAI,EACT,KAAK,OAAO,EACb,MAAM,oBAAoB,CAAC;AAI5B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAInD,MAAM,WAAW,iBAAiB;IAChC,wGAAwG;IACxG,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAEpC,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAE3B,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,WAAY,SAAQ,iBAAiB;IACpD,kGAAkG;IAClG,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,4FAA4F;IAC5F,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAKD;;;GAGG;AACH,qBAAa,UAAW,YAAW,KAAK;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAE/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAE/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IAEnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAElC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IAEjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmB;IAExC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAE/D,YAAY,MAAM,EAAE,KAAK,EAAE,OAAO,GAAE,iBAAsB,EAQzD;IAEK,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAWrD;IAEK,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAavF;IAEK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAElD;IAED;;;;OAIG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIpD;IAED;;;;;;OAMG;IACG,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,CAAC,CAAC,CAclG;IAED,8FAA8F;IAC9F,MAAM,IAAI,MAAM,CAEf;IAED,4DAA4D;IAC5D,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAEzB;IAED,OAAO,CAAC,KAAK;YAIC,OAAO;YAcP,cAAc;YAkBd,QAAQ;YAoBR,OAAO;CAUtB"}

package/dist/cache/redis-cache.js

@@ -0,0 +1,147 @@
+import { inspect } from 'node:util';
+import { NoopMetrics, } from '@ddd-ts-kit/kernel';
+import { namespaced } from '../keys/namespaced.js';
+import { prefixPattern } from '../keys/prefix-pattern.js';
+import { conceal } from '../secrecy/conceal.js';
+import { jsonCodec } from './json-codec.js';
+const SCAN_BATCH = 200;
+const DESCRIPTION = 'RedisCache [client concealed]';
+/**
+ * The kernel `Cache` on the Redis protocol. A value that can be computed again, never the
+ * source of truth: by default a server that is away costs a miss, not a failure.
+ */
+export class RedisCache {
+    client;
+    namespace;
+    codec;
+    failing;
+    errors;
+    lock;
+    loading = new Map();
+    constructor(client, options = {}) {
+        this.client = client;
+        this.namespace = options.namespace;
+        this.codec = options.codec ?? jsonCodec;
+        this.failing = options.onError === 'throw';
+        this.errors = (options.metrics ?? new NoopMetrics()).counter('cache_errors_total');
+        this.lock = options.lock;
+        conceal(this);
+    }
+    async get(key) {
+        const text = await this.guarded('get', () => this.client.get(this.keyOf(key.name)));
+        if (text === undefined || text === null) {
+            return undefined;
+        }
+        return this.guarded('get', async () => {
+            // eslint-disable-next-line ddd-ts-kit/clean-no-escape-hatch -- the server holds text: the link between a key and the type of its value is only known to the CacheKey that wrote it
+            return this.codec.decode(text);
+        });
+    }
+    async set(key, value, options = {}) {
+        const name = this.keyOf(key.name);
+        const { ttlMs } = options;
+        await this.guarded('set', async () => {
+            if (ttlMs === undefined) {
+                await this.client.set(name, this.codec.encode(value));
+            }
+            else if (ttlMs <= 0) {
+                await this.client.del(name);
+            }
+            else {
+                await this.client.set(name, this.codec.encode(value), 'PX', Math.ceil(ttlMs));
+            }
+        });
+    }
+    async delete(key) {
+        await this.guarded('delete', () => this.client.del(this.keyOf(key.name)));
+    }
+    /**
+     * Deletes every entry of the namespace whose name starts with the prefix, and says how
+     * many. Walks the keys with `SCAN`, never `KEYS`: the server keeps answering meanwhile, and
+     * an entry written during the walk may be missed.
+     */
+    async deleteByPrefix(prefix) {
+        const deleted = await this.guarded('delete', () => this.deleteMatching(prefixPattern(this.keyOf(prefix))));
+        return deleted ?? 0;
+    }
+    /**
+     * Reads the entry, or computes it once and stores it. Concurrent callers of one process
+     * share a single computation. With a `lock`, the processes share it too: one computes, the
+     * others wait for its value up to `waitMs`, then compute it themselves rather than fail.
+     * `cached` of `@ddd-ts-kit/aspects` already shares the call inside a process; this is for
+     * the value that is expensive enough to protect across instances.
+     */
+    async getOrLoad(key, load, options = {}) {
+        const hit = await this.get(key);
+        if (hit !== undefined) {
+            return hit;
+        }
+        const pending = this.loading.get(key.name) ?? this.loadOnce(key, load, options).finally(() => this.loading.delete(key.name));
+        this.loading.set(key.name, pending);
+        // eslint-disable-next-line ddd-ts-kit/clean-no-escape-hatch -- computations of every type share one map: the one stored under this name was started with this key
+        return pending;
+    }
+    /** What a serialisation shows: a name, never the client, whose options carry the password. */
+    toJSON() {
+        return DESCRIPTION;
+    }
+    /** What `console.log` and `util.inspect` show: the same. */
+    [inspect.custom]() {
+        return DESCRIPTION;
+    }
+    keyOf(name) {
+        return namespaced(this.namespace, name);
+    }
+    async guarded(operation, work) {
+        try {
+            return await work();
+        }
+        catch (error) {
+            this.errors.increment({ operation, ...(this.namespace === undefined ? {} : { context: this.namespace }) });
+            if (this.failing) {
+                throw error;
+            }
+            return undefined;
+        }
+    }
+    async deleteMatching(pattern) {
+        let cursor = '0';
+        let deleted = 0;
+        do {
+            const [next, keys] = await this.client.scan(cursor, 'MATCH', pattern, 'COUNT', SCAN_BATCH);
+            // One key per command: a cluster refuses a DEL whose keys live in different slots.
+            for (const key of keys) {
+                deleted += await this.client.del(key);
+            }
+            cursor = next;
+        } while (cursor !== '0');
+        return deleted;
+    }
+    async loadOnce(key, load, options) {
+        const handle = await this.lockFor(key.name, options);
+        try {
+            const filled = this.lock === undefined ? undefined : await this.get(key);
+            if (filled !== undefined) {
+                return filled;
+            }
+            const value = await load();
+            await this.set(key, value, options.ttlMs === undefined ? {} : { ttlMs: options.ttlMs });
+            return value;
+        }
+        finally {
+            await handle?.release().catch(() => undefined);
+        }
+    }
+    async lockFor(name, options) {
+        try {
+            return await this.lock?.acquire(`cache:${this.keyOf(name)}`, {
+                ttlMs: options.lockTtlMs ?? 10_000,
+                waitMs: options.waitMs ?? 2_000,
+            });
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+//# sourceMappingURL=redis-cache.js.map

package/dist/cache/redis-cache.js.map

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

package/dist/connection/close-redis.d.ts

@@ -0,0 +1,4 @@
+import type { Redis } from 'ioredis';
+/** `QUIT` when the connection is up, a plain disconnection otherwise. Resolves once the socket is closed. */
+export declare function closeRedis(client: Redis): Promise<void>;
+//# sourceMappingURL=close-redis.d.ts.map

package/dist/connection/close-redis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-redis.d.ts","sourceRoot":"","sources":["../../src/connection/close-redis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,6GAA6G;AAC7G,wBAAsB,UAAU,CAAC,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAe7D"}

package/dist/connection/close-redis.js

@@ -0,0 +1,20 @@
+/** `QUIT` when the connection is up, a plain disconnection otherwise. Resolves once the socket is closed. */
+export async function closeRedis(client) {
+    if (client.status === 'end') {
+        return;
+    }
+    // Between two attempts there is no socket whose closing could be awaited.
+    const closing = client.status === 'reconnecting' ? Promise.resolve() : ended(client);
+    // A connection that is not ready would queue the QUIT until it is, and may never be.
+    if (client.status === 'ready') {
+        await client.quit().catch(() => undefined);
+    }
+    client.disconnect();
+    await closing;
+}
+function ended(client) {
+    return new Promise((resolve) => {
+        client.once('end', resolve);
+    });
+}
+//# sourceMappingURL=close-redis.js.map

package/dist/connection/close-redis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-redis.js","sourceRoot":"","sources":["../../src/connection/close-redis.ts"],"names":[],"mappings":"AAEA,6GAA6G;AAC7G,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAa;IAC5C,IAAI,MAAM,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QAC5B,OAAO;IACT,CAAC;IAED,0EAA0E;IAC1E,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,KAAK,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAErF,qFAAqF;IACrF,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC9B,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,CAAC,UAAU,EAAE,CAAC;IACpB,MAAM,OAAO,CAAC;AAChB,CAAC;AAED,SAAS,KAAK,CAAC,MAAa;IAC1B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/connection/connect-redis.d.ts

@@ -0,0 +1,10 @@
+import { Redis } from 'ioredis';
+import type { RedisSource } from './redis-source.js';
+export interface RedisConnection {
+    readonly client: Redis;
+    /** Closes the connection when `connectRedis` opened it; a client that was handed over stays open. */
+    close(): Promise<void>;
+}
+/** One connection for every adapter of this package: Redis, Dragonfly and Valkey speak the same protocol. */
+export declare function connectRedis(source: RedisSource): RedisConnection;
+//# sourceMappingURL=connect-redis.d.ts.map

package/dist/connection/connect-redis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-redis.d.ts","sourceRoot":"","sources":["../../src/connection/connect-redis.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IAEvB,qGAAqG;IACrG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAID,6GAA6G;AAC7G,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,eAAe,CAQjE"}

package/dist/connection/connect-redis.js

@@ -0,0 +1,26 @@
+import { inspect } from 'node:util';
+import { Redis } from 'ioredis';
+import { closeRedis } from './close-redis.js';
+import { FAIL_FAST } from './fail-fast.js';
+const DESCRIPTION = 'RedisConnection [client concealed]';
+/** One connection for every adapter of this package: Redis, Dragonfly and Valkey speak the same protocol. */
+export function connectRedis(source) {
+    if (source instanceof Redis) {
+        return handedOut(source, async () => undefined);
+    }
+    const client = typeof source === 'string' ? new Redis(source, FAIL_FAST) : new Redis({ ...FAIL_FAST, ...source });
+    return handedOut(client, () => closeRedis(client));
+}
+/**
+ * The client of ioredis shows its options, password included, to whoever inspects it, and
+ * that cannot be changed from here. It is reached by name; a log, a spread or a serialisation
+ * of the connection does not lead to it.
+ */
+function handedOut(client, close) {
+    return Object.defineProperties({ client, close }, {
+        client: { enumerable: false },
+        toJSON: { value: () => DESCRIPTION },
+        [inspect.custom]: { value: () => DESCRIPTION },
+    });
+}
+//# sourceMappingURL=connect-redis.js.map

package/dist/connection/connect-redis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-redis.js","sourceRoot":"","sources":["../../src/connection/connect-redis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAU3C,MAAM,WAAW,GAAG,oCAAoC,CAAC;AAEzD,6GAA6G;AAC7G,MAAM,UAAU,YAAY,CAAC,MAAmB;IAC9C,IAAI,MAAM,YAAY,KAAK,EAAE,CAAC;QAC5B,OAAO,SAAS,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,EAAE,GAAG,SAAS,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IAElH,OAAO,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,SAAS,SAAS,CAAC,MAAa,EAAE,KAA0B;IAC1D,OAAO,MAAM,CAAC,gBAAgB,CAC5B,EAAE,MAAM,EAAE,KAAK,EAAE,EACjB;QACE,MAAM,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE;QAC7B,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;QACpC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;KAC/C,CACF,CAAC;AACJ,CAAC"}

package/dist/connection/fail-fast.d.ts

@@ -0,0 +1,9 @@
+import type { RedisConnectionOptions } from './redis-connection-options.js';
+/**
+ * What a connection opened here adds to the defaults of ioredis, unless the options say
+ * otherwise: a command fails after 2 seconds and after one reconnection, instead of waiting
+ * for twenty. An adapter of this package then answers its `onError` policy while the server
+ * is away, and the application keeps serving.
+ */
+export declare const FAIL_FAST: RedisConnectionOptions;
+//# sourceMappingURL=fail-fast.d.ts.map

package/dist/connection/fail-fast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fail-fast.d.ts","sourceRoot":"","sources":["../../src/connection/fail-fast.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAE5E;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,sBAA0F,CAAC"}

package/dist/connection/fail-fast.js

@@ -0,0 +1,8 @@
+/**
+ * What a connection opened here adds to the defaults of ioredis, unless the options say
+ * otherwise: a command fails after 2 seconds and after one reconnection, instead of waiting
+ * for twenty. An adapter of this package then answers its `onError` policy while the server
+ * is away, and the application keeps serving.
+ */
+export const FAIL_FAST = Object.freeze({ commandTimeout: 2_000, maxRetriesPerRequest: 1 });
+//# sourceMappingURL=fail-fast.js.map

package/dist/connection/fail-fast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fail-fast.js","sourceRoot":"","sources":["../../src/connection/fail-fast.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAA2B,MAAM,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC,EAAE,CAAC,CAAC"}

package/dist/connection/redis-connection-options.d.ts

@@ -0,0 +1,7 @@
+import type { RedisOptions } from 'ioredis';
+/**
+ * The options of ioredis, without the reply mapping ioredis 6 added: the adapters of this
+ * package read the replies in their classic shape.
+ */
+export type RedisConnectionOptions = Omit<RedisOptions, 'replyMapping'>;
+//# sourceMappingURL=redis-connection-options.d.ts.map

package/dist/connection/redis-connection-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-connection-options.d.ts","sourceRoot":"","sources":["../../src/connection/redis-connection-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC"}

package/dist/connection/redis-connection-options.js

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

package/dist/connection/redis-connection-options.js.map

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

package/dist/connection/redis-health.d.ts

@@ -0,0 +1,15 @@
+import type { Redis } from 'ioredis';
+export type RedisHealth = {
+    readonly status: 'up';
+    readonly latencyMs: number;
+} | {
+    readonly status: 'down';
+    readonly reason: 'timeout' | 'unreachable';
+};
+export interface RedisHealthOptions {
+    /** Default 1000. */
+    readonly timeoutMs?: number;
+}
+/** For a readiness probe: one `PING`, an answer within the timeout, and never an exception. */
+export declare function redisHealth(client: Redis, options?: RedisHealthOptions): Promise<RedisHealth>;
+//# sourceMappingURL=redis-health.d.ts.map

package/dist/connection/redis-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-health.d.ts","sourceRoot":"","sources":["../../src/connection/redis-health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,aAAa,CAAA;CAAE,CAAC;AAE5E,MAAM,WAAW,kBAAkB;IACjC,oBAAoB;IACpB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,+FAA+F;AAC/F,wBAAsB,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC,CAkBvG"}

package/dist/connection/redis-health.js

@@ -0,0 +1,31 @@
+/** For a readiness probe: one `PING`, an answer within the timeout, and never an exception. */
+export async function redisHealth(client, options = {}) {
+    const started = performance.now();
+    const timer = new AbortController();
+    try {
+        const answered = await Promise.race([
+            client.ping().then(() => true),
+            expiry(options.timeoutMs ?? 1_000, timer.signal),
+        ]);
+        return answered
+            ? { status: 'up', latencyMs: Math.round(performance.now() - started) }
+            : { status: 'down', reason: 'timeout' };
+    }
+    catch {
+        return { status: 'down', reason: 'unreachable' };
+    }
+    finally {
+        timer.abort();
+    }
+}
+function expiry(ms, cancelled) {
+    return new Promise((resolve) => {
+        const timeout = setTimeout(() => {
+            resolve(false);
+        }, ms);
+        cancelled.addEventListener('abort', () => {
+            clearTimeout(timeout);
+        });
+    });
+}
+//# sourceMappingURL=redis-health.js.map

package/dist/connection/redis-health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-health.js","sourceRoot":"","sources":["../../src/connection/redis-health.ts"],"names":[],"mappings":"AAWA,+FAA+F;AAC/F,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAa,EAAE,OAAO,GAAuB,EAAE;IAC/E,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;IAEpC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;YAClC,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;YAC9B,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC;SACjD,CAAC,CAAC;QAEH,OAAO,QAAQ;YACb,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,EAAE;YACtE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IACnD,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,EAAU,EAAE,SAAsB;IAChD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,EAAE,EAAE,CAAC,CAAC;QAEP,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YACvC,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/connection/redis-source.d.ts

@@ -0,0 +1,5 @@
+import type { Redis } from 'ioredis';
+import type { RedisConnectionOptions } from './redis-connection-options.js';
+/** A client the application already owns, a connection URL, or the options of ioredis. */
+export type RedisSource = Redis | RedisConnectionOptions | string;
+//# sourceMappingURL=redis-source.d.ts.map

package/dist/connection/redis-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-source.d.ts","sourceRoot":"","sources":["../../src/connection/redis-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAE5E,0FAA0F;AAC1F,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,sBAAsB,GAAG,MAAM,CAAC"}

package/dist/connection/redis-source.js

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

package/dist/connection/redis-source.js.map

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

package/dist/event-bus.d.ts

@@ -0,0 +1,22 @@
+export { RedisStreamsEventBus } from './streams/redis-streams-event-bus.js';
+export { DEFAULT_PREFIX } from './streams/options/default-prefix.js';
+export type { DeduplicationOptions } from './streams/options/deduplication-options.js';
+export type { ReconnectOptions } from './streams/options/reconnect-options.js';
+export type { RedisStreamsDelivery } from './streams/options/redis-streams-delivery.js';
+export type { RedisStreamsEventBusOptions } from './streams/options/redis-streams-event-bus-options.js';
+export type { RedisStreamsFailure } from './streams/options/redis-streams-failure.js';
+export type { RetentionOptions } from './streams/options/retention-options.js';
+export type { RetryOptions } from './streams/options/retry-options.js';
+export { streamNamesOf } from './streams/topology/stream-names-of.js';
+export type { ConsumerBinding } from './streams/topology/consumer-binding.js';
+export type { GroupDescription } from './streams/topology/group-description.js';
+export type { RedisStreamsTopology } from './streams/topology/redis-streams-topology.js';
+export type { StreamDescription } from './streams/topology/stream-description.js';
+export type { StreamNames } from './streams/topology/stream-names.js';
+export { ATTEMPT_FIELD, CONSUMER_FIELD, CORRELATION_FIELD, DEAD_REASON_FIELD, ENTRY_ID_FIELD, ENVELOPE_FIELD, ERROR_CODE_FIELD, EVENT_ID_FIELD, EVENT_TYPE_FIELD, EVENT_VERSION_FIELD, REPLAY_FOR_FIELD, TRACEPARENT_FIELD, } from './streams/codec/entry-fields.js';
+export { ATTEMPTS_EXHAUSTED, POISON_ENTRY } from './streams/settlement.js';
+export { BrokerUnavailableError } from './streams/errors/broker-unavailable-error.js';
+export { ConsumerNameRequiredError } from './streams/errors/consumer-name-required-error.js';
+export { EventBusClosedError } from './streams/errors/event-bus-closed-error.js';
+export { PublishNotConfirmedError } from './streams/errors/publish-not-confirmed-error.js';
+//# sourceMappingURL=event-bus.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../src/event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,YAAY,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AACvF,YAAY,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,YAAY,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AACxF,YAAY,EAAE,2BAA2B,EAAE,MAAM,sDAAsD,CAAC;AACxG,YAAY,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AACtF,YAAY,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,YAAY,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AACtE,YAAY,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAC9E,YAAY,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAChF,YAAY,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACzF,YAAY,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAClF,YAAY,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EACL,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AACtF,OAAO,EAAE,yBAAyB,EAAE,MAAM,kDAAkD,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAC"}

package/dist/event-bus.js

@@ -0,0 +1,10 @@
+export { RedisStreamsEventBus } from './streams/redis-streams-event-bus.js';
+export { DEFAULT_PREFIX } from './streams/options/default-prefix.js';
+export { streamNamesOf } from './streams/topology/stream-names-of.js';
+export { ATTEMPT_FIELD, CONSUMER_FIELD, CORRELATION_FIELD, DEAD_REASON_FIELD, ENTRY_ID_FIELD, ENVELOPE_FIELD, ERROR_CODE_FIELD, EVENT_ID_FIELD, EVENT_TYPE_FIELD, EVENT_VERSION_FIELD, REPLAY_FOR_FIELD, TRACEPARENT_FIELD, } from './streams/codec/entry-fields.js';
+export { ATTEMPTS_EXHAUSTED, POISON_ENTRY } from './streams/settlement.js';
+export { BrokerUnavailableError } from './streams/errors/broker-unavailable-error.js';
+export { ConsumerNameRequiredError } from './streams/errors/consumer-name-required-error.js';
+export { EventBusClosedError } from './streams/errors/event-bus-closed-error.js';
+export { PublishNotConfirmedError } from './streams/errors/publish-not-confirmed-error.js';
+//# sourceMappingURL=event-bus.js.map

package/dist/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../src/event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAQrE,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAMtE,OAAO,EACL,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AACtF,OAAO,EAAE,yBAAyB,EAAE,MAAM,kDAAkD,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export { RedisCache, type LoadOptions, type RedisCacheOptions } from './cache/redis-cache.js';
+export type { CacheCodec } from './cache/cache-codec.js';
+export type { CacheOperation } from './cache/cache-operation.js';
+export { jsonCodec } from './cache/json-codec.js';
+export { closeRedis } from './connection/close-redis.js';
+export { connectRedis, type RedisConnection } from './connection/connect-redis.js';
+export { FAIL_FAST } from './connection/fail-fast.js';
+export type { RedisConnectionOptions } from './connection/redis-connection-options.js';
+export { redisHealth, type RedisHealth, type RedisHealthOptions } from './connection/redis-health.js';
+export type { RedisSource } from './connection/redis-source.js';
+export { RedisLock, type RedisLockOptions } from './lock/redis-lock.js';
+export { RedisRateLimiter, type RedisRateLimiterOptions } from './rate-limiter/redis-rate-limiter.js';
+export { RedisRelaySignal, type RedisRelaySignalOptions } from './relay/redis-relay-signal.js';
+export { relayWakeUpMiddleware } from './relay/relay-wake-up-middleware.js';
+export { InMemoryLock, Lock, type AcquireOptions, type LockHandle, type WaitingOptions } from '@ddd-ts-kit/kernel';
+export { InMemoryRateLimiter, RateLimiter, type RateLimit, type RateLimitDecision } from '@ddd-ts-kit/kernel';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC9F,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACtG,YAAY,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACtG,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC/F,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACnH,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+export { RedisCache } from './cache/redis-cache.js';
+export { jsonCodec } from './cache/json-codec.js';
+export { closeRedis } from './connection/close-redis.js';
+export { connectRedis } from './connection/connect-redis.js';
+export { FAIL_FAST } from './connection/fail-fast.js';
+export { redisHealth } from './connection/redis-health.js';
+export { RedisLock } from './lock/redis-lock.js';
+export { RedisRateLimiter } from './rate-limiter/redis-rate-limiter.js';
+export { RedisRelaySignal } from './relay/redis-relay-signal.js';
+export { relayWakeUpMiddleware } from './relay/relay-wake-up-middleware.js';
+export { InMemoryLock, Lock } from '@ddd-ts-kit/kernel';
+export { InMemoryRateLimiter, RateLimiter } from '@ddd-ts-kit/kernel';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA4C,MAAM,wBAAwB,CAAC;AAG9F,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAwB,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEtD,OAAO,EAAE,WAAW,EAA6C,MAAM,8BAA8B,CAAC;AAEtG,OAAO,EAAE,SAAS,EAAyB,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAgC,MAAM,sCAAsC,CAAC;AACtG,OAAO,EAAE,gBAAgB,EAAgC,MAAM,+BAA+B,CAAC;AAC/F,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,IAAI,EAA6D,MAAM,oBAAoB,CAAC;AACnH,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAA0C,MAAM,oBAAoB,CAAC"}

package/dist/keys/namespaced.d.ts

@@ -0,0 +1,3 @@
+/** `namespace:name`, or the name alone: one namespace per bounded context keeps their keys apart. */
+export declare function namespaced(namespace: string | undefined, name: string): string;
+//# sourceMappingURL=namespaced.d.ts.map

package/dist/keys/namespaced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespaced.d.ts","sourceRoot":"","sources":["../../src/keys/namespaced.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9E"}

package/dist/keys/namespaced.js

@@ -0,0 +1,5 @@
+/** `namespace:name`, or the name alone: one namespace per bounded context keeps their keys apart. */
+export function namespaced(namespace, name) {
+    return namespace === undefined ? name : `${namespace}:${name}`;
+}
+//# sourceMappingURL=namespaced.js.map

package/dist/keys/namespaced.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespaced.js","sourceRoot":"","sources":["../../src/keys/namespaced.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG,MAAM,UAAU,UAAU,CAAC,SAA6B,EAAE,IAAY;IACpE,OAAO,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,IAAI,EAAE,CAAC;AACjE,CAAC"}

package/dist/keys/prefix-pattern.d.ts

@@ -0,0 +1,3 @@
+/** The glob pattern matching every key that starts with the prefix, whatever it contains. */
+export declare function prefixPattern(prefix: string): string;
+//# sourceMappingURL=prefix-pattern.d.ts.map