spooder 6.1.7 → 6.1.93

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 = {
@@ -1732,7 +1734,7 @@ global_subs: {
 	build_time: async () => {
 		// Example: fetch build timestamp from git
 		const process = Bun.spawn(['git', 'log', '-1', '--format=%ct']);
-		const output = await Bun.readableStreamToText(process.stdout);
+		const output = await new Response(process.stdout).text();
 		return new Date(parseInt(output.trim()) * 1000).toISOString();
 	},
 	
@@ -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.6", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-NNu0sjyNxpoiW3YuVFfNz7mxSQ+S4X2G28uqg2s+CzoqoQjLPsWSbsFFyztIAqt2vb8kfEAsJNepMGPTxFDx3Q=="],
 
-    "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.93",
 	"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)
@@ -808,7 +821,7 @@ export class ErrorWithMetadata extends Error {
 			else if (typeof value === 'function')
 				resolved_value = await value();
 			else if (value instanceof ReadableStream)
-				resolved_value = await Bun.readableStreamToText(value);
+				resolved_value = await new Response(value).text();
 			
 			if (typeof resolved_value === 'string' && resolved_value.includes('\n'))
 				resolved_value = resolved_value.split(/\r?\n/);
@@ -957,12 +970,10 @@ export async function parse_template(template: string, replacements: Replacement
 				}
 			}
 
-			if (!drop_missing)
-				return match;
-
+			// missing/undefined items treated as empty array (no output)
 			return '';
 		});
-		
+
 		// Parse t-if tags
 		const if_regex = /<t-if\s+test="([^"]+)"\s*>(.*?)<\/t-if>/gs;
 		result = await replace_async(result, if_regex, async (match, condition_key, if_content) => {
@@ -1106,9 +1117,9 @@ export async function git_get_hashes(length = 7): Promise<Record<string, string>
 	await process.exited;
 	
 	if (process.exitCode as number > 0)
-		throw new Error('git_get_hashes() failed, `' + cmd.join(' ') + '` exited with non-zero exit code.');
+		return {};
 	
-	const stdout = await Bun.readableStreamToText(process.stdout as ReadableStream);
+	const stdout = await new Response(process.stdout).text();
 	const hash_map: Record<string, string> = {};
 	
 	const regex = /([^\s]+)\s([^\s]+)\s([^\s]+)\t(.+)/g;
@@ -1128,7 +1139,7 @@ export function git_get_hashes_sync(length = 7): Record<string, string> {
 	});
 	
 	if (process.exitCode > 0)
-		throw new Error('git_get_hashes_sync() failed, `' + cmd.join(' ') + '` exited with non-zero exit code.');
+		return {};
 	
 	const stdout = process.stdout.toString();
 	const hash_map: Record<string, string> = {};