@loaders.gl/core 5.0.0-alpha.12 → 5.0.0-alpha.14

package/dist/worker-utils/lib/worker-farm/worker-farm.js

@@ -0,0 +1,116 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import WorkerPool from "./worker-pool.js";
+import WorkerThread from "./worker-thread.js";
+const DEFAULT_PROPS = {
+    maxConcurrency: 3,
+    maxMobileConcurrency: 1,
+    reuseWorkers: true,
+    onDebug: () => { }
+};
+/** Stable ids used to distinguish worker factories in the pool cache. */
+const loadWorkerIds = new WeakMap();
+/** Next stable worker-factory id. */
+let nextLoadWorkerId = 1;
+/**
+ * Process multiple jobs with a "farm" of different workers in worker pools.
+ */
+export default class WorkerFarm {
+    props;
+    workerPools = new Map();
+    // singleton
+    static _workerFarm;
+    /** Checks if workers are supported on this platform */
+    static isSupported() {
+        return WorkerThread.isSupported();
+    }
+    /** Get the singleton instance of the global worker farm */
+    static getWorkerFarm(props = {}) {
+        WorkerFarm._workerFarm = WorkerFarm._workerFarm || new WorkerFarm({});
+        WorkerFarm._workerFarm.setProps(props);
+        return WorkerFarm._workerFarm;
+    }
+    /** get global instance with WorkerFarm.getWorkerFarm() */
+    constructor(props) {
+        this.props = { ...DEFAULT_PROPS };
+        this.setProps(props);
+        /** @type Map<string, WorkerPool>} */
+        this.workerPools = new Map();
+    }
+    /**
+     * Terminate all workers in the farm and abort active jobs.
+     * @param reason Optional error delivered to active jobs.
+     * @note Can free up significant memory
+     */
+    destroy(reason) {
+        for (const workerPool of this.workerPools.values()) {
+            workerPool.destroy(reason);
+        }
+        this.workerPools = new Map();
+    }
+    /**
+     * Set props used when initializing worker pools
+     * @param props
+     */
+    setProps(props) {
+        this.props = { ...this.props, ...props };
+        // Update worker pool props
+        for (const workerPool of this.workerPools.values()) {
+            workerPool.setProps(this._getWorkerPoolProps());
+        }
+    }
+    /**
+     * Returns a worker pool for the specified worker
+     * @param options Worker target used to identify and initialize the pool.
+     * @param options.name Worker name used as the base pool identity.
+     * @param options.url Worker script URL.
+     * @param options.source Inline worker source.
+     * @param options.loadWorker Built-in browser worker factory.
+     * @example
+     *   const job = WorkerFarm.getWorkerFarm().getWorkerPool({name, url}).startJob(...);
+     */
+    getWorkerPool(options) {
+        const { name, source, url, getUrl, loadWorker } = options;
+        const workerPoolKey = getWorkerPoolKey(options);
+        let workerPool = this.workerPools.get(workerPoolKey);
+        if (!workerPool) {
+            workerPool = new WorkerPool({
+                name,
+                source,
+                url,
+                getUrl,
+                loadWorker
+            });
+            workerPool.setProps(this._getWorkerPoolProps());
+            this.workerPools.set(workerPoolKey, workerPool);
+        }
+        return workerPool;
+    }
+    _getWorkerPoolProps() {
+        return {
+            maxConcurrency: this.props.maxConcurrency,
+            maxMobileConcurrency: this.props.maxMobileConcurrency,
+            reuseWorkers: this.props.reuseWorkers,
+            onDebug: this.props.onDebug
+        };
+    }
+}
+/** Returns a cache key that distinguishes each worker source and factory. */
+function getWorkerPoolKey(options) {
+    const { name, source, url, urlKey, loadWorker } = options;
+    const sourceKey = source ? `source:${source}` : '';
+    const urlKeyPart = url || urlKey ? `url:${url || urlKey}` : '';
+    const loadWorkerKey = loadWorker ? `loadWorker:${getLoadWorkerId(loadWorker)}` : '';
+    return [name, sourceKey, urlKeyPart, loadWorkerKey].filter(Boolean).join('|');
+}
+/** Returns a stable identifier for a worker factory function. */
+function getLoadWorkerId(loadWorker) {
+    let loadWorkerId = loadWorkerIds.get(loadWorker);
+    if (!loadWorkerId) {
+        loadWorkerId = nextLoadWorkerId++;
+        loadWorkerIds.set(loadWorker, loadWorkerId);
+    }
+    return loadWorkerId;
+}
+//# sourceMappingURL=worker-farm.js.map

package/dist/worker-utils/lib/worker-farm/worker-farm.js.map

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

package/dist/worker-utils/lib/worker-farm/worker-job.d.ts

@@ -0,0 +1,34 @@
+import type { WorkerMessageType, WorkerMessagePayload } from "../../types.js";
+import WorkerThread from "./worker-thread.js";
+/**
+ * Represents one Job handled by a WorkerPool or WorkerFarm
+ */
+export default class WorkerJob {
+    readonly name: string;
+    readonly workerThread: WorkerThread;
+    isRunning: boolean;
+    /** Promise that resolves when Job is done */
+    readonly result: Promise<any>;
+    private _resolve;
+    private _reject;
+    constructor(jobName: string, workerThread: WorkerThread);
+    /**
+     * Send a message to the job's worker thread
+     * @param data any data structure, ideally consisting mostly of transferrable objects
+     */
+    postMessage(type: WorkerMessageType, payload: WorkerMessagePayload): void;
+    /**
+     * Call to resolve the `result` Promise with the supplied value
+     */
+    done(value: any): void;
+    /**
+     * Call to reject the `result` Promise with the supplied error
+     */
+    error(error: unknown): void;
+    /**
+     * Terminates the worker executing this job and rejects its result.
+     * @param reason Abort reason supplied by the caller, or a cross-runtime `AbortError`.
+     */
+    abort(reason?: unknown): void;
+}
+//# sourceMappingURL=worker-job.d.ts.map

package/dist/worker-utils/lib/worker-farm/worker-job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-job.d.ts","sourceRoot":"","sources":["../../../../src/worker-utils/lib/worker-farm/worker-job.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,iBAAiB,EAAE,oBAAoB,EAAC,uBAAoB;AACzE,OAAO,YAAY,2BAAwB;AAE3C;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,SAAS;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,SAAS,EAAE,OAAO,CAAQ;IAC1B,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAE9B,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,OAAO,CAAoC;gBAEvC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY;IASvD;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,oBAAoB,GAAG,IAAI;IASzE;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI;IAQtB;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAQ3B;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI;CAS9B"}

package/dist/worker-utils/lib/worker-farm/worker-job.js

@@ -0,0 +1,74 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/**
+ * Represents one Job handled by a WorkerPool or WorkerFarm
+ */
+export default class WorkerJob {
+    name;
+    workerThread;
+    isRunning = true;
+    /** Promise that resolves when Job is done */
+    result;
+    _resolve = () => { };
+    _reject = () => { };
+    constructor(jobName, workerThread) {
+        this.name = jobName;
+        this.workerThread = workerThread;
+        this.result = new Promise((resolve, reject) => {
+            this._resolve = resolve;
+            this._reject = reject;
+        });
+    }
+    /**
+     * Send a message to the job's worker thread
+     * @param data any data structure, ideally consisting mostly of transferrable objects
+     */
+    postMessage(type, payload) {
+        if (!this.isRunning)
+            return;
+        this.workerThread.postMessage({
+            source: 'loaders.gl', // Lets worker ignore unrelated messages
+            type,
+            payload
+        });
+    }
+    /**
+     * Call to resolve the `result` Promise with the supplied value
+     */
+    done(value) {
+        if (!this.isRunning) {
+            return;
+        }
+        this.isRunning = false;
+        this._resolve(value);
+    }
+    /**
+     * Call to reject the `result` Promise with the supplied error
+     */
+    error(error) {
+        if (!this.isRunning) {
+            return;
+        }
+        this.isRunning = false;
+        this._reject(error);
+    }
+    /**
+     * Terminates the worker executing this job and rejects its result.
+     * @param reason Abort reason supplied by the caller, or a cross-runtime `AbortError`.
+     */
+    abort(reason) {
+        if (!this.isRunning) {
+            return;
+        }
+        this.workerThread.destroy();
+        this.error(arguments.length ? reason : createAbortError(`Worker job "${this.name}" was aborted`));
+    }
+}
+/** Creates an abort error without requiring the DOMException global. */
+function createAbortError(message) {
+    const error = new Error(message);
+    error.name = 'AbortError';
+    return error;
+}
+//# sourceMappingURL=worker-job.js.map

package/dist/worker-utils/lib/worker-farm/worker-job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-job.js","sourceRoot":"","sources":["../../../../src/worker-utils/lib/worker-farm/worker-job.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAKpC;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,SAAS;IACnB,IAAI,CAAS;IACb,YAAY,CAAe;IACpC,SAAS,GAAY,IAAI,CAAC;IAC1B,6CAA6C;IACpC,MAAM,CAAe;IAEtB,QAAQ,GAAyB,GAAG,EAAE,GAAE,CAAC,CAAC;IAC1C,OAAO,GAA2B,GAAG,EAAE,GAAE,CAAC,CAAC;IAEnD,YAAY,OAAe,EAAE,YAA0B;QACrD,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC;QACpB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC5C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;YACxB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACxB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,IAAuB,EAAE,OAA6B;QAChE,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO;QAC5B,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC;YAC5B,MAAM,EAAE,YAAY,EAAE,wCAAwC;YAC9D,IAAI;YACJ,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,KAAU;QACb,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAc;QAClB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAgB;QACpB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CACR,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,eAAe,IAAI,CAAC,IAAI,eAAe,CAAC,CACtF,CAAC;IACJ,CAAC;CACF;AAED,wEAAwE;AACxE,SAAS,gBAAgB,CAAC,OAAe;IACvC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,GAAG,YAAY,CAAC;IAC1B,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/worker-utils/lib/worker-farm/worker-pool.d.ts

@@ -0,0 +1,94 @@
+import type { LoadWorker, WorkerMessageType, WorkerMessagePayload } from "../../types.js";
+import WorkerThread from "./worker-thread.js";
+import WorkerJob from "./worker-job.js";
+/** WorkerPool onDebug Callback Parameters */
+type OnDebugParameters = {
+    message: string;
+    worker: string;
+    name: string;
+    job: string;
+    backlog: number;
+    workerThread: WorkerThread;
+};
+/** WorkerPool Properties */
+export type WorkerPoolProps = {
+    name?: string;
+    source?: string;
+    url?: string;
+    /** Lazily resolves a classic worker fallback URL. */
+    getUrl?: () => string;
+    /** Creates a browser Worker directly. */
+    loadWorker?: LoadWorker;
+    maxConcurrency?: number;
+    maxMobileConcurrency?: number;
+    onDebug?: (options: OnDebugParameters) => any;
+    reuseWorkers?: boolean;
+};
+/** Worker-pool target, including values used only to distinguish cached pools. */
+export type WorkerPoolTarget = WorkerPoolProps & {
+    /** Worker name used as the base pool identity. */
+    name: string;
+    /** Stable identity for a lazily resolved URL. */
+    urlKey?: string;
+};
+/** Private helper types */
+type OnMessage = (job: WorkerJob, type: WorkerMessageType, payload: WorkerMessagePayload) => void;
+type OnError = (job: WorkerJob, error: Error) => void;
+/**
+ * Process multiple data messages with small pool of identical workers
+ */
+export default class WorkerPool {
+    name: string;
+    source?: string;
+    url?: string;
+    /** Lazily resolves a classic worker fallback URL. */
+    getUrl?: () => string;
+    /** Creates a browser Worker directly. */
+    loadWorker?: LoadWorker;
+    maxConcurrency: number;
+    maxMobileConcurrency: number;
+    onDebug: (options: OnDebugParameters) => any;
+    reuseWorkers: boolean;
+    private props;
+    private jobQueue;
+    private idleQueue;
+    private activeJobs;
+    private count;
+    private isDestroyed;
+    /** Checks if workers are supported on this platform */
+    static isSupported(): boolean;
+    /**
+     * @param processor - worker function
+     * @param maxConcurrency - max count of workers
+     */
+    constructor(props: WorkerPoolProps);
+    /**
+     * Terminates all workers in the pool and aborts active jobs.
+     * @param reason Optional error delivered to active jobs.
+     * @note Can free up significant memory
+     */
+    destroy(reason?: unknown): void;
+    setProps(props: WorkerPoolProps): void;
+    startJob(name: string, onMessage?: OnMessage, onError?: OnError, signal?: AbortSignal): Promise<WorkerJob>;
+    /**
+     * Starts first queued job if worker is available or can be created
+     * Called when job is started and whenever a worker returns to the idleQueue
+     */
+    _startQueuedJob(): Promise<void>;
+    /**
+     * Returns a worker to the idle queue
+     * Destroys the worker if
+     *  - pool is destroyed
+     *  - if this pool doesn't reuse workers
+     *  - if maxConcurrency has been lowered
+     * @param worker
+     */
+    returnWorkerToQueue(worker: WorkerThread): void;
+    /**
+     * Returns idle worker or creates new worker if maxConcurrency has not been reached
+     */
+    _getAvailableWorker(): WorkerThread | null;
+    _getMaxConcurrency(): number;
+}
+export {};
+//# sourceMappingURL=worker-pool.d.ts.map

package/dist/worker-utils/lib/worker-farm/worker-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-pool.d.ts","sourceRoot":"","sources":["../../../../src/worker-utils/lib/worker-farm/worker-pool.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,UAAU,EAAE,iBAAiB,EAAE,oBAAoB,EAAC,uBAAoB;AAErF,OAAO,YAAY,2BAAwB;AAC3C,OAAO,SAAS,wBAAqB;AAErC,6CAA6C;AAC7C,KAAK,iBAAiB,GAAG;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,YAAY,CAAC;CAC5B,CAAC;AAEF,4BAA4B;AAC5B,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;IACtB,yCAAyC;IACzC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,GAAG,CAAC;IAC9C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,kFAAkF;AAClF,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG;IAC/C,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,2BAA2B;AAC3B,KAAK,SAAS,GAAG,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAC;AAClG,KAAK,OAAO,GAAG,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AActD;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,UAAU;IAC7B,IAAI,EAAE,MAAM,CAAa;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;IACtB,yCAAyC;IACzC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,cAAc,EAAE,MAAM,CAAK;IAC3B,oBAAoB,EAAE,MAAM,CAAK;IACjC,OAAO,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,GAAG,CAAY;IACxD,YAAY,EAAE,OAAO,CAAQ;IAE7B,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,WAAW,CAAS;IAE5B,uDAAuD;IACvD,MAAM,CAAC,WAAW,IAAI,OAAO;IAI7B;;;OAGG;gBACS,KAAK,EAAE,eAAe;IAQlC;;;;OAIG;IACH,OAAO,CAAC,MAAM,GAAE,OAAgD,GAAG,IAAI;IAavE,QAAQ,CAAC,KAAK,EAAE,eAAe;IAoBzB,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,SAA+C,EAC1D,OAAO,GAAE,OAA0C,EACnD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,SAAS,CAAC;IAqCrB;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAiEtC;;;;;;;OAOG;IACH,mBAAmB,CAAC,MAAM,EAAE,YAAY;IA0BxC;;OAEG;IACH,mBAAmB,IAAI,YAAY,GAAG,IAAI;IA4B1C,kBAAkB;CAGnB"}

package/dist/worker-utils/lib/worker-farm/worker-pool.js

@@ -0,0 +1,246 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { isMobile } from "../env-utils/globals.js";
+import WorkerThread from "./worker-thread.js";
+import WorkerJob from "./worker-job.js";
+/**
+ * Process multiple data messages with small pool of identical workers
+ */
+export default class WorkerPool {
+    name = 'unnamed';
+    source; // | Function;
+    url;
+    /** Lazily resolves a classic worker fallback URL. */
+    getUrl;
+    /** Creates a browser Worker directly. */
+    loadWorker;
+    maxConcurrency = 1;
+    maxMobileConcurrency = 1;
+    onDebug = () => { };
+    reuseWorkers = true;
+    props = {};
+    jobQueue = [];
+    idleQueue = [];
+    activeJobs = new Set();
+    count = 0;
+    isDestroyed = false;
+    /** Checks if workers are supported on this platform */
+    static isSupported() {
+        return WorkerThread.isSupported();
+    }
+    /**
+     * @param processor - worker function
+     * @param maxConcurrency - max count of workers
+     */
+    constructor(props) {
+        this.source = props.source;
+        this.url = props.url;
+        this.getUrl = props.getUrl;
+        this.loadWorker = props.loadWorker;
+        this.setProps(props);
+    }
+    /**
+     * Terminates all workers in the pool and aborts active jobs.
+     * @param reason Optional error delivered to active jobs.
+     * @note Can free up significant memory
+     */
+    destroy(reason = new Error('Worker pool was destroyed')) {
+        // Abort active jobs so callers receive an error when a development worker is invalidated.
+        this.isDestroyed = true;
+        this.activeJobs.forEach(job => job.abort(reason));
+        const queuedJobs = this.jobQueue.splice(0);
+        queuedJobs.forEach(queuedJob => {
+            queuedJob.removeAbortListener();
+            queuedJob.onReject(reason);
+        });
+        this.idleQueue.forEach(worker => worker.destroy());
+        this.isDestroyed = true;
+    }
+    setProps(props) {
+        this.props = { ...this.props, ...props };
+        if (props.name !== undefined) {
+            this.name = props.name;
+        }
+        if (props.maxConcurrency !== undefined) {
+            this.maxConcurrency = props.maxConcurrency;
+        }
+        if (props.maxMobileConcurrency !== undefined) {
+            this.maxMobileConcurrency = props.maxMobileConcurrency;
+        }
+        if (props.reuseWorkers !== undefined) {
+            this.reuseWorkers = props.reuseWorkers;
+        }
+        if (props.onDebug !== undefined) {
+            this.onDebug = props.onDebug;
+        }
+    }
+    async startJob(name, onMessage = (job, type, data) => job.done(data), onError = (job, error) => job.error(error), signal) {
+        if (signal?.aborted) {
+            throw signal.reason;
+        }
+        if (this.isDestroyed) {
+            return Promise.reject(new Error('Worker pool was destroyed'));
+        }
+        // Promise resolves when thread starts working on this job
+        const startPromise = new Promise((onStart, onReject) => {
+            // Promise resolves when thread completes or fails working on this job
+            const abortQueuedJob = () => {
+                const index = this.jobQueue.indexOf(queuedJob);
+                if (index >= 0) {
+                    this.jobQueue.splice(index, 1);
+                    queuedJob.removeAbortListener();
+                    onReject(signal?.reason);
+                }
+            };
+            const queuedJob = {
+                name,
+                onMessage,
+                onError,
+                onStart,
+                onReject,
+                signal,
+                removeAbortListener: () => signal?.removeEventListener('abort', abortQueuedJob)
+            };
+            this.jobQueue.push(queuedJob);
+            signal?.addEventListener('abort', abortQueuedJob, { once: true });
+            return this;
+        });
+        this._startQueuedJob(); // eslint-disable-line @typescript-eslint/no-floating-promises
+        return await startPromise;
+    }
+    // PRIVATE
+    /**
+     * Starts first queued job if worker is available or can be created
+     * Called when job is started and whenever a worker returns to the idleQueue
+     */
+    async _startQueuedJob() {
+        if (!this.jobQueue.length) {
+            return;
+        }
+        let workerThread;
+        try {
+            workerThread = this._getAvailableWorker();
+        }
+        catch (error) {
+            const queuedJob = this.jobQueue.shift();
+            queuedJob?.removeAbortListener();
+            queuedJob?.onReject(error);
+            void this._startQueuedJob();
+            return;
+        }
+        if (!workerThread) {
+            return;
+        }
+        // We have a worker, dequeue and start the job
+        const queuedJob = this.jobQueue.shift();
+        if (queuedJob) {
+            // Emit a debug event
+            // @ts-ignore
+            this.onDebug({
+                message: 'Starting job',
+                name: queuedJob.name,
+                workerThread,
+                backlog: this.jobQueue.length
+            });
+            // Create a worker job to let the app access thread and manage job completion
+            const job = new WorkerJob(queuedJob.name, workerThread);
+            queuedJob.removeAbortListener();
+            const abortJob = () => job.abort(queuedJob.signal?.reason);
+            queuedJob.signal?.addEventListener('abort', abortJob, { once: true });
+            if (queuedJob.signal?.aborted)
+                abortJob();
+            this.activeJobs.add(job);
+            workerThread.ref();
+            // Set the worker thread's message handlers
+            workerThread.onMessage = data => {
+                if (job.isRunning)
+                    queuedJob.onMessage(job, data.type, data.payload);
+            };
+            workerThread.onError = error => queuedJob.onError(job, error);
+            // Resolve the start promise so that the app can start sending messages to worker
+            queuedJob.onStart(job);
+            // Wait for the app to signal that the job is complete, then return worker to queue
+            try {
+                await job.result;
+            }
+            catch {
+                // The job result promise carries worker errors back to the caller; do not duplicate-log
+                // handled rejections here.
+            }
+            finally {
+                queuedJob.signal?.removeEventListener('abort', abortJob);
+                this.activeJobs.delete(job);
+                this.returnWorkerToQueue(workerThread);
+            }
+        }
+        else {
+            this.returnWorkerToQueue(workerThread);
+        }
+    }
+    /**
+     * Returns a worker to the idle queue
+     * Destroys the worker if
+     *  - pool is destroyed
+     *  - if this pool doesn't reuse workers
+     *  - if maxConcurrency has been lowered
+     * @param worker
+     */
+    returnWorkerToQueue(worker) {
+        const shouldDestroyWorker = 
+        // Aborted jobs terminate their worker immediately.
+        worker.terminated ||
+            // If the pool is destroyed, there is no reason to keep the worker around
+            this.isDestroyed ||
+            // If the app has disabled worker reuse, any completed workers should be destroyed
+            !this.reuseWorkers ||
+            // If concurrency has been lowered, this worker might be surplus to requirements
+            this.count > this._getMaxConcurrency();
+        if (shouldDestroyWorker) {
+            if (!worker.terminated) {
+                worker.destroy();
+            }
+            this.count--;
+        }
+        else {
+            worker.unref();
+            this.idleQueue.push(worker);
+        }
+        if (!this.isDestroyed) {
+            this._startQueuedJob(); // eslint-disable-line @typescript-eslint/no-floating-promises
+        }
+    }
+    /**
+     * Returns idle worker or creates new worker if maxConcurrency has not been reached
+     */
+    _getAvailableWorker() {
+        // If a worker has completed and returned to the queue, it can be used
+        if (this.idleQueue.length > 0) {
+            return this.idleQueue.shift() || null;
+        }
+        // Create fresh worker if we haven't yet created the max amount of worker threads for this worker source
+        if (this.count < this._getMaxConcurrency()) {
+            this.count++;
+            const name = `${this.name.toLowerCase()} (#${this.count} of ${this.maxConcurrency})`;
+            try {
+                return new WorkerThread({
+                    name,
+                    source: this.source,
+                    url: this.url,
+                    getUrl: this.getUrl,
+                    loadWorker: this.loadWorker
+                });
+            }
+            catch (error) {
+                this.count--;
+                throw error;
+            }
+        }
+        // No worker available, have to wait
+        return null;
+    }
+    _getMaxConcurrency() {
+        return isMobile ? this.maxMobileConcurrency : this.maxConcurrency;
+    }
+}
+//# sourceMappingURL=worker-pool.js.map

package/dist/worker-utils/lib/worker-farm/worker-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-pool.js","sourceRoot":"","sources":["../../../../src/worker-utils/lib/worker-farm/worker-pool.ts"],"names":[],"mappings":"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"}

package/dist/worker-utils/lib/worker-farm/worker-thread.d.ts

@@ -0,0 +1,67 @@
+import type { LoadWorker } from "../../types.js";
+import { NodeWorkerType } from "../node/worker_threads.js";
+export type WorkerThreadProps = {
+    /** Human-readable worker name. */
+    name: string;
+    /** Inline worker source. */
+    source?: string;
+    /** Worker script URL. */
+    url?: string;
+    /** Lazily resolves the classic worker URL used as a fallback. */
+    getUrl?: () => string;
+    /** Creates a browser Worker directly. */
+    loadWorker?: LoadWorker;
+};
+/**
+ * Represents one worker thread
+ */
+export default class WorkerThread {
+    readonly name: string;
+    readonly source: string | undefined;
+    readonly url: string | undefined;
+    /** Lazily resolves the classic worker URL used as a fallback. */
+    readonly getUrl: (() => string) | undefined;
+    /** Creates a browser Worker directly. */
+    readonly loadWorker: LoadWorker | undefined;
+    terminated: boolean;
+    worker: Worker | NodeWorkerType;
+    onMessage: (message: any) => void;
+    onError: (error: Error) => void;
+    private _loadableURL;
+    /** Checks if workers are supported on this platform */
+    static isSupported(): boolean;
+    constructor(props: WorkerThreadProps);
+    /**
+     * Terminate this worker thread
+     * @note Can free up significant memory
+     */
+    destroy(): void;
+    /** Keeps this worker from preventing Node.js process exit while idle. */
+    unref(): void;
+    /** Keeps this worker alive while it is actively processing a job. */
+    ref(): void;
+    get isRunning(): boolean;
+    /**
+     * Send a message to this worker thread
+     * @param data any data structure, ideally consisting mostly of transferrable objects
+     * @param transferList If not supplied, calculated automatically by traversing data
+     */
+    postMessage(data: any, transferList?: any[]): void;
+    /**
+     * Generate a standard Error from an ErrorEvent
+     * @param event
+     */
+    _getErrorFromErrorEvent(event: ErrorEvent): Error;
+    /**
+     * Creates a worker thread on the browser
+     */
+    _createBrowserWorker(): Worker;
+    /** Attaches protocol handlers to a browser worker. */
+    _initializeBrowserWorker(worker: Worker): Worker;
+    /**
+     * Creates a worker thread in node.js
+     * @todo https://nodejs.org/api/async_hooks.html#async-resource-worker-pool
+     */
+    _createNodeWorker(): NodeWorkerType;
+}
+//# sourceMappingURL=worker-thread.d.ts.map