@chromahq/store 0.1.0 → 0.1.2

package/dist/index.cjs.js

@@ -196,6 +196,79 @@ function createBridgeStore(bridge, initialState, storeName = "default") {
   return new BridgeStore(bridge, initialState, storeName);
 }
 
+function createActionHookForStore(store, actionsFactory) {
+  return function useCustomActions() {
+    const baseActions = useStoreActions(store);
+    return React.useMemo(() => actionsFactory(baseActions), [baseActions]);
+  };
+}
+function useStoreActions(store) {
+  return React.useMemo(
+    () => ({
+      update: (partial) => {
+        store.setState((state) => ({ ...state, ...partial }));
+      },
+      updateWith: (updater) => {
+        store.setState((state) => ({ ...state, ...updater(state) }));
+      },
+      replace: (newState) => {
+        store.setState(newState, true);
+      },
+      setState: store.setState.bind(store)
+    }),
+    [store]
+  );
+}
+function createStoreHooks() {
+  const StoreContext = React.createContext(null);
+  function StoreProvider({ store, children }) {
+    const storeRef = React.useRef(store);
+    return React__namespace.createElement(StoreContext.Provider, { value: storeRef.current }, children);
+  }
+  function useStore(selector) {
+    const store = React.useContext(StoreContext);
+    if (!store) throw new Error("useStore must be used within a StoreProvider");
+    return useCentralStore(store, selector);
+  }
+  function useStoreInstance() {
+    const store = React.useContext(StoreContext);
+    if (!store) throw new Error("useStoreInstance must be used within a StoreProvider");
+    return store;
+  }
+  function useActions() {
+    const store = useStoreInstance();
+    return useStoreActions(store);
+  }
+  function useAction(actionKey) {
+    const store = useStoreInstance();
+    return React__namespace.useCallback(
+      (...args) => {
+        const fn = store.getState()[actionKey];
+        if (typeof fn !== "function") {
+          throw new Error("useAction only supports function actions");
+        }
+        return fn(...args);
+      },
+      [store, actionKey]
+    );
+  }
+  function createActionHook(actionsFactory) {
+    return function useCustomActions() {
+      const store = useStoreInstance();
+      const baseActions = useStoreActions(store);
+      return React.useMemo(() => actionsFactory(baseActions), [baseActions]);
+    };
+  }
+  return {
+    createActionHook,
+    StoreProvider,
+    useStore,
+    useStoreInstance,
+    useActions,
+    useAction
+  };
+}
+
 class StoreBuilder {
   constructor(name = "default") {
     this.config = {
@@ -253,63 +326,6 @@ function createStore(name) {
   return new StoreBuilder(name);
 }
 
-function useStoreActions(store) {
-  return React.useMemo(
-    () => ({
-      // Update state with partial data
-      update: (partial) => {
-        store.setState((state) => ({ ...state, ...partial }));
-      },
-      // Update state with a function
-      updateWith: (updater) => {
-        store.setState((state) => ({ ...state, ...updater(state) }));
-      },
-      // Replace entire state
-      replace: (newState) => {
-        store.setState(newState, true);
-      },
-      // Direct access to setState
-      setState: store.setState.bind(store)
-    }),
-    [store]
-  );
-}
-function createStoreHooks() {
-  const StoreContext = React.createContext(null);
-  function StoreProvider({ store, children }) {
-    const storeRef = React.useRef(store);
-    return React__namespace.createElement(StoreContext.Provider, { value: storeRef.current }, children);
-  }
-  function useStore(selector) {
-    const store = React.useContext(StoreContext);
-    if (!store) throw new Error("useStore must be used within a StoreProvider");
-    return useCentralStore(store, selector);
-  }
-  function useStoreInstance() {
-    const store = React.useContext(StoreContext);
-    if (!store) throw new Error("useStoreInstance must be used within a StoreProvider");
-    return store;
-  }
-  function useActions() {
-    const store = useStoreInstance();
-    return useStoreActions(store);
-  }
-  function createActionHook(actionsFactory) {
-    return function useCustomActions() {
-      const store = useStoreInstance();
-      const baseActions = useStoreActions(store);
-      return React.useMemo(() => actionsFactory(baseActions), [baseActions]);
-    };
-  }
-  return {
-    StoreProvider,
-    useStore,
-    useStoreInstance,
-    useActions,
-    createActionHook
-  };
-}
-
 function autoRegisterStoreHandlers(store) {
   if (!store) {
     throw new Error("autoRegisterStoreHandlers: store parameter is required");
@@ -398,6 +414,7 @@ if (typeof globalThis !== "undefined") {
 exports.BridgeStore = BridgeStore;
 exports.StoreBuilder = StoreBuilder;
 exports.chromeStoragePersist = chromeStoragePersist;
+exports.createActionHookForStore = createActionHookForStore;
 exports.createBridgeStore = createBridgeStore;
 exports.createStore = createStore;
 exports.createStoreHooks = createStoreHooks;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { StoreApi, StateCreator } from 'zustand';
-import { StateCreator as StateCreator$1 } from 'zustand/vanilla';
 import * as React from 'react';
 import { ReactNode } from 'react';
+import { StateCreator as StateCreator$1 } from 'zustand/vanilla';
 
 type PersistOptions = {
     name: string;
@@ -65,33 +65,19 @@ declare class BridgeStore<T> implements CentralStore<T> {
 declare function createBridgeStore<T>(bridge: BridgeWithEvents, initialState?: T, storeName?: string): CentralStore<T>;
 
 /**
- * Core store builder with fluent API
- */
-declare class StoreBuilder<T = any> {
-    private config;
-    constructor(name?: string);
-    /**
-     * Add state slices to the store
-     */
-    withSlices(...slices: StateCreator$1<any, [], [], any>[]): this;
-    /**
-     * Attach a bridge for cross-context communication
-     */
-    withBridge(bridge?: BridgeWithEvents): this;
-    /**
-     * Create the store
-     */
-    create(): Promise<CentralStore<T>>;
-    private createBaseStore;
-    private createServiceWorkerStore;
-}
-/**
- * Create a new store builder
+ * Generic action hook factory for any store instance.
+ * Usage:
+ *   const store = createStore(mergeSlices(sliceA, sliceB));
+ *   <StoreProvider store={store}> ... </StoreProvider>
+ *   export const useWalletActions = createActionHookForStore(store, walletActions);
+ *   export const useCounterActions = createActionHookForStore(store, counterActions);
+ * All hooks and actions share the same StoreProvider/context.
  */
-declare function createStore<T = any>(name?: string): StoreBuilder<T>;
+declare function createActionHookForStore<S extends Record<string, any>, ActionMap extends Record<string, (...args: any[]) => void>>(store: CentralStore<S>, actionsFactory: (actions: ReturnType<typeof useStoreActions<S>>) => ActionMap): () => ActionMap;
 
 /**
- * Store actions helper (inlined from actions.ts)
+ * Store actions helper: exposes update, updateWith, replace, setState
+ * Actions should be defined in your slice and accessed via useActions.
  */
 declare function useStoreActions<T extends Record<string, any>>(store: CentralStore<T>): {
     update: (partial: Partial<T>) => void;
@@ -102,11 +88,8 @@ declare function useStoreActions<T extends Record<string, any>>(store: CentralSt
         (state: T | ((state: T) => T), replace: true): void;
     };
 };
-/**
- * Create a complete store hook factory with typed providers and action creators
- * This prevents confusion by providing only the hooks you need, not global ones
- */
 declare function createStoreHooks<T extends Record<string, any>>(): {
+    createActionHook: <ActionMap extends Record<string, (...args: any[]) => void>>(actionsFactory: (actions: ReturnType<typeof useStoreActions<T>>) => ActionMap) => () => ActionMap;
     StoreProvider: ({ store, children }: {
         store: CentralStore<T>;
         children: ReactNode;
@@ -122,8 +105,34 @@ declare function createStoreHooks<T extends Record<string, any>>(): {
             (state: T | ((state: T) => T), replace: true): void;
         };
     };
-    createActionHook: <ActionMap extends Record<string, (...args: any[]) => void>>(actionsFactory: (actions: ReturnType<typeof useStoreActions<T>>) => ActionMap) => () => ActionMap;
+    useAction: <K extends { [K_1 in keyof T]: T[K_1] extends (...args: any[]) => any ? K_1 : never; }[keyof T]>(actionKey: K) => T[K];
 };
 
-export { BridgeStore, StoreBuilder, chromeStoragePersist, createBridgeStore, createStore, createStoreHooks, useCentralDispatch, useCentralStore };
+/**
+ * Core store builder with fluent API
+ */
+declare class StoreBuilder<T = any> {
+    private config;
+    constructor(name?: string);
+    /**
+     * Add state slices to the store
+     */
+    withSlices(...slices: StateCreator$1<any, [], [], any>[]): this;
+    /**
+     * Attach a bridge for cross-context communication
+     */
+    withBridge(bridge?: BridgeWithEvents): this;
+    /**
+     * Create the store
+     */
+    create(): Promise<CentralStore<T>>;
+    private createBaseStore;
+    private createServiceWorkerStore;
+}
+/**
+ * Create a new store builder
+ */
+declare function createStore<T = any>(name?: string): StoreBuilder<T>;
+
+export { BridgeStore, StoreBuilder, chromeStoragePersist, createActionHookForStore, createBridgeStore, createStore, createStoreHooks, useCentralDispatch, useCentralStore };
 export type { Bridge, BridgeWithEvents, BridgeWithHandlers, CentralStore, ExtractSliceState, MergeSlices, PersistOptions, SliceCreator, StoreConfig, StoreDefinition };

package/dist/index.es.js

@@ -176,6 +176,79 @@ function createBridgeStore(bridge, initialState, storeName = "default") {
   return new BridgeStore(bridge, initialState, storeName);
 }
 
+function createActionHookForStore(store, actionsFactory) {
+  return function useCustomActions() {
+    const baseActions = useStoreActions(store);
+    return useMemo(() => actionsFactory(baseActions), [baseActions]);
+  };
+}
+function useStoreActions(store) {
+  return useMemo(
+    () => ({
+      update: (partial) => {
+        store.setState((state) => ({ ...state, ...partial }));
+      },
+      updateWith: (updater) => {
+        store.setState((state) => ({ ...state, ...updater(state) }));
+      },
+      replace: (newState) => {
+        store.setState(newState, true);
+      },
+      setState: store.setState.bind(store)
+    }),
+    [store]
+  );
+}
+function createStoreHooks() {
+  const StoreContext = createContext(null);
+  function StoreProvider({ store, children }) {
+    const storeRef = useRef(store);
+    return React.createElement(StoreContext.Provider, { value: storeRef.current }, children);
+  }
+  function useStore(selector) {
+    const store = useContext(StoreContext);
+    if (!store) throw new Error("useStore must be used within a StoreProvider");
+    return useCentralStore(store, selector);
+  }
+  function useStoreInstance() {
+    const store = useContext(StoreContext);
+    if (!store) throw new Error("useStoreInstance must be used within a StoreProvider");
+    return store;
+  }
+  function useActions() {
+    const store = useStoreInstance();
+    return useStoreActions(store);
+  }
+  function useAction(actionKey) {
+    const store = useStoreInstance();
+    return React.useCallback(
+      (...args) => {
+        const fn = store.getState()[actionKey];
+        if (typeof fn !== "function") {
+          throw new Error("useAction only supports function actions");
+        }
+        return fn(...args);
+      },
+      [store, actionKey]
+    );
+  }
+  function createActionHook(actionsFactory) {
+    return function useCustomActions() {
+      const store = useStoreInstance();
+      const baseActions = useStoreActions(store);
+      return useMemo(() => actionsFactory(baseActions), [baseActions]);
+    };
+  }
+  return {
+    createActionHook,
+    StoreProvider,
+    useStore,
+    useStoreInstance,
+    useActions,
+    useAction
+  };
+}
+
 class StoreBuilder {
   constructor(name = "default") {
     this.config = {
@@ -233,63 +306,6 @@ function createStore(name) {
   return new StoreBuilder(name);
 }
 
-function useStoreActions(store) {
-  return useMemo(
-    () => ({
-      // Update state with partial data
-      update: (partial) => {
-        store.setState((state) => ({ ...state, ...partial }));
-      },
-      // Update state with a function
-      updateWith: (updater) => {
-        store.setState((state) => ({ ...state, ...updater(state) }));
-      },
-      // Replace entire state
-      replace: (newState) => {
-        store.setState(newState, true);
-      },
-      // Direct access to setState
-      setState: store.setState.bind(store)
-    }),
-    [store]
-  );
-}
-function createStoreHooks() {
-  const StoreContext = createContext(null);
-  function StoreProvider({ store, children }) {
-    const storeRef = useRef(store);
-    return React.createElement(StoreContext.Provider, { value: storeRef.current }, children);
-  }
-  function useStore(selector) {
-    const store = useContext(StoreContext);
-    if (!store) throw new Error("useStore must be used within a StoreProvider");
-    return useCentralStore(store, selector);
-  }
-  function useStoreInstance() {
-    const store = useContext(StoreContext);
-    if (!store) throw new Error("useStoreInstance must be used within a StoreProvider");
-    return store;
-  }
-  function useActions() {
-    const store = useStoreInstance();
-    return useStoreActions(store);
-  }
-  function createActionHook(actionsFactory) {
-    return function useCustomActions() {
-      const store = useStoreInstance();
-      const baseActions = useStoreActions(store);
-      return useMemo(() => actionsFactory(baseActions), [baseActions]);
-    };
-  }
-  return {
-    StoreProvider,
-    useStore,
-    useStoreInstance,
-    useActions,
-    createActionHook
-  };
-}
-
 function autoRegisterStoreHandlers(store) {
   if (!store) {
     throw new Error("autoRegisterStoreHandlers: store parameter is required");
@@ -375,4 +391,4 @@ if (typeof globalThis !== "undefined") {
   globalThis.initStores = init;
 }
 
-export { BridgeStore, StoreBuilder, chromeStoragePersist, createBridgeStore, createStore, createStoreHooks, useCentralDispatch, useCentralStore };
+export { BridgeStore, StoreBuilder, chromeStoragePersist, createActionHookForStore, createBridgeStore, createStore, createStoreHooks, useCentralDispatch, useCentralStore };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chromahq/store",
-  "version": "0.1.0",
+  "version": "0.1.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",