synapse-storage 3.0.19 → 4.0.1

package/dist/core/storage/adapters/storage-core.js

@@ -0,0 +1,221 @@
+import { SingletonKeyGenerator, SingletonManager } from "../modules/singleton/singleton.util.js";
+import { StorageEvents, StorageStatus } from "../storage.interface.js";
+
+
+
+
+
+/**
+ * Общая константа для глобальной подписки.
+ * Используется в StorageCore и наследниках.
+ */ const GLOBAL_SUBSCRIPTION_KEY = '*';
+/**
+ * Абстрактный базовый класс с общей инфраструктурой хранилища.
+ *
+ * Содержит: status management, subscriptions, lifecycle wrappers,
+ * state cache, event emission, singleton cleanup.
+ *
+ * Не содержит: middleware, plugin executor, do* методы, публичные CRUD-операции.
+ */ class StorageCore {
+    coreConfig;
+    eventEmitter;
+    logger;
+    name;
+    _initStatus = {
+        status: StorageStatus.IDLE
+    };
+    _isDestroyed = false;
+    statusSubscribers = new Set();
+    subscribers = new Map();
+    _stateCache = {};
+    keyVersions = new Map();
+    constructor(coreConfig, eventEmitter, logger){
+        this.coreConfig = coreConfig;
+        this.eventEmitter = eventEmitter;
+        this.logger = logger;
+        this.name = coreConfig.name;
+    }
+    // ─── Status Management ──────────────────────────────────────────────────────
+    get initStatus() {
+        return {
+            ...this._initStatus
+        };
+    }
+    async waitForReady() {
+        if (this._initStatus.status === StorageStatus.READY) return this;
+        if (this._initStatus.status === StorageStatus.ERROR) {
+            throw this._initStatus.error || new Error('Storage initialization failed');
+        }
+        return new Promise((resolve, reject)=>{
+            const unsubscribe = this.onStatusChange((status)=>{
+                if (status.status === StorageStatus.READY) {
+                    unsubscribe();
+                    resolve(this);
+                } else if (status.status === StorageStatus.ERROR) {
+                    unsubscribe();
+                    reject(status.error || new Error('Storage initialization failed'));
+                }
+            });
+        });
+    }
+    onStatusChange(callback) {
+        this.statusSubscribers.add(callback);
+        callback(this.initStatus);
+        return ()=>{
+            this.statusSubscribers.delete(callback);
+        };
+    }
+    updateInitStatus(update) {
+        const previousStatus = this._initStatus.status;
+        this._initStatus = {
+            ...this._initStatus,
+            ...update
+        };
+        if (previousStatus !== this._initStatus.status) {
+            this.logger?.debug(`Storage "${this.name}" status changed: ${previousStatus} -> ${this._initStatus.status}`);
+        }
+        const statusCopy = this.initStatus;
+        this.statusSubscribers.forEach((callback)=>{
+            try {
+                callback(statusCopy);
+            } catch (error) {
+                this.logger?.error('Error in status change callback', {
+                    error
+                });
+            }
+        });
+    }
+    ensureReady() {
+        if (this._isDestroyed) {
+            throw new Error(`Storage "${this.name}" has been destroyed`);
+        }
+        if (this._initStatus.status !== StorageStatus.READY) {
+            throw new Error(`Storage "${this.name}" is not ready. Current status: ${this._initStatus.status}`);
+        }
+    }
+    // ─── State Cache ────────────────────────────────────────────────────────────
+    getStateSync() {
+        return this._stateCache;
+    }
+    // ─── Subscriptions ──────────────────────────────────────────────────────────
+    subscribeToAll(callback) {
+        if (!this.subscribers.has(GLOBAL_SUBSCRIPTION_KEY)) {
+            this.subscribers.set(GLOBAL_SUBSCRIPTION_KEY, new Set());
+        }
+        this.subscribers.get(GLOBAL_SUBSCRIPTION_KEY).add(callback);
+        return ()=>{
+            const subscribers = this.subscribers.get(GLOBAL_SUBSCRIPTION_KEY);
+            if (subscribers) {
+                subscribers.delete(callback);
+                if (subscribers.size === 0) {
+                    this.subscribers.delete(GLOBAL_SUBSCRIPTION_KEY);
+                }
+            }
+        };
+    }
+    subscribe(keyOrSelector, callback) {
+        if (typeof keyOrSelector === 'string') {
+            return this.subscribeByKey(keyOrSelector, callback);
+        }
+        return this.subscribeBySelector(keyOrSelector, callback);
+    }
+    notifySubscribers(key, value) {
+        const keyStr = key.toString();
+        // Инкрементируем версию ключа — используется для защиты от race condition в subscribeByKey (async)
+        this.keyVersions.set(keyStr, (this.keyVersions.get(keyStr) ?? 0) + 1);
+        const exactSubscribers = this.subscribers.get(keyStr);
+        if (exactSubscribers?.size) {
+            const subscribersCopy = new Set(exactSubscribers);
+            subscribersCopy.forEach((callback)=>{
+                try {
+                    callback(value);
+                } catch (error) {
+                    this.logger?.error('Ошибка в подписчике на колбэк', {
+                        key: keyStr,
+                        error
+                    });
+                }
+            });
+        }
+    }
+    // ─── Lifecycle ──────────────────────────────────────────────────────────────
+    async initialize() {
+        if (this._initStatus.status === StorageStatus.READY) return this;
+        if (this._initStatus.status === StorageStatus.LOADING) return this.waitForReady();
+        // Allow re-initialization after destroy
+        this._isDestroyed = false;
+        this.updateInitStatus({
+            status: StorageStatus.LOADING,
+            error: undefined
+        });
+        try {
+            await this.performInitialize();
+            this.updateInitStatus({
+                status: StorageStatus.READY,
+                error: undefined
+            });
+            return this;
+        } catch (error) {
+            this.updateInitStatus({
+                status: StorageStatus.ERROR,
+                error: error instanceof Error ? error : new Error(String(error))
+            });
+            throw error;
+        }
+    }
+    async destroy() {
+        if (this._isDestroyed) return;
+        this._isDestroyed = true;
+        try {
+            if (this._initStatus.status === StorageStatus.LOADING) {
+                try {
+                    await this.waitForReady();
+                } catch  {
+                // Инициализация упала — продолжаем destroy
+                }
+            }
+            if (this._initStatus.status === StorageStatus.READY) {
+                await this.performCleanup();
+            }
+            this.statusSubscribers.clear();
+            if (this.coreConfig.singleton?.enabled) {
+                const key = SingletonKeyGenerator.generate(this.coreConfig, this.type);
+                SingletonManager.remove(key);
+            }
+            this._stateCache = {};
+            this.updateInitStatus({
+                status: StorageStatus.IDLE
+            });
+            await this.emitEvent({
+                type: StorageEvents.STORAGE_DESTROY
+            });
+        } catch (error) {
+            this.logger?.error('Error destroying storage', {
+                error
+            });
+            throw error;
+        }
+    }
+    // ─── Events ─────────────────────────────────────────────────────────────────
+    async emitEvent(event) {
+        try {
+            await this.eventEmitter?.emit({
+                ...event,
+                metadata: {
+                    ...event.metadata || {},
+                    timestamp: Date.now(),
+                    storageName: this.name
+                }
+            });
+        } catch (error) {
+            this.logger?.error('Error emitting event', {
+                event,
+                error
+            });
+        }
+    }
+}
+
+export { GLOBAL_SUBSCRIPTION_KEY, StorageCore };
+
+//# sourceMappingURL=storage-core.js.map

package/dist/core/storage/adapters/storage-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core/storage/adapters/storage-core.js","sources":["../../../../src/core/storage/adapters/storage-core.ts"],"sourcesContent":["import { SingletonKeyGenerator, SingletonManager } from '../modules/singleton/singleton.util'\nimport { BaseStorageConfig, IEventEmitter, ILogger, IStorageBase, StorageEvent, StorageEvents, StorageInitStatus, StorageStatus, StorageType } from '../storage.interface'\nimport { StorageKeyType } from '../utils/storage-key'\n\nexport type PathSelector<T, R> = (state: T) => R\n\n/**\n * Общая константа для глобальной подписки.\n * Используется в StorageCore и наследниках.\n */\nexport const GLOBAL_SUBSCRIPTION_KEY = '*'\n\n/**\n * Абстрактный базовый класс с общей инфраструктурой хранилища.\n *\n * Содержит: status management, subscriptions, lifecycle wrappers,\n * state cache, event emission, singleton cleanup.\n *\n * Не содержит: middleware, plugin executor, do* методы, публичные CRUD-операции.\n */\nexport abstract class StorageCore<T extends Record<string, any>> implements IStorageBase<T> {\n  name: string\n  abstract readonly type: StorageType\n\n  private _initStatus: StorageInitStatus = { status: StorageStatus.IDLE }\n  private _isDestroyed = false\n  private statusSubscribers = new Set<(status: StorageInitStatus) => void>()\n\n  protected subscribers = new Map<StorageKeyType, Set<(value: any) => void>>()\n  protected _stateCache: T = {} as T\n  protected keyVersions = new Map<string, number>()\n\n  constructor(\n    protected readonly coreConfig: BaseStorageConfig<T>,\n    protected readonly eventEmitter?: IEventEmitter,\n    protected readonly logger?: ILogger,\n  ) {\n    this.name = coreConfig.name\n  }\n\n  // ─── Status Management ──────────────────────────────────────────────────────\n\n  get initStatus(): StorageInitStatus {\n    return { ...this._initStatus }\n  }\n\n  async waitForReady(): Promise<this> {\n    if (this._initStatus.status === StorageStatus.READY) return this\n    if (this._initStatus.status === StorageStatus.ERROR) {\n      throw this._initStatus.error || new Error('Storage initialization failed')\n    }\n\n    return new Promise((resolve, reject) => {\n      const unsubscribe = this.onStatusChange((status) => {\n        if (status.status === StorageStatus.READY) {\n          unsubscribe()\n          resolve(this)\n        } else if (status.status === StorageStatus.ERROR) {\n          unsubscribe()\n          reject(status.error || new Error('Storage initialization failed'))\n        }\n      })\n    })\n  }\n\n  onStatusChange(callback: (status: StorageInitStatus) => void): VoidFunction {\n    this.statusSubscribers.add(callback)\n    callback(this.initStatus)\n\n    return () => {\n      this.statusSubscribers.delete(callback)\n    }\n  }\n\n  protected updateInitStatus(update: Partial<StorageInitStatus>): void {\n    const previousStatus = this._initStatus.status\n\n    this._initStatus = { ...this._initStatus, ...update }\n\n    if (previousStatus !== this._initStatus.status) {\n      this.logger?.debug(`Storage \"${this.name}\" status changed: ${previousStatus} -> ${this._initStatus.status}`)\n    }\n\n    const statusCopy = this.initStatus\n    this.statusSubscribers.forEach((callback) => {\n      try {\n        callback(statusCopy)\n      } catch (error) {\n        this.logger?.error('Error in status change callback', { error })\n      }\n    })\n  }\n\n  protected ensureReady(): void {\n    if (this._isDestroyed) {\n      throw new Error(`Storage \"${this.name}\" has been destroyed`)\n    }\n    if (this._initStatus.status !== StorageStatus.READY) {\n      throw new Error(`Storage \"${this.name}\" is not ready. Current status: ${this._initStatus.status}`)\n    }\n  }\n\n  // ─── State Cache ────────────────────────────────────────────────────────────\n\n  public getStateSync(): T {\n    return this._stateCache\n  }\n\n  // ─── Subscriptions ──────────────────────────────────────────────────────────\n\n  public subscribeToAll(callback: (event: { type: string; key?: StorageKeyType[] | StorageKeyType; value?: any; changedPaths?: string[] }) => void): VoidFunction {\n    if (!this.subscribers.has(GLOBAL_SUBSCRIPTION_KEY)) {\n      this.subscribers.set(GLOBAL_SUBSCRIPTION_KEY, new Set())\n    }\n\n    this.subscribers.get(GLOBAL_SUBSCRIPTION_KEY)!.add(callback)\n\n    return () => {\n      const subscribers = this.subscribers.get(GLOBAL_SUBSCRIPTION_KEY)\n      if (subscribers) {\n        subscribers.delete(callback)\n        if (subscribers.size === 0) {\n          this.subscribers.delete(GLOBAL_SUBSCRIPTION_KEY)\n        }\n      }\n    }\n  }\n\n  public subscribe(key: string, callback: (value: any) => void): VoidFunction\n  public subscribe<R>(pathSelector: PathSelector<T, R>, callback: (value: R) => void): VoidFunction\n  public subscribe<R>(keyOrSelector: string | PathSelector<T, R>, callback: (value: any) => void): VoidFunction {\n    if (typeof keyOrSelector === 'string') {\n      return this.subscribeByKey(keyOrSelector, callback)\n    }\n    return this.subscribeBySelector(keyOrSelector, callback)\n  }\n\n  protected abstract subscribeByKey(key: string, callback: (value: any) => void): VoidFunction\n  protected abstract subscribeBySelector<R>(pathSelector: PathSelector<T, R>, callback: (value: R) => void): VoidFunction\n\n  protected notifySubscribers(key: StorageKeyType, value: any): void {\n    const keyStr = key.toString()\n\n    // Инкрементируем версию ключа — используется для защиты от race condition в subscribeByKey (async)\n    this.keyVersions.set(keyStr, (this.keyVersions.get(keyStr) ?? 0) + 1)\n\n    const exactSubscribers = this.subscribers.get(keyStr)\n    if (exactSubscribers?.size) {\n      const subscribersCopy = new Set(exactSubscribers)\n      subscribersCopy.forEach((callback) => {\n        try {\n          callback(value)\n        } catch (error) {\n          this.logger?.error('Ошибка в подписчике на колбэк', { key: keyStr, error })\n        }\n      })\n    }\n  }\n\n  // ─── Lifecycle ──────────────────────────────────────────────────────────────\n\n  public async initialize(): Promise<this> {\n    if (this._initStatus.status === StorageStatus.READY) return this\n    if (this._initStatus.status === StorageStatus.LOADING) return this.waitForReady()\n\n    // Allow re-initialization after destroy\n    this._isDestroyed = false\n\n    this.updateInitStatus({ status: StorageStatus.LOADING, error: undefined })\n\n    try {\n      await this.performInitialize()\n      this.updateInitStatus({ status: StorageStatus.READY, error: undefined })\n      return this\n    } catch (error) {\n      this.updateInitStatus({\n        status: StorageStatus.ERROR,\n        error: error instanceof Error ? error : new Error(String(error)),\n      })\n      throw error\n    }\n  }\n\n  /**\n   * Subclass-specific initialization.\n   * Called inside initialize() wrapper after status is set to LOADING.\n   */\n  protected abstract performInitialize(): Promise<void>\n\n  public async destroy(): Promise<void> {\n    if (this._isDestroyed) return\n    this._isDestroyed = true\n\n    try {\n      if (this._initStatus.status === StorageStatus.LOADING) {\n        try {\n          await this.waitForReady()\n        } catch {\n          // Инициализация упала — продолжаем destroy\n        }\n      }\n\n      if (this._initStatus.status === StorageStatus.READY) {\n        await this.performCleanup()\n      }\n\n      this.statusSubscribers.clear()\n\n      if (this.coreConfig.singleton?.enabled) {\n        const key = SingletonKeyGenerator.generate(this.coreConfig as any, this.type)\n        SingletonManager.remove(key)\n      }\n\n      this._stateCache = {} as T\n      this.updateInitStatus({ status: StorageStatus.IDLE })\n\n      await this.emitEvent({ type: StorageEvents.STORAGE_DESTROY })\n    } catch (error) {\n      this.logger?.error('Error destroying storage', { error })\n      throw error\n    }\n  }\n\n  /**\n   * Subclass-specific cleanup during destroy.\n   * Should clear storage data, call doDestroy, cleanup middlewares.\n   */\n  protected abstract performCleanup(): Promise<void>\n\n  // ─── Events ─────────────────────────────────────────────────────────────────\n\n  protected async emitEvent(event: StorageEvent): Promise<void> {\n    try {\n      await this.eventEmitter?.emit({\n        ...event,\n        metadata: {\n          ...(event.metadata || {}),\n          timestamp: Date.now(),\n          storageName: this.name,\n        },\n      })\n    } catch (error) {\n      this.logger?.error('Error emitting event', { event, error })\n    }\n  }\n}\n"],"names":["SingletonKeyGenerator","SingletonManager","StorageEvents","StorageStatus","GLOBAL_SUBSCRIPTION_KEY","StorageCore","Set","Map","coreConfig","eventEmitter","logger","Error","Promise","resolve","reject","unsubscribe","status","callback","update","previousStatus","statusCopy","error","subscribers","keyOrSelector","key","value","keyStr","exactSubscribers","subscribersCopy","undefined","String","event","Date"],"mappings":"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"}

package/dist/core/storage/adapters/sync-base-storage.service.d.ts

@@ -0,0 +1,56 @@
+import { ISyncPluginExecutor } from '../modules/plugin/plugin.interface';
+import { IEventEmitter, ILogger, ISyncStorage, StorageType, SyncDefaultMiddlewares, SyncStorageConfig } from '../storage.interface';
+import { StorageKeyType } from '../utils/storage-key';
+import { PathSelector, StorageCore } from './storage-core';
+/**
+ * Базовый класс для синхронных хранилищ (Memory, LocalStorage).
+ *
+ * Все CRUD-операции выполняются синхронно.
+ * Lifecycle (initialize, destroy) остаётся async.
+ * subscribeByKey упрощён — нет race condition без async get.
+ */
+export declare abstract class SyncBaseStorage<T extends Record<string, any>> extends StorageCore<T> implements ISyncStorage<T> {
+    protected readonly config: SyncStorageConfig<T>;
+    protected readonly pluginExecutor?: ISyncPluginExecutor | undefined;
+    abstract readonly type: StorageType;
+    private middlewareModule;
+    private initializedMiddlewares;
+    private selectorPathCache;
+    constructor(config: SyncStorageConfig<T>, pluginExecutor?: ISyncPluginExecutor | undefined, eventEmitter?: IEventEmitter, logger?: ILogger);
+    protected abstract doGet(key: StorageKeyType): any;
+    protected abstract doSet(key: StorageKeyType, value: any): void;
+    protected abstract doUpdate(updates: Array<{
+        key: StorageKeyType;
+        value: any;
+    }>): void;
+    protected abstract doRemove(key: StorageKeyType): boolean;
+    protected abstract doClear(): void;
+    protected abstract doKeys(): string[];
+    protected abstract doHas(key: StorageKeyType): boolean;
+    /** Lifecycle — всегда async */
+    protected abstract doInitialize(): Promise<this>;
+    /** Lifecycle — всегда async */
+    protected abstract doDestroy(): Promise<void>;
+    protected performInitialize(): Promise<void>;
+    protected performCleanup(): Promise<void>;
+    protected initializeMiddlewares(): void;
+    protected getDefaultMiddleware(): SyncDefaultMiddlewares;
+    protected initializeWithMiddlewares(): void;
+    private getRawState;
+    get<R>(key: StorageKeyType): R | undefined;
+    set<R>(key: StorageKeyType, value: R): void;
+    update(updater: (state: T) => void): void;
+    remove(key: StorageKeyType): void;
+    clear(): void;
+    reset(): void;
+    keys(): string[];
+    has(key: StorageKeyType): boolean;
+    getState(): T;
+    /**
+     * Sync-версия subscribeByKey.
+     * Нет race condition (get() синхронный) → не нужен keyVersions tracking.
+     */
+    protected subscribeByKey(key: string, callback: (value: any) => void): VoidFunction;
+    protected subscribeBySelector<R>(pathSelector: PathSelector<T, R>, callback: (value: R) => void): VoidFunction;
+}
+//# sourceMappingURL=sync-base-storage.service.d.ts.map

package/dist/core/storage/adapters/sync-base-storage.service.d.ts.map

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