@mionjs/platform-uws 0.13.2 → 0.14.0

package/.dist/esm/src/constants.js

@@ -2,6 +2,8 @@ import { DEFAULT_MAX_BODY_SIZE } from "@mionjs/core";
 //#region src/constants.ts
 var DEFAULT_UWS_HTTP_OPTIONS = {
 	port: 80,
+	/** uWS' own default is 4 KB, which a 4 KB `?data=` query URL alone fills: same 8 KB as the node adapter */
+	maxHeaderSize: 8192,
 	/** What a route takes when its own `maxBodySize` and its types say nothing: the shared 128 KB default */
 	maxBodySize: DEFAULT_MAX_BODY_SIZE
 };

package/.dist/esm/src/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","names":[],"sources":["../../../src/constants.ts"],"sourcesContent":["/* ########\n * 2022 mion\n * Author: Ma-jerez\n * License: MIT\n * The software is provided \"as is\", without warranty of any kind.\n * ######## */\n\nimport {DEFAULT_MAX_BODY_SIZE} from '@mionjs/core';\nimport {UwsHttpOptions} from './types.ts';\n\nexport const DEFAULT_UWS_HTTP_OPTIONS: UwsHttpOptions = {\n  port: 80,\n  /** What a route takes when its own `maxBodySize` and its types say nothing: the shared 128 KB default */\n  maxBodySize: DEFAULT_MAX_BODY_SIZE,\n};\n"],"mappings":";;AAUA,IAAa,2BAA2C;CACtD,MAAM;;CAEN,aAAa;AACf"}
+{"version":3,"file":"constants.js","names":[],"sources":["../../../src/constants.ts"],"sourcesContent":["/* ########\n * 2022 mion\n * Author: Ma-jerez\n * License: MIT\n * The software is provided \"as is\", without warranty of any kind.\n * ######## */\n\nimport {DEFAULT_MAX_BODY_SIZE} from '@mionjs/core';\nimport {UwsHttpOptions} from './types.ts';\n\nexport const DEFAULT_UWS_HTTP_OPTIONS: UwsHttpOptions = {\n  port: 80,\n  /** uWS' own default is 4 KB, which a 4 KB `?data=` query URL alone fills: same 8 KB as the node adapter */\n  maxHeaderSize: 8192,\n  /** What a route takes when its own `maxBodySize` and its types say nothing: the shared 128 KB default */\n  maxBodySize: DEFAULT_MAX_BODY_SIZE,\n};\n"],"mappings":";;AAUA,IAAa,2BAA2C;CACtD,MAAM;;CAEN,eAAe;;CAEf,aAAa;AACf"}

package/.dist/esm/src/types.d.ts

@@ -2,6 +2,7 @@ import { AppOptions } from '@mionjs/bin-uws';
 export interface UwsHttpOptions {
     port: number;
     ssl?: AppOptions;
+    maxHeaderSize: number;
     maxBodySize: number;
     maxBodySizeCap?: number;
 }

package/.dist/esm/src/uwsHttp.js

@@ -1,6 +1,6 @@
 import { DEFAULT_UWS_HTTP_OPTIONS } from "./constants.js";
 import { headersFromUwsRequest } from "./headers.js";
-import { createContextFromChain, decodeQueryBody, dispatchMaybeSync, dispatchPlatformError, getDefaultHeaders, getRouterFatalErrorResponse, hostOwnsSocket, releaseHeaders, requestPayloadTooLarge, resetRouter, resolveExecutionChain, setPlatformConfig, toRpcError } from "@mionjs/router";
+import { createContextFromChain, dispatchMaybeSync, dispatchPlatformError, getDefaultHeaders, getRouterFatalErrorResponse, hostOwnsSocket, releaseHeaders, requestPayloadTooLarge, resetRouter, resolveExecutionChain, setPlatformConfig, toRpcError } from "@mionjs/router";
 import { STATUS_CODES } from "http";
 import { loadUws } from "@mionjs/bin-uws";
 import { FatalError, SerializerModes, getENV } from "@mionjs/core";
@@ -32,6 +32,7 @@ async function startUwsServer(options) {
 		port: httpOptions.port,
 		httpOptions
 	});
+	process.env.UWS_HTTP_MAX_HEADERS_SIZE ??= String(httpOptions.maxHeaderSize);
 	const uws = loadUws();
 	const app = httpOptions.ssl ? uws.SSLApp(httpOptions.ssl) : uws.App();
 	app.any("/*", uwsRequestHandler);
@@ -64,18 +65,35 @@ async function startUwsServer(options) {
 		});
 	});
 }
+var LOWER_CASE_METHODS = Object.assign(Object.create(null), {
+	get: "GET",
+	head: "HEAD",
+	post: "POST",
+	put: "PUT",
+	delete: "DELETE",
+	connect: "CONNECT",
+	options: "OPTIONS",
+	trace: "TRACE",
+	patch: "PATCH",
+	query: "QUERY"
+});
+function upperCaseMethod(method) {
+	return LOWER_CASE_METHODS[method] ?? "OTHER";
+}
 function drainRequestBody(res) {
 	res.onData(() => {});
 }
 function uwsRequestHandler(res, req) {
-	const state = {
-		replied: false,
-		aborted: false
-	};
 	const path = req.getUrl();
 	const query = req.getQuery();
 	const urlQuery = query === "" ? void 0 : query;
+	const method = upperCaseMethod(req.getMethod());
 	const reqHeaders = headersFromUwsRequest(req);
+	const state = {
+		replied: false,
+		aborted: false,
+		head: method === "HEAD"
+	};
 	const respHeaders = getDefaultHeaders();
 	res.onAborted(() => {
 		state.aborted = true;
@@ -94,21 +112,9 @@ function uwsRequestHandler(res, req) {
 		fatalFail(res, state, respHeaders, toRpcError(err));
 		return;
 	}
-	const dispatchBody = (rawBody, readQueryBody) => {
-		let reqRawBody = rawBody;
-		let reqBodyType = SerializerModes.stringifyJson;
-		try {
-			const queryBody = readQueryBody ? decodeQueryBody(urlQuery, reqRawBody || void 0) : void 0;
-			if (queryBody) {
-				reqRawBody = queryBody.rawBody;
-				reqBodyType = queryBody.bodyType;
-			}
-		} catch (err) {
-			state.replied = true;
-			fatalFail(res, state, respHeaders, err);
-			return;
-		}
-		const context = createContextFromChain(chain, path, urlQuery, reqHeaders, respHeaders, reqRawBody, reqBodyType);
+	const dispatchBody = (rawBody) => {
+		const reqBodyType = SerializerModes.stringifyJson;
+		const context = createContextFromChain(chain, path, urlQuery, method, reqHeaders, respHeaders, rawBody, reqBodyType);
 		let dispatched;
 		try {
 			dispatched = dispatchMaybeSync(context, rawRequest, res);
@@ -136,17 +142,17 @@ function uwsRequestHandler(res, req) {
 	};
 	if (!chain.readsBody) {
 		drainRequestBody(res);
-		dispatchBody("", false);
+		dispatchBody("");
 		return;
 	}
 	res.collectBody(chain.maxBodySize, (fullBody) => {
 		if (state.replied) return;
 		if (fullBody === null) {
-			answerWith(dispatchPlatformError(chain, path, urlQuery, requestPayloadTooLarge(), reqHeaders, respHeaders, rawRequest, res));
+			answerWith(dispatchPlatformError(chain, path, urlQuery, method, requestPayloadTooLarge(), reqHeaders, respHeaders, rawRequest, res));
 			return;
 		}
 		if (fullBody.byteLength <= UWS_MAX_SINGLE_READ) {
-			dispatchBody(fullBody.byteLength === 0 ? "" : Buffer.from(fullBody).toString(), true);
+			dispatchBody(fullBody.byteLength === 0 ? "" : Buffer.from(fullBody).toString());
 			return;
 		}
 		queueMicrotask(() => {
@@ -160,7 +166,7 @@ function uwsRequestHandler(res, req) {
 				}));
 				return;
 			}
-			dispatchBody(releaseAfterDecode(fullBody), true);
+			dispatchBody(releaseAfterDecode(fullBody));
 		});
 	});
 }
@@ -177,13 +183,6 @@ function releaseAfterDecode(fullBody) {
 function fatalFail(res, state, respHeaders, error) {
 	reply(res, state, getRouterFatalErrorResponse(error, respHeaders));
 }
-function isHeaderSafe(text) {
-	for (let i = 0; i < text.length; i++) {
-		const code = text.charCodeAt(i);
-		if (code === 13 || code === 10 || code === 0) return false;
-	}
-	return true;
-}
 /** The line is a pure function of the code, so it is built once per code rather than per response. */
 var statusLines = /* @__PURE__ */ new Map();
 function statusLine(statusCode) {
@@ -198,19 +197,19 @@ function reply(res, state, mionResp) {
 	if (state.aborted) return;
 	const headers = mionResp.headers;
 	const payload = JSON.stringify(mionResp.body);
-	const write = (name, value) => {
-		if (isHeaderSafe(value)) res.writeHeader(name, value);
-	};
+	const close = headers.get("connection")?.toLowerCase() === "close";
+	const write = (name, value) => res.writeHeader(name, value);
 	res.cork(() => {
 		res.writeStatus(statusLine(mionResp.statusCode));
 		headers.forEach((name, value) => {
-			if (name === "content-length" || name === "content-type" || !isHeaderSafe(name)) return;
+			if (name === "content-length" || name === "content-type") return;
 			if (typeof value === "string") write(name, value);
 			else if (name === "set-cookie") for (const cookie of value) write(name, cookie);
 			else write(name, value.join(", "));
 		});
 		res.writeHeader("content-type", mionResp.contentType);
-		res.end(payload);
+		if (state.head) res.endWithoutBody(Buffer.byteLength(payload, "utf8"), close);
+		else res.end(payload, close);
 	});
 	releaseHeaders(headers);
 }

package/.dist/esm/src/uwsHttp.js.map

@@ -1 +1 @@
-{"version":3,"file":"uwsHttp.js","names":[],"sources":["../../../src/uwsHttp.ts"],"sourcesContent":["/* ########\n * 2022 mion\n * Author: Ma-jerez\n * License: MIT\n * The software is provided \"as is\", without warranty of any kind.\n * ######## */\n\nimport {\n  dispatchMaybeSync,\n  dispatchPlatformError,\n  resolveExecutionChain,\n  createContextFromChain,\n  getRouterFatalErrorResponse,\n  toRpcError,\n  resetRouter,\n  decodeQueryBody,\n  setPlatformConfig,\n  getDefaultHeaders,\n  releaseHeaders,\n  requestPayloadTooLarge,\n  hostOwnsSocket,\n} from '@mionjs/router';\nimport {STATUS_CODES} from 'http';\nimport {loadUws} from '@mionjs/bin-uws';\nimport type {HttpRequest, HttpResponse, TemplatedApp, us_listen_socket} from '@mionjs/bin-uws';\nimport {DEFAULT_UWS_HTTP_OPTIONS} from './constants.ts';\nimport type {UwsHttpOptions} from './types.ts';\nimport type {MethodsExecutionChain, MionHeaders, MionResponse, RecordResponseHeaders} from '@mionjs/router';\nimport {getENV, SerializerModes} from '@mionjs/core';\nimport type {SerializerCode} from '@mionjs/core';\nimport {RpcError, FatalError} from '@mionjs/core';\nimport {headersFromUwsRequest} from './headers.ts';\n\n// ############# PRIVATE STATE #############\n\nlet httpOptions: Readonly<UwsHttpOptions> = {...DEFAULT_UWS_HTTP_OPTIONS};\n\n// The most bytes one uWS socket read can deliver: uSockets' LIBUS_RECV_BUFFER_LENGTH (512 KiB) at the tag pinned in\n// packages/bin-uws. A LARGER body cannot be single-read, which is what makes the zero-copy branch below safe (a\n// detachment tripwire guards it at runtime). Re-verify against uSockets on a tag bump.\nconst UWS_MAX_SINGLE_READ = 524288;\n\n/** The running server: the uWS app plus the socket handle listen() produced. */\nexport interface UwsServer {\n  app: TemplatedApp;\n  listenSocket: us_listen_socket;\n  close(): void;\n}\n\n// ############# PUBLIC METHODS #############\n\nexport function resetUwsHttpOpts() {\n  httpOptions = {...DEFAULT_UWS_HTTP_OPTIONS};\n  resetRouter();\n}\n\nexport function setUwsHttpOpts(options?: Partial<UwsHttpOptions>) {\n  httpOptions = {\n    ...httpOptions,\n    ...options,\n  };\n\n  return httpOptions;\n}\n\n/** The platform config the router publishes: everything but the TLS file paths. */\nfunction serializablePlatformConfig(): Record<string, unknown> {\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  const {ssl: _ssl, ...serializableConfig} = httpOptions;\n  return serializableConfig;\n}\n\nexport async function startUwsServer(options?: Partial<UwsHttpOptions>): Promise<UwsServer> {\n  const isTest = getENV('NODE_ENV') === 'test';\n\n  if (options) setUwsHttpOpts(options);\n  // uWS is its own C++ event loop and owns its listen socket, so it cannot mount on a host node server.\n  if (hostOwnsSocket()) {\n    throw new Error(\n      '@mionjs/platform-uws does not support middleware mode: uWebSockets.js owns its own listen ' +\n        'socket and cannot mount on a host node server. Use @mionjs/platform-node for middleware mode.'\n    );\n  }\n  const protocol = httpOptions.ssl ? 'https' : 'http';\n  const port = httpOptions.port !== 80 ? `:${httpOptions.port}` : '';\n  const url = `${protocol}://localhost${port}`;\n  if (!isTest)\n    console.log(`mion uws server running on ${url}`, {\n      port: httpOptions.port,\n      httpOptions,\n    });\n\n  const uws = loadUws();\n  const app = httpOptions.ssl ? uws.SSLApp(httpOptions.ssl) : uws.App();\n  app.any('/*', uwsRequestHandler);\n\n  return new Promise<UwsServer>((resolve, reject) => {\n    app.listen(httpOptions.port, (listenSocket) => {\n      if (!listenSocket) {\n        reject(new Error(`mion uws server failed to listen on port ${httpOptions.port} (port in use?)`));\n        return;\n      }\n\n      setPlatformConfig(serializablePlatformConfig());\n\n      let closed = false;\n      const close = () => {\n        if (closed) return;\n        closed = true;\n        uws.us_listen_socket_close(listenSocket);\n      };\n      const server: UwsServer = {app, listenSocket, close};\n\n      const shutdownHandler = function () {\n        if (!isTest) console.log(`Shutting down mion server on ${url}`);\n        close();\n        process.exit(0);\n      };\n      process.on('SIGINT', shutdownHandler);\n      process.on('SIGTERM', shutdownHandler);\n\n      resolve(server);\n    });\n  });\n}\n\n// ############# PRIVATE METHODS #############\n\n// uWS refreshes a socket's idle timeout only from inside a body-data callback, and runs it only when a reader is registered.\n// Without one, a request answered before its body finished arriving is closed mid-upload, so drop every chunk instead.\nfunction drainRequestBody(res: HttpResponse) {\n  res.onData(() => {});\n}\n\n// exported for tests and for mounting on a hand-built uWS app; NOT a middleware handler (see startUwsServer).\n// uWS contract: `req` is valid only synchronously here, so the async dispatch snapshots it before the first await.\nexport function uwsRequestHandler(res: HttpResponse, req: HttpRequest): void {\n  const state = {replied: false, aborted: false};\n  // Everything read from `req` happens HERE, synchronously.\n  const path = req.getUrl();\n  const query = req.getQuery();\n  const urlQuery = query === '' ? undefined : query;\n  const reqHeaders = headersFromUwsRequest(req);\n\n  const respHeaders = getDefaultHeaders();\n\n  // must be registered before any async work: after a disconnect uWS frees the response, and touching it would crash\n  res.onAborted(() => {\n    state.aborted = true;\n  });\n\n  // route resolved BEFORE the body, synchronously: the native read stops at the chain's limit, and a late context stays GC-cheap.\n  // The raw request object is built once: the one a pathTransform reads and the one the handlers see.\n  const rawRequest = {path, urlQuery, headers: reqHeaders};\n  let chain: MethodsExecutionChain;\n  try {\n    chain = resolveExecutionChain(path, urlQuery, rawRequest);\n  } catch (err) {\n    drainRequestBody(res);\n    state.replied = true;\n    fatalFail(res, state, respHeaders, toRpcError(err));\n    return;\n  }\n\n  const dispatchBody = (rawBody: string, readQueryBody: boolean) => {\n    let reqRawBody: any = rawBody;\n    let reqBodyType: SerializerCode = SerializerModes.stringifyJson;\n    // a throw here runs inside uWS' native callback (or a microtask): it must become a response\n    try {\n      const queryBody = readQueryBody ? decodeQueryBody(urlQuery, reqRawBody || undefined) : undefined;\n      if (queryBody) {\n        reqRawBody = queryBody.rawBody;\n        reqBodyType = queryBody.bodyType;\n      }\n    } catch (err) {\n      state.replied = true;\n      fatalFail(res, state, respHeaders, err as RpcError<string>);\n      return;\n    }\n\n    const context = createContextFromChain(chain, path, urlQuery, reqHeaders, respHeaders, reqRawBody, reqBodyType);\n    let dispatched: MionResponse | Promise<MionResponse>;\n    try {\n      dispatched = dispatchMaybeSync(context, rawRequest, res);\n    } catch (err) {\n      failWith(err);\n      return;\n    }\n    // an all-sync chain answers inside uWS' own callback, with no promise in between\n    if (dispatched instanceof Promise) answerWith(dispatched);\n    else answer(dispatched);\n  };\n\n  const answer = (mionResponse: MionResponse) => {\n    if (state.replied) return;\n    state.replied = true;\n    try {\n      reply(res, state, mionResponse);\n    } catch {\n      // already marked replied: a failed write has nothing left to answer with\n    }\n  };\n\n  const failWith = (err: unknown) => {\n    if (state.replied) return;\n    state.replied = true;\n    fatalFail(res, state, respHeaders, toRpcError(err));\n  };\n\n  const answerWith = (dispatched: Promise<MionResponse>) => {\n    dispatched.then(answer).catch(failWith);\n  };\n\n  // collectBody assembles the body natively (uWS' onDataV2 preallocates) and calls back ONCE, with null past maxSize,\n  // which is exactly the maxBodySize contract. A not-found chain has no route to feed: its body is dropped as it arrives.\n  if (!chain.readsBody) {\n    drainRequestBody(res);\n    dispatchBody('', false);\n    return;\n  }\n\n  res.collectBody(chain.maxBodySize, (fullBody) => {\n    if (state.replied) return;\n    if (fullBody === null) {\n      // the route resolved, so the refusal still runs the chain's alwaysRun members\n      answerWith(\n        dispatchPlatformError(chain, path, urlQuery, requestPayloadTooLarge(), reqHeaders, respHeaders, rawRequest, res)\n      );\n      return;\n    }\n\n    // collectBody has two paths (verified in the pinned tag's HttpResponseWrapper.h and by test): a single-read body is a\n    // zero-copy window into uWS' receive buffer, DETACHED when this callback returns, so it must be decoded synchronously\n    // here; a multi-read body was assembled in C++ and OWNERSHIP-TRANSFERRED to JS, so it can be decoded from a microtask.\n    if (fullBody.byteLength <= UWS_MAX_SINGLE_READ) {\n      // a body-less request (every GET) skips the view and the decode altogether\n      dispatchBody(fullBody.byteLength === 0 ? '' : Buffer.from(fullBody).toString(), true);\n      return;\n    }\n    // bigger than one read can deliver → guaranteed the ownership-transferred path, so the buffer survives the microtask.\n    // The zero-length check is a tripwire for an upstream change: fail loudly instead of parsing a neutered buffer.\n    queueMicrotask(() => {\n      if (state.replied) return;\n      if (fullBody.byteLength === 0) {\n        state.replied = true;\n        const error = new FatalError({\n          publicMessage: 'Internal Server Error',\n          type: 'unknown-error',\n          errorData: {reason: 'uws detached a multi-read body buffer (upstream behavior change) — report to mion'},\n        });\n        fatalFail(res, state, respHeaders, error);\n        return;\n      }\n      dispatchBody(releaseAfterDecode(fullBody), true);\n    });\n  });\n}\n\n/** Frees an ownership-transferred body buffer right after decoding it; the single-read window must never come through here.\n *  `transfer(0)` and not `transfer()`: measured on node 26, only `transfer(0)` releases the backing store there and then.\n *  Guarded because a future uWS could hand back a buffer that cannot be transferred, which must not fail the request. */\nfunction releaseAfterDecode(fullBody: ArrayBuffer): string {\n  const text = Buffer.from(fullBody).toString();\n  try {\n    (fullBody as ReleasableBuffer).transfer?.(0);\n  } catch {\n    // not transferable: the collector gets it instead, exactly as before\n  }\n  return text;\n}\n\n/** `transfer` is ES2024 and this package compiles against an ES2023 lib; optional because a runtime without it must work. */\ntype ReleasableBuffer = ArrayBuffer & {transfer?: (newByteLength?: number) => ArrayBuffer};\n\n// only called when there is an http error or weird unhandled route errors\nfunction fatalFail(res: HttpResponse, state: {aborted: boolean}, respHeaders: MionHeaders, error: RpcError<string>) {\n  const routeResponse = getRouterFatalErrorResponse(error, respHeaders);\n  reply(res, state, routeResponse);\n}\n\nfunction isHeaderSafe(text: string): boolean {\n  // one pass, no allocation: a CR, LF or NUL anywhere makes the header unsafe to write\n  for (let i = 0; i < text.length; i++) {\n    const code = text.charCodeAt(i);\n    if (code === 13 || code === 10 || code === 0) return false;\n  }\n  return true;\n}\n\n/** The line is a pure function of the code, so it is built once per code rather than per response. */\nconst statusLines = new Map<number, string>();\nfunction statusLine(statusCode: number): string {\n  const cached = statusLines.get(statusCode);\n  if (cached !== undefined) return cached;\n  const statusText = STATUS_CODES[statusCode];\n  const line = statusText ? `${statusCode} ${statusText}` : `${statusCode}`;\n  statusLines.set(statusCode, line);\n  return line;\n}\n\nfunction reply(res: HttpResponse, state: {aborted: boolean}, mionResp: MionResponse) {\n  // uWS freed the response when the client left; touching it would crash\n  if (state.aborted) return;\n  const headers = mionResp.headers as RecordResponseHeaders;\n\n  // serialized BEFORE the cork: uWS warns a cork buffer must not be held across event loop iterations\n  const payload = JSON.stringify(mionResp.body);\n\n  // cork makes one syscall; uWS headers are write-only and must all precede end().\n  // content-length is skipped: uWS writes its own, and a duplicate corrupts the response.\n  // uWS writes headers unchecked, so an echoed CR or LF would be header injection: dropped\n  const write = (name: string, value: string) => {\n    if (isHeaderSafe(value)) res.writeHeader(name, value);\n  };\n  res.cork(() => {\n    res.writeStatus(statusLine(mionResp.statusCode));\n    headers.forEach((name, value) => {\n      if (name === 'content-length' || name === 'content-type' || !isHeaderSafe(name)) return;\n      if (typeof value === 'string') write(name, value);\n      // RFC 6265 forbids folding set-cookie; uWS writes a repeated name as its own line\n      else if (name === 'set-cookie') for (const cookie of value) write(name, cookie);\n      else write(name, value.join(', '));\n    });\n    // last, and the store's own skipped above: uWS appends a repeated name instead of replacing it\n    res.writeHeader('content-type', mionResp.contentType);\n\n    res.end(payload);\n  });\n  releaseHeaders(headers);\n}\n"],"mappings":"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"}
+{"version":3,"file":"uwsHttp.js","names":[],"sources":["../../../src/uwsHttp.ts"],"sourcesContent":["/* ########\n * 2022 mion\n * Author: Ma-jerez\n * License: MIT\n * The software is provided \"as is\", without warranty of any kind.\n * ######## */\n\nimport {\n  dispatchMaybeSync,\n  dispatchPlatformError,\n  resolveExecutionChain,\n  createContextFromChain,\n  getRouterFatalErrorResponse,\n  toRpcError,\n  resetRouter,\n  setPlatformConfig,\n  getDefaultHeaders,\n  releaseHeaders,\n  requestPayloadTooLarge,\n  hostOwnsSocket,\n  HttpMethod,\n} from '@mionjs/router';\nimport {STATUS_CODES} from 'http';\nimport {loadUws} from '@mionjs/bin-uws';\nimport type {HttpRequest, HttpResponse, TemplatedApp, us_listen_socket} from '@mionjs/bin-uws';\nimport {DEFAULT_UWS_HTTP_OPTIONS} from './constants.ts';\nimport type {UwsHttpOptions} from './types.ts';\nimport type {MethodsExecutionChain, MionHeaders, MionResponse, RecordResponseHeaders} from '@mionjs/router';\nimport {getENV, SerializerModes} from '@mionjs/core';\nimport type {SerializerCode} from '@mionjs/core';\nimport {RpcError, FatalError} from '@mionjs/core';\nimport {headersFromUwsRequest} from './headers.ts';\n\n// ############# PRIVATE STATE #############\n\nlet httpOptions: Readonly<UwsHttpOptions> = {...DEFAULT_UWS_HTTP_OPTIONS};\n\n// The most bytes one uWS socket read can deliver: uSockets' LIBUS_RECV_BUFFER_LENGTH (512 KiB) at the tag pinned in\n// packages/bin-uws. A LARGER body cannot be single-read, which is what makes the zero-copy branch below safe (a\n// detachment tripwire guards it at runtime). Re-verify against uSockets on a tag bump.\nconst UWS_MAX_SINGLE_READ = 524288;\n\n/** The running server: the uWS app plus the socket handle listen() produced. */\nexport interface UwsServer {\n  app: TemplatedApp;\n  listenSocket: us_listen_socket;\n  close(): void;\n}\n\n// ############# PUBLIC METHODS #############\n\nexport function resetUwsHttpOpts() {\n  httpOptions = {...DEFAULT_UWS_HTTP_OPTIONS};\n  resetRouter();\n}\n\nexport function setUwsHttpOpts(options?: Partial<UwsHttpOptions>) {\n  httpOptions = {\n    ...httpOptions,\n    ...options,\n  };\n\n  return httpOptions;\n}\n\n/** The platform config the router publishes: everything but the TLS file paths. */\nfunction serializablePlatformConfig(): Record<string, unknown> {\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  const {ssl: _ssl, ...serializableConfig} = httpOptions;\n  return serializableConfig;\n}\n\nexport async function startUwsServer(options?: Partial<UwsHttpOptions>): Promise<UwsServer> {\n  const isTest = getENV('NODE_ENV') === 'test';\n\n  if (options) setUwsHttpOpts(options);\n  // uWS is its own C++ event loop and owns its listen socket, so it cannot mount on a host node server.\n  if (hostOwnsSocket()) {\n    throw new Error(\n      '@mionjs/platform-uws does not support middleware mode: uWebSockets.js owns its own listen ' +\n        'socket and cannot mount on a host node server. Use @mionjs/platform-node for middleware mode.'\n    );\n  }\n  const protocol = httpOptions.ssl ? 'https' : 'http';\n  const port = httpOptions.port !== 80 ? `:${httpOptions.port}` : '';\n  const url = `${protocol}://localhost${port}`;\n  if (!isTest)\n    console.log(`mion uws server running on ${url}`, {\n      port: httpOptions.port,\n      httpOptions,\n    });\n\n  // uWS reads it once, when its binary loads\n  process.env.UWS_HTTP_MAX_HEADERS_SIZE ??= String(httpOptions.maxHeaderSize);\n  const uws = loadUws();\n  const app = httpOptions.ssl ? uws.SSLApp(httpOptions.ssl) : uws.App();\n  app.any('/*', uwsRequestHandler);\n\n  return new Promise<UwsServer>((resolve, reject) => {\n    app.listen(httpOptions.port, (listenSocket) => {\n      if (!listenSocket) {\n        reject(new Error(`mion uws server failed to listen on port ${httpOptions.port} (port in use?)`));\n        return;\n      }\n\n      setPlatformConfig(serializablePlatformConfig());\n\n      let closed = false;\n      const close = () => {\n        if (closed) return;\n        closed = true;\n        uws.us_listen_socket_close(listenSocket);\n      };\n      const server: UwsServer = {app, listenSocket, close};\n\n      const shutdownHandler = function () {\n        if (!isTest) console.log(`Shutting down mion server on ${url}`);\n        close();\n        process.exit(0);\n      };\n      process.on('SIGINT', shutdownHandler);\n      process.on('SIGTERM', shutdownHandler);\n\n      resolve(server);\n    });\n  });\n}\n\n// ############# PRIVATE METHODS #############\n\n// uWS hands the method over lowercased\n// null prototype: a `constructor` method off the wire must not read Object.prototype\nconst LOWER_CASE_METHODS: Readonly<Record<string, HttpMethod>> = Object.assign(Object.create(null), {\n  get: 'GET',\n  head: 'HEAD',\n  post: 'POST',\n  put: 'PUT',\n  delete: 'DELETE',\n  connect: 'CONNECT',\n  options: 'OPTIONS',\n  trace: 'TRACE',\n  patch: 'PATCH',\n  query: 'QUERY',\n});\nfunction upperCaseMethod(method: string): HttpMethod {\n  return LOWER_CASE_METHODS[method] ?? 'OTHER';\n}\n\n// uWS refreshes a socket's idle timeout only from inside a body-data callback, and runs it only when a reader is registered.\n// Without one, a request answered before its body finished arriving is closed mid-upload, so drop every chunk instead.\nfunction drainRequestBody(res: HttpResponse) {\n  res.onData(() => {});\n}\n\n// exported for tests and for mounting on a hand-built uWS app; NOT a middleware handler (see startUwsServer).\n// uWS contract: `req` is valid only synchronously here, so the async dispatch snapshots it before the first await.\nexport function uwsRequestHandler(res: HttpResponse, req: HttpRequest): void {\n  const path = req.getUrl();\n  const query = req.getQuery();\n  const urlQuery = query === '' ? undefined : query;\n  const method = upperCaseMethod(req.getMethod());\n  const reqHeaders = headersFromUwsRequest(req);\n  const state: ReplyState = {replied: false, aborted: false, head: method === 'HEAD'};\n\n  const respHeaders = getDefaultHeaders();\n\n  // must be registered before any async work: after a disconnect uWS frees the response, and touching it would crash\n  res.onAborted(() => {\n    state.aborted = true;\n  });\n\n  // route resolved BEFORE the body: the native read stops at the chain's limit, and a late context stays GC-cheap.\n  // The raw request object is built once: the one a pathTransform reads and the one the handlers see.\n  const rawRequest = {path, urlQuery, headers: reqHeaders};\n  let chain: MethodsExecutionChain;\n  try {\n    chain = resolveExecutionChain(path, urlQuery, rawRequest);\n  } catch (err) {\n    drainRequestBody(res);\n    state.replied = true;\n    fatalFail(res, state, respHeaders, toRpcError(err));\n    return;\n  }\n\n  const dispatchBody = (rawBody: string) => {\n    const reqBodyType: SerializerCode = SerializerModes.stringifyJson;\n\n    const context = createContextFromChain(chain, path, urlQuery, method, reqHeaders, respHeaders, rawBody, reqBodyType);\n    let dispatched: MionResponse | Promise<MionResponse>;\n    try {\n      dispatched = dispatchMaybeSync(context, rawRequest, res);\n    } catch (err) {\n      failWith(err);\n      return;\n    }\n    // an all-sync chain answers inside uWS' own callback, with no promise in between\n    if (dispatched instanceof Promise) answerWith(dispatched);\n    else answer(dispatched);\n  };\n\n  const answer = (mionResponse: MionResponse) => {\n    if (state.replied) return;\n    state.replied = true;\n    try {\n      reply(res, state, mionResponse);\n    } catch {\n      // already marked replied: a failed write has nothing left to answer with\n    }\n  };\n\n  const failWith = (err: unknown) => {\n    if (state.replied) return;\n    state.replied = true;\n    fatalFail(res, state, respHeaders, toRpcError(err));\n  };\n\n  const answerWith = (dispatched: Promise<MionResponse>) => {\n    dispatched.then(answer).catch(failWith);\n  };\n\n  // collectBody assembles the body natively (uWS' onDataV2 preallocates) and calls back ONCE, with null past maxSize,\n  // which is exactly the maxBodySize contract. A not-found chain has no route to feed: its body is dropped as it arrives.\n  if (!chain.readsBody) {\n    drainRequestBody(res);\n    dispatchBody('');\n    return;\n  }\n\n  res.collectBody(chain.maxBodySize, (fullBody) => {\n    if (state.replied) return;\n    if (fullBody === null) {\n      // the route resolved, so the refusal still runs the chain's alwaysRun members\n      answerWith(\n        dispatchPlatformError(chain, path, urlQuery, method, requestPayloadTooLarge(), reqHeaders, respHeaders, rawRequest, res)\n      );\n      return;\n    }\n\n    // A single-read body is a zero-copy window DETACHED when this callback returns (HttpResponseWrapper.h): decode now.\n    // A multi-read body was assembled in C++ and OWNERSHIP-TRANSFERRED to JS, so a microtask may decode it.\n    if (fullBody.byteLength <= UWS_MAX_SINGLE_READ) {\n      // a body-less request (every GET) skips the view and the decode altogether\n      dispatchBody(fullBody.byteLength === 0 ? '' : Buffer.from(fullBody).toString());\n      return;\n    }\n    // past one read's size → always the ownership-transferred path, so the buffer survives the microtask.\n    // The zero-length check is a tripwire for an upstream change: fail loudly instead of parsing a neutered buffer.\n    queueMicrotask(() => {\n      if (state.replied) return;\n      if (fullBody.byteLength === 0) {\n        state.replied = true;\n        const error = new FatalError({\n          publicMessage: 'Internal Server Error',\n          type: 'unknown-error',\n          errorData: {reason: 'uws detached a multi-read body buffer (upstream behavior change) — report to mion'},\n        });\n        fatalFail(res, state, respHeaders, error);\n        return;\n      }\n      dispatchBody(releaseAfterDecode(fullBody));\n    });\n  });\n}\n\n/** Frees an ownership-transferred body buffer right after decoding it; the single-read window must never come through here.\n *  `transfer(0)` and not `transfer()`: measured on node 26, only `transfer(0)` releases the backing store there and then.\n *  Guarded because a future uWS could hand back a buffer that cannot be transferred, which must not fail the request. */\nfunction releaseAfterDecode(fullBody: ArrayBuffer): string {\n  const text = Buffer.from(fullBody).toString();\n  try {\n    (fullBody as ReleasableBuffer).transfer?.(0);\n  } catch {\n    // not transferable: the collector gets it instead, exactly as before\n  }\n  return text;\n}\n\n/** `transfer` is ES2024 and this package compiles against an ES2023 lib; optional because a runtime without it must work. */\ntype ReleasableBuffer = ArrayBuffer & {transfer?: (newByteLength?: number) => ArrayBuffer};\n\ninterface ReplyState {\n  replied: boolean;\n  aborted: boolean;\n  /** RFC 9110: a HEAD answer has no body; one sent anyway is read as the start of the next answer */\n  readonly head: boolean;\n}\n\n// only for http errors and unhandled route errors\nfunction fatalFail(res: HttpResponse, state: ReplyState, respHeaders: MionHeaders, error: RpcError<string>) {\n  const routeResponse = getRouterFatalErrorResponse(error, respHeaders);\n  reply(res, state, routeResponse);\n}\n\n/** The line is a pure function of the code, so it is built once per code rather than per response. */\nconst statusLines = new Map<number, string>();\nfunction statusLine(statusCode: number): string {\n  const cached = statusLines.get(statusCode);\n  if (cached !== undefined) return cached;\n  const statusText = STATUS_CODES[statusCode];\n  const line = statusText ? `${statusCode} ${statusText}` : `${statusCode}`;\n  statusLines.set(statusCode, line);\n  return line;\n}\n\nfunction reply(res: HttpResponse, state: ReplyState, mionResp: MionResponse) {\n  // uWS freed the response when the client left; touching it would crash\n  if (state.aborted) return;\n  const headers = mionResp.headers as RecordResponseHeaders;\n\n  // serialized BEFORE the cork: uWS warns a cork buffer must not be held across event loop iterations\n  const payload = JSON.stringify(mionResp.body);\n  // uWS writes a `connection: close` header but keeps the socket open, so the close is asked for here\n  const close = headers.get('connection')?.toLowerCase() === 'close';\n\n  // cork makes one syscall; uWS headers are write-only and must all precede end().\n  // content-length is skipped: uWS writes its own, and a duplicate corrupts the response.\n  // the header store refused any CR, LF or NUL when it was set\n  const write = (name: string, value: string) => res.writeHeader(name, value);\n  res.cork(() => {\n    res.writeStatus(statusLine(mionResp.statusCode));\n    headers.forEach((name, value) => {\n      if (name === 'content-length' || name === 'content-type') return;\n      if (typeof value === 'string') write(name, value);\n      // RFC 6265 forbids folding set-cookie; uWS writes a repeated name as its own line\n      else if (name === 'set-cookie') for (const cookie of value) write(name, cookie);\n      else write(name, value.join(', '));\n    });\n    // last, and the store's own skipped above: uWS appends a repeated name instead of replacing it\n    res.writeHeader('content-type', mionResp.contentType);\n\n    if (state.head) res.endWithoutBody(Buffer.byteLength(payload, 'utf8'), close);\n    else res.end(payload, close);\n  });\n  releaseHeaders(headers);\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mionjs/platform-uws",
-  "version": "0.13.2",
+  "version": "0.14.0",
   "type": "module",
   "description": "mion HTTP Server on uWebSockets.js for maximum performance.",
   "keywords": [
@@ -22,7 +22,6 @@
   "exports": {
     ".": {
       "types": "./.dist/esm/index.d.ts",
-      "require": "./.dist/cjs/index.cjs",
       "default": "./.dist/esm/index.js"
     }
   },
@@ -46,12 +45,12 @@
   },
   "comment:engines": "Inherited constraint from @mionjs/bin-uws: uWebSockets.js ships prebuilt binaries only for these Node majors.",
   "engines": {
-    "node": ">=22 <23 || >=24 <25 || >=26 <27"
+    "node": ">=24 <25 || >=26 <27"
   },
   "dependencies": {
-    "@mionjs/core": "0.13.2",
-    "@mionjs/router": "0.13.2",
-    "@mionjs/bin-uws": "0.13.2"
+    "@mionjs/core": "0.14.0",
+    "@mionjs/router": "0.14.0",
+    "@mionjs/bin-uws": "0.14.0"
   },
   "scripts": {
     "typecheck:test": "tsc -p tsconfig.json --noEmit",
@@ -59,7 +58,6 @@
     "dev": "vite build --watch",
     "dev:test": "vitest watch",
     "lint": "eslint src",
-    "format": "prettier --write src/**/*.ts",
     "build": "vite build",
     "clean": "rimraf .dist .coverage .mion",
     "fresh-start": "pnpm run clean && rimraf node_modules"

package/.dist/cjs/index.cjs

@@ -1,8 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_src_constants = require("./src/constants.cjs");
-const require_src_uwsHttp = require("./src/uwsHttp.cjs");
-exports.DEFAULT_UWS_HTTP_OPTIONS = require_src_constants.DEFAULT_UWS_HTTP_OPTIONS;
-exports.resetUwsHttpOpts = require_src_uwsHttp.resetUwsHttpOpts;
-exports.setUwsHttpOpts = require_src_uwsHttp.setUwsHttpOpts;
-exports.startUwsServer = require_src_uwsHttp.startUwsServer;
-exports.uwsRequestHandler = require_src_uwsHttp.uwsRequestHandler;

package/.dist/cjs/index.d.ts

@@ -1,4 +0,0 @@
-export * from './src/uwsHttp.ts';
-export * from './src/types.ts';
-export * from './src/constants.ts';
-//# sourceMappingURL=index.d.ts.map

package/.dist/cjs/package.json

@@ -1 +0,0 @@
-{"type":"commonjs"}

package/.dist/cjs/src/constants.cjs

@@ -1,11 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region src/constants.ts
-var DEFAULT_UWS_HTTP_OPTIONS = {
-	port: 80,
-	/** What a route takes when its own `maxBodySize` and its types say nothing: the shared 128 KB default */
-	maxBodySize: require("@mionjs/core").DEFAULT_MAX_BODY_SIZE
-};
-//#endregion
-exports.DEFAULT_UWS_HTTP_OPTIONS = DEFAULT_UWS_HTTP_OPTIONS;
-
-//# sourceMappingURL=constants.cjs.map

package/.dist/cjs/src/constants.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.cjs","names":[],"sources":["../../../src/constants.ts"],"sourcesContent":["/* ########\n * 2022 mion\n * Author: Ma-jerez\n * License: MIT\n * The software is provided \"as is\", without warranty of any kind.\n * ######## */\n\nimport {DEFAULT_MAX_BODY_SIZE} from '@mionjs/core';\nimport {UwsHttpOptions} from './types.ts';\n\nexport const DEFAULT_UWS_HTTP_OPTIONS: UwsHttpOptions = {\n  port: 80,\n  /** What a route takes when its own `maxBodySize` and its types say nothing: the shared 128 KB default */\n  maxBodySize: DEFAULT_MAX_BODY_SIZE,\n};\n"],"mappings":";;AAUA,IAAa,2BAA2C;CACtD,MAAM;;CAEN,mCAAa,EAAA;AACf"}

package/.dist/cjs/src/constants.d.ts

@@ -1,3 +0,0 @@
-import { UwsHttpOptions } from './types.ts';
-export declare const DEFAULT_UWS_HTTP_OPTIONS: UwsHttpOptions;
-//# sourceMappingURL=constants.d.ts.map

package/.dist/cjs/src/headers.cjs

@@ -1,16 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-let _mionjs_router = require("@mionjs/router");
-//#region src/headers.ts
-/** uWS headers are readable only synchronously inside the handler, so snapshot them; uWS already lower-cases the names. */
-function headersFromUwsRequest(req) {
-	const record = {};
-	req.forEach((name, value) => {
-		const previous = record[name];
-		record[name] = typeof previous === "string" ? `${previous}, ${value}` : value;
-	});
-	return (0, _mionjs_router.headersFromRecord)(record, true);
-}
-//#endregion
-exports.headersFromUwsRequest = headersFromUwsRequest;
-
-//# sourceMappingURL=headers.cjs.map

package/.dist/cjs/src/headers.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"headers.cjs","names":[],"sources":["../../../src/headers.ts"],"sourcesContent":["/* ########\n * 2022 mion\n * Author: Ma-jerez\n * License: MIT\n * The software is provided \"as is\", without warranty of any kind.\n * ######## */\n\nimport {MionHeaders, headersFromRecord} from '@mionjs/router';\nimport type {HttpRequest} from '@mionjs/bin-uws';\n\n/** uWS headers are readable only synchronously inside the handler, so snapshot them; uWS already lower-cases the names. */\nexport function headersFromUwsRequest(req: HttpRequest): MionHeaders {\n  const record: Record<string, string> = {};\n  req.forEach((name, value) => {\n    // a string check, not undefined: a `constructor` header would otherwise find Object.prototype's function\n    const previous = record[name];\n    record[name] = typeof previous === 'string' ? `${previous}, ${value}` : value;\n  });\n  return headersFromRecord(record, true);\n}\n"],"mappings":";;;;AAWA,SAAgB,sBAAsB,KAA+B;CACnE,MAAM,SAAiC,CAAC;CACxC,IAAI,SAAS,MAAM,UAAU;EAE3B,MAAM,WAAW,OAAO;EACxB,OAAO,QAAQ,OAAO,aAAa,WAAW,GAAG,SAAS,IAAI,UAAU;CAC1E,CAAC;CACD,QAAA,GAAA,eAAA,mBAAyB,QAAQ,IAAI;AACvC"}

package/.dist/cjs/src/headers.d.ts

@@ -1,4 +0,0 @@
-import { MionHeaders } from '@mionjs/router';
-import { HttpRequest } from '@mionjs/bin-uws';
-export declare function headersFromUwsRequest(req: HttpRequest): MionHeaders;
-//# sourceMappingURL=headers.d.ts.map

package/.dist/cjs/src/types.d.ts

@@ -1,8 +0,0 @@
-import { AppOptions } from '@mionjs/bin-uws';
-export interface UwsHttpOptions {
-    port: number;
-    ssl?: AppOptions;
-    maxBodySize: number;
-    maxBodySizeCap?: number;
-}
-//# sourceMappingURL=types.d.ts.map

package/.dist/cjs/src/uwsHttp.cjs

@@ -1,224 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_src_constants = require("./constants.cjs");
-const require_src_headers = require("./headers.cjs");
-let _mionjs_router = require("@mionjs/router");
-let http = require("http");
-let _mionjs_bin_uws = require("@mionjs/bin-uws");
-let _mionjs_core = require("@mionjs/core");
-//#region src/uwsHttp.ts
-var httpOptions = { ...require_src_constants.DEFAULT_UWS_HTTP_OPTIONS };
-var UWS_MAX_SINGLE_READ = 524288;
-function resetUwsHttpOpts() {
-	httpOptions = { ...require_src_constants.DEFAULT_UWS_HTTP_OPTIONS };
-	(0, _mionjs_router.resetRouter)();
-}
-function setUwsHttpOpts(options) {
-	httpOptions = {
-		...httpOptions,
-		...options
-	};
-	return httpOptions;
-}
-/** The platform config the router publishes: everything but the TLS file paths. */
-function serializablePlatformConfig() {
-	const { ssl: _ssl, ...serializableConfig } = httpOptions;
-	return serializableConfig;
-}
-async function startUwsServer(options) {
-	const isTest = (0, _mionjs_core.getENV)("NODE_ENV") === "test";
-	if (options) setUwsHttpOpts(options);
-	if ((0, _mionjs_router.hostOwnsSocket)()) throw new Error("@mionjs/platform-uws does not support middleware mode: uWebSockets.js owns its own listen socket and cannot mount on a host node server. Use @mionjs/platform-node for middleware mode.");
-	const url = `${httpOptions.ssl ? "https" : "http"}://localhost${httpOptions.port !== 80 ? `:${httpOptions.port}` : ""}`;
-	if (!isTest) console.log(`mion uws server running on ${url}`, {
-		port: httpOptions.port,
-		httpOptions
-	});
-	const uws = (0, _mionjs_bin_uws.loadUws)();
-	const app = httpOptions.ssl ? uws.SSLApp(httpOptions.ssl) : uws.App();
-	app.any("/*", uwsRequestHandler);
-	return new Promise((resolve, reject) => {
-		app.listen(httpOptions.port, (listenSocket) => {
-			if (!listenSocket) {
-				reject(/* @__PURE__ */ new Error(`mion uws server failed to listen on port ${httpOptions.port} (port in use?)`));
-				return;
-			}
-			(0, _mionjs_router.setPlatformConfig)(serializablePlatformConfig());
-			let closed = false;
-			const close = () => {
-				if (closed) return;
-				closed = true;
-				uws.us_listen_socket_close(listenSocket);
-			};
-			const server = {
-				app,
-				listenSocket,
-				close
-			};
-			const shutdownHandler = function() {
-				if (!isTest) console.log(`Shutting down mion server on ${url}`);
-				close();
-				process.exit(0);
-			};
-			process.on("SIGINT", shutdownHandler);
-			process.on("SIGTERM", shutdownHandler);
-			resolve(server);
-		});
-	});
-}
-function drainRequestBody(res) {
-	res.onData(() => {});
-}
-function uwsRequestHandler(res, req) {
-	const state = {
-		replied: false,
-		aborted: false
-	};
-	const path = req.getUrl();
-	const query = req.getQuery();
-	const urlQuery = query === "" ? void 0 : query;
-	const reqHeaders = require_src_headers.headersFromUwsRequest(req);
-	const respHeaders = (0, _mionjs_router.getDefaultHeaders)();
-	res.onAborted(() => {
-		state.aborted = true;
-	});
-	const rawRequest = {
-		path,
-		urlQuery,
-		headers: reqHeaders
-	};
-	let chain;
-	try {
-		chain = (0, _mionjs_router.resolveExecutionChain)(path, urlQuery, rawRequest);
-	} catch (err) {
-		drainRequestBody(res);
-		state.replied = true;
-		fatalFail(res, state, respHeaders, (0, _mionjs_router.toRpcError)(err));
-		return;
-	}
-	const dispatchBody = (rawBody, readQueryBody) => {
-		let reqRawBody = rawBody;
-		let reqBodyType = _mionjs_core.SerializerModes.stringifyJson;
-		try {
-			const queryBody = readQueryBody ? (0, _mionjs_router.decodeQueryBody)(urlQuery, reqRawBody || void 0) : void 0;
-			if (queryBody) {
-				reqRawBody = queryBody.rawBody;
-				reqBodyType = queryBody.bodyType;
-			}
-		} catch (err) {
-			state.replied = true;
-			fatalFail(res, state, respHeaders, err);
-			return;
-		}
-		const context = (0, _mionjs_router.createContextFromChain)(chain, path, urlQuery, reqHeaders, respHeaders, reqRawBody, reqBodyType);
-		let dispatched;
-		try {
-			dispatched = (0, _mionjs_router.dispatchMaybeSync)(context, rawRequest, res);
-		} catch (err) {
-			failWith(err);
-			return;
-		}
-		if (dispatched instanceof Promise) answerWith(dispatched);
-		else answer(dispatched);
-	};
-	const answer = (mionResponse) => {
-		if (state.replied) return;
-		state.replied = true;
-		try {
-			reply(res, state, mionResponse);
-		} catch {}
-	};
-	const failWith = (err) => {
-		if (state.replied) return;
-		state.replied = true;
-		fatalFail(res, state, respHeaders, (0, _mionjs_router.toRpcError)(err));
-	};
-	const answerWith = (dispatched) => {
-		dispatched.then(answer).catch(failWith);
-	};
-	if (!chain.readsBody) {
-		drainRequestBody(res);
-		dispatchBody("", false);
-		return;
-	}
-	res.collectBody(chain.maxBodySize, (fullBody) => {
-		if (state.replied) return;
-		if (fullBody === null) {
-			answerWith((0, _mionjs_router.dispatchPlatformError)(chain, path, urlQuery, (0, _mionjs_router.requestPayloadTooLarge)(), reqHeaders, respHeaders, rawRequest, res));
-			return;
-		}
-		if (fullBody.byteLength <= UWS_MAX_SINGLE_READ) {
-			dispatchBody(fullBody.byteLength === 0 ? "" : Buffer.from(fullBody).toString(), true);
-			return;
-		}
-		queueMicrotask(() => {
-			if (state.replied) return;
-			if (fullBody.byteLength === 0) {
-				state.replied = true;
-				fatalFail(res, state, respHeaders, new _mionjs_core.FatalError({
-					publicMessage: "Internal Server Error",
-					type: "unknown-error",
-					errorData: { reason: "uws detached a multi-read body buffer (upstream behavior change) — report to mion" }
-				}));
-				return;
-			}
-			dispatchBody(releaseAfterDecode(fullBody), true);
-		});
-	});
-}
-/** Frees an ownership-transferred body buffer right after decoding it; the single-read window must never come through here.
-*  `transfer(0)` and not `transfer()`: measured on node 26, only `transfer(0)` releases the backing store there and then.
-*  Guarded because a future uWS could hand back a buffer that cannot be transferred, which must not fail the request. */
-function releaseAfterDecode(fullBody) {
-	const text = Buffer.from(fullBody).toString();
-	try {
-		fullBody.transfer?.(0);
-	} catch {}
-	return text;
-}
-function fatalFail(res, state, respHeaders, error) {
-	reply(res, state, (0, _mionjs_router.getRouterFatalErrorResponse)(error, respHeaders));
-}
-function isHeaderSafe(text) {
-	for (let i = 0; i < text.length; i++) {
-		const code = text.charCodeAt(i);
-		if (code === 13 || code === 10 || code === 0) return false;
-	}
-	return true;
-}
-/** The line is a pure function of the code, so it is built once per code rather than per response. */
-var statusLines = /* @__PURE__ */ new Map();
-function statusLine(statusCode) {
-	const cached = statusLines.get(statusCode);
-	if (cached !== void 0) return cached;
-	const statusText = http.STATUS_CODES[statusCode];
-	const line = statusText ? `${statusCode} ${statusText}` : `${statusCode}`;
-	statusLines.set(statusCode, line);
-	return line;
-}
-function reply(res, state, mionResp) {
-	if (state.aborted) return;
-	const headers = mionResp.headers;
-	const payload = JSON.stringify(mionResp.body);
-	const write = (name, value) => {
-		if (isHeaderSafe(value)) res.writeHeader(name, value);
-	};
-	res.cork(() => {
-		res.writeStatus(statusLine(mionResp.statusCode));
-		headers.forEach((name, value) => {
-			if (name === "content-length" || name === "content-type" || !isHeaderSafe(name)) return;
-			if (typeof value === "string") write(name, value);
-			else if (name === "set-cookie") for (const cookie of value) write(name, cookie);
-			else write(name, value.join(", "));
-		});
-		res.writeHeader("content-type", mionResp.contentType);
-		res.end(payload);
-	});
-	(0, _mionjs_router.releaseHeaders)(headers);
-}
-//#endregion
-exports.resetUwsHttpOpts = resetUwsHttpOpts;
-exports.setUwsHttpOpts = setUwsHttpOpts;
-exports.startUwsServer = startUwsServer;
-exports.uwsRequestHandler = uwsRequestHandler;
-
-//# sourceMappingURL=uwsHttp.cjs.map

package/.dist/cjs/src/uwsHttp.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"uwsHttp.cjs","names":[],"sources":["../../../src/uwsHttp.ts"],"sourcesContent":["/* ########\n * 2022 mion\n * Author: Ma-jerez\n * License: MIT\n * The software is provided \"as is\", without warranty of any kind.\n * ######## */\n\nimport {\n  dispatchMaybeSync,\n  dispatchPlatformError,\n  resolveExecutionChain,\n  createContextFromChain,\n  getRouterFatalErrorResponse,\n  toRpcError,\n  resetRouter,\n  decodeQueryBody,\n  setPlatformConfig,\n  getDefaultHeaders,\n  releaseHeaders,\n  requestPayloadTooLarge,\n  hostOwnsSocket,\n} from '@mionjs/router';\nimport {STATUS_CODES} from 'http';\nimport {loadUws} from '@mionjs/bin-uws';\nimport type {HttpRequest, HttpResponse, TemplatedApp, us_listen_socket} from '@mionjs/bin-uws';\nimport {DEFAULT_UWS_HTTP_OPTIONS} from './constants.ts';\nimport type {UwsHttpOptions} from './types.ts';\nimport type {MethodsExecutionChain, MionHeaders, MionResponse, RecordResponseHeaders} from '@mionjs/router';\nimport {getENV, SerializerModes} from '@mionjs/core';\nimport type {SerializerCode} from '@mionjs/core';\nimport {RpcError, FatalError} from '@mionjs/core';\nimport {headersFromUwsRequest} from './headers.ts';\n\n// ############# PRIVATE STATE #############\n\nlet httpOptions: Readonly<UwsHttpOptions> = {...DEFAULT_UWS_HTTP_OPTIONS};\n\n// The most bytes one uWS socket read can deliver: uSockets' LIBUS_RECV_BUFFER_LENGTH (512 KiB) at the tag pinned in\n// packages/bin-uws. A LARGER body cannot be single-read, which is what makes the zero-copy branch below safe (a\n// detachment tripwire guards it at runtime). Re-verify against uSockets on a tag bump.\nconst UWS_MAX_SINGLE_READ = 524288;\n\n/** The running server: the uWS app plus the socket handle listen() produced. */\nexport interface UwsServer {\n  app: TemplatedApp;\n  listenSocket: us_listen_socket;\n  close(): void;\n}\n\n// ############# PUBLIC METHODS #############\n\nexport function resetUwsHttpOpts() {\n  httpOptions = {...DEFAULT_UWS_HTTP_OPTIONS};\n  resetRouter();\n}\n\nexport function setUwsHttpOpts(options?: Partial<UwsHttpOptions>) {\n  httpOptions = {\n    ...httpOptions,\n    ...options,\n  };\n\n  return httpOptions;\n}\n\n/** The platform config the router publishes: everything but the TLS file paths. */\nfunction serializablePlatformConfig(): Record<string, unknown> {\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  const {ssl: _ssl, ...serializableConfig} = httpOptions;\n  return serializableConfig;\n}\n\nexport async function startUwsServer(options?: Partial<UwsHttpOptions>): Promise<UwsServer> {\n  const isTest = getENV('NODE_ENV') === 'test';\n\n  if (options) setUwsHttpOpts(options);\n  // uWS is its own C++ event loop and owns its listen socket, so it cannot mount on a host node server.\n  if (hostOwnsSocket()) {\n    throw new Error(\n      '@mionjs/platform-uws does not support middleware mode: uWebSockets.js owns its own listen ' +\n        'socket and cannot mount on a host node server. Use @mionjs/platform-node for middleware mode.'\n    );\n  }\n  const protocol = httpOptions.ssl ? 'https' : 'http';\n  const port = httpOptions.port !== 80 ? `:${httpOptions.port}` : '';\n  const url = `${protocol}://localhost${port}`;\n  if (!isTest)\n    console.log(`mion uws server running on ${url}`, {\n      port: httpOptions.port,\n      httpOptions,\n    });\n\n  const uws = loadUws();\n  const app = httpOptions.ssl ? uws.SSLApp(httpOptions.ssl) : uws.App();\n  app.any('/*', uwsRequestHandler);\n\n  return new Promise<UwsServer>((resolve, reject) => {\n    app.listen(httpOptions.port, (listenSocket) => {\n      if (!listenSocket) {\n        reject(new Error(`mion uws server failed to listen on port ${httpOptions.port} (port in use?)`));\n        return;\n      }\n\n      setPlatformConfig(serializablePlatformConfig());\n\n      let closed = false;\n      const close = () => {\n        if (closed) return;\n        closed = true;\n        uws.us_listen_socket_close(listenSocket);\n      };\n      const server: UwsServer = {app, listenSocket, close};\n\n      const shutdownHandler = function () {\n        if (!isTest) console.log(`Shutting down mion server on ${url}`);\n        close();\n        process.exit(0);\n      };\n      process.on('SIGINT', shutdownHandler);\n      process.on('SIGTERM', shutdownHandler);\n\n      resolve(server);\n    });\n  });\n}\n\n// ############# PRIVATE METHODS #############\n\n// uWS refreshes a socket's idle timeout only from inside a body-data callback, and runs it only when a reader is registered.\n// Without one, a request answered before its body finished arriving is closed mid-upload, so drop every chunk instead.\nfunction drainRequestBody(res: HttpResponse) {\n  res.onData(() => {});\n}\n\n// exported for tests and for mounting on a hand-built uWS app; NOT a middleware handler (see startUwsServer).\n// uWS contract: `req` is valid only synchronously here, so the async dispatch snapshots it before the first await.\nexport function uwsRequestHandler(res: HttpResponse, req: HttpRequest): void {\n  const state = {replied: false, aborted: false};\n  // Everything read from `req` happens HERE, synchronously.\n  const path = req.getUrl();\n  const query = req.getQuery();\n  const urlQuery = query === '' ? undefined : query;\n  const reqHeaders = headersFromUwsRequest(req);\n\n  const respHeaders = getDefaultHeaders();\n\n  // must be registered before any async work: after a disconnect uWS frees the response, and touching it would crash\n  res.onAborted(() => {\n    state.aborted = true;\n  });\n\n  // route resolved BEFORE the body, synchronously: the native read stops at the chain's limit, and a late context stays GC-cheap.\n  // The raw request object is built once: the one a pathTransform reads and the one the handlers see.\n  const rawRequest = {path, urlQuery, headers: reqHeaders};\n  let chain: MethodsExecutionChain;\n  try {\n    chain = resolveExecutionChain(path, urlQuery, rawRequest);\n  } catch (err) {\n    drainRequestBody(res);\n    state.replied = true;\n    fatalFail(res, state, respHeaders, toRpcError(err));\n    return;\n  }\n\n  const dispatchBody = (rawBody: string, readQueryBody: boolean) => {\n    let reqRawBody: any = rawBody;\n    let reqBodyType: SerializerCode = SerializerModes.stringifyJson;\n    // a throw here runs inside uWS' native callback (or a microtask): it must become a response\n    try {\n      const queryBody = readQueryBody ? decodeQueryBody(urlQuery, reqRawBody || undefined) : undefined;\n      if (queryBody) {\n        reqRawBody = queryBody.rawBody;\n        reqBodyType = queryBody.bodyType;\n      }\n    } catch (err) {\n      state.replied = true;\n      fatalFail(res, state, respHeaders, err as RpcError<string>);\n      return;\n    }\n\n    const context = createContextFromChain(chain, path, urlQuery, reqHeaders, respHeaders, reqRawBody, reqBodyType);\n    let dispatched: MionResponse | Promise<MionResponse>;\n    try {\n      dispatched = dispatchMaybeSync(context, rawRequest, res);\n    } catch (err) {\n      failWith(err);\n      return;\n    }\n    // an all-sync chain answers inside uWS' own callback, with no promise in between\n    if (dispatched instanceof Promise) answerWith(dispatched);\n    else answer(dispatched);\n  };\n\n  const answer = (mionResponse: MionResponse) => {\n    if (state.replied) return;\n    state.replied = true;\n    try {\n      reply(res, state, mionResponse);\n    } catch {\n      // already marked replied: a failed write has nothing left to answer with\n    }\n  };\n\n  const failWith = (err: unknown) => {\n    if (state.replied) return;\n    state.replied = true;\n    fatalFail(res, state, respHeaders, toRpcError(err));\n  };\n\n  const answerWith = (dispatched: Promise<MionResponse>) => {\n    dispatched.then(answer).catch(failWith);\n  };\n\n  // collectBody assembles the body natively (uWS' onDataV2 preallocates) and calls back ONCE, with null past maxSize,\n  // which is exactly the maxBodySize contract. A not-found chain has no route to feed: its body is dropped as it arrives.\n  if (!chain.readsBody) {\n    drainRequestBody(res);\n    dispatchBody('', false);\n    return;\n  }\n\n  res.collectBody(chain.maxBodySize, (fullBody) => {\n    if (state.replied) return;\n    if (fullBody === null) {\n      // the route resolved, so the refusal still runs the chain's alwaysRun members\n      answerWith(\n        dispatchPlatformError(chain, path, urlQuery, requestPayloadTooLarge(), reqHeaders, respHeaders, rawRequest, res)\n      );\n      return;\n    }\n\n    // collectBody has two paths (verified in the pinned tag's HttpResponseWrapper.h and by test): a single-read body is a\n    // zero-copy window into uWS' receive buffer, DETACHED when this callback returns, so it must be decoded synchronously\n    // here; a multi-read body was assembled in C++ and OWNERSHIP-TRANSFERRED to JS, so it can be decoded from a microtask.\n    if (fullBody.byteLength <= UWS_MAX_SINGLE_READ) {\n      // a body-less request (every GET) skips the view and the decode altogether\n      dispatchBody(fullBody.byteLength === 0 ? '' : Buffer.from(fullBody).toString(), true);\n      return;\n    }\n    // bigger than one read can deliver → guaranteed the ownership-transferred path, so the buffer survives the microtask.\n    // The zero-length check is a tripwire for an upstream change: fail loudly instead of parsing a neutered buffer.\n    queueMicrotask(() => {\n      if (state.replied) return;\n      if (fullBody.byteLength === 0) {\n        state.replied = true;\n        const error = new FatalError({\n          publicMessage: 'Internal Server Error',\n          type: 'unknown-error',\n          errorData: {reason: 'uws detached a multi-read body buffer (upstream behavior change) — report to mion'},\n        });\n        fatalFail(res, state, respHeaders, error);\n        return;\n      }\n      dispatchBody(releaseAfterDecode(fullBody), true);\n    });\n  });\n}\n\n/** Frees an ownership-transferred body buffer right after decoding it; the single-read window must never come through here.\n *  `transfer(0)` and not `transfer()`: measured on node 26, only `transfer(0)` releases the backing store there and then.\n *  Guarded because a future uWS could hand back a buffer that cannot be transferred, which must not fail the request. */\nfunction releaseAfterDecode(fullBody: ArrayBuffer): string {\n  const text = Buffer.from(fullBody).toString();\n  try {\n    (fullBody as ReleasableBuffer).transfer?.(0);\n  } catch {\n    // not transferable: the collector gets it instead, exactly as before\n  }\n  return text;\n}\n\n/** `transfer` is ES2024 and this package compiles against an ES2023 lib; optional because a runtime without it must work. */\ntype ReleasableBuffer = ArrayBuffer & {transfer?: (newByteLength?: number) => ArrayBuffer};\n\n// only called when there is an http error or weird unhandled route errors\nfunction fatalFail(res: HttpResponse, state: {aborted: boolean}, respHeaders: MionHeaders, error: RpcError<string>) {\n  const routeResponse = getRouterFatalErrorResponse(error, respHeaders);\n  reply(res, state, routeResponse);\n}\n\nfunction isHeaderSafe(text: string): boolean {\n  // one pass, no allocation: a CR, LF or NUL anywhere makes the header unsafe to write\n  for (let i = 0; i < text.length; i++) {\n    const code = text.charCodeAt(i);\n    if (code === 13 || code === 10 || code === 0) return false;\n  }\n  return true;\n}\n\n/** The line is a pure function of the code, so it is built once per code rather than per response. */\nconst statusLines = new Map<number, string>();\nfunction statusLine(statusCode: number): string {\n  const cached = statusLines.get(statusCode);\n  if (cached !== undefined) return cached;\n  const statusText = STATUS_CODES[statusCode];\n  const line = statusText ? `${statusCode} ${statusText}` : `${statusCode}`;\n  statusLines.set(statusCode, line);\n  return line;\n}\n\nfunction reply(res: HttpResponse, state: {aborted: boolean}, mionResp: MionResponse) {\n  // uWS freed the response when the client left; touching it would crash\n  if (state.aborted) return;\n  const headers = mionResp.headers as RecordResponseHeaders;\n\n  // serialized BEFORE the cork: uWS warns a cork buffer must not be held across event loop iterations\n  const payload = JSON.stringify(mionResp.body);\n\n  // cork makes one syscall; uWS headers are write-only and must all precede end().\n  // content-length is skipped: uWS writes its own, and a duplicate corrupts the response.\n  // uWS writes headers unchecked, so an echoed CR or LF would be header injection: dropped\n  const write = (name: string, value: string) => {\n    if (isHeaderSafe(value)) res.writeHeader(name, value);\n  };\n  res.cork(() => {\n    res.writeStatus(statusLine(mionResp.statusCode));\n    headers.forEach((name, value) => {\n      if (name === 'content-length' || name === 'content-type' || !isHeaderSafe(name)) return;\n      if (typeof value === 'string') write(name, value);\n      // RFC 6265 forbids folding set-cookie; uWS writes a repeated name as its own line\n      else if (name === 'set-cookie') for (const cookie of value) write(name, cookie);\n      else write(name, value.join(', '));\n    });\n    // last, and the store's own skipped above: uWS appends a repeated name instead of replacing it\n    res.writeHeader('content-type', mionResp.contentType);\n\n    res.end(payload);\n  });\n  releaseHeaders(headers);\n}\n"],"mappings":"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"}

package/.dist/cjs/src/uwsHttp.d.ts

@@ -1,12 +0,0 @@
-import { HttpRequest, HttpResponse, TemplatedApp, us_listen_socket } from '@mionjs/bin-uws';
-import { UwsHttpOptions } from './types.ts';
-export interface UwsServer {
-    app: TemplatedApp;
-    listenSocket: us_listen_socket;
-    close(): void;
-}
-export declare function resetUwsHttpOpts(): void;
-export declare function setUwsHttpOpts(options?: Partial<UwsHttpOptions>): Readonly<UwsHttpOptions>;
-export declare function startUwsServer(options?: Partial<UwsHttpOptions>): Promise<UwsServer>;
-export declare function uwsRequestHandler(res: HttpResponse, req: HttpRequest): void;
-//# sourceMappingURL=uwsHttp.d.ts.map