@t8/react-store 1.0.38 → 1.1.0

package/dist/index.js

@@ -1,22 +1,39 @@
 // node_modules/@t8/store/src/isStore.ts
 function isStore(x) {
-  return x !== null && typeof x === "object" && "onUpdate" in x && typeof x.onUpdate === "function" && "getState" in x && typeof x.getState === "function" && "setState" in x && typeof x.setState === "function";
+  return x !== null && typeof x === "object" && "on" in x && typeof x.on === "function" && "getState" in x && typeof x.getState === "function" && "setState" in x && typeof x.setState === "function";
 }
 
 // node_modules/@t8/store/src/Store.ts
 var Store = class {
   state;
-  callbacks = /* @__PURE__ */ new Set();
+  callbacks = {};
   revision = -1;
   constructor(data) {
     this.state = data;
   }
-  onUpdate(callback) {
-    this.callbacks.add(callback);
+  on(event, callback) {
+    (this.callbacks[event] ??= /* @__PURE__ */ new Set()).add(callback);
     return () => {
-      this.callbacks.delete(callback);
+      this.off(event, callback);
     };
   }
+  off(event, callback) {
+    this.callbacks[event]?.delete(callback);
+  }
+  once(event, callback) {
+    let oneTimeCallback = (nextState, prevState) => {
+      this.off(event, oneTimeCallback);
+      callback(nextState, prevState);
+    };
+    return this.on(event, oneTimeCallback);
+  }
+  emit(event, nextState, prevState) {
+    let eventCallbacks = this.callbacks[event];
+    if (eventCallbacks) {
+      for (let callback of eventCallbacks)
+        callback(nextState ?? this.state, prevState ?? this.state);
+    }
+  }
   getState() {
     return this.state;
   }
@@ -25,7 +42,7 @@ var Store = class {
     let nextState = update instanceof Function ? update(this.state) : update;
     this.state = nextState;
     this.revision = Math.random();
-    for (let callback of this.callbacks) callback(nextState, prevState);
+    this.emit("update", nextState, prevState);
   }
 };
 
@@ -38,8 +55,9 @@ function useStore(store, shouldUpdate = true) {
   let setState = useMemo(() => store.setState.bind(store), [store]);
   let initialStoreRevision = useRef(store.revision);
   useEffect(() => {
+    store.emit("effect");
     if (!shouldUpdate) return;
-    let unsubscribe = store.onUpdate((nextState, prevState) => {
+    let unsubscribe = store.on("update", (nextState, prevState) => {
       if (typeof shouldUpdate !== "function" || shouldUpdate(nextState, prevState))
         setRevision(Math.random());
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t8/react-store",
-  "version": "1.0.38",
+  "version": "1.1.0",
   "description": "Small React app state management lib aligned with React's state pattern, condensed to the essentials",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -45,6 +45,6 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@t8/store": "^1.1.10"
+    "@t8/store": "^1.2.0"
   }
 }

package/src/useStore.ts

@@ -45,9 +45,14 @@ export function useStore<T>(
   let initialStoreRevision = useRef(store.revision);
 
   useEffect(() => {
+    // Use case: a one-time subscription to this event allows to
+    // initialize the store state on the client without causing a
+    // hydration error.
+    store.emit("effect");
+
     if (!shouldUpdate) return;
 
-    let unsubscribe = store.onUpdate((nextState, prevState) => {
+    let unsubscribe = store.on("update", (nextState, prevState) => {
       if (
         typeof shouldUpdate !== "function" ||
         shouldUpdate(nextState, prevState)