worker-testbed 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Petr Tripolsky
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,28 @@
+# workertest
+
+> The AI-ready testbed which use Worker Threads to create isolated vm context
+
+A worker-threads based test framework using `Node.js`, `tape`, and `functools-kit`, enabling parallel execution of isolated test cases. The main thread registers and spawns worker threads for each test, while the workers retrieve and execute tests, reporting results back via parentPort. This approach enhances test isolation, concurrency, and performance.
+
+## Usage
+
+```tsx
+import { run, test } from 'workertest';
+
+test("Will pass after three seconds", (t) => {
+    globalThis.test = {};
+    globalThis.test.foo = "bar";
+    setTimeout(() => {
+        t.pass(globalThis.test.foo);
+    }, 3_000);
+})
+
+test("Will fail after a second cause globalThis.test is undefined", (t) => {
+    setTimeout(() => {
+        t.pass(globalThis.test.foo);
+    }, 1_000);
+})
+
+run(import.meta.url)
+
+```

package/build/index.cjs

@@ -0,0 +1,71 @@
+'use strict';
+
+var worker_threads = require('worker_threads');
+var url = require('url');
+var functoolsKit = require('functools-kit');
+var tape = require('tape');
+
+const workerFileSubject = new functoolsKit.BehaviorSubject();
+let testRegistry = new functoolsKit.ToolRegistry("workertest");
+const waitForFile = async () => {
+    if (workerFileSubject.data) {
+        return workerFileSubject.data;
+    }
+    return await workerFileSubject.toPromise();
+};
+class TestWrapper {
+    testName;
+    cb;
+    constructor(testName, cb) {
+        this.testName = testName;
+        this.cb = cb;
+    }
+}
+const test = (testName, cb) => {
+    if (worker_threads.isMainThread) {
+        tape(testName, async (test) => {
+            const [awaiter, { resolve }] = functoolsKit.createAwaiter();
+            const workerFile = await waitForFile();
+            const worker = new worker_threads.Worker(workerFile, {
+                workerData: { testName },
+            });
+            worker.once("message", ({ status, msg }) => {
+                if (status === "pass") {
+                    test.pass(msg);
+                }
+                else if (status === "fail") {
+                    test.fail(msg);
+                }
+                resolve();
+            });
+            worker.on("error", (err) => {
+                test.fail(`Worker error: ${err.message}`);
+                resolve();
+            });
+            worker.on("exit", (code) => {
+                if (code !== 0) {
+                    test.fail(`Worker stopped with exit code ${code}`);
+                    resolve();
+                }
+            });
+            return await awaiter;
+        });
+    }
+    testRegistry = testRegistry.register(testName, new TestWrapper(testName, cb));
+};
+const run = async (__filename) => {
+    if (worker_threads.isMainThread) {
+        workerFileSubject.next(url.fileURLToPath(__filename));
+        return;
+    }
+    if (!worker_threads.parentPort) {
+        throw new Error("workertest parentPort is null");
+    }
+    testRegistry.get(worker_threads.workerData.testName).cb({
+        pass: (msg) => worker_threads.parentPort.postMessage({ status: "pass", msg }),
+        fail: (msg) => worker_threads.parentPort.postMessage({ status: "fail", msg }),
+    });
+};
+
+exports.run = run;
+exports.test = test;

package/build/index.mjs

@@ -0,0 +1,68 @@
+import { isMainThread, Worker, parentPort, workerData } from 'worker_threads';
+import { fileURLToPath } from 'url';
+import { BehaviorSubject, ToolRegistry, createAwaiter } from 'functools-kit';
+import tape from 'tape';
+
+const workerFileSubject = new BehaviorSubject();
+let testRegistry = new ToolRegistry("workertest");
+const waitForFile = async () => {
+    if (workerFileSubject.data) {
+        return workerFileSubject.data;
+    }
+    return await workerFileSubject.toPromise();
+};
+class TestWrapper {
+    testName;
+    cb;
+    constructor(testName, cb) {
+        this.testName = testName;
+        this.cb = cb;
+    }
+}
+const test = (testName, cb) => {
+    if (isMainThread) {
+        tape(testName, async (test) => {
+            const [awaiter, { resolve }] = createAwaiter();
+            const workerFile = await waitForFile();
+            const worker = new Worker(workerFile, {
+                workerData: { testName },
+            });
+            worker.once("message", ({ status, msg }) => {
+                if (status === "pass") {
+                    test.pass(msg);
+                }
+                else if (status === "fail") {
+                    test.fail(msg);
+                }
+                resolve();
+            });
+            worker.on("error", (err) => {
+                test.fail(`Worker error: ${err.message}`);
+                resolve();
+            });
+            worker.on("exit", (code) => {
+                if (code !== 0) {
+                    test.fail(`Worker stopped with exit code ${code}`);
+                    resolve();
+                }
+            });
+            return await awaiter;
+        });
+    }
+    testRegistry = testRegistry.register(testName, new TestWrapper(testName, cb));
+};
+const run = async (__filename) => {
+    if (isMainThread) {
+        workerFileSubject.next(fileURLToPath(__filename));
+        return;
+    }
+    if (!parentPort) {
+        throw new Error("workertest parentPort is null");
+    }
+    testRegistry.get(workerData.testName).cb({
+        pass: (msg) => parentPort.postMessage({ status: "pass", msg }),
+        fail: (msg) => parentPort.postMessage({ status: "fail", msg }),
+    });
+};
+
+export { run, test };

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "worker-testbed",
+  "version": "1.0.0",
+  "description": "The AI-ready testbed which use Worker Threads to create isolated vm context",
+  "author": {
+    "name": "Petr Tripolsky",
+    "email": "tripolskypetr@gmail.com",
+    "url": "https://github.com/tripolskypetr"
+  },
+  "funding": {
+    "type": "individual",
+    "url": "http://paypal.me/tripolskypetr"
+  },
+  "license": "MIT",
+  "homepage": "https://react-declarative-playground.github.io",
+  "keywords": [
+    "react-declarative",
+    "dependency-injection",
+    "nodejs",
+    "transient",
+    "stateless",
+    "asp.net core"
+  ],
+  "files": [
+    "build",
+    "types.d.ts",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/react-declarative/react-declarative",
+    "documentation": "https://github.com/react-declarative/react-declarative/tree/master/docs"
+  },
+  "bugs": {
+    "url": "https://github.com/react-declarative/react-declarative/issues"
+  },
+  "scripts": {
+    "build": "rollup -c",
+    "test": "npm run build && node ./test/test.mjs"
+  },
+  "main": "build/index.cjs",
+  "module": "build/index.mjs",
+  "source": "src/index.ts",
+  "types": "./types.d.ts",
+  "exports": {
+    "require": "./build/index.cjs",
+    "types": "./types.d.ts",
+    "import": "./build/index.mjs",
+    "default": "./build/index.cjs"
+  },
+  "devDependencies": {
+    "@rollup/plugin-typescript": "11.1.6",
+    "@types/node": "22.9.0",
+    "@types/tape": "^5.8.1",
+    "rollup": "3.29.4",
+    "rollup-plugin-dts": "6.1.1",
+    "rollup-plugin-peer-deps-external": "2.2.4",
+    "tslib": "2.7.0"
+  },
+  "peerDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "dependencies": {
+    "functools-kit": "^1.0.61",
+    "tape": "^5.9.0"
+  }
+}

package/types.d.ts

@@ -0,0 +1,8 @@
+interface ITest {
+    pass(msg?: string): void;
+    fail(msg?: string): void;
+}
+declare const test: (testName: string, cb: (t: ITest) => void) => void;
+declare const run: (__filename: string) => Promise<void>;
+
+export { run, test };