@mionjs/platform-uws 0.0.0-stage → 0.13.0

package/.dist/cjs/index.cjs

@@ -0,0 +1,8 @@
+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

@@ -0,0 +1,4 @@
+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

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

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

@@ -0,0 +1,11 @@
+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

@@ -0,0 +1 @@
+{"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

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

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

@@ -0,0 +1,16 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,4 @@
+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

@@ -0,0 +1,8 @@
+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

@@ -0,0 +1,224 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,12 @@
+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

package/.dist/esm/index.d.ts

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

package/.dist/esm/index.js

@@ -0,0 +1,3 @@
+import { DEFAULT_UWS_HTTP_OPTIONS } from "./src/constants.js";
+import { resetUwsHttpOpts, setUwsHttpOpts, startUwsServer, uwsRequestHandler } from "./src/uwsHttp.js";
+export { DEFAULT_UWS_HTTP_OPTIONS, resetUwsHttpOpts, setUwsHttpOpts, startUwsServer, uwsRequestHandler };

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

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

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

@@ -0,0 +1,11 @@
+import { DEFAULT_MAX_BODY_SIZE } from "@mionjs/core";
+//#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: DEFAULT_MAX_BODY_SIZE
+};
+//#endregion
+export { DEFAULT_UWS_HTTP_OPTIONS };
+
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,4 @@
+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/esm/src/headers.js

@@ -0,0 +1,15 @@
+import { headersFromRecord } from "@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 headersFromRecord(record, true);
+}
+//#endregion
+export { headersFromUwsRequest };
+
+//# sourceMappingURL=headers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"headers.js","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,OAAO,kBAAkB,QAAQ,IAAI;AACvC"}

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

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

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

@@ -0,0 +1,12 @@
+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

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

@@ -0,0 +1,220 @@
+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 { STATUS_CODES } from "http";
+import { loadUws } from "@mionjs/bin-uws";
+import { FatalError, SerializerModes, getENV } from "@mionjs/core";
+//#region src/uwsHttp.ts
+var httpOptions = { ...DEFAULT_UWS_HTTP_OPTIONS };
+var UWS_MAX_SINGLE_READ = 524288;
+function resetUwsHttpOpts() {
+	httpOptions = { ...DEFAULT_UWS_HTTP_OPTIONS };
+	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 = getENV("NODE_ENV") === "test";
+	if (options) setUwsHttpOpts(options);
+	if (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 = 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;
+			}
+			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 = headersFromUwsRequest(req);
+	const respHeaders = getDefaultHeaders();
+	res.onAborted(() => {
+		state.aborted = true;
+	});
+	const rawRequest = {
+		path,
+		urlQuery,
+		headers: reqHeaders
+	};
+	let chain;
+	try {
+		chain = resolveExecutionChain(path, urlQuery, rawRequest);
+	} catch (err) {
+		drainRequestBody(res);
+		state.replied = true;
+		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);
+		let dispatched;
+		try {
+			dispatched = 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, 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(dispatchPlatformError(chain, path, urlQuery, 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 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, 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 = 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);
+	});
+	releaseHeaders(headers);
+}
+//#endregion
+export { resetUwsHttpOpts, setUwsHttpOpts, startUwsServer, uwsRequestHandler };
+
+//# sourceMappingURL=uwsHttp.js.map

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

@@ -0,0 +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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"}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ma Jerez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,27 @@
-# Temporary Holding Version
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/MionKit/mion/main/assets/public/bannerx90-dark.png">
+    <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/MionKit/mion/main/assets/public/bannerx90.png">
+    <img alt='mion, a mikro kit for Typescript Serverless APIs' src='https://raw.githubusercontent.com/MionKit/mion/main/assets/public/bannerx90.png'>
+  </picture>
+</p>
+<p align="center">
+  <strong>Full Stack APIs at the speed of light 🚀
+  </strong>
+</p>
+<p align=center>
+  <img src="https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square&maxAge=99999999" alt="npm"  style="max-width:100%;">
+  <img src="https://img.shields.io/badge/license-MIT-97ca00.svg?style=flat-square&maxAge=99999999" alt="npm"  style="max-width:100%;">
+</p>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# `@mionjs/platform-uws`
+
+This package contains a [uWebSockets.js](https://github.com/uNetworking/uWebSockets.js) server to run mion APIs at maximum performance! The native uWS binaries install automatically via `@mionjs/bin-uws` (per-platform optional dependencies), so a plain npm install just works. Runs on the Node.js versions uWebSockets.js ships binaries for.
+
+## Check Out The [Website And Documentation](http://mion.io) 📚
+
+[![mion-website-banner](https://raw.githubusercontent.com/MionKit/mion/main/assets/public/mion-website-banner.png)](http://mion.io)
+
+---
+
+_[MIT](../../LICENSE) LICENSE_

package/package.json

@@ -1,6 +1,67 @@
 {
   "name": "@mionjs/platform-uws",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.13.0",
+  "type": "module",
+  "description": "mion HTTP Server on uWebSockets.js for maximum performance.",
+  "keywords": [
+    "typescript",
+    "API",
+    "RPC",
+    "json",
+    "schema",
+    "generate",
+    "server",
+    "serverless",
+    "framework",
+    "uWebSockets",
+    "uws"
+  ],
+  "author": "ma jerez",
+  "homepage": "https://mion.io/",
+  "license": "MIT",
+  "exports": {
+    ".": {
+      "types": "./.dist/esm/index.d.ts",
+      "require": "./.dist/cjs/index.cjs",
+      "default": "./.dist/esm/index.js"
+    }
+  },
+  "directories": {
+    "lib": ".dist"
+  },
+  "files": [
+    ".dist",
+    "!.dist/**/*.tsbuildinfo",
+    "!.dist/**/*.d.ts.map"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MionKit/mion.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bugs": {
+    "url": "https://github.com/MionKit/mion/issues"
+  },
+  "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"
+  },
+  "dependencies": {
+    "@mionjs/core": "0.13.0",
+    "@mionjs/router": "0.13.0",
+    "@mionjs/bin-uws": "0.13.0"
+  },
+  "scripts": {
+    "typecheck:test": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "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"
+  }
 }