synapse-storage 3.0.1 → 3.0.3

package/dist/core.d.cts

@@ -0,0 +1,397 @@
+import { I as ISelectorModule, a as Selector, b as SelectorOptions, S as SelectorAPI } from './selector.interface-CA5y-kD_.cjs';
+import { c as StorageKeyType, I as IStorage, h as StorageConfig, f as IEventEmitter, g as ILogger, D as DefaultMiddlewares, e as StorageEvent, i as StorageType, M as Middleware, C as ConfigureMiddlewares, l as StorageKey } from './storage.interface-Dl8SLUd1.cjs';
+export { B as BatchingMiddlewareOptions, G as GetDefaultMiddleware, k as IndexedDBStorageConfig, L as LocalStorageConfig, j as MemoryStorageConfig, a as MiddlewareAPI, N as NextFunction, S as ShallowCompareMiddlewareOptions, b as StorageAction, d as StorageEvents } from './storage.interface-Dl8SLUd1.cjs';
+
+/**
+ * Контекст выполнения для плагинов
+ * Содержит информацию о текущей операции и хранилище
+ */
+interface PluginContext {
+    /** Имя хранилища, к которому применяется плагин */
+    storageName: string;
+    /** Временная метка выполнения операции (timestamp) */
+    timestamp: number;
+    /** Дополнительные метаданные операции (могут быть предоставлены хранилищем или другими плагинами) */
+    metadata?: Record<string, any>;
+}
+/**
+ * Базовый интерфейс для всех плагинов
+ * Определяет основные свойства и методы жизненного цикла
+ */
+interface IPlugin {
+    /** Уникальное имя плагина */
+    name: string;
+    /**
+     * Метод инициализации плагина
+     * Вызывается при добавлении плагина в хранилище или при инициализации хранилища
+     */
+    initialize?(): Promise<void>;
+    /**
+     * Метод уничтожения плагина
+     * Вызывается при удалении плагина из хранилища или при уничтожении хранилища
+     * Используется для освобождения ресурсов и очистки состояния
+     */
+    destroy?(): Promise<void>;
+}
+/**
+ * Интерфейс плагина для хранилища данных
+ * Определяет хуки для различных операций хранилища
+ */
+interface IStoragePlugin extends IPlugin {
+    /**
+     * Вызывается перед установкой значения в хранилище
+     * Позволяет изменить значение до его сохранения
+     *
+     * @param value Значение, которое будет сохранено
+     * @param context Контекст выполнения операции
+     * @returns Модифицированное значение для сохранения
+     */
+    onBeforeSet?<T>(value: T, context: PluginContext): Promise<T>;
+    /**
+     * Вызывается после установки значения в хранилище
+     * Позволяет выполнить дополнительные действия или модифицировать результат
+     *
+     * @param key Ключ, по которому было сохранено значение
+     * @param value Сохраненное значение
+     * @param context Контекст выполнения операции
+     * @returns Финальное значение (может быть модифицировано)
+     */
+    onAfterSet?<T>(key: StorageKeyType, value: T, context: PluginContext): Promise<T>;
+    /**
+     * Вызывается перед получением значения из хранилища
+     * Позволяет модифицировать запрашиваемый ключ
+     *
+     * @param key Ключ, по которому запрашивается значение
+     * @param context Контекст выполнения операции
+     * @returns Возможно модифицированный ключ для запроса
+     */
+    onBeforeGet?(key: StorageKeyType, context: PluginContext): Promise<StorageKeyType>;
+    /**
+     * Вызывается после получения значения из хранилища
+     * Позволяет модифицировать полученное значение
+     *
+     * @param key Ключ, по которому было запрошено значение
+     * @param value Полученное значение (undefined, если значение не найдено)
+     * @param context Контекст выполнения операции
+     * @returns Финальное значение (может быть модифицировано)
+     */
+    onAfterGet?<T>(key: StorageKeyType, value: T | undefined, context: PluginContext): Promise<T | undefined>;
+    /**
+     * Вызывается перед удалением значения из хранилища
+     * Позволяет разрешить или запретить удаление
+     *
+     * @param key Ключ, по которому будет удалено значение
+     * @param context Контекст выполнения операции
+     * @returns Булево значение, разрешающее (true) или запрещающее (false) удаление
+     */
+    onBeforeDelete?(key: StorageKeyType, context: PluginContext): Promise<boolean>;
+    /**
+     * Вызывается после удаления значения из хранилища
+     * Позволяет выполнить дополнительные действия после удаления
+     *
+     * @param key Ключ, по которому было удалено значение
+     * @param context Контекст выполнения операции
+     */
+    onAfterDelete?(key: StorageKeyType, context: PluginContext): Promise<void>;
+    /**
+     * Вызывается перед очисткой хранилища
+     * Позволяет выполнить дополнительные действия перед удалением всех данных
+     *
+     * @param context Контекст выполнения операции
+     */
+    onClear?(context: PluginContext): Promise<void>;
+}
+/**
+ * Исполнитель плагинов
+ * Отвечает за выполнение хуков плагинов в определенной последовательности
+ */
+interface IPluginExecutor {
+    /**
+     * Выполняет хуки onBeforeSet всех зарегистрированных плагинов
+     *
+     * @param value Исходное значение
+     * @param metadata Дополнительные метаданные
+     * @returns Модифицированное значение после прохождения всех плагинов
+     */
+    executeBeforeSet<T>(value: T, metadata?: Record<string, any>): Promise<T>;
+    /**
+     * Выполняет хуки onAfterSet всех зарегистрированных плагинов
+     *
+     * @param key Ключ, по которому было сохранено значение
+     * @param value Сохраненное значение
+     * @param metadata Дополнительные метаданные
+     * @returns Финальное значение после прохождения всех плагинов
+     */
+    executeAfterSet<T>(key: StorageKeyType, value: T, metadata?: Record<string, any>): Promise<T>;
+    /**
+     * Выполняет хуки onBeforeGet всех зарегистрированных плагинов
+     *
+     * @param key Исходный ключ
+     * @param metadata Дополнительные метаданные
+     * @returns Модифицированный ключ после прохождения всех плагинов
+     */
+    executeBeforeGet(key: StorageKeyType, metadata?: Record<string, any>): Promise<StorageKeyType>;
+    /**
+     * Выполняет хуки onAfterGet всех зарегистрированных плагинов
+     *
+     * @param key Ключ, по которому было запрошено значение
+     * @param value Полученное значение
+     * @param metadata Дополнительные метаданные
+     * @returns Финальное значение после прохождения всех плагинов
+     */
+    executeAfterGet<T>(key: StorageKeyType, value: T | undefined, metadata?: Record<string, any>): Promise<T | undefined>;
+    /**
+     * Выполняет хуки onBeforeDelete всех зарегистрированных плагинов
+     *
+     * @param key Ключ, по которому будет удалено значение
+     * @param metadata Дополнительные метаданные
+     * @returns Результат проверки всех плагинов (false если хотя бы один плагин запретил удаление)
+     */
+    executeBeforeDelete(key: StorageKeyType, metadata?: Record<string, any>): Promise<boolean>;
+    /**
+     * Выполняет хуки onAfterDelete всех зарегистрированных плагинов
+     *
+     * @param key Ключ, по которому было удалено значение
+     * @param metadata Дополнительные метаданные
+     */
+    executeAfterDelete(key: StorageKeyType, metadata?: Record<string, any>): Promise<void>;
+    /**
+     * Выполняет хуки onClear всех зарегистрированных плагинов
+     *
+     * @param metadata Дополнительные метаданные
+     */
+    executeOnClear(metadata?: Record<string, any>): Promise<void>;
+}
+/**
+ * Менеджер плагинов
+ * Отвечает за регистрацию, получение и удаление плагинов
+ */
+interface IPluginManager<T extends IPlugin> {
+    /**
+     * Добавляет плагин в менеджер
+     *
+     * @param plugin Экземпляр плагина
+     */
+    add(plugin: T): Promise<void>;
+    /**
+     * Удаляет плагин из менеджера по имени
+     *
+     * @param name Имя плагина
+     */
+    remove(name: string): Promise<void>;
+    /**
+     * Получает плагин по имени
+     *
+     * @param name Имя плагина
+     * @returns Экземпляр плагина или undefined, если плагин не найден
+     */
+    get(name: string): T | undefined;
+    /**
+     * Получает все зарегистрированные плагины
+     *
+     * @returns Массив всех плагинов
+     */
+    getAll(): T[];
+    /**
+     * Инициализирует все зарегистрированные плагины
+     */
+    initialize(): Promise<void>;
+    /**
+     * Уничтожает все зарегистрированные плагины
+     */
+    destroy(): Promise<void>;
+}
+
+type PathSelector<T, R> = (state: T) => R;
+declare abstract class BaseStorage<T extends Record<string, any>> implements IStorage<T> {
+    protected readonly config: StorageConfig;
+    protected readonly pluginExecutor?: IPluginExecutor | undefined;
+    protected readonly eventEmitter?: IEventEmitter | undefined;
+    protected readonly logger?: ILogger | undefined;
+    protected static readonly GLOBAL_SUBSCRIPTION_KEY = "*";
+    name: string;
+    private selectorPathCache;
+    private middlewareModule;
+    private initializedMiddlewares;
+    protected subscribers: Map<StorageKeyType, Set<(value: any) => void>>;
+    constructor(config: StorageConfig, pluginExecutor?: IPluginExecutor | undefined, eventEmitter?: IEventEmitter | undefined, logger?: ILogger | undefined);
+    protected initializeMiddlewares(): void;
+    protected getDefaultMiddleware(): DefaultMiddlewares;
+    protected initializeWithMiddlewares(): Promise<void>;
+    abstract initialize(): Promise<this>;
+    protected abstract doGet(key: StorageKeyType): Promise<any>;
+    protected abstract doSet(key: StorageKeyType, value: any): Promise<void>;
+    protected abstract doUpdate(updates: Array<{
+        key: StorageKeyType;
+        value: any;
+    }>): Promise<void>;
+    protected abstract doDelete(key: StorageKeyType): Promise<boolean>;
+    protected abstract doClear(): Promise<void>;
+    protected abstract doKeys(): Promise<string[]>;
+    protected abstract doHas(key: StorageKeyType): Promise<boolean>;
+    protected abstract doDestroy(): Promise<void>;
+    get<R>(key: StorageKeyType): Promise<R | undefined>;
+    set<R>(key: StorageKeyType, value: R): Promise<void>;
+    update(updater: (state: T) => void): Promise<void>;
+    delete(key: StorageKeyType): Promise<void>;
+    clear(): Promise<void>;
+    keys(): Promise<string[]>;
+    has(key: StorageKeyType): Promise<boolean>;
+    getState(): Promise<T>;
+    subscribeToAll(callback: (event: {
+        type: string;
+        key?: StorageKeyType[] | StorageKeyType;
+        value?: any;
+        changedPaths?: string[];
+    }) => void): VoidFunction;
+    subscribe(key: string, callback: (value: any) => void): VoidFunction;
+    subscribe<R>(pathSelector: PathSelector<T, R>, callback: (value: R) => void): VoidFunction;
+    destroy(): Promise<void>;
+    private subscribeByKey;
+    private createDummyState;
+    private isEqual;
+    /**
+     * Возвращает полный путь, а не только корневой ключ
+     */
+    private extractPath;
+    protected notifySubscribers(key: StorageKeyType, value: any): void;
+    /**
+     * Метод для определения изменившихся путей между двумя объектами
+     */
+    private findChangedPaths;
+    private subscribeBySelector;
+    protected emitEvent(event: StorageEvent): Promise<void>;
+}
+
+interface SharedStateMiddlewareProps {
+    storageType: StorageType;
+    storageName: string;
+}
+declare const broadcastMiddleware: (props: SharedStateMiddlewareProps) => Middleware;
+
+declare class StoragePluginModule implements IPluginManager<IStoragePlugin>, IPluginExecutor {
+    protected readonly parentExecutor?: IPluginExecutor | undefined;
+    protected readonly logger?: ILogger | undefined;
+    protected readonly storageName: string;
+    private plugins;
+    constructor(parentExecutor?: IPluginExecutor | undefined, logger?: ILogger | undefined, storageName?: string);
+    private createContext;
+    add(plugin: IStoragePlugin): Promise<void>;
+    remove(name: string): Promise<void>;
+    get(name: string): IStoragePlugin | undefined;
+    getAll(): IStoragePlugin[];
+    initialize(): Promise<void>;
+    destroy(): Promise<void>;
+    executeBeforeSet<T>(value: T, metadata?: Record<string, any>): Promise<T>;
+    executeAfterSet<T>(key: StorageKeyType, value: T, metadata?: Record<string, any>): Promise<T>;
+    executeBeforeGet(key: StorageKeyType, metadata?: Record<string, any>): Promise<StorageKeyType>;
+    executeAfterGet<T>(key: StorageKeyType, value: T | undefined, metadata?: Record<string, any>): Promise<T | undefined>;
+    executeBeforeDelete(key: StorageKeyType, metadata?: Record<string, any>): Promise<boolean>;
+    executeAfterDelete(key: StorageKeyType, metadata?: Record<string, any>): Promise<void>;
+    executeOnClear(metadata?: Record<string, any>): Promise<void>;
+}
+
+interface IndexedDBConfig {
+    dbName?: string;
+    dbVersion: number;
+}
+declare class IndexedDBStorage<T extends Record<string, any>> extends BaseStorage<T> {
+    private readonly DB_NAME;
+    private readonly STORE_NAME;
+    private readonly DB_VERSION;
+    private dbManager;
+    constructor(config: StorageConfig & {
+        options: IndexedDBConfig;
+    }, pluginExecutor?: IPluginExecutor, eventEmitter?: IEventEmitter, logger?: ILogger);
+    initialize(): Promise<this>;
+    static getCurrentDBVersion(dbName: string): Promise<number>;
+    static createStorages<S extends Record<string, any>>(dbName: string, configs: {
+        [K in keyof S]: {
+            name: string;
+            initialState?: S[K];
+            middlewares?: ConfigureMiddlewares;
+            pluginExecutor?: IPluginExecutor;
+            eventEmitter?: IEventEmitter;
+        };
+    }, logger?: ILogger): Promise<{
+        [K in keyof S]: IndexedDBStorage<S[K]>;
+    }>;
+    private getTransaction;
+    private getObjectStore;
+    protected doGet(key: StorageKeyType): Promise<any>;
+    protected doSet(key: StorageKeyType, value: any): Promise<void>;
+    private putValueInStore;
+    protected doUpdate(updates: Array<{
+        key: string | StorageKey;
+        value: any;
+    }>): Promise<void>;
+    protected doDelete(key: StorageKeyType): Promise<boolean>;
+    protected doClear(): Promise<void>;
+    protected doKeys(): Promise<string[]>;
+    protected doHas(key: StorageKeyType): Promise<boolean>;
+    protected doDestroy(): Promise<void>;
+}
+
+declare class LocalStorage<T extends Record<string, any>> extends BaseStorage<T> {
+    constructor(config: StorageConfig, pluginExecutor?: IPluginExecutor, eventEmitter?: IEventEmitter, logger?: ILogger);
+    initialize(): Promise<this>;
+    protected doGet(key: StorageKeyType): Promise<any>;
+    protected doSet(key: StorageKeyType, value: any): Promise<void>;
+    protected doDelete(key: StorageKeyType): Promise<boolean>;
+    protected doUpdate(updates: Array<{
+        key: StorageKeyType;
+        value: any;
+    }>): Promise<void>;
+    protected doClear(): Promise<void>;
+    protected doKeys(): Promise<string[]>;
+    protected doHas(key: StorageKeyType): Promise<boolean>;
+    private getAllKeys;
+    protected doDestroy(): Promise<void>;
+}
+
+declare class MemoryStorage<T extends Record<string, any>> extends BaseStorage<T> {
+    private storage;
+    constructor(config: StorageConfig, pluginExecutor?: IPluginExecutor, eventEmitter?: IEventEmitter, logger?: ILogger);
+    initialize(): Promise<this>;
+    protected doGet(key: StorageKeyType): Promise<any>;
+    protected doSet(key: StorageKeyType, value: any): Promise<void>;
+    protected doDelete(key: StorageKeyType): Promise<boolean>;
+    protected doUpdate(updates: Array<{
+        key: StorageKeyType;
+        value: any;
+    }>): Promise<void>;
+    protected doClear(): Promise<void>;
+    protected doKeys(): Promise<string[]>;
+    protected doHas(key: StorageKeyType): Promise<boolean>;
+    protected doDestroy(): Promise<void>;
+    private getAllKeys;
+}
+
+declare class SelectorModule<S extends Record<string, any>> implements ISelectorModule<S> {
+    private readonly source;
+    private readonly logger?;
+    storageName: string;
+    private subscriptions;
+    private cachedState?;
+    private localSelectorCache;
+    private batchUpdateInProgress;
+    private pendingUpdates;
+    constructor(source: IStorage<S>, logger?: ILogger | undefined);
+    /**
+     * Генерирует имя для селектора на основе его типа и функции
+     */
+    private generateName;
+    /**
+     * Обрабатывает отложенные обновления, чтобы избежать каскадных уведомлений
+     */
+    private processPendingUpdates;
+    createSelector<T>(selector: Selector<S, T>, options?: SelectorOptions<T>): SelectorAPI<T>;
+    createSelector<Deps extends unknown[], T>(dependencies: {
+        [K in keyof Deps]: SelectorAPI<Deps[K]>;
+    }, resultFn: (...args: Deps) => T, options?: SelectorOptions<T>): SelectorAPI<T>;
+    private createSimpleSelector;
+    private createCombinedSelector;
+    destroy(): void;
+}
+
+export { ConfigureMiddlewares, DefaultMiddlewares, IEventEmitter, ILogger, type IPlugin, type IPluginExecutor, type IPluginManager, ISelectorModule, IStorage, type IStoragePlugin, IndexedDBStorage, LocalStorage, MemoryStorage, Middleware, type PluginContext, SelectorAPI, SelectorModule, StorageConfig, StorageEvent, StorageKeyType, StoragePluginModule, StorageType, broadcastMiddleware };

package/dist/{core/storage/modules/plugin/plugin.interface.d.ts → core.d.ts}

@@ -1,9 +1,12 @@
-import { StorageKeyType } from '../../utils/storage-key';
+import { I as ISelectorModule, a as Selector, b as SelectorOptions, S as SelectorAPI } from './selector.interface-CA5y-kD_.js';
+import { c as StorageKeyType, I as IStorage, h as StorageConfig, f as IEventEmitter, g as ILogger, D as DefaultMiddlewares, e as StorageEvent, i as StorageType, M as Middleware, C as ConfigureMiddlewares, l as StorageKey } from './storage.interface-Dl8SLUd1.js';
+export { B as BatchingMiddlewareOptions, G as GetDefaultMiddleware, k as IndexedDBStorageConfig, L as LocalStorageConfig, j as MemoryStorageConfig, a as MiddlewareAPI, N as NextFunction, S as ShallowCompareMiddlewareOptions, b as StorageAction, d as StorageEvents } from './storage.interface-Dl8SLUd1.js';
+
 /**
  * Контекст выполнения для плагинов
  * Содержит информацию о текущей операции и хранилище
  */
-export interface PluginContext {
+interface PluginContext {
     /** Имя хранилища, к которому применяется плагин */
     storageName: string;
     /** Временная метка выполнения операции (timestamp) */
@@ -15,7 +18,7 @@ export interface PluginContext {
  * Базовый интерфейс для всех плагинов
  * Определяет основные свойства и методы жизненного цикла
  */
-export interface IPlugin {
+interface IPlugin {
     /** Уникальное имя плагина */
     name: string;
     /**
@@ -34,7 +37,7 @@ export interface IPlugin {
  * Интерфейс плагина для хранилища данных
  * Определяет хуки для различных операций хранилища
  */
-export interface IStoragePlugin extends IPlugin {
+interface IStoragePlugin extends IPlugin {
     /**
      * Вызывается перед установкой значения в хранилище
      * Позволяет изменить значение до его сохранения
@@ -102,7 +105,7 @@ export interface IStoragePlugin extends IPlugin {
  * Исполнитель плагинов
  * Отвечает за выполнение хуков плагинов в определенной последовательности
  */
-export interface IPluginExecutor {
+interface IPluginExecutor {
     /**
      * Выполняет хуки onBeforeSet всех зарегистрированных плагинов
      *
@@ -163,7 +166,7 @@ export interface IPluginExecutor {
  * Менеджер плагинов
  * Отвечает за регистрацию, получение и удаление плагинов
  */
-export interface IPluginManager<T extends IPlugin> {
+interface IPluginManager<T extends IPlugin> {
     /**
      * Добавляет плагин в менеджер
      *
@@ -198,4 +201,197 @@ export interface IPluginManager<T extends IPlugin> {
      */
     destroy(): Promise<void>;
 }
-//# sourceMappingURL=plugin.interface.d.ts.map
+
+type PathSelector<T, R> = (state: T) => R;
+declare abstract class BaseStorage<T extends Record<string, any>> implements IStorage<T> {
+    protected readonly config: StorageConfig;
+    protected readonly pluginExecutor?: IPluginExecutor | undefined;
+    protected readonly eventEmitter?: IEventEmitter | undefined;
+    protected readonly logger?: ILogger | undefined;
+    protected static readonly GLOBAL_SUBSCRIPTION_KEY = "*";
+    name: string;
+    private selectorPathCache;
+    private middlewareModule;
+    private initializedMiddlewares;
+    protected subscribers: Map<StorageKeyType, Set<(value: any) => void>>;
+    constructor(config: StorageConfig, pluginExecutor?: IPluginExecutor | undefined, eventEmitter?: IEventEmitter | undefined, logger?: ILogger | undefined);
+    protected initializeMiddlewares(): void;
+    protected getDefaultMiddleware(): DefaultMiddlewares;
+    protected initializeWithMiddlewares(): Promise<void>;
+    abstract initialize(): Promise<this>;
+    protected abstract doGet(key: StorageKeyType): Promise<any>;
+    protected abstract doSet(key: StorageKeyType, value: any): Promise<void>;
+    protected abstract doUpdate(updates: Array<{
+        key: StorageKeyType;
+        value: any;
+    }>): Promise<void>;
+    protected abstract doDelete(key: StorageKeyType): Promise<boolean>;
+    protected abstract doClear(): Promise<void>;
+    protected abstract doKeys(): Promise<string[]>;
+    protected abstract doHas(key: StorageKeyType): Promise<boolean>;
+    protected abstract doDestroy(): Promise<void>;
+    get<R>(key: StorageKeyType): Promise<R | undefined>;
+    set<R>(key: StorageKeyType, value: R): Promise<void>;
+    update(updater: (state: T) => void): Promise<void>;
+    delete(key: StorageKeyType): Promise<void>;
+    clear(): Promise<void>;
+    keys(): Promise<string[]>;
+    has(key: StorageKeyType): Promise<boolean>;
+    getState(): Promise<T>;
+    subscribeToAll(callback: (event: {
+        type: string;
+        key?: StorageKeyType[] | StorageKeyType;
+        value?: any;
+        changedPaths?: string[];
+    }) => void): VoidFunction;
+    subscribe(key: string, callback: (value: any) => void): VoidFunction;
+    subscribe<R>(pathSelector: PathSelector<T, R>, callback: (value: R) => void): VoidFunction;
+    destroy(): Promise<void>;
+    private subscribeByKey;
+    private createDummyState;
+    private isEqual;
+    /**
+     * Возвращает полный путь, а не только корневой ключ
+     */
+    private extractPath;
+    protected notifySubscribers(key: StorageKeyType, value: any): void;
+    /**
+     * Метод для определения изменившихся путей между двумя объектами
+     */
+    private findChangedPaths;
+    private subscribeBySelector;
+    protected emitEvent(event: StorageEvent): Promise<void>;
+}
+
+interface SharedStateMiddlewareProps {
+    storageType: StorageType;
+    storageName: string;
+}
+declare const broadcastMiddleware: (props: SharedStateMiddlewareProps) => Middleware;
+
+declare class StoragePluginModule implements IPluginManager<IStoragePlugin>, IPluginExecutor {
+    protected readonly parentExecutor?: IPluginExecutor | undefined;
+    protected readonly logger?: ILogger | undefined;
+    protected readonly storageName: string;
+    private plugins;
+    constructor(parentExecutor?: IPluginExecutor | undefined, logger?: ILogger | undefined, storageName?: string);
+    private createContext;
+    add(plugin: IStoragePlugin): Promise<void>;
+    remove(name: string): Promise<void>;
+    get(name: string): IStoragePlugin | undefined;
+    getAll(): IStoragePlugin[];
+    initialize(): Promise<void>;
+    destroy(): Promise<void>;
+    executeBeforeSet<T>(value: T, metadata?: Record<string, any>): Promise<T>;
+    executeAfterSet<T>(key: StorageKeyType, value: T, metadata?: Record<string, any>): Promise<T>;
+    executeBeforeGet(key: StorageKeyType, metadata?: Record<string, any>): Promise<StorageKeyType>;
+    executeAfterGet<T>(key: StorageKeyType, value: T | undefined, metadata?: Record<string, any>): Promise<T | undefined>;
+    executeBeforeDelete(key: StorageKeyType, metadata?: Record<string, any>): Promise<boolean>;
+    executeAfterDelete(key: StorageKeyType, metadata?: Record<string, any>): Promise<void>;
+    executeOnClear(metadata?: Record<string, any>): Promise<void>;
+}
+
+interface IndexedDBConfig {
+    dbName?: string;
+    dbVersion: number;
+}
+declare class IndexedDBStorage<T extends Record<string, any>> extends BaseStorage<T> {
+    private readonly DB_NAME;
+    private readonly STORE_NAME;
+    private readonly DB_VERSION;
+    private dbManager;
+    constructor(config: StorageConfig & {
+        options: IndexedDBConfig;
+    }, pluginExecutor?: IPluginExecutor, eventEmitter?: IEventEmitter, logger?: ILogger);
+    initialize(): Promise<this>;
+    static getCurrentDBVersion(dbName: string): Promise<number>;
+    static createStorages<S extends Record<string, any>>(dbName: string, configs: {
+        [K in keyof S]: {
+            name: string;
+            initialState?: S[K];
+            middlewares?: ConfigureMiddlewares;
+            pluginExecutor?: IPluginExecutor;
+            eventEmitter?: IEventEmitter;
+        };
+    }, logger?: ILogger): Promise<{
+        [K in keyof S]: IndexedDBStorage<S[K]>;
+    }>;
+    private getTransaction;
+    private getObjectStore;
+    protected doGet(key: StorageKeyType): Promise<any>;
+    protected doSet(key: StorageKeyType, value: any): Promise<void>;
+    private putValueInStore;
+    protected doUpdate(updates: Array<{
+        key: string | StorageKey;
+        value: any;
+    }>): Promise<void>;
+    protected doDelete(key: StorageKeyType): Promise<boolean>;
+    protected doClear(): Promise<void>;
+    protected doKeys(): Promise<string[]>;
+    protected doHas(key: StorageKeyType): Promise<boolean>;
+    protected doDestroy(): Promise<void>;
+}
+
+declare class LocalStorage<T extends Record<string, any>> extends BaseStorage<T> {
+    constructor(config: StorageConfig, pluginExecutor?: IPluginExecutor, eventEmitter?: IEventEmitter, logger?: ILogger);
+    initialize(): Promise<this>;
+    protected doGet(key: StorageKeyType): Promise<any>;
+    protected doSet(key: StorageKeyType, value: any): Promise<void>;
+    protected doDelete(key: StorageKeyType): Promise<boolean>;
+    protected doUpdate(updates: Array<{
+        key: StorageKeyType;
+        value: any;
+    }>): Promise<void>;
+    protected doClear(): Promise<void>;
+    protected doKeys(): Promise<string[]>;
+    protected doHas(key: StorageKeyType): Promise<boolean>;
+    private getAllKeys;
+    protected doDestroy(): Promise<void>;
+}
+
+declare class MemoryStorage<T extends Record<string, any>> extends BaseStorage<T> {
+    private storage;
+    constructor(config: StorageConfig, pluginExecutor?: IPluginExecutor, eventEmitter?: IEventEmitter, logger?: ILogger);
+    initialize(): Promise<this>;
+    protected doGet(key: StorageKeyType): Promise<any>;
+    protected doSet(key: StorageKeyType, value: any): Promise<void>;
+    protected doDelete(key: StorageKeyType): Promise<boolean>;
+    protected doUpdate(updates: Array<{
+        key: StorageKeyType;
+        value: any;
+    }>): Promise<void>;
+    protected doClear(): Promise<void>;
+    protected doKeys(): Promise<string[]>;
+    protected doHas(key: StorageKeyType): Promise<boolean>;
+    protected doDestroy(): Promise<void>;
+    private getAllKeys;
+}
+
+declare class SelectorModule<S extends Record<string, any>> implements ISelectorModule<S> {
+    private readonly source;
+    private readonly logger?;
+    storageName: string;
+    private subscriptions;
+    private cachedState?;
+    private localSelectorCache;
+    private batchUpdateInProgress;
+    private pendingUpdates;
+    constructor(source: IStorage<S>, logger?: ILogger | undefined);
+    /**
+     * Генерирует имя для селектора на основе его типа и функции
+     */
+    private generateName;
+    /**
+     * Обрабатывает отложенные обновления, чтобы избежать каскадных уведомлений
+     */
+    private processPendingUpdates;
+    createSelector<T>(selector: Selector<S, T>, options?: SelectorOptions<T>): SelectorAPI<T>;
+    createSelector<Deps extends unknown[], T>(dependencies: {
+        [K in keyof Deps]: SelectorAPI<Deps[K]>;
+    }, resultFn: (...args: Deps) => T, options?: SelectorOptions<T>): SelectorAPI<T>;
+    private createSimpleSelector;
+    private createCombinedSelector;
+    destroy(): void;
+}
+
+export { ConfigureMiddlewares, DefaultMiddlewares, IEventEmitter, ILogger, type IPlugin, type IPluginExecutor, type IPluginManager, ISelectorModule, IStorage, type IStoragePlugin, IndexedDBStorage, LocalStorage, MemoryStorage, Middleware, type PluginContext, SelectorAPI, SelectorModule, StorageConfig, StorageEvent, StorageKeyType, StoragePluginModule, StorageType, broadcastMiddleware };