@mnaoumov/obsidian-lib 10.12.0 → 11.0.0

package/dist/lib/esm/components/worker-component.d.mts

@@ -0,0 +1,156 @@
+/// <reference path="../library-references.d.mts" />
+/// <reference lib="dom" />
+/**
+ * @file
+ *
+ * A component that owns one browser `Worker` built from bundled source and calls it through a typed request/response
+ * channel.
+ */
+import type { SerializedWorkerError, WorkerApi, WorkerApiHandlers } from '../worker-protocol.mjs';
+import { ComponentEx } from './component-ex.mjs';
+/**
+ * Options of {@link WorkerComponent.call}.
+ */
+export interface WorkerComponentCallOptions {
+    /**
+     * Cancels the call. The returned promise rejects with the signal's reason at once, and the worker's handler sees its
+     * own `this.abortSignal` aborted; whatever it answers afterwards is dropped.
+     */
+    readonly abortSignal?: AbortSignal;
+    /**
+     * Objects inside the arguments to transfer rather than copy. They are unusable on the main thread afterwards.
+     */
+    readonly transfer?: readonly Transferable[];
+}
+/**
+ * Parameters of {@link WorkerComponent}.
+ *
+ * @typeParam TApi - The API the worker exposes.
+ */
+export interface WorkerComponentConstructorParams<TApi extends WorkerApi<TApi>> {
+    /**
+     * The same handlers the worker exposes, run on the main thread when no `Worker` can be created. Without them, a
+     * failure to create the worker fails the component's load.
+     */
+    readonly fallbackHandlers?: WorkerApiHandlers<TApi>;
+    /**
+     * The worker's name, shown by the developer tools.
+     */
+    readonly name?: string;
+    /**
+     * The bundled worker source: the string a `*.worker.ts?worker-source` import gives with
+     * `@mnaoumov/obsidian-dev-toolkit`'s `workers` feature.
+     */
+    readonly source: string;
+}
+/**
+ * The method names of a {@link WorkerApi}.
+ *
+ * @typeParam TApi - The API type.
+ */
+export type WorkerMethod<TApi> = Extract<keyof TApi, string>;
+/**
+ * The resolved result type of a worker method.
+ *
+ * @typeParam TApi - The API type.
+ * @typeParam TMethod - The method.
+ */
+export type WorkerMethodResult<TApi extends WorkerApi<TApi>, TMethod extends WorkerMethod<TApi>> = Awaited<ReturnType<TApi[TMethod]>>;
+/**
+ * The error a call rejects with when the worker's handler failed. It carries the worker-side name, message and stack,
+ * because an `Error` loses its class across the worker boundary.
+ */
+export declare class WorkerCallError extends Error {
+    /**
+     * The name of the error thrown in the worker.
+     */
+    readonly remoteName: string;
+    /**
+     * The stack of the error thrown in the worker, when there was one.
+     */
+    readonly remoteStack: string | undefined;
+    /**
+     * Creates the error.
+     *
+     * @param error - The serialized worker-side error.
+     */
+    constructor(error: SerializedWorkerError);
+}
+/**
+ * Owns one `Worker` for the component's lifetime.
+ *
+ * On load it turns the bundled source into a Blob URL and starts the worker; on unload it terminates the worker,
+ * revokes the URL and rejects every pending call. Add it as a child of the plugin (or of any component), so the worker
+ * never outlives what uses it.
+ *
+ * The worker entry point calls `exposeWorkerApi` from `@mnaoumov/obsidian-lib/worker-protocol`, and
+ * {@link WorkerComponent.call} reaches its handlers by name, typed by `TApi`.
+ *
+ * @typeParam TApi - The API the worker exposes.
+ */
+export declare class WorkerComponent<TApi extends WorkerApi<TApi>> extends ComponentEx {
+    /**
+     * Whether calls run on the main thread, because no `Worker` could be created and fallback handlers were given.
+     *
+     * @returns Whether the fallback is in use.
+     */
+    get isUsingFallback(): boolean;
+    /**
+     * The number of calls that have not settled yet.
+     *
+     * @returns The count.
+     */
+    get pendingCallCount(): number;
+    /**
+     * The handlers to run on the main thread when no `Worker` can be created, or `null`.
+     */
+    protected readonly fallbackHandlers: null | WorkerApiHandlers<TApi>;
+    /**
+     * The worker's name, or `null`.
+     */
+    protected readonly name: null | string;
+    /**
+     * The bundled worker source.
+     */
+    protected readonly source: string;
+    private _pendingCallCount;
+    private activeFallbackHandlers;
+    private lastCallId;
+    private readonly pendingCalls;
+    private worker;
+    private workerUrl;
+    /**
+     * Creates the component.
+     *
+     * @param params - The parameters.
+     */
+    constructor(params: WorkerComponentConstructorParams<TApi>);
+    /**
+     * Calls a worker method.
+     *
+     * @typeParam TMethod - The method.
+     * @param method - The method name.
+     * @param callArguments - The method's arguments.
+     * @param options - The call options.
+     * @returns The method's result. Rejects with a {@link WorkerCallError} when the handler failed, with the abort reason
+     *   when the call was cancelled, and with an `Error` when the worker failed or the component unloaded first.
+     */
+    call<TMethod extends WorkerMethod<TApi>>(method: TMethod, callArguments: Parameters<TApi[TMethod]>, options?: WorkerComponentCallOptions): Promise<WorkerMethodResult<TApi, TMethod>>;
+    /**
+     * Starts the worker.
+     */
+    onload(): void;
+    /**
+     * Terminates the worker and rejects the pending calls.
+     */
+    onunload(): void;
+    private callWorker;
+    private readonly handleError;
+    private readonly handleMessage;
+    private readonly handleMessageError;
+    private rejectAll;
+    private revokeWorkerUrl;
+    private startWorker;
+    private stopWorker;
+    private terminateWorker;
+}

package/dist/lib/esm/components/worker-component.mjs

@@ -0,0 +1,279 @@
+/*
+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 ensureBrowserProcess() {
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return "/";
+    },
+    env: {},
+    platform: "android"
+  };
+  const existingProcess = globalThis.process;
+  if (!existingProcess) {
+    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;
+}
+
+ensureBrowserProcess();
+})();
+
+import { noop } from "@mnaoumov/typescript-lib/function";
+import { ensureNonNullable } from "@mnaoumov/typescript-lib/type-guards";
+import {
+  invokeWorkerHandler,
+  isWorkerResponseMessage,
+  unwrapTransferredValue,
+  WORKER_PROTOCOL
+} from "../worker-protocol.mjs";
+import { ComponentEx } from "./component-ex.mjs";
+class WorkerCallError extends Error {
+  /**
+   * The name of the error thrown in the worker.
+   */
+  remoteName;
+  /**
+   * The stack of the error thrown in the worker, when there was one.
+   */
+  remoteStack;
+  /**
+   * Creates the error.
+   *
+   * @param error - The serialized worker-side error.
+   */
+  constructor(error) {
+    super(error.message);
+    this.name = "WorkerCallError";
+    this.remoteName = error.name;
+    this.remoteStack = error.stack;
+  }
+}
+class WorkerComponent extends ComponentEx {
+  /**
+   * Whether calls run on the main thread, because no `Worker` could be created and fallback handlers were given.
+   *
+   * @returns Whether the fallback is in use.
+   */
+  get isUsingFallback() {
+    return this.activeFallbackHandlers !== null;
+  }
+  /**
+   * The number of calls that have not settled yet.
+   *
+   * @returns The count.
+   */
+  get pendingCallCount() {
+    return this._pendingCallCount;
+  }
+  /**
+   * The handlers to run on the main thread when no `Worker` can be created, or `null`.
+   */
+  fallbackHandlers;
+  /**
+   * The worker's name, or `null`.
+   */
+  name;
+  /**
+   * The bundled worker source.
+   */
+  source;
+  _pendingCallCount = 0;
+  activeFallbackHandlers = null;
+  lastCallId = 0;
+  pendingCalls = /* @__PURE__ */ new Map();
+  // eslint-disable-next-line n/no-unsupported-features/node-builtins -- The renderer's Web Worker, not Node's.
+  worker = null;
+  workerUrl = null;
+  /**
+   * Creates the component.
+   *
+   * @param params - The parameters.
+   */
+  constructor(params) {
+    super();
+    this.fallbackHandlers = params.fallbackHandlers ?? null;
+    this.name = params.name ?? null;
+    this.source = params.source;
+  }
+  /**
+   * Calls a worker method.
+   *
+   * @typeParam TMethod - The method.
+   * @param method - The method name.
+   * @param callArguments - The method's arguments.
+   * @param options - The call options.
+   * @returns The method's result. Rejects with a {@link WorkerCallError} when the handler failed, with the abort reason
+   *   when the call was cancelled, and with an `Error` when the worker failed or the component unloaded first.
+   */
+  async call(method, callArguments, options = {}) {
+    if (!this._loaded) {
+      throw new Error("The worker component is not loaded");
+    }
+    const abortSignal = options.abortSignal ?? new AbortController().signal;
+    abortSignal.throwIfAborted();
+    this._pendingCallCount++;
+    try {
+      const result = this.activeFallbackHandlers === null ? await this.callWorker(method, callArguments, abortSignal, options.transfer ?? []) : await callFallback(this.activeFallbackHandlers, method, callArguments, abortSignal);
+      return result;
+    } finally {
+      this._pendingCallCount--;
+    }
+  }
+  /**
+   * Starts the worker.
+   */
+  onload() {
+    super.onload();
+    try {
+      this.startWorker();
+    } catch (error) {
+      this.stopWorker();
+      if (this.fallbackHandlers === null) {
+        throw error;
+      }
+      this.activeFallbackHandlers = this.fallbackHandlers;
+    }
+  }
+  /**
+   * Terminates the worker and rejects the pending calls.
+   */
+  onunload() {
+    super.onunload();
+    this.stopWorker();
+    this.rejectAll(new Error("The worker component was unloaded"));
+    this.activeFallbackHandlers = null;
+  }
+  async callWorker(method, callArguments, abortSignal, transfer) {
+    const worker = ensureNonNullable(this.worker);
+    this.lastCallId++;
+    const id = this.lastCallId;
+    let onAbort = noop;
+    try {
+      return await new Promise((resolve, reject) => {
+        onAbort = () => {
+          if (!this.pendingCalls.delete(id)) {
+            return;
+          }
+          const cancelMessage = { id, kind: "cancel", protocol: WORKER_PROTOCOL };
+          worker.postMessage(cancelMessage);
+          reject(getAbortReason(abortSignal));
+        };
+        this.pendingCalls.set(id, { reject, resolve });
+        const callMessage = { arguments: callArguments, id, kind: "call", method, protocol: WORKER_PROTOCOL };
+        try {
+          worker.postMessage(callMessage, [...transfer]);
+        } catch (error) {
+          this.pendingCalls.delete(id);
+          reject(toError(error));
+          return;
+        }
+        abortSignal.addEventListener("abort", onAbort, { once: true });
+      });
+    } finally {
+      abortSignal.removeEventListener("abort", onAbort);
+    }
+  }
+  // eslint-disable-next-line n/no-unsupported-features/node-builtins -- The renderer's Web ErrorEvent, not Node's.
+  handleError = ($event) => {
+    $event.preventDefault();
+    this.rejectAll(new Error(`The worker failed: ${$event.message || "unknown error"}`));
+  };
+  handleMessage = ($event) => {
+    const message = $event.data;
+    if (!isWorkerResponseMessage(message)) {
+      return;
+    }
+    const pendingCall = this.pendingCalls.get(message.id);
+    if (!pendingCall) {
+      return;
+    }
+    this.pendingCalls.delete(message.id);
+    if (message.kind === "result") {
+      pendingCall.resolve(message.value);
+    } else {
+      pendingCall.reject(new WorkerCallError(message.error));
+    }
+  };
+  handleMessageError = () => {
+    this.rejectAll(new Error("The worker sent a message that could not be deserialized"));
+  };
+  rejectAll(reason) {
+    const pendingCalls = [...this.pendingCalls.values()];
+    this.pendingCalls.clear();
+    for (const pendingCall of pendingCalls) {
+      pendingCall.reject(reason);
+    }
+  }
+  revokeWorkerUrl() {
+    if (this.workerUrl === null) {
+      return;
+    }
+    window.URL.revokeObjectURL(this.workerUrl);
+    this.workerUrl = null;
+  }
+  startWorker() {
+    this.workerUrl = window.URL.createObjectURL(new Blob([this.source], { type: "text/javascript" }));
+    const workerOptions = this.name === null ? {} : { name: this.name };
+    const worker = new window.Worker(this.workerUrl, workerOptions);
+    this.worker = worker;
+    worker.addEventListener("message", this.handleMessage);
+    worker.addEventListener("messageerror", this.handleMessageError);
+    worker.addEventListener("error", this.handleError);
+  }
+  stopWorker() {
+    this.terminateWorker();
+    this.revokeWorkerUrl();
+  }
+  terminateWorker() {
+    if (!this.worker) {
+      return;
+    }
+    this.worker.removeEventListener("message", this.handleMessage);
+    this.worker.removeEventListener("messageerror", this.handleMessageError);
+    this.worker.removeEventListener("error", this.handleError);
+    this.worker.terminate();
+    this.worker = null;
+  }
+}
+async function callFallback(handlers, method, callArguments, callerSignal) {
+  const abortController = new AbortController();
+  function onAbort() {
+    abortController.abort(callerSignal.reason);
+  }
+  callerSignal.addEventListener("abort", onAbort, { once: true });
+  try {
+    const handlerPromise = invokeWorkerHandler(handlers, method, callArguments, { abortSignal: abortController.signal });
+    handlerPromise.catch(noop);
+    const abortPromise = new Promise((_resolve, reject) => {
+      abortController.signal.addEventListener("abort", () => {
+        reject(getAbortReason(abortController.signal));
+      }, { once: true });
+    });
+    return unwrapTransferredValue(await Promise.race([handlerPromise, abortPromise])).value;
+  } finally {
+    callerSignal.removeEventListener("abort", onAbort);
+  }
+}
+function getAbortReason(abortSignal) {
+  return toError(abortSignal.reason);
+}
+function toError(reason) {
+  return reason instanceof Error ? reason : new Error(String(reason));
+}
+export {
+  WorkerCallError,
+  WorkerComponent
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9jb21wb25lbnRzL3dvcmtlci1jb21wb25lbnQudHMiXSwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIEEgY29tcG9uZW50IHRoYXQgb3ducyBvbmUgYnJvd3NlciBgV29ya2VyYCBidWlsdCBmcm9tIGJ1bmRsZWQgc291cmNlIGFuZCBjYWxscyBpdCB0aHJvdWdoIGEgdHlwZWQgcmVxdWVzdC9yZXNwb25zZVxuICogY2hhbm5lbC5cbiAqL1xuXG5pbXBvcnQgeyBub29wIH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL2Z1bmN0aW9uJztcbmltcG9ydCB7IGVuc3VyZU5vbk51bGxhYmxlIH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL3R5cGUtZ3VhcmRzJztcblxuaW1wb3J0IHR5cGUge1xuICBTZXJpYWxpemVkV29ya2VyRXJyb3IsXG4gIFdvcmtlckFwaSxcbiAgV29ya2VyQXBpSGFuZGxlcnMsXG4gIFdvcmtlckNhbGxNZXNzYWdlLFxuICBXb3JrZXJDYW5jZWxNZXNzYWdlXG59IGZyb20gJy4uL3dvcmtlci1wcm90b2NvbC50cyc7XG5cbmltcG9ydCB7XG4gIGludm9rZVdvcmtlckhhbmRsZXIsXG4gIGlzV29ya2VyUmVzcG9uc2VNZXNzYWdlLFxuICB1bndyYXBUcmFuc2ZlcnJlZFZhbHVlLFxuICBXT1JLRVJfUFJPVE9DT0xcbn0gZnJvbSAnLi4vd29ya2VyLXByb3RvY29sLnRzJztcbmltcG9ydCB7IENvbXBvbmVudEV4IH0gZnJvbSAnLi9jb21wb25lbnQtZXgudHMnO1xuXG4vKipcbiAqIE9wdGlvbnMgb2Yge0BsaW5rIFdvcmtlckNvbXBvbmVudC5jYWxsfS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBXb3JrZXJDb21wb25lbnRDYWxsT3B0aW9ucyB7XG4gIC8qKlxuICAgKiBDYW5jZWxzIHRoZSBjYWxsLiBUaGUgcmV0dXJuZWQgcHJvbWlzZSByZWplY3RzIHdpdGggdGhlIHNpZ25hbCdzIHJlYXNvbiBhdCBvbmNlLCBhbmQgdGhlIHdvcmtlcidzIGhhbmRsZXIgc2VlcyBpdHNcbiAgICogb3duIGB0aGlzLmFib3J0U2lnbmFsYCBhYm9ydGVkOyB3aGF0ZXZlciBpdCBhbnN3ZXJzIGFmdGVyd2FyZHMgaXMgZHJvcHBlZC5cbiAgICovXG4gIHJlYWRvbmx5IGFib3J0U2lnbmFsPzogQWJvcnRTaWduYWw7XG5cbiAgLyoqXG4gICAqIE9iamVjdHMgaW5zaWRlIHRoZSBhcmd1bWVudHMgdG8gdHJhbnNmZXIgcmF0aGVyIHRoYW4gY29weS4gVGhleSBhcmUgdW51c2FibGUgb24gdGhlIG1haW4gdGhyZWFkIGFmdGVyd2FyZHMuXG4gICAqL1xuICByZWFkb25seSB0cmFuc2Zlcj86IHJlYWRvbmx5IFRyYW5zZmVyYWJsZVtdO1xufVxuXG4vKipcbiAqIFBhcmFtZXRlcnMgb2Yge0BsaW5rIFdvcmtlckNvbXBvbmVudH0uXG4gKlxuICogQHR5cGVQYXJhbSBUQXBpIC0gVGhlIEFQSSB0aGUgd29ya2VyIGV4cG9zZXMuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgV29ya2VyQ29tcG9uZW50Q29uc3RydWN0b3JQYXJhbXM8VEFwaSBleHRlbmRzIFdvcmtlckFwaTxUQXBpPj4ge1xuICAvKipcbiAgICogVGhlIHNhbWUgaGFuZGxlcnMgdGhlIHdvcmtlciBleHBvc2VzLCBydW4gb24gdGhlIG1haW4gdGhyZWFkIHdoZW4gbm8gYFdvcmtlcmAgY2FuIGJlIGNyZWF0ZWQuIFdpdGhvdXQgdGhlbSwgYVxuICAgKiBmYWlsdXJlIHRvIGNyZWF0ZSB0aGUgd29ya2VyIGZhaWxzIHRoZSBjb21wb25lbnQncyBsb2FkLlxuICAgKi9cbiAgcmVhZG9ubHkgZmFsbGJhY2tIYW5kbGVycz86IFdvcmtlckFwaUhhbmRsZXJzPFRBcGk+O1xuXG4gIC8qKlxuICAgKiBUaGUgd29ya2VyJ3MgbmFtZSwgc2hvd24gYnkgdGhlIGRldmVsb3BlciB0b29scy5cbiAgICovXG4gIHJlYWRvbmx5IG5hbWU/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRoZSBidW5kbGVkIHdvcmtlciBzb3VyY2U6IHRoZSBzdHJpbmcgYSBgKi53b3JrZXIudHM/d29ya2VyLXNvdXJjZWAgaW1wb3J0IGdpdmVzIHdpdGhcbiAgICogYEBtbmFvdW1vdi9vYnNpZGlhbi1kZXYtdG9vbGtpdGAncyBgd29ya2Vyc2AgZmVhdHVyZS5cbiAgICovXG4gIHJlYWRvbmx5IHNvdXJjZTogc3RyaW5nO1xufVxuXG4vKipcbiAqIFRoZSBtZXRob2QgbmFtZXMgb2YgYSB7QGxpbmsgV29ya2VyQXBpfS5cbiAqXG4gKiBAdHlwZVBhcmFtIFRBcGkgLSBUaGUgQVBJIHR5cGUuXG4gKi9cbmV4cG9ydCB0eXBlIFdvcmtlck1ldGhvZDxUQXBpPiA9IEV4dHJhY3Q8a2V5b2YgVEFwaSwgc3RyaW5nPjtcblxuLyoqXG4gKiBUaGUgcmVzb2x2ZWQgcmVzdWx0IHR5cGUgb2YgYSB3b3JrZXIgbWV0aG9kLlxuICpcbiAqIEB0eXBlUGFyYW0gVEFwaSAtIFRoZSBBUEkgdHlwZS5cbiAqIEB0eXBlUGFyYW0gVE1ldGhvZCAtIFRoZSBtZXRob2QuXG4gKi9cbmV4cG9ydCB0eXBlIFdvcmtlck1ldGhvZFJlc3VsdDxUQXBpIGV4dGVuZHMgV29ya2VyQXBpPFRBcGk+LCBUTWV0aG9kIGV4dGVuZHMgV29ya2VyTWV0aG9kPFRBcGk+PiA9IEF3YWl0ZWQ8UmV0dXJuVHlwZTxUQXBpW1RNZXRob2RdPj47XG5cbmludGVyZmFjZSBQZW5kaW5nQ2FsbCB7XG4gIHJlYWRvbmx5IHJlamVjdDogKHJlYXNvbjogRXJyb3IpID0+IHZvaWQ7XG4gIHJlYWRvbmx5IHJlc29sdmU6ICh2YWx1ZTogdW5rbm93bikgPT4gdm9pZDtcbn1cblxuLyoqXG4gKiBUaGUgZXJyb3IgYSBjYWxsIHJlamVjdHMgd2l0aCB3aGVuIHRoZSB3b3JrZXIncyBoYW5kbGVyIGZhaWxlZC4gSXQgY2FycmllcyB0aGUgd29ya2VyLXNpZGUgbmFtZSwgbWVzc2FnZSBhbmQgc3RhY2ssXG4gKiBiZWNhdXNlIGFuIGBFcnJvcmAgbG9zZXMgaXRzIGNsYXNzIGFjcm9zcyB0aGUgd29ya2VyIGJvdW5kYXJ5LlxuICovXG5leHBvcnQgY2xhc3MgV29ya2VyQ2FsbEVycm9yIGV4dGVuZHMgRXJyb3Ige1xuICAvKipcbiAgICogVGhlIG5hbWUgb2YgdGhlIGVycm9yIHRocm93biBpbiB0aGUgd29ya2VyLlxuICAgKi9cbiAgcHVibGljIHJlYWRvbmx5IHJlbW90ZU5hbWU6IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIHN0YWNrIG9mIHRoZSBlcnJvciB0aHJvd24gaW4gdGhlIHdvcmtlciwgd2hlbiB0aGVyZSB3YXMgb25lLlxuICAgKi9cbiAgcHVibGljIHJlYWRvbmx5IHJlbW90ZVN0YWNrOiBzdHJpbmcgfCB1bmRlZmluZWQ7XG5cbiAgLyoqXG4gICAqIENyZWF0ZXMgdGhlIGVycm9yLlxuICAgKlxuICAgKiBAcGFyYW0gZXJyb3IgLSBUaGUgc2VyaWFsaXplZCB3b3JrZXItc2lkZSBlcnJvci5cbiAgICovXG4gIHB1YmxpYyBjb25zdHJ1Y3RvcihlcnJvcjogU2VyaWFsaXplZFdvcmtlckVycm9yKSB7XG4gICAgc3VwZXIoZXJyb3IubWVzc2FnZSk7XG4gICAgdGhpcy5uYW1lID0gJ1dvcmtlckNhbGxFcnJvcic7XG4gICAgdGhpcy5yZW1vdGVOYW1lID0gZXJyb3IubmFtZTtcbiAgICB0aGlzLnJlbW90ZVN0YWNrID0gZXJyb3Iuc3RhY2s7XG4gIH1cbn1cblxuLyoqXG4gKiBPd25zIG9uZSBgV29ya2VyYCBmb3IgdGhlIGNvbXBvbmVudCdzIGxpZmV0aW1lLlxuICpcbiAqIE9uIGxvYWQgaXQgdHVybnMgdGhlIGJ1bmRsZWQgc291cmNlIGludG8gYSBCbG9iIFVSTCBhbmQgc3RhcnRzIHRoZSB3b3JrZXI7IG9uIHVubG9hZCBpdCB0ZXJtaW5hdGVzIHRoZSB3b3JrZXIsXG4gKiByZXZva2VzIHRoZSBVUkwgYW5kIHJlamVjdHMgZXZlcnkgcGVuZGluZyBjYWxsLiBBZGQgaXQgYXMgYSBjaGlsZCBvZiB0aGUgcGx1Z2luIChvciBvZiBhbnkgY29tcG9uZW50KSwgc28gdGhlIHdvcmtlclxuICogbmV2ZXIgb3V0bGl2ZXMgd2hhdCB1c2VzIGl0LlxuICpcbiAqIFRoZSB3b3JrZXIgZW50cnkgcG9pbnQgY2FsbHMgYGV4cG9zZVdvcmtlckFwaWAgZnJvbSBgQG1uYW91bW92L29ic2lkaWFuLWxpYi93b3JrZXItcHJvdG9jb2xgLCBhbmRcbiAqIHtAbGluayBXb3JrZXJDb21wb25lbnQuY2FsbH0gcmVhY2hlcyBpdHMgaGFuZGxlcnMgYnkgbmFtZSwgdHlwZWQgYnkgYFRBcGlgLlxuICpcbiAqIEB0eXBlUGFyYW0gVEFwaSAtIFRoZSBBUEkgdGhlIHdvcmtlciBleHBvc2VzLlxuICovXG5leHBvcnQgY2xhc3MgV29ya2VyQ29tcG9uZW50PFRBcGkgZXh0ZW5kcyBXb3JrZXJBcGk8VEFwaT4+IGV4dGVuZHMgQ29tcG9uZW50RXgge1xuICAvKipcbiAgICogV2hldGhlciBjYWxscyBydW4gb24gdGhlIG1haW4gdGhyZWFkLCBiZWNhdXNlIG5vIGBXb3JrZXJgIGNvdWxkIGJlIGNyZWF0ZWQgYW5kIGZhbGxiYWNrIGhhbmRsZXJzIHdlcmUgZ2l2ZW4uXG4gICAqXG4gICAqIEByZXR1cm5zIFdoZXRoZXIgdGhlIGZhbGxiYWNrIGlzIGluIHVzZS5cbiAgICovXG4gIHB1YmxpYyBnZXQgaXNVc2luZ0ZhbGxiYWNrKCk6IGJvb2xlYW4ge1xuICAgIHJldHVybiB0aGlzLmFjdGl2ZUZhbGxiYWNrSGFuZGxlcnMgIT09IG51bGw7XG4gIH1cblxuICAvKipcbiAgICogVGhlIG51bWJlciBvZiBjYWxscyB0aGF0IGhhdmUgbm90IHNldHRsZWQgeWV0LlxuICAgKlxuICAgKiBAcmV0dXJucyBUaGUgY291bnQuXG4gICAqL1xuICBwdWJsaWMgZ2V0IHBlbmRpbmdDYWxsQ291bnQoKTogbnVtYmVyIHtcbiAgICByZXR1cm4gdGhpcy5fcGVuZGluZ0NhbGxDb3VudDtcbiAgfVxuXG4gIC8qKlxuICAgKiBUaGUgaGFuZGxlcnMgdG8gcnVuIG9uIHRoZSBtYWluIHRocmVhZCB3aGVuIG5vIGBXb3JrZXJgIGNhbiBiZSBjcmVhdGVkLCBvciBgbnVsbGAuXG4gICAqL1xuICBwcm90ZWN0ZWQgcmVhZG9ubHkgZmFsbGJhY2tIYW5kbGVyczogbnVsbCB8IFdvcmtlckFwaUhhbmRsZXJzPFRBcGk+O1xuXG4gIC8qKlxuICAgKiBUaGUgd29ya2VyJ3MgbmFtZSwgb3IgYG51bGxgLlxuICAgKi9cbiAgcHJvdGVjdGVkIHJlYWRvbmx5IG5hbWU6IG51bGwgfCBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRoZSBidW5kbGVkIHdvcmtlciBzb3VyY2UuXG4gICAqL1xuICBwcm90ZWN0ZWQgcmVhZG9ubHkgc291cmNlOiBzdHJpbmc7XG5cbiAgcHJpdmF0ZSBfcGVuZGluZ0NhbGxDb3VudCA9IDA7XG4gIHByaXZhdGUgYWN0aXZlRmFsbGJhY2tIYW5kbGVyczogbnVsbCB8IFdvcmtlckFwaUhhbmRsZXJzPFRBcGk+ID0gbnVsbDtcbiAgcHJpdmF0ZSBsYXN0Q2FsbElkID0gMDtcbiAgcHJpdmF0ZSByZWFkb25seSBwZW5kaW5nQ2FsbHMgPSBuZXcgTWFwPG51bWJlciwgUGVuZGluZ0NhbGw+KCk7XG4gIC8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSBuL25vLXVuc3VwcG9ydGVkLWZlYXR1cmVzL25vZGUtYnVpbHRpbnMgLS0gVGhlIHJlbmRlcmVyJ3MgV2ViIFdvcmtlciwgbm90IE5vZGUncy5cbiAgcHJpdmF0ZSB3b3JrZXI6IG51bGwgfCBXb3JrZXIgPSBudWxsO1xuICBwcml2YXRlIHdvcmtlclVybDogbnVsbCB8IHN0cmluZyA9IG51bGw7XG5cbiAgLyoqXG4gICAqIENyZWF0ZXMgdGhlIGNvbXBvbmVudC5cbiAgICpcbiAgICogQHBhcmFtIHBhcmFtcyAtIFRoZSBwYXJhbWV0ZXJzLlxuICAgKi9cbiAgcHVibGljIGNvbnN0cnVjdG9yKHBhcmFtczogV29ya2VyQ29tcG9uZW50Q29uc3RydWN0b3JQYXJhbXM8VEFwaT4pIHtcbiAgICBzdXBlcigpO1xuICAgIHRoaXMuZmFsbGJhY2tIYW5kbGVycyA9IHBhcmFtcy5mYWxsYmFja0hhbmRsZXJzID8/IG51bGw7XG4gICAgdGhpcy5uYW1lID0gcGFyYW1zLm5hbWUgPz8gbnVsbDtcbiAgICB0aGlzLnNvdXJjZSA9IHBhcmFtcy5zb3VyY2U7XG4gIH1cblxuICAvKipcbiAgICogQ2FsbHMgYSB3b3JrZXIgbWV0aG9kLlxuICAgKlxuICAgKiBAdHlwZVBhcmFtIFRNZXRob2QgLSBUaGUgbWV0aG9kLlxuICAgKiBAcGFyYW0gbWV0aG9kIC0gVGhlIG1ldGhvZCBuYW1lLlxuICAgKiBAcGFyYW0gY2FsbEFyZ3VtZW50cyAtIFRoZSBtZXRob2QncyBhcmd1bWVudHMuXG4gICAqIEBwYXJhbSBvcHRpb25zIC0gVGhlIGNhbGwgb3B0aW9ucy5cbiAgICogQHJldHVybnMgVGhlIG1ldGhvZCdzIHJlc3VsdC4gUmVqZWN0cyB3aXRoIGEge0BsaW5rIFdvcmtlckNhbGxFcnJvcn0gd2hlbiB0aGUgaGFuZGxlciBmYWlsZWQsIHdpdGggdGhlIGFib3J0IHJlYXNvblxuICAgKiAgIHdoZW4gdGhlIGNhbGwgd2FzIGNhbmNlbGxlZCwgYW5kIHdpdGggYW4gYEVycm9yYCB3aGVuIHRoZSB3b3JrZXIgZmFpbGVkIG9yIHRoZSBjb21wb25lbnQgdW5sb2FkZWQgZmlyc3QuXG4gICAqL1xuICBwdWJsaWMgYXN5bmMgY2FsbDxUTWV0aG9kIGV4dGVuZHMgV29ya2VyTWV0aG9kPFRBcGk+PihcbiAgICBtZXRob2Q6IFRNZXRob2QsXG4gICAgY2FsbEFyZ3VtZW50czogUGFyYW1ldGVyczxUQXBpW1RNZXRob2RdPixcbiAgICBvcHRpb25zOiBXb3JrZXJDb21wb25lbnRDYWxsT3B0aW9ucyA9IHt9XG4gICk6IFByb21pc2U8V29ya2VyTWV0aG9kUmVzdWx0PFRBcGksIFRNZXRob2Q+PiB7XG4gICAgaWYgKCF0aGlzLl9sb2FkZWQpIHtcbiAgICAgIHRocm93IG5ldyBFcnJvcignVGhlIHdvcmtlciBjb21wb25lbnQgaXMgbm90IGxvYWRlZCcpO1xuICAgIH1cbiAgICBjb25zdCBhYm9ydFNpZ25hbCA9IG9wdGlvbnMuYWJvcnRTaWduYWwgPz8gbmV3IEFib3J0Q29udHJvbGxlcigpLnNpZ25hbDtcbiAgICBhYm9ydFNpZ25hbC50aHJvd0lmQWJvcnRlZCgpO1xuXG4gICAgdGhpcy5fcGVuZGluZ0NhbGxDb3VudCsrO1xuICAgIHRyeSB7XG4gICAgICBjb25zdCByZXN1bHQgPSB0aGlzLmFjdGl2ZUZhbGxiYWNrSGFuZGxlcnMgPT09IG51bGxcbiAgICAgICAgPyBhd2FpdCB0aGlzLmNhbGxXb3JrZXIobWV0aG9kLCBjYWxsQXJndW1lbnRzLCBhYm9ydFNpZ25hbCwgb3B0aW9ucy50cmFuc2ZlciA/PyBbXSlcbiAgICAgICAgOiBhd2FpdCBjYWxsRmFsbGJhY2sodGhpcy5hY3RpdmVGYWxsYmFja0hhbmRsZXJzLCBtZXRob2QsIGNhbGxBcmd1bWVudHMsIGFib3J0U2lnbmFsKTtcbiAgICAgIHJldHVybiByZXN1bHQgYXMgV29ya2VyTWV0aG9kUmVzdWx0PFRBcGksIFRNZXRob2Q+O1xuICAgIH0gZmluYWxseSB7XG4gICAgICB0aGlzLl9wZW5kaW5nQ2FsbENvdW50LS07XG4gICAgfVxuICB9XG5cbiAgLyoqXG4gICAqIFN0YXJ0cyB0aGUgd29ya2VyLlxuICAgKi9cbiAgcHVibGljIG92ZXJyaWRlIG9ubG9hZCgpOiB2b2lkIHtcbiAgICBzdXBlci5vbmxvYWQoKTtcbiAgICB0cnkge1xuICAgICAgdGhpcy5zdGFydFdvcmtlcigpO1xuICAgIH0gY2F0Y2ggKGVycm9yKSB7XG4gICAgICB0aGlzLnN0b3BXb3JrZXIoKTtcbiAgICAgIGlmICh0aGlzLmZhbGxiYWNrSGFuZGxlcnMgPT09IG51bGwpIHtcbiAgICAgICAgdGhyb3cgZXJyb3I7XG4gICAgICB9XG4gICAgICB0aGlzLmFjdGl2ZUZhbGxiYWNrSGFuZGxlcnMgPSB0aGlzLmZhbGxiYWNrSGFuZGxlcnM7XG4gICAgfVxuICB9XG5cbiAgLyoqXG4gICAqIFRlcm1pbmF0ZXMgdGhlIHdvcmtlciBhbmQgcmVqZWN0cyB0aGUgcGVuZGluZyBjYWxscy5cbiAgICovXG4gIHB1YmxpYyBvdmVycmlkZSBvbnVubG9hZCgpOiB2b2lkIHtcbiAgICBzdXBlci5vbnVubG9hZCgpO1xuICAgIHRoaXMuc3RvcFdvcmtlcigpO1xuICAgIHRoaXMucmVqZWN0QWxsKG5ldyBFcnJvcignVGhlIHdvcmtlciBjb21wb25lbnQgd2FzIHVubG9hZGVkJykpO1xuICAgIHRoaXMuYWN0aXZlRmFsbGJhY2tIYW5kbGVycyA9IG51bGw7XG4gIH1cblxuICBwcml2YXRlIGFzeW5jIGNhbGxXb3JrZXIoXG4gICAgbWV0aG9kOiBzdHJpbmcsXG4gICAgY2FsbEFyZ3VtZW50czogcmVhZG9ubHkgdW5rbm93bltdLFxuICAgIGFib3J0U2lnbmFsOiBBYm9ydFNpZ25hbCxcbiAgICB0cmFuc2ZlcjogcmVhZG9ubHkgVHJhbnNmZXJhYmxlW11cbiAgKTogUHJvbWlzZTx1bmtub3duPiB7XG4gICAgLy8gQSBsb2FkZWQgY29tcG9uZW50IHdpdGhvdXQgZmFsbGJhY2sgaGFuZGxlcnMgaW4gdXNlIGFsd2F5cyBob2xkcyBpdHMgd29ya2VyLlxuICAgIGNvbnN0IHdvcmtlciA9IGVuc3VyZU5vbk51bGxhYmxlKHRoaXMud29ya2VyKTtcblxuICAgIHRoaXMubGFzdENhbGxJZCsrO1xuICAgIGNvbnN0IGlkID0gdGhpcy5sYXN0Q2FsbElkO1xuICAgIGxldCBvbkFib3J0ID0gbm9vcDtcblxuICAgIHRyeSB7XG4gICAgICByZXR1cm4gYXdhaXQgbmV3IFByb21pc2U8dW5rbm93bj4oKHJlc29sdmUsIHJlamVjdCkgPT4ge1xuICAgICAgICBvbkFib3J0ID0gKCk6IHZvaWQgPT4ge1xuICAgICAgICAgIGlmICghdGhpcy5wZW5kaW5nQ2FsbHMuZGVsZXRlKGlkKSkge1xuICAgICAgICAgICAgcmV0dXJuO1xuICAgICAgICAgIH1cbiAgICAgICAgICBjb25zdCBjYW5jZWxNZXNzYWdlOiBXb3JrZXJDYW5jZWxNZXNzYWdlID0geyBpZCwga2luZDogJ2NhbmNlbCcsIHByb3RvY29sOiBXT1JLRVJfUFJPVE9DT0wgfTtcbiAgICAgICAgICB3b3JrZXIucG9zdE1lc3NhZ2UoY2FuY2VsTWVzc2FnZSk7XG4gICAgICAgICAgcmVqZWN0KGdldEFib3J0UmVhc29uKGFib3J0U2lnbmFsKSk7XG4gICAgICAgIH07XG4gICAgICAgIHRoaXMucGVuZGluZ0NhbGxzLnNldChpZCwgeyByZWplY3QsIHJlc29sdmUgfSk7XG4gICAgICAgIGNvbnN0IGNhbGxNZXNzYWdlOiBXb3JrZXJDYWxsTWVzc2FnZSA9IHsgYXJndW1lbnRzOiBjYWxsQXJndW1lbnRzLCBpZCwga2luZDogJ2NhbGwnLCBtZXRob2QsIHByb3RvY29sOiBXT1JLRVJfUFJPVE9DT0wgfTtcbiAgICAgICAgdHJ5IHtcbiAgICAgICAgICB3b3JrZXIucG9zdE1lc3NhZ2UoY2FsbE1lc3NhZ2UsIFsuLi50cmFuc2Zlcl0pO1xuICAgICAgICB9IGNhdGNoIChlcnJvcikge1xuICAgICAgICAgIHRoaXMucGVuZGluZ0NhbGxzLmRlbGV0ZShpZCk7XG4gICAgICAgICAgcmVqZWN0KHRvRXJyb3IoZXJyb3IpKTtcbiAgICAgICAgICByZXR1cm47XG4gICAgICAgIH1cbiAgICAgICAgYWJvcnRTaWduYWwuYWRkRXZlbnRMaXN0ZW5lcignYWJvcnQnLCBvbkFib3J0LCB7IG9uY2U6IHRydWUgfSk7XG4gICAgICB9KTtcbiAgICB9IGZpbmFsbHkge1xuICAgICAgYWJvcnRTaWduYWwucmVtb3ZlRXZlbnRMaXN0ZW5lcignYWJvcnQnLCBvbkFib3J0KTtcbiAgICB9XG4gIH1cblxuICAvLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgbi9uby11bnN1cHBvcnRlZC1mZWF0dXJlcy9ub2RlLWJ1aWx0aW5zIC0tIFRoZSByZW5kZXJlcidzIFdlYiBFcnJvckV2ZW50LCBub3QgTm9kZSdzLlxuICBwcml2YXRlIHJlYWRvbmx5IGhhbmRsZUVycm9yID0gKCRldmVudDogRXJyb3JFdmVudCk6IHZvaWQgPT4ge1xuICAgICRldmVudC5wcmV2ZW50RGVmYXVsdCgpO1xuICAgIHRoaXMucmVqZWN0QWxsKG5ldyBFcnJvcihgVGhlIHdvcmtlciBmYWlsZWQ6ICR7JGV2ZW50Lm1lc3NhZ2UgfHwgJ3Vua25vd24gZXJyb3InfWApKTtcbiAgfTtcblxuICBwcml2YXRlIHJlYWRvbmx5IGhhbmRsZU1lc3NhZ2UgPSAoJGV2ZW50OiBNZXNzYWdlRXZlbnQ8dW5rbm93bj4pOiB2b2lkID0+IHtcbiAgICBjb25zdCBtZXNzYWdlID0gJGV2ZW50LmRhdGE7XG4gICAgaWYgKCFpc1dvcmtlclJlc3BvbnNlTWVzc2FnZShtZXNzYWdlKSkge1xuICAgICAgcmV0dXJuO1xuICAgIH1cbiAgICBjb25zdCBwZW5kaW5nQ2FsbCA9IHRoaXMucGVuZGluZ0NhbGxzLmdldChtZXNzYWdlLmlkKTtcbiAgICBpZiAoIXBlbmRpbmdDYWxsKSB7XG4gICAgICByZXR1cm47XG4gICAgfVxuICAgIHRoaXMucGVuZGluZ0NhbGxzLmRlbGV0ZShtZXNzYWdlLmlkKTtcbiAgICBpZiAobWVzc2FnZS5raW5kID09PSAncmVzdWx0Jykge1xuICAgICAgcGVuZGluZ0NhbGwucmVzb2x2ZShtZXNzYWdlLnZhbHVlKTtcbiAgICB9IGVsc2Uge1xuICAgICAgcGVuZGluZ0NhbGwucmVqZWN0KG5ldyBXb3JrZXJDYWxsRXJyb3IobWVzc2FnZS5lcnJvcikpO1xuICAgIH1cbiAgfTtcblxuICBwcml2YXRlIHJlYWRvbmx5IGhhbmRsZU1lc3NhZ2VFcnJvciA9ICgpOiB2b2lkID0+IHtcbiAgICB0aGlzLnJlamVjdEFsbChuZXcgRXJyb3IoJ1RoZSB3b3JrZXIgc2VudCBhIG1lc3NhZ2UgdGhhdCBjb3VsZCBub3QgYmUgZGVzZXJpYWxpemVkJykpO1xuICB9O1xuXG4gIHByaXZhdGUgcmVqZWN0QWxsKHJlYXNvbjogRXJyb3IpOiB2b2lkIHtcbiAgICBjb25zdCBwZW5kaW5nQ2FsbHMgPSBbLi4udGhpcy5wZW5kaW5nQ2FsbHMudmFsdWVzKCldO1xuICAgIHRoaXMucGVuZGluZ0NhbGxzLmNsZWFyKCk7XG4gICAgZm9yIChjb25zdCBwZW5kaW5nQ2FsbCBvZiBwZW5kaW5nQ2FsbHMpIHtcbiAgICAgIHBlbmRpbmdDYWxsLnJlamVjdChyZWFzb24pO1xuICAgIH1cbiAgfVxuXG4gIHByaXZhdGUgcmV2b2tlV29ya2VyVXJsKCk6IHZvaWQge1xuICAgIGlmICh0aGlzLndvcmtlclVybCA9PT0gbnVsbCkge1xuICAgICAgcmV0dXJuO1xuICAgIH1cbiAgICB3aW5kb3cuVVJMLnJldm9rZU9iamVjdFVSTCh0aGlzLndvcmtlclVybCk7XG4gICAgdGhpcy53b3JrZXJVcmwgPSBudWxsO1xuICB9XG5cbiAgcHJpdmF0ZSBzdGFydFdvcmtlcigpOiB2b2lkIHtcbiAgICB0aGlzLndvcmtlclVybCA9IHdpbmRvdy5VUkwuY3JlYXRlT2JqZWN0VVJMKG5ldyBCbG9iKFt0aGlzLnNvdXJjZV0sIHsgdHlwZTogJ3RleHQvamF2YXNjcmlwdCcgfSkpO1xuICAgIGNvbnN0IHdvcmtlck9wdGlvbnM6IFdvcmtlck9wdGlvbnMgPSB0aGlzLm5hbWUgPT09IG51bGwgPyB7fSA6IHsgbmFtZTogdGhpcy5uYW1lIH07XG4gICAgY29uc3Qgd29ya2VyID0gbmV3IHdpbmRvdy5Xb3JrZXIodGhpcy53b3JrZXJVcmwsIHdvcmtlck9wdGlvbnMpO1xuICAgIHRoaXMud29ya2VyID0gd29ya2VyO1xuICAgIHdvcmtlci5hZGRFdmVudExpc3RlbmVyKCdtZXNzYWdlJywgdGhpcy5oYW5kbGVNZXNzYWdlKTtcbiAgICB3b3JrZXIuYWRkRXZlbnRMaXN0ZW5lcignbWVzc2FnZWVycm9yJywgdGhpcy5oYW5kbGVNZXNzYWdlRXJyb3IpO1xuICAgIHdvcmtlci5hZGRFdmVudExpc3RlbmVyKCdlcnJvcicsIHRoaXMuaGFuZGxlRXJyb3IpO1xuICB9XG5cbiAgcHJpdmF0ZSBzdG9wV29ya2VyKCk6IHZvaWQge1xuICAgIHRoaXMudGVybWluYXRlV29ya2VyKCk7XG4gICAgdGhpcy5yZXZva2VXb3JrZXJVcmwoKTtcbiAgfVxuXG4gIHByaXZhdGUgdGVybWluYXRlV29ya2VyKCk6IHZvaWQge1xuICAgIGlmICghdGhpcy53b3JrZXIpIHtcbiAgICAgIHJldHVybjtcbiAgICB9XG4gICAgdGhpcy53b3JrZXIucmVtb3ZlRXZlbnRMaXN0ZW5lcignbWVzc2FnZScsIHRoaXMuaGFuZGxlTWVzc2FnZSk7XG4gICAgdGhpcy53b3JrZXIucmVtb3ZlRXZlbnRMaXN0ZW5lcignbWVzc2FnZWVycm9yJywgdGhpcy5oYW5kbGVNZXNzYWdlRXJyb3IpO1xuICAgIHRoaXMud29ya2VyLnJlbW92ZUV2ZW50TGlzdGVuZXIoJ2Vycm9yJywgdGhpcy5oYW5kbGVFcnJvcik7XG4gICAgdGhpcy53b3JrZXIudGVybWluYXRlKCk7XG4gICAgdGhpcy53b3JrZXIgPSBudWxsO1xuICB9XG59XG5cbmFzeW5jIGZ1bmN0aW9uIGNhbGxGYWxsYmFjayhcbiAgaGFuZGxlcnM6IG9iamVjdCxcbiAgbWV0aG9kOiBzdHJpbmcsXG4gIGNhbGxBcmd1bWVudHM6IHJlYWRvbmx5IHVua25vd25bXSxcbiAgY2FsbGVyU2lnbmFsOiBBYm9ydFNpZ25hbFxuKTogUHJvbWlzZTx1bmtub3duPiB7XG4gIGNvbnN0IGFib3J0Q29udHJvbGxlciA9IG5ldyBBYm9ydENvbnRyb2xsZXIoKTtcbiAgZnVuY3Rpb24gb25BYm9ydCgpOiB2b2lkIHtcbiAgICBhYm9ydENvbnRyb2xsZXIuYWJvcnQoY2FsbGVyU2lnbmFsLnJlYXNvbik7XG4gIH1cbiAgY2FsbGVyU2lnbmFsLmFkZEV2ZW50TGlzdGVuZXIoJ2Fib3J0Jywgb25BYm9ydCwgeyBvbmNlOiB0cnVlIH0pO1xuICB0cnkge1xuICAgIGNvbnN0IGhhbmRsZXJQcm9taXNlID0gaW52b2tlV29ya2VySGFuZGxlcihoYW5kbGVycywgbWV0aG9kLCBjYWxsQXJndW1lbnRzLCB7IGFib3J0U2lnbmFsOiBhYm9ydENvbnRyb2xsZXIuc2lnbmFsIH0pO1xuICAgIC8vIFRoZSByYWNlIGJlbG93IG1heSBzZXR0bGUgb24gdGhlIGFib3J0IGZpcnN0OyB0aGUgaGFuZGxlcidzIG93biBsYXRlciByZWplY3Rpb24gaXMgdGhlbiBub2JvZHkncyB0byByZXBvcnQuXG4gICAgaGFuZGxlclByb21pc2UuY2F0Y2gobm9vcCk7XG4gICAgY29uc3QgYWJvcnRQcm9taXNlID0gbmV3IFByb21pc2U8bmV2ZXI+KChfcmVzb2x2ZSwgcmVqZWN0KSA9PiB7XG4gICAgICBhYm9ydENvbnRyb2xsZXIuc2lnbmFsLmFkZEV2ZW50TGlzdGVuZXIoJ2Fib3J0JywgKCkgPT4ge1xuICAgICAgICByZWplY3QoZ2V0QWJvcnRSZWFzb24oYWJvcnRDb250cm9sbGVyLnNpZ25hbCkpO1xuICAgICAgfSwgeyBvbmNlOiB0cnVlIH0pO1xuICAgIH0pO1xuICAgIHJldHVybiB1bndyYXBUcmFuc2ZlcnJlZFZhbHVlKGF3YWl0IFByb21pc2UucmFjZShbaGFuZGxlclByb21pc2UsIGFib3J0UHJvbWlzZV0pKS52YWx1ZTtcbiAgfSBmaW5hbGx5IHtcbiAgICBjYWxsZXJTaWduYWwucmVtb3ZlRXZlbnRMaXN0ZW5lcignYWJvcnQnLCBvbkFib3J0KTtcbiAgfVxufVxuXG5mdW5jdGlvbiBnZXRBYm9ydFJlYXNvbihhYm9ydFNpZ25hbDogQWJvcnRTaWduYWwpOiBFcnJvciB7XG4gIHJldHVybiB0b0Vycm9yKGFib3J0U2lnbmFsLnJlYXNvbik7XG59XG5cbmZ1bmN0aW9uIHRvRXJyb3IocmVhc29uOiB1bmtub3duKTogRXJyb3Ige1xuICByZXR1cm4gcmVhc29uIGluc3RhbmNlb2YgRXJyb3IgPyByZWFzb24gOiBuZXcgRXJyb3IoU3RyaW5nKHJlYXNvbikpO1xufVxuIl0sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQU9BLFNBQVMsWUFBWTtBQUNyQixTQUFTLHlCQUF5QjtBQVVsQztBQUFBLEVBQ0U7QUFBQSxFQUNBO0FBQUEsRUFDQTtBQUFBLEVBQ0E7QUFB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

package/dist/lib/esm/components/worker-pool-component.d.mts

@@ -0,0 +1,102 @@
+/// <reference path="../library-references.d.mts" />
+/// <reference lib="dom" />
+/**
+ * @file
+ *
+ * A component that owns several workers built from the same bundled source and spreads calls over them.
+ */
+import type { WorkerApi, WorkerApiHandlers } from '../worker-protocol.mjs';
+import type { WorkerComponentCallOptions, WorkerMethod, WorkerMethodResult } from './worker-component.mjs';
+import { ComponentEx } from './component-ex.mjs';
+import { WorkerComponent } from './worker-component.mjs';
+/**
+ * The most workers {@link getDefaultWorkerPoolSize} suggests, so a pool on a many-core desktop does not starve
+ * Obsidian's own renderer of memory.
+ */
+export declare const MAX_DEFAULT_WORKER_POOL_SIZE = 4;
+/**
+ * Options of {@link WorkerPoolComponent.call}: the same as {@link WorkerComponent.call}'s.
+ */
+export type WorkerPoolComponentCallOptions = WorkerComponentCallOptions;
+/**
+ * Parameters of {@link WorkerPoolComponent}.
+ *
+ * @typeParam TApi - The API every worker exposes.
+ */
+export interface WorkerPoolComponentConstructorParams<TApi extends WorkerApi<TApi>> {
+    /**
+     * The handlers to run on the main thread when no `Worker` can be created. See {@link WorkerComponent}.
+     */
+    readonly fallbackHandlers?: WorkerApiHandlers<TApi>;
+    /**
+     * The workers' name prefix, shown by the developer tools; each worker gets `<name> <index>`.
+     */
+    readonly name?: string;
+    /**
+     * The number of workers. Defaults to {@link getDefaultWorkerPoolSize}.
+     */
+    readonly size?: number;
+    /**
+     * The bundled worker source.
+     */
+    readonly source: string;
+}
+/**
+ * Owns a fixed number of {@link WorkerComponent} children and sends each call to the one with the fewest pending calls.
+ *
+ * Use it for CPU-bound jobs that split into independent calls. A job that keeps state in a worker (a loaded corpus, an
+ * instantiated module) addresses each worker by index through {@link WorkerPoolComponent.getWorker} instead.
+ *
+ * @typeParam TApi - The API every worker exposes.
+ */
+export declare class WorkerPoolComponent<TApi extends WorkerApi<TApi>> extends ComponentEx {
+    protected readonly params: WorkerPoolComponentConstructorParams<TApi>;
+    /**
+     * The number of workers.
+     *
+     * @returns The size.
+     */
+    get size(): number;
+    private readonly workers;
+    /**
+     * Creates the pool.
+     *
+     * @param params - The parameters.
+     */
+    constructor(params: WorkerPoolComponentConstructorParams<TApi>);
+    /**
+     * Calls a method on the least busy worker.
+     *
+     * @typeParam TMethod - The method.
+     * @param method - The method name.
+     * @param callArguments - The method's arguments.
+     * @param options - The call options.
+     * @returns The method's result.
+     */
+    call<TMethod extends WorkerMethod<TApi>>(method: TMethod, callArguments: Parameters<TApi[TMethod]>, options?: WorkerPoolComponentCallOptions): Promise<WorkerMethodResult<TApi, TMethod>>;
+    /**
+     * Calls a method on every worker with the same arguments, for instance to configure them all.
+     *
+     * @typeParam TMethod - The method.
+     * @param method - The method name.
+     * @param callArguments - The method's arguments, cloned for each worker; nothing can be transferred to all of them.
+     * @param abortSignal - Cancels every call.
+     * @returns The results, in worker order.
+     */
+    callAll<TMethod extends WorkerMethod<TApi>>(method: TMethod, callArguments: Parameters<TApi[TMethod]>, abortSignal?: AbortSignal): Promise<WorkerMethodResult<TApi, TMethod>[]>;
+    /**
+     * Gets one worker, for jobs that keep state in a particular worker.
+     *
+     * @param index - The worker index, from `0` to {@link WorkerPoolComponent.size} minus one.
+     * @returns The worker.
+     */
+    getWorker(index: number): WorkerComponent<TApi>;
+}
+/**
+ * Suggests a pool size: one fewer than the logical processors, so the main thread keeps one, between `1` and
+ * {@link MAX_DEFAULT_WORKER_POOL_SIZE}.
+ *
+ * @param hardwareConcurrency - The number of logical processors. Defaults to `navigator.hardwareConcurrency`.
+ * @returns The suggested size.
+ */
+export declare function getDefaultWorkerPoolSize(hardwareConcurrency?: number): number;