@ublitzjs/core 1.0.0 → 1.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+(The MIT License)
+
+Copyright (c) 2025-2026 Daniel Dyryl <diril656@gmail.com>
+
+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

@@ -10,12 +10,14 @@ On NPM you can find such packages: (with @ublitzjs/ organization)
 - static (send files)
 - payload (handling POST-like requests)
 - router (OpenAPI-like router for simple orientation)
-- openapi
+- openapi 
 - preprocess (Code preprocessing + templating framework)
 - asyncapi
 - testing (coming soon)
 - auth (coming soon)
 
+The ones having version < 1.0.0 are unstable.
+
 # Installation
 
 ```ps1

package/dist/cjs/http-codes.js

@@ -1,5 +1,8 @@
 "use strict";
 
+/**
+* Yes, I have just deprecated the whole category. It will be completely removed in 2.0.0. When is it coming? Who knows
+* */
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
@@ -10,19 +13,16 @@ exports.notFoundConstructor = notFoundConstructor;
 exports.seeOtherMethods = seeOtherMethods;
 exports.tooLargeBody = tooLargeBody;
 var _index = require("./index.js");
-var c405Message = (0, _index.toAB)("Method is not allowed");
-var allowHeader = (0, _index.toAB)("Allow");
-var checkHeader = (0, _index.toAB)("content-length");
-var checkMessage = (0, _index.toAB)("Content-Length is required to be > 0 and to be an integer");
 /**
- * If something wrong is to content-length, sends 411 code and throws error with a "cause" == { CL : string}, sets res.finished = true
+ * @deprecated
+ * uWS actually checks content-length by itself
  */
 function checkContentLength(res, req) {
-  var header = req.getHeader(checkHeader);
+  var header = req.getHeader("content-length");
   var CL;
   if (!header || !Number.isInteger(CL = Number(header))) {
     res.finished = true;
-    res.cork(() => res.writeStatus(c411).end(checkMessage));
+    res.cork(() => res.writeStatus("411").end("Content-Length is required to be > 0 and to be an integer"));
     throw new Error("Wrong content-length", {
       cause: {
         CL: header
@@ -32,26 +32,27 @@ function checkContentLength(res, req) {
   return CL;
 }
 /**
- * sends http 400 and throws an Error with "causeForYou", sets res.finished = true
+ * @deprecated
+ * This function throws, so it is slow.
  */
 function badRequest(res, error, causeForYou) {
   res.finished = true;
-  if (!res.aborted) res.cork(() => res.writeStatus(c400).end((0, _index.toAB)(error)));
+  if (!res.aborted) res.cork(() => res.writeStatus("400").end((0, _index.toAB)(error)));
   throw new Error("Bad request", {
     cause: causeForYou
   });
 }
 /**
- * sends http 413, but doesn't throw an Error, sets res.finished = true
+ * @deprecated
+ * These are 2 lines of code.
  */
 function tooLargeBody(res, limit) {
-  var message = (0, _index.toAB)("Body is too large. Limit in bytes - " + limit);
-  if (!res.aborted) res.cork(() => res.writeStatus(c413).end(message));
+  if (!res.aborted) res.cork(() => res.writeStatus("413").end("Body is too large. Limit in bytes - " + limit));
   res.finished = true;
 }
 /**
- * Constructs function, which sends http 405 and sets http Allow header with all methods you passed.
- * It ignores "ws" and replaces "del" on "DELETE"
+ * @deprecated
+ * use "typedAllowHeader" instead
  */
 function seeOtherMethods(methodsArr) {
   if (new Set(methodsArr).size != methodsArr.length) throw new Error("the methods repeat");
@@ -68,32 +69,38 @@ function seeOtherMethods(methodsArr) {
     }
   }
   var methods = (0, _index.toAB)(arr.join(", "));
-  return res => res.writeStatus(c405).writeHeader(allowHeader, methods).end(c405Message);
+  return res => res.writeStatus("405").writeHeader("Allow", methods).end("Method is not allowed");
 }
 /**
- * Constructs the function, which sets 404 http code and sends the message you have specified
+ * @deprecated
+ * This is 1-2 lines of code
  */
 function notFoundConstructor(message = "Not found") {
   var mes = (0, _index.toAB)(message);
-  return res => res.writeStatus(c404).end(mes, true);
+  return res => res.writeStatus("404").end(mes, true);
 }
 /**
+ * @deprecated
  * code: required content length
  */
 var c411 = exports.c411 = (0, _index.toAB)("411");
 /**
+ * @deprecated
  * code: bad request
  */
 var c400 = exports.c400 = (0, _index.toAB)("400");
 /**
+ * @deprecated
  * code: payload too large
  */
 var c413 = exports.c413 = (0, _index.toAB)("413");
 /**
+ * @deprecated
  * code: method not allowed
  */
 var c405 = exports.c405 = (0, _index.toAB)("405");
 /**
+ * @deprecated
  * code: not found
  */
 var c404 = exports.c404 = (0, _index.toAB)("404");

package/dist/cjs/http-headers.js

@@ -3,10 +3,13 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.HeadersMap = exports.CSPDirs = void 0;
+exports.helmentHeaders = exports.HeadersMap = exports.CSPDirs = void 0;
+exports.parseRange = parseRange;
 exports.setCSP = setCSP;
+exports.staticHeaders = staticHeaders;
+exports.typedAllowHeader = typedAllowHeader;
 var _index = require("./index.js");
-var helmetHeaders = {
+var helmentHeaders = exports.helmentHeaders = {
   "X-Content-Type-Options": "nosniff",
   "X-DNS-Prefetch-Control": "off",
   "X-Frame-Options": "DENY",
@@ -17,14 +20,41 @@ var helmetHeaders = {
   "Cross-Origin-Opener-Policy": "same-origin",
   "Cross-Origin-Embedder-Policy": "require-corp",
   "Origin-Agent-Cluster": "?1"
-  //"Content-Security-Policy-Report-Only":"",
-  //"Strict-Transport-Security":`max-age=${60 * 60 * 24 * 365}; includeSubDomains`,
 };
 /**
- * A map containing all headers as ArrayBuffers, so speed remains. There are several use cases of it:
- * 1) Don't define them in requests ( post(res){new HeadersMap({...headers}).prepare().toRes(res)} ). This is slow. Define maps BEFORE actual usage.
- * 2) You can pass them in LightMethod or HeavyMethod in shared property (but handle it manually)
- * 3) Don't define them before writing status on request. uWebSockets.js after first written header considers response as successful and puts "200" code automatically. Set headers AFTER validation in class controllers (handler function) and after writing status (or don't write it at all. It will be 200).
+* This function is created as a replacement for "HeadersMap" (which became deprecated in 1.1.0).
+* The most overhead when sending request doesn't come from utf16 -> utf8 conversion, but from many subsequent res.writeHeader, which is JS->C++ switch.
+* To reduce an amount of calling headers, you can use manual string concatenation and HTTP header separator - CRLF.
+* @notice this function doesn't create completely ready data to send. Look a the example below
+* @notice2 its return-type LIES. In fact it is just a concatenated string, but TS lies just for LSP help for the second param and, as a result, last header, value to which should be written in res.writeHeader
+* @example
+* //if all headers don't change
+* var headers = staticHeaders({
+*   "Content-Type": "text/plain"
+* }, "Etag") // However "Etag" doesn't have value yet
+* * var littleFasterHeaders = Buffer.from(headers)
+* server.get("/", (res)=>{
+*   // we put ETag's value to the right. This way we can combine static + dynamic headers in one single call
+*   res.writeHeader(littleFasterHeaders, 'W/"' + 123 + '"')
+*   res.end("ok")
+*
+*  // underneath this is the same (gain speed but lose TypeScript. Not bad if your head is a compiler)
+*  res.writeHeader("Content-Type: text/plain\r\nETag", 'W/"' + 123 + '"')
+*  // you can make right side look same as well
+*  res.writeHeader<string>("Content-Type", 'text/plain\r\nETag: W/"' + 123 + '"')
+* })
+*
+* */
+function staticHeaders(headers, likelyDynamicHeader) {
+  var result = "";
+  for (var key in headers) {
+    result += key + ": " + headers[key] + "\r\n";
+  }
+  return result += likelyDynamicHeader;
+}
+/**
+ * @deprecated because using ArrayBuffers vs strings in headers doesn't bring much benefit, as it turned out after some benchmarks (+ it uses Map class, so that's even slower). It is going to be removed in 2.0.0. When is it coming? Who knows.
+ * And YES, I removed description of it. Stick to "staticHeaders" or CRLF manipulations
  */
 class HeadersMap extends Map {
   currentHeaders;
@@ -69,7 +99,7 @@ class HeadersMap extends Map {
    * @example
    * new HeadersMap({...HeadersMap.baseObj, "ownHeader":"hello world"}).remove("X-Download-Options")
    */
-  static baseObj = helmetHeaders;
+  static baseObj = helmentHeaders;
   /**
    * this is same as "toRes", but it uses HeadersMap.baseObj
    */
@@ -94,8 +124,6 @@ function setCSP(mainCSP, ...remove) {
  * Usual CSP directories. If you want more dirs:
  * 1) I will put more in soon
  * 2) use string concatenation (use BASE)
- * @example
- * new HeadersMap({...HeadersMap.baseObj, "Content-Security-Policy":setCSP({...CSPDirs}) + " your-dir: 'self';"})
  */
 var CSPDirs = exports.CSPDirs = {
   "default-src": ["'self'"],
@@ -115,4 +143,64 @@ var CSPDirs = exports.CSPDirs = {
   "trusted-types": ["'none'"],
   "worker-src": ["'self'"],
   "media-src": ["'self'"]
-};
+};
+var badRange = {
+  ok: false,
+  code: "400"
+};
+/**
+* "Range" http header requires validation, so here you get it
+* @example
+* var data = Buffer.allocUnsafe(1024*1024)
+* server.get("/largeData", (res, req)=>{
+*   var range = req.getHeader("range")
+*   if(!range) return res.end(data)
+*   // so parseRange might modify "range" to suit requirements + check if header is right
+*   var parsedRange = parseRange(range, data.length - 1, 64*1024)
+*   // might be
+*   if(!parsedRange.ok) return res.writeStatus(parsedRange.code).end("bad")
+* })
+* */
+function parseRange(range, maxEnd, maxChunk) {
+  if (range.length == 7 || range.slice(0, 6) != "bytes=") return badRange;
+  var dash = range.indexOf("-", 6);
+  if (dash == -1) return badRange;
+  var start = dash == 6 ? undefined : Number(range.slice(6, dash));
+  if (Number.isNaN(start)) return badRange;
+  var end = range.length == dash + 1 ? undefined : Number(range.slice(dash + 1));
+  if (Number.isNaN(end)) return badRange;
+  if (end === undefined) {
+    end = maxChunk ? Math.min(start + maxChunk, maxEnd) : maxEnd;
+  } else if (start === undefined) {
+    start = maxEnd - end;
+    end = maxEnd;
+  }
+  if (start >= end || start >= maxEnd) return {
+    ok: false,
+    code: "416"
+  };
+  return {
+    ok: true,
+    start: start,
+    end
+  };
+}
+/**
+* This function takes methods that you registered on an endpoint and formats them to suit "Allow" header.
+* */
+function typedAllowHeader(methodsArr) {
+  if (new Set(methodsArr).size != methodsArr.length) throw new Error("the methods repeat");
+  var arr = [];
+  loop: for (var method of methodsArr) {
+    switch (method) {
+      case "ws":
+        continue loop;
+      case "del":
+        arr.push("DELETE");
+        break;
+      default:
+        arr.push(method.toUpperCase());
+    }
+  }
+  return arr.join(", ");
+}

package/dist/cjs/index.js

@@ -47,7 +47,12 @@ _uWebSockets.DeclarativeResponse.prototype.writeHeaders = function (headers) {
 };
 /**
  * function to effortlessly mark response as aborted AND to attach an event emitter, so that you can easily scale the handler. If you don't need event emitter and only some res.aborted - set it by yourself (no overkill for the handler)
+ * If some utility expect import("@ublitzjs/core").HttpResponse, it means that they response to first go through this registerAbort
  * @param res
+ * @example
+ * console.log(Boolean(res.emitter)) // false
+ * registerAbort(res)
+ * console.log(Boolean(res.emitter)) // true
  */
 function registerAbort(res) {
   if (typeof res.aborted === "boolean") throw new Error("abort already registered");
@@ -92,7 +97,7 @@ function extendApp(app, ...rest) {
   return app;
 }
 /**
- * conversion to ArrayBuffer ('cause transferring strings to uWS is really slow)
+ * @deprecated this conversion to arrayBuffer is not really necessary. You just have Buffer.from(""). Slicing that is rarely needed, and even if it is, that takes 4 lines of code
  */
 function toAB(data) {
   var NodeBuf = data instanceof _nodeBuffer.Buffer ? data : _nodeBuffer.Buffer.from(data);

package/dist/esm/http-codes.js

@@ -1,43 +1,44 @@
 "use strict";
+/**
+* Yes, I have just deprecated the whole category. It will be completely removed in 2.0.0. When is it coming? Who knows
+* */
 import { toAB } from "./index.js";
-var c405Message = toAB("Method is not allowed");
-var allowHeader = toAB("Allow");
-var checkHeader = toAB("content-length");
-var checkMessage = toAB("Content-Length is required to be > 0 and to be an integer");
 /**
- * If something wrong is to content-length, sends 411 code and throws error with a "cause" == { CL : string}, sets res.finished = true
+ * @deprecated
+ * uWS actually checks content-length by itself
  */
 export function checkContentLength(res, req) {
-    var header = req.getHeader(checkHeader);
+    var header = req.getHeader("content-length");
     var CL;
     if (!header || !Number.isInteger(CL = Number(header))) {
         res.finished = true;
-        res.cork(() => res.writeStatus(c411).end(checkMessage));
+        res.cork(() => res.writeStatus("411").end("Content-Length is required to be > 0 and to be an integer"));
         throw new Error("Wrong content-length", { cause: { CL: header } });
     }
     return CL;
 }
 /**
- * sends http 400 and throws an Error with "causeForYou", sets res.finished = true
+ * @deprecated
+ * This function throws, so it is slow.
  */
 export function badRequest(res, error, causeForYou) {
     res.finished = true;
     if (!res.aborted)
-        res.cork(() => res.writeStatus(c400).end(toAB(error)));
+        res.cork(() => res.writeStatus("400").end(toAB(error)));
     throw new Error("Bad request", { cause: causeForYou });
 }
 /**
- * sends http 413, but doesn't throw an Error, sets res.finished = true
+ * @deprecated
+ * These are 2 lines of code.
  */
 export function tooLargeBody(res, limit) {
-    var message = toAB("Body is too large. Limit in bytes - " + limit);
     if (!res.aborted)
-        res.cork(() => res.writeStatus(c413).end(message));
+        res.cork(() => res.writeStatus("413").end("Body is too large. Limit in bytes - " + limit));
     res.finished = true;
 }
 /**
- * Constructs function, which sends http 405 and sets http Allow header with all methods you passed.
- * It ignores "ws" and replaces "del" on "DELETE"
+ * @deprecated
+ * use "typedAllowHeader" instead
  */
 export function seeOtherMethods(methodsArr) {
     if (new Set(methodsArr).size != methodsArr.length)
@@ -53,32 +54,38 @@ export function seeOtherMethods(methodsArr) {
         }
     }
     var methods = toAB(arr.join(", "));
-    return (res) => res.writeStatus(c405).writeHeader(allowHeader, methods).end(c405Message);
+    return (res) => res.writeStatus("405").writeHeader("Allow", methods).end("Method is not allowed");
 }
 /**
- * Constructs the function, which sets 404 http code and sends the message you have specified
+ * @deprecated
+ * This is 1-2 lines of code
  */
 export function notFoundConstructor(message = "Not found") {
     var mes = toAB(message);
-    return (res) => res.writeStatus(c404).end(mes, true);
+    return (res) => res.writeStatus("404").end(mes, true);
 }
 /**
+ * @deprecated
  * code: required content length
  */
 export var c411 = toAB("411");
 /**
+ * @deprecated
  * code: bad request
  */
 export var c400 = toAB("400");
 /**
+ * @deprecated
  * code: payload too large
  */
 export var c413 = toAB("413");
 /**
+ * @deprecated
  * code: method not allowed
  */
 export var c405 = toAB("405");
 /**
+ * @deprecated
  * code: not found
  */
 export var c404 = toAB("404");

package/dist/esm/http-headers.js

@@ -1,6 +1,6 @@
 "use strict";
 import { toAB } from "./index.js";
-var helmetHeaders = {
+export var helmentHeaders = {
     "X-Content-Type-Options": "nosniff",
     "X-DNS-Prefetch-Control": "off",
     "X-Frame-Options": "DENY",
@@ -11,14 +11,41 @@ var helmetHeaders = {
     "Cross-Origin-Opener-Policy": "same-origin",
     "Cross-Origin-Embedder-Policy": "require-corp",
     "Origin-Agent-Cluster": "?1",
-    //"Content-Security-Policy-Report-Only":"",
-    //"Strict-Transport-Security":`max-age=${60 * 60 * 24 * 365}; includeSubDomains`,
 };
 /**
- * A map containing all headers as ArrayBuffers, so speed remains. There are several use cases of it:
- * 1) Don't define them in requests ( post(res){new HeadersMap({...headers}).prepare().toRes(res)} ). This is slow. Define maps BEFORE actual usage.
- * 2) You can pass them in LightMethod or HeavyMethod in shared property (but handle it manually)
- * 3) Don't define them before writing status on request. uWebSockets.js after first written header considers response as successful and puts "200" code automatically. Set headers AFTER validation in class controllers (handler function) and after writing status (or don't write it at all. It will be 200).
+* This function is created as a replacement for "HeadersMap" (which became deprecated in 1.1.0).
+* The most overhead when sending request doesn't come from utf16 -> utf8 conversion, but from many subsequent res.writeHeader, which is JS->C++ switch.
+* To reduce an amount of calling headers, you can use manual string concatenation and HTTP header separator - CRLF.
+* @notice this function doesn't create completely ready data to send. Look a the example below
+* @notice2 its return-type LIES. In fact it is just a concatenated string, but TS lies just for LSP help for the second param and, as a result, last header, value to which should be written in res.writeHeader
+* @example
+* //if all headers don't change
+* var headers = staticHeaders({
+*   "Content-Type": "text/plain"
+* }, "Etag") // However "Etag" doesn't have value yet
+* * var littleFasterHeaders = Buffer.from(headers)
+* server.get("/", (res)=>{
+*   // we put ETag's value to the right. This way we can combine static + dynamic headers in one single call
+*   res.writeHeader(littleFasterHeaders, 'W/"' + 123 + '"')
+*   res.end("ok")
+*
+*  // underneath this is the same (gain speed but lose TypeScript. Not bad if your head is a compiler)
+*  res.writeHeader("Content-Type: text/plain\r\nETag", 'W/"' + 123 + '"')
+*  // you can make right side look same as well
+*  res.writeHeader<string>("Content-Type", 'text/plain\r\nETag: W/"' + 123 + '"')
+* })
+*
+* */
+export function staticHeaders(headers, likelyDynamicHeader) {
+    var result = "";
+    for (var key in headers) {
+        result += key + ": " + headers[key] + "\r\n";
+    }
+    return (result += likelyDynamicHeader);
+}
+/**
+ * @deprecated because using ArrayBuffers vs strings in headers doesn't bring much benefit, as it turned out after some benchmarks (+ it uses Map class, so that's even slower). It is going to be removed in 2.0.0. When is it coming? Who knows.
+ * And YES, I removed description of it. Stick to "staticHeaders" or CRLF manipulations
  */
 export class HeadersMap extends Map {
     currentHeaders;
@@ -68,7 +95,7 @@ export class HeadersMap extends Map {
      * @example
      * new HeadersMap({...HeadersMap.baseObj, "ownHeader":"hello world"}).remove("X-Download-Options")
      */
-    static baseObj = helmetHeaders;
+    static baseObj = helmentHeaders;
     /**
      * this is same as "toRes", but it uses HeadersMap.baseObj
      */
@@ -95,8 +122,6 @@ export function setCSP(mainCSP, ...remove) {
  * Usual CSP directories. If you want more dirs:
  * 1) I will put more in soon
  * 2) use string concatenation (use BASE)
- * @example
- * new HeadersMap({...HeadersMap.baseObj, "Content-Security-Policy":setCSP({...CSPDirs}) + " your-dir: 'self';"})
  */
 export var CSPDirs = {
     "default-src": ["'self'"],
@@ -117,3 +142,58 @@ export var CSPDirs = {
     "worker-src": ["'self'"],
     "media-src": ["'self'"],
 };
+var badRange = { ok: false, code: "400" };
+/**
+* "Range" http header requires validation, so here you get it
+* @example
+* var data = Buffer.allocUnsafe(1024*1024)
+* server.get("/largeData", (res, req)=>{
+*   var range = req.getHeader("range")
+*   if(!range) return res.end(data)
+*   // so parseRange might modify "range" to suit requirements + check if header is right
+*   var parsedRange = parseRange(range, data.length - 1, 64*1024)
+*   // might be
+*   if(!parsedRange.ok) return res.writeStatus(parsedRange.code).end("bad")
+* })
+* */
+export function parseRange(range, maxEnd, maxChunk) {
+    if (range.length == 7 || range.slice(0, 6) != "bytes=")
+        return badRange;
+    var dash = range.indexOf("-", 6);
+    if (dash == -1)
+        return badRange;
+    var start = dash == 6 ? undefined : Number(range.slice(6, dash));
+    if (Number.isNaN(start))
+        return badRange;
+    var end = range.length == dash + 1 ? undefined : Number(range.slice(dash + 1));
+    if (Number.isNaN(end))
+        return badRange;
+    if (end === undefined) {
+        end = maxChunk ? Math.min(start + maxChunk, maxEnd) : maxEnd;
+    }
+    else if (start === undefined) {
+        start = maxEnd - end;
+        end = maxEnd;
+    }
+    if (start >= end || start >= maxEnd)
+        return { ok: false, code: "416" };
+    return { ok: true, start: start, end };
+}
+/**
+* This function takes methods that you registered on an endpoint and formats them to suit "Allow" header.
+* */
+export function typedAllowHeader(methodsArr) {
+    if (new Set(methodsArr).size != methodsArr.length)
+        throw new Error("the methods repeat");
+    var arr = [];
+    loop: for (var method of methodsArr) {
+        switch (method) {
+            case "ws": continue loop;
+            case "del":
+                arr.push("DELETE");
+                break;
+            default: arr.push(method.toUpperCase());
+        }
+    }
+    return arr.join(", ");
+}

package/dist/esm/index.js

@@ -9,7 +9,12 @@ uWS.DeclarativeResponse.prototype.writeHeaders = function (headers) {
 };
 /**
  * function to effortlessly mark response as aborted AND to attach an event emitter, so that you can easily scale the handler. If you don't need event emitter and only some res.aborted - set it by yourself (no overkill for the handler)
+ * If some utility expect import("@ublitzjs/core").HttpResponse, it means that they response to first go through this registerAbort
  * @param res
+ * @example
+ * console.log(Boolean(res.emitter)) // false
+ * registerAbort(res)
+ * console.log(Boolean(res.emitter)) // true
  */
 export function registerAbort(res) {
     if (typeof res.aborted === "boolean")
@@ -57,7 +62,7 @@ export function extendApp(app, ...rest) {
     return app;
 }
 /**
- * conversion to ArrayBuffer ('cause transferring strings to uWS is really slow)
+ * @deprecated this conversion to arrayBuffer is not really necessary. You just have Buffer.from(""). Slicing that is rarely needed, and even if it is, that takes 4 lines of code
  */
 export function toAB(data) {
     var NodeBuf = data instanceof Buffer ? data : Buffer.from(data);

package/dist/types/http-codes.d.ts

@@ -1,43 +1,52 @@
 import type { HttpResponse as uwsHttpResponse } from "uWebSockets.js";
 import type { HttpRequest, HttpMethods } from "./index.ts";
 /**
- * If something wrong is to content-length, sends 411 code and throws error with a "cause" == { CL : string}, sets res.finished = true
+ * @deprecated
+ * uWS actually checks content-length by itself
  */
 export declare function checkContentLength(res: uwsHttpResponse, req: HttpRequest): number;
 /**
- * sends http 400 and throws an Error with "causeForYou", sets res.finished = true
+ * @deprecated
+ * This function throws, so it is slow.
  */
 export declare function badRequest(res: uwsHttpResponse, error: string, causeForYou: string): void;
 /**
- * sends http 413, but doesn't throw an Error, sets res.finished = true
+ * @deprecated
+ * These are 2 lines of code.
  */
 export declare function tooLargeBody(res: uwsHttpResponse, limit: number): void;
 /**
- * Constructs function, which sends http 405 and sets http Allow header with all methods you passed.
- * It ignores "ws" and replaces "del" on "DELETE"
+ * @deprecated
+ * use "typedAllowHeader" instead
  */
 export declare function seeOtherMethods(methodsArr: HttpMethods[]): (res: uwsHttpResponse, req: any) => any;
 /**
- * Constructs the function, which sets 404 http code and sends the message you have specified
+ * @deprecated
+ * This is 1-2 lines of code
  */
 export declare function notFoundConstructor(message?: string): (res: uwsHttpResponse, req: any) => any;
 /**
+ * @deprecated
  * code: required content length
  */
 export declare var c411: ArrayBuffer;
 /**
+ * @deprecated
  * code: bad request
  */
 export declare var c400: ArrayBuffer;
 /**
+ * @deprecated
  * code: payload too large
  */
 export declare var c413: ArrayBuffer;
 /**
+ * @deprecated
  * code: method not allowed
  */
 export declare var c405: ArrayBuffer;
 /**
+ * @deprecated
  * code: not found
  */
 export declare var c404: ArrayBuffer;