@mnaoumov/typescript-lib 0.0.0 → 1.0.0

package/dist/lib/esm/error.d.mts

@@ -0,0 +1,181 @@
+/// <reference path="./library.d.mts" />
+/**
+ * @file
+ *
+ * Contains utility functions for error handling.
+ */
+/**
+ * A message of the AsyncWrapperError.
+ */
+export declare const ASYNC_WRAPPER_ERROR_MESSAGE = "An unhandled error occurred executing async operation";
+/**
+ * Parameters for the {@link CustomStackTraceError} constructor.
+ */
+export interface CustomStackTraceErrorConstructorParams {
+    /**
+     * The cause of the error.
+     */
+    readonly cause: unknown;
+    /**
+     * The message of the error.
+     */
+    readonly message: string;
+    /**
+     * The stack trace of the error.
+     */
+    readonly stackTrace: string;
+}
+/**
+ * An error that wraps an error with a custom stack trace.
+ */
+export declare class CustomStackTraceError extends Error {
+    /**
+     * Creates a new CustomStackTraceError.
+     *
+     * @param params - The parameters for the error.
+     */
+    constructor(params: CustomStackTraceErrorConstructorParams);
+}
+/**
+ * An error that wraps a non-`Error` value that was thrown, preserving the original value in `cause`.
+ */
+export declare class ErrorWrapper extends Error {
+    /**
+     * Creates a new ErrorWrapper.
+     *
+     * @param thrownValue - The original non-`Error` value that was thrown.
+     */
+    constructor(thrownValue: unknown);
+    /**
+     * Normalizes any thrown value to an `Error`.
+     *
+     * Returns the value unchanged if it is already an `Error`, otherwise wraps it in an {@link ErrorWrapper}.
+     *
+     * @param thrownValue - The thrown value to normalize.
+     * @returns An `Error` instance: the original value if it is already an `Error`, otherwise an {@link ErrorWrapper}.
+     */
+    static create(thrownValue: unknown): Error;
+}
+/**
+ * An error that is not printed to the console.
+ */
+export declare class SilentError extends Error {
+    /**
+     * Creates a new SilentError.
+     *
+     * @param message - The message of the error.
+     */
+    constructor(message: string);
+}
+/**
+ * Empties the collection window opened by {@link startCollectingUnhandledAsyncErrors} and returns what it
+ * held, leaving the window **open** so errors emitted afterwards keep being collected.
+ *
+ * This is what the test setup's (`@mnaoumov/typescript-test-toolkit/setup`) `beforeEach` / `afterEach` use, rather than
+ * {@link stopCollectingUnhandledAsyncErrors}: an async error emitted in the gap between two tests (e.g. by a
+ * `setTimeout` the test left pending) would otherwise land on a closed window and vanish unreported.
+ *
+ * @returns The unhandled async errors collected so far, or an empty array if no window is open.
+ */
+export declare function drainCollectedUnhandledAsyncErrors(): unknown[];
+/**
+ * Emits an asynchronous error event.
+ *
+ * When a collection window is open (see {@link startCollectingUnhandledAsyncErrors}) the error is
+ * collected as unhandled unless it is ignored — either because `shouldIgnore` is `true` or an
+ * {@link startAsyncErrorIgnoreContext} scope is active. A registered consumer handler deliberately does
+ * **not** exempt the error: in production it shows the user a Notice, which is not a test asserting that
+ * the error was expected. {@link startAsyncErrorIgnoreContext} is the single, explicit opt-out.
+ *
+ * @param asyncError - The error to emit as an asynchronous error event.
+ * @param shouldIgnore - Whether to treat the error as expected and never collect it as unhandled, regardless of the active ignore context. Used to carry the schedule-time ignore decision of a deferred fire-and-forget rejection.
+ */
+export declare function emitAsyncErrorEvent(asyncError: unknown, shouldIgnore?: boolean): void;
+/**
+ * Converts an error to a string representation, including nested causes and the aggregated errors of
+ * an `AggregateError`, with indentation.
+ *
+ * @param error - The error to convert to a string.
+ * @returns The string representation of the error.
+ */
+export declare function errorToString(error: unknown): string;
+/**
+ * Gets the current stack trace as a string, excluding the current function call.
+ *
+ * @param framesToSkip - The number of frames to skip in the stack trace.
+ * @returns A string representation of the current stack trace, excluding the current function call.
+ */
+export declare function getStackTrace(framesToSkip?: number): string;
+/**
+ * Checks whether an {@link startAsyncErrorIgnoreContext} scope is currently active.
+ *
+ * @returns `true` if at least one ignore context is active, `false` otherwise.
+ */
+export declare function isAsyncErrorIgnoreContextActive(): boolean;
+/**
+ * Prints an error to the console, including nested causes and optional ANSI sequence clearing.
+ *
+ * @param error - The error to print.
+ * @param console - The console to print to (default: `globalThis.console`).
+ */
+export declare function printError(error: unknown, console?: Console): void;
+/**
+ * Registers an event handler for asynchronous errors.
+ *
+ * Registering a handler does not mark the errors it receives as expected — see
+ * {@link emitAsyncErrorEvent}. A test that deliberately triggers an async error opens a
+ * {@link startAsyncErrorIgnoreContext} scope regardless of who is listening.
+ *
+ * @param handler - The handler function to be called when an asynchronous error event occurs.
+ * @returns A {@link Disposable} that unregisters the handler when disposed, for use with `using`.
+ */
+export declare function registerAsyncErrorEventHandler(handler: (asyncError: unknown) => void): Disposable;
+/**
+ * Opens an ignore context in which async errors are treated as expected rather than unhandled, so the
+ * test harness does not fail the test.
+ *
+ * While the returned disposable is held, an async error emitted directly (see
+ * {@link emitAsyncErrorEvent}) is not collected as unhandled. Crucially, a fire-and-forget operation
+ * scheduled within the scope (e.g. via {@link async!invokeAsyncSafely}) is also ignored when it later
+ * rejects — even after the scope has exited — because {@link async!addErrorHandler} captures the active
+ * ignore context at schedule time. A test therefore does not need to drain the operation itself:
+ *
+ * ```ts
+ * it('does not fail', () => {
+ *   using _ = startAsyncErrorIgnoreContext();
+ *   invokeAsyncSafely(() => Promise.reject(new Error('deliberately swallowed')));
+ * });
+ * ```
+ *
+ * Contexts nest; the ignore only ends once every open context has been disposed.
+ *
+ * @returns A {@link Disposable} that closes the ignore context when disposed, for use with `using`.
+ */
+export declare function startAsyncErrorIgnoreContext(): Disposable;
+/**
+ * Opens a window in which async errors emitted outside an ignore context are collected as unhandled
+ * (see {@link emitAsyncErrorEvent}), discarding anything collected by a previous window.
+ *
+ * Intended for the test harness only: the per-test setup opens a window before each test and empties it
+ * after each test via {@link drainCollectedUnhandledAsyncErrors}, closing it for good with
+ * {@link stopCollectingUnhandledAsyncErrors} once the file's last test has run. In production no window
+ * is open, so emitting an async error carries no bookkeeping overhead.
+ */
+export declare function startCollectingUnhandledAsyncErrors(): void;
+/**
+ * Closes the window opened by {@link startCollectingUnhandledAsyncErrors} and returns the unhandled
+ * async errors collected while it was open.
+ *
+ * Use {@link drainCollectedUnhandledAsyncErrors} instead wherever collection must continue afterwards —
+ * once the window is closed, a later async error is not collected by anyone.
+ *
+ * @returns The collected unhandled async errors, or an empty array if no window was open.
+ */
+export declare function stopCollectingUnhandledAsyncErrors(): unknown[];
+/**
+ * Throws an error with the specified message.
+ *
+ * @param error - The error to throw.
+ * @throws
+ */
+export declare function throwExpression(error: unknown): never;

package/dist/lib/esm/error.mjs

@@ -0,0 +1,248 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function () {
+function ensureDisposeSymbols(symbolConstructor = Symbol) {
+  symbolConstructor.asyncDispose ??= symbolConstructor.for('Symbol.asyncDispose');
+  symbolConstructor.dispose ??= symbolConstructor.for('Symbol.dispose');
+}
+
+function ensureBrowserProcess() {
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return '/';
+    },
+    env: {},
+    platform: 'android'
+  };
+
+  // eslint-disable-next-line obsidianmd/no-global-this, unicorn/no-unnecessary-global-this -- Must stay `globalThis`-qualified: in the emitted banner a bare `process` is a free identifier, so reading it where the host has none throws a ReferenceError instead of yielding `undefined`. That is the very case this function exists to handle.
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+    globalThis.process = browserProcess;
+    return;
+  }
+
+  if (existingProcess.versions?.node) {
+    return;
+  }
+
+  const existingProcessRecord = existingProcess;
+
+  for (const [key, value] of Object.entries(browserProcess)) {
+    existingProcessRecord[key] ??= value;
+  }
+
+  existingProcessRecord['browser'] = true;
+}
+
+(function initEsm() {
+  ensureDisposeSymbols();
+  ensureBrowserProcess();
+})();
+})();
+
+import { AsyncEvents } from "./async-events.mjs";
+import {
+  CallbackDisposable,
+  MultipleDisposeBehavior
+} from "./disposable.mjs";
+import { ensureNonNullable } from "./type-guards.mjs";
+const errorAsyncEvents = new AsyncEvents();
+errorAsyncEvents.on("asyncError", handleAsyncError);
+const moduleState = {
+  asyncErrorIgnoreContextDepth: 0,
+  collectedUnhandledAsyncErrors: null
+};
+const ASYNC_WRAPPER_ERROR_MESSAGE = "An unhandled error occurred executing async operation";
+const STACK_TRACE_PREFIX = "    at";
+const ERROR_HEADER_REG_EXP = /^\w*Error(?:: |$)/;
+const STACK_HEADER_PROBE_MESSAGE = "stack header probe";
+class CustomStackTraceError extends Error {
+  /**
+   * Creates a new CustomStackTraceError.
+   *
+   * @param params - The parameters for the error.
+   */
+  constructor(params) {
+    const { cause, message, stackTrace } = params;
+    super(message, { cause });
+    this.name = "CustomStackTraceError";
+    let rootCause = cause;
+    const parentCauses = /* @__PURE__ */ new Set();
+    while (rootCause instanceof CustomStackTraceError) {
+      if (parentCauses.has(rootCause)) {
+        throw new Error("Circular cause detected");
+      }
+      parentCauses.add(rootCause);
+      rootCause = rootCause.cause;
+    }
+    const stackLines = stackTrace.split("\n");
+    if (ERROR_HEADER_REG_EXP.test(ensureNonNullable(stackLines[0]))) {
+      stackLines.shift();
+    }
+    if (hasStackHeader()) {
+      stackLines.unshift(getErrorHeader(this));
+    }
+    this.stack = stackLines.join("\n");
+  }
+}
+class ErrorWrapper extends Error {
+  /**
+   * Creates a new ErrorWrapper.
+   *
+   * @param thrownValue - The original non-`Error` value that was thrown.
+   */
+  constructor(thrownValue) {
+    super(`A non-Error value was thrown: ${String(thrownValue)}`, { cause: thrownValue });
+    this.name = "ErrorWrapper";
+  }
+  /**
+   * Normalizes any thrown value to an `Error`.
+   *
+   * Returns the value unchanged if it is already an `Error`, otherwise wraps it in an {@link ErrorWrapper}.
+   *
+   * @param thrownValue - The thrown value to normalize.
+   * @returns An `Error` instance: the original value if it is already an `Error`, otherwise an {@link ErrorWrapper}.
+   */
+  static create(thrownValue) {
+    return thrownValue instanceof Error ? thrownValue : new ErrorWrapper(thrownValue);
+  }
+}
+class SilentError extends Error {
+  /**
+   * Creates a new SilentError.
+   *
+   * @param message - The message of the error.
+   */
+  constructor(message) {
+    super(message);
+    this.name = "SilentError";
+  }
+}
+function drainCollectedUnhandledAsyncErrors() {
+  return moduleState.collectedUnhandledAsyncErrors?.splice(0) ?? [];
+}
+function emitAsyncErrorEvent(asyncError, shouldIgnore = false) {
+  const isIgnored = shouldIgnore || moduleState.asyncErrorIgnoreContextDepth > 0;
+  if (moduleState.collectedUnhandledAsyncErrors && !isIgnored) {
+    moduleState.collectedUnhandledAsyncErrors.push(asyncError);
+  }
+  errorAsyncEvents.trigger("asyncError", asyncError);
+}
+function errorToString(error) {
+  return getErrorLines(error).map((line) => line.text).join("\n");
+}
+function getStackTrace(framesToSkip = 0) {
+  const GET_STACK_TRACE_FRAME_COUNT = 1;
+  const additionalLinesToSkip = GET_STACK_TRACE_FRAME_COUNT + (hasStackHeader() ? 1 : 0);
+  const stack = ensureNonNullable(new Error().stack);
+  const lines = stack.split("\n");
+  return lines.slice(framesToSkip + additionalLinesToSkip).join("\n");
+}
+function isAsyncErrorIgnoreContextActive() {
+  return moduleState.asyncErrorIgnoreContextDepth > 0;
+}
+function printError(error, console) {
+  console ??= globalThis.console;
+  console.error(errorToString(error));
+}
+function registerAsyncErrorEventHandler(handler) {
+  const eventRef = errorAsyncEvents.on("asyncError", handler);
+  return new CallbackDisposable({
+    callback: () => {
+      errorAsyncEvents.offref(eventRef);
+    },
+    multipleDisposeBehavior: MultipleDisposeBehavior.Ignore
+  });
+}
+function startAsyncErrorIgnoreContext() {
+  moduleState.asyncErrorIgnoreContextDepth++;
+  return new CallbackDisposable({
+    callback: () => {
+      moduleState.asyncErrorIgnoreContextDepth--;
+    },
+    multipleDisposeBehavior: MultipleDisposeBehavior.Ignore
+  });
+}
+function startCollectingUnhandledAsyncErrors() {
+  moduleState.collectedUnhandledAsyncErrors = [];
+}
+function stopCollectingUnhandledAsyncErrors() {
+  const collectedErrors = moduleState.collectedUnhandledAsyncErrors ?? [];
+  moduleState.collectedUnhandledAsyncErrors = null;
+  return collectedErrors;
+}
+function throwExpression(error) {
+  throw error;
+}
+function generateNestedErrorLines(nestedError, title) {
+  const lines = [toTitleLine(title), ...getErrorLines(nestedError).filter((line) => line.text.trim() !== "")];
+  return lines.map((line) => line.isFrame ? line : { isFrame: true, text: generateStackTraceLine(line.text) });
+}
+function generateStackTraceLine(title) {
+  return `${STACK_TRACE_PREFIX} --- ${title} --- (0)`;
+}
+function getErrorHeader(error) {
+  return error.message ? `${error.name}: ${error.message}` : error.name;
+}
+function getErrorLines(error) {
+  if (!(error instanceof Error)) {
+    return String(error).split("\n").map((text) => toTitleLine(text));
+  }
+  const lines = getOwnErrorLines(error);
+  if (error.cause !== void 0) {
+    lines.push(...generateNestedErrorLines(error.cause, "Caused by:"));
+  }
+  if (error instanceof AggregateError) {
+    const aggregatedErrors = error.errors;
+    for (const [index, aggregatedError] of aggregatedErrors.entries()) {
+      lines.push(...generateNestedErrorLines(aggregatedError, `Aggregated error #${String(index + 1)}:`));
+    }
+  }
+  return lines;
+}
+function getOwnErrorLines(error) {
+  const headerLines = getErrorHeader(error).split("\n").map((text) => toTitleLine(text));
+  if (error.stack === void 0) {
+    return headerLines;
+  }
+  const stackLines = error.stack.split("\n");
+  if (hasStackHeader()) {
+    return stackLines.map((text) => ({ isFrame: text.startsWith(STACK_TRACE_PREFIX), text }));
+  }
+  return [...headerLines, ...stackLines.filter((text) => text.trim() !== "").map((text) => ({ isFrame: true, text }))];
+}
+function handleAsyncError(asyncError) {
+  printError(asyncError);
+}
+function hasStackHeader() {
+  const firstLine = new Error(STACK_HEADER_PROBE_MESSAGE).stack?.split("\n", 1)[0];
+  return firstLine === `Error: ${STACK_HEADER_PROBE_MESSAGE}`;
+}
+function toTitleLine(text) {
+  return { isFrame: false, text };
+}
+export {
+  ASYNC_WRAPPER_ERROR_MESSAGE,
+  CustomStackTraceError,
+  ErrorWrapper,
+  SilentError,
+  drainCollectedUnhandledAsyncErrors,
+  emitAsyncErrorEvent,
+  errorToString,
+  getStackTrace,
+  isAsyncErrorIgnoreContextActive,
+  printError,
+  registerAsyncErrorEventHandler,
+  startAsyncErrorIgnoreContext,
+  startCollectingUnhandledAsyncErrors,
+  stopCollectingUnhandledAsyncErrors,
+  throwExpression
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2Vycm9yLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogQ29udGFpbnMgdXRpbGl0eSBmdW5jdGlvbnMgZm9yIGVycm9yIGhhbmRsaW5nLlxuICovXG5cbmltcG9ydCB7IEFzeW5jRXZlbnRzIH0gZnJvbSAnLi9hc3luYy1ldmVudHMudHMnO1xuaW1wb3J0IHtcbiAgQ2FsbGJhY2tEaXNwb3NhYmxlLFxuICBNdWx0aXBsZURpc3Bvc2VCZWhhdmlvclxufSBmcm9tICcuL2Rpc3Bvc2FibGUudHMnO1xuaW1wb3J0IHsgZW5zdXJlTm9uTnVsbGFibGUgfSBmcm9tICcuL3R5cGUtZ3VhcmRzLnRzJztcblxuaW50ZXJmYWNlIEVycm9yQXN5bmNFdmVudE1hcCB7XG4gIGFzeW5jRXJyb3I6IFtlcnJvcjogdW5rbm93bl07XG59XG5cbmNvbnN0IGVycm9yQXN5bmNFdmVudHMgPSBuZXcgQXN5bmNFdmVudHM8RXJyb3JBc3luY0V2ZW50TWFwPigpO1xuLy8gZXNsaW50LWRpc2FibGUtbmV4dC1saW5lIHVuaWNvcm4vbm8tdG9wLWxldmVsLXNpZGUtZWZmZWN0cyAtLSBJbnN0YWxsaW5nIHRoZSBkZWZhdWx0IGhhbmRsZXIgb24gaW1wb3J0IGlzIHdoYXQgdGhpcyBtb2R1bGUgaXMgZm9yLiBEZWZlcnJpbmcgaXQgYmVoaW5kIGEgY2FsbCB3b3VsZCBtZWFuIGV2ZXJ5IGNvbnN1bWVyIGhhZCB0byByZW1lbWJlciB0byBtYWtlIHRoYXQgY2FsbCBiZWZvcmUgdGhlIGZpcnN0IGFzeW5jIGVycm9yLCB3aGljaCBpcyBwcmVjaXNlbHkgdGhlIG1vbWVudCB0aGUgaGFuZGxlciBuZWVkcyB0byBhbHJlYWR5IGV4aXN0LlxuZXJyb3JBc3luY0V2ZW50cy5vbignYXN5bmNFcnJvcicsIGhhbmRsZUFzeW5jRXJyb3IpO1xuXG5pbnRlcmZhY2UgTW9kdWxlU3RhdGUge1xuICAvKipcbiAgICogVGhlIG5lc3RpbmcgZGVwdGggb2YgYWN0aXZlIHtAbGluayBzdGFydEFzeW5jRXJyb3JJZ25vcmVDb250ZXh0fSBzY29wZXMuIFdoaWxlIGdyZWF0ZXIgdGhhbiBgMGAsIGFuXG4gICAqIGFzeW5jIGVycm9yIGVtaXR0ZWQgKG9yIGEgZmlyZS1hbmQtZm9yZ2V0IG9wZXJhdGlvbiB3aG9zZSByZWplY3Rpb24gd2FzIGNhcHR1cmVkKSB3aXRoaW4gdGhlIHNjb3BlIGlzXG4gICAqIHRyZWF0ZWQgYXMgZXhwZWN0ZWQgYW5kIG5vdCBjb2xsZWN0ZWQgYXMgdW5oYW5kbGVkLlxuICAgKi9cbiAgYXN5bmNFcnJvcklnbm9yZUNvbnRleHREZXB0aDogbnVtYmVyO1xuXG4gIC8qKlxuICAgKiBUaGUgYnVmZmVyIHRoYXQgY29sbGVjdHMgdW5oYW5kbGVkIGFzeW5jIGVycm9ycyB3aGlsZSBhIGNvbGxlY3Rpb24gd2luZG93IGlzIG9wZW4sIG9yIGBudWxsYCB3aGVuXG4gICAqIG5vIHdpbmRvdyBpcyBvcGVuICh0aGUgZGVmYXVsdCBpbiBwcm9kdWN0aW9uKS4gT3BlbmVkIGJ5IHtAbGluayBzdGFydENvbGxlY3RpbmdVbmhhbmRsZWRBc3luY0Vycm9yc30sXG4gICAqIGVtcHRpZWQgd2l0aG91dCBjbG9zaW5nIGJ5IHtAbGluayBkcmFpbkNvbGxlY3RlZFVuaGFuZGxlZEFzeW5jRXJyb3JzfSwgYW5kIGRyYWluZWQtYW5kLWNsb3NlZCBieVxuICAgKiB7QGxpbmsgc3RvcENvbGxlY3RpbmdVbmhhbmRsZWRBc3luY0Vycm9yc30gXHUyMDE0IHVzZWQgYnkgdGhlIHRlc3QgaGFybmVzcyB0byBmYWlsIGEgdGVzdCB0aGF0IHN3YWxsb3dlZFxuICAgKiBhbiBhc3luYyBlcnJvci5cbiAgICovXG4gIGNvbGxlY3RlZFVuaGFuZGxlZEFzeW5jRXJyb3JzOiBudWxsIHwgdW5rbm93bltdO1xufVxuXG4vKipcbk1vZHVsZS1sZXZlbCBtdXRhYmxlIHN0YXRlLCBoZWxkIGluIG9uZSBvYmplY3Qgc28gZWFjaCBtdXRhdGlvbiBuYW1lcyBpdCBleHBsaWNpdGx5LlxuICovXG5jb25zdCBtb2R1bGVTdGF0ZTogTW9kdWxlU3RhdGUgPSB7XG4gIGFzeW5jRXJyb3JJZ25vcmVDb250ZXh0RGVwdGg6IDAsXG4gIGNvbGxlY3RlZFVuaGFuZGxlZEFzeW5jRXJyb3JzOiBudWxsXG59O1xuLyoqXG4gKiBBIG1lc3NhZ2Ugb2YgdGhlIEFzeW5jV3JhcHBlckVycm9yLlxuICovXG5leHBvcnQgY29uc3QgQVNZTkNfV1JBUFBFUl9FUlJPUl9NRVNTQUdFID0gJ0FuIHVuaGFuZGxlZCBlcnJvciBvY2N1cnJlZCBleGVjdXRpbmcgYXN5bmMgb3BlcmF0aW9uJztcblxuY29uc3QgU1RBQ0tfVFJBQ0VfUFJFRklYID0gJyAgICBhdCc7XG5cbmNvbnN0IEVSUk9SX0hFQURFUl9SRUdfRVhQID0gL15cXHcqRXJyb3IoPzo6IHwkKS87XG5cbmNvbnN0IFNUQUNLX0hFQURFUl9QUk9CRV9NRVNTQUdFID0gJ3N0YWNrIGhlYWRlciBwcm9iZSc7XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3IgdGhlIHtAbGluayBDdXN0b21TdGFja1RyYWNlRXJyb3J9IGNvbnN0cnVjdG9yLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIEN1c3RvbVN0YWNrVHJhY2VFcnJvckNvbnN0cnVjdG9yUGFyYW1zIHtcbiAgLyoqXG4gICAqIFRoZSBjYXVzZSBvZiB0aGUgZXJyb3IuXG4gICAqL1xuICByZWFkb25seSBjYXVzZTogdW5rbm93bjtcblxuICAvKipcbiAgICogVGhlIG1lc3NhZ2Ugb2YgdGhlIGVycm9yLlxuICAgKi9cbiAgcmVhZG9ubHkgbWVzc2FnZTogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgc3RhY2sgdHJhY2Ugb2YgdGhlIGVycm9yLlxuICAgKi9cbiAgcmVhZG9ubHkgc3RhY2tUcmFjZTogc3RyaW5nO1xufVxuXG4vKipcbiAqIE9uZSBsaW5lIG9mIGFuIGVycm9yJ3Mgc3RyaW5nIGZvcm0sIHRhZ2dlZCB3aXRoIHdoZXRoZXIgaXQgaXMgYSBzdGFjayBmcmFtZS5cbiAqXG4gKiBBIHRpdGxlIChhbiBlcnJvciBoZWFkZXIsIGEgYENhdXNlZCBieTpgIG1hcmtlciwgYSBsaW5lIG9mIGEgbXVsdGktbGluZSBtZXNzYWdlKSBpcyB3cmFwcGVkIGludG9cbiAqIHtAbGluayBnZW5lcmF0ZVN0YWNrVHJhY2VMaW5lfSdzIGZvcm0gd2hlbiB0aGUgZXJyb3IgaXQgYmVsb25ncyB0byBpcyBuZXN0ZWQ7IGEgZnJhbWUgaXMga2VwdCB2ZXJiYXRpbS5cbiAqL1xuaW50ZXJmYWNlIEVycm9yTGluZSB7XG4gIHJlYWRvbmx5IGlzRnJhbWU6IGJvb2xlYW47XG4gIHJlYWRvbmx5IHRleHQ6IHN0cmluZztcbn1cblxuLyoqXG4gKiBBbiBlcnJvciB0aGF0IHdyYXBzIGFuIGVycm9yIHdpdGggYSBjdXN0b20gc3RhY2sgdHJhY2UuXG4gKi9cbmV4cG9ydCBjbGFzcyBDdXN0b21TdGFja1RyYWNlRXJyb3IgZXh0ZW5kcyBFcnJvciB7XG4gIC8qKlxuICAgKiBDcmVhdGVzIGEgbmV3IEN1c3RvbVN0YWNrVHJhY2VFcnJvci5cbiAgICpcbiAgICogQHBhcmFtIHBhcmFtcyAtIFRoZSBwYXJhbWV0ZXJzIGZvciB0aGUgZXJyb3IuXG4gICAqL1xuICBwdWJsaWMgY29uc3RydWN0b3IocGFyYW1zOiBDdXN0b21TdGFja1RyYWNlRXJyb3JDb25zdHJ1Y3RvclBhcmFtcykge1xuICAgIGNvbnN0IHsgY2F1c2UsIG1lc3NhZ2UsIHN0YWNrVHJhY2UgfSA9IHBhcmFtcztcbiAgICBzdXBlcihtZXNzYWdlLCB7IGNhdXNlIH0pO1xuICAgIHRoaXMubmFtZSA9ICdDdXN0b21TdGFja1RyYWNlRXJyb3InO1xuXG4gICAgbGV0IHJvb3RDYXVzZSA9IGNhdXNlO1xuICAgIGNvbnN0IHBhcmVudENhdXNlcyA9IG5ldyBTZXQ8Q3VzdG9tU3RhY2tUcmFjZUVycm9yPigpO1xuICAgIHdoaWxlIChyb290Q2F1c2UgaW5zdGFuY2VvZiBDdXN0b21TdGFja1RyYWNlRXJyb3IpIHtcbiAgICAgIGlmIChwYXJlbnRDYXVzZXMuaGFzKHJvb3RDYXVzZSkpIHtcbiAgICAgICAgdGhyb3cgbmV3IEVycm9yKCdDaXJjdWxhciBjYXVzZSBkZXRlY3RlZCcpO1xuICAgICAgfVxuICAgICAgcGFyZW50Q2F1c2VzLmFkZChyb290Q2F1c2UpO1xuICAgICAgcm9vdENhdXNlID0gcm9vdENhdXNlLmNhdXNlO1xuICAgIH1cblxuICAgIGNvbnN0IHN0YWNrTGluZXMgPSBzdGFja1RyYWNlLnNwbGl0KCdcXG4nKTtcbiAgICBpZiAoRVJST1JfSEVBREVSX1JFR19FWFAudGVzdChlbnN1cmVOb25OdWxsYWJsZShzdGFja0xpbmVzWzBdKSkpIHtcbiAgICAgIHN0YWNrTGluZXMuc2hpZnQoKTtcbiAgICB9XG4gICAgLy8gS2VlcCB0aGUgZW5naW5lJ3Mgb3duIGAuc3RhY2tgIHNoYXBlOiBhIGhlYWRlciBvbmx5IHdoZXJlIHRoZSBlbmdpbmUgd3JpdGVzIG9uZSAoVjgpLCBmcmFtZXMgb25seSB3aGVyZSBpdCBkb2VzIG5vdCAoSmF2YVNjcmlwdENvcmUsIFNwaWRlck1vbmtleSkuXG4gICAgaWYgKGhhc1N0YWNrSGVhZGVyKCkpIHtcbiAgICAgIHN0YWNrTGluZXMudW5zaGlmdChnZXRFcnJvckhlYWRlcih0aGlzKSk7XG4gICAgfVxuICAgIHRoaXMuc3RhY2sgPSBzdGFja0xpbmVzLmpvaW4oJ1xcbicpO1xuICB9XG59XG5cbi8qKlxuICogQW4gZXJyb3IgdGhhdCB3cmFwcyBhIG5vbi1gRXJyb3JgIHZhbHVlIHRoYXQgd2FzIHRocm93biwgcHJlc2VydmluZyB0aGUgb3JpZ2luYWwgdmFsdWUgaW4gYGNhdXNlYC5cbiAqL1xuZXhwb3J0IGNsYXNzIEVycm9yV3JhcHBlciBleHRlbmRzIEVycm9yIHtcbiAgLyoqXG4gICAqIENyZWF0ZXMgYSBuZXcgRXJyb3JXcmFwcGVyLlxuICAgKlxuICAgKiBAcGFyYW0gdGhyb3duVmFsdWUgLSBUaGUgb3JpZ2luYWwgbm9uLWBFcnJvcmAgdmFsdWUgdGhhdCB3YXMgdGhyb3duLlxuICAgKi9cbiAgcHVibGljIGNvbnN0cnVjdG9yKHRocm93blZhbHVlOiB1bmtub3duKSB7XG4gICAgc3VwZXIoYEEgbm9uLUVycm9yIHZhbHVlIHdhcyB0aHJvd246ICR7U3RyaW5nKHRocm93blZhbHVlKX1gLCB7IGNhdXNlOiB0aHJvd25WYWx1ZSB9KTtcbiAgICB0aGlzLm5hbWUgPSAnRXJyb3JXcmFwcGVyJztcbiAgfVxuXG4gIC8qKlxuICAgKiBOb3JtYWxpemVzIGFueSB0aHJvd24gdmFsdWUgdG8gYW4gYEVycm9yYC5cbiAgICpcbiAgICogUmV0dXJucyB0aGUgdmFsdWUgdW5jaGFuZ2VkIGlmIGl0IGlzIGFscmVhZHkgYW4gYEVycm9yYCwgb3RoZXJ3aXNlIHdyYXBzIGl0IGluIGFuIHtAbGluayBFcnJvcldyYXBwZXJ9LlxuICAgKlxuICAgKiBAcGFyYW0gdGhyb3duVmFsdWUgLSBUaGUgdGhyb3duIHZhbHVlIHRvIG5vcm1hbGl6ZS5cbiAgICogQHJldHVybnMgQW4gYEVycm9yYCBpbnN0YW5jZTogdGhlIG9yaWdpbmFsIHZhbHVlIGlmIGl0IGlzIGFscmVhZHkgYW4gYEVycm9yYCwgb3RoZXJ3aXNlIGFuIHtAbGluayBFcnJvcldyYXBwZXJ9LlxuICAgKi9cbiAgcHVibGljIHN0YXRpYyBjcmVhdGUodGhyb3duVmFsdWU6IHVua25vd24pOiBFcnJvciB7XG4gICAgcmV0dXJuIHRocm93blZhbHVlIGluc3RhbmNlb2YgRXJyb3IgPyB0aHJvd25WYWx1ZSA6IG5ldyBFcnJvcldyYXBwZXIodGhyb3duVmFsdWUpO1xuICB9XG59XG5cbi8qKlxuICogQW4gZXJyb3IgdGhhdCBpcyBub3QgcHJpbnRlZCB0byB0aGUgY29uc29sZS5cbiAqL1xuZXhwb3J0IGNsYXNzIFNpbGVudEVycm9yIGV4dGVuZHMgRXJyb3Ige1xuICAvKipcbiAgICogQ3JlYXRlcyBhIG5ldyBTaWxlbnRFcnJvci5cbiAgICpcbiAgICogQHBhcmFtIG1lc3NhZ2UgLSBUaGUgbWVzc2FnZSBvZiB0aGUgZXJyb3IuXG4gICAqL1xuICBwdWJsaWMgY29uc3RydWN0b3IobWVzc2FnZTogc3RyaW5nKSB7XG4gICAgc3VwZXIobWVzc2FnZSk7XG4gICAgdGhpcy5uYW1lID0gJ1NpbGVudEVycm9yJztcbiAgfVxufVxuXG4vKipcbiAqIEVtcHRpZXMgdGhlIGNvbGxlY3Rpb24gd2luZG93IG9wZW5lZCBieSB7QGxpbmsgc3RhcnRDb2xsZWN0aW5nVW5oYW5kbGVkQXN5bmNFcnJvcnN9IGFuZCByZXR1cm5zIHdoYXQgaXRcbiAqIGhlbGQsIGxlYXZpbmcgdGhlIHdpbmRvdyAqKm9wZW4qKiBzbyBlcnJvcnMgZW1pdHRlZCBhZnRlcndhcmRzIGtlZXAgYmVpbmcgY29sbGVjdGVkLlxuICpcbiAqIFRoaXMgaXMgd2hhdCB0aGUgdGVzdCBzZXR1cCdzIChgQG1uYW91bW92L3R5cGVzY3JpcHQtdGVzdC10b29sa2l0L3NldHVwYCkgYGJlZm9yZUVhY2hgIC8gYGFmdGVyRWFjaGAgdXNlLCByYXRoZXIgdGhhblxuICoge0BsaW5rIHN0b3BDb2xsZWN0aW5nVW5oYW5kbGVkQXN5bmNFcnJvcnN9OiBhbiBhc3luYyBlcnJvciBlbWl0dGVkIGluIHRoZSBnYXAgYmV0d2VlbiB0d28gdGVzdHMgKGUuZy4gYnkgYVxuICogYHNldFRpbWVvdXRgIHRoZSB0ZXN0IGxlZnQgcGVuZGluZykgd291bGQgb3RoZXJ3aXNlIGxhbmQgb24gYSBjbG9zZWQgd2luZG93IGFuZCB2YW5pc2ggdW5yZXBvcnRlZC5cbiAqXG4gKiBAcmV0dXJucyBUaGUgdW5oYW5kbGVkIGFzeW5jIGVycm9ycyBjb2xsZWN0ZWQgc28gZmFyLCBvciBhbiBlbXB0eSBhcnJheSBpZiBubyB3aW5kb3cgaXMgb3Blbi5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGRyYWluQ29sbGVjdGVkVW5oYW5kbGVkQXN5bmNFcnJvcnMoKTogdW5rbm93bltdIHtcbiAgcmV0dXJuIG1vZHVsZVN0YXRlLmNvbGxlY3RlZFVuaGFuZGxlZEFzeW5jRXJyb3JzPy5zcGxpY2UoMCkgPz8gW107XG59XG5cbi8qKlxuICogRW1pdHMgYW4gYXN5bmNocm9ub3VzIGVycm9yIGV2ZW50LlxuICpcbiAqIFdoZW4gYSBjb2xsZWN0aW9uIHdpbmRvdyBpcyBvcGVuIChzZWUge0BsaW5rIHN0YXJ0Q29sbGVjdGluZ1VuaGFuZGxlZEFzeW5jRXJyb3JzfSkgdGhlIGVycm9yIGlzXG4gKiBjb2xsZWN0ZWQgYXMgdW5oYW5kbGVkIHVubGVzcyBpdCBpcyBpZ25vcmVkIFx1MjAxNCBlaXRoZXIgYmVjYXVzZSBgc2hvdWxkSWdub3JlYCBpcyBgdHJ1ZWAgb3IgYW5cbiAqIHtAbGluayBzdGFydEFzeW5jRXJyb3JJZ25vcmVDb250ZXh0fSBzY29wZSBpcyBhY3RpdmUuIEEgcmVnaXN0ZXJlZCBjb25zdW1lciBoYW5kbGVyIGRlbGliZXJhdGVseSBkb2VzXG4gKiAqKm5vdCoqIGV4ZW1wdCB0aGUgZXJyb3I6IGluIHByb2R1Y3Rpb24gaXQgc2hvd3MgdGhlIHVzZXIgYSBOb3RpY2UsIHdoaWNoIGlzIG5vdCBhIHRlc3QgYXNzZXJ0aW5nIHRoYXRcbiAqIHRoZSBlcnJvciB3YXMgZXhwZWN0ZWQuIHtAbGluayBzdGFydEFzeW5jRXJyb3JJZ25vcmVDb250ZXh0fSBpcyB0aGUgc2luZ2xlLCBleHBsaWNpdCBvcHQtb3V0LlxuICpcbiAqIEBwYXJhbSBhc3luY0Vycm9yIC0gVGhlIGVycm9yIHRvIGVtaXQgYXMgYW4gYXN5bmNocm9ub3VzIGVycm9yIGV2ZW50LlxuICogQHBhcmFtIHNob3VsZElnbm9yZSAtIFdoZXRoZXIgdG8gdHJlYXQgdGhlIGVycm9yIGFzIGV4cGVjdGVkIGFuZCBuZXZlciBjb2xsZWN0IGl0IGFzIHVuaGFuZGxlZCwgcmVnYXJkbGVzcyBvZiB0aGUgYWN0aXZlIGlnbm9yZSBjb250ZXh0LiBVc2VkIHRvIGNhcnJ5IHRoZSBzY2hlZHVsZS10aW1lIGlnbm9yZSBkZWNpc2lvbiBvZiBhIGRlZmVycmVkIGZpcmUtYW5kLWZvcmdldCByZWplY3Rpb24uXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBlbWl0QXN5bmNFcnJvckV2ZW50KGFzeW5jRXJyb3I6IHVua25vd24sIHNob3VsZElnbm9yZSA9IGZhbHNlKTogdm9pZCB7XG4gIGNvbnN0IGlzSWdub3JlZCA9IHNob3VsZElnbm9yZSB8fCBtb2R1bGVTdGF0ZS5hc3luY0Vycm9ySWdub3JlQ29udGV4dERlcHRoID4gMDtcbiAgaWYgKG1vZHVsZVN0YXRlLmNvbGxlY3RlZFVuaGFuZGxlZEFzeW5jRXJyb3JzICYmICFpc0lnbm9yZWQpIHtcbiAgICBtb2R1bGVTdGF0ZS5jb2xsZWN0ZWRVbmhhbmRsZWRBc3luY0Vycm9ycy5wdXNoKGFzeW5jRXJyb3IpO1xuICB9XG4gIGVycm9yQXN5bmNFdmVudHMudHJpZ2dlcignYXN5bmNFcnJvcicsIGFzeW5jRXJyb3IpO1xufVxuXG4vKipcbiAqIENvbnZlcnRzIGFuIGVycm9yIHRvIGEgc3RyaW5nIHJlcHJlc2VudGF0aW9uLCBpbmNsdWRpbmcgbmVzdGVkIGNhdXNlcyBhbmQgdGhlIGFnZ3JlZ2F0ZWQgZXJyb3JzIG9mXG4gKiBhbiBgQWdncmVnYXRlRXJyb3JgLCB3aXRoIGluZGVudGF0aW9uLlxuICpcbiAqIEBwYXJhbSBlcnJvciAtIFRoZSBlcnJvciB0byBjb252ZXJ0IHRvIGEgc3RyaW5nLlxuICogQHJldHVybnMgVGhlIHN0cmluZyByZXByZXNlbnRhdGlvbiBvZiB0aGUgZXJyb3IuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBlcnJvclRvU3RyaW5nKGVycm9yOiB1bmtub3duKTogc3RyaW5nIHtcbiAgcmV0dXJuIGdldEVycm9yTGluZXMoZXJyb3IpLm1hcCgobGluZSkgPT4gbGluZS50ZXh0KS5qb2luKCdcXG4nKTtcbn1cblxuLyoqXG4gKiBHZXRzIHRoZSBjdXJyZW50IHN0YWNrIHRyYWNlIGFzIGEgc3RyaW5nLCBleGNsdWRpbmcgdGhlIGN1cnJlbnQgZnVuY3Rpb24gY2FsbC5cbiAqXG4gKiBAcGFyYW0gZnJhbWVzVG9Ta2lwIC0gVGhlIG51bWJlciBvZiBmcmFtZXMgdG8gc2tpcCBpbiB0aGUgc3RhY2sgdHJhY2UuXG4gKiBAcmV0dXJucyBBIHN0cmluZyByZXByZXNlbnRhdGlvbiBvZiB0aGUgY3VycmVudCBzdGFjayB0cmFjZSwgZXhjbHVkaW5nIHRoZSBjdXJyZW50IGZ1bmN0aW9uIGNhbGwuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBnZXRTdGFja1RyYWNlKGZyYW1lc1RvU2tpcCA9IDApOiBzdHJpbmcge1xuICAvLyBTa2lwcGluZyB0aGUgYGdldFN0YWNrVHJhY2VgIGZyYW1lIGl0c2VsZiwgcGx1cyB0aGUgYEVycm9yYCBoZWFkZXIgbGluZSBvbiBhbiBlbmdpbmUgdGhhdCB3cml0ZXMgb25lLlxuICBjb25zdCBHRVRfU1RBQ0tfVFJBQ0VfRlJBTUVfQ09VTlQgPSAxO1xuICBjb25zdCBhZGRpdGlvbmFsTGluZXNUb1NraXAgPSBHRVRfU1RBQ0tfVFJBQ0VfRlJBTUVfQ09VTlQgKyAoaGFzU3RhY2tIZWFkZXIoKSA/IDEgOiAwKTtcbiAgY29uc3Qgc3RhY2sgPSBlbnN1cmVOb25OdWxsYWJsZShuZXcgRXJyb3IoKS5zdGFjayk7XG4gIGNvbnN0IGxpbmVzID0gc3RhY2suc3BsaXQoJ1xcbicpO1xuICByZXR1cm4gbGluZXMuc2xpY2UoZnJhbWVzVG9Ta2lwICsgYWRkaXRpb25hbExpbmVzVG9Ta2lwKS5qb2luKCdcXG4nKTtcbn1cblxuLyoqXG4gKiBDaGVja3Mgd2hldGhlciBhbiB7QGxpbmsgc3RhcnRBc3luY0Vycm9ySWdub3JlQ29udGV4dH0gc2NvcGUgaXMgY3VycmVudGx5IGFjdGl2ZS5cbiAqXG4gKiBAcmV0dXJucyBgdHJ1ZWAgaWYgYXQgbGVhc3Qgb25lIGlnbm9yZSBjb250ZXh0IGlzIGFjdGl2ZSwgYGZhbHNlYCBvdGhlcndpc2UuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBpc0FzeW5jRXJyb3JJZ25vcmVDb250ZXh0QWN0aXZlKCk6IGJvb2xlYW4ge1xuICByZXR1cm4gbW9kdWxlU3RhdGUuYXN5bmNFcnJvcklnbm9yZUNvbnRleHREZXB0aCA+IDA7XG59XG5cbi8qKlxuICogUHJpbnRzIGFuIGVycm9yIHRvIHRoZSBjb25zb2xlLCBpbmNsdWRpbmcgbmVzdGVkIGNhdXNlcyBhbmQgb3B0aW9uYWwgQU5TSSBzZXF1ZW5jZSBjbGVhcmluZy5cbiAqXG4gKiBAcGFyYW0gZXJyb3IgLSBUaGUgZXJyb3IgdG8gcHJpbnQuXG4gKiBAcGFyYW0gY29uc29sZSAtIFRoZSBjb25zb2xlIHRvIHByaW50IHRvIChkZWZhdWx0OiBgZ2xvYmFsVGhpcy5jb25zb2xlYCkuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBwcmludEVycm9yKGVycm9yOiB1bmtub3duLCBjb25zb2xlPzogQ29uc29sZSk6IHZvaWQge1xuICAvLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgb2JzaWRpYW5tZC9uby1nbG9iYWwtdGhpcyAtLSBBY3RpdmVseSB1c2UgZ2xvYmFsVGhpcy5cbiAgY29uc29sZSA/Pz0gZ2xvYmFsVGhpcy5jb25zb2xlO1xuICBjb25zb2xlLmVycm9yKGVycm9yVG9TdHJpbmcoZXJyb3IpKTtcbn1cblxuLyoqXG4gKiBSZWdpc3RlcnMgYW4gZXZlbnQgaGFuZGxlciBmb3IgYXN5bmNocm9ub3VzIGVycm9ycy5cbiAqXG4gKiBSZWdpc3RlcmluZyBhIGhhbmRsZXIgZG9lcyBub3QgbWFyayB0aGUgZXJyb3JzIGl0IHJlY2VpdmVzIGFzIGV4cGVjdGVkIFx1MjAxNCBzZWVcbiAqIHtAbGluayBlbWl0QXN5bmNFcnJvckV2ZW50fS4gQSB0ZXN0IHRoYXQgZGVsaWJlcmF0ZWx5IHRyaWdnZXJzIGFuIGFzeW5jIGVycm9yIG9wZW5zIGFcbiAqIHtAbGluayBzdGFydEFzeW5jRXJyb3JJZ25vcmVDb250ZXh0fSBzY29wZSByZWdhcmRsZXNzIG9mIHdobyBpcyBsaXN0ZW5pbmcuXG4gKlxuICogQHBhcmFtIGhhbmRsZXIgLSBUaGUgaGFuZGxlciBmdW5jdGlvbiB0byBiZSBjYWxsZWQgd2hlbiBhbiBhc3luY2hyb25vdXMgZXJyb3IgZXZlbnQgb2NjdXJzLlxuICogQHJldHVybnMgQSB7QGxpbmsgRGlzcG9zYWJsZX0gdGhhdCB1bnJlZ2lzdGVycyB0aGUgaGFuZGxlciB3aGVuIGRpc3Bvc2VkLCBmb3IgdXNlIHdpdGggYHVzaW5nYC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHJlZ2lzdGVyQXN5bmNFcnJvckV2ZW50SGFuZGxlcihoYW5kbGVyOiAoYXN5bmNFcnJvcjogdW5rbm93bikgPT4gdm9pZCk6IERpc3Bvc2FibGUge1xuICBjb25zdCBldmVudFJlZiA9IGVycm9yQXN5bmNFdmVudHMub24oJ2FzeW5jRXJyb3InLCBoYW5kbGVyKTtcbiAgcmV0dXJuIG5ldyBDYWxsYmFja0Rpc3Bvc2FibGUoe1xuICAgIGNhbGxiYWNrOiAoKTogdm9pZCA9PiB7XG4gICAgICBlcnJvckFzeW5jRXZlbnRzLm9mZnJlZihldmVudFJlZik7XG4gICAgfSxcbiAgICBtdWx0aXBsZURpc3Bvc2VCZWhhdmlvcjogTXVsdGlwbGVEaXNwb3NlQmVoYXZpb3IuSWdub3JlXG4gIH0pO1xufVxuXG4vKipcbiAqIE9wZW5zIGFuIGlnbm9yZSBjb250ZXh0IGluIHdoaWNoIGFzeW5jIGVycm9ycyBhcmUgdHJlYXRlZCBhcyBleHBlY3RlZCByYXRoZXIgdGhhbiB1bmhhbmRsZWQsIHNvIHRoZVxuICogdGVzdCBoYXJuZXNzIGRvZXMgbm90IGZhaWwgdGhlIHRlc3QuXG4gKlxuICogV2hpbGUgdGhlIHJldHVybmVkIGRpc3Bvc2FibGUgaXMgaGVsZCwgYW4gYXN5bmMgZXJyb3IgZW1pdHRlZCBkaXJlY3RseSAoc2VlXG4gKiB7QGxpbmsgZW1pdEFzeW5jRXJyb3JFdmVudH0pIGlzIG5vdCBjb2xsZWN0ZWQgYXMgdW5oYW5kbGVkLiBDcnVjaWFsbHksIGEgZmlyZS1hbmQtZm9yZ2V0IG9wZXJhdGlvblxuICogc2NoZWR1bGVkIHdpdGhpbiB0aGUgc2NvcGUgKGUuZy4gdmlhIHtAbGluayBhc3luYyFpbnZva2VBc3luY1NhZmVseX0pIGlzIGFsc28gaWdub3JlZCB3aGVuIGl0IGxhdGVyXG4gKiByZWplY3RzIFx1MjAxNCBldmVuIGFmdGVyIHRoZSBzY29wZSBoYXMgZXhpdGVkIFx1MjAxNCBiZWNhdXNlIHtAbGluayBhc3luYyFhZGRFcnJvckhhbmRsZXJ9IGNhcHR1cmVzIHRoZSBhY3RpdmVcbiAqIGlnbm9yZSBjb250ZXh0IGF0IHNjaGVkdWxlIHRpbWUuIEEgdGVzdCB0aGVyZWZvcmUgZG9lcyBub3QgbmVlZCB0byBkcmFpbiB0aGUgb3BlcmF0aW9uIGl0c2VsZjpcbiAqXG4gKiBgYGB0c1xuICogaXQoJ2RvZXMgbm90IGZhaWwnLCAoKSA9PiB7XG4gKiAgIHVzaW5nIF8gPSBzdGFydEFzeW5jRXJyb3JJZ25vcmVDb250ZXh0KCk7XG4gKiAgIGludm9rZUFzeW5jU2FmZWx5KCgpID0+IFByb21pc2UucmVqZWN0KG5ldyBFcnJvcignZGVsaWJlcmF0ZWx5IHN3YWxsb3dlZCcpKSk7XG4gKiB9KTtcbiAqIGBgYFxuICpcbiAqIENvbnRleHRzIG5lc3Q7IHRoZSBpZ25vcmUgb25seSBlbmRzIG9uY2UgZXZlcnkgb3BlbiBjb250ZXh0IGhhcyBiZWVuIGRpc3Bvc2VkLlxuICpcbiAqIEByZXR1cm5zIEEge0BsaW5rIERpc3Bvc2FibGV9IHRoYXQgY2xvc2VzIHRoZSBpZ25vcmUgY29udGV4dCB3aGVuIGRpc3Bvc2VkLCBmb3IgdXNlIHdpdGggYHVzaW5nYC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHN0YXJ0QXN5bmNFcnJvcklnbm9yZUNvbnRleHQoKTogRGlzcG9zYWJsZSB7XG4gIG1vZHVsZVN0YXRlLmFzeW5jRXJyb3JJZ25vcmVDb250ZXh0RGVwdGgrKztcbiAgcmV0dXJuIG5ldyBDYWxsYmFja0Rpc3Bvc2FibGUoe1xuICAgIGNhbGxiYWNrOiAoKTogdm9pZCA9PiB7XG4gICAgICBtb2R1bGVTdGF0ZS5hc3luY0Vycm9ySWdub3JlQ29udGV4dERlcHRoLS07XG4gICAgfSxcbiAgICBtdWx0aXBsZURpc3Bvc2VCZWhhdmlvcjogTXVsdGlwbGVEaXNwb3NlQmVoYXZpb3IuSWdub3JlXG4gIH0pO1xufVxuXG4vKipcbiAqIE9wZW5zIGEgd2luZG93IGluIHdoaWNoIGFzeW5jIGVycm9ycyBlbWl0dGVkIG91dHNpZGUgYW4gaWdub3JlIGNvbnRleHQgYXJlIGNvbGxlY3RlZCBhcyB1bmhhbmRsZWRcbiAqIChzZWUge0BsaW5rIGVtaXRBc3luY0Vycm9yRXZlbnR9KSwgZGlzY2FyZGluZyBhbnl0aGluZyBjb2xsZWN0ZWQgYnkgYSBwcmV2aW91cyB3aW5kb3cuXG4gKlxuICogSW50ZW5kZWQgZm9yIHRoZSB0ZXN0IGhhcm5lc3Mgb25seTogdGhlIHBlci10ZXN0IHNldHVwIG9wZW5zIGEgd2luZG93IGJlZm9yZSBlYWNoIHRlc3QgYW5kIGVtcHRpZXMgaXRcbiAqIGFmdGVyIGVhY2ggdGVzdCB2aWEge0BsaW5rIGRyYWluQ29sbGVjdGVkVW5oYW5kbGVkQXN5bmNFcnJvcnN9LCBjbG9zaW5nIGl0IGZvciBnb29kIHdpdGhcbiAqIHtAbGluayBzdG9wQ29sbGVjdGluZ1VuaGFuZGxlZEFzeW5jRXJyb3JzfSBvbmNlIHRoZSBmaWxlJ3MgbGFzdCB0ZXN0IGhhcyBydW4uIEluIHByb2R1Y3Rpb24gbm8gd2luZG93XG4gKiBpcyBvcGVuLCBzbyBlbWl0dGluZyBhbiBhc3luYyBlcnJvciBjYXJyaWVzIG5vIGJvb2trZWVwaW5nIG92ZXJoZWFkLlxuICovXG5leHBvcnQgZnVuY3Rpb24gc3RhcnRDb2xsZWN0aW5nVW5oYW5kbGVkQXN5bmNFcnJvcnMoKTogdm9pZCB7XG4gIG1vZHVsZVN0YXRlLmNvbGxlY3RlZFVuaGFuZGxlZEFzeW5jRXJyb3JzID0gW107XG59XG5cbi8qKlxuICogQ2xvc2VzIHRoZSB3aW5kb3cgb3BlbmVkIGJ5IHtAbGluayBzdGFydENvbGxlY3RpbmdVbmhhbmRsZWRBc3luY0Vycm9yc30gYW5kIHJldHVybnMgdGhlIHVuaGFuZGxlZFxuICogYXN5bmMgZXJyb3JzIGNvbGxlY3RlZCB3aGlsZSBpdCB3YXMgb3Blbi5cbiAqXG4gKiBVc2Uge0BsaW5rIGRyYWluQ29sbGVjdGVkVW5oYW5kbGVkQXN5bmNFcnJvcnN9IGluc3RlYWQgd2hlcmV2ZXIgY29sbGVjdGlvbiBtdXN0IGNvbnRpbnVlIGFmdGVyd2FyZHMgXHUyMDE0XG4gKiBvbmNlIHRoZSB3aW5kb3cgaXMgY2xvc2VkLCBhIGxhdGVyIGFzeW5jIGVycm9yIGlzIG5vdCBjb2xsZWN0ZWQgYnkgYW55b25lLlxuICpcbiAqIEByZXR1cm5zIFRoZSBjb2xsZWN0ZWQgdW5oYW5kbGVkIGFzeW5jIGVycm9ycywgb3IgYW4gZW1wdHkgYXJyYXkgaWYgbm8gd2luZG93IHdhcyBvcGVuLlxuICovXG5leHBvcnQgZnVuY3Rpb24gc3RvcENvbGxlY3RpbmdVbmhhbmRsZWRBc3luY0Vycm9ycygpOiB1bmtub3duW10ge1xuICBjb25zdCBjb2xsZWN0ZWRFcnJvcnMgPSBtb2R1bGVTdGF0ZS5jb2xsZWN0ZWRVbmhhbmRsZWRBc3luY0Vycm9ycyA/PyBbXTtcbiAgbW9kdWxlU3RhdGUuY29sbGVjdGVkVW5oYW5kbGVkQXN5bmNFcnJvcnMgPSBudWxsO1xuICByZXR1cm4gY29sbGVjdGVkRXJyb3JzO1xufVxuXG4vKipcbiAqIFRocm93cyBhbiBlcnJvciB3aXRoIHRoZSBzcGVjaWZpZWQgbWVzc2FnZS5cbiAqXG4gKiBAcGFyYW0gZXJyb3IgLSBUaGUgZXJyb3IgdG8gdGhyb3cuXG4gKiBAdGhyb3dzXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiB0aHJvd0V4cHJlc3Npb24oZXJyb3I6IHVua25vd24pOiBuZXZlciB7XG4gIHRocm93IGVycm9yO1xufVxuXG5mdW5jdGlvbiBnZW5lcmF0ZU5lc3RlZEVycm9yTGluZXMobmVzdGVkRXJyb3I6IHVua25vd24sIHRpdGxlOiBzdHJpbmcpOiBFcnJvckxpbmVbXSB7XG4gIGNvbnN0IGxpbmVzID0gW3RvVGl0bGVMaW5lKHRpdGxlKSwgLi4uZ2V0RXJyb3JMaW5lcyhuZXN0ZWRFcnJvcikuZmlsdGVyKChsaW5lKSA9PiBsaW5lLnRleHQudHJpbSgpICE9PSAnJyldO1xuICByZXR1cm4gbGluZXMubWFwKChsaW5lKSA9PiBsaW5lLmlzRnJhbWUgPyBsaW5lIDogeyBpc0ZyYW1lOiB0cnVlLCB0ZXh0OiBnZW5lcmF0ZVN0YWNrVHJhY2VMaW5lKGxpbmUudGV4dCkgfSk7XG59XG5cbmZ1bmN0aW9uIGdlbmVyYXRlU3RhY2tUcmFjZUxpbmUodGl0bGU6IHN0cmluZyk6IHN0cmluZyB7XG4gIHJldHVybiBgJHtTVEFDS19UUkFDRV9QUkVGSVh9IC0tLSAke3RpdGxlfSAtLS0gKDApYDtcbn1cblxuLyoqXG4gKiBCdWlsZHMgdGhlIGBOYW1lOiBtZXNzYWdlYCBoZWFkZXIgdGhlIHdheSBWOCB3cml0ZXMgaXQgaW50byBgLnN0YWNrYCAoYSBiYXJlIGBOYW1lYCBmb3IgYW4gZW1wdHkgbWVzc2FnZSkuXG4gKlxuICogQHBhcmFtIGVycm9yIC0gVGhlIGVycm9yLlxuICogQHJldHVybnMgVGhlIGhlYWRlciwgd2hpY2ggc3BhbnMgc2V2ZXJhbCBsaW5lcyB3aGVuIHRoZSBtZXNzYWdlIGRvZXMuXG4gKi9cbmZ1bmN0aW9uIGdldEVycm9ySGVhZGVyKGVycm9yOiBFcnJvcik6IHN0cmluZyB7XG4gIHJldHVybiBlcnJvci5tZXNzYWdlID8gYCR7ZXJyb3IubmFtZX06ICR7ZXJyb3IubWVzc2FnZX1gIDogZXJyb3IubmFtZTtcbn1cblxuZnVuY3Rpb24gZ2V0RXJyb3JMaW5lcyhlcnJvcjogdW5rbm93bik6IEVycm9yTGluZVtdIHtcbiAgaWYgKCEoZXJyb3IgaW5zdGFuY2VvZiBFcnJvcikpIHtcbiAgICByZXR1cm4gU3RyaW5nKGVycm9yKS5zcGxpdCgnXFxuJykubWFwKCh0ZXh0KSA9PiB0b1RpdGxlTGluZSh0ZXh0KSk7XG4gIH1cblxuICBjb25zdCBsaW5lcyA9IGdldE93bkVycm9yTGluZXMoZXJyb3IpO1xuICBpZiAoZXJyb3IuY2F1c2UgIT09IHVuZGVmaW5lZCkge1xuICAgIGxpbmVzLnB1c2goLi4uZ2VuZXJhdGVOZXN0ZWRFcnJvckxpbmVzKGVycm9yLmNhdXNlLCAnQ2F1c2VkIGJ5OicpKTtcbiAgfVxuICBpZiAoZXJyb3IgaW5zdGFuY2VvZiBBZ2dyZWdhdGVFcnJvcikge1xuICAgIGNvbnN0IGFnZ3JlZ2F0ZWRFcnJvcnM6IHJlYWRvbmx5IHVua25vd25bXSA9IGVycm9yLmVycm9ycztcbiAgICBmb3IgKGNvbnN0IFtpbmRleCwgYWdncmVnYXRlZEVycm9yXSBvZiBhZ2dyZWdhdGVkRXJyb3JzLmVudHJpZXMoKSkge1xuICAgICAgbGluZXMucHVzaCguLi5nZW5lcmF0ZU5lc3RlZEVycm9yTGluZXMoYWdncmVnYXRlZEVycm9yLCBgQWdncmVnYXRlZCBlcnJvciAjJHtTdHJpbmcoaW5kZXggKyAxKX06YCkpO1xuICAgIH1cbiAgfVxuICByZXR1cm4gbGluZXM7XG59XG5cbmZ1bmN0aW9uIGdldE93bkVycm9yTGluZXMoZXJyb3I6IEVycm9yKTogRXJyb3JMaW5lW10ge1xuICBjb25zdCBoZWFkZXJMaW5lcyA9IGdldEVycm9ySGVhZGVyKGVycm9yKS5zcGxpdCgnXFxuJykubWFwKCh0ZXh0KSA9PiB0b1RpdGxlTGluZSh0ZXh0KSk7XG4gIGlmIChlcnJvci5zdGFjayA9PT0gdW5kZWZpbmVkKSB7XG4gICAgcmV0dXJuIGhlYWRlckxpbmVzO1xuICB9XG5cbiAgY29uc3Qgc3RhY2tMaW5lcyA9IGVycm9yLnN0YWNrLnNwbGl0KCdcXG4nKTtcbiAgaWYgKGhhc1N0YWNrSGVhZGVyKCkpIHtcbiAgICByZXR1cm4gc3RhY2tMaW5lcy5tYXAoKHRleHQpID0+ICh7IGlzRnJhbWU6IHRleHQuc3RhcnRzV2l0aChTVEFDS19UUkFDRV9QUkVGSVgpLCB0ZXh0IH0pKTtcbiAgfVxuXG4gIC8vIE9uIGFuIGVuZ2luZSB3aXRob3V0IGEgaGVhZGVyIGxpbmUsIHRoZSBgLnN0YWNrYCBpcyBmcmFtZXMgb25seSwgaW4gaXRzIG93biBgbmFtZUB1cmw6bGluZTpjb2xgIGZvcm0sIHNvIHRoZSBtZXNzYWdlIGlzIG5vd2hlcmUgaW4gaXQ6XG4gIC8vIFByZXBlbmQgdGhlIGhlYWRlciwgYW5kIHRha2UgZXZlcnkgc3RhY2sgbGluZSBhcyBhIGZyYW1lLlxuICByZXR1cm4gWy4uLmhlYWRlckxpbmVzLCAuLi5zdGFja0xpbmVzLmZpbHRlcigodGV4dCkgPT4gdGV4dC50cmltKCkgIT09ICcnKS5tYXAoKHRleHQpID0+ICh7IGlzRnJhbWU6IHRydWUsIHRleHQgfSkpXTtcbn1cblxuLyoqXG4gKiBIYW5kbGVzIGFzeW5jaHJvbm91cyBlcnJvcnMgYnkgcHJpbnRpbmcgdGhlbS5cbiAqXG4gKiBAcGFyYW0gYXN5bmNFcnJvciAtIFRoZSBhc3luY2hyb25vdXMgZXJyb3IgdG8gaGFuZGxlLlxuICovXG5mdW5jdGlvbiBoYW5kbGVBc3luY0Vycm9yKGFzeW5jRXJyb3I6IHVua25vd24pOiB2b2lkIHtcbiAgcHJpbnRFcnJvcihhc3luY0Vycm9yKTtcbn1cblxuLyoqXG4gKiBBbnN3ZXJzIHdoZXRoZXIgdGhpcyBlbmdpbmUncyBgLnN0YWNrYCBvcGVucyB3aXRoIHRoZSBlcnJvcidzIGBOYW1lOiBtZXNzYWdlYCBoZWFkZXIgbGluZS5cbiAqXG4gKiBWOCB3cml0ZXMgb25lOyBKYXZhU2NyaXB0Q29yZSAoZXZlcnkgQXBwbGUgcGxhdGZvcm0sIHNvIE9ic2lkaWFuIG9uIGlPUyBhbmQgaVBhZE9TKSBhbmQgU3BpZGVyTW9ua2V5IHdyaXRlIGZyYW1lcyBvbmx5LlxuICogVGhlIGFuc3dlciBiZWxvbmdzIHRvIHRoZSBlbmdpbmUsIG5vdCB0aGUgcGxhdGZvcm0sIHNvIGl0IGlzIHByb2JlZCByYXRoZXIgdGhhbiByZWFkIG9mZiBgUGxhdGZvcm1gLiBJdCBpcyBwcm9iZWQgb24gZXZlcnlcbiAqIGNhbGwgcmF0aGVyIHRoYW4gY2FjaGVkLCBiZWNhdXNlIGBFcnJvci5wcmVwYXJlU3RhY2tUcmFjZWAgY2FuIHJlc2hhcGUgVjgncyBzdGFjayBhdCBydW50aW1lLCBhbmQgb25lIGV4dHJhIGBFcnJvcmAgY29zdHNcbiAqIG5vdGhpbmcgb24gYSBwYXRoIHRoYXQgaXMgYWxyZWFkeSBoYW5kbGluZyBvbmUuXG4gKlxuICogQHJldHVybnMgYHRydWVgIGlmIGAuc3RhY2tgIGNhcnJpZXMgdGhlIGhlYWRlciBsaW5lLlxuICovXG5mdW5jdGlvbiBoYXNTdGFja0hlYWRlcigpOiBib29sZWFuIHtcbiAgY29uc3QgZmlyc3RMaW5lID0gbmV3IEVycm9yKFNUQUNLX0hFQURFUl9QUk9CRV9NRVNTQUdFKS5zdGFjaz8uc3BsaXQoJ1xcbicsIDEpWzBdO1xuICByZXR1cm4gZmlyc3RMaW5lID09PSBgRXJyb3I6ICR7U1RBQ0tfSEVBREVSX1BST0JFX01FU1NBR0V9YDtcbn1cblxuZnVuY3Rpb24gdG9UaXRsZUxpbmUodGV4dDogc3RyaW5nKTogRXJyb3JMaW5lIHtcbiAgcmV0dXJuIHsgaXNGcmFtZTogZmFsc2UsIHRleHQgfTtcbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFNQSxTQUFTLG1CQUFtQjtBQUM1QjtBQUFBLEVBQ0U7QUFBQSxFQUNBO0FBQUEsT0FDSztBQUNQLFNBQVMseUJBQXlCO0FBTWxDLE1BQU0sbUJBQW1CLElBQUksWUFBZ0M7QUFFN0QsaUJBQWlCLEdBQUcsY0FBYyxnQkFBZ0I7QUF1QmxELE1BQU0sY0FBMkI7QUFBQSxFQUMvQiw4QkFBOEI7QUFBQSxFQUM5QiwrQkFBK0I7QUFDakM7QUFJTyxNQUFNLDhCQUE4QjtBQUUzQyxNQUFNLHFCQUFxQjtBQUUzQixNQUFNLHVCQUF1QjtBQUU3QixNQUFNLDZCQUE2QjtBQW9DNUIsTUFBTSw4QkFBOEIsTUFBTTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU14QyxZQUFZLFFBQWdEO0FBQ2pFLFVBQU0sRUFBRSxPQUFPLFNBQVMsV0FBVyxJQUFJO0FBQ3ZDLFVBQU0sU0FBUyxFQUFFLE1BQU0sQ0FBQztBQUN4QixTQUFLLE9BQU87QUFFWixRQUFJLFlBQVk7QUFDaEIsVUFBTSxlQUFlLG9CQUFJLElBQTJCO0FBQ3BELFdBQU8scUJBQXFCLHVCQUF1QjtBQUNqRCxVQUFJLGFBQWEsSUFBSSxTQUFTLEdBQUc7QUFDL0IsY0FBTSxJQUFJLE1BQU0seUJBQXlCO0FBQUEsTUFDM0M7QUFDQSxtQkFBYSxJQUFJLFNBQVM7QUFDMUIsa0JBQVksVUFBVTtBQUFBLElBQ3hCO0FBRUEsVUFBTSxhQUFhLFdBQVcsTUFBTSxJQUFJO0FBQ3hDLFFBQUkscUJBQXFCLEtBQUssa0JBQWtCLFdBQVcsQ0FBQyxDQUFDLENBQUMsR0FBRztBQUMvRCxpQkFBVyxNQUFNO0FBQUEsSUFDbkI7QUFFQSxRQUFJLGVBQWUsR0FBRztBQUNwQixpQkFBVyxRQUFRLGVBQWUsSUFBSSxDQUFDO0FBQUEsSUFDekM7QUFDQSxTQUFLLFFBQVEsV0FBVyxLQUFLLElBQUk7QUFBQSxFQUNuQztBQUNGO0FBS08sTUFBTSxxQkFBcUIsTUFBTTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU0vQixZQUFZLGFBQXNCO0FBQ3ZDLFVBQU0saUNBQWlDLE9BQU8sV0FBVyxDQUFDLElBQUksRUFBRSxPQUFPLFlBQVksQ0FBQztBQUNwRixTQUFLLE9BQU87QUFBQSxFQUNkO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBVUEsT0FBYyxPQUFPLGFBQTZCO0FBQ2hELFdBQU8sdUJBQXVCLFFBQVEsY0FBYyxJQUFJLGFBQWEsV0FBVztBQUFBLEVBQ2xGO0FBQ0Y7QUFLTyxNQUFNLG9CQUFvQixNQUFNO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBTTlCLFlBQVksU0FBaUI7QUFDbEMsVUFBTSxPQUFPO0FBQ2IsU0FBSyxPQUFPO0FBQUEsRUFDZDtBQUNGO0FBWU8sU0FBUyxxQ0FBZ0Q7QUFDOUQsU0FBTyxZQUFZLCtCQUErQixPQUFPLENBQUMsS0FBSyxDQUFDO0FBQ2xFO0FBY08sU0FBUyxvQkFBb0IsWUFBcUIsZUFBZSxPQUFhO0FBQ25GLFFBQU0sWUFBWSxnQkFBZ0IsWUFBWSwrQkFBK0I7QUFDN0UsTUFBSSxZQUFZLGlDQUFpQyxDQUFDLFdBQVc7QUFDM0QsZ0JBQVksOEJBQThCLEtBQUssVUFBVTtBQUFBLEVBQzNEO0FBQ0EsbUJBQWlCLFFBQVEsY0FBYyxVQUFVO0FBQ25EO0FBU08sU0FBUyxjQUFjLE9BQXdCO0FBQ3BELFNBQU8sY0FBYyxLQUFLLEVBQUUsSUFBSSxDQUFDLFNBQVMsS0FBSyxJQUFJLEVBQUUsS0FBSyxJQUFJO0FBQ2hFO0FBUU8sU0FBUyxjQUFjLGVBQWUsR0FBVztBQUV0RCxRQUFNLDhCQUE4QjtBQUNwQyxRQUFNLHdCQUF3QiwrQkFBK0IsZUFBZSxJQUFJLElBQUk7QUFDcEYsUUFBTSxRQUFRLGtCQUFrQixJQUFJLE1BQU0sRUFBRSxLQUFLO0FBQ2pELFFBQU0sUUFBUSxNQUFNLE1BQU0sSUFBSTtBQUM5QixTQUFPLE1BQU0sTUFBTSxlQUFlLHFCQUFxQixFQUFFLEtBQUssSUFBSTtBQUNwRTtBQU9PLFNBQVMsa0NBQTJDO0FBQ3pELFNBQU8sWUFBWSwrQkFBK0I7QUFDcEQ7QUFRTyxTQUFTLFdBQVcsT0FBZ0IsU0FBeUI7QUFFbEUsY0FBWSxXQUFXO0FBQ3ZCLFVBQVEsTUFBTSxjQUFjLEtBQUssQ0FBQztBQUNwQztBQVlPLFNBQVMsK0JBQStCLFNBQW9EO0FBQ2pHLFFBQU0sV0FBVyxpQkFBaUIsR0FBRyxjQUFjLE9BQU87QUFDMUQsU0FBTyxJQUFJLG1CQUFtQjtBQUFBLElBQzVCLFVBQVUsTUFBWTtBQUNwQix1QkFBaUIsT0FBTyxRQUFRO0FBQUEsSUFDbEM7QUFBQSxJQUNBLHlCQUF5Qix3QkFBd0I7QUFBQSxFQUNuRCxDQUFDO0FBQ0g7QUF1Qk8sU0FBUywrQkFBMkM7QUFDekQsY0FBWTtBQUNaLFNBQU8sSUFBSSxtQkFBbUI7QUFBQSxJQUM1QixVQUFVLE1BQVk7QUFDcEIsa0JBQVk7QUFBQSxJQUNkO0FBQUEsSUFDQSx5QkFBeUIsd0JBQXdCO0FBQUEsRUFDbkQsQ0FBQztBQUNIO0FBV08sU0FBUyxzQ0FBNEM7QUFDMUQsY0FBWSxnQ0FBZ0MsQ0FBQztBQUMvQztBQVdPLFNBQVMscUNBQWdEO0FBQzlELFFBQU0sa0JBQWtCLFlBQVksaUNBQWlDLENBQUM7QUFDdEUsY0FBWSxnQ0FBZ0M7QUFDNUMsU0FBTztBQUNUO0FBUU8sU0FBUyxnQkFBZ0IsT0FBdUI7QUFDckQsUUFBTTtBQUNSO0FBRUEsU0FBUyx5QkFBeUIsYUFBc0IsT0FBNEI7QUFDbEYsUUFBTSxRQUFRLENBQUMsWUFBWSxLQUFLLEdBQUcsR0FBRyxjQUFjLFdBQVcsRUFBRSxPQUFPLENBQUMsU0FBUyxLQUFLLEtBQUssS0FBSyxNQUFNLEVBQUUsQ0FBQztBQUMxRyxTQUFPLE1BQU0sSUFBSSxDQUFDLFNBQVMsS0FBSyxVQUFVLE9BQU8sRUFBRSxTQUFTLE1BQU0sTUFBTSx1QkFBdUIsS0FBSyxJQUFJLEVBQUUsQ0FBQztBQUM3RztBQUVBLFNBQVMsdUJBQXVCLE9BQXVCO0FBQ3JELFNBQU8sR0FBRyxrQkFBa0IsUUFBUSxLQUFLO0FBQzNDO0FBUUEsU0FBUyxlQUFlLE9BQXNCO0FBQzVDLFNBQU8sTUFBTSxVQUFVLEdBQUcsTUFBTSxJQUFJLEtBQUssTUFBTSxPQUFPLEtBQUssTUFBTTtBQUNuRTtBQUVBLFNBQVMsY0FBYyxPQUE2QjtBQUNsRCxNQUFJLEVBQUUsaUJBQWlCLFFBQVE7QUFDN0IsV0FBTyxPQUFPLEtBQUssRUFBRSxNQUFNLElBQUksRUFBRSxJQUFJLENBQUMsU0FBUyxZQUFZLElBQUksQ0FBQztBQUFBLEVBQ2xFO0FBRUEsUUFBTSxRQUFRLGlCQUFpQixLQUFLO0FBQ3BDLE1BQUksTUFBTSxVQUFVLFFBQVc7QUFDN0IsVUFBTSxLQUFLLEdBQUcseUJBQXlCLE1BQU0sT0FBTyxZQUFZLENBQUM7QUFBQSxFQUNuRTtBQUNBLE1BQUksaUJBQWlCLGdCQUFnQjtBQUNuQyxVQUFNLG1CQUF1QyxNQUFNO0FBQ25ELGVBQVcsQ0FBQyxPQUFPLGVBQWUsS0FBSyxpQkFBaUIsUUFBUSxHQUFHO0FBQ2pFLFlBQU0sS0FBSyxHQUFHLHlCQUF5QixpQkFBaUIscUJBQXFCLE9BQU8sUUFBUSxDQUFDLENBQUMsR0FBRyxDQUFDO0FBQUEsSUFDcEc7QUFBQSxFQUNGO0FBQ0EsU0FBTztBQUNUO0FBRUEsU0FBUyxpQkFBaUIsT0FBMkI7QUFDbkQsUUFBTSxjQUFjLGVBQWUsS0FBSyxFQUFFLE1BQU0sSUFBSSxFQUFFLElBQUksQ0FBQyxTQUFTLFlBQVksSUFBSSxDQUFDO0FBQ3JGLE1BQUksTUFBTSxVQUFVLFFBQVc7QUFDN0IsV0FBTztBQUFBLEVBQ1Q7QUFFQSxRQUFNLGFBQWEsTUFBTSxNQUFNLE1BQU0sSUFBSTtBQUN6QyxNQUFJLGVBQWUsR0FBRztBQUNwQixXQUFPLFdBQVcsSUFBSSxDQUFDLFVBQVUsRUFBRSxTQUFTLEtBQUssV0FBVyxrQkFBa0IsR0FBRyxLQUFLLEVBQUU7QUFBQSxFQUMxRjtBQUlBLFNBQU8sQ0FBQyxHQUFHLGFBQWEsR0FBRyxXQUFXLE9BQU8sQ0FBQyxTQUFTLEtBQUssS0FBSyxNQUFNLEVBQUUsRUFBRSxJQUFJLENBQUMsVUFBVSxFQUFFLFNBQVMsTUFBTSxLQUFLLEVBQUUsQ0FBQztBQUNySDtBQU9BLFNBQVMsaUJBQWlCLFlBQTJCO0FBQ25ELGFBQVcsVUFBVTtBQUN2QjtBQVlBLFNBQVMsaUJBQTBCO0FBQ2pDLFFBQU0sWUFBWSxJQUFJLE1BQU0sMEJBQTBCLEVBQUUsT0FBTyxNQUFNLE1BQU0sQ0FBQyxFQUFFLENBQUM7QUFDL0UsU0FBTyxjQUFjLFVBQVUsMEJBQTBCO0FBQzNEO0FBRUEsU0FBUyxZQUFZLE1BQXlCO0FBQzVDLFNBQU8sRUFBRSxTQUFTLE9BQU8sS0FBSztBQUNoQzsiLAogICJuYW1lcyI6IFtdCn0K

package/dist/lib/esm/function.d.mts

@@ -0,0 +1,128 @@
+/// <reference path="./library.d.mts" />
+/**
+ * @file
+ *
+ * Contains utility functions and types for working with functions.
+ */
+import type { Promisable } from 'type-fest';
+/**
+ * Represents a generic async function.
+ *
+ * @typeParam Arguments - The arguments of the function.
+ * @typeParam Return - The awaited return type of the function.
+ */
+export type GenericAsyncFunction<Arguments extends unknown[] = never[], Return = unknown> = GenericFunction<Arguments, Promise<Return>>;
+/**
+ * Represents a generic async void function.
+ *
+ * @typeParam Arguments - The arguments of the function.
+ */
+export type GenericAsyncVoidFunction<Arguments extends unknown[] = never[]> = GenericAsyncFunction<Arguments, void>;
+/**
+ * Represents a generic function.
+ *
+ * @typeParam Arguments - The arguments of the function.
+ * @typeParam Return - The return type of the function.
+ */
+export type GenericFunction<Arguments extends unknown[] = never[], Return = unknown> = (...$arguments: Arguments) => Return;
+/**
+ * Represents a generic promisable function.
+ *
+ * @typeParam Arguments - The arguments of the function.
+ * @typeParam Return - The awaited return type of the function.
+ */
+export type GenericPromisableFunction<Arguments extends unknown[] = never[], Return = unknown> = GenericFunction<Arguments, Promisable<Return>>;
+/**
+ * Represents a generic promisable void function.
+ *
+ * @typeParam Arguments - The arguments of the function.
+ */
+export type GenericPromisableVoidFunction<Arguments extends unknown[] = never[]> = GenericPromisableFunction<Arguments, void>;
+/**
+ * Represents a generic void function.
+ *
+ * @typeParam Arguments - The arguments of the function.
+ */
+export type GenericVoidFunction<Arguments extends unknown[] = never[]> = GenericFunction<Arguments, void>;
+/**
+ * Converts a function into a string that is a valid function expression.
+ *
+ * `Function.prototype.toString()` on a shorthand method like `{ fn() {} }`
+ * returns `"fn() {}"`, which is not a valid expression.
+ * This helper detects that form and prefixes it with `function `.
+ *
+ * @param $function - The function to convert.
+ * @returns A string that is a valid function expression.
+ */
+export declare function getFunctionExpressionString($function: Function): string;
+/**
+ * A function that does nothing.
+ */
+export declare function noop(): void;
+/**
+ * A singleton no-op promise.
+ */
+export declare const noopAsyncSingletonPromise: Promise<void>;
+/**
+ * A function that does nothing.
+ *
+ * @returns A promise that resolves when the function is complete.
+ */
+export declare function noopAsync(): Promise<void>;
+/**
+ * Makes an async function that calls the original async function with the provided arguments and omits the return value.
+ *
+ * @typeParam Arguments - Arguments to be passed to the function.
+ * @param $function - Function to be called.
+ * @returns An async function that calls the original function with the provided arguments and omits the return value.
+ */
+export declare function omitAsyncReturnType<Arguments extends unknown[]>($function: GenericAsyncFunction<Arguments>): GenericAsyncVoidFunction<Arguments>;
+type ArgumentNamesOf<T extends GenericFunction> = MapToArgumentNames<Parameters<T>>;
+interface CreateFunctionArgumentlessParams {
+    readonly functionBody: string;
+}
+interface CreateFunctionParams<TFunction extends GenericFunction> extends CreateFunctionArgumentlessParams {
+    readonly argumentNames: ArgumentNamesOf<TFunction>;
+}
+type MapToArgumentNames<TArguments extends readonly unknown[]> = {
+    readonly [K in keyof TArguments]: string;
+};
+/**
+ * Clone a function by creating a new function that calls the original function.
+ *
+ * This is useful for creating a new instance of a function that has the same behavior but is not strictly equal to the original function.
+ *
+ * @typeParam TFunction - The type of the function to clone.
+ * @param $function - The function to clone.
+ * @returns A new function that has the same behavior as the original function.
+ */
+export declare function cloneFunction<TFunction extends GenericFunction>($function: TFunction): TFunction;
+/**
+ * Creates a function from the provided parameters.
+ *
+ * Function is argumentless, so `argNames` is not needed.
+ *
+ * @typeParam TFunction - The type of the function to create.
+ * @param params - The parameters to create the function with.
+ * @returns A function created from the provided parameters.
+ */
+export declare function createFunction<TFunction extends () => unknown>(params: CreateFunctionArgumentlessParams): TFunction;
+/**
+ * Creates a function from the provided parameters.
+ *
+ * Function has arguments, so `argNames` is required.
+ *
+ * @typeParam TFunction - The type of the function to create.
+ * @param params - The parameters to create the function with.
+ * @returns A function created from the provided parameters.
+ */
+export declare function createFunction<TFunction extends GenericFunction>(params: CreateFunctionParams<TFunction>): TFunction;
+/**
+ * Makes a function that calls the original function with the provided arguments and omits the return value.
+ *
+ * @typeParam Arguments - Arguments to be passed to the function.
+ * @param $function - Function to be called.
+ * @returns A function that calls the original function with the provided arguments and omits the return value.
+ */
+export declare function omitReturnType<Arguments extends unknown[]>($function: GenericFunction<Arguments>): GenericVoidFunction<Arguments>;
+export {};