@kwiz/common 1.0.1

package/src/helpers/url.ts

@@ -0,0 +1,202 @@
+import { IDictionary } from "./_dependencies";
+import { ArrayFill, lastOrNull } from "./collections.base";
+import { isNullOrEmptyString, isString } from "./typecheckers";
+import { URLHelper } from "./urlhelper";
+
+/**
+ * Get query string parameter by name
+ * @param name name of parameter
+ * @param url optional, url. if not sent - current window.location.href will be used
+ */
+export function getQueryStringParameter(param: string, url?: string, caseInSensitive?: boolean) {
+    let search = window.location.search;
+    if (!isNullOrEmptyString(url)) {
+        let tmp = url.split('#')[0].split('?');
+        search = tmp.length > 1 ? tmp[1] : '';
+    }
+
+    return getParameterValue(param, search, caseInSensitive);
+}
+/**
+ * Get url hash parameter by name
+ * @param name name of parameter
+ * @param url optional, url. if not sent - current window.location.href will be used
+ */
+export function getHashParameter(param: string, url?: string, caseInSensitive?: boolean) {
+    let hash = window.location.hash;
+    if (!isNullOrEmptyString(url)) {
+        let tmp = url.split('#');
+        hash = tmp.length > 1 ? tmp[1] : '';
+    }
+    return getParameterValue(param, hash, caseInSensitive);
+}
+
+/** return a value of a parameter from a key/value string like: key=value&key2=value2 */
+export function getParameterValue(param: string, keyValueString: string, caseInSensitive?: boolean) {
+    let _keyValueString = keyValueString.startsWith("#") || keyValueString.startsWith("?") ? keyValueString.substr(1) : keyValueString;
+    var parsed = _keyValueString.split('&');
+    for (var i = 0; i < parsed.length; i++) {
+        var values = parsed[i].split('=');
+
+        if (caseInSensitive ? values[0] === param : values[0].toLowerCase() === param.toLowerCase()) {
+            let v = (values.length > 1 ? values[1] : param);
+            return decodeURIComponent(v.replace(/\+/g, " "));
+        }
+
+        //ISSUE: 1301 - the query string parameter name was encoded in window.location.href/window.location.search even though in the 
+        //url bar the paramter name was not encoded
+        if (caseInSensitive ? decodeURIComponent(values[0]) === param : decodeURIComponent(values[0]).toLowerCase() === param.toLowerCase()) {
+            let v = (values.length > 1 ? values[1] : param);
+            return decodeURIComponent(v.replace(/\+/g, " "));
+        }
+    }
+    return "";
+}
+
+/**
+ * Make full url relative to current page location
+ * @param url
+ */
+export function makeFullUrl(url: string, baseUrl?: string): string {
+    if (isNullOrEmptyString(url)) url = baseUrl || window.location.href;
+
+    if (url.indexOf('://') > 0) return url;
+    else {
+        //might be server relative or folder relative url.
+
+        if (isNullOrEmptyString(baseUrl) || url.startsWith('/')) {
+            var xxx = document.createElement("a");
+            xxx.href = url;
+            return xxx.href;
+        }
+        else//folder relative URL, and we have a different baseURL to base it on
+        {
+            return makeFullUrl(makeServerRelativeUrl(url, baseUrl));
+        }
+    }
+}
+
+/** if the url is the same, only different hash parameter - reload the page. otherwise - navigate to the page */
+export function navigateOrReload(urlWithHash: string) {
+    if (makeServerRelativeUrl(urlWithHash).split('#')[0].toLowerCase() === makeServerRelativeUrl(window.location.href).split('#')[0].toLowerCase())
+        window.location.reload();//can't change hash - it won't refresh page
+    else
+        window.location.href = urlWithHash;
+}
+
+/** baseUrl is optional full or server relative URL to build folder relative urls from. */
+export function makeServerRelativeUrl(url: string, baseUrl?: string): string {
+    if (isNullOrEmptyString(url)) url = baseUrl || window.location.href.split('?')[0];
+
+    var index = url.indexOf("//");
+    if (index > 0)//this is a full URL, just trim it from // until the first / and return.
+    {
+        index = url.indexOf("/", index + 2);//find next / after the ://domain.name
+        if (index < 0) return "/";//not found - return "/" for the root.
+        else return url.slice(index);//found - return from that "/" onwards.
+    }
+    else if (url.startsWith('/'))//server relative url already
+        return url;
+    else//folder relative url
+    {
+        let baseRelativeUrl = makeServerRelativeUrl(baseUrl || window.location.href);
+        baseRelativeUrl = baseRelativeUrl.split('?')[0];
+        //if ends with file name - strip it
+        if (lastOrNull(baseRelativeUrl.split('/')).indexOf('.') >= 0)
+            baseRelativeUrl = baseRelativeUrl.substr(0, baseRelativeUrl.lastIndexOf('/'));
+        return normalizeUrl(baseRelativeUrl, true) + url;
+    }
+}
+
+/** Normalizes URL ending, end with or without slash */
+export function normalizeUrl(url: string, endWithSlash = false): string {
+    var tmp = url;
+    if (endWithSlash) {
+        if (isNullOrEmptyString(tmp))
+            tmp = "/";
+        else if (tmp.substr(-1) !== "/")
+            tmp += "/";
+    }
+    else {
+        if (!isNullOrEmptyString(tmp) && tmp.endsWith('/'))
+            tmp = tmp.slice(0, url.length - 1);
+    }
+    return tmp;
+}
+
+/** 
+ * Returns the extension for a specified url string. Requires the URL polyfill for IE. 
+ */
+export function getURLExtension(url: string) {//, baseUri?: string) {
+    if (!isString(url)) {
+        return "";
+    }
+    //if (!isString(baseUri)) {
+    //    baseUri = document.baseURI || window.location.protocol + "://" + window.location.hostname + window.location.pathname;
+    //}
+    var urlObj = new URL(url, "https://example.com");
+    url = urlObj.href.replace(urlObj.host, "").replace(urlObj.hash, "").replace(urlObj.search, "");
+    return url.substring(url.lastIndexOf("/") + 1).split(/#|\?/)[0].split(".").pop().trim();
+}
+
+export function isDataUrl(url: string) {
+    var REGEXP_DATA_URL = /^data:(?:.+?\/.+?)?(?:;.+?=.+?)*(?:;base64)?,.*$/;
+    return REGEXP_DATA_URL.test(url);
+}
+
+export function setUrlKeyValue(keyName: string, keyValue: string, bEncode: boolean, url?: string) {
+    if (!isString(url)) {
+        url = window.location.href + "";
+    }
+
+    var urlParams = new URLHelper(url);
+    return urlParams.setQueryStringParam(keyName, keyValue, bEncode);
+}
+
+export function removeUrlKeyValue(keyName: string, url?: string) {
+    if (!isString(url)) {
+        url = window.location.href + "";
+    }
+
+    var urlParams = new URLHelper(url);
+    return urlParams.removeQueryStringParam(keyName);
+}
+
+/**
+ * Returns encoded string from encodeURIComponent with single quote replaced with %27 or %27%27
+ */
+export function encodeURIComponentEX(str, options?: {
+    /** use this flag when making a REST requst, and encoding a parameter surrounded by 'param'
+     * for each level of '' your param is sorounded with
+     * example: filename('par'am') > send 2 to make it filename('par''am')
+     * example 2: sheet(' ''par'am'' ') > send 4 to make it sheet(' ''par''''am'' ')
+     */
+    singleQuoteMultiplier?: number;
+}) {
+    return encodeURIComponent(str).replace(/'/g, (s) => {
+        return options && options.singleQuoteMultiplier > 1
+            ? ArrayFill(new Array(options.singleQuoteMultiplier), "%27").join('')
+            : `%27`;
+    });
+}
+
+export function parseQueryString(url: string): IDictionary<string> {
+    if (isNullOrEmptyString(url) || url.indexOf('?') < 0) return {};
+    let strParams = url.split('?')[1].split('#')[0].split('&');
+    let params: IDictionary<string> = {};
+    strParams.forEach(p => {
+        let keyValue = p.split("=");
+        params[keyValue[0]] = decodeURIComponent(keyValue[1] || "");
+    });
+    return params;
+}
+export function parseHash(url: string): IDictionary<string> {
+    if (isNullOrEmptyString(url) || url.indexOf('#') < 0) return {};
+    let strParams = url.split('#')[1].split('&');
+    let params: IDictionary<string> = {};
+    strParams.forEach(p => {
+        let keyValue = p.split("=");
+        params[keyValue[0]] = decodeURIComponent(keyValue[1] || "");
+    });
+    return params;
+}

package/src/helpers/urlhelper.ts

@@ -0,0 +1,104 @@
+export class URLHelper {
+    private queryStringParams: { [key: string]: string; };
+    private hashParams: { [key: string]: string; };
+    private path: string;
+
+    public constructor(url: string) {
+        var parts = url.split("#");
+        var pathAndQueryString = parts[0];
+        var hash = parts[1];
+        var parts2 = pathAndQueryString.split("?");
+        var path = parts2[0];
+        var queryString = parts2[1];
+
+        this.path = path;
+        this.queryStringParams = this._parseParams(queryString);
+        this.hashParams = this._parseParams(hash);
+    }
+
+    public getQueryStringParam(keyName: string, bNoDecode?: boolean, bCaseInsensitive?: boolean) {
+        return this._getParam(this.queryStringParams, keyName, bNoDecode, bCaseInsensitive);
+    }
+
+    public setQueryStringParam(keyName: string, keyValue: string, bEncode: boolean) {
+        this.queryStringParams[keyName] = bEncode ? encodeURIComponent(keyValue) : keyValue;
+        return this.getUrl();
+    }
+
+    public removeQueryStringParam(keyName: string) {
+        this._removeParam(this.queryStringParams, keyName);
+        return this.getUrl();
+    }
+
+    public getHashParam(keyName: string, bNoDecode?: boolean, bCaseInsensitive?: boolean) {
+        return this._getParam(this.hashParams, keyName, bNoDecode, bCaseInsensitive);
+    }
+
+    public setHashParam(keyName: string, keyValue: string, bEncode: boolean) {
+        this.hashParams[keyName] = bEncode ? encodeURIComponent(keyValue) : keyValue;
+        return this.getUrl();
+    }
+
+    public removeHashParam(keyName: string) {
+        this._removeParam(this.hashParams, keyName);
+        return this.getUrl();
+    }
+
+    private _parseParams(paramsAsString: string) {
+        var paramsDict: { [key: string]: string; } = {};
+        try {
+            (typeof (paramsAsString) === "string" && paramsAsString.length ? paramsAsString.split("&") : []).forEach((s) => {
+                var q = s.split("=");
+                var paramKey = decodeURIComponent(q[0]);
+                var paramValue = q[1];
+                if (typeof (paramKey) === "string" && paramKey.length) {
+                    paramsDict[paramKey] = typeof (paramValue) === "string" && paramValue.length ? paramValue : null;
+                }
+            });
+        } catch (ex) {
+        }
+        return paramsDict;
+    }
+
+    private _removeParam(obj: { [key: string]: string; }, keyName: string) {
+        if (obj && obj[keyName]) {
+            try {
+                delete obj[keyName];
+            } catch (ex) {
+            }
+        }
+    }
+
+    private _getParam(obj: { [key: string]: string; }, keyName: string, bNoDecode?: boolean, bCaseInsensitive?: boolean) {
+        var value: string = null;
+        if (bCaseInsensitive) {
+            var matchedKey = Object.keys(obj).filter((key) => {
+                return key.toLowerCase() === keyName.toLowerCase();
+            })[0];
+
+            if (matchedKey) {
+                value = obj[matchedKey];
+            }
+        } else {
+            value = obj[keyName];
+        }
+        return typeof (value) === "string" ? (bNoDecode ? value : decodeURIComponent(value)) : null;
+    }
+
+    public getUrl() {
+        var queryString = Object.keys(this.queryStringParams).map((key) => {
+            var value = this.queryStringParams[key];
+            return `${key}` + (value !== null ? `=${value}` : "");
+        });
+        var hash = Object.keys(this.hashParams).map((key) => {
+            var value = this.hashParams[key];
+            return `${key}` + (value !== null ? `=${value}` : "");
+        });
+        var newUrl = [
+            typeof (this.path) === "string" && this.path.length ? this.path : "",
+            queryString && queryString.length ? `?${queryString.join("&")}` : "",
+            hash && hash.length ? `#${hash.join("&")}` : ""
+        ];
+        return newUrl.join("");
+    }
+}

package/src/index.ts

@@ -0,0 +1,24 @@
+import { ConsoleLogger } from './utils';
+export * from './helpers';
+export * from './types';
+export * from './utils';
+
+export var BuildNumber = "unset";
+export var IsLocalDev = false;
+export var ReleaseStatus = "npm";
+export function config(params: {
+    BuildNumber: string;
+    IsLocalDev: boolean;
+    ReleaseStatus: string;
+    ProjectName: string;
+}) {
+    BuildNumber = params.BuildNumber;
+    IsLocalDev = params.IsLocalDev;
+    ReleaseStatus = params.ReleaseStatus;
+    function GetLogger(name: string) {
+        return ConsoleLogger.get(name, "[cms]");
+    }
+    return {
+        logger: GetLogger
+    }
+}

package/src/types/common.types.ts

@@ -0,0 +1,16 @@
+//Drop common, non product specific, types
+
+export interface IDictionary<valueType> { [key: string]: valueType; }
+
+export type IdTextPair = { id: string; text: string; };
+export type KeyValuePair<T> = { key: string; value: T; };
+
+/** display info for enums or custom types for modern UI dropdowns */
+export interface ITypesDisplayInfo<ValueType> {
+    value: ValueType;
+    title: string;
+    description?: string;
+    fabricIconName?: string;
+}
+
+export type DateOrNull = Date | null;

package/src/types/flatted.types.ts

@@ -0,0 +1,60 @@
+/*! (c) 2020 Andrea Giammarchi */
+/**
+ * Fast and minimal circular JSON parser.
+ * logic example
+```js
+var a = [{one: 1}, {two: '2'}];
+a[0].a = a;
+// a is the main object, will be at index '0'
+// {one: 1} is the second object, index '1'
+// {two: '2'} the third, in '2', and it has a string
+// which will be found at index '3'
+Flatted.stringify(a);
+// [["1","2"],{"one":1,"a":"0"},{"two":"3"},"2"]
+// a[one,two]    {one: 1, a}    {two: '2'}  '2'
+```
+ */
+export interface IFlatted {
+    /**
+     * Converts a JavaScript Object Notation (using Flatted encoding) string into an object.
+     * @param text A valid Flatted string.
+     * @param reviver A function that transforms the results. This function is called for each member of the object.
+     * If a member contains nested objects, the nested objects are transformed before the parent object is.
+     */
+    parse(
+        text: string,
+        reviver?: (this: any, key: string, value: any) => any
+    ): any;
+    /**
+     * Converts a JavaScript value to a JavaScript Object Notation (using Flatted encoding) string.
+     * @param value A JavaScript value, usually an object or array, to be converted.
+     * @param replacer A function that transforms the results.
+     * @param space Adds indentation, white space, and line break characters to the return-value JSON text to make it easier to read.
+     */
+    stringify(
+        value: any,
+        replacer?: (this: any, key: string, value: any) => any,
+        space?: string | number
+    ): string;
+    /**
+     * Converts a JavaScript value to a JavaScript Object Notation (using Flatted encoding) string.
+     * @param value A JavaScript value, usually an object or array, to be converted.
+     * @param replacer An array of strings and numbers that acts as an approved list for selecting the object properties that will be stringified.
+     * @param space Adds indentation, white space, and line break characters to the return-value JSON text to make it easier to read.
+     */
+    stringify(
+        value: any,
+        replacer?: (number | string)[] | null,
+        space?: string | number
+    ): string;
+    /**
+     * Helper to allow explicit conversions with classes.
+     * @param value The JSON to convert to JavaScript value
+     */
+    fromJSON(value: any): any;
+    /**
+     * Helper to allow explicit conversions with classes.
+     * @param value A JavaScript value, usually an object or array, to be converted.
+     */
+    toJSON(value: any): any;
+}

package/src/types/globals.types.ts

@@ -0,0 +1,7 @@
+import { IDictionary } from "./common.types";
+
+declare global {
+    interface IKWizComGlobals {
+        globals?: IDictionary<any>;
+    }
+}

package/src/types/graph/calendar.types.ts

@@ -0,0 +1,81 @@
+export interface IGraphEventUser {
+    emailAddress: {
+        name: string;
+        address: string;
+    }
+}
+export interface IGraphEventAttendee extends IGraphEventUser {
+    type: "optional" | "required";
+    status: {
+        response: GraphEventResponse;
+        time: string;
+    };
+}
+export interface IGraphEventLocation {
+    displayName: string,//"Microsoft Teams Meeting",
+    locationType: "default",
+    uniqueId: string,//"Microsoft Teams Meeting",
+    uniqueIdType: "private" | "unknown"
+}
+
+export type GraphEventTimezone = "Eastern Standard Time" | "America/Toronto" | "UTC";
+export type GraphEventType = "occurrence" | "singleInstance";
+export type GraphEventResponse = "none" | "organizer" | "accepted";
+
+export interface IGraphCalendar {
+    id: string,
+    createdDateTime: string,
+    lastModifiedDateTime: string,
+    changeKey: string,
+    categories: string[],
+    transactionId: null,
+    originalStartTimeZone: GraphEventTimezone,
+    originalEndTimeZone: GraphEventTimezone,
+    iCalUId: string,
+    reminderMinutesBeforeStart: number,
+    isReminderOn: boolean,
+    hasAttachments: boolean,
+    subject: string,
+    bodyPreview: string,
+    importance: string,//"normal",
+    sensitivity: string,// "normal",
+    isAllDay: boolean,
+    isCancelled: boolean,
+    isOrganizer: boolean,
+    responseRequested: boolean,
+    seriesMasterId: string,//null,
+    showAs: string,//"busy",
+    type: GraphEventType,
+    webLink: string,
+    onlineMeetingUrl: string,//null,
+    isOnlineMeeting: boolean,
+    onlineMeetingProvider: "teamsForBusiness" | "unknown",
+    allowNewTimeProposals: boolean,
+    occurrenceId: string,//null,
+    isDraft: boolean,
+    hideAttendees: boolean,
+    responseStatus: {
+        response: GraphEventResponse,
+        time: string
+    },
+    body: {
+        contentType: "html",
+        content: string,//"<html><head><body>....</html>"
+    },
+    start: {
+        dateTime: string,
+        timeZone: GraphEventTimezone,
+    },
+    end: {
+        dateTime: string,
+        timeZone: GraphEventTimezone,
+    },
+    location: IGraphEventLocation,
+    locations: IGraphEventLocation[],
+    recurrence: null,
+    attendees: IGraphEventAttendee[],
+    organizer: IGraphEventUser,
+    onlineMeeting: {
+        joinUrl: string
+    }
+}

package/src/types/graph/index.ts

@@ -0,0 +1 @@
+export * from "./calendar.types";

package/src/types/index.ts

@@ -0,0 +1,12 @@
+export * from "./common.types";
+export * from './flatted.types';
+export * from "./globals.types";
+export * from "./graph";
+export * from "./knownscript.types";
+export * from "./libs";
+export * from "./localstoragecache.types";
+export * from "./regex.types";
+export * from "./rest.types";
+export * from "./sharepoint.types";
+export * from "./sharepoint.utils.types";
+

package/src/types/knownscript.types.ts

@@ -0,0 +1,19 @@
+export type ksGlobal = string | { name: string; getter: (() => any); };
+export interface IKnownScript {
+    /** cdn url for this script */
+    url: string;
+    /** specify any other libraries this script is depended on. These libraries will be loaded before this script if they were not loaded already. */
+    dependencies?: IKnownScript[];
+    /** specify global object name, if available. if this object exists - the script will not load, assuming it was already loaded
+     * Alternativly, provide a getter if it is more complex
+     */
+    global: ksGlobal;
+    /** specify sod script name. if provided, and the sod in this name was already loaded - this script will not be loaded again. */
+    sodName?: string;
+    /** If this library requires a CSS file, add it here */
+    css?: string[];
+    /** If this library requires an RTL CSS file, add it here */
+    rtlCss?: string[];
+    /** set to true, to make sure known script will not try to load the non min version on debug */
+    forceMin?: boolean;
+}

package/src/types/libs/datajs.types.ts

@@ -0,0 +1,29 @@
+export interface IDataJsRequestData {
+    __batchRequests: IDataJsBatchRequest[];
+}
+export interface IDataJsBatchRequest {
+    requestUri: string;
+    method: "GET" | "POST";
+    headers: { [key: string]: string; };
+}
+export interface IDataJsRequest {
+    requestUri: string;
+    method: "GET" | "POST";
+    headers: { [key: string]: string; };
+    data: IDataJsRequestData;
+}
+
+export interface IDataJsResponseData<ResponseDataType> {
+    __batchResponses: { data: ResponseDataType; }[];
+}
+
+export interface IDataJsHandler { }
+
+export interface IDataJs {
+    batchHandler: IDataJsHandler;
+    request<ResponseDataType>(request: IDataJsRequest, success: (data: IDataJsResponseData<ResponseDataType>, response: any) => void,
+        error: (error: string) => void,
+        handler: IDataJsHandler,
+        httpClient?: any,
+        metadata?: any): void;
+}

package/src/types/libs/ics.types.ts

@@ -0,0 +1,31 @@
+export type ICSFrequency = "DAILY" | "WEEKLY" | "MONTHLY" | "YEARLY";
+export type ICSDay = "SU" | "MO" | "TU" | "WE" | "TH" | "FR" | "SA";
+
+export type ICS = () => {
+    /** add an event to this ICS file. begin and end need to be formatted in a way that is friendly to Date() -- Issue 572 */
+    addEvent(subject: string, description: string | {
+        /** non-outlook standard */
+        text: string;
+        /** special support for outlook, html */
+        html: string;
+    }, location: string, begin: string, end: string, recurrence?: {
+        freq: ICSFrequency;
+        /** A date string representing the date on which to end repitition. Must be friendly to Date() */
+        until?: string;
+        /** Alternative to until. Repeat the event count times. Must be an integer */
+        count?: number;
+        /** The interval of freq to recur at. For example, if freq is WEEKLY and interval is 2, the event will repeat every 2 weeks. Must be an integer. */
+        interval?: number;
+        /** Which days of the week the event is to occur. An array containing any of SU, MO, TU, WE, TH, FR, SA. */
+        byday?: ICSDay;
+    }): void;
+    /** get the ICS file content of the events added so far */
+    calendar(): string;
+    download(filename: string, extention?: string): void;
+};
+
+declare global {
+    interface IKWizComGlobalsLibs {
+        ics?: ICS;
+    }
+}

package/src/types/libs/index.ts

@@ -0,0 +1,4 @@
+export * from "./datajs.types";
+export * from "./ics.types";
+export * from "./msal.types";
+

package/src/types/libs/msal.types.ts

@@ -0,0 +1,79 @@
+export interface IMSALBaseRequest { scopes: string[]; }
+export interface IMSALConfig { }
+export interface ITenantInfo {
+    environment: AzureEnvironment;
+    idOrName: string;
+    authorityUrl: string;
+    valid: boolean;
+}
+
+// eslint-disable-next-line no-shadow
+export enum AzureEnvironment {
+    /// <summary>
+    /// 
+    /// </summary>
+    Production = 0,
+    /// <summary>
+    /// 
+    /// </summary>
+    PPE = 1,
+    /// <summary>
+    /// 
+    /// </summary>
+    China = 2,
+    /// <summary>
+    /// 
+    /// </summary>
+    Germany = 3,
+    /// <summary>
+    /// 
+    /// </summary>
+    USGovernment = 4
+}
+
+export const MSALSampleLoginPopupScript = `<p id="msg">please wait...</p>
+<script>
+function finish() {
+    try {
+        var hash = window.location.hash;
+        if (hash[0] === "#") hash = hash.slice(1);//get rid of #
+        var hashDictionary = {};
+        hash.split("&").forEach(function (keyValue) {
+            if (keyValue !== "") {
+                var vals = keyValue.split("=");
+                hashDictionary[vals[0]] = decodeURIComponent(vals[1]);
+            }
+        });
+        if (Object.keys(hashDictionary).length < 1)
+            window.close();//we lose the hash!
+        else if (hashDictionary.error && hashDictionary.error_description)
+            document.getElementById("msg").innerHTML = hashDictionary.error_description.replace(/\\+/g," ").replace(/\\n/g,"<br /><br />");
+        else if (hashDictionary.state) {
+            var origin = hashDictionary.state.split("|")[1];
+            if (origin) {
+                window.location.href = origin.split("#")[0] + window.location.hash;
+            }
+        }
+    } catch (e) { }
+}
+finish();
+</script>`;
+
+export function GetTokenAudiencePrefix(appId: string) {
+    return `api://${appId}`;
+}
+export function GetDefaultScope(appId: string) {
+    return `${GetTokenAudiencePrefix(appId)}/access_as_user`;
+}
+
+export interface IMSAL {
+    AutoDiscoverTenantInfo: () => Promise<ITenantInfo>;
+    GetConfig: (clientId: string, authority: string, redirectUri: string) => Promise<IMSALConfig>;
+    GetTokenPopup: (config: IMSALConfig, requestOptions?: { scopes?: string[]; }) => Promise<string>;
+}
+
+declare global {
+    interface IKWizComGlobalsLibs {
+        msal?: IMSAL;
+    }
+}