@noy-db/by-tabs 0.2.0-pre.8 → 0.3.0-pre.1

package/README.md

@@ -2,7 +2,7 @@
 
 BroadcastChannel multi-tab transport for [noy-db](https://github.com/vLannaAi/noy-db) — sub-millisecond fan-out between tabs of the same origin.
 
-> Second member of the `by-*` family of session-share transports. See [`docs/packages/by-transports.md`](../../docs/packages/by-transports.md) for the family contract and roster.
+> Second member of the `by-*` family of session-share transports. See [`docs/packages/by-transports.md`](https://github.com/vLannaAi/noy-db-docs/blob/main/content/docs/packages/by-transports.md) for the family contract and roster.
 
 ## Install
 

package/dist/index.d.ts

@@ -1,5 +1,40 @@
 import { PeerChannel } from '@noy-db/by-peer';
 export { PeerChannel } from '@noy-db/by-peer';
+import { CoordinationProvider } from '@noy-db/hub/kernel';
+
+/**
+ * **@noy-db/by-tabs** real-time {@link CoordinationProvider} — a drain-barrier
+ * transport over a {@link PeerChannel} (BroadcastChannel between tabs).
+ *
+ * The kernel defines the {@link CoordinationProvider} port (#469); the store
+ * default polls `_meta/schema-fence`, but a multi-tab app can inject this
+ * push-based provider so a schema cutover fences **instantly** instead of via
+ * store polling. The migration cutover and `@klum-db/lobby` both drive the same
+ * port through `coordinationStrategy`, so neither names `by-tabs`.
+ *
+ * ## Shared core
+ *
+ * The protocol (JSON `co-fence`/`co-presence` envelopes, per-vault fence +
+ * presence maps, local-update-before-broadcast, prune-on-read) is transport
+ * agnostic — it is **identical** for a BroadcastChannel tab and a WebRTC peer.
+ * To stay DRY, that core lives once in `@noy-db/by-peer` as
+ * `channelCoordination`; `tabsCoordination` is a thin, named delegation. See
+ * that module for the wire protocol and local-echo notes.
+ *
+ * @module
+ */
+
+/**
+ * Build a real-time {@link CoordinationProvider} backed by a {@link PeerChannel}
+ * (a BroadcastChannel between tabs of the same origin).
+ *
+ * Delegates to the shared `channelCoordination` core in `@noy-db/by-peer` — the
+ * by-tabs and by-peer transports run the identical drain-barrier protocol, so
+ * the logic is not duplicated. Pass it as
+ * `createNoydb({ coordinationStrategy: tabsCoordination(ch) })`, or drive it
+ * directly via `runDrainBarrier`.
+ */
+declare function tabsCoordination(channel: PeerChannel): CoordinationProvider;
 
 /**
  * **@noy-db/by-tabs** — BroadcastChannel multi-tab transport for noy-db.
@@ -53,4 +88,4 @@ declare function tabsChannel(options: TabsChannelOptions): PeerChannel;
  */
 declare function isTabsChannelAvailable(): boolean;
 
-export { type TabsChannelOptions, isTabsChannelAvailable, tabsChannel };
+export { type TabsChannelOptions, isTabsChannelAvailable, tabsChannel, tabsCoordination };

package/dist/index.js

@@ -1,3 +1,9 @@
+// src/coordination.ts
+import { channelCoordination } from "@noy-db/by-peer";
+function tabsCoordination(channel) {
+  return channelCoordination(channel);
+}
+
 // src/index.ts
 function tabsChannel(options) {
   const name = options.name;
@@ -63,6 +69,7 @@ function makeNoopChannel(name) {
 }
 export {
   isTabsChannelAvailable,
-  tabsChannel
+  tabsChannel,
+  tabsCoordination
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * **@noy-db/by-tabs** — BroadcastChannel multi-tab transport for noy-db.\n *\n * Wraps the browser `BroadcastChannel` API as a `PeerChannel`, the\n * primitive every `by-*` transport implements. Sub-millisecond fan-out\n * across tabs of the same origin; same code shape as `@noy-db/by-peer`,\n * just a different wire.\n *\n * Compose with `peerStore()` / `servePeerStore()` from `@noy-db/by-peer`\n * for an asymmetric tab-as-remote-store topology, or use the channel\n * directly to publish change events to every other tab.\n *\n * ## Threat model\n *\n * - `BroadcastChannel` is same-origin by browser policy — only documents\n *   served from the same scheme + host + port can subscribe.\n * - noy-db already encrypts at rest — every tab on the channel sees\n *   only AES-256-GCM ciphertext envelopes. The transport never decrypts.\n * - Untrusted tabs (e.g. third-party iframes that share an origin via\n *   `document.domain` legacy) can still see the channel. Treat\n *   BroadcastChannel as origin-scoped, not session-scoped.\n *\n * @packageDocumentation\n */\n\nimport type { PeerChannel } from '@noy-db/by-peer'\n\nexport type { PeerChannel }\n\n/**\n * Options for `tabsChannel()`.\n */\nexport interface TabsChannelOptions {\n  /**\n   * BroadcastChannel name. Two tabs subscribed to the same name see\n   * each other's messages. Use a stable, vault-scoped string like\n   * `'noy-db:vault-acme'` to keep different vaults isolated.\n   */\n  readonly name: string\n}\n\n/**\n * Wrap a `BroadcastChannel` as a `PeerChannel`.\n *\n * Returns a no-op channel (always `isOpen: false`, no-op `send`) when\n * `BroadcastChannel` is undefined — so server-side rendering, Node\n * scripts, and older browsers can import the package without crashing\n * before they feature-detect.\n */\nexport function tabsChannel(options: TabsChannelOptions): PeerChannel {\n  const name = options.name\n  const Bc = (globalThis as { BroadcastChannel?: typeof BroadcastChannel }).BroadcastChannel\n  if (!Bc) return makeNoopChannel(name)\n\n  const bc = new Bc(name)\n  type Listeners = {\n    message: Set<(p: string) => void>\n    close: Set<() => void>\n  }\n  const listeners: Listeners = { message: new Set(), close: new Set() }\n  let closed = false\n\n  bc.addEventListener('message', (ev: MessageEvent) => {\n    if (typeof ev.data !== 'string') return\n    for (const fn of listeners.message) fn(ev.data)\n  })\n\n  function fireClose(): void {\n    if (closed) return\n    closed = true\n    for (const fn of listeners.close) fn()\n  }\n\n  return {\n    get isOpen() {\n      return !closed\n    },\n    send(payload: string) {\n      if (closed) throw new Error('PeerChannel closed')\n      bc.postMessage(payload)\n    },\n    on(event: 'message' | 'close', listener: ((payload: string) => void) | (() => void)): () => void {\n      if (event === 'message') {\n        listeners.message.add(listener as (p: string) => void)\n        return () => listeners.message.delete(listener as (p: string) => void)\n      }\n      listeners.close.add(listener as () => void)\n      return () => listeners.close.delete(listener as () => void)\n    },\n    close() {\n      if (closed) return\n      try {\n        bc.close()\n      } catch {\n        // ignore — channel already torn down\n      }\n      fireClose()\n    },\n  } as PeerChannel\n}\n\n/**\n * Whether `BroadcastChannel` is available in the current runtime. Use\n * this as a pre-flight before rendering UI that relies on tab-to-tab\n * sync — Node, SSR, and a handful of older browsers don't ship it.\n */\nexport function isTabsChannelAvailable(): boolean {\n  return typeof (globalThis as { BroadcastChannel?: unknown }).BroadcastChannel === 'function'\n}\n\n// ─── Internals ───────────────────────────────────────────────────────────\n\nfunction makeNoopChannel(name: string): PeerChannel {\n  void name\n  return {\n    isOpen: false,\n    send() {\n      throw new Error(\n        '[@noy-db/by-tabs] BroadcastChannel is not available in this runtime — use isTabsChannelAvailable() to feature-detect',\n      )\n    },\n    on(_event: 'message' | 'close', _listener: ((p: string) => void) | (() => void)): () => void {\n      return () => {}\n    },\n    close() {},\n  } as PeerChannel\n}\n"],"mappings":";AAiDO,SAAS,YAAY,SAA0C;AACpE,QAAM,OAAO,QAAQ;AACrB,QAAM,KAAM,WAA8D;AAC1E,MAAI,CAAC,GAAI,QAAO,gBAAgB,IAAI;AAEpC,QAAM,KAAK,IAAI,GAAG,IAAI;AAKtB,QAAM,YAAuB,EAAE,SAAS,oBAAI,IAAI,GAAG,OAAO,oBAAI,IAAI,EAAE;AACpE,MAAI,SAAS;AAEb,KAAG,iBAAiB,WAAW,CAAC,OAAqB;AACnD,QAAI,OAAO,GAAG,SAAS,SAAU;AACjC,eAAW,MAAM,UAAU,QAAS,IAAG,GAAG,IAAI;AAAA,EAChD,CAAC;AAED,WAAS,YAAkB;AACzB,QAAI,OAAQ;AACZ,aAAS;AACT,eAAW,MAAM,UAAU,MAAO,IAAG;AAAA,EACvC;AAEA,SAAO;AAAA,IACL,IAAI,SAAS;AACX,aAAO,CAAC;AAAA,IACV;AAAA,IACA,KAAK,SAAiB;AACpB,UAAI,OAAQ,OAAM,IAAI,MAAM,oBAAoB;AAChD,SAAG,YAAY,OAAO;AAAA,IACxB;AAAA,IACA,GAAG,OAA4B,UAAkE;AAC/F,UAAI,UAAU,WAAW;AACvB,kBAAU,QAAQ,IAAI,QAA+B;AACrD,eAAO,MAAM,UAAU,QAAQ,OAAO,QAA+B;AAAA,MACvE;AACA,gBAAU,MAAM,IAAI,QAAsB;AAC1C,aAAO,MAAM,UAAU,MAAM,OAAO,QAAsB;AAAA,IAC5D;AAAA,IACA,QAAQ;AACN,UAAI,OAAQ;AACZ,UAAI;AACF,WAAG,MAAM;AAAA,MACX,QAAQ;AAAA,MAER;AACA,gBAAU;AAAA,IACZ;AAAA,EACF;AACF;AAOO,SAAS,yBAAkC;AAChD,SAAO,OAAQ,WAA8C,qBAAqB;AACpF;AAIA,SAAS,gBAAgB,MAA2B;AAClD,OAAK;AACL,SAAO;AAAA,IACL,QAAQ;AAAA,IACR,OAAO;AACL,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAAA,IACA,GAAG,QAA6B,WAA6D;AAC3F,aAAO,MAAM;AAAA,MAAC;AAAA,IAChB;AAAA,IACA,QAAQ;AAAA,IAAC;AAAA,EACX;AACF;","names":[]}
+{"version":3,"sources":["../src/coordination.ts","../src/index.ts"],"sourcesContent":["/**\n * **@noy-db/by-tabs** real-time {@link CoordinationProvider} — a drain-barrier\n * transport over a {@link PeerChannel} (BroadcastChannel between tabs).\n *\n * The kernel defines the {@link CoordinationProvider} port (#469); the store\n * default polls `_meta/schema-fence`, but a multi-tab app can inject this\n * push-based provider so a schema cutover fences **instantly** instead of via\n * store polling. The migration cutover and `@klum-db/lobby` both drive the same\n * port through `coordinationStrategy`, so neither names `by-tabs`.\n *\n * ## Shared core\n *\n * The protocol (JSON `co-fence`/`co-presence` envelopes, per-vault fence +\n * presence maps, local-update-before-broadcast, prune-on-read) is transport\n * agnostic — it is **identical** for a BroadcastChannel tab and a WebRTC peer.\n * To stay DRY, that core lives once in `@noy-db/by-peer` as\n * `channelCoordination`; `tabsCoordination` is a thin, named delegation. See\n * that module for the wire protocol and local-echo notes.\n *\n * @module\n */\n\nimport { channelCoordination } from '@noy-db/by-peer'\nimport type { PeerChannel } from '@noy-db/by-peer'\nimport type { CoordinationProvider } from '@noy-db/hub/kernel'\n\n/**\n * Build a real-time {@link CoordinationProvider} backed by a {@link PeerChannel}\n * (a BroadcastChannel between tabs of the same origin).\n *\n * Delegates to the shared `channelCoordination` core in `@noy-db/by-peer` — the\n * by-tabs and by-peer transports run the identical drain-barrier protocol, so\n * the logic is not duplicated. Pass it as\n * `createNoydb({ coordinationStrategy: tabsCoordination(ch) })`, or drive it\n * directly via `runDrainBarrier`.\n */\nexport function tabsCoordination(channel: PeerChannel): CoordinationProvider {\n  return channelCoordination(channel)\n}\n","/**\n * **@noy-db/by-tabs** — BroadcastChannel multi-tab transport for noy-db.\n *\n * Wraps the browser `BroadcastChannel` API as a `PeerChannel`, the\n * primitive every `by-*` transport implements. Sub-millisecond fan-out\n * across tabs of the same origin; same code shape as `@noy-db/by-peer`,\n * just a different wire.\n *\n * Compose with `peerStore()` / `servePeerStore()` from `@noy-db/by-peer`\n * for an asymmetric tab-as-remote-store topology, or use the channel\n * directly to publish change events to every other tab.\n *\n * ## Threat model\n *\n * - `BroadcastChannel` is same-origin by browser policy — only documents\n *   served from the same scheme + host + port can subscribe.\n * - noy-db already encrypts at rest — every tab on the channel sees\n *   only AES-256-GCM ciphertext envelopes. The transport never decrypts.\n * - Untrusted tabs (e.g. third-party iframes that share an origin via\n *   `document.domain` legacy) can still see the channel. Treat\n *   BroadcastChannel as origin-scoped, not session-scoped.\n *\n * @packageDocumentation\n */\n\nimport type { PeerChannel } from '@noy-db/by-peer'\n\nexport type { PeerChannel }\n\nexport { tabsCoordination } from './coordination.js'\n\n/**\n * Options for `tabsChannel()`.\n */\nexport interface TabsChannelOptions {\n  /**\n   * BroadcastChannel name. Two tabs subscribed to the same name see\n   * each other's messages. Use a stable, vault-scoped string like\n   * `'noy-db:vault-acme'` to keep different vaults isolated.\n   */\n  readonly name: string\n}\n\n/**\n * Wrap a `BroadcastChannel` as a `PeerChannel`.\n *\n * Returns a no-op channel (always `isOpen: false`, no-op `send`) when\n * `BroadcastChannel` is undefined — so server-side rendering, Node\n * scripts, and older browsers can import the package without crashing\n * before they feature-detect.\n */\nexport function tabsChannel(options: TabsChannelOptions): PeerChannel {\n  const name = options.name\n  const Bc = (globalThis as { BroadcastChannel?: typeof BroadcastChannel }).BroadcastChannel\n  if (!Bc) return makeNoopChannel(name)\n\n  const bc = new Bc(name)\n  type Listeners = {\n    message: Set<(p: string) => void>\n    close: Set<() => void>\n  }\n  const listeners: Listeners = { message: new Set(), close: new Set() }\n  let closed = false\n\n  bc.addEventListener('message', (ev: MessageEvent) => {\n    if (typeof ev.data !== 'string') return\n    for (const fn of listeners.message) fn(ev.data)\n  })\n\n  function fireClose(): void {\n    if (closed) return\n    closed = true\n    for (const fn of listeners.close) fn()\n  }\n\n  return {\n    get isOpen() {\n      return !closed\n    },\n    send(payload: string) {\n      if (closed) throw new Error('PeerChannel closed')\n      bc.postMessage(payload)\n    },\n    on(event: 'message' | 'close', listener: ((payload: string) => void) | (() => void)): () => void {\n      if (event === 'message') {\n        listeners.message.add(listener as (p: string) => void)\n        return () => listeners.message.delete(listener as (p: string) => void)\n      }\n      listeners.close.add(listener as () => void)\n      return () => listeners.close.delete(listener as () => void)\n    },\n    close() {\n      if (closed) return\n      try {\n        bc.close()\n      } catch {\n        // ignore — channel already torn down\n      }\n      fireClose()\n    },\n  } as PeerChannel\n}\n\n/**\n * Whether `BroadcastChannel` is available in the current runtime. Use\n * this as a pre-flight before rendering UI that relies on tab-to-tab\n * sync — Node, SSR, and a handful of older browsers don't ship it.\n */\nexport function isTabsChannelAvailable(): boolean {\n  return typeof (globalThis as { BroadcastChannel?: unknown }).BroadcastChannel === 'function'\n}\n\n// ─── Internals ───────────────────────────────────────────────────────────\n\nfunction makeNoopChannel(name: string): PeerChannel {\n  void name\n  return {\n    isOpen: false,\n    send() {\n      throw new Error(\n        '[@noy-db/by-tabs] BroadcastChannel is not available in this runtime — use isTabsChannelAvailable() to feature-detect',\n      )\n    },\n    on(_event: 'message' | 'close', _listener: ((p: string) => void) | (() => void)): () => void {\n      return () => {}\n    },\n    close() {},\n  } as PeerChannel\n}\n"],"mappings":";AAsBA,SAAS,2BAA2B;AAc7B,SAAS,iBAAiB,SAA4C;AAC3E,SAAO,oBAAoB,OAAO;AACpC;;;ACaO,SAAS,YAAY,SAA0C;AACpE,QAAM,OAAO,QAAQ;AACrB,QAAM,KAAM,WAA8D;AAC1E,MAAI,CAAC,GAAI,QAAO,gBAAgB,IAAI;AAEpC,QAAM,KAAK,IAAI,GAAG,IAAI;AAKtB,QAAM,YAAuB,EAAE,SAAS,oBAAI,IAAI,GAAG,OAAO,oBAAI,IAAI,EAAE;AACpE,MAAI,SAAS;AAEb,KAAG,iBAAiB,WAAW,CAAC,OAAqB;AACnD,QAAI,OAAO,GAAG,SAAS,SAAU;AACjC,eAAW,MAAM,UAAU,QAAS,IAAG,GAAG,IAAI;AAAA,EAChD,CAAC;AAED,WAAS,YAAkB;AACzB,QAAI,OAAQ;AACZ,aAAS;AACT,eAAW,MAAM,UAAU,MAAO,IAAG;AAAA,EACvC;AAEA,SAAO;AAAA,IACL,IAAI,SAAS;AACX,aAAO,CAAC;AAAA,IACV;AAAA,IACA,KAAK,SAAiB;AACpB,UAAI,OAAQ,OAAM,IAAI,MAAM,oBAAoB;AAChD,SAAG,YAAY,OAAO;AAAA,IACxB;AAAA,IACA,GAAG,OAA4B,UAAkE;AAC/F,UAAI,UAAU,WAAW;AACvB,kBAAU,QAAQ,IAAI,QAA+B;AACrD,eAAO,MAAM,UAAU,QAAQ,OAAO,QAA+B;AAAA,MACvE;AACA,gBAAU,MAAM,IAAI,QAAsB;AAC1C,aAAO,MAAM,UAAU,MAAM,OAAO,QAAsB;AAAA,IAC5D;AAAA,IACA,QAAQ;AACN,UAAI,OAAQ;AACZ,UAAI;AACF,WAAG,MAAM;AAAA,MACX,QAAQ;AAAA,MAER;AACA,gBAAU;AAAA,IACZ;AAAA,EACF;AACF;AAOO,SAAS,yBAAkC;AAChD,SAAO,OAAQ,WAA8C,qBAAqB;AACpF;AAIA,SAAS,gBAAgB,MAA2B;AAClD,OAAK;AACL,SAAO;AAAA,IACL,QAAQ;AAAA,IACR,OAAO;AACL,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAAA,IACA,GAAG,QAA6B,WAA6D;AAC3F,aAAO,MAAM;AAAA,MAAC;AAAA,IAChB;AAAA,IACA,QAAQ;AAAA,IAAC;AAAA,EACX;AACF;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noy-db/by-tabs",
-  "version": "0.2.0-pre.8",
+  "version": "0.3.0-pre.1",
   "description": "BroadcastChannel multi-tab transport for noy-db — sync between tabs of the same browser without round-tripping the storage backend",
   "license": "MIT",
   "author": "vLannaAi <vicio@lanna.ai>",
@@ -17,17 +17,10 @@
   "sideEffects": false,
   "exports": {
     ".": {
-      "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
-      },
-      "require": {
-        "types": "./dist/index.d.cts",
-        "default": "./dist/index.cjs"
-      }
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
     }
   },
-  "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
@@ -36,16 +29,16 @@
     "LICENSE"
   ],
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=22.0.0"
   },
   "peerDependencies": {
-    "@noy-db/by-peer": "0.2.0-pre.8",
-    "@noy-db/hub": "0.2.0-pre.8"
+    "@noy-db/by-peer": "0.3.0-pre.1",
+    "@noy-db/hub": "0.3.0-pre.1"
   },
   "devDependencies": {
-    "@noy-db/by-peer": "0.2.0-pre.8",
-    "@noy-db/hub": "0.2.0-pre.8",
-    "@noy-db/to-memory": "0.2.0-pre.8"
+    "@noy-db/by-peer": "0.3.0-pre.1",
+    "@noy-db/hub": "0.3.0-pre.1",
+    "@noy-db/to-memory": "0.3.0-pre.1"
   },
   "keywords": [
     "noy-db",

package/dist/index.cjs

@@ -1,94 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  isTabsChannelAvailable: () => isTabsChannelAvailable,
-  tabsChannel: () => tabsChannel
-});
-module.exports = __toCommonJS(index_exports);
-function tabsChannel(options) {
-  const name = options.name;
-  const Bc = globalThis.BroadcastChannel;
-  if (!Bc) return makeNoopChannel(name);
-  const bc = new Bc(name);
-  const listeners = { message: /* @__PURE__ */ new Set(), close: /* @__PURE__ */ new Set() };
-  let closed = false;
-  bc.addEventListener("message", (ev) => {
-    if (typeof ev.data !== "string") return;
-    for (const fn of listeners.message) fn(ev.data);
-  });
-  function fireClose() {
-    if (closed) return;
-    closed = true;
-    for (const fn of listeners.close) fn();
-  }
-  return {
-    get isOpen() {
-      return !closed;
-    },
-    send(payload) {
-      if (closed) throw new Error("PeerChannel closed");
-      bc.postMessage(payload);
-    },
-    on(event, listener) {
-      if (event === "message") {
-        listeners.message.add(listener);
-        return () => listeners.message.delete(listener);
-      }
-      listeners.close.add(listener);
-      return () => listeners.close.delete(listener);
-    },
-    close() {
-      if (closed) return;
-      try {
-        bc.close();
-      } catch {
-      }
-      fireClose();
-    }
-  };
-}
-function isTabsChannelAvailable() {
-  return typeof globalThis.BroadcastChannel === "function";
-}
-function makeNoopChannel(name) {
-  void name;
-  return {
-    isOpen: false,
-    send() {
-      throw new Error(
-        "[@noy-db/by-tabs] BroadcastChannel is not available in this runtime \u2014 use isTabsChannelAvailable() to feature-detect"
-      );
-    },
-    on(_event, _listener) {
-      return () => {
-      };
-    },
-    close() {
-    }
-  };
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  isTabsChannelAvailable,
-  tabsChannel
-});
-//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * **@noy-db/by-tabs** — BroadcastChannel multi-tab transport for noy-db.\n *\n * Wraps the browser `BroadcastChannel` API as a `PeerChannel`, the\n * primitive every `by-*` transport implements. Sub-millisecond fan-out\n * across tabs of the same origin; same code shape as `@noy-db/by-peer`,\n * just a different wire.\n *\n * Compose with `peerStore()` / `servePeerStore()` from `@noy-db/by-peer`\n * for an asymmetric tab-as-remote-store topology, or use the channel\n * directly to publish change events to every other tab.\n *\n * ## Threat model\n *\n * - `BroadcastChannel` is same-origin by browser policy — only documents\n *   served from the same scheme + host + port can subscribe.\n * - noy-db already encrypts at rest — every tab on the channel sees\n *   only AES-256-GCM ciphertext envelopes. The transport never decrypts.\n * - Untrusted tabs (e.g. third-party iframes that share an origin via\n *   `document.domain` legacy) can still see the channel. Treat\n *   BroadcastChannel as origin-scoped, not session-scoped.\n *\n * @packageDocumentation\n */\n\nimport type { PeerChannel } from '@noy-db/by-peer'\n\nexport type { PeerChannel }\n\n/**\n * Options for `tabsChannel()`.\n */\nexport interface TabsChannelOptions {\n  /**\n   * BroadcastChannel name. Two tabs subscribed to the same name see\n   * each other's messages. Use a stable, vault-scoped string like\n   * `'noy-db:vault-acme'` to keep different vaults isolated.\n   */\n  readonly name: string\n}\n\n/**\n * Wrap a `BroadcastChannel` as a `PeerChannel`.\n *\n * Returns a no-op channel (always `isOpen: false`, no-op `send`) when\n * `BroadcastChannel` is undefined — so server-side rendering, Node\n * scripts, and older browsers can import the package without crashing\n * before they feature-detect.\n */\nexport function tabsChannel(options: TabsChannelOptions): PeerChannel {\n  const name = options.name\n  const Bc = (globalThis as { BroadcastChannel?: typeof BroadcastChannel }).BroadcastChannel\n  if (!Bc) return makeNoopChannel(name)\n\n  const bc = new Bc(name)\n  type Listeners = {\n    message: Set<(p: string) => void>\n    close: Set<() => void>\n  }\n  const listeners: Listeners = { message: new Set(), close: new Set() }\n  let closed = false\n\n  bc.addEventListener('message', (ev: MessageEvent) => {\n    if (typeof ev.data !== 'string') return\n    for (const fn of listeners.message) fn(ev.data)\n  })\n\n  function fireClose(): void {\n    if (closed) return\n    closed = true\n    for (const fn of listeners.close) fn()\n  }\n\n  return {\n    get isOpen() {\n      return !closed\n    },\n    send(payload: string) {\n      if (closed) throw new Error('PeerChannel closed')\n      bc.postMessage(payload)\n    },\n    on(event: 'message' | 'close', listener: ((payload: string) => void) | (() => void)): () => void {\n      if (event === 'message') {\n        listeners.message.add(listener as (p: string) => void)\n        return () => listeners.message.delete(listener as (p: string) => void)\n      }\n      listeners.close.add(listener as () => void)\n      return () => listeners.close.delete(listener as () => void)\n    },\n    close() {\n      if (closed) return\n      try {\n        bc.close()\n      } catch {\n        // ignore — channel already torn down\n      }\n      fireClose()\n    },\n  } as PeerChannel\n}\n\n/**\n * Whether `BroadcastChannel` is available in the current runtime. Use\n * this as a pre-flight before rendering UI that relies on tab-to-tab\n * sync — Node, SSR, and a handful of older browsers don't ship it.\n */\nexport function isTabsChannelAvailable(): boolean {\n  return typeof (globalThis as { BroadcastChannel?: unknown }).BroadcastChannel === 'function'\n}\n\n// ─── Internals ───────────────────────────────────────────────────────────\n\nfunction makeNoopChannel(name: string): PeerChannel {\n  void name\n  return {\n    isOpen: false,\n    send() {\n      throw new Error(\n        '[@noy-db/by-tabs] BroadcastChannel is not available in this runtime — use isTabsChannelAvailable() to feature-detect',\n      )\n    },\n    on(_event: 'message' | 'close', _listener: ((p: string) => void) | (() => void)): () => void {\n      return () => {}\n    },\n    close() {},\n  } as PeerChannel\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAiDO,SAAS,YAAY,SAA0C;AACpE,QAAM,OAAO,QAAQ;AACrB,QAAM,KAAM,WAA8D;AAC1E,MAAI,CAAC,GAAI,QAAO,gBAAgB,IAAI;AAEpC,QAAM,KAAK,IAAI,GAAG,IAAI;AAKtB,QAAM,YAAuB,EAAE,SAAS,oBAAI,IAAI,GAAG,OAAO,oBAAI,IAAI,EAAE;AACpE,MAAI,SAAS;AAEb,KAAG,iBAAiB,WAAW,CAAC,OAAqB;AACnD,QAAI,OAAO,GAAG,SAAS,SAAU;AACjC,eAAW,MAAM,UAAU,QAAS,IAAG,GAAG,IAAI;AAAA,EAChD,CAAC;AAED,WAAS,YAAkB;AACzB,QAAI,OAAQ;AACZ,aAAS;AACT,eAAW,MAAM,UAAU,MAAO,IAAG;AAAA,EACvC;AAEA,SAAO;AAAA,IACL,IAAI,SAAS;AACX,aAAO,CAAC;AAAA,IACV;AAAA,IACA,KAAK,SAAiB;AACpB,UAAI,OAAQ,OAAM,IAAI,MAAM,oBAAoB;AAChD,SAAG,YAAY,OAAO;AAAA,IACxB;AAAA,IACA,GAAG,OAA4B,UAAkE;AAC/F,UAAI,UAAU,WAAW;AACvB,kBAAU,QAAQ,IAAI,QAA+B;AACrD,eAAO,MAAM,UAAU,QAAQ,OAAO,QAA+B;AAAA,MACvE;AACA,gBAAU,MAAM,IAAI,QAAsB;AAC1C,aAAO,MAAM,UAAU,MAAM,OAAO,QAAsB;AAAA,IAC5D;AAAA,IACA,QAAQ;AACN,UAAI,OAAQ;AACZ,UAAI;AACF,WAAG,MAAM;AAAA,MACX,QAAQ;AAAA,MAER;AACA,gBAAU;AAAA,IACZ;AAAA,EACF;AACF;AAOO,SAAS,yBAAkC;AAChD,SAAO,OAAQ,WAA8C,qBAAqB;AACpF;AAIA,SAAS,gBAAgB,MAA2B;AAClD,OAAK;AACL,SAAO;AAAA,IACL,QAAQ;AAAA,IACR,OAAO;AACL,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAAA,IACA,GAAG,QAA6B,WAA6D;AAC3F,aAAO,MAAM;AAAA,MAAC;AAAA,IAChB;AAAA,IACA,QAAQ;AAAA,IAAC;AAAA,EACX;AACF;","names":[]}

package/dist/index.d.cts

@@ -1,56 +0,0 @@
-import { PeerChannel } from '@noy-db/by-peer';
-export { PeerChannel } from '@noy-db/by-peer';
-
-/**
- * **@noy-db/by-tabs** — BroadcastChannel multi-tab transport for noy-db.
- *
- * Wraps the browser `BroadcastChannel` API as a `PeerChannel`, the
- * primitive every `by-*` transport implements. Sub-millisecond fan-out
- * across tabs of the same origin; same code shape as `@noy-db/by-peer`,
- * just a different wire.
- *
- * Compose with `peerStore()` / `servePeerStore()` from `@noy-db/by-peer`
- * for an asymmetric tab-as-remote-store topology, or use the channel
- * directly to publish change events to every other tab.
- *
- * ## Threat model
- *
- * - `BroadcastChannel` is same-origin by browser policy — only documents
- *   served from the same scheme + host + port can subscribe.
- * - noy-db already encrypts at rest — every tab on the channel sees
- *   only AES-256-GCM ciphertext envelopes. The transport never decrypts.
- * - Untrusted tabs (e.g. third-party iframes that share an origin via
- *   `document.domain` legacy) can still see the channel. Treat
- *   BroadcastChannel as origin-scoped, not session-scoped.
- *
- * @packageDocumentation
- */
-
-/**
- * Options for `tabsChannel()`.
- */
-interface TabsChannelOptions {
-    /**
-     * BroadcastChannel name. Two tabs subscribed to the same name see
-     * each other's messages. Use a stable, vault-scoped string like
-     * `'noy-db:vault-acme'` to keep different vaults isolated.
-     */
-    readonly name: string;
-}
-/**
- * Wrap a `BroadcastChannel` as a `PeerChannel`.
- *
- * Returns a no-op channel (always `isOpen: false`, no-op `send`) when
- * `BroadcastChannel` is undefined — so server-side rendering, Node
- * scripts, and older browsers can import the package without crashing
- * before they feature-detect.
- */
-declare function tabsChannel(options: TabsChannelOptions): PeerChannel;
-/**
- * Whether `BroadcastChannel` is available in the current runtime. Use
- * this as a pre-flight before rendering UI that relies on tab-to-tab
- * sync — Node, SSR, and a handful of older browsers don't ship it.
- */
-declare function isTabsChannelAvailable(): boolean;
-
-export { type TabsChannelOptions, isTabsChannelAvailable, tabsChannel };