@azure/msal-common 14.0.2 → 14.0.3

package/src/authority/AuthorityFactory.ts

@@ -0,0 +1,106 @@
+/*
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+
+import { Authority } from "./Authority";
+import { ClientConfigurationError } from "../error/ClientConfigurationError";
+import { INetworkModule } from "../network/INetworkModule";
+import { ClientAuthError } from "../error/ClientAuthError";
+import { ICacheManager } from "../cache/interface/ICacheManager";
+import { AuthorityOptions } from "./AuthorityOptions";
+import { Logger } from "../logger/Logger";
+import { IPerformanceClient } from "../telemetry/performance/IPerformanceClient";
+import { PerformanceEvents } from "../telemetry/performance/PerformanceEvent";
+
+/** @internal */
+export class AuthorityFactory {
+    /**
+     * Create an authority object of the correct type based on the url
+     * Performs basic authority validation - checks to see if the authority is of a valid type (i.e. aad, b2c, adfs)
+     *
+     * Also performs endpoint discovery.
+     *
+     * @param authorityUri
+     * @param networkClient
+     * @param protocolMode
+     */
+    static async createDiscoveredInstance(
+        authorityUri: string,
+        networkClient: INetworkModule,
+        cacheManager: ICacheManager,
+        authorityOptions: AuthorityOptions,
+        logger: Logger,
+        performanceClient?: IPerformanceClient,
+        correlationId?: string
+    ): Promise<Authority> {
+        performanceClient?.addQueueMeasurement(
+            PerformanceEvents.AuthorityFactoryCreateDiscoveredInstance,
+            correlationId
+        );
+
+        const authorityUriFinal =
+            Authority.transformCIAMAuthority(authorityUri);
+
+        // Initialize authority and perform discovery endpoint check.
+        const acquireTokenAuthority: Authority =
+            AuthorityFactory.createInstance(
+                authorityUriFinal,
+                networkClient,
+                cacheManager,
+                authorityOptions,
+                logger,
+                performanceClient,
+                correlationId
+            );
+
+        try {
+            performanceClient?.setPreQueueTime(
+                PerformanceEvents.AuthorityResolveEndpointsAsync,
+                correlationId
+            );
+
+            await acquireTokenAuthority.resolveEndpointsAsync();
+            return acquireTokenAuthority;
+        } catch (e) {
+            throw ClientAuthError.createEndpointDiscoveryIncompleteError(
+                e as string
+            );
+        }
+    }
+
+    /**
+     * Create an authority object of the correct type based on the url
+     * Performs basic authority validation - checks to see if the authority is of a valid type (i.e. aad, b2c, adfs)
+     *
+     * Does not perform endpoint discovery.
+     *
+     * @param authorityUrl
+     * @param networkInterface
+     * @param protocolMode
+     */
+    static createInstance(
+        authorityUrl: string,
+        networkInterface: INetworkModule,
+        cacheManager: ICacheManager,
+        authorityOptions: AuthorityOptions,
+        logger: Logger,
+        performanceClient?: IPerformanceClient,
+        correlationId?: string
+    ): Authority {
+        // Throw error if authority url is empty
+        if (!authorityUrl) {
+            throw ClientConfigurationError.createUrlEmptyError();
+        }
+
+        return new Authority(
+            authorityUrl,
+            networkInterface,
+            cacheManager,
+            authorityOptions,
+            logger,
+            performanceClient,
+            correlationId
+        );
+    }
+}