@mhbdev/redis 0.2.0

package/dist/node/client.js

@@ -0,0 +1,155 @@
+import { createClient, } from "redis";
+import { asError, RedisClientStateError, RedisConnectionError } from "../core/errors.js";
+import { assertPositiveInteger, withTimeout, } from "../core/executor.js";
+import { normalizeNodeRedisError } from "./errors.js";
+export class RedisClient {
+    client;
+    options;
+    connecting = null;
+    closing = null;
+    closed = false;
+    constructor(options) {
+        if (!options.url.trim())
+            throw new RedisConnectionError("Redis URL is required");
+        this.options = {
+            ...options,
+            connectTimeoutMs: options.connectTimeoutMs ?? 3_000,
+            commandTimeoutMs: options.commandTimeoutMs ?? 3_000,
+            maxReconnectAttempts: options.maxReconnectAttempts ?? 3,
+            reconnectBaseDelayMs: options.reconnectBaseDelayMs ?? 100,
+            reconnectMaxDelayMs: options.reconnectMaxDelayMs ?? 1_000,
+            disableOfflineQueue: options.disableOfflineQueue ?? true,
+        };
+        assertPositiveInteger(this.options.connectTimeoutMs, "Redis connect timeout");
+        assertPositiveInteger(this.options.commandTimeoutMs, "Redis command timeout");
+        this.client = this.createClient();
+    }
+    get isReady() {
+        return this.client.isReady;
+    }
+    get isOpen() {
+        return this.client.isOpen;
+    }
+    createClient() {
+        const client = createClient({
+            ...this.options.clientOptions,
+            url: this.options.url,
+            disableOfflineQueue: this.options.disableOfflineQueue,
+            socket: {
+                ...this.options.clientOptions?.socket,
+                connectTimeout: this.options.connectTimeoutMs,
+                reconnectStrategy: (attempts) => {
+                    if (attempts >= this.options.maxReconnectAttempts)
+                        return false;
+                    return Math.min(this.options.reconnectBaseDelayMs * 2 ** attempts, this.options.reconnectMaxDelayMs);
+                },
+            },
+        });
+        client.on("error", (error) => {
+            const normalized = asError(error);
+            this.options.onError?.(normalized);
+            this.options.hooks?.onError?.(normalized);
+            this.options.hooks?.onStateChange?.("error");
+        });
+        client.on("ready", () => this.options.hooks?.onStateChange?.("ready"));
+        client.on("reconnecting", () => this.options.hooks?.onStateChange?.("connecting"));
+        return client;
+    }
+    replaceClient() {
+        if (this.closed)
+            return;
+        if (this.client.isOpen)
+            this.client.destroy();
+        this.client = this.createClient();
+    }
+    async connect() {
+        if (this.closed)
+            throw new RedisClientStateError("The Redis client has been closed");
+        if (this.client.isReady)
+            return;
+        this.connecting ??= withTimeout(async () => {
+            this.options.hooks?.onStateChange?.("connecting");
+            try {
+                await this.client.connect();
+            }
+            catch (error) {
+                this.replaceClient();
+                throw new RedisConnectionError("Redis connection failed", error);
+            }
+        }, this.options.connectTimeoutMs, "Redis connection timed out")
+            .catch((error) => {
+            this.replaceClient();
+            throw error;
+        })
+            .finally(() => {
+            this.connecting = null;
+        });
+        await this.connecting;
+        if (this.closed)
+            throw new RedisClientStateError("The Redis client was closed while connecting");
+    }
+    async execute(command, options = {}) {
+        await this.connect();
+        const started = Date.now();
+        this.options.hooks?.onCommandStart?.(command);
+        try {
+            return await withTimeout((signal) => this.sendCommand(command, options.signal ?? signal), this.options.commandTimeoutMs);
+        }
+        finally {
+            this.options.hooks?.onCommandEnd?.(command, Date.now() - started);
+        }
+    }
+    async sendCommand(command, signal) {
+        try {
+            const client = this.client;
+            return (await client.withAbortSignal(signal).sendCommand([...command]));
+        }
+        catch (error) {
+            throw normalizeNodeRedisError(error);
+        }
+    }
+    async eval(script, options, request = {}) {
+        const command = [
+            "EVAL",
+            script,
+            String(options.keys?.length ?? 0),
+            ...(options.keys ?? []),
+            ...(options.arguments ?? []),
+        ];
+        return this.execute(command, request);
+    }
+    async ping() {
+        await this.execute(["PING"]);
+    }
+    raw() {
+        return this.client;
+    }
+    async close() {
+        this.closing ??= (async () => {
+            this.closed = true;
+            await this.connecting?.catch(() => undefined);
+            if (this.client.isOpen)
+                await this.client.close();
+            this.options.hooks?.onStateChange?.("closed");
+        })();
+        await this.closing;
+    }
+}
+export function createRedisClient(options) {
+    return new RedisClient(options);
+}
+/**
+ * Creates, connects, and closes a managed client around one operation.
+ * This is useful for scripts, jobs, and request-scoped composition tests.
+ */
+export async function withRedisClient(options, operation) {
+    const redis = createRedisClient(options);
+    try {
+        await redis.connect();
+        return await operation(redis);
+    }
+    finally {
+        await redis.close();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/node/client.js.map

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

package/dist/node/errors.d.ts

@@ -0,0 +1,3 @@
+import { RedisError } from "../core/errors.js";
+export declare function normalizeNodeRedisError(error: unknown): RedisError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/node/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/node/errors.ts"],"names":[],"mappings":"AAQA,OAAO,EAEN,UAAU,EAKV,MAAM,mBAAmB,CAAC;AAE3B,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAUlE"}

package/dist/node/errors.js

@@ -0,0 +1,16 @@
+import { AbortError, ClientClosedError, ConnectionTimeoutError, ErrorReply, TimeoutError, } from "redis";
+import { RedisClientStateError, RedisError, RedisProtocolError, RedisRequestAbortedError, RedisTimeoutError, RedisUnavailableError, } from "../core/errors.js";
+export function normalizeNodeRedisError(error) {
+    if (error instanceof RedisError)
+        return error;
+    if (error instanceof AbortError)
+        return new RedisRequestAbortedError(error);
+    if (error instanceof ConnectionTimeoutError || error instanceof TimeoutError)
+        return new RedisTimeoutError("Redis command timed out", error);
+    if (error instanceof ClientClosedError)
+        return new RedisClientStateError("The Redis client has been closed");
+    if (error instanceof ErrorReply)
+        return new RedisProtocolError("Redis rejected the command", error);
+    return new RedisUnavailableError(error);
+}
+//# sourceMappingURL=errors.js.map

package/dist/node/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/node/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,UAAU,EACV,iBAAiB,EACjB,sBAAsB,EACtB,UAAU,EACV,YAAY,GACZ,MAAM,OAAO,CAAC;AAEf,OAAO,EACN,qBAAqB,EACrB,UAAU,EACV,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,GACrB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACrD,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9C,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO,IAAI,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAC5E,IAAI,KAAK,YAAY,sBAAsB,IAAI,KAAK,YAAY,YAAY;QAC3E,OAAO,IAAI,iBAAiB,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;IAChE,IAAI,KAAK,YAAY,iBAAiB;QACrC,OAAO,IAAI,qBAAqB,CAAC,kCAAkC,CAAC,CAAC;IACtE,IAAI,KAAK,YAAY,UAAU;QAC9B,OAAO,IAAI,kBAAkB,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;IACpE,OAAO,IAAI,qBAAqB,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC"}

package/dist/node/index.d.ts

@@ -0,0 +1,6 @@
+export type { NodeRedisClient, RedisClientOptions } from "./client.js";
+export { createRedisClient, RedisClient, withRedisClient } from "./client.js";
+export type { RedisPoolOptions } from "./pool.js";
+export { createRedisPool, RedisPool, withRedisPool } from "./pool.js";
+export { createNodePubSubTransport, createNodeTypedPubSub } from "./pubsub.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9E,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

package/dist/node/index.js

@@ -0,0 +1,4 @@
+export { createRedisClient, RedisClient, withRedisClient } from "./client.js";
+export { createRedisPool, RedisPool, withRedisPool } from "./pool.js";
+export { createNodePubSubTransport, createNodeTypedPubSub } from "./pubsub.js";
+//# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9E,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

package/dist/node/pool.d.ts

@@ -0,0 +1,31 @@
+import { type RedisClientOptions as NodeRedisOptions } from "redis";
+import { type RedisCommand, type RedisExecutor, type RedisScriptOptions } from "../core/executor.js";
+import type { RedisClientOptions } from "./client.js";
+export type RedisPoolOptions = RedisClientOptions & Readonly<{
+    minimum?: number;
+    maximum?: number;
+    acquireTimeoutMs?: number;
+    cleanupDelayMs?: number;
+    clientOptions?: Omit<NodeRedisOptions, "url" | "disableOfflineQueue">;
+}>;
+export declare class RedisPool implements RedisExecutor {
+    private readonly options;
+    private readonly pool;
+    private readonly commandTimeoutMs;
+    private readonly acquireTimeoutMs;
+    private closed;
+    private connected;
+    constructor(options: RedisPoolOptions);
+    get isReady(): boolean;
+    connect(): Promise<void>;
+    execute<T = unknown>(command: RedisCommand): Promise<T>;
+    eval<T = unknown>(script: string, options: RedisScriptOptions): Promise<T>;
+    ping(): Promise<void>;
+    use<T>(operation: (client: unknown) => Promise<T>): Promise<T>;
+    close(): Promise<void>;
+    private reportError;
+}
+export declare function createRedisPool(options: RedisPoolOptions): RedisPool;
+/** Creates, connects, and closes a pool around one operation. */
+export declare function withRedisPool<T>(options: RedisPoolOptions, operation: (pool: RedisPool) => Promise<T>): Promise<T>;
+//# sourceMappingURL=pool.d.ts.map

package/dist/node/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../src/node/pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,kBAAkB,IAAI,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAQtF,OAAO,EAEN,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EAEvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGtD,MAAM,MAAM,gBAAgB,GAAG,kBAAkB,GAChD,QAAQ,CAAC;IACR,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,KAAK,GAAG,qBAAqB,CAAC,CAAC;CACtE,CAAC,CAAC;AAIJ,qBAAa,SAAU,YAAW,aAAa;IAOlC,OAAO,CAAC,QAAQ,CAAC,OAAO;IANpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;IAE1B,YAA6B,OAAO,EAAE,gBAAgB,EAoCrD;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAoB7B;IAEK,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,CAiB5D;IAEK,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC,CAQ/E;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1B;IAEK,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAInE;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAK3B;IAED,OAAO,CAAC,WAAW;CAKnB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAEpE;AAED,iEAAiE;AACjE,wBAAsB,aAAa,CAAC,CAAC,EACpC,OAAO,EAAE,gBAAgB,EACzB,SAAS,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,GACxC,OAAO,CAAC,CAAC,CAAC,CAQZ"}

package/dist/node/pool.js

@@ -0,0 +1,131 @@
+import { createClientPool } from "redis";
+import { RedisClientStateError, RedisConfigurationError, RedisConnectionError, RedisTimeoutError, } from "../core/errors.js";
+import { assertPositiveInteger, withTimeout, } from "../core/executor.js";
+import { normalizeNodeRedisError } from "./errors.js";
+export class RedisPool {
+    options;
+    pool;
+    commandTimeoutMs;
+    acquireTimeoutMs;
+    closed = false;
+    connected = false;
+    constructor(options) {
+        this.options = options;
+        const minimum = options.minimum ?? 1;
+        const maximum = options.maximum ?? 10;
+        this.commandTimeoutMs = options.commandTimeoutMs ?? 3_000;
+        this.acquireTimeoutMs = options.acquireTimeoutMs ?? 3_000;
+        assertPositiveInteger(minimum, "Redis pool minimum");
+        assertPositiveInteger(maximum, "Redis pool maximum");
+        assertPositiveInteger(this.commandTimeoutMs, "Redis command timeout");
+        assertPositiveInteger(this.acquireTimeoutMs, "Redis acquire timeout");
+        if (minimum > maximum)
+            throw new RedisConfigurationError("Redis pool minimum cannot exceed maximum");
+        this.pool = createClientPool({
+            ...options.clientOptions,
+            url: options.url,
+            disableOfflineQueue: options.disableOfflineQueue ?? true,
+            socket: {
+                ...options.clientOptions?.socket,
+                connectTimeout: options.connectTimeoutMs ?? 3_000,
+                reconnectStrategy: (attempts) => {
+                    if (attempts >= (options.maxReconnectAttempts ?? 3))
+                        return false;
+                    return Math.min((options.reconnectBaseDelayMs ?? 100) * 2 ** attempts, options.reconnectMaxDelayMs ?? 1_000);
+                },
+            },
+        }, {
+            minimum,
+            maximum,
+            acquireTimeout: this.acquireTimeoutMs,
+            cleanupDelay: options.cleanupDelayMs ?? 3_000,
+        });
+        this.pool.on("error", (error) => this.reportError(normalizeNodeRedisError(error)));
+    }
+    get isReady() {
+        return this.pool.isReady ?? true;
+    }
+    async connect() {
+        if (this.closed)
+            throw new RedisClientStateError("The Redis pool has been closed");
+        if (this.connected)
+            return;
+        try {
+            this.options.hooks?.onStateChange?.("connecting");
+            await withTimeout(() => this.pool.connect(), this.acquireTimeoutMs, "Redis pool connection timed out");
+            this.connected = true;
+            this.options.hooks?.onStateChange?.("ready");
+        }
+        catch (error) {
+            const normalized = normalizeNodeRedisError(error);
+            this.reportError(normalized);
+            throw normalized.code === "REDIS_CLIENT_STATE" ||
+                normalized instanceof RedisTimeoutError
+                ? normalized
+                : new RedisConnectionError("Redis pool connection failed", normalized);
+        }
+    }
+    async execute(command) {
+        if (this.closed)
+            throw new RedisClientStateError("The Redis pool has been closed");
+        await this.connect();
+        const started = Date.now();
+        this.options.hooks?.onCommandStart?.(command);
+        try {
+            return await withTimeout(() => this.pool.sendCommand([...command]), this.commandTimeoutMs);
+        }
+        catch (error) {
+            const normalized = normalizeNodeRedisError(error);
+            this.reportError(normalized);
+            throw normalized;
+        }
+        finally {
+            this.options.hooks?.onCommandEnd?.(command, Date.now() - started);
+        }
+    }
+    async eval(script, options) {
+        return this.execute([
+            "EVAL",
+            script,
+            String(options.keys?.length ?? 0),
+            ...(options.keys ?? []),
+            ...(options.arguments ?? []),
+        ]);
+    }
+    async ping() {
+        await this.execute(["PING"]);
+    }
+    async use(operation) {
+        if (this.closed)
+            throw new RedisClientStateError("The Redis pool has been closed");
+        await this.connect();
+        return this.pool.execute(operation);
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        await this.pool.close();
+        this.options.hooks?.onStateChange?.("closed");
+    }
+    reportError(error) {
+        this.options.onError?.(error);
+        this.options.hooks?.onError?.(error);
+        this.options.hooks?.onStateChange?.("error");
+    }
+}
+export function createRedisPool(options) {
+    return new RedisPool(options);
+}
+/** Creates, connects, and closes a pool around one operation. */
+export async function withRedisPool(options, operation) {
+    const pool = createRedisPool(options);
+    try {
+        await pool.connect();
+        return await operation(pool);
+    }
+    finally {
+        await pool.close();
+    }
+}
+//# sourceMappingURL=pool.js.map

package/dist/node/pool.js.map

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

package/dist/node/pubsub.d.ts

@@ -0,0 +1,16 @@
+import type { RedisCodec } from "../core/codec.js";
+import type { RedisSubscriptionTransport } from "../pubsub/contracts.js";
+export declare function createNodePubSubTransport(options: Readonly<{
+    url: string;
+    onError?: (error: Error) => void;
+}>): RedisSubscriptionTransport;
+export declare function createNodeTypedPubSub<T>(options: Readonly<{
+    url: string;
+    codec: RedisCodec<T>;
+    onError?: (error: Error) => void;
+}>): {
+    publish(channel: string, value: T): Promise<number>;
+    subscribe(channel: string, handler: (value: T) => void | Promise<void>): Promise<() => Promise<void>>;
+    close(): Promise<void>;
+};
+//# sourceMappingURL=pubsub.d.ts.map

package/dist/node/pubsub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pubsub.d.ts","sourceRoot":"","sources":["../../src/node/pubsub.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAKzE,wBAAgB,yBAAyB,CACxC,OAAO,EAAE,QAAQ,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;CAAE,CAAC,GAClE,0BAA0B,CA2B5B;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EACtC,OAAO,EAAE,QAAQ,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACjC,CAAC,GACA;IACF,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,SAAS,CACR,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACzC,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAChC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB,CAWA"}

package/dist/node/pubsub.js

@@ -0,0 +1,41 @@
+import { createClient } from "redis";
+export function createNodePubSubTransport(options) {
+    let publisher = null;
+    let subscriber = null;
+    return {
+        async publish(channel, message) {
+            publisher ??= createClient({ url: options.url });
+            publisher.on("error", (error) => options.onError?.(error));
+            if (!publisher.isReady)
+                await publisher.connect();
+            return publisher.publish(channel, message);
+        },
+        async subscribe(channel, handler) {
+            subscriber ??= createClient({ url: options.url });
+            subscriber.on("error", (error) => options.onError?.(error));
+            if (!subscriber.isReady)
+                await subscriber.connect();
+            await subscriber.subscribe(channel, handler);
+            return async () => {
+                if (!subscriber)
+                    return;
+                await subscriber.unsubscribe(channel);
+            };
+        },
+        async close() {
+            await Promise.all([
+                publisher?.isOpen ? publisher.close() : undefined,
+                subscriber?.isOpen ? subscriber.close() : undefined,
+            ]);
+        },
+    };
+}
+export function createNodeTypedPubSub(options) {
+    const transport = createNodePubSubTransport(options);
+    return {
+        publish: async (channel, value) => transport.publish(channel, options.codec.encode(value)),
+        subscribe: (channel, handler) => transport.subscribe(channel, async (message) => handler(options.codec.decode(message))),
+        close: () => transport.close(),
+    };
+}
+//# sourceMappingURL=pubsub.js.map

package/dist/node/pubsub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pubsub.js","sourceRoot":"","sources":["../../src/node/pubsub.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAwB,MAAM,OAAO,CAAC;AAO3D,MAAM,UAAU,yBAAyB,CACxC,OAAoE;IAEpE,IAAI,SAAS,GAAkB,IAAI,CAAC;IACpC,IAAI,UAAU,GAAkB,IAAI,CAAC;IACrC,OAAO;QACN,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO;YAC7B,SAAS,KAAK,YAAY,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YACjD,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;YAC3D,IAAI,CAAC,SAAS,CAAC,OAAO;gBAAE,MAAM,SAAS,CAAC,OAAO,EAAE,CAAC;YAClD,OAAO,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;QACD,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO;YAC/B,UAAU,KAAK,YAAY,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YAClD,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;YAC5D,IAAI,CAAC,UAAU,CAAC,OAAO;gBAAE,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC;YACpD,MAAM,UAAU,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7C,OAAO,KAAK,IAAI,EAAE;gBACjB,IAAI,CAAC,UAAU;oBAAE,OAAO;gBACxB,MAAM,UAAU,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YACvC,CAAC,CAAC;QACH,CAAC;QACD,KAAK,CAAC,KAAK;YACV,MAAM,OAAO,CAAC,GAAG,CAAC;gBACjB,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS;gBACjD,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS;aACnD,CAAC,CAAC;QACJ,CAAC;KACD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CACpC,OAIE;IASF,MAAM,SAAS,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACrD,OAAO;QACN,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CACjC,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxD,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAC/B,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAC9C,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CACtC;QACF,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE;KAC9B,CAAC;AACH,CAAC"}

package/dist/pubsub/contracts.d.ts

@@ -0,0 +1,6 @@
+export interface RedisSubscriptionTransport {
+    publish(channel: string, message: string): Promise<number>;
+    subscribe(channel: string, handler: (message: string) => void | Promise<void>): Promise<() => Promise<void>>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/pubsub/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/pubsub/contracts.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,0BAA0B;IAC1C,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3D,SAAS,CACR,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAChD,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAChC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB"}

package/dist/pubsub/contracts.js

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

package/dist/pubsub/contracts.js.map

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

package/dist/pubsub/index.d.ts

@@ -0,0 +1,3 @@
+export type { RedisSubscriptionTransport } from "./contracts.js";
+export { createPubSub, createRedisPubSub, RedisPubSub } from "./pubsub.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/pubsub/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pubsub/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/pubsub/index.js

@@ -0,0 +1,2 @@
+export { createPubSub, createRedisPubSub, RedisPubSub } from "./pubsub.js";
+//# sourceMappingURL=index.js.map

package/dist/pubsub/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pubsub/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/pubsub/pubsub.d.ts

@@ -0,0 +1,15 @@
+import { type RedisCodec } from "../core/codec.js";
+import type { RedisSubscriptionTransport } from "./contracts.js";
+export declare class RedisPubSub<T> {
+    private readonly transport;
+    private readonly codec;
+    constructor(transport: RedisSubscriptionTransport, codec?: RedisCodec<T>);
+    publish(channel: string, value: T): Promise<number>;
+    subscribe(channel: string, handler: (value: T) => void | Promise<void>): Promise<() => Promise<void>>;
+    messages(channel: string): AsyncIterable<T>;
+    close(): Promise<void>;
+}
+export declare function createPubSub<T>(transport: RedisSubscriptionTransport, codec?: RedisCodec<T>): RedisPubSub<T>;
+/** A discoverable alias for applications that prefer Redis-prefixed factory names. */
+export declare const createRedisPubSub: typeof createPubSub;
+//# sourceMappingURL=pubsub.d.ts.map

package/dist/pubsub/pubsub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pubsub.d.ts","sourceRoot":"","sources":["../../src/pubsub/pubsub.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAEjE,qBAAa,WAAW,CAAC,CAAC;IAExB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFvB,YACkB,SAAS,EAAE,0BAA0B,EACrC,KAAK,GAAE,UAAU,CAAC,CAAC,CAAkB,EACnD;IAEE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAGxD;IAEK,SAAS,CACd,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACzC,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAK9B;IAED,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CA4B1C;IAED,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAErB;CACD;AAED,wBAAgB,YAAY,CAAC,CAAC,EAC7B,SAAS,EAAE,0BAA0B,EACrC,KAAK,GAAE,UAAU,CAAC,CAAC,CAAkB,GACnC,WAAW,CAAC,CAAC,CAAC,CAEhB;AAED,sFAAsF;AACtF,eAAO,MAAM,iBAAiB,qBAAe,CAAC"}

package/dist/pubsub/pubsub.js

@@ -0,0 +1,62 @@
+import { jsonCodec } from "../core/codec.js";
+import { RedisConfigurationError } from "../core/errors.js";
+export class RedisPubSub {
+    transport;
+    codec;
+    constructor(transport, codec = jsonCodec()) {
+        this.transport = transport;
+        this.codec = codec;
+    }
+    async publish(channel, value) {
+        if (!channel.trim())
+            throw new RedisConfigurationError("Pub/sub channel is required");
+        return this.transport.publish(channel, this.codec.encode(value));
+    }
+    async subscribe(channel, handler) {
+        if (!channel.trim())
+            throw new RedisConfigurationError("Pub/sub channel is required");
+        return this.transport.subscribe(channel, async (message) => handler(this.codec.decode(message)));
+    }
+    messages(channel) {
+        const queue = [];
+        const waiters = [];
+        let closed = false;
+        let unsubscribe;
+        const ready = this.subscribe(channel, (value) => {
+            const waiter = waiters.shift();
+            if (waiter)
+                waiter({ done: false, value });
+            else
+                queue.push(value);
+        }).then((stop) => {
+            unsubscribe = stop;
+        });
+        const iterator = {
+            next: async () => {
+                await ready;
+                if (queue.length)
+                    return { done: false, value: queue.shift() };
+                if (closed)
+                    return { done: true, value: undefined };
+                return new Promise((resolve) => waiters.push(resolve));
+            },
+            return: async () => {
+                closed = true;
+                await unsubscribe?.();
+                for (const waiter of waiters.splice(0))
+                    waiter({ done: true, value: undefined });
+                return { done: true, value: undefined };
+            },
+        };
+        return { [Symbol.asyncIterator]: () => iterator };
+    }
+    close() {
+        return this.transport.close();
+    }
+}
+export function createPubSub(transport, codec = jsonCodec()) {
+    return new RedisPubSub(transport, codec);
+}
+/** A discoverable alias for applications that prefer Redis-prefixed factory names. */
+export const createRedisPubSub = createPubSub;
+//# sourceMappingURL=pubsub.js.map

package/dist/pubsub/pubsub.js.map

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

package/dist/queue/index.d.ts

@@ -0,0 +1,3 @@
+export type { EnqueueOptions, JobQueue, QueueJob, QueueOptions, QueueWorker, QueueWorkerOptions, } from "./queue.js";
+export { createQueue, createRedisQueue, RedisQueue, RedisQueueWorker } from "./queue.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/queue/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/queue/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,kBAAkB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/queue/index.js

@@ -0,0 +1,2 @@
+export { createQueue, createRedisQueue, RedisQueue, RedisQueueWorker } from "./queue.js";
+//# sourceMappingURL=index.js.map

package/dist/queue/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/queue/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}