synapse-storage 3.0.19 → 4.0.0

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

@@ -0,0 +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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"}

package/dist/react/utils/index.d.ts

@@ -0,0 +1,3 @@
+export { awaitSynapse } from './awaitSynapse';
+export { createSynapseCtx } from './createSynapseCtx';
+//# sourceMappingURL=index.d.ts.map

package/dist/react/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/react/utils/index.js

@@ -0,0 +1,9 @@
+
+
+
+
+
+export { awaitSynapse } from "./awaitSynapse.js";
+export { createSynapseCtx } from "./createSynapseCtx.js";
+
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"react/utils/index.js","sources":["../../../src/react/utils/index.ts"],"sourcesContent":["export { awaitSynapse } from './awaitSynapse'\nexport { createSynapseCtx } from './createSynapseCtx'\n"],"names":["awaitSynapse","createSynapseCtx"],"mappings":";;AAA6C;AACQ"}

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

@@ -0,0 +1,216 @@
+import { Observable } from 'rxjs';
+import type { IStorage } from '../../core';
+import { TypedAction } from '../effects';
+import type { ActionExecutionOptions, ActionRecipe, WatcherRecipe } from './standalone';
+/**
+ * Расширенное API для middleware
+ */
+export interface EnhancedMiddlewareAPI<T extends Record<string, any>> {
+    getState: () => T | Promise<T>;
+    dispatch: (action: Action) => Promise<any>;
+    storage: IStorage<T>;
+    actions$: Observable<Action>;
+    actions: Record<string, DispatchFunction<any, any>>;
+    watchers: Record<string, WatcherFunction<any>>;
+    findActionByType: (actionType: string) => DispatchFunction<any, any> | undefined;
+    findWatcherByType: (actionType: string) => WatcherFunction<any> | undefined;
+}
+/**
+ * Расширенное определение middleware
+ */
+export interface EnhancedMiddleware<T extends Record<string, any> = any> {
+    (api: EnhancedMiddlewareAPI<T>): (next: (action: Action) => Promise<any>) => (action: Action) => Promise<any>;
+}
+/**
+ * Базовая структура действия
+ */
+export interface Action<T = unknown> {
+    type: string;
+    payload?: T;
+    meta?: Record<string, any>;
+}
+/**
+ * Параметры для создания действия
+ */
+export interface ActionDefinition<TParams, TResult> {
+    /** Тип действия для идентификации в потоке и эффектах. Если не указан — будет выведен из имени ключа в createDispatcher */
+    type?: string;
+    /** Функция, выполняющая действие и возвращающая результат (payload) */
+    action: (params: TParams) => Promise<TResult> | TResult;
+    /** Дополнительные метаданные (опционально) */
+    meta?: Record<string, any>;
+}
+/**
+ * Определение типа для watcher'а
+ */
+interface WatcherDefinition<T, R> {
+    /** Тип watcher'а для идентификации в потоке. Если не указан — будет выведен из имени ключа в createDispatcher */
+    type?: string;
+    selector: (state: T) => R;
+    meta?: Record<string, any>;
+    shouldTrigger?: (prev: R | undefined, current: R) => boolean;
+    notifyAfterSubscribe?: boolean;
+}
+/**
+ * Тип для функции watcher
+ */
+export interface WatcherFunction<R> {
+    (): Observable<TypedAction<R>>;
+    actionType: string;
+    meta?: Record<string, any>;
+    unsubscribe: VoidFunction;
+}
+/**
+ * Расширенный тип для функции настройки действий с поддержкой дополнительных утилит
+ */
+export type ActionsSetupWithUtils<T extends Record<string, any>> = (storage: IStorage<T>, utils: {
+    createAction: ActionCreatorFactory;
+    createWatcher: <R>(config: WatcherDefinition<T, R>) => WatcherFunction<R>;
+}) => Record<string, DispatchFunction<any, any> | WatcherFunction<any> | ActionRecipe<T, any, any> | WatcherRecipe<T, any>>;
+/**
+ * Расширенная функция диспетчеризации
+ */
+export interface DispatchFunction<TParams, TResult> {
+    /** Функция для вызова действия с параметрами */
+    (params: TParams): Promise<TResult>;
+    /** Тип действия для использования в эффектах */
+    actionType: string;
+    /** Метаданные действия */
+    meta?: Record<string, any>;
+    /** Внутренний тип для идентификации */
+    _type?: 'dispatch' | 'watchers';
+}
+/**
+ * Тип для фабрики создателей действий
+ */
+type ActionCreatorFactory = <TParams = void, TResult = void>(config: ActionDefinition<TParams, TResult>, executionOptions?: ActionExecutionOptions<TParams, TResult>) => DispatchFunction<TParams, TResult>;
+/**
+ * Извлекает тип результата из функции диспетчера
+ */
+export type ExtractResultType<T> = T extends DispatchFunction<any, infer R> ? R : never;
+/**
+ * Извлекает типы из функции настройки действий
+ */
+export type ActionsResult<F> = F extends (create: ActionCreatorFactory, storage: any, ...args: any[]) => infer R ? R : Record<string, DispatchFunction<any, any>>;
+/**
+ * Типизированный объект действий
+ */
+type ResolveDispatch<T> = T extends DispatchFunction<any, any> ? T : T extends ActionRecipe<any, infer P, infer R> ? DispatchFunction<P, R> : never;
+export type DispatchActions<T> = {
+    [K in keyof T]: ResolveDispatch<T[K]>;
+};
+/**
+ * Типизированный объект watchers
+ */
+type ResolveWatcher<T> = T extends WatcherFunction<any> ? T : T extends WatcherRecipe<any, infer R> ? WatcherFunction<R> : never;
+export type WatcherActions<T> = {
+    [K in keyof T]: ResolveWatcher<T[K]>;
+};
+/**
+ * Параметры для Dispatcher
+ */
+interface DispatcherOptions<T extends Record<string, any>> {
+    storage: IStorage<T>;
+    middlewares?: EnhancedMiddleware<T>[];
+}
+/**
+ * Класс Dispatcher для интеграции хранилищ с реактивной системой
+ */
+export declare class Dispatcher<T extends Record<string, any>, TActionsFn extends ActionsSetupWithUtils<T> = ActionsSetupWithUtils<T>> {
+    private actions$;
+    readonly actions: Observable<Action>;
+    dispatch: Record<string, DispatchFunction<any, any>>;
+    watchers: Record<string, WatcherFunction<any>>;
+    private storage;
+    private middlewareFunctions;
+    private dispatchChain;
+    private actionRegistry;
+    private actionParams;
+    private middlewareAPI;
+    /**
+     * Создает новый экземпляр Dispatcher
+     */
+    constructor(options: DispatcherOptions<T>);
+    /**
+     * Добавляет middleware в цепочку обработки
+     */
+    use(...middlewares: EnhancedMiddleware<T>[]): this;
+    /**
+     * Base executor: runs the registered action handler or passes through
+     */
+    private baseExecute;
+    /**
+     * Executes action through middleware chain and emits to actions$ (single emission point)
+     */
+    private executeChain;
+    /**
+     * Rebuilds the pre-composed middleware chain. Called once on use(), not on every dispatch.
+     */
+    private rebuildChain;
+    /**
+     * Получает все действия с улучшенной типизацией
+     */
+    getActions(): ActionsResult<TActionsFn>;
+    /**
+     * Получает типизированные действия диспетчера
+     */
+    getTypedDispatch<A extends Record<string, any>>(): DispatchActions<A>;
+    /**
+     * Получает типизированные watcher'ы
+     */
+    getTypedWatchers<A extends Record<string, any>>(): WatcherActions<A>;
+    /**
+     * Находит действие по типу
+     */
+    findActionByType(actionType: string): DispatchFunction<any, any> | undefined;
+    /**
+     * Находит наблюдатель по типу
+     */
+    findWatcherByType(actionType: string): WatcherFunction<any> | undefined;
+    /**
+     * Уничтожает dispatcher: отписывает watchers, завершает поток действий, очищает состояние
+     */
+    destroy(): void;
+    /**
+     * Создает действие
+     */
+    createAction<TParams = void, TResult = void>(actionConfig: ActionDefinition<TParams, TResult>, executionOptions?: ActionExecutionOptions<TParams, TResult>): DispatchFunction<TParams, TResult>;
+    /**
+     * Создает watcher для отслеживания изменений в хранилище
+     */
+    createWatcher<R>(config: WatcherDefinition<T, R>): WatcherFunction<R>;
+}
+/**
+ * Функция для создания типизированного диспетчера.
+ *
+ * Поддерживает два варианта:
+ * 1. Объект standalone-рецептов (ActionRecipe / WatcherRecipe)
+ * 2. Setup-функция с доступом к createAction / createWatcher (inline-определение)
+ *
+ * @example
+ * ```ts
+ * // Вариант 1: объект рецептов (рекомендуемый)
+ * createDispatcher({ storage }, {
+ *   loadList,
+ *   loadListLoading: listRequest.loading,
+ *   watchCount,
+ * })
+ *
+ * // Вариант 2: setup-функция (для смешанного использования)
+ * createDispatcher({ storage }, (storage, { createAction }) => ({
+ *   loadList,
+ *   custom: createAction({ action: () => { ... } }),
+ * }))
+ * ```
+ */
+export declare function createDispatcher<TState extends Record<string, any>, TRecord extends Record<string, ActionRecipe<TState, any, any> | WatcherRecipe<TState, any>>>(options: DispatcherOptions<TState>, actions: TRecord): Dispatcher<TState> & {
+    dispatch: DispatchActions<TRecord>;
+    watchers: WatcherActions<TRecord>;
+};
+export declare function createDispatcher<TState extends Record<string, any>, TActions extends ActionsSetupWithUtils<TState>>(options: DispatcherOptions<TState>, actionsSetup: TActions): Dispatcher<TState, TActions> & {
+    dispatch: DispatchActions<ReturnType<TActions>>;
+    watchers: WatcherActions<ReturnType<TActions>>;
+};
+export type CreateDispatcherType = ReturnType<typeof createDispatcher>;
+export {};
+//# sourceMappingURL=dispatcher.module.d.ts.map

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

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

package/dist/reactive/dispatcher/dispatcher.module.js

@@ -0,0 +1,384 @@
+import { Observable, Subject, share } from "rxjs";
+import { handleCallbackError } from "../../_utils/error-handling.util.js";
+
+
+
+
+
+/**
+ * Класс Dispatcher для интеграции хранилищ с реактивной системой
+ */ class Dispatcher {
+    // Поток действий
+    actions$ = new Subject();
+    // Публичный Observable для действий
+    actions = this.actions$.asObservable();
+    // Методы диспетчеризации действий с типизацией
+    dispatch = {};
+    // Watcher'ы для реактивной подписки на изменения
+    watchers = {};
+    // Ссылка на хранилище
+    storage;
+    // Только один массив для хранения инициализированных middleware
+    middlewareFunctions = [];
+    // Pre-built middleware chain (null if no middlewares)
+    dispatchChain = null;
+    // Registry of action executors by action type
+    actionRegistry = new Map();
+    // Temporary storage for passing params through middleware chain without polluting action object
+    actionParams = new WeakMap();
+    // API для инициализации middleware
+    middlewareAPI;
+    /**
+   * Создает новый экземпляр Dispatcher
+   */ constructor(options){
+        this.storage = options.storage;
+        // Создаем API для middleware сразу
+        this.middlewareAPI = {
+            getState: ()=>this.storage.getState(),
+            dispatch: (action)=>this.executeChain(action),
+            storage: this.storage,
+            actions$: this.actions,
+            actions: this.dispatch,
+            watchers: this.watchers,
+            findActionByType: (type)=>this.findActionByType(type),
+            findWatcherByType: (type)=>this.findWatcherByType(type)
+        };
+        // Если есть middleware в options, добавляем их
+        if (options.middlewares && options.middlewares.length > 0) {
+            this.use(...options.middlewares);
+        }
+    }
+    /**
+   * Добавляет middleware в цепочку обработки
+   */ use(...middlewares) {
+        // Инициализируем каждый middleware и добавляем только инициализированную версию
+        for(let i = 0; i < middlewares.length; i++){
+            try {
+                // Инициализируем middleware с API
+                const initializedMiddleware = middlewares[i](this.middlewareAPI);
+                this.middlewareFunctions.push(initializedMiddleware);
+            } catch (error) {
+                handleCallbackError(`Dispatcher: error initializing middleware [${i}]`, error);
+            }
+        }
+        this.rebuildChain();
+        return this;
+    }
+    /**
+   * Base executor: runs the registered action handler or passes through
+   */ baseExecute = async (action)=>{
+        // No params in WeakMap means this is a pass-through dispatch (via api.dispatch)
+        if (!this.actionParams.has(action)) {
+            return action.payload;
+        }
+        const entry = this.actionRegistry.get(action.type);
+        if (!entry) {
+            return action.payload;
+        }
+        const params = this.actionParams.get(action);
+        return Promise.resolve(entry.action(params));
+    };
+    /**
+   * Executes action through middleware chain and emits to actions$ (single emission point)
+   */ async executeChain(action) {
+        const executor = this.dispatchChain ?? this.baseExecute;
+        const result = await executor(action);
+        // Single emission point for all dispatches
+        action.payload = result;
+        this.actionParams.delete(action);
+        this.actions$.next(action);
+        return result;
+    }
+    /**
+   * Rebuilds the pre-composed middleware chain. Called once on use(), not on every dispatch.
+   */ rebuildChain() {
+        if (this.middlewareFunctions.length === 0) {
+            this.dispatchChain = null;
+            return;
+        }
+        let chain = this.baseExecute;
+        for(let i = this.middlewareFunctions.length - 1; i >= 0; i--){
+            chain = this.middlewareFunctions[i](chain);
+        }
+        this.dispatchChain = chain;
+    }
+    /**
+   * Получает все действия с улучшенной типизацией
+   */ getActions() {
+        return this.dispatch;
+    }
+    /**
+   * Получает типизированные действия диспетчера
+   */ getTypedDispatch() {
+        return this.dispatch;
+    }
+    /**
+   * Получает типизированные watcher'ы
+   */ getTypedWatchers() {
+        return this.watchers;
+    }
+    /**
+   * Находит действие по типу
+   */ findActionByType(actionType) {
+        return Object.values(this.dispatch).find((action)=>{
+            return action.actionType.split(`[${this.storage.name}]`)[1] === actionType;
+        });
+    }
+    /**
+   * Находит наблюдатель по типу
+   */ findWatcherByType(actionType) {
+        return Object.values(this.watchers).find((watcher)=>{
+            return watcher.actionType.split(`[${this.storage.name}]`)[1] === actionType;
+        });
+    }
+    /**
+   * Уничтожает dispatcher: отписывает watchers, завершает поток действий, очищает состояние
+   */ destroy() {
+        Object.values(this.watchers).forEach((w)=>w.unsubscribe());
+        this.actions$.complete();
+        this.dispatch = {};
+        this.watchers = {};
+        this.middlewareFunctions = [];
+        this.dispatchChain = null;
+        this.actionRegistry.clear();
+    }
+    /**
+   * Создает действие
+   */ createAction(actionConfig, executionOptions) {
+        const hasExplicitType = !!actionConfig.type;
+        let actionType = hasExplicitType ? `[${this.storage.name}]${actionConfig.type}` : '';
+        // Register action executor in the registry (сразу, если тип известен)
+        if (hasExplicitType) {
+            this.actionRegistry.set(actionType, {
+                action: actionConfig.action
+            });
+        }
+        // Для мемоизации храним последние аргументы и результат
+        let lastParams;
+        let lastResult;
+        let hasCached = false;
+        // Создаем функцию диспетчеризации
+        const dispatchFn = async (params)=>{
+            if (!actionType) {
+                throw new Error('Action type not assigned. Provide "type" in config or use within createDispatcher.');
+            }
+            // Проверяем мемоизацию
+            if (executionOptions?.memoize && hasCached) {
+                if (executionOptions.memoize(params, lastParams, lastResult)) {
+                    return lastResult;
+                }
+            }
+            // Создаем объект действия
+            const actionObject = {
+                type: actionType,
+                meta: actionConfig.meta
+            };
+            // Store params for base executor to retrieve via WeakMap
+            this.actionParams.set(actionObject, params);
+            // Execute through middleware chain (includes single emission to actions$)
+            const result = await this.executeChain(actionObject);
+            // Сохраняем аргументы и результат для мемоизации
+            lastParams = params;
+            lastResult = result;
+            hasCached = true;
+            return result;
+        };
+        dispatchFn._type = 'dispatch';
+        // Добавляем тип действия как свойство функции (configurable для deferred assignment)
+        Object.defineProperty(dispatchFn, 'actionType', {
+            value: actionType,
+            writable: false,
+            enumerable: true,
+            configurable: true
+        });
+        // Добавляем метаданные, если они есть
+        if (actionConfig.meta) {
+            Object.defineProperty(dispatchFn, 'meta', {
+                value: actionConfig.meta,
+                writable: false,
+                enumerable: true
+            });
+        }
+        // Deferred type assignment — используется в createDispatcher для авто-генерации типа из имени ключа
+        if (!hasExplicitType) {
+            ;
+            dispatchFn._assignType = (name)=>{
+                actionType = `[${this.storage.name}]${name}`;
+                this.actionRegistry.set(actionType, {
+                    action: actionConfig.action
+                });
+                Object.defineProperty(dispatchFn, 'actionType', {
+                    value: actionType,
+                    writable: false,
+                    enumerable: true,
+                    configurable: true
+                });
+            };
+        }
+        return dispatchFn;
+    }
+    /**
+   * Создает watcher для отслеживания изменений в хранилище
+   */ createWatcher(config) {
+        const hasExplicitType = !!config.type;
+        let actionType = hasExplicitType ? `[${this.storage.name}]${config.type}` : '';
+        // Lazy-подписка: подписываемся на storage только при первом subscribe на Observable
+        let storageUnsubscribe = null;
+        const sharedObservable = new Observable((subscriber)=>{
+            // Инициализируем prevValue текущим значением при первой подписке
+            let prevValue;
+            let disposed = false;
+            const initAndSubscribe = async ()=>{
+                try {
+                    const currentState = await Promise.resolve(this.storage.getState());
+                    prevValue = config.selector(currentState);
+                } catch  {
+                // Если не удалось получить начальное значение — продолжаем с undefined
+                }
+                if (disposed) return;
+                // Если нужно уведомить о текущем значении при подписке
+                if (config.notifyAfterSubscribe && prevValue !== undefined) {
+                    if (!config.shouldTrigger || config.shouldTrigger(undefined, prevValue)) {
+                        const initialAction = {
+                            type: actionType,
+                            payload: prevValue,
+                            meta: {
+                                ...config.meta,
+                                isInitial: true
+                            }
+                        };
+                        this.actions$.next(initialAction);
+                        subscriber.next(initialAction);
+                    }
+                }
+                // Подписываемся на изменения storage
+                storageUnsubscribe = this.storage.subscribe(config.selector, (value)=>{
+                    if (!config.shouldTrigger || config.shouldTrigger(prevValue, value)) {
+                        const action = {
+                            type: actionType,
+                            payload: value,
+                            meta: config.meta
+                        };
+                        this.actions$.next(action);
+                        subscriber.next(action);
+                        prevValue = value;
+                    }
+                });
+                // Если отписались пока шла асинхронная инициализация — сразу очищаем
+                if (disposed) {
+                    storageUnsubscribe();
+                    storageUnsubscribe = null;
+                }
+            };
+            initAndSubscribe();
+            return ()=>{
+                disposed = true;
+                if (storageUnsubscribe) {
+                    storageUnsubscribe();
+                    storageUnsubscribe = null;
+                }
+            };
+        }).pipe(share());
+        // Создаем функцию watcher'а
+        const watcherFn = ()=>sharedObservable;
+        watcherFn._type = 'watchers';
+        Object.defineProperty(watcherFn, 'actionType', {
+            value: actionType,
+            writable: false,
+            enumerable: true,
+            configurable: true
+        });
+        if (config.meta) {
+            Object.defineProperty(watcherFn, 'meta', {
+                value: config.meta,
+                writable: false,
+                enumerable: true
+            });
+        }
+        Object.defineProperty(watcherFn, 'unsubscribe', {
+            value: ()=>{
+                if (storageUnsubscribe) {
+                    storageUnsubscribe();
+                    storageUnsubscribe = null;
+                }
+            },
+            writable: false,
+            enumerable: true
+        });
+        // Deferred type assignment — используется в createDispatcher для авто-генерации типа из имени ключа
+        if (!hasExplicitType) {
+            ;
+            watcherFn._assignType = (name)=>{
+                actionType = `[${this.storage.name}]${name}`;
+                Object.defineProperty(watcherFn, 'actionType', {
+                    value: actionType,
+                    writable: false,
+                    enumerable: true,
+                    configurable: true
+                });
+            };
+        }
+        //@ts-ignore
+        return watcherFn;
+    }
+}
+// Implementation
+function createDispatcher(options, actionsOrSetup) {
+    // Создаем экземпляр диспетчера
+    const dispatcher = new Dispatcher(options);
+    // Получаем объект действий: из функции или напрямую
+    const actions = typeof actionsOrSetup === 'function' ? actionsOrSetup(options.storage, {
+        createAction: (actionConfig, executionOptions)=>dispatcher.createAction(actionConfig, executionOptions),
+        createWatcher: (config)=>dispatcher.createWatcher(config)
+    }) : actionsOrSetup;
+    // Регистрируем все созданные объекты в соответствующих коллекциях
+    for (const [key, fn] of Object.entries(actions)){
+        // Standalone action recipe — привязываем к storage и создаём реальный action
+        if (typeof fn === 'object' && fn !== null && fn._type === 'action-recipe') {
+            const recipe = fn;
+            const boundConfig = {
+                meta: recipe._config.meta,
+                action: (params)=>recipe._config.action(options.storage, params)
+            };
+            const dispatchFn = dispatcher.createAction(boundConfig, recipe._executionOptions);
+            if (typeof dispatchFn._assignType === 'function') {
+                ;
+                dispatchFn._assignType(key);
+                delete dispatchFn._assignType;
+            }
+            dispatcher.dispatch[key] = dispatchFn;
+            continue;
+        }
+        // Standalone watcher recipe — привязываем к storage и создаём реальный watcher
+        if (typeof fn === 'object' && fn !== null && fn._type === 'watcher-recipe') {
+            const recipe = fn;
+            const watcherFn = dispatcher.createWatcher(recipe._config);
+            if (typeof watcherFn._assignType === 'function') {
+                ;
+                watcherFn._assignType(key);
+                delete watcherFn._assignType;
+            }
+            dispatcher.watchers[key] = watcherFn;
+            continue;
+        }
+        // Inline action/watcher (существующая логика)
+        if (typeof fn === 'function') {
+            const type = fn._type;
+            if (type === 'dispatch' || type === 'watchers') {
+                // Авто-назначение типа из имени ключа, если type не был указан явно
+                if (typeof fn._assignType === 'function') {
+                    ;
+                    fn._assignType(key);
+                    delete fn._assignType;
+                }
+                // @ts-ignore
+                dispatcher[type][key] = fn;
+            }
+        }
+    }
+    return dispatcher;
+}
+
+export { Dispatcher, createDispatcher };
+
+//# sourceMappingURL=dispatcher.module.js.map