spooder 5.1.2 → 5.1.4

package/README.md

@@ -474,8 +474,8 @@ In addition to the information provided by the developer, `spooder` also include
 
 ```ts
 // logging
-log(message: string);
-log_error(message: string);
+log(message: string, ...params: any[]);
+log_error(message: string, ...params: any[]);
 log_create_logger(prefix: string, color: ColorInput);
 log_list(input: any[], delimiter = ', ');
 
@@ -595,7 +595,7 @@ HTTP_STATUS_CODE: { OK_200: 200, NotFound_404: 404, ... };
 <a id="api-logging"></a>
 ## API > Logging
 
-### 🔧 `log(message: string)`
+### 🔧 `log(message: string, ...params: any[])`
 Print a message to the console using the default logger. Wrapping text segments in curly braces will highlight those segments with colour.
 
 ```ts
@@ -603,7 +603,24 @@ log('Hello, {world}!');
 // > [info] Hello, world!
 ```
 
-### 🔧 `log_error(message: string)`
+Formatting parameters are supported using standard console logging formatters.
+
+```ts
+log('My object: %o', { foo: 'bar' });
+// > [info] My object: { foo: 'bar' }
+```
+
+| Specifier | Description |
+|-----------|-------------|
+| `%s` | String |
+| `%d` | Integer |
+| `%i` | Integer (same as %d) |
+| `%f` | Floating point |
+| `%o` | Object (pretty-printed) |
+| `%O` | Object (expanded/detailed) |
+| `%j` | JSON string |
+
+### 🔧 `log_error(message: string, ...params: any[])`
 Print an error message to the console. Wrapping text segments in curly braces will highlight those segments. This works the same as `log()` except it's red, so you know it's bad.
 
 ```ts
@@ -1300,6 +1317,7 @@ const server = http_serve(80);
 
 server.bootstrap({
 	base: Bun.file('./html/base_template.html'),
+	drop_missing_subs: false,
 
 	cache: {
 		ttl: 5 * 60 * 60 * 1000, // 5 minutes
@@ -1384,6 +1402,13 @@ server.bootstrap({
 });
 ```
 
+##### `drop_missing_subs: boolean`
+
+**Optional**. Defaults to true. If explicitly disabled, templating parsing will not drop unknown substitutions.
+
+> ![NOTE]
+> If you are using a client-side framework that uses the double-brace syntax ``{{foo}}`` such as Vue, you should set this to `false` to ensure compatibility.
+
 ##### `routes: Record<string, BootstrapRoute>`
 **Required.** Defines the routes and their content. Each route can have:
 - `content`: The page content (string or BunFile)

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "spooder",
 	"type": "module",
-	"version": "5.1.2",
+	"version": "5.1.4",
 	"module": "./src/api.ts",
 	"bin": {
 		"spooder": "./src/cli.ts"

package/src/api.ts

@@ -106,8 +106,8 @@ export function log_create_logger(label: string, color: ColorInput = 'blue') {
 	const ansi = Bun.color(color, 'ansi-256') ?? '\x1b[38;5;6m';
 	const prefix = `[${ansi}${label}\x1b[0m] `;
 	
-	return (message: string) => {
-		process.stdout.write(prefix + message.replace(/\{([^}]+)\}/g, `${ansi}$1\x1b[0m`) + '\n');
+	return (message: string, ...params: any[]) => {
+		console.log(prefix + message.replace(/\{([^}]+)\}/g, `${ansi}$1\x1b[0m`), ...params);
 	};
 }
 
@@ -366,7 +366,7 @@ async function handle_error(prefix: string, err_message_or_obj: string | object,
 	if (process.env.SPOODER_ENV === 'dev') {
 		log_spooder(`[{dev}] dispatch_report ${prefix + error_message}`);
 		log_spooder('[{dev}] without {--dev}, this would raise a canary report');
-		log_spooder(`[{dev}] ${final_err}`);
+		log_spooder('[{dev}] %O', final_err);
 	} else {
 		await dispatch_report(prefix + error_message, final_err);
 	}
@@ -1077,6 +1077,8 @@ type BootstrapCacheBust = {
 
 type BootstrapOptions = {
 	base?: string | BunFile;
+	drop_missing_subs?: boolean;
+
 	routes: Record<string, BootstrapRoute>;
 	cache?: ReturnType<typeof cache_http> | CacheOptions;
 
@@ -1522,6 +1524,7 @@ export function http_serve(port: number, hostname?: string) {
 			if (cache !== undefined && !is_cache_http(cache))
 				cache = cache_http(cache);
 
+			const drop_missing = options.drop_missing_subs ?? true;
 			for (const [route, route_opts] of Object.entries(options.routes)) {
 				const content_generator = async () => {
 					let content = await resolve_bootstrap_content(route_opts.content);
@@ -1530,7 +1533,7 @@ export function http_serve(port: number, hostname?: string) {
 						content = await parse_template(await resolve_bootstrap_content(options.base), { content }, false);
 					
 					const sub_table = sub_table_merge({}, global_sub_table, route_opts.subs);
-					content = await parse_template(content, sub_table, true);
+					content = await parse_template(content, sub_table, drop_missing);
 					
 					return content;
 				};