spooder 6.1.7 → 6.1.92

package/README.md

@@ -655,6 +655,8 @@ type WorkerPoolOptions = {
 	worker: string | string[];
 	size?: number;
 	auto_restart?: boolean | AutoRestartConfig;
+	onWorkerStart?: (pool: WorkerPool, worker_id: string) => void;
+	onWorkerStop?: (pool: WorkerPool, worker_id: string, exit_code: number) => void;
 };
 
 type AutoRestartConfig = {
@@ -2106,6 +2108,32 @@ pool.on('MSG_REQUEST', msg => {
 });
 ```
 
+### Lifecycle Callbacks
+
+Worker pools support lifecycle callbacks to monitor when workers start and stop. Callbacks receive the pool instance, allowing you to communicate with workers immediately.
+
+```ts
+const pool = await worker_pool({
+	worker: './worker.ts',
+	auto_restart: true,
+	onWorkerStart: async (pool, worker_id) => {
+		console.log(`Worker ${worker_id} started`);
+		await pool.send(worker_id, 'init', { config: 'value' }, true);
+	},
+	onWorkerStop: (pool, worker_id, exit_code) => {
+		console.log(`Worker ${worker_id} stopped with exit code ${exit_code}`);
+		if (exit_code !== 0 && exit_code !== 42) {
+			console.log(`Worker ${worker_id} crashed`);
+		}
+	}
+});
+```
+
+#### Callback Signatures
+
+- `onWorkerStart: (pool: WorkerPool, worker_id: string) => void` - Fires when a worker registers with the pool
+- `onWorkerStop: (pool: WorkerPool, worker_id: string, exit_code: number) => void` - Fires when a worker stops
+
 ### Auto-Restart
 
 The `worker_pool` function supports automatic worker restart when workers crash or close unexpectedly. This feature includes an exponential backoff protocol to prevent restart loops.

package/bun.lock

@@ -10,11 +10,11 @@
     },
   },
   "packages": {
-    "@types/bun": ["@types/bun@1.3.3", "", { "dependencies": { "bun-types": "1.3.3" } }, "sha512-ogrKbJ2X5N0kWLLFKeytG0eHDleBYtngtlbu9cyBKFtNL3cnpDZkNdQj8flVf6WTZUX5ulI9AY1oa7ljhSrp+g=="],
+    "@types/bun": ["@types/bun@1.3.5", "", { "dependencies": { "bun-types": "1.3.5" } }, "sha512-RnygCqNrd3srIPEWBd5LFeUYG7plCoH2Yw9WaZGyNmdTEei+gWaHqydbaIRkIkcbXwhBT94q78QljxN0Sk838w=="],
 
-    "@types/node": ["@types/node@24.10.1", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-GNWcUTRBgIRJD5zj+Tq0fKOJ5XZajIiBroOF0yvj2bSU1WvNdYS/dn9UxwsujGW4JX06dnHyjV2y9rRaybH0iQ=="],
+    "@types/node": ["@types/node@25.0.3", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-W609buLVRVmeW693xKfzHeIV6nJGGz98uCPfeXI1ELMLXVeKYZ9m15fAMSaUPBHYLGFsVRcMmSCksQOrZV9BYA=="],
 
-    "bun-types": ["bun-types@1.3.3", "", { "dependencies": { "@types/node": "*" } }, "sha512-z3Xwlg7j2l9JY27x5Qn3Wlyos8YAp0kKRlrePAOjgjMGS5IG6E7Jnlx736vH9UVI4wUICwwhC9anYL++XeOgTQ=="],
+    "bun-types": ["bun-types@1.3.5", "", { "dependencies": { "@types/node": "*" } }, "sha512-inmAYe2PFLs0SUbFOWSVD24sg1jFlMPxOjOSSCYqUgn4Hsc3rDc7dFvfVYjFPNHtov6kgUeulV4SxbuIV/stPw=="],
 
     "undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
   }

package/package.json

@@ -2,8 +2,11 @@
 	"name": "spooder",
 	"author": "Kruithne <kruithne@gmail.com>",
 	"type": "module",
-	"version": "6.1.7",
+	"version": "6.1.92",
 	"module": "./src/api.ts",
+	"repository": {
+		"url": "https://github.com/Kruithne/spooder"
+	},
 	"bin": {
 		"spooder": "./src/cli.ts"
 	},

package/src/api.ts

@@ -33,6 +33,9 @@ type WorkerMessage = {
 
 const RESPONSE_TIMEOUT_MS = 5000;
 
+type WorkerStartCallback = (pool: WorkerPool, worker_id: string) => void;
+type WorkerStopCallback = (pool: WorkerPool, worker_id: string, exit_code: number) => void;
+
 export interface WorkerPool {
 	id: string;
 	send(peer: string, id: string, data?: WorkerMessageData, expect_response?: false): void;
@@ -59,6 +62,8 @@ type WorkerPoolOptions = {
 	size?: number;
 	auto_restart?: boolean | AutoRestartConfig;
 	response_timeout?: number;
+	onWorkerStart?: WorkerStartCallback;
+	onWorkerStop?: WorkerStopCallback;
 };
 
 type WorkerState = {
@@ -94,6 +99,9 @@ export async function worker_pool(options: WorkerPoolOptions): Promise<WorkerPoo
 	const callbacks = new Map<string, (data: WorkerMessage) => Promise<void> | void>();
 	const pending_responses = new Map<string, { resolve: (message: WorkerMessage) => void, reject: (error: Error) => void, timeout: Timer | undefined }>();
 
+	const on_worker_start = options.onWorkerStart;
+	const on_worker_stop = options.onWorkerStop;
+
 	async function restart_worker(worker: Worker) {
 		if (!auto_restart_enabled)
 			return;
@@ -150,6 +158,9 @@ export async function worker_pool(options: WorkerPoolOptions): Promise<WorkerPoo
 			if (worker_id)
 				pipe_workers.deleteByKey(worker_id);
 
+			if (worker_id)
+				on_worker_stop?.(pool, worker_id, exit_code);
+
 			if (auto_restart_enabled && exit_code !== WORKER_EXIT_NO_RESTART)
 				restart_worker(worker);
 			else if (exit_code === WORKER_EXIT_NO_RESTART)
@@ -180,6 +191,8 @@ export async function worker_pool(options: WorkerPoolOptions): Promise<WorkerPoo
 
 			worker_promises.get(worker)?.();
 			worker_promises.delete(worker);
+
+			on_worker_start?.(pool, worker_id);
 		} else if (message.peer === '__broadcast__') {
 			const worker_id = pipe_workers.getByValue(worker);
 			if (worker_id === undefined)