@ariestools/threads 8.0.0

package/dist/node/master/pool-node.mjs

@@ -0,0 +1,309 @@
+// src/master/pool-node.ts
+import DebugLogger from "debug";
+import {
+  multicast,
+  Observable,
+  Subject
+} from "observable-fns";
+
+// src/master/implementation.node.ts
+import { cpus } from "node:os";
+var defaultPoolSize = cpus().length;
+
+// src/master/pool-types.ts
+var PoolEventType = /* @__PURE__ */ ((PoolEventType2) => {
+  PoolEventType2["initialized"] = "initialized";
+  PoolEventType2["taskCanceled"] = "taskCanceled";
+  PoolEventType2["taskCompleted"] = "taskCompleted";
+  PoolEventType2["taskFailed"] = "taskFailed";
+  PoolEventType2["taskQueued"] = "taskQueued";
+  PoolEventType2["taskQueueDrained"] = "taskQueueDrained";
+  PoolEventType2["taskStart"] = "taskStart";
+  PoolEventType2["terminated"] = "terminated";
+  return PoolEventType2;
+})(PoolEventType || {});
+
+// src/symbols.ts
+var $errors = /* @__PURE__ */ Symbol("thread.errors");
+var $events = /* @__PURE__ */ Symbol("thread.events");
+var $terminate = /* @__PURE__ */ Symbol("thread.terminate");
+
+// src/master/thread.ts
+function fail(message) {
+  throw new Error(message);
+}
+function readPrivateThreadProp(thread, key) {
+  return Reflect.get(thread, key);
+}
+var Thread = {
+  /** Return an observable that can be used to subscribe to all errors happening in the thread. */
+  errors: (thread) => readPrivateThreadProp(thread, $errors) ?? fail("Error observable not found. Make sure to pass a thread instance as returned by the spawn() promise."),
+  /** Return an observable that can be used to subscribe to internal events happening in the thread. Useful for debugging. */
+  events: (thread) => readPrivateThreadProp(thread, $events) ?? fail("Events observable not found. Make sure to pass a thread instance as returned by the spawn() promise."),
+  /** Terminate a thread. Remember to terminate every thread when you are done using it. */
+  terminate: (thread) => readPrivateThreadProp(thread, $terminate)?.() ?? fail("Terminate function not found. Make sure to pass a thread instance as returned by the spawn() promise.")
+};
+
+// src/master/pool-node.ts
+var nextPoolID = 1;
+function createArray(size) {
+  const array = [];
+  for (let index = 0; index < size; index++) {
+    array.push(index);
+  }
+  return array;
+}
+function delay(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function flatMap(array, mapper) {
+  return array.reduce((flattened, element) => [...flattened, ...mapper(element)], []);
+}
+function slugify(text) {
+  return text.replaceAll(/\W/g, " ").trim().replaceAll(/\s+/g, "-");
+}
+function spawnWorkers(spawnWorker, count) {
+  return createArray(count).map(
+    () => ({
+      init: spawnWorker(),
+      runningTasks: []
+    })
+  );
+}
+var WorkerPool = class {
+  static EventType = PoolEventType;
+  debug;
+  eventObservable;
+  options;
+  workers;
+  eventSubject = new Subject();
+  initErrors = [];
+  isClosing = false;
+  nextTaskID = 1;
+  taskQueue = [];
+  constructor(spawnWorker, optionsOrSize) {
+    const options = typeof optionsOrSize === "number" ? { size: optionsOrSize } : optionsOrSize || {};
+    const { size = defaultPoolSize } = options;
+    this.debug = DebugLogger(`threads:pool:${slugify(options.name ?? String(nextPoolID++))}`);
+    this.options = options;
+    this.workers = spawnWorkers(spawnWorker, size);
+    this.eventObservable = multicast(Observable.from(this.eventSubject));
+    const debug = this.debug;
+    const workers = this.workers;
+    void (async () => {
+      try {
+        await Promise.all(workers.map((worker) => worker.init));
+        this.eventSubject.next({
+          size: workers.length,
+          type: "initialized" /* initialized */
+        });
+      } catch (error) {
+        const initError = error instanceof Error ? error : new Error(String(error));
+        debug("Error while initializing pool worker:", initError);
+        this.eventSubject.error(initError);
+        this.initErrors.push(initError);
+      }
+    })();
+  }
+  findIdlingWorker() {
+    const { concurrency = 1 } = this.options;
+    return this.workers.find((worker) => worker.runningTasks.length < concurrency);
+  }
+  async runPoolTask(worker, task) {
+    const workerID = this.workers.indexOf(worker) + 1;
+    this.debug(`Running task #${task.id} on worker #${workerID}...`);
+    this.eventSubject.next({
+      taskID: task.id,
+      type: "taskStart" /* taskStart */,
+      workerID
+    });
+    try {
+      const returnValue = await task.run(await worker.init);
+      this.debug(`Task #${task.id} completed successfully`);
+      this.eventSubject.next({
+        returnValue,
+        taskID: task.id,
+        type: "taskCompleted" /* taskCompleted */,
+        workerID
+      });
+    } catch (ex) {
+      const error = ex;
+      this.debug(`Task #${task.id} failed`);
+      this.eventSubject.next({
+        error,
+        taskID: task.id,
+        type: "taskFailed" /* taskFailed */,
+        workerID
+      });
+    }
+  }
+  run(worker, task) {
+    const runPromise = (async () => {
+      const removeTaskFromWorkersRunningTasks = () => {
+        worker.runningTasks = worker.runningTasks.filter((someRunPromise) => someRunPromise !== runPromise);
+      };
+      await delay(0);
+      try {
+        await this.runPoolTask(worker, task);
+      } finally {
+        removeTaskFromWorkersRunningTasks();
+        if (!this.isClosing) {
+          this.scheduleWork();
+        }
+      }
+    })();
+    worker.runningTasks.push(runPromise);
+  }
+  scheduleWork() {
+    this.debug("Attempt de-queueing a task in order to run it...");
+    const availableWorker = this.findIdlingWorker();
+    if (!availableWorker) return;
+    const nextTask = this.taskQueue.shift();
+    if (!nextTask) {
+      this.debug("Task queue is empty");
+      this.eventSubject.next({ type: "taskQueueDrained" /* taskQueueDrained */ });
+      return;
+    }
+    this.run(availableWorker, nextTask);
+  }
+  taskCompletion(taskID) {
+    return new Promise((resolve, reject) => {
+      const eventSubscription = this.events().subscribe((event) => {
+        if (event.type === "taskCompleted" /* taskCompleted */ && event.taskID === taskID) {
+          eventSubscription.unsubscribe();
+          resolve(event.returnValue);
+        } else if (event.type === "taskFailed" /* taskFailed */ && event.taskID === taskID) {
+          eventSubscription.unsubscribe();
+          reject(event.error);
+        } else if (event.type === "terminated" /* terminated */) {
+          eventSubscription.unsubscribe();
+          reject(new Error("Pool has been terminated before task was run."));
+        }
+      });
+    });
+  }
+  async settled(allowResolvingImmediately = false) {
+    if (this.initErrors.length > 0) {
+      throw this.initErrors[0];
+    }
+    if (allowResolvingImmediately && this.taskQueue.length === 0) {
+      await Promise.allSettled(flatMap(this.workers, (worker) => worker.runningTasks));
+      return [];
+    }
+    const getCurrentlyRunningTasks = () => flatMap(this.workers, (worker) => worker.runningTasks);
+    const taskFailures = [];
+    const failureSubscription = this.eventObservable.subscribe((event) => {
+      if (event.type === "taskFailed" /* taskFailed */) {
+        taskFailures.push(event.error);
+      }
+    });
+    await new Promise((resolve, reject) => {
+      const subscription = this.eventObservable.subscribe({
+        error: reject,
+        next(event) {
+          if (event.type !== "taskQueueDrained" /* taskQueueDrained */) {
+            return;
+          }
+          subscription.unsubscribe();
+          resolve(void 0);
+        }
+        // make a pool-wide error reject the completed() result promise
+      });
+    });
+    await Promise.allSettled(getCurrentlyRunningTasks());
+    failureSubscription.unsubscribe();
+    return taskFailures;
+  }
+  async completed(allowResolvingImmediately = false) {
+    const settlementPromise = this.settled(allowResolvingImmediately);
+    const earlyExitPromise = new Promise((resolve, reject) => {
+      const subscription = this.eventObservable.subscribe({
+        error: reject,
+        next(event) {
+          if (event.type === "taskQueueDrained" /* taskQueueDrained */) {
+            subscription.unsubscribe();
+            resolve(settlementPromise);
+          } else if (event.type === "taskFailed" /* taskFailed */) {
+            subscription.unsubscribe();
+            reject(event.error);
+          }
+        }
+        // make a pool-wide error reject the completed() result promise
+      });
+    });
+    const errors = await Promise.race([settlementPromise, earlyExitPromise]);
+    if (errors.length > 0) {
+      throw errors[0];
+    }
+  }
+  events() {
+    return this.eventObservable;
+  }
+  queue(taskFunction) {
+    const { maxQueuedJobs = Infinity } = this.options;
+    if (this.isClosing) {
+      throw new Error("Cannot schedule pool tasks after terminate() has been called.");
+    }
+    if (this.initErrors.length > 0) {
+      throw this.initErrors[0];
+    }
+    const taskID = this.nextTaskID++;
+    const taskCompletion = this.taskCompletion(taskID);
+    void (async () => {
+      try {
+        await taskCompletion;
+      } catch (error) {
+        this.debug(`Task #${taskID} errored:`, error);
+      }
+    })();
+    const task = {
+      cancel: () => {
+        if (!this.taskQueue.includes(task)) return;
+        this.taskQueue = this.taskQueue.filter((someTask) => someTask !== task);
+        this.eventSubject.next({
+          taskID: task.id,
+          type: "taskCanceled" /* taskCanceled */
+        });
+      },
+      id: taskID,
+      run: taskFunction,
+      then: taskCompletion.then.bind(taskCompletion)
+    };
+    if (this.taskQueue.length >= maxQueuedJobs) {
+      throw new Error(
+        "Maximum number of pool tasks queued. Refusing to queue another one.\nThis usually happens for one of two reasons: We are either at peak workload right now or some tasks just won't finish, thus blocking the pool."
+      );
+    }
+    this.debug(`Queueing task #${task.id}...`);
+    this.taskQueue.push(task);
+    this.eventSubject.next({
+      taskID: task.id,
+      type: "taskQueued" /* taskQueued */
+    });
+    this.scheduleWork();
+    return task;
+  }
+  async terminate(force) {
+    this.isClosing = true;
+    if (force !== true) {
+      await this.completed(true);
+    }
+    this.eventSubject.next({
+      remainingQueue: [...this.taskQueue],
+      type: "terminated" /* terminated */
+    });
+    this.eventSubject.complete();
+    await Promise.all(this.workers.map(async (worker) => Thread.terminate(await worker.init)));
+  }
+};
+function PoolConstructor(spawnWorker, optionsOrSize) {
+  return new WorkerPool(spawnWorker, optionsOrSize);
+}
+PoolConstructor.EventType = PoolEventType;
+var Pool = PoolConstructor;
+export {
+  Pool,
+  PoolEventType,
+  Thread
+};
+//# sourceMappingURL=pool-node.mjs.map

package/dist/node/master/pool-node.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/master/pool-node.ts", "../../../src/master/implementation.node.ts", "../../../src/master/pool-types.ts", "../../../src/symbols.ts", "../../../src/master/thread.ts"],
+  "sourcesContent": ["/* eslint-disable import-x/export */\n/* eslint-disable unicorn/no-thenable */\n\n/* eslint-disable @typescript-eslint/member-ordering */\n/* eslint-disable unicorn/no-array-reduce */\n/* eslint-disable @typescript-eslint/no-explicit-any */\n/* eslint-disable @typescript-eslint/no-namespace */\n\n/// <reference lib=\"esnext\" />\n\nimport DebugLogger from 'debug'\nimport {\n  multicast, Observable, Subject,\n} from 'observable-fns'\n\nimport { defaultPoolSize } from './implementation.node.ts'\nimport type {\n  PoolEvent, QueuedTask, TaskRunFunction, WorkerDescriptor,\n} from './pool-types.ts'\nimport { PoolEventType } from './pool-types.ts'\nimport { Thread } from './thread.ts'\n\nexport declare namespace Pool {\n  type Event<ThreadType extends Thread = any> = PoolEvent<ThreadType>\n  type EventType = PoolEventType\n}\n\nlet nextPoolID = 1\n\nfunction createArray(size: number): number[] {\n  const array: number[] = []\n  for (let index = 0; index < size; index++) {\n    array.push(index)\n  }\n  return array\n}\n\nfunction delay(ms: number) {\n  return new Promise(resolve => setTimeout(resolve, ms))\n}\n\nfunction flatMap<In, Out>(array: In[], mapper: (element: In) => Out[]): Out[] {\n  return array.reduce<Out[]>((flattened, element) => [...flattened, ...mapper(element)], [])\n}\n\nfunction slugify(text: string) {\n  return text.replaceAll(/\\W/g, ' ').trim().replaceAll(/\\s+/g, '-')\n}\n\nfunction spawnWorkers<ThreadType extends Thread>(spawnWorker: () => Promise<ThreadType>, count: number): WorkerDescriptor<ThreadType>[] {\n  return createArray(count).map(\n    (): WorkerDescriptor<ThreadType> => ({\n      init: spawnWorker(),\n      runningTasks: [],\n    }),\n  )\n}\n\n/**\n * Thread pool managing a set of worker threads.\n * Use it to queue tasks that are run on those threads with limited\n * concurrency.\n */\nexport interface Pool<ThreadType extends Thread> {\n  /**\n   * Returns a promise that resolves once the task queue is emptied.\n   * Promise will be rejected if any task fails.\n   *\n   * @param allowResolvingImmediately Set to `true` to resolve immediately if task queue is currently empty.\n   */\n  completed(allowResolvingImmediately?: boolean): Promise<any>\n\n  /**\n   * Returns a promise that resolves once the task queue is emptied.\n   * Failing tasks will not cause the promise to be rejected.\n   *\n   * @param allowResolvingImmediately Set to `true` to resolve immediately if task queue is currently empty.\n   */\n  settled(allowResolvingImmediately?: boolean): Promise<Error[]>\n\n  /**\n   * Returns an observable that yields pool events.\n   */\n  events(): Observable<PoolEvent<ThreadType>>\n\n  /**\n   * Queue a task and return a promise that resolves once the task has been dequeued,\n   * started and finished.\n   *\n   * @param task An async function that takes a thread instance and invokes it.\n   */\n  queue<Return>(task: TaskRunFunction<ThreadType, Return>): QueuedTask<ThreadType, Return>\n\n  /**\n   * Terminate all pool threads.\n   *\n   * @param force Set to `true` to kill the thread even if it cannot be stopped gracefully.\n   */\n  terminate(force?: boolean): Promise<void>\n}\n\ninterface PoolOptions {\n  /** Maximum no. of tasks to run on one worker thread at a time. Defaults to one. */\n  concurrency?: number\n\n  /** Maximum no. of jobs to be queued for execution before throwing an error. */\n  maxQueuedJobs?: number\n\n  /** Gives that pool a name to be used for debug logging, letting you distinguish between log output of different pools. */\n  name?: string\n\n  /** No. of worker threads to spawn and to be managed by the pool. */\n  size?: number\n}\n\nclass WorkerPool<ThreadType extends Thread> implements Pool<ThreadType> {\n  static EventType = PoolEventType\n\n  private readonly debug: DebugLogger.Debugger\n  private readonly eventObservable: Observable<PoolEvent<ThreadType>>\n  private readonly options: PoolOptions\n  private readonly workers: WorkerDescriptor<ThreadType>[]\n\n  private readonly eventSubject = new Subject<PoolEvent<ThreadType>>()\n  private initErrors: Error[] = []\n  private isClosing = false\n  private nextTaskID = 1\n  private taskQueue: QueuedTask<ThreadType, any>[] = []\n\n  constructor(spawnWorker: () => Promise<ThreadType>, optionsOrSize?: number | PoolOptions) {\n    const options: PoolOptions = typeof optionsOrSize === 'number' ? { size: optionsOrSize } : optionsOrSize || {}\n\n    const { size = defaultPoolSize } = options\n\n    this.debug = DebugLogger(`threads:pool:${slugify(options.name ?? String(nextPoolID++))}`)\n    this.options = options\n    this.workers = spawnWorkers(spawnWorker, size)\n\n    this.eventObservable = multicast(Observable.from(this.eventSubject))\n\n    const debug = this.debug\n    const workers = this.workers\n    void (async () => {\n      try {\n        await Promise.all(workers.map(worker => worker.init))\n        this.eventSubject.next({\n          size: workers.length,\n          type: PoolEventType.initialized,\n        })\n      } catch (error) {\n        const initError = error instanceof Error ? error : new Error(String(error))\n        debug('Error while initializing pool worker:', initError)\n        this.eventSubject.error(initError)\n        this.initErrors.push(initError)\n      }\n    })()\n  }\n\n  private findIdlingWorker(): WorkerDescriptor<ThreadType> | undefined {\n    const { concurrency = 1 } = this.options\n    return this.workers.find(worker => worker.runningTasks.length < concurrency)\n  }\n\n  private async runPoolTask(worker: WorkerDescriptor<ThreadType>, task: QueuedTask<ThreadType, any>) {\n    const workerID = this.workers.indexOf(worker) + 1\n\n    this.debug(`Running task #${task.id} on worker #${workerID}...`)\n    this.eventSubject.next({\n      taskID: task.id,\n      type: PoolEventType.taskStart,\n      workerID,\n    })\n\n    try {\n      const returnValue = await task.run(await worker.init)\n\n      this.debug(`Task #${task.id} completed successfully`)\n      this.eventSubject.next({\n        returnValue,\n        taskID: task.id,\n        type: PoolEventType.taskCompleted,\n        workerID,\n      })\n    } catch (ex) {\n      const error = ex as Error\n      this.debug(`Task #${task.id} failed`)\n      this.eventSubject.next({\n        error,\n        taskID: task.id,\n        type: PoolEventType.taskFailed,\n        workerID,\n      })\n    }\n  }\n\n  private run(worker: WorkerDescriptor<ThreadType>, task: QueuedTask<ThreadType, any>) {\n    const runPromise = (async () => {\n      const removeTaskFromWorkersRunningTasks = () => {\n        worker.runningTasks = worker.runningTasks.filter(someRunPromise => someRunPromise !== runPromise)\n      }\n\n      // Defer task execution by one tick to give handlers time to subscribe\n      await delay(0)\n\n      try {\n        await this.runPoolTask(worker, task)\n      } finally {\n        removeTaskFromWorkersRunningTasks()\n\n        if (!this.isClosing) {\n          this.scheduleWork()\n        }\n      }\n    })()\n\n    worker.runningTasks.push(runPromise)\n  }\n\n  private scheduleWork() {\n    this.debug('Attempt de-queueing a task in order to run it...')\n\n    const availableWorker = this.findIdlingWorker()\n    if (!availableWorker) return\n\n    const nextTask = this.taskQueue.shift()\n    if (!nextTask) {\n      this.debug('Task queue is empty')\n      this.eventSubject.next({ type: PoolEventType.taskQueueDrained })\n      return\n    }\n\n    this.run(availableWorker, nextTask)\n  }\n\n  private taskCompletion(taskID: number) {\n    return new Promise<any>((resolve, reject) => {\n      const eventSubscription = this.events().subscribe((event) => {\n        if (event.type === PoolEventType.taskCompleted && event.taskID === taskID) {\n          eventSubscription.unsubscribe()\n          resolve(event.returnValue)\n        } else if (event.type === PoolEventType.taskFailed && event.taskID === taskID) {\n          eventSubscription.unsubscribe()\n          reject(event.error)\n        } else if (event.type === PoolEventType.terminated) {\n          eventSubscription.unsubscribe()\n          reject(new Error('Pool has been terminated before task was run.'))\n        }\n      })\n    })\n  }\n\n  async settled(allowResolvingImmediately = false): Promise<Error[]> {\n    if (this.initErrors.length > 0) {\n      throw this.initErrors[0]\n    }\n    if (allowResolvingImmediately && this.taskQueue.length === 0) {\n      await Promise.allSettled(flatMap(this.workers, worker => worker.runningTasks))\n      return []\n    }\n\n    const getCurrentlyRunningTasks = () => flatMap(this.workers, worker => worker.runningTasks)\n    const taskFailures: Error[] = []\n\n    const failureSubscription = this.eventObservable.subscribe((event) => {\n      if (event.type === PoolEventType.taskFailed) {\n        taskFailures.push(event.error)\n      }\n    })\n\n    await new Promise<void>((resolve, reject) => {\n      const subscription = this.eventObservable.subscribe({\n        error: reject,\n        next(event) {\n          if (event.type !== PoolEventType.taskQueueDrained) {\n            return\n          }\n\n          subscription.unsubscribe()\n          resolve(void 0)\n        }, // make a pool-wide error reject the completed() result promise\n      })\n    })\n\n    await Promise.allSettled(getCurrentlyRunningTasks())\n    failureSubscription.unsubscribe()\n\n    return taskFailures\n  }\n\n  async completed(allowResolvingImmediately = false) {\n    const settlementPromise = this.settled(allowResolvingImmediately)\n\n    const earlyExitPromise = new Promise<Error[]>((resolve, reject) => {\n      const subscription = this.eventObservable.subscribe({\n        error: reject,\n        next(event) {\n          if (event.type === PoolEventType.taskQueueDrained) {\n            subscription.unsubscribe()\n            resolve(settlementPromise)\n          } else if (event.type === PoolEventType.taskFailed) {\n            subscription.unsubscribe()\n            reject(event.error)\n          }\n        }, // make a pool-wide error reject the completed() result promise\n      })\n    })\n\n    const errors = await Promise.race([settlementPromise, earlyExitPromise])\n\n    if (errors.length > 0) {\n      throw errors[0]\n    }\n  }\n\n  events() {\n    return this.eventObservable\n  }\n\n  queue(taskFunction: TaskRunFunction<ThreadType, any>) {\n    const { maxQueuedJobs = Infinity } = this.options\n\n    if (this.isClosing) {\n      throw new Error('Cannot schedule pool tasks after terminate() has been called.')\n    }\n    if (this.initErrors.length > 0) {\n      throw this.initErrors[0]\n    }\n\n    const taskID = this.nextTaskID++\n    const taskCompletion = this.taskCompletion(taskID)\n\n    void (async () => {\n      try {\n        await taskCompletion\n      } catch (error) {\n        // Prevent unhandled rejections here as we assume the user will use\n        // `pool.completed()`, `pool.settled()` or `task.catch()` to handle errors\n        this.debug(`Task #${taskID} errored:`, error)\n      }\n    })()\n\n    const task: QueuedTask<ThreadType, any> = {\n      cancel: () => {\n        if (!this.taskQueue.includes(task)) return\n        this.taskQueue = this.taskQueue.filter(someTask => someTask !== task)\n        this.eventSubject.next({\n          taskID: task.id,\n          type: PoolEventType.taskCanceled,\n        })\n      },\n      id: taskID,\n      run: taskFunction,\n      then: taskCompletion.then.bind(taskCompletion),\n    }\n\n    if (this.taskQueue.length >= maxQueuedJobs) {\n      throw new Error(\n        'Maximum number of pool tasks queued. Refusing to queue another one.\\n'\n        + 'This usually happens for one of two reasons: We are either at peak '\n        + \"workload right now or some tasks just won't finish, thus blocking the pool.\",\n      )\n    }\n\n    this.debug(`Queueing task #${task.id}...`)\n    this.taskQueue.push(task)\n\n    this.eventSubject.next({\n      taskID: task.id,\n      type: PoolEventType.taskQueued,\n    })\n\n    this.scheduleWork()\n    return task\n  }\n\n  async terminate(force?: boolean) {\n    this.isClosing = true\n    if (force !== true) {\n      await this.completed(true)\n    }\n    this.eventSubject.next({\n      remainingQueue: [...this.taskQueue],\n      type: PoolEventType.terminated,\n    })\n    this.eventSubject.complete()\n    await Promise.all(this.workers.map(async worker => Thread.terminate(await worker.init)))\n  }\n}\n\n/**\n * Thread pool constructor. Creates a new pool and spawns its worker threads.\n */\nfunction PoolConstructor<ThreadType extends Thread>(spawnWorker: () => Promise<ThreadType>, optionsOrSize?: number | PoolOptions) {\n  // The function exists only so we don't need to use `new` to create a pool (we still can, though).\n  // If the Pool is a class or not is an implementation detail that should not concern the user.\n  return new WorkerPool(spawnWorker, optionsOrSize)\n}\n\n;(PoolConstructor as any).EventType = PoolEventType\n\n/**\n * Thread pool constructor. Creates a new pool and spawns its worker threads.\n */\nexport const Pool = PoolConstructor as typeof PoolConstructor & { EventType: typeof PoolEventType }\n\nexport type { PoolEvent, QueuedTask } from './pool-types.ts'\nexport { PoolEventType } from './pool-types.ts'\nexport { Thread } from './thread.ts'\n", "/* eslint-disable @typescript-eslint/no-explicit-any */\n/* eslint-disable unicorn/text-encoding-identifier-case */\n/// <reference types=\"node\" />\n\nimport { cpus } from 'node:os'\nimport path from 'node:path'\nimport { cwd } from 'node:process'\nimport { isMainThread, Worker as NativeWorker } from 'node:worker_threads'\n\nimport type {\n  ImplementationExport, ThreadsWorkerOptions, WorkerImplementation,\n} from '../types/master.ts'\n\n/** Default thread pool size based on the number of CPU cores. */\nexport const defaultPoolSize = cpus().length\n\nfunction resolveScriptPath(scriptPath: string, baseURL?: string) {\n  const makeAbsolute = (filePath: string) => {\n    return path.isAbsolute(filePath) ? filePath : path.join(baseURL ?? cwd(), filePath)\n  }\n\n  const absolutePath = makeAbsolute(scriptPath)\n  return absolutePath\n}\n\nfunction initWorkerThreadsWorker(): ImplementationExport {\n  let allWorkers: NativeWorker[] = []\n\n  class Worker extends NativeWorker {\n    private mappedEventListeners: WeakMap<EventListener, EventListener>\n\n    constructor(scriptPath: string, options?: ThreadsWorkerOptions & { fromSource: boolean }) {\n      const resolvedScriptPath = options?.fromSource === true ? null : resolveScriptPath(scriptPath, options?._baseURL)\n      if (resolvedScriptPath === null) {\n        // `options.fromSource` is true\n        const sourceCode = scriptPath\n        super(sourceCode, { ...options, eval: true })\n      } else {\n        super(resolvedScriptPath, options)\n      }\n\n      this.mappedEventListeners = new WeakMap()\n      allWorkers.push(this)\n    }\n\n    addEventListener(eventName: string, rawListener: EventListener) {\n      const listener = (message: any) => {\n        rawListener({ data: message } as any)\n      }\n      this.mappedEventListeners.set(rawListener, listener)\n      this.on(eventName, listener)\n    }\n\n    removeEventListener(eventName: string, rawListener: EventListener) {\n      const listener = this.mappedEventListeners.get(rawListener) || rawListener\n      this.off(eventName, listener)\n    }\n  }\n\n  const terminateWorkersAndMaster = () => {\n    // we should terminate all workers and then gracefully shutdown self process\n    void (async () => {\n      try {\n        await Promise.all(allWorkers.map(worker => worker.terminate()))\n        process.exit(0)\n      } catch {\n        process.exit(1)\n      }\n    })()\n    allWorkers = []\n  }\n\n  // Take care to not leave orphaned processes behind. See #147.\n  process.on('SIGINT', () => terminateWorkersAndMaster())\n  process.on('SIGTERM', () => terminateWorkersAndMaster())\n\n  class BlobWorker extends Worker {\n    constructor(blob: Uint8Array, options?: ThreadsWorkerOptions) {\n      super(Buffer.from(blob).toString('utf-8'), { ...options, fromSource: true })\n    }\n\n    static fromText(source: string, options?: ThreadsWorkerOptions): WorkerImplementation {\n      return new Worker(source, { ...options, fromSource: true }) as any\n    }\n  }\n\n  return {\n    blob: BlobWorker as any,\n    default: Worker as any,\n  }\n}\n\nlet implementation: ImplementationExport\n\n/**\n * Get the Node.js-specific worker implementation using `worker_threads`, lazily initializing it on first call.\n * @returns The platform-specific worker implementation export.\n */\nexport function getWorkerImplementation(): ImplementationExport {\n  if (implementation === undefined) {\n    implementation = initWorkerThreadsWorker()\n  }\n  return implementation\n}\n\n/**\n * Check whether the current code is running inside a Node.js worker thread.\n * @returns True if running in a worker thread (not the main thread), false otherwise.\n */\nexport function isWorkerRuntime() {\n  return !isMainThread\n}\n", "/* eslint-disable @typescript-eslint/no-explicit-any */\n/* eslint-disable @typescript-eslint/member-ordering */\nimport type { Thread } from './thread.ts'\n\n/** Pool event type. Specifies the type of each `PoolEvent`. */\nexport enum PoolEventType {\n  initialized = 'initialized',\n  taskCanceled = 'taskCanceled',\n  taskCompleted = 'taskCompleted',\n  taskFailed = 'taskFailed',\n  taskQueued = 'taskQueued',\n  taskQueueDrained = 'taskQueueDrained',\n  taskStart = 'taskStart',\n  terminated = 'terminated',\n}\n\n/** A function that runs a task on a worker thread and returns a promise of the result. */\nexport type TaskRunFunction<ThreadType extends Thread, Return> = (worker: ThreadType) => Promise<Return>\n\n/** Pool event. Subscribe to those events using `pool.events()`. Useful for debugging. */\nexport type PoolEvent<ThreadType extends Thread>\n  = | {\n    type: PoolEventType.initialized\n    size: number\n  }\n  | {\n    type: PoolEventType.taskQueued\n    taskID: number\n  }\n  | {\n    type: PoolEventType.taskQueueDrained\n  }\n  | {\n    type: PoolEventType.taskStart\n    taskID: number\n    workerID: number\n  }\n  | {\n    type: PoolEventType.taskCompleted\n    returnValue: any\n    taskID: number\n    workerID: number\n  }\n  | {\n    type: PoolEventType.taskFailed\n    error: Error\n    taskID: number\n    workerID: number\n  }\n  | {\n    type: PoolEventType.taskCanceled\n    taskID: number\n  }\n  | {\n    type: PoolEventType.terminated\n    remainingQueue: QueuedTask<ThreadType, any>[]\n  }\n\n/** Descriptor for a worker in a pool, tracking its initialization and running tasks. */\nexport interface WorkerDescriptor<ThreadType extends Thread> {\n  init: Promise<ThreadType>\n  runningTasks: Promise<any>[]\n}\n\n/**\n * Task that has been `pool.queued()`-ed.\n */\nexport interface QueuedTask<ThreadType extends Thread, Return> {\n  /** @private */\n  id: number\n\n  /** @private */\n  run: TaskRunFunction<ThreadType, Return>\n\n  /**\n   * Queued tasks can be cancelled until the pool starts running them on a worker thread.\n   */\n  cancel(): void\n\n  /**\n   * `QueuedTask` is thenable, so you can `await` it.\n   * Resolves when the task has successfully been executed. Rejects if the task fails.\n   */\n  then: Promise<Return>['then']\n}\n", "/** Symbol key for accessing a thread's error observable. */\nexport const $errors = Symbol('thread.errors')\n/** Symbol key for accessing a thread's event observable. */\nexport const $events = Symbol('thread.events')\n/** Symbol key for accessing a thread's terminate function. */\nexport const $terminate = Symbol('thread.terminate')\n/** Symbol key for marking an object as a transferable descriptor. */\nexport const $transferable = Symbol('thread.transferable')\n/** Symbol key for accessing the underlying worker instance of a thread. */\nexport const $worker = Symbol('thread.worker')\n", "import type { Observable } from 'observable-fns'\n\nimport {\n  $errors, $events, $terminate,\n} from '../symbols.ts'\nimport type {\n  PrivateThreadProps, Thread as ThreadType, WorkerEvent,\n} from '../types/master.ts'\n\nfunction fail(message: string): never {\n  throw new Error(message)\n}\n\nfunction readPrivateThreadProp<K extends keyof PrivateThreadProps>(\n  thread: ThreadType,\n  key: K,\n): PrivateThreadProps[K] | undefined {\n  return Reflect.get(thread, key)\n}\n\n/** Re-exported Thread type from the master types module. */\nexport type Thread = ThreadType\n\n/** Thread utility functions. Use them to manage or inspect a `spawn()`-ed thread. */\nexport const Thread = {\n  /** Return an observable that can be used to subscribe to all errors happening in the thread. */\n  errors: <ThreadT extends ThreadType>(thread: ThreadT): Observable<Error> =>\n    readPrivateThreadProp(thread, $errors) ?? fail('Error observable not found. Make sure to pass a thread instance as returned by the spawn() promise.'),\n  /** Return an observable that can be used to subscribe to internal events happening in the thread. Useful for debugging. */\n  events: <ThreadT extends ThreadType>(thread: ThreadT): Observable<WorkerEvent> =>\n    readPrivateThreadProp(thread, $events) ?? fail('Events observable not found. Make sure to pass a thread instance as returned by the spawn() promise.'),\n  /** Terminate a thread. Remember to terminate every thread when you are done using it. */\n  terminate: <ThreadT extends ThreadType>(thread: ThreadT) =>\n    readPrivateThreadProp(thread, $terminate)?.() ?? fail('Terminate function not found. Make sure to pass a thread instance as returned by the spawn() promise.'),\n}\n"],
+  "mappings": ";AAUA,OAAO,iBAAiB;AACxB;AAAA,EACE;AAAA,EAAW;AAAA,EAAY;AAAA,OAClB;;;ACTP,SAAS,YAAY;AAUd,IAAM,kBAAkB,KAAK,EAAE;;;ACT/B,IAAK,gBAAL,kBAAKA,mBAAL;AACL,EAAAA,eAAA,iBAAc;AACd,EAAAA,eAAA,kBAAe;AACf,EAAAA,eAAA,mBAAgB;AAChB,EAAAA,eAAA,gBAAa;AACb,EAAAA,eAAA,gBAAa;AACb,EAAAA,eAAA,sBAAmB;AACnB,EAAAA,eAAA,eAAY;AACZ,EAAAA,eAAA,gBAAa;AARH,SAAAA;AAAA,GAAA;;;ACJL,IAAM,UAAU,uBAAO,eAAe;AAEtC,IAAM,UAAU,uBAAO,eAAe;AAEtC,IAAM,aAAa,uBAAO,kBAAkB;;;ACInD,SAAS,KAAK,SAAwB;AACpC,QAAM,IAAI,MAAM,OAAO;AACzB;AAEA,SAAS,sBACP,QACA,KACmC;AACnC,SAAO,QAAQ,IAAI,QAAQ,GAAG;AAChC;AAMO,IAAM,SAAS;AAAA;AAAA,EAEpB,QAAQ,CAA6B,WACnC,sBAAsB,QAAQ,OAAO,KAAK,KAAK,qGAAqG;AAAA;AAAA,EAEtJ,QAAQ,CAA6B,WACnC,sBAAsB,QAAQ,OAAO,KAAK,KAAK,sGAAsG;AAAA;AAAA,EAEvJ,WAAW,CAA6B,WACtC,sBAAsB,QAAQ,UAAU,IAAI,KAAK,KAAK,uGAAuG;AACjK;;;AJPA,IAAI,aAAa;AAEjB,SAAS,YAAY,MAAwB;AAC3C,QAAM,QAAkB,CAAC;AACzB,WAAS,QAAQ,GAAG,QAAQ,MAAM,SAAS;AACzC,UAAM,KAAK,KAAK;AAAA,EAClB;AACA,SAAO;AACT;AAEA,SAAS,MAAM,IAAY;AACzB,SAAO,IAAI,QAAQ,aAAW,WAAW,SAAS,EAAE,CAAC;AACvD;AAEA,SAAS,QAAiB,OAAa,QAAuC;AAC5E,SAAO,MAAM,OAAc,CAAC,WAAW,YAAY,CAAC,GAAG,WAAW,GAAG,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;AAC3F;AAEA,SAAS,QAAQ,MAAc;AAC7B,SAAO,KAAK,WAAW,OAAO,GAAG,EAAE,KAAK,EAAE,WAAW,QAAQ,GAAG;AAClE;AAEA,SAAS,aAAwC,aAAwC,OAA+C;AACtI,SAAO,YAAY,KAAK,EAAE;AAAA,IACxB,OAAqC;AAAA,MACnC,MAAM,YAAY;AAAA,MAClB,cAAc,CAAC;AAAA,IACjB;AAAA,EACF;AACF;AA2DA,IAAM,aAAN,MAAwE;AAAA,EACtE,OAAO,YAAY;AAAA,EAEF;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA,eAAe,IAAI,QAA+B;AAAA,EAC3D,aAAsB,CAAC;AAAA,EACvB,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,YAA2C,CAAC;AAAA,EAEpD,YAAY,aAAwC,eAAsC;AACxF,UAAM,UAAuB,OAAO,kBAAkB,WAAW,EAAE,MAAM,cAAc,IAAI,iBAAiB,CAAC;AAE7G,UAAM,EAAE,OAAO,gBAAgB,IAAI;AAEnC,SAAK,QAAQ,YAAY,gBAAgB,QAAQ,QAAQ,QAAQ,OAAO,YAAY,CAAC,CAAC,EAAE;AACxF,SAAK,UAAU;AACf,SAAK,UAAU,aAAa,aAAa,IAAI;AAE7C,SAAK,kBAAkB,UAAU,WAAW,KAAK,KAAK,YAAY,CAAC;AAEnE,UAAM,QAAQ,KAAK;AACnB,UAAM,UAAU,KAAK;AACrB,UAAM,YAAY;AAChB,UAAI;AACF,cAAM,QAAQ,IAAI,QAAQ,IAAI,YAAU,OAAO,IAAI,CAAC;AACpD,aAAK,aAAa,KAAK;AAAA,UACrB,MAAM,QAAQ;AAAA,UACd;AAAA,QACF,CAAC;AAAA,MACH,SAAS,OAAO;AACd,cAAM,YAAY,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AAC1E,cAAM,yCAAyC,SAAS;AACxD,aAAK,aAAa,MAAM,SAAS;AACjC,aAAK,WAAW,KAAK,SAAS;AAAA,MAChC;AAAA,IACF,GAAG;AAAA,EACL;AAAA,EAEQ,mBAA6D;AACnE,UAAM,EAAE,cAAc,EAAE,IAAI,KAAK;AACjC,WAAO,KAAK,QAAQ,KAAK,YAAU,OAAO,aAAa,SAAS,WAAW;AAAA,EAC7E;AAAA,EAEA,MAAc,YAAY,QAAsC,MAAmC;AACjG,UAAM,WAAW,KAAK,QAAQ,QAAQ,MAAM,IAAI;AAEhD,SAAK,MAAM,iBAAiB,KAAK,EAAE,eAAe,QAAQ,KAAK;AAC/D,SAAK,aAAa,KAAK;AAAA,MACrB,QAAQ,KAAK;AAAA,MACb;AAAA,MACA;AAAA,IACF,CAAC;AAED,QAAI;AACF,YAAM,cAAc,MAAM,KAAK,IAAI,MAAM,OAAO,IAAI;AAEpD,WAAK,MAAM,SAAS,KAAK,EAAE,yBAAyB;AACpD,WAAK,aAAa,KAAK;AAAA,QACrB;AAAA,QACA,QAAQ,KAAK;AAAA,QACb;AAAA,QACA;AAAA,MACF,CAAC;AAAA,IACH,SAAS,IAAI;AACX,YAAM,QAAQ;AACd,WAAK,MAAM,SAAS,KAAK,EAAE,SAAS;AACpC,WAAK,aAAa,KAAK;AAAA,QACrB;AAAA,QACA,QAAQ,KAAK;AAAA,QACb;AAAA,QACA;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AAAA,EAEQ,IAAI,QAAsC,MAAmC;AACnF,UAAM,cAAc,YAAY;AAC9B,YAAM,oCAAoC,MAAM;AAC9C,eAAO,eAAe,OAAO,aAAa,OAAO,oBAAkB,mBAAmB,UAAU;AAAA,MAClG;AAGA,YAAM,MAAM,CAAC;AAEb,UAAI;AACF,cAAM,KAAK,YAAY,QAAQ,IAAI;AAAA,MACrC,UAAE;AACA,0CAAkC;AAElC,YAAI,CAAC,KAAK,WAAW;AACnB,eAAK,aAAa;AAAA,QACpB;AAAA,MACF;AAAA,IACF,GAAG;AAEH,WAAO,aAAa,KAAK,UAAU;AAAA,EACrC;AAAA,EAEQ,eAAe;AACrB,SAAK,MAAM,kDAAkD;AAE7D,UAAM,kBAAkB,KAAK,iBAAiB;AAC9C,QAAI,CAAC,gBAAiB;AAEtB,UAAM,WAAW,KAAK,UAAU,MAAM;AACtC,QAAI,CAAC,UAAU;AACb,WAAK,MAAM,qBAAqB;AAChC,WAAK,aAAa,KAAK,EAAE,gDAAqC,CAAC;AAC/D;AAAA,IACF;AAEA,SAAK,IAAI,iBAAiB,QAAQ;AAAA,EACpC;AAAA,EAEQ,eAAe,QAAgB;AACrC,WAAO,IAAI,QAAa,CAAC,SAAS,WAAW;AAC3C,YAAM,oBAAoB,KAAK,OAAO,EAAE,UAAU,CAAC,UAAU;AAC3D,YAAI,MAAM,gDAAwC,MAAM,WAAW,QAAQ;AACzE,4BAAkB,YAAY;AAC9B,kBAAQ,MAAM,WAAW;AAAA,QAC3B,WAAW,MAAM,0CAAqC,MAAM,WAAW,QAAQ;AAC7E,4BAAkB,YAAY;AAC9B,iBAAO,MAAM,KAAK;AAAA,QACpB,WAAW,MAAM,wCAAmC;AAClD,4BAAkB,YAAY;AAC9B,iBAAO,IAAI,MAAM,+CAA+C,CAAC;AAAA,QACnE;AAAA,MACF,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,QAAQ,4BAA4B,OAAyB;AACjE,QAAI,KAAK,WAAW,SAAS,GAAG;AAC9B,YAAM,KAAK,WAAW,CAAC;AAAA,IACzB;AACA,QAAI,6BAA6B,KAAK,UAAU,WAAW,GAAG;AAC5D,YAAM,QAAQ,WAAW,QAAQ,KAAK,SAAS,YAAU,OAAO,YAAY,CAAC;AAC7E,aAAO,CAAC;AAAA,IACV;AAEA,UAAM,2BAA2B,MAAM,QAAQ,KAAK,SAAS,YAAU,OAAO,YAAY;AAC1F,UAAM,eAAwB,CAAC;AAE/B,UAAM,sBAAsB,KAAK,gBAAgB,UAAU,CAAC,UAAU;AACpE,UAAI,MAAM,wCAAmC;AAC3C,qBAAa,KAAK,MAAM,KAAK;AAAA,MAC/B;AAAA,IACF,CAAC;AAED,UAAM,IAAI,QAAc,CAAC,SAAS,WAAW;AAC3C,YAAM,eAAe,KAAK,gBAAgB,UAAU;AAAA,QAClD,OAAO;AAAA,QACP,KAAK,OAAO;AACV,cAAI,MAAM,oDAAyC;AACjD;AAAA,UACF;AAEA,uBAAa,YAAY;AACzB,kBAAQ,MAAM;AAAA,QAChB;AAAA;AAAA,MACF,CAAC;AAAA,IACH,CAAC;AAED,UAAM,QAAQ,WAAW,yBAAyB,CAAC;AACnD,wBAAoB,YAAY;AAEhC,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,UAAU,4BAA4B,OAAO;AACjD,UAAM,oBAAoB,KAAK,QAAQ,yBAAyB;AAEhE,UAAM,mBAAmB,IAAI,QAAiB,CAAC,SAAS,WAAW;AACjE,YAAM,eAAe,KAAK,gBAAgB,UAAU;AAAA,QAClD,OAAO;AAAA,QACP,KAAK,OAAO;AACV,cAAI,MAAM,oDAAyC;AACjD,yBAAa,YAAY;AACzB,oBAAQ,iBAAiB;AAAA,UAC3B,WAAW,MAAM,wCAAmC;AAClD,yBAAa,YAAY;AACzB,mBAAO,MAAM,KAAK;AAAA,UACpB;AAAA,QACF;AAAA;AAAA,MACF,CAAC;AAAA,IACH,CAAC;AAED,UAAM,SAAS,MAAM,QAAQ,KAAK,CAAC,mBAAmB,gBAAgB,CAAC;AAEvE,QAAI,OAAO,SAAS,GAAG;AACrB,YAAM,OAAO,CAAC;AAAA,IAChB;AAAA,EACF;AAAA,EAEA,SAAS;AACP,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAM,cAAgD;AACpD,UAAM,EAAE,gBAAgB,SAAS,IAAI,KAAK;AAE1C,QAAI,KAAK,WAAW;AAClB,YAAM,IAAI,MAAM,+DAA+D;AAAA,IACjF;AACA,QAAI,KAAK,WAAW,SAAS,GAAG;AAC9B,YAAM,KAAK,WAAW,CAAC;AAAA,IACzB;AAEA,UAAM,SAAS,KAAK;AACpB,UAAM,iBAAiB,KAAK,eAAe,MAAM;AAEjD,UAAM,YAAY;AAChB,UAAI;AACF,cAAM;AAAA,MACR,SAAS,OAAO;AAGd,aAAK,MAAM,SAAS,MAAM,aAAa,KAAK;AAAA,MAC9C;AAAA,IACF,GAAG;AAEH,UAAM,OAAoC;AAAA,MACxC,QAAQ,MAAM;AACZ,YAAI,CAAC,KAAK,UAAU,SAAS,IAAI,EAAG;AACpC,aAAK,YAAY,KAAK,UAAU,OAAO,cAAY,aAAa,IAAI;AACpE,aAAK,aAAa,KAAK;AAAA,UACrB,QAAQ,KAAK;AAAA,UACb;AAAA,QACF,CAAC;AAAA,MACH;AAAA,MACA,IAAI;AAAA,MACJ,KAAK;AAAA,MACL,MAAM,eAAe,KAAK,KAAK,cAAc;AAAA,IAC/C;AAEA,QAAI,KAAK,UAAU,UAAU,eAAe;AAC1C,YAAM,IAAI;AAAA,QACR;AAAA,MAGF;AAAA,IACF;AAEA,SAAK,MAAM,kBAAkB,KAAK,EAAE,KAAK;AACzC,SAAK,UAAU,KAAK,IAAI;AAExB,SAAK,aAAa,KAAK;AAAA,MACrB,QAAQ,KAAK;AAAA,MACb;AAAA,IACF,CAAC;AAED,SAAK,aAAa;AAClB,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,UAAU,OAAiB;AAC/B,SAAK,YAAY;AACjB,QAAI,UAAU,MAAM;AAClB,YAAM,KAAK,UAAU,IAAI;AAAA,IAC3B;AACA,SAAK,aAAa,KAAK;AAAA,MACrB,gBAAgB,CAAC,GAAG,KAAK,SAAS;AAAA,MAClC;AAAA,IACF,CAAC;AACD,SAAK,aAAa,SAAS;AAC3B,UAAM,QAAQ,IAAI,KAAK,QAAQ,IAAI,OAAM,WAAU,OAAO,UAAU,MAAM,OAAO,IAAI,CAAC,CAAC;AAAA,EACzF;AACF;AAKA,SAAS,gBAA2C,aAAwC,eAAsC;AAGhI,SAAO,IAAI,WAAW,aAAa,aAAa;AAClD;AAEE,gBAAwB,YAAY;AAK/B,IAAM,OAAO;",
+  "names": ["PoolEventType"]
+}

package/dist/node/master/pool-types.d.ts

@@ -0,0 +1,68 @@
+import type { Thread } from './thread.ts';
+/** Pool event type. Specifies the type of each `PoolEvent`. */
+export declare enum PoolEventType {
+    initialized = "initialized",
+    taskCanceled = "taskCanceled",
+    taskCompleted = "taskCompleted",
+    taskFailed = "taskFailed",
+    taskQueued = "taskQueued",
+    taskQueueDrained = "taskQueueDrained",
+    taskStart = "taskStart",
+    terminated = "terminated"
+}
+/** A function that runs a task on a worker thread and returns a promise of the result. */
+export type TaskRunFunction<ThreadType extends Thread, Return> = (worker: ThreadType) => Promise<Return>;
+/** Pool event. Subscribe to those events using `pool.events()`. Useful for debugging. */
+export type PoolEvent<ThreadType extends Thread> = {
+    type: PoolEventType.initialized;
+    size: number;
+} | {
+    type: PoolEventType.taskQueued;
+    taskID: number;
+} | {
+    type: PoolEventType.taskQueueDrained;
+} | {
+    type: PoolEventType.taskStart;
+    taskID: number;
+    workerID: number;
+} | {
+    type: PoolEventType.taskCompleted;
+    returnValue: any;
+    taskID: number;
+    workerID: number;
+} | {
+    type: PoolEventType.taskFailed;
+    error: Error;
+    taskID: number;
+    workerID: number;
+} | {
+    type: PoolEventType.taskCanceled;
+    taskID: number;
+} | {
+    type: PoolEventType.terminated;
+    remainingQueue: QueuedTask<ThreadType, any>[];
+};
+/** Descriptor for a worker in a pool, tracking its initialization and running tasks. */
+export interface WorkerDescriptor<ThreadType extends Thread> {
+    init: Promise<ThreadType>;
+    runningTasks: Promise<any>[];
+}
+/**
+ * Task that has been `pool.queued()`-ed.
+ */
+export interface QueuedTask<ThreadType extends Thread, Return> {
+    /** @private */
+    id: number;
+    /** @private */
+    run: TaskRunFunction<ThreadType, Return>;
+    /**
+     * Queued tasks can be cancelled until the pool starts running them on a worker thread.
+     */
+    cancel(): void;
+    /**
+     * `QueuedTask` is thenable, so you can `await` it.
+     * Resolves when the task has successfully been executed. Rejects if the task fails.
+     */
+    then: Promise<Return>['then'];
+}
+//# sourceMappingURL=pool-types.d.ts.map

package/dist/node/master/pool-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool-types.d.ts","sourceRoot":"","sources":["../../../src/master/pool-types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,+DAA+D;AAC/D,oBAAY,aAAa;IACvB,WAAW,gBAAgB;IAC3B,YAAY,iBAAiB;IAC7B,aAAa,kBAAkB;IAC/B,UAAU,eAAe;IACzB,UAAU,eAAe;IACzB,gBAAgB,qBAAqB;IACrC,SAAS,cAAc;IACvB,UAAU,eAAe;CAC1B;AAED,0FAA0F;AAC1F,MAAM,MAAM,eAAe,CAAC,UAAU,SAAS,MAAM,EAAE,MAAM,IAAI,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;AAExG,yFAAyF;AACzF,MAAM,MAAM,SAAS,CAAC,UAAU,SAAS,MAAM,IACzC;IACF,IAAI,EAAE,aAAa,CAAC,WAAW,CAAA;IAC/B,IAAI,EAAE,MAAM,CAAA;CACb,GACC;IACA,IAAI,EAAE,aAAa,CAAC,UAAU,CAAA;IAC9B,MAAM,EAAE,MAAM,CAAA;CACf,GACC;IACA,IAAI,EAAE,aAAa,CAAC,gBAAgB,CAAA;CACrC,GACC;IACA,IAAI,EAAE,aAAa,CAAC,SAAS,CAAA;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;CACjB,GACC;IACA,IAAI,EAAE,aAAa,CAAC,aAAa,CAAA;IACjC,WAAW,EAAE,GAAG,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;CACjB,GACC;IACA,IAAI,EAAE,aAAa,CAAC,UAAU,CAAA;IAC9B,KAAK,EAAE,KAAK,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;CACjB,GACC;IACA,IAAI,EAAE,aAAa,CAAC,YAAY,CAAA;IAChC,MAAM,EAAE,MAAM,CAAA;CACf,GACC;IACA,IAAI,EAAE,aAAa,CAAC,UAAU,CAAA;IAC9B,cAAc,EAAE,UAAU,CAAC,UAAU,EAAE,GAAG,CAAC,EAAE,CAAA;CAC9C,CAAA;AAEH,wFAAwF;AACxF,MAAM,WAAW,gBAAgB,CAAC,UAAU,SAAS,MAAM;IACzD,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,CAAA;IACzB,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAA;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,UAAU,SAAS,MAAM,EAAE,MAAM;IAC3D,eAAe;IACf,EAAE,EAAE,MAAM,CAAA;IAEV,eAAe;IACf,GAAG,EAAE,eAAe,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;IAExC;;OAEG;IACH,MAAM,IAAI,IAAI,CAAA;IAEd;;;OAGG;IACH,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAA;CAC9B"}

package/dist/node/master/register.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=register.d.ts.map

package/dist/node/master/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../src/master/register.ts"],"names":[],"mappings":""}

package/dist/node/master/register.mjs

@@ -0,0 +1,87 @@
+// src/master/implementation.node.ts
+import { cpus } from "node:os";
+import path from "node:path";
+import { cwd } from "node:process";
+import { isMainThread, Worker as NativeWorker } from "node:worker_threads";
+var defaultPoolSize = cpus().length;
+function resolveScriptPath(scriptPath, baseURL) {
+  const makeAbsolute = (filePath) => {
+    return path.isAbsolute(filePath) ? filePath : path.join(baseURL ?? cwd(), filePath);
+  };
+  const absolutePath = makeAbsolute(scriptPath);
+  return absolutePath;
+}
+function initWorkerThreadsWorker() {
+  let allWorkers = [];
+  class Worker2 extends NativeWorker {
+    mappedEventListeners;
+    constructor(scriptPath, options) {
+      const resolvedScriptPath = options?.fromSource === true ? null : resolveScriptPath(scriptPath, options?._baseURL);
+      if (resolvedScriptPath === null) {
+        const sourceCode = scriptPath;
+        super(sourceCode, { ...options, eval: true });
+      } else {
+        super(resolvedScriptPath, options);
+      }
+      this.mappedEventListeners = /* @__PURE__ */ new WeakMap();
+      allWorkers.push(this);
+    }
+    addEventListener(eventName, rawListener) {
+      const listener = (message) => {
+        rawListener({ data: message });
+      };
+      this.mappedEventListeners.set(rawListener, listener);
+      this.on(eventName, listener);
+    }
+    removeEventListener(eventName, rawListener) {
+      const listener = this.mappedEventListeners.get(rawListener) || rawListener;
+      this.off(eventName, listener);
+    }
+  }
+  const terminateWorkersAndMaster = () => {
+    void (async () => {
+      try {
+        await Promise.all(allWorkers.map((worker) => worker.terminate()));
+        process.exit(0);
+      } catch {
+        process.exit(1);
+      }
+    })();
+    allWorkers = [];
+  };
+  process.on("SIGINT", () => terminateWorkersAndMaster());
+  process.on("SIGTERM", () => terminateWorkersAndMaster());
+  class BlobWorker2 extends Worker2 {
+    constructor(blob, options) {
+      super(Buffer.from(blob).toString("utf-8"), { ...options, fromSource: true });
+    }
+    static fromText(source, options) {
+      return new Worker2(source, { ...options, fromSource: true });
+    }
+  }
+  return {
+    blob: BlobWorker2,
+    default: Worker2
+  };
+}
+var implementation;
+function getWorkerImplementation() {
+  if (implementation === void 0) {
+    implementation = initWorkerThreadsWorker();
+  }
+  return implementation;
+}
+
+// src/master/index-node.ts
+var BlobWorker = getWorkerImplementation().blob;
+var Worker = getWorkerImplementation().default;
+
+// src/master/register.ts
+if (typeof globalThis !== "undefined") {
+  ;
+  globalThis.Worker = Worker;
+} else if (window !== void 0) {
+  ;
+  window.Worker = Worker;
+}
+//# sourceMappingURL=register.mjs.map

package/dist/node/master/register.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/master/implementation.node.ts", "../../../src/master/index-node.ts", "../../../src/master/register.ts"],
+  "sourcesContent": ["/* eslint-disable @typescript-eslint/no-explicit-any */\n/* eslint-disable unicorn/text-encoding-identifier-case */\n/// <reference types=\"node\" />\n\nimport { cpus } from 'node:os'\nimport path from 'node:path'\nimport { cwd } from 'node:process'\nimport { isMainThread, Worker as NativeWorker } from 'node:worker_threads'\n\nimport type {\n  ImplementationExport, ThreadsWorkerOptions, WorkerImplementation,\n} from '../types/master.ts'\n\n/** Default thread pool size based on the number of CPU cores. */\nexport const defaultPoolSize = cpus().length\n\nfunction resolveScriptPath(scriptPath: string, baseURL?: string) {\n  const makeAbsolute = (filePath: string) => {\n    return path.isAbsolute(filePath) ? filePath : path.join(baseURL ?? cwd(), filePath)\n  }\n\n  const absolutePath = makeAbsolute(scriptPath)\n  return absolutePath\n}\n\nfunction initWorkerThreadsWorker(): ImplementationExport {\n  let allWorkers: NativeWorker[] = []\n\n  class Worker extends NativeWorker {\n    private mappedEventListeners: WeakMap<EventListener, EventListener>\n\n    constructor(scriptPath: string, options?: ThreadsWorkerOptions & { fromSource: boolean }) {\n      const resolvedScriptPath = options?.fromSource === true ? null : resolveScriptPath(scriptPath, options?._baseURL)\n      if (resolvedScriptPath === null) {\n        // `options.fromSource` is true\n        const sourceCode = scriptPath\n        super(sourceCode, { ...options, eval: true })\n      } else {\n        super(resolvedScriptPath, options)\n      }\n\n      this.mappedEventListeners = new WeakMap()\n      allWorkers.push(this)\n    }\n\n    addEventListener(eventName: string, rawListener: EventListener) {\n      const listener = (message: any) => {\n        rawListener({ data: message } as any)\n      }\n      this.mappedEventListeners.set(rawListener, listener)\n      this.on(eventName, listener)\n    }\n\n    removeEventListener(eventName: string, rawListener: EventListener) {\n      const listener = this.mappedEventListeners.get(rawListener) || rawListener\n      this.off(eventName, listener)\n    }\n  }\n\n  const terminateWorkersAndMaster = () => {\n    // we should terminate all workers and then gracefully shutdown self process\n    void (async () => {\n      try {\n        await Promise.all(allWorkers.map(worker => worker.terminate()))\n        process.exit(0)\n      } catch {\n        process.exit(1)\n      }\n    })()\n    allWorkers = []\n  }\n\n  // Take care to not leave orphaned processes behind. See #147.\n  process.on('SIGINT', () => terminateWorkersAndMaster())\n  process.on('SIGTERM', () => terminateWorkersAndMaster())\n\n  class BlobWorker extends Worker {\n    constructor(blob: Uint8Array, options?: ThreadsWorkerOptions) {\n      super(Buffer.from(blob).toString('utf-8'), { ...options, fromSource: true })\n    }\n\n    static fromText(source: string, options?: ThreadsWorkerOptions): WorkerImplementation {\n      return new Worker(source, { ...options, fromSource: true }) as any\n    }\n  }\n\n  return {\n    blob: BlobWorker as any,\n    default: Worker as any,\n  }\n}\n\nlet implementation: ImplementationExport\n\n/**\n * Get the Node.js-specific worker implementation using `worker_threads`, lazily initializing it on first call.\n * @returns The platform-specific worker implementation export.\n */\nexport function getWorkerImplementation(): ImplementationExport {\n  if (implementation === undefined) {\n    implementation = initWorkerThreadsWorker()\n  }\n  return implementation\n}\n\n/**\n * Check whether the current code is running inside a Node.js worker thread.\n * @returns True if running in a worker thread (not the main thread), false otherwise.\n */\nexport function isWorkerRuntime() {\n  return !isMainThread\n}\n", "import type { BlobWorker as BlobWorkerClass, Worker as WorkerType } from '../types/master.ts'\nimport * as NodeImplementation from './implementation.node.ts'\n\nexport type { FunctionThread, ModuleThread } from '../types/master.ts'\nexport { Pool } from './pool-browser.ts'\nexport { spawn } from './spawn.ts'\nexport { Thread } from './thread.ts'\n\nexport type BlobWorker = typeof BlobWorkerClass\nexport type Worker = WorkerType\n\n/** Separate class to spawn workers from source code blobs or strings. */\nexport const BlobWorker = NodeImplementation.getWorkerImplementation().blob\n\n/** Worker implementation. Either web worker or a Node.js Worker class. */\nexport const Worker = NodeImplementation.getWorkerImplementation().default\n\nexport { isWorkerRuntime } from './implementation.node.ts'\n", "/* eslint-disable @typescript-eslint/no-explicit-any */\n\nimport { Worker as WorkerImplementation } from './index-node.ts'\n\ndeclare const window: any\n\nif (typeof globalThis !== 'undefined') {\n  ;(globalThis as any).Worker = WorkerImplementation\n} else if (window !== undefined) {\n  ;(window).Worker = WorkerImplementation\n}\n"],
+  "mappings": ";AAIA,SAAS,YAAY;AACrB,OAAO,UAAU;AACjB,SAAS,WAAW;AACpB,SAAS,cAAc,UAAU,oBAAoB;AAO9C,IAAM,kBAAkB,KAAK,EAAE;AAEtC,SAAS,kBAAkB,YAAoB,SAAkB;AAC/D,QAAM,eAAe,CAAC,aAAqB;AACzC,WAAO,KAAK,WAAW,QAAQ,IAAI,WAAW,KAAK,KAAK,WAAW,IAAI,GAAG,QAAQ;AAAA,EACpF;AAEA,QAAM,eAAe,aAAa,UAAU;AAC5C,SAAO;AACT;AAEA,SAAS,0BAAgD;AACvD,MAAI,aAA6B,CAAC;AAAA,EAElC,MAAMA,gBAAe,aAAa;AAAA,IACxB;AAAA,IAER,YAAY,YAAoB,SAA0D;AACxF,YAAM,qBAAqB,SAAS,eAAe,OAAO,OAAO,kBAAkB,YAAY,SAAS,QAAQ;AAChH,UAAI,uBAAuB,MAAM;AAE/B,cAAM,aAAa;AACnB,cAAM,YAAY,EAAE,GAAG,SAAS,MAAM,KAAK,CAAC;AAAA,MAC9C,OAAO;AACL,cAAM,oBAAoB,OAAO;AAAA,MACnC;AAEA,WAAK,uBAAuB,oBAAI,QAAQ;AACxC,iBAAW,KAAK,IAAI;AAAA,IACtB;AAAA,IAEA,iBAAiB,WAAmB,aAA4B;AAC9D,YAAM,WAAW,CAAC,YAAiB;AACjC,oBAAY,EAAE,MAAM,QAAQ,CAAQ;AAAA,MACtC;AACA,WAAK,qBAAqB,IAAI,aAAa,QAAQ;AACnD,WAAK,GAAG,WAAW,QAAQ;AAAA,IAC7B;AAAA,IAEA,oBAAoB,WAAmB,aAA4B;AACjE,YAAM,WAAW,KAAK,qBAAqB,IAAI,WAAW,KAAK;AAC/D,WAAK,IAAI,WAAW,QAAQ;AAAA,IAC9B;AAAA,EACF;AAEA,QAAM,4BAA4B,MAAM;AAEtC,UAAM,YAAY;AAChB,UAAI;AACF,cAAM,QAAQ,IAAI,WAAW,IAAI,YAAU,OAAO,UAAU,CAAC,CAAC;AAC9D,gBAAQ,KAAK,CAAC;AAAA,MAChB,QAAQ;AACN,gBAAQ,KAAK,CAAC;AAAA,MAChB;AAAA,IACF,GAAG;AACH,iBAAa,CAAC;AAAA,EAChB;AAGA,UAAQ,GAAG,UAAU,MAAM,0BAA0B,CAAC;AACtD,UAAQ,GAAG,WAAW,MAAM,0BAA0B,CAAC;AAAA,EAEvD,MAAMC,oBAAmBD,QAAO;AAAA,IAC9B,YAAY,MAAkB,SAAgC;AAC5D,YAAM,OAAO,KAAK,IAAI,EAAE,SAAS,OAAO,GAAG,EAAE,GAAG,SAAS,YAAY,KAAK,CAAC;AAAA,IAC7E;AAAA,IAEA,OAAO,SAAS,QAAgB,SAAsD;AACpF,aAAO,IAAIA,QAAO,QAAQ,EAAE,GAAG,SAAS,YAAY,KAAK,CAAC;AAAA,IAC5D;AAAA,EACF;AAEA,SAAO;AAAA,IACL,MAAMC;AAAA,IACN,SAASD;AAAA,EACX;AACF;AAEA,IAAI;AAMG,SAAS,0BAAgD;AAC9D,MAAI,mBAAmB,QAAW;AAChC,qBAAiB,wBAAwB;AAAA,EAC3C;AACA,SAAO;AACT;;;AC3FO,IAAM,aAAgC,wBAAwB,EAAE;AAGhE,IAAM,SAA4B,wBAAwB,EAAE;;;ACTnE,IAAI,OAAO,eAAe,aAAa;AACrC;AAAC,EAAC,WAAmB,SAAS;AAChC,WAAW,WAAW,QAAW;AAC/B;AAAC,EAAC,OAAQ,SAAS;AACrB;",
+  "names": ["Worker", "BlobWorker"]
+}

package/dist/node/master/spawn.d.ts

@@ -0,0 +1,22 @@
+import type { FunctionThread, ModuleThread, StripAsync, Worker as WorkerType } from '../types/master.ts';
+import type { WorkerFunction, WorkerModule } from '../types/worker.ts';
+type ArbitraryWorkerInterface = WorkerFunction & WorkerModule<string> & {
+    somekeythatisneverusedinproductioncode123: 'magicmarker123';
+};
+type ArbitraryThreadType = FunctionThread<any, any> & ModuleThread<any>;
+/** Maps a worker's exposed API type to its corresponding thread type (`FunctionThread` or `ModuleThread`). */
+export type ExposedToThreadType<Exposed extends WorkerFunction | WorkerModule<any>> = Exposed extends ArbitraryWorkerInterface ? ArbitraryThreadType : Exposed extends WorkerFunction ? FunctionThread<Parameters<Exposed>, StripAsync<ReturnType<Exposed>>> : Exposed extends WorkerModule<any> ? ModuleThread<Exposed> : never;
+/**
+ * Spawn a new thread. Takes a fresh worker instance, wraps it in a thin
+ * abstraction layer to provide the transparent API and verifies that
+ * the worker has initialized successfully.
+ *
+ * @param worker Instance of `Worker`. Either a web worker or `worker_threads` worker.
+ * @param [options]
+ * @param [options.timeout] Init message timeout. Default: 10000 or set by environment variable.
+ */
+export declare function spawn<Exposed extends WorkerFunction | WorkerModule<any> = ArbitraryWorkerInterface>(worker: WorkerType, options?: {
+    timeout?: number;
+}): Promise<ExposedToThreadType<Exposed>>;
+export {};
+//# sourceMappingURL=spawn.d.ts.map

package/dist/node/master/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/master/spawn.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EAEZ,UAAU,EACV,MAAM,IAAI,UAAU,EAKrB,MAAM,oBAAoB,CAAA;AAG3B,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAGtE,KAAK,wBAAwB,GAAG,cAAc,GAAG,YAAY,CAAC,MAAM,CAAC,GAAG;IAAE,yCAAyC,EAAE,gBAAgB,CAAA;CAAE,CAAA;AACvI,KAAK,mBAAmB,GAAG,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAA;AAUvE,8GAA8G;AAC9G,MAAM,MAAM,mBAAmB,CAAC,OAAO,SAAS,cAAc,GAAG,YAAY,CAAC,GAAG,CAAC,IAC9E,OAAO,SAAS,wBAAwB,GAAG,mBAAmB,GAC5D,OAAO,SAAS,cAAc,GAAG,cAAc,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,GACnG,OAAO,SAAS,YAAY,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,GACvD,KAAK,CAAA;AA4Gf;;;;;;;;GAQG;AACH,wBAAsB,KAAK,CAAC,OAAO,SAAS,cAAc,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,wBAAwB,EACvG,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B,OAAO,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAwBvC"}

package/dist/node/master/thread.d.ts

@@ -0,0 +1,14 @@
+import type { Observable } from 'observable-fns';
+import type { Thread as ThreadType, WorkerEvent } from '../types/master.ts';
+/** Re-exported Thread type from the master types module. */
+export type Thread = ThreadType;
+/** Thread utility functions. Use them to manage or inspect a `spawn()`-ed thread. */
+export declare const Thread: {
+    /** Return an observable that can be used to subscribe to all errors happening in the thread. */
+    errors: <ThreadT extends ThreadType>(thread: ThreadT) => Observable<Error>;
+    /** Return an observable that can be used to subscribe to internal events happening in the thread. Useful for debugging. */
+    events: <ThreadT extends ThreadType>(thread: ThreadT) => Observable<WorkerEvent>;
+    /** Terminate a thread. Remember to terminate every thread when you are done using it. */
+    terminate: <ThreadT extends ThreadType>(thread: ThreadT) => Promise<void>;
+};
+//# sourceMappingURL=thread.d.ts.map

package/dist/node/master/thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread.d.ts","sourceRoot":"","sources":["../../../src/master/thread.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAKhD,OAAO,KAAK,EACU,MAAM,IAAI,UAAU,EAAE,WAAW,EACtD,MAAM,oBAAoB,CAAA;AAa3B,4DAA4D;AAC5D,MAAM,MAAM,MAAM,GAAG,UAAU,CAAA;AAE/B,qFAAqF;AACrF,eAAO,MAAM,MAAM;IACjB,gGAAgG;aACvF,OAAO,SAAS,UAAU,UAAU,OAAO,KAAG,UAAU,CAAC,KAAK,CAAC;IAExE,2HAA2H;aAClH,OAAO,SAAS,UAAU,UAAU,OAAO,KAAG,UAAU,CAAC,WAAW,CAAC;IAE9E,yFAAyF;gBAC7E,OAAO,SAAS,UAAU,UAAU,OAAO;CAExD,CAAA"}

package/dist/node/observable-promise.d.ts

@@ -0,0 +1,41 @@
+import type { ObservableLike, SubscriptionObserver } from 'observable-fns';
+import { Observable } from 'observable-fns';
+type Initializer<T> = (observer: SubscriptionObserver<T>) => UnsubscribeFn | void;
+type Thenable<T> = {
+    then: (onFulfilled?: (value: T) => any, onRejected?: (error: any) => any) => any;
+};
+type UnsubscribeFn = () => void;
+/**
+ * Creates a hybrid, combining the APIs of an Observable and a Promise.
+ *
+ * It is used to proxy async process states when we are initially not sure
+ * if that async process will yield values once (-> Promise) or multiple
+ * times (-> Observable).
+ *
+ * Note that the observable promise inherits some of the observable's characteristics:
+ * The `init` function will be called *once for every time anyone subscribes to it*.
+ *
+ * If this is undesired, derive a hot observable from it using `makeHot()` and
+ * subscribe to that.
+ */
+export declare class ObservablePromise<T> extends Observable<T> implements Promise<T> {
+    readonly [Symbol.toStringTag] = "[object ObservablePromise]";
+    private initHasRun;
+    private fulfillmentCallbacks;
+    private rejectionCallbacks;
+    private firstValue;
+    private firstValueSet;
+    private rejection;
+    private state;
+    constructor(init: Initializer<T>);
+    private onNext;
+    private onError;
+    private onCompletion;
+    private createPromise;
+    then<TResult1 = T, TResult2 = never>(onFulfilledRaw?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null, onRejectedRaw?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+    catch<Result = never>(onRejected: ((error: Error) => Promise<Result> | Result) | null | undefined): Promise<T | Result>;
+    finally(onCompleted?: (() => void) | null): Promise<T>;
+    static from<T>(thing: Observable<T> | ObservableLike<T> | ArrayLike<T> | Thenable<T>): ObservablePromise<T>;
+}
+export {};
+//# sourceMappingURL=observable-promise.d.ts.map