synapse-storage 3.0.16 → 4.0.0

package/dist/core/storage/middlewares/sync-broadcast.middleware.js

@@ -0,0 +1,177 @@
+import { handleCallbackError, logError } from "../../../_utils/error-handling.util.js";
+import { StorageEvents } from "../storage.interface.js";
+import { SyncBroadcastChannel } from "../utils/broadcast.util.js";
+
+
+
+
+
+
+
+function handleSyncStorageMessage(api, type, payload) {
+    switch(type){
+        case 'set':
+            if (payload?.key !== undefined && payload?.value !== undefined) {
+                api.storage.doSet(payload.key, payload.value);
+                api.storage.notifySubscribers(payload.key, payload.value);
+            }
+            break;
+        case 'update':
+            if (Array.isArray(payload?.value)) {
+                api.storage.doUpdate(payload.value);
+                payload.value.forEach(({ key, value })=>{
+                    api.storage.notifySubscribers(key, value);
+                });
+            }
+            break;
+        case 'delete':
+            if (payload?.key !== undefined) {
+                api.storage.doRemove(payload.key);
+                api.storage.notifySubscribers(payload.key, undefined);
+            }
+            break;
+        case 'clear':
+            api.storage.doClear();
+            api.storage.notifySubscribers('*', {
+                type: StorageEvents.STORAGE_UPDATE,
+                value: {},
+                source: 'broadcast'
+            });
+            break;
+    }
+    api.storage.notifySubscribers('*', {
+        type: StorageEvents.STORAGE_UPDATE,
+        key: payload?.key,
+        value: payload?.value,
+        source: 'broadcast'
+    });
+}
+function handlePersistentSyncStorageMessage(api, type, payload) {
+    switch(type){
+        case 'set':
+            if (payload?.key !== undefined) {
+                const currentValue = api.storage.doGet(payload.key);
+                api.storage.notifySubscribers(payload.key, currentValue);
+            }
+            break;
+        case 'update':
+            if (Array.isArray(payload?.value)) {
+                for (const { key } of payload.value){
+                    const currentValue = api.storage.doGet(key);
+                    api.storage.notifySubscribers(key, currentValue);
+                }
+                api.storage.notifySubscribers('*', {
+                    type: StorageEvents.STORAGE_UPDATE,
+                    key: payload.value.map(({ key })=>key),
+                    value: payload.value,
+                    source: 'broadcast'
+                });
+            }
+            break;
+        case 'delete':
+            if (payload?.key !== undefined) {
+                api.storage.notifySubscribers(payload.key, undefined);
+            }
+            break;
+        case 'clear':
+            api.storage.notifySubscribers('*', {
+                type: StorageEvents.STORAGE_UPDATE,
+                value: {},
+                source: 'broadcast'
+            });
+            break;
+    }
+    if (type !== 'update') {
+        api.storage.notifySubscribers('*', {
+            type: StorageEvents.STORAGE_UPDATE,
+            key: payload?.key,
+            value: type === 'delete' ? undefined : payload?.value,
+            source: 'broadcast'
+        });
+    }
+}
+const syncBroadcastMiddleware = (props)=>{
+    const { storageName, storageType } = props;
+    const channelName = `${storageType}-${storageName}`;
+    const channel = new SyncBroadcastChannel(channelName, {
+        debug: true
+    });
+    return {
+        name: 'sync-broadcast',
+        setup: (api)=>{
+            if (storageType === 'memory') {
+                channel.setSyncHandler(async ()=>{
+                    const state = api.getState();
+                    const updates = Object.entries(state).map(([key, value])=>({
+                            key,
+                            value
+                        }));
+                    const action = {
+                        type: 'update',
+                        key: '*',
+                        value: updates,
+                        metadata: {
+                            batchUpdate: true,
+                            timestamp: Date.now()
+                        }
+                    };
+                    return action;
+                });
+                // Начальная синхронизация (fire-and-forget)
+                channel.requestSync().then((action)=>{
+                    if (action?.type === 'update' && Array.isArray(action.value)) {
+                        try {
+                            const validUpdates = action.value.every((update)=>update && typeof update === 'object' && 'key' in update && 'value' in update);
+                            if (!validUpdates) {
+                                logError('syncBroadcastMiddleware: invalid sync response updates structure', action.value);
+                                return;
+                            }
+                            api.storage.doUpdate(action.value);
+                            action.value.forEach(({ key, value })=>{
+                                api.storage.notifySubscribers(key, value);
+                            });
+                            api.storage.notifySubscribers('*', {
+                                type: StorageEvents.STORAGE_UPDATE,
+                                value: action.value,
+                                source: 'broadcast'
+                            });
+                        } catch (error) {
+                            handleCallbackError('syncBroadcastMiddleware: error applying sync updates', error);
+                        }
+                    }
+                }).catch((error)=>{
+                    logError('syncBroadcastMiddleware: initial sync failed', error, null, 'warn');
+                });
+            }
+            // Подписка на сообщения (BroadcastChannel API всегда async)
+            return channel.subscribe((message)=>{
+                const { type, payload } = message;
+                if (storageType === 'memory') {
+                    handleSyncStorageMessage(api, type, payload);
+                } else {
+                    handlePersistentSyncStorageMessage(api, type, payload);
+                }
+            });
+        },
+        reducer: (_api)=>(next)=>(action)=>{
+                    const result = next(action);
+                    // Fire-and-forget broadcast to other tabs
+                    if ([
+                        'set',
+                        'delete',
+                        'clear',
+                        'update'
+                    ].includes(action.type)) {
+                        channel.broadcast(action.type, action);
+                    }
+                    return result;
+                },
+        cleanup: ()=>{
+            channel.close();
+        }
+    };
+};
+
+export { syncBroadcastMiddleware };
+
+//# sourceMappingURL=sync-broadcast.middleware.js.map

package/dist/core/storage/middlewares/sync-broadcast.middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core/storage/middlewares/sync-broadcast.middleware.js","sources":["../../../../src/core/storage/middlewares/sync-broadcast.middleware.ts"],"sourcesContent":["import { handleCallbackError, logError } from '../../../_utils/error-handling.util'\nimport { StorageEvents, StorageType } from '../storage.interface'\nimport { SyncBroadcastChannel } from '../utils/broadcast.util'\nimport { StorageAction, SyncMiddleware, SyncMiddlewareAPI, SyncNextFunction } from '../utils/middleware-module'\n\ninterface SyncSharedStateMiddlewareProps {\n  storageType: StorageType\n  storageName: string\n}\n\nfunction handleSyncStorageMessage(api: SyncMiddlewareAPI, type: string, payload: any): void {\n  switch (type) {\n    case 'set':\n      if (payload?.key !== undefined && payload?.value !== undefined) {\n        api.storage.doSet(payload.key, payload.value)\n        api.storage.notifySubscribers(payload.key, payload.value)\n      }\n      break\n\n    case 'update':\n      if (Array.isArray(payload?.value)) {\n        api.storage.doUpdate(payload.value)\n        payload.value.forEach(({ key, value }: { key: string; value: any }) => {\n          api.storage.notifySubscribers(key, value)\n        })\n      }\n      break\n\n    case 'delete':\n      if (payload?.key !== undefined) {\n        api.storage.doRemove(payload.key)\n        api.storage.notifySubscribers(payload.key, undefined)\n      }\n      break\n\n    case 'clear':\n      api.storage.doClear()\n      api.storage.notifySubscribers('*', {\n        type: StorageEvents.STORAGE_UPDATE,\n        value: {},\n        source: 'broadcast',\n      })\n      break\n  }\n\n  api.storage.notifySubscribers('*', {\n    type: StorageEvents.STORAGE_UPDATE,\n    key: payload?.key,\n    value: payload?.value,\n    source: 'broadcast',\n  })\n}\n\nfunction handlePersistentSyncStorageMessage(api: SyncMiddlewareAPI, type: string, payload: any): void {\n  switch (type) {\n    case 'set':\n      if (payload?.key !== undefined) {\n        const currentValue = api.storage.doGet(payload.key)\n        api.storage.notifySubscribers(payload.key, currentValue)\n      }\n      break\n\n    case 'update':\n      if (Array.isArray(payload?.value)) {\n        for (const { key } of payload.value) {\n          const currentValue = api.storage.doGet(key)\n          api.storage.notifySubscribers(key, currentValue)\n        }\n\n        api.storage.notifySubscribers('*', {\n          type: StorageEvents.STORAGE_UPDATE,\n          key: payload.value.map(({ key }: { key: string }) => key),\n          value: payload.value,\n          source: 'broadcast',\n        })\n      }\n      break\n\n    case 'delete':\n      if (payload?.key !== undefined) {\n        api.storage.notifySubscribers(payload.key, undefined)\n      }\n      break\n\n    case 'clear':\n      api.storage.notifySubscribers('*', {\n        type: StorageEvents.STORAGE_UPDATE,\n        value: {},\n        source: 'broadcast',\n      })\n      break\n  }\n\n  if (type !== 'update') {\n    api.storage.notifySubscribers('*', {\n      type: StorageEvents.STORAGE_UPDATE,\n      key: payload?.key,\n      value: type === 'delete' ? undefined : payload?.value,\n      source: 'broadcast',\n    })\n  }\n}\n\nexport const syncBroadcastMiddleware = (props: SyncSharedStateMiddlewareProps): SyncMiddleware => {\n  const { storageName, storageType } = props\n  const channelName = `${storageType}-${storageName}`\n  const channel = new SyncBroadcastChannel<StorageAction>(channelName, { debug: true })\n\n  return {\n    name: 'sync-broadcast',\n    setup: (api: SyncMiddlewareAPI) => {\n      if (storageType === 'memory') {\n        channel.setSyncHandler(async () => {\n          const state = api.getState()\n\n          const updates = Object.entries(state).map(([key, value]) => ({\n            key,\n            value,\n          }))\n\n          const action: StorageAction = {\n            type: 'update',\n            key: '*',\n            value: updates,\n            metadata: {\n              batchUpdate: true,\n              timestamp: Date.now(),\n            },\n          }\n          return action\n        })\n\n        // Начальная синхронизация (fire-and-forget)\n        channel\n          .requestSync()\n          .then((action) => {\n            if (action?.type === 'update' && Array.isArray(action.value)) {\n              try {\n                const validUpdates = action.value.every((update) => update && typeof update === 'object' && 'key' in update && 'value' in update)\n\n                if (!validUpdates) {\n                  logError('syncBroadcastMiddleware: invalid sync response updates structure', action.value)\n                  return\n                }\n\n                api.storage.doUpdate(action.value)\n\n                action.value.forEach(({ key, value }) => {\n                  api.storage.notifySubscribers(key, value)\n                })\n\n                api.storage.notifySubscribers('*', {\n                  type: StorageEvents.STORAGE_UPDATE,\n                  value: action.value,\n                  source: 'broadcast',\n                })\n              } catch (error) {\n                handleCallbackError('syncBroadcastMiddleware: error applying sync updates', error)\n              }\n            }\n          })\n          .catch((error) => {\n            logError('syncBroadcastMiddleware: initial sync failed', error, null, 'warn')\n          })\n      }\n\n      // Подписка на сообщения (BroadcastChannel API всегда async)\n      return channel.subscribe((message) => {\n        const { type, payload } = message\n\n        if (storageType === 'memory') {\n          handleSyncStorageMessage(api, type, payload)\n        } else {\n          handlePersistentSyncStorageMessage(api, type, payload)\n        }\n      })\n    },\n\n    reducer: (_api: SyncMiddlewareAPI) => (next: SyncNextFunction) => (action: StorageAction) => {\n      const result = next(action)\n\n      // Fire-and-forget broadcast to other tabs\n      if (['set', 'delete', 'clear', 'update'].includes(action.type)) {\n        channel.broadcast(action.type, action)\n      }\n\n      return result\n    },\n\n    cleanup: () => {\n      channel.close()\n    },\n  }\n}\n"],"names":["handleCallbackError","logError","StorageEvents","SyncBroadcastChannel","handleSyncStorageMessage","api","type","payload","undefined","Array","key","value","handlePersistentSyncStorageMessage","currentValue","syncBroadcastMiddleware","props","storageName","storageType","channelName","channel","state","updates","Object","action","Date","validUpdates","update","error","message","_api","next","result"],"mappings":"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"}

package/dist/core/storage/middlewares/sync-storage-batching.middleware.d.ts

@@ -0,0 +1,6 @@
+import { SyncMiddleware } from '../utils/middleware-module';
+export interface SyncBatchingMiddlewareOptions {
+    batchSize?: number;
+}
+export declare const syncBatchingMiddleware: (options?: SyncBatchingMiddlewareOptions) => SyncMiddleware;
+//# sourceMappingURL=sync-storage-batching.middleware.d.ts.map

package/dist/core/storage/middlewares/sync-storage-batching.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-storage-batching.middleware.d.ts","sourceRoot":"","sources":["../../../../src/core/storage/middlewares/sync-storage-batching.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,cAAc,EAAuC,MAAM,4BAA4B,CAAA;AAE/G,MAAM,WAAW,6BAA6B;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,eAAO,MAAM,sBAAsB,GAAI,UAAS,6BAAkC,KAAG,cA+DpF,CAAA"}

package/dist/core/storage/middlewares/sync-storage-batching.middleware.js

@@ -0,0 +1,56 @@
+const syncBatchingMiddleware = (options = {})=>{
+    const batchSize = options.batchSize ?? 10;
+    let queue = [];
+    let scheduled = false;
+    const shouldBatch = (action)=>{
+        return action.type === 'set' || action.type === 'update';
+    };
+    const mergeActions = (actions)=>{
+        const merged = new Map();
+        for (const action of actions){
+            const key = `${action.type}_${action.key?.toString() || 'default'}`;
+            merged.set(key, action);
+        }
+        return Array.from(merged.values());
+    };
+    const flushQueue = (api, next)=>{
+        if (queue.length === 0) return;
+        const batch = queue.splice(0);
+        const mergedActions = mergeActions(batch);
+        for (const action of mergedActions){
+            next(action);
+        }
+    };
+    return {
+        name: 'sync-batching',
+        setup: ()=>{},
+        cleanup: ()=>{
+            queue = [];
+            scheduled = false;
+        },
+        reducer: (api)=>(next)=>(action)=>{
+                    if (!shouldBatch(action)) {
+                        return next(action);
+                    }
+                    queue.push(action);
+                    if (queue.length >= batchSize) {
+                        flushQueue(api, next);
+                    } else if (!scheduled) {
+                        scheduled = true;
+                        queueMicrotask(()=>{
+                            scheduled = false;
+                            flushQueue(api, next);
+                        });
+                    }
+                    // Возвращаем текущее значение из кеша (операция ещё не выполнена если в очереди)
+                    if (action.type === 'set' && action.key) {
+                        return action.value;
+                    }
+                    return undefined;
+                }
+    };
+};
+
+export { syncBatchingMiddleware };
+
+//# sourceMappingURL=sync-storage-batching.middleware.js.map

package/dist/core/storage/middlewares/sync-storage-batching.middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core/storage/middlewares/sync-storage-batching.middleware.js","sources":["../../../../src/core/storage/middlewares/sync-storage-batching.middleware.ts"],"sourcesContent":["import { StorageAction, SyncMiddleware, SyncMiddlewareAPI, SyncNextFunction } from '../utils/middleware-module'\n\nexport interface SyncBatchingMiddlewareOptions {\n  batchSize?: number\n}\n\nexport const syncBatchingMiddleware = (options: SyncBatchingMiddlewareOptions = {}): SyncMiddleware => {\n  const batchSize = options.batchSize ?? 10\n\n  let queue: StorageAction[] = []\n  let scheduled = false\n\n  const shouldBatch = (action: StorageAction): boolean => {\n    return action.type === 'set' || action.type === 'update'\n  }\n\n  const mergeActions = (actions: StorageAction[]): StorageAction[] => {\n    const merged = new Map<string, StorageAction>()\n\n    for (const action of actions) {\n      const key = `${action.type}_${action.key?.toString() || 'default'}`\n      merged.set(key, action)\n    }\n\n    return Array.from(merged.values())\n  }\n\n  const flushQueue = (api: SyncMiddlewareAPI, next: SyncNextFunction): void => {\n    if (queue.length === 0) return\n\n    const batch = queue.splice(0)\n    const mergedActions = mergeActions(batch)\n\n    for (const action of mergedActions) {\n      next(action)\n    }\n  }\n\n  return {\n    name: 'sync-batching',\n    setup: () => {},\n    cleanup: () => {\n      queue = []\n      scheduled = false\n    },\n    reducer: (api: SyncMiddlewareAPI) => (next: SyncNextFunction) => (action: StorageAction) => {\n      if (!shouldBatch(action)) {\n        return next(action)\n      }\n\n      queue.push(action)\n\n      if (queue.length >= batchSize) {\n        flushQueue(api, next)\n      } else if (!scheduled) {\n        scheduled = true\n        queueMicrotask(() => {\n          scheduled = false\n          flushQueue(api, next)\n        })\n      }\n\n      // Возвращаем текущее значение из кеша (операция ещё не выполнена если в очереди)\n      if (action.type === 'set' && action.key) {\n        return action.value\n      }\n      return undefined\n    },\n  }\n}\n"],"names":["syncBatchingMiddleware","options","batchSize","queue","scheduled","shouldBatch","action","mergeActions","actions","merged","Map","key","Array","flushQueue","api","next","batch","mergedActions","queueMicrotask","undefined"],"mappings":"AAMO,MAAMA,sBAAsBA,GAAG,CAACC,UAAyC,CAAC,CAAC;IAChF,MAAMC,YAAYD,QAAQ,SAAS,IAAI;IAEvC,IAAIE,QAAyB,EAAE;IAC/B,IAAIC,YAAY;IAEhB,MAAMC,cAAc,CAACC;QACnB,OAAOA,OAAO,IAAI,KAAK,SAASA,OAAO,IAAI,KAAK;IAClD;IAEA,MAAMC,eAAe,CAACC;QACpB,MAAMC,SAAS,IAAIC;QAEnB,KAAK,MAAMJ,UAAUE,QAAS;YAC5B,MAAMG,MAAM,GAAGL,OAAO,IAAI,CAAC,CAAC,EAAEA,OAAO,GAAG,EAAE,cAAc,WAAW;YACnEG,OAAO,GAAG,CAACE,KAAKL;QAClB;QAEA,OAAOM,MAAM,IAAI,CAACH,OAAO,MAAM;IACjC;IAEA,MAAMI,aAAa,CAACC,KAAwBC;QAC1C,IAAIZ,MAAM,MAAM,KAAK,GAAG;QAExB,MAAMa,QAAQb,MAAM,MAAM,CAAC;QAC3B,MAAMc,gBAAgBV,aAAaS;QAEnC,KAAK,MAAMV,UAAUW,cAAe;YAClCF,KAAKT;QACP;IACF;IAEA,OAAO;QACL,MAAM;QACN,OAAO,KAAO;QACd,SAAS;YACPH,QAAQ,EAAE;YACVC,YAAY;QACd;QACA,SAAS,CAACU,MAA2B,CAACC,OAA2B,CAACT;oBAChE,IAAI,CAACD,YAAYC,SAAS;wBACxB,OAAOS,KAAKT;oBACd;oBAEAH,MAAM,IAAI,CAACG;oBAEX,IAAIH,MAAM,MAAM,IAAID,WAAW;wBAC7BW,WAAWC,KAAKC;oBAClB,OAAO,IAAI,CAACX,WAAW;wBACrBA,YAAY;wBACZc,eAAe;4BACbd,YAAY;4BACZS,WAAWC,KAAKC;wBAClB;oBACF;oBAEA,iFAAiF;oBACjF,IAAIT,OAAO,IAAI,KAAK,SAASA,OAAO,GAAG,EAAE;wBACvC,OAAOA,OAAO,KAAK;oBACrB;oBACA,OAAOa;gBACT;IACF;AACF,EAAC"}

package/dist/core/storage/middlewares/sync-storage-shallow-compare.middleware.d.ts

@@ -0,0 +1,7 @@
+import { SyncMiddleware } from '../utils/middleware-module';
+export interface SyncShallowCompareMiddlewareOptions {
+    segments?: string[];
+    comparator?: <T>(prev: T, next: T) => boolean;
+}
+export declare const syncShallowCompareMiddleware: (options?: SyncShallowCompareMiddlewareOptions) => SyncMiddleware;
+//# sourceMappingURL=sync-storage-shallow-compare.middleware.d.ts.map

package/dist/core/storage/middlewares/sync-storage-shallow-compare.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-storage-shallow-compare.middleware.d.ts","sourceRoot":"","sources":["../../../../src/core/storage/middlewares/sync-storage-shallow-compare.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,cAAc,EAA0D,MAAM,4BAA4B,CAAA;AAGlI,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,OAAO,CAAA;CAC9C;AAED,eAAO,MAAM,4BAA4B,GAAI,UAAS,mCAAwC,KAAG,cA0ChG,CAAA"}

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

@@ -0,0 +1,39 @@
+import { VALUE_NOT_CHANGED } from "../utils/middleware-module.js";
+
+
+
+const syncShallowCompareMiddleware = (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: 'sync-shallow-compare',
+        setup: ()=>{},
+        reducer: (_api)=>(next)=>(action)=>{
+                    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)) {
+                        return VALUE_NOT_CHANGED;
+                    }
+                    const result = next(action);
+                    valueCache.set(cacheKey, result !== undefined ? result : nextValue);
+                    return result;
+                }
+    };
+};
+
+export { syncShallowCompareMiddleware };
+
+//# sourceMappingURL=sync-storage-shallow-compare.middleware.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core/storage/middlewares/sync-storage-shallow-compare.middleware.js","sources":["../../../../src/core/storage/middlewares/sync-storage-shallow-compare.middleware.ts"],"sourcesContent":["import { StorageAction, SyncMiddleware, SyncMiddlewareAPI, SyncNextFunction, VALUE_NOT_CHANGED } from '../utils/middleware-module'\nimport { StorageKeyType } from '../utils/storage-key'\n\nexport interface SyncShallowCompareMiddlewareOptions {\n  segments?: string[]\n  comparator?: <T>(prev: T, next: T) => boolean\n}\n\nexport const syncShallowCompareMiddleware = (options: SyncShallowCompareMiddlewareOptions = {}): SyncMiddleware => {\n  const {\n    comparator = (prev: any, next: any) => {\n      if (prev === next) return true\n\n      if (typeof prev !== 'object' || typeof next !== 'object' || prev === null || next === null) {\n        return prev === next\n      }\n\n      const keysA = Object.keys(prev)\n      const keysB = Object.keys(next)\n\n      if (keysA.length !== keysB.length) return false\n\n      return keysA.every((key) => Object.prototype.hasOwnProperty.call(next, key) && prev[key] === next[key])\n    },\n    segments = [],\n  } = options\n\n  const valueCache = new Map<StorageKeyType, any>()\n\n  return {\n    name: 'sync-shallow-compare',\n    setup: () => {},\n    reducer: (_api: SyncMiddlewareAPI) => (next: SyncNextFunction) => (action: StorageAction) => {\n      if (action.type !== 'set' || (segments.length && !segments.includes(action.metadata?.segment ?? 'default'))) {\n        return next(action)\n      }\n\n      const cacheKey = action.key!\n      const prevValue = valueCache.get(cacheKey)\n      const nextValue = action.value\n\n      if (prevValue !== undefined && comparator(prevValue, nextValue)) {\n        return VALUE_NOT_CHANGED\n      }\n\n      const result = next(action)\n      valueCache.set(cacheKey, result !== undefined ? result : nextValue)\n      return result\n    },\n  }\n}\n"],"names":["VALUE_NOT_CHANGED","syncShallowCompareMiddleware","options","comparator","prev","next","keysA","Object","keysB","key","segments","valueCache","Map","_api","action","cacheKey","prevValue","nextValue","undefined","result"],"mappings":";;;AAAkI;AAQ3H,MAAMC,4BAA4BA,GAAG,CAACC,UAA+C,CAAC,CAAC;IAC5F,MAAM,EACJC,aAAa,CAACC,MAAWC;QACvB,IAAID,SAASC,MAAM,OAAO;QAE1B,IAAI,OAAOD,SAAS,YAAY,OAAOC,SAAS,YAAYD,SAAS,QAAQC,SAAS,MAAM;YAC1F,OAAOD,SAASC;QAClB;QAEA,MAAMC,QAAQC,OAAO,IAAI,CAACH;QAC1B,MAAMI,QAAQD,OAAO,IAAI,CAACF;QAE1B,IAAIC,MAAM,MAAM,KAAKE,MAAM,MAAM,EAAE,OAAO;QAE1C,OAAOF,MAAM,KAAK,CAAC,CAACG,MAAQF,OAAO,SAAS,CAAC,cAAc,CAAC,IAAI,CAACF,MAAMI,QAAQL,IAAI,CAACK,IAAI,KAAKJ,IAAI,CAACI,IAAI;IACxG,CAAC,EACDC,WAAW,EAAE,EACd,GAAGR;IAEJ,MAAMS,aAAa,IAAIC;IAEvB,OAAO;QACL,MAAM;QACN,OAAO,KAAO;QACd,SAAS,CAACC,OAA4B,CAACR,OAA2B,CAACS;oBACjE,IAAIA,OAAO,IAAI,KAAK,SAAUJ,SAAS,MAAM,IAAI,CAACA,SAAS,QAAQ,CAACI,OAAO,QAAQ,EAAE,WAAW,YAAa;wBAC3G,OAAOT,KAAKS;oBACd;oBAEA,MAAMC,WAAWD,OAAO,GAAG;oBAC3B,MAAME,YAAYL,WAAW,GAAG,CAACI;oBACjC,MAAME,YAAYH,OAAO,KAAK;oBAE9B,IAAIE,cAAcE,aAAaf,WAAWa,WAAWC,YAAY;wBAC/D,OAAOjB,iBAAiBA;oBAC1B;oBAEA,MAAMmB,SAASd,KAAKS;oBACpBH,WAAW,GAAG,CAACI,UAAUI,WAAWD,YAAYC,SAASF;oBACzD,OAAOE;gBACT;IACF;AACF,EAAC"}

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

@@ -0,0 +1,101 @@
+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 ISyncStoragePlugin extends IPlugin {
+    onBeforeSet?<T>(value: T, context: PluginContext): T;
+    onAfterSet?<T>(key: StorageKeyType, value: T, context: PluginContext): T;
+    onBeforeGet?(key: StorageKeyType, context: PluginContext): StorageKeyType;
+    onAfterGet?<T>(key: StorageKeyType, value: T | undefined, context: PluginContext): T | undefined;
+    onBeforeDelete?(key: StorageKeyType, context: PluginContext): boolean;
+    onAfterDelete?(key: StorageKeyType, context: PluginContext): void;
+    onClear?(context: PluginContext): void;
+}
+/**
+ * Исполнитель плагинов для синхронных хранилищ.
+ * Все execute* методы возвращают значения синхронно.
+ */
+export interface ISyncPluginExecutor {
+    executeBeforeSet<T>(value: T, metadata?: Record<string, any>): T;
+    executeAfterSet<T>(key: StorageKeyType, value: T, metadata?: Record<string, any>): T;
+    executeBeforeGet(key: StorageKeyType, metadata?: Record<string, any>): StorageKeyType;
+    executeAfterGet<T>(key: StorageKeyType, value: T | undefined, metadata?: Record<string, any>): T | undefined;
+    executeBeforeDelete(key: StorageKeyType, metadata?: Record<string, any>): boolean;
+    executeAfterDelete(key: StorageKeyType, metadata?: Record<string, any>): void;
+    executeOnClear(metadata?: Record<string, any>): void;
+}
+/**
+ * Интерфейс плагина для асинхронного хранилища.
+ * Все хуки возвращают Promise.
+ */
+export interface IAsyncStoragePlugin extends IPlugin {
+    onBeforeSet?<T>(value: T, context: PluginContext): Promise<T>;
+    onAfterSet?<T>(key: StorageKeyType, value: T, context: PluginContext): Promise<T>;
+    onBeforeGet?(key: StorageKeyType, context: PluginContext): Promise<StorageKeyType>;
+    onAfterGet?<T>(key: StorageKeyType, value: T | undefined, context: PluginContext): Promise<T | undefined>;
+    onBeforeDelete?(key: StorageKeyType, context: PluginContext): Promise<boolean>;
+    onAfterDelete?(key: StorageKeyType, context: PluginContext): Promise<void>;
+    onClear?(context: PluginContext): Promise<void>;
+}
+/**
+ * Исполнитель плагинов для асинхронных хранилищ.
+ * Все execute* методы возвращают Promise.
+ */
+export interface IAsyncPluginExecutor {
+    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>;
+}
+/** @deprecated Use IAsyncStoragePlugin */
+export type IStoragePlugin = IAsyncStoragePlugin;
+/** @deprecated Use IAsyncPluginExecutor */
+export type IPluginExecutor = IAsyncPluginExecutor;
+/**
+ * Менеджер плагинов
+ * Отвечает за регистрацию, получение и удаление плагинов
+ */
+export interface IPluginManager<T extends IPlugin> {
+    add(plugin: T): Promise<void>;
+    remove(name: string): Promise<void>;
+    get(name: string): T | undefined;
+    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,8 @@
+// ─── Plugin Manager ───────────────────────────────────────────────────────────
+/**
+ * Менеджер плагинов
+ * Отвечает за регистрацию, получение и удаление плагинов
+ */ 
+
+
+//# sourceMappingURL=plugin.interface.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core/storage/modules/plugin/plugin.interface.js","sources":["../../../../../src/core/storage/modules/plugin/plugin.interface.ts"],"sourcesContent":["import { StorageKeyType } from '../../utils/storage-key'\n\n/**\n * Контекст выполнения для плагинов\n * Содержит информацию о текущей операции и хранилище\n */\nexport interface PluginContext {\n  /** Имя хранилища, к которому применяется плагин */\n  storageName: string\n\n  /** Временная метка выполнения операции (timestamp) */\n  timestamp: number\n\n  /** Дополнительные метаданные операции (могут быть предоставлены хранилищем или другими плагинами) */\n  metadata?: Record<string, any>\n}\n\n/**\n * Базовый интерфейс для всех плагинов\n * Определяет основные свойства и методы жизненного цикла\n */\nexport interface IPlugin {\n  /** Уникальное имя плагина */\n  name: string\n\n  /**\n   * Метод инициализации плагина\n   * Вызывается при добавлении плагина в хранилище или при инициализации хранилища\n   */\n  initialize?(): Promise<void>\n\n  /**\n   * Метод уничтожения плагина\n   * Вызывается при удалении плагина из хранилища или при уничтожении хранилища\n   * Используется для освобождения ресурсов и очистки состояния\n   */\n  destroy?(): Promise<void>\n}\n\n// ─── Sync Storage Plugin ──────────────────────────────────────────────────────\n\n/**\n * Интерфейс плагина для синхронного хранилища.\n * Все хуки выполняются синхронно.\n */\nexport interface ISyncStoragePlugin extends IPlugin {\n  onBeforeSet?<T>(value: T, context: PluginContext): T\n  onAfterSet?<T>(key: StorageKeyType, value: T, context: PluginContext): T\n  onBeforeGet?(key: StorageKeyType, context: PluginContext): StorageKeyType\n  onAfterGet?<T>(key: StorageKeyType, value: T | undefined, context: PluginContext): T | undefined\n  onBeforeDelete?(key: StorageKeyType, context: PluginContext): boolean\n  onAfterDelete?(key: StorageKeyType, context: PluginContext): void\n  onClear?(context: PluginContext): void\n}\n\n/**\n * Исполнитель плагинов для синхронных хранилищ.\n * Все execute* методы возвращают значения синхронно.\n */\nexport interface ISyncPluginExecutor {\n  executeBeforeSet<T>(value: T, metadata?: Record<string, any>): T\n  executeAfterSet<T>(key: StorageKeyType, value: T, metadata?: Record<string, any>): T\n  executeBeforeGet(key: StorageKeyType, metadata?: Record<string, any>): StorageKeyType\n  executeAfterGet<T>(key: StorageKeyType, value: T | undefined, metadata?: Record<string, any>): T | undefined\n  executeBeforeDelete(key: StorageKeyType, metadata?: Record<string, any>): boolean\n  executeAfterDelete(key: StorageKeyType, metadata?: Record<string, any>): void\n  executeOnClear(metadata?: Record<string, any>): void\n}\n\n// ─── Async Storage Plugin ─────────────────────────────────────────────────────\n\n/**\n * Интерфейс плагина для асинхронного хранилища.\n * Все хуки возвращают Promise.\n */\nexport interface IAsyncStoragePlugin extends IPlugin {\n  onBeforeSet?<T>(value: T, context: PluginContext): Promise<T>\n  onAfterSet?<T>(key: StorageKeyType, value: T, context: PluginContext): Promise<T>\n  onBeforeGet?(key: StorageKeyType, context: PluginContext): Promise<StorageKeyType>\n  onAfterGet?<T>(key: StorageKeyType, value: T | undefined, context: PluginContext): Promise<T | undefined>\n  onBeforeDelete?(key: StorageKeyType, context: PluginContext): Promise<boolean>\n  onAfterDelete?(key: StorageKeyType, context: PluginContext): Promise<void>\n  onClear?(context: PluginContext): Promise<void>\n}\n\n/**\n * Исполнитель плагинов для асинхронных хранилищ.\n * Все execute* методы возвращают Promise.\n */\nexport interface IAsyncPluginExecutor {\n  executeBeforeSet<T>(value: T, metadata?: Record<string, any>): Promise<T>\n  executeAfterSet<T>(key: StorageKeyType, value: T, metadata?: Record<string, any>): Promise<T>\n  executeBeforeGet(key: StorageKeyType, metadata?: Record<string, any>): Promise<StorageKeyType>\n  executeAfterGet<T>(key: StorageKeyType, value: T | undefined, metadata?: Record<string, any>): Promise<T | undefined>\n  executeBeforeDelete(key: StorageKeyType, metadata?: Record<string, any>): Promise<boolean>\n  executeAfterDelete(key: StorageKeyType, metadata?: Record<string, any>): Promise<void>\n  executeOnClear(metadata?: Record<string, any>): Promise<void>\n}\n\n// ─── Backward Compatibility Aliases ───────────────────────────────────────────\n\n/** @deprecated Use IAsyncStoragePlugin */\nexport type IStoragePlugin = IAsyncStoragePlugin\n\n/** @deprecated Use IAsyncPluginExecutor */\nexport type IPluginExecutor = IAsyncPluginExecutor\n\n// ─── Plugin Manager ───────────────────────────────────────────────────────────\n\n/**\n * Менеджер плагинов\n * Отвечает за регистрацию, получение и удаление плагинов\n */\nexport interface IPluginManager<T extends IPlugin> {\n  add(plugin: T): Promise<void>\n  remove(name: string): Promise<void>\n  get(name: string): T | undefined\n  getAll(): T[]\n  initialize(): Promise<void>\n  destroy(): Promise<void>\n}\n"],"names":[],"mappings":"AA2GA,iFAAiF;AAEjF;;;CAGC,GAQA"}

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

@@ -0,0 +1,49 @@
+import { ILogger } from '../../storage.interface';
+import { StorageKeyType } from '../../utils/storage-key';
+import { IAsyncPluginExecutor, IAsyncStoragePlugin, IPluginManager, ISyncPluginExecutor, ISyncStoragePlugin } from './plugin.interface';
+export declare class SyncStoragePluginModule implements IPluginManager<ISyncStoragePlugin>, ISyncPluginExecutor {
+    protected readonly parentExecutor?: ISyncPluginExecutor | undefined;
+    protected readonly logger?: ILogger | undefined;
+    protected readonly storageName: string;
+    private plugins;
+    constructor(parentExecutor?: ISyncPluginExecutor | undefined, logger?: ILogger | undefined, storageName?: string);
+    private createContext;
+    add(plugin: ISyncStoragePlugin): Promise<void>;
+    remove(name: string): Promise<void>;
+    get(name: string): ISyncStoragePlugin | undefined;
+    getAll(): ISyncStoragePlugin[];
+    initialize(): Promise<void>;
+    destroy(): Promise<void>;
+    executeBeforeSet<T>(value: T, metadata?: Record<string, any>): T;
+    executeAfterSet<T>(key: StorageKeyType, value: T, metadata?: Record<string, any>): T;
+    executeBeforeGet(key: StorageKeyType, metadata?: Record<string, any>): StorageKeyType;
+    executeAfterGet<T>(key: StorageKeyType, value: T | undefined, metadata?: Record<string, any>): T | undefined;
+    executeBeforeDelete(key: StorageKeyType, metadata?: Record<string, any>): boolean;
+    executeAfterDelete(key: StorageKeyType, metadata?: Record<string, any>): void;
+    executeOnClear(metadata?: Record<string, any>): void;
+}
+export declare class AsyncStoragePluginModule implements IPluginManager<IAsyncStoragePlugin>, IAsyncPluginExecutor {
+    protected readonly parentExecutor?: IAsyncPluginExecutor | undefined;
+    protected readonly logger?: ILogger | undefined;
+    protected readonly storageName: string;
+    private plugins;
+    constructor(parentExecutor?: IAsyncPluginExecutor | undefined, logger?: ILogger | undefined, storageName?: string);
+    private createContext;
+    add(plugin: IAsyncStoragePlugin): Promise<void>;
+    remove(name: string): Promise<void>;
+    get(name: string): IAsyncStoragePlugin | undefined;
+    getAll(): IAsyncStoragePlugin[];
+    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>;
+}
+/** @deprecated Use AsyncStoragePluginModule */
+export declare class StoragePluginModule extends AsyncStoragePluginModule {
+}
+//# 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,oBAAoB,EAAE,mBAAmB,EAAE,cAAc,EAAE,mBAAmB,EAAE,kBAAkB,EAAiB,MAAM,oBAAoB,CAAA;AAItJ,qBAAa,uBAAwB,YAAW,cAAc,CAAC,kBAAkB,CAAC,EAAE,mBAAmB;IAInG,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,mBAAmB;IACvD,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO;IACnC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM;IALxC,OAAO,CAAC,OAAO,CAAwC;gBAGlC,cAAc,CAAC,EAAE,mBAAmB,YAAA,EACpC,MAAM,CAAC,EAAE,OAAO,YAAA,EAChB,WAAW,GAAE,MAAkB;IAGpD,OAAO,CAAC,aAAa;IAQR,GAAG,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAe9C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASzC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIjD,MAAM,IAAI,kBAAkB,EAAE;IAIxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC;IAsBhE,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC;IAsBpF,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,cAAc;IAsBrF,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS;IAsB5G,mBAAmB,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO;IAsBjF,kBAAkB,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAmB7E,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;CAkB5D;AAID,qBAAa,wBAAyB,YAAW,cAAc,CAAC,mBAAmB,CAAC,EAAE,oBAAoB;IAItG,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,oBAAoB;IACxD,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO;IACnC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM;IALxC,OAAO,CAAC,OAAO,CAAyC;gBAGnC,cAAc,CAAC,EAAE,oBAAoB,YAAA,EACrC,MAAM,CAAC,EAAE,OAAO,YAAA,EAChB,WAAW,GAAE,MAAkB;IAGpD,OAAO,CAAC,aAAa;IAQR,GAAG,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAe/C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASzC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAIlD,MAAM,IAAI,mBAAmB,EAAE;IAIzB,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;IAqBrH,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;AAED,+CAA+C;AAC/C,qBAAa,mBAAoB,SAAQ,wBAAwB;CAAG"}