spooder 3.2.0 → 3.2.1

package/README.md

@@ -613,6 +613,14 @@ server.dir('/content', './public/content', { index: 'index.html' });
 
 The above will serve `./public/content/index.html` when `/content` is requested.
 
+#### `server.stop(method: ServerStop)`
+
+The `stop` function allows you to stop the server. `method` is one of `ServerStop.IMMEDIATE` or `ServerStop.GRACEFUL`.
+
+`ServerStop.GRACEFUL` will stop accepting new requests and wait for all in-flight requests to complete before stopping the server. This is the default behavior.
+
+`ServerStop.IMMEDIATE` will immediately stop the server, terminating all in-flight requests.
+
 ---
 
 #### `route_location(redirect_url: string)`

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "spooder",
 	"type": "module",
-	"version": "3.2.0",
+	"version": "3.2.1",
 	"exports": {
 		".": {
 			"bun": "./src/api.ts",

package/src/api.d.ts

@@ -13,6 +13,13 @@ type DirOptions = {
 };
 /** Built-in route handler for redirecting to a different URL. */
 export declare function route_location(redirect_url: string): (req: Request, url: URL) => Response;
+export declare const ServerStop: {
+    /** Stops the server immediately, terminating in-flight requests. */
+    IMMEDIATE: number;
+    /** Stops the server after all in-flight requests have completed. */
+    GRACEFUL: number;
+};
+type ServerStop = typeof ServerStop[keyof typeof ServerStop];
 export declare function serve(port: number): {
     /** Register a handler for a specific route. */
     route: (path: string, handler: RequestHandler) => void;
@@ -24,5 +31,7 @@ export declare function serve(port: number): {
     handle: (status_code: number, handler: StatusCodeHandler) => void;
     /** Register a handler for uncaught errors. */
     error: (handler: ErrorHandler) => void;
+    /** Stops the server. */
+    stop: (method?: ServerStop) => void;
 };
 export {};

package/src/api.ts

@@ -98,6 +98,16 @@ function route_directory(route_path: string, dir: string, options: DirOptions):
 	};
 }
 
+export const ServerStop = {
+	/** Stops the server immediately, terminating in-flight requests. */
+	IMMEDIATE: 0,
+
+	/** Stops the server after all in-flight requests have completed. */
+	GRACEFUL: 1
+};
+
+type ServerStop = typeof ServerStop[keyof typeof ServerStop];
+
 export function serve(port: number) {
 	const routes = new Map<string[], RequestHandler>();
 	const handlers = new Map<number, StatusCodeHandler>();
@@ -238,6 +248,11 @@ export function serve(port: number) {
 		/** Register a handler for uncaught errors. */
 		error: (handler: ErrorHandler): void => {
 			error_handler = handler;
+		},
+
+		/** Stops the server. */
+		stop: (method: ServerStop = ServerStop.GRACEFUL): void => {
+			server.stop(method === ServerStop.IMMEDIATE);
 		}
 	}
 }