@equinor/fusion-framework 9.0.5 → 9.1.0-next.0

package/dist/types/FrameworkConfigurator.d.ts

@@ -1,10 +1,26 @@
-import { type AnyModule, ModulesConfigurator } from '@equinor/fusion-framework-module';
+import { type AnyModule, type CombinedModules, type ModulesConfig, ModulesConfigurator } from '@equinor/fusion-framework-module';
 import { configureHttpClient, configureHttp, type HttpClientOptions } from '@equinor/fusion-framework-module-http';
 import type { HttpClientMsal } from '@equinor/fusion-framework-module-http/client';
 import { type AuthConfigFn } from '@equinor/fusion-framework-module-msal';
-import { enableTelemetry } from '@equinor/fusion-framework-module-telemetry';
+import { enableTelemetry, type ITelemetryConfigurator } from '@equinor/fusion-framework-module-telemetry';
 import type { FusionModules } from './types.js';
 import type { MsalClientConfig } from '@equinor/fusion-framework-module-msal';
+/**
+ * Options for creating a {@link FrameworkConfigurator}.
+ */
+export interface FrameworkConfiguratorOptions {
+    /**
+     * Telemetry configuration builder the framework host should configure, for example a
+     * mock builder in tests. Defaults to a new `TelemetryConfigurator`.
+     */
+    telemetry?: ITelemetryConfigurator;
+    /**
+     * Records one safe `fusion.http.request.duration` metric per transport attempt of the
+     * framework's HTTP clients, plus a sanitized failure on error. Defaults to `true`; set
+     * `false` to keep framework HTTP traffic out of operational telemetry.
+     */
+    httpTelemetry?: boolean;
+}
 /**
  * Configurator that registers and wires the core Fusion Framework modules.
  *
@@ -39,6 +55,7 @@ import type { MsalClientConfig } from '@equinor/fusion-framework-module-msal';
  * ```
  */
 export declare class FrameworkConfigurator<TModules extends Array<AnyModule> = [], TRef = any> extends ModulesConfigurator<FusionModules<TModules>, TRef> {
+    #private;
     /**
      * The class name used for event naming. This static property ensures
      * the name is preserved through compilation and minification.
@@ -50,6 +67,7 @@ export declare class FrameworkConfigurator<TModules extends Array<AnyModule> = [
      * Initializes the framework with core modules (event, auth, http, service discovery,
      * services, context, and telemetry) and sets up default telemetry that includes
      * framework version metadata and 'framework' scope for all telemetry events.
+     * @param options - Optional host setup; see {@link FrameworkConfiguratorOptions}.
      *
      * @example
      * ```typescript
@@ -57,7 +75,20 @@ export declare class FrameworkConfigurator<TModules extends Array<AnyModule> = [
      * // Now ready to configure additional modules
      * ```
      */
-    constructor();
+    constructor(options?: FrameworkConfiguratorOptions);
+    /**
+     * Configures modules, then installs HTTP telemetry as the innermost middleware.
+     *
+     * Post-configure callbacks run concurrently, so installing after the whole configure phase
+     * is the only point where every application middleware, including retry middleware added
+     * from asynchronous callbacks, is already registered.
+     *
+     * @param ref - Optional reference forwarded to module configuration.
+     * @returns The final module configuration map.
+     * @template T - Additional modules included in the configuration type.
+     * @template R - Reference type forwarded to module configuration.
+     */
+    protected _configure<T, R extends TRef = TRef>(ref?: R): Promise<ModulesConfig<CombinedModules<T, FusionModules<TModules>>>>;
     /**
      * Configures the global HTTP module settings such as base URLs, default headers,
      * request/response interceptors, and timeout settings.

package/dist/types/__tests__/http-telemetry.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/__tests__/telemetry-host.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/connect-http-telemetry.d.ts

@@ -0,0 +1,32 @@
+import type { AnyModule, ModulesConfigurator } from '@equinor/fusion-framework-module';
+/** Host-owned HTTP telemetry, installed once the configure phase has settled. */
+export interface HostHttpTelemetry {
+    /**
+     * Appends the transport-attempt middleware to the host's HTTP configuration.
+     * Call it after every `configure`, `onConfigured` and `afterConfig` callback has settled,
+     * so the middleware is innermost regardless of callback registration order or timing.
+     * @param config - Final module configuration map of the host.
+     */
+    install(config: unknown): void;
+}
+/**
+ * Instruments every HTTP client the host's HTTP module builds with transport-attempt telemetry.
+ *
+ * The owning host calls {@link HostHttpTelemetry.install} after its configure phase has
+ * settled, making this the innermost configurator-level middleware: retry or caching
+ * middleware registered by applications, including from asynchronous post-configure
+ * callbacks, wraps it, and each actual fetch attempt produces one
+ * `fusion.http.request.duration` record. Clients configured with their own
+ * `middlewareHandler` replace the configurator middleware and are not instrumented.
+ *
+ * Telemetry is resolved after initialization through a plugin, so HTTP never waits for
+ * telemetry and requests issued while modules initialize are not recorded. The plugin
+ * teardown detaches instrumentation before modules dispose, without aborting requests.
+ *
+ * @param configurator - Host configurator owning the HTTP and telemetry modules.
+ * @returns The installer the host calls once configuration has settled.
+ * @template TModules - Modules registered on the host configurator.
+ * @template TRef - Reference type forwarded to module initialization.
+ */
+export declare function connectHttpTelemetry<TModules extends Array<AnyModule>, TRef>(configurator: ModulesConfigurator<TModules, TRef>): HostHttpTelemetry;
+export default connectHttpTelemetry;

package/dist/types/index.d.ts

@@ -32,5 +32,6 @@ export { FrameworkConfigurator,
  * @deprecated Use {@link FrameworkConfigurator} instead.
  */
 FrameworkConfigurator as FusionConfigurator, } from './FrameworkConfigurator.js';
+export type { FrameworkConfiguratorOptions } from './FrameworkConfigurator.js';
 export type { FusionModules, FusionModulesInstance, Fusion, FusionRenderFn } from './types.js';
 export { default, init } from './init.js';

package/dist/types/mock/FrameworkMockConfigurator.d.ts

@@ -4,7 +4,7 @@ import { type IHttpClientConfigurator } from '@equinor/fusion-framework-module-h
 import { type MsalMockConfigurator } from '@equinor/fusion-framework-module-msal/mock';
 import { type ServiceDiscoveryMockConfigurator } from '@equinor/fusion-framework-module-service-discovery/mock';
 import { type IApiConfigurator } from '@equinor/fusion-framework-module-services';
-import { type TelemetryMockConfigurator } from '@equinor/fusion-framework-module-telemetry/mock';
+import { TelemetryMockConfigurator } from '@equinor/fusion-framework-module-telemetry/mock';
 import { FrameworkConfigurator } from '../FrameworkConfigurator.js';
 /**
  * The real framework configurator, with every built-in module that reaches
@@ -69,9 +69,8 @@ export declare class FrameworkMockConfigurator<TModules extends Array<AnyModule>
      * @remarks
      * The module system otherwise builds a fresh configurator from its own
      * `configure` factory during the configure phase — too late for a test to
-     * reach, and a new instance on every call besides. This replaces that
-     * factory with one that always returns the same instance, and registers the
-     * result under the module's own name.
+     * reach, and a new instance on every call besides. Prepared registration
+     * supplies that exact builder without replacing the module's factory.
      *
      * A subclass registering a module supplied through {@link TModules} uses
      * this the same way `.msal` and `.serviceDiscovery` do, to expose its own

package/dist/types/version.d.ts

@@ -1 +1 @@
-export declare const version = "9.0.5";
+export declare const version = "9.1.0-next.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@equinor/fusion-framework",
-  "version": "9.0.5",
+  "version": "9.1.0-next.0",
   "description": "",
   "type": "module",
   "main": "dist/esm/index.js",
@@ -41,14 +41,14 @@
     "directory": "packages/framework"
   },
   "dependencies": {
-    "@equinor/fusion-framework-module": "6.1.6",
-    "@equinor/fusion-framework-module-context": "9.0.2",
-    "@equinor/fusion-framework-module-event": "6.1.3",
-    "@equinor/fusion-framework-module-http": "8.1.4",
-    "@equinor/fusion-framework-module-msal": "12.0.1",
-    "@equinor/fusion-framework-module-service-discovery": "10.2.0",
-    "@equinor/fusion-framework-module-services": "8.1.5",
-    "@equinor/fusion-framework-module-telemetry": "7.2.2",
+    "@equinor/fusion-framework-module": "6.2.0-next.0",
+    "@equinor/fusion-framework-module-context": "9.1.0-next.0",
+    "@equinor/fusion-framework-module-event": "6.1.4-next.0",
+    "@equinor/fusion-framework-module-http": "8.1.5-next.0",
+    "@equinor/fusion-framework-module-msal": "12.1.0-next.0",
+    "@equinor/fusion-framework-module-service-discovery": "10.3.0-next.0",
+    "@equinor/fusion-framework-module-services": "8.2.0-next.0",
+    "@equinor/fusion-framework-module-telemetry": "8.0.0-next.0",
     "rxjs": "^7.8.1"
   },
   "devDependencies": {