@openobserve/browser-core 0.2.11 → 0.2.12-beta.1

package/esm/tools/serialisation/heavyCustomerDataWarning.js

@@ -1,14 +0,0 @@
-import { ONE_KIBI_BYTE } from '../utils/byteUtils';
-import { display } from '../display';
-// RUM and logs batch bytes limit is 16KB
-// ensure that we leave room for other event attributes and maintain a decent amount of event per batch
-// (3KB (customer data) + 1KB (other attributes)) * 4 (events per batch) = 16KB
-export var CUSTOMER_DATA_BYTES_LIMIT = 3 * ONE_KIBI_BYTE;
-export function warnIfCustomerDataLimitReached(bytesCount, customerDataType) {
-    if (bytesCount > CUSTOMER_DATA_BYTES_LIMIT) {
-        display.warn("The ".concat(customerDataType, " data exceeds the recommended ").concat(CUSTOMER_DATA_BYTES_LIMIT / ONE_KIBI_BYTE, "KiB threshold. More details: https://docs.datadoghq.com/real_user_monitoring/browser/troubleshooting/#customer-data-exceeds-the-recommended-3kib-warning"));
-        return true;
-    }
-    return false;
-}
-//# sourceMappingURL=heavyCustomerDataWarning.js.map

package/esm/tools/serialisation/heavyCustomerDataWarning.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"heavyCustomerDataWarning.js","sourceRoot":"","sources":["../../../src/tools/serialisation/heavyCustomerDataWarning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEpC,yCAAyC;AACzC,uGAAuG;AACvG,+EAA+E;AAC/E,MAAM,CAAC,IAAM,yBAAyB,GAAG,CAAC,GAAG,aAAa,CAAA;AAS1D,MAAM,UAAU,8BAA8B,CAAC,UAAkB,EAAE,gBAAkC;IACnG,IAAI,UAAU,GAAG,yBAAyB,EAAE;QAC1C,OAAO,CAAC,IAAI,CACV,cAAO,gBAAgB,2CACrB,yBAAyB,GAAG,aAAa,6JAC+G,CAC3J,CAAA;QACD,OAAO,IAAI,CAAA;KACZ;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/esm/tools/serialisation/jsonStringify.d.ts

@@ -1,14 +0,0 @@
-import { noop } from '../utils/functionUtils';
-/**
- * Custom implementation of JSON.stringify that ignores some toJSON methods. We need to do that
- * because some sites badly override toJSON on certain objects. Removing all toJSON methods from
- * nested values would be too costly, so we just detach them from the root value, and native classes
- * used to build JSON values (Array and Object).
- *
- * Note: this still assumes that JSON.stringify is correct.
- */
-export declare function jsonStringify(value: unknown, replacer?: Array<string | number>, space?: string | number): string | undefined;
-export interface ObjectWithToJsonMethod {
-    toJSON?: () => unknown;
-}
-export declare function detachToJsonMethod(value: object): typeof noop;

package/esm/tools/serialisation/jsonStringify.js

@@ -1,44 +0,0 @@
-import { noop } from '../utils/functionUtils';
-/**
- * Custom implementation of JSON.stringify that ignores some toJSON methods. We need to do that
- * because some sites badly override toJSON on certain objects. Removing all toJSON methods from
- * nested values would be too costly, so we just detach them from the root value, and native classes
- * used to build JSON values (Array and Object).
- *
- * Note: this still assumes that JSON.stringify is correct.
- */
-export function jsonStringify(value, replacer, space) {
-    if (typeof value !== 'object' || value === null) {
-        return JSON.stringify(value);
-    }
-    // Note: The order matter here. We need to detach toJSON methods on parent classes before their
-    // subclasses.
-    var restoreObjectPrototypeToJson = detachToJsonMethod(Object.prototype);
-    var restoreArrayPrototypeToJson = detachToJsonMethod(Array.prototype);
-    var restoreValuePrototypeToJson = detachToJsonMethod(Object.getPrototypeOf(value));
-    var restoreValueToJson = detachToJsonMethod(value);
-    try {
-        return JSON.stringify(value, replacer, space);
-    }
-    catch (_a) {
-        return '<error: unable to serialize object>';
-    }
-    finally {
-        restoreObjectPrototypeToJson();
-        restoreArrayPrototypeToJson();
-        restoreValuePrototypeToJson();
-        restoreValueToJson();
-    }
-}
-export function detachToJsonMethod(value) {
-    var object = value;
-    var objectToJson = object.toJSON;
-    if (objectToJson) {
-        delete object.toJSON;
-        return function () {
-            object.toJSON = objectToJson;
-        };
-    }
-    return noop;
-}
-//# sourceMappingURL=jsonStringify.js.map

package/esm/tools/serialisation/jsonStringify.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"jsonStringify.js","sourceRoot":"","sources":["../../../src/tools/serialisation/jsonStringify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAA;AAE7C;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAc,EACd,QAAiC,EACjC,KAAuB;IAEvB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE;QAC/C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;KAC7B;IAED,+FAA+F;IAC/F,cAAc;IACd,IAAM,4BAA4B,GAAG,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IACzE,IAAM,2BAA2B,GAAG,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IACvE,IAAM,2BAA2B,GAAG,kBAAkB,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAA;IACpF,IAAM,kBAAkB,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAA;IAEpD,IAAI;QACF,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAA;KAC9C;IAAC,WAAM;QACN,OAAO,qCAAqC,CAAA;KAC7C;YAAS;QACR,4BAA4B,EAAE,CAAA;QAC9B,2BAA2B,EAAE,CAAA;QAC7B,2BAA2B,EAAE,CAAA;QAC7B,kBAAkB,EAAE,CAAA;KACrB;AACH,CAAC;AAMD,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,IAAM,MAAM,GAAG,KAA+B,CAAA;IAC9C,IAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAA;IAClC,IAAI,YAAY,EAAE;QAChB,OAAO,MAAM,CAAC,MAAM,CAAA;QACpB,OAAO;YACL,MAAM,CAAC,MAAM,GAAG,YAAY,CAAA;QAC9B,CAAC,CAAA;KACF;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/esm/tools/serialisation/sanitize.d.ts

@@ -1,18 +0,0 @@
-import type { Context, ContextValue } from './context';
-/**
- * Ensures user-provided data is 'safe' for the SDK
- * - Deep clones data
- * - Removes cyclic references
- * - Transforms unserializable types to a string representation
- *
- * LIMITATIONS:
- * - Size is in characters, not byte count (may differ according to character encoding)
- * - Size does not take into account indentation that can be applied to JSON.stringify
- * - Non-numerical properties of Arrays are ignored. Same behavior as JSON.stringify
- *
- * @param source              User-provided data meant to be serialized using JSON.stringify
- * @param maxCharacterCount   Maximum number of characters allowed in serialized form
- */
-export declare function sanitize(source: string, maxCharacterCount?: number): string | undefined;
-export declare function sanitize(source: Context, maxCharacterCount?: number): Context;
-export declare function sanitize(source: unknown, maxCharacterCount?: number): ContextValue;

package/esm/tools/serialisation/sanitize.js

@@ -1,181 +0,0 @@
-import { display } from '../display';
-import { ONE_KIBI_BYTE } from '../utils/byteUtils';
-import { detachToJsonMethod } from './jsonStringify';
-// The maximum size of a single event is 256KiB. By default, we ensure that user-provided data
-// going through sanitize fits inside our events, while leaving room for other contexts, metadata, ...
-var SANITIZE_DEFAULT_MAX_CHARACTER_COUNT = 220 * ONE_KIBI_BYTE;
-// Symbol for the root element of the JSONPath used for visited objects
-var JSON_PATH_ROOT_ELEMENT = '$';
-// When serializing (using JSON.stringify) a key of an object, { key: 42 } gets wrapped in quotes as "key".
-// With the separator (:), we need to add 3 characters to the count.
-var KEY_DECORATION_LENGTH = 3;
-export function sanitize(source, maxCharacterCount) {
-    var _a;
-    if (maxCharacterCount === void 0) { maxCharacterCount = SANITIZE_DEFAULT_MAX_CHARACTER_COUNT; }
-    // Unbind any toJSON function we may have on [] or {} prototypes
-    var restoreObjectPrototypeToJson = detachToJsonMethod(Object.prototype);
-    var restoreArrayPrototypeToJson = detachToJsonMethod(Array.prototype);
-    // Initial call to sanitizeProcessor - will populate containerQueue if source is an Array or a plain Object
-    var containerQueue = [];
-    var visitedObjectsWithPath = new WeakMap();
-    var sanitizedData = sanitizeProcessor(source, JSON_PATH_ROOT_ELEMENT, undefined, containerQueue, visitedObjectsWithPath);
-    var accumulatedCharacterCount = ((_a = JSON.stringify(sanitizedData)) === null || _a === void 0 ? void 0 : _a.length) || 0;
-    if (accumulatedCharacterCount > maxCharacterCount) {
-        warnOverCharacterLimit(maxCharacterCount, 'discarded', source);
-        return undefined;
-    }
-    while (containerQueue.length > 0 && accumulatedCharacterCount < maxCharacterCount) {
-        var containerToProcess = containerQueue.shift();
-        var separatorLength = 0; // 0 for the first element, 1 for subsequent elements
-        // Arrays and Objects have to be handled distinctly to ensure
-        // we do not pick up non-numerical properties from Arrays
-        if (Array.isArray(containerToProcess.source)) {
-            for (var key = 0; key < containerToProcess.source.length; key++) {
-                var targetData = sanitizeProcessor(containerToProcess.source[key], containerToProcess.path, key, containerQueue, visitedObjectsWithPath);
-                if (targetData !== undefined) {
-                    accumulatedCharacterCount += JSON.stringify(targetData).length;
-                }
-                else {
-                    // When an element of an Array (targetData) is undefined, it is serialized as null:
-                    // JSON.stringify([undefined]) => '[null]' - This accounts for 4 characters
-                    accumulatedCharacterCount += 4;
-                }
-                accumulatedCharacterCount += separatorLength;
-                separatorLength = 1;
-                if (accumulatedCharacterCount > maxCharacterCount) {
-                    warnOverCharacterLimit(maxCharacterCount, 'truncated', source);
-                    break;
-                }
-                ;
-                containerToProcess.target[key] = targetData;
-            }
-        }
-        else {
-            for (var key in containerToProcess.source) {
-                if (Object.prototype.hasOwnProperty.call(containerToProcess.source, key)) {
-                    var targetData = sanitizeProcessor(containerToProcess.source[key], containerToProcess.path, key, containerQueue, visitedObjectsWithPath);
-                    // When a property of an object has an undefined value, it will be dropped during serialization:
-                    // JSON.stringify({a:undefined}) => '{}'
-                    if (targetData !== undefined) {
-                        accumulatedCharacterCount +=
-                            JSON.stringify(targetData).length + separatorLength + key.length + KEY_DECORATION_LENGTH;
-                        separatorLength = 1;
-                    }
-                    if (accumulatedCharacterCount > maxCharacterCount) {
-                        warnOverCharacterLimit(maxCharacterCount, 'truncated', source);
-                        break;
-                    }
-                    ;
-                    containerToProcess.target[key] = targetData;
-                }
-            }
-        }
-    }
-    // Rebind detached toJSON functions
-    restoreObjectPrototypeToJson();
-    restoreArrayPrototypeToJson();
-    return sanitizedData;
-}
-/**
- * Internal function to factorize the process common to the
- * initial call to sanitize, and iterations for Arrays and Objects
- *
- */
-function sanitizeProcessor(source, parentPath, key, queue, visitedObjectsWithPath) {
-    // Start by handling toJSON, as we want to sanitize its output
-    var sourceToSanitize = tryToApplyToJSON(source);
-    if (!sourceToSanitize || typeof sourceToSanitize !== 'object') {
-        return sanitizePrimitivesAndFunctions(sourceToSanitize);
-    }
-    var sanitizedSource = sanitizeObjects(sourceToSanitize);
-    if (sanitizedSource !== '[Object]' && sanitizedSource !== '[Array]' && sanitizedSource !== '[Error]') {
-        return sanitizedSource;
-    }
-    // Handle potential cyclic references
-    // We need to use source as sourceToSanitize could be a reference to a new object
-    // At this stage, we know the source is an object type
-    var sourceAsObject = source;
-    if (visitedObjectsWithPath.has(sourceAsObject)) {
-        return "[Reference seen at ".concat(visitedObjectsWithPath.get(sourceAsObject), "]");
-    }
-    // Add processed source to queue
-    var currentPath = key !== undefined ? "".concat(parentPath, ".").concat(key) : parentPath;
-    var target = Array.isArray(sourceToSanitize) ? [] : {};
-    visitedObjectsWithPath.set(sourceAsObject, currentPath);
-    queue.push({ source: sourceToSanitize, target: target, path: currentPath });
-    return target;
-}
-/**
- * Handles sanitization of simple, non-object types
- *
- */
-function sanitizePrimitivesAndFunctions(value) {
-    // BigInt cannot be serialized by JSON.stringify(), convert it to a string representation
-    if (typeof value === 'bigint') {
-        return "[BigInt] ".concat(value.toString());
-    }
-    // Functions cannot be serialized by JSON.stringify(). Moreover, if a faulty toJSON is present, it needs to be converted
-    // so it won't prevent stringify from serializing later
-    if (typeof value === 'function') {
-        return "[Function] ".concat(value.name || 'unknown');
-    }
-    // JSON.stringify() does not serialize symbols.
-    if (typeof value === 'symbol') {
-        return "[Symbol] ".concat(value.description || value.toString());
-    }
-    return value;
-}
-/**
- * Handles sanitization of object types
- *
- * LIMITATIONS
- * - If a class defines a toStringTag Symbol, it will fall in the catch-all method and prevent enumeration of properties.
- * To avoid this, a toJSON method can be defined.
- * - IE11 does not return a distinct type for objects such as Map, WeakMap, ... These objects will pass through and their
- * properties enumerated if any.
- *
- */
-function sanitizeObjects(value) {
-    try {
-        // Handle events - Keep a simple implementation to avoid breaking changes
-        if (value instanceof Event) {
-            return {
-                isTrusted: value.isTrusted,
-            };
-        }
-        // Handle all remaining object types in a generic way
-        var result = Object.prototype.toString.call(value);
-        var match = result.match(/\[object (.*)\]/);
-        if (match && match[1]) {
-            return "[".concat(match[1], "]");
-        }
-    }
-    catch (_a) {
-        // If the previous serialization attempts failed, and we cannot convert using
-        // Object.prototype.toString, declare the value unserializable
-    }
-    return '[Unserializable]';
-}
-/**
- * Checks if a toJSON function exists and tries to execute it
- *
- */
-function tryToApplyToJSON(value) {
-    var object = value;
-    if (object && typeof object.toJSON === 'function') {
-        try {
-            return object.toJSON();
-        }
-        catch (_a) {
-            // If toJSON fails, we continue by trying to serialize the value manually
-        }
-    }
-    return value;
-}
-/**
- * Helper function to display the warning when the accumulated character count is over the limit
- */
-function warnOverCharacterLimit(maxCharacterCount, changeType, source) {
-    display.warn("The data provided has been ".concat(changeType, " as it is over the limit of ").concat(maxCharacterCount, " characters:"), source);
-}
-//# sourceMappingURL=sanitize.js.map

package/esm/tools/serialisation/sanitize.js.map

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

package/esm/tools/timer.d.ts

@@ -1,5 +0,0 @@
-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

@@ -1,16 +0,0 @@
-import { getZoneJsOriginalValue } from './getZoneJsOriginalValue';
-import { monitor } from './monitor';
-import { getGlobalObject } from './getGlobalObject';
-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

@@ -1 +0,0 @@
-{"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,mBAAmB,CAAA;AAInD,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

@@ -1 +0,0 @@
-export declare function removeDuplicates<T>(array: T[]): T[];

package/esm/tools/utils/arrayUtils.js

@@ -1,7 +0,0 @@
-import { arrayFrom } from './polyfills';
-export function removeDuplicates(array) {
-    var set = new Set();
-    array.forEach(function (item) { return set.add(item); });
-    return arrayFrom(set);
-}
-//# sourceMappingURL=arrayUtils.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"arrayUtils.js","sourceRoot":"","sources":["../../../src/tools/utils/arrayUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,MAAM,UAAU,gBAAgB,CAAI,KAAU;IAC5C,IAAM,GAAG,GAAG,IAAI,GAAG,EAAK,CAAA;IACxB,KAAK,CAAC,OAAO,CAAC,UAAC,IAAI,IAAK,OAAA,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAb,CAAa,CAAC,CAAA;IACtC,OAAO,SAAS,CAAC,GAAG,CAAC,CAAA;AACvB,CAAC"}

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

@@ -1,2 +0,0 @@
-export declare function isIE(): boolean;
-export declare function isChromium(): boolean;

package/esm/tools/utils/browserDetection.js

@@ -1,7 +0,0 @@
-export function isIE() {
-    return Boolean(document.documentMode);
-}
-export function isChromium() {
-    return !!window.chrome || /HeadlessChrome/.test(window.navigator.userAgent);
-}
-//# sourceMappingURL=browserDetection.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"browserDetection.js","sourceRoot":"","sources":["../../../src/tools/utils/browserDetection.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,IAAI;IAClB,OAAO,OAAO,CAAE,QAAgB,CAAC,YAAY,CAAC,CAAA;AAChD,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,CAAC,CAAE,MAAc,CAAC,MAAM,IAAI,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;AACtF,CAAC"}

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

@@ -1,4 +0,0 @@
-export declare const ONE_KIBI_BYTE = 1024;
-export declare const ONE_MEBI_BYTE: number;
-export declare function computeBytesCount(candidate: string): number;
-export declare function concatBuffers(buffers: Uint8Array[]): Uint8Array;

package/esm/tools/utils/byteUtils.js

@@ -1,26 +0,0 @@
-export var ONE_KIBI_BYTE = 1024;
-export var ONE_MEBI_BYTE = 1024 * ONE_KIBI_BYTE;
-// eslint-disable-next-line no-control-regex
-var 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) {
-    var length = buffers.reduce(function (total, buffer) { return total + buffer.length; }, 0);
-    var result = new Uint8Array(length);
-    var offset = 0;
-    for (var _i = 0, buffers_1 = buffers; _i < buffers_1.length; _i++) {
-        var buffer = buffers_1[_i];
-        result.set(buffer, offset);
-        offset += buffer.length;
-    }
-    return result;
-}
-//# sourceMappingURL=byteUtils.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"byteUtils.js","sourceRoot":"","sources":["../../../src/tools/utils/byteUtils.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,IAAM,aAAa,GAAG,IAAI,CAAA;AACjC,MAAM,CAAC,IAAM,aAAa,GAAG,IAAI,GAAG,aAAa,CAAA;AAEjD,4CAA4C;AAC5C,IAAM,0BAA0B,GAAG,kBAAkB,CAAA;AAErD,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,sGAAsG;IACtG,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE;QAC/C,OAAO,SAAS,CAAC,MAAM,CAAA;KACxB;IAED,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE;QACpC,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAA;KAClD;IAED,OAAO,IAAI,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAA;AACnC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAqB;IACjD,IAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,UAAC,KAAK,EAAE,MAAM,IAAK,OAAA,KAAK,GAAG,MAAM,CAAC,MAAM,EAArB,CAAqB,EAAE,CAAC,CAAC,CAAA;IAC1E,IAAM,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAA;IACrC,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,KAAqB,UAAO,EAAP,mBAAO,EAAP,qBAAO,EAAP,IAAO,EAAE;QAAzB,IAAM,MAAM,gBAAA;QACf,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC1B,MAAM,IAAI,MAAM,CAAC,MAAM,CAAA;KACxB;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}

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

@@ -1,9 +0,0 @@
-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;
-export type ListenerHandler = () => void;

package/esm/tools/utils/functionUtils.js

@@ -1,43 +0,0 @@
-import { setTimeout, clearTimeout } from '../timer';
-// use lodash API
-export function throttle(fn, wait, options) {
-    var needLeadingExecution = options && options.leading !== undefined ? options.leading : true;
-    var needTrailingExecution = options && options.trailing !== undefined ? options.trailing : true;
-    var inWaitPeriod = false;
-    var pendingExecutionWithParameters;
-    var pendingTimeoutId;
-    return {
-        throttled: function () {
-            var parameters = [];
-            for (var _i = 0; _i < arguments.length; _i++) {
-                parameters[_i] = arguments[_i];
-            }
-            if (inWaitPeriod) {
-                pendingExecutionWithParameters = parameters;
-                return;
-            }
-            if (needLeadingExecution) {
-                fn.apply(void 0, parameters);
-            }
-            else {
-                pendingExecutionWithParameters = parameters;
-            }
-            inWaitPeriod = true;
-            pendingTimeoutId = setTimeout(function () {
-                if (needTrailingExecution && pendingExecutionWithParameters) {
-                    fn.apply(void 0, pendingExecutionWithParameters);
-                }
-                inWaitPeriod = false;
-                pendingExecutionWithParameters = undefined;
-            }, wait);
-        },
-        cancel: function () {
-            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

@@ -1 +0,0 @@
-{"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,IAAM,oBAAoB,GAAG,OAAO,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAA;IAC9F,IAAM,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;YAAC,oBAA4B;iBAA5B,UAA4B,EAA5B,qBAA4B,EAA5B,IAA4B;gBAA5B,+BAA4B;;YACtC,IAAI,YAAY,EAAE;gBAChB,8BAA8B,GAAG,UAAU,CAAA;gBAC3C,OAAM;aACP;YACD,IAAI,oBAAoB,EAAE;gBACxB,EAAE,eAAI,UAAU,EAAC;aAClB;iBAAM;gBACL,8BAA8B,GAAG,UAAU,CAAA;aAC5C;YACD,YAAY,GAAG,IAAI,CAAA;YACnB,gBAAgB,GAAG,UAAU,CAAC;gBAC5B,IAAI,qBAAqB,IAAI,8BAA8B,EAAE;oBAC3D,EAAE,eAAI,8BAA8B,EAAC;iBACtC;gBACD,YAAY,GAAG,KAAK,CAAA;gBACpB,8BAA8B,GAAG,SAAS,CAAA;YAC5C,CAAC,EAAE,IAAI,CAAC,CAAA;QACV,CAAC;QACD,MAAM,EAAE;YACN,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

@@ -1,8 +0,0 @@
-/**
- * Return true if the draw is successful
- * @param 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

@@ -1,17 +0,0 @@
-/**
- * Return true if the draw is successful
- * @param 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

@@ -1 +0,0 @@
-{"version":3,"file":"numberUtils.js","sourceRoot":"","sources":["../../../src/tools/utils/numberUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;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

@@ -1,10 +0,0 @@
-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

@@ -1,19 +0,0 @@
-import { assign } from './polyfills';
-export function shallowClone(object) {
-    return assign({}, object);
-}
-export function objectHasValue(object, value) {
-    return Object.keys(object).some(function (key) { return object[key] === value; });
-}
-export function isEmptyObject(object) {
-    return Object.keys(object).length === 0;
-}
-export function mapValues(object, fn) {
-    var newObject = {};
-    for (var _i = 0, _a = Object.keys(object); _i < _a.length; _i++) {
-        var key = _a[_i];
-        newObject[key] = fn(object[key]);
-    }
-    return newObject;
-}
-//# sourceMappingURL=objectUtils.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"objectUtils.js","sourceRoot":"","sources":["../../../src/tools/utils/objectUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,MAAM,UAAU,YAAY,CAAI,MAAS;IACvC,OAAO,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;AAC3B,CAAC;AAED,MAAM,UAAU,cAAc,CAAuC,MAAS,EAAE,KAAc;IAC5F,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAC,GAAG,IAAK,OAAA,MAAM,CAAC,GAAG,CAAC,KAAK,KAAK,EAArB,CAAqB,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,IAAM,SAAS,GAAyB,EAAE,CAAA;IAC1C,KAAkB,UAAmB,EAAnB,KAAA,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAnB,cAAmB,EAAnB,IAAmB,EAAE;QAAlC,IAAM,GAAG,SAAA;QACZ,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;KACjC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC"}

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

@@ -1,24 +0,0 @@
-export declare function includes(candidate: string, search: string): boolean;
-export declare function includes<T>(candidate: T[], search: T): boolean;
-export declare function arrayFrom<T>(arrayLike: ArrayLike<T> | Set<T>): T[];
-export declare function find<T, S extends T>(array: ArrayLike<T>, predicate: (item: T, index: number) => item is S): S | undefined;
-export declare function find<T>(array: ArrayLike<T>, predicate: (item: T, index: number) => boolean): T | undefined;
-export declare function findLast<T, S extends T>(array: T[], predicate: (item: T, index: number, array: T[]) => item is S): S | undefined;
-export declare function forEach<List extends {
-    [index: number]: any;
-}>(list: List, callback: (value: List[number], index: number, parent: List) => void): void;
-export declare function objectValues<T = unknown>(object: {
-    [key: string]: T;
-}): T[];
-export declare function objectEntries<T = unknown>(object: {
-    [key: string]: T;
-}): Array<[string, T]>;
-export declare function startsWith(candidate: string, search: string): boolean;
-export declare function endsWith(candidate: string, search: string): boolean;
-export declare function elementMatches(element: Element & {
-    msMatchesSelector?(selector: string): boolean;
-}, selector: string): boolean;
-export declare function cssEscape(str: string): string;
-export declare function assign<T, U>(target: T, source: U): T & U;
-export declare function assign<T, U, V>(target: T, source1: U, source2: V): T & U & V;
-export declare function assign<T, U, V, W>(target: T, source1: U, source2: V, source3: W): T & U & V & W;