synapse-storage 3.0.16 → 4.0.0

package/dist/core/storage/utils/middleware-module.js

@@ -0,0 +1,258 @@
+import { handleOperationError } from "../../../_utils/error-handling.util.js";
+
+
+
+/**
+ * Sentinel object returned by middleware to signal that the value has not changed.
+ * BaseStorage checks for this by reference equality to skip subscriber notifications.
+ */ const VALUE_NOT_CHANGED = Symbol('VALUE_NOT_CHANGED');
+// ─── Async Middleware Module ───────────────────────────────────────────────────
+class AsyncMiddlewareModule {
+    middlewares = [];
+    api;
+    initialized = false;
+    depth = 0;
+    dispatchFn;
+    constructor(storage){
+        this.api = {
+            dispatch: async (action)=>this.dispatch(action),
+            getState: ()=>storage.getState(),
+            storage: {
+                doGet: storage.doGet.bind(storage),
+                doSet: storage.doSet.bind(storage),
+                doUpdate: storage.doUpdate.bind(storage),
+                doDelete: storage.doDelete.bind(storage),
+                doClear: storage.doClear.bind(storage),
+                doKeys: storage.doKeys.bind(storage),
+                notifySubscribers: storage.notifySubscribers.bind(storage)
+            }
+        };
+    }
+    async baseOperation(action) {
+        switch(action.type){
+            case 'get':
+                {
+                    return this.api.storage.doGet(action.key);
+                }
+            case 'set':
+                {
+                    await this.api.storage.doSet(action.key, action.value);
+                    return this.api.storage.doGet(action.key);
+                }
+            case 'update':
+                {
+                    if (Array.isArray(action.value)) {
+                        await this.api.storage.doUpdate(action.value);
+                        return this.api.storage.doGet('');
+                    }
+                    return action.value;
+                }
+            case 'delete':
+                {
+                    return this.api.storage.doDelete(action.key);
+                }
+            case 'clear':
+                {
+                    return this.api.storage.doClear();
+                }
+            case 'reset':
+                {
+                    if (action.value) {
+                        await this.api.storage.doClear();
+                        await this.api.storage.doSet('', action.value);
+                        return this.api.storage.doGet('');
+                    }
+                    return this.api.storage.doClear();
+                }
+            case 'init':
+                {
+                    const currentState = await this.api.storage.doGet('');
+                    if (Object.keys(currentState || {}).length > 0) {
+                        return currentState;
+                    }
+                    if (action.value) {
+                        await this.api.storage.doSet('', action.value);
+                        return this.api.storage.doGet('');
+                    }
+                    return currentState;
+                }
+            case 'keys':
+                {
+                    return this.api.storage.doKeys();
+                }
+            default:
+                {
+                    throw new Error(`Unknown action type: ${action.type}`);
+                }
+        }
+    }
+    initializeMiddlewares() {
+        if (this.initialized) return;
+        let chain = this.baseOperation.bind(this);
+        for (const middleware of [
+            ...this.middlewares
+        ].reverse()){
+            const nextChain = chain;
+            chain = async (action)=>{
+                const actionWithMeta = {
+                    ...action,
+                    metadata: {
+                        ...action.metadata,
+                        timestamp: action.metadata?.timestamp || Date.now()
+                    }
+                };
+                return middleware.reducer(this.api)(nextChain)(actionWithMeta);
+            };
+        }
+        this.dispatchFn = chain;
+        this.initialized = true;
+    }
+    use(middleware) {
+        if (middleware.setup) {
+            middleware.setup(this.api);
+        }
+        this.middlewares.push(middleware);
+        this.initialized = false;
+    }
+    async dispatch(action) {
+        if (!this.initialized) {
+            this.initializeMiddlewares();
+        }
+        this.depth++;
+        try {
+            return await this.dispatchFn(action);
+        } catch (error) {
+            handleOperationError('AsyncMiddlewareModule: error in middleware chain', error);
+        } finally{
+            this.depth--;
+        }
+    }
+}
+/** @deprecated Use AsyncMiddlewareModule */ class MiddlewareModule extends AsyncMiddlewareModule {
+}
+// ─── Sync Middleware Module ────────────────────────────────────────────────────
+class SyncMiddlewareModule {
+    middlewares = [];
+    api;
+    initialized = false;
+    depth = 0;
+    dispatchFn;
+    constructor(storage){
+        this.api = {
+            dispatch: (action)=>this.dispatch(action),
+            getState: ()=>storage.getState(),
+            storage: {
+                doGet: storage.doGet.bind(storage),
+                doSet: storage.doSet.bind(storage),
+                doUpdate: storage.doUpdate.bind(storage),
+                doRemove: storage.doRemove.bind(storage),
+                doClear: storage.doClear.bind(storage),
+                doKeys: storage.doKeys.bind(storage),
+                notifySubscribers: storage.notifySubscribers.bind(storage)
+            }
+        };
+    }
+    baseOperation(action) {
+        switch(action.type){
+            case 'get':
+                {
+                    return this.api.storage.doGet(action.key);
+                }
+            case 'set':
+                {
+                    this.api.storage.doSet(action.key, action.value);
+                    return this.api.storage.doGet(action.key);
+                }
+            case 'update':
+                {
+                    if (Array.isArray(action.value)) {
+                        this.api.storage.doUpdate(action.value);
+                        return this.api.storage.doGet('');
+                    }
+                    return action.value;
+                }
+            case 'delete':
+                {
+                    return this.api.storage.doRemove(action.key);
+                }
+            case 'clear':
+                {
+                    return this.api.storage.doClear();
+                }
+            case 'reset':
+                {
+                    if (action.value) {
+                        this.api.storage.doClear();
+                        this.api.storage.doSet('', action.value);
+                        return this.api.storage.doGet('');
+                    }
+                    return this.api.storage.doClear();
+                }
+            case 'init':
+                {
+                    const currentState = this.api.storage.doGet('');
+                    if (Object.keys(currentState || {}).length > 0) {
+                        return currentState;
+                    }
+                    if (action.value) {
+                        this.api.storage.doSet('', action.value);
+                        return this.api.storage.doGet('');
+                    }
+                    return currentState;
+                }
+            case 'keys':
+                {
+                    return this.api.storage.doKeys();
+                }
+            default:
+                {
+                    throw new Error(`Unknown action type: ${action.type}`);
+                }
+        }
+    }
+    initializeMiddlewares() {
+        if (this.initialized) return;
+        let chain = this.baseOperation.bind(this);
+        for (const middleware of [
+            ...this.middlewares
+        ].reverse()){
+            const nextChain = chain;
+            chain = (action)=>{
+                const actionWithMeta = {
+                    ...action,
+                    metadata: {
+                        ...action.metadata,
+                        timestamp: action.metadata?.timestamp || Date.now()
+                    }
+                };
+                return middleware.reducer(this.api)(nextChain)(actionWithMeta);
+            };
+        }
+        this.dispatchFn = chain;
+        this.initialized = true;
+    }
+    use(middleware) {
+        if (middleware.setup) {
+            middleware.setup(this.api);
+        }
+        this.middlewares.push(middleware);
+        this.initialized = false;
+    }
+    dispatch(action) {
+        if (!this.initialized) {
+            this.initializeMiddlewares();
+        }
+        this.depth++;
+        try {
+            return this.dispatchFn(action);
+        } catch (error) {
+            handleOperationError('SyncMiddlewareModule: error in middleware chain', error);
+        } finally{
+            this.depth--;
+        }
+    }
+}
+
+export { AsyncMiddlewareModule, MiddlewareModule, SyncMiddlewareModule, VALUE_NOT_CHANGED };
+
+//# sourceMappingURL=middleware-module.js.map

package/dist/core/storage/utils/middleware-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core/storage/utils/middleware-module.js","sources":["../../../../src/core/storage/utils/middleware-module.ts"],"sourcesContent":["import { handleOperationError } from '../../../_utils/error-handling.util'\nimport { StorageKeyType } from './storage-key'\n\n/**\n * Sentinel object returned by middleware to signal that the value has not changed.\n * BaseStorage checks for this by reference equality to skip subscriber notifications.\n */\nexport const VALUE_NOT_CHANGED: unique symbol = Symbol('VALUE_NOT_CHANGED')\n\nexport type StorageActionType = 'get' | 'set' | 'delete' | 'clear' | 'init' | 'keys' | 'update' | 'reset'\n\nexport type StorageAction = {\n  type: StorageActionType\n  key?: StorageKeyType\n  value?: any\n  metadata?: Record<string, any>\n  source?: string\n  timestamp?: number\n}\n\n// ─── Async Middleware Types ────────────────────────────────────────────────────\n\nexport type MiddlewareAPI = {\n  dispatch: (action: StorageAction) => Promise<any>\n  getState: () => Promise<Record<string, any>>\n  storage: {\n    doGet: (key: StorageKeyType) => Promise<any>\n    doSet: (key: StorageKeyType, value: any) => Promise<void>\n    doUpdate: (updates: Array<{ key: StorageKeyType; value: any }>) => Promise<void>\n    doDelete: (key: StorageKeyType) => Promise<boolean>\n    doClear: () => Promise<void>\n    doKeys: () => Promise<string[]>\n    notifySubscribers: (key: StorageKeyType, value: any) => void\n  }\n}\n\nexport type NextFunction = (action: StorageAction) => Promise<any>\n\nexport type SetupEventsFunction = (api: MiddlewareAPI) => void\n\nexport type Middleware = {\n  name: string\n  setup?: SetupEventsFunction\n  cleanup?: () => Promise<void> | void\n  reducer: (api: MiddlewareAPI) => (next: NextFunction) => (action: StorageAction) => Promise<any>\n}\n\n// Алиасы для явного разделения\nexport type AsyncMiddlewareAPI = MiddlewareAPI\nexport type AsyncNextFunction = NextFunction\nexport type AsyncMiddleware = Middleware\n\n// ─── Sync Middleware Types ─────────────────────────────────────────────────────\n\nexport type SyncMiddlewareAPI = {\n  dispatch: (action: StorageAction) => any\n  getState: () => Record<string, any>\n  storage: {\n    doGet: (key: StorageKeyType) => any\n    doSet: (key: StorageKeyType, value: any) => void\n    doUpdate: (updates: Array<{ key: StorageKeyType; value: any }>) => void\n    doRemove: (key: StorageKeyType) => boolean\n    doClear: () => void\n    doKeys: () => string[]\n    notifySubscribers: (key: StorageKeyType, value: any) => void\n  }\n}\n\nexport type SyncNextFunction = (action: StorageAction) => any\n\nexport type SyncSetupEventsFunction = (api: SyncMiddlewareAPI) => void\n\nexport type SyncMiddleware = {\n  name: string\n  setup?: SyncSetupEventsFunction\n  cleanup?: () => void\n  reducer: (api: SyncMiddlewareAPI) => (next: SyncNextFunction) => (action: StorageAction) => any\n}\n\n// ─── Async Middleware Module ───────────────────────────────────────────────────\n\nexport class AsyncMiddlewareModule {\n  private middlewares: Middleware[] = []\n\n  private api: MiddlewareAPI\n\n  private initialized = false\n\n  private depth = 0\n\n  private dispatchFn!: (action: StorageAction) => Promise<any>\n\n  constructor(storage: any) {\n    this.api = {\n      dispatch: async (action: StorageAction) => this.dispatch(action),\n      getState: () => storage.getState(),\n      storage: {\n        doGet: storage.doGet.bind(storage),\n        doSet: storage.doSet.bind(storage),\n        doUpdate: storage.doUpdate.bind(storage),\n        doDelete: storage.doDelete.bind(storage),\n        doClear: storage.doClear.bind(storage),\n        doKeys: storage.doKeys.bind(storage),\n        notifySubscribers: storage.notifySubscribers.bind(storage),\n      },\n    }\n  }\n\n  private async baseOperation(action: StorageAction): Promise<any> {\n    switch (action.type) {\n      case 'get': {\n        return this.api.storage.doGet(action.key!)\n      }\n\n      case 'set': {\n        await this.api.storage.doSet(action.key!, action.value)\n        return this.api.storage.doGet(action.key!)\n      }\n\n      case 'update': {\n        if (Array.isArray(action.value)) {\n          await this.api.storage.doUpdate(action.value)\n          return this.api.storage.doGet('')\n        }\n        return action.value\n      }\n\n      case 'delete': {\n        return this.api.storage.doDelete(action.key!)\n      }\n\n      case 'clear': {\n        return this.api.storage.doClear()\n      }\n\n      case 'reset': {\n        if (action.value) {\n          await this.api.storage.doClear()\n          await this.api.storage.doSet('', action.value)\n          return this.api.storage.doGet('')\n        }\n        return this.api.storage.doClear()\n      }\n\n      case 'init': {\n        const currentState = await this.api.storage.doGet('')\n        if (Object.keys(currentState || {}).length > 0) {\n          return currentState\n        }\n        if (action.value) {\n          await this.api.storage.doSet('', action.value)\n          return this.api.storage.doGet('')\n        }\n        return currentState\n      }\n\n      case 'keys': {\n        return this.api.storage.doKeys()\n      }\n\n      default: {\n        throw new Error(`Unknown action type: ${action.type}`)\n      }\n    }\n  }\n\n  private initializeMiddlewares() {\n    if (this.initialized) return\n\n    let chain = this.baseOperation.bind(this)\n\n    for (const middleware of [...this.middlewares].reverse()) {\n      const nextChain = chain\n      chain = async (action) => {\n        const actionWithMeta = {\n          ...action,\n          metadata: {\n            ...action.metadata,\n            timestamp: action.metadata?.timestamp || Date.now(),\n          },\n        }\n\n        return middleware.reducer(this.api)(nextChain)(actionWithMeta)\n      }\n    }\n\n    this.dispatchFn = chain\n    this.initialized = true\n  }\n\n  use(middleware: Middleware): void {\n    if (middleware.setup) {\n      middleware.setup(this.api)\n    }\n\n    this.middlewares.push(middleware)\n    this.initialized = false\n  }\n\n  async dispatch(action: StorageAction): Promise<any> {\n    if (!this.initialized) {\n      this.initializeMiddlewares()\n    }\n\n    this.depth++\n    try {\n      return await this.dispatchFn(action)\n    } catch (error) {\n      handleOperationError('AsyncMiddlewareModule: error in middleware chain', error)\n    } finally {\n      this.depth--\n    }\n  }\n}\n\n/** @deprecated Use AsyncMiddlewareModule */\nexport class MiddlewareModule extends AsyncMiddlewareModule {}\n\n// ─── Sync Middleware Module ────────────────────────────────────────────────────\n\nexport class SyncMiddlewareModule {\n  private middlewares: SyncMiddleware[] = []\n\n  private api: SyncMiddlewareAPI\n\n  private initialized = false\n\n  private depth = 0\n\n  private dispatchFn!: (action: StorageAction) => any\n\n  constructor(storage: any) {\n    this.api = {\n      dispatch: (action: StorageAction) => this.dispatch(action),\n      getState: () => storage.getState(),\n      storage: {\n        doGet: storage.doGet.bind(storage),\n        doSet: storage.doSet.bind(storage),\n        doUpdate: storage.doUpdate.bind(storage),\n        doRemove: storage.doRemove.bind(storage),\n        doClear: storage.doClear.bind(storage),\n        doKeys: storage.doKeys.bind(storage),\n        notifySubscribers: storage.notifySubscribers.bind(storage),\n      },\n    }\n  }\n\n  private baseOperation(action: StorageAction): any {\n    switch (action.type) {\n      case 'get': {\n        return this.api.storage.doGet(action.key!)\n      }\n\n      case 'set': {\n        this.api.storage.doSet(action.key!, action.value)\n        return this.api.storage.doGet(action.key!)\n      }\n\n      case 'update': {\n        if (Array.isArray(action.value)) {\n          this.api.storage.doUpdate(action.value)\n          return this.api.storage.doGet('')\n        }\n        return action.value\n      }\n\n      case 'delete': {\n        return this.api.storage.doRemove(action.key!)\n      }\n\n      case 'clear': {\n        return this.api.storage.doClear()\n      }\n\n      case 'reset': {\n        if (action.value) {\n          this.api.storage.doClear()\n          this.api.storage.doSet('', action.value)\n          return this.api.storage.doGet('')\n        }\n        return this.api.storage.doClear()\n      }\n\n      case 'init': {\n        const currentState = this.api.storage.doGet('')\n        if (Object.keys(currentState || {}).length > 0) {\n          return currentState\n        }\n        if (action.value) {\n          this.api.storage.doSet('', action.value)\n          return this.api.storage.doGet('')\n        }\n        return currentState\n      }\n\n      case 'keys': {\n        return this.api.storage.doKeys()\n      }\n\n      default: {\n        throw new Error(`Unknown action type: ${action.type}`)\n      }\n    }\n  }\n\n  private initializeMiddlewares() {\n    if (this.initialized) return\n\n    let chain = this.baseOperation.bind(this)\n\n    for (const middleware of [...this.middlewares].reverse()) {\n      const nextChain = chain\n      chain = (action) => {\n        const actionWithMeta = {\n          ...action,\n          metadata: {\n            ...action.metadata,\n            timestamp: action.metadata?.timestamp || Date.now(),\n          },\n        }\n\n        return middleware.reducer(this.api)(nextChain)(actionWithMeta)\n      }\n    }\n\n    this.dispatchFn = chain\n    this.initialized = true\n  }\n\n  use(middleware: SyncMiddleware): void {\n    if (middleware.setup) {\n      middleware.setup(this.api)\n    }\n\n    this.middlewares.push(middleware)\n    this.initialized = false\n  }\n\n  dispatch(action: StorageAction): any {\n    if (!this.initialized) {\n      this.initializeMiddlewares()\n    }\n\n    this.depth++\n    try {\n      return this.dispatchFn(action)\n    } catch (error) {\n      handleOperationError('SyncMiddlewareModule: error in middleware chain', error)\n    } finally {\n      this.depth--\n    }\n  }\n}\n"],"names":["handleOperationError","VALUE_NOT_CHANGED","Symbol","AsyncMiddlewareModule","storage","action","Array","currentState","Object","Error","chain","middleware","nextChain","actionWithMeta","Date","error","MiddlewareModule","SyncMiddlewareModule"],"mappings":"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"}

package/dist/core/storage/utils/path-selector.util.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Creates a dummy Proxy state object for path extraction.
+ */
+export declare function createDummyState<T>(): T;
+/**
+ * Extracts the property path from a selector function using Proxy.
+ *
+ * **Limitations:**
+ * - Does not support conditional logic (if/ternary): Proxy records ALL accessed paths
+ *   and returns the longest, which leads to subscription on the wrong path.
+ * - Does not support destructuring or array methods (map, filter, etc.)
+ * - For such cases use string-based subscription: `storage.subscribe('user.permissions', callback)`
+ */
+export declare function extractPath<T>(selector: (state: T) => any, dummyState: T, cache?: WeakMap<(...args: any[]) => any, string>): string;
+//# sourceMappingURL=path-selector.util.d.ts.map

package/dist/core/storage/utils/path-selector.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-selector.util.d.ts","sourceRoot":"","sources":["../../../../src/core/storage/utils/path-selector.util.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,KAAK,CAAC,CAQvC;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,MAAM,CAAC,GAAG,MAAM,CA0CnI"}

package/dist/core/storage/utils/path-selector.util.js

@@ -0,0 +1,58 @@
+/**
+ * Creates a dummy Proxy state object for path extraction.
+ */ function createDummyState() {
+    const handler = {
+        get: (target, prop)=>{
+            target[prop] = target[prop] || new Proxy({}, handler);
+            return target[prop];
+        }
+    };
+    return new Proxy({}, handler);
+}
+/**
+ * Extracts the property path from a selector function using Proxy.
+ *
+ * **Limitations:**
+ * - Does not support conditional logic (if/ternary): Proxy records ALL accessed paths
+ *   and returns the longest, which leads to subscription on the wrong path.
+ * - Does not support destructuring or array methods (map, filter, etc.)
+ * - For such cases use string-based subscription: `storage.subscribe('user.permissions', callback)`
+ */ function extractPath(selector, dummyState, cache) {
+    if (cache?.has(selector)) {
+        return cache.get(selector);
+    }
+    const accessedPaths = [];
+    const createProxyHandler = (path = '')=>({
+            get: (_target, prop)=>{
+                if (typeof prop === 'symbol') {
+                    return Reflect.get(_target, prop);
+                }
+                const currentPath = path ? `${path}.${prop}` : prop;
+                accessedPaths.push(currentPath);
+                return new Proxy({}, createProxyHandler(currentPath));
+            },
+            has: ()=>true,
+            ownKeys: ()=>[],
+            getOwnPropertyDescriptor: ()=>({
+                    configurable: true,
+                    enumerable: true
+                }),
+            apply: ()=>{
+                return new Proxy(()=>{}, createProxyHandler(path));
+            }
+        });
+    try {
+        selector(new Proxy(dummyState, createProxyHandler()));
+    } catch  {
+    // Ignore errors from accessing non-existent properties
+    }
+    if (accessedPaths.length === 0) return '';
+    accessedPaths.sort((a, b)=>b.length - a.length);
+    const result = accessedPaths[0];
+    cache?.set(selector, result);
+    return result;
+}
+
+export { createDummyState, extractPath };
+
+//# sourceMappingURL=path-selector.util.js.map

package/dist/core/storage/utils/path-selector.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core/storage/utils/path-selector.util.js","sources":["../../../../src/core/storage/utils/path-selector.util.ts"],"sourcesContent":["/**\n * Creates a dummy Proxy state object for path extraction.\n */\nexport function createDummyState<T>(): T {\n  const handler: ProxyHandler<any> = {\n    get: (target: any, prop: string) => {\n      target[prop] = target[prop] || new Proxy({}, handler)\n      return target[prop]\n    },\n  }\n  return new Proxy({} as T, handler)\n}\n\n/**\n * Extracts the property path from a selector function using Proxy.\n *\n * **Limitations:**\n * - Does not support conditional logic (if/ternary): Proxy records ALL accessed paths\n *   and returns the longest, which leads to subscription on the wrong path.\n * - Does not support destructuring or array methods (map, filter, etc.)\n * - For such cases use string-based subscription: `storage.subscribe('user.permissions', callback)`\n */\nexport function extractPath<T>(selector: (state: T) => any, dummyState: T, cache?: WeakMap<(...args: any[]) => any, string>): string {\n  if (cache?.has(selector)) {\n    return cache.get(selector)!\n  }\n\n  const accessedPaths: string[] = []\n\n  const createProxyHandler = (path = ''): ProxyHandler<any> => ({\n    get: (_target: any, prop: string) => {\n      if (typeof prop === 'symbol') {\n        return Reflect.get(_target, prop)\n      }\n\n      const currentPath = path ? `${path}.${prop}` : prop\n      accessedPaths.push(currentPath)\n\n      return new Proxy({}, createProxyHandler(currentPath))\n    },\n    has: () => true,\n    ownKeys: () => [],\n    getOwnPropertyDescriptor: () => ({\n      configurable: true,\n      enumerable: true,\n    }),\n    apply: () => {\n      return new Proxy(() => {}, createProxyHandler(path))\n    },\n  })\n\n  try {\n    selector(new Proxy(dummyState, createProxyHandler()))\n  } catch {\n    // Ignore errors from accessing non-existent properties\n  }\n\n  if (accessedPaths.length === 0) return ''\n\n  accessedPaths.sort((a, b) => b.length - a.length)\n\n  const result = accessedPaths[0]\n  cache?.set(selector, result)\n  return result\n}\n"],"names":["createDummyState","handler","target","prop","Proxy","extractPath","selector","dummyState","cache","accessedPaths","createProxyHandler","path","_target","Reflect","currentPath","a","b","result"],"mappings":"AAAA;;CAEC,GACM,SAASA,gBAAgBA;IAC9B,MAAMC,UAA6B;QACjC,KAAK,CAACC,QAAaC;YACjBD,MAAM,CAACC,KAAK,GAAGD,MAAM,CAACC,KAAK,IAAI,IAAIC,MAAM,CAAC,GAAGH;YAC7C,OAAOC,MAAM,CAACC,KAAK;QACrB;IACF;IACA,OAAO,IAAIC,MAAM,CAAC,GAAQH;AAC5B;AAEA;;;;;;;;CAQC,GACM,SAASI,WAAWA,CAAIC,QAA2B,EAAEC,UAAa,EAAEC,KAAgD;IACzH,IAAIA,OAAO,IAAIF,WAAW;QACxB,OAAOE,MAAM,GAAG,CAACF;IACnB;IAEA,MAAMG,gBAA0B,EAAE;IAElC,MAAMC,qBAAqB,CAACC,OAAO,EAAE,GAAyB;YAC5D,KAAK,CAACC,SAAcT;gBAClB,IAAI,OAAOA,SAAS,UAAU;oBAC5B,OAAOU,QAAQ,GAAG,CAACD,SAAST;gBAC9B;gBAEA,MAAMW,cAAcH,OAAO,GAAGA,KAAK,CAAC,EAAER,MAAM,GAAGA;gBAC/CM,cAAc,IAAI,CAACK;gBAEnB,OAAO,IAAIV,MAAM,CAAC,GAAGM,mBAAmBI;YAC1C;YACA,KAAK,IAAM;YACX,SAAS,IAAM,EAAE;YACjB,0BAA0B,IAAO;oBAC/B,cAAc;oBACd,YAAY;gBACd;YACA,OAAO;gBACL,OAAO,IAAIV,MAAM,KAAO,GAAGM,mBAAmBC;YAChD;QACF;IAEA,IAAI;QACFL,SAAS,IAAIF,MAAMG,YAAYG;IACjC,EAAE,OAAM;IACN,uDAAuD;IACzD;IAEA,IAAID,cAAc,MAAM,KAAK,GAAG,OAAO;IAEvCA,cAAc,IAAI,CAAC,CAACM,GAAGC,IAAMA,EAAE,MAAM,GAAGD,EAAE,MAAM;IAEhD,MAAME,SAASR,aAAa,CAAC,EAAE;IAC/BD,OAAO,IAAIF,UAAUW;IACrB,OAAOA;AACT"}

package/dist/core/storage/utils/state-diff.util.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Deep equality check for two values.
+ */
+export declare function isEqual(a: any, b: any): boolean;
+/**
+ * Finds all changed paths between two objects.
+ */
+export declare function findChangedPaths(oldObj: any, newObj: any, prefix?: string, changedPaths?: Set<string>, visited?: WeakMap<any, boolean>): Set<string>;
+/**
+ * Creates a lazy deep-clone of an object.
+ * Shallow copy initially, structuredClone on first nested property access.
+ */
+export declare function createLazyClone<T extends Record<string, any>>(source: T): T;
+//# sourceMappingURL=state-diff.util.d.ts.map

package/dist/core/storage/utils/state-diff.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-diff.util.d.ts","sourceRoot":"","sources":["../../../../src/core/storage/utils/state-diff.util.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,GAAG,OAAO,CA0B/C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,SAAK,EAAE,YAAY,GAAE,GAAG,CAAC,MAAM,CAAqB,EAAE,OAAO,wBAA8B,GAAG,GAAG,CAAC,MAAM,CAAC,CAkCzK;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAsB3E"}

package/dist/core/storage/utils/state-diff.util.js

@@ -0,0 +1,88 @@
+/**
+ * Deep equality check for two values.
+ */ function isEqual(a, b) {
+    if (a === b) return true;
+    if (a == null || b == null) return a === b;
+    const typeA = typeof a;
+    const typeB = typeof b;
+    if (typeA !== typeB) return false;
+    if (typeA !== 'object') return a === b;
+    if (a instanceof Date && b instanceof Date) {
+        return a.getTime() === b.getTime();
+    }
+    if (Array.isArray(a) && Array.isArray(b)) {
+        if (a.length !== b.length) return false;
+        for(let i = 0; i < a.length; i++){
+            if (!isEqual(a[i], b[i])) return false;
+        }
+        return true;
+    }
+    const keysA = Object.keys(a);
+    const keysB = Object.keys(b);
+    if (keysA.length !== keysB.length) return false;
+    return keysA.every((key)=>Object.prototype.hasOwnProperty.call(b, key) && isEqual(a[key], b[key]));
+}
+/**
+ * Finds all changed paths between two objects.
+ */ function findChangedPaths(oldObj, newObj, prefix = '', changedPaths = new Set(), visited = new WeakMap()) {
+    if (oldObj === newObj) return changedPaths;
+    if (typeof oldObj !== 'object' || typeof newObj !== 'object' || oldObj === null || newObj === null) {
+        if (oldObj !== newObj) {
+            changedPaths.add(prefix || '');
+        }
+        return changedPaths;
+    }
+    if (visited.has(oldObj)) return changedPaths;
+    visited.set(oldObj, true);
+    const allKeys = new Set([
+        ...Object.keys(oldObj || {}),
+        ...Object.keys(newObj || {})
+    ]);
+    for (const key of allKeys){
+        const oldValue = oldObj[key];
+        const newValue = newObj[key];
+        if (oldValue === newValue) continue;
+        const path = prefix ? `${prefix}.${key}` : key;
+        if (oldValue && newValue && typeof oldValue === 'object' && typeof newValue === 'object' && !Array.isArray(oldValue) && !Array.isArray(newValue)) {
+            findChangedPaths(oldValue, newValue, path, changedPaths, visited);
+        } else if (Array.isArray(oldValue) && Array.isArray(newValue)) {
+            if (!isEqual(oldValue, newValue)) {
+                changedPaths.add(path);
+            }
+        } else if (!isEqual(oldValue, newValue)) {
+            changedPaths.add(path);
+        }
+    }
+    return changedPaths;
+}
+/**
+ * Creates a lazy deep-clone of an object.
+ * Shallow copy initially, structuredClone on first nested property access.
+ */ function createLazyClone(source) {
+    const cloned = new Set();
+    const shallow = {
+        ...source
+    };
+    return new Proxy(shallow, {
+        get (target, prop, receiver) {
+            if (typeof prop === 'string' && !cloned.has(prop)) {
+                const val = target[prop];
+                if (val !== null && typeof val === 'object') {
+                    cloned.add(prop);
+                    target[prop] = structuredClone(val);
+                }
+            }
+            return Reflect.get(target, prop, receiver);
+        },
+        set (target, prop, value) {
+            if (typeof prop === 'string') {
+                cloned.add(prop);
+            }
+            return Reflect.set(target, prop, value);
+        }
+    });
+}
+
+export { createLazyClone, findChangedPaths, isEqual };
+
+//# sourceMappingURL=state-diff.util.js.map

package/dist/core/storage/utils/state-diff.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core/storage/utils/state-diff.util.js","sources":["../../../../src/core/storage/utils/state-diff.util.ts"],"sourcesContent":["/**\n * Deep equality check for two values.\n */\nexport function isEqual(a: any, b: any): boolean {\n  if (a === b) return true\n  if (a == null || b == null) return a === b\n\n  const typeA = typeof a\n  const typeB = typeof b\n  if (typeA !== typeB) return false\n  if (typeA !== 'object') return a === b\n\n  if (a instanceof Date && b instanceof Date) {\n    return a.getTime() === b.getTime()\n  }\n\n  if (Array.isArray(a) && Array.isArray(b)) {\n    if (a.length !== b.length) return false\n    for (let i = 0; i < a.length; i++) {\n      if (!isEqual(a[i], b[i])) return false\n    }\n    return true\n  }\n\n  const keysA = Object.keys(a)\n  const keysB = Object.keys(b)\n  if (keysA.length !== keysB.length) return false\n\n  return keysA.every((key) => Object.prototype.hasOwnProperty.call(b, key) && isEqual(a[key], b[key]))\n}\n\n/**\n * Finds all changed paths between two objects.\n */\nexport function findChangedPaths(oldObj: any, newObj: any, prefix = '', changedPaths: Set<string> = new Set<string>(), visited = new WeakMap<any, boolean>()): Set<string> {\n  if (oldObj === newObj) return changedPaths\n\n  if (typeof oldObj !== 'object' || typeof newObj !== 'object' || oldObj === null || newObj === null) {\n    if (oldObj !== newObj) {\n      changedPaths.add(prefix || '')\n    }\n    return changedPaths\n  }\n\n  if (visited.has(oldObj)) return changedPaths\n  visited.set(oldObj, true)\n\n  const allKeys = new Set([...Object.keys(oldObj || {}), ...Object.keys(newObj || {})])\n\n  for (const key of allKeys) {\n    const oldValue = oldObj[key]\n    const newValue = newObj[key]\n    if (oldValue === newValue) continue\n\n    const path = prefix ? `${prefix}.${key}` : key\n\n    if (oldValue && newValue && typeof oldValue === 'object' && typeof newValue === 'object' && !Array.isArray(oldValue) && !Array.isArray(newValue)) {\n      findChangedPaths(oldValue, newValue, path, changedPaths, visited)\n    } else if (Array.isArray(oldValue) && Array.isArray(newValue)) {\n      if (!isEqual(oldValue, newValue)) {\n        changedPaths.add(path)\n      }\n    } else if (!isEqual(oldValue, newValue)) {\n      changedPaths.add(path)\n    }\n  }\n\n  return changedPaths\n}\n\n/**\n * Creates a lazy deep-clone of an object.\n * Shallow copy initially, structuredClone on first nested property access.\n */\nexport function createLazyClone<T extends Record<string, any>>(source: T): T {\n  const cloned = new Set<string>()\n  const shallow = { ...source }\n\n  return new Proxy(shallow, {\n    get(target, prop, receiver) {\n      if (typeof prop === 'string' && !cloned.has(prop)) {\n        const val = target[prop as keyof typeof target]\n        if (val !== null && typeof val === 'object') {\n          cloned.add(prop)\n          ;(target as any)[prop] = structuredClone(val)\n        }\n      }\n      return Reflect.get(target, prop, receiver)\n    },\n    set(target, prop, value) {\n      if (typeof prop === 'string') {\n        cloned.add(prop)\n      }\n      return Reflect.set(target, prop, value)\n    },\n  }) as T\n}\n"],"names":["isEqual","a","b","typeA","typeB","Date","Array","i","keysA","Object","keysB","key","findChangedPaths","oldObj","newObj","prefix","changedPaths","Set","visited","WeakMap","allKeys","oldValue","newValue","path","createLazyClone","source","cloned","shallow","Proxy","target","prop","receiver","val","structuredClone","Reflect","value"],"mappings":"AAAA;;CAEC,GACM,SAASA,OAAOA,CAACC,CAAM,EAAEC,CAAM;IACpC,IAAID,MAAMC,GAAG,OAAO;IACpB,IAAID,KAAK,QAAQC,KAAK,MAAM,OAAOD,MAAMC;IAEzC,MAAMC,QAAQ,OAAOF;IACrB,MAAMG,QAAQ,OAAOF;IACrB,IAAIC,UAAUC,OAAO,OAAO;IAC5B,IAAID,UAAU,UAAU,OAAOF,MAAMC;IAErC,IAAID,aAAaI,QAAQH,aAAaG,MAAM;QAC1C,OAAOJ,EAAE,OAAO,OAAOC,EAAE,OAAO;IAClC;IAEA,IAAII,MAAM,OAAO,CAACL,MAAMK,MAAM,OAAO,CAACJ,IAAI;QACxC,IAAID,EAAE,MAAM,KAAKC,EAAE,MAAM,EAAE,OAAO;QAClC,IAAK,IAAIK,IAAI,GAAGA,IAAIN,EAAE,MAAM,EAAEM,IAAK;YACjC,IAAI,CAACP,OAAOA,CAACC,CAAC,CAACM,EAAE,EAAEL,CAAC,CAACK,EAAE,GAAG,OAAO;QACnC;QACA,OAAO;IACT;IAEA,MAAMC,QAAQC,OAAO,IAAI,CAACR;IAC1B,MAAMS,QAAQD,OAAO,IAAI,CAACP;IAC1B,IAAIM,MAAM,MAAM,KAAKE,MAAM,MAAM,EAAE,OAAO;IAE1C,OAAOF,MAAM,KAAK,CAAC,CAACG,MAAQF,OAAO,SAAS,CAAC,cAAc,CAAC,IAAI,CAACP,GAAGS,QAAQX,OAAOA,CAACC,CAAC,CAACU,IAAI,EAAET,CAAC,CAACS,IAAI;AACpG;AAEA;;CAEC,GACM,SAASC,gBAAgBA,CAACC,MAAW,EAAEC,MAAW,EAAEC,SAAS,EAAE,EAAEC,eAA4B,IAAIC,KAAa,EAAEC,UAAU,IAAIC,SAAuB;IAC1J,IAAIN,WAAWC,QAAQ,OAAOE;IAE9B,IAAI,OAAOH,WAAW,YAAY,OAAOC,WAAW,YAAYD,WAAW,QAAQC,WAAW,MAAM;QAClG,IAAID,WAAWC,QAAQ;YACrBE,aAAa,GAAG,CAACD,UAAU;QAC7B;QACA,OAAOC;IACT;IAEA,IAAIE,QAAQ,GAAG,CAACL,SAAS,OAAOG;IAChCE,QAAQ,GAAG,CAACL,QAAQ;IAEpB,MAAMO,UAAU,IAAIH,IAAI;WAAIR,OAAO,IAAI,CAACI,UAAU,CAAC;WAAOJ,OAAO,IAAI,CAACK,UAAU,CAAC;KAAG;IAEpF,KAAK,MAAMH,OAAOS,QAAS;QACzB,MAAMC,WAAWR,MAAM,CAACF,IAAI;QAC5B,MAAMW,WAAWR,MAAM,CAACH,IAAI;QAC5B,IAAIU,aAAaC,UAAU;QAE3B,MAAMC,OAAOR,SAAS,GAAGA,OAAO,CAAC,EAAEJ,KAAK,GAAGA;QAE3C,IAAIU,YAAYC,YAAY,OAAOD,aAAa,YAAY,OAAOC,aAAa,YAAY,CAAChB,MAAM,OAAO,CAACe,aAAa,CAACf,MAAM,OAAO,CAACgB,WAAW;YAChJV,gBAAgBA,CAACS,UAAUC,UAAUC,MAAMP,cAAcE;QAC3D,OAAO,IAAIZ,MAAM,OAAO,CAACe,aAAaf,MAAM,OAAO,CAACgB,WAAW;YAC7D,IAAI,CAACtB,OAAOA,CAACqB,UAAUC,WAAW;gBAChCN,aAAa,GAAG,CAACO;YACnB;QACF,OAAO,IAAI,CAACvB,OAAOA,CAACqB,UAAUC,WAAW;YACvCN,aAAa,GAAG,CAACO;QACnB;IACF;IAEA,OAAOP;AACT;AAEA;;;CAGC,GACM,SAASQ,eAAeA,CAAgCC,MAAS;IACtE,MAAMC,SAAS,IAAIT;IACnB,MAAMU,UAAU;QAAE,GAAGF,MAAM;IAAC;IAE5B,OAAO,IAAIG,MAAMD,SAAS;QACxB,KAAIE,MAAM,EAAEC,IAAI,EAAEC,QAAQ;YACxB,IAAI,OAAOD,SAAS,YAAY,CAACJ,OAAO,GAAG,CAACI,OAAO;gBACjD,MAAME,MAAMH,MAAM,CAACC,KAA4B;gBAC/C,IAAIE,QAAQ,QAAQ,OAAOA,QAAQ,UAAU;oBAC3CN,OAAO,GAAG,CAACI;oBACTD,MAAc,CAACC,KAAK,GAAGG,gBAAgBD;gBAC3C;YACF;YACA,OAAOE,QAAQ,GAAG,CAACL,QAAQC,MAAMC;QACnC;QACA,KAAIF,MAAM,EAAEC,IAAI,EAAEK,KAAK;YACrB,IAAI,OAAOL,SAAS,UAAU;gBAC5BJ,OAAO,GAAG,CAACI;YACb;YACA,OAAOI,QAAQ,GAAG,CAACL,QAAQC,MAAMK;QACnC;IACF;AACF"}

package/dist/core/storage/utils/storage-factory.util.d.ts

@@ -0,0 +1,21 @@
+import { IndexedDBStorage } from '../adapters/indexed-DB.service';
+import { LocalStorage } from '../adapters/local-storage.service';
+import { MemoryStorage } from '../adapters/memory-storage.service';
+import { IAsyncPluginExecutor, ISyncPluginExecutor } from '../modules/plugin/plugin.interface';
+import { IAsyncStorage, IEventEmitter, ILogger, IndexedDBStorageConfig, IStorage, ISyncStorage, LocalStorageConfig, MemoryStorageConfig, UniversalStorageConfig } from '../storage.interface';
+export declare class StorageFactory {
+    static createMemory<T extends Record<string, any>>(config: MemoryStorageConfig<T>, pluginExecutor?: ISyncPluginExecutor, eventEmitter?: IEventEmitter, logger?: ILogger): MemoryStorage<T>;
+    static createLocal<T extends Record<string, any>>(config: LocalStorageConfig<T>, pluginExecutor?: ISyncPluginExecutor, eventEmitter?: IEventEmitter, logger?: ILogger): LocalStorage<T>;
+    static createIndexedDB<T extends Record<string, any>>(config: IndexedDBStorageConfig<T>, pluginExecutor?: IAsyncPluginExecutor, eventEmitter?: IEventEmitter, logger?: ILogger): IndexedDBStorage<T>;
+    static create<T extends Record<string, any>>(config: UniversalStorageConfig<T> & {
+        type: 'memory';
+    }, pluginExecutor?: ISyncPluginExecutor, eventEmitter?: IEventEmitter, logger?: ILogger): ISyncStorage<T>;
+    static create<T extends Record<string, any>>(config: UniversalStorageConfig<T> & {
+        type: 'localStorage';
+    }, pluginExecutor?: ISyncPluginExecutor, eventEmitter?: IEventEmitter, logger?: ILogger): ISyncStorage<T>;
+    static create<T extends Record<string, any>>(config: UniversalStorageConfig<T> & {
+        type: 'indexedDB';
+    }, pluginExecutor?: IAsyncPluginExecutor, eventEmitter?: IEventEmitter, logger?: ILogger): IAsyncStorage<T>;
+    static create<T extends Record<string, any>>(config: UniversalStorageConfig<T>, pluginExecutor?: ISyncPluginExecutor | IAsyncPluginExecutor, eventEmitter?: IEventEmitter, logger?: ILogger): IStorage<T>;
+}
+//# sourceMappingURL=storage-factory.util.d.ts.map

package/dist/core/storage/utils/storage-factory.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-factory.util.d.ts","sourceRoot":"","sources":["../../../../src/core/storage/utils/storage-factory.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAA;AAClE,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAA;AAC9F,OAAO,EACL,aAAa,EACb,aAAa,EACb,OAAO,EACP,sBAAsB,EACtB,QAAQ,EACR,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,sBAAsB,CAAA;AAE7B,qBAAa,cAAc;IACzB,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/C,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAC9B,cAAc,CAAC,EAAE,mBAAmB,EACpC,YAAY,CAAC,EAAE,aAAa,EAC5B,MAAM,CAAC,EAAE,OAAO,GACf,aAAa,CAAC,CAAC,CAAC;IAInB,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC9C,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC7B,cAAc,CAAC,EAAE,mBAAmB,EACpC,YAAY,CAAC,EAAE,aAAa,EAC5B,MAAM,CAAC,EAAE,OAAO,GACf,YAAY,CAAC,CAAC,CAAC;IAIlB,MAAM,CAAC,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAClD,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC,EACjC,cAAc,CAAC,EAAE,oBAAoB,EACrC,YAAY,CAAC,EAAE,aAAa,EAC5B,MAAM,CAAC,EAAE,OAAO,GACf,gBAAgB,CAAC,CAAC,CAAC;IAMtB,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,EACtD,cAAc,CAAC,EAAE,mBAAmB,EACpC,YAAY,CAAC,EAAE,aAAa,EAC5B,MAAM,CAAC,EAAE,OAAO,GACf,YAAY,CAAC,CAAC,CAAC;IAElB,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG;QAAE,IAAI,EAAE,cAAc,CAAA;KAAE,EAC5D,cAAc,CAAC,EAAE,mBAAmB,EACpC,YAAY,CAAC,EAAE,aAAa,EAC5B,MAAM,CAAC,EAAE,OAAO,GACf,YAAY,CAAC,CAAC,CAAC;IAElB,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,EACzD,cAAc,CAAC,EAAE,oBAAoB,EACrC,YAAY,CAAC,EAAE,aAAa,EAC5B,MAAM,CAAC,EAAE,OAAO,GACf,aAAa,CAAC,CAAC,CAAC;IAEnB,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC,EACjC,cAAc,CAAC,EAAE,mBAAmB,GAAG,oBAAoB,EAC3D,YAAY,CAAC,EAAE,aAAa,EAC5B,MAAM,CAAC,EAAE,OAAO,GACf,QAAQ,CAAC,CAAC,CAAC;CAsBf"}

package/dist/core/storage/utils/storage-factory.util.js

@@ -0,0 +1,40 @@
+import { IndexedDBStorage } from "../adapters/indexed-DB.service.js";
+import { LocalStorage } from "../adapters/local-storage.service.js";
+import { MemoryStorage } from "../adapters/memory-storage.service.js";
+
+
+
+
+
+
+
+class StorageFactory {
+    static createMemory(config, pluginExecutor, eventEmitter, logger) {
+        return MemoryStorage.create(config, pluginExecutor, eventEmitter, logger);
+    }
+    static createLocal(config, pluginExecutor, eventEmitter, logger) {
+        return LocalStorage.create(config, pluginExecutor, eventEmitter, logger);
+    }
+    static createIndexedDB(config, pluginExecutor, eventEmitter, logger) {
+        return IndexedDBStorage.create(config, pluginExecutor, eventEmitter, logger);
+    }
+    // ─── Реализация ─────────────────────────────────────────────────────────────
+    static create(config, pluginExecutor, eventEmitter, logger) {
+        switch(config.type){
+            case 'memory':
+                return this.createMemory(config, pluginExecutor, eventEmitter, logger);
+            case 'localStorage':
+                return this.createLocal(config, pluginExecutor, eventEmitter, logger);
+            case 'indexedDB':
+                return this.createIndexedDB(config, pluginExecutor, eventEmitter, logger);
+            default:
+                {
+                    throw new Error(`Unsupported storage type: ${config.type}`);
+                }
+        }
+    }
+}
+
+export { StorageFactory };
+
+//# sourceMappingURL=storage-factory.util.js.map

package/dist/core/storage/utils/storage-factory.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core/storage/utils/storage-factory.util.js","sources":["../../../../src/core/storage/utils/storage-factory.util.ts"],"sourcesContent":["import { IndexedDBStorage } from '../adapters/indexed-DB.service'\nimport { LocalStorage } from '../adapters/local-storage.service'\nimport { MemoryStorage } from '../adapters/memory-storage.service'\nimport { IAsyncPluginExecutor, ISyncPluginExecutor } from '../modules/plugin/plugin.interface'\nimport {\n  IAsyncStorage,\n  IEventEmitter,\n  ILogger,\n  IndexedDBStorageConfig,\n  IStorage,\n  ISyncStorage,\n  LocalStorageConfig,\n  MemoryStorageConfig,\n  UniversalStorageConfig,\n} from '../storage.interface'\n\nexport class StorageFactory {\n  static createMemory<T extends Record<string, any>>(\n    config: MemoryStorageConfig<T>,\n    pluginExecutor?: ISyncPluginExecutor,\n    eventEmitter?: IEventEmitter,\n    logger?: ILogger,\n  ): MemoryStorage<T> {\n    return MemoryStorage.create<T>(config, pluginExecutor, eventEmitter, logger)\n  }\n\n  static createLocal<T extends Record<string, any>>(\n    config: LocalStorageConfig<T>,\n    pluginExecutor?: ISyncPluginExecutor,\n    eventEmitter?: IEventEmitter,\n    logger?: ILogger,\n  ): LocalStorage<T> {\n    return LocalStorage.create<T>(config, pluginExecutor, eventEmitter, logger)\n  }\n\n  static createIndexedDB<T extends Record<string, any>>(\n    config: IndexedDBStorageConfig<T>,\n    pluginExecutor?: IAsyncPluginExecutor,\n    eventEmitter?: IEventEmitter,\n    logger?: ILogger,\n  ): IndexedDBStorage<T> {\n    return IndexedDBStorage.create<T>(config, pluginExecutor, eventEmitter, logger)\n  }\n\n  // ─── Перегрузки для правильного вывода типов ────────────────────────────────\n\n  static create<T extends Record<string, any>>(\n    config: UniversalStorageConfig<T> & { type: 'memory' },\n    pluginExecutor?: ISyncPluginExecutor,\n    eventEmitter?: IEventEmitter,\n    logger?: ILogger,\n  ): ISyncStorage<T>\n\n  static create<T extends Record<string, any>>(\n    config: UniversalStorageConfig<T> & { type: 'localStorage' },\n    pluginExecutor?: ISyncPluginExecutor,\n    eventEmitter?: IEventEmitter,\n    logger?: ILogger,\n  ): ISyncStorage<T>\n\n  static create<T extends Record<string, any>>(\n    config: UniversalStorageConfig<T> & { type: 'indexedDB' },\n    pluginExecutor?: IAsyncPluginExecutor,\n    eventEmitter?: IEventEmitter,\n    logger?: ILogger,\n  ): IAsyncStorage<T>\n\n  static create<T extends Record<string, any>>(\n    config: UniversalStorageConfig<T>,\n    pluginExecutor?: ISyncPluginExecutor | IAsyncPluginExecutor,\n    eventEmitter?: IEventEmitter,\n    logger?: ILogger,\n  ): IStorage<T>\n\n  // ─── Реализация ─────────────────────────────────────────────────────────────\n\n  static create<T extends Record<string, any>>(\n    config: UniversalStorageConfig<T>,\n    pluginExecutor?: ISyncPluginExecutor | IAsyncPluginExecutor,\n    eventEmitter?: IEventEmitter,\n    logger?: ILogger,\n  ): IStorage<T> {\n    switch (config.type) {\n      case 'memory':\n        return this.createMemory<T>(config as MemoryStorageConfig<T>, pluginExecutor as ISyncPluginExecutor, eventEmitter, logger)\n      case 'localStorage':\n        return this.createLocal<T>(config as LocalStorageConfig<T>, pluginExecutor as ISyncPluginExecutor, eventEmitter, logger)\n      case 'indexedDB':\n        return this.createIndexedDB<T>(config as IndexedDBStorageConfig<T>, pluginExecutor as IAsyncPluginExecutor, eventEmitter, logger)\n      default: {\n        throw new Error(`Unsupported storage type: ${(config as any).type}`)\n      }\n    }\n  }\n}\n"],"names":["IndexedDBStorage","LocalStorage","MemoryStorage","StorageFactory","config","pluginExecutor","eventEmitter","logger","Error"],"mappings":";;;;;;;AAAiE;AACD;AACE;AAc3D,MAAMG,cAAcA;IACzB,OAAO,aACLC,MAA8B,EAC9BC,cAAoC,EACpCC,YAA4B,EAC5BC,MAAgB,EACE;QAClB,OAAOL,oBAAoB,CAAIE,QAAQC,gBAAgBC,cAAcC;IACvE;IAEA,OAAO,YACLH,MAA6B,EAC7BC,cAAoC,EACpCC,YAA4B,EAC5BC,MAAgB,EACC;QACjB,OAAON,mBAAmB,CAAIG,QAAQC,gBAAgBC,cAAcC;IACtE;IAEA,OAAO,gBACLH,MAAiC,EACjCC,cAAqC,EACrCC,YAA4B,EAC5BC,MAAgB,EACK;QACrB,OAAOP,uBAAuB,CAAII,QAAQC,gBAAgBC,cAAcC;IAC1E;IAgCA,+EAA+E;IAE/E,OAAO,OACLH,MAAiC,EACjCC,cAA2D,EAC3DC,YAA4B,EAC5BC,MAAgB,EACH;QACb,OAAQH,OAAO,IAAI;YACjB,KAAK;gBACH,OAAO,IAAI,CAAC,YAAY,CAAIA,QAAkCC,gBAAuCC,cAAcC;YACrH,KAAK;gBACH,OAAO,IAAI,CAAC,WAAW,CAAIH,QAAiCC,gBAAuCC,cAAcC;YACnH,KAAK;gBACH,OAAO,IAAI,CAAC,eAAe,CAAIH,QAAqCC,gBAAwCC,cAAcC;YAC5H;gBAAS;oBACP,MAAM,IAAIC,MAAM,CAAC,0BAA0B,EAAGJ,OAAe,IAAI,EAAE;gBACrE;QACF;IACF;AACF"}

package/dist/core/storage/utils/storage-key.d.ts

@@ -0,0 +1,11 @@
+export declare class StorageKey {
+    private readonly value;
+    private readonly isRawKey;
+    constructor(value: string, isRawKey?: boolean);
+    toString(): string;
+    toJSON(): string;
+    valueOf(): string;
+    isUnparseable(): boolean;
+}
+export type StorageKeyType = string | StorageKey;
+//# sourceMappingURL=storage-key.d.ts.map

package/dist/core/storage/utils/storage-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-key.d.ts","sourceRoot":"","sources":["../../../../src/core/storage/utils/storage-key.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAU;IAEnB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBADR,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,OAAe;IAG5C,QAAQ,IAAI,MAAM;IAIlB,MAAM,IAAI,MAAM;IAIhB,OAAO,IAAI,MAAM;IAIjB,aAAa,IAAI,OAAO;CAGzB;AAGD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,CAAA"}

package/dist/core/storage/utils/storage-key.js

@@ -0,0 +1,24 @@
+class StorageKey {
+    value;
+    isRawKey;
+    constructor(value, isRawKey = false){
+        this.value = value;
+        this.isRawKey = isRawKey;
+    }
+    toString() {
+        return this.value;
+    }
+    toJSON() {
+        return this.value;
+    }
+    valueOf() {
+        return this.value;
+    }
+    isUnparseable() {
+        return this.isRawKey;
+    }
+}
+
+export { StorageKey };
+
+//# sourceMappingURL=storage-key.js.map

package/dist/core/storage/utils/storage-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core/storage/utils/storage-key.js","sources":["../../../../src/core/storage/utils/storage-key.ts"],"sourcesContent":["export class StorageKey {\n  constructor(\n    private readonly value: string,\n    private readonly isRawKey: boolean = false,\n  ) {}\n\n  toString(): string {\n    return this.value\n  }\n\n  toJSON(): string {\n    return this.value\n  }\n\n  valueOf(): string {\n    return this.value\n  }\n\n  isUnparseable(): boolean {\n    return this.isRawKey\n  }\n}\n\n// Тип, который может быть либо строкой, либо StorageKey\nexport type StorageKeyType = string | StorageKey\n"],"names":["StorageKey","value","isRawKey"],"mappings":"AAAO,MAAMA,UAAUA;;;IACrB,YACmBC,KAAa,EACbC,WAAoB,KAAK,CAC1C;aAFiBD,QAAAA;aACAC,WAAAA;IAChB;IAEH,WAAmB;QACjB,OAAO,IAAI,CAAC,KAAK;IACnB;IAEA,SAAiB;QACf,OAAO,IAAI,CAAC,KAAK;IACnB;IAEA,UAAkB;QAChB,OAAO,IAAI,CAAC,KAAK;IACnB;IAEA,gBAAyB;QACvB,OAAO,IAAI,CAAC,QAAQ;IACtB;AACF"}