@ev-core/workers 0.6.1 → 0.6.2

package/dist/esm/background/background-task.d.ts

@@ -0,0 +1,26 @@
+/**
+ * A class for executing a function in a Web Worker and returning the result as a Promise.
+ * This is useful for offloading computationally expensive tasks to a background thread.
+ *
+ * @example
+ * const worker = new WorkHandler();
+ * const enhancedData = await worker.run(() => {
+ *     const data = bigCalculation();
+ *     return data;
+ * });
+ */
+export declare class BackgroundTask {
+    private worker?;
+    /**
+     * Executes the provided function in a Web Worker and returns the result as a Promise.
+     * @template T The type of the result returned by the function.
+     * @param task A function containing the logic to execute in the worker.
+     * @returns A Promise that resolves with the result of the function.
+     */
+    run<T>(task: () => T): Promise<T>;
+    /**
+     * Terminates the worker if it exists.
+     */
+    terminateWorker(): void;
+}
+//# sourceMappingURL=background-task.d.ts.map

package/dist/esm/background/background-task.js

@@ -0,0 +1,65 @@
+/**
+ * A class for executing a function in a Web Worker and returning the result as a Promise.
+ * This is useful for offloading computationally expensive tasks to a background thread.
+ *
+ * @example
+ * const worker = new WorkHandler();
+ * const enhancedData = await worker.run(() => {
+ *     const data = bigCalculation();
+ *     return data;
+ * });
+ */
+export class BackgroundTask {
+    /**
+     * Executes the provided function in a Web Worker and returns the result as a Promise.
+     * @template T The type of the result returned by the function.
+     * @param task A function containing the logic to execute in the worker.
+     * @returns A Promise that resolves with the result of the function.
+     */
+    run(task) {
+        return new Promise((resolve, reject) => {
+            const taskString = task.toString();
+            // Verify the task is serializable to a string
+            if (typeof task !== 'function' || !taskString.startsWith('function') && !taskString.startsWith('(')) {
+                reject(new Error('The provided task must be a pure function.'));
+                return;
+            }
+            const blob = new Blob([`
+                self.onmessage = function() {
+                    try {
+                        const result = (${taskString})();
+                        postMessage({ result });
+                    } catch (error) {
+                        postMessage({ error: error.message });
+                    }
+                };
+            `], { type: 'application/javascript' });
+            this.worker = new Worker(URL.createObjectURL(blob));
+            this.worker.onmessage = (event) => {
+                const { result, error } = event.data;
+                if (error) {
+                    reject(new Error(error));
+                }
+                else {
+                    resolve(result);
+                }
+                this.terminateWorker();
+            };
+            this.worker.onerror = (error) => {
+                reject(error);
+                this.terminateWorker();
+            };
+            this.worker.postMessage(null); // Start the worker task.
+        });
+    }
+    /**
+     * Terminates the worker if it exists.
+     */
+    terminateWorker() {
+        if (this.worker) {
+            this.worker.terminate();
+            this.worker = undefined;
+        }
+    }
+}
+//# sourceMappingURL=background-task.js.map

package/dist/esm/index.d.ts

@@ -0,0 +1,2 @@
+export * from './background/background-task';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.js

@@ -0,0 +1,2 @@
+export * from './background/background-task';
+//# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ev-core/workers",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "description": "Worker library for ev-core",
   "types": "dist/esm/index.d.ts",
   "module": "dist/esm/index.mjs",
@@ -21,7 +21,7 @@
   "scripts": {
     "build": "pnpm run build:cjs && pnpm run build:esm",
     "build:cjs": "tsc -p tsconfig.cjs.json",
-    "build:esm": "tsc -p tsconfig.esm.json && ts2mjs dist/esm --remove-source",
+    "build:esm": "tsc -p tsconfig.esm.json && ts2mjs dist/esm",
     "clean": "rimraf dist"
   }
 }