stardust-parallel-js 1.0.0

package/README.md

@@ -0,0 +1,228 @@
+# parallel.js
+
+Библиотека для параллельного выполнения JavaScript/TypeScript функций с использованием Worker Threads в Node.js.
+
+## Возможности
+
+- ✨ Простой API для параллельного выполнения функций
+- 🔄 Пул потоков для эффективного управления ресурсами
+- 🚀 Отдельные потоки для разовых задач
+- 📦 TypeScript поддержка из коробки
+- 🛡️ Автоматическое восстановление упавших потоков
+- ⚡ Асинхронная обработка задач с очередью
+
+## Установка
+
+```bash
+npm install parallel.js
+# или
+pnpm install parallel.js
+# или
+yarn add parallel.js
+```
+
+## Использование
+
+### ThreadPool - Пул потоков
+
+Используйте `ThreadPool` для выполнения множества задач с ограниченным количеством потоков:
+
+```typescript
+import { ThreadPool } from 'parallel.js';
+
+// Создаем пул из 4 потоков
+const pool = new ThreadPool(4);
+
+// Выполнение одной задачи
+const result = await pool.execute(
+  (n: number) => {
+    // Тяжелые вычисления
+    let sum = 0;
+    for (let i = 0; i < n; i++) {
+      sum += Math.sqrt(i);
+    }
+    return sum;
+  },
+  [1000000]
+);
+
+console.log(result);
+
+// Параллельная обработка массива
+const numbers = [1, 2, 3, 4, 5, 6, 7, 8];
+const squares = await pool.map(numbers, (n: number) => n * n);
+console.log(squares); // [1, 4, 9, 16, 25, 36, 49, 64]
+
+// Не забудьте остановить пул
+await pool.terminate();
+```
+
+### Thread - Отдельный поток
+
+Используйте `Thread` для разовых задач:
+
+```typescript
+import { Thread } from 'parallel.js';
+
+// Создаем поток для выполнения функции
+const thread = new Thread(
+  (text: string) => {
+    return text.toUpperCase();
+  },
+  ['hello world']
+);
+
+// Ждем результат
+const result = await thread.join();
+console.log(result); // "HELLO WORLD"
+
+// Стрелочные функции также поддерживаются
+const thread2 = new Thread(x => x * 2, [21]);
+const result2 = await thread2.join();
+console.log(result2); // 42
+```
+
+## API
+
+### ThreadPool
+
+#### `constructor(size: number)`
+Создает пул потоков заданного размера.
+
+```typescript
+const pool = new ThreadPool(4);
+```
+
+#### `execute<TArgs, TResult>(fn: (...args: TArgs) => TResult, args?: TArgs): Promise<TResult>`
+Выполняет функцию в доступном потоке из пула.
+
+```typescript
+const result = await pool.execute(
+#### `map<T, R>(items: T[], fn: (item: T) => R): Promise<R[]>`
+Применяет функцию к каждому элементу массива параллельно.
+
+```typescript
+// Стрелочная функция
+const results = await pool.map([1, 2, 3], n => n * 2);
+
+// Обычная функция
+const results2 = await pool.map([1, 2, 3], function(n) { return n * 2; });
+```# `map<T, R>(items: T[], fn: (item: T) => R): Promise<R[]>`
+Применяет функцию к каждому элементу массива параллельно.
+
+```typescript
+const results = await pool.map([1, 2, 3], (n) => n * 2);
+```
+
+#### `terminate(): Promise<void>`
+Останавливает все потоки и освобождает ресурсы.
+
+```typescript
+await pool.terminate();
+```
+
+### Thread
+
+#### `constructor<T, TArgs>(fn: (...args: TArgs) => T, args?: TArgs)`
+Создает новый поток для выполнения функции.
+
+```typescript
+const thread = new Thread((x: number) => x * x, [5]);
+```
+
+#### `join(): Promise<T>`
+Ожидает завершения выполнения и возвращает результат. Автоматически завершает поток.
+
+```typescript
+const result = await thread.join();
+```
+
+## Примеры
+
+### Обработка больших данных
+
+```typescript
+import { ThreadPool } from 'parallel.js';
+
+const pool = new ThreadPool(8);
+
+const data = Array.from({ length: 10000 }, (_, i) => i);
+
+const processed = await pool.map(data, (item: number) => {
+  // Сложная обработка каждого элемента
+  return Math.sin(item) * Math.cos(item);
+});
+### Вычисление чисел Фибоначчи
+
+```typescript
+import { ThreadPool } from 'parallel.js';
+
+const pool = new ThreadPool(4);
+
+const numbers = [35, 36, 37, 38, 39, 40];
+
+const results = await pool.map(numbers, n => {
+  function fibonacci(num) {
+    if (num <= 1) return num;
+    return fibonacci(num - 1) + fibonacci(num - 2);
+  }
+  return fibonacci(n);
+});
+
+console.log(results); // [9227465, 14930352, 24157817, ...]
+
+await pool.terminate();
+```
+
+### Использование встроенных модулей Node.js
+
+```typescript
+import { ThreadPool } from 'parallel.js';
+
+const pool = new ThreadPool(4);
+
+// require() доступен внутри функций
+const result = await pool.execute(() => {
+  const fs = require('fs');
+  const path = require('path');
+  return path.join('folder', 'file.txt');
+});
+
+console.log(result); // 'folder/file.txt' или 'folder\\file.txt'
+
+await pool.terminate();
+```eturn response.json();
+});
+
+await pool.terminate();
+```
+
+## Важные замечания
+
+- 🔒 Функции, передаваемые в потоки, выполняются в изолированном контексте
+- 📦 Все аргументы и результаты должны быть сериализуемыми (передаются через структурированное клонирование)
+- 🚫 Нельзя использовать замыкания - функции не имеют доступа к внешним переменным из основного потока
+- ✅ Поддерживаются как обычные функции (`function`), так и стрелочные (`=>`)
+- ✅ `require()` и встроенные модули Node.js доступны внутри функций
+- ⚡ Worker Threads лучше всего подходят для CPU-интенсивных задач
+
+## Требования
+
+- Node.js >= 14.0.0 (с поддержкой Worker Threads)
+
+## Лицензия
+
+ISC
+
+## Разработка
+
+```bash
+# Установка зависимостей
+pnpm install
+
+# Запуск тестов
+pnpm test
+
+# Сборка
+pnpm build
+```

package/dist/Thread.d.ts

@@ -0,0 +1,8 @@
+declare class Thread<T, TArgs extends unknown[] = unknown[]> {
+    private worker;
+    private promise;
+    constructor(fn: (...args: TArgs) => T, args?: TArgs);
+    join(): Promise<T>;
+}
+export { Thread };
+//# sourceMappingURL=Thread.d.ts.map

package/dist/Thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Thread.d.ts","sourceRoot":"","sources":["../src/Thread.ts"],"names":[],"mappings":"AAGA,cAAM,MAAM,CAAC,CAAC,EAAE,KAAK,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE;IAC/C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAa;gBAEhB,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,CAAC,EAAE,IAAI,GAAE,KAA8B;IAwBrE,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC;CAQ3B;AAED,OAAO,EAAE,MAAM,EAAE,CAAA"}

package/dist/Thread.js

@@ -0,0 +1,39 @@
+import { Worker } from "node:worker_threads";
+import { createWorker } from "@/utils/workerFactory.js";
+class Thread {
+    worker;
+    promise;
+    constructor(fn, args = []) {
+        this.worker = createWorker();
+        this.promise = new Promise((resolve, reject) => {
+            this.worker.on('message', (res) => {
+                if (res.success) {
+                    resolve(res.result);
+                }
+                else {
+                    reject(new Error(res.error));
+                }
+            });
+            this.worker.on('error', (err) => {
+                reject(err);
+            });
+            this.worker.on('exit', (code) => {
+                if (code !== 0) {
+                    reject(new Error(`Worker stopped with exit code ${code}`));
+                }
+            });
+        });
+        this.worker.postMessage({ fn: fn.toString(), args });
+    }
+    async join() {
+        try {
+            const result = await this.promise;
+            return result;
+        }
+        finally {
+            this.worker.terminate();
+        }
+    }
+}
+export { Thread };
+//# sourceMappingURL=Thread.js.map

package/dist/Thread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Thread.js","sourceRoot":"","sources":["../src/Thread.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,MAAM,MAAM;IACA,MAAM,CAAS;IACf,OAAO,CAAa;IAE5B,YAAY,EAAyB,EAAE,OAAc,EAAsB;QACvE,IAAI,CAAC,MAAM,GAAG,YAAY,EAAE,CAAC;QAE7B,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC9C,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAqD,EAAE,EAAE;gBAChF,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;oBACd,OAAO,CAAC,GAAG,CAAC,MAAW,CAAC,CAAC;gBAC7B,CAAC;qBAAM,CAAC;oBACJ,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;gBACjC,CAAC;YACL,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBAC5B,MAAM,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;gBAC5B,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACb,MAAM,CAAC,IAAI,KAAK,CAAC,iCAAiC,IAAI,EAAE,CAAC,CAAC,CAAC;gBAC/D,CAAC;YACL,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,IAAI;QACN,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;YAClC,OAAO,MAAM,CAAC;QAClB,CAAC;gBAAS,CAAC;YACP,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QAC5B,CAAC;IACL,CAAC;CACJ;AAED,OAAO,EAAE,MAAM,EAAE,CAAA"}

package/dist/ThreadPool.d.ts

@@ -0,0 +1,22 @@
+export declare class ThreadPool {
+    private size;
+    private workers;
+    private availableWorkers;
+    private taskQueue;
+    private workerTasks;
+    constructor(size: number);
+    private initWorkers;
+    private setupWorkerHandlers;
+    private recoverWorker;
+    private processQueue;
+    execute<TArgs extends unknown[], TResult>(fn: (...args: TArgs) => TResult, args?: TArgs): Promise<TResult>;
+    map<T, R>(items: T[], fn: (item: T) => R): Promise<R[]>;
+    getStats(): {
+        totalWorkers: number;
+        availableWorkers: number;
+        busyWorkers: number;
+        queuedTasks: number;
+    };
+    terminate(): Promise<void>;
+}
+//# sourceMappingURL=ThreadPool.d.ts.map

package/dist/ThreadPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadPool.d.ts","sourceRoot":"","sources":["../src/ThreadPool.ts"],"names":[],"mappings":"AAWA,qBAAa,UAAU;IAMP,OAAO,CAAC,IAAI;IALxB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,gBAAgB,CAAgB;IACxC,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,WAAW,CAAoC;gBAEnC,IAAI,EAAE,MAAM;IAIhC,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,mBAAmB;IA0B3B,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,YAAY;IAUd,OAAO,CAAC,KAAK,SAAS,OAAO,EAAE,EAAE,OAAO,EAC1C,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,EAC/B,IAAI,GAAE,KAA8B,GACrC,OAAO,CAAC,OAAO,CAAC;IAab,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAM7D,QAAQ;;;;;;IASF,SAAS;CASlB"}

package/dist/ThreadPool.js

@@ -0,0 +1,95 @@
+import { Worker } from "node:worker_threads";
+import { createWorker } from "@/utils/workerFactory.js";
+import { Queue } from "@datastructures-js/queue";
+export class ThreadPool {
+    size;
+    workers = [];
+    availableWorkers = [];
+    taskQueue = new Queue();
+    workerTasks = new Map();
+    constructor(size) {
+        this.size = size;
+        this.initWorkers();
+    }
+    initWorkers() {
+        for (let i = 0; i < this.size; i++) {
+            const worker = createWorker();
+            this.setupWorkerHandlers(worker);
+            this.workers.push(worker);
+            this.availableWorkers.push(worker);
+        }
+    }
+    setupWorkerHandlers(worker) {
+        worker.on('message', (res) => {
+            const task = this.workerTasks.get(worker);
+            if (!task)
+                return;
+            if (res.success) {
+                task.resolve(res.result);
+            }
+            else {
+                task.reject(new Error(res.error));
+            }
+            this.workerTasks.delete(worker);
+            this.availableWorkers.push(worker);
+            this.processQueue();
+        });
+        worker.on('error', (err) => {
+            const task = this.workerTasks.get(worker);
+            if (task) {
+                task.reject(err);
+                this.workerTasks.delete(worker);
+            }
+            this.recoverWorker(worker);
+        });
+    }
+    recoverWorker(crashedWorker) {
+        this.workers = this.workers.filter(worker => worker !== crashedWorker);
+        this.availableWorkers = this.availableWorkers.filter(worker => worker !== crashedWorker);
+        crashedWorker.terminate();
+        const newWorker = createWorker();
+        this.setupWorkerHandlers(newWorker);
+        this.workers.push(newWorker);
+        this.availableWorkers.push(newWorker);
+        this.processQueue();
+    }
+    processQueue() {
+        while (!this.taskQueue.isEmpty() && this.availableWorkers.length > 0) {
+            const worker = this.availableWorkers.pop();
+            const task = this.taskQueue.dequeue();
+            this.workerTasks.set(worker, task);
+            worker.postMessage({ fn: task.fn.toString(), args: task.args });
+        }
+    }
+    async execute(fn, args = []) {
+        return new Promise((resolve, reject) => {
+            const task = {
+                fn: fn.toString(),
+                args,
+                resolve: resolve,
+                reject
+            };
+            this.taskQueue.enqueue(task);
+            this.processQueue();
+        });
+    }
+    async map(items, fn) {
+        return Promise.all(items.map(item => this.execute(fn, [item])));
+    }
+    getStats() {
+        return {
+            totalWorkers: this.workers.length,
+            availableWorkers: this.availableWorkers.length,
+            busyWorkers: this.workers.length - this.availableWorkers.length,
+            queuedTasks: this.taskQueue.size(),
+        };
+    }
+    async terminate() {
+        await Promise.all(this.workers.map(w => w.terminate()));
+        this.workers = [];
+        this.availableWorkers = [];
+        this.taskQueue = new Queue();
+        this.workerTasks.clear();
+    }
+}
+//# sourceMappingURL=ThreadPool.js.map

package/dist/ThreadPool.js.map

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

package/dist/examples/thread.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=thread.d.ts.map

package/dist/examples/thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread.d.ts","sourceRoot":"","sources":["../../src/examples/thread.ts"],"names":[],"mappings":""}

package/dist/examples/thread.js

@@ -0,0 +1,60 @@
+import { Thread } from "@/Thread.js";
+async function main() {
+    console.log("🚀 Запуск примера с потоками...\n");
+    // Создаем поток для выполнения тяжелых вычислений
+    console.log("⏳ Запускаем вычисление факториала 20 в отдельном потоке...");
+    const factorialThread = new Thread(function (n) {
+        function factorial(num) {
+            if (num <= 1)
+                return 1;
+            return num * factorial(num - 1);
+        }
+        // Симулируем долгое вычисление
+        const start = Date.now();
+        const result = factorial(n);
+        const duration = Date.now() - start;
+        return { result, duration };
+    }, [20]);
+    // Создаем поток для обработки массива
+    console.log("⏳ Запускаем обработку массива в отдельном потоке...");
+    const arrayThread = new Thread(function (arr) {
+        const sum = arr.reduce(function (a, b) { return a + b; }, 0);
+        const avg = sum / arr.length;
+        const max = Math.max(...arr);
+        const min = Math.min(...arr);
+        return { sum, avg, max, min };
+    }, [[1, 2, 3, 4, 5, 6, 7, 8, 9, 10]]);
+    // Создаем поток для проверки простых чисел
+    console.log("⏳ Запускаем поиск простых чисел в отдельном потоке...");
+    const primeThread = new Thread(function (limit) {
+        function isPrime(num) {
+            if (num < 2)
+                return false;
+            for (let i = 2; i <= Math.sqrt(num); i++) {
+                if (num % i === 0)
+                    return false;
+            }
+            return true;
+        }
+        const primes = [];
+        for (let i = 2; i <= limit; i++) {
+            if (isPrime(i))
+                primes.push(i);
+        }
+        return primes;
+    }, [100]);
+    console.log("\n⏰ Главный поток продолжает работу, пока потоки выполняются...");
+    console.log("✅ Главный поток свободен для других задач!\n");
+    // Ждем результаты от всех потоков
+    console.log("🔄 Ожидаем результаты от потоков...\n");
+    const factorialResult = await factorialThread.join();
+    console.log(`✨ Факториал: ${factorialResult.result} (выполнено за ${factorialResult.duration}мс)`);
+    const arrayResult = await arrayThread.join();
+    console.log(`✨ Статистика массива:`, arrayResult);
+    const primeResult = await primeThread.join();
+    console.log(`✨ Простые числа до 100: ${primeResult.join(', ')}`);
+    console.log(`   Найдено ${primeResult.length} простых чисел`);
+    console.log("\n🎉 Все потоки завершены!");
+}
+main();
+//# sourceMappingURL=thread.js.map

package/dist/examples/thread.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { ThreadPool } from "@/primitives/ThreadPool.js";
+export { Thread } from "@/primitives/Thread.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { ThreadPool } from "@/primitives/ThreadPool.js";
+export { Thread } from "@/primitives/Thread.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/primitives/Thread.d.ts

@@ -0,0 +1,8 @@
+declare class Thread<T, TArgs extends unknown[] = unknown[]> {
+    private worker;
+    private promise;
+    constructor(fn: (...args: TArgs) => T, args?: TArgs);
+    join(): Promise<T>;
+}
+export { Thread };
+//# sourceMappingURL=Thread.d.ts.map

package/dist/primitives/Thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Thread.d.ts","sourceRoot":"","sources":["../../src/primitives/Thread.ts"],"names":[],"mappings":"AAGA,cAAM,MAAM,CAAC,CAAC,EAAE,KAAK,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE;IAC/C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAa;gBAEhB,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,CAAC,EAAE,IAAI,GAAE,KAA8B;IAwBrE,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC;CAQ3B;AAED,OAAO,EAAE,MAAM,EAAE,CAAA"}

package/dist/primitives/Thread.js

@@ -0,0 +1,39 @@
+import { Worker } from "node:worker_threads";
+import { createWorker } from "@/utils/workerFactory.js";
+class Thread {
+    worker;
+    promise;
+    constructor(fn, args = []) {
+        this.worker = createWorker();
+        this.promise = new Promise((resolve, reject) => {
+            this.worker.on('message', (res) => {
+                if (res.success) {
+                    resolve(res.result);
+                }
+                else {
+                    reject(new Error(res.error));
+                }
+            });
+            this.worker.on('error', (err) => {
+                reject(err);
+            });
+            this.worker.on('exit', (code) => {
+                if (code !== 0) {
+                    reject(new Error(`Worker stopped with exit code ${code}`));
+                }
+            });
+        });
+        this.worker.postMessage({ fn: fn.toString(), args });
+    }
+    async join() {
+        try {
+            const result = await this.promise;
+            return result;
+        }
+        finally {
+            this.worker.terminate();
+        }
+    }
+}
+export { Thread };
+//# sourceMappingURL=Thread.js.map

package/dist/primitives/Thread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Thread.js","sourceRoot":"","sources":["../../src/primitives/Thread.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,MAAM,MAAM;IACA,MAAM,CAAS;IACf,OAAO,CAAa;IAE5B,YAAY,EAAyB,EAAE,OAAc,EAAsB;QACvE,IAAI,CAAC,MAAM,GAAG,YAAY,EAAE,CAAC;QAE7B,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC9C,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAqD,EAAE,EAAE;gBAChF,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;oBACd,OAAO,CAAC,GAAG,CAAC,MAAW,CAAC,CAAC;gBAC7B,CAAC;qBAAM,CAAC;oBACJ,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;gBACjC,CAAC;YACL,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBAC5B,MAAM,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;gBAC5B,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACb,MAAM,CAAC,IAAI,KAAK,CAAC,iCAAiC,IAAI,EAAE,CAAC,CAAC,CAAC;gBAC/D,CAAC;YACL,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,IAAI;QACN,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;YAClC,OAAO,MAAM,CAAC;QAClB,CAAC;gBAAS,CAAC;YACP,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QAC5B,CAAC;IACL,CAAC;CACJ;AAED,OAAO,EAAE,MAAM,EAAE,CAAA"}

package/dist/primitives/ThreadPool.d.ts

@@ -0,0 +1,22 @@
+export declare class ThreadPool {
+    private size;
+    private workers;
+    private availableWorkers;
+    private taskQueue;
+    private workerTasks;
+    constructor(size: number);
+    private initWorkers;
+    private setupWorkerHandlers;
+    private recoverWorker;
+    private processQueue;
+    execute<TArgs extends unknown[], TResult>(fn: (...args: TArgs) => TResult, args?: TArgs): Promise<TResult>;
+    map<T, R>(items: T[], fn: (item: T) => R): Promise<R[]>;
+    getStats(): {
+        totalWorkers: number;
+        availableWorkers: number;
+        busyWorkers: number;
+        queuedTasks: number;
+    };
+    terminate(): Promise<void>;
+}
+//# sourceMappingURL=ThreadPool.d.ts.map

package/dist/primitives/ThreadPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadPool.d.ts","sourceRoot":"","sources":["../../src/primitives/ThreadPool.ts"],"names":[],"mappings":"AAWA,qBAAa,UAAU;IAMP,OAAO,CAAC,IAAI;IALxB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,gBAAgB,CAAgB;IACxC,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,WAAW,CAAoC;gBAEnC,IAAI,EAAE,MAAM;IAIhC,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,mBAAmB;IA0B3B,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,YAAY;IAUd,OAAO,CAAC,KAAK,SAAS,OAAO,EAAE,EAAE,OAAO,EAC1C,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,EAC/B,IAAI,GAAE,KAA8B,GACrC,OAAO,CAAC,OAAO,CAAC;IAab,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAM7D,QAAQ;;;;;;IASF,SAAS;CASlB"}

package/dist/primitives/ThreadPool.js

@@ -0,0 +1,95 @@
+import { Worker } from "node:worker_threads";
+import { createWorker } from "@/utils/workerFactory.js";
+import { Queue } from "@datastructures-js/queue";
+export class ThreadPool {
+    size;
+    workers = [];
+    availableWorkers = [];
+    taskQueue = new Queue();
+    workerTasks = new Map();
+    constructor(size) {
+        this.size = size;
+        this.initWorkers();
+    }
+    initWorkers() {
+        for (let i = 0; i < this.size; i++) {
+            const worker = createWorker();
+            this.setupWorkerHandlers(worker);
+            this.workers.push(worker);
+            this.availableWorkers.push(worker);
+        }
+    }
+    setupWorkerHandlers(worker) {
+        worker.on('message', (res) => {
+            const task = this.workerTasks.get(worker);
+            if (!task)
+                return;
+            if (res.success) {
+                task.resolve(res.result);
+            }
+            else {
+                task.reject(new Error(res.error));
+            }
+            this.workerTasks.delete(worker);
+            this.availableWorkers.push(worker);
+            this.processQueue();
+        });
+        worker.on('error', (err) => {
+            const task = this.workerTasks.get(worker);
+            if (task) {
+                task.reject(err);
+                this.workerTasks.delete(worker);
+            }
+            this.recoverWorker(worker);
+        });
+    }
+    recoverWorker(crashedWorker) {
+        this.workers = this.workers.filter(worker => worker !== crashedWorker);
+        this.availableWorkers = this.availableWorkers.filter(worker => worker !== crashedWorker);
+        crashedWorker.terminate();
+        const newWorker = createWorker();
+        this.setupWorkerHandlers(newWorker);
+        this.workers.push(newWorker);
+        this.availableWorkers.push(newWorker);
+        this.processQueue();
+    }
+    processQueue() {
+        while (!this.taskQueue.isEmpty() && this.availableWorkers.length > 0) {
+            const worker = this.availableWorkers.pop();
+            const task = this.taskQueue.dequeue();
+            this.workerTasks.set(worker, task);
+            worker.postMessage({ fn: task.fn.toString(), args: task.args });
+        }
+    }
+    async execute(fn, args = []) {
+        return new Promise((resolve, reject) => {
+            const task = {
+                fn: fn.toString(),
+                args,
+                resolve: resolve,
+                reject
+            };
+            this.taskQueue.enqueue(task);
+            this.processQueue();
+        });
+    }
+    async map(items, fn) {
+        return Promise.all(items.map(item => this.execute(fn, [item])));
+    }
+    getStats() {
+        return {
+            totalWorkers: this.workers.length,
+            availableWorkers: this.availableWorkers.length,
+            busyWorkers: this.workers.length - this.availableWorkers.length,
+            queuedTasks: this.taskQueue.size(),
+        };
+    }
+    async terminate() {
+        await Promise.all(this.workers.map(w => w.terminate()));
+        this.workers = [];
+        this.availableWorkers = [];
+        this.taskQueue = new Queue();
+        this.workerTasks.clear();
+    }
+}
+//# sourceMappingURL=ThreadPool.js.map

package/dist/primitives/ThreadPool.js.map

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

package/dist/utils/workerFactory.d.ts

@@ -0,0 +1,3 @@
+import { Worker } from "node:worker_threads";
+export declare function createWorker(): Worker;
+//# sourceMappingURL=workerFactory.d.ts.map

package/dist/utils/workerFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workerFactory.d.ts","sourceRoot":"","sources":["../../src/utils/workerFactory.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AA6C7C,wBAAgB,YAAY,WAG3B"}

package/dist/utils/workerFactory.js

@@ -0,0 +1,54 @@
+/*
+    Worker Factory
+    Creates a new Worker instance with predefined code to execute functions.
+    Worker returns results or errors back to the main thread.
+    Supports both regular and arrow functions.
+*/
+import { Worker } from "node:worker_threads";
+const workerCode = `
+            const { parentPort } = require('worker_threads');
+            parentPort.on('message', ({ fn, args }) => {
+                try {
+                    // Remove __name helper calls added by TypeScript
+                    let cleanFn = fn.replace(/__name\\([^)]+\\);?/g, '').trim();
+                    
+                    // Convert arrow functions to regular functions
+                    // Handles: (a, b) => expr  or  (a, b) => { ... }
+                    const arrowMatch = cleanFn.match(/^\\(([^)]*)\\)\\s*=>\\s*(.+)$/s);
+                    if (arrowMatch) {
+                        const params = arrowMatch[1];
+                        const body = arrowMatch[2].trim();
+                        
+                        // Check if body is wrapped in braces or is an expression
+                        if (body.startsWith('{') && body.endsWith('}')) {
+                            cleanFn = \`function(\${params}) \${body}\`;
+                        } else {
+                            cleanFn = \`function(\${params}) { return \${body} }\`;
+                        }
+                    }
+                    // Handle single parameter arrow functions: x => expr
+                    const singleArrowMatch = cleanFn.match(/^([a-zA-Z_$][a-zA-Z0-9_$]*)\\s*=>\\s*(.+)$/s);
+                    if (singleArrowMatch) {
+                        const param = singleArrowMatch[1];
+                        const body = singleArrowMatch[2].trim();
+                        
+                        if (body.startsWith('{') && body.endsWith('}')) {
+                            cleanFn = \`function(\${param}) \${body}\`;
+                        } else {
+                            cleanFn = \`function(\${param}) { return \${body} }\`;
+                        }
+                    }
+                    
+                    const func = eval('(' + cleanFn + ')');
+                    const result = func(...args);
+                    parentPort.postMessage({ success: true, result });
+                } catch (error) {
+                    parentPort.postMessage({ success: false, error: error.message });
+                }
+            });
+        `;
+export function createWorker() {
+    const worker = new Worker(workerCode, { eval: true });
+    return worker;
+}
+//# sourceMappingURL=workerFactory.js.map

package/dist/utils/workerFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workerFactory.js","sourceRoot":"","sources":["../../src/utils/workerFactory.ts"],"names":[],"mappings":"AAAA;;;;;EAKE;AAEF,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SAyCV,CAAC;AAEV,MAAM,UAAU,YAAY;IACxB,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "stardust-parallel-js",
+  "version": "1.0.0",
+  "description": "Simple parallel execution library for Node.js using Worker Threads. Execute CPU-intensive tasks with thread pools and isolated workers. Supports both regular and arrow functions.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/b1411/parallel.js.git"
+  },
+  "type": "module",
+  "scripts": {
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "build": "tsc -p ."
+  },
+  "keywords": [
+    "parallel",
+    "worker",
+    "threads",
+    "worker-threads",
+    "pool",
+    "threadpool",
+    "async",
+    "concurrent",
+    "cpu",
+    "performance",
+    "multithread",
+    "typescript"
+  ],
+  "author": "b1411",
+  "license": "MIT",
+  "packageManager": "pnpm@10.23.0",
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.0.8",
+    "eslint": "^9.39.2",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.6",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.53.0"
+  },
+  "dependencies": {
+    "@datastructures-js/queue": "^4.3.0"
+  }
+}