spooder 6.2.0 → 6.2.2

package/README.md

@@ -2520,6 +2520,34 @@ await parse_template(..., {
 </t-for>
 ```
 
+#### Object Serialization
+
+When a replacement value is an object or array, it is automatically serialized to JSON. This allows server-side data to be embedded directly into client-side scripts.
+
+```ts
+const config = {
+	debug: true,
+	api_url: '/api/v1',
+	features: ['auth', 'logging']
+};
+
+await parse_template('<script>const CONFIG = {{config}};</script>', { config });
+// Result: "<script>const CONFIG = {"debug":true,"api_url":"/api/v1","features":["auth","logging"]};</script>"
+```
+
+This also works with nested objects accessed via dot notation:
+
+```ts
+const data = {
+	app: {
+		settings: { theme: 'dark', lang: 'en' }
+	}
+};
+
+await parse_template('<script>const SETTINGS = {{app.settings}};</script>', data);
+// Result: "<script>const SETTINGS = {"theme":"dark","lang":"en"};</script>"
+```
+
 <a id="api-cache-busting"></a>
 ## API > Cache Busting
 

package/package.json

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

package/src/api.ts

@@ -1040,8 +1040,12 @@ export async function parse_template(template: string, replacements: Replacement
 					replacement = await replacement();
 			}
 			
-			if (replacement !== undefined)
+			if (replacement !== undefined) {
+				if (typeof replacement === 'object' && replacement !== null)
+					return JSON.stringify(replacement);
+
 				return replacement;
+			}
 			
 			if (!drop_missing)
 				return match;
@@ -1332,6 +1336,8 @@ export const HTTP_STATUS_CODE = {
 type HTTP_METHOD = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS' | 'CONNECT' | 'TRACE';
 type HTTP_METHODS = HTTP_METHOD|HTTP_METHOD[];
 
+type BodylessMethod = 'GET' | 'HEAD';
+
 export function http_apply_range(file: BunFile, request: Request): BunFile {
 	const range_header = request.headers.get('range');
 	if (range_header !== null) {
@@ -1384,7 +1390,7 @@ type ErrorHandler = (err: Error, req: Request, url: URL) => Resolvable<Response>
 type DefaultHandler = (req: Request, status_code: number) => HandlerReturnType;
 type StatusCodeHandler = (req: Request) => HandlerReturnType;
 
-type JSONRequestHandler = (req: Request, url: URL, json: JsonObject | null) => HandlerReturnType;
+type JSONRequestHandler<T extends JsonObject | null = JsonObject> = (req: Request, url: URL, json: T) => HandlerReturnType;
 
 export type ServerSentEventClient = {
 	message: (message: string) => void;
@@ -1823,10 +1829,20 @@ export function http_serve(port: number, hostname?: string) {
 	log_spooder(`server started on port {${server.port}} (host: {${hostname ?? 'unspecified'}})`);
 	
 	type ThrottleHandler = {
-		(delta: number, handler: JSONRequestHandler): JSONRequestHandler;
+		(delta: number, handler: JSONRequestHandler<JsonObject>): JSONRequestHandler<JsonObject>;
+		(delta: number, handler: JSONRequestHandler<null>): JSONRequestHandler<null>;
 		(delta: number, handler: RequestHandler): RequestHandler;
 	};
 
+	type JsonEndpointHandler = {
+		<M extends BodylessMethod>(path: string, handler: JSONRequestHandler<null>, method: M): void;
+		<M extends BodylessMethod[]>(path: string, handler: JSONRequestHandler<null>, method: M): void;
+		<M extends Exclude<HTTP_METHOD, BodylessMethod>>(path: string, handler: JSONRequestHandler<JsonObject>, method: M): void;
+		<M extends Exclude<HTTP_METHOD, BodylessMethod>[]>(path: string, handler: JSONRequestHandler<JsonObject>, method: M): void;
+		<M extends HTTP_METHOD[]>(path: string, handler: JSONRequestHandler<JsonObject | null>, method: M): void;
+		(path: string, handler: JSONRequestHandler<JsonObject>): void;
+	};
+
 	return {
 		/** Register a handler for a specific route. */
 		route: (path: string, handler: RequestHandler, method: HTTP_METHODS = 'GET'): void => {
@@ -1853,7 +1869,7 @@ export function http_serve(port: number, hostname?: string) {
 		}) as ThrottleHandler,
 		
 		/** Register a JSON endpoint with automatic content validation. */
-		json: (path: string, handler: JSONRequestHandler, method: HTTP_METHODS = 'POST'): void => {
+		json: ((path: string, handler: JSONRequestHandler<JsonObject | null>, method: HTTP_METHODS = 'POST'): void => {
 			const json_wrapper: RequestHandler = async (req: Request, url: URL) => {
 				// handle CORS preflight
 				if (req.method === 'OPTIONS') {
@@ -1890,7 +1906,7 @@ export function http_serve(port: number, hostname?: string) {
 
 			const methods: HTTP_METHODS = Array.isArray(method) ? [...method, 'OPTIONS'] : [method, 'OPTIONS'];
 			routes.push([path.split('/'), json_wrapper, methods]);
-		},
+		}) as JsonEndpointHandler,
 		
 		/** Unregister a specific route */
 		unroute: (path: string): void => {