spooder 6.1.92 → 6.1.94

package/README.md

@@ -599,6 +599,7 @@ log_list(input: any[], delimiter = ', ');
 
 // http
 http_serve(port: number, hostname?: string): Server;
+server.port: number;
 server.stop(immediate: boolean): Promise<void>;
 
 // cookies
@@ -840,13 +841,14 @@ IPC_TARGET.BROADCAST; // broadcast to all other instances
 ## API > HTTP
 
 ### `http_serve(port: number, hostname?: string): Server`
-Bootstrap a server on the specified port (and optional hostname).
+Bootstrap a server on the specified port (and optional hostname). Pass `0` for the port to assign a random available port, which can then be retrieved via `server.port`.
 
 ```ts
 import { serve } from 'spooder';
 
 const server = http_serve(8080); // port only
 const server = http_serve(3000, '0.0.0.0'); // optional hostname
+const server = http_serve(0); // random port, retrieve via server.port
 ```
 
 By default, the server responds with:
@@ -879,6 +881,15 @@ await server.stop(false);
 // do something now all connections are done
 ```
 
+### 📖 `server.port`
+
+Returns the port the server is listening on. Useful when `0` is passed to `http_serve()` for a random port assignment.
+
+```ts
+const server = http_serve(0);
+console.log(`Server listening on port ${server.port}`);
+```
+
 ### Routing
 
 ### 🔧 `server.route(path: string, handler: RequestHandler)`
@@ -1734,7 +1745,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();
 	},
 	

package/bun.lock

@@ -12,7 +12,7 @@
   "packages": {
     "@types/bun": ["@types/bun@1.3.5", "", { "dependencies": { "bun-types": "1.3.5" } }, "sha512-RnygCqNrd3srIPEWBd5LFeUYG7plCoH2Yw9WaZGyNmdTEei+gWaHqydbaIRkIkcbXwhBT94q78QljxN0Sk838w=="],
 
-    "@types/node": ["@types/node@25.0.3", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-W609buLVRVmeW693xKfzHeIV6nJGGz98uCPfeXI1ELMLXVeKYZ9m15fAMSaUPBHYLGFsVRcMmSCksQOrZV9BYA=="],
+    "@types/node": ["@types/node@25.0.6", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-NNu0sjyNxpoiW3YuVFfNz7mxSQ+S4X2G28uqg2s+CzoqoQjLPsWSbsFFyztIAqt2vb8kfEAsJNepMGPTxFDx3Q=="],
 
     "bun-types": ["bun-types@1.3.5", "", { "dependencies": { "@types/node": "*" } }, "sha512-inmAYe2PFLs0SUbFOWSVD24sg1jFlMPxOjOSSCYqUgn4Hsc3rDc7dFvfVYjFPNHtov6kgUeulV4SxbuIV/stPw=="],
 

package/package.json

@@ -2,7 +2,7 @@
 	"name": "spooder",
 	"author": "Kruithne <kruithne@gmail.com>",
 	"type": "module",
-	"version": "6.1.92",
+	"version": "6.1.94",
 	"module": "./src/api.ts",
 	"repository": {
 		"url": "https://github.com/Kruithne/spooder"

package/src/api.ts

@@ -821,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/);
@@ -970,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) => {
@@ -1119,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;
@@ -1141,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> = {};
@@ -1819,7 +1817,7 @@ export function http_serve(port: number, hostname?: string) {
 		}
 	});
 	
-	log_spooder(`server started on port {${port}} (host: {${hostname ?? 'unspecified'}})`);
+	log_spooder(`server started on port {${server.port}} (host: {${hostname ?? 'unspecified'}})`);
 	
 	type ThrottleHandler = {
 		(delta: number, handler: JSONRequestHandler): JSONRequestHandler;
@@ -2181,6 +2179,11 @@ export function http_serve(port: number, hostname?: string) {
 					return http_apply_range(file, request);
 				});
 			}
+		},
+
+		/** The port the server is listening on. Useful when port 0 is passed to assign a random port. */
+		get port(): number {
+			return server.port!;
 		}
 	};
 }