use-everywhere 0.6.0 → 0.8.0

package/dist/{chunk-YOXUZYKA.js → chunk-75TICQ7E.js}

@@ -5,6 +5,7 @@ import {
   createChannel,
   createLeader,
   createPresence,
+  createSharedReducer,
   createSharedStore,
   DEFAULT_NAME,
   NoopTransport
@@ -49,6 +50,12 @@ var unsubscribe = () => noop;
 var INERT = Object.freeze({
   clientId: SERVER_CLIENT_ID,
   // store
+  //
+  // Resolved, unlike the leader's `waitForLeadership` below. A server render
+  // has nothing to restore and is documented to render defaults, so `await
+  // store.hydrated` must proceed — a never-settling promise would hang the
+  // render rather than describe it honestly.
+  hydrated: Promise.resolve(),
   state: EMPTY,
   getVersions: () => EMPTY,
   set: noop,
@@ -57,6 +64,8 @@ var INERT = Object.freeze({
   // store + leader share getSnapshot; presence has getPeers
   getSnapshot: () => EMPTY,
   getPeers: () => NO_PEERS,
+  // presence
+  setMetadata: noop,
   // leader
   resign: noop,
   setEligible: noop,
@@ -67,7 +76,20 @@ var INERT = Object.freeze({
 var createServerStore = () => INERT;
 var createServerPresence = () => INERT;
 var NO_LEADER = Object.freeze({ leaderId: null, isLeader: false });
-var createServerLeader = () => ({ ...INERT, getSnapshot: () => NO_LEADER });
+var NEVER = () => new Promise(() => {
+});
+var createServerLeader = () => ({
+  ...INERT,
+  strategy: "heartbeat",
+  getSnapshot: () => NO_LEADER,
+  waitForLeadership: NEVER
+});
+var createServerReducer = (initial) => ({
+  ...INERT,
+  getSnapshot: () => initial,
+  dispatch: noop,
+  pendingCount: () => 0
+});
 var createServerChannel = (name) => ({ ...INERT, name, post: noop, on: unsubscribe });
 
 // src/registry.ts
@@ -88,15 +110,17 @@ function getSharedStore(name = DEFAULT_NAME, scope = "everywhere") {
 function configSignature(options) {
   const persist = options?.persist;
   if (!persist) return "none";
-  return `persist:${persist.keys?.join(",") ?? "*"}:${persist.debounceMs ?? "default"}`;
+  return `persist:${persist.keys?.join(",") ?? "*"}:${persist.debounceMs ?? "default"}:v${persist.version ?? 0}`;
 }
 function configureStore(name, scope, options) {
   const key = `${scope} ${name}`;
   if (stores.has(key)) {
     if (configSignature(storeConfig.get(key)) === configSignature(options)) return;
-    devWarn(
-      `[use-everywhere] defineStore('${name}') ran after that store was already created, with different options. The live store keeps the configuration it was built with. Move defineStore to module scope, before any component reads the store.`
-    );
+    if (process.env.NODE_ENV !== "production") {
+      devWarn(
+        `[use-everywhere] defineStore('${name}') ran after that store was already created, with different options. The live store keeps the configuration it was built with. Move defineStore to module scope, before any component reads the store.`
+      );
+    }
     return;
   }
   storeConfig.set(key, options);
@@ -110,11 +134,12 @@ function getStore(name, scope = "everywhere") {
   }
   return store;
 }
-function getPresence(name) {
-  let presence = presences.get(name);
+function getPresence(name, includeSelf = false) {
+  const key = includeSelf ? `self ${name}` : name;
+  let presence = presences.get(key);
   if (!presence) {
-    presence = isServer() ? createServerPresence() : createPresence(name);
-    presences.set(name, presence);
+    presence = isServer() ? createServerPresence() : createPresence(name, { includeSelf });
+    presences.set(key, presence);
   }
   return presence;
 }
@@ -135,26 +160,53 @@ function warnOnLeaderOptionConflict(name, options) {
   for (const key of ["heartbeatMs", "leaseMs"]) {
     const requested = options[key];
     if (requested !== void 0 && requested !== first?.[key]) {
+      if (process.env.NODE_ENV !== "production") {
+        devWarn(
+          `[use-everywhere] leader "${name}": ${key} ignored \u2014 the first useLeader/getLeader call fixes the election timings for this tab.`
+        );
+      }
+    }
+  }
+}
+var channelConfig = /* @__PURE__ */ new Map();
+function configureChannel(name, options) {
+  if (channels.has(name)) {
+    const before = Object.keys(channelConfig.get(name)?.schema ?? {}).sort();
+    const after = Object.keys(options.schema ?? {}).sort();
+    if (before.join() === after.join()) return;
+    if (process.env.NODE_ENV !== "production") {
       devWarn(
-        `[use-everywhere] leader "${name}": ${key} ignored \u2014 the first useLeader/getLeader call fixes the election timings for this tab.`
+        `[use-everywhere] defineChannel('${name}') ran after that channel was already created, with different options. The live channel keeps the configuration it was built with. Move defineChannel to module scope, before any component sends or receives on it.`
       );
     }
+    return;
   }
+  channelConfig.set(name, options);
+}
+var reducers = /* @__PURE__ */ new Map();
+function getReducer(name, key, reducer, initial) {
+  const id = `${name} ${key}`;
+  let existing = reducers.get(id);
+  if (!existing) {
+    existing = isServer() ? createServerReducer(initial) : createSharedReducer(name, reducer, initial, { key, leader: getLeader(name) });
+    reducers.set(id, existing);
+  }
+  return existing;
 }
 function getChannel(name) {
   let channel = channels.get(name);
   if (!channel) {
-    channel = isServer() ? createServerChannel(name) : createChannel(name);
+    channel = isServer() ? createServerChannel(name) : createChannel(name, channelConfig.get(name));
     channels.set(name, channel);
   }
   return channel;
 }
 
 // src/use-peers.ts
-import { useCallback, useSyncExternalStore } from "react";
+import { useCallback, useEffect, useSyncExternalStore } from "react";
 var NO_PEERS2 = Object.freeze([]);
 function usePeers(options) {
-  const presence = getPresence(options?.name ?? DEFAULT_NAME);
+  const presence = getPresence(options?.name ?? DEFAULT_NAME, options?.includeSelf ?? false);
   return useSyncExternalStore(
     useCallback((onChange) => presence.subscribe(onChange), [presence]),
     () => presence.getPeers(),
@@ -173,6 +225,12 @@ function useClientId(options) {
     () => SERVER_CLIENT_ID
   );
 }
+function usePresenceMetadata(metadata, options) {
+  const presence = getPresence(options?.name ?? DEFAULT_NAME, options?.includeSelf ?? false);
+  useEffect(() => {
+    presence.setMetadata(metadata);
+  }, [presence, metadata]);
+}
 
 export {
   warnOnInitialMismatch,
@@ -181,7 +239,10 @@ export {
   configureStore,
   getStore,
   getLeader,
+  configureChannel,
+  getReducer,
   getChannel,
   usePeers,
-  useClientId
+  useClientId,
+  usePresenceMetadata
 };

package/dist/devtools/index.cjs

@@ -42,6 +42,12 @@ var unsubscribe = () => noop;
 var INERT = Object.freeze({
   clientId: SERVER_CLIENT_ID,
   // store
+  //
+  // Resolved, unlike the leader's `waitForLeadership` below. A server render
+  // has nothing to restore and is documented to render defaults, so `await
+  // store.hydrated` must proceed — a never-settling promise would hang the
+  // render rather than describe it honestly.
+  hydrated: Promise.resolve(),
   state: EMPTY,
   getVersions: () => EMPTY,
   set: noop,
@@ -50,6 +56,8 @@ var INERT = Object.freeze({
   // store + leader share getSnapshot; presence has getPeers
   getSnapshot: () => EMPTY,
   getPeers: () => NO_PEERS,
+  // presence
+  setMetadata: noop,
   // leader
   resign: noop,
   setEligible: noop,
@@ -83,11 +91,12 @@ function getStore(name, scope = "everywhere") {
   }
   return store;
 }
-function getPresence(name) {
-  let presence = presences.get(name);
+function getPresence(name, includeSelf = false) {
+  const key = includeSelf ? `self ${name}` : name;
+  let presence = presences.get(key);
   if (!presence) {
-    presence = isServer() ? createServerPresence() : (0, import_core.createPresence)(name);
-    presences.set(name, presence);
+    presence = isServer() ? createServerPresence() : (0, import_core.createPresence)(name, { includeSelf });
+    presences.set(key, presence);
   }
   return presence;
 }
@@ -96,7 +105,7 @@ function getPresence(name) {
 var import_react = require("react");
 var NO_PEERS2 = Object.freeze([]);
 function usePeers(options) {
-  const presence = getPresence(options?.name ?? import_core.DEFAULT_NAME);
+  const presence = getPresence(options?.name ?? import_core.DEFAULT_NAME, options?.includeSelf ?? false);
   return (0, import_react.useSyncExternalStore)(
     (0, import_react.useCallback)((onChange) => presence.subscribe(onChange), [presence]),
     () => presence.getPeers(),

package/dist/devtools/index.js

@@ -2,7 +2,7 @@
 import {
   getSharedStore,
   usePeers
-} from "../chunk-YOXUZYKA.js";
+} from "../chunk-75TICQ7E.js";
 
 // src/devtools/inspector.tsx
 import { useCallback, useEffect, useRef, useState, useSyncExternalStore } from "react";