@amazon/vinyl-util 1.0.0

package/dist/types/current/index.d.ts

@@ -0,0 +1,118 @@
+/** Auto-generated from build scripts */
+export * from './util/type';
+export * from './util/url/resolveUrl';
+export * from './util/string/uid';
+export * from './util/string/string';
+export * from './util/string/StringReader';
+export * from './util/set/set';
+export * from './util/serialization/stringifyForPrint';
+export * from './util/serialization/primitives';
+export * from './util/serialization/json';
+export * from './util/serialization/ParseError';
+export * from './util/range/timeRanges';
+export * from './util/range/UnionRanges';
+export * from './util/range/Ranges';
+export * from './util/range/IntersectionRanges';
+export * from './util/object/readonlyType';
+export * from './util/object/object';
+export * from './util/object/mutableType';
+export * from './util/object/mergeDeep';
+export * from './util/object/merge';
+export * from './util/object/lazy';
+export * from './util/object/equalDeep';
+export * from './util/object/clone';
+export * from './util/network/request';
+export * from './util/mpeg/parseSidxBox';
+export * from './util/math/math';
+export * from './util/map/map';
+export * from './util/iteration/iterable';
+export * from './util/fun/throttle';
+export * from './util/fun/memoize';
+export * from './util/fun/function';
+export * from './util/fun/flow';
+export * from './util/fun/debounce';
+export * from './util/error/stack';
+export * from './util/date/date';
+export * from './util/config/ValueProvider';
+export * from './util/comparison/compare';
+export * from './util/collection/typedArray';
+export * from './util/collection/array';
+export * from './util/collection/LruCache';
+export * from './util/collection/LinkedList';
+export * from './util/collection/CacheMap';
+export * from './util/buffer/buffer';
+export * from './util/buffer/BufferWriter';
+export * from './util/buffer/BufferReader';
+export * from './util/buffer/BufferError';
+export * from './util/browser/searchParams';
+export * from './util/async/timeout';
+export * from './util/async/sleep';
+export * from './util/async/promise';
+export * from './util/async/never';
+export * from './util/async/abortUtils';
+export * from './util/async/TimeoutSlot';
+export * from './util/async/TimeoutController';
+export * from './util/async/TaskQueue';
+export * from './util/async/Deferred';
+export * from './util/async/Abort';
+export * from './persistence/persistenceRef';
+export * from './persistence/StoragePersistence';
+export * from './persistence/PersistentItem';
+export * from './persistence/KeyValuePersistence';
+export * from './patch/patchTarget';
+export * from './patch/network/fetch';
+export * from './network/responseUtil';
+export * from './network/requesterUtil';
+export * from './network/requesterGlobal';
+export * from './network/network';
+export * from './network/createRequester';
+export * from './network/RequesterImplEventMap';
+export * from './network/RequesterImpl';
+export * from './network/Requester';
+export * from './network/RequestInterceptor';
+export * from './network/RequestError';
+export * from './network/metrics/networkMetricsModel';
+export * from './network/metrics/networkMetricsGlobal';
+export * from './network/metrics/NetworkMetricsControllerImpl';
+export * from './network/metrics/NetworkMetricsController';
+export * from './network/logging/networkLoggingHandler';
+export * from './network/browser/NetworkInformation';
+export * from './logging/logTimer';
+export * from './logging/getLogLevelFromSearch';
+export * from './logging/VinylLogging';
+export * from './logging/Logger';
+export * from './logging/LogTarget';
+export * from './logging/HistoryLogHandler';
+export * from './logging/ConsoleLogHandler';
+export * from './global/globalTarget';
+export * from './global/globalRegistry';
+export * from './global/environment';
+export * from './event/redispatchEvents';
+export * from './event/onAny';
+export * from './event/nextEventAsPromise';
+export * from './event/Signal';
+export * from './event/EventHost';
+export * from './event/DomEventHost';
+export * from './error/ValidationError';
+export * from './error/UnreachableCodeError';
+export * from './error/TimeoutError';
+export * from './error/StackOverflowError';
+export * from './error/ServiceResponseError';
+export * from './error/ReportableError';
+export * from './error/MediaUnsupportedError';
+export * from './error/IllegalStateError';
+export * from './error/IllegalArgumentError';
+export * from './error/ErrorOrigin';
+export * from './error/AbortError';
+export * from './core/disposable';
+export * from './core/cloneable';
+export * from './core/clearable';
+export * from './core/Unsubscribe';
+export * from './client/Version';
+export * from './client/userAgent/userAgentRuleHelpers';
+export * from './client/userAgent/tokenizeUserAgent';
+export * from './client/userAgent/parseUserAgent';
+export * from './client/userAgent/hasBrowser';
+export * from './client/userAgent/defaultUserAgentRules';
+export * from './client/userAgent/UserAgentInfo';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/current/index.d.ts.map

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

package/dist/types/current/index.js

@@ -0,0 +1,117 @@
+/** Auto-generated from build scripts */
+export * from './util/type';
+export * from './util/url/resolveUrl';
+export * from './util/string/uid';
+export * from './util/string/string';
+export * from './util/string/StringReader';
+export * from './util/set/set';
+export * from './util/serialization/stringifyForPrint';
+export * from './util/serialization/primitives';
+export * from './util/serialization/json';
+export * from './util/serialization/ParseError';
+export * from './util/range/timeRanges';
+export * from './util/range/UnionRanges';
+export * from './util/range/Ranges';
+export * from './util/range/IntersectionRanges';
+export * from './util/object/readonlyType';
+export * from './util/object/object';
+export * from './util/object/mutableType';
+export * from './util/object/mergeDeep';
+export * from './util/object/merge';
+export * from './util/object/lazy';
+export * from './util/object/equalDeep';
+export * from './util/object/clone';
+export * from './util/network/request';
+export * from './util/mpeg/parseSidxBox';
+export * from './util/math/math';
+export * from './util/map/map';
+export * from './util/iteration/iterable';
+export * from './util/fun/throttle';
+export * from './util/fun/memoize';
+export * from './util/fun/function';
+export * from './util/fun/flow';
+export * from './util/fun/debounce';
+export * from './util/error/stack';
+export * from './util/date/date';
+export * from './util/config/ValueProvider';
+export * from './util/comparison/compare';
+export * from './util/collection/typedArray';
+export * from './util/collection/array';
+export * from './util/collection/LruCache';
+export * from './util/collection/LinkedList';
+export * from './util/collection/CacheMap';
+export * from './util/buffer/buffer';
+export * from './util/buffer/BufferWriter';
+export * from './util/buffer/BufferReader';
+export * from './util/buffer/BufferError';
+export * from './util/browser/searchParams';
+export * from './util/async/timeout';
+export * from './util/async/sleep';
+export * from './util/async/promise';
+export * from './util/async/never';
+export * from './util/async/abortUtils';
+export * from './util/async/TimeoutSlot';
+export * from './util/async/TimeoutController';
+export * from './util/async/TaskQueue';
+export * from './util/async/Deferred';
+export * from './util/async/Abort';
+export * from './persistence/persistenceRef';
+export * from './persistence/StoragePersistence';
+export * from './persistence/PersistentItem';
+export * from './persistence/KeyValuePersistence';
+export * from './patch/patchTarget';
+export * from './patch/network/fetch';
+export * from './network/responseUtil';
+export * from './network/requesterUtil';
+export * from './network/requesterGlobal';
+export * from './network/network';
+export * from './network/createRequester';
+export * from './network/RequesterImplEventMap';
+export * from './network/RequesterImpl';
+export * from './network/Requester';
+export * from './network/RequestInterceptor';
+export * from './network/RequestError';
+export * from './network/metrics/networkMetricsModel';
+export * from './network/metrics/networkMetricsGlobal';
+export * from './network/metrics/NetworkMetricsControllerImpl';
+export * from './network/metrics/NetworkMetricsController';
+export * from './network/logging/networkLoggingHandler';
+export * from './network/browser/NetworkInformation';
+export * from './logging/logTimer';
+export * from './logging/getLogLevelFromSearch';
+export * from './logging/VinylLogging';
+export * from './logging/Logger';
+export * from './logging/LogTarget';
+export * from './logging/HistoryLogHandler';
+export * from './logging/ConsoleLogHandler';
+export * from './global/globalTarget';
+export * from './global/globalRegistry';
+export * from './global/environment';
+export * from './event/redispatchEvents';
+export * from './event/onAny';
+export * from './event/nextEventAsPromise';
+export * from './event/Signal';
+export * from './event/EventHost';
+export * from './event/DomEventHost';
+export * from './error/ValidationError';
+export * from './error/UnreachableCodeError';
+export * from './error/TimeoutError';
+export * from './error/StackOverflowError';
+export * from './error/ServiceResponseError';
+export * from './error/ReportableError';
+export * from './error/MediaUnsupportedError';
+export * from './error/IllegalStateError';
+export * from './error/IllegalArgumentError';
+export * from './error/ErrorOrigin';
+export * from './error/AbortError';
+export * from './core/disposable';
+export * from './core/cloneable';
+export * from './core/clearable';
+export * from './core/Unsubscribe';
+export * from './client/Version';
+export * from './client/userAgent/userAgentRuleHelpers';
+export * from './client/userAgent/tokenizeUserAgent';
+export * from './client/userAgent/parseUserAgent';
+export * from './client/userAgent/hasBrowser';
+export * from './client/userAgent/defaultUserAgentRules';
+export * from './client/userAgent/UserAgentInfo';

package/dist/types/current/logging/ConsoleLogHandler.d.ts

@@ -0,0 +1,26 @@
+import type { Disposable } from '../core/disposable';
+import type { ReadonlyEventHost } from '../event/EventHost';
+import type { LogEventMap } from './Logger';
+import { LogLevel } from './Logger';
+export interface ConsoleLike {
+    log(message?: any, ...optionalParams: any[]): void;
+    debug(message?: any, ...optionalParams: any[]): void;
+    warn(message?: any, ...optionalParams: any[]): void;
+    error(message?: any, ...optionalParams: any[]): void;
+}
+/**
+ * A log target that logs to a console.
+ */
+export interface ConsoleLogHandler {
+    logLevel: LogLevel;
+}
+/**
+ * A {@link ConsoleLogHandler} implementation.
+ */
+export declare class ConsoleLogHandlerImpl implements ConsoleLogHandler, Disposable {
+    logLevel: LogLevel;
+    private readonly logSub;
+    constructor(host: ReadonlyEventHost<LogEventMap>, logLevel?: LogLevel, consoleLike?: ConsoleLike);
+    dispose(): void;
+}
+//# sourceMappingURL=ConsoleLogHandler.d.ts.map

package/dist/types/current/logging/ConsoleLogHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsoleLogHandler.d.ts","sourceRoot":"","sources":["../../../../src/logging/ConsoleLogHandler.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAEnC,MAAM,WAAW,WAAW;IACxB,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;IAClD,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;IACpD,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;IACnD,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;CACvD;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,EAAE,QAAQ,CAAA;CACrB;AAED;;GAEG;AACH,qBAAa,qBAAsB,YAAW,iBAAiB,EAAE,UAAU;IAK5D,QAAQ,EAAE,QAAQ;IAJ7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;gBAGhC,IAAI,EAAE,iBAAiB,CAAC,WAAW,CAAC,EAC7B,QAAQ,GAAE,QAAyB,EAC1C,WAAW,GAAE,WAAqB;IAgCtC,OAAO,IAAI,IAAI;CAGlB"}

package/dist/types/current/logging/ConsoleLogHandler.js

@@ -0,0 +1,43 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { LogLevel } from './Logger';
+/**
+ * A {@link ConsoleLogHandler} implementation.
+ */
+export class ConsoleLogHandlerImpl {
+    logLevel;
+    logSub;
+    constructor(host, logLevel = LogLevel.DEBUG, consoleLike = console) {
+        this.logLevel = logLevel;
+        this.logSub = host.on('log', (event) => {
+            if (event.level < this.logLevel)
+                return;
+            let consoleFun;
+            switch (event.level) {
+                case LogLevel.INFO:
+                    consoleFun = consoleLike['log'];
+                    break;
+                case LogLevel.WARN:
+                    consoleFun = consoleLike['warn'];
+                    break;
+                case LogLevel.ERROR:
+                    consoleFun = consoleLike['error'];
+                    break;
+                case LogLevel.DEBUG:
+                case LogLevel.VERBOSE:
+                default:
+                    consoleFun = consoleLike['debug'];
+                    break;
+            }
+            const now = new Date();
+            const minutes = String(now.getMinutes()).padStart(2, '0');
+            const seconds = String(now.getSeconds()).padStart(2, '0');
+            consoleFun.call(consoleLike, `[${minutes}:${seconds} ${event.target.logPrefix}]`, ...event.messages);
+        });
+    }
+    dispose() {
+        this.logSub();
+    }
+}

package/dist/types/current/logging/HistoryLogHandler.d.ts

@@ -0,0 +1,56 @@
+import type { Disposable } from '../core/disposable';
+import type { ReadonlyEventHost } from '../event/EventHost';
+import type { LogEventMap } from './Logger';
+import { LogLevel } from './Logger';
+import type { ReadonlyDate } from '../util/object/readonlyType';
+/**
+ * The default maximum history size for the history log handler.
+ */
+export declare const DEFAULT_MAX_HISTORY = 100;
+export interface HistoryLogItem {
+    readonly timestamp: ReadonlyDate;
+    readonly messages: readonly any[];
+    readonly level: LogLevel;
+    /**
+     * The LogTarget's logPrefix.
+     */
+    readonly logPrefix: string;
+}
+/**
+ * Logs to a rolling list.
+ */
+export interface HistoryLogHandler {
+    /**
+     * This level and higher will be logged to the history.
+     * Default is {@link LogLevel.DEBUG}
+     */
+    logLevel: LogLevel;
+    /**
+     * The maximum number of logs to keep.
+     */
+    maxHistorySize: number;
+    /**
+     * The log history, kept up to {@link maxHistorySize}
+     */
+    get history(): readonly HistoryLogItem[];
+    /**
+     * Clears the log history.
+     */
+    clear(): void;
+}
+/**
+ * A basic HistoryLogHandler implementation.
+ */
+export declare class HistoryLogHandlerImpl implements HistoryLogHandler, Disposable {
+    logLevel: LogLevel;
+    private readonly _history;
+    private readonly logSub;
+    private _maxHistorySize;
+    constructor(host: ReadonlyEventHost<LogEventMap>, logLevel?: LogLevel);
+    get maxHistorySize(): number;
+    set maxHistorySize(value: number);
+    get history(): readonly HistoryLogItem[];
+    clear(): void;
+    dispose(): void;
+}
+//# sourceMappingURL=HistoryLogHandler.d.ts.map

package/dist/types/current/logging/HistoryLogHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HistoryLogHandler.d.ts","sourceRoot":"","sources":["../../../../src/logging/HistoryLogHandler.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAE9D;;GAEG;AACH,eAAO,MAAM,mBAAmB,MAAM,CAAA;AAEtC,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAA;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,EAAE,CAAA;IACjC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;IAExB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B;;;OAGG;IACH,QAAQ,EAAE,QAAQ,CAAA;IAElB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAA;IAEtB;;OAEG;IACH,IAAI,OAAO,IAAI,SAAS,cAAc,EAAE,CAAA;IAExC;;OAEG;IACH,KAAK,IAAI,IAAI,CAAA;CAChB;AAED;;GAEG;AACH,qBAAa,qBAAsB,YAAW,iBAAiB,EAAE,UAAU;IAO5D,QAAQ,EAAE,QAAQ;IAN7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,eAAe,CAA8B;gBAGjD,IAAI,EAAE,iBAAiB,CAAC,WAAW,CAAC,EAC7B,QAAQ,GAAE,QAAyB;IAgB9C,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,cAAc,CAAC,KAAK,EAAE,MAAM,EAM/B;IAED,IAAI,OAAO,IAAI,SAAS,cAAc,EAAE,CAEvC;IAED,KAAK;IAIL,OAAO,IAAI,IAAI;CAIlB"}

package/dist/types/current/logging/HistoryLogHandler.js

@@ -0,0 +1,54 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { LogLevel } from './Logger';
+/**
+ * The default maximum history size for the history log handler.
+ */
+export const DEFAULT_MAX_HISTORY = 100;
+/**
+ * A basic HistoryLogHandler implementation.
+ */
+export class HistoryLogHandlerImpl {
+    logLevel;
+    _history = [];
+    logSub;
+    _maxHistorySize = DEFAULT_MAX_HISTORY;
+    constructor(host, logLevel = LogLevel.DEBUG) {
+        this.logLevel = logLevel;
+        this.logSub = host.on('log', (event) => {
+            if (event.level < this.logLevel)
+                return;
+            this._history.push({
+                level: event.level,
+                messages: event.messages,
+                timestamp: new Date(),
+                logPrefix: event.target.logPrefix,
+            });
+            if (this._history.length > this.maxHistorySize) {
+                this._history.shift();
+            }
+        });
+    }
+    get maxHistorySize() {
+        return this._maxHistorySize;
+    }
+    set maxHistorySize(value) {
+        value = Math.max(0, value);
+        while (value < this._history.length) {
+            this._history.shift();
+        }
+        this._maxHistorySize = value;
+    }
+    get history() {
+        return this._history;
+    }
+    clear() {
+        this._history.length = 0;
+    }
+    dispose() {
+        this.clear();
+        this.logSub();
+    }
+}

package/dist/types/current/logging/LogTarget.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Provides the logging prefix for all logs made by this target.
+ */
+export interface LogTarget {
+    /**
+     * A string prefix for all log statements made by this target.
+     */
+    readonly logPrefix: string;
+}
+/**
+ * Creates a unique log prefix.
+ *
+ * @param target Either a string or an object with a toStringTag.
+ * The log prefix will append a unique counter.
+ */
+export declare function createLogPrefix(target: string | {
+    readonly [Symbol.toStringTag]: string;
+}): string;
+//# sourceMappingURL=LogTarget.d.ts.map

package/dist/types/current/logging/LogTarget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogTarget.d.ts","sourceRoot":"","sources":["../../../../src/logging/LogTarget.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC7B;AAOD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC3B,MAAM,EAAE,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3D,MAAM,CAIR"}

package/dist/types/current/logging/LogTarget.js

@@ -0,0 +1,18 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * A static counter for creating a locally-unique id.
+ */
+let counter = 0;
+/**
+ * Creates a unique log prefix.
+ *
+ * @param target Either a string or an object with a toStringTag.
+ * The log prefix will append a unique counter.
+ */
+export function createLogPrefix(target) {
+    const name = typeof target === 'string' ? target : target[Symbol.toStringTag];
+    return `${name}/${++counter}`;
+}

package/dist/types/current/logging/Logger.d.ts

@@ -0,0 +1,66 @@
+import type { ReadonlyEventHost } from '../event/EventHost';
+import { EventHostImpl } from '../event/EventHost';
+import type { LogTarget } from '../logging/LogTarget';
+export declare enum LogLevel {
+    VERBOSE = 0,
+    DEBUG = 1,
+    INFO = 2,
+    WARN = 3,
+    ERROR = 4,
+    NONE = 5
+}
+export interface LogEvent {
+    readonly messages: any[];
+    readonly target: LogTarget;
+    readonly level: LogLevel;
+}
+export interface LogEventMap {
+    readonly log: LogEvent;
+}
+/**
+ * The interface for a basic logger implementation.
+ */
+export interface Logger extends ReadonlyEventHost<LogEventMap> {
+    logLevel: LogLevel;
+    log(target: LogTarget, level: LogLevel, ...messages: readonly any[]): void;
+}
+export declare class LoggerImpl extends EventHostImpl<LogEventMap> implements Logger {
+    logLevel: LogLevel;
+    get [Symbol.toStringTag](): string;
+    constructor(logLevel?: LogLevel);
+    log(target: LogTarget, level: LogLevel, ...messages: readonly any[]): void;
+}
+/**
+ * A global reference to the logger.
+ * @private
+ */
+export declare const loggerRef: import("../global/globalRegistry").GlobalRef<Logger>;
+/**
+ * Returns the current log level.
+ */
+export declare function getLogLevel(): LogLevel;
+/**
+ * Sets the current log level.
+ *
+ * @param value
+ */
+export declare function setLogLevel(value: LogLevel): void;
+export declare function log(target: LogTarget, level: LogLevel, ...messages: readonly any[]): void;
+export declare function logVerbose(target: LogTarget, ...messages: readonly any[]): void;
+export declare function logDebug(target: LogTarget, ...messages: readonly any[]): void;
+export declare function logInfo(target: LogTarget, ...messages: readonly any[]): void;
+export declare function logWarn(target: LogTarget, ...messages: readonly any[]): void;
+export declare function logError(target: LogTarget, ...messages: readonly any[]): void;
+/**
+ * From a case-insensitive string, returns the log level.
+ * Possible values match to the keys in {@link LogLevel}.
+ *
+ * @param str
+ */
+export declare function parseLogLevel(str: string): LogLevel | null;
+/**
+ * Returns the log level as a lowercase string.
+ * E.g. stringifyLogLevel(LogLevel.DEBUG) returns 'debug'
+ */
+export declare function stringifyLogLevel(logLevel: LogLevel): string;
+//# sourceMappingURL=Logger.d.ts.map

package/dist/types/current/logging/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../../../src/logging/Logger.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAGjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAGpD,oBAAY,QAAQ;IAChB,OAAO,IAAA;IACP,KAAK,IAAA;IACL,IAAI,IAAA;IACJ,IAAI,IAAA;IACJ,KAAK,IAAA;IACL,IAAI,IAAA;CACP;AAED,MAAM,WAAW,QAAQ;IACrB,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;CAC3B;AAED,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,MAAO,SAAQ,iBAAiB,CAAC,WAAW,CAAC;IAC1D,QAAQ,EAAE,QAAQ,CAAA;IAElB,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,SAAS,GAAG,EAAE,GAAG,IAAI,CAAA;CAC7E;AAED,qBAAa,UAAW,SAAQ,aAAa,CAAC,WAAW,CAAE,YAAW,MAAM;IAKrD,QAAQ,EAAE,QAAQ;IAJrC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAEjC;gBAEkB,QAAQ,GAAE,QAAyB;IAItD,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,SAAS,GAAG,EAAE,GAAG,IAAI;CAQ7E;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,qDASrB,CAAA;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAED,wBAAgB,GAAG,CACf,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,QAAQ,EACf,GAAG,QAAQ,EAAE,SAAS,GAAG,EAAE,GAC5B,IAAI,CAEN;AAED,wBAAgB,UAAU,CACtB,MAAM,EAAE,SAAS,EACjB,GAAG,QAAQ,EAAE,SAAS,GAAG,EAAE,GAC5B,IAAI,CAEN;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,QAAQ,EAAE,SAAS,GAAG,EAAE,GAAG,IAAI,CAE7E;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,QAAQ,EAAE,SAAS,GAAG,EAAE,GAAG,IAAI,CAE5E;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,QAAQ,EAAE,SAAS,GAAG,EAAE,GAAG,IAAI,CAE5E;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,QAAQ,EAAE,SAAS,GAAG,EAAE,GAAG,IAAI,CAE7E;AAWD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAE1D;AAWD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAE5D"}

package/dist/types/current/logging/Logger.js

@@ -0,0 +1,110 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { EventHostImpl } from '../event/EventHost';
+import { globalRef } from '../global/globalRegistry';
+import { toJson } from '../util/serialization/json';
+import { getLogLevelFromSearch } from '../logging/getLogLevelFromSearch';
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["VERBOSE"] = 0] = "VERBOSE";
+    LogLevel[LogLevel["DEBUG"] = 1] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 2] = "INFO";
+    LogLevel[LogLevel["WARN"] = 3] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 4] = "ERROR";
+    LogLevel[LogLevel["NONE"] = 5] = "NONE";
+})(LogLevel || (LogLevel = {}));
+export class LoggerImpl extends EventHostImpl {
+    logLevel;
+    get [Symbol.toStringTag]() {
+        return 'Logger';
+    }
+    constructor(logLevel = LogLevel.DEBUG) {
+        super();
+        this.logLevel = logLevel;
+    }
+    log(target, level, ...messages) {
+        if (level === LogLevel.NONE || level < this.logLevel)
+            return;
+        this.dispatch('log', {
+            level,
+            messages: toJson(messages),
+            target,
+        });
+    }
+}
+/**
+ * A global reference to the logger.
+ * @private
+ */
+export const loggerRef = globalRef(() => new LoggerImpl(
+// The logger is initialized to VERBOSE if vinylLogLevel=verbose is in the query string
+// Otherwise use DEBUG.
+getLogLevelFromSearch() === LogLevel.VERBOSE
+    ? LogLevel.VERBOSE
+    : LogLevel.DEBUG));
+/**
+ * Returns the current log level.
+ */
+export function getLogLevel() {
+    return loggerRef.value.logLevel;
+}
+/**
+ * Sets the current log level.
+ *
+ * @param value
+ */
+export function setLogLevel(value) {
+    loggerRef.value.logLevel = value;
+}
+export function log(target, level, ...messages) {
+    loggerRef.value.log(target, level, ...messages);
+}
+export function logVerbose(target, ...messages) {
+    loggerRef.value.log(target, LogLevel.VERBOSE, ...messages);
+}
+export function logDebug(target, ...messages) {
+    loggerRef.value.log(target, LogLevel.DEBUG, ...messages);
+}
+export function logInfo(target, ...messages) {
+    loggerRef.value.log(target, LogLevel.INFO, ...messages);
+}
+export function logWarn(target, ...messages) {
+    loggerRef.value.log(target, LogLevel.WARN, ...messages);
+}
+export function logError(target, ...messages) {
+    loggerRef.value.log(target, LogLevel.ERROR, ...messages);
+}
+const strToLogLevel = {
+    verbose: LogLevel.VERBOSE,
+    debug: LogLevel.DEBUG,
+    info: LogLevel.INFO,
+    warn: LogLevel.WARN,
+    error: LogLevel.ERROR,
+    none: LogLevel.NONE,
+};
+/**
+ * From a case-insensitive string, returns the log level.
+ * Possible values match to the keys in {@link LogLevel}.
+ *
+ * @param str
+ */
+export function parseLogLevel(str) {
+    return strToLogLevel[str.toLowerCase()] ?? null;
+}
+const logLevelToString = {
+    [LogLevel.VERBOSE]: 'verbose',
+    [LogLevel.DEBUG]: 'debug',
+    [LogLevel.INFO]: 'info',
+    [LogLevel.WARN]: 'warn',
+    [LogLevel.ERROR]: 'error',
+    [LogLevel.NONE]: 'none',
+};
+/**
+ * Returns the log level as a lowercase string.
+ * E.g. stringifyLogLevel(LogLevel.DEBUG) returns 'debug'
+ */
+export function stringifyLogLevel(logLevel) {
+    return logLevelToString[logLevel];
+}