@equinor/fusion-framework-app 13.0.0 → 14.0.0-next.0

package/CHANGELOG.md

@@ -1,5 +1,81 @@
 # Change Log
 
+## 14.0.0-next.0
+
+### Minor Changes
+
+- 2836e0b: `enableAppManifestMock` accepts an optional third `assetUri` argument, overriding the base URI a loaded app's script is imported from — useful for tests that dynamically import a real fixture script. `env.config` is now optional; when omitted, a trivial `AppConfig` is used so `App.initialize()` can still resolve.
+- 2836e0b: Add a `./mock` entry point: `mockAppModules` runs an application's real module pipeline — the real `event`/`http`/`msal` modules, the real `AppConfigurator` configuration pipeline and real lifecycle — against a mocked parent Fusion instance, so a test exercises the wiring an application actually depends on instead of a reimplementation of it.
+
+  ```ts
+  import { mockAppModules } from "@equinor/fusion-framework-app/mock";
+
+  const manifest = {
+    appKey: "my-app",
+    displayName: "My App",
+    description: "My app",
+    type: "standalone",
+  } as const;
+  const modules = await mockAppModules(undefined, { manifest });
+  ```
+
+  `enableAppManifestMock` registers the `app` module on a parent `mockFramework` configurator, serving an app's own manifest and config while delegating every other request to whatever service discovery (or a pre-configured http client) would really resolve. `mockAppModules` uses it to build its zero-configuration default parent; call it directly when a test needs to customize `serviceDiscovery` first.
+
+  Restructured `README.md` into an entry point pointing at `docs/http-clients.md`, `docs/bookmarks.md` and `docs/testing.md`, matching the convention already used by `@equinor/fusion-framework-module-http` and `@equinor/fusion-framework-module-msal`.
+
+### Patch Changes
+
+- e8aae1f: Internal: publish every package on the `next` pre-release tag so the whole framework can be installed as a coherent set.
+
+  Packages without their own changes are bumped only to receive a `-next.N` version and the `next` dist-tag on npm. Install with:
+
+  ```bash
+  pnpm add @equinor/fusion-framework-react-app@next
+  ```
+
+- Updated dependencies [e8aae1f]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+  - @equinor/fusion-framework@8.1.0-next.0
+  - @equinor/fusion-framework-module@6.1.3-next.0
+  - @equinor/fusion-framework-module-app@8.1.0-next.0
+  - @equinor/fusion-framework-module-bookmark@4.1.0-next.0
+  - @equinor/fusion-framework-module-event@6.1.0-next.0
+  - @equinor/fusion-framework-module-http@8.1.0-next.0
+  - @equinor/fusion-framework-module-msal@11.0.0-next.0
+  - @equinor/fusion-framework-module-state@2.0.1-next.0
+  - @equinor/fusion-framework-module-telemetry@8.0.0-next.0
+
+## 13.0.1
+
+### Patch Changes
+
+- @equinor/fusion-framework@8.0.15
+
 ## 13.0.0
 
 ### Patch Changes

package/README.md

@@ -20,6 +20,14 @@ single `configureModules` call.
 > **Most Fusion apps should use `@equinor/fusion-framework-react-app` instead.**
 > This lower-level package is for framework-agnostic or advanced scenarios.
 
+## Documentation
+
+| Topic | Description |
+|---|---|
+| [Configure HTTP Clients](docs/http-clients.md) | Named clients from app config, service discovery, and explicit registration, plus resolution priority |
+| [Enable Bookmarks](docs/bookmarks.md) | Registering the bookmark module via `enableBookmark` |
+| [Testing](docs/testing.md) | The `/mock` entry point: `mockAppModules`, `AppMockConfigurator`, and `enableAppManifestMock` |
+
 ## Installation
 
 ```sh
@@ -80,6 +88,7 @@ const modules = await initialize({ fusion, env });
 | `AppModuleInitiator` | Callback signature accepted by `configureModules` for user-supplied setup. |
 | `AppEnv` | Environment descriptor containing the app manifest, config, and optional basename. |
 | `enableBookmark` | Helper to enable the bookmark module (import from `@equinor/fusion-framework-app/enable-bookmark`). |
+| `mockAppModules` | Runs the real module pipeline against deterministic fakes for tests (import from `@equinor/fusion-framework-app/mock`). |
 
 ## API Surface
 
@@ -100,40 +109,13 @@ giving you access to:
 |---|---|
 | `@equinor/fusion-framework-app` | `configureModules`, `AppConfigurator`, `IAppConfigurator`, all type aliases |
 | `@equinor/fusion-framework-app/enable-bookmark` | `enableBookmark` function |
+| `@equinor/fusion-framework-app/mock` | `mockAppModules`, `AppMockConfigurator`, `enableAppManifestMock` |
 
 ## Configure HTTP Clients
 
-The `AppConfigurator` can register named HTTP clients from several sources.
-You retrieve a client at runtime with `framework.modules.http.createClient(name)`.
-
-### From Application Config (auto-registration)
-
-Endpoints defined in `app.config.<env>.ts` are **automatically registered as
-named HTTP clients** when the `AppConfigurator` is created — no extra code
-needed in `config.ts`.
-
-```ts
-// app.config.ts
-import { defineAppConfig } from '@equinor/fusion-framework-cli/app';
-
-export default defineAppConfig(() => ({
-  endpoints: {
-    schedule: {
-      url: 'https://schedule-api.example.com',
-      scopes: ['api://schedule-id/.default'],
-    },
-  },
-}));
-```
-
-After initialization, use the client directly:
-
-```ts
-const client = framework.modules.http.createClient('schedule');
-const data = await client.json('/items');
-```
-
-### Via Service Discovery
+The `AppConfigurator` can register named HTTP clients from several sources —
+application config endpoints, service discovery, or explicit registration —
+and you retrieve one at runtime with `framework.modules.http.createClient(name)`.
 
 ```ts
 const initialize = configureModules((configurator) => {
@@ -141,37 +123,9 @@ const initialize = configureModules((configurator) => {
 });
 ```
 
-### Explicit Registration
-
-Use `configureHttpClient` in `config.ts` when the endpoint is **not** in
-`app.config.ts`, or when you need custom transport behavior such as headers,
-response guards, or a custom client class.
-
-```ts
-configurator.configureHttpClient('custom-api', {
-  baseUri: 'https://custom.api.example.com',
-  defaultScopes: ['api://custom-id/.default'],
-  onCreate: (client) => {
-    client.requestHandler.setHeader('X-Source', 'portal');
-  },
-});
-```
-
-### Resolution Priority
-
-When the same client name is configured in more than one place, the
-highest-priority source wins:
-
-| Priority | Source | Example |
-|----------|--------|---------|
-| 1 (highest) | **Session overrides** | User-specific URL / scopes set at runtime via `sessionStorage` |
-| 2 | **Application config endpoints** | `endpoints` in `app.config.ts` |
-| 3 | **Service-discovery registry** | Resolved via `useFrameworkServiceClient` |
-| 4 (lowest) | **Explicit registration** | `configureHttpClient(name, options)` in `config.ts` |
-
-This means an endpoint defined in `app.config.ts` will override a
-`configureHttpClient` call for the same name, and a session override will
-override both.
+See [Configure HTTP Clients](docs/http-clients.md) for auto-registration from
+`app.config.ts`, explicit registration, and resolution priority when a client
+is configured in more than one place.
 
 ## Enable Bookmarks
 
@@ -181,7 +135,6 @@ The bookmark module allows applications to save and restore application state.
 > `@equinor/fusion-framework-module-bookmark` directly.
 
 ```ts
-import { configureModules } from '@equinor/fusion-framework-app';
 import { enableBookmark } from '@equinor/fusion-framework-app/enable-bookmark';
 
 const initialize = configureModules((configurator) => {
@@ -189,8 +142,25 @@ const initialize = configureModules((configurator) => {
 });
 ```
 
-Payload generators registered through the bookmark module are automatically
-cleaned up when the module is disposed.
+See [Enable Bookmarks](docs/bookmarks.md) for payload generator cleanup behavior.
+
+## Testing
+
+Import from `@equinor/fusion-framework-app/mock` to run an application's real
+module pipeline in tests — the real `event`/`http`/`msal` modules, the real
+`AppConfigurator` configuration pipeline, and real lifecycle — while only the
+boundaries that reach outside the process are substituted with deterministic
+fakes. This entry point has no dependency on Vitest or any other test runner.
+
+```ts
+import { mockAppModules } from '@equinor/fusion-framework-app/mock';
+
+const manifest = { appKey: 'my-app', displayName: 'My App', description: 'My app', type: 'standalone' } as const;
+const modules = await mockAppModules(undefined, { manifest });
+```
+
+See [Testing](docs/testing.md) for `AppMockConfigurator`, `enableAppManifestMock`,
+and customizing the mocked parent's service discovery.
 
 ## Types
 

package/dist/esm/__tests__/mock/AppMockConfigurator.test.js

@@ -0,0 +1,70 @@
+import { describe, expect, it } from 'vitest';
+import { AppConfig } from '@equinor/fusion-framework-module-app';
+import { enableTelemetry } from '@equinor/fusion-framework-module-telemetry';
+import { AppConfigurator } from '../../AppConfigurator.js';
+import { AppMockConfigurator } from '../../mock/AppMockConfigurator.js';
+const mockEnv = {
+    manifest: {
+        appKey: 'test-app',
+        displayName: 'Test App',
+        description: 'A test application',
+        type: 'standalone',
+        build: {
+            version: '1.0.0',
+            entryPoint: 'index.js',
+        },
+    },
+};
+describe('AppMockConfigurator', () => {
+    it('is a real AppConfigurator', () => {
+        const configurator = new AppMockConfigurator(mockEnv);
+        expect(configurator).toBeInstanceOf(AppMockConfigurator);
+        expect(configurator).toBeInstanceOf(AppConfigurator);
+    });
+    it('constructs without throwing when env.config declares endpoints', async () => {
+        // the base AppConfigurator constructor auto-registers these via addConfig,
+        // before this class's own fields (#pinnedModules) are initialized
+        const env = {
+            ...mockEnv,
+            config: new AppConfig({
+                endpoints: { status: { url: 'https://status.example.com', scopes: [] } },
+            }),
+        };
+        const configurator = new AppMockConfigurator(env);
+        configurator.http.addMiddleware(async (uri, init, next) => uri === 'https://status.example.com/health' ? Response.json({ ok: true }) : next(uri, init));
+        enableTelemetry(configurator);
+        const modules = await configurator.initialize();
+        await expect(modules.http.createClient('status').json('/health')).resolves.toEqual({
+            ok: true,
+        });
+    });
+    it('exposes the same http configurator the http module is built from', async () => {
+        const configurator = new AppMockConfigurator(mockEnv);
+        configurator.http.configureClient('catalog', { baseUri: 'https://api.example.com' });
+        configurator.http.addMiddleware(async (uri, init, next) => uri === 'https://api.example.com/items' ? Response.json([{ id: 1 }]) : next(uri, init));
+        // msal's config schema requires a telemetry module, normally wired by configureModules
+        enableTelemetry(configurator);
+        const modules = await configurator.initialize();
+        await expect(modules.http.createClient('catalog').json('/items')).resolves.toEqual([{ id: 1 }]);
+    });
+    it('exposes the same msal configurator the auth module is built from', async () => {
+        const configurator = new AppMockConfigurator(mockEnv);
+        configurator.msal.setAccount({ name: 'Ada Lovelace' });
+        // msal's config schema requires a telemetry module, normally wired by configureModules
+        enableTelemetry(configurator);
+        const modules = await configurator.initialize();
+        expect(modules.auth.account?.name).toBe('Ada Lovelace');
+    });
+    it('answers a client registered through configureHttpClient via addMiddleware', async () => {
+        const configurator = new AppMockConfigurator(mockEnv);
+        configurator.configureHttpClient('status-api', { baseUri: 'https://status.example.com' });
+        configurator.http.addMiddleware(async (uri, init, next) => uri === 'https://status.example.com/status' ? Response.json({ ok: true }) : next(uri, init));
+        // msal's config schema requires a telemetry module, normally wired by configureModules
+        enableTelemetry(configurator);
+        const modules = await configurator.initialize();
+        await expect(modules.http.createClient('status-api').json('/status')).resolves.toEqual({
+            ok: true,
+        });
+    });
+});
+//# sourceMappingURL=AppMockConfigurator.test.js.map

package/dist/esm/__tests__/mock/AppMockConfigurator.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppMockConfigurator.test.js","sourceRoot":"","sources":["../../../../src/__tests__/mock/AppMockConfigurator.test.ts"],"names":[],"mappings":"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"}

package/dist/esm/__tests__/mock/mock-app.test.js

@@ -0,0 +1,86 @@
+import { describe, expect, it } from 'vitest';
+import { mockFramework } from '@equinor/fusion-framework/mock';
+import { AppConfig } from '@equinor/fusion-framework-module-app';
+import { AppMockConfigurator } from '../../mock/AppMockConfigurator.js';
+import { mockAppModules } from '../../mock/mock-app-modules.js';
+const env = {
+    manifest: {
+        appKey: 'test-app',
+        displayName: 'Test App',
+        description: 'A test application',
+        type: 'standalone',
+        build: {
+            version: '1.0.0',
+            entryPoint: 'index.js',
+        },
+    },
+    config: new AppConfig({ environment: { foo: 'bar' } }),
+};
+describe('mockApp', () => {
+    it('initializes the app module pipeline with no configuration', async () => {
+        const modules = await mockAppModules(undefined, env);
+        expect(modules.event).toBeDefined();
+        expect(modules.auth).toBeDefined();
+        expect(modules.http).toBeDefined();
+    });
+    it('passes a real AppConfigurator to the callback', async () => {
+        expect.assertions(1);
+        await mockAppModules((configurator) => {
+            expect(configurator).toBeInstanceOf(AppMockConfigurator);
+        }, env);
+    });
+    it('answers a service-discovery-resolved client from the app’s own mocked http module', async () => {
+        const modules = await mockAppModules((configurator) => {
+            configurator.useFrameworkServiceClient('portal-api');
+            // matches against the full resolved URL, so the host is part of the match to keep this
+            // from also answering a different client's request
+            configurator.http.addMiddleware(async (uri, init, next) => uri === 'https://portal-api.fusion.test/items'
+                ? Response.json([{ id: 1 }])
+                : next(uri, init));
+        }, env);
+        await expect(modules.http.createClient('portal-api').json('/items')).resolves.toEqual([
+            { id: 1 },
+        ]);
+    });
+    it('reuses an already-mocked fusion instance instead of creating a new one', async () => {
+        expect.assertions(1);
+        const fusion = await mockFramework((configurator) => {
+            configurator.msal.setAccount({ name: 'Ada Lovelace' });
+        });
+        await mockAppModules((_configurator, { fusion: parent }) => {
+            expect(parent.modules.auth.account?.name).toBe('Ada Lovelace');
+        }, env, fusion);
+    });
+    it('awaits an async configure callback before initialize resolves', async () => {
+        const modules = await mockAppModules(async (configurator) => {
+            await Promise.resolve();
+            configurator.msal.setAccount({ name: 'Ada Lovelace' });
+        }, env);
+        expect(modules.auth.account?.name).toBe('Ada Lovelace');
+    });
+    it('serves this app’s own manifest and config through the default parent’s app module', async () => {
+        expect.assertions(2);
+        await mockAppModules(async (_configurator, { fusion }) => {
+            // the default parent always has `app` enabled; typed as plain `Fusion` since callers
+            // may pass in a parent without it, so the module set is narrowed just for this assertion
+            const { app } = fusion.modules;
+            app.setCurrentApp(env.manifest.appKey);
+            await expect(app.current?.getManifestAsync()).resolves.toMatchObject({
+                appKey: env.manifest.appKey,
+                displayName: env.manifest.displayName,
+            });
+            await expect(app.current?.getConfigAsync()).resolves.toMatchObject({
+                environment: env.config.environment,
+            });
+        }, env);
+    });
+    it('falls through to the real client for a manifest not matching this app’s own', async () => {
+        expect.assertions(1);
+        await mockAppModules(async (_configurator, { fusion }) => {
+            const { app } = fusion.modules;
+            app.setCurrentApp('some-other-app');
+            await expect(app.current?.getManifestAsync()).rejects.toThrow();
+        }, env);
+    });
+});
+//# sourceMappingURL=mock-app.test.js.map

package/dist/esm/__tests__/mock/mock-app.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-app.test.js","sourceRoot":"","sources":["../../../../src/__tests__/mock/mock-app.test.ts"],"names":[],"mappings":"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"}

package/dist/esm/__tests__/mock/msal-hoisting.test.js

@@ -0,0 +1,36 @@
+import { describe, expect, it, vi } from 'vitest';
+import { mockFramework } from '@equinor/fusion-framework/mock';
+import { mockAppModules } from '../../mock/mock-app-modules.js';
+const env = {
+    manifest: {
+        appKey: 'test-app',
+        displayName: 'Test App',
+        description: 'A test application',
+        type: 'standalone',
+    },
+};
+describe('msal hoisting', () => {
+    it('delegates acquireToken to the parent’s auth module instead of building its own client', async () => {
+        const fusion = await mockFramework();
+        const result = { accessToken: 'parent-issued-token' };
+        vi.spyOn(fusion.modules.auth, 'acquireToken').mockResolvedValue(result);
+        const modules = await mockAppModules(undefined, env, fusion);
+        // the app's own `auth` is a distinct (proxying) object, not the parent's instance itself
+        expect(modules.auth).not.toBe(fusion.modules.auth);
+        await expect(modules.auth.acquireToken({ request: { scopes: ['User.Read'] } })).resolves.toMatchObject({ accessToken: 'parent-issued-token' });
+    });
+    it('surfaces the parent’s acquisition failures instead of falling back to its own client', async () => {
+        const fusion = await mockFramework();
+        vi.spyOn(fusion.modules.auth, 'acquireToken').mockRejectedValue(new Error('acquisition failed'));
+        const modules = await mockAppModules(undefined, env, fusion);
+        await expect(modules.auth.acquireToken({ request: { scopes: ['User.Read'] } })).rejects.toThrow('acquisition failed');
+    });
+    it('reflects the parent’s signed-in account rather than signing in its own', async () => {
+        const fusion = await mockFramework((configurator) => {
+            configurator.msal.setAccount({ name: 'Ada Lovelace' });
+        });
+        const modules = await mockAppModules(undefined, env, fusion);
+        expect(modules.auth.account?.name).toBe('Ada Lovelace');
+    });
+});
+//# sourceMappingURL=msal-hoisting.test.js.map

package/dist/esm/__tests__/mock/msal-hoisting.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"msal-hoisting.test.js","sourceRoot":"","sources":["../../../../src/__tests__/mock/msal-hoisting.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAG/D,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAEhE,MAAM,GAAG,GAAG;IACV,QAAQ,EAAE;QACR,MAAM,EAAE,UAAU;QAClB,WAAW,EAAE,UAAU;QACvB,WAAW,EAAE,oBAAoB;QACjC,IAAI,EAAE,YAAqB;KAC5B;CACF,CAAC;AAEF,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,uFAAuF,EAAE,KAAK,IAAI,EAAE;QACrG,MAAM,MAAM,GAAG,MAAM,aAAa,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,EAAE,WAAW,EAAE,qBAAqB,EAA0B,CAAC;QAC9E,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAExE,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QAE7D,yFAAyF;QACzF,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,MAAM,CACV,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC,CAClE,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sFAAsF,EAAE,KAAK,IAAI,EAAE;QACpG,MAAM,MAAM,GAAG,MAAM,aAAa,EAAE,CAAC;QACrC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,iBAAiB,CAC7D,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAChC,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QAE7D,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAC7F,oBAAoB,CACrB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACtF,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,CAAC,YAAY,EAAE,EAAE;YAClD,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QAE7D,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/esm/configure-modules.js

@@ -4,8 +4,8 @@
  * 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';
+import { initializeAppModules } from './initialize-app-modules';
 /**
  * Create an application module initializer for a Fusion application.
  *
@@ -49,49 +49,9 @@ export const configureModules = (cb) =>
  * @returns The fully initialized application module instance.
  */
 async (args) => {
-    const { fusion } = args;
     // Create app configurator
     const configurator = new AppConfigurator(args.env);
-    // Extract telemetry metadata from app manifest for tracking and debugging
-    const metadataExtractor = () => {
-        return {
-            fusion: {
-                type: 'app-telemetry',
-                app: {
-                    key: args.env.manifest?.appKey || 'unknown-app',
-                    version: args.env.manifest?.build?.version || 'unknown-version',
-                },
-            },
-        };
-    };
-    // Enable telemetry collection for module configuration events
-    // attachConfiguratorEvents automatically prefixes events with configurator class name
-    enableTelemetry(configurator, {
-        attachConfiguratorEvents: true,
-        configure: (builder) => {
-            builder.setMetadata(metadataExtractor);
-            builder.setParent(fusion.modules.telemetry);
-            // Scope telemetry to 'app' level for app-specific event filtering
-            builder.setDefaultScope(['app']);
-        },
-    });
-    // Allow user configuration callback to run before module initialization
-    if (cb) {
-        await Promise.resolve(cb(configurator, args));
-    }
-    // Type cast is safe because AppConfigurator.initialize() returns the exact module
-    // instance that was registered and configured above. The intermediate 'unknown'
-    // cast is necessary due to TypeScript's generic inference limitations with the
-    // configurator's initialization chain, but the runtime value is guaranteed to match.
-    const modules = (await configurator.initialize(args.fusion.modules));
-    // Dispatch app modules loaded event for app lifecycle tracking
-    // TODO(#5061): remove check after fusion-cli is updated (app module is not enabled in fusion-cli)
-    if (args.env.manifest?.appKey) {
-        modules.event.dispatchEvent('onAppModulesLoaded', {
-            detail: { appKey: args.env.manifest.appKey, manifest: args.env.manifest, modules },
-        });
-    }
-    return modules;
+    return initializeAppModules(configurator, cb, args);
 };
 export default configureModules;
 //# sourceMappingURL=configure-modules.js.map

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"configure-modules.js","sourceRoot":"","sources":["../../src/configure-modules.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAC3B,CAKE,EAA6C,EACmC,EAAE;AACpF;;;;;;;GAOG;AACH,KAAK,EAAE,IAAiC,EAAyC,EAAE;IACjF,0BAA0B;IAC1B,MAAM,YAAY,GAAG,IAAI,eAAe,CAAkC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpF,OAAO,oBAAoB,CAAC,YAAY,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;AACtD,CAAC,CAAC;AAEJ,eAAe,gBAAgB,CAAC"}

package/dist/esm/initialize-app-modules.js

@@ -0,0 +1,65 @@
+import { enableTelemetry, } from '@equinor/fusion-framework-module-telemetry';
+/**
+ * Runs the telemetry wiring, the caller's configuration callback and module
+ * initialization against an already constructed configurator.
+ *
+ * @remarks
+ * Extracted so `mockAppModules` (`@equinor/fusion-framework-app/mock`) can drive the
+ * exact same pipeline against an `AppMockConfigurator` instead of reimplementing
+ * it — the same way `FrameworkConfigurator` and `FrameworkMockConfigurator`
+ * share the framework's `init`.
+ *
+ * @param configurator - The (real or mock) app configurator to run the pipeline on.
+ * @param cb - Configuration callback invoked before module initialization, or `undefined` to skip it.
+ * @param args - Object containing the Fusion instance and the application environment.
+ * @returns The fully initialized application module instance.
+ * @template TModules - Application module descriptors beyond the default set.
+ * @template TRef - The parent Fusion instance type.
+ * @template TEnv - The application environment descriptor.
+ * @template TConfigurator - The (real or mock) `AppConfigurator` subclass driving the pipeline.
+ */
+export async function initializeAppModules(configurator, cb, args) {
+    const { fusion } = args;
+    // Extract telemetry metadata from app manifest for tracking and debugging
+    const metadataExtractor = () => {
+        return {
+            fusion: {
+                type: 'app-telemetry',
+                app: {
+                    key: args.env.manifest?.appKey || 'unknown-app',
+                    version: args.env.manifest?.build?.version || 'unknown-version',
+                },
+            },
+        };
+    };
+    // Enable telemetry collection for module configuration events
+    // attachConfiguratorEvents automatically prefixes events with configurator class name
+    enableTelemetry(configurator, {
+        attachConfiguratorEvents: true,
+        configure: (builder) => {
+            builder.setMetadata(metadataExtractor);
+            builder.setParent(fusion.modules.telemetry);
+            // Scope telemetry to 'app' level for app-specific event filtering
+            builder.setDefaultScope(['app']);
+        },
+    });
+    // Allow user configuration callback to run before module initialization
+    if (cb) {
+        await Promise.resolve(cb(configurator, args));
+    }
+    // Type cast is safe because AppConfigurator.initialize() returns the exact module
+    // instance that was registered and configured above. The intermediate 'unknown'
+    // cast is necessary due to TypeScript's generic inference limitations with the
+    // configurator's initialization chain, but the runtime value is guaranteed to match.
+    const modules = (await configurator.initialize(args.fusion.modules));
+    // Dispatch app modules loaded event for app lifecycle tracking
+    // TODO(#5061): remove check after fusion-cli is updated (app module is not enabled in fusion-cli)
+    if (args.env.manifest?.appKey) {
+        modules.event.dispatchEvent('onAppModulesLoaded', {
+            detail: { appKey: args.env.manifest.appKey, manifest: args.env.manifest, modules },
+        });
+    }
+    return modules;
+}
+export default initializeAppModules;
+//# sourceMappingURL=initialize-app-modules.js.map

package/dist/esm/initialize-app-modules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialize-app-modules.js","sourceRoot":"","sources":["../../src/initialize-app-modules.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,eAAe,GAEhB,MAAM,4CAA4C,CAAC;AAKpD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAaxC,YAA2B,EAC3B,EAEa,EACb,IAAiC;IAEjC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAExB,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;AAED,eAAe,oBAAoB,CAAC"}