@pubber-subber/redis 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sami Mishal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,89 @@
+# @pubber-subber/redis
+
+Redis pub/sub adapter for [`@pubber-subber/core`](https://www.npmjs.com/package/@pubber-subber/core) — built on [`ioredis`](https://github.com/redis/ioredis). Works with Redis, [Valkey](https://valkey.io), [KeyDB](https://docs.keydb.dev), [Dragonfly](https://dragonflydb.io), or any Redis-protocol-compatible server.
+
+## Install
+
+```sh
+pnpm add @pubber-subber/core @pubber-subber/redis ioredis
+```
+
+`ioredis` is a **peer dependency** — install it alongside.
+
+## Quick start
+
+```ts
+import { PubSub } from '@pubber-subber/core';
+import { redis } from '@pubber-subber/redis';
+
+const pubsub = new PubSub({
+  adapter: redis({ url: 'redis://localhost:6379' }),
+});
+
+await pubsub.subscribe('users.*', (msg) => {
+  console.log(msg.topic, msg.payload);
+});
+
+await pubsub.publish('users.created', { id: 1, name: 'Alice' });
+```
+
+## Options
+
+```ts
+redis({
+  url?: string;
+  options?: RedisOptions;                            // ioredis-compatible
+  clients?: { publisher: Redis; subscriber: Redis };
+  codec?: Codec;
+})
+```
+
+| Option | Notes |
+| --- | --- |
+| `url` | Standard Redis URL: `redis://[:password@]host:port[/db]`, `rediss://...` for TLS. |
+| `options` | Full ioredis `RedisOptions`. Merged with `url`. |
+| `clients` | Bring your own `{ publisher, subscriber }` pair. The adapter will **not** call `quit()` on them. `publisher` and `subscriber` must be distinct clients — Redis rejects non-pub/sub commands on a `SUBSCRIBE`-d connection. |
+| `codec` | Payload encoder/decoder. Default `jsonCodec()`. |
+
+## Publish meta
+
+```ts
+await pubsub.publish('orders.created', payload, { channel: 'orders' });
+```
+
+| Field | Notes |
+| --- | --- |
+| `channel` | Override the on-wire Redis channel without changing the logical `AdapterMessage.topic`. |
+
+## Subscribe meta
+
+```ts
+await pubsub.subscribe('orders', handler, { pattern: true });
+```
+
+| Field | Default | Notes |
+| --- | --- | --- |
+| `pattern` | auto-detected | Force `PSUBSCRIBE` even if the topic has no `*` or `?`. Auto-detected from wildcards otherwise. |
+
+## Capabilities
+
+```ts
+{ publish: true, subscribe: true, patternSubscribe: true, ack: false }
+```
+
+## How it works
+
+- **Two internal connections**: one publisher, one subscriber. Required by Redis (a `SUBSCRIBE`-d connection cannot issue other commands).
+- `subscribe(topic, handler)` issues `SUBSCRIBE` for exact channels and `PSUBSCRIBE` for patterns containing `*` or `?` (override via `meta.pattern: true`).
+- **Reference-counted**: multiple `subscribe()` calls for the same channel only `SUBSCRIBE` once on the wire. `UNSUBSCRIBE` fires when the last handler goes away.
+- **Reconnect**: `ioredis` handles socket-level reconnects automatically. On the `ready` event, the adapter re-subscribes every live channel and pattern — no user-visible message loss for events published *after* the reconnect completes.
+
+## Caveats
+
+- **Redis pub/sub is fire-and-forget.** Subscribers that fall behind have their messages dropped server-side. Events published while the subscriber is disconnected are not buffered. If you need delivery guarantees, use Redis Streams (different adapter — not in this package) or a different transport.
+- **`capabilities.ack = false`**: there is no `ack`/`nack` to call on `AdapterMessage`.
+- For high message-frequency scenarios, watch ioredis's `lazyConnect` and connection pool tuning.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,165 @@
+'use strict';
+
+var core = require('@pubber-subber/core');
+var ioredis = require('ioredis');
+
+// src/index.ts
+function redis(opts = {}) {
+  const codec = opts.codec ?? core.jsonCodec();
+  let publisher = null;
+  let subscriber = null;
+  let owned = true;
+  const exactHandlers = /* @__PURE__ */ new Map();
+  const patternHandlers = /* @__PURE__ */ new Map();
+  let idCounter = 0;
+  let installedListeners = false;
+  const createClient = () => {
+    if (opts.url && opts.options) return new ioredis.Redis(opts.url, opts.options);
+    if (opts.url) return new ioredis.Redis(opts.url);
+    if (opts.options) return new ioredis.Redis(opts.options);
+    return new ioredis.Redis();
+  };
+  const ensure = () => {
+    if (publisher && subscriber) return { publisher, subscriber };
+    if (opts.clients) {
+      publisher = opts.clients.publisher;
+      subscriber = opts.clients.subscriber;
+      owned = false;
+    } else {
+      publisher = createClient();
+      subscriber = createClient();
+      owned = true;
+    }
+    if (!installedListeners) {
+      installedListeners = true;
+      subscriber.on("message", (channel, message) => {
+        deliver(exactHandlers.get(channel), channel, message, void 0);
+      });
+      subscriber.on("pmessage", (pattern, channel, message) => {
+        deliver(patternHandlers.get(pattern), channel, message, { pattern });
+      });
+      subscriber.on("ready", () => {
+        for (const channel of exactHandlers.keys()) {
+          subscriber?.subscribe(channel).catch(noop);
+        }
+        for (const pattern of patternHandlers.keys()) {
+          subscriber?.psubscribe(pattern).catch(noop);
+        }
+      });
+    }
+    return { publisher, subscriber };
+  };
+  const deliver = (handlers, channel, wireMessage, extraMeta) => {
+    if (!handlers || handlers.size === 0) return;
+    let payload;
+    try {
+      payload = codec.decode(wireMessage);
+    } catch {
+      payload = wireMessage;
+    }
+    const msg = {
+      topic: channel,
+      payload,
+      raw: wireMessage,
+      meta: extraMeta
+    };
+    for (const handler of [...handlers]) {
+      Promise.resolve(handler(msg)).catch(noop);
+    }
+  };
+  return {
+    name: "redis",
+    capabilities: { publish: true, subscribe: true, patternSubscribe: true, ack: false },
+    async connect() {
+      const { publisher: p, subscriber: s } = ensure();
+      await Promise.all([waitReady(p), waitReady(s)]);
+    },
+    async disconnect() {
+      if (!owned) {
+        publisher = null;
+        subscriber = null;
+        return;
+      }
+      const closing = [];
+      if (subscriber) closing.push(subscriber.quit().catch(noop));
+      if (publisher) closing.push(publisher.quit().catch(noop));
+      await Promise.all(closing);
+      publisher = null;
+      subscriber = null;
+      installedListeners = false;
+      exactHandlers.clear();
+      patternHandlers.clear();
+    },
+    async publish(topic, payload, meta) {
+      const { publisher: p } = ensure();
+      const channel = meta?.channel ?? topic;
+      const encoded = codec.encode(payload);
+      const wire = typeof encoded === "string" ? encoded : Buffer.from(encoded);
+      await p.publish(channel, wire);
+    },
+    async subscribe(topic, handler, meta) {
+      const { subscriber: s } = ensure();
+      const usePattern = meta?.pattern ?? core.isPattern(topic);
+      const map = usePattern ? patternHandlers : exactHandlers;
+      let set = map.get(topic);
+      const firstSubscriber = !set;
+      if (!set) {
+        set = /* @__PURE__ */ new Set();
+        map.set(topic, set);
+      }
+      if (firstSubscriber) {
+        if (usePattern) await s.psubscribe(topic);
+        else await s.subscribe(topic);
+      }
+      set.add(handler);
+      idCounter += 1;
+      const id = `redis-${idCounter}`;
+      const ownSet = set;
+      return {
+        id,
+        topic,
+        unsubscribe: async () => {
+          ownSet.delete(handler);
+          if (ownSet.size === 0) {
+            map.delete(topic);
+            if (subscriber) {
+              if (usePattern) await subscriber.punsubscribe(topic).catch(noop);
+              else await subscriber.unsubscribe(topic).catch(noop);
+            }
+          }
+        }
+      };
+    }
+  };
+}
+function noop() {
+}
+async function waitReady(client) {
+  if (client.status === "ready") return;
+  if (client.status === "wait" || client.status === "connecting") {
+    await new Promise((resolve, reject) => {
+      const onReady = () => {
+        cleanup();
+        resolve();
+      };
+      const onError = (err) => {
+        cleanup();
+        reject(err);
+      };
+      const cleanup = () => {
+        client.off("ready", onReady);
+        client.off("error", onError);
+      };
+      client.once("ready", onReady);
+      client.once("error", onError);
+    });
+    return;
+  }
+  await client.connect().catch((err) => {
+    if (!String(err?.message ?? "").includes("connect")) throw err;
+  });
+}
+
+exports.redis = redis;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["jsonCodec","Redis","isPattern"],"mappings":"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","file":"index.cjs","sourcesContent":["import {\n  type AdapterMessage,\n  type Codec,\n  type MessageHandler,\n  type PubSubAdapter,\n  isPattern,\n  jsonCodec,\n} from '@pubber-subber/core';\nimport { Redis, type RedisOptions } from 'ioredis';\n\nexport interface RedisAdapterOptions {\n  /** Redis connection URL, e.g. `redis://localhost:6379`. */\n  url?: string;\n  /** ioredis-compatible options. Combined with `url` if both are passed. */\n  options?: RedisOptions;\n  /**\n   * Bring-your-own clients. When provided, the adapter will NOT manage their\n   * lifecycle (connect/disconnect become no-ops on `disconnect`).\n   * `publisher` and `subscriber` must be distinct clients because Redis\n   * disallows non-pub/sub commands on a subscribed connection.\n   */\n  clients?: { publisher: Redis; subscriber: Redis };\n  /** Payload codec. Default: JSON. */\n  codec?: Codec;\n}\n\nexport interface RedisPublishMeta {\n  /** Override the wire channel for this publish; the AdapterMessage still carries `topic`. */\n  channel?: string;\n}\n\nexport interface RedisSubscribeMeta {\n  /** Force PSUBSCRIBE even when `topic` has no wildcards. */\n  pattern?: boolean;\n}\n\nexport function redis(\n  opts: RedisAdapterOptions = {},\n): PubSubAdapter<RedisPublishMeta, RedisSubscribeMeta> {\n  const codec = opts.codec ?? jsonCodec();\n\n  let publisher: Redis | null = null;\n  let subscriber: Redis | null = null;\n  let owned = true;\n\n  const exactHandlers = new Map<string, Set<MessageHandler>>();\n  const patternHandlers = new Map<string, Set<MessageHandler>>();\n  let idCounter = 0;\n  let installedListeners = false;\n\n  const createClient = (): Redis => {\n    if (opts.url && opts.options) return new Redis(opts.url, opts.options);\n    if (opts.url) return new Redis(opts.url);\n    if (opts.options) return new Redis(opts.options);\n    return new Redis();\n  };\n\n  const ensure = (): { publisher: Redis; subscriber: Redis } => {\n    if (publisher && subscriber) return { publisher, subscriber };\n\n    if (opts.clients) {\n      publisher = opts.clients.publisher;\n      subscriber = opts.clients.subscriber;\n      owned = false;\n    } else {\n      publisher = createClient();\n      subscriber = createClient();\n      owned = true;\n    }\n\n    if (!installedListeners) {\n      installedListeners = true;\n      subscriber.on('message', (channel: string, message: string) => {\n        deliver(exactHandlers.get(channel), channel, message, undefined);\n      });\n      subscriber.on('pmessage', (pattern: string, channel: string, message: string) => {\n        deliver(patternHandlers.get(pattern), channel, message, { pattern });\n      });\n      // Re-subscribe after a reconnect.\n      subscriber.on('ready', () => {\n        for (const channel of exactHandlers.keys()) {\n          subscriber?.subscribe(channel).catch(noop);\n        }\n        for (const pattern of patternHandlers.keys()) {\n          subscriber?.psubscribe(pattern).catch(noop);\n        }\n      });\n    }\n\n    return { publisher, subscriber };\n  };\n\n  const deliver = (\n    handlers: Set<MessageHandler> | undefined,\n    channel: string,\n    wireMessage: string,\n    extraMeta: Record<string, unknown> | undefined,\n  ) => {\n    if (!handlers || handlers.size === 0) return;\n    let payload: unknown;\n    try {\n      payload = codec.decode(wireMessage);\n    } catch {\n      payload = wireMessage;\n    }\n    const msg: AdapterMessage = {\n      topic: channel,\n      payload,\n      raw: wireMessage,\n      meta: extraMeta,\n    };\n    for (const handler of [...handlers]) {\n      Promise.resolve(handler(msg)).catch(noop);\n    }\n  };\n\n  return {\n    name: 'redis',\n    capabilities: { publish: true, subscribe: true, patternSubscribe: true, ack: false },\n\n    async connect() {\n      const { publisher: p, subscriber: s } = ensure();\n      await Promise.all([waitReady(p), waitReady(s)]);\n    },\n\n    async disconnect() {\n      if (!owned) {\n        publisher = null;\n        subscriber = null;\n        return;\n      }\n      const closing: Promise<unknown>[] = [];\n      if (subscriber) closing.push(subscriber.quit().catch(noop));\n      if (publisher) closing.push(publisher.quit().catch(noop));\n      await Promise.all(closing);\n      publisher = null;\n      subscriber = null;\n      installedListeners = false;\n      exactHandlers.clear();\n      patternHandlers.clear();\n    },\n\n    async publish(topic, payload, meta) {\n      const { publisher: p } = ensure();\n      const channel = meta?.channel ?? topic;\n      const encoded = codec.encode(payload);\n      const wire = typeof encoded === 'string' ? encoded : Buffer.from(encoded);\n      await p.publish(channel, wire as never);\n    },\n\n    async subscribe(topic, handler, meta) {\n      const { subscriber: s } = ensure();\n      const usePattern = meta?.pattern ?? isPattern(topic);\n      const map = usePattern ? patternHandlers : exactHandlers;\n      let set = map.get(topic);\n      const firstSubscriber = !set;\n      if (!set) {\n        set = new Set();\n        map.set(topic, set);\n      }\n      if (firstSubscriber) {\n        if (usePattern) await s.psubscribe(topic);\n        else await s.subscribe(topic);\n      }\n      set.add(handler);\n      idCounter += 1;\n      const id = `redis-${idCounter}`;\n      const ownSet = set;\n      return {\n        id,\n        topic,\n        unsubscribe: async () => {\n          ownSet.delete(handler);\n          if (ownSet.size === 0) {\n            map.delete(topic);\n            if (subscriber) {\n              if (usePattern) await subscriber.punsubscribe(topic).catch(noop);\n              else await subscriber.unsubscribe(topic).catch(noop);\n            }\n          }\n        },\n      };\n    },\n  };\n}\n\nfunction noop(): void {\n  // intentional\n}\n\nasync function waitReady(client: Redis): Promise<void> {\n  if (client.status === 'ready') return;\n  if (client.status === 'wait' || client.status === 'connecting') {\n    await new Promise<void>((resolve, reject) => {\n      const onReady = () => {\n        cleanup();\n        resolve();\n      };\n      const onError = (err: unknown) => {\n        cleanup();\n        reject(err);\n      };\n      const cleanup = () => {\n        client.off('ready', onReady);\n        client.off('error', onError);\n      };\n      client.once('ready', onReady);\n      client.once('error', onError);\n    });\n    return;\n  }\n  await client.connect().catch((err) => {\n    // Already connected/connecting is fine.\n    if (!String(err?.message ?? '').includes('connect')) throw err;\n  });\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,32 @@
+import { Codec, PubSubAdapter } from '@pubber-subber/core';
+import { RedisOptions, Redis } from 'ioredis';
+
+interface RedisAdapterOptions {
+    /** Redis connection URL, e.g. `redis://localhost:6379`. */
+    url?: string;
+    /** ioredis-compatible options. Combined with `url` if both are passed. */
+    options?: RedisOptions;
+    /**
+     * Bring-your-own clients. When provided, the adapter will NOT manage their
+     * lifecycle (connect/disconnect become no-ops on `disconnect`).
+     * `publisher` and `subscriber` must be distinct clients because Redis
+     * disallows non-pub/sub commands on a subscribed connection.
+     */
+    clients?: {
+        publisher: Redis;
+        subscriber: Redis;
+    };
+    /** Payload codec. Default: JSON. */
+    codec?: Codec;
+}
+interface RedisPublishMeta {
+    /** Override the wire channel for this publish; the AdapterMessage still carries `topic`. */
+    channel?: string;
+}
+interface RedisSubscribeMeta {
+    /** Force PSUBSCRIBE even when `topic` has no wildcards. */
+    pattern?: boolean;
+}
+declare function redis(opts?: RedisAdapterOptions): PubSubAdapter<RedisPublishMeta, RedisSubscribeMeta>;
+
+export { type RedisAdapterOptions, type RedisPublishMeta, type RedisSubscribeMeta, redis };

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+import { Codec, PubSubAdapter } from '@pubber-subber/core';
+import { RedisOptions, Redis } from 'ioredis';
+
+interface RedisAdapterOptions {
+    /** Redis connection URL, e.g. `redis://localhost:6379`. */
+    url?: string;
+    /** ioredis-compatible options. Combined with `url` if both are passed. */
+    options?: RedisOptions;
+    /**
+     * Bring-your-own clients. When provided, the adapter will NOT manage their
+     * lifecycle (connect/disconnect become no-ops on `disconnect`).
+     * `publisher` and `subscriber` must be distinct clients because Redis
+     * disallows non-pub/sub commands on a subscribed connection.
+     */
+    clients?: {
+        publisher: Redis;
+        subscriber: Redis;
+    };
+    /** Payload codec. Default: JSON. */
+    codec?: Codec;
+}
+interface RedisPublishMeta {
+    /** Override the wire channel for this publish; the AdapterMessage still carries `topic`. */
+    channel?: string;
+}
+interface RedisSubscribeMeta {
+    /** Force PSUBSCRIBE even when `topic` has no wildcards. */
+    pattern?: boolean;
+}
+declare function redis(opts?: RedisAdapterOptions): PubSubAdapter<RedisPublishMeta, RedisSubscribeMeta>;
+
+export { type RedisAdapterOptions, type RedisPublishMeta, type RedisSubscribeMeta, redis };

package/dist/index.js

@@ -0,0 +1,163 @@
+import { jsonCodec, isPattern } from '@pubber-subber/core';
+import { Redis } from 'ioredis';
+
+// src/index.ts
+function redis(opts = {}) {
+  const codec = opts.codec ?? jsonCodec();
+  let publisher = null;
+  let subscriber = null;
+  let owned = true;
+  const exactHandlers = /* @__PURE__ */ new Map();
+  const patternHandlers = /* @__PURE__ */ new Map();
+  let idCounter = 0;
+  let installedListeners = false;
+  const createClient = () => {
+    if (opts.url && opts.options) return new Redis(opts.url, opts.options);
+    if (opts.url) return new Redis(opts.url);
+    if (opts.options) return new Redis(opts.options);
+    return new Redis();
+  };
+  const ensure = () => {
+    if (publisher && subscriber) return { publisher, subscriber };
+    if (opts.clients) {
+      publisher = opts.clients.publisher;
+      subscriber = opts.clients.subscriber;
+      owned = false;
+    } else {
+      publisher = createClient();
+      subscriber = createClient();
+      owned = true;
+    }
+    if (!installedListeners) {
+      installedListeners = true;
+      subscriber.on("message", (channel, message) => {
+        deliver(exactHandlers.get(channel), channel, message, void 0);
+      });
+      subscriber.on("pmessage", (pattern, channel, message) => {
+        deliver(patternHandlers.get(pattern), channel, message, { pattern });
+      });
+      subscriber.on("ready", () => {
+        for (const channel of exactHandlers.keys()) {
+          subscriber?.subscribe(channel).catch(noop);
+        }
+        for (const pattern of patternHandlers.keys()) {
+          subscriber?.psubscribe(pattern).catch(noop);
+        }
+      });
+    }
+    return { publisher, subscriber };
+  };
+  const deliver = (handlers, channel, wireMessage, extraMeta) => {
+    if (!handlers || handlers.size === 0) return;
+    let payload;
+    try {
+      payload = codec.decode(wireMessage);
+    } catch {
+      payload = wireMessage;
+    }
+    const msg = {
+      topic: channel,
+      payload,
+      raw: wireMessage,
+      meta: extraMeta
+    };
+    for (const handler of [...handlers]) {
+      Promise.resolve(handler(msg)).catch(noop);
+    }
+  };
+  return {
+    name: "redis",
+    capabilities: { publish: true, subscribe: true, patternSubscribe: true, ack: false },
+    async connect() {
+      const { publisher: p, subscriber: s } = ensure();
+      await Promise.all([waitReady(p), waitReady(s)]);
+    },
+    async disconnect() {
+      if (!owned) {
+        publisher = null;
+        subscriber = null;
+        return;
+      }
+      const closing = [];
+      if (subscriber) closing.push(subscriber.quit().catch(noop));
+      if (publisher) closing.push(publisher.quit().catch(noop));
+      await Promise.all(closing);
+      publisher = null;
+      subscriber = null;
+      installedListeners = false;
+      exactHandlers.clear();
+      patternHandlers.clear();
+    },
+    async publish(topic, payload, meta) {
+      const { publisher: p } = ensure();
+      const channel = meta?.channel ?? topic;
+      const encoded = codec.encode(payload);
+      const wire = typeof encoded === "string" ? encoded : Buffer.from(encoded);
+      await p.publish(channel, wire);
+    },
+    async subscribe(topic, handler, meta) {
+      const { subscriber: s } = ensure();
+      const usePattern = meta?.pattern ?? isPattern(topic);
+      const map = usePattern ? patternHandlers : exactHandlers;
+      let set = map.get(topic);
+      const firstSubscriber = !set;
+      if (!set) {
+        set = /* @__PURE__ */ new Set();
+        map.set(topic, set);
+      }
+      if (firstSubscriber) {
+        if (usePattern) await s.psubscribe(topic);
+        else await s.subscribe(topic);
+      }
+      set.add(handler);
+      idCounter += 1;
+      const id = `redis-${idCounter}`;
+      const ownSet = set;
+      return {
+        id,
+        topic,
+        unsubscribe: async () => {
+          ownSet.delete(handler);
+          if (ownSet.size === 0) {
+            map.delete(topic);
+            if (subscriber) {
+              if (usePattern) await subscriber.punsubscribe(topic).catch(noop);
+              else await subscriber.unsubscribe(topic).catch(noop);
+            }
+          }
+        }
+      };
+    }
+  };
+}
+function noop() {
+}
+async function waitReady(client) {
+  if (client.status === "ready") return;
+  if (client.status === "wait" || client.status === "connecting") {
+    await new Promise((resolve, reject) => {
+      const onReady = () => {
+        cleanup();
+        resolve();
+      };
+      const onError = (err) => {
+        cleanup();
+        reject(err);
+      };
+      const cleanup = () => {
+        client.off("ready", onReady);
+        client.off("error", onError);
+      };
+      client.once("ready", onReady);
+      client.once("error", onError);
+    });
+    return;
+  }
+  await client.connect().catch((err) => {
+    if (!String(err?.message ?? "").includes("connect")) throw err;
+  });
+}
+
+export { redis };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import {\n  type AdapterMessage,\n  type Codec,\n  type MessageHandler,\n  type PubSubAdapter,\n  isPattern,\n  jsonCodec,\n} from '@pubber-subber/core';\nimport { Redis, type RedisOptions } from 'ioredis';\n\nexport interface RedisAdapterOptions {\n  /** Redis connection URL, e.g. `redis://localhost:6379`. */\n  url?: string;\n  /** ioredis-compatible options. Combined with `url` if both are passed. */\n  options?: RedisOptions;\n  /**\n   * Bring-your-own clients. When provided, the adapter will NOT manage their\n   * lifecycle (connect/disconnect become no-ops on `disconnect`).\n   * `publisher` and `subscriber` must be distinct clients because Redis\n   * disallows non-pub/sub commands on a subscribed connection.\n   */\n  clients?: { publisher: Redis; subscriber: Redis };\n  /** Payload codec. Default: JSON. */\n  codec?: Codec;\n}\n\nexport interface RedisPublishMeta {\n  /** Override the wire channel for this publish; the AdapterMessage still carries `topic`. */\n  channel?: string;\n}\n\nexport interface RedisSubscribeMeta {\n  /** Force PSUBSCRIBE even when `topic` has no wildcards. */\n  pattern?: boolean;\n}\n\nexport function redis(\n  opts: RedisAdapterOptions = {},\n): PubSubAdapter<RedisPublishMeta, RedisSubscribeMeta> {\n  const codec = opts.codec ?? jsonCodec();\n\n  let publisher: Redis | null = null;\n  let subscriber: Redis | null = null;\n  let owned = true;\n\n  const exactHandlers = new Map<string, Set<MessageHandler>>();\n  const patternHandlers = new Map<string, Set<MessageHandler>>();\n  let idCounter = 0;\n  let installedListeners = false;\n\n  const createClient = (): Redis => {\n    if (opts.url && opts.options) return new Redis(opts.url, opts.options);\n    if (opts.url) return new Redis(opts.url);\n    if (opts.options) return new Redis(opts.options);\n    return new Redis();\n  };\n\n  const ensure = (): { publisher: Redis; subscriber: Redis } => {\n    if (publisher && subscriber) return { publisher, subscriber };\n\n    if (opts.clients) {\n      publisher = opts.clients.publisher;\n      subscriber = opts.clients.subscriber;\n      owned = false;\n    } else {\n      publisher = createClient();\n      subscriber = createClient();\n      owned = true;\n    }\n\n    if (!installedListeners) {\n      installedListeners = true;\n      subscriber.on('message', (channel: string, message: string) => {\n        deliver(exactHandlers.get(channel), channel, message, undefined);\n      });\n      subscriber.on('pmessage', (pattern: string, channel: string, message: string) => {\n        deliver(patternHandlers.get(pattern), channel, message, { pattern });\n      });\n      // Re-subscribe after a reconnect.\n      subscriber.on('ready', () => {\n        for (const channel of exactHandlers.keys()) {\n          subscriber?.subscribe(channel).catch(noop);\n        }\n        for (const pattern of patternHandlers.keys()) {\n          subscriber?.psubscribe(pattern).catch(noop);\n        }\n      });\n    }\n\n    return { publisher, subscriber };\n  };\n\n  const deliver = (\n    handlers: Set<MessageHandler> | undefined,\n    channel: string,\n    wireMessage: string,\n    extraMeta: Record<string, unknown> | undefined,\n  ) => {\n    if (!handlers || handlers.size === 0) return;\n    let payload: unknown;\n    try {\n      payload = codec.decode(wireMessage);\n    } catch {\n      payload = wireMessage;\n    }\n    const msg: AdapterMessage = {\n      topic: channel,\n      payload,\n      raw: wireMessage,\n      meta: extraMeta,\n    };\n    for (const handler of [...handlers]) {\n      Promise.resolve(handler(msg)).catch(noop);\n    }\n  };\n\n  return {\n    name: 'redis',\n    capabilities: { publish: true, subscribe: true, patternSubscribe: true, ack: false },\n\n    async connect() {\n      const { publisher: p, subscriber: s } = ensure();\n      await Promise.all([waitReady(p), waitReady(s)]);\n    },\n\n    async disconnect() {\n      if (!owned) {\n        publisher = null;\n        subscriber = null;\n        return;\n      }\n      const closing: Promise<unknown>[] = [];\n      if (subscriber) closing.push(subscriber.quit().catch(noop));\n      if (publisher) closing.push(publisher.quit().catch(noop));\n      await Promise.all(closing);\n      publisher = null;\n      subscriber = null;\n      installedListeners = false;\n      exactHandlers.clear();\n      patternHandlers.clear();\n    },\n\n    async publish(topic, payload, meta) {\n      const { publisher: p } = ensure();\n      const channel = meta?.channel ?? topic;\n      const encoded = codec.encode(payload);\n      const wire = typeof encoded === 'string' ? encoded : Buffer.from(encoded);\n      await p.publish(channel, wire as never);\n    },\n\n    async subscribe(topic, handler, meta) {\n      const { subscriber: s } = ensure();\n      const usePattern = meta?.pattern ?? isPattern(topic);\n      const map = usePattern ? patternHandlers : exactHandlers;\n      let set = map.get(topic);\n      const firstSubscriber = !set;\n      if (!set) {\n        set = new Set();\n        map.set(topic, set);\n      }\n      if (firstSubscriber) {\n        if (usePattern) await s.psubscribe(topic);\n        else await s.subscribe(topic);\n      }\n      set.add(handler);\n      idCounter += 1;\n      const id = `redis-${idCounter}`;\n      const ownSet = set;\n      return {\n        id,\n        topic,\n        unsubscribe: async () => {\n          ownSet.delete(handler);\n          if (ownSet.size === 0) {\n            map.delete(topic);\n            if (subscriber) {\n              if (usePattern) await subscriber.punsubscribe(topic).catch(noop);\n              else await subscriber.unsubscribe(topic).catch(noop);\n            }\n          }\n        },\n      };\n    },\n  };\n}\n\nfunction noop(): void {\n  // intentional\n}\n\nasync function waitReady(client: Redis): Promise<void> {\n  if (client.status === 'ready') return;\n  if (client.status === 'wait' || client.status === 'connecting') {\n    await new Promise<void>((resolve, reject) => {\n      const onReady = () => {\n        cleanup();\n        resolve();\n      };\n      const onError = (err: unknown) => {\n        cleanup();\n        reject(err);\n      };\n      const cleanup = () => {\n        client.off('ready', onReady);\n        client.off('error', onError);\n      };\n      client.once('ready', onReady);\n      client.once('error', onError);\n    });\n    return;\n  }\n  await client.connect().catch((err) => {\n    // Already connected/connecting is fine.\n    if (!String(err?.message ?? '').includes('connect')) throw err;\n  });\n}\n"]}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@pubber-subber/redis",
+  "version": "0.0.1",
+  "description": "Redis (and Redis-compatible: Valkey, KeyDB, Dragonfly) pub/sub adapter for @pubber-subber.",
+  "keywords": [
+    "pubsub",
+    "pub-sub",
+    "messaging",
+    "events",
+    "adapter",
+    "redis",
+    "valkey",
+    "keydb",
+    "dragonfly",
+    "ioredis",
+    "typescript"
+  ],
+  "homepage": "https://github.com/samishal1998/pubber-subber/tree/main/packages/redis#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/samishal1998/pubber-subber.git",
+    "directory": "packages/redis"
+  },
+  "bugs": {
+    "url": "https://github.com/samishal1998/pubber-subber/issues"
+  },
+  "author": "Sami Mishal",
+  "type": "module",
+  "license": "MIT",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist", "src", "README.md", "LICENSE"],
+  "scripts": {
+    "prebuild": "node ../../scripts/swap-package-json.mjs build",
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:integration": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "node ../../scripts/swap-package-json.mjs publish",
+    "postpublish": "node ../../scripts/swap-package-json.mjs build"
+  },
+  "peerDependencies": {
+    "@pubber-subber/core": "^0.0.1",
+    "ioredis": "^5.0.0"
+  },
+  "devDependencies": {
+    "@pubber-subber/core": "workspace:*",
+    "ioredis": "^5.4.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/index.ts

@@ -0,0 +1,216 @@
+import {
+  type AdapterMessage,
+  type Codec,
+  type MessageHandler,
+  type PubSubAdapter,
+  isPattern,
+  jsonCodec,
+} from '@pubber-subber/core';
+import { Redis, type RedisOptions } from 'ioredis';
+
+export interface RedisAdapterOptions {
+  /** Redis connection URL, e.g. `redis://localhost:6379`. */
+  url?: string;
+  /** ioredis-compatible options. Combined with `url` if both are passed. */
+  options?: RedisOptions;
+  /**
+   * Bring-your-own clients. When provided, the adapter will NOT manage their
+   * lifecycle (connect/disconnect become no-ops on `disconnect`).
+   * `publisher` and `subscriber` must be distinct clients because Redis
+   * disallows non-pub/sub commands on a subscribed connection.
+   */
+  clients?: { publisher: Redis; subscriber: Redis };
+  /** Payload codec. Default: JSON. */
+  codec?: Codec;
+}
+
+export interface RedisPublishMeta {
+  /** Override the wire channel for this publish; the AdapterMessage still carries `topic`. */
+  channel?: string;
+}
+
+export interface RedisSubscribeMeta {
+  /** Force PSUBSCRIBE even when `topic` has no wildcards. */
+  pattern?: boolean;
+}
+
+export function redis(
+  opts: RedisAdapterOptions = {},
+): PubSubAdapter<RedisPublishMeta, RedisSubscribeMeta> {
+  const codec = opts.codec ?? jsonCodec();
+
+  let publisher: Redis | null = null;
+  let subscriber: Redis | null = null;
+  let owned = true;
+
+  const exactHandlers = new Map<string, Set<MessageHandler>>();
+  const patternHandlers = new Map<string, Set<MessageHandler>>();
+  let idCounter = 0;
+  let installedListeners = false;
+
+  const createClient = (): Redis => {
+    if (opts.url && opts.options) return new Redis(opts.url, opts.options);
+    if (opts.url) return new Redis(opts.url);
+    if (opts.options) return new Redis(opts.options);
+    return new Redis();
+  };
+
+  const ensure = (): { publisher: Redis; subscriber: Redis } => {
+    if (publisher && subscriber) return { publisher, subscriber };
+
+    if (opts.clients) {
+      publisher = opts.clients.publisher;
+      subscriber = opts.clients.subscriber;
+      owned = false;
+    } else {
+      publisher = createClient();
+      subscriber = createClient();
+      owned = true;
+    }
+
+    if (!installedListeners) {
+      installedListeners = true;
+      subscriber.on('message', (channel: string, message: string) => {
+        deliver(exactHandlers.get(channel), channel, message, undefined);
+      });
+      subscriber.on('pmessage', (pattern: string, channel: string, message: string) => {
+        deliver(patternHandlers.get(pattern), channel, message, { pattern });
+      });
+      // Re-subscribe after a reconnect.
+      subscriber.on('ready', () => {
+        for (const channel of exactHandlers.keys()) {
+          subscriber?.subscribe(channel).catch(noop);
+        }
+        for (const pattern of patternHandlers.keys()) {
+          subscriber?.psubscribe(pattern).catch(noop);
+        }
+      });
+    }
+
+    return { publisher, subscriber };
+  };
+
+  const deliver = (
+    handlers: Set<MessageHandler> | undefined,
+    channel: string,
+    wireMessage: string,
+    extraMeta: Record<string, unknown> | undefined,
+  ) => {
+    if (!handlers || handlers.size === 0) return;
+    let payload: unknown;
+    try {
+      payload = codec.decode(wireMessage);
+    } catch {
+      payload = wireMessage;
+    }
+    const msg: AdapterMessage = {
+      topic: channel,
+      payload,
+      raw: wireMessage,
+      meta: extraMeta,
+    };
+    for (const handler of [...handlers]) {
+      Promise.resolve(handler(msg)).catch(noop);
+    }
+  };
+
+  return {
+    name: 'redis',
+    capabilities: { publish: true, subscribe: true, patternSubscribe: true, ack: false },
+
+    async connect() {
+      const { publisher: p, subscriber: s } = ensure();
+      await Promise.all([waitReady(p), waitReady(s)]);
+    },
+
+    async disconnect() {
+      if (!owned) {
+        publisher = null;
+        subscriber = null;
+        return;
+      }
+      const closing: Promise<unknown>[] = [];
+      if (subscriber) closing.push(subscriber.quit().catch(noop));
+      if (publisher) closing.push(publisher.quit().catch(noop));
+      await Promise.all(closing);
+      publisher = null;
+      subscriber = null;
+      installedListeners = false;
+      exactHandlers.clear();
+      patternHandlers.clear();
+    },
+
+    async publish(topic, payload, meta) {
+      const { publisher: p } = ensure();
+      const channel = meta?.channel ?? topic;
+      const encoded = codec.encode(payload);
+      const wire = typeof encoded === 'string' ? encoded : Buffer.from(encoded);
+      await p.publish(channel, wire as never);
+    },
+
+    async subscribe(topic, handler, meta) {
+      const { subscriber: s } = ensure();
+      const usePattern = meta?.pattern ?? isPattern(topic);
+      const map = usePattern ? patternHandlers : exactHandlers;
+      let set = map.get(topic);
+      const firstSubscriber = !set;
+      if (!set) {
+        set = new Set();
+        map.set(topic, set);
+      }
+      if (firstSubscriber) {
+        if (usePattern) await s.psubscribe(topic);
+        else await s.subscribe(topic);
+      }
+      set.add(handler);
+      idCounter += 1;
+      const id = `redis-${idCounter}`;
+      const ownSet = set;
+      return {
+        id,
+        topic,
+        unsubscribe: async () => {
+          ownSet.delete(handler);
+          if (ownSet.size === 0) {
+            map.delete(topic);
+            if (subscriber) {
+              if (usePattern) await subscriber.punsubscribe(topic).catch(noop);
+              else await subscriber.unsubscribe(topic).catch(noop);
+            }
+          }
+        },
+      };
+    },
+  };
+}
+
+function noop(): void {
+  // intentional
+}
+
+async function waitReady(client: Redis): Promise<void> {
+  if (client.status === 'ready') return;
+  if (client.status === 'wait' || client.status === 'connecting') {
+    await new Promise<void>((resolve, reject) => {
+      const onReady = () => {
+        cleanup();
+        resolve();
+      };
+      const onError = (err: unknown) => {
+        cleanup();
+        reject(err);
+      };
+      const cleanup = () => {
+        client.off('ready', onReady);
+        client.off('error', onError);
+      };
+      client.once('ready', onReady);
+      client.once('error', onError);
+    });
+    return;
+  }
+  await client.connect().catch((err) => {
+    // Already connected/connecting is fine.
+    if (!String(err?.message ?? '').includes('connect')) throw err;
+  });
+}