@memberjunction/ng-auth-services 2.129.0 → 2.130.1

package/dist/lib/providers/mjexplorer-msal-provider.service.d.ts

@@ -1,16 +1,22 @@
 import { OnDestroy } from '@angular/core';
 import { MJAuthBase } from '../mjexplorer-auth-base.service';
-import { Observable } from 'rxjs';
 import { MsalBroadcastService, MsalService, MsalGuard } from '@azure/msal-angular';
-import { AccountInfo } from '@azure/msal-common';
 import { PublicClientApplication, InteractionType } from '@azure/msal-browser';
+import { StandardUserInfo, StandardAuthToken, StandardAuthError, TokenRefreshResult } from '../auth-types';
 import * as i0 from "@angular/core";
 export declare function LoadMJMSALProvider(): void;
+/**
+ * MSAL (Microsoft Authentication Library) provider implementation - v3.0.0
+ *
+ * Implements the abstract methods from MJAuthBase to hide MSAL-specific details.
+ * The key abstraction is that MSAL stores the JWT in AuthenticationResult.idToken,
+ * but consumers never need to know this detail.
+ */
 export declare class MJMSALProvider extends MJAuthBase implements OnDestroy {
     auth: MsalService;
     private msalBroadcastService;
     static readonly PROVIDER_TYPE = "msal";
-    type: string;
+    readonly type = "msal";
     private readonly _destroying$;
     private readonly _initializationCompleted$;
     private _initPromise;
@@ -18,7 +24,7 @@ export declare class MJMSALProvider extends MJAuthBase implements OnDestroy {
      * Factory function to provide Angular dependencies required by MSAL
      * Stored as a static property for the factory to access without instantiation
      */
-    static angularProviderFactory: (environment: any) => (typeof MsalService | typeof MsalBroadcastService | typeof MsalGuard | {
+    static angularProviderFactory: (environment: Record<string, unknown>) => (typeof MsalService | typeof MsalBroadcastService | typeof MsalGuard | {
         provide: import("@angular/core").InjectionToken<string>;
         useValue: PublicClientApplication;
     } | {
@@ -39,22 +45,65 @@ export declare class MJMSALProvider extends MJAuthBase implements OnDestroy {
         };
     })[];
     constructor(auth: MsalService, msalBroadcastService: MsalBroadcastService);
-    private initializeMSAL;
+    initialize(): Promise<void>;
     private _performInitialization;
-    private ensureInitialized;
-    login(options?: any): Observable<void>;
+    protected loginInternal(options?: Record<string, unknown>): Promise<void>;
     logout(): Promise<void>;
-    refresh(): Promise<Observable<any>>;
-    getUser(): Promise<AccountInfo | null>;
-    isAuthenticated(): Observable<boolean>;
-    getUserClaims(): Promise<Observable<any>>;
-    checkExpiredTokenError(error: string): boolean;
-    initialize(): Promise<void>;
-    protected loginInternal(options?: any): Promise<void>;
-    getToken(): Promise<string | null>;
     handleCallback(): Promise<void>;
+    /**
+     * Extract ID token from MSAL's storage
+     *
+     * MSAL stores the JWT in AuthenticationResult.idToken
+     * This is the key abstraction - consumers never need to know about MSAL's structure!
+     */
+    protected extractIdTokenInternal(): Promise<string | null>;
+    /**
+     * Extract complete token info from MSAL
+     *
+     * Maps MSAL's AuthenticationResult to StandardAuthToken
+     */
+    protected extractTokenInfoInternal(): Promise<StandardAuthToken | null>;
+    /**
+     * Extract user info from MSAL account
+     *
+     * Maps MSAL's AccountInfo structure to StandardUserInfo
+     */
+    protected extractUserInfoInternal(): Promise<StandardUserInfo | null>;
+    /**
+     * Refresh token using MSAL's silent token acquisition
+     *
+     * Uses acquireTokenSilent with forceRefresh to get new tokens
+     */
+    protected refreshTokenInternal(): Promise<TokenRefreshResult>;
+    /**
+     * Classify MSAL-specific errors into semantic types
+     *
+     * Maps MSAL error classes to AuthErrorType enum
+     */
+    protected classifyErrorInternal(error: unknown): StandardAuthError;
+    private ensureInitialized;
+    /**
+     * Map MSAL AccountInfo to StandardUserInfo
+     */
+    private mapMSALAccountToStandard;
+    /**
+     * Get profile picture URL from Microsoft Graph API
+     *
+     * MSAL requires fetching the photo from Microsoft Graph.
+     * This is the key advantage of encapsulation - consumers don't need
+     * to know about Graph API, they just call getProfilePictureUrl()!
+     */
+    protected getProfilePictureUrlInternal(): Promise<string | null>;
+    /**
+     * Handle session expiry by redirecting to Microsoft login
+     *
+     * This method is called by the base class when silent token refresh fails
+     * with INTERACTION_REQUIRED error. It redirects to Microsoft login and never returns.
+     * After authentication, the app will reload and re-initialize with a fresh token.
+     */
+    protected handleSessionExpiryInternal(): Promise<void>;
     getRequiredConfig(): string[];
-    validateConfig(_config: any): boolean;
+    validateConfig(_config: Record<string, unknown>): boolean;
     ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<MJMSALProvider, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<MJMSALProvider>;

package/dist/lib/providers/mjexplorer-msal-provider.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mjexplorer-msal-provider.service.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/mjexplorer-msal-provider.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,SAAS,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAmB,UAAU,EAA2F,MAAM,MAAM,CAAC;AAC5I,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAA6D,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC9I,OAAO,EAAE,WAAW,EAAwB,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAsE,uBAAuB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;;AAKnJ,wBAAgB,kBAAkB,SACjC;AAED,qBAIa,cAAe,SAAQ,UAAW,YAAW,SAAS;IAgD9C,IAAI,EAAE,WAAW;IAAE,OAAO,CAAC,oBAAoB;IA/ClE,MAAM,CAAC,QAAQ,CAAC,aAAa,UAAU;IACvC,IAAI,SAAgC;IAEpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuB;IACpD,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAuC;IACjF,OAAO,CAAC,YAAY,CAA8B;IAElD;;;OAGG;IACH,MAAM,CAAC,sBAAsB,gBAAiB,GAAG;;;;;;;;;;;;;;;;;;;SAkC/C;gBAEiB,IAAI,EAAE,WAAW,EAAU,oBAAoB,EAAE,oBAAoB;YAU1E,cAAc;YAUd,sBAAsB;YAuCtB,iBAAiB;IAUtB,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC;IAmBlC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAOvB,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAS1C,OAAO,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAKnC,eAAe,IAAI,UAAU,CAAC,OAAO,CAAC;IAKzC,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IA+B/C,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAKxC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;cAIjB,aAAa,CAAC,OAAO,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBrD,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA8BlC,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrC,iBAAiB,IAAI,MAAM,EAAE;IAI7B,cAAc,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO;IAKrC,WAAW,IAAI,IAAI;yCA3QR,cAAc;6CAAd,cAAc;CAyR1B"}
+{"version":3,"file":"mjexplorer-msal-provider.service.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/mjexplorer-msal-provider.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,SAAS,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAE7D,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAA6D,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAE9I,OAAO,EAAsE,uBAAuB,EAAE,eAAe,EAAoB,MAAM,qBAAqB,CAAC;AAGrK,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EAEjB,kBAAkB,EACnB,MAAM,eAAe,CAAC;;AAGvB,wBAAgB,kBAAkB,SACjC;AAED;;;;;;GAMG;AACH,qBAIa,cAAe,SAAQ,UAAW,YAAW,SAAS;IAgD9C,IAAI,EAAE,WAAW;IAAE,OAAO,CAAC,oBAAoB;IA/ClE,MAAM,CAAC,QAAQ,CAAC,aAAa,UAAU;IACvC,QAAQ,CAAC,IAAI,UAAgC;IAE7C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuB;IACpD,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAuC;IACjF,OAAO,CAAC,YAAY,CAA8B;IAElD;;;OAGG;IACH,MAAM,CAAC,sBAAsB,gBAAiB,OAAO,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;;;;;;;;SAkCnE;gBAEiB,IAAI,EAAE,WAAW,EAAU,oBAAoB,EAAE,oBAAoB;IAYlF,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YASnB,sBAAsB;cAwDpB,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBzE,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAOvB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAUrC;;;;;OAKG;cACa,sBAAsB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA+BhE;;;;OAIG;cACa,wBAAwB,IAAI,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IA4C7E;;;;OAIG;cACa,uBAAuB,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAgB3E;;;;OAIG;cACa,oBAAoB,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAuEnE;;;;OAIG;IACH,SAAS,CAAC,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB;YA2EpD,iBAAiB;IAQ/B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAYhC;;;;;;OAMG;cACa,4BAA4B,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAqCtE;;;;;;OAMG;cACa,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBnD,iBAAiB,IAAI,MAAM,EAAE;IAI7B,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IASlE,WAAW,IAAI,IAAI;yCAthBR,cAAc;6CAAd,cAAc;CA4hB1B"}