@equinor/fusion-framework 8.0.14 → 8.1.0-next.0

package/CHANGELOG.md

@@ -1,5 +1,203 @@
 # Change Log
 
+## 8.1.0-next.0
+
+### Minor Changes
+
+- 2836e0b: Restructure documentation so each README is an entry point rather than a manual.
+
+  Long-form content moved into per-package `docs/` folders, matching the convention already used by `@equinor/fusion-framework-module` and `@equinor/fusion-framework-module-http`. Each README now keeps the elevator pitch, the shortest working example and a documentation table linking to the rest.
+
+  - **msal** — `docs/api-reference.md`, `docs/auth-code-flow.md`, `docs/testing.md`, `docs/version-management.md`, `docs/migration-v2-to-v4.md`, `docs/troubleshooting.md`. The README also gained the top-level heading it was missing.
+  - **service-discovery** — `docs/configuration.md`, `docs/testing.md`, `docs/session-overrides.md`, `docs/api-reference.md`.
+  - **framework** — `docs/testing-choosing-a-layer.md`, `docs/testing.md`, `docs/testing-design.md`, `docs/testing-extending.md`, `docs/testing-api.md`.
+
+  Both module READMEs now document their `/mock` entry point, which was previously undocumented, and state that spying on an individual call is the test runner's job rather than something these packages provide.
+
+- 2836e0b: `FrameworkMockConfigurator.context` is now backed by `ContextMockConfigurator` from `@equinor/fusion-framework-module-context/mock` instead of the real `ContextModuleConfigurator` — context resolution in tests no longer performs real I/O:
+
+  ```typescript
+  const configurator = new FrameworkMockConfigurator();
+  configurator.context.setCurrentContext({
+    id: "my-ctx",
+    type: { id: "ProjectMaster" },
+    value: {},
+  });
+
+  const fusion = await init(configurator);
+  ```
+
+  This changes the type returned by `.context` from `ContextModuleConfigurator` to `ContextMockConfigurator` (which extends it) — code relying on `.context` being exactly `ContextModuleConfigurator` should switch to seeding data through the new mock methods (`setCurrentContext`, `setContexts`, `addContext`, `setRelatedContexts`, `setResolver`) instead of configuring a real client.
+
+  `docs/testing.md`, `docs/testing-extending.md` and `docs/testing-api.md` are updated to describe both mocking strategies now available for context: the in-memory `ContextMockConfigurator` above, and mocking the context API's HTTP responses directly for tests that need to exercise the real configurator/services/HTTP pipeline.
+
+- 2836e0b: Add `_pin` and `_getConfig` to `FrameworkMockConfigurator`, so a module supplied through `TModules` can get the same kind of named accessor `.msal` and `.serviceDiscovery` already have.
+
+  Previously that pinning was hand-written twice, once per built-in mock, with no way for anything else to do the same. A subclass now reuses it directly:
+
+  ```typescript
+  class AppMockConfigurator extends FrameworkMockConfigurator<[InvoiceModule]> {
+    constructor() {
+      super();
+      this._pin(invoiceMockModule);
+    }
+
+    get invoices(): InvoiceMockConfigurator {
+      return this._getConfig("invoices");
+    }
+  }
+  ```
+
+  `_pin(module)` replaces the module's own `configure` factory with one that always returns the same instance, and registers it — pinning it before initialization runs is what lets a test reach the accessor synchronously and have it be the configurator the module is actually built from. `_getConfig(name)` looks that instance up by the module's name, throwing if nothing was pinned for it.
+
+  `.msal` and `.serviceDiscovery` are unchanged for consumers; they are now built from `_pin`/`_getConfig` themselves rather than from two private fields.
+
+- 2836e0b: Add `.services`, `.context` and `.telemetry` accessors to `FrameworkMockConfigurator`, alongside the existing `.msal`, `.serviceDiscovery` and `.http`.
+
+  These three modules have no test double yet, so anything read through `.services`, `.context` or `.telemetry` still performs real I/O — but their configurators are now reachable synchronously the same way `.msal` and `.serviceDiscovery` already are, since none of their `configure` factories depend on `ref`:
+
+  ```typescript
+  const configurator = new FrameworkMockConfigurator();
+  configurator.services.configureClient("my-api", {
+    baseUri: "http://localhost:6669",
+  });
+
+  const fusion = await init(configurator);
+  ```
+
+  `event` is intentionally left out: its `configure` factory reads `ref` to wire event bubbling to a parent event provider when `FrameworkMockConfigurator` is hoisted inside a host framework, and pinning it would call `configure()` with `ref` always `undefined` — silently disabling that bubbling.
+
+- 2836e0b: Add a `./mock` entry point for initializing the framework in a test.
+
+  ```typescript
+  import { mockFramework } from "@equinor/fusion-framework/mock";
+
+  const fusion = await mockFramework();
+  ```
+
+  `mockFramework` runs the real configure → initialize pipeline with the real built-in modules and substitutes only the boundaries that leave the process — the MSAL client and the service discovery client. Module wiring, configuration validation and lifecycle hooks behave as they do in production, so a test still catches wiring mistakes that a hand-built replacement for the module graph would hide.
+
+  It takes a single callback receiving a `FrameworkMockConfigurator`, which **is** a `FrameworkConfigurator`. Modules whose boundary is mocked expose their own configurator as a property, so a test configures them without registering a callback:
+
+  ```typescript
+  const fusion = await mockFramework((configurator) => {
+    configurator.msal.setAccount({ name: "Ada Lovelace" });
+    configurator.serviceDiscovery.setBaseUri("http://localhost:6669");
+    configurator.serviceDiscovery.addService({ key: "my-api" });
+  });
+  ```
+
+  Because it is a real configurator, every `enableX` helper an application already uses accepts it unchanged — including the ones a team writes for their own modules. Those modules can be passed as a type argument so they are typed on the configurator _and_ on the resulting `fusion.modules` without a cast:
+
+  ```typescript
+  const fusion = await mockFramework<[InvoiceModule]>((configurator) => {
+    enableInvoicesMock(configurator, { total: 42 });
+  });
+
+  await fusion.modules.invoices.getInvoice("inv-1"); // typed
+  ```
+
+  `FrameworkMockConfigurator` is also exported for tests that need to hold on to the configurator and call `init` themselves.
+
+  The entry point owns no mock logic. Each module exports its own test double from its own `./mock` entry point, and this one composes the built-in set; an application module follows the same pattern and plugs in without any support from this package. It has no test-runner dependency and provides no mocking API, because replacing an individual call belongs to your test runner.
+
+- 2836e0b: `FrameworkMockConfigurator.telemetry` is now backed by `TelemetryMockConfigurator` from `@equinor/fusion-framework-module-telemetry/mock` instead of the real `TelemetryConfigurator` — telemetry tracked through a mocked framework instance no longer reaches Application Insights or any real endpoint:
+
+  ```typescript
+  import { filter } from "rxjs";
+
+  const fusion = await mockFramework();
+
+  fusion.modules.telemetry.items
+    .pipe(filter((item) => item.name === "button-click"))
+    .subscribe((item) => {
+      // ...
+    });
+
+  fusion.modules.telemetry.trackEvent({ name: "button-click" });
+  ```
+
+  A test can register its own adapter alongside the mock's default one, the same way `enableTelemetry` already does:
+
+  ```typescript
+  const myAdapter: ITelemetryAdapter = {
+    processItem: (item) => forwardSomewhere(item),
+  };
+  const fusion = await mockFramework((configurator) => {
+    configurator.telemetry.setAdapter("my-adapter", myAdapter);
+  });
+  ```
+
+  This changes the type returned by `.telemetry` from `ITelemetryConfigurator` to `TelemetryMockConfigurator` (which extends the real `TelemetryConfigurator`) — code relying on `.telemetry` being exactly the real configurator should read tracked items back through `.telemetry.adapter` (`getItems`/`waitForItem`) instead of asserting against a real telemetry backend.
+
+- 2836e0b: Add a `.http` accessor to `FrameworkMockConfigurator`, backed by the real `IHttpClientConfigurator` — fake a response by registering a short-circuiting middleware through `.http.addMiddleware(...)` instead of swapping the module out:
+
+  ```ts
+  const configurator = new FrameworkMockConfigurator();
+  configurator.http.addMiddleware(async (uri, init, next) =>
+    uri === "https://api.example.com/items"
+      ? Response.json([{ id: 1 }])
+      : next(uri, init),
+  );
+  ```
+
+  See `@equinor/fusion-framework-module-http`'s `addMiddleware` changeset for the full API.
+
+### 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
+  ```
+
+- 2836e0b: `init` no longer throws when no DOM is present.
+
+  The running instance is published as `window.Fusion` for portal shells and widgets. That assignment was unguarded, so initializing the framework anywhere without a `window` — a test runner using the `node` environment, or a server-side render — failed with `ReferenceError: window is not defined`.
+
+  The assignment is now skipped when `window` is undefined. Browser behaviour is unchanged.
+
+- 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]
+  - @equinor/fusion-framework-module@6.1.3-next.0
+  - @equinor/fusion-framework-module-context@9.0.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-service-discovery@10.1.0-next.0
+  - @equinor/fusion-framework-module-services@8.1.1-next.0
+  - @equinor/fusion-framework-module-telemetry@8.0.0-next.0
+
+## 8.0.15
+
+### Patch Changes
+
+- Updated dependencies [73bfe52]
+  - @equinor/fusion-framework-module-context@8.0.3
+
 ## 8.0.14
 
 ### Patch Changes

package/README.md

@@ -94,6 +94,36 @@ The framework ships with the following modules enabled by default:
 - **`@equinor/fusion-framework-module-context`** — application / project context selection
 - **`@equinor/fusion-framework-module-telemetry`** — telemetry, logging, and metadata
 
+## Testing
+
+Import from `@equinor/fusion-framework/mock` to initialize the framework in a test without credentials, without network access and without configuration.
+
+```typescript
+import { mockFramework } from '@equinor/fusion-framework/mock';
+
+const fusion = await mockFramework((configurator) => {
+  configurator.msal.setAccount({ name: 'Ada Lovelace' });
+  configurator.serviceDiscovery.setBaseUri('http://localhost:6669');
+});
+
+const token = await fusion.modules.auth.acquireAccessToken();
+const apps = await fusion.modules.serviceDiscovery.resolveService('apps');
+```
+
+The **real** configure → initialize pipeline runs with the **real** built-in modules; only the boundaries that leave the process — the MSAL client and the service discovery client — are substituted. Module wiring, configuration validation and lifecycle hooks therefore behave as they do in production, so a test still catches wiring mistakes.
+
+The entry point has **no test-runner dependency**, and ships no mocking API of its own — spying on an individual call is your test runner's job.
+
+## Documentation
+
+| Guide | Covers |
+| --- | --- |
+| [Choosing a testing layer](./docs/testing-choosing-a-layer.md) | Which import to use for React app, framework, module, HTTP, and runner-level tests |
+| [Testing](./docs/testing.md) | Choosing the user, signed-out tests, composing the service registry, spying, and configuring as an application does |
+| [Testing — design](./docs/testing-design.md) | What is substituted and why, where mocks live, determinism, and test-runner support |
+| [Testing — adding a mock for another module](./docs/testing-extending.md) | Giving your own module a test double, and which framework modules are not covered yet |
+| [Testing — API](./docs/testing-api.md) | Every mock export and the package that owns it |
+
 ## Further reading
 
 📚 [Full documentation](https://equinor.github.io/fusion-framework/)

package/dist/esm/__tests__/mock/application-module.test.js

@@ -0,0 +1,53 @@
+import { describe, expect, it } from 'vitest';
+import { mockFramework } from '../../mock/index.js';
+class InvoiceConfigurator {
+    #client;
+    setClient(client) {
+        this.#client = client;
+    }
+    createClient() {
+        if (!this.#client) {
+            throw new Error('An invoice client is required');
+        }
+        return this.#client;
+    }
+}
+const invoiceModule = {
+    name: 'invoices',
+    configure: () => new InvoiceConfigurator(),
+    initialize: ({ config }) => config.createClient(),
+};
+/** The team's own mock, following the pattern the built-in modules use. */
+const enableInvoicesMock = (
+// biome-ignore lint/suspicious/noExplicitAny: mirrors every enableX helper
+configurator, options = {}) => {
+    configurator.addConfig({
+        module: invoiceModule,
+        configure: (builder) => builder.setClient({
+            getInvoice: async (id) => ({ id, total: options.total ?? 0 }),
+        }),
+    });
+};
+describe('application modules', () => {
+    it('fails to start without its mock, so the seam is real and not a no-op', async () => {
+        await expect(mockFramework((configurator) => {
+            configurator.addConfig({ module: invoiceModule });
+        })).rejects.toThrow(/invoice client is required/i);
+    });
+    it('composes with the built-in mocks and is typed without a cast', async () => {
+        const fusion = await mockFramework((configurator) => {
+            configurator.msal.setAccount({ name: 'Ada Lovelace' });
+            enableInvoicesMock(configurator, { total: 42 });
+        });
+        // No cast: `TModules` must flow through to `fusion.modules`.
+        const invoice = await fusion.modules.invoices.getInvoice('inv-1');
+        expect(invoice).toEqual({ id: 'inv-1', total: 42 });
+        expect(fusion.modules.auth.account?.name).toBe('Ada Lovelace');
+    });
+    it('is registered exactly as it is in production', async () => {
+        // The same helper, against a real FrameworkConfigurator, would behave identically.
+        const fusion = await mockFramework((configurator) => enableInvoicesMock(configurator, { total: 7 }));
+        await expect(fusion.modules.invoices.getInvoice('inv-2')).resolves.toMatchObject({ total: 7 });
+    });
+});
+//# sourceMappingURL=application-module.test.js.map

package/dist/esm/__tests__/mock/application-module.test.js.map

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

package/dist/esm/__tests__/mock/documented-usage.test.js

@@ -0,0 +1,73 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { decodeJwtSegment } from '@equinor/fusion-framework-module-msal/mock';
+import { init } from '../../init.js';
+import { createMockService, FrameworkMockConfigurator, mockFramework } from '../../mock/index.js';
+/**
+ * Pins the snippets in `docs/testing.md` and the package README to real
+ * behaviour, so documentation cannot drift away from the API it describes.
+ */
+describe('documented usage', () => {
+    afterEach(() => vi.restoreAllMocks());
+    it('composes the service registry on the builder', async () => {
+        const fusion = await mockFramework((configurator) => {
+            configurator.serviceDiscovery.setBaseUri('http://localhost:6669');
+            configurator.serviceDiscovery.addService({ key: 'my-api' });
+            configurator.serviceDiscovery.removeService('bookmarks');
+        });
+        await expect(fusion.modules.serviceDiscovery.resolveService('my-api')).resolves.toMatchObject({
+            key: 'my-api',
+        });
+    });
+    it('replaces the baseline registry with setServices', async () => {
+        const fusion = await mockFramework((configurator) => {
+            configurator.serviceDiscovery.setServices([{ key: 'apps', uri: 'http://localhost:3000' }]);
+        });
+        await expect(fusion.modules.serviceDiscovery.resolveService('apps')).resolves.toMatchObject({
+            uri: 'http://localhost:3000',
+        });
+    });
+    it('keeps startup working when the registry is replaced, because unknown services synthesise', async () => {
+        // The context module resolves `context` while initializing, so a replaced
+        // registry that omits it would break start-up if synthesis were disabled.
+        const fusion = await mockFramework((configurator) => {
+            configurator.serviceDiscovery.setServices([{ key: 'apps', uri: 'http://localhost:3000' }]);
+        });
+        await expect(fusion.modules.serviceDiscovery.resolveService('people')).resolves.toBeDefined();
+    });
+    it('lets the test runner spy on the discovery client', async () => {
+        const fusion = await mockFramework();
+        vi.spyOn(fusion.modules.serviceDiscovery.client, 'resolveService').mockResolvedValue(createMockService({ key: 'apps', uri: 'http://spied' }));
+        await expect(fusion.modules.serviceDiscovery.resolveService('apps')).resolves.toMatchObject({
+            uri: 'http://spied',
+        });
+    });
+    it('lets the test runner spy on the auth client', async () => {
+        const fusion = await mockFramework();
+        const spy = vi.spyOn(fusion.modules.auth.client, 'acquireToken');
+        await fusion.modules.auth.acquireAccessToken({ request: { scopes: ['Files.Read'] } });
+        expect(spy).toHaveBeenCalled();
+    });
+    it('resolves the real scope through the real provider, not the test double', async () => {
+        const fusion = await mockFramework((configurator) => {
+            // The client is configured with what it talks to, exactly as in production
+            configurator.msal.setClientConfig({ auth: { clientId: 'my-app', tenantId: 'my-tenant' } });
+        });
+        const token = await fusion.modules.auth.acquireAccessToken();
+        const claims = JSON.parse(decodeJwtSegment(token?.split('.')[1] ?? ''));
+        // MsalProvider — not the mock — turns "no scopes requested" into `${clientId}/.default`
+        expect(claims.scp).toBe('my-app/.default');
+    });
+    it('signs nobody in when the account is signed out', async () => {
+        const fusion = await mockFramework((configurator) => {
+            configurator.msal.setAccount({ signedOut: true });
+        });
+        expect(fusion.modules.auth.account).toBeFalsy();
+    });
+    it('can be constructed directly and initialized with init', async () => {
+        const configurator = new FrameworkMockConfigurator();
+        configurator.msal.setAccount({ name: 'Ada Lovelace' });
+        const fusion = await init(configurator);
+        expect(fusion.modules.auth.account?.name).toBe('Ada Lovelace');
+    });
+});
+//# sourceMappingURL=documented-usage.test.js.map

package/dist/esm/__tests__/mock/documented-usage.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documented-usage.test.js","sourceRoot":"","sources":["../../../../src/__tests__/mock/documented-usage.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAE9E,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAElG;;;GAGG;AACH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,CAAC;IAEtC,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,CAAC,YAAY,EAAE,EAAE;YAClD,YAAY,CAAC,gBAAgB,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC;YAClE,YAAY,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC5D,YAAY,CAAC,gBAAgB,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;YAC5F,GAAG,EAAE,QAAQ;SACd,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,CAAC,YAAY,EAAE,EAAE;YAClD,YAAY,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,uBAAuB,EAAE,CAAC,CAAC,CAAC;QAC7F,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;YAC1F,GAAG,EAAE,uBAAuB;SAC7B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0FAA0F,EAAE,KAAK,IAAI,EAAE;QACxG,0EAA0E;QAC1E,0EAA0E;QAC1E,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,CAAC,YAAY,EAAE,EAAE;YAClD,YAAY,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,uBAAuB,EAAE,CAAC,CAAC,CAAC;QAC7F,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAChG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,MAAM,GAAG,MAAM,aAAa,EAAE,CAAC;QAErC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,iBAAiB,CAClF,iBAAiB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC,CACxD,CAAC;QAEF,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;YAC1F,GAAG,EAAE,cAAc;SACpB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,MAAM,GAAG,MAAM,aAAa,EAAE,CAAC;QAErC,MAAM,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QAEjE,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC,CAAC;QAEtF,MAAM,CAAC,GAAG,CAAC,CAAC,gBAAgB,EAAE,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACtF,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,CAAC,YAAY,EAAE,EAAE;YAClD,2EAA2E;YAC3E,YAAY,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;QAC7F,CAAC,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAExE,wFAAwF;QACxF,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,CAAC,YAAY,EAAE,EAAE;YAClD,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,YAAY,GAAG,IAAI,yBAAyB,EAAE,CAAC;QACrD,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;QAEvD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC;QAExC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,212 @@
+import { describe, expect, it, vi } from 'vitest';
+import { enableMsalMock } from '@equinor/fusion-framework-module-msal/mock';
+import { enableServiceDiscoveryMock } from '@equinor/fusion-framework-module-service-discovery/mock';
+import { TelemetryLevel } from '@equinor/fusion-framework-module-telemetry';
+import { FrameworkConfigurator } from '../../FrameworkConfigurator.js';
+import { init } from '../../init.js';
+import { FrameworkMockConfigurator, mockFramework } from '../../mock/index.js';
+/** A minimal configurator, standing in for an application's own. */
+class WidgetsConfigurator {
+    #name = 'default';
+    setName(name) {
+        this.#name = name;
+        return this;
+    }
+    get name() {
+        return this.#name;
+    }
+}
+const widgetsModule = {
+    name: 'widgets',
+    configure: () => new WidgetsConfigurator(),
+    initialize: ({ config }) => ({ name: config.name }),
+};
+describe('mockFramework', () => {
+    it('initializes every built-in module without configuration', async () => {
+        const fusion = await mockFramework();
+        expect(fusion.modules.event).toBeDefined();
+        expect(fusion.modules.auth).toBeDefined();
+        expect(fusion.modules.http).toBeDefined();
+        expect(fusion.modules.serviceDiscovery).toBeDefined();
+        expect(fusion.modules.context).toBeDefined();
+        expect(fusion.modules.telemetry).toBeDefined();
+    });
+    it('signs in a default user so an application has an identity to read', async () => {
+        const fusion = await mockFramework();
+        expect(fusion.modules.auth.account?.name).toBe('Test User');
+    });
+    it('resolves the services a Fusion application needs at start-up', async () => {
+        const fusion = await mockFramework();
+        await expect(fusion.modules.serviceDiscovery.resolveService('apps')).resolves.toMatchObject({
+            key: 'apps',
+        });
+    });
+    it('passes a real FrameworkConfigurator to the callback', async () => {
+        expect.assertions(2);
+        await mockFramework((configurator) => {
+            expect(configurator).toBeInstanceOf(FrameworkMockConfigurator);
+            expect(configurator).toBeInstanceOf(FrameworkConfigurator);
+        });
+    });
+    it('awaits an asynchronous callback before initializing', async () => {
+        const fusion = await mockFramework(async (configurator) => {
+            await Promise.resolve();
+            configurator.msal.setAccount({ name: 'Ada Lovelace' });
+        });
+        expect(fusion.modules.auth.account?.name).toBe('Ada Lovelace');
+    });
+});
+describe('FrameworkMockConfigurator', () => {
+    it('exposes the same msal configurator the auth module is built from', async () => {
+        const fusion = await mockFramework((configurator) => {
+            configurator.msal.setAccount({ name: 'Ada Lovelace', username: 'ada@equinor.com' });
+        });
+        expect(fusion.modules.auth.account).toMatchObject({
+            name: 'Ada Lovelace',
+            username: 'ada@equinor.com',
+        });
+    });
+    it('lets the last declared account win', async () => {
+        const fusion = await mockFramework((configurator) => {
+            configurator.msal.setAccount({ name: 'Ada Lovelace' });
+            configurator.msal.setAccount({ name: 'Grace Hopper' });
+        });
+        expect(fusion.modules.auth.account?.name).toBe('Grace Hopper');
+    });
+    it('resolves an account callback when the config is built', async () => {
+        const fusion = await mockFramework((configurator) => {
+            configurator.msal.setAccount(async () => ({ name: 'Ada Lovelace' }));
+        });
+        expect(fusion.modules.auth.account?.name).toBe('Ada Lovelace');
+    });
+    it('builds the auth client when the module builds its config, not when the account is set', async () => {
+        const configurator = new FrameworkMockConfigurator();
+        configurator.msal.setAccount({ name: 'Ada Lovelace' });
+        // The account is configuration; nothing is constructed from it yet
+        expect(configurator.msal.getClient()).toBeUndefined();
+        const fusion = await init(configurator);
+        expect(fusion.modules.auth.account?.name).toBe('Ada Lovelace');
+    });
+    it('exposes the same service discovery configurator the module is built from', async () => {
+        const fusion = await mockFramework((configurator) => {
+            configurator.serviceDiscovery.setBaseUri('http://localhost:6669');
+            configurator.serviceDiscovery.addService({ key: 'my-api' });
+        });
+        const service = await fusion.modules.serviceDiscovery.resolveService('my-api');
+        expect(service.uri).toContain('http://localhost:6669');
+    });
+    it('lets a service be removed so its absence can be asserted', async () => {
+        const fusion = await mockFramework((configurator) => {
+            configurator.serviceDiscovery.setResolveUnknownServices(false);
+            configurator.serviceDiscovery.removeService('bookmarks');
+        });
+        await expect(fusion.modules.serviceDiscovery.resolveService('bookmarks')).rejects.toThrow();
+    });
+    it('accepts an enableX helper directly, because it is a real configurator', async () => {
+        const fusion = await mockFramework((configurator) => {
+            enableMsalMock(configurator, (builder) => builder.setAccount({ name: 'Grace Hopper' }));
+            enableServiceDiscoveryMock(configurator, (builder) => builder.addService({ key: 'my-api' }));
+        });
+        expect(fusion.modules.auth.account?.name).toBe('Grace Hopper');
+        await expect(fusion.modules.serviceDiscovery.resolveService('my-api')).resolves.toBeDefined();
+    });
+    it('registers a module through addModule', async () => {
+        const fusion = await mockFramework((configurator) => {
+            configurator.addModule((c) => enableMsalMock(c, (builder) => builder.setAccount({ name: 'Grace Hopper' })));
+        });
+        expect(fusion.modules.auth.account?.name).toBe('Grace Hopper');
+    });
+    it('returns itself from addModule so calls can be chained', () => {
+        const configurator = new FrameworkMockConfigurator();
+        expect(configurator.addModule(() => undefined)).toBe(configurator);
+    });
+    it('exposes the same http configurator the http module is built from', async () => {
+        const configurator = new FrameworkMockConfigurator();
+        configurator.http.configureClient('my-api', { baseUri: 'http://localhost:6669' });
+        const fusion = await init(configurator);
+        expect(fusion.modules.http.createClient('my-api')).toBeDefined();
+    });
+    it('exposes the same services configurator the services module is built from', () => {
+        const configurator = new FrameworkMockConfigurator();
+        expect(configurator.services).toBeDefined();
+    });
+    it('exposes the same context configurator the context module is built from', () => {
+        const configurator = new FrameworkMockConfigurator();
+        expect(configurator.context).toBeDefined();
+    });
+    it('seeds the initial context through the context module, so `.context` backs the real module', async () => {
+        const fusion = await mockFramework((configurator) => {
+            configurator.context.setCurrentContext({
+                id: 'my-ctx',
+                type: { id: 'ProjectMaster' },
+                value: {},
+            });
+        });
+        expect(fusion.modules.context.currentContext).toMatchObject({ id: 'my-ctx' });
+    });
+    it('exposes the same telemetry configurator the telemetry module is built from', () => {
+        const configurator = new FrameworkMockConfigurator();
+        expect(configurator.telemetry).toBeDefined();
+    });
+    it('collects a tracked event through the telemetry mock adapter, reaching no real endpoint', async () => {
+        let mockConfigurator;
+        const fusion = await mockFramework((configurator) => {
+            mockConfigurator = configurator;
+        });
+        fusion.modules.telemetry.trackEvent({
+            name: 'button-click',
+            level: TelemetryLevel.Information,
+            scope: [],
+        });
+        await vi.waitFor(() => {
+            expect(mockConfigurator?.telemetry.adapter.getItems('button-click')).toHaveLength(1);
+        });
+    });
+    it('lets a module supplied through TModules get the same kind of accessor as msal and serviceDiscovery', async () => {
+        // Standing in for an application subclassing FrameworkMockConfigurator to
+        // expose its own module the same way the built-ins are exposed.
+        class AppMockConfigurator extends FrameworkMockConfigurator {
+            constructor() {
+                super();
+                this._pin(widgetsModule);
+            }
+            get widgets() {
+                return this._getConfig('widgets');
+            }
+        }
+        const configurator = new AppMockConfigurator();
+        configurator.widgets.setName('Ada');
+        const fusion = await init(configurator);
+        expect(fusion.modules.widgets.name).toBe('Ada');
+    });
+    it('pins the same instance across repeated reads, so declarations accumulate on one configurator', () => {
+        class AppMockConfigurator extends FrameworkMockConfigurator {
+            constructor() {
+                super();
+                this._pin(widgetsModule);
+            }
+            get widgets() {
+                return this._getConfig('widgets');
+            }
+        }
+        const configurator = new AppMockConfigurator();
+        expect(configurator.widgets).toBe(configurator.widgets);
+    });
+    it('throws from _getConfig when nothing was pinned for that name', () => {
+        class AppMockConfigurator extends FrameworkMockConfigurator {
+            readMissing() {
+                return this._getConfig('widgets');
+            }
+        }
+        expect(() => new AppMockConfigurator().readMissing()).toThrow(/widgets/);
+    });
+    it('throws from _pin when the module declares no configure factory', () => {
+        class AppMockConfigurator extends FrameworkMockConfigurator {
+            pinMissingConfigure() {
+                this._pin({ ...widgetsModule, configure: undefined });
+            }
+        }
+        expect(() => new AppMockConfigurator().pinMissingConfigure()).toThrow(/configure factory/);
+    });
+});
+//# sourceMappingURL=mock-framework.test.js.map

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

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

package/dist/esm/init.js

@@ -37,8 +37,13 @@ export const init = async (configurator, ref) => {
     const fusion = {
         modules,
     };
-    // Expose globally so portal shells and widgets can access the running instance
-    window.Fusion = fusion;
+    // Expose globally so portal shells and widgets can access the running instance.
+    // Guarded because the framework must also initialize where no DOM exists, such as
+    // a test runner or a server-side render.
+    if (typeof window !== 'undefined') {
+        // Global exposure predates strict typing on `Window.Fusion`; the shape is guaranteed by this function's own construction above
+        window.Fusion = fusion;
+    }
     modules.event.dispatchEvent('onFrameworkLoaded', { detail: fusion });
     // The generic TModules type is erased on the plain object above; restore it for the return type
     return fusion;

package/dist/esm/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/init.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,KAAK,EACvB,YAA6C,EAC7C,GAAU,EACiB,EAAE;IAC7B,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,UAAU,CAAgB,GAAG,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG;QACb,OAAO;KACR,CAAC;IACF,+EAA+E;IAC/E,MAAM,CAAC,MAAM,GAAG,MAA2B,CAAC;IAC5C,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,mBAAmB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAErE,gGAAgG;IAChG,OAAO,MAAqC,CAAC;AAC/C,CAAC,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/init.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,KAAK,EACvB,YAA6C,EAC7C,GAAU,EACiB,EAAE;IAC7B,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,UAAU,CAAgB,GAAG,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG;QACb,OAAO;KACR,CAAC;IACF,gFAAgF;IAChF,kFAAkF;IAClF,yCAAyC;IACzC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,+HAA+H;QAC/H,MAAM,CAAC,MAAM,GAAG,MAA2B,CAAC;IAC9C,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,mBAAmB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAErE,gGAAgG;IAChG,OAAO,MAAqC,CAAC;AAC/C,CAAC,CAAC;AAEF,eAAe,IAAI,CAAC"}