@xylabs/threads 4.6.4 → 4.7.0

package/dist/esm/master/spawn.js

@@ -1,114 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.spawn = spawn;
-const debug_1 = __importDefault(require("debug"));
-const observable_fns_1 = require("observable-fns");
-const common_1 = require("../common");
-const promise_1 = require("../promise");
-const symbols_1 = require("../symbols");
-const master_1 = require("../types/master");
-const invocation_proxy_1 = require("./invocation-proxy");
-const debugMessages = (0, debug_1.default)('threads:master:messages');
-const debugSpawn = (0, debug_1.default)('threads:master:spawn');
-const debugThreadUtils = (0, debug_1.default)('threads:master:thread-utils');
-const isInitMessage = (data) => data && data.type === 'init';
-const isUncaughtErrorMessage = (data) => data && data.type === 'uncaughtError';
-const initMessageTimeout = typeof process !== 'undefined' && process.env !== undefined && process.env.THREADS_WORKER_INIT_TIMEOUT
-    ? Number.parseInt(process.env.THREADS_WORKER_INIT_TIMEOUT, 10)
-    : 10_000;
-async function withTimeout(promise, timeoutInMs, errorMessage) {
-    let timeoutHandle;
-    const timeout = new Promise((resolve, reject) => {
-        timeoutHandle = setTimeout(() => reject(new Error(errorMessage)), timeoutInMs);
-    });
-    const result = await Promise.race([promise, timeout]);
-    clearTimeout(timeoutHandle);
-    return result;
-}
-function receiveInitMessage(worker) {
-    return new Promise((resolve, reject) => {
-        const messageHandler = ((event) => {
-            debugMessages('Message from worker before finishing initialization:', event.data);
-            if (isInitMessage(event.data)) {
-                worker.removeEventListener('message', messageHandler);
-                resolve(event.data);
-            }
-            else if (isUncaughtErrorMessage(event.data)) {
-                worker.removeEventListener('message', messageHandler);
-                reject((0, common_1.deserialize)(event.data.error));
-            }
-        });
-        worker.addEventListener('message', messageHandler);
-    });
-}
-function createEventObservable(worker, workerTermination) {
-    return new observable_fns_1.Observable((observer) => {
-        const messageHandler = ((messageEvent) => {
-            const workerEvent = {
-                data: messageEvent.data,
-                type: master_1.WorkerEventType.message,
-            };
-            observer.next(workerEvent);
-        });
-        const rejectionHandler = ((errorEvent) => {
-            debugThreadUtils('Unhandled promise rejection event in thread:', errorEvent);
-            const workerEvent = {
-                error: new Error(errorEvent.reason),
-                type: master_1.WorkerEventType.internalError,
-            };
-            observer.next(workerEvent);
-        });
-        worker.addEventListener('message', messageHandler);
-        worker.addEventListener('unhandledrejection', rejectionHandler);
-        workerTermination.then(() => {
-            const terminationEvent = { type: master_1.WorkerEventType.termination };
-            worker.removeEventListener('message', messageHandler);
-            worker.removeEventListener('unhandledrejection', rejectionHandler);
-            observer.next(terminationEvent);
-            observer.complete();
-        });
-    });
-}
-function createTerminator(worker) {
-    const [termination, resolver] = (0, promise_1.createPromiseWithResolver)();
-    const terminate = async () => {
-        debugThreadUtils('Terminating worker');
-        await worker.terminate();
-        resolver();
-    };
-    return { terminate, termination };
-}
-function setPrivateThreadProps(raw, worker, workerEvents, terminate) {
-    const workerErrors = workerEvents
-        .filter(event => event.type === master_1.WorkerEventType.internalError)
-        .map(errorEvent => errorEvent.error);
-    return Object.assign(raw, {
-        [symbols_1.$errors]: workerErrors,
-        [symbols_1.$events]: workerEvents,
-        [symbols_1.$terminate]: terminate,
-        [symbols_1.$worker]: worker,
-    });
-}
-async function spawn(worker, options) {
-    debugSpawn('Initializing new thread');
-    const timeout = options && options.timeout ? options.timeout : initMessageTimeout;
-    const initMessage = await withTimeout(receiveInitMessage(worker), timeout, `Timeout: Did not receive an init message from worker after ${timeout}ms. Make sure the worker calls expose().`);
-    const exposed = initMessage.exposed;
-    const { termination, terminate } = createTerminator(worker);
-    const events = createEventObservable(worker, termination);
-    if (exposed.type === 'function') {
-        const proxy = (0, invocation_proxy_1.createProxyFunction)(worker);
-        return setPrivateThreadProps(proxy, worker, events, terminate);
-    }
-    else if (exposed.type === 'module') {
-        const proxy = (0, invocation_proxy_1.createProxyModule)(worker, exposed.methods);
-        return setPrivateThreadProps(proxy, worker, events, terminate);
-    }
-    else {
-        const type = exposed.type;
-        throw new Error(`Worker init message states unexpected type of expose(): ${type}`);
-    }
-}

package/dist/esm/master/thread.js

@@ -1,18 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Thread = void 0;
-const symbols_1 = require("../symbols");
-function fail(message) {
-    throw new Error(message);
-}
-exports.Thread = {
-    errors(thread) {
-        return thread[symbols_1.$errors] || fail('Error observable not found. Make sure to pass a thread instance as returned by the spawn() promise.');
-    },
-    events(thread) {
-        return thread[symbols_1.$events] || fail('Events observable not found. Make sure to pass a thread instance as returned by the spawn() promise.');
-    },
-    terminate(thread) {
-        return thread[symbols_1.$terminate]();
-    },
-};

package/dist/esm/observable-promise.js

@@ -1,132 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ObservablePromise = void 0;
-const observable_fns_1 = require("observable-fns");
-const doNothing = () => { };
-const returnInput = (input) => input;
-const runDeferred = (fn) => Promise.resolve().then(fn);
-function fail(error) {
-    throw error;
-}
-function isThenable(thing) {
-    return thing && typeof thing.then === 'function';
-}
-class ObservablePromise extends observable_fns_1.Observable {
-    [Symbol.toStringTag] = '[object ObservablePromise]';
-    initHasRun = false;
-    fulfillmentCallbacks = [];
-    rejectionCallbacks = [];
-    firstValue;
-    firstValueSet = false;
-    rejection;
-    state = 'pending';
-    constructor(init) {
-        super((originalObserver) => {
-            const self = this;
-            const observer = {
-                ...originalObserver,
-                complete() {
-                    originalObserver.complete();
-                    self.onCompletion();
-                },
-                error(error) {
-                    originalObserver.error(error);
-                    self.onError(error);
-                },
-                next(value) {
-                    originalObserver.next(value);
-                    self.onNext(value);
-                },
-            };
-            try {
-                this.initHasRun = true;
-                return init(observer);
-            }
-            catch (error) {
-                observer.error(error);
-            }
-        });
-    }
-    onNext(value) {
-        if (!this.firstValueSet) {
-            this.firstValue = value;
-            this.firstValueSet = true;
-        }
-    }
-    onError(error) {
-        this.state = 'rejected';
-        this.rejection = error;
-        for (const onRejected of this.rejectionCallbacks) {
-            runDeferred(() => onRejected(error));
-        }
-    }
-    onCompletion() {
-        this.state = 'fulfilled';
-        for (const onFulfilled of this.fulfillmentCallbacks) {
-            runDeferred(() => onFulfilled(this.firstValue));
-        }
-    }
-    then(onFulfilledRaw, onRejectedRaw) {
-        const onFulfilled = onFulfilledRaw || returnInput;
-        const onRejected = onRejectedRaw || fail;
-        let onRejectedCalled = false;
-        return new Promise((resolve, reject) => {
-            const rejectionCallback = (error) => {
-                if (onRejectedCalled)
-                    return;
-                onRejectedCalled = true;
-                try {
-                    resolve(onRejected(error));
-                }
-                catch (anotherError) {
-                    reject(anotherError);
-                }
-            };
-            const fulfillmentCallback = (value) => {
-                try {
-                    resolve(onFulfilled(value));
-                }
-                catch (error) {
-                    rejectionCallback(error);
-                }
-            };
-            if (!this.initHasRun) {
-                this.subscribe({ error: rejectionCallback });
-            }
-            if (this.state === 'fulfilled') {
-                return resolve(onFulfilled(this.firstValue));
-            }
-            if (this.state === 'rejected') {
-                onRejectedCalled = true;
-                return resolve(onRejected(this.rejection));
-            }
-            this.fulfillmentCallbacks.push(fulfillmentCallback);
-            this.rejectionCallbacks.push(rejectionCallback);
-        });
-    }
-    catch(onRejected) {
-        return this.then(undefined, onRejected);
-    }
-    finally(onCompleted) {
-        const handler = onCompleted || doNothing;
-        return this.then((value) => {
-            handler();
-            return value;
-        }, () => handler());
-    }
-    static from(thing) {
-        return isThenable(thing)
-            ? new ObservablePromise((observer) => {
-                const onFulfilled = (value) => {
-                    observer.next(value);
-                    observer.complete();
-                };
-                const onRejected = (error) => {
-                    observer.error(error);
-                };
-                thing.then(onFulfilled, onRejected);
-            })
-            : super.from(thing);
-    }
-}
-exports.ObservablePromise = ObservablePromise;

package/dist/esm/observable.js

@@ -1,33 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Observable = exports.Subject = void 0;
-const observable_fns_1 = require("observable-fns");
-const $observers = Symbol('observers');
-class Subject extends observable_fns_1.Observable {
-    [$observers];
-    constructor() {
-        super((observer) => {
-            this[$observers] = [...(this[$observers] || []), observer];
-            const unsubscribe = () => {
-                this[$observers] = this[$observers].filter(someObserver => someObserver !== observer);
-            };
-            return unsubscribe;
-        });
-        this[$observers] = [];
-    }
-    complete() {
-        for (const observer of this[$observers])
-            observer.complete();
-    }
-    error(error) {
-        for (const observer of this[$observers])
-            observer.error(error);
-    }
-    next(value) {
-        for (const observer of this[$observers])
-            observer.next(value);
-    }
-}
-exports.Subject = Subject;
-var observable_fns_2 = require("observable-fns");
-Object.defineProperty(exports, "Observable", { enumerable: true, get: function () { return observable_fns_2.Observable; } });

package/dist/esm/ponyfills.js

@@ -1,20 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.allSettled = allSettled;
-function allSettled(values) {
-    return Promise.all(values.map((item) => {
-        const onFulfill = (value) => {
-            return { status: 'fulfilled', value };
-        };
-        const onReject = (reason) => {
-            return { reason, status: 'rejected' };
-        };
-        const itemPromise = Promise.resolve(item);
-        try {
-            return itemPromise.then(onFulfill, onReject);
-        }
-        catch (error) {
-            return Promise.reject(error);
-        }
-    }));
-}

package/dist/esm/promise.js

@@ -1,23 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createPromiseWithResolver = createPromiseWithResolver;
-const doNothing = () => undefined;
-function createPromiseWithResolver() {
-    let alreadyResolved = false;
-    let resolvedTo;
-    let resolver = doNothing;
-    const promise = new Promise((resolve) => {
-        if (alreadyResolved) {
-            resolve(resolvedTo);
-        }
-        else {
-            resolver = resolve;
-        }
-    });
-    const exposedResolver = (value) => {
-        alreadyResolved = true;
-        resolvedTo = value;
-        resolver(resolvedTo);
-    };
-    return [promise, exposedResolver];
-}

package/dist/esm/serializers.js

@@ -1,41 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DefaultSerializer = void 0;
-exports.extendSerializer = extendSerializer;
-function extendSerializer(extend, implementation) {
-    const fallbackDeserializer = extend.deserialize.bind(extend);
-    const fallbackSerializer = extend.serialize.bind(extend);
-    return {
-        deserialize(message) {
-            return implementation.deserialize(message, fallbackDeserializer);
-        },
-        serialize(input) {
-            return implementation.serialize(input, fallbackSerializer);
-        },
-    };
-}
-const DefaultErrorSerializer = {
-    deserialize(message) {
-        return Object.assign(new Error(message.message), {
-            name: message.name,
-            stack: message.stack,
-        });
-    },
-    serialize(error) {
-        return {
-            __error_marker: '$$error',
-            message: error.message,
-            name: error.name,
-            stack: error.stack,
-        };
-    },
-};
-const isSerializedError = (thing) => thing && typeof thing === 'object' && '__error_marker' in thing && thing.__error_marker === '$$error';
-exports.DefaultSerializer = {
-    deserialize(message) {
-        return isSerializedError(message) ? DefaultErrorSerializer.deserialize(message) : message;
-    },
-    serialize(input) {
-        return input instanceof Error ? DefaultErrorSerializer.serialize(input) : input;
-    },
-};

package/dist/esm/symbols.js

@@ -1,8 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.$worker = exports.$transferable = exports.$terminate = exports.$events = exports.$errors = void 0;
-exports.$errors = Symbol('thread.errors');
-exports.$events = Symbol('thread.events');
-exports.$terminate = Symbol('thread.terminate');
-exports.$transferable = Symbol('thread.transferable');
-exports.$worker = Symbol('thread.worker');

package/dist/esm/transferable.js

@@ -1,25 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isTransferDescriptor = isTransferDescriptor;
-exports.Transfer = Transfer;
-const symbols_1 = require("./symbols");
-function isTransferable(thing) {
-    if (!thing || typeof thing !== 'object')
-        return false;
-    return true;
-}
-function isTransferDescriptor(thing) {
-    return thing && typeof thing === 'object' && thing[symbols_1.$transferable];
-}
-function Transfer(payload, transferables) {
-    if (!transferables) {
-        if (!isTransferable(payload))
-            throw new Error('Not transferable');
-        transferables = [payload];
-    }
-    return {
-        [symbols_1.$transferable]: true,
-        send: payload,
-        transferables,
-    };
-}

package/dist/esm/types/master.js

@@ -1,9 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WorkerEventType = void 0;
-var WorkerEventType;
-(function (WorkerEventType) {
-    WorkerEventType["internalError"] = "internalError";
-    WorkerEventType["message"] = "message";
-    WorkerEventType["termination"] = "termination";
-})(WorkerEventType || (exports.WorkerEventType = WorkerEventType = {}));

package/dist/esm/types/messages.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WorkerMessageType = exports.MasterMessageType = void 0;
-var MasterMessageType;
-(function (MasterMessageType) {
-    MasterMessageType["cancel"] = "cancel";
-    MasterMessageType["run"] = "run";
-})(MasterMessageType || (exports.MasterMessageType = MasterMessageType = {}));
-var WorkerMessageType;
-(function (WorkerMessageType) {
-    WorkerMessageType["error"] = "error";
-    WorkerMessageType["init"] = "init";
-    WorkerMessageType["result"] = "result";
-    WorkerMessageType["running"] = "running";
-    WorkerMessageType["uncaughtError"] = "uncaughtError";
-})(WorkerMessageType || (exports.WorkerMessageType = WorkerMessageType = {}));

package/dist/esm/types/worker.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/esm/worker/bundle-entry.js

@@ -1,26 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const index_1 = require("./index");
-__exportStar(require("./index"), exports);
-if (typeof globalThis !== 'undefined') {
-    ;
-    globalThis.expose = index_1.expose;
-}
-if (typeof globalThis !== 'undefined') {
-    ;
-    globalThis.expose = index_1.expose;
-}

package/dist/esm/worker/implementation.browser.js

@@ -1,24 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const isWorkerRuntime = function isWorkerRuntime() {
-    const isWindowContext = self !== undefined && typeof Window !== 'undefined' && self instanceof Window;
-    return self !== undefined && self['postMessage'] && !isWindowContext ? true : false;
-};
-const postMessageToMaster = function postMessageToMaster(data, transferList) {
-    self.postMessage(data, transferList);
-};
-const subscribeToMasterMessages = function subscribeToMasterMessages(onMessage) {
-    const messageHandler = (messageEvent) => {
-        onMessage(messageEvent.data);
-    };
-    const unsubscribe = () => {
-        self.removeEventListener('message', messageHandler);
-    };
-    self.addEventListener('message', messageHandler);
-    return unsubscribe;
-};
-exports.default = {
-    isWorkerRuntime,
-    postMessageToMaster,
-    subscribeToMasterMessages,
-};

package/dist/esm/worker/implementation.js

@@ -1,19 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const implementation_browser_1 = __importDefault(require("./implementation.browser"));
-const implementation_tiny_worker_1 = __importDefault(require("./implementation.tiny-worker"));
-const implementation_worker_threads_1 = __importDefault(require("./implementation.worker_threads"));
-const runningInNode = typeof process !== 'undefined' && process.arch !== 'browser' && 'pid' in process;
-function selectNodeImplementation() {
-    try {
-        implementation_worker_threads_1.default.testImplementation();
-        return implementation_worker_threads_1.default;
-    }
-    catch {
-        return implementation_tiny_worker_1.default;
-    }
-}
-exports.default = runningInNode ? selectNodeImplementation() : implementation_browser_1.default;

package/dist/esm/worker/implementation.tiny-worker.js

@@ -1,37 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-try {
-    if (self === undefined) {
-        ;
-        globalThis.self = globalThis;
-    }
-}
-catch {
-    ;
-    globalThis.self = globalThis;
-}
-const isWorkerRuntime = function isWorkerRuntime() {
-    return self !== undefined && self['postMessage'] ? true : false;
-};
-const postMessageToMaster = function postMessageToMaster(data) {
-    self.postMessage(data);
-};
-let muxingHandlerSetUp = false;
-const messageHandlers = new Set();
-const subscribeToMasterMessages = function subscribeToMasterMessages(onMessage) {
-    if (!muxingHandlerSetUp) {
-        self.addEventListener('message', ((event) => {
-            for (const handler of messageHandlers)
-                handler(event.data);
-        }));
-        muxingHandlerSetUp = true;
-    }
-    messageHandlers.add(onMessage);
-    const unsubscribe = () => messageHandlers.delete(onMessage);
-    return unsubscribe;
-};
-exports.default = {
-    isWorkerRuntime,
-    postMessageToMaster,
-    subscribeToMasterMessages,
-};

package/dist/esm/worker/implementation.worker_threads.js

@@ -1,41 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const worker_threads_1 = __importDefault(require("../worker_threads"));
-function assertMessagePort(port) {
-    if (!port) {
-        throw new Error('Invariant violation: MessagePort to parent is not available.');
-    }
-    return port;
-}
-const isWorkerRuntime = function isWorkerRuntime() {
-    return !(0, worker_threads_1.default)().isMainThread;
-};
-const postMessageToMaster = function postMessageToMaster(data, transferList) {
-    assertMessagePort((0, worker_threads_1.default)().parentPort).postMessage(data, transferList);
-};
-const subscribeToMasterMessages = function subscribeToMasterMessages(onMessage) {
-    const parentPort = (0, worker_threads_1.default)().parentPort;
-    if (!parentPort) {
-        throw new Error('Invariant violation: MessagePort to parent is not available.');
-    }
-    const messageHandler = (message) => {
-        onMessage(message);
-    };
-    const unsubscribe = () => {
-        assertMessagePort(parentPort).off('message', messageHandler);
-    };
-    assertMessagePort(parentPort).on('message', messageHandler);
-    return unsubscribe;
-};
-function testImplementation() {
-    (0, worker_threads_1.default)();
-}
-exports.default = {
-    isWorkerRuntime,
-    postMessageToMaster,
-    subscribeToMasterMessages,
-    testImplementation,
-};