@equinor/fusion-framework-app 11.0.12 → 12.0.0

package/dist/types/AppConfigurator.d.ts

@@ -2,6 +2,13 @@ import type { FusionModulesInstance } from '@equinor/fusion-framework';
 import { type AnyModule, type IModulesConfigurator, ModulesConfigurator } from '@equinor/fusion-framework-module';
 import { configureHttpClient, configureHttp, type HttpClientOptions } from '@equinor/fusion-framework-module-http';
 import type { AppEnv, AppModules } from './types';
+import { type DeepImmutable } from './utils';
+/**
+ * Type definition for AppConfigurator constructor
+ */
+export type AppConfiguratorConstructor<TModules extends readonly AnyModule[] = [], TRef extends FusionModulesInstance = FusionModulesInstance, TEnv extends AppEnv = AppEnv> = {
+    new (env: TEnv, ref?: TRef): IAppConfigurator<TModules, TRef>;
+};
 /**
  * Contract for configuring Fusion application modules.
  *
@@ -25,6 +32,7 @@ import type { AppEnv, AppModules } from './types';
  * ```
  */
 export interface IAppConfigurator<TModules extends Array<AnyModule> | unknown = unknown, TRef extends FusionModulesInstance = FusionModulesInstance> extends IModulesConfigurator<AppModules<TModules>, TRef> {
+    readonly manifest: DeepImmutable<AppEnv['manifest']>;
     /**
      * Configure the HTTP module with custom settings.
      *
@@ -73,7 +81,7 @@ export interface IAppConfigurator<TModules extends Array<AnyModule> | unknown =
  *
  * `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.
@@ -90,6 +98,7 @@ export interface IAppConfigurator<TModules extends Array<AnyModule> | unknown =
  * ```
  */
 export declare class AppConfigurator<TModules extends Array<AnyModule> | unknown = unknown, TRef extends FusionModulesInstance = FusionModulesInstance, TEnv extends AppEnv = AppEnv> extends ModulesConfigurator<AppModules<TModules>, TRef> implements IAppConfigurator<TModules, TRef> {
+    #private;
     readonly env: TEnv;
     /**
      * The class name used for event naming. This static property ensures
@@ -103,8 +112,17 @@ export declare class AppConfigurator<TModules extends Array<AnyModule> | unknown
      * 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: TEnv, ref?: TRef);
+    /**
+     * The immutable application manifest.
+     *
+     * Deeply frozen at construction time to prevent accidental mutations.
+     *
+     * @returns The deeply immutable application manifest.
      */
-    constructor(env: TEnv);
+    get manifest(): DeepImmutable<AppEnv['manifest']>;
     /**
      * Read HTTP endpoint definitions from the application config and register each
      * one as a named HTTP client.

package/dist/types/AppConfiguratorError.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 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 declare class AppConfiguratorError extends Error {
+    readonly phase: 'configuration' | 'initialization';
+    /**
+     * @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: string, phase: 'configuration' | 'initialization', cause?: unknown);
+}
+export default AppConfiguratorError;

package/dist/types/AppModulesConfiguredEvent.d.ts

@@ -0,0 +1,37 @@
+import type { ModulesConfigType, AnyModule } from '@equinor/fusion-framework-module';
+import type { AppModules } from '@equinor/fusion-framework-module-app';
+import { FrameworkEvent, type FrameworkEventInit } from '@equinor/fusion-framework-module-event';
+import type { AppModulesInitializedEvent } from './AppModulesInitializedEvent';
+/**
+ * Represents the initialization data for an event indicating that application modules have been configured.
+ *
+ * @template T - Array of additional modules configured in the application.
+ * @extends FrameworkEventInit
+ * @property {string} appKey - The unique key identifying the application.
+ * @property {ModulesConfigType<AppModules<T>>} configs - The configuration objects for the specified application modules.
+ */
+type AppModulesConfiguredEventInit<T extends AnyModule[] | unknown = unknown> = FrameworkEventInit<{
+    appKey: string;
+    configs: ModulesConfigType<AppModules<T>>;
+}>;
+/**
+ * Event emitted when application modules have been configured.
+ *
+ * @template T - An array of additional modules configured in the application.
+ * @extends FrameworkEvent<AppModulesConfiguredEventInit<T>>
+ */
+export declare class AppModulesConfiguredEvent<T extends AnyModule[] | unknown = unknown> extends FrameworkEvent<AppModulesConfiguredEventInit<T>> {
+    /**
+     * Create an event describing configured application modules.
+     *
+     * @param init - Event initialization data containing the application key and module configs.
+     */
+    constructor(init: AppModulesConfiguredEventInit<T>);
+}
+declare module '@equinor/fusion-framework-module-event' {
+    interface FrameworkEventMap {
+        onAppModulesConfigured: AppModulesConfiguredEvent;
+        onAppModulesInitialized: AppModulesInitializedEvent;
+    }
+}
+export {};

package/dist/types/AppModulesInitializedEvent.d.ts

@@ -0,0 +1,34 @@
+import type { AnyModule } from '@equinor/fusion-framework-module';
+import type { AppModulesInstance } from '@equinor/fusion-framework-module-app';
+import { FrameworkEvent, type FrameworkEventInit } from '@equinor/fusion-framework-module-event';
+/**
+ * Event initialization type for the "AppModulesInitialized" event.
+ *
+ * @template T - An array of module types extending `AnyModule`. Defaults to an empty array.
+ * @property appKey - The unique key identifying the application.
+ * @property modules - The instance containing all initialized application modules.
+ */
+type AppModulesInitializedEventInit<T extends AnyModule[] | unknown = unknown> = FrameworkEventInit<{
+    appKey: string;
+    modules: AppModulesInstance<T>;
+}>;
+/**
+ * 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 declare class AppModulesInitializedEvent<T extends AnyModule[] | unknown = unknown> extends FrameworkEvent<AppModulesInitializedEventInit<T>> {
+    /**
+     * Create an event describing initialized application modules.
+     *
+     * @param init - Event initialization data containing the application key and module instance.
+     */
+    constructor(init: AppModulesInitializedEventInit<T>);
+}
+export {};

package/dist/types/configure-modules.d.ts

@@ -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 type { Fusion } from '@equinor/fusion-framework';
 import type { AnyModule } from '@equinor/fusion-framework-module';
 import type { AppModulesInstance, AppModuleInitiator, AppEnv } from './types';

package/dist/types/enable-state.d.ts

@@ -0,0 +1,39 @@
+import type { IStateModuleConfigurator } from '@equinor/fusion-framework-module-state';
+import type { IAppConfigurator } from './AppConfigurator';
+import type { AnyModule } from '@equinor/fusion-framework-module';
+import type { FusionModulesInstance } from '@equinor/fusion-framework';
+/**
+ * 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 declare function enableState<M extends AnyModule[], R extends FusionModulesInstance>(configurator: IAppConfigurator<M, R>, configure?: (builder: IStateModuleConfigurator) => void | Promise<void>): void;

package/dist/types/index.d.ts

@@ -15,9 +15,12 @@
  * Bookmark support is available via the `@equinor/fusion-framework-app/enable-bookmark`
  * sub-path export.
  */
-export { AppConfigurator, IAppConfigurator } from './AppConfigurator';
+export { AppConfigurator, IAppConfigurator, AppConfiguratorConstructor } 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/types/utils.d.ts

@@ -0,0 +1,22 @@
+export { default as deepClone } from 'lodash.clonedeep';
+/**
+ * Utility type that makes all properties of an object deeply readonly.
+ *
+ * @typeParam T - The type to make deeply readonly.
+ */
+export type DeepImmutable<T> = {
+    readonly [P in keyof T]: T[P] extends object ? DeepImmutable<T[P]> : T[P];
+};
+/**
+ * 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 declare function deepFreeze<T>(source: T): DeepImmutable<T>;

package/dist/types/version.d.ts

@@ -1 +1 @@
-export declare const version = "11.0.12";
+export declare const version = "12.0.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@equinor/fusion-framework-app",
-  "version": "11.0.12",
+  "version": "12.0.0",
   "description": "",
   "main": "dist/esm/index.js",
   "types": "./dist/types/index.d.ts",
@@ -9,6 +9,10 @@
       "types": "./dist/types/index.d.ts",
       "import": "./dist/esm/index.js"
     },
+    "./enable-state": {
+      "types": "./dist/types/enable-state.d.ts",
+      "import": "./dist/esm/enable-state.js"
+    },
     "./enable-bookmark": {
       "types": "./dist/types/enable-bookmark.d.ts",
       "import": "./dist/esm/enable-bookmark.js"
@@ -19,6 +23,9 @@
       ".": [
         "dist/types/index.d.ts"
       ],
+      "enable-state": [
+        "dist/types/enable-state.d.ts"
+      ],
       "enable-bookmark": [
         "dist/types/enable-bookmark.d.ts"
       ]
@@ -45,25 +52,32 @@
     "directory": "packages/app"
   },
   "dependencies": {
+    "lodash.clonedeep": "^4.5.0",
     "rxjs": "^7.8.1",
-    "@equinor/fusion-framework": "8.0.12",
-    "@equinor/fusion-framework-module": "6.1.1",
+    "@equinor/fusion-framework": "8.0.13",
     "@equinor/fusion-framework-module-app": "8.0.4",
     "@equinor/fusion-framework-module-event": "6.0.1",
-    "@equinor/fusion-framework-module-msal": "10.0.2",
     "@equinor/fusion-framework-module-http": "8.0.5",
-    "@equinor/fusion-framework-module-telemetry": "7.0.1"
+    "@equinor/fusion-framework-module": "6.1.2",
+    "@equinor/fusion-framework-module-msal": "10.0.2",
+    "@equinor/fusion-framework-module-telemetry": "7.0.2"
   },
   "devDependencies": {
+    "@types/lodash.clonedeep": "^4.5.9",
     "typescript": "^7.0.2",
-    "@equinor/fusion-framework-module-bookmark": "^4.0.4"
+    "@equinor/fusion-framework-module-bookmark": "^4.0.4",
+    "@equinor/fusion-framework-module-state": "^1.0.0"
   },
   "peerDependencies": {
-    "@equinor/fusion-framework-module-bookmark": "^4.0.4"
+    "@equinor/fusion-framework-module-bookmark": "^4.0.4",
+    "@equinor/fusion-framework-module-state": "^1.0.0"
   },
   "peerDependenciesMeta": {
     "@equinor/fusion-framework-module-bookmark": {
       "optional": true
+    },
+    "@equinor/fusion-framework-module-state": {
+      "optional": true
     }
   },
   "scripts": {

package/src/AppConfigurator.ts

@@ -17,6 +17,20 @@ import http, {
 import auth from '@equinor/fusion-framework-module-msal';
 
 import type { AppEnv, AppModules } from './types';
+import { AppModulesConfiguredEvent } from './AppModulesConfiguredEvent';
+import { AppConfiguratorError } from './AppConfiguratorError';
+import { deepClone, deepFreeze, type DeepImmutable } from './utils';
+
+/**
+ * Type definition for AppConfigurator constructor
+ */
+export type AppConfiguratorConstructor<
+  TModules extends readonly AnyModule[] = [],
+  TRef extends FusionModulesInstance = FusionModulesInstance,
+  TEnv extends AppEnv = AppEnv,
+> = {
+  new (env: TEnv, ref?: TRef): IAppConfigurator<TModules, TRef>;
+};
 
 /**
  * Contract for configuring Fusion application modules.
@@ -44,6 +58,8 @@ export interface IAppConfigurator<
   TModules extends Array<AnyModule> | unknown = unknown,
   TRef extends FusionModulesInstance = FusionModulesInstance,
 > extends IModulesConfigurator<AppModules<TModules>, TRef> {
+  readonly manifest: DeepImmutable<AppEnv['manifest']>;
+
   /**
    * Configure the HTTP module with custom settings.
    *
@@ -100,7 +116,7 @@ export interface IAppConfigurator<
  *
  * `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.
@@ -130,6 +146,8 @@ export class AppConfigurator<
    */
   static readonly className: string = 'AppConfigurator';
 
+  #manifest: DeepImmutable<AppEnv['manifest']>;
+
   /**
    * Create an application configurator with default modules and environment.
    *
@@ -137,11 +155,36 @@ export class AppConfigurator<
    * 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(public readonly env: TEnv) {
+  constructor(
+    public readonly env: TEnv,
+    ref?: TRef,
+  ) {
     super([event, http, auth]);
-
+    this.#manifest = deepFreeze(deepClone(env.manifest));
     this._configureHttpClientsFromAppConfig();
+
+    this.onConfigured((configs) => {
+      const configuredEvent = new AppModulesConfiguredEvent<TModules>({
+        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(): DeepImmutable<AppEnv['manifest']> {
+    return this.#manifest;
   }
 
   /**
@@ -207,7 +250,10 @@ export class AppConfigurator<
         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)

package/src/AppConfiguratorError.ts

@@ -0,0 +1,34 @@
+/**
+ * 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 {
+  /**
+   * @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: string,
+    public readonly phase: 'configuration' | 'initialization',
+    cause?: unknown,
+  ) {
+    super(message);
+    this.name = 'AppConfiguratorError';
+    this.cause = cause;
+  }
+}
+
+export default AppConfiguratorError;

package/src/AppModulesConfiguredEvent.ts

@@ -0,0 +1,43 @@
+import type { ModulesConfigType, AnyModule } from '@equinor/fusion-framework-module';
+import type { AppModules } from '@equinor/fusion-framework-module-app';
+import { FrameworkEvent, type FrameworkEventInit } from '@equinor/fusion-framework-module-event';
+import type { AppModulesInitializedEvent } from './AppModulesInitializedEvent';
+
+/**
+ * Represents the initialization data for an event indicating that application modules have been configured.
+ *
+ * @template T - Array of additional modules configured in the application.
+ * @extends FrameworkEventInit
+ * @property {string} appKey - The unique key identifying the application.
+ * @property {ModulesConfigType<AppModules<T>>} configs - The configuration objects for the specified application modules.
+ */
+type AppModulesConfiguredEventInit<T extends AnyModule[] | unknown = unknown> = FrameworkEventInit<{
+  appKey: string;
+  configs: ModulesConfigType<AppModules<T>>;
+}>;
+
+/**
+ * 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<
+  T extends AnyModule[] | unknown = unknown,
+> extends FrameworkEvent<AppModulesConfiguredEventInit<T>> {
+  /**
+   * Create an event describing configured application modules.
+   *
+   * @param init - Event initialization data containing the application key and module configs.
+   */
+  constructor(init: AppModulesConfiguredEventInit<T>) {
+    super('onAppModulesConfigured', init);
+  }
+}
+
+declare module '@equinor/fusion-framework-module-event' {
+  interface FrameworkEventMap {
+    onAppModulesConfigured: AppModulesConfiguredEvent;
+    onAppModulesInitialized: AppModulesInitializedEvent;
+  }
+}

package/src/AppModulesInitializedEvent.ts

@@ -0,0 +1,40 @@
+import type { AnyModule } from '@equinor/fusion-framework-module';
+import type { AppModulesInstance } from '@equinor/fusion-framework-module-app';
+import { FrameworkEvent, type FrameworkEventInit } from '@equinor/fusion-framework-module-event';
+
+/**
+ * Event initialization type for the "AppModulesInitialized" event.
+ *
+ * @template T - An array of module types extending `AnyModule`. Defaults to an empty array.
+ * @property appKey - The unique key identifying the application.
+ * @property modules - The instance containing all initialized application modules.
+ */
+type AppModulesInitializedEventInit<T extends AnyModule[] | unknown = unknown> =
+  FrameworkEventInit<{
+    appKey: string;
+    modules: AppModulesInstance<T>;
+  }>;
+
+/**
+ * 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<
+  T extends AnyModule[] | unknown = unknown,
+> extends FrameworkEvent<AppModulesInitializedEventInit<T>> {
+  /**
+   * Create an event describing initialized application modules.
+   *
+   * @param init - Event initialization data containing the application key and module instance.
+   */
+  constructor(init: AppModulesInitializedEventInit<T>) {
+    super('onAppModulesInitialized', init);
+  }
+}

package/src/configure-modules.ts

@@ -1,3 +1,10 @@
+/**
+ * @fileoverview Application module configuration factory
+ *
+ * Provides the core factory function for configuring and initializing
+ * application-specific modules in the Fusion framework.
+ */
+
 import type { Fusion } from '@equinor/fusion-framework';
 import type { AnyModule } from '@equinor/fusion-framework-module';
 import {
@@ -6,6 +13,7 @@ import {
 } from '@equinor/fusion-framework-module-telemetry';
 
 import { AppConfigurator } from './AppConfigurator';
+
 import type { AppModulesInstance, AppModuleInitiator, AppEnv } from './types';
 
 /**

package/src/enable-state.ts

@@ -0,0 +1,49 @@
+import { enableStateModule } from '@equinor/fusion-framework-module-state';
+import type { IStateModuleConfigurator } from '@equinor/fusion-framework-module-state';
+import type { IAppConfigurator } from './AppConfigurator';
+import type { AnyModule } from '@equinor/fusion-framework-module';
+import type { FusionModulesInstance } from '@equinor/fusion-framework';
+
+/**
+ * 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<M extends AnyModule[], R extends FusionModulesInstance>(
+  configurator: IAppConfigurator<M, R>,
+  configure?: (builder: IStateModuleConfigurator) => void | Promise<void>,
+): void {
+  enableStateModule(configurator, async (builder) => {
+    builder.setName(configurator.manifest.appKey);
+    await configure?.(builder);
+  });
+}

package/src/index.ts

@@ -16,12 +16,18 @@
  * sub-path export.
  */
 
-export { AppConfigurator, IAppConfigurator } from './AppConfigurator';
+export { AppConfigurator, IAppConfigurator, AppConfiguratorConstructor } 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.
  */