@pratham.raval/browser-core 6.22.3

package/esm/tools/stackTrace/computeStackTrace.js

@@ -0,0 +1,183 @@
+/**
+ * Cross-browser stack trace computation.
+ *
+ * Reference implementation: https://github.com/csnover/TraceKit/blob/04530298073c3823de72deb0b97e7b38ca7bcb59/tracekit.js
+ */
+const UNKNOWN_FUNCTION = '?';
+export function computeStackTrace(ex) {
+    var _a, _b;
+    const stack = [];
+    let stackProperty = tryToGetString(ex, 'stack');
+    const exString = String(ex);
+    if (stackProperty && stackProperty.startsWith(exString)) {
+        stackProperty = stackProperty.slice(exString.length);
+    }
+    if (stackProperty) {
+        stackProperty.split('\n').forEach((line) => {
+            const stackFrame = parseChromeLine(line) || parseChromeAnonymousLine(line) || parseWinLine(line) || parseGeckoLine(line);
+            if (stackFrame) {
+                if (!stackFrame.func && stackFrame.line) {
+                    stackFrame.func = UNKNOWN_FUNCTION;
+                }
+                stack.push(stackFrame);
+            }
+        });
+    }
+    if (stack.length > 0 && isWronglyReportingCustomErrors() && ex instanceof Error) {
+        // if we are wrongly reporting custom errors
+        const constructors = [];
+        // go through each inherited constructor
+        let currentPrototype = ex;
+        while ((currentPrototype = Object.getPrototypeOf(currentPrototype)) &&
+            isNonNativeClassPrototype(currentPrototype)) {
+            const constructorName = ((_a = currentPrototype.constructor) === null || _a === void 0 ? void 0 : _a.name) || UNKNOWN_FUNCTION;
+            constructors.push(constructorName);
+        }
+        // traverse the stacktrace in reverse order because the stacktrace starts with the last inherited constructor
+        // we check constructor names to ensure we remove the correct frame (and there isn't a weird unsupported environment behavior)
+        for (let i = constructors.length - 1; i >= 0 && ((_b = stack[0]) === null || _b === void 0 ? void 0 : _b.func) === constructors[i]; i--) {
+            // if the first stack frame is the custom error constructor
+            // null stack frames may represent frames that failed to be parsed because the error class did not have a constructor
+            stack.shift(); // remove it
+        }
+    }
+    return {
+        message: tryToGetString(ex, 'message'),
+        name: tryToGetString(ex, 'name'),
+        stack,
+    };
+}
+const fileUrl = '((?:file|https?|blob|chrome-extension|electron|native|eval|webpack|snippet|<anonymous>|\\w+\\.|\\/).*?)';
+const filePosition = '(?::(\\d+))';
+const CHROME_LINE_RE = new RegExp(`^\\s*at (.*?) ?\\(${fileUrl}${filePosition}?${filePosition}?\\)?\\s*$`, 'i');
+const CHROME_EVAL_RE = new RegExp(`\\((\\S*)${filePosition}${filePosition}\\)`);
+function parseChromeLine(line) {
+    const parts = CHROME_LINE_RE.exec(line);
+    if (!parts) {
+        return;
+    }
+    const isNative = parts[2] && parts[2].indexOf('native') === 0; // start of line
+    const isEval = parts[2] && parts[2].indexOf('eval') === 0; // start of line
+    const submatch = CHROME_EVAL_RE.exec(parts[2]);
+    if (isEval && submatch) {
+        // throw out eval line/column and use top-most line/column number
+        parts[2] = submatch[1]; // url
+        parts[3] = submatch[2]; // line
+        parts[4] = submatch[3]; // column
+    }
+    return {
+        args: isNative ? [parts[2]] : [],
+        column: parts[4] ? +parts[4] : undefined,
+        func: parts[1] || UNKNOWN_FUNCTION,
+        line: parts[3] ? +parts[3] : undefined,
+        url: !isNative ? parts[2] : undefined,
+    };
+}
+const CHROME_ANONYMOUS_FUNCTION_RE = new RegExp(`^\\s*at ?${fileUrl}${filePosition}?${filePosition}??\\s*$`, 'i');
+function parseChromeAnonymousLine(line) {
+    const parts = CHROME_ANONYMOUS_FUNCTION_RE.exec(line);
+    if (!parts) {
+        return;
+    }
+    return {
+        args: [],
+        column: parts[3] ? +parts[3] : undefined,
+        func: UNKNOWN_FUNCTION,
+        line: parts[2] ? +parts[2] : undefined,
+        url: parts[1],
+    };
+}
+const WINJS_LINE_RE = /^\s*at (?:((?:\[object object\])?.+) )?\(?((?:file|ms-appx|https?|webpack|blob):.*?):(\d+)(?::(\d+))?\)?\s*$/i;
+function parseWinLine(line) {
+    const parts = WINJS_LINE_RE.exec(line);
+    if (!parts) {
+        return;
+    }
+    return {
+        args: [],
+        column: parts[4] ? +parts[4] : undefined,
+        func: parts[1] || UNKNOWN_FUNCTION,
+        line: +parts[3],
+        url: parts[2],
+    };
+}
+const GECKO_LINE_RE = /^\s*(.*?)(?:\((.*?)\))?(?:(?:(?:^|@)((?:file|https?|blob|chrome|webpack|resource|capacitor|\[native).*?|[^@]*bundle|\[wasm code\])(?::(\d+))?(?::(\d+))?)|@)\s*$/i;
+const GECKO_EVAL_RE = /(\S+) line (\d+)(?: > eval line \d+)* > eval/i;
+function parseGeckoLine(line) {
+    const parts = GECKO_LINE_RE.exec(line);
+    if (!parts) {
+        return;
+    }
+    const isEval = parts[3] && parts[3].indexOf(' > eval') > -1;
+    const submatch = GECKO_EVAL_RE.exec(parts[3]);
+    if (isEval && submatch) {
+        // throw out eval line/column and use top-most line number
+        parts[3] = submatch[1];
+        parts[4] = submatch[2];
+        parts[5] = undefined; // no column when eval
+    }
+    return {
+        args: parts[2] ? parts[2].split(',') : [],
+        column: parts[5] ? +parts[5] : undefined,
+        func: parts[1] || UNKNOWN_FUNCTION,
+        line: parts[4] ? +parts[4] : undefined,
+        url: parts[3],
+    };
+}
+function tryToGetString(candidate, property) {
+    if (typeof candidate !== 'object' || !candidate || !(property in candidate)) {
+        return undefined;
+    }
+    const value = candidate[property];
+    return typeof value === 'string' ? value : undefined;
+}
+export function computeStackTraceFromOnErrorMessage(messageObj, url, line, column) {
+    if (url === undefined) {
+        return;
+    }
+    const { name, message } = tryToParseMessage(messageObj);
+    return {
+        name,
+        message,
+        stack: [{ url, column, line }],
+    };
+}
+// https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error#Error_types
+const ERROR_TYPES_RE = /^(?:[Uu]ncaught (?:exception: )?)?(?:((?:Eval|Internal|Range|Reference|Syntax|Type|URI|)Error): )?([\s\S]*)$/;
+function tryToParseMessage(messageObj) {
+    let name;
+    let message;
+    if ({}.toString.call(messageObj) === '[object String]') {
+        ;
+        [, name, message] = ERROR_TYPES_RE.exec(messageObj);
+    }
+    return { name, message };
+}
+// Custom error stacktrace fix
+// Some browsers (safari/firefox) add the error constructor as a frame in the stacktrace
+// In order to normalize the stacktrace, we need to remove it
+function isNonNativeClassPrototype(prototype) {
+    return String(prototype.constructor).startsWith('class ');
+}
+let isWronglyReportingCustomErrorsCache;
+function isWronglyReportingCustomErrors() {
+    if (isWronglyReportingCustomErrorsCache !== undefined) {
+        return isWronglyReportingCustomErrorsCache;
+    }
+    /* eslint-disable no-restricted-syntax */
+    class DatadogTestCustomError extends Error {
+        constructor() {
+            super();
+            this.name = 'Error'; // set name to Error so that no browser would default to the constructor name
+        }
+    }
+    const [customError, nativeError] = [DatadogTestCustomError, Error].map((errConstructor) => new errConstructor()); // so that both errors should exactly have the same stacktrace
+    isWronglyReportingCustomErrorsCache =
+        // If customError is not a class, it means that this was built with ES5 as target, converting the class to a normal object.
+        // Thus, error constructors will be reported on all browsers, which is the expected behavior.
+        isNonNativeClassPrototype(Object.getPrototypeOf(customError)) &&
+            // If the browser is correctly reporting the stacktrace, the normal error stacktrace should be the same as the custom error stacktrace
+            nativeError.stack !== customError.stack;
+    return isWronglyReportingCustomErrorsCache;
+}
+//# sourceMappingURL=computeStackTrace.js.map

package/esm/tools/stackTrace/computeStackTrace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeStackTrace.js","sourceRoot":"","sources":["../../../src/tools/stackTrace/computeStackTrace.ts"],"names":[],"mappings":"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"}

package/esm/tools/stackTrace/handlingStack.d.ts

@@ -0,0 +1,10 @@
+import type { StackTrace } from './computeStackTrace';
+/**
+ * Creates a stacktrace without SDK internal frames.
+ * Constraints:
+ * - Has to be called at the utmost position of the call stack.
+ * - No monitored function should encapsulate it, that is why we need to use callMonitored inside it.
+ */
+export declare function createHandlingStack(type: 'console error' | 'action' | 'error' | 'instrumented method' | 'log' | 'react error'): string;
+export declare function toStackTraceString(stack: StackTrace): string;
+export declare function formatErrorMessage(stack: StackTrace): string;

package/esm/tools/stackTrace/handlingStack.js

@@ -0,0 +1,41 @@
+import { callMonitored } from '../monitor';
+import { computeStackTrace } from './computeStackTrace';
+/**
+ * Creates a stacktrace without SDK internal frames.
+ * Constraints:
+ * - Has to be called at the utmost position of the call stack.
+ * - No monitored function should encapsulate it, that is why we need to use callMonitored inside it.
+ */
+export function createHandlingStack(type) {
+    /**
+     * Skip the two internal frames:
+     * - SDK API (console.error, ...)
+     * - this function
+     * in order to keep only the user calls
+     */
+    const internalFramesToSkip = 2;
+    const error = new Error(type);
+    error.name = 'HandlingStack';
+    let formattedStack;
+    callMonitored(() => {
+        const stackTrace = computeStackTrace(error);
+        stackTrace.stack = stackTrace.stack.slice(internalFramesToSkip);
+        formattedStack = toStackTraceString(stackTrace);
+    });
+    return formattedStack;
+}
+export function toStackTraceString(stack) {
+    let result = formatErrorMessage(stack);
+    stack.stack.forEach((frame) => {
+        const func = frame.func === '?' ? '<anonymous>' : frame.func;
+        const args = frame.args && frame.args.length > 0 ? `(${frame.args.join(', ')})` : '';
+        const line = frame.line ? `:${frame.line}` : '';
+        const column = frame.line && frame.column ? `:${frame.column}` : '';
+        result += `\n  at ${func}${args} @ ${frame.url}${line}${column}`;
+    });
+    return result;
+}
+export function formatErrorMessage(stack) {
+    return `${stack.name || 'Error'}: ${stack.message}`;
+}
+//# sourceMappingURL=handlingStack.js.map

package/esm/tools/stackTrace/handlingStack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlingStack.js","sourceRoot":"","sources":["../../../src/tools/stackTrace/handlingStack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAEvD;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAA0F;IAE1F;;;;;OAKG;IACH,MAAM,oBAAoB,GAAG,CAAC,CAAA;IAC9B,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,CAAA;IAC7B,KAAK,CAAC,IAAI,GAAG,eAAe,CAAA;IAC5B,IAAI,cAAsB,CAAA;IAE1B,aAAa,CAAC,GAAG,EAAE;QACjB,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;QAC3C,UAAU,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAA;QAC/D,cAAc,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAA;IACjD,CAAC,CAAC,CAAA;IAEF,OAAO,cAAe,CAAA;AACxB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAiB;IAClD,IAAI,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAA;IACtC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAA;QAC5D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;QACpF,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAC/C,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QACnE,MAAM,IAAI,UAAU,IAAK,GAAG,IAAI,MAAM,KAAK,CAAC,GAAI,GAAG,IAAI,GAAG,MAAM,EAAE,CAAA;IACpE,CAAC,CAAC,CAAA;IACF,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAiB;IAClD,OAAO,GAAG,KAAK,CAAC,IAAI,IAAI,OAAO,KAAK,KAAK,CAAC,OAAQ,EAAE,CAAA;AACtD,CAAC"}

package/esm/tools/taskQueue.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Maximum amount of time allocated to running tasks when a timeout (`IDLE_CALLBACK_TIMEOUT`) is
+ * reached. We should not run tasks for too long as it will hurt performance, but we should still
+ * run some tasks to avoid postponing them forever.
+ *
+ * Rational: Running tasks for 30ms every second (IDLE_CALLBACK_TIMEOUT) should be acceptable.
+ */
+export declare const MAX_EXECUTION_TIME_ON_TIMEOUT = 30;
+export interface TaskQueue {
+    push(task: Task): void;
+    stop(): void;
+}
+type Task = () => void;
+export declare function createTaskQueue(): TaskQueue;
+export {};

package/esm/tools/taskQueue.js

@@ -0,0 +1,50 @@
+import { ONE_SECOND } from './utils/timeUtils';
+import { requestIdleCallback } from './requestIdleCallback';
+/**
+ * Maximum delay before starting to execute tasks in the queue. We don't want to wait too long
+ * before running tasks, as it might hurt reliability (ex: if the user navigates away, we might lose
+ * the opportunity to send some data). We also don't want to run tasks too often, as it might hurt
+ * performance.
+ */
+const IDLE_CALLBACK_TIMEOUT = ONE_SECOND;
+/**
+ * Maximum amount of time allocated to running tasks when a timeout (`IDLE_CALLBACK_TIMEOUT`) is
+ * reached. We should not run tasks for too long as it will hurt performance, but we should still
+ * run some tasks to avoid postponing them forever.
+ *
+ * Rational: Running tasks for 30ms every second (IDLE_CALLBACK_TIMEOUT) should be acceptable.
+ */
+export const MAX_EXECUTION_TIME_ON_TIMEOUT = 30;
+export function createTaskQueue() {
+    const pendingTasks = [];
+    function run(deadline) {
+        let executionTimeRemaining;
+        if (deadline.didTimeout) {
+            const start = performance.now();
+            executionTimeRemaining = () => MAX_EXECUTION_TIME_ON_TIMEOUT - (performance.now() - start);
+        }
+        else {
+            executionTimeRemaining = deadline.timeRemaining.bind(deadline);
+        }
+        while (executionTimeRemaining() > 0 && pendingTasks.length) {
+            pendingTasks.shift()();
+        }
+        if (pendingTasks.length) {
+            scheduleNextRun();
+        }
+    }
+    function scheduleNextRun() {
+        requestIdleCallback(run, { timeout: IDLE_CALLBACK_TIMEOUT });
+    }
+    return {
+        push(task) {
+            if (pendingTasks.push(task) === 1) {
+                scheduleNextRun();
+            }
+        },
+        stop() {
+            pendingTasks.length = 0;
+        },
+    };
+}
+//# sourceMappingURL=taskQueue.js.map

package/esm/tools/taskQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskQueue.js","sourceRoot":"","sources":["../../src/tools/taskQueue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAE3D;;;;;GAKG;AACH,MAAM,qBAAqB,GAAG,UAAU,CAAA;AAExC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,CAAA;AAS/C,MAAM,UAAU,eAAe;IAC7B,MAAM,YAAY,GAAW,EAAE,CAAA;IAE/B,SAAS,GAAG,CAAC,QAAsB;QACjC,IAAI,sBAAoC,CAAA;QACxC,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;YAC/B,sBAAsB,GAAG,GAAG,EAAE,CAAC,6BAA6B,GAAG,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAA;QAC5F,CAAC;aAAM,CAAC;YACN,sBAAsB,GAAG,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAChE,CAAC;QAED,OAAO,sBAAsB,EAAE,GAAG,CAAC,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC;YAC3D,YAAY,CAAC,KAAK,EAAG,EAAE,CAAA;QACzB,CAAC;QAED,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC;YACxB,eAAe,EAAE,CAAA;QACnB,CAAC;IACH,CAAC;IAED,SAAS,eAAe;QACtB,mBAAmB,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC,CAAA;IAC9D,CAAC;IAED,OAAO;QACL,IAAI,CAAC,IAAI;YACP,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAClC,eAAe,EAAE,CAAA;YACnB,CAAC;QACH,CAAC;QACD,IAAI;YACF,YAAY,CAAC,MAAM,GAAG,CAAC,CAAA;QACzB,CAAC;KACF,CAAA;AACH,CAAC"}

package/esm/tools/timer.d.ts

@@ -0,0 +1,5 @@
+export type TimeoutId = ReturnType<typeof globalThis.setTimeout>;
+export declare function setTimeout(callback: () => void, delay?: number): TimeoutId;
+export declare function clearTimeout(timeoutId: TimeoutId | undefined): void;
+export declare function setInterval(callback: () => void, delay?: number): TimeoutId;
+export declare function clearInterval(timeoutId: TimeoutId | undefined): void;

package/esm/tools/timer.js

@@ -0,0 +1,16 @@
+import { getZoneJsOriginalValue } from './getZoneJsOriginalValue';
+import { monitor } from './monitor';
+import { getGlobalObject } from './globalObject';
+export function setTimeout(callback, delay) {
+    return getZoneJsOriginalValue(getGlobalObject(), 'setTimeout')(monitor(callback), delay);
+}
+export function clearTimeout(timeoutId) {
+    getZoneJsOriginalValue(getGlobalObject(), 'clearTimeout')(timeoutId);
+}
+export function setInterval(callback, delay) {
+    return getZoneJsOriginalValue(getGlobalObject(), 'setInterval')(monitor(callback), delay);
+}
+export function clearInterval(timeoutId) {
+    getZoneJsOriginalValue(getGlobalObject(), 'clearInterval')(timeoutId);
+}
+//# sourceMappingURL=timer.js.map

package/esm/tools/timer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer.js","sourceRoot":"","sources":["../../src/tools/timer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAIhD,MAAM,UAAU,UAAU,CAAC,QAAoB,EAAE,KAAc;IAC7D,OAAO,sBAAsB,CAAC,eAAe,EAAE,EAAE,YAAY,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAA;AAC1F,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,SAAgC;IAC3D,sBAAsB,CAAC,eAAe,EAAE,EAAE,cAAc,CAAC,CAAC,SAAS,CAAC,CAAA;AACtE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,QAAoB,EAAE,KAAc;IAC9D,OAAO,sBAAsB,CAAC,eAAe,EAAE,EAAE,aAAa,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAA;AAC3F,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,SAAgC;IAC5D,sBAAsB,CAAC,eAAe,EAAE,EAAE,eAAe,CAAC,CAAC,SAAS,CAAC,CAAA;AACvE,CAAC"}

package/esm/tools/utils/arrayUtils.d.ts

@@ -0,0 +1,3 @@
+export declare function removeDuplicates<T>(array: T[]): T[];
+export declare function removeItem<T>(array: T[], item: T): void;
+export declare function isNonEmptyArray<T>(value: unknown): value is T[];

package/esm/tools/utils/arrayUtils.js

@@ -0,0 +1,15 @@
+export function removeDuplicates(array) {
+    const set = new Set();
+    array.forEach((item) => set.add(item));
+    return Array.from(set);
+}
+export function removeItem(array, item) {
+    const index = array.indexOf(item);
+    if (index >= 0) {
+        array.splice(index, 1);
+    }
+}
+export function isNonEmptyArray(value) {
+    return Array.isArray(value) && value.length > 0;
+}
+//# sourceMappingURL=arrayUtils.js.map

package/esm/tools/utils/arrayUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrayUtils.js","sourceRoot":"","sources":["../../../src/tools/utils/arrayUtils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,gBAAgB,CAAI,KAAU;IAC5C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAK,CAAA;IACxB,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;IACtC,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACxB,CAAC;AAED,MAAM,UAAU,UAAU,CAAI,KAAU,EAAE,IAAO;IAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACjC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;IACxB,CAAC;AACH,CAAC;AACD,MAAM,UAAU,eAAe,CAAI,KAAc;IAC/C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA;AACjD,CAAC"}

package/esm/tools/utils/browserDetection.d.ts

@@ -0,0 +1,8 @@
+export declare const enum Browser {
+    CHROMIUM = 0,
+    SAFARI = 1,
+    OTHER = 2
+}
+export declare function isChromium(): boolean;
+export declare function isSafari(): boolean;
+export declare function detectBrowser(browserWindow?: Window): Browser;

package/esm/tools/utils/browserDetection.js

@@ -0,0 +1,28 @@
+export function isChromium() {
+    return detectBrowserCached() === 0 /* Browser.CHROMIUM */;
+}
+export function isSafari() {
+    return detectBrowserCached() === 1 /* Browser.SAFARI */;
+}
+let browserCache;
+function detectBrowserCached() {
+    return browserCache !== null && browserCache !== void 0 ? browserCache : (browserCache = detectBrowser());
+}
+// Exported only for tests
+export function detectBrowser(browserWindow = window) {
+    var _a;
+    const userAgent = browserWindow.navigator.userAgent;
+    if (browserWindow.chrome || /HeadlessChrome/.test(userAgent)) {
+        return 0 /* Browser.CHROMIUM */;
+    }
+    if (
+    // navigator.vendor is deprecated, but it is the most resilient way we found to detect
+    // "Apple maintained browsers" (AKA Safari). If one day it gets removed, we still have the
+    // useragent test as a semi-working fallback.
+    ((_a = browserWindow.navigator.vendor) === null || _a === void 0 ? void 0 : _a.indexOf('Apple')) === 0 ||
+        (/safari/i.test(userAgent) && !/chrome|android/i.test(userAgent))) {
+        return 1 /* Browser.SAFARI */;
+    }
+    return 2 /* Browser.OTHER */;
+}
+//# sourceMappingURL=browserDetection.js.map

package/esm/tools/utils/browserDetection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserDetection.js","sourceRoot":"","sources":["../../../src/tools/utils/browserDetection.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,UAAU;IACxB,OAAO,mBAAmB,EAAE,6BAAqB,CAAA;AACnD,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO,mBAAmB,EAAE,2BAAmB,CAAA;AACjD,CAAC;AAED,IAAI,YAAiC,CAAA;AACrC,SAAS,mBAAmB;IAC1B,OAAO,YAAY,aAAZ,YAAY,cAAZ,YAAY,GAAI,CAAC,YAAY,GAAG,aAAa,EAAE,CAAC,CAAA;AACzD,CAAC;AAED,0BAA0B;AAC1B,MAAM,UAAU,aAAa,CAAC,gBAAwB,MAAM;;IAC1D,MAAM,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC,SAAS,CAAA;IACnD,IAAK,aAAqB,CAAC,MAAM,IAAI,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACtE,gCAAuB;IACzB,CAAC;IAED;IACE,sFAAsF;IACtF,0FAA0F;IAC1F,6CAA6C;IAC7C,CAAA,MAAA,aAAa,CAAC,SAAS,CAAC,MAAM,0CAAE,OAAO,CAAC,OAAO,CAAC,MAAK,CAAC;QACtD,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EACjE,CAAC;QACD,8BAAqB;IACvB,CAAC;IAED,6BAAoB;AACtB,CAAC"}

package/esm/tools/utils/byteUtils.d.ts

@@ -0,0 +1,8 @@
+export declare const ONE_KIBI_BYTE = 1024;
+export declare const ONE_MEBI_BYTE: number;
+export interface Uint8ArrayBuffer extends Uint8Array {
+    readonly buffer: ArrayBuffer;
+    subarray(begin?: number, end?: number): Uint8ArrayBuffer;
+}
+export declare function computeBytesCount(candidate: string): number;
+export declare function concatBuffers(buffers: Uint8ArrayBuffer[]): Uint8ArrayBuffer;

package/esm/tools/utils/byteUtils.js

@@ -0,0 +1,25 @@
+export const ONE_KIBI_BYTE = 1024;
+export const ONE_MEBI_BYTE = 1024 * ONE_KIBI_BYTE;
+// eslint-disable-next-line no-control-regex
+const HAS_MULTI_BYTES_CHARACTERS = /[^\u0000-\u007F]/;
+export function computeBytesCount(candidate) {
+    // Accurate bytes count computations can degrade performances when there is a lot of events to process
+    if (!HAS_MULTI_BYTES_CHARACTERS.test(candidate)) {
+        return candidate.length;
+    }
+    if (window.TextEncoder !== undefined) {
+        return new TextEncoder().encode(candidate).length;
+    }
+    return new Blob([candidate]).size;
+}
+export function concatBuffers(buffers) {
+    const length = buffers.reduce((total, buffer) => total + buffer.length, 0);
+    const result = new Uint8Array(length);
+    let offset = 0;
+    for (const buffer of buffers) {
+        result.set(buffer, offset);
+        offset += buffer.length;
+    }
+    return result;
+}
+//# sourceMappingURL=byteUtils.js.map

package/esm/tools/utils/byteUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"byteUtils.js","sourceRoot":"","sources":["../../../src/tools/utils/byteUtils.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAA;AACjC,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,GAAG,aAAa,CAAA;AAEjD,4CAA4C;AAC5C,MAAM,0BAA0B,GAAG,kBAAkB,CAAA;AAQrD,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,sGAAsG;IACtG,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAChD,OAAO,SAAS,CAAC,MAAM,CAAA;IACzB,CAAC;IAED,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAA;IACnD,CAAC;IAED,OAAO,IAAI,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAA;AACnC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAA2B;IACvD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IAC1E,MAAM,MAAM,GAAqB,IAAI,UAAU,CAAC,MAAM,CAAC,CAAA;IACvD,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC1B,MAAM,IAAI,MAAM,CAAC,MAAM,CAAA;IACzB,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/esm/tools/utils/functionUtils.d.ts

@@ -0,0 +1,8 @@
+export declare function throttle<T extends (...args: any[]) => void>(fn: T, wait: number, options?: {
+    leading?: boolean;
+    trailing?: boolean;
+}): {
+    throttled: (...parameters: Parameters<T>) => void;
+    cancel: () => void;
+};
+export declare function noop(): void;

package/esm/tools/utils/functionUtils.js

@@ -0,0 +1,39 @@
+import { setTimeout, clearTimeout } from '../timer';
+// use lodash API
+export function throttle(fn, wait, options) {
+    const needLeadingExecution = options && options.leading !== undefined ? options.leading : true;
+    const needTrailingExecution = options && options.trailing !== undefined ? options.trailing : true;
+    let inWaitPeriod = false;
+    let pendingExecutionWithParameters;
+    let pendingTimeoutId;
+    return {
+        throttled: (...parameters) => {
+            if (inWaitPeriod) {
+                pendingExecutionWithParameters = parameters;
+                return;
+            }
+            if (needLeadingExecution) {
+                fn(...parameters);
+            }
+            else {
+                pendingExecutionWithParameters = parameters;
+            }
+            inWaitPeriod = true;
+            pendingTimeoutId = setTimeout(() => {
+                if (needTrailingExecution && pendingExecutionWithParameters) {
+                    fn(...pendingExecutionWithParameters);
+                }
+                inWaitPeriod = false;
+                pendingExecutionWithParameters = undefined;
+            }, wait);
+        },
+        cancel: () => {
+            clearTimeout(pendingTimeoutId);
+            inWaitPeriod = false;
+            pendingExecutionWithParameters = undefined;
+        },
+    };
+}
+// eslint-disable-next-line @typescript-eslint/no-empty-function
+export function noop() { }
+//# sourceMappingURL=functionUtils.js.map

package/esm/tools/utils/functionUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"functionUtils.js","sourceRoot":"","sources":["../../../src/tools/utils/functionUtils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAEnD,iBAAiB;AACjB,MAAM,UAAU,QAAQ,CACtB,EAAK,EACL,IAAY,EACZ,OAAmD;IAEnD,MAAM,oBAAoB,GAAG,OAAO,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAA;IAC9F,MAAM,qBAAqB,GAAG,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAA;IACjG,IAAI,YAAY,GAAG,KAAK,CAAA;IACxB,IAAI,8BAAyD,CAAA;IAC7D,IAAI,gBAA2B,CAAA;IAE/B,OAAO;QACL,SAAS,EAAE,CAAC,GAAG,UAAyB,EAAE,EAAE;YAC1C,IAAI,YAAY,EAAE,CAAC;gBACjB,8BAA8B,GAAG,UAAU,CAAA;gBAC3C,OAAM;YACR,CAAC;YACD,IAAI,oBAAoB,EAAE,CAAC;gBACzB,EAAE,CAAC,GAAG,UAAU,CAAC,CAAA;YACnB,CAAC;iBAAM,CAAC;gBACN,8BAA8B,GAAG,UAAU,CAAA;YAC7C,CAAC;YACD,YAAY,GAAG,IAAI,CAAA;YACnB,gBAAgB,GAAG,UAAU,CAAC,GAAG,EAAE;gBACjC,IAAI,qBAAqB,IAAI,8BAA8B,EAAE,CAAC;oBAC5D,EAAE,CAAC,GAAG,8BAA8B,CAAC,CAAA;gBACvC,CAAC;gBACD,YAAY,GAAG,KAAK,CAAA;gBACpB,8BAA8B,GAAG,SAAS,CAAA;YAC5C,CAAC,EAAE,IAAI,CAAC,CAAA;QACV,CAAC;QACD,MAAM,EAAE,GAAG,EAAE;YACX,YAAY,CAAC,gBAAgB,CAAC,CAAA;YAC9B,YAAY,GAAG,KAAK,CAAA;YACpB,8BAA8B,GAAG,SAAS,CAAA;QAC5C,CAAC;KACF,CAAA;AACH,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,IAAI,KAAI,CAAC"}

package/esm/tools/utils/numberUtils.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Return true if the draw is successful
+ *
+ * @param threshold - Threshold between 0 and 100
+ */
+export declare function performDraw(threshold: number): boolean;
+export declare function round(num: number, decimals: 0 | 1 | 2 | 3 | 4): number;
+export declare function isPercentage(value: unknown): boolean;
+export declare function isNumber(value: unknown): value is number;

package/esm/tools/utils/numberUtils.js

@@ -0,0 +1,18 @@
+/**
+ * Return true if the draw is successful
+ *
+ * @param threshold - Threshold between 0 and 100
+ */
+export function performDraw(threshold) {
+    return threshold !== 0 && Math.random() * 100 <= threshold;
+}
+export function round(num, decimals) {
+    return +num.toFixed(decimals);
+}
+export function isPercentage(value) {
+    return isNumber(value) && value >= 0 && value <= 100;
+}
+export function isNumber(value) {
+    return typeof value === 'number';
+}
+//# sourceMappingURL=numberUtils.js.map

package/esm/tools/utils/numberUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"numberUtils.js","sourceRoot":"","sources":["../../../src/tools/utils/numberUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,SAAiB;IAC3C,OAAO,SAAS,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,SAAS,CAAA;AAC5D,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,GAAW,EAAE,QAA2B;IAC5D,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;AAC/B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,GAAG,CAAA;AACtD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAA;AAClC,CAAC"}

package/esm/tools/utils/objectUtils.d.ts

@@ -0,0 +1,10 @@
+export declare function shallowClone<T>(object: T): T & Record<string, never>;
+export declare function objectHasValue<T extends {
+    [key: string]: unknown;
+}>(object: T, value: unknown): value is T[keyof T];
+export declare function isEmptyObject(object: object): boolean;
+export declare function mapValues<A, B>(object: {
+    [key: string]: A;
+}, fn: (arg: A) => B): {
+    [key: string]: B;
+};

package/esm/tools/utils/objectUtils.js

@@ -0,0 +1,17 @@
+export function shallowClone(object) {
+    return { ...object };
+}
+export function objectHasValue(object, value) {
+    return Object.keys(object).some((key) => object[key] === value);
+}
+export function isEmptyObject(object) {
+    return Object.keys(object).length === 0;
+}
+export function mapValues(object, fn) {
+    const newObject = {};
+    for (const key of Object.keys(object)) {
+        newObject[key] = fn(object[key]);
+    }
+    return newObject;
+}
+//# sourceMappingURL=objectUtils.js.map

package/esm/tools/utils/objectUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectUtils.js","sourceRoot":"","sources":["../../../src/tools/utils/objectUtils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAAI,MAAS;IACvC,OAAO,EAAE,GAAG,MAAM,EAA+B,CAAA;AACnD,CAAC;AAED,MAAM,UAAU,cAAc,CAAuC,MAAS,EAAE,KAAc;IAC5F,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,CAAA;AACjE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,CAAA;AACzC,CAAC;AAED,MAAM,UAAU,SAAS,CAAO,MAA4B,EAAE,EAAiB;IAC7E,MAAM,SAAS,GAAyB,EAAE,CAAA;IAC1C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;IAClC,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC"}

package/esm/tools/utils/polyfills.d.ts

@@ -0,0 +1,7 @@
+export declare function findLast<T, S extends T>(array: readonly T[], predicate: (item: T, index: number, array: readonly T[]) => item is S): S | undefined;
+export declare function objectValues<T = unknown>(object: {
+    [key: string]: T;
+}): T[];
+export declare function objectEntries<T = unknown>(object: {
+    [key: string]: T;
+}): Array<[string, T]>;

package/esm/tools/utils/polyfills.js

@@ -0,0 +1,18 @@
+export function findLast(array, predicate) {
+    for (let i = array.length - 1; i >= 0; i -= 1) {
+        const item = array[i];
+        if (predicate(item, i, array)) {
+            return item;
+        }
+    }
+    return undefined;
+}
+// Keep the following wrapper functions as it can be mangled and will result in smaller bundle size that using
+// the native Object.values and Object.entries directly
+export function objectValues(object) {
+    return Object.values(object);
+}
+export function objectEntries(object) {
+    return Object.entries(object);
+}
+//# sourceMappingURL=polyfills.js.map

package/esm/tools/utils/polyfills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polyfills.js","sourceRoot":"","sources":["../../../src/tools/utils/polyfills.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ,CACtB,KAAmB,EACnB,SAAqE;IAErE,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;QACrB,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,8GAA8G;AAC9G,uDAAuD;AAEvD,MAAM,UAAU,YAAY,CAAc,MAA4B;IACpE,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;AAC9B,CAAC;AAED,MAAM,UAAU,aAAa,CAAc,MAA4B;IACrE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;AAC/B,CAAC"}

package/esm/tools/utils/responseUtils.d.ts

@@ -0,0 +1,2 @@
+export declare function isServerError(status: number): boolean;
+export declare function tryToClone(response: Response): Response | undefined;