@askrjs/node 0.0.11 → 0.2.0

package/README.md

@@ -58,6 +58,12 @@ const server = await listen(app, {
 server.close();
 ```
 
+`listen()` and `serve()` apply timeout options during `http.Server` construction and configure
+Node's incomplete-connection check interval no slower than the smallest finite request/header
+timeout (capped at one second). This makes the authored values enforceable for stalled headers and
+bodies instead of relying on Node's much slower default checking interval. Use explicit finite
+`requestTimeout` and `headersTimeout` values in production; `0` retains Node's disable semantics.
+
 Pass an `AbortSignal` to integrate shutdown with your process lifecycle.
 
 Enable the built-in `ws` transport with `websocket: true`. It defaults to a

package/dist/index.d.ts

@@ -44,9 +44,9 @@ interface ListenOptions extends NodeHandlerOptions {
   backlog?: number;
   /** Aborting this signal stops the server. */
   signal?: AbortSignal;
-  /** Node HTTP server `requestTimeout`, in milliseconds. */
+  /** Node HTTP server `requestTimeout`, enforced from server construction, in milliseconds. */
   requestTimeout?: number;
-  /** Node HTTP server `headersTimeout`, in milliseconds. */
+  /** Node HTTP server `headersTimeout`, enforced from server construction, in milliseconds. */
   headersTimeout?: number;
   /** Node HTTP server `keepAliveTimeout`, in milliseconds. */
   keepAliveTimeout?: number;

package/dist/index.js

@@ -327,6 +327,18 @@ function timeout(value, name) {
 	if (!Number.isSafeInteger(value) || value < 0) throw new TypeError(`${name} must be a non-negative safe integer.`);
 	return value;
 }
+function resolveServerOptions(options) {
+	const requestTimeout = timeout(options.requestTimeout, "requestTimeout");
+	const headersTimeout = timeout(options.headersTimeout, "headersTimeout");
+	const keepAliveTimeout = timeout(options.keepAliveTimeout, "keepAliveTimeout");
+	const enforced = [requestTimeout, headersTimeout].filter((value) => value !== void 0 && value > 0);
+	return {
+		requestTimeout: requestTimeout !== void 0 && headersTimeout !== void 0 && headersTimeout > requestTimeout ? headersTimeout : requestTimeout,
+		headersTimeout,
+		keepAliveTimeout,
+		connectionsCheckingInterval: enforced.length ? Math.min(1e3, ...enforced) : void 0
+	};
+}
 function applyServerTimeouts(server, options) {
 	const requestTimeout = timeout(options.requestTimeout, "requestTimeout");
 	const headersTimeout = timeout(options.headersTimeout, "headersTimeout");
@@ -545,7 +557,7 @@ function listen(app, options = {}) {
 	options.signal?.throwIfAborted();
 	const host = resolveBindHost(options);
 	const handlerOptions = handlerOptionsForHost(options, host);
-	const server = createServer(createNodeHandler(app, handlerOptions));
+	const server = createServer(resolveServerOptions(options), createNodeHandler(app, handlerOptions));
 	applyServerTimeouts(server, options);
 	const webSockets = options.websocket ? installWebSockets(server, app, options.websocket === true ? {} : options.websocket, handlerOptions) : void 0;
 	if (webSockets) {
@@ -658,7 +670,7 @@ async function serve(app, options = {}) {
 		}
 		return result;
 	} }, handlerOptions);
-	const server = createServer(async (request, response) => {
+	const server = createServer(resolveServerOptions(options), async (request, response) => {
 		if (!root) {
 			applicationHandler(request, response);
 			return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@askrjs/node",
-  "version": "0.0.11",
+  "version": "0.2.0",
   "description": "Node http adapter for @askrjs/server",
   "keywords": [
     "askr",
@@ -57,13 +57,13 @@
     "prepublishOnly": "npm run check"
   },
   "dependencies": {
-    "@askrjs/auth": ">=0.0.8 <0.1.0",
-    "@askrjs/server": ">=0.0.11 <0.1.0",
+    "@askrjs/auth": ">=0.2.0 <0.3.0",
+    "@askrjs/server": ">=0.2.0 <0.3.0",
     "@types/ws": "^8.18.1",
     "ws": "^8.21.3"
   },
   "devDependencies": {
-    "@askrjs/schema": ">=0.0.5 <0.1.0",
+    "@askrjs/schema": ">=0.2.0 <0.3.0",
     "@types/node": "^26.2.0",
     "publint": "^0.3.23",
     "typescript": "^7.0.2",