@equinor/fusion-framework-module-msal 7.0.0-next.0 → 7.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@equinor/fusion-framework-module-msal",
-  "version": "7.0.0-next.0",
+  "version": "7.0.0",
   "description": "Microsoft Authentication Library (MSAL) integration module for Fusion Framework",
   "main": "dist/esm/index.js",
   "types": "dist/types/index.d.ts",
@@ -12,6 +12,10 @@
     "./v2": {
       "import": "./dist/esm/v2/index.js",
       "types": "./dist/types/v2/index.d.ts"
+    },
+    "./v4": {
+      "import": "./dist/esm/v4/index.js",
+      "types": "./dist/types/v4/index.d.ts"
     }
   },
   "typesVersions": {
@@ -21,6 +25,9 @@
       ],
       "v2": [
         "dist/types/v2/index.d.ts"
+      ],
+      "v4": [
+        "dist/types/v4/index.d.ts"
       ]
     }
   },
@@ -36,23 +43,23 @@
     "directory": "packages/modules/msal"
   },
   "dependencies": {
-    "@azure/msal-browser": "^2.21.0"
+    "@azure/msal-browser": "^5.0.2"
   },
   "devDependencies": {
     "@types/semver": "^7.5.0",
     "semver": "^7.5.4",
     "typescript": "^5.8.2",
     "zod": "^4.1.8",
-    "@equinor/fusion-framework-module": "^5.0.6-next.0",
-    "@equinor/fusion-framework-module-telemetry": "^5.0.0-next.0"
+    "@equinor/fusion-framework-module-telemetry": "^4.6.1",
+    "@equinor/fusion-framework-module": "^5.0.5"
   },
   "peerDependencies": {
     "@types/semver": "^7.5.0",
     "semver": "^7.5.4",
     "typescript": "^5.8.2",
     "zod": "^4.1.8",
-    "@equinor/fusion-framework-module": "^5.0.6-next.0",
-    "@equinor/fusion-framework-module-telemetry": "^5.0.0-next.0"
+    "@equinor/fusion-framework-module": "^5.0.5",
+    "@equinor/fusion-framework-module-telemetry": "^4.6.1"
   },
   "peerDependenciesMeta": {
     "@equinor/fusion-framework-module-telemetry": {

package/src/MsalClient.ts

@@ -18,6 +18,12 @@ import type {
 
 export type { IMsalClient };
 
+/**
+ * Fallback correlation ID for logger calls when request doesn't provide one.
+ * Empty string indicates a non-request-specific log (validation, configuration warnings).
+ */
+const FUSION_CORRELATION_ID = '';
+
 /**
  * MSAL client configuration extending the standard MSAL Configuration.
  *
@@ -127,13 +133,17 @@ export class MsalClient extends PublicClientApplication implements IMsalClient {
       if (!options.request.account && !options.request.loginHint) {
         this.getLogger().warning(
           'No account or login hint provided, please provide an account or login hint in the request',
+          options.request.correlationId || FUSION_CORRELATION_ID,
         );
       }
       try {
         return await this.ssoSilent(options.request as SilentRequest);
       } catch {
         // Silent login failed - continue to interactive flow
-        this.getLogger().warning('Silent login failed, falling back to interactive');
+        this.getLogger().warning(
+          'Silent login failed, falling back to interactive',
+          options.request.correlationId || FUSION_CORRELATION_ID,
+        );
       }
     }
 
@@ -189,6 +199,7 @@ export class MsalClient extends PublicClientApplication implements IMsalClient {
     if (!options?.account) {
       this.getLogger().warning(
         'No account available for logout, please provide an account in the options',
+        FUSION_CORRELATION_ID,
       );
     }
 
@@ -233,6 +244,7 @@ export class MsalClient extends PublicClientApplication implements IMsalClient {
     if (request.scopes.length === 0) {
       this.getLogger().warning(
         'No scopes provided, please provide scopes in the request option, see options.request for more information.',
+        request.correlationId || FUSION_CORRELATION_ID,
       );
     }
 
@@ -241,15 +253,22 @@ export class MsalClient extends PublicClientApplication implements IMsalClient {
     if (silent) {
       if (request.account) {
         try {
-          this.getLogger().verbose('Attempting to acquire token silently');
+          this.getLogger().verbose(
+            'Attempting to acquire token silently',
+            request.correlationId || FUSION_CORRELATION_ID,
+          );
           return await this.acquireTokenSilent(request as SilentRequest);
         } catch {
           // Silent acquisition failed - fall back to interactive
-          this.getLogger().warning('Silent token acquisition failed, falling back to interactive');
+          this.getLogger().warning(
+            'Silent token acquisition failed, falling back to interactive',
+            request.correlationId || FUSION_CORRELATION_ID,
+          );
         }
       } else {
         this.getLogger().warning(
           'Cannot acquire token silently, no account provided, falling back to interactive.',
+          request.correlationId || FUSION_CORRELATION_ID,
         );
       }
     }

package/src/MsalProxyProvider.interface.ts

@@ -15,6 +15,7 @@ import type { IMsalProvider as IMsalProvider_v2 } from './v2/MsalProvider.interf
 type ProxyProviderMap = {
   [MsalModuleVersion.V2]: IMsalProvider_v2;
   [MsalModuleVersion.V4]: IMsalProvider;
+  [MsalModuleVersion.V5]: IMsalProvider;
 };
 
 /**

package/src/create-proxy-provider.ts

@@ -2,6 +2,7 @@ import type { IMsalProvider } from './MsalProvider.interface';
 import { MsalModuleVersion } from './static';
 import { resolveVersion } from './versioning/resolve-version';
 import { createProxyProvider as createProxyProvider_v2 } from './v2/create-proxy-provider';
+import { createProxyProvider as createProxyProvider_v4 } from './v4/create-proxy-provider';
 
 /**
  * Creates a proxy provider for version compatibility.
@@ -32,8 +33,10 @@ export function createProxyProvider<T = IMsalProvider>(
       // Create v2-compatible proxy with legacy API adapters
       return createProxyProvider_v2(provider) as T;
     case MsalModuleVersion.V4:
-      // Create transparent proxy for v4 - passes through to original provider
-      // This allows v4 code to be used where any version is expected
+      // Create v4-compatible proxy (passthrough with v4 version metadata)
+      return createProxyProvider_v4(provider) as T;
+    case MsalModuleVersion.V5:
+      // Create transparent proxy for v5 - passes through to original provider
       return new Proxy(provider, {
         get: (target: IMsalProvider, prop: keyof IMsalProvider) => {
           switch (prop) {

package/src/static.ts

@@ -9,20 +9,19 @@ export const ModuleName = 'msal' as const;
  * Enumeration of supported MSAL module versions.
  *
  * This enum defines the available MSAL versions and provides type-safe access to version identifiers.
- * The `Latest` value is automatically set to the current module version at build time.
  *
  * @remarks
  * - `V2`: MSAL v2 compatibility (legacy support)
- * - `V4`: MSAL v4 (current major version)
- * - `Latest`: Always points to the current module version (5.1.0)
+ * - `V4`: MSAL v4 compatibility (supports @azure/msal-browser 4.x)
+ * - `V5`: MSAL v5 compatibility (supports @azure/msal-browser 5.x)
  *
  * @example
  * ```typescript
  * import { MsalModuleVersion } from '@equinor/fusion-framework-module-msal';
  *
  * // Check version
- * if (version === MsalModuleVersion.Latest) {
- *   console.log('Using latest MSAL version');
+ * if (version === MsalModuleVersion.V5) {
+ *   console.log('Using MSAL v5 compatible version');
  * }
  *
  * // Create version-specific proxy
@@ -30,8 +29,10 @@ export const ModuleName = 'msal' as const;
  * ```
  */
 export enum MsalModuleVersion {
-  /** MSAL v2 compatibility version */
+  /** MSAL v2 compatibility version (legacy support) */
   V2 = 'v2',
-  /** MSAL v4 (current major version) */
+  /** MSAL v4 compatibility version (supports @azure/msal-browser 4.x) */
   V4 = 'v4',
+  /** MSAL v5 compatibility version (supports @azure/msal-browser 5.x) */
+  V5 = 'v5',
 }

package/src/v4/create-proxy-provider.ts

@@ -0,0 +1,74 @@
+import type { IMsalProvider } from '../MsalProvider.interface';
+import { MsalModuleVersion } from '../static';
+
+/**
+ * Creates a v4-compatible proxy provider.
+ *
+ * Since v4 and v5 are API compatible, this creates a simple passthrough proxy
+ * that only adjusts the msalVersion property to report V4 compatibility.
+ *
+ * @param provider - The base MSAL v5 provider instance to wrap
+ * @returns A proxy provider reporting v4 compatibility
+ *
+ * @example
+ * ```typescript
+ * const baseProvider = new MsalProvider(config);
+ * const v4Proxy = createProxyProvider(baseProvider);
+ *
+ * // Use with v4-compatible API (same as v5)
+ * await v4Proxy.login({ request: { scopes: ['User.Read'] } });
+ * ```
+ */
+export function createProxyProvider(provider: IMsalProvider): IMsalProvider {
+  // Create passthrough proxy that only overrides msalVersion
+  return new Proxy(provider, {
+    get: (target: IMsalProvider, prop: keyof IMsalProvider) => {
+      switch (prop) {
+        case 'msalVersion': {
+          // Report as V4 for compatibility tracking
+          return MsalModuleVersion.V4;
+        }
+        case 'version': {
+          return target.version;
+        }
+        case 'client': {
+          return target.client;
+        }
+        case 'account': {
+          return target.account;
+        }
+        case 'acquireAccessToken': {
+          return target.acquireAccessToken.bind(target);
+        }
+        case 'acquireToken': {
+          return target.acquireToken.bind(target);
+        }
+        case 'login': {
+          return target.login.bind(target);
+        }
+        case 'logout': {
+          return target.logout.bind(target);
+        }
+        case 'handleRedirect': {
+          return target.handleRedirect.bind(target);
+        }
+        case 'createProxyProvider': {
+          return target.createProxyProvider.bind(target);
+        }
+        case 'initialize': {
+          return () => {
+            // noop - initialize is handled by the provider, not the proxy
+          };
+        }
+        default: {
+          // Prevent 'then' from being called - this is not an async operation
+          if (prop === 'then') return undefined;
+
+          // Exhaustive check: TypeScript-only guard to ensure all IMsalProvider keys are handled
+          const exhausted: never = prop;
+          return (target as IMsalProvider)[exhausted];
+        }
+      }
+    },
+  }) as IMsalProvider;
+}

package/src/v4/index.ts

@@ -0,0 +1,13 @@
+/**
+ * MSAL v4 compatibility layer for v5 implementation.
+ *
+ * @remarks
+ * This module provides v4-compatible proxies when running on v5.
+ * Since v4 and v5 are API compatible, this is primarily a passthrough
+ * with version metadata adjustments.
+ *
+ * @module v4
+ */
+
+export { createProxyProvider } from './create-proxy-provider';
+export type * from './types';