@vpmedia/simplify 1.74.0 → 1.75.0

package/dist/logging/SentryLogHandler.js

@@ -0,0 +1,36 @@
+import { addBreadcrumb, captureException, captureMessage } from '@sentry/browser';
+import { AbstractLogHandler } from './AbstractLogHandler.js';
+import { LOG_LEVEL_DEBUG, LOG_LEVEL_WARNING } from './const.js';
+import { getLogLevelName } from './util.js';
+export class SentryLogHandler extends AbstractLogHandler {
+    /**
+     * Sentry log handler.
+     */
+    constructor(level = LOG_LEVEL_DEBUG) {
+        super(level);
+    }
+    /**
+     * Emit log record.
+     */
+    emit(logger, _timestamp, level, message, extra, error) {
+        const levelName = getLogLevelName(level);
+        const logMessage = `[${logger.name}] ${message}`;
+        const breadcrumb = {
+            type: 'default',
+            category: 'console',
+            message: logMessage,
+            level: levelName,
+            data: extra ?? undefined,
+        };
+        addBreadcrumb(breadcrumb);
+        if (error) {
+            extra?.tags ? captureException(error, { tags: extra.tags }) : captureException(error);
+        }
+        else if (level === LOG_LEVEL_WARNING) {
+            extra?.tags
+                ? captureMessage(logMessage, { level: 'warning', tags: extra.tags })
+                : captureMessage(logMessage, { level: 'warning' });
+        }
+    }
+}
+//# sourceMappingURL=SentryLogHandler.js.map

package/dist/logging/SentryLogHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SentryLogHandler.js","sourceRoot":"","sources":["../../src/logging/SentryLogHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,EAAsB,MAAM,iBAAiB,CAAC;AACtG,OAAO,EAAE,kBAAkB,EAAiB,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEhE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,OAAO,gBAAiB,SAAQ,kBAAkB;IACtD;;OAEG;IACH,YAAY,QAAgB,eAAe;QACzC,KAAK,CAAC,KAAK,CAAC,CAAC;IACf,CAAC;IAED;;OAEG;IACM,IAAI,CACX,MAAc,EACd,UAAkB,EAClB,KAAa,EACb,OAAe,EACf,KAAkC,EAClC,KAA+B;QAE/B,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAkB,CAAC;QAC1D,MAAM,UAAU,GAAG,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QACjD,MAAM,UAAU,GAAG;YACjB,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,SAAS;YACnB,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,KAAK,IAAI,SAAS;SACzB,CAAC;QACF,aAAa,CAAC,UAAU,CAAC,CAAC;QAC1B,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACxF,CAAC;aAAM,IAAI,KAAK,KAAK,iBAAiB,EAAE,CAAC;YACvC,KAAK,EAAE,IAAI;gBACT,CAAC,CAAC,cAAc,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;gBACpE,CAAC,CAAC,cAAc,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;CACF"}

package/dist/logging/const.d.ts

@@ -0,0 +1,14 @@
+export declare const LOG_LEVEL_SILENT = 0;
+export declare const LOG_LEVEL_FATAL = 1;
+export declare const LOG_LEVEL_ERROR = 2;
+export declare const LOG_LEVEL_WARNING = 3;
+export declare const LOG_LEVEL_INFO = 4;
+export declare const LOG_LEVEL_DEBUG = 5;
+export declare const LOG_LEVEL_NAME_SILENT = "silent";
+export declare const LOG_LEVEL_NAME_FATAL = "fatal";
+export declare const LOG_LEVEL_NAME_ERROR = "error";
+export declare const LOG_LEVEL_NAME_WARNING = "warning";
+export declare const LOG_LEVEL_NAME_INFO = "info";
+export declare const LOG_LEVEL_NAME_DEBUG = "debug";
+export declare const LOG_LEVEL_NAMES: readonly string[];
+//# sourceMappingURL=const.d.ts.map

package/dist/logging/const.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"const.d.ts","sourceRoot":"","sources":["../../src/logging/const.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC,eAAO,MAAM,qBAAqB,WAAW,CAAC;AAC9C,eAAO,MAAM,oBAAoB,UAAU,CAAC;AAC5C,eAAO,MAAM,oBAAoB,UAAU,CAAC;AAC5C,eAAO,MAAM,sBAAsB,YAAY,CAAC;AAChD,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAC1C,eAAO,MAAM,oBAAoB,UAAU,CAAC;AAE5C,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAO5C,CAAC"}

package/dist/logging/const.js

@@ -0,0 +1,21 @@
+export const LOG_LEVEL_SILENT = 0;
+export const LOG_LEVEL_FATAL = 1;
+export const LOG_LEVEL_ERROR = 2;
+export const LOG_LEVEL_WARNING = 3;
+export const LOG_LEVEL_INFO = 4;
+export const LOG_LEVEL_DEBUG = 5;
+export const LOG_LEVEL_NAME_SILENT = 'silent';
+export const LOG_LEVEL_NAME_FATAL = 'fatal';
+export const LOG_LEVEL_NAME_ERROR = 'error';
+export const LOG_LEVEL_NAME_WARNING = 'warning';
+export const LOG_LEVEL_NAME_INFO = 'info';
+export const LOG_LEVEL_NAME_DEBUG = 'debug';
+export const LOG_LEVEL_NAMES = [
+    LOG_LEVEL_NAME_SILENT,
+    LOG_LEVEL_NAME_FATAL,
+    LOG_LEVEL_NAME_ERROR,
+    LOG_LEVEL_NAME_WARNING,
+    LOG_LEVEL_NAME_INFO,
+    LOG_LEVEL_NAME_DEBUG,
+];
+//# sourceMappingURL=const.js.map

package/dist/logging/const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"const.js","sourceRoot":"","sources":["../../src/logging/const.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAClC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AACjC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AACjC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AACnC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAChC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AAEjC,MAAM,CAAC,MAAM,qBAAqB,GAAG,QAAQ,CAAC;AAC9C,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC;AAC5C,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC;AAC5C,MAAM,CAAC,MAAM,sBAAsB,GAAG,SAAS,CAAC;AAChD,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAC1C,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC;AAE5C,MAAM,CAAC,MAAM,eAAe,GAAsB;IAChD,qBAAqB;IACrB,oBAAoB;IACpB,oBAAoB;IACpB,sBAAsB;IACtB,mBAAmB;IACnB,oBAAoB;CACrB,CAAC"}

package/dist/logging/util.d.ts

@@ -0,0 +1,14 @@
+import type { Logger } from './Logger.js';
+/**
+ * Format log message.
+ */
+export declare const formatLogMessage: (logger: Logger, timestamp: number, _level: number, message: string) => string;
+/**
+ * Get log level name.
+ */
+export declare const getLogLevelName: (level: number) => string | undefined;
+/**
+ * Returns the application environment identifier.
+ */
+export declare const getAppEnvironment: () => string;
+//# sourceMappingURL=util.d.ts.map

package/dist/logging/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/logging/util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,QAAQ,MAAM,EAAE,WAAW,MAAM,EAAE,QAAQ,MAAM,EAAE,SAAS,MAAM,KAAG,MAC1D,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,KAAG,MAAM,GAAG,SAAmC,CAAC;AAE7F;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAO,MAkBpC,CAAC"}

package/dist/logging/util.js

@@ -0,0 +1,34 @@
+import { LOG_LEVEL_NAMES } from './const.js';
+/**
+ * Format log message.
+ */
+export const formatLogMessage = (logger, timestamp, _level, message) => `${timestamp} [${logger.name}] ${message}`;
+/**
+ * Get log level name.
+ */
+export const getLogLevelName = (level) => LOG_LEVEL_NAMES[level];
+/**
+ * Returns the application environment identifier.
+ */
+export const getAppEnvironment = () => {
+    let appEnvironment = 'local';
+    try {
+        const { env } = import.meta;
+        if (env?.['VITE_APP_ENVIRONMENT']) {
+            appEnvironment = env['VITE_APP_ENVIRONMENT'];
+        }
+    }
+    catch {
+        // pass
+    }
+    try {
+        if (process.env['APP_ENVIRONMENT']) {
+            appEnvironment = process.env['APP_ENVIRONMENT'];
+        }
+    }
+    catch {
+        // pass
+    }
+    return appEnvironment;
+};
+//# sourceMappingURL=util.js.map

package/dist/logging/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/logging/util.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAc,EAAE,SAAiB,EAAE,MAAc,EAAE,OAAe,EAAU,EAAE,CAC7G,GAAG,SAAS,KAAK,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;AAE7C;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAa,EAAsB,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;AAE7F;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAW,EAAE;IAC5C,IAAI,cAAc,GAAG,OAAO,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,IAA+D,CAAC;QACvF,IAAI,GAAG,EAAE,CAAC,sBAAsB,CAAC,EAAE,CAAC;YAClC,cAAc,GAAG,GAAG,CAAC,sBAAsB,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IACD,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACnC,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC,CAAC"}

package/dist/pagelifecycle/const.d.ts

@@ -0,0 +1,15 @@
+export declare const PAGE_LIFECYCLE_STATE_HIDDEN = "hidden";
+export declare const PAGE_LIFECYCLE_STATE_ACTIVE = "active";
+export declare const PAGE_LIFECYCLE_STATE_PASSIVE = "passive";
+export declare const PAGE_LIFECYCLE_STATE_FROZEN = "frozen";
+export declare const PAGE_LIFECYCLE_STATE_TERMINATED = "terminated";
+export declare const PAGE_LIFECYCLE_STATES: ReadonlySet<string>;
+export declare const DOCUMENT_STATE_DOM_LOADED = "domLoaded";
+export declare const DOCUMENT_STATE_FULLY_LOADED = "fullyLoaded";
+export declare const DOCUMENT_STATE_COMPLETE = "complete";
+export declare const DOCUMENT_STATE_INTERACTIVE = "interactive";
+export declare const DOCUMENT_STATE_LOADING = "loading";
+export declare const DOCUMENT_STATES: ReadonlySet<string>;
+export declare const PAGE_LIFECYCLE_STATE_CHANGE_EVENT = "pageLifecycleStateChange";
+export declare const DOCUMENT_STATE_CHANGE_EVENT = "documentStateChange";
+//# sourceMappingURL=const.d.ts.map

package/dist/pagelifecycle/const.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"const.d.ts","sourceRoot":"","sources":["../../src/pagelifecycle/const.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,WAAW,CAAC;AACpD,eAAO,MAAM,2BAA2B,WAAW,CAAC;AACpD,eAAO,MAAM,4BAA4B,YAAY,CAAC;AACtD,eAAO,MAAM,2BAA2B,WAAW,CAAC;AACpD,eAAO,MAAM,+BAA+B,eAAe,CAAC;AAE5D,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAMpD,CAAC;AAEH,eAAO,MAAM,yBAAyB,cAAc,CAAC;AACrD,eAAO,MAAM,2BAA2B,gBAAgB,CAAC;AACzD,eAAO,MAAM,uBAAuB,aAAa,CAAC;AAClD,eAAO,MAAM,0BAA0B,gBAAgB,CAAC;AACxD,eAAO,MAAM,sBAAsB,YAAY,CAAC;AAEhD,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,MAAM,CAM9C,CAAC;AAEH,eAAO,MAAM,iCAAiC,6BAA6B,CAAC;AAC5E,eAAO,MAAM,2BAA2B,wBAAwB,CAAC"}

package/dist/pagelifecycle/const.js

@@ -0,0 +1,27 @@
+export const PAGE_LIFECYCLE_STATE_HIDDEN = 'hidden';
+export const PAGE_LIFECYCLE_STATE_ACTIVE = 'active';
+export const PAGE_LIFECYCLE_STATE_PASSIVE = 'passive';
+export const PAGE_LIFECYCLE_STATE_FROZEN = 'frozen';
+export const PAGE_LIFECYCLE_STATE_TERMINATED = 'terminated';
+export const PAGE_LIFECYCLE_STATES = new Set([
+    PAGE_LIFECYCLE_STATE_ACTIVE,
+    PAGE_LIFECYCLE_STATE_FROZEN,
+    PAGE_LIFECYCLE_STATE_HIDDEN,
+    PAGE_LIFECYCLE_STATE_PASSIVE,
+    PAGE_LIFECYCLE_STATE_TERMINATED,
+]);
+export const DOCUMENT_STATE_DOM_LOADED = 'domLoaded';
+export const DOCUMENT_STATE_FULLY_LOADED = 'fullyLoaded';
+export const DOCUMENT_STATE_COMPLETE = 'complete';
+export const DOCUMENT_STATE_INTERACTIVE = 'interactive';
+export const DOCUMENT_STATE_LOADING = 'loading';
+export const DOCUMENT_STATES = new Set([
+    DOCUMENT_STATE_COMPLETE,
+    DOCUMENT_STATE_DOM_LOADED,
+    DOCUMENT_STATE_FULLY_LOADED,
+    DOCUMENT_STATE_INTERACTIVE,
+    DOCUMENT_STATE_LOADING,
+]);
+export const PAGE_LIFECYCLE_STATE_CHANGE_EVENT = 'pageLifecycleStateChange';
+export const DOCUMENT_STATE_CHANGE_EVENT = 'documentStateChange';
+//# sourceMappingURL=const.js.map

package/dist/pagelifecycle/const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"const.js","sourceRoot":"","sources":["../../src/pagelifecycle/const.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG,QAAQ,CAAC;AACpD,MAAM,CAAC,MAAM,2BAA2B,GAAG,QAAQ,CAAC;AACpD,MAAM,CAAC,MAAM,4BAA4B,GAAG,SAAS,CAAC;AACtD,MAAM,CAAC,MAAM,2BAA2B,GAAG,QAAQ,CAAC;AACpD,MAAM,CAAC,MAAM,+BAA+B,GAAG,YAAY,CAAC;AAE5D,MAAM,CAAC,MAAM,qBAAqB,GAAwB,IAAI,GAAG,CAAC;IAChE,2BAA2B;IAC3B,2BAA2B;IAC3B,2BAA2B;IAC3B,4BAA4B;IAC5B,+BAA+B;CAChC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,WAAW,CAAC;AACrD,MAAM,CAAC,MAAM,2BAA2B,GAAG,aAAa,CAAC;AACzD,MAAM,CAAC,MAAM,uBAAuB,GAAG,UAAU,CAAC;AAClD,MAAM,CAAC,MAAM,0BAA0B,GAAG,aAAa,CAAC;AACxD,MAAM,CAAC,MAAM,sBAAsB,GAAG,SAAS,CAAC;AAEhD,MAAM,CAAC,MAAM,eAAe,GAAwB,IAAI,GAAG,CAAC;IAC1D,uBAAuB;IACvB,yBAAyB;IACzB,2BAA2B;IAC3B,0BAA0B;IAC1B,sBAAsB;CACvB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iCAAiC,GAAG,0BAA0B,CAAC;AAC5E,MAAM,CAAC,MAAM,2BAA2B,GAAG,qBAAqB,CAAC"}

package/dist/pagelifecycle/typedef.d.ts

@@ -0,0 +1,4 @@
+export declare const TYPEDEF = true;
+export type PageLifecycleState = 'hidden' | 'active' | 'passive' | 'frozen' | 'terminated';
+export type DocumentState = 'loading' | 'interactive' | 'complete' | 'domLoaded' | 'fullyLoaded';
+//# sourceMappingURL=typedef.d.ts.map

package/dist/pagelifecycle/typedef.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typedef.d.ts","sourceRoot":"","sources":["../../src/pagelifecycle/typedef.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,OAAO,CAAC;AAE5B,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,CAAC;AAE3F,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,aAAa,GAAG,UAAU,GAAG,WAAW,GAAG,aAAa,CAAC"}

package/dist/pagelifecycle/typedef.js

@@ -0,0 +1,2 @@
+export const TYPEDEF = true;
+//# sourceMappingURL=typedef.js.map

package/dist/pagelifecycle/typedef.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typedef.js","sourceRoot":"","sources":["../../src/pagelifecycle/typedef.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC"}

package/dist/pagelifecycle/util.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Page lifecycle helper.
+ * @see https://developer.chrome.com/docs/web-platform/page-lifecycle-api
+ */
+import { EventEmitter } from '../util/event_emitter.js';
+import type { DocumentState, PageLifecycleState } from './typedef.js';
+/**
+ * Initialize page lifecycle observer.
+ */
+export declare const initPageLifecycle: () => void;
+/**
+ * Returns the current page lifecycle state.
+ */
+export declare const getPageLifecycleState: () => PageLifecycleState | null | undefined;
+/**
+ * Returns the current document state.
+ */
+export declare const getDocumentState: () => DocumentState | null | undefined;
+/**
+ * Returns the event emitter instance.
+ */
+export declare const getPageLifecycleEventEmitter: () => EventEmitter;
+/**
+ * Returns the page lifecycle observer initialized state.
+ */
+export declare const isPageLifecycleInitialized: () => boolean;
+/**
+ * Add callback for a specific state change.
+ */
+export declare const addPageLifecycleCallback: (state: DocumentState | PageLifecycleState, callback: () => void) => void;
+//# sourceMappingURL=util.d.ts.map

package/dist/pagelifecycle/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/pagelifecycle/util.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAYxD,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAqEtE;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAO,IAwBpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,QAAO,kBAAkB,GAAG,IAAI,GAAG,SAAsC,CAAC;AAE5G;;GAEG;AACH,eAAO,MAAM,gBAAgB,QAAO,aAAa,GAAG,IAAI,GAAG,SAAiC,CAAC;AAE7F;;GAEG;AACH,eAAO,MAAM,4BAA4B,QAAO,YAK/C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,QAAO,OAAwB,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,OAAO,aAAa,GAAG,kBAAkB,EAAE,UAAU,MAAM,IAAI,KAAG,IAI1G,CAAC"}

package/dist/pagelifecycle/util.js

@@ -0,0 +1,117 @@
+/**
+ * Page lifecycle helper.
+ * @see https://developer.chrome.com/docs/web-platform/page-lifecycle-api
+ */
+import { Logger } from '../logging/Logger.js';
+import { EventEmitter } from '../util/event_emitter.js';
+import { DOCUMENT_STATE_CHANGE_EVENT, DOCUMENT_STATE_DOM_LOADED, DOCUMENT_STATE_FULLY_LOADED, PAGE_LIFECYCLE_STATE_ACTIVE, PAGE_LIFECYCLE_STATE_CHANGE_EVENT, PAGE_LIFECYCLE_STATE_FROZEN, PAGE_LIFECYCLE_STATE_HIDDEN, PAGE_LIFECYCLE_STATE_PASSIVE, PAGE_LIFECYCLE_STATE_TERMINATED, } from './const.js';
+const logger = new Logger('pagelifecycle');
+const eventEmitter = new EventEmitter();
+let currentPageLifecycleState = null;
+let currentDocumentState = null;
+let isInitialized = false;
+const callbacks = {};
+/**
+ * Run callbacks for a specific state change.
+ */
+const processCallbacks = (state) => {
+    const stateCallbacks = callbacks[state];
+    if (!stateCallbacks) {
+        return;
+    }
+    for (const callback of stateCallbacks) {
+        callback();
+    }
+    stateCallbacks.length = 0;
+};
+/**
+ * Detects the current page lifecycle state.
+ */
+const detectPageLifecycleState = () => {
+    if (document.visibilityState === 'hidden') {
+        return PAGE_LIFECYCLE_STATE_HIDDEN;
+    }
+    if (document.hasFocus()) {
+        return PAGE_LIFECYCLE_STATE_ACTIVE;
+    }
+    return PAGE_LIFECYCLE_STATE_PASSIVE;
+};
+/**
+ * Handles page lifecycle state change.
+ */
+const onPageLifecycleStateChange = (nextState) => {
+    const previousState = currentPageLifecycleState;
+    if (nextState !== previousState) {
+        currentPageLifecycleState = nextState;
+        const eventData = { previousState, nextState };
+        logger.info(PAGE_LIFECYCLE_STATE_CHANGE_EVENT, eventData);
+        eventEmitter.emit(PAGE_LIFECYCLE_STATE_CHANGE_EVENT, eventData);
+        processCallbacks(currentPageLifecycleState);
+    }
+};
+/**
+ * Handles document state change.
+ */
+const onDocumentStateChange = (nextState) => {
+    const previousState = currentDocumentState;
+    if (nextState !== previousState) {
+        currentDocumentState = nextState;
+        const eventData = { previousState, nextState };
+        logger.info(DOCUMENT_STATE_CHANGE_EVENT, eventData);
+        eventEmitter.emit(DOCUMENT_STATE_CHANGE_EVENT, eventData);
+        processCallbacks(currentDocumentState);
+    }
+};
+/**
+ * Initialize page lifecycle observer.
+ */
+export const initPageLifecycle = () => {
+    if (isInitialized) {
+        return;
+    }
+    logger.info('initPageLifecycle');
+    onPageLifecycleStateChange(detectPageLifecycleState());
+    onDocumentStateChange(document.readyState);
+    const options = { capture: true };
+    document.addEventListener('visibilitychange', () => onPageLifecycleStateChange(detectPageLifecycleState()), options);
+    globalThis.addEventListener('pageshow', () => onPageLifecycleStateChange(detectPageLifecycleState()), options);
+    globalThis.addEventListener('focus', () => onPageLifecycleStateChange(detectPageLifecycleState()), options);
+    globalThis.addEventListener('blur', () => onPageLifecycleStateChange(detectPageLifecycleState()), options);
+    document.addEventListener('resume', () => onPageLifecycleStateChange(detectPageLifecycleState()), options);
+    document.addEventListener('freeze', () => onPageLifecycleStateChange(PAGE_LIFECYCLE_STATE_FROZEN), options);
+    globalThis.addEventListener('pagehide', (event) => onPageLifecycleStateChange(event.persisted ? PAGE_LIFECYCLE_STATE_FROZEN : PAGE_LIFECYCLE_STATE_TERMINATED), options);
+    document.addEventListener('DOMContentLoaded', () => onDocumentStateChange(DOCUMENT_STATE_DOM_LOADED), options);
+    document.addEventListener('readystatechange', () => onDocumentStateChange(document.readyState), options);
+    globalThis.addEventListener('load', () => onDocumentStateChange(DOCUMENT_STATE_FULLY_LOADED), options);
+    isInitialized = true;
+};
+/**
+ * Returns the current page lifecycle state.
+ */
+export const getPageLifecycleState = () => currentPageLifecycleState;
+/**
+ * Returns the current document state.
+ */
+export const getDocumentState = () => currentDocumentState;
+/**
+ * Returns the event emitter instance.
+ */
+export const getPageLifecycleEventEmitter = () => {
+    if (!isInitialized) {
+        initPageLifecycle();
+    }
+    return eventEmitter;
+};
+/**
+ * Returns the page lifecycle observer initialized state.
+ */
+export const isPageLifecycleInitialized = () => isInitialized;
+/**
+ * Add callback for a specific state change.
+ */
+export const addPageLifecycleCallback = (state, callback) => {
+    const stateCallbacks = callbacks[state] ?? [];
+    stateCallbacks.push(callback);
+    callbacks[state] = stateCallbacks;
+};
+//# sourceMappingURL=util.js.map

package/dist/pagelifecycle/util.js.map

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

package/dist/typecheck/TypeCheckError.d.ts

@@ -0,0 +1,11 @@
+export interface TypeCheckErrorOptions extends ErrorOptions {
+    value?: unknown;
+}
+export declare class TypeCheckError extends TypeError {
+    value: unknown;
+    /**
+     * Creates a new `TypeCheckError` instance.
+     */
+    constructor(message: string, options?: TypeCheckErrorOptions);
+}
+//# sourceMappingURL=TypeCheckError.d.ts.map

package/dist/typecheck/TypeCheckError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeCheckError.d.ts","sourceRoot":"","sources":["../../src/typecheck/TypeCheckError.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAsB,SAAQ,YAAY;IACzD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,cAAe,SAAQ,SAAS;IAC3C,KAAK,EAAE,OAAO,CAAC;IAEf;;OAEG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB;CAK7D"}

package/dist/typecheck/TypeCheckError.js

@@ -0,0 +1,12 @@
+export class TypeCheckError extends TypeError {
+    value;
+    /**
+     * Creates a new `TypeCheckError` instance.
+     */
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'TypeCheckError';
+        this.value = options?.value;
+    }
+}
+//# sourceMappingURL=TypeCheckError.js.map

package/dist/typecheck/TypeCheckError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeCheckError.js","sourceRoot":"","sources":["../../src/typecheck/TypeCheckError.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,cAAe,SAAQ,SAAS;IAC3C,KAAK,CAAU;IAEf;;OAEG;IACH,YAAY,OAAe,EAAE,OAA+B;QAC1D,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,CAAC;IAC9B,CAAC;CACF"}

package/dist/typecheck/TypeChecker.d.ts

@@ -0,0 +1,27 @@
+import { type EnumChoices } from './util.js';
+declare class TypeChecker {
+    #private;
+    constructor();
+    /**
+     * Enable or disable swallowing of TypeCheckErrors.
+     */
+    setSwallowErrors(value: boolean): void;
+    /**
+     * Type check a single value.
+     */
+    check<T>(value: unknown, validator: (value: unknown) => value is T): T;
+    /**
+     * Type check an array of values.
+     */
+    checkArray<T>(value: unknown[], validator: (value: unknown) => value is T): T[];
+    /**
+     * Type check an enum.
+     */
+    checkEnum(value: string | number, choices: EnumChoices): string | number;
+}
+/**
+ * Export a single shared instance.
+ */
+export declare const typeChecker: TypeChecker;
+export {};
+//# sourceMappingURL=TypeChecker.d.ts.map

package/dist/typecheck/TypeChecker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeChecker.d.ts","sourceRoot":"","sources":["../../src/typecheck/TypeChecker.ts"],"names":[],"mappings":"AAEA,OAAO,EAA4C,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAIvF,cAAM,WAAW;;;IAWf;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAItC;;OAEG;IACH,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,GAAG,CAAC;IAYtE;;OAEG;IACH,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE;IAY/E;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,GAAG,MAAM;CAWzE;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,aAAoB,CAAC"}

package/dist/typecheck/TypeChecker.js

@@ -0,0 +1,69 @@
+import { Logger } from '../logging/Logger.js';
+import { TypeCheckError } from './TypeCheckError.js';
+import { typeCheck, typeCheckArray, typeCheckEnum } from './util.js';
+const logger = new Logger('typechecker');
+class TypeChecker {
+    static #instance;
+    #swallowErrors = false;
+    constructor() {
+        if (TypeChecker.#instance === undefined) {
+            TypeChecker.#instance = this;
+        }
+    }
+    /**
+     * Enable or disable swallowing of TypeCheckErrors.
+     */
+    setSwallowErrors(value) {
+        this.#swallowErrors = Boolean(value);
+    }
+    /**
+     * Type check a single value.
+     */
+    check(value, validator) {
+        try {
+            return typeCheck(value, validator);
+        }
+        catch (error) {
+            if (this.#swallowErrors && error instanceof TypeCheckError) {
+                logger.exception('check', error);
+                return value;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Type check an array of values.
+     */
+    checkArray(value, validator) {
+        try {
+            return typeCheckArray(value, validator);
+        }
+        catch (error) {
+            if (this.#swallowErrors && error instanceof TypeCheckError) {
+                logger.exception('checkArray', error);
+                return value;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Type check an enum.
+     */
+    checkEnum(value, choices) {
+        try {
+            return typeCheckEnum(value, choices);
+        }
+        catch (error) {
+            if (this.#swallowErrors && error instanceof TypeCheckError) {
+                logger.exception('checkEnum', error);
+                return value;
+            }
+            throw error;
+        }
+    }
+}
+/**
+ * Export a single shared instance.
+ */
+export const typeChecker = new TypeChecker();
+//# sourceMappingURL=TypeChecker.js.map

package/dist/typecheck/TypeChecker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeChecker.js","sourceRoot":"","sources":["../../src/typecheck/TypeChecker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAoB,MAAM,WAAW,CAAC;AAEvF,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,aAAa,CAAC,CAAC;AAEzC,MAAM,WAAW;IACf,MAAM,CAAC,SAAS,CAA0B;IAE1C,cAAc,GAAG,KAAK,CAAC;IAEvB;QACE,IAAI,WAAW,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACxC,WAAW,CAAC,SAAS,GAAG,IAAI,CAAC;QAC/B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,KAAc;QAC7B,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,KAAK,CAAI,KAAc,EAAE,SAAyC;QAChE,IAAI,CAAC;YACH,OAAO,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,IAAI,CAAC,cAAc,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;gBAC3D,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBACjC,OAAO,KAAU,CAAC;YACpB,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU,CAAI,KAAgB,EAAE,SAAyC;QACvE,IAAI,CAAC;YACH,OAAO,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,IAAI,CAAC,cAAc,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;gBAC3D,MAAM,CAAC,SAAS,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;gBACtC,OAAO,KAAY,CAAC;YACtB,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,KAAsB,EAAE,OAAoB;QACpD,IAAI,CAAC;YACH,OAAO,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,IAAI,CAAC,cAAc,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;gBAC3D,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;gBACrC,OAAO,KAAK,CAAC;YACf,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC"}

package/dist/typecheck/util.d.ts

@@ -0,0 +1,17 @@
+export type EnumChoices = ReadonlyArray<string | number> | ReadonlySet<string | number> | Readonly<Record<string | number, string | number>>;
+/**
+ * Type check a value using a validator.
+ * @throws {TypeCheckError}
+ */
+export declare const typeCheck: <T>(value: unknown, validator: (value: unknown) => value is T) => T;
+/**
+ * Type check an array of values using a validator.
+ * @throws {TypeCheckError}
+ */
+export declare const typeCheckArray: <T>(value: unknown[], validator: (value: unknown) => value is T) => T[];
+/**
+ * Type check an enum.
+ * @throws {TypeCheckError}
+ */
+export declare const typeCheckEnum: (value: string | number, choices: EnumChoices) => string | number;
+//# sourceMappingURL=util.d.ts.map

package/dist/typecheck/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/typecheck/util.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,WAAW,GACnB,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,GAC9B,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,GAC5B,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;AAWvD;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,OAAO,OAAO,EAAE,WAAW,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,KAAG,CAKxF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,OAAO,OAAO,EAAE,EAAE,WAAW,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,KAAG,CAAC,EAKhG,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,GAAG,MAAM,EAAE,SAAS,WAAW,KAAG,MAAM,GAAG,MAKrF,CAAC"}

package/dist/typecheck/util.js

@@ -0,0 +1,42 @@
+import { getDisplayValue, getTypeFromValue } from '../util/string.js';
+import { isArrayOf, isEnum } from '../util/validate.js';
+import { TypeCheckError } from './TypeCheckError.js';
+/**
+ * Get error message for validator exceptions.
+ */
+const getErrorMessage = (validatorName, value) => {
+    const displayValue = getDisplayValue(value);
+    const displayType = getTypeFromValue(value);
+    throw new TypeCheckError(`Validation failed: ${validatorName || '<anonymous>'} - ${displayValue} (${displayType})`);
+};
+/**
+ * Type check a value using a validator.
+ * @throws {TypeCheckError}
+ */
+export const typeCheck = (value, validator) => {
+    if (!validator(value)) {
+        getErrorMessage(validator.name, value);
+    }
+    return value;
+};
+/**
+ * Type check an array of values using a validator.
+ * @throws {TypeCheckError}
+ */
+export const typeCheckArray = (value, validator) => {
+    if (!isArrayOf(value, validator)) {
+        getErrorMessage(validator.name, value);
+    }
+    return value;
+};
+/**
+ * Type check an enum.
+ * @throws {TypeCheckError}
+ */
+export const typeCheckEnum = (value, choices) => {
+    if (!isEnum(value, choices)) {
+        getErrorMessage('isEnum', value);
+    }
+    return value;
+};
+//# sourceMappingURL=util.js.map

package/dist/typecheck/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/typecheck/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAOrD;;GAEG;AACH,MAAM,eAAe,GAAG,CAAC,aAAqB,EAAE,KAAc,EAAS,EAAE;IACvE,MAAM,YAAY,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,IAAI,cAAc,CAAC,sBAAsB,aAAa,IAAI,aAAa,MAAM,YAAY,KAAK,WAAW,GAAG,CAAC,CAAC;AACtH,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAI,KAAc,EAAE,SAAyC,EAAK,EAAE;IAC3F,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,eAAe,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,KAAU,CAAC;AACpB,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAI,KAAgB,EAAE,SAAyC,EAAO,EAAE;IACpG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;QACjC,eAAe,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,KAAY,CAAC;AACtB,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAsB,EAAE,OAAoB,EAAmB,EAAE;IAC7F,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;QAC5B,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/util/async.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Returns a promise with delayed resolve.
+ */
+export declare const delayPromise: (delayMS: number) => Promise<void>;
+/**
+ * Async method call retry helper.
+ */
+export declare const retryAsync: <T>(method: () => Promise<T>, numTries?: number, delayMs?: number) => Promise<T>;
+/**
+ * Load JSON file using a fetch GET request.
+ */
+export declare const loadJSON: (url: string) => Promise<unknown>;
+//# sourceMappingURL=async.d.ts.map

package/dist/util/async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.d.ts","sourceRoot":"","sources":["../../src/util/async.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,KAAG,OAAO,CAAC,IAAI,CAGvD,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,UAAU,GAAU,CAAC,EAAE,QAAQ,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,iBAAY,EAAE,gBAAa,KAAG,OAAO,CAAC,CAAC,CAgBpG,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,GAAU,KAAK,MAAM,KAAG,OAAO,CAAC,OAAO,CAM3D,CAAC"}