@azure/msal-common 14.0.2 → 14.0.3

package/src/utils/StringUtils.ts

@@ -0,0 +1,106 @@
+/*
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+
+/**
+ * @hidden
+ */
+export class StringUtils {
+    /**
+     * Check if stringified object is empty
+     * @param strObj
+     */
+    static isEmptyObj(strObj?: string): boolean {
+        if (strObj) {
+            try {
+                const obj = JSON.parse(strObj);
+                return Object.keys(obj).length === 0;
+            } catch (e) {}
+        }
+        return true;
+    }
+
+    static startsWith(str: string, search: string): boolean {
+        return str.indexOf(search) === 0;
+    }
+
+    static endsWith(str: string, search: string): boolean {
+        return (
+            str.length >= search.length &&
+            str.lastIndexOf(search) === str.length - search.length
+        );
+    }
+
+    /**
+     * Parses string into an object.
+     *
+     * @param query
+     */
+    static queryStringToObject<T>(query: string): T {
+        const obj: {} = {};
+        const params = query.split("&");
+        const decode = (s: string) => decodeURIComponent(s.replace(/\+/g, " "));
+        params.forEach((pair) => {
+            if (pair.trim()) {
+                const [key, value] = pair.split(/=(.+)/g, 2); // Split on the first occurence of the '=' character
+                if (key && value) {
+                    obj[decode(key)] = decode(value);
+                }
+            }
+        });
+        return obj as T;
+    }
+
+    /**
+     * Trims entries in an array.
+     *
+     * @param arr
+     */
+    static trimArrayEntries(arr: Array<string>): Array<string> {
+        return arr.map((entry) => entry.trim());
+    }
+
+    /**
+     * Removes empty strings from array
+     * @param arr
+     */
+    static removeEmptyStringsFromArray(arr: Array<string>): Array<string> {
+        return arr.filter((entry) => {
+            return !!entry;
+        });
+    }
+
+    /**
+     * Attempts to parse a string into JSON
+     * @param str
+     */
+    static jsonParseHelper<T>(str: string): T | null {
+        try {
+            return JSON.parse(str) as T;
+        } catch (e) {
+            return null;
+        }
+    }
+
+    /**
+     * Tests if a given string matches a given pattern, with support for wildcards and queries.
+     * @param pattern Wildcard pattern to string match. Supports "*" for wildcards and "?" for queries
+     * @param input String to match against
+     */
+    static matchPattern(pattern: string, input: string): boolean {
+        /**
+         * Wildcard support: https://stackoverflow.com/a/3117248/4888559
+         * Queries: replaces "?" in string with escaped "\?" for regex test
+         */
+        // eslint-disable-next-line security/detect-non-literal-regexp
+        const regex: RegExp = new RegExp(
+            pattern
+                .replace(/\\/g, "\\\\")
+                .replace(/\*/g, "[^ ]*")
+                .replace(/\?/g, "\\?")
+        );
+
+        return regex.test(input);
+    }
+}

package/src/utils/TimeUtils.ts

@@ -0,0 +1,51 @@
+/*
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+
+/**
+ * Utility class which exposes functions for managing date and time operations.
+ */
+export class TimeUtils {
+    /**
+     * return the current time in Unix time (seconds).
+     */
+    static nowSeconds(): number {
+        // Date.getTime() returns in milliseconds.
+        return Math.round(new Date().getTime() / 1000.0);
+    }
+
+    /**
+     * check if a token is expired based on given UTC time in seconds.
+     * @param expiresOn
+     */
+    static isTokenExpired(expiresOn: string, offset: number): boolean {
+        // check for access token expiry
+        const expirationSec = Number(expiresOn) || 0;
+        const offsetCurrentTimeSec = TimeUtils.nowSeconds() + offset;
+
+        // If current time + offset is greater than token expiration time, then token is expired.
+        return offsetCurrentTimeSec > expirationSec;
+    }
+
+    /**
+     * If the current time is earlier than the time that a token was cached at, we must discard the token
+     * i.e. The system clock was turned back after acquiring the cached token
+     * @param cachedAt
+     * @param offset
+     */
+    static wasClockTurnedBack(cachedAt: string): boolean {
+        const cachedAtSec = Number(cachedAt);
+
+        return cachedAtSec > TimeUtils.nowSeconds();
+    }
+
+    /**
+     * Waits for t number of milliseconds
+     * @param t number
+     * @param value T
+     */
+    static delay<T>(t: number, value?: T): Promise<T | void> {
+        return new Promise((resolve) => setTimeout(() => resolve(value), t));
+    }
+}

package/dist/account/DecodedAuthToken.d.ts

@@ -1,9 +0,0 @@
-/**
- * Interface for Decoded JWT tokens.
- */
-export interface DecodedAuthToken {
-    header: string;
-    JWSPayload: string;
-    JWSSig: string;
-}
-//# sourceMappingURL=DecodedAuthToken.d.ts.map

package/dist/account/DecodedAuthToken.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"DecodedAuthToken.d.ts","sourceRoot":"","sources":["../../src/account/DecodedAuthToken.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAClB"}