@equinor/fusion-framework-app 11.0.11 → 12.0.0

package/CHANGELOG.md

@@ -1,5 +1,59 @@
 # Change Log
 
+## 12.0.0
+
+### Minor Changes
+
+- b92698d: Add state management module support to @equinor/fusion-framework-app
+
+  This change introduces comprehensive state management capabilities to the app package, allowing developers to easily enable persistent state storage in their Fusion applications.
+
+  **Features**
+
+  - **State Module Enabler**: Added `enableState` function that configures the state module with PouchDB storage
+  - **Package Exports**: Added new export path `./enable-state` for the state enabler function
+  - **Type Definitions**: Added typesVersions support for the new state enabler
+  - **Peer Dependencies**: Added `@equinor/fusion-framework-module-state` as an optional peer dependency
+  - **Storage Configuration**: Automatic app-scoped storage with key prefixing to prevent state collisions
+
+  **Usage**
+
+  Applications can now enable state management by:
+
+  ```typescript
+  import { enableState } from "@equinor/fusion-framework-app/enable-state";
+
+  export const configure = (configurator) => {
+    enableState(configurator);
+  };
+  ```
+
+  The state module provides persistent storage with automatic app-key scoping and uses PouchDB for reliable data persistence across browser sessions.
+
+  **Note**: Applications must install `@equinor/fusion-framework-module-state` to use this functionality.
+
+### Patch Changes
+
+- Updated dependencies [0d6ef3a]
+- Updated dependencies [020d9e5]
+- Updated dependencies [0d9d876]
+- Updated dependencies [05586e7]
+- Updated dependencies [b92698d]
+- Updated dependencies [b92698d]
+  - @equinor/fusion-framework-module-state@1.0.0
+  - @equinor/fusion-framework-module@6.1.2
+  - @equinor/fusion-framework@8.0.13
+  - @equinor/fusion-framework-module-telemetry@7.0.2
+
+## 11.0.12
+
+### Patch Changes
+
+- Updated dependencies [de2b4fb]
+  - @equinor/fusion-framework-module-app@8.0.4
+  - @equinor/fusion-framework-module-http@8.0.5
+  - @equinor/fusion-framework@8.0.12
+
 ## 11.0.11
 
 ### Patch Changes

package/README.md

@@ -1,4 +1,15 @@
-# @equinor/fusion-framework-app
+---
+title: "@equinor/fusion-framework-app"
+description: "Application foundation package for the Fusion Framework"
+category: "Application"
+tag:
+  - app
+  - core
+  - foundation
+  - modules
+  - framework
+  - typescript
+---
 
 Configuration and initialization layer for Fusion applications.
 
@@ -16,6 +27,32 @@ pnpm add @equinor/fusion-framework-app
 ```
 
 ## Quick Start
+```typescript
+import type { AppModuleInitiator } from '@equinor/fusion-framework-app';
+import { enableState } from '@equinor/fusion-framework-app/enable-state';
+
+const configure: AppModuleInitiator = (configurator) => {
+    enableState(configurator);
+};
+```
+
+> [!CAUTION]
+> The state management module is a powerful tool, but it's important to know the potential pitfalls and limitations when using it in your application. The state management is global and can lead to unexpected behavior if not used carefully.
+>
+> __example 1:__ If you have multiple components that rely on the same state, updating the state in one component can cause re-renders in all components that use that state, potentially leading to performance issues.
+>
+> __example 2:__ The user has open multiple tabs of the application, and each tab is modifying the same state. This can lead to unexpected behavior, as changes made in one tab will be reflected to all tabs. (like storing user preferences for selected columns)
+
+#### Bookmarks
+
+[<img src="https://img.shields.io/github/package-json/v/equinor/fusion-framework?filename=packages%2Fmodules%2Fbookmark%2Fpackage.json&label=@equinor/fusion-framework-module-bookmark&style=for-the-badge" />](https://github.com/equinor/fusion-framework/tree/main/packages/modules/bookmark)
+
+_The bookmark module provides a way to save and restore the state of the application. This is useful for saving the state of the application when the user navigates away from the application and then returns to the application._
+
+```sh
+# Install the bookmark module
+pnpm add @equinor/fusion-framework-module-bookmark
+```
 
 ```ts
 import { configureModules } from '@equinor/fusion-framework-app';

package/dist/esm/AppConfigurator.js

@@ -2,13 +2,16 @@ import { ModulesConfigurator, } from '@equinor/fusion-framework-module';
 import event from '@equinor/fusion-framework-module-event';
 import http, { configureHttpClient, configureHttp, } from '@equinor/fusion-framework-module-http';
 import auth from '@equinor/fusion-framework-module-msal';
+import { AppModulesConfiguredEvent } from './AppModulesConfiguredEvent';
+import { AppConfiguratorError } from './AppConfiguratorError';
+import { deepClone, deepFreeze } from './utils';
 /**
  * Configurator that bootstraps default Fusion application modules and provides
  * helper methods for HTTP client and service-discovery setup.
  *
  * `AppConfigurator` is created internally by {@link configureModules}. It registers
  * the `event`, `http`, and `msal` (auth) modules by default and reads any HTTP
- * endpoints declared in the application’s environment config.
+ * endpoints declared in the application's environment config.
  *
  * @template TModules - Additional application-specific modules beyond the defaults.
  * @template TRef - The resolved Fusion modules instance used as an initialization reference.
@@ -31,6 +34,7 @@ export class AppConfigurator extends ModulesConfigurator {
      * the name is preserved through compilation and minification.
      */
     static className = 'AppConfigurator';
+    #manifest;
     /**
      * Create an application configurator with default modules and environment.
      *
@@ -38,11 +42,32 @@ export class AppConfigurator extends ModulesConfigurator {
      * HTTP clients declared in `env.config.endpoints`.
      *
      * @param env - The application environment containing manifest, config, and optional basename.
+     * @param ref - Optional reference to the Fusion modules instance, used for event dispatching.
      */
-    constructor(env) {
+    constructor(env, ref) {
         super([event, http, auth]);
         this.env = env;
+        this.#manifest = deepFreeze(deepClone(env.manifest));
         this._configureHttpClientsFromAppConfig();
+        this.onConfigured((configs) => {
+            const configuredEvent = new AppModulesConfiguredEvent({
+                detail: {
+                    appKey: this.#manifest.appKey,
+                    configs,
+                },
+            });
+            ref?.event.dispatchEvent(configuredEvent);
+        });
+    }
+    /**
+     * The immutable application manifest.
+     *
+     * Deeply frozen at construction time to prevent accidental mutations.
+     *
+     * @returns The deeply immutable application manifest.
+     */
+    get manifest() {
+        return this.#manifest;
     }
     /**
      * Read HTTP endpoint definitions from the application config and register each
@@ -102,7 +127,7 @@ export class AppConfigurator extends ModulesConfigurator {
                 const service = await ref?.serviceDiscovery.resolveService(serviceName);
                 // Guard: service must resolve before the HTTP client can be configured.
                 if (!service) {
-                    throw Error(`failed to configure service [${serviceName}]`);
+                    throw new AppConfiguratorError(`Unable to resolve service [${serviceName}] during configuration.`, 'configuration');
                 }
                 // Check if serviceName is already configured (potentially with app-config)
                 // If the service is session overridden - we need the configuration to run

package/dist/esm/AppConfigurator.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppConfigurator.js","sourceRoot":"","sources":["../../src/AppConfigurator.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,mBAAmB,GACpB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,KAAK,MAAM,wCAAwC,CAAC;AAE3D,OAAO,IAAI,EAAE,EACX,mBAAmB,EACnB,aAAa,GAEd,MAAM,uCAAuC,CAAC;AAE/C,OAAO,IAAI,MAAM,uCAAuC,CAAC;AAgFzD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,eAKX,SAAQ,mBAA+C;IAiB3B,GAAG;IAd/B;;;OAGG;IACH,MAAM,CAAU,SAAS,GAAW,iBAAiB,CAAC;IAEtD;;;;;;;OAOG;IACH,YAA4B,GAAS;QACnC,KAAK,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;mBADD,GAAG;QAG7B,IAAI,CAAC,kCAAkC,EAAE,CAAC;IAC5C,CAAC;IAED;;;;;;OAMG;IACO,kCAAkC;QAC1C,MAAM,EAAE,SAAS,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;QACjD,8EAA8E;QAC9E,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/D,IAAI,CAAC,mBAAmB,CAAC,GAAG,EAAE;gBAC5B,OAAO,EAAE,GAAG;gBACZ,aAAa,EAAE,MAAM;aACtB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,mDAAmD;IAC5C,aAAa,CAAC,GAAG,IAAsC;QAC5D,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,yDAAyD;IAClD,mBAAmB,CAAC,GAAG,IAA4C;QACxE,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACI,yBAAyB,CAC9B,WAAmB;IACnB,6HAA6H;IAC7H,OAAmE;QAEnE,IAAI,CAAC,SAAS,CAAC;YACb,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;gBAC/B,iEAAiE;gBACjE,MAAM,OAAO,GAAG,MAAM,GAAG,EAAE,gBAAgB,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;gBACxE,wEAAwE;gBACxE,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,MAAM,KAAK,CAAC,gCAAgC,WAAW,GAAG,CAAC,CAAC;gBAC9D,CAAC;gBAED,2EAA2E;gBAC3E,0EAA0E;gBAC1E,uCAAuC;gBACvC,IAAI,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;oBACzD,OAAO,CAAC,IAAI,CACV,GAAG,WAAW;;oCAEU,CACzB,CAAC;oBACF,OAAO;gBACT,CAAC;gBACD,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE;oBAClC,GAAG,OAAO;oBACV,OAAO,EAAE,OAAO,CAAC,GAAG;oBACpB,aAAa,EAAE,OAAO,CAAC,aAAa;iBACrC,CAAC,CAAC;YACL,CAAC;SACF,CAAC,CAAC;IACL,CAAC;CACF;AAED,eAAe,eAAe,CAAC"}
+{"version":3,"file":"AppConfigurator.js","sourceRoot":"","sources":["../../src/AppConfigurator.ts"],"names":[],"mappings":"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"}

package/dist/esm/AppConfiguratorError.js

@@ -0,0 +1,32 @@
+/**
+ * Custom error class for application configurator errors.
+ *
+ * Provides error context to help developers debug configuration and initialization issues.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   const modules = await initialize({ fusion, env });
+ * } catch (error) {
+ *   if (error instanceof AppConfiguratorError) {
+ *     console.log(`Error in ${error.phase}: ${error.message}`);
+ *   }
+ * }
+ * ```
+ */
+export class AppConfiguratorError extends Error {
+    phase;
+    /**
+     * @param message - Human-readable error description
+     * @param phase - The phase where the error occurred
+     * @param cause - The underlying error that caused this failure
+     */
+    constructor(message, phase, cause) {
+        super(message);
+        this.phase = phase;
+        this.name = 'AppConfiguratorError';
+        this.cause = cause;
+    }
+}
+export default AppConfiguratorError;
+//# sourceMappingURL=AppConfiguratorError.js.map

package/dist/esm/AppConfiguratorError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppConfiguratorError.js","sourceRoot":"","sources":["../../src/AppConfiguratorError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAQ3B,KAAK;IAPvB;;;;OAIG;IACH,YACE,OAAe,EACC,KAAyC,EACzD,KAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;qBAHC,KAAK;QAIrB,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED,eAAe,oBAAoB,CAAC"}

package/dist/esm/AppModulesConfiguredEvent.js

@@ -0,0 +1,18 @@
+import { FrameworkEvent } from '@equinor/fusion-framework-module-event';
+/**
+ * Event emitted when application modules have been configured.
+ *
+ * @template T - An array of additional modules configured in the application.
+ * @extends FrameworkEvent<AppModulesConfiguredEventInit<T>>
+ */
+export class AppModulesConfiguredEvent extends FrameworkEvent {
+    /**
+     * Create an event describing configured application modules.
+     *
+     * @param init - Event initialization data containing the application key and module configs.
+     */
+    constructor(init) {
+        super('onAppModulesConfigured', init);
+    }
+}
+//# sourceMappingURL=AppModulesConfiguredEvent.js.map

package/dist/esm/AppModulesConfiguredEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppModulesConfiguredEvent.js","sourceRoot":"","sources":["../../src/AppModulesConfiguredEvent.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAA2B,MAAM,wCAAwC,CAAC;AAgBjG;;;;;GAKG;AACH,MAAM,OAAO,yBAEX,SAAQ,cAAgD;IACxD;;;;OAIG;IACH,YAAY,IAAsC;QAChD,KAAK,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/esm/AppModulesInitializedEvent.js

@@ -0,0 +1,23 @@
+import { FrameworkEvent } from '@equinor/fusion-framework-module-event';
+/**
+ * Event triggered when application modules have been initialized.
+ *
+ * @template T - An array of modules extending `AnyModule`. Defaults to an empty array.
+ * @extends FrameworkEvent<AppModulesInitializedEventInit<T>>
+ *
+ * @example
+ * ```typescript
+ * const event = new AppModulesInitializedEvent({ modules: [...] });
+ * ```
+ */
+export class AppModulesInitializedEvent extends FrameworkEvent {
+    /**
+     * Create an event describing initialized application modules.
+     *
+     * @param init - Event initialization data containing the application key and module instance.
+     */
+    constructor(init) {
+        super('onAppModulesInitialized', init);
+    }
+}
+//# sourceMappingURL=AppModulesInitializedEvent.js.map

package/dist/esm/AppModulesInitializedEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppModulesInitializedEvent.js","sourceRoot":"","sources":["../../src/AppModulesInitializedEvent.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAA2B,MAAM,wCAAwC,CAAC;AAejG;;;;;;;;;;GAUG;AACH,MAAM,OAAO,0BAEX,SAAQ,cAAiD;IACzD;;;;OAIG;IACH,YAAY,IAAuC;QACjD,KAAK,CAAC,yBAAyB,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;CACF"}

package/dist/esm/configure-modules.js

@@ -1,3 +1,9 @@
+/**
+ * @fileoverview Application module configuration factory
+ *
+ * Provides the core factory function for configuring and initializing
+ * application-specific modules in the Fusion framework.
+ */
 import { enableTelemetry, } from '@equinor/fusion-framework-module-telemetry';
 import { AppConfigurator } from './AppConfigurator';
 /**

package/dist/esm/configure-modules.js.map

@@ -1 +1 @@
-{"version":3,"file":"configure-modules.js","sourceRoot":"","sources":["../../src/configure-modules.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,eAAe,GAEhB,MAAM,4CAA4C,CAAC;AAEpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAC3B,CAKE,EAA6C,EACmC,EAAE;AACpF;;;;;;;GAOG;AACH,KAAK,EAAE,IAAiC,EAAyC,EAAE;IACjF,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAExB,0BAA0B;IAC1B,MAAM,YAAY,GAAG,IAAI,eAAe,CAAkC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEpF,0EAA0E;IAC1E,MAAM,iBAAiB,GAAsB,GAAG,EAAE;QAChD,OAAO;YACL,MAAM,EAAE;gBACN,IAAI,EAAE,eAAe;gBACrB,GAAG,EAAE;oBACH,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,aAAa;oBAC/C,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,IAAI,iBAAiB;iBAChE;aACF;SACF,CAAC;IACJ,CAAC,CAAC;IAEF,8DAA8D;IAC9D,sFAAsF;IACtF,eAAe,CAAC,YAAY,EAAE;QAC5B,wBAAwB,EAAE,IAAI;QAC9B,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;YACrB,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;YACvC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAC5C,kEAAkE;YAClE,OAAO,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACnC,CAAC;KACF,CAAC,CAAC;IAEH,wEAAwE;IACxE,IAAI,EAAE,EAAE,CAAC;QACP,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,kFAAkF;IAClF,gFAAgF;IAChF,+EAA+E;IAC/E,qFAAqF;IACrF,MAAM,OAAO,GAAiC,CAAC,MAAM,YAAY,CAAC,UAAU,CAC1E,IAAI,CAAC,MAAM,CAAC,OAAO,CACpB,CAA4C,CAAC;IAE9C,+DAA+D;IAC/D,kGAAkG;IAClG,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,oBAAoB,EAAE;YAChD,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE;SACnF,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEJ,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"configure-modules.js","sourceRoot":"","sources":["../../src/configure-modules.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EACL,eAAe,GAEhB,MAAM,4CAA4C,CAAC;AAEpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAC3B,CAKE,EAA6C,EACmC,EAAE;AACpF;;;;;;;GAOG;AACH,KAAK,EAAE,IAAiC,EAAyC,EAAE;IACjF,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAExB,0BAA0B;IAC1B,MAAM,YAAY,GAAG,IAAI,eAAe,CAAkC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEpF,0EAA0E;IAC1E,MAAM,iBAAiB,GAAsB,GAAG,EAAE;QAChD,OAAO;YACL,MAAM,EAAE;gBACN,IAAI,EAAE,eAAe;gBACrB,GAAG,EAAE;oBACH,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,aAAa;oBAC/C,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,IAAI,iBAAiB;iBAChE;aACF;SACF,CAAC;IACJ,CAAC,CAAC;IAEF,8DAA8D;IAC9D,sFAAsF;IACtF,eAAe,CAAC,YAAY,EAAE;QAC5B,wBAAwB,EAAE,IAAI;QAC9B,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;YACrB,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;YACvC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAC5C,kEAAkE;YAClE,OAAO,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACnC,CAAC;KACF,CAAC,CAAC;IAEH,wEAAwE;IACxE,IAAI,EAAE,EAAE,CAAC;QACP,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,kFAAkF;IAClF,gFAAgF;IAChF,+EAA+E;IAC/E,qFAAqF;IACrF,MAAM,OAAO,GAAiC,CAAC,MAAM,YAAY,CAAC,UAAU,CAC1E,IAAI,CAAC,MAAM,CAAC,OAAO,CACpB,CAA4C,CAAC;IAE9C,+DAA+D;IAC/D,kGAAkG;IAClG,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,oBAAoB,EAAE;YAChD,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE;SACnF,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEJ,eAAe,gBAAgB,CAAC"}

package/dist/esm/enable-state.js

@@ -0,0 +1,42 @@
+import { enableStateModule } from '@equinor/fusion-framework-module-state';
+/**
+ * Enables state management for the application with persistent storage.
+ *
+ * This is a thin, app-scoped convenience wrapper around `enableStateModule` — it registers
+ * the state module on the app's configurator so app code can reach it via the app namespace,
+ * and scopes the module's default storage to this app's own `manifest.appKey` (so unrelated
+ * apps or widgets hosted alongside it never share its state). The state module resolves a
+ * local PouchDB database, optionally synced with the Fusion App State backend when service
+ * discovery and auth are configured; call `setStorage` on the configurator to override it.
+ *
+ * @warning Local storage is NOT encrypted. Do not store sensitive data such as passwords,
+ * tokens, personal information, or any data that requires security protection.
+ *
+ * @see {@link https://github.com/equinor/fusion-framework/blob/main/packages/modules/state/README.md | State Module Documentation} for comprehensive usage examples and API reference.
+ *
+ * @template M - Array of modules to be configured.
+ * @template R - The fusion modules instance type.
+ * @param configurator - The application configurator to enable state management on.
+ * @param configure - Optional config callback, receiving the module's `IStateModuleConfigurator`.
+ *
+ * @example
+ * ```typescript
+ * import { enableState } from '@equinor/fusion-framework-app';
+ *
+ * export const configure = (configurator) => {
+ *   enableState(configurator);
+ * };
+ *
+ * // Later in your app, access the state provider
+ * const stateProvider = modules.state;
+ * await stateProvider.storeItem({ key: 'user-preference', value: { theme: 'dark' } });
+ * const item = await stateProvider.getItem('user-preference');
+ * ```
+ */
+export function enableState(configurator, configure) {
+    enableStateModule(configurator, async (builder) => {
+        builder.setName(configurator.manifest.appKey);
+        await configure?.(builder);
+    });
+}
+//# sourceMappingURL=enable-state.js.map

package/dist/esm/enable-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enable-state.js","sourceRoot":"","sources":["../../src/enable-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAM3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,WAAW,CACzB,YAAoC,EACpC,SAAuE;IAEvE,iBAAiB,CAAC,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChD,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/esm/index.js

@@ -18,6 +18,9 @@
 export { AppConfigurator } from './AppConfigurator';
 export * from './types';
 export { configureModules, default } from './configure-modules';
+export { AppConfiguratorError } from './AppConfiguratorError';
+export { AppModulesConfiguredEvent } from './AppModulesConfiguredEvent';
+export { AppModulesInitializedEvent } from './AppModulesInitializedEvent';
 /**
  * @deprecated Use {@link configureModules} instead. This alias will be removed in a future major version.
  */

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,eAAe,EAAoB,MAAM,mBAAmB,CAAC;AAEtE,cAAc,SAAS,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEhE;;GAEG;AACH,OAAO,EAAE,gBAAgB,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,eAAe,EAAgD,MAAM,mBAAmB,CAAC;AAElG,cAAc,SAAS,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAExE,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE1E;;GAEG;AACH,OAAO,EAAE,gBAAgB,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/esm/utils.js

@@ -0,0 +1,41 @@
+export { default as deepClone } from 'lodash.clonedeep';
+/**
+ * Determines if the provided object is eligible to be frozen.
+ *
+ * Checks whether the input is a non-null object or array that is not already frozen.
+ *
+ * @param obj - The value to check for isMutable.
+ * @returns True if the object is a non-null object or array and is not already frozen; otherwise, false.
+ */
+function isMutable(obj) {
+    return typeof obj === 'object' && obj !== null && !Object.isFrozen(obj);
+}
+/**
+ * Recursively applies Object.freeze to an object and all nested properties, making them immutable.
+ *
+ * @remarks
+ * - Plain objects and arrays are deeply frozen.
+ * - Does not handle circular references. Use with caution on complex object graphs.
+ * - Symbol properties are not frozen.
+ *
+ * @template T - The type of the object to freeze.
+ * @param obj - The object to deeply freeze.
+ * @returns The deeply frozen (read-only) object.
+ */
+export function deepFreeze(source) {
+    // Skip primitives and objects already frozen to avoid unnecessary recursion.
+    if (isMutable(source)) {
+        // Arrays require traversing their values directly before freezing the container.
+        if (Array.isArray(source)) {
+            // Freeze every nested array value so the result is immutable at every depth.
+            source.forEach(deepFreeze);
+        }
+        else {
+            // Freeze every nested object value so the result is immutable at every depth.
+            Object.values(source).forEach(deepFreeze);
+        }
+        Object.freeze(source);
+    }
+    return source;
+}
+//# sourceMappingURL=utils.js.map

package/dist/esm/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAWxD;;;;;;;GAOG;AACH,SAAS,SAAS,CAAC,GAAY;IAC7B,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAC1E,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAI,MAAS;IACrC,6EAA6E;IAC7E,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,iFAAiF;QACjF,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,6EAA6E;YAC7E,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,8EAA8E;YAC9E,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC5C,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/esm/version.js

@@ -1,3 +1,3 @@
 // Generated by genversion.
-export const version = '11.0.11';
+export const version = '12.0.0';
 //# sourceMappingURL=version.js.map

package/dist/esm/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,MAAM,CAAC,MAAM,OAAO,GAAG,SAAS,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC"}