@equinor/fusion-framework-app 13.0.3-next.0 → 13.0.3

package/CHANGELOG.md

@@ -1,13 +1,11 @@
 # Change Log
 
-## 13.0.3-next.0
+## 13.0.3
 
 ### Patch Changes
 
-- c8008e3: Internal: rebase `next` onto `main`, syncing in already-published stable releases so they carry a `next` pre-release tag.
-- Updated dependencies [c8008e3]
-  - @equinor/fusion-framework-module-app@8.0.6-next.0
-  - @equinor/fusion-framework-module-state@2.0.2-next.0
+- @equinor/fusion-framework-module-telemetry@7.0.3
+  - @equinor/fusion-framework@8.0.16
 
 ## 13.0.2
 

package/README.md

@@ -20,14 +20,6 @@ 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
@@ -88,7 +80,6 @@ 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
 
@@ -109,13 +100,40 @@ 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 —
-application config endpoints, service discovery, or explicit registration —
-and you retrieve one at runtime with `framework.modules.http.createClient(name)`.
+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
 
 ```ts
 const initialize = configureModules((configurator) => {
@@ -123,9 +141,37 @@ const initialize = configureModules((configurator) => {
 });
 ```
 
-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.
+### 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.
 
 ## Enable Bookmarks
 
@@ -135,6 +181,7 @@ 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) => {
@@ -142,25 +189,8 @@ const initialize = configureModules((configurator) => {
 });
 ```
 
-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.
+Payload generators registered through the bookmark module are automatically
+cleaned up when the module is disposed.
 
 ## Types
 

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

package/dist/esm/version.js

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

package/dist/esm/version.js.map

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