@pubber-subber/memory 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,82 @@
+# @pubber-subber/memory
+
+In-process pub/sub adapter for [`@pubber-subber/core`](https://www.npmjs.com/package/@pubber-subber/core). EventEmitter-style fan-out, glob pattern subscriptions, payload cloning, zero external dependencies.
+
+Use it in tests, in single-process apps, and as the default when no real broker is configured.
+
+## Install
+
+```sh
+pnpm add @pubber-subber/core @pubber-subber/memory
+```
+
+## Quick start
+
+```ts
+import { PubSub } from '@pubber-subber/core';
+import { memory } from '@pubber-subber/memory';
+
+const pubsub = new PubSub({ adapter: memory() });
+
+await pubsub.subscribe('users.*', (msg) => {
+  console.log(msg.topic, msg.payload);
+});
+
+await pubsub.publish('users.created', { id: 1, name: 'Alice' });
+await pubsub.publish('users.updated', { id: 1, name: 'Alice (edited)' });
+```
+
+## Options
+
+```ts
+memory({ rawPayloads?: boolean })
+```
+
+| Option | Default | Notes |
+| --- | --- | --- |
+| `rawPayloads` | `false` | If `true`, subscribers receive the publisher's exact object reference. Default is to `structuredClone()` so subscribers can't accidentally mutate the publisher's data. Set `true` when your payloads are immutable, expensive to clone, or contain non-cloneable values (functions, class instances). |
+
+## Capabilities
+
+```ts
+{ publish: true, subscribe: true, patternSubscribe: true, ack: false }
+```
+
+## Pattern matching
+
+Built-in glob matcher (no external dependency):
+
+| Pattern | Matches | Notes |
+| --- | --- | --- |
+| `*` | any run of characters within a topic segment | won't cross `.` |
+| `**` | any run of characters across segments | greedy |
+| `?` | exactly one character within a segment | won't match `.` |
+
+```ts
+await pubsub.subscribe('users.*',  handler);  // users.created, users.updated; NOT users.created.email
+await pubsub.subscribe('users.**', handler);  // users.created, users.created.email, ...
+await pubsub.subscribe('user?',    handler);  // user1, users
+```
+
+## Metadata
+
+The memory adapter forwards any object as `AdapterMessage.meta` and as the second handler argument, but doesn't interpret it. Use it for tracing, tenant IDs, correlation IDs, or anything else you'd like to thread through.
+
+```ts
+await pubsub.subscribe('t', (msg, meta) => {
+  // msg.meta === { traceId: 'abc' }
+  // meta     === undefined
+}, /* no subscribe meta */);
+
+await pubsub.publish('t', payload, { traceId: 'abc' });
+```
+
+## Behavior
+
+- **Fire-and-forget but synchronous-ish.** `publish()` awaits each subscriber's handler in order before resolving. Memory has no in-flight buffer or backpressure — when `publish()` resolves, every live subscriber has been called.
+- **No replay.** Subscribers added *after* a publish do not see backfill (consistent with pub/sub semantics across the ecosystem).
+- **Handler errors don't break delivery.** If one subscriber throws, the others still receive the message. Errors surface via the facade's `onError` callback if set.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,78 @@
+'use strict';
+
+var core = require('@pubber-subber/core');
+
+// src/index.ts
+function memory(opts = {}) {
+  const exactSubs = /* @__PURE__ */ new Map();
+  const patternSubs = /* @__PURE__ */ new Map();
+  let idCounter = 0;
+  const cloneIfNeeded = (value) => {
+    if (opts.rawPayloads) return value;
+    try {
+      return structuredClone(value);
+    } catch {
+      return value;
+    }
+  };
+  return {
+    name: "memory",
+    capabilities: {
+      publish: true,
+      subscribe: true,
+      patternSubscribe: true,
+      ack: false
+    },
+    async publish(topic, payload, meta) {
+      const buildMessage = () => ({
+        topic,
+        payload: cloneIfNeeded(payload),
+        raw: payload,
+        meta
+      });
+      const exact = exactSubs.get(topic);
+      if (exact && exact.size > 0) {
+        for (const handler of [...exact]) {
+          await safeDeliver(handler, buildMessage());
+        }
+      }
+      for (const [pattern, handlers] of patternSubs) {
+        if (core.matchTopic(pattern, topic)) {
+          for (const handler of [...handlers]) {
+            await safeDeliver(handler, buildMessage());
+          }
+        }
+      }
+    },
+    async subscribe(topic, handler) {
+      const map = core.isPattern(topic) ? patternSubs : exactSubs;
+      let set = map.get(topic);
+      if (!set) {
+        set = /* @__PURE__ */ new Set();
+        map.set(topic, set);
+      }
+      set.add(handler);
+      idCounter += 1;
+      const id = `mem-${idCounter}`;
+      const ownSet = set;
+      return {
+        id,
+        topic,
+        unsubscribe: async () => {
+          ownSet.delete(handler);
+          if (ownSet.size === 0) map.delete(topic);
+        }
+      };
+    }
+  };
+}
+async function safeDeliver(handler, message) {
+  try {
+    await handler(message);
+  } catch {
+  }
+}
+
+exports.memory = memory;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["matchTopic","isPattern"],"mappings":";;;;;AAoBO,SAAS,MAAA,CACd,IAAA,GAA6B,EAAC,EACqB;AACnD,EAAA,MAAM,SAAA,uBAAgB,GAAA,EAAiC;AACvD,EAAA,MAAM,WAAA,uBAAkB,GAAA,EAAiC;AACzD,EAAA,IAAI,SAAA,GAAY,CAAA;AAEhB,EAAA,MAAM,aAAA,GAAgB,CAAC,KAAA,KAA4B;AACjD,IAAA,IAAI,IAAA,CAAK,aAAa,OAAO,KAAA;AAC7B,IAAA,IAAI;AACF,MAAA,OAAO,gBAAgB,KAAK,CAAA;AAAA,IAC9B,CAAA,CAAA,MAAQ;AACN,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,EACF,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,QAAA;AAAA,IACN,YAAA,EAAc;AAAA,MACZ,OAAA,EAAS,IAAA;AAAA,MACT,SAAA,EAAW,IAAA;AAAA,MACX,gBAAA,EAAkB,IAAA;AAAA,MAClB,GAAA,EAAK;AAAA,KACP;AAAA,IAEA,MAAM,OAAA,CAAQ,KAAA,EAAO,OAAA,EAAS,IAAA,EAAM;AAClC,MAAA,MAAM,eAAe,OAAuB;AAAA,QAC1C,KAAA;AAAA,QACA,OAAA,EAAS,cAAc,OAAO,CAAA;AAAA,QAC9B,GAAA,EAAK,OAAA;AAAA,QACL;AAAA,OACF,CAAA;AAEA,MAAA,MAAM,KAAA,GAAQ,SAAA,CAAU,GAAA,CAAI,KAAK,CAAA;AACjC,MAAA,IAAI,KAAA,IAAS,KAAA,CAAM,IAAA,GAAO,CAAA,EAAG;AAC3B,QAAA,KAAA,MAAW,OAAA,IAAW,CAAC,GAAG,KAAK,CAAA,EAAG;AAChC,UAAA,MAAM,WAAA,CAAY,OAAA,EAAS,YAAA,EAAc,CAAA;AAAA,QAC3C;AAAA,MACF;AAEA,MAAA,KAAA,MAAW,CAAC,OAAA,EAAS,QAAQ,CAAA,IAAK,WAAA,EAAa;AAC7C,QAAA,IAAIA,eAAA,CAAW,OAAA,EAAS,KAAK,CAAA,EAAG;AAC9B,UAAA,KAAA,MAAW,OAAA,IAAW,CAAC,GAAG,QAAQ,CAAA,EAAG;AACnC,YAAA,MAAM,WAAA,CAAY,OAAA,EAAS,YAAA,EAAc,CAAA;AAAA,UAC3C;AAAA,QACF;AAAA,MACF;AAAA,IACF,CAAA;AAAA,IAEA,MAAM,SAAA,CAAU,KAAA,EAAO,OAAA,EAAS;AAC9B,MAAA,MAAM,GAAA,GAAMC,cAAA,CAAU,KAAK,CAAA,GAAI,WAAA,GAAc,SAAA;AAC7C,MAAA,IAAI,GAAA,GAAM,GAAA,CAAI,GAAA,CAAI,KAAK,CAAA;AACvB,MAAA,IAAI,CAAC,GAAA,EAAK;AACR,QAAA,GAAA,uBAAU,GAAA,EAAI;AACd,QAAA,GAAA,CAAI,GAAA,CAAI,OAAO,GAAG,CAAA;AAAA,MACpB;AACA,MAAA,GAAA,CAAI,IAAI,OAAO,CAAA;AACf,MAAA,SAAA,IAAa,CAAA;AACb,MAAA,MAAM,EAAA,GAAK,OAAO,SAAS,CAAA,CAAA;AAC3B,MAAA,MAAM,MAAA,GAAS,GAAA;AACf,MAAA,OAAO;AAAA,QACL,EAAA;AAAA,QACA,KAAA;AAAA,QACA,aAAa,YAAY;AACvB,UAAA,MAAA,CAAO,OAAO,OAAO,CAAA;AACrB,UAAA,IAAI,MAAA,CAAO,IAAA,KAAS,CAAA,EAAG,GAAA,CAAI,OAAO,KAAK,CAAA;AAAA,QACzC;AAAA,OACF;AAAA,IACF;AAAA,GACF;AACF;AAEA,eAAe,WAAA,CAAY,SAAyB,OAAA,EAAwC;AAC1F,EAAA,IAAI;AACF,IAAA,MAAM,QAAQ,OAAO,CAAA;AAAA,EACvB,CAAA,CAAA,MAAQ;AAAA,EAGR;AACF","file":"index.cjs","sourcesContent":["import {\n  type AdapterMessage,\n  type MessageHandler,\n  type PubSubAdapter,\n  isPattern,\n  matchTopic,\n} from '@pubber-subber/core';\n\nexport interface MemoryAdapterOptions {\n  /**\n   * Skip cloning published payloads. By default the adapter passes a\n   * `structuredClone`d copy to subscribers so handlers can't mutate the\n   * publisher's object. Set this if your payloads are immutable or contain\n   * non-cloneable values (functions, class instances) and you accept the risk.\n   */\n  rawPayloads?: boolean;\n}\n\nexport type MemoryMeta = Record<string, unknown>;\n\nexport function memory(\n  opts: MemoryAdapterOptions = {},\n): PubSubAdapter<MemoryMeta, MemoryMeta, MemoryMeta> {\n  const exactSubs = new Map<string, Set<MessageHandler>>();\n  const patternSubs = new Map<string, Set<MessageHandler>>();\n  let idCounter = 0;\n\n  const cloneIfNeeded = (value: unknown): unknown => {\n    if (opts.rawPayloads) return value;\n    try {\n      return structuredClone(value);\n    } catch {\n      return value;\n    }\n  };\n\n  return {\n    name: 'memory',\n    capabilities: {\n      publish: true,\n      subscribe: true,\n      patternSubscribe: true,\n      ack: false,\n    },\n\n    async publish(topic, payload, meta) {\n      const buildMessage = (): AdapterMessage => ({\n        topic,\n        payload: cloneIfNeeded(payload),\n        raw: payload,\n        meta,\n      });\n\n      const exact = exactSubs.get(topic);\n      if (exact && exact.size > 0) {\n        for (const handler of [...exact]) {\n          await safeDeliver(handler, buildMessage());\n        }\n      }\n\n      for (const [pattern, handlers] of patternSubs) {\n        if (matchTopic(pattern, topic)) {\n          for (const handler of [...handlers]) {\n            await safeDeliver(handler, buildMessage());\n          }\n        }\n      }\n    },\n\n    async subscribe(topic, handler) {\n      const map = isPattern(topic) ? patternSubs : exactSubs;\n      let set = map.get(topic);\n      if (!set) {\n        set = new Set();\n        map.set(topic, set);\n      }\n      set.add(handler);\n      idCounter += 1;\n      const id = `mem-${idCounter}`;\n      const ownSet = set;\n      return {\n        id,\n        topic,\n        unsubscribe: async () => {\n          ownSet.delete(handler);\n          if (ownSet.size === 0) map.delete(topic);\n        },\n      };\n    },\n  };\n}\n\nasync function safeDeliver(handler: MessageHandler, message: AdapterMessage): Promise<void> {\n  try {\n    await handler(message);\n  } catch {\n    // Handler errors are surfaced by the PubSub facade via onError; we\n    // swallow here so one bad subscriber doesn't break delivery to the rest.\n  }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,15 @@
+import { PubSubAdapter } from '@pubber-subber/core';
+
+interface MemoryAdapterOptions {
+    /**
+     * Skip cloning published payloads. By default the adapter passes a
+     * `structuredClone`d copy to subscribers so handlers can't mutate the
+     * publisher's object. Set this if your payloads are immutable or contain
+     * non-cloneable values (functions, class instances) and you accept the risk.
+     */
+    rawPayloads?: boolean;
+}
+type MemoryMeta = Record<string, unknown>;
+declare function memory(opts?: MemoryAdapterOptions): PubSubAdapter<MemoryMeta, MemoryMeta, MemoryMeta>;
+
+export { type MemoryAdapterOptions, type MemoryMeta, memory };

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+import { PubSubAdapter } from '@pubber-subber/core';
+
+interface MemoryAdapterOptions {
+    /**
+     * Skip cloning published payloads. By default the adapter passes a
+     * `structuredClone`d copy to subscribers so handlers can't mutate the
+     * publisher's object. Set this if your payloads are immutable or contain
+     * non-cloneable values (functions, class instances) and you accept the risk.
+     */
+    rawPayloads?: boolean;
+}
+type MemoryMeta = Record<string, unknown>;
+declare function memory(opts?: MemoryAdapterOptions): PubSubAdapter<MemoryMeta, MemoryMeta, MemoryMeta>;
+
+export { type MemoryAdapterOptions, type MemoryMeta, memory };

package/dist/index.js

@@ -0,0 +1,76 @@
+import { isPattern, matchTopic } from '@pubber-subber/core';
+
+// src/index.ts
+function memory(opts = {}) {
+  const exactSubs = /* @__PURE__ */ new Map();
+  const patternSubs = /* @__PURE__ */ new Map();
+  let idCounter = 0;
+  const cloneIfNeeded = (value) => {
+    if (opts.rawPayloads) return value;
+    try {
+      return structuredClone(value);
+    } catch {
+      return value;
+    }
+  };
+  return {
+    name: "memory",
+    capabilities: {
+      publish: true,
+      subscribe: true,
+      patternSubscribe: true,
+      ack: false
+    },
+    async publish(topic, payload, meta) {
+      const buildMessage = () => ({
+        topic,
+        payload: cloneIfNeeded(payload),
+        raw: payload,
+        meta
+      });
+      const exact = exactSubs.get(topic);
+      if (exact && exact.size > 0) {
+        for (const handler of [...exact]) {
+          await safeDeliver(handler, buildMessage());
+        }
+      }
+      for (const [pattern, handlers] of patternSubs) {
+        if (matchTopic(pattern, topic)) {
+          for (const handler of [...handlers]) {
+            await safeDeliver(handler, buildMessage());
+          }
+        }
+      }
+    },
+    async subscribe(topic, handler) {
+      const map = isPattern(topic) ? patternSubs : exactSubs;
+      let set = map.get(topic);
+      if (!set) {
+        set = /* @__PURE__ */ new Set();
+        map.set(topic, set);
+      }
+      set.add(handler);
+      idCounter += 1;
+      const id = `mem-${idCounter}`;
+      const ownSet = set;
+      return {
+        id,
+        topic,
+        unsubscribe: async () => {
+          ownSet.delete(handler);
+          if (ownSet.size === 0) map.delete(topic);
+        }
+      };
+    }
+  };
+}
+async function safeDeliver(handler, message) {
+  try {
+    await handler(message);
+  } catch {
+  }
+}
+
+export { memory };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AAoBO,SAAS,MAAA,CACd,IAAA,GAA6B,EAAC,EACqB;AACnD,EAAA,MAAM,SAAA,uBAAgB,GAAA,EAAiC;AACvD,EAAA,MAAM,WAAA,uBAAkB,GAAA,EAAiC;AACzD,EAAA,IAAI,SAAA,GAAY,CAAA;AAEhB,EAAA,MAAM,aAAA,GAAgB,CAAC,KAAA,KAA4B;AACjD,IAAA,IAAI,IAAA,CAAK,aAAa,OAAO,KAAA;AAC7B,IAAA,IAAI;AACF,MAAA,OAAO,gBAAgB,KAAK,CAAA;AAAA,IAC9B,CAAA,CAAA,MAAQ;AACN,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,EACF,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,QAAA;AAAA,IACN,YAAA,EAAc;AAAA,MACZ,OAAA,EAAS,IAAA;AAAA,MACT,SAAA,EAAW,IAAA;AAAA,MACX,gBAAA,EAAkB,IAAA;AAAA,MAClB,GAAA,EAAK;AAAA,KACP;AAAA,IAEA,MAAM,OAAA,CAAQ,KAAA,EAAO,OAAA,EAAS,IAAA,EAAM;AAClC,MAAA,MAAM,eAAe,OAAuB;AAAA,QAC1C,KAAA;AAAA,QACA,OAAA,EAAS,cAAc,OAAO,CAAA;AAAA,QAC9B,GAAA,EAAK,OAAA;AAAA,QACL;AAAA,OACF,CAAA;AAEA,MAAA,MAAM,KAAA,GAAQ,SAAA,CAAU,GAAA,CAAI,KAAK,CAAA;AACjC,MAAA,IAAI,KAAA,IAAS,KAAA,CAAM,IAAA,GAAO,CAAA,EAAG;AAC3B,QAAA,KAAA,MAAW,OAAA,IAAW,CAAC,GAAG,KAAK,CAAA,EAAG;AAChC,UAAA,MAAM,WAAA,CAAY,OAAA,EAAS,YAAA,EAAc,CAAA;AAAA,QAC3C;AAAA,MACF;AAEA,MAAA,KAAA,MAAW,CAAC,OAAA,EAAS,QAAQ,CAAA,IAAK,WAAA,EAAa;AAC7C,QAAA,IAAI,UAAA,CAAW,OAAA,EAAS,KAAK,CAAA,EAAG;AAC9B,UAAA,KAAA,MAAW,OAAA,IAAW,CAAC,GAAG,QAAQ,CAAA,EAAG;AACnC,YAAA,MAAM,WAAA,CAAY,OAAA,EAAS,YAAA,EAAc,CAAA;AAAA,UAC3C;AAAA,QACF;AAAA,MACF;AAAA,IACF,CAAA;AAAA,IAEA,MAAM,SAAA,CAAU,KAAA,EAAO,OAAA,EAAS;AAC9B,MAAA,MAAM,GAAA,GAAM,SAAA,CAAU,KAAK,CAAA,GAAI,WAAA,GAAc,SAAA;AAC7C,MAAA,IAAI,GAAA,GAAM,GAAA,CAAI,GAAA,CAAI,KAAK,CAAA;AACvB,MAAA,IAAI,CAAC,GAAA,EAAK;AACR,QAAA,GAAA,uBAAU,GAAA,EAAI;AACd,QAAA,GAAA,CAAI,GAAA,CAAI,OAAO,GAAG,CAAA;AAAA,MACpB;AACA,MAAA,GAAA,CAAI,IAAI,OAAO,CAAA;AACf,MAAA,SAAA,IAAa,CAAA;AACb,MAAA,MAAM,EAAA,GAAK,OAAO,SAAS,CAAA,CAAA;AAC3B,MAAA,MAAM,MAAA,GAAS,GAAA;AACf,MAAA,OAAO;AAAA,QACL,EAAA;AAAA,QACA,KAAA;AAAA,QACA,aAAa,YAAY;AACvB,UAAA,MAAA,CAAO,OAAO,OAAO,CAAA;AACrB,UAAA,IAAI,MAAA,CAAO,IAAA,KAAS,CAAA,EAAG,GAAA,CAAI,OAAO,KAAK,CAAA;AAAA,QACzC;AAAA,OACF;AAAA,IACF;AAAA,GACF;AACF;AAEA,eAAe,WAAA,CAAY,SAAyB,OAAA,EAAwC;AAC1F,EAAA,IAAI;AACF,IAAA,MAAM,QAAQ,OAAO,CAAA;AAAA,EACvB,CAAA,CAAA,MAAQ;AAAA,EAGR;AACF","file":"index.js","sourcesContent":["import {\n  type AdapterMessage,\n  type MessageHandler,\n  type PubSubAdapter,\n  isPattern,\n  matchTopic,\n} from '@pubber-subber/core';\n\nexport interface MemoryAdapterOptions {\n  /**\n   * Skip cloning published payloads. By default the adapter passes a\n   * `structuredClone`d copy to subscribers so handlers can't mutate the\n   * publisher's object. Set this if your payloads are immutable or contain\n   * non-cloneable values (functions, class instances) and you accept the risk.\n   */\n  rawPayloads?: boolean;\n}\n\nexport type MemoryMeta = Record<string, unknown>;\n\nexport function memory(\n  opts: MemoryAdapterOptions = {},\n): PubSubAdapter<MemoryMeta, MemoryMeta, MemoryMeta> {\n  const exactSubs = new Map<string, Set<MessageHandler>>();\n  const patternSubs = new Map<string, Set<MessageHandler>>();\n  let idCounter = 0;\n\n  const cloneIfNeeded = (value: unknown): unknown => {\n    if (opts.rawPayloads) return value;\n    try {\n      return structuredClone(value);\n    } catch {\n      return value;\n    }\n  };\n\n  return {\n    name: 'memory',\n    capabilities: {\n      publish: true,\n      subscribe: true,\n      patternSubscribe: true,\n      ack: false,\n    },\n\n    async publish(topic, payload, meta) {\n      const buildMessage = (): AdapterMessage => ({\n        topic,\n        payload: cloneIfNeeded(payload),\n        raw: payload,\n        meta,\n      });\n\n      const exact = exactSubs.get(topic);\n      if (exact && exact.size > 0) {\n        for (const handler of [...exact]) {\n          await safeDeliver(handler, buildMessage());\n        }\n      }\n\n      for (const [pattern, handlers] of patternSubs) {\n        if (matchTopic(pattern, topic)) {\n          for (const handler of [...handlers]) {\n            await safeDeliver(handler, buildMessage());\n          }\n        }\n      }\n    },\n\n    async subscribe(topic, handler) {\n      const map = isPattern(topic) ? patternSubs : exactSubs;\n      let set = map.get(topic);\n      if (!set) {\n        set = new Set();\n        map.set(topic, set);\n      }\n      set.add(handler);\n      idCounter += 1;\n      const id = `mem-${idCounter}`;\n      const ownSet = set;\n      return {\n        id,\n        topic,\n        unsubscribe: async () => {\n          ownSet.delete(handler);\n          if (ownSet.size === 0) map.delete(topic);\n        },\n      };\n    },\n  };\n}\n\nasync function safeDeliver(handler: MessageHandler, message: AdapterMessage): Promise<void> {\n  try {\n    await handler(message);\n  } catch {\n    // Handler errors are surfaced by the PubSub facade via onError; we\n    // swallow here so one bad subscriber doesn't break delivery to the rest.\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@pubber-subber/memory",
+  "version": "0.0.1",
+  "description": "In-memory pub/sub adapter for @pubber-subber. Use in tests, dev, and single-process apps.",
+  "keywords": [
+    "pubsub",
+    "pub-sub",
+    "messaging",
+    "events",
+    "adapter",
+    "in-memory",
+    "eventemitter",
+    "in-process",
+    "typescript"
+  ],
+  "homepage": "https://github.com/samishal1998/pubber-subber/tree/main/packages/memory#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/samishal1998/pubber-subber.git",
+    "directory": "packages/memory"
+  },
+  "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: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"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@pubber-subber/core": "workspace:*"
+  }
+}

package/src/index.ts

@@ -0,0 +1,100 @@
+import {
+  type AdapterMessage,
+  type MessageHandler,
+  type PubSubAdapter,
+  isPattern,
+  matchTopic,
+} from '@pubber-subber/core';
+
+export interface MemoryAdapterOptions {
+  /**
+   * Skip cloning published payloads. By default the adapter passes a
+   * `structuredClone`d copy to subscribers so handlers can't mutate the
+   * publisher's object. Set this if your payloads are immutable or contain
+   * non-cloneable values (functions, class instances) and you accept the risk.
+   */
+  rawPayloads?: boolean;
+}
+
+export type MemoryMeta = Record<string, unknown>;
+
+export function memory(
+  opts: MemoryAdapterOptions = {},
+): PubSubAdapter<MemoryMeta, MemoryMeta, MemoryMeta> {
+  const exactSubs = new Map<string, Set<MessageHandler>>();
+  const patternSubs = new Map<string, Set<MessageHandler>>();
+  let idCounter = 0;
+
+  const cloneIfNeeded = (value: unknown): unknown => {
+    if (opts.rawPayloads) return value;
+    try {
+      return structuredClone(value);
+    } catch {
+      return value;
+    }
+  };
+
+  return {
+    name: 'memory',
+    capabilities: {
+      publish: true,
+      subscribe: true,
+      patternSubscribe: true,
+      ack: false,
+    },
+
+    async publish(topic, payload, meta) {
+      const buildMessage = (): AdapterMessage => ({
+        topic,
+        payload: cloneIfNeeded(payload),
+        raw: payload,
+        meta,
+      });
+
+      const exact = exactSubs.get(topic);
+      if (exact && exact.size > 0) {
+        for (const handler of [...exact]) {
+          await safeDeliver(handler, buildMessage());
+        }
+      }
+
+      for (const [pattern, handlers] of patternSubs) {
+        if (matchTopic(pattern, topic)) {
+          for (const handler of [...handlers]) {
+            await safeDeliver(handler, buildMessage());
+          }
+        }
+      }
+    },
+
+    async subscribe(topic, handler) {
+      const map = isPattern(topic) ? patternSubs : exactSubs;
+      let set = map.get(topic);
+      if (!set) {
+        set = new Set();
+        map.set(topic, set);
+      }
+      set.add(handler);
+      idCounter += 1;
+      const id = `mem-${idCounter}`;
+      const ownSet = set;
+      return {
+        id,
+        topic,
+        unsubscribe: async () => {
+          ownSet.delete(handler);
+          if (ownSet.size === 0) map.delete(topic);
+        },
+      };
+    },
+  };
+}
+
+async function safeDeliver(handler: MessageHandler, message: AdapterMessage): Promise<void> {
+  try {
+    await handler(message);
+  } catch {
+    // Handler errors are surfaced by the PubSub facade via onError; we
+    // swallow here so one bad subscriber doesn't break delivery to the rest.
+  }
+}