synapse-storage 4.0.0 → 4.1.0

package/dist/react/utils/createSynapseCtx.js

@@ -1,5 +1,11 @@
+import { Fragment, jsx } from "react/jsx-runtime";
 import { createContext, forwardRef, useContext, useEffect, useState } from "react";
-import { handleCleanupError, handleOperationError } from "../../_utils/error-handling.util.js";
+import { handleCleanupError } from "../../_utils/error-handling.util.js";
+import { createSynapseAwaiter } from "../../utils/index.js";
+
+
+
+
 
 
 
@@ -9,22 +15,15 @@ const ERROR_HOOK_MESSAGE = 'Хук необходимо использовать
 const ERROR_CONTEXT_INIT = 'Ошибка при инициализации контекста:';
 // Основная реализация
 function createSynapseCtx(synapseStorePromise, options) {
-    const { loadingComponent = /*#__PURE__*/ React.createElement("div", null, "Инициализация контекста...") } = options || {};
-    // Lazy-инициализация: Promise создаётся при первом обращении и сбрасывается при cleanup
-    let storeInitPromise = null;
-    const getStoreInitPromise = ()=>{
-        if (!storeInitPromise) {
-            storeInitPromise = (async ()=>{
-                try {
-                    const store = await (synapseStorePromise instanceof Promise ? synapseStorePromise : Promise.resolve(synapseStorePromise));
-                    await store.storage.waitForReady();
-                    return store;
-                } catch (error) {
-                    handleOperationError('createSynapseCtx: Synapse storage initialization error', error);
-                }
-            })();
-        }
-        return storeInitPromise;
+    const { loadingComponent = /*#__PURE__*/ jsx("div", {
+        children: "Инициализация контекста..."
+    }) } = options || {};
+    // Lazy-инициализация: awaiter создаётся при первом обращении и сбрасывается при cleanup.
+    // Сам awaiter (createSynapseAwaiter) инкапсулирует ожидание готовности, статус и подписки.
+    let awaiter = null;
+    const getAwaiter = ()=>{
+        if (!awaiter) awaiter = createSynapseAwaiter(synapseStorePromise);
+        return awaiter;
     };
     const SynapseContext = /*#__PURE__*/ createContext(null);
     const useSynapseStorage = ()=>{
@@ -59,39 +58,41 @@ function createSynapseCtx(synapseStorePromise, options) {
    * Декоратор для обертывания компонентов в контекст Synapse
    */ function contextSynapse(Component) {
         const WrappedComponent = /*#__PURE__*/ forwardRef(function WrappedComponent(props, ref) {
-            const [synapseStore, setSynapseStore] = useState(null);
-            const [isReady, setIsReady] = useState(false);
-            const [error, setError] = useState(null);
+            const [synapseStore, setSynapseStore] = useState(()=>getAwaiter().getStoreIfReady());
+            const [error, setError] = useState(()=>getAwaiter().getError());
             useEffect(()=>{
-                let mounted = true;
-                const initializeContext = async ()=>{
-                    try {
-                        const store = await getStoreInitPromise();
-                        if (mounted) {
-                            setSynapseStore(store);
-                            setIsReady(true);
-                        }
-                    } catch (err) {
-                        if (mounted) {
-                            setError(err instanceof Error ? err : new Error(String(err)));
-                        }
-                    }
-                };
-                initializeContext();
+                // awaiter мог поменять состояние между рендером и эффектом — синхронизируемся
+                const instance = getAwaiter();
+                setSynapseStore(instance.getStoreIfReady());
+                setError(instance.getError());
+                const unsubscribeReady = instance.onReady((store)=>{
+                    setSynapseStore(store);
+                    setError(null);
+                });
+                const unsubscribeError = instance.onError((err)=>{
+                    setSynapseStore(undefined);
+                    setError(err);
+                });
                 return ()=>{
-                    mounted = false;
+                    unsubscribeReady();
+                    unsubscribeError();
                 };
             }, []);
             // Показываем ошибку если что-то пошло не так
-            if (error) return /*#__PURE__*/ React.createElement("div", null, `${ERROR_CONTEXT_INIT}: ${error.message}`);
-            // Показываем загрузку пока все не готово
-            if (!isReady || !synapseStore) return /*#__PURE__*/ React.createElement(React.Fragment, null, loadingComponent);
-            return /*#__PURE__*/ React.createElement(SynapseContext.Provider, {
-                value: synapseStore
-            }, /*#__PURE__*/ React.createElement(Component, {
-                ...props,
-                ref: ref
-            }));
+            if (error) return /*#__PURE__*/ jsx("div", {
+                children: `${ERROR_CONTEXT_INIT} ${error.message}`
+            });
+            // Показываем загрузку пока store не готов
+            if (!synapseStore) return /*#__PURE__*/ jsx(Fragment, {
+                children: loadingComponent
+            });
+            return /*#__PURE__*/ jsx(SynapseContext.Provider, {
+                value: synapseStore,
+                children: /*#__PURE__*/ jsx(Component, {
+                    ...props,
+                    ref: ref
+                })
+            });
         });
         // Устанавливаем отображаемое имя для отладки
         const componentName = Component.displayName || Component.name || 'Component';
@@ -113,14 +114,15 @@ function createSynapseCtx(synapseStorePromise, options) {
         return WrappedComponent;
     }
     const cleanupSynapse = async ()=>{
+        if (!awaiter) return;
+        const instance = awaiter;
+        awaiter = null; // сбрасываем сразу, чтобы следующий маунт создал новый awaiter
         try {
-            if (storeInitPromise) {
-                const store = await storeInitPromise;
-                storeInitPromise = null;
-                return store?.destroy() || Promise.resolve();
-            }
+            const store = instance.getStoreIfReady() ?? await instance.waitForReady();
+            instance.destroy();
+            await store?.destroy();
         } catch (error) {
-            storeInitPromise = null;
+            instance.destroy();
             handleCleanupError('createSynapseCtx: error during Synapse cleanup', error);
         }
     };

package/dist/react/utils/createSynapseCtx.js.map

@@ -1 +1 @@
-{"version":3,"file":"react/utils/createSynapseCtx.js","sources":["../../../src/react/utils/createSynapseCtx.tsx"],"sourcesContent":["import { ComponentType, createContext, forwardRef, PropsWithChildren, useContext, useEffect, useState } from 'react'\nimport { Observable } from 'rxjs'\n\nimport { handleCleanupError, handleOperationError } from '../../_utils/error-handling.util'\nimport { IStorage } from '../../core'\nimport { AnySynapseStore, SynapseStoreBasic, SynapseStoreWithDispatcher, SynapseStoreWithEffects } from '../../utils'\n\nconst ERROR_HOOK_MESSAGE = 'Хук необходимо использовать внутри компонента contextSynapse'\nconst ERROR_CONTEXT_INIT = 'Ошибка при инициализации контекста:'\n\ninterface SimplifiedOptions {\n  loadingComponent?: React.ReactNode\n}\n\n/**\n * Перегрузки для createSynapseCtx в зависимости от типа хранилища\n */\n\n// Для хранилища с effects\nexport function createSynapseCtx<TStore extends Record<string, any>, TStorage extends IStorage<TStore>, TSelectors, TActions>(\n  synapseStorePromise: Promise<SynapseStoreWithEffects<TStore, TStorage, TSelectors, TActions>> | SynapseStoreWithEffects<TStore, TStorage, TSelectors, TActions>,\n  options?: SimplifiedOptions,\n): {\n  contextSynapse: <SelfComponentProps>(Component: ComponentType<SelfComponentProps>) => ComponentType<SelfComponentProps>\n  useSynapseStorage: () => TStorage\n  useSynapseSelectors: () => TSelectors\n  useSynapseActions: () => TActions\n  useSynapseState$: () => Observable<TStore>\n  cleanupSynapse: () => Promise<void>\n}\n\n// Для хранилища с dispatcher (без effects)\nexport function createSynapseCtx<TStore extends Record<string, any>, TStorage extends IStorage<TStore>, TSelectors, TActions>(\n  synapseStorePromise: Promise<SynapseStoreWithDispatcher<TStore, TStorage, TSelectors, TActions>> | SynapseStoreWithDispatcher<TStore, TStorage, TSelectors, TActions>,\n  options?: SimplifiedOptions,\n): {\n  contextSynapse: <SelfComponentProps>(Component: ComponentType<SelfComponentProps>) => ComponentType<SelfComponentProps>\n  useSynapseStorage: () => TStorage\n  useSynapseSelectors: () => TSelectors\n  useSynapseActions: () => TActions\n  cleanupSynapse: () => Promise<void>\n}\n\n// Для базового хранилища\nexport function createSynapseCtx<TStore extends Record<string, any>, TStorage extends IStorage<TStore>, TSelectors>(\n  synapseStorePromise: Promise<SynapseStoreBasic<TStore, TStorage, TSelectors>> | SynapseStoreBasic<TStore, TStorage, TSelectors>,\n  options?: SimplifiedOptions,\n): {\n  contextSynapse: <SelfComponentProps>(Component: ComponentType<SelfComponentProps>) => ComponentType<SelfComponentProps>\n  useSynapseStorage: () => TStorage\n  useSynapseSelectors: () => TSelectors\n  cleanupSynapse: () => Promise<void>\n}\n\n// Основная реализация\nexport function createSynapseCtx<TStore extends Record<string, any>, TStorage extends IStorage<TStore>, TSelectors = any, TActions = any>(\n  synapseStorePromise: Promise<AnySynapseStore<TStore, TStorage, TSelectors, TActions>> | AnySynapseStore<TStore, TStorage, TSelectors, TActions>,\n  options?: SimplifiedOptions,\n) {\n  const { loadingComponent = <div>Инициализация контекста...</div> } = options || {}\n\n  // Lazy-инициализация: Promise создаётся при первом обращении и сбрасывается при cleanup\n  let storeInitPromise: Promise<AnySynapseStore<TStore, TStorage, TSelectors, TActions>> | null = null\n\n  const getStoreInitPromise = () => {\n    if (!storeInitPromise) {\n      storeInitPromise = (async () => {\n        try {\n          const store = await (synapseStorePromise instanceof Promise ? synapseStorePromise : Promise.resolve(synapseStorePromise))\n          await store.storage.waitForReady()\n          return store\n        } catch (error) {\n          handleOperationError('createSynapseCtx: Synapse storage initialization error', error)\n        }\n      })()\n    }\n    return storeInitPromise\n  }\n\n  const SynapseContext = createContext<AnySynapseStore<TStore, TStorage, TSelectors, TActions> | null>(null)\n\n  const useSynapseStorage = (): TStorage => {\n    const context = useContext(SynapseContext)\n    if (!context) throw new Error(`useSynapseStorage: ${ERROR_HOOK_MESSAGE}`)\n    return context.storage\n  }\n\n  const useSynapseSelectors = (): TSelectors => {\n    const context = useContext(SynapseContext)\n    if (!context) throw new Error(`useSynapseSelectors: ${ERROR_HOOK_MESSAGE}`)\n    return context.selectors\n  }\n\n  // Условный хук для actions (только если есть dispatcher)\n  const useSynapseActions = (): TActions => {\n    const context = useContext(SynapseContext)\n    if (!context) throw new Error(`useSynapseActions: ${ERROR_HOOK_MESSAGE}`)\n\n    if ('actions' in context) {\n      return (context as SynapseStoreWithDispatcher<TStore, TStorage, TSelectors, TActions> | SynapseStoreWithEffects<TStore, TStorage, TSelectors, TActions>).actions\n    }\n\n    throw new Error('useSynapseActions: actions недоступны для этого типа хранилища. Убедитесь, что передана функция createDispatcherFn при создании хранилища.')\n  }\n\n  // Условный хук для state$ (только если есть effects)\n  const useSynapseState$ = (): Observable<TStore> => {\n    const context = useContext(SynapseContext)\n    if (!context) throw new Error(`useSynapseState$: ${ERROR_HOOK_MESSAGE}`)\n\n    if ('state$' in context) {\n      return (context as SynapseStoreWithEffects<TStore, TStorage, TSelectors, TActions>).state$\n    }\n\n    throw new Error('useSynapseState$: state$ недоступен для этого типа хранилища. Убедитесь, что переданы функции createDispatcherFn и createEffectConfig при создании хранилища.')\n  }\n\n  /**\n   * Декоратор для обертывания компонентов в контекст Synapse\n   */\n  function contextSynapse<SelfComponentProps>(Component: ComponentType<SelfComponentProps>) {\n    const WrappedComponent = forwardRef<unknown, SelfComponentProps>(function WrappedComponent(props, ref) {\n      const [synapseStore, setSynapseStore] = useState<AnySynapseStore<TStore, TStorage, TSelectors, TActions> | null>(null)\n      const [isReady, setIsReady] = useState(false)\n      const [error, setError] = useState<Error | null>(null)\n\n      useEffect(() => {\n        let mounted = true\n\n        const initializeContext = async () => {\n          try {\n            const store = await getStoreInitPromise()\n\n            if (mounted) {\n              setSynapseStore(store)\n              setIsReady(true)\n            }\n          } catch (err) {\n            if (mounted) {\n              setError(err instanceof Error ? err : new Error(String(err)))\n            }\n          }\n        }\n\n        initializeContext()\n\n        return () => {\n          mounted = false\n        }\n      }, [])\n\n      // Показываем ошибку если что-то пошло не так\n      if (error) return <div>{`${ERROR_CONTEXT_INIT}: ${error.message}`}</div>\n\n      // Показываем загрузку пока все не готово\n      if (!isReady || !synapseStore) return <>{loadingComponent}</>\n\n      return (\n        <SynapseContext.Provider value={synapseStore}>\n          <Component {...(props as PropsWithChildren<SelfComponentProps>)} ref={ref} />\n        </SynapseContext.Provider>\n      )\n    })\n\n    // Устанавливаем отображаемое имя для отладки\n    const componentName = Component.displayName || Component.name || 'Component'\n    WrappedComponent.displayName = `SynapseContext(${componentName})`\n\n    // Копируем статические свойства оригинального компонента\n    const excludedKeys = new Set(['$$typeof', 'render', 'defaultProps', 'displayName', 'propTypes'])\n    Object.keys(Component).forEach((key) => {\n      if (!excludedKeys.has(key)) {\n        ;(WrappedComponent as any)[key] = (Component as any)[key]\n      }\n    })\n\n    return WrappedComponent as ComponentType<SelfComponentProps>\n  }\n\n  const cleanupSynapse = async (): Promise<void> => {\n    try {\n      if (storeInitPromise) {\n        const store = await storeInitPromise\n        storeInitPromise = null\n        return store?.destroy() || Promise.resolve()\n      }\n    } catch (error) {\n      storeInitPromise = null\n      handleCleanupError('createSynapseCtx: error during Synapse cleanup', error)\n    }\n  }\n\n  return {\n    contextSynapse,\n    useSynapseStorage,\n    useSynapseSelectors,\n    useSynapseActions,\n    useSynapseState$,\n    cleanupSynapse,\n  }\n}\n"],"names":["createContext","forwardRef","useContext","useEffect","useState","handleCleanupError","handleOperationError","ERROR_HOOK_MESSAGE","ERROR_CONTEXT_INIT","createSynapseCtx","synapseStorePromise","options","loadingComponent","storeInitPromise","getStoreInitPromise","store","Promise","error","SynapseContext","useSynapseStorage","context","Error","useSynapseSelectors","useSynapseActions","useSynapseState$","contextSynapse","Component","WrappedComponent","props","ref","synapseStore","setSynapseStore","isReady","setIsReady","setError","mounted","initializeContext","err","String","componentName","excludedKeys","Set","Object","key","cleanupSynapse"],"mappings":"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"}
+{"version":3,"file":"react/utils/createSynapseCtx.js","sources":["../../../src/react/utils/createSynapseCtx.tsx"],"sourcesContent":["import { ComponentType, createContext, forwardRef, PropsWithChildren, useContext, useEffect, useState } from 'react'\nimport { Observable } from 'rxjs'\n\nimport { handleCleanupError } from '../../_utils/error-handling.util'\nimport { IStorage } from '../../core'\nimport { AnySynapseStore, createSynapseAwaiter, SynapseStoreBasic, SynapseStoreWithDispatcher, SynapseStoreWithEffects } from '../../utils'\n\nconst ERROR_HOOK_MESSAGE = 'Хук необходимо использовать внутри компонента contextSynapse'\nconst ERROR_CONTEXT_INIT = 'Ошибка при инициализации контекста:'\n\ninterface SimplifiedOptions {\n  loadingComponent?: React.ReactNode\n}\n\n/**\n * Перегрузки для createSynapseCtx в зависимости от типа хранилища\n */\n\n// Для хранилища с effects\nexport function createSynapseCtx<TStore extends Record<string, any>, TStorage extends IStorage<TStore>, TSelectors, TActions>(\n  synapseStorePromise: Promise<SynapseStoreWithEffects<TStore, TStorage, TSelectors, TActions>> | SynapseStoreWithEffects<TStore, TStorage, TSelectors, TActions>,\n  options?: SimplifiedOptions,\n): {\n  contextSynapse: <SelfComponentProps>(Component: ComponentType<SelfComponentProps>) => ComponentType<SelfComponentProps>\n  useSynapseStorage: () => TStorage\n  useSynapseSelectors: () => TSelectors\n  useSynapseActions: () => TActions\n  useSynapseState$: () => Observable<TStore>\n  cleanupSynapse: () => Promise<void>\n}\n\n// Для хранилища с dispatcher (без effects)\nexport function createSynapseCtx<TStore extends Record<string, any>, TStorage extends IStorage<TStore>, TSelectors, TActions>(\n  synapseStorePromise: Promise<SynapseStoreWithDispatcher<TStore, TStorage, TSelectors, TActions>> | SynapseStoreWithDispatcher<TStore, TStorage, TSelectors, TActions>,\n  options?: SimplifiedOptions,\n): {\n  contextSynapse: <SelfComponentProps>(Component: ComponentType<SelfComponentProps>) => ComponentType<SelfComponentProps>\n  useSynapseStorage: () => TStorage\n  useSynapseSelectors: () => TSelectors\n  useSynapseActions: () => TActions\n  cleanupSynapse: () => Promise<void>\n}\n\n// Для базового хранилища\nexport function createSynapseCtx<TStore extends Record<string, any>, TStorage extends IStorage<TStore>, TSelectors>(\n  synapseStorePromise: Promise<SynapseStoreBasic<TStore, TStorage, TSelectors>> | SynapseStoreBasic<TStore, TStorage, TSelectors>,\n  options?: SimplifiedOptions,\n): {\n  contextSynapse: <SelfComponentProps>(Component: ComponentType<SelfComponentProps>) => ComponentType<SelfComponentProps>\n  useSynapseStorage: () => TStorage\n  useSynapseSelectors: () => TSelectors\n  cleanupSynapse: () => Promise<void>\n}\n\n// Основная реализация\nexport function createSynapseCtx<TStore extends Record<string, any>, TStorage extends IStorage<TStore>, TSelectors = any, TActions = any>(\n  synapseStorePromise: Promise<AnySynapseStore<TStore, TStorage, TSelectors, TActions>> | AnySynapseStore<TStore, TStorage, TSelectors, TActions>,\n  options?: SimplifiedOptions,\n) {\n  const { loadingComponent = <div>Инициализация контекста...</div> } = options || {}\n\n  // Lazy-инициализация: awaiter создаётся при первом обращении и сбрасывается при cleanup.\n  // Сам awaiter (createSynapseAwaiter) инкапсулирует ожидание готовности, статус и подписки.\n  let awaiter: ReturnType<typeof createSynapseAwaiter<TStore, TStorage, TSelectors, TActions>> | null = null\n\n  const getAwaiter = () => {\n    if (!awaiter) awaiter = createSynapseAwaiter(synapseStorePromise)\n    return awaiter\n  }\n\n  const SynapseContext = createContext<AnySynapseStore<TStore, TStorage, TSelectors, TActions> | null>(null)\n\n  const useSynapseStorage = (): TStorage => {\n    const context = useContext(SynapseContext)\n    if (!context) throw new Error(`useSynapseStorage: ${ERROR_HOOK_MESSAGE}`)\n    return context.storage\n  }\n\n  const useSynapseSelectors = (): TSelectors => {\n    const context = useContext(SynapseContext)\n    if (!context) throw new Error(`useSynapseSelectors: ${ERROR_HOOK_MESSAGE}`)\n    return context.selectors\n  }\n\n  // Условный хук для actions (только если есть dispatcher)\n  const useSynapseActions = (): TActions => {\n    const context = useContext(SynapseContext)\n    if (!context) throw new Error(`useSynapseActions: ${ERROR_HOOK_MESSAGE}`)\n\n    if ('actions' in context) {\n      return (context as SynapseStoreWithDispatcher<TStore, TStorage, TSelectors, TActions> | SynapseStoreWithEffects<TStore, TStorage, TSelectors, TActions>).actions\n    }\n\n    throw new Error('useSynapseActions: actions недоступны для этого типа хранилища. Убедитесь, что передана функция createDispatcherFn при создании хранилища.')\n  }\n\n  // Условный хук для state$ (только если есть effects)\n  const useSynapseState$ = (): Observable<TStore> => {\n    const context = useContext(SynapseContext)\n    if (!context) throw new Error(`useSynapseState$: ${ERROR_HOOK_MESSAGE}`)\n\n    if ('state$' in context) {\n      return (context as SynapseStoreWithEffects<TStore, TStorage, TSelectors, TActions>).state$\n    }\n\n    throw new Error('useSynapseState$: state$ недоступен для этого типа хранилища. Убедитесь, что переданы функции createDispatcherFn и createEffectConfig при создании хранилища.')\n  }\n\n  /**\n   * Декоратор для обертывания компонентов в контекст Synapse\n   */\n  function contextSynapse<SelfComponentProps>(Component: ComponentType<SelfComponentProps>) {\n    const WrappedComponent = forwardRef<unknown, SelfComponentProps>(function WrappedComponent(props, ref) {\n      const [synapseStore, setSynapseStore] = useState<AnySynapseStore<TStore, TStorage, TSelectors, TActions> | undefined>(() => getAwaiter().getStoreIfReady())\n      const [error, setError] = useState<Error | null>(() => getAwaiter().getError())\n\n      useEffect(() => {\n        // awaiter мог поменять состояние между рендером и эффектом — синхронизируемся\n        const instance = getAwaiter()\n        setSynapseStore(instance.getStoreIfReady())\n        setError(instance.getError())\n\n        const unsubscribeReady = instance.onReady((store) => {\n          setSynapseStore(store)\n          setError(null)\n        })\n        const unsubscribeError = instance.onError((err) => {\n          setSynapseStore(undefined)\n          setError(err)\n        })\n\n        return () => {\n          unsubscribeReady()\n          unsubscribeError()\n        }\n      }, [])\n\n      // Показываем ошибку если что-то пошло не так\n      if (error) return <div>{`${ERROR_CONTEXT_INIT} ${error.message}`}</div>\n\n      // Показываем загрузку пока store не готов\n      if (!synapseStore) return <>{loadingComponent}</>\n\n      return (\n        <SynapseContext.Provider value={synapseStore}>\n          <Component {...(props as PropsWithChildren<SelfComponentProps>)} ref={ref} />\n        </SynapseContext.Provider>\n      )\n    })\n\n    // Устанавливаем отображаемое имя для отладки\n    const componentName = Component.displayName || Component.name || 'Component'\n    WrappedComponent.displayName = `SynapseContext(${componentName})`\n\n    // Копируем статические свойства оригинального компонента\n    const excludedKeys = new Set(['$$typeof', 'render', 'defaultProps', 'displayName', 'propTypes'])\n    Object.keys(Component).forEach((key) => {\n      if (!excludedKeys.has(key)) {\n        ;(WrappedComponent as any)[key] = (Component as any)[key]\n      }\n    })\n\n    return WrappedComponent as ComponentType<SelfComponentProps>\n  }\n\n  const cleanupSynapse = async (): Promise<void> => {\n    if (!awaiter) return\n\n    const instance = awaiter\n    awaiter = null // сбрасываем сразу, чтобы следующий маунт создал новый awaiter\n\n    try {\n      const store = instance.getStoreIfReady() ?? (await instance.waitForReady())\n      instance.destroy()\n      await store?.destroy()\n    } catch (error) {\n      instance.destroy()\n      handleCleanupError('createSynapseCtx: error during Synapse cleanup', error)\n    }\n  }\n\n  return {\n    contextSynapse,\n    useSynapseStorage,\n    useSynapseSelectors,\n    useSynapseActions,\n    useSynapseState$,\n    cleanupSynapse,\n  }\n}\n"],"names":["createContext","forwardRef","useContext","useEffect","useState","handleCleanupError","createSynapseAwaiter","ERROR_HOOK_MESSAGE","ERROR_CONTEXT_INIT","createSynapseCtx","synapseStorePromise","options","loadingComponent","awaiter","getAwaiter","SynapseContext","useSynapseStorage","context","Error","useSynapseSelectors","useSynapseActions","useSynapseState$","contextSynapse","Component","WrappedComponent","props","ref","synapseStore","setSynapseStore","error","setError","instance","unsubscribeReady","store","unsubscribeError","err","undefined","componentName","excludedKeys","Set","Object","key","cleanupSynapse"],"mappings":"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"}

package/dist/reactive/dispatcher/standalone.d.ts

@@ -30,10 +30,29 @@ export interface WatcherRecipe<TState extends Record<string, any>, R> {
     };
 }
 /**
- * Состояние API-запроса для createApiActions
+ * Статусы жизненного цикла API-запроса.
+ *
+ * Сделано const-объектом (а не TS `enum`) намеренно: значения остаются обычными
+ * строковыми литералами, поэтому `ApiStatus.Loading` и строка `'loading'`
+ * взаимозаменяемы и тип обратно совместим с прежним строковым union'ом. С `enum`
+ * это не так — его член не присваивается к литералу и наоборот.
+ *
+ * `ApiStatus` — одновременно значение (для `ApiStatus.Loading` в коде) и тип
+ * (union всех статусов).
+ */
+export declare const ApiStatus: {
+    readonly Idle: "idle";
+    readonly Loading: "loading";
+    readonly Success: "success";
+    readonly Error: "error";
+    readonly Reset: "reset";
+};
+export type ApiStatus = (typeof ApiStatus)[keyof typeof ApiStatus];
+/**
+ * Состояние API-запроса для createApiActions / createKeyedApiActions
  */
 export interface ApiRequestState {
-    status: 'idle' | 'loading' | 'success' | 'error' | 'reset';
+    status: ApiStatus;
     error: string | null;
 }
 /**
@@ -86,6 +105,11 @@ export declare function defineWatcher<TState extends Record<string, any>>(): <R>
  *
  * @param accessor - Функция-accessor, указывающая на поле ApiRequestState в стейте
  *
+ * @typeParam TInitPayload - Тип payload'а `init`-экшена. По умолчанию `void`
+ *   (init без параметров). Если задать — `init` принимает payload и возвращает
+ *   его, что удобно для intent-паттерна: эффект слушает `init` и читает payload
+ *   намерения (target, фильтры и т.п.), а статус при этом сбрасывается в `idle`.
+ *
  * @example
  * ```ts
  * const listRequest = createApiActions<MyState>(
@@ -100,13 +124,58 @@ export declare function defineWatcher<TState extends Record<string, any>>(): <R>
  *   loadListFailure: listRequest.failure,
  *   loadListReset:   listRequest.reset,
  * })
+ *
+ * // init с payload (intent): эффект получит { entityId } из возврата экшена.
+ * const usersReq = createApiActions<MyState, { entityId: string }>(
+ *   (draft) => draft.api.usersRequest
+ * )
  * ```
  */
-export declare function createApiActions<TState extends Record<string, any>>(accessor: (draft: TState) => ApiRequestState): {
-    init: ActionRecipe<TState, void, void>;
+export declare function createApiActions<TState extends Record<string, any>, TInitPayload = void>(accessor: (draft: TState) => ApiRequestState): {
+    init: ActionRecipe<TState, TInitPayload, TInitPayload>;
     loading: ActionRecipe<TState, void, void>;
     success: ActionRecipe<TState, void, void>;
     failure: ActionRecipe<TState, string, void>;
     reset: ActionRecipe<TState, void, void>;
 };
+/**
+ * Keyed-вариант createApiActions: статус хранится ПО КЛЮЧУ в `Record<string,
+ * ApiRequestState>`, а не один на весь запрос. Нужен, когда один и тот же запрос
+ * летит параллельно для нескольких независимых ключей и у каждого свой
+ * loading/error: комменты по таргетам, детали сущностей по id, per-row действия
+ * в таблице/ленте, пагинация по секциям — всё, что лежит как `Record<key, data>`.
+ *
+ * Все статус-экшены принимают `key` (и возвращают его — удобно эффектам), кроме
+ * `failure`, который принимает `{ key, error }`. Записи мутируются иммутабельно
+ * по одному ключу — соседние ключи (их срезы) по ссылке не затрагиваются, что и
+ * нужно для гранулярной изоляции ре-рендеров (см. useKeyedSliceSelector).
+ *
+ * @param accessor - Функция-accessor, указывающая на поле `Record<string, ApiRequestState>`
+ *
+ * @example
+ * ```ts
+ * const commentsReq = createKeyedApiActions<MyState>((d) => d.api.commentsRequest)
+ *
+ * createDispatcher({ storage }, {
+ *   commentsInit:    commentsReq.init,     // (key) => key
+ *   commentsLoading: commentsReq.loading,  // (key) => key
+ *   commentsSuccess: commentsReq.success,  // (key) => key
+ *   commentsFailure: commentsReq.failure,  // ({ key, error })
+ *   commentsReset:   commentsReq.reset,    // (key) => key
+ * })
+ * ```
+ */
+export declare function createKeyedApiActions<TState extends Record<string, any>>(accessor: (draft: TState) => Record<string, ApiRequestState>): {
+    init: ActionRecipe<TState, string, string>;
+    loading: ActionRecipe<TState, string, string>;
+    success: ActionRecipe<TState, string, string>;
+    reset: ActionRecipe<TState, string, string>;
+    failure: ActionRecipe<TState, {
+        key: string;
+        error: string;
+    }, {
+        key: string;
+        error: string;
+    }>;
+};
 //# sourceMappingURL=standalone.d.ts.map

package/dist/reactive/dispatcher/standalone.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"standalone.d.ts","sourceRoot":"","sources":["../../../src/reactive/dispatcher/standalone.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"standalone.d.ts","sourceRoot":"","sources":["../../../src/reactive/dispatcher/standalone.ts"],"names":[],"mappings":"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"}

package/dist/reactive/dispatcher/standalone.js

@@ -1,3 +1,20 @@
+/**
+ * Статусы жизненного цикла API-запроса.
+ *
+ * Сделано const-объектом (а не TS `enum`) намеренно: значения остаются обычными
+ * строковыми литералами, поэтому `ApiStatus.Loading` и строка `'loading'`
+ * взаимозаменяемы и тип обратно совместим с прежним строковым union'ом. С `enum`
+ * это не так — его член не присваивается к литералу и наоборот.
+ *
+ * `ApiStatus` — одновременно значение (для `ApiStatus.Loading` в коде) и тип
+ * (union всех статусов).
+ */ const ApiStatus = {
+    Idle: 'idle',
+    Loading: 'loading',
+    Success: 'success',
+    Error: 'error',
+    Reset: 'reset'
+};
 // ────────────────────────────────────────────────────────────────────────────
 // defineAction
 // ────────────────────────────────────────────────────────────────────────────
@@ -82,6 +99,11 @@
  *
  * @param accessor - Функция-accessor, указывающая на поле ApiRequestState в стейте
  *
+ * @typeParam TInitPayload - Тип payload'а `init`-экшена. По умолчанию `void`
+ *   (init без параметров). Если задать — `init` принимает payload и возвращает
+ *   его, что удобно для intent-паттерна: эффект слушает `init` и читает payload
+ *   намерения (target, фильтры и т.п.), а статус при этом сбрасывается в `idle`.
+ *
  * @example
  * ```ts
  * const listRequest = createApiActions<MyState>(
@@ -96,6 +118,11 @@
  *   loadListFailure: listRequest.failure,
  *   loadListReset:   listRequest.reset,
  * })
+ *
+ * // init с payload (intent): эффект получит { entityId } из возврата экшена.
+ * const usersReq = createApiActions<MyState, { entityId: string }>(
+ *   (draft) => draft.api.usersRequest
+ * )
  * ```
  */ function createApiActions(accessor) {
     const path = resolvePath(accessor);
@@ -105,38 +132,106 @@
     };
     return {
         init: action({
-            action: (storage)=>update(storage, {
-                    status: 'idle',
+            // Сбрасываем статус в idle и пробрасываем payload намерения дальше (эффектам).
+            action: (storage, payload)=>{
+                update(storage, {
+                    status: ApiStatus.Idle,
                     error: null
-                })
+                });
+                return payload;
+            }
         }),
         loading: action({
             action: (storage)=>update(storage, {
-                    status: 'loading',
+                    status: ApiStatus.Loading,
                     error: null
                 })
         }),
         success: action({
             action: (storage)=>update(storage, {
-                    status: 'success',
+                    status: ApiStatus.Success,
                     error: null
                 })
         }),
         failure: action({
             action: (storage, error)=>update(storage, {
-                    status: 'error',
+                    status: ApiStatus.Error,
                     error
                 })
         }),
         reset: action({
             action: (storage)=>update(storage, {
-                    status: 'reset',
+                    status: ApiStatus.Reset,
                     error: null
                 })
         })
     };
 }
+// ────────────────────────────────────────────────────────────────────────────
+// createKeyedApiActions
+// ────────────────────────────────────────────────────────────────────────────
+/**
+ * Keyed-вариант createApiActions: статус хранится ПО КЛЮЧУ в `Record<string,
+ * ApiRequestState>`, а не один на весь запрос. Нужен, когда один и тот же запрос
+ * летит параллельно для нескольких независимых ключей и у каждого свой
+ * loading/error: комменты по таргетам, детали сущностей по id, per-row действия
+ * в таблице/ленте, пагинация по секциям — всё, что лежит как `Record<key, data>`.
+ *
+ * Все статус-экшены принимают `key` (и возвращают его — удобно эффектам), кроме
+ * `failure`, который принимает `{ key, error }`. Записи мутируются иммутабельно
+ * по одному ключу — соседние ключи (их срезы) по ссылке не затрагиваются, что и
+ * нужно для гранулярной изоляции ре-рендеров (см. useKeyedSliceSelector).
+ *
+ * @param accessor - Функция-accessor, указывающая на поле `Record<string, ApiRequestState>`
+ *
+ * @example
+ * ```ts
+ * const commentsReq = createKeyedApiActions<MyState>((d) => d.api.commentsRequest)
+ *
+ * createDispatcher({ storage }, {
+ *   commentsInit:    commentsReq.init,     // (key) => key
+ *   commentsLoading: commentsReq.loading,  // (key) => key
+ *   commentsSuccess: commentsReq.success,  // (key) => key
+ *   commentsFailure: commentsReq.failure,  // ({ key, error })
+ *   commentsReset:   commentsReq.reset,    // (key) => key
+ * })
+ * ```
+ */ function createKeyedApiActions(accessor) {
+    const path = resolvePath(accessor);
+    const action = defineAction();
+    const write = (storage, key, request)=>{
+        // [...path, key] → setByPath доходит до самого Record и кладёт значение по ключу
+        storage.update((s)=>setByPath(s, [
+                ...path,
+                key
+            ], request));
+    };
+    const writer = (status)=>action({
+            action: (storage, key)=>{
+                write(storage, key, {
+                    status,
+                    error: null
+                });
+                return key;
+            }
+        });
+    return {
+        init: writer(ApiStatus.Idle),
+        loading: writer(ApiStatus.Loading),
+        success: writer(ApiStatus.Success),
+        reset: writer(ApiStatus.Reset),
+        failure: action({
+            action: (storage, payload)=>{
+                write(storage, payload.key, {
+                    status: ApiStatus.Error,
+                    error: payload.error
+                });
+                return payload;
+            }
+        })
+    };
+}
 
-export { createApiActions, defineAction, defineWatcher };
+export { ApiStatus, createApiActions, createKeyedApiActions, defineAction, defineWatcher };
 
 //# sourceMappingURL=standalone.js.map

package/dist/reactive/dispatcher/standalone.js.map

@@ -1 +1 @@
-{"version":3,"file":"reactive/dispatcher/standalone.js","sources":["../../../src/reactive/dispatcher/standalone.ts"],"sourcesContent":["import type { IStorage } from '../../core'\n\n// ────────────────────────────────────────────────────────────────────────────\n// Types\n// ────────────────────────────────────────────────────────────────────────────\n\n/**\n * Параметры исполнения действия (мемоизация)\n */\nexport interface ActionExecutionOptions<TParams, TResult> {\n  memoize?: (currentArgs: TParams, previousArgs: TParams, previousResult: TResult) => boolean\n}\n\n/**\n * Рецепт действия — standalone-определение, не привязанное к хранилищу.\n * Привязывается к storage при регистрации в createDispatcher.\n */\nexport interface ActionRecipe<TState extends Record<string, any>, TParams, TResult> {\n  readonly _type: 'action-recipe'\n  readonly _config: {\n    action: (storage: IStorage<TState>, params: TParams) => Promise<TResult> | TResult\n    meta?: Record<string, any>\n  }\n  readonly _executionOptions?: ActionExecutionOptions<TParams, TResult>\n}\n\n/**\n * Рецепт watcher'а — standalone-определение, не привязанное к хранилищу.\n */\nexport interface WatcherRecipe<TState extends Record<string, any>, R> {\n  readonly _type: 'watcher-recipe'\n  readonly _config: {\n    selector: (state: TState) => R\n    meta?: Record<string, any>\n    shouldTrigger?: (prev: R | undefined, current: R) => boolean\n    notifyAfterSubscribe?: boolean\n  }\n}\n\n/**\n * Состояние API-запроса для createApiActions\n */\nexport interface ApiRequestState {\n  status: 'idle' | 'loading' | 'success' | 'error' | 'reset'\n  error: string | null\n}\n\n// ────────────────────────────────────────────────────────────────────────────\n// defineAction\n// ────────────────────────────────────────────────────────────────────────────\n\n/**\n * Создаёт standalone-определение действия.\n * Фиксирует TState через первый вызов, TParams/TResult инферятся из action.\n *\n * @example\n * ```ts\n * const action = defineAction<MyState>()\n *\n * export const increment = action({\n *   action: (storage, amount: number) => {\n *     storage.update((s) => { s.count += amount })\n *     return amount\n *   },\n * })\n *\n * // Void action (без параметров и возврата):\n * export const reset = action({\n *   action: (storage) => {\n *     storage.update((s) => { s.count = 0 })\n *   },\n * })\n * ```\n */\nexport function defineAction<TState extends Record<string, any>>() {\n  return <TParams = void, TResult = void>(\n    config: {\n      action: (storage: IStorage<TState>, params: TParams) => Promise<TResult> | TResult\n      meta?: Record<string, any>\n    },\n    executionOptions?: ActionExecutionOptions<TParams, TResult>,\n  ): ActionRecipe<TState, TParams, TResult> => ({\n    _type: 'action-recipe' as const,\n    _config: config,\n    _executionOptions: executionOptions,\n  })\n}\n\n// ────────────────────────────────────────────────────────────────────────────\n// defineWatcher\n// ────────────────────────────────────────────────────────────────────────────\n\n/**\n * Создаёт standalone-определение watcher'а.\n *\n * @example\n * ```ts\n * export const watchCount = defineWatcher<MyState>()({\n *   selector: (s) => s.items.length,\n *   notifyAfterSubscribe: true,\n * })\n * ```\n */\nexport function defineWatcher<TState extends Record<string, any>>() {\n  return <R>(config: {\n    selector: (state: TState) => R\n    meta?: Record<string, any>\n    shouldTrigger?: (prev: R | undefined, current: R) => boolean\n    notifyAfterSubscribe?: boolean\n  }): WatcherRecipe<TState, R> => ({\n    _type: 'watcher-recipe' as const,\n    _config: config,\n  })\n}\n\n// ────────────────────────────────────────────────────────────────────────────\n// createApiActions\n// ────────────────────────────────────────────────────────────────────────────\n\n/**\n * Вычисляет путь к свойству через Proxy-перехват обращений.\n */\nfunction resolvePath<T>(accessor: (draft: T) => any): string[] {\n  const path: string[] = []\n  const handler: ProxyHandler<any> = {\n    get(_, prop) {\n      if (typeof prop === 'string') {\n        path.push(prop)\n      }\n      return new Proxy({}, handler)\n    },\n  }\n  accessor(new Proxy({}, handler) as T)\n  return path\n}\n\n/**\n * Записывает значение по пути в объекте.\n */\nfunction setByPath(obj: any, path: string[], value: any): void {\n  let current = obj\n  for (let i = 0; i < path.length - 1; i++) {\n    current = current[path[i]]\n  }\n  current[path[path.length - 1]] = value\n}\n\n/**\n * Создаёт набор шаблонных lifecycle-действий для API-запроса.\n * Accessor указывает на поле ApiRequestState в стейте — путь вычисляется автоматически.\n *\n * @param accessor - Функция-accessor, указывающая на поле ApiRequestState в стейте\n *\n * @example\n * ```ts\n * const listRequest = createApiActions<MyState>(\n *   (draft) => draft.api.listRequest\n * )\n *\n * // В dispatcher:\n * createDispatcher({ storage }, {\n *   loadListInit:    listRequest.init,\n *   loadListLoading: listRequest.loading,\n *   loadListSuccess: listRequest.success,\n *   loadListFailure: listRequest.failure,\n *   loadListReset:   listRequest.reset,\n * })\n * ```\n */\nexport function createApiActions<TState extends Record<string, any>>(accessor: (draft: TState) => ApiRequestState) {\n  const path = resolvePath(accessor)\n  const action = defineAction<TState>()\n\n  const update = (storage: IStorage<TState>, request: ApiRequestState) => {\n    storage.update((s) => setByPath(s, path, request))\n  }\n\n  return {\n    init: action({\n      action: (storage) => update(storage, { status: 'idle', error: null }),\n    }),\n\n    loading: action({\n      action: (storage) => update(storage, { status: 'loading', error: null }),\n    }),\n\n    success: action({\n      action: (storage) => update(storage, { status: 'success', error: null }),\n    }),\n\n    failure: action({\n      action: (storage, error: string) => update(storage, { status: 'error', error }),\n    }),\n\n    reset: action({\n      action: (storage) => update(storage, { status: 'reset', error: null }),\n    }),\n  }\n}\n"],"names":["defineAction","config","executionOptions","defineWatcher","resolvePath","accessor","path","handler","_","prop","Proxy","setByPath","obj","value","current","i","createApiActions","action","update","storage","request","s","error"],"mappings":"AA+CA,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;CAsBC,GACM,SAASA,YAAYA;IAC1B,OAAO,CACLC,QAIAC,mBAC4C;YAC5C,OAAO;YACP,SAASD;YACT,mBAAmBC;QACrB;AACF;AAEA,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E;;;;;;;;;;CAUC,GACM,SAASC,aAAaA;IAC3B,OAAO,CAAIF,SAKsB;YAC/B,OAAO;YACP,SAASA;QACX;AACF;AAEA,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;CAEC,GACD,SAASG,WAAWA,CAAIC,QAA2B;IACjD,MAAMC,OAAiB,EAAE;IACzB,MAAMC,UAA6B;QACjC,KAAIC,CAAC,EAAEC,IAAI;YACT,IAAI,OAAOA,SAAS,UAAU;gBAC5BH,KAAK,IAAI,CAACG;YACZ;YACA,OAAO,IAAIC,MAAM,CAAC,GAAGH;QACvB;IACF;IACAF,SAAS,IAAIK,MAAM,CAAC,GAAGH;IACvB,OAAOD;AACT;AAEA;;CAEC,GACD,SAASK,SAASA,CAACC,GAAQ,EAAEN,IAAc,EAAEO,KAAU;IACrD,IAAIC,UAAUF;IACd,IAAK,IAAIG,IAAI,GAAGA,IAAIT,KAAK,MAAM,GAAG,GAAGS,IAAK;QACxCD,UAAUA,OAAO,CAACR,IAAI,CAACS,EAAE,CAAC;IAC5B;IACAD,OAAO,CAACR,IAAI,CAACA,KAAK,MAAM,GAAG,EAAE,CAAC,GAAGO;AACnC;AAEA;;;;;;;;;;;;;;;;;;;;;CAqBC,GACM,SAASG,gBAAgBA,CAAqCX,QAA4C;IAC/G,MAAMC,OAAOF,WAAWA,CAACC;IACzB,MAAMY,SAASjB,YAAYA;IAE3B,MAAMkB,SAAS,CAACC,SAA2BC;QACzCD,QAAQ,MAAM,CAAC,CAACE,IAAMV,SAASA,CAACU,GAAGf,MAAMc;IAC3C;IAEA,OAAO;QACL,MAAMH,OAAO;YACX,QAAQ,CAACE,UAAYD,OAAOC,SAAS;oBAAE,QAAQ;oBAAQ,OAAO;gBAAK;QACrE;QAEA,SAASF,OAAO;YACd,QAAQ,CAACE,UAAYD,OAAOC,SAAS;oBAAE,QAAQ;oBAAW,OAAO;gBAAK;QACxE;QAEA,SAASF,OAAO;YACd,QAAQ,CAACE,UAAYD,OAAOC,SAAS;oBAAE,QAAQ;oBAAW,OAAO;gBAAK;QACxE;QAEA,SAASF,OAAO;YACd,QAAQ,CAACE,SAASG,QAAkBJ,OAAOC,SAAS;oBAAE,QAAQ;oBAASG;gBAAM;QAC/E;QAEA,OAAOL,OAAO;YACZ,QAAQ,CAACE,UAAYD,OAAOC,SAAS;oBAAE,QAAQ;oBAAS,OAAO;gBAAK;QACtE;IACF;AACF"}
+{"version":3,"file":"reactive/dispatcher/standalone.js","sources":["../../../src/reactive/dispatcher/standalone.ts"],"sourcesContent":["import type { IStorage } from '../../core'\n\n// ────────────────────────────────────────────────────────────────────────────\n// Types\n// ────────────────────────────────────────────────────────────────────────────\n\n/**\n * Параметры исполнения действия (мемоизация)\n */\nexport interface ActionExecutionOptions<TParams, TResult> {\n  memoize?: (currentArgs: TParams, previousArgs: TParams, previousResult: TResult) => boolean\n}\n\n/**\n * Рецепт действия — standalone-определение, не привязанное к хранилищу.\n * Привязывается к storage при регистрации в createDispatcher.\n */\nexport interface ActionRecipe<TState extends Record<string, any>, TParams, TResult> {\n  readonly _type: 'action-recipe'\n  readonly _config: {\n    action: (storage: IStorage<TState>, params: TParams) => Promise<TResult> | TResult\n    meta?: Record<string, any>\n  }\n  readonly _executionOptions?: ActionExecutionOptions<TParams, TResult>\n}\n\n/**\n * Рецепт watcher'а — standalone-определение, не привязанное к хранилищу.\n */\nexport interface WatcherRecipe<TState extends Record<string, any>, R> {\n  readonly _type: 'watcher-recipe'\n  readonly _config: {\n    selector: (state: TState) => R\n    meta?: Record<string, any>\n    shouldTrigger?: (prev: R | undefined, current: R) => boolean\n    notifyAfterSubscribe?: boolean\n  }\n}\n\n/**\n * Статусы жизненного цикла API-запроса.\n *\n * Сделано const-объектом (а не TS `enum`) намеренно: значения остаются обычными\n * строковыми литералами, поэтому `ApiStatus.Loading` и строка `'loading'`\n * взаимозаменяемы и тип обратно совместим с прежним строковым union'ом. С `enum`\n * это не так — его член не присваивается к литералу и наоборот.\n *\n * `ApiStatus` — одновременно значение (для `ApiStatus.Loading` в коде) и тип\n * (union всех статусов).\n */\nexport const ApiStatus = {\n  Idle: 'idle',\n  Loading: 'loading',\n  Success: 'success',\n  Error: 'error',\n  Reset: 'reset',\n} as const\n\nexport type ApiStatus = (typeof ApiStatus)[keyof typeof ApiStatus]\n\n/**\n * Состояние API-запроса для createApiActions / createKeyedApiActions\n */\nexport interface ApiRequestState {\n  status: ApiStatus\n  error: string | null\n}\n\n// ────────────────────────────────────────────────────────────────────────────\n// defineAction\n// ────────────────────────────────────────────────────────────────────────────\n\n/**\n * Создаёт standalone-определение действия.\n * Фиксирует TState через первый вызов, TParams/TResult инферятся из action.\n *\n * @example\n * ```ts\n * const action = defineAction<MyState>()\n *\n * export const increment = action({\n *   action: (storage, amount: number) => {\n *     storage.update((s) => { s.count += amount })\n *     return amount\n *   },\n * })\n *\n * // Void action (без параметров и возврата):\n * export const reset = action({\n *   action: (storage) => {\n *     storage.update((s) => { s.count = 0 })\n *   },\n * })\n * ```\n */\nexport function defineAction<TState extends Record<string, any>>() {\n  return <TParams = void, TResult = void>(\n    config: {\n      action: (storage: IStorage<TState>, params: TParams) => Promise<TResult> | TResult\n      meta?: Record<string, any>\n    },\n    executionOptions?: ActionExecutionOptions<TParams, TResult>,\n  ): ActionRecipe<TState, TParams, TResult> => ({\n    _type: 'action-recipe' as const,\n    _config: config,\n    _executionOptions: executionOptions,\n  })\n}\n\n// ────────────────────────────────────────────────────────────────────────────\n// defineWatcher\n// ────────────────────────────────────────────────────────────────────────────\n\n/**\n * Создаёт standalone-определение watcher'а.\n *\n * @example\n * ```ts\n * export const watchCount = defineWatcher<MyState>()({\n *   selector: (s) => s.items.length,\n *   notifyAfterSubscribe: true,\n * })\n * ```\n */\nexport function defineWatcher<TState extends Record<string, any>>() {\n  return <R>(config: {\n    selector: (state: TState) => R\n    meta?: Record<string, any>\n    shouldTrigger?: (prev: R | undefined, current: R) => boolean\n    notifyAfterSubscribe?: boolean\n  }): WatcherRecipe<TState, R> => ({\n    _type: 'watcher-recipe' as const,\n    _config: config,\n  })\n}\n\n// ────────────────────────────────────────────────────────────────────────────\n// createApiActions\n// ────────────────────────────────────────────────────────────────────────────\n\n/**\n * Вычисляет путь к свойству через Proxy-перехват обращений.\n */\nfunction resolvePath<T>(accessor: (draft: T) => any): string[] {\n  const path: string[] = []\n  const handler: ProxyHandler<any> = {\n    get(_, prop) {\n      if (typeof prop === 'string') {\n        path.push(prop)\n      }\n      return new Proxy({}, handler)\n    },\n  }\n  accessor(new Proxy({}, handler) as T)\n  return path\n}\n\n/**\n * Записывает значение по пути в объекте.\n */\nfunction setByPath(obj: any, path: string[], value: any): void {\n  let current = obj\n  for (let i = 0; i < path.length - 1; i++) {\n    current = current[path[i]]\n  }\n  current[path[path.length - 1]] = value\n}\n\n/**\n * Создаёт набор шаблонных lifecycle-действий для API-запроса.\n * Accessor указывает на поле ApiRequestState в стейте — путь вычисляется автоматически.\n *\n * @param accessor - Функция-accessor, указывающая на поле ApiRequestState в стейте\n *\n * @typeParam TInitPayload - Тип payload'а `init`-экшена. По умолчанию `void`\n *   (init без параметров). Если задать — `init` принимает payload и возвращает\n *   его, что удобно для intent-паттерна: эффект слушает `init` и читает payload\n *   намерения (target, фильтры и т.п.), а статус при этом сбрасывается в `idle`.\n *\n * @example\n * ```ts\n * const listRequest = createApiActions<MyState>(\n *   (draft) => draft.api.listRequest\n * )\n *\n * // В dispatcher:\n * createDispatcher({ storage }, {\n *   loadListInit:    listRequest.init,\n *   loadListLoading: listRequest.loading,\n *   loadListSuccess: listRequest.success,\n *   loadListFailure: listRequest.failure,\n *   loadListReset:   listRequest.reset,\n * })\n *\n * // init с payload (intent): эффект получит { entityId } из возврата экшена.\n * const usersReq = createApiActions<MyState, { entityId: string }>(\n *   (draft) => draft.api.usersRequest\n * )\n * ```\n */\nexport function createApiActions<TState extends Record<string, any>, TInitPayload = void>(accessor: (draft: TState) => ApiRequestState) {\n  const path = resolvePath(accessor)\n  const action = defineAction<TState>()\n\n  const update = (storage: IStorage<TState>, request: ApiRequestState) => {\n    storage.update((s) => setByPath(s, path, request))\n  }\n\n  return {\n    init: action<TInitPayload, TInitPayload>({\n      // Сбрасываем статус в idle и пробрасываем payload намерения дальше (эффектам).\n      action: (storage, payload: TInitPayload) => {\n        update(storage, { status: ApiStatus.Idle, error: null })\n        return payload\n      },\n    }),\n\n    loading: action({\n      action: (storage) => update(storage, { status: ApiStatus.Loading, error: null }),\n    }),\n\n    success: action({\n      action: (storage) => update(storage, { status: ApiStatus.Success, error: null }),\n    }),\n\n    failure: action({\n      action: (storage, error: string) => update(storage, { status: ApiStatus.Error, error }),\n    }),\n\n    reset: action({\n      action: (storage) => update(storage, { status: ApiStatus.Reset, error: null }),\n    }),\n  }\n}\n\n// ────────────────────────────────────────────────────────────────────────────\n// createKeyedApiActions\n// ────────────────────────────────────────────────────────────────────────────\n\n/**\n * Keyed-вариант createApiActions: статус хранится ПО КЛЮЧУ в `Record<string,\n * ApiRequestState>`, а не один на весь запрос. Нужен, когда один и тот же запрос\n * летит параллельно для нескольких независимых ключей и у каждого свой\n * loading/error: комменты по таргетам, детали сущностей по id, per-row действия\n * в таблице/ленте, пагинация по секциям — всё, что лежит как `Record<key, data>`.\n *\n * Все статус-экшены принимают `key` (и возвращают его — удобно эффектам), кроме\n * `failure`, который принимает `{ key, error }`. Записи мутируются иммутабельно\n * по одному ключу — соседние ключи (их срезы) по ссылке не затрагиваются, что и\n * нужно для гранулярной изоляции ре-рендеров (см. useKeyedSliceSelector).\n *\n * @param accessor - Функция-accessor, указывающая на поле `Record<string, ApiRequestState>`\n *\n * @example\n * ```ts\n * const commentsReq = createKeyedApiActions<MyState>((d) => d.api.commentsRequest)\n *\n * createDispatcher({ storage }, {\n *   commentsInit:    commentsReq.init,     // (key) => key\n *   commentsLoading: commentsReq.loading,  // (key) => key\n *   commentsSuccess: commentsReq.success,  // (key) => key\n *   commentsFailure: commentsReq.failure,  // ({ key, error })\n *   commentsReset:   commentsReq.reset,    // (key) => key\n * })\n * ```\n */\nexport function createKeyedApiActions<TState extends Record<string, any>>(accessor: (draft: TState) => Record<string, ApiRequestState>) {\n  const path = resolvePath(accessor)\n  const action = defineAction<TState>()\n\n  const write = (storage: IStorage<TState>, key: string, request: ApiRequestState) => {\n    // [...path, key] → setByPath доходит до самого Record и кладёт значение по ключу\n    storage.update((s) => setByPath(s, [...path, key], request))\n  }\n\n  const writer = (status: ApiStatus) =>\n    action<string, string>({\n      action: (storage, key: string) => {\n        write(storage, key, { status, error: null })\n        return key\n      },\n    })\n\n  return {\n    init: writer(ApiStatus.Idle),\n    loading: writer(ApiStatus.Loading),\n    success: writer(ApiStatus.Success),\n    reset: writer(ApiStatus.Reset),\n\n    failure: action<{ key: string; error: string }, { key: string; error: string }>({\n      action: (storage, payload: { key: string; error: string }) => {\n        write(storage, payload.key, { status: ApiStatus.Error, error: payload.error })\n        return payload\n      },\n    }),\n  }\n}\n"],"names":["ApiStatus","defineAction","config","executionOptions","defineWatcher","resolvePath","accessor","path","handler","_","prop","Proxy","setByPath","obj","value","current","i","createApiActions","action","update","storage","request","s","payload","error","createKeyedApiActions","write","key","writer","status"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "synapse-storage",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "Набор инструментов для управления состоянием и апи-запросами",
   "type": "module",
   "main": "./dist/index.js",