spooder 6.1.93 → 6.1.95

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)`

package/package.json

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

package/src/api.ts

@@ -978,13 +978,16 @@ export async function parse_template(template: string, replacements: Replacement
 		const if_regex = /<t-if\s+test="([^"]+)"\s*>(.*?)<\/t-if>/gs;
 		result = await replace_async(result, if_regex, async (match, condition_key, if_content) => {
 			const condition_value = is_replacer_fn ? await replacements(condition_key) : replacements[condition_key];
-			
-			if (!drop_missing && !condition_value)
+			const key_exists = is_replacer_fn || (condition_key in replacements);
+
+			// preserve block for later pass if key doesn't exist and drop_missing is false
+			if (!key_exists && !drop_missing)
 				return match;
-			
+
+			// render content if condition is truthy, otherwise remove block
 			if (condition_value)
 				return await parse_template(if_content, replacements, drop_missing);
-			
+
 			return '';
 		});
 		
@@ -1817,7 +1820,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;
@@ -2179,6 +2182,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!;
 		}
 	};
 }