@mnaoumov/obsidian-lib 10.11.0 → 11.0.0

package/dist/lib/cjs/components/worker-component.cjs

@@ -0,0 +1,363 @@
+/*
+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();
+})();
+(function patchObsidianRequire() {
+  const originalRequire = require;
+  if (!originalRequire || originalRequire.__isPatched) {
+    return;
+  }
+  require = Object.assign(
+    (id) => requirePatched(id),
+    originalRequire,
+    {
+      __isPatched: true
+    }
+  );
+  function extractDefault($module) {
+    return $module && $module.__esModule && "default" in $module ? $module.default : $module;
+  }
+  const OBSIDIAN_BUILT_IN_MODULE_NAMES = /* @__PURE__ */ new Set([
+    "@codemirror/autocomplete",
+    "@codemirror/collab",
+    "@codemirror/commands",
+    "@codemirror/language",
+    "@codemirror/lint",
+    "@codemirror/search",
+    "@codemirror/state",
+    "@codemirror/text",
+    "@codemirror/view",
+    "@lezer/common",
+    "@lezer/highlight",
+    "@lezer/lr",
+    "obsidian"
+  ]);
+  const DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES = /* @__PURE__ */ new Set([
+    "@codemirror/closebrackets",
+    "@codemirror/comment",
+    "@codemirror/fold",
+    "@codemirror/gutter",
+    "@codemirror/highlight",
+    "@codemirror/history",
+    "@codemirror/matchbrackets",
+    "@codemirror/panel",
+    "@codemirror/rangeset",
+    "@codemirror/rectangular-selection",
+    "@codemirror/stream-parser",
+    "@codemirror/tooltip"
+  ]);
+  function requirePatched(id) {
+    if (OBSIDIAN_BUILT_IN_MODULE_NAMES.has(id) || DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES.has(id)) {
+      return originalRequire?.(id);
+    }
+    const app = globalThis.app;
+    if (app?.isMobile) {
+      if (id === "process" || id === "node:process") {
+        console.debug(`The most likely you can safely ignore this error. Module not found: ${id}. Fake process object is returned instead.`);
+        return process;
+      }
+    } else {
+      const $module = originalRequire?.(id);
+      if ($module) {
+        return extractDefault($module);
+      }
+    }
+    console.debug(`The most likely you can safely ignore this error. Module not found: ${id}. Empty object is returned instead.`);
+    return {};
+  }
+})();
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var worker_component_exports = {};
+__export(worker_component_exports, {
+  WorkerCallError: () => WorkerCallError,
+  WorkerComponent: () => WorkerComponent
+});
+module.exports = __toCommonJS(worker_component_exports);
+var import_function = require("@mnaoumov/typescript-lib/function");
+var import_type_guards = require("@mnaoumov/typescript-lib/type-guards");
+var import_worker_protocol = require("../worker-protocol.cjs");
+var import_component_ex = require("./component-ex.cjs");
+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 import_component_ex.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 = (0, import_type_guards.ensureNonNullable)(this.worker);
+    this.lastCallId++;
+    const id = this.lastCallId;
+    let onAbort = import_function.noop;
+    try {
+      return await new Promise((resolve, reject) => {
+        onAbort = () => {
+          if (!this.pendingCalls.delete(id)) {
+            return;
+          }
+          const cancelMessage = { id, kind: "cancel", protocol: import_worker_protocol.WORKER_PROTOCOL };
+          worker.postMessage(cancelMessage);
+          reject(getAbortReason(abortSignal));
+        };
+        this.pendingCalls.set(id, { reject, resolve });
+        const callMessage = { arguments: callArguments, id, kind: "call", method, protocol: import_worker_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 (!(0, import_worker_protocol.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 = (0, import_worker_protocol.invokeWorkerHandler)(handlers, method, callArguments, { abortSignal: abortController.signal });
+    handlerPromise.catch(import_function.noop);
+    const abortPromise = new Promise((_resolve, reject) => {
+      abortController.signal.addEventListener("abort", () => {
+        reject(getAbortReason(abortController.signal));
+      }, { once: true });
+    });
+    return (0, import_worker_protocol.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));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  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+KChfcmVzb2x2ZSwgcmVqZWN0KSA9PiB7XG4gICAgICBhYm9ydENvbnRyb2xsZXIuc2lnbmFsLmFkZEV2ZW50TGlzdGVuZXIoJ2Fib3J0JywgKCkgPT4ge1xuICAgICAgICByZWplY3QoZ2V0QWJvcnRSZWFzb24oYWJvcnRDb250cm9sbGVyLnNpZ25hbCkpO1xuICAgICAgfSwgeyBvbmNlOiB0cnVlIH0pO1xuICAgIH0pO1xuICAgIHJldHVybiB1bndyYXBUcmFuc2ZlcnJlZFZhbHVlKGF3YWl0IFByb21pc2UucmFjZShbaGFuZGxlclByb21pc2UsIGFib3J0UHJvbWlzZV0pKS52YWx1ZTtcbiAgfSBmaW5hbGx5IHtcbiAgICBjYWxsZXJTaWduYWwucmVtb3ZlRXZlbnRMaXN0ZW5lcignYWJvcnQnLCBvbkFib3J0KTtcbiAgfVxufVxuXG5mdW5jdGlvbiBnZXRBYm9ydFJlYXNvbihhYm9ydFNpZ25hbDogQWJvcnRTaWduYWwpOiBFcnJvciB7XG4gIHJldHVybiB0b0Vycm9yKGFib3J0U2lnbmFsLnJlYXNvbik7XG59XG5cbmZ1bmN0aW9uIHRvRXJyb3IocmVhc29uOiB1bmtub3duKTogRXJyb3Ige1xuICByZXR1cm4gcmVhc29uIGluc3RhbmNlb2YgRXJyb3IgPyByZWFzb24gOiBuZXcgRXJyb3IoU3RyaW5nKHJlYXNvbikpO1xufVxuIl0sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7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

package/dist/lib/cjs/components/worker-component.d.cts

@@ -0,0 +1,156 @@
+/// <reference path="../library-references.d.cts" />
+/// <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.cjs';
+import { ComponentEx } from './component-ex.cjs';
+/**
+ * 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;
+}