@equinor/fusion-framework-module-msal 7.1.0 → 7.2.0

package/dist/types/MsalConfigurator.d.ts

@@ -113,6 +113,21 @@ export declare class MsalConfigurator extends BaseConfigBuilder<MsalConfig> {
      * ```
      */
     setRequiresAuth(requiresAuth: boolean): this;
+    /**
+     * Sets a default login hint for authentication flows.
+     *
+     * The login hint is used to pre-fill the username during authentication and
+     * enables silent SSO when no account is available.
+     *
+     * @param loginHint - The preferred username/email to use as login hint
+     * @returns The configurator instance for method chaining
+     *
+     * @example
+     * ```typescript
+     * configurator.setLoginHint('user@company.com');
+     * ```
+     */
+    setLoginHint(loginHint?: string): this;
     /**
      * @deprecated - since version 5.1.0, use setClient instead
      */

package/dist/types/module.d.ts

@@ -39,6 +39,11 @@ export type AuthConfigFn = (builder: {
      * @param requiresAuth - If true, app will attempt automatic login on initialization
      */
     setRequiresAuth: (requiresAuth: boolean) => void;
+    /**
+     * Set a default login hint used for silent SSO and pre-filled usernames
+     * @param loginHint - Preferred username/email to use for login hint
+     */
+    setLoginHint: (loginHint: string) => void;
 }) => void;
 /**
  * Enables MSAL authentication module in the framework.

package/dist/types/version.d.ts

@@ -1 +1 @@
-export declare const version = "7.1.0";
+export declare const version = "7.2.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@equinor/fusion-framework-module-msal",
-  "version": "7.1.0",
+  "version": "7.2.0",
   "description": "Microsoft Authentication Library (MSAL) integration module for Fusion Framework",
   "main": "dist/esm/index.js",
   "types": "dist/types/index.d.ts",

package/src/MsalConfigurator.ts

@@ -43,6 +43,7 @@ const MsalConfigSchema = z.object({
   provider: z.custom<IMsalProvider>().optional(),
   requiresAuth: z.boolean().optional(),
   redirectUri: z.string().optional(),
+  loginHint: z.string().optional(),
   authCode: z.string().optional(),
   version: z.string().transform((x: string) => String(semver.coerce(x))),
   telemetry: TelemetryConfigSchema,
@@ -180,6 +181,25 @@ export class MsalConfigurator extends BaseConfigBuilder<MsalConfig> {
     return this;
   }
 
+  /**
+   * Sets a default login hint for authentication flows.
+   *
+   * The login hint is used to pre-fill the username during authentication and
+   * enables silent SSO when no account is available.
+   *
+   * @param loginHint - The preferred username/email to use as login hint
+   * @returns The configurator instance for method chaining
+   *
+   * @example
+   * ```typescript
+   * configurator.setLoginHint('user@company.com');
+   * ```
+   */
+  setLoginHint(loginHint?: string): this {
+    this._set('loginHint', async () => loginHint);
+    return this;
+  }
+
   /**
    * @deprecated - since version 5.1.0, use setClient instead
    */

package/src/MsalProvider.ts

@@ -61,6 +61,7 @@ export class MsalProvider extends BaseModuleProvider<MsalConfig> implements IMsa
   };
   #requiresAuth?: boolean;
   #authCode?: string;
+  #loginHint?: string;
 
   /**
    * The MSAL module version enum value indicating the API compatibility level.
@@ -127,6 +128,7 @@ export class MsalProvider extends BaseModuleProvider<MsalConfig> implements IMsa
     });
     this.#requiresAuth = config.requiresAuth;
     this.#telemetry = config.telemetry;
+    this.#loginHint = config.loginHint;
 
     // Extract auth code from config if present
     // This will be used during initialize to exchange for tokens
@@ -406,6 +408,9 @@ export class MsalProvider extends BaseModuleProvider<MsalConfig> implements IMsa
   async login(options: LoginOptions): Promise<LoginResult> {
     const { behavior = 'redirect', silent = true, request } = options;
 
+    request.loginHint ??=
+      this.#loginHint ?? this.account?.username ?? this.account?.loginHint ?? undefined;
+
     // Determine if silent login is possible based on available account/hint information
     // Silent login requires either an account object or a loginHint to work
     const canLoginSilently = silent && (request.account || request.loginHint);

package/src/module.ts

@@ -91,6 +91,11 @@ export type AuthConfigFn = (builder: {
    * @param requiresAuth - If true, app will attempt automatic login on initialization
    */
   setRequiresAuth: (requiresAuth: boolean) => void;
+  /**
+   * Set a default login hint used for silent SSO and pre-filled usernames
+   * @param loginHint - Preferred username/email to use for login hint
+   */
+  setLoginHint: (loginHint: string) => void;
 }) => void;
 
 /**

package/src/version.ts

@@ -1,2 +1,2 @@
 // Generated by genversion.
-export const version = '7.1.0';
+export const version = '7.2.0';