@ngxs/storage-plugin 21.0.0 → 22.0.0

package/fesm2022/ngxs-storage-plugin-internals.mjs

@@ -15,7 +15,6 @@ var StorageOption;
 const ɵUSER_OPTIONS = new InjectionToken(typeof ngDevMode !== 'undefined' && ngDevMode ? 'USER_OPTIONS' : '');
 // Determines whether all states in the NGXS registry should be persisted or not.
 const ɵALL_STATES_PERSISTED = new InjectionToken(typeof ngDevMode !== 'undefined' && ngDevMode ? 'ALL_STATES_PERSISTED' : '', {
-    providedIn: 'root',
     factory: () => inject(ɵUSER_OPTIONS).keys === '*'
 });
 const ɵNGXS_STORAGE_PLUGIN_OPTIONS = new InjectionToken(typeof ngDevMode !== 'undefined' && ngDevMode ? 'NGXS_STORAGE_PLUGIN_OPTIONS' : '');
@@ -25,6 +24,10 @@ const STORAGE_ENGINE = new InjectionToken(typeof ngDevMode !== 'undefined' && ng
 function ɵisKeyWithExplicitEngine(key) {
     return !!key?.engine;
 }
+/** Determines whether the engine is a factory function rather than a class or InjectionToken. */
+function ɵisEngineFactory(engine) {
+    return !(engine instanceof InjectionToken) && !engine.toString().startsWith('class');
+}
 function ɵextractStringKey(storageKey) {
     // Extract the actual key out of the `{ key, engine }` structure.
     if (ɵisKeyWithExplicitEngine(storageKey)) {
@@ -43,5 +46,5 @@ function ɵextractStringKey(storageKey) {
  * Generated bundle index. Do not edit.
  */
 
-export { STORAGE_ENGINE, StorageOption, ɵALL_STATES_PERSISTED, ɵDEFAULT_STATE_KEY, ɵNGXS_STORAGE_PLUGIN_OPTIONS, ɵUSER_OPTIONS, ɵextractStringKey, ɵisKeyWithExplicitEngine };
+export { STORAGE_ENGINE, StorageOption, ɵALL_STATES_PERSISTED, ɵDEFAULT_STATE_KEY, ɵNGXS_STORAGE_PLUGIN_OPTIONS, ɵUSER_OPTIONS, ɵextractStringKey, ɵisEngineFactory, ɵisKeyWithExplicitEngine };
 //# sourceMappingURL=ngxs-storage-plugin-internals.mjs.map

package/fesm2022/ngxs-storage-plugin-internals.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ngxs-storage-plugin-internals.mjs","sources":["../../../packages/storage-plugin/internals/src/symbols.ts","../../../packages/storage-plugin/internals/src/storage-key.ts","../../../packages/storage-plugin/internals/src/ngxs-storage-plugin-internals.ts"],"sourcesContent":["import { InjectionToken, inject } from '@angular/core';\n\nimport { StorageKey } from './storage-key';\n\n/**\n * The following key is used to store the entire serialized\n * state when no specific state is provided.\n */\nexport const ɵDEFAULT_STATE_KEY = '@@STATE';\n\ndeclare const ngDevMode: boolean;\n\nexport enum StorageOption {\n  LocalStorage,\n  SessionStorage\n}\n\nexport interface NgxsStoragePluginOptions {\n  /**\n   * Keys for the state slice to store in the storage engine.\n   */\n  keys: '*' | StorageKey[];\n\n  /**\n   * The namespace is used to prefix the key for the state slice. This is\n   * necessary when running micro frontend applications which use storage plugin.\n   * The namespace will eliminate the conflict between keys that might overlap.\n   */\n  namespace?: string;\n\n  /**\n   * Storage engine to use. Deaults to localStorage but can provide\n   *\n   * sessionStorage or custom implementation of the StorageEngine interface\n   */\n  storage?: StorageOption;\n\n  /**\n   * Migration strategies.\n   */\n  migrations?: {\n    /**\n     * Version to key off.\n     */\n    version: number | string;\n\n    /**\n     * Method to migrate the previous state.\n     */\n    migrate: (state: any) => any;\n\n    /**\n     * Key to migrate.\n     */\n    key?: string;\n\n    /**\n     * Key for the version. Defaults to 'version'.\n     */\n    versionKey?: string;\n  }[];\n\n  /**\n   * Serailizer for the object before its pushed into the engine.\n   */\n  serialize?(obj: any): string;\n\n  /**\n   * Deserializer for the object before its pulled out of the engine.\n   */\n  deserialize?(obj: any): any;\n\n  /**\n   * Method to alter object before serialization.\n   */\n  beforeSerialize?(obj: any, key: string): any;\n\n  /**\n   * Method to alter object after deserialization.\n   */\n  afterDeserialize?(obj: any, key: string): any;\n}\n\nexport interface ɵNgxsTransformedStoragePluginOptions extends NgxsStoragePluginOptions {\n  keys: StorageKey[];\n}\n\nexport const ɵUSER_OPTIONS = new InjectionToken<NgxsStoragePluginOptions>(\n  typeof ngDevMode !== 'undefined' && ngDevMode ? 'USER_OPTIONS' : ''\n);\n\n// Determines whether all states in the NGXS registry should be persisted or not.\nexport const ɵALL_STATES_PERSISTED = new InjectionToken<boolean>(\n  typeof ngDevMode !== 'undefined' && ngDevMode ? 'ALL_STATES_PERSISTED' : '',\n  {\n    providedIn: 'root',\n    factory: () => inject(ɵUSER_OPTIONS).keys === '*'\n  }\n);\n\nexport const ɵNGXS_STORAGE_PLUGIN_OPTIONS =\n  new InjectionToken<ɵNgxsTransformedStoragePluginOptions>(\n    typeof ngDevMode !== 'undefined' && ngDevMode ? 'NGXS_STORAGE_PLUGIN_OPTIONS' : ''\n  );\n\nexport const STORAGE_ENGINE = new InjectionToken<StorageEngine>(\n  typeof ngDevMode !== 'undefined' && ngDevMode ? 'STORAGE_ENGINE' : ''\n);\n\nexport interface StorageEngine {\n  getItem(key: string): any;\n  setItem(key: string, value: any): void;\n}\n","import { InjectionToken, Type } from '@angular/core';\nimport { StateToken } from '@ngxs/store';\nimport { ɵhasOwnProperty, ɵMETA_OPTIONS_KEY, ɵStateClass } from '@ngxs/store/internals';\n\nimport { StorageEngine } from './symbols';\n\n/** This enables the user to provide a storage engine per individual key. */\nexport interface KeyWithExplicitEngine {\n  key: string | ɵStateClass | StateToken<any>;\n  engine: Type<StorageEngine> | InjectionToken<StorageEngine>;\n}\n\n/** Determines whether the provided key has the following structure. */\nexport function ɵisKeyWithExplicitEngine(key: any): key is KeyWithExplicitEngine {\n  return !!key?.engine;\n}\n\n/**\n * This tuples all of the possible types allowed in the `key` property.\n * This is not exposed publicly and used internally only.\n */\nexport type StorageKey = string | ɵStateClass | StateToken<any> | KeyWithExplicitEngine;\n\nexport function ɵextractStringKey(storageKey: StorageKey): string {\n  // Extract the actual key out of the `{ key, engine }` structure.\n  if (ɵisKeyWithExplicitEngine(storageKey)) {\n    storageKey = storageKey.key;\n  }\n\n  // Given the `storageKey` is a class, for instance, `AuthState`.\n  // We should retrieve its metadata and the `name` property.\n  // The `name` property might be a string (state name) or a state token.\n  if (ɵhasOwnProperty(storageKey, ɵMETA_OPTIONS_KEY)) {\n    storageKey = (storageKey as any)[ɵMETA_OPTIONS_KEY].name;\n  }\n\n  return storageKey instanceof StateToken ? storageKey.getName() : <string>storageKey;\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":["ɵhasOwnProperty","ɵMETA_OPTIONS_KEY"],"mappings":";;;;AAIA;;;AAGG;AACI,MAAM,kBAAkB,GAAG;IAItB;AAAZ,CAAA,UAAY,aAAa,EAAA;AACvB,IAAA,aAAA,CAAA,aAAA,CAAA,cAAA,CAAA,GAAA,CAAA,CAAA,GAAA,cAAY;AACZ,IAAA,aAAA,CAAA,aAAA,CAAA,gBAAA,CAAA,GAAA,CAAA,CAAA,GAAA,gBAAc;AAChB,CAAC,EAHW,aAAa,KAAb,aAAa,GAGxB,EAAA,CAAA,CAAA;MAwEY,aAAa,GAAG,IAAI,cAAc,CAC7C,OAAO,SAAS,KAAK,WAAW,IAAI,SAAS,GAAG,cAAc,GAAG,EAAE;AAGrE;MACa,qBAAqB,GAAG,IAAI,cAAc,CACrD,OAAO,SAAS,KAAK,WAAW,IAAI,SAAS,GAAG,sBAAsB,GAAG,EAAE,EAC3E;AACE,IAAA,UAAU,EAAE,MAAM;IAClB,OAAO,EAAE,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,KAAK;AAC/C,CAAA;MAGU,4BAA4B,GACvC,IAAI,cAAc,CAChB,OAAO,SAAS,KAAK,WAAW,IAAI,SAAS,GAAG,6BAA6B,GAAG,EAAE;MAGzE,cAAc,GAAG,IAAI,cAAc,CAC9C,OAAO,SAAS,KAAK,WAAW,IAAI,SAAS,GAAG,gBAAgB,GAAG,EAAE;;AC9FvE;AACM,SAAU,wBAAwB,CAAC,GAAQ,EAAA;AAC/C,IAAA,OAAO,CAAC,CAAC,GAAG,EAAE,MAAM;AACtB;AAQM,SAAU,iBAAiB,CAAC,UAAsB,EAAA;;AAEtD,IAAA,IAAI,wBAAwB,CAAC,UAAU,CAAC,EAAE;AACxC,QAAA,UAAU,GAAG,UAAU,CAAC,GAAG;;;;;AAM7B,IAAA,IAAIA,eAAe,CAAC,UAAU,EAAEC,iBAAiB,CAAC,EAAE;AAClD,QAAA,UAAU,GAAI,UAAkB,CAACA,iBAAiB,CAAC,CAAC,IAAI;;AAG1D,IAAA,OAAO,UAAU,YAAY,UAAU,GAAG,UAAU,CAAC,OAAO,EAAE,GAAW,UAAU;AACrF;;ACrCA;;AAEG;;;;"}
+{"version":3,"file":"ngxs-storage-plugin-internals.mjs","sources":["../../../packages/storage-plugin/internals/src/symbols.ts","../../../packages/storage-plugin/internals/src/storage-key.ts","../../../packages/storage-plugin/internals/src/ngxs-storage-plugin-internals.ts"],"sourcesContent":["import { InjectionToken, inject } from '@angular/core';\n\nimport { StorageKey } from './storage-key';\n\n/**\n * The following key is used to store the entire serialized\n * state when no specific state is provided.\n */\nexport const ɵDEFAULT_STATE_KEY = '@@STATE';\n\ndeclare const ngDevMode: boolean;\n\nexport enum StorageOption {\n  LocalStorage,\n  SessionStorage\n}\n\nexport interface NgxsStoragePluginOptions {\n  /**\n   * Keys for the state slice to store in the storage engine.\n   */\n  keys: '*' | StorageKey[];\n\n  /**\n   * The namespace is used to prefix the key for the state slice. This is\n   * necessary when running micro frontend applications which use storage plugin.\n   * The namespace will eliminate the conflict between keys that might overlap.\n   */\n  namespace?: string;\n\n  /**\n   * Storage engine to use. Deaults to localStorage but can provide\n   *\n   * sessionStorage or custom implementation of the StorageEngine interface\n   */\n  storage?: StorageOption;\n\n  /**\n   * Migration strategies.\n   */\n  migrations?: {\n    /**\n     * Version to key off.\n     */\n    version: number | string;\n\n    /**\n     * Method to migrate the previous state.\n     */\n    migrate: (state: any) => any;\n\n    /**\n     * Key to migrate.\n     */\n    key?: string;\n\n    /**\n     * Key for the version. Defaults to 'version'.\n     */\n    versionKey?: string;\n  }[];\n\n  /**\n   * Serailizer for the object before its pushed into the engine.\n   */\n  serialize?(obj: any): string;\n\n  /**\n   * Deserializer for the object before its pulled out of the engine.\n   */\n  deserialize?(obj: any): any;\n\n  /**\n   * Method to alter object before serialization.\n   */\n  beforeSerialize?(obj: any, key: string): any;\n\n  /**\n   * Method to alter object after deserialization.\n   */\n  afterDeserialize?(obj: any, key: string): any;\n}\n\nexport interface ɵNgxsTransformedStoragePluginOptions extends NgxsStoragePluginOptions {\n  keys: StorageKey[];\n}\n\nexport const ɵUSER_OPTIONS = new InjectionToken<NgxsStoragePluginOptions>(\n  typeof ngDevMode !== 'undefined' && ngDevMode ? 'USER_OPTIONS' : ''\n);\n\n// Determines whether all states in the NGXS registry should be persisted or not.\nexport const ɵALL_STATES_PERSISTED = new InjectionToken<boolean>(\n  typeof ngDevMode !== 'undefined' && ngDevMode ? 'ALL_STATES_PERSISTED' : '',\n  {\n    factory: () => inject(ɵUSER_OPTIONS).keys === '*'\n  }\n);\n\nexport const ɵNGXS_STORAGE_PLUGIN_OPTIONS =\n  new InjectionToken<ɵNgxsTransformedStoragePluginOptions>(\n    typeof ngDevMode !== 'undefined' && ngDevMode ? 'NGXS_STORAGE_PLUGIN_OPTIONS' : ''\n  );\n\nexport const STORAGE_ENGINE = new InjectionToken<StorageEngine>(\n  typeof ngDevMode !== 'undefined' && ngDevMode ? 'STORAGE_ENGINE' : ''\n);\n\nexport interface StorageEngine {\n  getItem(key: string): any;\n  setItem(key: string, value: any): void;\n}\n","import { InjectionToken, Type } from '@angular/core';\nimport { StateToken } from '@ngxs/store';\nimport { ɵhasOwnProperty, ɵMETA_OPTIONS_KEY, ɵStateClass } from '@ngxs/store/internals';\n\nimport { StorageEngine } from './symbols';\n\n/** This enables the user to provide a storage engine per individual key. */\nexport interface KeyWithExplicitEngine {\n  key: string | ɵStateClass | StateToken<any>;\n  engine: Type<StorageEngine> | InjectionToken<StorageEngine> | (() => StorageEngine);\n}\n\n/** Determines whether the provided key has the following structure. */\nexport function ɵisKeyWithExplicitEngine(key: any): key is KeyWithExplicitEngine {\n  return !!key?.engine;\n}\n\n/** Determines whether the engine is a factory function rather than a class or InjectionToken. */\nexport function ɵisEngineFactory(\n  engine: Type<StorageEngine> | InjectionToken<StorageEngine> | (() => StorageEngine)\n): engine is () => StorageEngine {\n  return !(engine instanceof InjectionToken) && !engine.toString().startsWith('class');\n}\n\n/**\n * This tuples all of the possible types allowed in the `key` property.\n * This is not exposed publicly and used internally only.\n */\nexport type StorageKey = string | ɵStateClass | StateToken<any> | KeyWithExplicitEngine;\n\nexport function ɵextractStringKey(storageKey: StorageKey): string {\n  // Extract the actual key out of the `{ key, engine }` structure.\n  if (ɵisKeyWithExplicitEngine(storageKey)) {\n    storageKey = storageKey.key;\n  }\n\n  // Given the `storageKey` is a class, for instance, `AuthState`.\n  // We should retrieve its metadata and the `name` property.\n  // The `name` property might be a string (state name) or a state token.\n  if (ɵhasOwnProperty(storageKey, ɵMETA_OPTIONS_KEY)) {\n    storageKey = (storageKey as any)[ɵMETA_OPTIONS_KEY].name;\n  }\n\n  return storageKey instanceof StateToken ? storageKey.getName() : <string>storageKey;\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":["ɵhasOwnProperty","ɵMETA_OPTIONS_KEY"],"mappings":";;;;AAIA;;;AAGG;AACI,MAAM,kBAAkB,GAAG;IAItB;AAAZ,CAAA,UAAY,aAAa,EAAA;AACvB,IAAA,aAAA,CAAA,aAAA,CAAA,cAAA,CAAA,GAAA,CAAA,CAAA,GAAA,cAAY;AACZ,IAAA,aAAA,CAAA,aAAA,CAAA,gBAAA,CAAA,GAAA,CAAA,CAAA,GAAA,gBAAc;AAChB,CAAC,EAHW,aAAa,KAAb,aAAa,GAAA,EAAA,CAAA,CAAA;MA2EZ,aAAa,GAAG,IAAI,cAAc,CAC7C,OAAO,SAAS,KAAK,WAAW,IAAI,SAAS,GAAG,cAAc,GAAG,EAAE;AAGrE;MACa,qBAAqB,GAAG,IAAI,cAAc,CACrD,OAAO,SAAS,KAAK,WAAW,IAAI,SAAS,GAAG,sBAAsB,GAAG,EAAE,EAC3E;IACE,OAAO,EAAE,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,KAAK;AAC/C,CAAA;MAGU,4BAA4B,GACvC,IAAI,cAAc,CAChB,OAAO,SAAS,KAAK,WAAW,IAAI,SAAS,GAAG,6BAA6B,GAAG,EAAE;MAGzE,cAAc,GAAG,IAAI,cAAc,CAC9C,OAAO,SAAS,KAAK,WAAW,IAAI,SAAS,GAAG,gBAAgB,GAAG,EAAE;;AC7FvE;AACM,SAAU,wBAAwB,CAAC,GAAQ,EAAA;AAC/C,IAAA,OAAO,CAAC,CAAC,GAAG,EAAE,MAAM;AACtB;AAEA;AACM,SAAU,gBAAgB,CAC9B,MAAmF,EAAA;AAEnF,IAAA,OAAO,EAAE,MAAM,YAAY,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;AACtF;AAQM,SAAU,iBAAiB,CAAC,UAAsB,EAAA;;AAEtD,IAAA,IAAI,wBAAwB,CAAC,UAAU,CAAC,EAAE;AACxC,QAAA,UAAU,GAAG,UAAU,CAAC,GAAG;IAC7B;;;;AAKA,IAAA,IAAIA,eAAe,CAAC,UAAU,EAAEC,iBAAiB,CAAC,EAAE;AAClD,QAAA,UAAU,GAAI,UAAkB,CAACA,iBAAiB,CAAC,CAAC,IAAI;IAC1D;AAEA,IAAA,OAAO,UAAU,YAAY,UAAU,GAAG,UAAU,CAAC,OAAO,EAAE,GAAW,UAAU;AACrF;;AC5CA;;AAEG;;;;"}

package/fesm2022/ngxs-storage-plugin.mjs

@@ -1,8 +1,9 @@
 import * as i0 from '@angular/core';
-import { inject, Injector, Injectable, NgModule, makeEnvironmentProviders, provideEnvironmentInitializer, InjectionToken } from '@angular/core';
+import { inject, Injector, runInInjectionContext, Injectable, PLATFORM_ID, NgModule, makeEnvironmentProviders, provideEnvironmentInitializer, InjectionToken } from '@angular/core';
 import { withNgxsPlugin } from '@ngxs/store';
-import { ɵDEFAULT_STATE_KEY as _DEFAULT_STATE_KEY, StorageOption, ɵNGXS_STORAGE_PLUGIN_OPTIONS as _NGXS_STORAGE_PLUGIN_OPTIONS, ɵextractStringKey as _extractStringKey, ɵisKeyWithExplicitEngine as _isKeyWithExplicitEngine, STORAGE_ENGINE, ɵALL_STATES_PERSISTED as _ALL_STATES_PERSISTED, ɵUSER_OPTIONS as _USER_OPTIONS } from '@ngxs/storage-plugin/internals';
+import { ɵDEFAULT_STATE_KEY as _DEFAULT_STATE_KEY, StorageOption, ɵNGXS_STORAGE_PLUGIN_OPTIONS as _NGXS_STORAGE_PLUGIN_OPTIONS, ɵextractStringKey as _extractStringKey, ɵisKeyWithExplicitEngine as _isKeyWithExplicitEngine, ɵisEngineFactory as _isEngineFactory, STORAGE_ENGINE, ɵALL_STATES_PERSISTED as _ALL_STATES_PERSISTED, ɵUSER_OPTIONS as _USER_OPTIONS } from '@ngxs/storage-plugin/internals';
 export { STORAGE_ENGINE, StorageOption } from '@ngxs/storage-plugin/internals';
+import { isPlatformServer } from '@angular/common';
 import { ɵhasOwnProperty as _hasOwnProperty } from '@ngxs/store/internals';
 import { getActionTypeFromInstance, InitState, UpdateState, getValue, setValue } from '@ngxs/store/plugins';
 import { tap } from 'rxjs';
@@ -63,25 +64,28 @@ class ɵNgxsStoragePluginKeysManager {
             }
             this._keys.add(key);
             const engine = _isKeyWithExplicitEngine(storageKey)
-                ? this._injector.get(storageKey.engine)
+                ? _isEngineFactory(storageKey.engine)
+                    ? runInInjectionContext(this._injector, storageKey.engine)
+                    : this._injector.get(storageKey.engine)
                 : this._injector.get(STORAGE_ENGINE);
             this._keysWithEngines.push({ key, engine });
         }
     }
-    /** @nocollapse */ static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.2", ngImport: i0, type: ɵNgxsStoragePluginKeysManager, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
-    /** @nocollapse */ static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.2", ngImport: i0, type: ɵNgxsStoragePluginKeysManager, providedIn: 'root' });
+    /** @nocollapse */ static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.25", ngImport: i0, type: ɵNgxsStoragePluginKeysManager, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    /** @nocollapse */ static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.25", ngImport: i0, type: ɵNgxsStoragePluginKeysManager });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.2", ngImport: i0, type: ɵNgxsStoragePluginKeysManager, decorators: [{
-            type: Injectable,
-            args: [{ providedIn: 'root' }]
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.25", ngImport: i0, type: ɵNgxsStoragePluginKeysManager, decorators: [{
+            type: Injectable
         }], ctorParameters: () => [] });
 
 class NgxsStoragePlugin {
+    _injector = inject(Injector);
     _keysManager = inject(ɵNgxsStoragePluginKeysManager);
     _options = inject(_NGXS_STORAGE_PLUGIN_OPTIONS);
     _allStatesPersisted = inject(_ALL_STATES_PERSISTED);
     handle(state, event, next) {
-        if (typeof ngServerMode !== 'undefined' && ngServerMode) {
+        if ((typeof ngServerMode !== 'undefined' && ngServerMode) ||
+            isPlatformServer(this._injector.get(PLATFORM_ID))) {
             return next(state, event);
         }
         const type = getActionTypeFromInstance(event);
@@ -125,7 +129,8 @@ class NgxsStoragePlugin {
                         storedValue = {};
                     }
                     this._options.migrations?.forEach(strategy => {
-                        const versionMatch = strategy.version === getValue(storedValue, strategy.versionKey || 'version');
+                        const storedVersion = getValue(storedValue, strategy.versionKey || 'version') ?? 0;
+                        const versionMatch = strategy.version === storedVersion;
                         const keyMatch = (!strategy.key && this._allStatesPersisted) || strategy.key === key;
                         if (versionMatch && keyMatch) {
                             storedValue = strategy.migrate(storedValue);
@@ -201,19 +206,26 @@ class NgxsStoragePlugin {
             return accumulator;
         }, {});
     }
-    /** @nocollapse */ static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.2", ngImport: i0, type: NgxsStoragePlugin, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
-    /** @nocollapse */ static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.2", ngImport: i0, type: NgxsStoragePlugin });
+    /** @nocollapse */ static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.25", ngImport: i0, type: NgxsStoragePlugin, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    /** @nocollapse */ static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.25", ngImport: i0, type: NgxsStoragePlugin });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.2", ngImport: i0, type: NgxsStoragePlugin, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.25", ngImport: i0, type: NgxsStoragePlugin, decorators: [{
             type: Injectable
         }] });
 const DOT = '.';
 
+/**
+ * @deprecated Use `withNgxsStoragePlugin()` instead.
+ */
 class NgxsStoragePluginModule {
+    /**
+     * @deprecated Use `withNgxsStoragePlugin()` instead.
+     */
     static forRoot(options) {
         return {
             ngModule: NgxsStoragePluginModule,
             providers: [
+                ɵNgxsStoragePluginKeysManager,
                 withNgxsPlugin(NgxsStoragePlugin),
                 {
                     provide: _USER_OPTIONS,
@@ -232,15 +244,16 @@ class NgxsStoragePluginModule {
             ]
         };
     }
-    /** @nocollapse */ static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.2", ngImport: i0, type: NgxsStoragePluginModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
-    /** @nocollapse */ static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "20.3.2", ngImport: i0, type: NgxsStoragePluginModule });
-    /** @nocollapse */ static ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "20.3.2", ngImport: i0, type: NgxsStoragePluginModule });
+    /** @nocollapse */ static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.25", ngImport: i0, type: NgxsStoragePluginModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
+    /** @nocollapse */ static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "20.3.25", ngImport: i0, type: NgxsStoragePluginModule });
+    /** @nocollapse */ static ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "20.3.25", ngImport: i0, type: NgxsStoragePluginModule });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.2", ngImport: i0, type: NgxsStoragePluginModule, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.25", ngImport: i0, type: NgxsStoragePluginModule, decorators: [{
             type: NgModule
         }] });
 function withNgxsStoragePlugin(options) {
     return makeEnvironmentProviders([
+        ɵNgxsStoragePluginKeysManager,
         withNgxsPlugin(NgxsStoragePlugin),
         {
             provide: _USER_OPTIONS,
@@ -280,11 +293,9 @@ function withStorageFeature(storageKeys) {
 }
 
 const LOCAL_STORAGE_ENGINE = /* @__PURE__ */ new InjectionToken(typeof ngDevMode !== 'undefined' && ngDevMode ? 'LOCAL_STORAGE_ENGINE' : '', {
-    providedIn: 'root',
     factory: () => (typeof ngServerMode !== 'undefined' && ngServerMode ? null : localStorage)
 });
 const SESSION_STORAGE_ENGINE = /* @__PURE__ */ new InjectionToken(typeof ngDevMode !== 'undefined' && ngDevMode ? 'SESSION_STORAGE_ENGINE' : '', {
-    providedIn: 'root',
     factory: () => typeof ngServerMode !== 'undefined' && ngServerMode ? null : sessionStorage
 });
 

package/fesm2022/ngxs-storage-plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ngxs-storage-plugin.mjs","sources":["../../../packages/storage-plugin/src/internals.ts","../../../packages/storage-plugin/src/keys-manager.ts","../../../packages/storage-plugin/src/storage.plugin.ts","../../../packages/storage-plugin/src/storage.module.ts","../../../packages/storage-plugin/src/with-storage-feature.ts","../../../packages/storage-plugin/src/engines.ts","../../../packages/storage-plugin/index.ts","../../../packages/storage-plugin/ngxs-storage-plugin.ts"],"sourcesContent":["import {\n  ɵDEFAULT_STATE_KEY,\n  StorageOption,\n  StorageEngine,\n  NgxsStoragePluginOptions,\n  ɵNgxsTransformedStoragePluginOptions\n} from '@ngxs/storage-plugin/internals';\n\ndeclare const ngServerMode: boolean;\n\nexport function storageOptionsFactory(\n  options: NgxsStoragePluginOptions\n): ɵNgxsTransformedStoragePluginOptions {\n  return {\n    storage: StorageOption.LocalStorage,\n    serialize: JSON.stringify,\n    deserialize: JSON.parse,\n    beforeSerialize: obj => obj,\n    afterDeserialize: obj => obj,\n    ...options,\n    keys: options.keys === '*' ? [ɵDEFAULT_STATE_KEY] : options.keys\n  };\n}\n\nexport function engineFactory(options: NgxsStoragePluginOptions): StorageEngine | null {\n  if (typeof ngServerMode !== 'undefined' && ngServerMode) {\n    return null;\n  }\n\n  if (options.storage === StorageOption.LocalStorage) {\n    return localStorage;\n  } else if (options.storage === StorageOption.SessionStorage) {\n    return sessionStorage;\n  }\n\n  return null;\n}\n\nexport function getStorageKey(key: string, options?: NgxsStoragePluginOptions): string {\n  // Prepends the `namespace` option to any key if it's been provided by a user.\n  // So `@@STATE` becomes `my-app:@@STATE`.\n  return options?.namespace ? `${options.namespace}:${key}` : key;\n}\n","import { Injectable, Injector, inject } from '@angular/core';\nimport {\n  STORAGE_ENGINE,\n  StorageEngine,\n  StorageKey,\n  ɵextractStringKey,\n  ɵisKeyWithExplicitEngine,\n  ɵNGXS_STORAGE_PLUGIN_OPTIONS\n} from '@ngxs/storage-plugin/internals';\n\ninterface KeyWithEngine {\n  key: string;\n  engine: StorageEngine | null;\n}\n\n@Injectable({ providedIn: 'root' })\nexport class ɵNgxsStoragePluginKeysManager {\n  /** Store keys separately in a set so we're able to check if the key already exists. */\n  private readonly _keys = new Set<string>();\n\n  private readonly _injector = inject(Injector);\n\n  private readonly _keysWithEngines: KeyWithEngine[] = [];\n\n  constructor() {\n    const { keys } = inject(ɵNGXS_STORAGE_PLUGIN_OPTIONS);\n    this.addKeys(keys);\n  }\n\n  getKeysWithEngines() {\n    // Spread to prevent external code from directly modifying the internal state.\n    return [...this._keysWithEngines];\n  }\n\n  addKeys(storageKeys: StorageKey[]): void {\n    for (const storageKey of storageKeys) {\n      const key = ɵextractStringKey(storageKey);\n\n      // The user may call `withStorageFeature` with the same state multiple times.\n      // Let's prevent duplicating state names in the `keysWithEngines` list.\n      // Please note that calling provideStates multiple times with the same state is\n      // acceptable behavior. This may occur because the state could be necessary at the\n      // feature level, and different parts of the application might require its registration.\n      // Consequently, `withStorageFeature` may also be called multiple times.\n      if (this._keys.has(key)) {\n        continue;\n      }\n\n      this._keys.add(key);\n\n      const engine = ɵisKeyWithExplicitEngine(storageKey)\n        ? this._injector.get(storageKey.engine)\n        : this._injector.get(STORAGE_ENGINE);\n\n      this._keysWithEngines.push({ key, engine });\n    }\n  }\n}\n","import { Injectable, inject } from '@angular/core';\nimport { ɵhasOwnProperty, ɵPlainObject } from '@ngxs/store/internals';\nimport {\n  NgxsPlugin,\n  setValue,\n  getValue,\n  InitState,\n  UpdateState,\n  actionMatcher,\n  NgxsNextPluginFn,\n  getActionTypeFromInstance\n} from '@ngxs/store/plugins';\nimport {\n  ɵDEFAULT_STATE_KEY,\n  ɵALL_STATES_PERSISTED,\n  ɵNGXS_STORAGE_PLUGIN_OPTIONS\n} from '@ngxs/storage-plugin/internals';\nimport { tap } from 'rxjs';\n\nimport { getStorageKey } from './internals';\nimport { ɵNgxsStoragePluginKeysManager } from './keys-manager';\n\ndeclare const ngDevMode: boolean;\ndeclare const ngServerMode: boolean;\n\n@Injectable()\nexport class NgxsStoragePlugin implements NgxsPlugin {\n  private _keysManager = inject(ɵNgxsStoragePluginKeysManager);\n  private _options = inject(ɵNGXS_STORAGE_PLUGIN_OPTIONS);\n  private _allStatesPersisted = inject(ɵALL_STATES_PERSISTED);\n\n  handle(state: any, event: any, next: NgxsNextPluginFn) {\n    if (typeof ngServerMode !== 'undefined' && ngServerMode) {\n      return next(state, event);\n    }\n\n    const type = getActionTypeFromInstance(event);\n    const isInitAction = type === InitState.type;\n    const isUpdateAction = type === UpdateState.type;\n    const isInitOrUpdateAction = isInitAction || isUpdateAction;\n    let hasMigration = false;\n\n    if (isInitOrUpdateAction) {\n      const addedStates: ɵPlainObject = isUpdateAction && event.addedStates;\n\n      for (const { key, engine } of this._keysManager.getKeysWithEngines()) {\n        // We're checking what states have been added by NGXS and if any of these states should be handled by\n        // the storage plugin. For instance, we only want to deserialize the `auth` state, NGXS has added\n        // the `user` state, the storage plugin will be rerun and will do redundant deserialization.\n        // `usesDefaultStateKey` is necessary to check since `event.addedStates` never contains `@@STATE`.\n        if (!this._allStatesPersisted && addedStates) {\n          // We support providing keys that can be deeply nested via dot notation, for instance,\n          // `keys: ['myState.myProperty']` is a valid key.\n          // The state name should always go first. The below code checks if the `key` includes dot\n          // notation and extracts the state name out of the key.\n          // Given the `key` is `myState.myProperty`, the `addedStates` will only contain `myState`.\n          const dotNotationIndex = key.indexOf(DOT);\n          const stateName = dotNotationIndex > -1 ? key.slice(0, dotNotationIndex) : key;\n          if (!ɵhasOwnProperty(addedStates, stateName)) continue;\n        }\n\n        // Guard against `engine` being falsy. Since it can be provided via DI,\n        // we should assume it may be `null` or `undefined` at runtime and skip it safely.\n        if (!engine) continue;\n\n        const storageKey = getStorageKey(key, this._options);\n        let storedValue: any = engine.getItem(storageKey);\n\n        if (storedValue !== 'undefined' && storedValue != null) {\n          try {\n            const newVal = this._options.deserialize!(storedValue);\n            storedValue = this._options.afterDeserialize!(newVal, key);\n          } catch {\n            typeof ngDevMode !== 'undefined' &&\n              ngDevMode &&\n              console.error(\n                `Error ocurred while deserializing the ${storageKey} store value, falling back to empty object, the value obtained from the store: `,\n                storedValue\n              );\n\n            storedValue = {};\n          }\n\n          this._options.migrations?.forEach(strategy => {\n            const versionMatch =\n              strategy.version === getValue(storedValue, strategy.versionKey || 'version');\n            const keyMatch =\n              (!strategy.key && this._allStatesPersisted) || strategy.key === key;\n            if (versionMatch && keyMatch) {\n              storedValue = strategy.migrate(storedValue);\n              hasMigration = true;\n            }\n          });\n\n          if (this._allStatesPersisted) {\n            storedValue = this._hydrateSelectivelyOnUpdate(storedValue, addedStates);\n            state = { ...state, ...storedValue };\n          } else {\n            state = setValue(state, key, storedValue);\n          }\n        }\n      }\n    }\n\n    return next(state, event).pipe(\n      tap(nextState => {\n        if (isInitOrUpdateAction && !hasMigration) {\n          return;\n        }\n\n        for (const { key, engine } of this._keysManager.getKeysWithEngines()) {\n          if (!engine) continue;\n\n          let storedValue = nextState;\n\n          const storageKey = getStorageKey(key, this._options);\n\n          if (key !== ɵDEFAULT_STATE_KEY) {\n            storedValue = getValue(nextState, key);\n          }\n\n          try {\n            const newStoredValue = this._options.beforeSerialize!(storedValue, key);\n            engine.setItem(storageKey, this._options.serialize!(newStoredValue));\n          } catch (error: any) {\n            if (typeof ngDevMode !== 'undefined' && ngDevMode) {\n              if (\n                error &&\n                (error.name === 'QuotaExceededError' ||\n                  error.name === 'NS_ERROR_DOM_QUOTA_REACHED')\n              ) {\n                console.error(\n                  `The ${storageKey} store value exceeds the browser storage quota: `,\n                  storedValue\n                );\n              } else {\n                console.error(\n                  `Error ocurred while serializing the ${storageKey} store value, value not updated, the value obtained from the store: `,\n                  storedValue\n                );\n              }\n            }\n          }\n        }\n      })\n    );\n  }\n\n  private _hydrateSelectivelyOnUpdate(storedValue: any, addedStates: ɵPlainObject) {\n    // The `UpdateState` action is triggered whenever a feature state is added.\n    // The condition below is only satisfied when this action is triggered.\n    // Let's consider two states: `counter` and `@ngxs/router-plugin` state.\n    // When `provideStore` is called, `CounterState` is provided at the root level,\n    // while `@ngxs/router-plugin` is provided as a feature state. Previously, the storage\n    // plugin might have stored the value of the counter state as `10`. If `CounterState`\n    // implements the `ngxsOnInit` hook and sets the state to `999`, the storage plugin will\n    // reset the entire state when the `RouterState` is registered.\n    // Consequently, the `counter` state will revert back to `10` instead of `999`.\n\n    if (!storedValue || !addedStates || Object.keys(addedStates).length === 0) {\n      // Nothing to update if `addedStates` object is empty.\n      return storedValue;\n    }\n\n    // The `storedValue` can be the entire state when the default state key\n    // is used. However, if `addedStates` only contains the `router` value,\n    // we only want to merge the state with that `router` value.\n    // Given the `storedValue` is an object:\n    // `{ counter: 10, router: {...} }`\n    // This will only select the `router` object from the `storedValue`,\n    // avoiding unnecessary rehydration of the `counter` state.\n    return Object.keys(addedStates).reduce(\n      (accumulator, addedState) => {\n        if (ɵhasOwnProperty(storedValue, addedState)) {\n          accumulator[addedState] = storedValue[addedState];\n        }\n        return accumulator;\n      },\n      <ɵPlainObject>{}\n    );\n  }\n}\n\nconst DOT = '.';\n","import {\n  NgModule,\n  ModuleWithProviders,\n  EnvironmentProviders,\n  makeEnvironmentProviders\n} from '@angular/core';\nimport { withNgxsPlugin } from '@ngxs/store';\nimport {\n  ɵUSER_OPTIONS,\n  STORAGE_ENGINE,\n  ɵNGXS_STORAGE_PLUGIN_OPTIONS,\n  NgxsStoragePluginOptions\n} from '@ngxs/storage-plugin/internals';\n\nimport { NgxsStoragePlugin } from './storage.plugin';\nimport { engineFactory, storageOptionsFactory } from './internals';\n\n@NgModule()\nexport class NgxsStoragePluginModule {\n  static forRoot(\n    options: NgxsStoragePluginOptions\n  ): ModuleWithProviders<NgxsStoragePluginModule> {\n    return {\n      ngModule: NgxsStoragePluginModule,\n      providers: [\n        withNgxsPlugin(NgxsStoragePlugin),\n        {\n          provide: ɵUSER_OPTIONS,\n          useValue: options\n        },\n        {\n          provide: ɵNGXS_STORAGE_PLUGIN_OPTIONS,\n          useFactory: storageOptionsFactory,\n          deps: [ɵUSER_OPTIONS]\n        },\n        {\n          provide: STORAGE_ENGINE,\n          useFactory: engineFactory,\n          deps: [ɵNGXS_STORAGE_PLUGIN_OPTIONS]\n        }\n      ]\n    };\n  }\n}\n\nexport function withNgxsStoragePlugin(\n  options: NgxsStoragePluginOptions\n): EnvironmentProviders {\n  return makeEnvironmentProviders([\n    withNgxsPlugin(NgxsStoragePlugin),\n    {\n      provide: ɵUSER_OPTIONS,\n      useValue: options\n    },\n    {\n      provide: ɵNGXS_STORAGE_PLUGIN_OPTIONS,\n      useFactory: storageOptionsFactory,\n      deps: [ɵUSER_OPTIONS]\n    },\n    {\n      provide: STORAGE_ENGINE,\n      useFactory: engineFactory,\n      deps: [ɵNGXS_STORAGE_PLUGIN_OPTIONS]\n    }\n  ]);\n}\n","import { inject, EnvironmentProviders, provideEnvironmentInitializer } from '@angular/core';\nimport { StorageKey, ɵALL_STATES_PERSISTED } from '@ngxs/storage-plugin/internals';\n\nimport { ɵNgxsStoragePluginKeysManager } from './keys-manager';\n\ndeclare const ngDevMode: boolean;\n\nexport function withStorageFeature(storageKeys: StorageKey[]): EnvironmentProviders {\n  return provideEnvironmentInitializer(() => {\n    const allStatesPersisted = inject(ɵALL_STATES_PERSISTED);\n\n    if (allStatesPersisted) {\n      if (typeof ngDevMode !== 'undefined' && ngDevMode) {\n        const message =\n          'The NGXS storage plugin is currently persisting all states because the `keys` ' +\n          'option was explicitly set to `*` at the root level. To selectively persist states, ' +\n          'consider explicitly specifying them, allowing for addition at the feature level.';\n\n        console.error(message);\n      }\n\n      // We should prevent the addition of any feature states to persistence\n      // if the `keys` property is set to `*`, as this could disrupt the algorithm\n      // used in the storage plugin. Instead, we should log an error in development\n      // mode. In production, it should continue to function, but act as a no-op.\n      return;\n    }\n\n    inject(ɵNgxsStoragePluginKeysManager).addKeys(storageKeys);\n  });\n}\n","import { InjectionToken } from '@angular/core';\nimport { StorageEngine } from '@ngxs/storage-plugin/internals';\n\ndeclare const ngDevMode: boolean;\ndeclare const ngServerMode: boolean;\n\nexport const LOCAL_STORAGE_ENGINE = /* @__PURE__ */ new InjectionToken<StorageEngine | null>(\n  typeof ngDevMode !== 'undefined' && ngDevMode ? 'LOCAL_STORAGE_ENGINE' : '',\n  {\n    providedIn: 'root',\n    factory: () => (typeof ngServerMode !== 'undefined' && ngServerMode ? null : localStorage)\n  }\n);\n\nexport const SESSION_STORAGE_ENGINE = /* @__PURE__ */ new InjectionToken<StorageEngine | null>(\n  typeof ngDevMode !== 'undefined' && ngDevMode ? 'SESSION_STORAGE_ENGINE' : '',\n  {\n    providedIn: 'root',\n    factory: () =>\n      typeof ngServerMode !== 'undefined' && ngServerMode ? null : sessionStorage\n  }\n);\n","/**\n * The public api for consumers of @ngxs/storage-plugin\n */\nexport * from './src/public_api';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":["ɵDEFAULT_STATE_KEY","ɵNGXS_STORAGE_PLUGIN_OPTIONS","ɵextractStringKey","ɵisKeyWithExplicitEngine","ɵALL_STATES_PERSISTED","ɵhasOwnProperty","ɵUSER_OPTIONS"],"mappings":"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"}
+{"version":3,"file":"ngxs-storage-plugin.mjs","sources":["../../../packages/storage-plugin/src/internals.ts","../../../packages/storage-plugin/src/keys-manager.ts","../../../packages/storage-plugin/src/storage.plugin.ts","../../../packages/storage-plugin/src/storage.module.ts","../../../packages/storage-plugin/src/with-storage-feature.ts","../../../packages/storage-plugin/src/engines.ts","../../../packages/storage-plugin/index.ts","../../../packages/storage-plugin/ngxs-storage-plugin.ts"],"sourcesContent":["import {\n  ɵDEFAULT_STATE_KEY,\n  StorageOption,\n  StorageEngine,\n  NgxsStoragePluginOptions,\n  ɵNgxsTransformedStoragePluginOptions\n} from '@ngxs/storage-plugin/internals';\n\ndeclare const ngServerMode: boolean;\n\nexport function storageOptionsFactory(\n  options: NgxsStoragePluginOptions\n): ɵNgxsTransformedStoragePluginOptions {\n  return {\n    storage: StorageOption.LocalStorage,\n    serialize: JSON.stringify,\n    deserialize: JSON.parse,\n    beforeSerialize: obj => obj,\n    afterDeserialize: obj => obj,\n    ...options,\n    keys: options.keys === '*' ? [ɵDEFAULT_STATE_KEY] : options.keys\n  };\n}\n\nexport function engineFactory(options: NgxsStoragePluginOptions): StorageEngine | null {\n  if (typeof ngServerMode !== 'undefined' && ngServerMode) {\n    return null;\n  }\n\n  if (options.storage === StorageOption.LocalStorage) {\n    return localStorage;\n  } else if (options.storage === StorageOption.SessionStorage) {\n    return sessionStorage;\n  }\n\n  return null;\n}\n\nexport function getStorageKey(key: string, options?: NgxsStoragePluginOptions): string {\n  // Prepends the `namespace` option to any key if it's been provided by a user.\n  // So `@@STATE` becomes `my-app:@@STATE`.\n  return options?.namespace ? `${options.namespace}:${key}` : key;\n}\n","import { Injectable, Injector, inject, runInInjectionContext } from '@angular/core';\nimport {\n  STORAGE_ENGINE,\n  StorageEngine,\n  StorageKey,\n  ɵextractStringKey,\n  ɵisEngineFactory,\n  ɵisKeyWithExplicitEngine,\n  ɵNGXS_STORAGE_PLUGIN_OPTIONS\n} from '@ngxs/storage-plugin/internals';\n\ninterface KeyWithEngine {\n  key: string;\n  engine: StorageEngine | null;\n}\n\n@Injectable()\nexport class ɵNgxsStoragePluginKeysManager {\n  /** Store keys separately in a set so we're able to check if the key already exists. */\n  private readonly _keys = new Set<string>();\n\n  private readonly _injector = inject(Injector);\n\n  private readonly _keysWithEngines: KeyWithEngine[] = [];\n\n  constructor() {\n    const { keys } = inject(ɵNGXS_STORAGE_PLUGIN_OPTIONS);\n    this.addKeys(keys);\n  }\n\n  getKeysWithEngines() {\n    // Spread to prevent external code from directly modifying the internal state.\n    return [...this._keysWithEngines];\n  }\n\n  addKeys(storageKeys: StorageKey[]): void {\n    for (const storageKey of storageKeys) {\n      const key = ɵextractStringKey(storageKey);\n\n      // The user may call `withStorageFeature` with the same state multiple times.\n      // Let's prevent duplicating state names in the `keysWithEngines` list.\n      // Please note that calling provideStates multiple times with the same state is\n      // acceptable behavior. This may occur because the state could be necessary at the\n      // feature level, and different parts of the application might require its registration.\n      // Consequently, `withStorageFeature` may also be called multiple times.\n      if (this._keys.has(key)) {\n        continue;\n      }\n\n      this._keys.add(key);\n\n      const engine = ɵisKeyWithExplicitEngine(storageKey)\n        ? ɵisEngineFactory(storageKey.engine)\n          ? runInInjectionContext(this._injector, storageKey.engine)\n          : this._injector.get(storageKey.engine)\n        : this._injector.get(STORAGE_ENGINE);\n\n      this._keysWithEngines.push({ key, engine });\n    }\n  }\n}\n","import { Injectable, Injector, PLATFORM_ID, inject } from '@angular/core';\nimport { isPlatformServer } from '@angular/common';\nimport { ɵhasOwnProperty, ɵPlainObject } from '@ngxs/store/internals';\nimport {\n  NgxsPlugin,\n  setValue,\n  getValue,\n  InitState,\n  UpdateState,\n  NgxsNextPluginFn,\n  getActionTypeFromInstance\n} from '@ngxs/store/plugins';\nimport {\n  ɵDEFAULT_STATE_KEY,\n  ɵALL_STATES_PERSISTED,\n  ɵNGXS_STORAGE_PLUGIN_OPTIONS\n} from '@ngxs/storage-plugin/internals';\nimport { tap } from 'rxjs';\n\nimport { getStorageKey } from './internals';\nimport { ɵNgxsStoragePluginKeysManager } from './keys-manager';\n\ndeclare const ngDevMode: boolean;\ndeclare const ngServerMode: boolean;\n\n@Injectable()\nexport class NgxsStoragePlugin implements NgxsPlugin {\n  private _injector = inject(Injector);\n  private _keysManager = inject(ɵNgxsStoragePluginKeysManager);\n  private _options = inject(ɵNGXS_STORAGE_PLUGIN_OPTIONS);\n  private _allStatesPersisted = inject(ɵALL_STATES_PERSISTED);\n\n  handle(state: any, event: any, next: NgxsNextPluginFn) {\n    if (\n      (typeof ngServerMode !== 'undefined' && ngServerMode) ||\n      isPlatformServer(this._injector.get(PLATFORM_ID))\n    ) {\n      return next(state, event);\n    }\n\n    const type = getActionTypeFromInstance(event);\n    const isInitAction = type === InitState.type;\n    const isUpdateAction = type === UpdateState.type;\n    const isInitOrUpdateAction = isInitAction || isUpdateAction;\n    let hasMigration = false;\n\n    if (isInitOrUpdateAction) {\n      const addedStates: ɵPlainObject = isUpdateAction && event.addedStates;\n\n      for (const { key, engine } of this._keysManager.getKeysWithEngines()) {\n        // We're checking what states have been added by NGXS and if any of these states should be handled by\n        // the storage plugin. For instance, we only want to deserialize the `auth` state, NGXS has added\n        // the `user` state, the storage plugin will be rerun and will do redundant deserialization.\n        // `usesDefaultStateKey` is necessary to check since `event.addedStates` never contains `@@STATE`.\n        if (!this._allStatesPersisted && addedStates) {\n          // We support providing keys that can be deeply nested via dot notation, for instance,\n          // `keys: ['myState.myProperty']` is a valid key.\n          // The state name should always go first. The below code checks if the `key` includes dot\n          // notation and extracts the state name out of the key.\n          // Given the `key` is `myState.myProperty`, the `addedStates` will only contain `myState`.\n          const dotNotationIndex = key.indexOf(DOT);\n          const stateName = dotNotationIndex > -1 ? key.slice(0, dotNotationIndex) : key;\n          if (!ɵhasOwnProperty(addedStates, stateName)) continue;\n        }\n\n        // Guard against `engine` being falsy. Since it can be provided via DI,\n        // we should assume it may be `null` or `undefined` at runtime and skip it safely.\n        if (!engine) continue;\n\n        const storageKey = getStorageKey(key, this._options);\n        let storedValue: any = engine.getItem(storageKey);\n\n        if (storedValue !== 'undefined' && storedValue != null) {\n          try {\n            const newVal = this._options.deserialize!(storedValue);\n            storedValue = this._options.afterDeserialize!(newVal, key);\n          } catch {\n            typeof ngDevMode !== 'undefined' &&\n              ngDevMode &&\n              console.error(\n                `Error ocurred while deserializing the ${storageKey} store value, falling back to empty object, the value obtained from the store: `,\n                storedValue\n              );\n\n            storedValue = {};\n          }\n\n          this._options.migrations?.forEach(strategy => {\n            const storedVersion = getValue(storedValue, strategy.versionKey || 'version') ?? 0;\n            const versionMatch = strategy.version === storedVersion;\n            const keyMatch =\n              (!strategy.key && this._allStatesPersisted) || strategy.key === key;\n            if (versionMatch && keyMatch) {\n              storedValue = strategy.migrate(storedValue);\n              hasMigration = true;\n            }\n          });\n\n          if (this._allStatesPersisted) {\n            storedValue = this._hydrateSelectivelyOnUpdate(storedValue, addedStates);\n            state = { ...state, ...storedValue };\n          } else {\n            state = setValue(state, key, storedValue);\n          }\n        }\n      }\n    }\n\n    return next(state, event).pipe(\n      tap(nextState => {\n        if (isInitOrUpdateAction && !hasMigration) {\n          return;\n        }\n\n        for (const { key, engine } of this._keysManager.getKeysWithEngines()) {\n          if (!engine) continue;\n\n          let storedValue = nextState;\n\n          const storageKey = getStorageKey(key, this._options);\n\n          if (key !== ɵDEFAULT_STATE_KEY) {\n            storedValue = getValue(nextState, key);\n          }\n\n          try {\n            const newStoredValue = this._options.beforeSerialize!(storedValue, key);\n            engine.setItem(storageKey, this._options.serialize!(newStoredValue));\n          } catch (error: any) {\n            if (typeof ngDevMode !== 'undefined' && ngDevMode) {\n              if (\n                error &&\n                (error.name === 'QuotaExceededError' ||\n                  error.name === 'NS_ERROR_DOM_QUOTA_REACHED')\n              ) {\n                console.error(\n                  `The ${storageKey} store value exceeds the browser storage quota: `,\n                  storedValue\n                );\n              } else {\n                console.error(\n                  `Error ocurred while serializing the ${storageKey} store value, value not updated, the value obtained from the store: `,\n                  storedValue\n                );\n              }\n            }\n          }\n        }\n      })\n    );\n  }\n\n  private _hydrateSelectivelyOnUpdate(storedValue: any, addedStates: ɵPlainObject) {\n    // The `UpdateState` action is triggered whenever a feature state is added.\n    // The condition below is only satisfied when this action is triggered.\n    // Let's consider two states: `counter` and `@ngxs/router-plugin` state.\n    // When `provideStore` is called, `CounterState` is provided at the root level,\n    // while `@ngxs/router-plugin` is provided as a feature state. Previously, the storage\n    // plugin might have stored the value of the counter state as `10`. If `CounterState`\n    // implements the `ngxsOnInit` hook and sets the state to `999`, the storage plugin will\n    // reset the entire state when the `RouterState` is registered.\n    // Consequently, the `counter` state will revert back to `10` instead of `999`.\n\n    if (!storedValue || !addedStates || Object.keys(addedStates).length === 0) {\n      // Nothing to update if `addedStates` object is empty.\n      return storedValue;\n    }\n\n    // The `storedValue` can be the entire state when the default state key\n    // is used. However, if `addedStates` only contains the `router` value,\n    // we only want to merge the state with that `router` value.\n    // Given the `storedValue` is an object:\n    // `{ counter: 10, router: {...} }`\n    // This will only select the `router` object from the `storedValue`,\n    // avoiding unnecessary rehydration of the `counter` state.\n    return Object.keys(addedStates).reduce(\n      (accumulator, addedState) => {\n        if (ɵhasOwnProperty(storedValue, addedState)) {\n          accumulator[addedState] = storedValue[addedState];\n        }\n        return accumulator;\n      },\n      <ɵPlainObject>{}\n    );\n  }\n}\n\nconst DOT = '.';\n","import {\n  NgModule,\n  ModuleWithProviders,\n  EnvironmentProviders,\n  makeEnvironmentProviders\n} from '@angular/core';\nimport { withNgxsPlugin } from '@ngxs/store';\nimport {\n  ɵUSER_OPTIONS,\n  STORAGE_ENGINE,\n  ɵNGXS_STORAGE_PLUGIN_OPTIONS,\n  NgxsStoragePluginOptions\n} from '@ngxs/storage-plugin/internals';\n\nimport { NgxsStoragePlugin } from './storage.plugin';\nimport { engineFactory, storageOptionsFactory } from './internals';\nimport { ɵNgxsStoragePluginKeysManager } from './keys-manager';\n\n/**\n * @deprecated Use `withNgxsStoragePlugin()` instead.\n */\n@NgModule()\nexport class NgxsStoragePluginModule {\n  /**\n   * @deprecated Use `withNgxsStoragePlugin()` instead.\n   */\n  static forRoot(\n    options: NgxsStoragePluginOptions\n  ): ModuleWithProviders<NgxsStoragePluginModule> {\n    return {\n      ngModule: NgxsStoragePluginModule,\n      providers: [\n        ɵNgxsStoragePluginKeysManager,\n        withNgxsPlugin(NgxsStoragePlugin),\n        {\n          provide: ɵUSER_OPTIONS,\n          useValue: options\n        },\n        {\n          provide: ɵNGXS_STORAGE_PLUGIN_OPTIONS,\n          useFactory: storageOptionsFactory,\n          deps: [ɵUSER_OPTIONS]\n        },\n        {\n          provide: STORAGE_ENGINE,\n          useFactory: engineFactory,\n          deps: [ɵNGXS_STORAGE_PLUGIN_OPTIONS]\n        }\n      ]\n    };\n  }\n}\n\nexport function withNgxsStoragePlugin(\n  options: NgxsStoragePluginOptions\n): EnvironmentProviders {\n  return makeEnvironmentProviders([\n    ɵNgxsStoragePluginKeysManager,\n    withNgxsPlugin(NgxsStoragePlugin),\n    {\n      provide: ɵUSER_OPTIONS,\n      useValue: options\n    },\n    {\n      provide: ɵNGXS_STORAGE_PLUGIN_OPTIONS,\n      useFactory: storageOptionsFactory,\n      deps: [ɵUSER_OPTIONS]\n    },\n    {\n      provide: STORAGE_ENGINE,\n      useFactory: engineFactory,\n      deps: [ɵNGXS_STORAGE_PLUGIN_OPTIONS]\n    }\n  ]);\n}\n","import { inject, EnvironmentProviders, provideEnvironmentInitializer } from '@angular/core';\nimport { StorageKey, ɵALL_STATES_PERSISTED } from '@ngxs/storage-plugin/internals';\n\nimport { ɵNgxsStoragePluginKeysManager } from './keys-manager';\n\ndeclare const ngDevMode: boolean;\n\nexport function withStorageFeature(storageKeys: StorageKey[]): EnvironmentProviders {\n  return provideEnvironmentInitializer(() => {\n    const allStatesPersisted = inject(ɵALL_STATES_PERSISTED);\n\n    if (allStatesPersisted) {\n      if (typeof ngDevMode !== 'undefined' && ngDevMode) {\n        const message =\n          'The NGXS storage plugin is currently persisting all states because the `keys` ' +\n          'option was explicitly set to `*` at the root level. To selectively persist states, ' +\n          'consider explicitly specifying them, allowing for addition at the feature level.';\n\n        console.error(message);\n      }\n\n      // We should prevent the addition of any feature states to persistence\n      // if the `keys` property is set to `*`, as this could disrupt the algorithm\n      // used in the storage plugin. Instead, we should log an error in development\n      // mode. In production, it should continue to function, but act as a no-op.\n      return;\n    }\n\n    inject(ɵNgxsStoragePluginKeysManager).addKeys(storageKeys);\n  });\n}\n","import { InjectionToken } from '@angular/core';\nimport { StorageEngine } from '@ngxs/storage-plugin/internals';\n\ndeclare const ngDevMode: boolean;\ndeclare const ngServerMode: boolean;\n\nexport const LOCAL_STORAGE_ENGINE = /* @__PURE__ */ new InjectionToken<StorageEngine | null>(\n  typeof ngDevMode !== 'undefined' && ngDevMode ? 'LOCAL_STORAGE_ENGINE' : '',\n  {\n    factory: () => (typeof ngServerMode !== 'undefined' && ngServerMode ? null : localStorage)\n  }\n);\n\nexport const SESSION_STORAGE_ENGINE = /* @__PURE__ */ new InjectionToken<StorageEngine | null>(\n  typeof ngDevMode !== 'undefined' && ngDevMode ? 'SESSION_STORAGE_ENGINE' : '',\n  {\n    factory: () =>\n      typeof ngServerMode !== 'undefined' && ngServerMode ? null : sessionStorage\n  }\n);\n","/**\n * The public api for consumers of @ngxs/storage-plugin\n */\nexport * from './src/public_api';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":["ɵDEFAULT_STATE_KEY","ɵNGXS_STORAGE_PLUGIN_OPTIONS","ɵextractStringKey","ɵisKeyWithExplicitEngine","ɵisEngineFactory","ɵALL_STATES_PERSISTED","ɵhasOwnProperty","ɵUSER_OPTIONS"],"mappings":"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"}

package/index.d.ts

@@ -1,10 +1,16 @@
 import * as i0 from '@angular/core';
-import { InjectionToken, ModuleWithProviders, EnvironmentProviders } from '@angular/core';
-import { StorageEngine, NgxsStoragePluginOptions, StorageKey } from '@ngxs/storage-plugin/internals';
+import { ModuleWithProviders, EnvironmentProviders, InjectionToken } from '@angular/core';
+import { NgxsStoragePluginOptions, StorageKey, StorageEngine } from '@ngxs/storage-plugin/internals';
 export { NgxsStoragePluginOptions, STORAGE_ENGINE, StorageEngine, StorageOption } from '@ngxs/storage-plugin/internals';
 import { NgxsPlugin, NgxsNextPluginFn } from '@ngxs/store/plugins';
 
+/**
+ * @deprecated Use `withNgxsStoragePlugin()` instead.
+ */
 declare class NgxsStoragePluginModule {
+    /**
+     * @deprecated Use `withNgxsStoragePlugin()` instead.
+     */
     static forRoot(options: NgxsStoragePluginOptions): ModuleWithProviders<NgxsStoragePluginModule>;
     static ɵfac: i0.ɵɵFactoryDeclaration<NgxsStoragePluginModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<NgxsStoragePluginModule, never, never, never>;
@@ -15,6 +21,7 @@ declare function withNgxsStoragePlugin(options: NgxsStoragePluginOptions): Envir
 declare function withStorageFeature(storageKeys: StorageKey[]): EnvironmentProviders;
 
 declare class NgxsStoragePlugin implements NgxsPlugin {
+    private _injector;
     private _keysManager;
     private _options;
     private _allStatesPersisted;

package/internals/index.d.ts

@@ -1,14 +1,16 @@
-import { InjectionToken, Type } from '@angular/core';
+import { Type, InjectionToken } from '@angular/core';
 import { StateToken } from '@ngxs/store';
 import { ɵStateClass as _StateClass } from '@ngxs/store/internals';
 
 /** This enables the user to provide a storage engine per individual key. */
 interface KeyWithExplicitEngine {
     key: string | _StateClass | StateToken<any>;
-    engine: Type<StorageEngine> | InjectionToken<StorageEngine>;
+    engine: Type<StorageEngine> | InjectionToken<StorageEngine> | (() => StorageEngine);
 }
 /** Determines whether the provided key has the following structure. */
 declare function ɵisKeyWithExplicitEngine(key: any): key is KeyWithExplicitEngine;
+/** Determines whether the engine is a factory function rather than a class or InjectionToken. */
+declare function ɵisEngineFactory(engine: Type<StorageEngine> | InjectionToken<StorageEngine> | (() => StorageEngine)): engine is () => StorageEngine;
 /**
  * This tuples all of the possible types allowed in the `key` property.
  * This is not exposed publicly and used internally only.
@@ -92,5 +94,5 @@ interface StorageEngine {
     setItem(key: string, value: any): void;
 }
 
-export { STORAGE_ENGINE, StorageOption, ɵALL_STATES_PERSISTED, ɵDEFAULT_STATE_KEY, ɵNGXS_STORAGE_PLUGIN_OPTIONS, ɵUSER_OPTIONS, ɵextractStringKey, ɵisKeyWithExplicitEngine };
+export { STORAGE_ENGINE, StorageOption, ɵALL_STATES_PERSISTED, ɵDEFAULT_STATE_KEY, ɵNGXS_STORAGE_PLUGIN_OPTIONS, ɵUSER_OPTIONS, ɵextractStringKey, ɵisEngineFactory, ɵisKeyWithExplicitEngine };
 export type { KeyWithExplicitEngine, NgxsStoragePluginOptions, StorageEngine, StorageKey, ɵNgxsTransformedStoragePluginOptions };

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@ngxs/storage-plugin",
   "description": "extendable storage plugin for @ngxs/store",
-  "version": "21.0.0",
+  "version": "22.0.0",
   "sideEffects": false,
   "peerDependencies": {
-    "@ngxs/store": "^21.0.0 || ^21.0.0-dev",
-    "@angular/core": ">=21.0.0 <22.0.0",
+    "@ngxs/store": "^22.0.0 || ^22.0.0-dev",
+    "@angular/core": ">=22.0.0 <23.0.0",
     "rxjs": ">=7.0.0",
-    "ts-morph": "21.0.1"
+    "ts-morph": ">=21.0.0"
   },
   "schematics": "./schematics/collection.json",
   "module": "fesm2022/ngxs-storage-plugin.mjs",
@@ -47,18 +47,9 @@
   ],
   "author": "Austin McDaniel",
   "contributors": [
-    {
-      "name": "Danny Blue"
-    },
-    {
-      "name": "Leon Radley"
-    },
     {
       "name": "Mark Whitfeld"
     },
-    {
-      "name": "Maxim Ivanov"
-    },
     {
       "name": "Artur Androsovych"
     }
@@ -72,4 +63,4 @@
     "type": "opencollective",
     "url": "https://opencollective.com/ngxs"
   }
-}
+}