synapse-storage 2.1.0

package/dist/core/storage/middlewares/storage-shallow-compare.middleware.js

@@ -0,0 +1,46 @@
+export const shallowCompareMiddleware = (options = {}) => {
+    const { comparator = (prev, next) => {
+        if (prev === next)
+            return true;
+        if (typeof prev !== 'object' || typeof next !== 'object' || prev === null || next === null) {
+            return prev === next;
+        }
+        const keysA = Object.keys(prev);
+        const keysB = Object.keys(next);
+        if (keysA.length !== keysB.length)
+            return false;
+        return keysA.every((key) => Object.prototype.hasOwnProperty.call(next, key) && prev[key] === next[key]);
+    }, segments = [], } = options;
+    // Кэш последних значений
+    const valueCache = new Map();
+    return {
+        name: 'shallow-compare',
+        setup: (api) => { },
+        reducer: (api) => (next) => async (action) => {
+            // Пропускаем действия кроме set
+            if (action.type !== 'set' || (segments.length && !segments.includes(action.metadata?.segment ?? 'default'))) {
+                return next(action);
+            }
+            const cacheKey = action.key;
+            const prevValue = valueCache.get(cacheKey);
+            const nextValue = action.value;
+            // Если значения равны, пропускаем операцию
+            if (prevValue !== undefined && comparator(prevValue, nextValue)) {
+                console.log('ShallowCompare: значения идентичны, пропускаем операцию', { key: cacheKey, value: nextValue });
+                // Добавляем специальный флаг в метаданные, чтобы BaseStorage знал, что значение не изменилось
+                return {
+                    ...prevValue,
+                    __metadata: {
+                        valueNotChanged: true, // Этот флаг будет проверяться в BaseStorage перед notifySubscribers
+                        originalValue: prevValue,
+                    },
+                };
+            }
+            // Иначе обновляем кэш и продолжаем
+            const result = await next(action);
+            valueCache.set(cacheKey, nextValue);
+            return result;
+        },
+    };
+};
+//# sourceMappingURL=storage-shallow-compare.middleware.js.map

package/dist/core/storage/middlewares/storage-shallow-compare.middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-shallow-compare.middleware.js","sourceRoot":"","sources":["../../../../src/core/storage/middlewares/storage-shallow-compare.middleware.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,UAA2C,EAAE,EAAc,EAAE;IACpG,MAAM,EACJ,UAAU,GAAG,CAAC,IAAS,EAAE,IAAS,EAAE,EAAE;QACpC,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;QAE9B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAC3F,OAAO,IAAI,KAAK,IAAI,CAAA;QACtB,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAE/B,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;YAAE,OAAO,KAAK,CAAA;QAE/C,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IACzG,CAAC,EACD,QAAQ,GAAG,EAAE,GACd,GAAG,OAAO,CAAA;IAEX,yBAAyB;IACzB,MAAM,UAAU,GAAG,IAAI,GAAG,EAA4B,CAAA;IAEtD,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,CAAC,GAAkB,EAAE,EAAE,GAAE,CAAC;QACjC,OAAO,EAAE,CAAC,GAAkB,EAAE,EAAE,CAAC,CAAC,IAAkB,EAAE,EAAE,CAAC,KAAK,EAAE,MAAqB,EAAE,EAAE;YACvF,gCAAgC;YAChC,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,IAAI,SAAS,CAAC,CAAC,EAAE,CAAC;gBAC5G,OAAO,IAAI,CAAC,MAAM,CAAC,CAAA;YACrB,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAI,CAAA;YAC5B,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAA;YAE9B,2CAA2C;YAC3C,IAAI,SAAS,KAAK,SAAS,IAAI,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC;gBAChE,OAAO,CAAC,GAAG,CAAC,yDAAyD,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAA;gBAE3G,8FAA8F;gBAC9F,OAAO;oBACL,GAAG,SAAS;oBACZ,UAAU,EAAE;wBACV,eAAe,EAAE,IAAI,EAAE,oEAAoE;wBAC3F,aAAa,EAAE,SAAS;qBACzB;iBACF,CAAA;YACH,CAAC;YAED,mCAAmC;YACnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,CAAA;YACjC,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;YACnC,OAAO,MAAM,CAAA;QACf,CAAC;KACF,CAAA;AACH,CAAC,CAAA"}

package/dist/core/storage/modules/plugin/plugin.interface.d.ts

@@ -0,0 +1,201 @@
+import { StorageKeyType } from '../../utils/storage-key';
+/**
+ * Контекст выполнения для плагинов
+ * Содержит информацию о текущей операции и хранилище
+ */
+export interface PluginContext {
+    /** Имя хранилища, к которому применяется плагин */
+    storageName: string;
+    /** Временная метка выполнения операции (timestamp) */
+    timestamp: number;
+    /** Дополнительные метаданные операции (могут быть предоставлены хранилищем или другими плагинами) */
+    metadata?: Record<string, any>;
+}
+/**
+ * Базовый интерфейс для всех плагинов
+ * Определяет основные свойства и методы жизненного цикла
+ */
+export interface IPlugin {
+    /** Уникальное имя плагина */
+    name: string;
+    /**
+     * Метод инициализации плагина
+     * Вызывается при добавлении плагина в хранилище или при инициализации хранилища
+     */
+    initialize?(): Promise<void>;
+    /**
+     * Метод уничтожения плагина
+     * Вызывается при удалении плагина из хранилища или при уничтожении хранилища
+     * Используется для освобождения ресурсов и очистки состояния
+     */
+    destroy?(): Promise<void>;
+}
+/**
+ * Интерфейс плагина для хранилища данных
+ * Определяет хуки для различных операций хранилища
+ */
+export 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>;
+}
+/**
+ * Исполнитель плагинов
+ * Отвечает за выполнение хуков плагинов в определенной последовательности
+ */
+export 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>;
+}
+/**
+ * Менеджер плагинов
+ * Отвечает за регистрацию, получение и удаление плагинов
+ */
+export 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>;
+}
+//# sourceMappingURL=plugin.interface.d.ts.map

package/dist/core/storage/modules/plugin/plugin.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.interface.d.ts","sourceRoot":"","sources":["../../../../../src/core/storage/modules/plugin/plugin.interface.ts"],"names":[],"mappings":"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"}

package/dist/core/storage/modules/plugin/plugin.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plugin.interface.js.map

package/dist/core/storage/modules/plugin/plugin.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.interface.js","sourceRoot":"","sources":["../../../../../src/core/storage/modules/plugin/plugin.interface.ts"],"names":[],"mappings":""}

package/dist/core/storage/modules/plugin/plugin.service.d.ts

@@ -0,0 +1,25 @@
+import { ILogger } from '../../storage.interface';
+import { StorageKeyType } from '../../utils/storage-key';
+import { IPluginExecutor, IPluginManager, IStoragePlugin } from './plugin.interface';
+export 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>;
+}
+//# sourceMappingURL=plugin.service.d.ts.map

package/dist/core/storage/modules/plugin/plugin.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.service.d.ts","sourceRoot":"","sources":["../../../../../src/core/storage/modules/plugin/plugin.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAiB,MAAM,oBAAoB,CAAA;AAEnG,qBAAa,mBAAoB,YAAW,cAAc,CAAC,cAAc,CAAC,EAAE,eAAe;IAIvF,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,eAAe;IACnD,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO;IACnC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM;IALxC,OAAO,CAAC,OAAO,CAAoC;gBAG9B,cAAc,CAAC,EAAE,eAAe,YAAA,EAChC,MAAM,CAAC,EAAE,OAAO,YAAA,EAChB,WAAW,GAAE,MAAkB;IAGpD,OAAO,CAAC,aAAa;IAQR,GAAG,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAe1C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASzC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI7C,MAAM,IAAI,cAAc,EAAE;IAIpB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAKxB,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAsBzE,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAsB7F,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;IAsB9F,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAsBrH,mBAAmB,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAsB1F,kBAAkB,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBtF,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAkB3E"}

package/dist/core/storage/modules/plugin/plugin.service.js

@@ -0,0 +1,186 @@
+export class StoragePluginModule {
+    parentExecutor;
+    logger;
+    storageName;
+    plugins = new Map();
+    constructor(parentExecutor, logger, storageName = 'default') {
+        this.parentExecutor = parentExecutor;
+        this.logger = logger;
+        this.storageName = storageName;
+    }
+    createContext(metadata) {
+        return {
+            storageName: this.storageName,
+            timestamp: Date.now(),
+            metadata,
+        };
+    }
+    async add(plugin) {
+        if (this.plugins.has(plugin.name)) {
+            this.logger?.warn(`Плагин ${plugin.name} уже был зарегистрирован`);
+            return;
+        }
+        try {
+            await plugin.initialize?.();
+            this.plugins.set(plugin.name, plugin);
+            this.logger?.info('Плагин добавлен', { name: plugin.name });
+        }
+        catch (error) {
+            throw error;
+        }
+    }
+    async remove(name) {
+        const plugin = this.plugins.get(name);
+        if (plugin) {
+            await plugin.destroy?.();
+            this.plugins.delete(name);
+            this.logger?.info('Плагин удален', { name });
+        }
+    }
+    get(name) {
+        return this.plugins.get(name);
+    }
+    getAll() {
+        return Array.from(this.plugins.values());
+    }
+    async initialize() {
+        for (const plugin of this.plugins.values()) {
+            await plugin.initialize?.();
+        }
+    }
+    async destroy() {
+        await Promise.all(Array.from(this.plugins.values()).map((plugin) => plugin.destroy?.() ?? Promise.resolve()));
+        this.plugins.clear();
+    }
+    async executeBeforeSet(value, metadata) {
+        let result = value;
+        const context = this.createContext(metadata);
+        if (this.parentExecutor) {
+            result = await this.parentExecutor.executeBeforeSet(result, context);
+        }
+        for (const plugin of this.plugins.values()) {
+            if (plugin.onBeforeSet) {
+                try {
+                    result = await plugin.onBeforeSet(result, context);
+                }
+                catch (error) {
+                    this.logger?.error(`Ошибка в плагине ${plugin.name} onBeforeSet`, { error });
+                    throw error;
+                }
+            }
+        }
+        return result;
+    }
+    async executeAfterSet(key, value, metadata) {
+        let result = value;
+        const context = this.createContext(metadata);
+        if (this.parentExecutor) {
+            result = await this.parentExecutor.executeAfterSet(key, result, context);
+        }
+        for (const plugin of this.plugins.values()) {
+            if (plugin.onAfterSet) {
+                try {
+                    result = await plugin.onAfterSet(key, result, context);
+                }
+                catch (error) {
+                    this.logger?.error(`Ошибка в плагине ${plugin.name} onAfterSet`, { key, error });
+                    throw error;
+                }
+            }
+        }
+        return result;
+    }
+    async executeBeforeGet(key, metadata) {
+        let processedKey = key;
+        const context = this.createContext(metadata);
+        if (this.parentExecutor) {
+            processedKey = await this.parentExecutor.executeBeforeGet(processedKey, context);
+        }
+        for (const plugin of this.plugins.values()) {
+            if (plugin.onBeforeGet) {
+                try {
+                    processedKey = await plugin.onBeforeGet(processedKey, context);
+                }
+                catch (error) {
+                    this.logger?.error(`Ошибка в плагине ${plugin.name} onBeforeGet`, { key, error });
+                    throw error;
+                }
+            }
+        }
+        return processedKey;
+    }
+    async executeAfterGet(key, value, metadata) {
+        let result = value;
+        const context = this.createContext(metadata);
+        if (this.parentExecutor) {
+            result = await this.parentExecutor.executeAfterGet(key, result, context);
+        }
+        console.log('executeAfterGet', key, value, metadata);
+        for (const plugin of this.plugins.values()) {
+            if (plugin.onAfterGet) {
+                try {
+                    result = await plugin.onAfterGet(key, result, context);
+                }
+                catch (error) {
+                    this.logger?.error(`Ошибка в плагине ${plugin.name} onAfterGet`, { key, error });
+                    throw error;
+                }
+            }
+        }
+        return result;
+    }
+    async executeBeforeDelete(key, metadata) {
+        let canDelete = true;
+        const context = this.createContext(metadata);
+        if (this.parentExecutor) {
+            canDelete = await this.parentExecutor.executeBeforeDelete(key, context);
+        }
+        for (const plugin of this.plugins.values()) {
+            if (plugin.onBeforeDelete) {
+                try {
+                    canDelete = (await plugin.onBeforeDelete(key, context)) && canDelete;
+                }
+                catch (error) {
+                    this.logger?.error(`Ошибка в плагине ${plugin.name} onBeforeDelete`, { key, error });
+                    throw error;
+                }
+            }
+        }
+        return canDelete;
+    }
+    async executeAfterDelete(key, metadata) {
+        const context = this.createContext(metadata);
+        if (this.parentExecutor) {
+            await this.parentExecutor.executeAfterDelete(key, context);
+        }
+        for (const plugin of this.plugins.values()) {
+            if (plugin.onAfterDelete) {
+                try {
+                    await plugin.onAfterDelete(key, context);
+                }
+                catch (error) {
+                    this.logger?.error(`Ошибка в плагине ${plugin.name} onAfterDelete`, { key, error });
+                    throw error;
+                }
+            }
+        }
+    }
+    async executeOnClear(metadata) {
+        const context = this.createContext(metadata);
+        if (this.parentExecutor) {
+            await this.parentExecutor.executeOnClear(context);
+        }
+        for (const plugin of this.plugins.values()) {
+            if (plugin.onClear) {
+                try {
+                    await plugin.onClear(context);
+                }
+                catch (error) {
+                    this.logger?.error(`Ошибка в плагине ${plugin.name} onClear`, { error });
+                    throw error;
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=plugin.service.js.map

package/dist/core/storage/modules/plugin/plugin.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.service.js","sourceRoot":"","sources":["../../../../../src/core/storage/modules/plugin/plugin.service.ts"],"names":[],"mappings":"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"}

package/dist/core/storage/storage.interface.d.ts

@@ -0,0 +1,70 @@
+import { IndexedDBConfig } from './adapters/indexed-DB.service.old';
+import { BatchingMiddlewareOptions, ShallowCompareMiddlewareOptions } from './middlewares';
+import { Middleware } from './utils/middleware-module';
+import { StorageKeyType } from './utils/storage-key';
+export interface IStorage<T extends Record<string, any> = any> {
+    name: string;
+    get<R>(key: StorageKeyType): Promise<R | undefined>;
+    getState(): Promise<T>;
+    set<R>(key: StorageKeyType, value: R): Promise<void>;
+    update(updater: (state: T) => void): Promise<void>;
+    has(key: StorageKeyType): Promise<boolean>;
+    delete(key: StorageKeyType): Promise<void>;
+    clear(): Promise<void>;
+    keys(): Promise<string[]>;
+    destroy(): Promise<void>;
+    subscribeToAll(callback: (event: {
+        type: string;
+        changedPaths?: string[];
+        key?: StorageKeyType[] | StorageKeyType;
+        value?: any;
+    }) => void): VoidFunction;
+    initialize(): Promise<this>;
+    subscribe(key: StorageKeyType, callback: (value: any) => void): VoidFunction;
+    subscribe<R>(pathSelector: (state: T) => R, callback: (value: R) => void): VoidFunction;
+}
+export declare enum StorageEvents {
+    STORAGE_UPDATE = "storage:update",
+    STORAGE_DELETE = "storage:delete",
+    STORAGE_PATCH = "storage:patch",
+    STORAGE_SELECT = "storage:select",
+    STORAGE_CLEAR = "storage:clear",
+    STORAGE_DESTROY = "storage:destroy"
+}
+export interface StorageEvent<T = any> {
+    type: string;
+    payload?: T;
+    metadata?: Record<string, any>;
+}
+export interface IEventEmitter {
+    emit(event: StorageEvent): Promise<void>;
+}
+export interface ILogger {
+    debug(message: string, meta?: Record<string, any>): void;
+    info(message: string, meta?: Record<string, any>): void;
+    warn(message: string, meta?: Record<string, any>): void;
+    error(message: string, meta?: Record<string, any>): void;
+}
+export interface DefaultMiddlewares {
+    batching: (options?: BatchingMiddlewareOptions) => Middleware;
+    shallowCompare: (options?: ShallowCompareMiddlewareOptions) => Middleware;
+}
+export type GetDefaultMiddleware = () => DefaultMiddlewares;
+export type ConfigureMiddlewares = (getDefaultMiddleware: GetDefaultMiddleware) => Middleware[];
+export interface StorageConfig {
+    name: string;
+    initialState?: Record<string, any>;
+    middlewares?: ConfigureMiddlewares;
+}
+export type StorageType = 'memory' | 'localStorage' | 'indexedDB';
+export interface MemoryStorageConfig extends StorageConfig {
+    type: 'memory';
+}
+export interface LocalStorageConfig extends StorageConfig {
+    type: 'localStorage';
+}
+export interface IndexedDBStorageConfig extends StorageConfig {
+    type: 'indexedDB';
+    options: IndexedDBConfig;
+}
+//# sourceMappingURL=storage.interface.d.ts.map

package/dist/core/storage/storage.interface.d.ts.map

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

package/dist/core/storage/storage.interface.js

@@ -0,0 +1,10 @@
+export var StorageEvents;
+(function (StorageEvents) {
+    StorageEvents["STORAGE_UPDATE"] = "storage:update";
+    StorageEvents["STORAGE_DELETE"] = "storage:delete";
+    StorageEvents["STORAGE_PATCH"] = "storage:patch";
+    StorageEvents["STORAGE_SELECT"] = "storage:select";
+    StorageEvents["STORAGE_CLEAR"] = "storage:clear";
+    StorageEvents["STORAGE_DESTROY"] = "storage:destroy";
+})(StorageEvents || (StorageEvents = {}));
+//# sourceMappingURL=storage.interface.js.map

package/dist/core/storage/storage.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.interface.js","sourceRoot":"","sources":["../../../src/core/storage/storage.interface.ts"],"names":[],"mappings":"AAuBA,MAAM,CAAN,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,kDAAiC,CAAA;IACjC,kDAAiC,CAAA;IACjC,gDAA+B,CAAA;IAC/B,kDAAiC,CAAA;IACjC,gDAA+B,CAAA;IAC/B,oDAAmC,CAAA;AACrC,CAAC,EAPW,aAAa,KAAb,aAAa,QAOxB"}

package/dist/core/storage/utils/batch.utils.d.ts

@@ -0,0 +1,33 @@
+import { StorageAction } from './middleware-module';
+import { StorageKeyType } from './storage-key';
+export interface BatchOptions<T> {
+    batchSize?: number;
+    batchDelay?: number;
+    onBatch?: (items: T[]) => Promise<void>;
+    getSegmentKey?: (item: T) => StorageKeyType;
+    shouldBatch?: (item: T) => boolean;
+    mergeItems?: (items: T[]) => T[];
+}
+export interface BatchQueueItem<T extends StorageAction> {
+    action: T;
+    baseOperation: () => Promise<any>;
+    resolve: (value: any) => void;
+    reject: (error: any) => void;
+}
+export declare class BatchProcessor<T extends StorageAction> {
+    private readonly options;
+    private queues;
+    private timeouts;
+    constructor(options: BatchOptions<T>);
+    add(action: T, baseOperation: () => Promise<any>): Promise<any>;
+    private addToQueue;
+    private processBatch;
+    private clearSegmentTimeout;
+    private setSegmentTimeout;
+    flush(): Promise<void>;
+    clear(): void;
+    getState(): {
+        [segment: string]: number;
+    };
+}
+//# sourceMappingURL=batch.utils.d.ts.map

package/dist/core/storage/utils/batch.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.utils.d.ts","sourceRoot":"","sources":["../../../../src/core/storage/utils/batch.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAE9C,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAEvC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,cAAc,CAAA;IAE3C,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAA;IAElC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,CAAA;CACjC;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,aAAa;IACrD,MAAM,EAAE,CAAC,CAAA;IACT,aAAa,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAA;IACjC,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAA;IAC7B,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAA;CAC7B;AAED,qBAAa,cAAc,CAAC,CAAC,SAAS,aAAa;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IAEnD,OAAO,CAAC,MAAM,CAAiD;IAE/D,OAAO,CAAC,QAAQ,CAA4C;gBAEhD,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;IAWvB,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAW5E,OAAO,CAAC,UAAU;YAiBJ,YAAY;IAqB1B,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,iBAAiB;IAQZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,KAAK,IAAI,IAAI;IAMb,QAAQ,IAAI;QAAE,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE;CAOjD"}