synapse-storage 3.0.19 → 4.0.0

package/dist/core/storage/utils/broadcast.util.d.ts

@@ -0,0 +1,49 @@
+interface BroadcastMessage<T = unknown> {
+    type: string;
+    payload?: T;
+    senderId: string;
+    targetId?: string;
+    timestamp: number;
+}
+type MessageHandler<T> = (message: BroadcastMessage<T>) => void | Promise<void>;
+type SyncRequestHandler<T> = () => T | Promise<T>;
+interface SyncBroadcastChannelOptions {
+    debug?: boolean;
+}
+export declare class SyncBroadcastChannel<T = unknown> {
+    private channel;
+    private readonly tabId;
+    private messageHandlers;
+    private syncHandler?;
+    private debug;
+    private syncTimeoutMs;
+    private pendingSyncRequests;
+    constructor(channelName: string, options?: SyncBroadcastChannelOptions);
+    private log;
+    private error;
+    private handleMessage;
+    private handleError;
+    private postMessage;
+    /**
+     * Подписка на сообщения канала
+     */
+    subscribe(handler: MessageHandler<T>): () => boolean;
+    /**
+     * Установка обработчика запросов на синхронизацию
+     */
+    setSyncHandler(handler: SyncRequestHandler<T>): void;
+    /**
+     * Отправка сообщения всем подписчикам
+     */
+    broadcast(type: string, payload?: T): void;
+    /**
+     * Запрос синхронизации данных с других вкладок
+     */
+    requestSync(): Promise<T | null>;
+    /**
+     * Закрытие канала
+     */
+    close(): void;
+}
+export {};
+//# sourceMappingURL=broadcast.util.d.ts.map

package/dist/core/storage/utils/broadcast.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast.util.d.ts","sourceRoot":"","sources":["../../../../src/core/storage/utils/broadcast.util.ts"],"names":[],"mappings":"AAEA,UAAU,gBAAgB,CAAC,CAAC,GAAG,OAAO;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,CAAC,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,KAAK,cAAc,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAC/E,KAAK,kBAAkB,CAAC,CAAC,IAAI,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AAEjD,UAAU,2BAA2B;IACnC,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,qBAAa,oBAAoB,CAAC,CAAC,GAAG,OAAO;IAC3C,OAAO,CAAC,OAAO,CAAkB;IAEjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAE9B,OAAO,CAAC,eAAe,CAAwB;IAE/C,OAAO,CAAC,WAAW,CAAC,CAAuB;IAE3C,OAAO,CAAC,KAAK,CAAS;IAEtB,OAAO,CAAC,aAAa,CAAO;IAE5B,OAAO,CAAC,mBAAmB,CAO1B;gBAEW,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,2BAAgC;IAW1E,OAAO,CAAC,GAAG;IAMX,OAAO,CAAC,KAAK;YAIC,aAAa;IA+C3B,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,WAAW;IAenB;;OAEG;IACI,SAAS,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;IAK3C;;OAEG;IACI,cAAc,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAIpD;;OAEG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAK1C;;OAEG;IACU,WAAW,IAAI,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAa7C;;OAEG;IACI,KAAK;CAeb"}

package/dist/core/storage/utils/broadcast.util.js

@@ -0,0 +1,141 @@
+import { loggerConsole } from "../../../_utils/logger-console.util.js";
+
+
+
+class SyncBroadcastChannel {
+    channel;
+    tabId;
+    messageHandlers;
+    syncHandler;
+    debug;
+    syncTimeoutMs = 1000;
+    pendingSyncRequests;
+    constructor(channelName, options = {}){
+        this.channel = new BroadcastChannel(channelName);
+        this.tabId = crypto.randomUUID();
+        this.messageHandlers = new Set();
+        this.debug = options.debug ?? false;
+        this.pendingSyncRequests = new Map();
+        this.channel.onmessage = this.handleMessage.bind(this);
+        this.channel.onmessageerror = this.handleError.bind(this);
+    }
+    log(...args) {
+        if (this.debug) {
+            loggerConsole.log(`[SyncBroadcastChannel][${this.tabId}]`, ...args);
+        }
+    }
+    error(...args) {
+        loggerConsole.error(`[SyncBroadcastChannel][${this.tabId}]`, ...args);
+    }
+    async handleMessage(event) {
+        const message = event.data;
+        // Игнорируем собственные сообщения
+        if (message.senderId === this.tabId) {
+            return;
+        }
+        // Обработка запроса на синхронизацию
+        if (message.type === 'SYNC_REQUEST') {
+            if (this.syncHandler) {
+                try {
+                    const state = await this.syncHandler();
+                    this.postMessage('SYNC_RESPONSE', state, message.senderId);
+                } catch (error) {
+                    this.error('Error handling sync request:', error);
+                }
+            }
+            return;
+        }
+        // Обработка ответа на запрос синхронизации
+        if (message.type === 'SYNC_RESPONSE') {
+            // Фильтруем по targetId — принимаем только ответы, адресованные этой вкладке
+            if (message.targetId && message.targetId !== this.tabId) {
+                return;
+            }
+            const request = this.pendingSyncRequests.get(this.tabId);
+            if (request) {
+                clearTimeout(request.timeout);
+                this.pendingSyncRequests.delete(this.tabId);
+                //@ts-ignore
+                request.resolve(message.payload);
+            }
+            return;
+        }
+        // Уведомляем всех подписчиков о сообщении
+        for (const handler of this.messageHandlers){
+            try {
+                await handler(message);
+            } catch (error) {
+                this.error('Error in message handler:', error);
+            }
+        }
+    }
+    handleError(event) {
+        this.error('Channel error:', event);
+    }
+    postMessage(type, payload, targetId) {
+        const message = {
+            type,
+            payload,
+            senderId: this.tabId,
+            timestamp: Date.now()
+        };
+        if (targetId) {
+            message.targetId = targetId;
+        }
+        this.channel.postMessage(message);
+    }
+    /**
+   * Подписка на сообщения канала
+   */ subscribe(handler) {
+        this.messageHandlers.add(handler);
+        return ()=>this.messageHandlers.delete(handler);
+    }
+    /**
+   * Установка обработчика запросов на синхронизацию
+   */ setSyncHandler(handler) {
+        this.syncHandler = handler;
+    }
+    /**
+   * Отправка сообщения всем подписчикам
+   */ broadcast(type, payload) {
+        //@ts-ignore
+        this.postMessage(type, payload);
+    }
+    /**
+   * Запрос синхронизации данных с других вкладок
+   */ async requestSync() {
+        return new Promise((resolve, reject)=>{
+            const timeout = setTimeout(()=>{
+                this.pendingSyncRequests.delete(this.tabId);
+                resolve(null);
+            }, this.syncTimeoutMs);
+            this.pendingSyncRequests.set(this.tabId, {
+                resolve,
+                reject,
+                timeout
+            });
+            this.postMessage('SYNC_REQUEST', {
+                type: 'sync'
+            });
+        });
+    }
+    /**
+   * Закрытие канала
+   */ close() {
+        // Очищаем все pending запросы
+        for (const [, request] of this.pendingSyncRequests){
+            clearTimeout(request.timeout);
+            request.reject(new Error('Channel closed'));
+        }
+        this.pendingSyncRequests.clear();
+        // Очищаем обработчики
+        this.messageHandlers.clear();
+        this.syncHandler = undefined;
+        // Закрываем канал
+        this.channel.close();
+    }
+}
+
+export { SyncBroadcastChannel };
+
+//# sourceMappingURL=broadcast.util.js.map

package/dist/core/storage/utils/broadcast.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core/storage/utils/broadcast.util.js","sources":["../../../../src/core/storage/utils/broadcast.util.ts"],"sourcesContent":["import { loggerConsole } from '../../../_utils/logger-console.util'\n\ninterface BroadcastMessage<T = unknown> {\n  type: string\n  payload?: T\n  senderId: string\n  targetId?: string\n  timestamp: number\n}\n\ntype MessageHandler<T> = (message: BroadcastMessage<T>) => void | Promise<void>\ntype SyncRequestHandler<T> = () => T | Promise<T>\n\ninterface SyncBroadcastChannelOptions {\n  debug?: boolean\n}\n\nexport class SyncBroadcastChannel<T = unknown> {\n  private channel: BroadcastChannel\n\n  private readonly tabId: string\n\n  private messageHandlers: Set<MessageHandler<T>>\n\n  private syncHandler?: SyncRequestHandler<T>\n\n  private debug: boolean\n\n  private syncTimeoutMs = 1000\n\n  private pendingSyncRequests: Map<\n    string,\n    {\n      resolve: (value: T | null) => void\n      reject: (reason?: any) => void\n      timeout: NodeJS.Timeout\n    }\n  >\n\n  constructor(channelName: string, options: SyncBroadcastChannelOptions = {}) {\n    this.channel = new BroadcastChannel(channelName)\n    this.tabId = crypto.randomUUID()\n    this.messageHandlers = new Set()\n    this.debug = options.debug ?? false\n    this.pendingSyncRequests = new Map()\n\n    this.channel.onmessage = this.handleMessage.bind(this)\n    this.channel.onmessageerror = this.handleError.bind(this)\n  }\n\n  private log(...args: any[]) {\n    if (this.debug) {\n      loggerConsole.log(`[SyncBroadcastChannel][${this.tabId}]`, ...args)\n    }\n  }\n\n  private error(...args: any[]) {\n    loggerConsole.error(`[SyncBroadcastChannel][${this.tabId}]`, ...args)\n  }\n\n  private async handleMessage(event: MessageEvent<BroadcastMessage<T>>): Promise<void> {\n    const message = event.data\n\n    // Игнорируем собственные сообщения\n    if (message.senderId === this.tabId) {\n      return\n    }\n\n    // Обработка запроса на синхронизацию\n    if (message.type === 'SYNC_REQUEST') {\n      if (this.syncHandler) {\n        try {\n          const state = await this.syncHandler()\n          this.postMessage('SYNC_RESPONSE', state, message.senderId)\n        } catch (error) {\n          this.error('Error handling sync request:', error)\n        }\n      }\n      return\n    }\n\n    // Обработка ответа на запрос синхронизации\n    if (message.type === 'SYNC_RESPONSE') {\n      // Фильтруем по targetId — принимаем только ответы, адресованные этой вкладке\n      if (message.targetId && message.targetId !== this.tabId) {\n        return\n      }\n      const request = this.pendingSyncRequests.get(this.tabId)\n      if (request) {\n        clearTimeout(request.timeout)\n        this.pendingSyncRequests.delete(this.tabId)\n        //@ts-ignore\n        request.resolve(message.payload)\n      }\n      return\n    }\n\n    // Уведомляем всех подписчиков о сообщении\n    for (const handler of this.messageHandlers) {\n      try {\n        await handler(message)\n      } catch (error) {\n        this.error('Error in message handler:', error)\n      }\n    }\n  }\n\n  private handleError(event: MessageEvent) {\n    this.error('Channel error:', event)\n  }\n\n  private postMessage(type: string, payload: T, targetId?: string): void {\n    const message: BroadcastMessage<T> = {\n      type,\n      payload,\n      senderId: this.tabId,\n      timestamp: Date.now(),\n    }\n\n    if (targetId) {\n      message.targetId = targetId\n    }\n\n    this.channel.postMessage(message)\n  }\n\n  /**\n   * Подписка на сообщения канала\n   */\n  public subscribe(handler: MessageHandler<T>) {\n    this.messageHandlers.add(handler)\n    return () => this.messageHandlers.delete(handler)\n  }\n\n  /**\n   * Установка обработчика запросов на синхронизацию\n   */\n  public setSyncHandler(handler: SyncRequestHandler<T>) {\n    this.syncHandler = handler\n  }\n\n  /**\n   * Отправка сообщения всем подписчикам\n   */\n  public broadcast(type: string, payload?: T) {\n    //@ts-ignore\n    this.postMessage(type, payload)\n  }\n\n  /**\n   * Запрос синхронизации данных с других вкладок\n   */\n  public async requestSync(): Promise<T | null> {\n    return new Promise((resolve, reject) => {\n      const timeout = setTimeout(() => {\n        this.pendingSyncRequests.delete(this.tabId)\n        resolve(null)\n      }, this.syncTimeoutMs)\n\n      this.pendingSyncRequests.set(this.tabId, { resolve, reject, timeout })\n\n      this.postMessage('SYNC_REQUEST', { type: 'sync' } as T)\n    })\n  }\n\n  /**\n   * Закрытие канала\n   */\n  public close() {\n    // Очищаем все pending запросы\n    for (const [, request] of this.pendingSyncRequests) {\n      clearTimeout(request.timeout)\n      request.reject(new Error('Channel closed'))\n    }\n    this.pendingSyncRequests.clear()\n\n    // Очищаем обработчики\n    this.messageHandlers.clear()\n    this.syncHandler = undefined\n\n    // Закрываем канал\n    this.channel.close()\n  }\n}\n"],"names":["loggerConsole","SyncBroadcastChannel","channelName","options","BroadcastChannel","crypto","Set","Map","args","event","message","state","error","request","clearTimeout","handler","type","payload","targetId","Date","Promise","resolve","reject","timeout","setTimeout","Error","undefined"],"mappings":"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"}

package/dist/core/storage/utils/cache.util.d.ts

@@ -0,0 +1,33 @@
+import { StorageKey, StorageKeyType } from './storage-key';
+export interface CacheMetadata {
+    createdAt: number;
+    updatedAt: number;
+    expiresAt: number;
+    tags?: string[];
+    createdAtDateTime: string;
+    updatedAtDateTime: string;
+    expiresAtDateTime: string;
+}
+export interface CacheOptions {
+    ttl?: number;
+    cleanup?: {
+        enabled: boolean;
+        interval?: number;
+    };
+    invalidateOnError?: boolean;
+}
+export interface CacheEntry<Data, Params extends Record<string, any> = any> {
+    data: Data;
+    metadata: CacheMetadata;
+    params: Params;
+}
+export declare class CacheUtils {
+    static createMetadata(ttl?: number, tags?: string[]): CacheMetadata;
+    private static formatDateTime;
+    static isExpired(metadata: CacheMetadata): boolean;
+    static updateMetadata(metadata: CacheMetadata): CacheMetadata;
+    static createKey(...parts: (string | number)[]): StorageKey;
+    static createApiKey(endpoint: string, params?: Record<string, any>): [StorageKeyType, Record<string, any> | undefined];
+    static hasAnyTag(metadata: CacheMetadata, tags?: string[]): boolean;
+}
+//# sourceMappingURL=cache.util.d.ts.map

package/dist/core/storage/utils/cache.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.util.d.ts","sourceRoot":"","sources":["../../../../src/core/storage/utils/cache.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAE1D,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,iBAAiB,EAAE,MAAM,CAAA;IACzB,iBAAiB,EAAE,MAAM,CAAA;IACzB,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE;QACR,OAAO,EAAE,OAAO,CAAA;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAA;IACD,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED,MAAM,WAAW,UAAU,CAAC,IAAI,EAAE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG;IACxE,IAAI,EAAE,IAAI,CAAA;IACV,QAAQ,EAAE,aAAa,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,qBAAa,UAAU;IACrB,MAAM,CAAC,cAAc,CAAC,GAAG,GAAE,MAAU,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,aAAa;IAe1E,OAAO,CAAC,MAAM,CAAC,cAAc;IAI7B,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO;IAIlD,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,aAAa,GAAG,aAAa;IAO7D,MAAM,CAAC,SAAS,CAAC,GAAG,KAAK,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,UAAU;IAI3D,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAAC;IAYtH,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,OAAO;CAIxE"}

package/dist/core/storage/utils/cache.util.js

@@ -0,0 +1,54 @@
+import { StorageKey } from "./storage-key.js";
+
+
+
+class CacheUtils {
+    static createMetadata(ttl = 0, tags = []) {
+        const now = Date.now();
+        const expiresAt = ttl > 0 ? now + ttl : Infinity;
+        return {
+            createdAt: now,
+            updatedAt: now,
+            expiresAt,
+            tags,
+            createdAtDateTime: this.formatDateTime(now),
+            updatedAtDateTime: this.formatDateTime(now),
+            expiresAtDateTime: expiresAt === Infinity ? 'never' : this.formatDateTime(expiresAt)
+        };
+    }
+    static formatDateTime(timestamp) {
+        return new Date(timestamp).toISOString();
+    }
+    static isExpired(metadata) {
+        return Date.now() > metadata.expiresAt;
+    }
+    static updateMetadata(metadata) {
+        return {
+            ...metadata,
+            updatedAt: Date.now()
+        };
+    }
+    static createKey(...parts) {
+        return new StorageKey(parts.join('_'));
+    }
+    static createApiKey(endpoint, params) {
+        if (!params) return [
+            new StorageKey(endpoint, true),
+            params
+        ];
+        const sortedParams = Object.entries(params).sort(([a], [b])=>a.localeCompare(b)).map(([k, v])=>`${k}=${v}`).join('&');
+        return [
+            new StorageKey(`${endpoint}_${sortedParams}`, true),
+            params
+        ];
+    }
+    // Функция для проверки, есть ли у записи определенные теги
+    static hasAnyTag(metadata, tags = []) {
+        if (!metadata.tags || !tags.length) return false;
+        return tags.some((tag)=>metadata.tags?.includes(tag));
+    }
+}
+
+export { CacheUtils };
+
+//# sourceMappingURL=cache.util.js.map

package/dist/core/storage/utils/cache.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core/storage/utils/cache.util.js","sources":["../../../../src/core/storage/utils/cache.util.ts"],"sourcesContent":["import { StorageKey, StorageKeyType } from './storage-key'\n\nexport interface CacheMetadata {\n  createdAt: number\n  updatedAt: number\n  expiresAt: number\n  tags?: string[]\n  createdAtDateTime: string\n  updatedAtDateTime: string\n  expiresAtDateTime: string\n}\n\nexport interface CacheOptions {\n  ttl?: number\n  cleanup?: {\n    enabled: boolean\n    interval?: number\n  }\n  invalidateOnError?: boolean\n}\n\nexport interface CacheEntry<Data, Params extends Record<string, any> = any> {\n  data: Data\n  metadata: CacheMetadata\n  params: Params\n}\n\nexport class CacheUtils {\n  static createMetadata(ttl: number = 0, tags: string[] = []): CacheMetadata {\n    const now = Date.now()\n    const expiresAt = ttl > 0 ? now + ttl : Infinity\n\n    return {\n      createdAt: now,\n      updatedAt: now,\n      expiresAt,\n      tags,\n      createdAtDateTime: this.formatDateTime(now),\n      updatedAtDateTime: this.formatDateTime(now),\n      expiresAtDateTime: expiresAt === Infinity ? 'never' : this.formatDateTime(expiresAt),\n    }\n  }\n\n  private static formatDateTime(timestamp: number): string {\n    return new Date(timestamp).toISOString()\n  }\n\n  static isExpired(metadata: CacheMetadata): boolean {\n    return Date.now() > metadata.expiresAt\n  }\n\n  static updateMetadata(metadata: CacheMetadata): CacheMetadata {\n    return {\n      ...metadata,\n      updatedAt: Date.now(),\n    }\n  }\n\n  static createKey(...parts: (string | number)[]): StorageKey {\n    return new StorageKey(parts.join('_'))\n  }\n\n  static createApiKey(endpoint: string, params?: Record<string, any>): [StorageKeyType, Record<string, any> | undefined] {\n    if (!params) return [new StorageKey(endpoint, true), params]\n\n    const sortedParams = Object.entries(params)\n      .sort(([a], [b]) => a.localeCompare(b))\n      .map(([k, v]) => `${k}=${v}`)\n      .join('&')\n\n    return [new StorageKey(`${endpoint}_${sortedParams}`, true), params]\n  }\n\n  // Функция для проверки, есть ли у записи определенные теги\n  static hasAnyTag(metadata: CacheMetadata, tags: string[] = []): boolean {\n    if (!metadata.tags || !tags.length) return false\n    return tags.some((tag) => metadata.tags?.includes(tag))\n  }\n}\n"],"names":["StorageKey","CacheUtils","ttl","tags","now","Date","expiresAt","Infinity","timestamp","metadata","parts","endpoint","params","sortedParams","Object","a","b","k","v","tag"],"mappings":";;;AAA0D;AA2BnD,MAAMC,UAAUA;IACrB,OAAO,eAAeC,MAAc,CAAC,EAAEC,OAAiB,EAAE,EAAiB;QACzE,MAAMC,MAAMC,KAAK,GAAG;QACpB,MAAMC,YAAYJ,MAAM,IAAIE,MAAMF,MAAMK;QAExC,OAAO;YACL,WAAWH;YACX,WAAWA;YACXE;YACAH;YACA,mBAAmB,IAAI,CAAC,cAAc,CAACC;YACvC,mBAAmB,IAAI,CAAC,cAAc,CAACA;YACvC,mBAAmBE,cAAcC,WAAW,UAAU,IAAI,CAAC,cAAc,CAACD;QAC5E;IACF;IAEA,OAAe,eAAeE,SAAiB,EAAU;QACvD,OAAO,IAAIH,KAAKG,WAAW,WAAW;IACxC;IAEA,OAAO,UAAUC,QAAuB,EAAW;QACjD,OAAOJ,KAAK,GAAG,KAAKI,SAAS,SAAS;IACxC;IAEA,OAAO,eAAeA,QAAuB,EAAiB;QAC5D,OAAO;YACL,GAAGA,QAAQ;YACX,WAAWJ,KAAK,GAAG;QACrB;IACF;IAEA,OAAO,UAAU,GAAGK,KAA0B,EAAc;QAC1D,OAAO,IAAIV,UAAUA,CAACU,MAAM,IAAI,CAAC;IACnC;IAEA,OAAO,aAAaC,QAAgB,EAAEC,MAA4B,EAAqD;QACrH,IAAI,CAACA,QAAQ,OAAO;YAAC,IAAIZ,UAAUA,CAACW,UAAU;YAAOC;SAAO;QAE5D,MAAMC,eAAeC,OAAO,OAAO,CAACF,QACjC,IAAI,CAAC,CAAC,CAACG,EAAE,EAAE,CAACC,EAAE,GAAKD,EAAE,aAAa,CAACC,IACnC,GAAG,CAAC,CAAC,CAACC,GAAGC,EAAE,GAAK,GAAGD,EAAE,CAAC,EAAEC,GAAG,EAC3B,IAAI,CAAC;QAER,OAAO;YAAC,IAAIlB,UAAUA,CAAC,GAAGW,SAAS,CAAC,EAAEE,cAAc,EAAE;YAAOD;SAAO;IACtE;IAEA,2DAA2D;IAC3D,OAAO,UAAUH,QAAuB,EAAEN,OAAiB,EAAE,EAAW;QACtE,IAAI,CAACM,SAAS,IAAI,IAAI,CAACN,KAAK,MAAM,EAAE,OAAO;QAC3C,OAAOA,KAAK,IAAI,CAAC,CAACgB,MAAQV,SAAS,IAAI,EAAE,SAASU;IACpD;AACF"}

package/dist/core/storage/utils/middleware-module.d.ts

@@ -0,0 +1,94 @@
+import { StorageKeyType } from './storage-key';
+/**
+ * Sentinel object returned by middleware to signal that the value has not changed.
+ * BaseStorage checks for this by reference equality to skip subscriber notifications.
+ */
+export declare const VALUE_NOT_CHANGED: unique symbol;
+export type StorageActionType = 'get' | 'set' | 'delete' | 'clear' | 'init' | 'keys' | 'update' | 'reset';
+export type StorageAction = {
+    type: StorageActionType;
+    key?: StorageKeyType;
+    value?: any;
+    metadata?: Record<string, any>;
+    source?: string;
+    timestamp?: number;
+};
+export type MiddlewareAPI = {
+    dispatch: (action: StorageAction) => Promise<any>;
+    getState: () => Promise<Record<string, any>>;
+    storage: {
+        doGet: (key: StorageKeyType) => Promise<any>;
+        doSet: (key: StorageKeyType, value: any) => Promise<void>;
+        doUpdate: (updates: Array<{
+            key: StorageKeyType;
+            value: any;
+        }>) => Promise<void>;
+        doDelete: (key: StorageKeyType) => Promise<boolean>;
+        doClear: () => Promise<void>;
+        doKeys: () => Promise<string[]>;
+        notifySubscribers: (key: StorageKeyType, value: any) => void;
+    };
+};
+export type NextFunction = (action: StorageAction) => Promise<any>;
+export type SetupEventsFunction = (api: MiddlewareAPI) => void;
+export type Middleware = {
+    name: string;
+    setup?: SetupEventsFunction;
+    cleanup?: () => Promise<void> | void;
+    reducer: (api: MiddlewareAPI) => (next: NextFunction) => (action: StorageAction) => Promise<any>;
+};
+export type AsyncMiddlewareAPI = MiddlewareAPI;
+export type AsyncNextFunction = NextFunction;
+export type AsyncMiddleware = Middleware;
+export type SyncMiddlewareAPI = {
+    dispatch: (action: StorageAction) => any;
+    getState: () => Record<string, any>;
+    storage: {
+        doGet: (key: StorageKeyType) => any;
+        doSet: (key: StorageKeyType, value: any) => void;
+        doUpdate: (updates: Array<{
+            key: StorageKeyType;
+            value: any;
+        }>) => void;
+        doRemove: (key: StorageKeyType) => boolean;
+        doClear: () => void;
+        doKeys: () => string[];
+        notifySubscribers: (key: StorageKeyType, value: any) => void;
+    };
+};
+export type SyncNextFunction = (action: StorageAction) => any;
+export type SyncSetupEventsFunction = (api: SyncMiddlewareAPI) => void;
+export type SyncMiddleware = {
+    name: string;
+    setup?: SyncSetupEventsFunction;
+    cleanup?: () => void;
+    reducer: (api: SyncMiddlewareAPI) => (next: SyncNextFunction) => (action: StorageAction) => any;
+};
+export declare class AsyncMiddlewareModule {
+    private middlewares;
+    private api;
+    private initialized;
+    private depth;
+    private dispatchFn;
+    constructor(storage: any);
+    private baseOperation;
+    private initializeMiddlewares;
+    use(middleware: Middleware): void;
+    dispatch(action: StorageAction): Promise<any>;
+}
+/** @deprecated Use AsyncMiddlewareModule */
+export declare class MiddlewareModule extends AsyncMiddlewareModule {
+}
+export declare class SyncMiddlewareModule {
+    private middlewares;
+    private api;
+    private initialized;
+    private depth;
+    private dispatchFn;
+    constructor(storage: any);
+    private baseOperation;
+    private initializeMiddlewares;
+    use(middleware: SyncMiddleware): void;
+    dispatch(action: StorageAction): any;
+}
+//# sourceMappingURL=middleware-module.d.ts.map

package/dist/core/storage/utils/middleware-module.d.ts.map

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