@use-everywhere/core 0.4.1 → 0.5.0

package/dist/index.cjs

@@ -55,7 +55,13 @@ function emitBusEvent(name, direction, wire) {
   const set = observers.get(name);
   if (!set) return;
   const event = { name, direction, wire };
-  for (const fn of set) fn(event);
+  for (const fn of set) {
+    try {
+      fn(event);
+    } catch (error) {
+      console.error(`[use-everywhere] a bus observer for "${name}" threw`, error);
+    }
+  }
 }
 function observeBus(name, fn) {
   let set = observers.get(name);
@@ -80,12 +86,41 @@ function enableDebug(options = {}) {
   });
 }
 
+// src/dev.ts
+var inDev = false;
+try {
+  inDev = process.env.NODE_ENV !== "production";
+} catch {
+}
+var warned = /* @__PURE__ */ new Set();
+function devWarn(message) {
+  if (!inDev || warned.has(message)) return;
+  warned.add(message);
+  console.warn(message);
+}
+
 // src/ids.ts
+function randomHex(bytes) {
+  const crypto = globalThis.crypto;
+  if (crypto?.getRandomValues) {
+    const buf = crypto.getRandomValues(new Uint8Array(bytes));
+    let out2 = "";
+    for (const b of buf) out2 += b.toString(16).padStart(2, "0");
+    return out2;
+  }
+  devWarn(
+    "[use-everywhere] crypto.getRandomValues is unavailable; falling back to Math.random for ids. Cross-origin window nonces are not cryptographically strong in this environment."
+  );
+  let out = "";
+  while (out.length < bytes * 2)
+    out += Math.floor(Math.random() * 256).toString(16).padStart(2, "0");
+  return out;
+}
 function newClientId() {
-  return Math.random().toString(36).slice(2, 8);
+  return randomHex(8);
 }
 function newMsgId() {
-  return Math.random().toString(36).slice(2, 10);
+  return randomHex(16);
 }
 
 // src/transport/broadcast-channel-transport.ts
@@ -165,12 +200,20 @@ function createBus(name, options, onShutdown) {
     options.heartbeatMs ?? 2e3
   );
   const sayBye = () => post({ v: 1, scope: "presence", type: "bye", clientId, kind });
+  const onPageShow = (event) => {
+    if (!event.persisted) return;
+    post({ v: 1, scope: "presence", type: "hello", clientId, kind });
+  };
   const hasWindow = typeof document !== "undefined" && typeof addEventListener === "function";
-  if (hasWindow) addEventListener("pagehide", sayBye);
+  if (hasWindow) {
+    addEventListener("pagehide", sayBye);
+    addEventListener("pageshow", onPageShow);
+  }
   return {
     name,
     clientId,
     kind,
+    heartbeatMs: options.heartbeatMs ?? 2e3,
     post,
     subscribe(fn) {
       listeners.add(fn);
@@ -180,12 +223,16 @@ function createBus(name, options, onShutdown) {
       refs++;
     },
     release() {
+      if (closed) return;
       refs--;
       if (refs > 0) return;
       sayBye();
       closed = true;
       clearInterval(heartbeat);
-      if (hasWindow) removeEventListener("pagehide", sayBye);
+      if (hasWindow) {
+        removeEventListener("pagehide", sayBye);
+        removeEventListener("pageshow", onPageShow);
+      }
       unsubscribe();
       transport.close();
       listeners.clear();
@@ -207,6 +254,15 @@ function getBus(name, options = {}) {
   if (!bus) {
     bus = createBus(name, options, () => registry.delete(name));
     registry.set(name, bus);
+  } else {
+    if (options.heartbeatMs !== void 0 && options.heartbeatMs !== bus.heartbeatMs) {
+      devWarn(
+        `[use-everywhere] bus "${name}": heartbeatMs ignored \u2014 the first creator fixes bus options`
+      );
+    }
+    if (options.kind !== void 0 && options.kind !== bus.kind) {
+      devWarn(`[use-everywhere] bus "${name}": kind ignored \u2014 the first creator fixes bus options`);
+    }
   }
   bus.acquire();
   return bus;
@@ -223,6 +279,7 @@ function createChannel(name, options = {}) {
     const meta = { clientId: wire.clientId, kind: wire.kind, self: false };
     for (const fn of set) fn(wire.payload, meta);
   });
+  let closed = false;
   return {
     name,
     clientId: bus.clientId,
@@ -247,6 +304,8 @@ function createChannel(name, options = {}) {
       return () => set.delete(handler);
     },
     close() {
+      if (closed) return;
+      closed = true;
       unsubscribe();
       handlers.clear();
       bus.release();
@@ -260,25 +319,48 @@ function newer(a, b) {
 }
 
 // src/dev-freeze.ts
-var inDev = false;
+var inDev2 = false;
 try {
-  inDev = process.env.NODE_ENV !== "production";
+  inDev2 = process.env.NODE_ENV !== "production";
 } catch {
 }
 function deepFreeze(value) {
   if (value === null || typeof value !== "object" || Object.isFrozen(value)) return;
+  if (ArrayBuffer.isView(value)) return;
   Object.freeze(value);
+  if (value instanceof Map) {
+    for (const [k, v] of value) {
+      deepFreeze(k);
+      deepFreeze(v);
+    }
+    return;
+  }
+  if (value instanceof Set) {
+    for (const entry of value) deepFreeze(entry);
+    return;
+  }
   for (const key of Object.keys(value)) {
     deepFreeze(value[key]);
   }
 }
 function freezeShared(value) {
-  if (inDev) deepFreeze(value);
+  if (inDev2) deepFreeze(value);
   return value;
 }
 
 // src/shared-store.ts
+var liveStores = /* @__PURE__ */ new Map();
 function createSharedStore(name, initial, options = {}) {
+  const onSharedBus = !options.transport;
+  if (onSharedBus) {
+    const live = liveStores.get(name) ?? 0;
+    if (live > 0) {
+      devWarn(
+        `[use-everywhere] second shared store for "${name}" in this tab \u2014 stores on one page never hear each other and will diverge. Reuse one per name.`
+      );
+    }
+    liveStores.set(name, live + 1);
+  }
   const bus = getBus(name, options);
   const clientId = bus.clientId;
   const accept = options.accept;
@@ -332,18 +414,25 @@ function createSharedStore(name, initial, options = {}) {
   });
   function setKey(key, value) {
     const version = [(versions[key]?.[0] ?? 0) + 1, clientId];
+    try {
+      bus.post({
+        v: 1,
+        scope: "state",
+        type: "patch",
+        key,
+        value,
+        version,
+        clientId,
+        kind: bus.kind
+      });
+    } catch (error) {
+      throw new TypeError(
+        `use-everywhere: the value for key "${key}" cannot cross the wire (structured clone failed); the write was not applied. ${String(error)}`,
+        { cause: error }
+      );
+    }
     versions[key] = version;
     state[key] = freezeShared(value);
-    bus.post({
-      v: 1,
-      scope: "state",
-      type: "patch",
-      key,
-      value,
-      version,
-      clientId,
-      kind: bus.kind
-    });
     notify(key, value, { clientId, kind: bus.kind, self: true });
   }
   const proxy = new Proxy(state, {
@@ -406,7 +495,15 @@ function createSharedStore(name, initial, options = {}) {
       addEventListener("pagehide", flushPersist);
     }
   }
-  bus.post({ v: 1, scope: "state", type: "hello", clientId, kind: bus.kind });
+  const sayHello = () => bus.post({ v: 1, scope: "state", type: "hello", clientId, kind: bus.kind });
+  const onPageShow = (event) => {
+    if (!event.persisted) return;
+    sayHello();
+  };
+  const hasWindow = typeof document !== "undefined" && typeof addEventListener === "function";
+  if (hasWindow) addEventListener("pageshow", onPageShow);
+  sayHello();
+  let storeClosed = false;
   return {
     clientId,
     state: proxy,
@@ -427,16 +524,27 @@ function createSharedStore(name, initial, options = {}) {
         keyListeners.set(key, set);
       }
       set.add(fn);
-      return () => set.delete(fn);
+      return () => {
+        set.delete(fn);
+        if (set.size === 0) keyListeners.delete(key);
+      };
     },
     registerKey(key, initialValue) {
       if (key in versions) return;
       versions[key] = [0, clientId];
-      state[key] = initialValue;
+      state[key] = freezeShared(initialValue);
       snapshot = Object.freeze({ ...state });
       versionsSnapshot = Object.freeze({ ...versions });
     },
     close() {
+      if (storeClosed) return;
+      storeClosed = true;
+      if (onSharedBus) {
+        const live = (liveStores.get(name) ?? 1) - 1;
+        if (live > 0) liveStores.set(name, live);
+        else liveStores.delete(name);
+      }
+      if (hasWindow) removeEventListener("pageshow", onPageShow);
       if (flushPersist) {
         flushPersist();
         if (typeof document !== "undefined" && typeof removeEventListener === "function") {
@@ -485,6 +593,7 @@ function createPresence(name, options = {}) {
     },
     Math.max(500, Math.floor(pruneAfterMs / 2))
   );
+  let closed = false;
   return {
     clientId: bus.clientId,
     getPeers: () => snapshot,
@@ -493,6 +602,8 @@ function createPresence(name, options = {}) {
       return () => listeners.delete(fn);
     },
     close() {
+      if (closed) return;
+      closed = true;
       clearInterval(prune);
       unsubscribe();
       listeners.clear();
@@ -581,10 +692,19 @@ function createLeader(name, options = {}) {
     bus.post({ v: 1, scope: "leader", type: "resign", term: resigning, clientId, kind: bus.kind });
     armLease(leaseMs);
   }
+  const sayHello = () => bus.post({ v: 1, scope: "leader", type: "hello", clientId, kind: bus.kind });
   const hasWindow = typeof document !== "undefined" && typeof addEventListener === "function";
   const onPageHide = () => resign();
-  if (hasWindow) addEventListener("pagehide", onPageHide);
-  bus.post({ v: 1, scope: "leader", type: "hello", clientId, kind: bus.kind });
+  const onPageShow = (event) => {
+    if (!event.persisted) return;
+    sayHello();
+    armLease(heartbeatMs);
+  };
+  if (hasWindow) {
+    addEventListener("pagehide", onPageHide);
+    addEventListener("pageshow", onPageShow);
+  }
+  sayHello();
   armLease(heartbeatMs);
   return {
     clientId,
@@ -604,11 +724,15 @@ function createLeader(name, options = {}) {
       if (leaderId === null) armLease(0);
     },
     close() {
+      if (closed) return;
       closed = true;
       resign();
       clearInterval(beat);
       clearTimeout(lease);
-      if (hasWindow) removeEventListener("pagehide", onPageHide);
+      if (hasWindow) {
+        removeEventListener("pagehide", onPageHide);
+        removeEventListener("pageshow", onPageShow);
+      }
       unsubscribe();
       listeners.clear();
       bus.release();
@@ -622,44 +746,54 @@ function isPersisted(value) {
   const candidate = value;
   return candidate.v === 1 && typeof candidate.state === "object" && typeof candidate.versions === "object";
 }
-function webStorageAdapter(storage, key) {
-  const resolve = () => {
+function webStorageAdapter(storage, key, options = {}) {
+  const report = (error, operation) => {
     try {
-      return typeof storage === "function" ? storage() : storage;
+      options.onError?.(error, operation);
     } catch {
+    }
+  };
+  const resolve = (operation) => {
+    try {
+      return typeof storage === "function" ? storage() : storage;
+    } catch (error) {
+      report(error, operation);
       return void 0;
     }
   };
   return {
     read() {
       try {
-        const raw = resolve()?.getItem(key);
+        const raw = resolve("read")?.getItem(key);
         if (!raw) return void 0;
         const parsed = JSON.parse(raw);
         return isPersisted(parsed) ? parsed : void 0;
-      } catch {
+      } catch (error) {
+        report(error, "read");
         return void 0;
       }
     },
     write(snapshot) {
       try {
-        resolve()?.setItem(key, JSON.stringify(snapshot));
-      } catch {
+        resolve("write")?.setItem(key, JSON.stringify(snapshot));
+      } catch (error) {
+        report(error, "write");
       }
     },
     remove() {
       try {
-        resolve()?.removeItem(key);
-      } catch {
+        resolve("remove")?.removeItem(key);
+      } catch (error) {
+        report(error, "remove");
       }
     }
   };
 }
-function localStorageAdapter(key) {
-  return webStorageAdapter(() => globalThis.localStorage, key);
+function localStorageAdapter(key, options) {
+  return webStorageAdapter(() => globalThis.localStorage, key, options);
 }
-function sessionStorageAdapter(key) {
-  return webStorageAdapter(() => globalThis.sessionStorage, key);
+function sessionStorageAdapter(key, options) {
+  return webStorageAdapter(() => globalThis.sessionStorage, key, options);
 }
 
 // src/errors/handshake-timeout-error.ts
@@ -786,6 +920,7 @@ function openWindow(url, options) {
   }, 400);
   const readyTimer = setTimeout(() => {
     if (isReady || closedSettled) return;
+    localWindow.removeEventListener("message", onMessage);
     const err = new HandshakeTimeoutError();
     rejectReady(err);
     if (!resultSettled) {
@@ -839,6 +974,7 @@ function connectToOpener(options) {
   markHandled(ready);
   const onMessage = (event) => {
     if (!allowAnyOrigin && event.origin !== peerOrigin) return;
+    if (event.source !== opener) return;
     if (!isWindowWire(event.data, cid)) return;
     const wire = event.data;
     if (wire.t === "ready-ack") {
@@ -934,9 +1070,11 @@ var MemoryHub = class {
   }
   /** @internal */
   broadcast(from, data) {
+    structuredClone(data);
     for (const transport of this.transports) {
       if (transport !== from) {
-        queueMicrotask(() => transport.deliver(data));
+        const copy = structuredClone(data);
+        queueMicrotask(() => transport.deliver(copy));
       }
     }
   }

package/dist/index.d.cts

@@ -230,6 +230,15 @@ interface Leader {
 declare function createLeader(name: string, options?: LeaderOptions): Leader;
 
 type StorageLike = Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>;
+interface WebStorageAdapterOptions {
+    /**
+     * Called when a storage operation fails: blocked storage, corrupt JSON, a
+     * full quota. Persistence stays best-effort either way — this is the
+     * observability seam (telemetry, a "your changes may not be saved" notice),
+     * not a recovery path. Errors thrown by the callback itself are swallowed.
+     */
+    onError?: (error: unknown, operation: 'read' | 'write' | 'remove') => void;
+}
 /**
  * Persist to any Storage-shaped thing.
  *
@@ -240,13 +249,14 @@ type StorageLike = Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>;
  * Behind a thunk, every access happens inside one.
  *
  * Blocked storage, corrupt JSON, a foreign schema, or a full quota all degrade
- * to a silent no-op. Persistence is best-effort; it must never break the store.
+ * to a silent no-op — persistence is best-effort; it must never break the
+ * store. Pass `onError` to observe the failures anyway.
  */
-declare function webStorageAdapter(storage: StorageLike | (() => StorageLike | undefined), key: string): PersistAdapter;
+declare function webStorageAdapter(storage: StorageLike | (() => StorageLike | undefined), key: string, options?: WebStorageAdapterOptions): PersistAdapter;
 /** Survives closing every tab. */
-declare function localStorageAdapter(key: string): PersistAdapter;
+declare function localStorageAdapter(key: string, options?: WebStorageAdapterOptions): PersistAdapter;
 /** Survives reloads, but dies with the tab. */
-declare function sessionStorageAdapter(key: string): PersistAdapter;
+declare function sessionStorageAdapter(key: string, options?: WebStorageAdapterOptions): PersistAdapter;
 
 interface MessageEventLike {
     data: unknown;
@@ -442,4 +452,4 @@ declare class MemoryHub {
     disconnect(transport: MemoryTransport): void;
 }
 
-export { BroadcastChannelTransport, type BusEvent, type BusObserver, type BusWire, CID_PARAM, type Channel, type CommonOptions, type ConnectToOpenerOptions, DEFAULT_NAME, type DebugOptions, HandshakeTimeoutError, type Leader, type LeaderOptions, type LeaderSnapshot, MemoryHub, MemoryTransport, type MessageEventLike, type MessageMap, type MessageMeta, NoopTransport, type OpenWindowOptions, type OpenedWindow, type OpenerConnection, type Peer, type PeerKind, type PersistAdapter, type PersistOptions, type Persisted, type Presence, type PresenceOptions, type SharedStore, type SharedStoreOptions, type StorageLike, type Transport, type Version, WindowClosedError, type WindowEventTarget, type WindowLike, connectToOpener, createChannel, createLeader, createPresence, createSharedStore, defaultTransport, enableDebug, getBusNames, isBroadcastChannelAvailable, localStorageAdapter, newer, observeBus, openWindow, sessionStorageAdapter, webStorageAdapter };
+export { BroadcastChannelTransport, type BusEvent, type BusObserver, type BusWire, CID_PARAM, type Channel, type CommonOptions, type ConnectToOpenerOptions, DEFAULT_NAME, type DebugOptions, HandshakeTimeoutError, type Leader, type LeaderOptions, type LeaderSnapshot, MemoryHub, MemoryTransport, type MessageEventLike, type MessageMap, type MessageMeta, NoopTransport, type OpenWindowOptions, type OpenedWindow, type OpenerConnection, type Peer, type PeerKind, type PersistAdapter, type PersistOptions, type Persisted, type Presence, type PresenceOptions, type SharedStore, type SharedStoreOptions, type StorageLike, type Transport, type Version, type WebStorageAdapterOptions, WindowClosedError, type WindowEventTarget, type WindowLike, connectToOpener, createChannel, createLeader, createPresence, createSharedStore, defaultTransport, enableDebug, getBusNames, isBroadcastChannelAvailable, localStorageAdapter, newer, observeBus, openWindow, sessionStorageAdapter, webStorageAdapter };

package/dist/index.d.ts

@@ -230,6 +230,15 @@ interface Leader {
 declare function createLeader(name: string, options?: LeaderOptions): Leader;
 
 type StorageLike = Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>;
+interface WebStorageAdapterOptions {
+    /**
+     * Called when a storage operation fails: blocked storage, corrupt JSON, a
+     * full quota. Persistence stays best-effort either way — this is the
+     * observability seam (telemetry, a "your changes may not be saved" notice),
+     * not a recovery path. Errors thrown by the callback itself are swallowed.
+     */
+    onError?: (error: unknown, operation: 'read' | 'write' | 'remove') => void;
+}
 /**
  * Persist to any Storage-shaped thing.
  *
@@ -240,13 +249,14 @@ type StorageLike = Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>;
  * Behind a thunk, every access happens inside one.
  *
  * Blocked storage, corrupt JSON, a foreign schema, or a full quota all degrade
- * to a silent no-op. Persistence is best-effort; it must never break the store.
+ * to a silent no-op — persistence is best-effort; it must never break the
+ * store. Pass `onError` to observe the failures anyway.
  */
-declare function webStorageAdapter(storage: StorageLike | (() => StorageLike | undefined), key: string): PersistAdapter;
+declare function webStorageAdapter(storage: StorageLike | (() => StorageLike | undefined), key: string, options?: WebStorageAdapterOptions): PersistAdapter;
 /** Survives closing every tab. */
-declare function localStorageAdapter(key: string): PersistAdapter;
+declare function localStorageAdapter(key: string, options?: WebStorageAdapterOptions): PersistAdapter;
 /** Survives reloads, but dies with the tab. */
-declare function sessionStorageAdapter(key: string): PersistAdapter;
+declare function sessionStorageAdapter(key: string, options?: WebStorageAdapterOptions): PersistAdapter;
 
 interface MessageEventLike {
     data: unknown;
@@ -442,4 +452,4 @@ declare class MemoryHub {
     disconnect(transport: MemoryTransport): void;
 }
 
-export { BroadcastChannelTransport, type BusEvent, type BusObserver, type BusWire, CID_PARAM, type Channel, type CommonOptions, type ConnectToOpenerOptions, DEFAULT_NAME, type DebugOptions, HandshakeTimeoutError, type Leader, type LeaderOptions, type LeaderSnapshot, MemoryHub, MemoryTransport, type MessageEventLike, type MessageMap, type MessageMeta, NoopTransport, type OpenWindowOptions, type OpenedWindow, type OpenerConnection, type Peer, type PeerKind, type PersistAdapter, type PersistOptions, type Persisted, type Presence, type PresenceOptions, type SharedStore, type SharedStoreOptions, type StorageLike, type Transport, type Version, WindowClosedError, type WindowEventTarget, type WindowLike, connectToOpener, createChannel, createLeader, createPresence, createSharedStore, defaultTransport, enableDebug, getBusNames, isBroadcastChannelAvailable, localStorageAdapter, newer, observeBus, openWindow, sessionStorageAdapter, webStorageAdapter };
+export { BroadcastChannelTransport, type BusEvent, type BusObserver, type BusWire, CID_PARAM, type Channel, type CommonOptions, type ConnectToOpenerOptions, DEFAULT_NAME, type DebugOptions, HandshakeTimeoutError, type Leader, type LeaderOptions, type LeaderSnapshot, MemoryHub, MemoryTransport, type MessageEventLike, type MessageMap, type MessageMeta, NoopTransport, type OpenWindowOptions, type OpenedWindow, type OpenerConnection, type Peer, type PeerKind, type PersistAdapter, type PersistOptions, type Persisted, type Presence, type PresenceOptions, type SharedStore, type SharedStoreOptions, type StorageLike, type Transport, type Version, type WebStorageAdapterOptions, WindowClosedError, type WindowEventTarget, type WindowLike, connectToOpener, createChannel, createLeader, createPresence, createSharedStore, defaultTransport, enableDebug, getBusNames, isBroadcastChannelAvailable, localStorageAdapter, newer, observeBus, openWindow, sessionStorageAdapter, webStorageAdapter };

package/dist/index.js

@@ -7,7 +7,13 @@ function emitBusEvent(name, direction, wire) {
   const set = observers.get(name);
   if (!set) return;
   const event = { name, direction, wire };
-  for (const fn of set) fn(event);
+  for (const fn of set) {
+    try {
+      fn(event);
+    } catch (error) {
+      console.error(`[use-everywhere] a bus observer for "${name}" threw`, error);
+    }
+  }
 }
 function observeBus(name, fn) {
   let set = observers.get(name);
@@ -32,12 +38,41 @@ function enableDebug(options = {}) {
   });
 }
 
+// src/dev.ts
+var inDev = false;
+try {
+  inDev = process.env.NODE_ENV !== "production";
+} catch {
+}
+var warned = /* @__PURE__ */ new Set();
+function devWarn(message) {
+  if (!inDev || warned.has(message)) return;
+  warned.add(message);
+  console.warn(message);
+}
+
 // src/ids.ts
+function randomHex(bytes) {
+  const crypto = globalThis.crypto;
+  if (crypto?.getRandomValues) {
+    const buf = crypto.getRandomValues(new Uint8Array(bytes));
+    let out2 = "";
+    for (const b of buf) out2 += b.toString(16).padStart(2, "0");
+    return out2;
+  }
+  devWarn(
+    "[use-everywhere] crypto.getRandomValues is unavailable; falling back to Math.random for ids. Cross-origin window nonces are not cryptographically strong in this environment."
+  );
+  let out = "";
+  while (out.length < bytes * 2)
+    out += Math.floor(Math.random() * 256).toString(16).padStart(2, "0");
+  return out;
+}
 function newClientId() {
-  return Math.random().toString(36).slice(2, 8);
+  return randomHex(8);
 }
 function newMsgId() {
-  return Math.random().toString(36).slice(2, 10);
+  return randomHex(16);
 }
 
 // src/transport/broadcast-channel-transport.ts
@@ -117,12 +152,20 @@ function createBus(name, options, onShutdown) {
     options.heartbeatMs ?? 2e3
   );
   const sayBye = () => post({ v: 1, scope: "presence", type: "bye", clientId, kind });
+  const onPageShow = (event) => {
+    if (!event.persisted) return;
+    post({ v: 1, scope: "presence", type: "hello", clientId, kind });
+  };
   const hasWindow = typeof document !== "undefined" && typeof addEventListener === "function";
-  if (hasWindow) addEventListener("pagehide", sayBye);
+  if (hasWindow) {
+    addEventListener("pagehide", sayBye);
+    addEventListener("pageshow", onPageShow);
+  }
   return {
     name,
     clientId,
     kind,
+    heartbeatMs: options.heartbeatMs ?? 2e3,
     post,
     subscribe(fn) {
       listeners.add(fn);
@@ -132,12 +175,16 @@ function createBus(name, options, onShutdown) {
       refs++;
     },
     release() {
+      if (closed) return;
       refs--;
       if (refs > 0) return;
       sayBye();
       closed = true;
       clearInterval(heartbeat);
-      if (hasWindow) removeEventListener("pagehide", sayBye);
+      if (hasWindow) {
+        removeEventListener("pagehide", sayBye);
+        removeEventListener("pageshow", onPageShow);
+      }
       unsubscribe();
       transport.close();
       listeners.clear();
@@ -159,6 +206,15 @@ function getBus(name, options = {}) {
   if (!bus) {
     bus = createBus(name, options, () => registry.delete(name));
     registry.set(name, bus);
+  } else {
+    if (options.heartbeatMs !== void 0 && options.heartbeatMs !== bus.heartbeatMs) {
+      devWarn(
+        `[use-everywhere] bus "${name}": heartbeatMs ignored \u2014 the first creator fixes bus options`
+      );
+    }
+    if (options.kind !== void 0 && options.kind !== bus.kind) {
+      devWarn(`[use-everywhere] bus "${name}": kind ignored \u2014 the first creator fixes bus options`);
+    }
   }
   bus.acquire();
   return bus;
@@ -175,6 +231,7 @@ function createChannel(name, options = {}) {
     const meta = { clientId: wire.clientId, kind: wire.kind, self: false };
     for (const fn of set) fn(wire.payload, meta);
   });
+  let closed = false;
   return {
     name,
     clientId: bus.clientId,
@@ -199,6 +256,8 @@ function createChannel(name, options = {}) {
       return () => set.delete(handler);
     },
     close() {
+      if (closed) return;
+      closed = true;
       unsubscribe();
       handlers.clear();
       bus.release();
@@ -212,25 +271,48 @@ function newer(a, b) {
 }
 
 // src/dev-freeze.ts
-var inDev = false;
+var inDev2 = false;
 try {
-  inDev = process.env.NODE_ENV !== "production";
+  inDev2 = process.env.NODE_ENV !== "production";
 } catch {
 }
 function deepFreeze(value) {
   if (value === null || typeof value !== "object" || Object.isFrozen(value)) return;
+  if (ArrayBuffer.isView(value)) return;
   Object.freeze(value);
+  if (value instanceof Map) {
+    for (const [k, v] of value) {
+      deepFreeze(k);
+      deepFreeze(v);
+    }
+    return;
+  }
+  if (value instanceof Set) {
+    for (const entry of value) deepFreeze(entry);
+    return;
+  }
   for (const key of Object.keys(value)) {
     deepFreeze(value[key]);
   }
 }
 function freezeShared(value) {
-  if (inDev) deepFreeze(value);
+  if (inDev2) deepFreeze(value);
   return value;
 }
 
 // src/shared-store.ts
+var liveStores = /* @__PURE__ */ new Map();
 function createSharedStore(name, initial, options = {}) {
+  const onSharedBus = !options.transport;
+  if (onSharedBus) {
+    const live = liveStores.get(name) ?? 0;
+    if (live > 0) {
+      devWarn(
+        `[use-everywhere] second shared store for "${name}" in this tab \u2014 stores on one page never hear each other and will diverge. Reuse one per name.`
+      );
+    }
+    liveStores.set(name, live + 1);
+  }
   const bus = getBus(name, options);
   const clientId = bus.clientId;
   const accept = options.accept;
@@ -284,18 +366,25 @@ function createSharedStore(name, initial, options = {}) {
   });
   function setKey(key, value) {
     const version = [(versions[key]?.[0] ?? 0) + 1, clientId];
+    try {
+      bus.post({
+        v: 1,
+        scope: "state",
+        type: "patch",
+        key,
+        value,
+        version,
+        clientId,
+        kind: bus.kind
+      });
+    } catch (error) {
+      throw new TypeError(
+        `use-everywhere: the value for key "${key}" cannot cross the wire (structured clone failed); the write was not applied. ${String(error)}`,
+        { cause: error }
+      );
+    }
     versions[key] = version;
     state[key] = freezeShared(value);
-    bus.post({
-      v: 1,
-      scope: "state",
-      type: "patch",
-      key,
-      value,
-      version,
-      clientId,
-      kind: bus.kind
-    });
     notify(key, value, { clientId, kind: bus.kind, self: true });
   }
   const proxy = new Proxy(state, {
@@ -358,7 +447,15 @@ function createSharedStore(name, initial, options = {}) {
       addEventListener("pagehide", flushPersist);
     }
   }
-  bus.post({ v: 1, scope: "state", type: "hello", clientId, kind: bus.kind });
+  const sayHello = () => bus.post({ v: 1, scope: "state", type: "hello", clientId, kind: bus.kind });
+  const onPageShow = (event) => {
+    if (!event.persisted) return;
+    sayHello();
+  };
+  const hasWindow = typeof document !== "undefined" && typeof addEventListener === "function";
+  if (hasWindow) addEventListener("pageshow", onPageShow);
+  sayHello();
+  let storeClosed = false;
   return {
     clientId,
     state: proxy,
@@ -379,16 +476,27 @@ function createSharedStore(name, initial, options = {}) {
         keyListeners.set(key, set);
       }
       set.add(fn);
-      return () => set.delete(fn);
+      return () => {
+        set.delete(fn);
+        if (set.size === 0) keyListeners.delete(key);
+      };
     },
     registerKey(key, initialValue) {
       if (key in versions) return;
       versions[key] = [0, clientId];
-      state[key] = initialValue;
+      state[key] = freezeShared(initialValue);
       snapshot = Object.freeze({ ...state });
       versionsSnapshot = Object.freeze({ ...versions });
     },
     close() {
+      if (storeClosed) return;
+      storeClosed = true;
+      if (onSharedBus) {
+        const live = (liveStores.get(name) ?? 1) - 1;
+        if (live > 0) liveStores.set(name, live);
+        else liveStores.delete(name);
+      }
+      if (hasWindow) removeEventListener("pageshow", onPageShow);
       if (flushPersist) {
         flushPersist();
         if (typeof document !== "undefined" && typeof removeEventListener === "function") {
@@ -437,6 +545,7 @@ function createPresence(name, options = {}) {
     },
     Math.max(500, Math.floor(pruneAfterMs / 2))
   );
+  let closed = false;
   return {
     clientId: bus.clientId,
     getPeers: () => snapshot,
@@ -445,6 +554,8 @@ function createPresence(name, options = {}) {
       return () => listeners.delete(fn);
     },
     close() {
+      if (closed) return;
+      closed = true;
       clearInterval(prune);
       unsubscribe();
       listeners.clear();
@@ -533,10 +644,19 @@ function createLeader(name, options = {}) {
     bus.post({ v: 1, scope: "leader", type: "resign", term: resigning, clientId, kind: bus.kind });
     armLease(leaseMs);
   }
+  const sayHello = () => bus.post({ v: 1, scope: "leader", type: "hello", clientId, kind: bus.kind });
   const hasWindow = typeof document !== "undefined" && typeof addEventListener === "function";
   const onPageHide = () => resign();
-  if (hasWindow) addEventListener("pagehide", onPageHide);
-  bus.post({ v: 1, scope: "leader", type: "hello", clientId, kind: bus.kind });
+  const onPageShow = (event) => {
+    if (!event.persisted) return;
+    sayHello();
+    armLease(heartbeatMs);
+  };
+  if (hasWindow) {
+    addEventListener("pagehide", onPageHide);
+    addEventListener("pageshow", onPageShow);
+  }
+  sayHello();
   armLease(heartbeatMs);
   return {
     clientId,
@@ -556,11 +676,15 @@ function createLeader(name, options = {}) {
       if (leaderId === null) armLease(0);
     },
     close() {
+      if (closed) return;
       closed = true;
       resign();
       clearInterval(beat);
       clearTimeout(lease);
-      if (hasWindow) removeEventListener("pagehide", onPageHide);
+      if (hasWindow) {
+        removeEventListener("pagehide", onPageHide);
+        removeEventListener("pageshow", onPageShow);
+      }
       unsubscribe();
       listeners.clear();
       bus.release();
@@ -574,44 +698,54 @@ function isPersisted(value) {
   const candidate = value;
   return candidate.v === 1 && typeof candidate.state === "object" && typeof candidate.versions === "object";
 }
-function webStorageAdapter(storage, key) {
-  const resolve = () => {
+function webStorageAdapter(storage, key, options = {}) {
+  const report = (error, operation) => {
     try {
-      return typeof storage === "function" ? storage() : storage;
+      options.onError?.(error, operation);
     } catch {
+    }
+  };
+  const resolve = (operation) => {
+    try {
+      return typeof storage === "function" ? storage() : storage;
+    } catch (error) {
+      report(error, operation);
       return void 0;
     }
   };
   return {
     read() {
       try {
-        const raw = resolve()?.getItem(key);
+        const raw = resolve("read")?.getItem(key);
         if (!raw) return void 0;
         const parsed = JSON.parse(raw);
         return isPersisted(parsed) ? parsed : void 0;
-      } catch {
+      } catch (error) {
+        report(error, "read");
         return void 0;
       }
     },
     write(snapshot) {
       try {
-        resolve()?.setItem(key, JSON.stringify(snapshot));
-      } catch {
+        resolve("write")?.setItem(key, JSON.stringify(snapshot));
+      } catch (error) {
+        report(error, "write");
       }
     },
     remove() {
       try {
-        resolve()?.removeItem(key);
-      } catch {
+        resolve("remove")?.removeItem(key);
+      } catch (error) {
+        report(error, "remove");
       }
     }
   };
 }
-function localStorageAdapter(key) {
-  return webStorageAdapter(() => globalThis.localStorage, key);
+function localStorageAdapter(key, options) {
+  return webStorageAdapter(() => globalThis.localStorage, key, options);
 }
-function sessionStorageAdapter(key) {
-  return webStorageAdapter(() => globalThis.sessionStorage, key);
+function sessionStorageAdapter(key, options) {
+  return webStorageAdapter(() => globalThis.sessionStorage, key, options);
 }
 
 // src/errors/handshake-timeout-error.ts
@@ -738,6 +872,7 @@ function openWindow(url, options) {
   }, 400);
   const readyTimer = setTimeout(() => {
     if (isReady || closedSettled) return;
+    localWindow.removeEventListener("message", onMessage);
     const err = new HandshakeTimeoutError();
     rejectReady(err);
     if (!resultSettled) {
@@ -791,6 +926,7 @@ function connectToOpener(options) {
   markHandled(ready);
   const onMessage = (event) => {
     if (!allowAnyOrigin && event.origin !== peerOrigin) return;
+    if (event.source !== opener) return;
     if (!isWindowWire(event.data, cid)) return;
     const wire = event.data;
     if (wire.t === "ready-ack") {
@@ -886,9 +1022,11 @@ var MemoryHub = class {
   }
   /** @internal */
   broadcast(from, data) {
+    structuredClone(data);
     for (const transport of this.transports) {
       if (transport !== from) {
-        queueMicrotask(() => transport.deliver(data));
+        const copy = structuredClone(data);
+        queueMicrotask(() => transport.deliver(copy));
       }
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@use-everywhere/core",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Cross-tab shared state, events, presence, and cross-origin window channels",
   "license": "MIT",
   "author": "Jonatan Kruszewski <jonakrusze@gmail.com>",
@@ -48,43 +48,43 @@
       "name": "everything (import *)",
       "path": "dist/index.js",
       "import": "*",
-      "limit": "4.5 kB"
+      "limit": "5 kB"
     },
     {
       "name": "createLeader",
       "path": "dist/index.js",
       "import": "{ createLeader }",
-      "limit": "1.3 kB"
+      "limit": "1.6 kB"
     },
     {
       "name": "createSharedStore",
       "path": "dist/index.js",
       "import": "{ createSharedStore }",
-      "limit": "1.6 kB"
+      "limit": "2.25 kB"
     },
     {
       "name": "createChannel",
       "path": "dist/index.js",
       "import": "{ createChannel }",
-      "limit": "900 B"
+      "limit": "1.25 kB"
     },
     {
       "name": "createPresence",
       "path": "dist/index.js",
       "import": "{ createPresence }",
-      "limit": "1 kB"
+      "limit": "1.35 kB"
     },
     {
       "name": "openWindow (opener side)",
       "path": "dist/index.js",
       "import": "{ openWindow }",
-      "limit": "1.15 kB"
+      "limit": "1.3 kB"
     },
     {
       "name": "connectToOpener (child side)",
       "path": "dist/index.js",
       "import": "{ connectToOpener }",
-      "limit": "1 kB"
+      "limit": "1.15 kB"
     },
     {
       "name": "MemoryHub (test transport)",