@azure/msal-common 16.0.0-alpha.0 → 16.0.0-beta.0

package/lib/types/client/BaseClient.d.ts

@@ -1,59 +0,0 @@
-import { ClientConfiguration, CommonClientConfiguration } from "../config/ClientConfiguration.js";
-import { INetworkModule, NetworkRequestOptions } from "../network/INetworkModule.js";
-import { NetworkResponse } from "../network/NetworkResponse.js";
-import { ICrypto } from "../crypto/ICrypto.js";
-import { Authority } from "../authority/Authority.js";
-import { Logger } from "../logger/Logger.js";
-import { ServerAuthorizationTokenResponse } from "../response/ServerAuthorizationTokenResponse.js";
-import { CacheManager } from "../cache/CacheManager.js";
-import { ServerTelemetryManager } from "../telemetry/server/ServerTelemetryManager.js";
-import { RequestThumbprint } from "../network/RequestThumbprint.js";
-import { CcsCredential } from "../account/CcsCredential.js";
-import { IPerformanceClient } from "../telemetry/performance/IPerformanceClient.js";
-import { BaseAuthRequest } from "../request/BaseAuthRequest.js";
-/**
- * Base application class which will construct requests to send to and handle responses from the Microsoft STS using the authorization code flow.
- * @internal
- */
-export declare abstract class BaseClient {
-    logger: Logger;
-    protected config: CommonClientConfiguration;
-    protected cryptoUtils: ICrypto;
-    protected cacheManager: CacheManager;
-    protected networkClient: INetworkModule;
-    protected serverTelemetryManager: ServerTelemetryManager | null;
-    authority: Authority;
-    protected performanceClient: IPerformanceClient;
-    protected constructor(configuration: ClientConfiguration, performanceClient: IPerformanceClient);
-    /**
-     * Creates default headers for requests to token endpoint
-     */
-    protected createTokenRequestHeaders(ccsCred?: CcsCredential): Record<string, string>;
-    /**
-     * Http post to token endpoint
-     * @param tokenEndpoint
-     * @param queryString
-     * @param headers
-     * @param thumbprint
-     */
-    protected executePostToTokenEndpoint(tokenEndpoint: string, queryString: string, headers: Record<string, string>, thumbprint: RequestThumbprint, correlationId: string): Promise<NetworkResponse<ServerAuthorizationTokenResponse>>;
-    /**
-     * Wraps sendPostRequestAsync with necessary preflight and postflight logic
-     * @param thumbprint - Request thumbprint for throttling
-     * @param tokenEndpoint - Endpoint to make the POST to
-     * @param options - Body and Headers to include on the POST request
-     * @param correlationId - CorrelationId for telemetry
-     */
-    sendPostRequest<T extends ServerAuthorizationTokenResponse>(thumbprint: RequestThumbprint, tokenEndpoint: string, options: NetworkRequestOptions, correlationId: string): Promise<NetworkResponse<T>>;
-    /**
-     * Updates the authority object of the client. Endpoint discovery must be completed.
-     * @param updatedAuthority
-     */
-    updateAuthority(cloudInstanceHostname: string, correlationId: string): Promise<void>;
-    /**
-     * Creates query string for the /token request
-     * @param request
-     */
-    createTokenQueryParameters(request: BaseAuthRequest): string;
-}
-//# sourceMappingURL=BaseClient.d.ts.map

package/lib/types/client/BaseClient.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"BaseClient.d.ts","sourceRoot":"","sources":["../../../src/client/BaseClient.ts"],"names":[],"mappings":"AAKA,OAAO,EACH,mBAAmB,EAEnB,yBAAyB,EAC5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACH,cAAc,EACd,qBAAqB,EACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,OAAO,EAAE,gCAAgC,EAAE,MAAM,iDAAiD,CAAC;AACnG,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAqB,MAAM,6BAA6B,CAAC;AAE/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AAGpF,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAYhE;;;GAGG;AACH,8BAAsB,UAAU;IAErB,MAAM,EAAE,MAAM,CAAC;IAGtB,SAAS,CAAC,MAAM,EAAE,yBAAyB,CAAC;IAG5C,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC;IAG/B,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC;IAGrC,SAAS,CAAC,aAAa,EAAE,cAAc,CAAC;IAGxC,SAAS,CAAC,sBAAsB,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAGzD,SAAS,EAAE,SAAS,CAAC;IAG5B,SAAS,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;IAEhD,SAAS,aACL,aAAa,EAAE,mBAAmB,EAClC,iBAAiB,EAAE,kBAAkB;IA2BzC;;OAEG;IACH,SAAS,CAAC,yBAAyB,CAC/B,OAAO,CAAC,EAAE,aAAa,GACxB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IA8BzB;;;;;;OAMG;cACa,0BAA0B,CACtC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,UAAU,EAAE,iBAAiB,EAC7B,aAAa,EAAE,MAAM,GACtB,OAAO,CAAC,eAAe,CAAC,gCAAgC,CAAC,CAAC;IAqB7D;;;;;;OAMG;IACG,eAAe,CAAC,CAAC,SAAS,gCAAgC,EAC5D,UAAU,EAAE,iBAAiB,EAC7B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,qBAAqB,EAC9B,aAAa,EAAE,MAAM,GACtB,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAwE9B;;;OAGG;IACG,eAAe,CACjB,qBAAqB,EAAE,MAAM,EAC7B,aAAa,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC;IAchB;;;OAGG;IACH,0BAA0B,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM;CA8B/D"}

package/src/client/BaseClient.ts

@@ -1,308 +0,0 @@
-/*
- * Copyright (c) Microsoft Corporation. All rights reserved.
- * Licensed under the MIT License.
- */
-
-import {
-    ClientConfiguration,
-    buildClientConfiguration,
-    CommonClientConfiguration,
-} from "../config/ClientConfiguration.js";
-import {
-    INetworkModule,
-    NetworkRequestOptions,
-} from "../network/INetworkModule.js";
-import { NetworkResponse } from "../network/NetworkResponse.js";
-import { ICrypto } from "../crypto/ICrypto.js";
-import { Authority } from "../authority/Authority.js";
-import { Logger } from "../logger/Logger.js";
-import { HeaderNames, URL_FORM_CONTENT_TYPE } from "../utils/Constants.js";
-import { ServerAuthorizationTokenResponse } from "../response/ServerAuthorizationTokenResponse.js";
-import { CacheManager } from "../cache/CacheManager.js";
-import { ServerTelemetryManager } from "../telemetry/server/ServerTelemetryManager.js";
-import { RequestThumbprint } from "../network/RequestThumbprint.js";
-import { version, name } from "../packageMetadata.js";
-import { CcsCredential, CcsCredentialType } from "../account/CcsCredential.js";
-import { buildClientInfoFromHomeAccountId } from "../account/ClientInfo.js";
-import { IPerformanceClient } from "../telemetry/performance/IPerformanceClient.js";
-import * as RequestParameterBuilder from "../request/RequestParameterBuilder.js";
-import * as UrlUtils from "../utils/UrlUtils.js";
-import { BaseAuthRequest } from "../request/BaseAuthRequest.js";
-import { createDiscoveredInstance } from "../authority/AuthorityFactory.js";
-import * as PerformanceEvents from "../telemetry/performance/PerformanceEvents.js";
-import { ThrottlingUtils } from "../network/ThrottlingUtils.js";
-import { AuthError } from "../error/AuthError.js";
-import {
-    ClientAuthErrorCodes,
-    createClientAuthError,
-} from "../error/ClientAuthError.js";
-import { NetworkError } from "../error/NetworkError.js";
-import { invokeAsync } from "../utils/FunctionWrappers.js";
-
-/**
- * Base application class which will construct requests to send to and handle responses from the Microsoft STS using the authorization code flow.
- * @internal
- */
-export abstract class BaseClient {
-    // Logger object
-    public logger: Logger;
-
-    // Application config
-    protected config: CommonClientConfiguration;
-
-    // Crypto Interface
-    protected cryptoUtils: ICrypto;
-
-    // Storage Interface
-    protected cacheManager: CacheManager;
-
-    // Network Interface
-    protected networkClient: INetworkModule;
-
-    // Server Telemetry Manager
-    protected serverTelemetryManager: ServerTelemetryManager | null;
-
-    // Default authority object
-    public authority: Authority;
-
-    // Performance telemetry client
-    protected performanceClient: IPerformanceClient;
-
-    protected constructor(
-        configuration: ClientConfiguration,
-        performanceClient: IPerformanceClient
-    ) {
-        // Set the configuration
-        this.config = buildClientConfiguration(configuration);
-
-        // Initialize the logger
-        this.logger = new Logger(this.config.loggerOptions, name, version);
-
-        // Initialize crypto
-        this.cryptoUtils = this.config.cryptoInterface;
-
-        // Initialize storage interface
-        this.cacheManager = this.config.storageInterface;
-
-        // Set the network interface
-        this.networkClient = this.config.networkInterface;
-
-        // Set TelemetryManager
-        this.serverTelemetryManager = this.config.serverTelemetryManager;
-
-        // set Authority
-        this.authority = this.config.authOptions.authority;
-
-        // set performance telemetry client
-        this.performanceClient = performanceClient;
-    }
-
-    /**
-     * Creates default headers for requests to token endpoint
-     */
-    protected createTokenRequestHeaders(
-        ccsCred?: CcsCredential
-    ): Record<string, string> {
-        const headers: Record<string, string> = {};
-        headers[HeaderNames.CONTENT_TYPE] = URL_FORM_CONTENT_TYPE;
-        if (!this.config.systemOptions.preventCorsPreflight && ccsCred) {
-            switch (ccsCred.type) {
-                case CcsCredentialType.HOME_ACCOUNT_ID:
-                    try {
-                        const clientInfo = buildClientInfoFromHomeAccountId(
-                            ccsCred.credential
-                        );
-                        headers[
-                            HeaderNames.CCS_HEADER
-                        ] = `Oid:${clientInfo.uid}@${clientInfo.utid}`;
-                    } catch (e) {
-                        this.logger.verbose(
-                            `Could not parse home account ID for CCS Header: '${e}'`,
-                            ""
-                        );
-                    }
-                    break;
-                case CcsCredentialType.UPN:
-                    headers[
-                        HeaderNames.CCS_HEADER
-                    ] = `UPN: ${ccsCred.credential}`;
-                    break;
-            }
-        }
-        return headers;
-    }
-
-    /**
-     * Http post to token endpoint
-     * @param tokenEndpoint
-     * @param queryString
-     * @param headers
-     * @param thumbprint
-     */
-    protected async executePostToTokenEndpoint(
-        tokenEndpoint: string,
-        queryString: string,
-        headers: Record<string, string>,
-        thumbprint: RequestThumbprint,
-        correlationId: string
-    ): Promise<NetworkResponse<ServerAuthorizationTokenResponse>> {
-        const response =
-            await this.sendPostRequest<ServerAuthorizationTokenResponse>(
-                thumbprint,
-                tokenEndpoint,
-                { body: queryString, headers: headers },
-                correlationId
-            );
-
-        if (
-            this.config.serverTelemetryManager &&
-            response.status < 500 &&
-            response.status !== 429
-        ) {
-            // Telemetry data successfully logged by server, clear Telemetry cache
-            this.config.serverTelemetryManager.clearTelemetryCache();
-        }
-
-        return response;
-    }
-
-    /**
-     * Wraps sendPostRequestAsync with necessary preflight and postflight logic
-     * @param thumbprint - Request thumbprint for throttling
-     * @param tokenEndpoint - Endpoint to make the POST to
-     * @param options - Body and Headers to include on the POST request
-     * @param correlationId - CorrelationId for telemetry
-     */
-    async sendPostRequest<T extends ServerAuthorizationTokenResponse>(
-        thumbprint: RequestThumbprint,
-        tokenEndpoint: string,
-        options: NetworkRequestOptions,
-        correlationId: string
-    ): Promise<NetworkResponse<T>> {
-        ThrottlingUtils.preProcess(
-            this.cacheManager,
-            thumbprint,
-            correlationId
-        );
-
-        let response;
-        try {
-            response = await invokeAsync(
-                this.networkClient.sendPostRequestAsync.bind(
-                    this.networkClient
-                )<T>,
-                PerformanceEvents.NetworkClientSendPostRequestAsync,
-                this.logger,
-                this.performanceClient,
-                correlationId
-            )(tokenEndpoint, options);
-            const responseHeaders = response.headers || {};
-            this.performanceClient?.addFields(
-                {
-                    refreshTokenSize: response.body.refresh_token?.length || 0,
-                    httpVerToken:
-                        responseHeaders[HeaderNames.X_MS_HTTP_VERSION] || "",
-                    requestId:
-                        responseHeaders[HeaderNames.X_MS_REQUEST_ID] || "",
-                },
-                correlationId
-            );
-        } catch (e) {
-            if (e instanceof NetworkError) {
-                const responseHeaders = e.responseHeaders;
-                if (responseHeaders) {
-                    this.performanceClient?.addFields(
-                        {
-                            httpVerToken:
-                                responseHeaders[
-                                    HeaderNames.X_MS_HTTP_VERSION
-                                ] || "",
-                            requestId:
-                                responseHeaders[HeaderNames.X_MS_REQUEST_ID] ||
-                                "",
-                            contentTypeHeader:
-                                responseHeaders[HeaderNames.CONTENT_TYPE] ||
-                                undefined,
-                            contentLengthHeader:
-                                responseHeaders[HeaderNames.CONTENT_LENGTH] ||
-                                undefined,
-                            httpStatus: e.httpStatus,
-                        },
-                        correlationId
-                    );
-                }
-                throw e.error;
-            }
-            if (e instanceof AuthError) {
-                throw e;
-            } else {
-                throw createClientAuthError(ClientAuthErrorCodes.networkError);
-            }
-        }
-
-        ThrottlingUtils.postProcess(
-            this.cacheManager,
-            thumbprint,
-            response,
-            correlationId
-        );
-
-        return response;
-    }
-
-    /**
-     * Updates the authority object of the client. Endpoint discovery must be completed.
-     * @param updatedAuthority
-     */
-    async updateAuthority(
-        cloudInstanceHostname: string,
-        correlationId: string
-    ): Promise<void> {
-        const cloudInstanceAuthorityUri = `https://${cloudInstanceHostname}/${this.authority.tenant}/`;
-        const cloudInstanceAuthority = await createDiscoveredInstance(
-            cloudInstanceAuthorityUri,
-            this.networkClient,
-            this.cacheManager,
-            this.authority.options,
-            this.logger,
-            correlationId,
-            this.performanceClient
-        );
-        this.authority = cloudInstanceAuthority;
-    }
-
-    /**
-     * Creates query string for the /token request
-     * @param request
-     */
-    createTokenQueryParameters(request: BaseAuthRequest): string {
-        const parameters = new Map<string, string>();
-
-        if (request.embeddedClientId) {
-            RequestParameterBuilder.addBrokerParameters(
-                parameters,
-                this.config.authOptions.clientId,
-                this.config.authOptions.redirectUri
-            );
-        }
-
-        if (request.tokenQueryParameters) {
-            RequestParameterBuilder.addExtraQueryParameters(
-                parameters,
-                request.tokenQueryParameters
-            );
-        }
-
-        RequestParameterBuilder.addCorrelationId(
-            parameters,
-            request.correlationId
-        );
-
-        RequestParameterBuilder.instrumentBrokerParams(
-            parameters,
-            request.correlationId,
-            this.performanceClient
-        );
-        return UrlUtils.mapToQueryString(parameters);
-    }
-}