@morojs/moro 1.8.12 → 1.8.13

package/dist/core/http/utils/body-type.d.ts

@@ -0,0 +1,12 @@
+/**
+ * True when a request body with this Content-Type decodes to a string,
+ * false when it must stay a Buffer.
+ *
+ * Rule: a missing Content-Type keeps the historical string behaviour;
+ * `text/*` and anything declaring a `charset` are text; `application/*` is
+ * text for the JSON/XML/JS/YAML family (including `+json`-style suffixes);
+ * every other type (`application/octet-stream`, `image/*`, `audio/*`,
+ * `video/*`, `font/*`, `application/pdf`, `application/zip`, protobuf,
+ * msgpack, ...) is binary.
+ */
+export declare function bodyIsText(contentType: string | undefined): boolean;

package/dist/core/http/utils/body-type.js

@@ -0,0 +1,70 @@
+// Request-body text/binary classification, shared by the Node, uWS and native
+// engine servers so `req.body` has the same shape on every backend.
+//
+// JSON, urlencoded and multipart bodies are parsed into objects upstream of
+// this. For everything else the question is whether decoding the bytes as
+// UTF-8 is lossless: a text body arriving as a Buffer is one toString() away
+// from what the handler wanted, but a binary body decoded to a string is
+// corrupted for good (every invalid sequence becomes U+FFFD), and there is no
+// other way to reach the bytes. So the default for an unknown type is Buffer.
+/** application/* subtypes that are text on the wire */
+const TEXT_APPLICATION_SUBTYPES = new Set([
+    'json',
+    'xml',
+    'javascript',
+    'ecmascript',
+    'x-javascript',
+    'x-www-form-urlencoded',
+    'graphql',
+    'sql',
+    'yaml',
+    'x-yaml',
+    'toml',
+    'csv',
+    'ndjson',
+    'x-ndjson',
+    'jsonl',
+    'x-sh',
+    'xhtml',
+    'ld+json',
+    'problem+json',
+    'soap+xml',
+]);
+/** Structured-syntax suffixes (RFC 6838) that are always text */
+const TEXT_SUFFIXES = ['+json', '+xml', '+yaml', '+toml'];
+/**
+ * True when a request body with this Content-Type decodes to a string,
+ * false when it must stay a Buffer.
+ *
+ * Rule: a missing Content-Type keeps the historical string behaviour;
+ * `text/*` and anything declaring a `charset` are text; `application/*` is
+ * text for the JSON/XML/JS/YAML family (including `+json`-style suffixes);
+ * every other type (`application/octet-stream`, `image/*`, `audio/*`,
+ * `video/*`, `font/*`, `application/pdf`, `application/zip`, protobuf,
+ * msgpack, ...) is binary.
+ */
+export function bodyIsText(contentType) {
+    if (!contentType)
+        return true;
+    const semi = contentType.indexOf(';');
+    const mime = (semi === -1 ? contentType : contentType.slice(0, semi)).trim().toLowerCase();
+    if (mime === '')
+        return true;
+    if (mime.startsWith('text/'))
+        return true;
+    if (semi !== -1 && /;\s*charset=/i.test(contentType))
+        return true;
+    if (mime.startsWith('application/')) {
+        const subtype = mime.slice('application/'.length);
+        if (TEXT_APPLICATION_SUBTYPES.has(subtype))
+            return true;
+        for (const suffix of TEXT_SUFFIXES) {
+            if (subtype.endsWith(suffix))
+                return true;
+        }
+        return false;
+    }
+    // message/*, model/*, image/*, audio/*, video/*, font/*, ...
+    return false;
+}
+//# sourceMappingURL=body-type.js.map

package/dist/core/http/utils/body-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-type.js","sourceRoot":"","sources":["../../../../src/core/http/utils/body-type.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,oEAAoE;AACpE,EAAE;AACF,4EAA4E;AAC5E,0EAA0E;AAC1E,6EAA6E;AAC7E,yEAAyE;AACzE,8EAA8E;AAC9E,8EAA8E;AAE9E,uDAAuD;AACvD,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAC;IACxC,MAAM;IACN,KAAK;IACL,YAAY;IACZ,YAAY;IACZ,cAAc;IACd,uBAAuB;IACvB,SAAS;IACT,KAAK;IACL,MAAM;IACN,QAAQ;IACR,MAAM;IACN,KAAK;IACL,QAAQ;IACR,UAAU;IACV,OAAO;IACP,MAAM;IACN,OAAO;IACP,SAAS;IACT,cAAc;IACd,UAAU;CACX,CAAC,CAAC;AAEH,iEAAiE;AACjE,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CAAC,WAA+B;IACxD,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3F,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,IAAI,KAAK,CAAC,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IAClE,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAClD,IAAI,yBAAyB,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QACxD,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;YACnC,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC5C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,6DAA6D;IAC7D,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["// Request-body text/binary classification, shared by the Node, uWS and native\n// engine servers so `req.body` has the same shape on every backend.\n//\n// JSON, urlencoded and multipart bodies are parsed into objects upstream of\n// this. For everything else the question is whether decoding the bytes as\n// UTF-8 is lossless: a text body arriving as a Buffer is one toString() away\n// from what the handler wanted, but a binary body decoded to a string is\n// corrupted for good (every invalid sequence becomes U+FFFD), and there is no\n// other way to reach the bytes. So the default for an unknown type is Buffer.\n\n/** application/* subtypes that are text on the wire */\nconst TEXT_APPLICATION_SUBTYPES = new Set([\n  'json',\n  'xml',\n  'javascript',\n  'ecmascript',\n  'x-javascript',\n  'x-www-form-urlencoded',\n  'graphql',\n  'sql',\n  'yaml',\n  'x-yaml',\n  'toml',\n  'csv',\n  'ndjson',\n  'x-ndjson',\n  'jsonl',\n  'x-sh',\n  'xhtml',\n  'ld+json',\n  'problem+json',\n  'soap+xml',\n]);\n\n/** Structured-syntax suffixes (RFC 6838) that are always text */\nconst TEXT_SUFFIXES = ['+json', '+xml', '+yaml', '+toml'];\n\n/**\n * True when a request body with this Content-Type decodes to a string,\n * false when it must stay a Buffer.\n *\n * Rule: a missing Content-Type keeps the historical string behaviour;\n * `text/*` and anything declaring a `charset` are text; `application/*` is\n * text for the JSON/XML/JS/YAML family (including `+json`-style suffixes);\n * every other type (`application/octet-stream`, `image/*`, `audio/*`,\n * `video/*`, `font/*`, `application/pdf`, `application/zip`, protobuf,\n * msgpack, ...) is binary.\n */\nexport function bodyIsText(contentType: string | undefined): boolean {\n  if (!contentType) return true;\n  const semi = contentType.indexOf(';');\n  const mime = (semi === -1 ? contentType : contentType.slice(0, semi)).trim().toLowerCase();\n  if (mime === '') return true;\n  if (mime.startsWith('text/')) return true;\n  if (semi !== -1 && /;\\s*charset=/i.test(contentType)) return true;\n  if (mime.startsWith('application/')) {\n    const subtype = mime.slice('application/'.length);\n    if (TEXT_APPLICATION_SUBTYPES.has(subtype)) return true;\n    for (const suffix of TEXT_SUFFIXES) {\n      if (subtype.endsWith(suffix)) return true;\n    }\n    return false;\n  }\n  // message/*, model/*, image/*, audio/*, video/*, font/*, ...\n  return false;\n}\n"]}

package/dist/core/http/utils/ssl-config.d.ts

@@ -14,6 +14,14 @@ export interface SSLConfigInput {
     minVersion?: 'TLSv1.2' | 'TLSv1.3';
     requestCert?: boolean;
     rejectUnauthorized?: boolean;
+    /**
+     * Watch the key/cert (and CA) files and reload the certificate when they
+     * change (`app.reloadTLS()` under the hood), the way an ACME client rotates
+     * them. File-path shape only. `true` = 1000 ms debounce.
+     */
+    watch?: boolean | {
+        debounceMs?: number;
+    };
 }
 /** Canonical internal SSL config after normalization. */
 export interface NormalizedSSLConfig {
@@ -65,5 +73,8 @@ export declare function sslForUws(ssl: NormalizedSSLConfig): {
  * Project for the native @morojs/engine serve() options.ssl, which accepts
  * BOTH shapes (file paths and inline PEM) and prefers inline. Pass everything
  * through; the engine decides.
+ *
+ * The engine takes ONE CA per slot (`ca_file_name` / `ca`), so only the first
+ * CA of a list reaches it; the Node projection keeps the full list.
  */
 export declare function sslForEngine(ssl: NormalizedSSLConfig): Record<string, unknown>;

package/dist/core/http/utils/ssl-config.js

@@ -88,6 +88,9 @@ export function sslForUws(ssl) {
  * Project for the native @morojs/engine serve() options.ssl, which accepts
  * BOTH shapes (file paths and inline PEM) and prefers inline. Pass everything
  * through; the engine decides.
+ *
+ * The engine takes ONE CA per slot (`ca_file_name` / `ca`), so only the first
+ * CA of a list reaches it; the Node projection keeps the full list.
  */
 export function sslForEngine(ssl) {
     const out = {};

package/dist/core/http/utils/ssl-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"ssl-config.js","sourceRoot":"","sources":["../../../../src/core/http/utils/ssl-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAoClC,MAAM,OAAO,GAAG,CAAI,CAAsB,EAAmB,EAAE,CAC7D,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAAiC,EACjC,YAAoC,EACpC,MAAmB;IAEnB,IAAI,SAAS,IAAI,YAAY,EAAE,CAAC;QAC9B,MAAM,EAAE,IAAI,CAAC,wEAAwE,EAAE,KAAK,CAAC,CAAC;IAChG,CAAC;IACD,MAAM,GAAG,GAAG,SAAS,IAAI,YAAY,CAAC;IACtC,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAEtB,MAAM,GAAG,GAAwB;QAC/B,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,aAAa;QACzC,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,cAAc;QAC5C,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,YAAY,CAAC;QAC/C,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACnB,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,kBAAkB,EAAE,GAAG,CAAC,kBAAkB;KAC3C,CAAC;IAEF,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClD,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC,CAAC,4BAA4B;IAClE,OAAO,GAAG,CAAC;AACb,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,aAAa,CAAC,GAAwB;IACpD,OAAO,OAAO,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;AACzE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,GAAwB;IASjD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACjF,MAAM,EAAE,GAAG,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACrF,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,OAAO;QACL,GAAG;QACH,IAAI;QACJ,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QACjB,GAAG,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC;QACrD,GAAG,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC;QACrD,GAAG,CAAC,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC;QACtE,GAAG,CAAC,GAAG,CAAC,kBAAkB,KAAK,SAAS,IAAI;YAC1C,kBAAkB,EAAE,GAAG,CAAC,kBAAkB;SAC3C,CAAC;KACH,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,GAAwB;IAMhD,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC/C,OAAO;QACL,aAAa,EAAE,GAAG,CAAC,OAAO;QAC1B,cAAc,EAAE,GAAG,CAAC,QAAQ;QAC5B,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,GAAG,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC;KACtD,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAwB;IACnD,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,IAAI,GAAG,CAAC,OAAO;QAAE,GAAG,CAAC,aAAa,GAAG,GAAG,CAAC,OAAO,CAAC;IACjD,IAAI,GAAG,CAAC,QAAQ;QAAE,GAAG,CAAC,cAAc,GAAG,GAAG,CAAC,QAAQ,CAAC;IACpD,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QAAE,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAClE,IAAI,GAAG,CAAC,GAAG;QAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;IAC/B,IAAI,GAAG,CAAC,IAAI;QAAE,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IAClC,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAAE,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5C,IAAI,GAAG,CAAC,UAAU;QAAE,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;IACpD,IAAI,GAAG,CAAC,UAAU;QAAE,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;IACpD,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS;QAAE,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;IACrE,IAAI,GAAG,CAAC,kBAAkB,KAAK,SAAS;QAAE,GAAG,CAAC,kBAAkB,GAAG,GAAG,CAAC,kBAAkB,CAAC;IAC1F,OAAO,GAAG,CAAC;AACb,CAAC","sourcesContent":["/**\n * Unified SSL/TLS configuration.\n *\n * MoroJS historically carried TWO incompatible SSL shapes:\n *   - `config.server.ssl` = uWS-style file paths { key_file_name, cert_file_name, passphrase }\n *   - `options.https`      = node-style buffers    { key, cert, ca }\n * and each reached only one runtime (uWS / http2 respectively). This module\n * normalizes both into ONE internal shape and projects it back out for each\n * of the four servers (Node https, uWS SSLApp, HTTP/2, the native engine), so\n * a single `server.ssl` config flows everywhere.\n */\nimport { readFileSync } from 'fs';\nimport type { MoroLogger } from '../../logger/index.js';\n\n/** Raw, un-normalized SSL config as a user may supply it (either shape). */\nexport interface SSLConfigInput {\n  // File-path shape (uWS-style; also accepted node-style keyFile/certFile)\n  key_file_name?: string;\n  cert_file_name?: string;\n  ca_file_name?: string | string[];\n  keyFile?: string;\n  certFile?: string;\n  caFile?: string | string[];\n  // Inline shape (node-style)\n  key?: string | Buffer;\n  cert?: string | Buffer;\n  ca?: string | Buffer | Array<string | Buffer>;\n  passphrase?: string;\n  minVersion?: 'TLSv1.2' | 'TLSv1.3';\n  requestCert?: boolean;\n  rejectUnauthorized?: boolean;\n}\n\n/** Canonical internal SSL config after normalization. */\nexport interface NormalizedSSLConfig {\n  keyFile?: string | undefined;\n  certFile?: string | undefined;\n  caFile?: string[] | undefined;\n  key?: string | Buffer | undefined;\n  cert?: string | Buffer | undefined;\n  ca?: Array<string | Buffer> | undefined;\n  passphrase?: string | undefined;\n  minVersion?: 'TLSv1.2' | 'TLSv1.3' | undefined;\n  requestCert?: boolean | undefined;\n  rejectUnauthorized?: boolean | undefined;\n}\n\nconst toArray = <T>(v: T | T[] | undefined): T[] | undefined =>\n  v === undefined ? undefined : Array.isArray(v) ? v : [v];\n\n/**\n * Normalize the two historical SSL shapes into one. `serverSsl`\n * (config.server.ssl) wins over `optionsHttps` (options.https) when both are\n * present, matching the pre-existing precedence in framework.ts. Returns null\n * when neither carries any key/cert material (TLS simply off).\n */\nexport function normalizeSSLConfig(\n  serverSsl?: SSLConfigInput | null,\n  optionsHttps?: SSLConfigInput | null,\n  logger?: MoroLogger\n): NormalizedSSLConfig | null {\n  if (serverSsl && optionsHttps) {\n    logger?.warn('Both server.ssl and options.https are set; server.ssl takes precedence', 'SSL');\n  }\n  const src = serverSsl ?? optionsHttps;\n  if (!src) return null;\n\n  const out: NormalizedSSLConfig = {\n    keyFile: src.keyFile ?? src.key_file_name,\n    certFile: src.certFile ?? src.cert_file_name,\n    caFile: toArray(src.caFile ?? src.ca_file_name),\n    key: src.key,\n    cert: src.cert,\n    ca: toArray(src.ca),\n    passphrase: src.passphrase,\n    minVersion: src.minVersion,\n    requestCert: src.requestCert,\n    rejectUnauthorized: src.rejectUnauthorized,\n  };\n\n  const hasKey = Boolean(out.key || out.keyFile);\n  const hasCert = Boolean(out.cert || out.certFile);\n  if (!hasKey && !hasCert) return null; // nothing usable -> TLS off\n  return out;\n}\n\n/** True when the config actually carries a key+cert (complete TLS material). */\nexport function sslIsComplete(ssl: NormalizedSSLConfig): boolean {\n  return Boolean((ssl.key || ssl.keyFile) && (ssl.cert || ssl.certFile));\n}\n\n/**\n * Project for the Node http/https and HTTP/2 servers: node's tls API wants\n * key/cert/ca as strings or Buffers, so any file paths are read here.\n */\nexport function sslForNode(ssl: NormalizedSSLConfig): {\n  key: string | Buffer;\n  cert: string | Buffer;\n  ca?: Array<string | Buffer>;\n  passphrase?: string;\n  minVersion?: string;\n  requestCert?: boolean;\n  rejectUnauthorized?: boolean;\n} {\n  const key = ssl.key ?? (ssl.keyFile ? readFileSync(ssl.keyFile) : undefined);\n  const cert = ssl.cert ?? (ssl.certFile ? readFileSync(ssl.certFile) : undefined);\n  const ca = ssl.ca ?? (ssl.caFile ? ssl.caFile.map(p => readFileSync(p)) : undefined);\n  if (!key || !cert) {\n    throw new Error('sslForNode requires both a key and a certificate');\n  }\n  return {\n    key,\n    cert,\n    ...(ca && { ca }),\n    ...(ssl.passphrase && { passphrase: ssl.passphrase }),\n    ...(ssl.minVersion && { minVersion: ssl.minVersion }),\n    ...(ssl.requestCert !== undefined && { requestCert: ssl.requestCert }),\n    ...(ssl.rejectUnauthorized !== undefined && {\n      rejectUnauthorized: ssl.rejectUnauthorized,\n    }),\n  };\n}\n\n/**\n * Project for uWebSockets.js SSLApp, which requires FILE PATHS (it has no\n * inline-PEM option). Returns null when only inline PEM is available so the\n * caller can log a clear error instead of silently booting plain HTTP.\n */\nexport function sslForUws(ssl: NormalizedSSLConfig): {\n  key_file_name: string;\n  cert_file_name: string;\n  ca_file_name?: string;\n  passphrase?: string;\n} | null {\n  if (!ssl.keyFile || !ssl.certFile) return null;\n  return {\n    key_file_name: ssl.keyFile,\n    cert_file_name: ssl.certFile,\n    ...(ssl.caFile && ssl.caFile[0] && { ca_file_name: ssl.caFile[0] }),\n    ...(ssl.passphrase && { passphrase: ssl.passphrase }),\n  };\n}\n\n/**\n * Project for the native @morojs/engine serve() options.ssl, which accepts\n * BOTH shapes (file paths and inline PEM) and prefers inline. Pass everything\n * through; the engine decides.\n */\nexport function sslForEngine(ssl: NormalizedSSLConfig): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n  if (ssl.keyFile) out.key_file_name = ssl.keyFile;\n  if (ssl.certFile) out.cert_file_name = ssl.certFile;\n  if (ssl.caFile && ssl.caFile[0]) out.ca_file_name = ssl.caFile[0];\n  if (ssl.key) out.key = ssl.key;\n  if (ssl.cert) out.cert = ssl.cert;\n  if (ssl.ca && ssl.ca[0]) out.ca = ssl.ca[0];\n  if (ssl.passphrase) out.passphrase = ssl.passphrase;\n  if (ssl.minVersion) out.minVersion = ssl.minVersion;\n  if (ssl.requestCert !== undefined) out.requestCert = ssl.requestCert;\n  if (ssl.rejectUnauthorized !== undefined) out.rejectUnauthorized = ssl.rejectUnauthorized;\n  return out;\n}\n"]}
+{"version":3,"file":"ssl-config.js","sourceRoot":"","sources":["../../../../src/core/http/utils/ssl-config.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Unified SSL/TLS configuration.\n *\n * MoroJS historically carried TWO incompatible SSL shapes:\n *   - `config.server.ssl` = uWS-style file paths { key_file_name, cert_file_name, passphrase }\n *   - `options.https`      = node-style buffers    { key, cert, ca }\n * and each reached only one runtime (uWS / http2 respectively). This module\n * normalizes both into ONE internal shape and projects it back out for each\n * of the four servers (Node https, uWS SSLApp, HTTP/2, the native engine), so\n * a single `server.ssl` config flows everywhere.\n */\nimport { readFileSync } from 'fs';\nimport type { MoroLogger } from '../../logger/index.js';\n\n/** Raw, un-normalized SSL config as a user may supply it (either shape). */\nexport interface SSLConfigInput {\n  // File-path shape (uWS-style; also accepted node-style keyFile/certFile)\n  key_file_name?: string;\n  cert_file_name?: string;\n  ca_file_name?: string | string[];\n  keyFile?: string;\n  certFile?: string;\n  caFile?: string | string[];\n  // Inline shape (node-style)\n  key?: string | Buffer;\n  cert?: string | Buffer;\n  ca?: string | Buffer | Array<string | Buffer>;\n  passphrase?: string;\n  minVersion?: 'TLSv1.2' | 'TLSv1.3';\n  requestCert?: boolean;\n  rejectUnauthorized?: boolean;\n  /**\n   * Watch the key/cert (and CA) files and reload the certificate when they\n   * change (`app.reloadTLS()` under the hood), the way an ACME client rotates\n   * them. File-path shape only. `true` = 1000 ms debounce.\n   */\n  watch?: boolean | { debounceMs?: number };\n}\n\n/** Canonical internal SSL config after normalization. */\nexport interface NormalizedSSLConfig {\n  keyFile?: string | undefined;\n  certFile?: string | undefined;\n  caFile?: string[] | undefined;\n  key?: string | Buffer | undefined;\n  cert?: string | Buffer | undefined;\n  ca?: Array<string | Buffer> | undefined;\n  passphrase?: string | undefined;\n  minVersion?: 'TLSv1.2' | 'TLSv1.3' | undefined;\n  requestCert?: boolean | undefined;\n  rejectUnauthorized?: boolean | undefined;\n}\n\nconst toArray = <T>(v: T | T[] | undefined): T[] | undefined =>\n  v === undefined ? undefined : Array.isArray(v) ? v : [v];\n\n/**\n * Normalize the two historical SSL shapes into one. `serverSsl`\n * (config.server.ssl) wins over `optionsHttps` (options.https) when both are\n * present, matching the pre-existing precedence in framework.ts. Returns null\n * when neither carries any key/cert material (TLS simply off).\n */\nexport function normalizeSSLConfig(\n  serverSsl?: SSLConfigInput | null,\n  optionsHttps?: SSLConfigInput | null,\n  logger?: MoroLogger\n): NormalizedSSLConfig | null {\n  if (serverSsl && optionsHttps) {\n    logger?.warn('Both server.ssl and options.https are set; server.ssl takes precedence', 'SSL');\n  }\n  const src = serverSsl ?? optionsHttps;\n  if (!src) return null;\n\n  const out: NormalizedSSLConfig = {\n    keyFile: src.keyFile ?? src.key_file_name,\n    certFile: src.certFile ?? src.cert_file_name,\n    caFile: toArray(src.caFile ?? src.ca_file_name),\n    key: src.key,\n    cert: src.cert,\n    ca: toArray(src.ca),\n    passphrase: src.passphrase,\n    minVersion: src.minVersion,\n    requestCert: src.requestCert,\n    rejectUnauthorized: src.rejectUnauthorized,\n  };\n\n  const hasKey = Boolean(out.key || out.keyFile);\n  const hasCert = Boolean(out.cert || out.certFile);\n  if (!hasKey && !hasCert) return null; // nothing usable -> TLS off\n  return out;\n}\n\n/** True when the config actually carries a key+cert (complete TLS material). */\nexport function sslIsComplete(ssl: NormalizedSSLConfig): boolean {\n  return Boolean((ssl.key || ssl.keyFile) && (ssl.cert || ssl.certFile));\n}\n\n/**\n * Project for the Node http/https and HTTP/2 servers: node's tls API wants\n * key/cert/ca as strings or Buffers, so any file paths are read here.\n */\nexport function sslForNode(ssl: NormalizedSSLConfig): {\n  key: string | Buffer;\n  cert: string | Buffer;\n  ca?: Array<string | Buffer>;\n  passphrase?: string;\n  minVersion?: string;\n  requestCert?: boolean;\n  rejectUnauthorized?: boolean;\n} {\n  const key = ssl.key ?? (ssl.keyFile ? readFileSync(ssl.keyFile) : undefined);\n  const cert = ssl.cert ?? (ssl.certFile ? readFileSync(ssl.certFile) : undefined);\n  const ca = ssl.ca ?? (ssl.caFile ? ssl.caFile.map(p => readFileSync(p)) : undefined);\n  if (!key || !cert) {\n    throw new Error('sslForNode requires both a key and a certificate');\n  }\n  return {\n    key,\n    cert,\n    ...(ca && { ca }),\n    ...(ssl.passphrase && { passphrase: ssl.passphrase }),\n    ...(ssl.minVersion && { minVersion: ssl.minVersion }),\n    ...(ssl.requestCert !== undefined && { requestCert: ssl.requestCert }),\n    ...(ssl.rejectUnauthorized !== undefined && {\n      rejectUnauthorized: ssl.rejectUnauthorized,\n    }),\n  };\n}\n\n/**\n * Project for uWebSockets.js SSLApp, which requires FILE PATHS (it has no\n * inline-PEM option). Returns null when only inline PEM is available so the\n * caller can log a clear error instead of silently booting plain HTTP.\n */\nexport function sslForUws(ssl: NormalizedSSLConfig): {\n  key_file_name: string;\n  cert_file_name: string;\n  ca_file_name?: string;\n  passphrase?: string;\n} | null {\n  if (!ssl.keyFile || !ssl.certFile) return null;\n  return {\n    key_file_name: ssl.keyFile,\n    cert_file_name: ssl.certFile,\n    ...(ssl.caFile && ssl.caFile[0] && { ca_file_name: ssl.caFile[0] }),\n    ...(ssl.passphrase && { passphrase: ssl.passphrase }),\n  };\n}\n\n/**\n * Project for the native @morojs/engine serve() options.ssl, which accepts\n * BOTH shapes (file paths and inline PEM) and prefers inline. Pass everything\n * through; the engine decides.\n *\n * The engine takes ONE CA per slot (`ca_file_name` / `ca`), so only the first\n * CA of a list reaches it; the Node projection keeps the full list.\n */\nexport function sslForEngine(ssl: NormalizedSSLConfig): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n  if (ssl.keyFile) out.key_file_name = ssl.keyFile;\n  if (ssl.certFile) out.cert_file_name = ssl.certFile;\n  if (ssl.caFile && ssl.caFile[0]) out.ca_file_name = ssl.caFile[0];\n  if (ssl.key) out.key = ssl.key;\n  if (ssl.cert) out.cert = ssl.cert;\n  if (ssl.ca && ssl.ca[0]) out.ca = ssl.ca[0];\n  if (ssl.passphrase) out.passphrase = ssl.passphrase;\n  if (ssl.minVersion) out.minVersion = ssl.minVersion;\n  if (ssl.requestCert !== undefined) out.requestCert = ssl.requestCert;\n  if (ssl.rejectUnauthorized !== undefined) out.rejectUnauthorized = ssl.rejectUnauthorized;\n  return out;\n}\n"]}

package/dist/core/http/utils/uws-worker-clustering.js

@@ -10,7 +10,7 @@
 import { requireBuiltin } from '../../utilities/builtin.js';
 // worker_threads is loaded on first use (core/utilities/builtin.ts).
 const wt = () => requireBuiltin('worker_threads');
-import os from 'os';
+import { usableCpuCount, usableMemoryBytes } from '../../cluster/thread-cluster.js';
 import { createFrameworkLogger } from '../../logger/index.js';
 import { loadNativeEngine } from '../../utilities/package-utils.js';
 const logger = createFrameworkLogger('UWSClustering');
@@ -27,10 +27,11 @@ export class UWSWorkerClusterManager {
         this.workerCount = this.calculateWorkerCount();
     }
     calculateWorkerCount() {
-        let workerCount = this.config.workers || os.cpus().length;
+        // Container-aware counts (cgroup quota / affinity mask), not the host's
+        let workerCount = this.config.workers || usableCpuCount();
         if (workerCount === 'auto') {
-            const cpuCount = os.cpus().length;
-            const totalMemoryGB = os.totalmem() / (1024 * 1024 * 1024);
+            const cpuCount = usableCpuCount();
+            const totalMemoryGB = usableMemoryBytes() / (1024 * 1024 * 1024);
             let memoryPerWorkerGB = this.config.memoryPerWorkerGB;
             if (!memoryPerWorkerGB) {
                 const headroomGB = 4;

package/dist/core/http/utils/uws-worker-clustering.js.map

@@ -1 +1 @@
-{"version":3,"file":"uws-worker-clustering.js","sourceRoot":"","sources":["../../../../src/core/http/utils/uws-worker-clustering.ts"],"names":[],"mappings":"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","sourcesContent":["// uWebSockets.js Worker Thread Clustering Implementation\n// Uses worker threads with acceptor pattern for maximum performance\n//\n// NOTE: When terminating, you may see \"uv_loop_close() while having open handles\" warnings\n// from Node.js. This is a known limitation when using uWebSockets.js with worker threads.\n// The uWS C++ addon maintains internal libuv poll handles that cannot be cleanly closed\n// through JavaScript APIs. These warnings are harmless - the process will still exit cleanly.\n// To suppress these warnings, you can run Node.js with: --no-warnings or\n// NODE_NO_WARNINGS=1 environment variable.\n\nimport type { Worker } from 'worker_threads';\nimport { requireBuiltin } from '../../utilities/builtin.js';\n\n// worker_threads is loaded on first use (core/utilities/builtin.ts).\nconst wt = () => requireBuiltin<typeof import('worker_threads')>('worker_threads');\nimport os from 'os';\nimport { createFrameworkLogger } from '../../logger/index.js';\nimport { loadNativeEngine } from '../../utilities/package-utils.js';\n\nconst logger = createFrameworkLogger('UWSClustering');\n\nexport interface UWSClusterConfig {\n  workers?: number | 'auto';\n  memoryPerWorkerGB?: number;\n  port: number;\n  host?: string;\n  ssl?: {\n    key_file_name?: string;\n    cert_file_name?: string;\n    passphrase?: string;\n  };\n}\n\nexport class UWSWorkerClusterManager {\n  private workers: Worker[] = [];\n  private acceptorApp: any = null;\n  private acceptorListenSocket: any = null;\n  private uws: any = null;\n  private config: UWSClusterConfig;\n  private workerCount: number;\n  private isShuttingDown = false;\n\n  constructor(config: UWSClusterConfig) {\n    this.config = config;\n    this.workerCount = this.calculateWorkerCount();\n  }\n\n  private calculateWorkerCount(): number {\n    let workerCount = this.config.workers || os.cpus().length;\n\n    if (workerCount === 'auto') {\n      const cpuCount = os.cpus().length;\n      const totalMemoryGB = os.totalmem() / (1024 * 1024 * 1024);\n\n      let memoryPerWorkerGB = this.config.memoryPerWorkerGB;\n\n      if (!memoryPerWorkerGB) {\n        const headroomGB = 4;\n        memoryPerWorkerGB = Math.max(0.5, Math.floor((totalMemoryGB - headroomGB) / cpuCount));\n      }\n\n      workerCount = Math.min(cpuCount, Math.floor(totalMemoryGB / memoryPerWorkerGB));\n\n      logger.info(\n        `Auto-calculated worker count: ${workerCount} (CPU: ${cpuCount}, RAM: ${totalMemoryGB.toFixed(1)}GB, ${memoryPerWorkerGB}GB per worker)`,\n        'WorkerCalculation'\n      );\n    } else if (typeof workerCount === 'number') {\n      logger.info(`Using specified worker count: ${workerCount}`, 'WorkerCalculation');\n    }\n\n    return workerCount;\n  }\n\n  async startAcceptorAndWorkers(_appFactory: () => any): Promise<void> {\n    if (!wt().isMainThread) {\n      throw new Error('startAcceptorAndWorkers can only be called from main thread');\n    }\n\n    try {\n      // Worker clustering uses the uWS-shaped App/SSLApp + SO_REUSEPORT API,\n      // so it needs uWebSockets.js specifically (not @morojs/engine).\n      const engine = loadNativeEngine({ candidates: ['uWebSockets.js'] });\n      if (!engine) {\n        throw new Error('uWebSockets.js is not available for uWS worker clustering');\n      }\n      const uwsModule = engine.module;\n      this.uws = uwsModule.default || uwsModule;\n\n      // Create acceptor app - must match SSL config of worker apps\n      const ssl = this.config.ssl;\n      if (ssl && ssl.key_file_name && ssl.cert_file_name) {\n        this.acceptorApp = this.uws.SSLApp({\n          key_file_name: ssl.key_file_name,\n          cert_file_name: ssl.cert_file_name,\n          passphrase: ssl.passphrase,\n        });\n        logger.info('uWebSockets SSL acceptor app created', 'Acceptor');\n      } else {\n        this.acceptorApp = this.uws.App();\n        logger.info('uWebSockets acceptor app created', 'Acceptor');\n      }\n\n      // Start listening on acceptor\n      const port = this.config.port;\n      this.acceptorApp.listen(port, (token: any) => {\n        if (token) {\n          this.acceptorListenSocket = token;\n          logger.info(\n            `Acceptor listening on port ${port} from thread ${wt().threadId}`,\n            'Acceptor'\n          );\n        } else {\n          throw new Error(`Failed to listen on port ${port} from thread ${wt().threadId}`);\n        }\n      });\n\n      // Spawn workers\n      logger.info(`Starting ${this.workerCount} worker threads`, 'Workers');\n\n      for (let i = 0; i < this.workerCount; i++) {\n        await this.spawnWorker(i);\n      }\n\n      // Setup graceful shutdown\n      this.setupGracefulShutdown();\n    } catch (error) {\n      logger.error('Failed to start acceptor and workers', 'Startup', {\n        error: error instanceof Error ? error.message : String(error),\n      });\n      throw error;\n    }\n  }\n\n  private async spawnWorker(index: number): Promise<void> {\n    return new Promise((resolve, reject) => {\n      const scriptPath = process.argv[1];\n      if (scriptPath === undefined) {\n        reject(new Error('Cannot spawn worker: process.argv[1] (entry script) is unavailable'));\n        return;\n      }\n      const worker = new (wt().Worker)(scriptPath, {\n        workerData: {\n          isUWSWorker: true,\n          workerIndex: index,\n          config: this.config,\n        },\n        argv: process.argv.slice(2),\n        env: {\n          ...process.env,\n          UWS_WORKER_MODE: 'true',\n          UWS_WORKER_INDEX: String(index),\n        },\n      });\n\n      let descriptorReceived = false;\n\n      worker.on('message', (message: any) => {\n        if (message.type === 'descriptor' && message.descriptor) {\n          if (!this.acceptorApp) {\n            logger.error('Acceptor app not initialized', 'WorkerSpawn');\n            reject(new Error('Acceptor app not initialized'));\n            return;\n          }\n\n          try {\n            this.acceptorApp.addChildAppDescriptor(message.descriptor);\n            descriptorReceived = true;\n            logger.info(\n              `Worker ${index} (thread ${message.threadId}) registered with acceptor`,\n              'WorkerSpawn'\n            );\n            resolve();\n          } catch (error) {\n            logger.error('Failed to add child app descriptor', 'WorkerSpawn', {\n              error: error instanceof Error ? error.message : String(error),\n            });\n            reject(error);\n          }\n        } else if (message.type === 'error') {\n          logger.error(`Worker ${index} initialization error: ${message.error}`, 'WorkerSpawn');\n          reject(new Error(message.error));\n        }\n      });\n\n      worker.on('error', (error: Error) => {\n        logger.error(`Worker ${index} error`, 'Worker', {\n          error: error.message,\n        });\n        if (!descriptorReceived) {\n          reject(error);\n        }\n      });\n\n      worker.on('exit', (code: number) => {\n        // Worker threads don't have exitedAfterDisconnect like cluster workers\n        // Restart on any non-zero exit code\n        if (code !== 0) {\n          logger.warn(`Worker ${index} died unexpectedly (code: ${code}). Restarting...`, 'Worker');\n\n          // Remove from workers array\n          const workerIdx = this.workers.indexOf(worker);\n          if (workerIdx > -1) {\n            this.workers.splice(workerIdx, 1);\n          }\n\n          // Restart worker\n          this.spawnWorker(index).catch(error => {\n            logger.error('Failed to restart worker', 'Worker', {\n              error: error instanceof Error ? error.message : String(error),\n            });\n          });\n        }\n      });\n\n      this.workers.push(worker);\n\n      // Timeout for descriptor reception\n      setTimeout(() => {\n        if (!descriptorReceived) {\n          logger.error(`Worker ${index} failed to send descriptor within timeout`, 'WorkerSpawn');\n          void worker.terminate();\n          reject(new Error(`Worker ${index} initialization timeout`));\n        }\n      }, 10000); // 10 second timeout\n    });\n  }\n\n  private setupGracefulShutdown(): void {\n    const gracefulShutdown = async () => {\n      if (this.isShuttingDown) return;\n      this.isShuttingDown = true;\n\n      logger.info('Gracefully shutting down worker cluster...', 'Shutdown');\n\n      // Close acceptor listen socket first\n      if (this.acceptorListenSocket && this.uws) {\n        try {\n          this.uws.us_listen_socket_close(this.acceptorListenSocket);\n          this.acceptorListenSocket = null;\n          logger.info('Acceptor listen socket closed', 'Shutdown');\n        } catch (error) {\n          logger.error('Error closing acceptor socket', 'Shutdown', {\n            error: error instanceof Error ? error.message : String(error),\n          });\n        }\n      }\n\n      // Send shutdown message to all workers and wait for them to close\n      const shutdownPromises = this.workers.map((worker, index) => {\n        return new Promise<void>(resolve => {\n          let workerExited = false;\n\n          const timeout = setTimeout(() => {\n            if (!workerExited) {\n              logger.info(\n                `Worker ${index} taking too long to exit, terminating forcefully`,\n                'Shutdown'\n              );\n              try {\n                // Terminate is the last resort for stuck workers\n                void worker.terminate();\n              } catch {\n                logger.error(`Error terminating worker ${index}`, 'Shutdown');\n              }\n            }\n            resolve();\n          }, 2000); // Give 2 seconds for graceful exit\n\n          worker.once('exit', code => {\n            workerExited = true;\n            clearTimeout(timeout);\n            if (code === 0) {\n              logger.info(`Worker ${index} exited cleanly`, 'Shutdown');\n            } else if (code === 1) {\n              logger.info(`Worker ${index} terminated (exit code ${code})`, 'Shutdown');\n            } else {\n              logger.warn(`Worker ${index} exited with unexpected code ${code}`, 'Shutdown');\n            }\n            resolve();\n          });\n\n          // Send shutdown message\n          try {\n            worker.postMessage({ type: 'shutdown' });\n          } catch {\n            logger.error(`Failed to send shutdown message to worker ${index}`, 'Shutdown');\n            clearTimeout(timeout);\n            try {\n              void worker.terminate();\n            } catch {\n              // Ignore termination errors\n            }\n            resolve();\n          }\n        });\n      });\n\n      await Promise.all(shutdownPromises);\n      logger.info('All workers shut down', 'Shutdown');\n\n      // Clear acceptor app reference to allow uWebSockets to cleanup\n      if (this.acceptorApp) {\n        this.acceptorApp = null;\n      }\n\n      // Give uWebSockets event loop time to fully cleanup before exiting\n      await new Promise(resolve => setTimeout(resolve, 200));\n\n      logger.info('Shutdown complete', 'Shutdown');\n      process.exit(0);\n    };\n\n    process.on('SIGINT', () => void gracefulShutdown());\n    process.on('SIGTERM', () => void gracefulShutdown());\n  }\n\n  static isUWSWorker(): boolean {\n    return !wt().isMainThread && process.env.UWS_WORKER_MODE === 'true';\n  }\n\n  static async sendDescriptorToAcceptor(app: any): Promise<void> {\n    const { isMainThread, parentPort, threadId } = wt();\n    if (isMainThread || !parentPort) {\n      throw new Error('sendDescriptorToAcceptor can only be called from worker thread');\n    }\n\n    try {\n      const descriptor = app.getDescriptor();\n\n      parentPort.postMessage({\n        type: 'descriptor',\n        descriptor,\n        threadId,\n      });\n\n      logger.info(`Worker thread ${threadId} sent descriptor to acceptor`, 'Worker');\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : String(error);\n      logger.error('Failed to send descriptor to acceptor', 'Worker', { error: errorMessage });\n\n      if (parentPort) {\n        parentPort.postMessage({\n          type: 'error',\n          error: errorMessage,\n        });\n      }\n\n      throw error;\n    }\n  }\n\n  static setupWorkerShutdownHandler(closeCallback: () => void | Promise<void>): void {\n    const { parentPort, threadId } = wt();\n    if (!parentPort) {\n      return;\n    }\n\n    parentPort.on('message', (message: any) => {\n      void (async () => {\n        if (message.type === 'shutdown') {\n          logger.info(`Worker thread ${threadId} shutting down...`, 'Worker');\n\n          try {\n            // Call the close callback and wait if it's async\n            const result = closeCallback();\n            if (result && typeof result.then === 'function') {\n              await result;\n            }\n\n            // Give uWebSockets event loop time to fully cleanup\n            await new Promise(resolve => setTimeout(resolve, 150));\n\n            // Close parent port to signal we're ready to exit\n            if (parentPort) {\n              parentPort.close();\n            }\n\n            logger.info(`Worker thread ${threadId} cleanup complete`, 'Worker');\n\n            // DON'T call process.exit() - let Node.js exit naturally\n            // This allows the event loop to properly drain all uWebSockets handles\n            // The worker will exit on its own once all handles are closed\n          } catch (error) {\n            logger.error('Error during worker shutdown', 'Worker', {\n              error: error instanceof Error ? error.message : String(error),\n            });\n            // Still don't force exit - let it drain naturally\n          }\n        }\n      })();\n    });\n  }\n}\n"]}
+{"version":3,"file":"uws-worker-clustering.js","sourceRoot":"","sources":["../../../../src/core/http/utils/uws-worker-clustering.ts"],"names":[],"mappings":"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","sourcesContent":["// uWebSockets.js Worker Thread Clustering Implementation\n// Uses worker threads with acceptor pattern for maximum performance\n//\n// NOTE: When terminating, you may see \"uv_loop_close() while having open handles\" warnings\n// from Node.js. This is a known limitation when using uWebSockets.js with worker threads.\n// The uWS C++ addon maintains internal libuv poll handles that cannot be cleanly closed\n// through JavaScript APIs. These warnings are harmless - the process will still exit cleanly.\n// To suppress these warnings, you can run Node.js with: --no-warnings or\n// NODE_NO_WARNINGS=1 environment variable.\n\nimport type { Worker } from 'worker_threads';\nimport { requireBuiltin } from '../../utilities/builtin.js';\n\n// worker_threads is loaded on first use (core/utilities/builtin.ts).\nconst wt = () => requireBuiltin<typeof import('worker_threads')>('worker_threads');\nimport { usableCpuCount, usableMemoryBytes } from '../../cluster/thread-cluster.js';\nimport { createFrameworkLogger } from '../../logger/index.js';\nimport { loadNativeEngine } from '../../utilities/package-utils.js';\n\nconst logger = createFrameworkLogger('UWSClustering');\n\nexport interface UWSClusterConfig {\n  workers?: number | 'auto';\n  memoryPerWorkerGB?: number;\n  port: number;\n  host?: string;\n  ssl?: {\n    key_file_name?: string;\n    cert_file_name?: string;\n    passphrase?: string;\n  };\n}\n\nexport class UWSWorkerClusterManager {\n  private workers: Worker[] = [];\n  private acceptorApp: any = null;\n  private acceptorListenSocket: any = null;\n  private uws: any = null;\n  private config: UWSClusterConfig;\n  private workerCount: number;\n  private isShuttingDown = false;\n\n  constructor(config: UWSClusterConfig) {\n    this.config = config;\n    this.workerCount = this.calculateWorkerCount();\n  }\n\n  private calculateWorkerCount(): number {\n    // Container-aware counts (cgroup quota / affinity mask), not the host's\n    let workerCount = this.config.workers || usableCpuCount();\n\n    if (workerCount === 'auto') {\n      const cpuCount = usableCpuCount();\n      const totalMemoryGB = usableMemoryBytes() / (1024 * 1024 * 1024);\n\n      let memoryPerWorkerGB = this.config.memoryPerWorkerGB;\n\n      if (!memoryPerWorkerGB) {\n        const headroomGB = 4;\n        memoryPerWorkerGB = Math.max(0.5, Math.floor((totalMemoryGB - headroomGB) / cpuCount));\n      }\n\n      workerCount = Math.min(cpuCount, Math.floor(totalMemoryGB / memoryPerWorkerGB));\n\n      logger.info(\n        `Auto-calculated worker count: ${workerCount} (CPU: ${cpuCount}, RAM: ${totalMemoryGB.toFixed(1)}GB, ${memoryPerWorkerGB}GB per worker)`,\n        'WorkerCalculation'\n      );\n    } else if (typeof workerCount === 'number') {\n      logger.info(`Using specified worker count: ${workerCount}`, 'WorkerCalculation');\n    }\n\n    return workerCount;\n  }\n\n  async startAcceptorAndWorkers(_appFactory: () => any): Promise<void> {\n    if (!wt().isMainThread) {\n      throw new Error('startAcceptorAndWorkers can only be called from main thread');\n    }\n\n    try {\n      // Worker clustering uses the uWS-shaped App/SSLApp + SO_REUSEPORT API,\n      // so it needs uWebSockets.js specifically (not @morojs/engine).\n      const engine = loadNativeEngine({ candidates: ['uWebSockets.js'] });\n      if (!engine) {\n        throw new Error('uWebSockets.js is not available for uWS worker clustering');\n      }\n      const uwsModule = engine.module;\n      this.uws = uwsModule.default || uwsModule;\n\n      // Create acceptor app - must match SSL config of worker apps\n      const ssl = this.config.ssl;\n      if (ssl && ssl.key_file_name && ssl.cert_file_name) {\n        this.acceptorApp = this.uws.SSLApp({\n          key_file_name: ssl.key_file_name,\n          cert_file_name: ssl.cert_file_name,\n          passphrase: ssl.passphrase,\n        });\n        logger.info('uWebSockets SSL acceptor app created', 'Acceptor');\n      } else {\n        this.acceptorApp = this.uws.App();\n        logger.info('uWebSockets acceptor app created', 'Acceptor');\n      }\n\n      // Start listening on acceptor\n      const port = this.config.port;\n      this.acceptorApp.listen(port, (token: any) => {\n        if (token) {\n          this.acceptorListenSocket = token;\n          logger.info(\n            `Acceptor listening on port ${port} from thread ${wt().threadId}`,\n            'Acceptor'\n          );\n        } else {\n          throw new Error(`Failed to listen on port ${port} from thread ${wt().threadId}`);\n        }\n      });\n\n      // Spawn workers\n      logger.info(`Starting ${this.workerCount} worker threads`, 'Workers');\n\n      for (let i = 0; i < this.workerCount; i++) {\n        await this.spawnWorker(i);\n      }\n\n      // Setup graceful shutdown\n      this.setupGracefulShutdown();\n    } catch (error) {\n      logger.error('Failed to start acceptor and workers', 'Startup', {\n        error: error instanceof Error ? error.message : String(error),\n      });\n      throw error;\n    }\n  }\n\n  private async spawnWorker(index: number): Promise<void> {\n    return new Promise((resolve, reject) => {\n      const scriptPath = process.argv[1];\n      if (scriptPath === undefined) {\n        reject(new Error('Cannot spawn worker: process.argv[1] (entry script) is unavailable'));\n        return;\n      }\n      const worker = new (wt().Worker)(scriptPath, {\n        workerData: {\n          isUWSWorker: true,\n          workerIndex: index,\n          config: this.config,\n        },\n        argv: process.argv.slice(2),\n        env: {\n          ...process.env,\n          UWS_WORKER_MODE: 'true',\n          UWS_WORKER_INDEX: String(index),\n        },\n      });\n\n      let descriptorReceived = false;\n\n      worker.on('message', (message: any) => {\n        if (message.type === 'descriptor' && message.descriptor) {\n          if (!this.acceptorApp) {\n            logger.error('Acceptor app not initialized', 'WorkerSpawn');\n            reject(new Error('Acceptor app not initialized'));\n            return;\n          }\n\n          try {\n            this.acceptorApp.addChildAppDescriptor(message.descriptor);\n            descriptorReceived = true;\n            logger.info(\n              `Worker ${index} (thread ${message.threadId}) registered with acceptor`,\n              'WorkerSpawn'\n            );\n            resolve();\n          } catch (error) {\n            logger.error('Failed to add child app descriptor', 'WorkerSpawn', {\n              error: error instanceof Error ? error.message : String(error),\n            });\n            reject(error);\n          }\n        } else if (message.type === 'error') {\n          logger.error(`Worker ${index} initialization error: ${message.error}`, 'WorkerSpawn');\n          reject(new Error(message.error));\n        }\n      });\n\n      worker.on('error', (error: Error) => {\n        logger.error(`Worker ${index} error`, 'Worker', {\n          error: error.message,\n        });\n        if (!descriptorReceived) {\n          reject(error);\n        }\n      });\n\n      worker.on('exit', (code: number) => {\n        // Worker threads don't have exitedAfterDisconnect like cluster workers\n        // Restart on any non-zero exit code\n        if (code !== 0) {\n          logger.warn(`Worker ${index} died unexpectedly (code: ${code}). Restarting...`, 'Worker');\n\n          // Remove from workers array\n          const workerIdx = this.workers.indexOf(worker);\n          if (workerIdx > -1) {\n            this.workers.splice(workerIdx, 1);\n          }\n\n          // Restart worker\n          this.spawnWorker(index).catch(error => {\n            logger.error('Failed to restart worker', 'Worker', {\n              error: error instanceof Error ? error.message : String(error),\n            });\n          });\n        }\n      });\n\n      this.workers.push(worker);\n\n      // Timeout for descriptor reception\n      setTimeout(() => {\n        if (!descriptorReceived) {\n          logger.error(`Worker ${index} failed to send descriptor within timeout`, 'WorkerSpawn');\n          void worker.terminate();\n          reject(new Error(`Worker ${index} initialization timeout`));\n        }\n      }, 10000); // 10 second timeout\n    });\n  }\n\n  private setupGracefulShutdown(): void {\n    const gracefulShutdown = async () => {\n      if (this.isShuttingDown) return;\n      this.isShuttingDown = true;\n\n      logger.info('Gracefully shutting down worker cluster...', 'Shutdown');\n\n      // Close acceptor listen socket first\n      if (this.acceptorListenSocket && this.uws) {\n        try {\n          this.uws.us_listen_socket_close(this.acceptorListenSocket);\n          this.acceptorListenSocket = null;\n          logger.info('Acceptor listen socket closed', 'Shutdown');\n        } catch (error) {\n          logger.error('Error closing acceptor socket', 'Shutdown', {\n            error: error instanceof Error ? error.message : String(error),\n          });\n        }\n      }\n\n      // Send shutdown message to all workers and wait for them to close\n      const shutdownPromises = this.workers.map((worker, index) => {\n        return new Promise<void>(resolve => {\n          let workerExited = false;\n\n          const timeout = setTimeout(() => {\n            if (!workerExited) {\n              logger.info(\n                `Worker ${index} taking too long to exit, terminating forcefully`,\n                'Shutdown'\n              );\n              try {\n                // Terminate is the last resort for stuck workers\n                void worker.terminate();\n              } catch {\n                logger.error(`Error terminating worker ${index}`, 'Shutdown');\n              }\n            }\n            resolve();\n          }, 2000); // Give 2 seconds for graceful exit\n\n          worker.once('exit', code => {\n            workerExited = true;\n            clearTimeout(timeout);\n            if (code === 0) {\n              logger.info(`Worker ${index} exited cleanly`, 'Shutdown');\n            } else if (code === 1) {\n              logger.info(`Worker ${index} terminated (exit code ${code})`, 'Shutdown');\n            } else {\n              logger.warn(`Worker ${index} exited with unexpected code ${code}`, 'Shutdown');\n            }\n            resolve();\n          });\n\n          // Send shutdown message\n          try {\n            worker.postMessage({ type: 'shutdown' });\n          } catch {\n            logger.error(`Failed to send shutdown message to worker ${index}`, 'Shutdown');\n            clearTimeout(timeout);\n            try {\n              void worker.terminate();\n            } catch {\n              // Ignore termination errors\n            }\n            resolve();\n          }\n        });\n      });\n\n      await Promise.all(shutdownPromises);\n      logger.info('All workers shut down', 'Shutdown');\n\n      // Clear acceptor app reference to allow uWebSockets to cleanup\n      if (this.acceptorApp) {\n        this.acceptorApp = null;\n      }\n\n      // Give uWebSockets event loop time to fully cleanup before exiting\n      await new Promise(resolve => setTimeout(resolve, 200));\n\n      logger.info('Shutdown complete', 'Shutdown');\n      process.exit(0);\n    };\n\n    process.on('SIGINT', () => void gracefulShutdown());\n    process.on('SIGTERM', () => void gracefulShutdown());\n  }\n\n  static isUWSWorker(): boolean {\n    return !wt().isMainThread && process.env.UWS_WORKER_MODE === 'true';\n  }\n\n  static async sendDescriptorToAcceptor(app: any): Promise<void> {\n    const { isMainThread, parentPort, threadId } = wt();\n    if (isMainThread || !parentPort) {\n      throw new Error('sendDescriptorToAcceptor can only be called from worker thread');\n    }\n\n    try {\n      const descriptor = app.getDescriptor();\n\n      parentPort.postMessage({\n        type: 'descriptor',\n        descriptor,\n        threadId,\n      });\n\n      logger.info(`Worker thread ${threadId} sent descriptor to acceptor`, 'Worker');\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : String(error);\n      logger.error('Failed to send descriptor to acceptor', 'Worker', { error: errorMessage });\n\n      if (parentPort) {\n        parentPort.postMessage({\n          type: 'error',\n          error: errorMessage,\n        });\n      }\n\n      throw error;\n    }\n  }\n\n  static setupWorkerShutdownHandler(closeCallback: () => void | Promise<void>): void {\n    const { parentPort, threadId } = wt();\n    if (!parentPort) {\n      return;\n    }\n\n    parentPort.on('message', (message: any) => {\n      void (async () => {\n        if (message.type === 'shutdown') {\n          logger.info(`Worker thread ${threadId} shutting down...`, 'Worker');\n\n          try {\n            // Call the close callback and wait if it's async\n            const result = closeCallback();\n            if (result && typeof result.then === 'function') {\n              await result;\n            }\n\n            // Give uWebSockets event loop time to fully cleanup\n            await new Promise(resolve => setTimeout(resolve, 150));\n\n            // Close parent port to signal we're ready to exit\n            if (parentPort) {\n              parentPort.close();\n            }\n\n            logger.info(`Worker thread ${threadId} cleanup complete`, 'Worker');\n\n            // DON'T call process.exit() - let Node.js exit naturally\n            // This allows the event loop to properly drain all uWebSockets handles\n            // The worker will exit on its own once all handles are closed\n          } catch (error) {\n            logger.error('Error during worker shutdown', 'Worker', {\n              error: error instanceof Error ? error.message : String(error),\n            });\n            // Still don't force exit - let it drain naturally\n          }\n        }\n      })();\n    });\n  }\n}\n"]}

package/dist/core/http/uws-http-server.d.ts

@@ -18,6 +18,9 @@ export declare class UwsRequest extends LazyEventEmitter {
     params: Record<string, string>;
     body: any;
     ip: string;
+    _rawBody: Buffer | undefined;
+    /** The request body exactly as received, before any parsing; null when empty. */
+    get rawBody(): Buffer | null;
     _server: UWebSocketsHttpServer;
     _uwsReq: any;
     _queryString: string | null;

package/dist/core/http/uws-http-server.js

@@ -7,6 +7,7 @@ import { parseMultipart as parseMultipartBuffer, } from './utils/multipart-parse
 import { LazyEventEmitter } from './utils/lazy-event-emitter.js';
 import { parseRawQueryString } from './utils/query-parser.js';
 import { resolveCompressionSettings, compressBuffer, isCompressible, negotiateEncoding, } from './utils/compression.js';
+import { bodyIsText } from './utils/body-type.js';
 // Back-compat alias (this parser is now the transport-neutral one in utils/)
 const parseUwsQueryString = parseRawQueryString;
 /**
@@ -25,6 +26,11 @@ export class UwsRequest extends LazyEventEmitter {
     params = {};
     body = null;
     ip = '';
+    _rawBody = undefined;
+    /** The request body exactly as received, before any parsing; null when empty. */
+    get rawBody() {
+        return this._rawBody ?? null;
+    }
     _server;
     _uwsReq; // valid ONLY synchronously inside the uWS route callback
     _queryString;
@@ -1557,9 +1563,24 @@ export class UWebSocketsHttpServer {
                         const stable = buffer === view ? Buffer.from(buffer) : buffer;
                         httpReq.body = parseMultipartBuffer(stable, contentType, this.multipartLimits);
                     }
-                    else {
+                    else if (bodyIsText(contentType)) {
                         httpReq.body = buffer.toString('utf-8');
                     }
+                    else {
+                        // Binary stays a Buffer. The single-chunk fast path aliases
+                        // uWS-owned memory that is recycled after this callback, so a
+                        // Buffer that outlives it must be a copy.
+                        httpReq.body = buffer === view ? Buffer.from(buffer) : buffer;
+                    }
+                    // Raw bytes for signature checks: reuse the stable binary copy when
+                    // one was made, otherwise copy out of uWS-owned memory now.
+                    if (totalLength > 0) {
+                        httpReq._rawBody = Buffer.isBuffer(httpReq.body)
+                            ? httpReq.body
+                            : buffer === view
+                                ? Buffer.from(buffer)
+                                : buffer;
+                    }
                     finish(resolve);
                 }
                 catch (parseError) {