synapse-storage 3.0.19 → 4.0.0

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

@@ -0,0 +1,406 @@
+// ─── Sync Plugin Module ───────────────────────────────────────────────────────
+class SyncStoragePluginModule {
+    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();
+    }
+    executeBeforeSet(value, metadata) {
+        let result = value;
+        const context = this.createContext(metadata);
+        if (this.parentExecutor) {
+            result = this.parentExecutor.executeBeforeSet(result, metadata);
+        }
+        for (const plugin of this.plugins.values()){
+            if (plugin.onBeforeSet) {
+                try {
+                    result = plugin.onBeforeSet(result, context);
+                } catch (error) {
+                    this.logger?.error(`Ошибка в плагине ${plugin.name} onBeforeSet`, {
+                        error
+                    });
+                    throw error;
+                }
+            }
+        }
+        return result;
+    }
+    executeAfterSet(key, value, metadata) {
+        let result = value;
+        const context = this.createContext(metadata);
+        if (this.parentExecutor) {
+            result = this.parentExecutor.executeAfterSet(key, result, metadata);
+        }
+        for (const plugin of this.plugins.values()){
+            if (plugin.onAfterSet) {
+                try {
+                    result = plugin.onAfterSet(key, result, context);
+                } catch (error) {
+                    this.logger?.error(`Ошибка в плагине ${plugin.name} onAfterSet`, {
+                        key,
+                        error
+                    });
+                    throw error;
+                }
+            }
+        }
+        return result;
+    }
+    executeBeforeGet(key, metadata) {
+        let processedKey = key;
+        const context = this.createContext(metadata);
+        if (this.parentExecutor) {
+            processedKey = this.parentExecutor.executeBeforeGet(processedKey, metadata);
+        }
+        for (const plugin of this.plugins.values()){
+            if (plugin.onBeforeGet) {
+                try {
+                    processedKey = plugin.onBeforeGet(processedKey, context);
+                } catch (error) {
+                    this.logger?.error(`Ошибка в плагине ${plugin.name} onBeforeGet`, {
+                        key,
+                        error
+                    });
+                    throw error;
+                }
+            }
+        }
+        return processedKey;
+    }
+    executeAfterGet(key, value, metadata) {
+        let result = value;
+        const context = this.createContext(metadata);
+        if (this.parentExecutor) {
+            result = this.parentExecutor.executeAfterGet(key, result, metadata);
+        }
+        for (const plugin of this.plugins.values()){
+            if (plugin.onAfterGet) {
+                try {
+                    result = plugin.onAfterGet(key, result, context);
+                } catch (error) {
+                    this.logger?.error(`Ошибка в плагине ${plugin.name} onAfterGet`, {
+                        key,
+                        error
+                    });
+                    throw error;
+                }
+            }
+        }
+        return result;
+    }
+    executeBeforeDelete(key, metadata) {
+        let canDelete = true;
+        const context = this.createContext(metadata);
+        if (this.parentExecutor) {
+            canDelete = this.parentExecutor.executeBeforeDelete(key, metadata);
+        }
+        for (const plugin of this.plugins.values()){
+            if (plugin.onBeforeDelete) {
+                try {
+                    canDelete = plugin.onBeforeDelete(key, context) && canDelete;
+                } catch (error) {
+                    this.logger?.error(`Ошибка в плагине ${plugin.name} onBeforeDelete`, {
+                        key,
+                        error
+                    });
+                    throw error;
+                }
+            }
+        }
+        return canDelete;
+    }
+    executeAfterDelete(key, metadata) {
+        const context = this.createContext(metadata);
+        if (this.parentExecutor) {
+            this.parentExecutor.executeAfterDelete(key, metadata);
+        }
+        for (const plugin of this.plugins.values()){
+            if (plugin.onAfterDelete) {
+                try {
+                    plugin.onAfterDelete(key, context);
+                } catch (error) {
+                    this.logger?.error(`Ошибка в плагине ${plugin.name} onAfterDelete`, {
+                        key,
+                        error
+                    });
+                    throw error;
+                }
+            }
+        }
+    }
+    executeOnClear(metadata) {
+        const context = this.createContext(metadata);
+        if (this.parentExecutor) {
+            this.parentExecutor.executeOnClear(metadata);
+        }
+        for (const plugin of this.plugins.values()){
+            if (plugin.onClear) {
+                try {
+                    plugin.onClear(context);
+                } catch (error) {
+                    this.logger?.error(`Ошибка в плагине ${plugin.name} onClear`, {
+                        error
+                    });
+                    throw error;
+                }
+            }
+        }
+    }
+}
+// ─── Async Plugin Module ──────────────────────────────────────────────────────
+class AsyncStoragePluginModule {
+    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, metadata);
+        }
+        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, metadata);
+        }
+        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, metadata);
+        }
+        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, 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;
+                }
+            }
+        }
+    }
+}
+/** @deprecated Use AsyncStoragePluginModule */ class StoragePluginModule extends AsyncStoragePluginModule {
+}
+
+export { AsyncStoragePluginModule, StoragePluginModule, SyncStoragePluginModule };
+
+//# sourceMappingURL=plugin.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core/storage/modules/plugin/plugin.service.js","sources":["../../../../../src/core/storage/modules/plugin/plugin.service.ts"],"sourcesContent":["import { ILogger } from '../../storage.interface'\nimport { StorageKeyType } from '../../utils/storage-key'\nimport { IAsyncPluginExecutor, IAsyncStoragePlugin, IPluginManager, ISyncPluginExecutor, ISyncStoragePlugin, PluginContext } from './plugin.interface'\n\n// ─── Sync Plugin Module ───────────────────────────────────────────────────────\n\nexport class SyncStoragePluginModule implements IPluginManager<ISyncStoragePlugin>, ISyncPluginExecutor {\n  private plugins = new Map<string, ISyncStoragePlugin>()\n\n  constructor(\n    protected readonly parentExecutor?: ISyncPluginExecutor,\n    protected readonly logger?: ILogger,\n    protected readonly storageName: string = 'default',\n  ) {}\n\n  private createContext(metadata?: Record<string, any>): PluginContext {\n    return {\n      storageName: this.storageName,\n      timestamp: Date.now(),\n      metadata,\n    }\n  }\n\n  public async add(plugin: ISyncStoragePlugin): Promise<void> {\n    if (this.plugins.has(plugin.name)) {\n      this.logger?.warn(`Плагин ${plugin.name} уже был зарегистрирован`)\n      return\n    }\n\n    try {\n      await plugin.initialize?.()\n      this.plugins.set(plugin.name, plugin)\n      this.logger?.info('Плагин добавлен', { name: plugin.name })\n    } catch (error) {\n      throw error\n    }\n  }\n\n  public async remove(name: string): Promise<void> {\n    const plugin = this.plugins.get(name)\n    if (plugin) {\n      await plugin.destroy?.()\n      this.plugins.delete(name)\n      this.logger?.info('Плагин удален', { name })\n    }\n  }\n\n  public get(name: string): ISyncStoragePlugin | undefined {\n    return this.plugins.get(name)\n  }\n\n  public getAll(): ISyncStoragePlugin[] {\n    return Array.from(this.plugins.values())\n  }\n\n  public async initialize(): Promise<void> {\n    for (const plugin of this.plugins.values()) {\n      await plugin.initialize?.()\n    }\n  }\n\n  public async destroy(): Promise<void> {\n    await Promise.all(Array.from(this.plugins.values()).map((plugin) => plugin.destroy?.() ?? Promise.resolve()))\n    this.plugins.clear()\n  }\n\n  public executeBeforeSet<T>(value: T, metadata?: Record<string, any>): T {\n    let result = value\n    const context = this.createContext(metadata)\n\n    if (this.parentExecutor) {\n      result = this.parentExecutor.executeBeforeSet(result, metadata)\n    }\n\n    for (const plugin of this.plugins.values()) {\n      if (plugin.onBeforeSet) {\n        try {\n          result = plugin.onBeforeSet(result, context)\n        } catch (error) {\n          this.logger?.error(`Ошибка в плагине ${plugin.name} onBeforeSet`, { error })\n          throw error\n        }\n      }\n    }\n\n    return result\n  }\n\n  public executeAfterSet<T>(key: StorageKeyType, value: T, metadata?: Record<string, any>): T {\n    let result = value\n    const context = this.createContext(metadata)\n\n    if (this.parentExecutor) {\n      result = this.parentExecutor.executeAfterSet(key, result, metadata)\n    }\n\n    for (const plugin of this.plugins.values()) {\n      if (plugin.onAfterSet) {\n        try {\n          result = plugin.onAfterSet(key, result, context)\n        } catch (error) {\n          this.logger?.error(`Ошибка в плагине ${plugin.name} onAfterSet`, { key, error })\n          throw error\n        }\n      }\n    }\n\n    return result\n  }\n\n  public executeBeforeGet(key: StorageKeyType, metadata?: Record<string, any>): StorageKeyType {\n    let processedKey = key\n    const context = this.createContext(metadata)\n\n    if (this.parentExecutor) {\n      processedKey = this.parentExecutor.executeBeforeGet(processedKey, metadata)\n    }\n\n    for (const plugin of this.plugins.values()) {\n      if (plugin.onBeforeGet) {\n        try {\n          processedKey = plugin.onBeforeGet(processedKey, context)\n        } catch (error) {\n          this.logger?.error(`Ошибка в плагине ${plugin.name} onBeforeGet`, { key, error })\n          throw error\n        }\n      }\n    }\n\n    return processedKey\n  }\n\n  public executeAfterGet<T>(key: StorageKeyType, value: T | undefined, metadata?: Record<string, any>): T | undefined {\n    let result = value\n    const context = this.createContext(metadata)\n\n    if (this.parentExecutor) {\n      result = this.parentExecutor.executeAfterGet(key, result, metadata)\n    }\n\n    for (const plugin of this.plugins.values()) {\n      if (plugin.onAfterGet) {\n        try {\n          result = plugin.onAfterGet(key, result, context)\n        } catch (error) {\n          this.logger?.error(`Ошибка в плагине ${plugin.name} onAfterGet`, { key, error })\n          throw error\n        }\n      }\n    }\n\n    return result\n  }\n\n  public executeBeforeDelete(key: StorageKeyType, metadata?: Record<string, any>): boolean {\n    let canDelete = true\n    const context = this.createContext(metadata)\n\n    if (this.parentExecutor) {\n      canDelete = this.parentExecutor.executeBeforeDelete(key, metadata)\n    }\n\n    for (const plugin of this.plugins.values()) {\n      if (plugin.onBeforeDelete) {\n        try {\n          canDelete = plugin.onBeforeDelete(key, context) && canDelete\n        } catch (error) {\n          this.logger?.error(`Ошибка в плагине ${plugin.name} onBeforeDelete`, { key, error })\n          throw error\n        }\n      }\n    }\n\n    return canDelete\n  }\n\n  public executeAfterDelete(key: StorageKeyType, metadata?: Record<string, any>): void {\n    const context = this.createContext(metadata)\n\n    if (this.parentExecutor) {\n      this.parentExecutor.executeAfterDelete(key, metadata)\n    }\n\n    for (const plugin of this.plugins.values()) {\n      if (plugin.onAfterDelete) {\n        try {\n          plugin.onAfterDelete(key, context)\n        } catch (error) {\n          this.logger?.error(`Ошибка в плагине ${plugin.name} onAfterDelete`, { key, error })\n          throw error\n        }\n      }\n    }\n  }\n\n  public executeOnClear(metadata?: Record<string, any>): void {\n    const context = this.createContext(metadata)\n\n    if (this.parentExecutor) {\n      this.parentExecutor.executeOnClear(metadata)\n    }\n\n    for (const plugin of this.plugins.values()) {\n      if (plugin.onClear) {\n        try {\n          plugin.onClear(context)\n        } catch (error) {\n          this.logger?.error(`Ошибка в плагине ${plugin.name} onClear`, { error })\n          throw error\n        }\n      }\n    }\n  }\n}\n\n// ─── Async Plugin Module ──────────────────────────────────────────────────────\n\nexport class AsyncStoragePluginModule implements IPluginManager<IAsyncStoragePlugin>, IAsyncPluginExecutor {\n  private plugins = new Map<string, IAsyncStoragePlugin>()\n\n  constructor(\n    protected readonly parentExecutor?: IAsyncPluginExecutor,\n    protected readonly logger?: ILogger,\n    protected readonly storageName: string = 'default',\n  ) {}\n\n  private createContext(metadata?: Record<string, any>): PluginContext {\n    return {\n      storageName: this.storageName,\n      timestamp: Date.now(),\n      metadata,\n    }\n  }\n\n  public async add(plugin: IAsyncStoragePlugin): Promise<void> {\n    if (this.plugins.has(plugin.name)) {\n      this.logger?.warn(`Плагин ${plugin.name} уже был зарегистрирован`)\n      return\n    }\n\n    try {\n      await plugin.initialize?.()\n      this.plugins.set(plugin.name, plugin)\n      this.logger?.info('Плагин добавлен', { name: plugin.name })\n    } catch (error) {\n      throw error\n    }\n  }\n\n  public async remove(name: string): Promise<void> {\n    const plugin = this.plugins.get(name)\n    if (plugin) {\n      await plugin.destroy?.()\n      this.plugins.delete(name)\n      this.logger?.info('Плагин удален', { name })\n    }\n  }\n\n  public get(name: string): IAsyncStoragePlugin | undefined {\n    return this.plugins.get(name)\n  }\n\n  public getAll(): IAsyncStoragePlugin[] {\n    return Array.from(this.plugins.values())\n  }\n\n  public async initialize(): Promise<void> {\n    for (const plugin of this.plugins.values()) {\n      await plugin.initialize?.()\n    }\n  }\n\n  public async destroy(): Promise<void> {\n    await Promise.all(Array.from(this.plugins.values()).map((plugin) => plugin.destroy?.() ?? Promise.resolve()))\n    this.plugins.clear()\n  }\n\n  public async executeBeforeSet<T>(value: T, metadata?: Record<string, any>): Promise<T> {\n    let result = value\n    const context = this.createContext(metadata)\n\n    if (this.parentExecutor) {\n      result = await this.parentExecutor.executeBeforeSet(result, metadata)\n    }\n\n    for (const plugin of this.plugins.values()) {\n      if (plugin.onBeforeSet) {\n        try {\n          result = await plugin.onBeforeSet(result, context)\n        } catch (error) {\n          this.logger?.error(`Ошибка в плагине ${plugin.name} onBeforeSet`, { error })\n          throw error\n        }\n      }\n    }\n\n    return result\n  }\n\n  public async executeAfterSet<T>(key: StorageKeyType, value: T, metadata?: Record<string, any>): Promise<T> {\n    let result = value\n    const context = this.createContext(metadata)\n\n    if (this.parentExecutor) {\n      result = await this.parentExecutor.executeAfterSet(key, result, metadata)\n    }\n\n    for (const plugin of this.plugins.values()) {\n      if (plugin.onAfterSet) {\n        try {\n          result = await plugin.onAfterSet(key, result, context)\n        } catch (error) {\n          this.logger?.error(`Ошибка в плагине ${plugin.name} onAfterSet`, { key, error })\n          throw error\n        }\n      }\n    }\n\n    return result\n  }\n\n  public async executeBeforeGet(key: StorageKeyType, metadata?: Record<string, any>): Promise<StorageKeyType> {\n    let processedKey = key\n    const context = this.createContext(metadata)\n\n    if (this.parentExecutor) {\n      processedKey = await this.parentExecutor.executeBeforeGet(processedKey, metadata)\n    }\n\n    for (const plugin of this.plugins.values()) {\n      if (plugin.onBeforeGet) {\n        try {\n          processedKey = await plugin.onBeforeGet(processedKey, context)\n        } catch (error) {\n          this.logger?.error(`Ошибка в плагине ${plugin.name} onBeforeGet`, { key, error })\n          throw error\n        }\n      }\n    }\n\n    return processedKey\n  }\n\n  public async executeAfterGet<T>(key: StorageKeyType, value: T | undefined, metadata?: Record<string, any>): Promise<T | undefined> {\n    let result = value\n    const context = this.createContext(metadata)\n\n    if (this.parentExecutor) {\n      result = await this.parentExecutor.executeAfterGet(key, result, metadata)\n    }\n    for (const plugin of this.plugins.values()) {\n      if (plugin.onAfterGet) {\n        try {\n          result = await plugin.onAfterGet(key, result, context)\n        } catch (error) {\n          this.logger?.error(`Ошибка в плагине ${plugin.name} onAfterGet`, { key, error })\n          throw error\n        }\n      }\n    }\n\n    return result\n  }\n\n  public async executeBeforeDelete(key: StorageKeyType, metadata?: Record<string, any>): Promise<boolean> {\n    let canDelete = true\n    const context = this.createContext(metadata)\n\n    if (this.parentExecutor) {\n      canDelete = await this.parentExecutor.executeBeforeDelete(key, context)\n    }\n\n    for (const plugin of this.plugins.values()) {\n      if (plugin.onBeforeDelete) {\n        try {\n          canDelete = (await plugin.onBeforeDelete(key, context)) && canDelete\n        } catch (error) {\n          this.logger?.error(`Ошибка в плагине ${plugin.name} onBeforeDelete`, { key, error })\n          throw error\n        }\n      }\n    }\n\n    return canDelete\n  }\n\n  public async executeAfterDelete(key: StorageKeyType, metadata?: Record<string, any>): Promise<void> {\n    const context = this.createContext(metadata)\n\n    if (this.parentExecutor) {\n      await this.parentExecutor.executeAfterDelete(key, context)\n    }\n\n    for (const plugin of this.plugins.values()) {\n      if (plugin.onAfterDelete) {\n        try {\n          await plugin.onAfterDelete(key, context)\n        } catch (error) {\n          this.logger?.error(`Ошибка в плагине ${plugin.name} onAfterDelete`, { key, error })\n          throw error\n        }\n      }\n    }\n  }\n\n  public async executeOnClear(metadata?: Record<string, any>): Promise<void> {\n    const context = this.createContext(metadata)\n\n    if (this.parentExecutor) {\n      await this.parentExecutor.executeOnClear(context)\n    }\n\n    for (const plugin of this.plugins.values()) {\n      if (plugin.onClear) {\n        try {\n          await plugin.onClear(context)\n        } catch (error) {\n          this.logger?.error(`Ошибка в плагине ${plugin.name} onClear`, { error })\n          throw error\n        }\n      }\n    }\n  }\n}\n\n/** @deprecated Use AsyncStoragePluginModule */\nexport class StoragePluginModule extends AsyncStoragePluginModule {}\n"],"names":["SyncStoragePluginModule","Map","parentExecutor","logger","storageName","metadata","Date","plugin","error","name","Array","Promise","value","result","context","key","processedKey","canDelete","AsyncStoragePluginModule","StoragePluginModule"],"mappings":"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"}

package/dist/core/storage/modules/singleton/mixin.util.d.ts

@@ -0,0 +1,6 @@
+import { StorageCore } from '../../adapters/storage-core';
+import { BaseStorageConfig, ILogger, StorageType } from '../../storage.interface';
+export declare class SingletonMixin {
+    static handleSingletonCreation<T extends StorageCore<any>>(config: BaseStorageConfig, storageType: StorageType, factory: (finalConfig: BaseStorageConfig) => T, logger?: ILogger): T;
+}
+//# sourceMappingURL=mixin.util.d.ts.map

package/dist/core/storage/modules/singleton/mixin.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mixin.util.d.ts","sourceRoot":"","sources":["../../../../../src/core/storage/modules/singleton/mixin.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AACzD,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAGjF,qBAAa,cAAc;IACzB,MAAM,CAAC,uBAAuB,CAAC,CAAC,SAAS,WAAW,CAAC,GAAG,CAAC,EACvD,MAAM,EAAE,iBAAiB,EACzB,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,CAAC,WAAW,EAAE,iBAAiB,KAAK,CAAC,EAC9C,MAAM,CAAC,EAAE,OAAO,GACf,CAAC;CAyBL"}

package/dist/core/storage/modules/singleton/mixin.util.js

@@ -0,0 +1,30 @@
+import { SingletonKeyGenerator, SingletonManager } from "./singleton.util.js";
+
+
+
+class SingletonMixin {
+    static handleSingletonCreation(config, storageType, factory, logger) {
+        // Если singleton не включен, создаем обычный экземпляр
+        if (!config.singleton?.enabled) return factory(config);
+        // Настраиваем логгер в SingletonManager
+        if (logger) {
+            SingletonManager.setLogger(logger);
+        }
+        const key = SingletonKeyGenerator.generate(config, storageType);
+        const result = SingletonManager.getOrCreate(key, config, factory);
+        // Логируем результат
+        if (result.isNewInstance) {
+            logger?.debug(`Created new singleton storage: ${key}`);
+        } else {
+            logger?.debug(`Reusing existing singleton storage: ${key}`);
+            if (result.conflicts && result.conflicts.length > 0) {
+                logger?.debug(`Configuration conflicts detected: ${result.conflicts.join(', ')}`);
+            }
+        }
+        return result.instance;
+    }
+}
+
+export { SingletonMixin };
+
+//# sourceMappingURL=mixin.util.js.map

package/dist/core/storage/modules/singleton/mixin.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core/storage/modules/singleton/mixin.util.js","sources":["../../../../../src/core/storage/modules/singleton/mixin.util.ts"],"sourcesContent":["import { StorageCore } from '../../adapters/storage-core'\nimport { BaseStorageConfig, ILogger, StorageType } from '../../storage.interface'\nimport { SingletonKeyGenerator, SingletonManager } from './singleton.util'\n\nexport class SingletonMixin {\n  static handleSingletonCreation<T extends StorageCore<any>>(\n    config: BaseStorageConfig,\n    storageType: StorageType,\n    factory: (finalConfig: BaseStorageConfig) => T,\n    logger?: ILogger,\n  ): T {\n    // Если singleton не включен, создаем обычный экземпляр\n    if (!config.singleton?.enabled) return factory(config)\n\n    // Настраиваем логгер в SingletonManager\n    if (logger) {\n      SingletonManager.setLogger(logger)\n    }\n\n    const key = SingletonKeyGenerator.generate(config, storageType)\n    const result = SingletonManager.getOrCreate(key, config, factory)\n\n    // Логируем результат\n    if (result.isNewInstance) {\n      logger?.debug(`Created new singleton storage: ${key}`)\n    } else {\n      logger?.debug(`Reusing existing singleton storage: ${key}`)\n\n      if (result.conflicts && result.conflicts.length > 0) {\n        logger?.debug(`Configuration conflicts detected: ${result.conflicts.join(', ')}`)\n      }\n    }\n\n    return result.instance\n  }\n}\n"],"names":["SingletonKeyGenerator","SingletonManager","SingletonMixin","config","storageType","factory","logger","key","result"],"mappings":";;;AAE0E;AAEnE,MAAME,cAAcA;IACzB,OAAO,wBACLC,MAAyB,EACzBC,WAAwB,EACxBC,OAA8C,EAC9CC,MAAgB,EACb;QACH,uDAAuD;QACvD,IAAI,CAACH,OAAO,SAAS,EAAE,SAAS,OAAOE,QAAQF;QAE/C,wCAAwC;QACxC,IAAIG,QAAQ;YACVL,0BAA0B,CAACK;QAC7B;QAEA,MAAMC,MAAMP,8BAA8B,CAACG,QAAQC;QACnD,MAAMI,SAASP,4BAA4B,CAACM,KAAKJ,QAAQE;QAEzD,qBAAqB;QACrB,IAAIG,OAAO,aAAa,EAAE;YACxBF,QAAQ,MAAM,CAAC,+BAA+B,EAAEC,KAAK;QACvD,OAAO;YACLD,QAAQ,MAAM,CAAC,oCAAoC,EAAEC,KAAK;YAE1D,IAAIC,OAAO,SAAS,IAAIA,OAAO,SAAS,CAAC,MAAM,GAAG,GAAG;gBACnDF,QAAQ,MAAM,CAAC,kCAAkC,EAAEE,OAAO,SAAS,CAAC,IAAI,CAAC,OAAO;YAClF;QACF;QAEA,OAAOA,OAAO,QAAQ;IACxB;AACF"}

package/dist/core/storage/modules/singleton/models.d.ts

@@ -0,0 +1,143 @@
+/**
+ * @example
+ * ```typescript
+ * // Строгая проверка - выбросит ошибку при любых различиях
+ * const storage1 = new MemoryStorage({
+ *   name: 'user',
+ *   singleton: {
+ *     enabled: true,
+ *     mergeStrategy: ConfigMergeStrategy.STRICT
+ *   },
+ *   initialState: { name: 'John' }
+ * })
+ *
+ * // Глубокое слияние - объединит объекты
+ * const storage2 = new MemoryStorage({
+ *   name: 'settings',
+ *   singleton: {
+ *     enabled: true,
+ *     mergeStrategy: ConfigMergeStrategy.DEEP_MERGE
+ *   },
+ *   initialState: { theme: 'dark', notifications: { email: true } }
+ * })
+ * ```
+ */
+export declare enum ConfigMergeStrategy {
+    /**
+     * Строгая проверка - выбрасывает ошибку при любых отличиях в конфигурации
+     *
+     * Используйте когда требуется абсолютная идентичность конфигураций
+     * для обеспечения предсказуемого поведения
+     */
+    STRICT = "strict",
+    /**
+     * Первая конфигурация побеждает - игнорирует последующие конфигурации
+     *
+     * **По умолчанию**. Безопасная стратегия, которая использует настройки
+     * первого созданного экземпляра и игнорирует все последующие
+     */
+    FIRST_WINS = "first_wins",
+    /**
+     * Глубокое слияние объектов - рекурсивно объединяет initialState
+     *
+     * Полезно когда разные компоненты должны дополнять начальное состояние.
+     * Примитивные значения из первой конфигурации сохраняются
+     */
+    DEEP_MERGE = "deep_merge",
+    /**
+     * Последняя конфигурация перезаписывает предыдущие (кроме name)
+     *
+     * **Осторожно!** Может привести к непредсказуемому поведению,
+     * так как результат зависит от порядка создания компонентов
+     */
+    OVERRIDE = "override",
+    /**
+     * Предупреждение в консоли + использование первой конфигурации
+     *
+     * Как FIRST_WINS, но с подробными предупреждениями в консоли
+     * о конфликтующих настройках. Полезно для отладки
+     */
+    WARN_AND_USE_FIRST = "warn_and_use_first"
+}
+/**
+ * Позволяет переиспользовать экземпляры хранилищ между компонентами
+ * по имени, что особенно полезно в React при частых ре-рендерах
+ *
+ * @example
+ * ```typescript
+ * // Базовое использование
+ * const storage = new MemoryStorage({
+ *   name: 'user-preferences',
+ *   singleton: { enabled: true },
+ *   initialState: { theme: 'light' }
+ * })
+ *
+ * // Продвинутые настройки
+ * const storage = new MemoryStorage({
+ *   name: 'shared-state',
+ *   singleton: {
+ *     enabled: true,
+ *     mergeStrategy: ConfigMergeStrategy.DEEP_MERGE,
+ *     warnOnConflict: true,
+ *     key: 'custom-singleton-key'
+ *   },
+ *   initialState: { user: null, settings: {} }
+ * })
+ * ```
+ *
+ * @see {@link ConfigMergeStrategy} для стратегий разрешения конфликтов
+ */
+export interface SingletonOptions {
+    /**
+     * Включить Singleton Pattern для данного хранилища
+     *
+     * При `true` хранилища с одинаковым именем (или ключом) будут
+     * возвращать один и тот же экземпляр вместо создания нового
+     *
+     * @default false
+     */
+    enabled: boolean;
+    /**
+     * Стратегия разрешения конфликтов при различающихся конфигурациях
+     *
+     * Определяет как поступать, когда singleton с тем же именем
+     * создается с отличающимися параметрами (initialState, middlewares и т.д.)
+     *
+     * @default ConfigMergeStrategy.FIRST_WINS
+     * @see {@link ConfigMergeStrategy}
+     */
+    mergeStrategy?: ConfigMergeStrategy;
+    /**
+     * Выводить предупреждения при обнаружении конфликтов конфигурации
+     *
+     * При `true` будет логировать в консоль информацию о различиях
+     * в конфигурациях между экземплярами singleton (кроме стратегии STRICT)
+     *
+     * @default true
+     */
+    warnOnConflict?: boolean;
+    /**
+     * Кастомный ключ для идентификации singleton экземпляра
+     *
+     * По умолчанию используется комбинация `{StorageType}_{name}`,
+     * но можно задать собственный ключ для более тонкого контроля
+     *
+     * @example
+     * ```typescript
+     * // Разные хранилища с одним именем, но разными ключами
+     * const userCache = new MemoryStorage({
+     *   name: 'user',
+     *   singleton: { enabled: true, key: 'user-cache' }
+     * })
+     *
+     * const userSettings = new LocalStorage({
+     *   name: 'user', // То же имя!
+     *   singleton: { enabled: true, key: 'user-settings' } // Но разный ключ
+     * })
+     * ```
+     *
+     * @default `${StorageType}_${name}`
+     */
+    key?: string;
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/core/storage/modules/singleton/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../../../../src/core/storage/modules/singleton/models.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,oBAAY,mBAAmB;IAC7B;;;;;OAKG;IACH,MAAM,WAAW;IAEjB;;;;;OAKG;IACH,UAAU,eAAe;IAEzB;;;;;OAKG;IACH,UAAU,eAAe;IAEzB;;;;;OAKG;IACH,QAAQ,aAAa;IAErB;;;;;OAKG;IACH,kBAAkB,uBAAuB;CAC1C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;OAOG;IACH,OAAO,EAAE,OAAO,CAAA;IAEhB;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,mBAAmB,CAAA;IAEnC;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IAExB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;CACb"}