@noy-db/by-tabs 0.2.0-pre.26 → 0.2.0-pre.28

package/dist/index.cjs

@@ -21,9 +21,18 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   isTabsChannelAvailable: () => isTabsChannelAvailable,
-  tabsChannel: () => tabsChannel
+  tabsChannel: () => tabsChannel,
+  tabsCoordination: () => tabsCoordination
 });
 module.exports = __toCommonJS(index_exports);
+
+// src/coordination.ts
+var import_by_peer = require("@noy-db/by-peer");
+function tabsCoordination(channel) {
+  return (0, import_by_peer.channelCoordination)(channel);
+}
+
+// src/index.ts
 function tabsChannel(options) {
   const name = options.name;
   const Bc = globalThis.BroadcastChannel;
@@ -89,6 +98,7 @@ function makeNoopChannel(name) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   isTabsChannelAvailable,
-  tabsChannel
+  tabsChannel,
+  tabsCoordination
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.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":";;;;;;;;;;;;;;;;;;;;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":[]}
+{"version":3,"sources":["../src/index.ts","../src/coordination.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\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","/**\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"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACsBA,qBAAoC;AAc7B,SAAS,iBAAiB,SAA4C;AAC3E,aAAO,oCAAoB,OAAO;AACpC;;;ADaO,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,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.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.26",
+  "version": "0.2.0-pre.28",
   "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>",
@@ -39,13 +39,13 @@
     "node": ">=18.0.0"
   },
   "peerDependencies": {
-    "@noy-db/by-peer": "0.2.0-pre.26",
-    "@noy-db/hub": "0.2.0-pre.26"
+    "@noy-db/by-peer": "0.2.0-pre.28",
+    "@noy-db/hub": "0.2.0-pre.28"
   },
   "devDependencies": {
-    "@noy-db/by-peer": "0.2.0-pre.26",
-    "@noy-db/hub": "0.2.0-pre.26",
-    "@noy-db/to-memory": "0.2.0-pre.26"
+    "@noy-db/by-peer": "0.2.0-pre.28",
+    "@noy-db/to-memory": "0.2.0-pre.28",
+    "@noy-db/hub": "0.2.0-pre.28"
   },
   "keywords": [
     "noy-db",