@effectionx/worker 0.3.1 → 0.4.0

package/script/worker.d.ts

@@ -1,63 +0,0 @@
-import { type Operation } from "effection";
-/**
- * Argument received by workerMain function
- *
- * @template TSend - value main thread will send to the worker
- * @template TRecv - value main thread will receive from the worker
- * @template TData - data passed from the main thread to the worker during initialization
- */
-export interface WorkerResource<TSend, TRecv, TReturn> extends Operation<TReturn> {
-    send(data: TSend): Operation<TRecv>;
-}
-/**
- * Use on the main thread to create and exeecute a well behaved web worker.
- *
- * @example Compute a single value
- * ```ts
- * import { run } from "effection";
- * import { useWorker } from "@effectionx/worker"
- *
- * await run(function*() {
- *    const worker = yield* useWorker("script.ts", { type: "module" });
- *
- *    try {
- *      const result = yield* worker;
- *    } catch (e) {
- *      console.error(e);
- *    }
- * });
- * ```
- *
- * @example Compute multipe values
- * ```ts
- * import { run } from "effection";
- * import { useWorker } from "@effectionx/worker"
- *
- * await run(function*() {
- *    const worker = yield* useWorker("script.ts", { type: "module" });
- *
- *    try {
- *      const result1 = yield* worker.send("Tom");
- *      const result2 = yield* worker.send("Dick");
- *      const result2 = yield* worker.send("Harry");
- *
- *      // get the last result
- *      const finalResult = yield* worker;
- *    } catch (e) {
- *      console.error(e);
- *    }
- * });
- * ```
- *
- * @param url URL or string of script
- * @param options WorkerOptions
- * @template TSend - value main thread will send to the worker
- * @template TRecv - value main thread will receive from the worker
- * @template TReturn - worker operation return value
- * @template TData - data passed from the main thread to the worker during initialization
- * @returns {Operation<WorkerResource<TSend, TRecv>>}
- */
-export declare function useWorker<TSend, TRecv, TReturn, TData>(url: string | URL, options?: WorkerOptions & {
-    data?: TData;
-}): Operation<WorkerResource<TSend, TRecv, TReturn>>;
-//# sourceMappingURL=worker.d.ts.map

package/script/worker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,SAAS,EAKf,MAAM,WAAW,CAAC;AAInB;;;;;;GAMG;AACH,MAAM,WAAW,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CACnD,SAAQ,SAAS,CAAC,OAAO,CAAC;IAC1B,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EACpD,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,OAAO,CAAC,EAAE,aAAa,GAAG;IAAE,IAAI,CAAC,EAAE,KAAK,CAAA;CAAE,GACzC,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAgElD"}

package/script/worker.js

@@ -1,124 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useWorker = useWorker;
-const mod_js_1 = require("./deps/jsr.io/@std/assert/1.0.16/mod.js");
-const effection_1 = require("effection");
-const message_channel_js_1 = require("./message-channel.js");
-/**
- * Use on the main thread to create and exeecute a well behaved web worker.
- *
- * @example Compute a single value
- * ```ts
- * import { run } from "effection";
- * import { useWorker } from "@effectionx/worker"
- *
- * await run(function*() {
- *    const worker = yield* useWorker("script.ts", { type: "module" });
- *
- *    try {
- *      const result = yield* worker;
- *    } catch (e) {
- *      console.error(e);
- *    }
- * });
- * ```
- *
- * @example Compute multipe values
- * ```ts
- * import { run } from "effection";
- * import { useWorker } from "@effectionx/worker"
- *
- * await run(function*() {
- *    const worker = yield* useWorker("script.ts", { type: "module" });
- *
- *    try {
- *      const result1 = yield* worker.send("Tom");
- *      const result2 = yield* worker.send("Dick");
- *      const result2 = yield* worker.send("Harry");
- *
- *      // get the last result
- *      const finalResult = yield* worker;
- *    } catch (e) {
- *      console.error(e);
- *    }
- * });
- * ```
- *
- * @param url URL or string of script
- * @param options WorkerOptions
- * @template TSend - value main thread will send to the worker
- * @template TRecv - value main thread will receive from the worker
- * @template TReturn - worker operation return value
- * @template TData - data passed from the main thread to the worker during initialization
- * @returns {Operation<WorkerResource<TSend, TRecv>>}
- */
-function useWorker(url, options) {
-    return (0, effection_1.resource)(function* (provide) {
-        let outcome = (0, effection_1.withResolvers)();
-        let worker = new Worker(url, options);
-        let subscription = yield* (0, effection_1.on)(worker, "message");
-        let onclose = (event) => {
-            if (event.data.type === "close") {
-                let { result } = event.data;
-                if (result.ok) {
-                    outcome.resolve(result.value);
-                }
-                else {
-                    outcome.reject(result.error);
-                }
-            }
-        };
-        worker.addEventListener("message", onclose);
-        let first = yield* subscription.next();
-        (0, mod_js_1.assert)(first.value.data.type === "open", `expected first message to arrive from worker to be of type "open", but was: ${first.value.data.type}`);
-        yield* (0, effection_1.spawn)(function* () {
-            let event = yield* (0, effection_1.once)(worker, "error");
-            event.preventDefault();
-            throw event.error;
-        });
-        try {
-            worker.postMessage({
-                type: "init",
-                data: options?.data,
-            });
-            yield* provide({
-                *send(value) {
-                    let channel = yield* (0, message_channel_js_1.useMessageChannel)();
-                    worker.postMessage({
-                        type: "send",
-                        value,
-                        response: channel.port2,
-                    }, [channel.port2]);
-                    channel.port1.start();
-                    let event = yield* (0, effection_1.once)(channel.port1, "message");
-                    let result = event.data;
-                    if (result.ok) {
-                        return result.value;
-                    }
-                    else {
-                        throw result.error;
-                    }
-                },
-                [Symbol.iterator]: outcome.operation[Symbol.iterator],
-            });
-        }
-        finally {
-            worker.postMessage({ type: "close" });
-            yield* settled(outcome.operation);
-            worker.removeEventListener("message", onclose);
-        }
-    });
-}
-function settled(operation) {
-    return {
-        *[Symbol.iterator]() {
-            try {
-                yield* operation;
-                return (0, effection_1.Ok)(void 0);
-            }
-            catch (error) {
-                return (0, effection_1.Err)(error);
-            }
-        },
-    };
-}