spooder 6.1.95 → 6.2.1

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.6", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-NNu0sjyNxpoiW3YuVFfNz7mxSQ+S4X2G28uqg2s+CzoqoQjLPsWSbsFFyztIAqt2vb8kfEAsJNepMGPTxFDx3Q=="],
+    "@types/node": ["@types/node@25.0.7", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-C/er7DlIZgRJO7WtTdYovjIFzGsz0I95UlMyR9anTb4aCpBSRWe5Jc1/RvLKUfzmOxHPGjSE5+63HgLtndxU4w=="],
 
     "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.95",
+	"version": "6.2.1",
 	"module": "./src/api.ts",
 	"repository": {
 		"url": "https://github.com/Kruithne/spooder"

package/src/api.ts

@@ -1332,6 +1332,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 +1386,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) => HandlerReturnType;
+type JSONRequestHandler<T extends JsonObject | null = JsonObject> = (req: Request, url: URL, json: T) => HandlerReturnType;
 
 export type ServerSentEventClient = {
 	message: (message: string) => void;
@@ -1823,10 +1825,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 +1865,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') {
@@ -1868,6 +1880,10 @@ export function http_serve(port: number, hostname?: string) {
 				}
 
 				try {
+					// GET/HEAD requests don't have bodies, skip validation
+					if (req.method === 'GET' || req.method === 'HEAD')
+						return handler(req, url, null);
+
 					if (req.headers.get('Content-Type') !== 'application/json')
 						return 400; // Bad Request
 
@@ -1886,7 +1902,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 => {