@chromahq/store 1.0.0 → 1.0.2

package/dist/index.cjs.js

@@ -96,12 +96,24 @@ function useCentralStore(store, selector) {
 function useCentralDispatch(store) {
   return store.setState;
 }
+function useStoreReady(store) {
+  return React.useSyncExternalStore(
+    store.onReady,
+    store.isReady,
+    () => false
+    // Server-side fallback
+  );
+}
+function useStoreReset(store) {
+  return store.reset;
+}
 
 class BridgeStore {
   constructor(bridge, initialState, storeName = "default") {
     this.listeners = /* @__PURE__ */ new Set();
     this.currentState = null;
     this.previousState = null;
+    this.initialState = null;
     this.ready = false;
     this.readyCallbacks = /* @__PURE__ */ new Set();
     this.initialize = async () => {
@@ -109,6 +121,9 @@ class BridgeStore {
         const state = await this.bridge.send(`store:${this.storeName}:getState`);
         this.previousState = this.currentState;
         this.currentState = state;
+        if (this.initialState === null) {
+          this.initialState = state;
+        }
         this.notifyListeners();
         this.ready = true;
         this.notifyReady();
@@ -166,6 +181,18 @@ class BridgeStore {
         this.readyCallbacks.delete(callback);
       };
     };
+    this.reset = () => {
+      if (this.initialState !== null) {
+        this.bridge.send(`store:${this.storeName}:reset`).catch((error) => {
+          console.error("Failed to reset state via bridge:", error);
+        });
+        this.previousState = this.currentState;
+        this.currentState = { ...this.initialState };
+        this.notifyListeners();
+      } else {
+        console.warn("BridgeStore: Cannot reset, initial state not available");
+      }
+    };
     this.notifyReady = () => {
       this.readyCallbacks.forEach((callback) => callback());
       this.readyCallbacks.clear();
@@ -173,6 +200,7 @@ class BridgeStore {
     this.bridge = bridge;
     this.currentState = initialState || null;
     this.previousState = initialState || null;
+    this.initialState = initialState || null;
     this.storeName = storeName;
     this.setupStateSync();
     this.initialize();
@@ -329,6 +357,7 @@ class StoreBuilder {
   createServiceWorkerStore() {
     let isReady = false;
     const readyCallbacks = /* @__PURE__ */ new Set();
+    let initialState = null;
     const notifyReady = () => {
       isReady = true;
       readyCallbacks.forEach((callback) => callback());
@@ -340,6 +369,9 @@ class StoreBuilder {
         const sliceState = slice(set, get, store2);
         state = { ...state, ...sliceState };
       }
+      if (initialState === null) {
+        initialState = { ...state };
+      }
       return state;
     };
     const persistOptions = {
@@ -350,6 +382,13 @@ class StoreBuilder {
     const store = vanilla.createStore(persistedCreator);
     const centralStore = Object.assign(store, {
       isReady: () => isReady,
+      reset: () => {
+        if (initialState !== null) {
+          store.setState(initialState, true);
+        } else {
+          console.warn("ServiceWorkerStore: Cannot reset, initial state not available");
+        }
+      },
       onReady: (callback) => {
         if (isReady) {
           callback();
@@ -464,3 +503,5 @@ exports.createStoreHooks = createStoreHooks;
 exports.init = init;
 exports.useCentralDispatch = useCentralDispatch;
 exports.useCentralStore = useCentralStore;
+exports.useStoreReady = useStoreReady;
+exports.useStoreReset = useStoreReset;

package/dist/index.d.ts

@@ -24,6 +24,7 @@ type MergeSlices<Slices extends readonly StateCreator<any, [], [], any>[]> = Sli
 interface CentralStore<T> extends StoreApi<T> {
     isReady: () => boolean;
     onReady: (callback: () => void) => () => void;
+    reset: () => void;
 }
 
 declare function chromeStoragePersist<S>(options?: PersistOptions & {
@@ -35,6 +36,14 @@ declare function useCentralDispatch<T>(store: CentralStore<T>): {
     (partial: T | Partial<T> | ((state: T) => T | Partial<T>), replace?: false): void;
     (state: T | ((state: T) => T), replace: true): void;
 };
+/**
+ * React hook to check if the store is ready (fully loaded from persistence/bridge)
+ */
+declare function useStoreReady<T>(store: CentralStore<T>): boolean;
+/**
+ * React hook to get the reset function for a store
+ */
+declare function useStoreReset<T>(store: CentralStore<T>): () => void;
 
 interface Bridge {
     send: <Req = unknown, Res = unknown>(key: string, payload?: Req) => Promise<Res>;
@@ -53,6 +62,7 @@ declare class BridgeStore<T> implements CentralStore<T> {
     private listeners;
     private currentState;
     private previousState;
+    private initialState;
     private storeName;
     private ready;
     private readyCallbacks;
@@ -68,6 +78,7 @@ declare class BridgeStore<T> implements CentralStore<T> {
     getInitialState: () => T;
     isReady: () => boolean;
     onReady: (callback: () => void) => (() => void);
+    reset: () => void;
     private notifyReady;
 }
 declare function createBridgeStore<T>(bridge: BridgeWithEvents, initialState?: T, storeName?: string): CentralStore<T>;
@@ -147,5 +158,5 @@ declare function createStore<T = any>(name?: string): StoreBuilder<T>;
  */
 declare function init(storeDefinition: StoreDefinition): Promise<any>;
 
-export { BridgeStore, StoreBuilder, chromeStoragePersist, createActionHookForStore, createBridgeStore, createStore, createStoreHooks, init, useCentralDispatch, useCentralStore };
+export { BridgeStore, StoreBuilder, chromeStoragePersist, createActionHookForStore, createBridgeStore, createStore, createStoreHooks, init, useCentralDispatch, useCentralStore, useStoreReady, useStoreReset };
 export type { Bridge, BridgeWithEvents, BridgeWithHandlers, CentralStore, ExtractSliceState, MergeSlices, PersistOptions, SliceCreator, StoreConfig, StoreDefinition };

package/dist/index.es.js

@@ -76,12 +76,24 @@ function useCentralStore(store, selector) {
 function useCentralDispatch(store) {
   return store.setState;
 }
+function useStoreReady(store) {
+  return useSyncExternalStore(
+    store.onReady,
+    store.isReady,
+    () => false
+    // Server-side fallback
+  );
+}
+function useStoreReset(store) {
+  return store.reset;
+}
 
 class BridgeStore {
   constructor(bridge, initialState, storeName = "default") {
     this.listeners = /* @__PURE__ */ new Set();
     this.currentState = null;
     this.previousState = null;
+    this.initialState = null;
     this.ready = false;
     this.readyCallbacks = /* @__PURE__ */ new Set();
     this.initialize = async () => {
@@ -89,6 +101,9 @@ class BridgeStore {
         const state = await this.bridge.send(`store:${this.storeName}:getState`);
         this.previousState = this.currentState;
         this.currentState = state;
+        if (this.initialState === null) {
+          this.initialState = state;
+        }
         this.notifyListeners();
         this.ready = true;
         this.notifyReady();
@@ -146,6 +161,18 @@ class BridgeStore {
         this.readyCallbacks.delete(callback);
       };
     };
+    this.reset = () => {
+      if (this.initialState !== null) {
+        this.bridge.send(`store:${this.storeName}:reset`).catch((error) => {
+          console.error("Failed to reset state via bridge:", error);
+        });
+        this.previousState = this.currentState;
+        this.currentState = { ...this.initialState };
+        this.notifyListeners();
+      } else {
+        console.warn("BridgeStore: Cannot reset, initial state not available");
+      }
+    };
     this.notifyReady = () => {
       this.readyCallbacks.forEach((callback) => callback());
       this.readyCallbacks.clear();
@@ -153,6 +180,7 @@ class BridgeStore {
     this.bridge = bridge;
     this.currentState = initialState || null;
     this.previousState = initialState || null;
+    this.initialState = initialState || null;
     this.storeName = storeName;
     this.setupStateSync();
     this.initialize();
@@ -309,6 +337,7 @@ class StoreBuilder {
   createServiceWorkerStore() {
     let isReady = false;
     const readyCallbacks = /* @__PURE__ */ new Set();
+    let initialState = null;
     const notifyReady = () => {
       isReady = true;
       readyCallbacks.forEach((callback) => callback());
@@ -320,6 +349,9 @@ class StoreBuilder {
         const sliceState = slice(set, get, store2);
         state = { ...state, ...sliceState };
       }
+      if (initialState === null) {
+        initialState = { ...state };
+      }
       return state;
     };
     const persistOptions = {
@@ -330,6 +362,13 @@ class StoreBuilder {
     const store = createStore$1(persistedCreator);
     const centralStore = Object.assign(store, {
       isReady: () => isReady,
+      reset: () => {
+        if (initialState !== null) {
+          store.setState(initialState, true);
+        } else {
+          console.warn("ServiceWorkerStore: Cannot reset, initial state not available");
+        }
+      },
       onReady: (callback) => {
         if (isReady) {
           callback();
@@ -434,4 +473,4 @@ if (typeof globalThis !== "undefined") {
   globalThis.initStores = init;
 }
 
-export { BridgeStore, StoreBuilder, chromeStoragePersist, createActionHookForStore, createBridgeStore, createStore, createStoreHooks, init, useCentralDispatch, useCentralStore };
+export { BridgeStore, StoreBuilder, chromeStoragePersist, createActionHookForStore, createBridgeStore, createStore, createStoreHooks, init, useCentralDispatch, useCentralStore, useStoreReady, useStoreReset };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chromahq/store",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Centralized, persistent store for Chrome extensions using zustand, accessible from service workers and React, with chrome.storage.local persistence.",
   "type": "module",
   "main": "dist/index.cjs.js",