webhoster 0.3.3 → 0.3.5

package/README.md

@@ -39,7 +39,7 @@ For now, take a look at [/test/index.js](/test/index.js)
 * `.defaultInstance` - (`HttpHandler`) - Returns a instance of `HttpHandler` that can be accessed staticly.
 * `.middleware` - (`Middleware[]`) - An array of middleware operations to iterate through when handling a request. It is recommended to create isolated branches (eg: `/images/`; `/api/`; `/views/`; etc.).
 * `.errorHandlers` - (`MiddlewareErrorHandler[]`) - An array of `MiddlewareErrorHandler` that will handle errors and respond appropriately (eg: `res.status = 500`)
-* `.handleRequest` - (`function(MiddlewareFunctionParams):Promise<HttpResponse>`) - handles logic for calling middleware and error handlers. Unlikely to be used directly.
+* `.handleRequest` - (`function(HttpTransaction):Promise<HttpResponse>`) - handles logic for calling middleware and error handlers. Unlikely to be used directly.
 * `.handleHttp1Request` - (`function(IncomingMessage, ServerResponse):Promise<HttpResponse>`) - constructs a new `HttpRequest` and `HttpResponse` based on the HTTP1 parameters and passes it to `handleRequest`
 * `.handleHttp2Stream` - (`function(ServerHttp2Stream, IncomingHttpHeaders, HttpResponseOptions):Promise<HttpResponse>`) - constructs a new `HttpRequest` and `HttpResponse` based on the HTTP2 parameters and passes it to `handleRequest`
 
@@ -141,7 +141,7 @@ async function onGetIndexPage(transaction) {
 
 Middleware logic flows in a tree structure, allowing for `continue`, `break`, or `end`.
 
-A `MiddlewareFunction` is a function that accepts a `MiddlewareFunctionParams` object structured as `{ res: HttpRequest, res: HttpResponse }`. The function can return a instruction with the step in the tree-based logic, status code, or content body to be handled. It maybe return any of these instructions with any of the values as a literal, a `Promise`, or `PromiseLike`:
+A `MiddlewareFunction` is a function that accepts a `HttpTransaction` object structured as `{ res: HttpRequest, res: HttpResponse }`. The function can return a instruction with the step in the tree-based logic, status code, or content body to be handled. It maybe return any of these instructions with any of the values as a literal, a `Promise`, or `PromiseLike`:
 
 * `HttpHandler.CONTINUE`: Continues on the current branch to the next middleware, or moves to the next branch if there are no siblings left. `alias: true|void|null|undefined`
 * `HttpHandler.BREAK`: Breaks from the current middleware branch, and continues to the next branch. `alias: false`
@@ -151,7 +151,7 @@ A `MiddlewareFunction` is a function that accepts a `MiddlewareFunctionParams` o
 * `Array`: Explicitly passed to `HttpResponse.end()`. This is to support sending an `Array` object instead having it becoming an inline middleware branch.
 * `any`: Any other value returned would automatically be passed to `HttpResponse.end()` which, in turn, uses it's own content handlers (eg: `JSON`; `Readable`), and finally terminates the middleware tree.
 
-A `MiddlewareFilter` is a function that accepts a `MiddlewareFunctionParams` and returns a `boolean` or `Promise<boolean>` signaling whether to continue in the branch. `true` translates to `HttpHandler.CONTINUE`. `false` translates to `HttpHandler.BREAK`. There is no support for `HttpHandler.END` logic in a MiddlewareFilter by design.
+A `MiddlewareFilter` is a function that accepts a `HttpTransaction` and returns a `boolean` or `Promise<boolean>` signaling whether to continue in the branch. `true` translates to `HttpHandler.CONTINUE`. `false` translates to `HttpHandler.BREAK`. There is no support for `HttpHandler.END` logic in a MiddlewareFilter by design.
 
 A `MiddlewareErrorHandler` is an `Object` with a `onError` property. `onError` is like a MiddlewareFunction, but includes an `err` item in its parameter object. When the handler is in an error state, it will bubble upwards while searching for the next `MiddlewareErrorHandler`.
 
@@ -163,7 +163,7 @@ To support branching, `Middleware` can also be a `Iterable<Middleware>` (eg: `Se
 
 ### Response Middleware
 * [AuthHeaders](./middleware/AutoHeadersMiddleware.js) - Automatically sends response headers before writing or ending a response stream
-* [ContentLength](./middleware/contentLengthMiddleware.js) - Sets `Content-Length` based on response stream content writes
+* [ContentLength](./middleware/ContentLengthMiddleware.js) - Sets `Content-Length` based on response stream content writes
 * [Hash](./middleware/HashMiddleware.js) - Sets `ETag`, `Digest`, and `Content-MD5` response headers automatically
 * [ContentEncoder](./middleware/ContentEncoderMiddleware.js) - Applies `Content-Encoding` to response based on `Accept-Encoding` request header
 * [SendJson](./middleware/SendJsonMiddleware.js) - Adds response content processor that encodes objects and arrays to JSON string. Sets `application/json;charset=utf-8`, if content-type not set.

package/data/CookieObject.js

@@ -1,4 +1,4 @@
-/** @typedef {import('../types').CookieDetails} CookieDetails */
+/** @typedef {import('./custom-types.js').CookieDetails} CookieDetails */
 
 /** @private */
 export default class CookieObject {

package/{types/index.js → data/custom-types.js}

@@ -16,7 +16,7 @@
 
 /** @typedef {import('node:stream').Duplex} Duplex */
 
-/** @typedef {import('./typings.js').Middleware} Middleware */
+/** @typedef {import('./middleware.js').Middleware} Middleware */
 
 /** @typedef {true|false|0} MiddlewareFlowInstruction */
 

package/{types/typings.d.ts → data/middleware.d.ts}

@@ -3,7 +3,7 @@ import {
   MiddlewareContent,
   MiddlewareFunction,
   MiddlewareFunctionResultType,
-} from './index.js';
+} from './custom-types.js';
 
 export type Middleware =
   | IMiddleware

package/helpers/RequestReader.js

@@ -1,4 +1,4 @@
-/** @typedef {import('../types').HttpRequest} HttpRequest */
+/** @typedef {import('../data/custom-types.js').HttpRequest} HttpRequest */
 
 import { TextDecoder } from 'node:util';
 import AsyncObject from '../utils/AsyncObject.js';

package/helpers/ResponseHeaders.js

@@ -3,7 +3,7 @@ import CookieObject from '../data/CookieObject.js';
 import HeadersHandler from './HeadersParser.js';
 
 /** @typedef {import('../lib/HttpResponse.js').default} HttpResponse */
-/** @typedef {import('../types').CookieDetails} CookieDetails */
+/** @typedef {import('../data/custom-types.js').CookieDetails} CookieDetails */
 
 /** @type {(keyof CookieDetails)[]} */
 const COOKIE_DETAIL_KEYS = [
@@ -22,18 +22,17 @@ const COOKIE_DETAIL_KEYS = [
 const instanceCache = new WeakMap();
 
 export default class ResponseHeaders extends HeadersHandler {
-  /** @param {HttpResponse} res */
-  // @ts-ignore Cached constructor
-  constructor(res) {
-    const instance = instanceCache.get(res);
+  /** @param {HttpResponse} response */
+  constructor(response) {
+    const instance = instanceCache.get(response);
     if (instance) return instance;
-    super(res.headers);
-    instanceCache.set(res, this);
+    super(response.headers);
+    instanceCache.set(response, this);
   }
 
-  /** @param {HttpResponse} res */
-  static cookies(res) {
-    const instance = new ResponseHeaders(res);
+  /** @param {HttpResponse} response */
+  static cookies(response) {
+    const instance = new ResponseHeaders(response);
     return instance.cookies;
   }
 

package/lib/HttpHandler.js

@@ -7,10 +7,10 @@ import HttpRequest from './HttpRequest.js';
 import HttpResponse from './HttpResponse.js';
 import HttpTransaction from './HttpTransaction.js';
 
-/** @typedef {import('../types').Middleware} Middleware */
-/** @typedef {import('../types').MiddlewareErrorHandler} MiddlewareErrorHandler */
-/** @typedef {import('../types').MiddlewareFlowInstruction} MiddlewareFlowInstruction */
-/** @typedef {import('../types').RequestMethod} RequestMethod */
+/** @typedef {import('../data/custom-types.js').Middleware} Middleware */
+/** @typedef {import('../data/custom-types.js').MiddlewareErrorHandler} MiddlewareErrorHandler */
+/** @typedef {import('../data/custom-types.js').MiddlewareFlowInstruction} MiddlewareFlowInstruction */
+/** @typedef {import('../data/custom-types.js').RequestMethod} RequestMethod */
 
 /** @type {HttpHandler} */
 let defaultInstance = null;

package/lib/HttpRequest.js

@@ -1,9 +1,9 @@
 import { Readable } from 'node:stream';
 import { URLSearchParams } from 'node:url';
 
-/** @typedef {import('../types').RequestMethod} RequestMethod */
+/** @typedef {import('../data/custom-types.js').RequestMethod} RequestMethod */
 /** @typedef {import('http').IncomingHttpHeaders} IncomingHttpHeaders */
-/** @typedef {import('../types/index.js').MediaType} MediaType */
+/** @typedef {import('../data/custom-types.js').MediaType} MediaType */
 
 /** @typedef {Partial<MediaType> & {parse:(this:HttpRequest)=>any|PromiseLike<any>, test?:(this:HttpRequest, mediaType: MediaType)=>boolean}} ContentReaderRegistration */
 

package/lib/HttpResponse.js

@@ -11,9 +11,9 @@ import { isWritable } from '../utils/stream.js';
 
 /** @typedef {import('http').OutgoingHttpHeaders} OutgoingHttpHeaders */
 /** @typedef {import('stream').Stream} Stream */
-/** @typedef {import('../types/index.js').Middleware} Middleware */
+/** @typedef {import('../data/custom-types.js').Middleware} Middleware */
 /** @typedef {import('./HttpRequest.js').default} HttpRequest */
-/** @typedef {import('../types/index.js').ResponseFinalizer} ResponseFinalizer */
+/** @typedef {import('../data/custom-types.js').ResponseFinalizer} ResponseFinalizer */
 
 /**
  * @typedef {Object} HttpResponseOptions

package/lib/HttpTransaction.js

@@ -2,8 +2,8 @@
 /** @typedef {import('./HttpResponse.js').default} HttpResponse */
 /** @typedef {import('stream').Stream} Stream */
 
-/** @typedef {import('../types/index.js').MediaType} MediaType */
-/** @typedef {import('../types/index.js').Middleware} Middleware */
+/** @typedef {import('../data/custom-types.js').MediaType} MediaType */
+/** @typedef {import('../data/custom-types.js').Middleware} Middleware */
 /** @typedef {import('stream').Writable} Writable */
 
 /** @typedef {Partial<MediaType> & {parse:(this:HttpRequest)=>any|PromiseLike<any>, test?:(this:HttpRequest, mediaType: MediaType)=>boolean}} ContentReaderRegistration */

package/middleware/AutoHeadersMiddleware.js

@@ -1,6 +1,6 @@
 /** @typedef {import('../lib/HttpResponse.js').default} HttpResponse */
-/** @typedef {import('../types').ResponseFinalizer} ResponseFinalizer */
-/** @typedef {import('../types').MiddlewareFunction} MiddlewareFunction */
+/** @typedef {import('../data/custom-types.js').ResponseFinalizer} ResponseFinalizer */
+/** @typedef {import('../data/custom-types.js').MiddlewareFunction} MiddlewareFunction */
 
 import { Transform } from 'node:stream';
 

package/middleware/CORSMiddleware.js

@@ -1,6 +1,6 @@
-/** @typedef {import('../types').IMiddleware} IMiddleware */
-/** @typedef {import('../types').MiddlewareFunction} MiddlewareFunction */
-/** @typedef {import('../types').RequestMethod} RequestMethod */
+/** @typedef {import('../data/custom-types.js').IMiddleware} IMiddleware */
+/** @typedef {import('../data/custom-types.js').MiddlewareFunction} MiddlewareFunction */
+/** @typedef {import('../data/custom-types.js').RequestMethod} RequestMethod */
 
 /**
  * @typedef CORSMiddlewareOptions

package/middleware/CaseInsensitiveHeadersMiddleware.js

@@ -1,7 +1,7 @@
 import CaseInsensitiveObject from '../utils/CaseInsensitiveObject.js';
 
-/** @typedef {import('../types').IMiddleware} IMiddleware */
-/** @typedef {import('../types').MiddlewareFunction} MiddlewareFunction */
+/** @typedef {import('../data/custom-types.js').IMiddleware} IMiddleware */
+/** @typedef {import('../data/custom-types.js').MiddlewareFunction} MiddlewareFunction */
 
 /**
  * @typedef {Object} CaseInsensitiveHeadersMiddlewareOptions

package/middleware/ContentDecoderMiddleware.js

@@ -4,7 +4,7 @@ import {
   BrotliDecompress, Gunzip, Inflate,
 } from 'node:zlib';
 
-/** @typedef {import('../types').MiddlewareFunction} MiddlewareFunction */
+/** @typedef {import('../data/custom-types.js').MiddlewareFunction} MiddlewareFunction */
 
 /**
  * @typedef ContentDecoderMiddlewareOptions

package/middleware/ContentEncoderMiddleware.js

@@ -15,8 +15,8 @@ const { BROTLI_OPERATION_FLUSH, Z_SYNC_FLUSH } = ZlibContants;
 /** @typedef {import('http').IncomingHttpHeaders} IncomingHttpHeaders */
 /** @typedef {import('../lib/HttpRequest.js').default} HttpRequest */
 /** @typedef {import('../lib/HttpResponse.js').default} HttpResponse */
-/** @typedef {import('../types').MiddlewareFunction} MiddlewareFunction */
-/** @typedef {import('../types').ResponseFinalizer} ResponseFinalizer */
+/** @typedef {import('../data/custom-types.js').MiddlewareFunction} MiddlewareFunction */
+/** @typedef {import('../data/custom-types.js').ResponseFinalizer} ResponseFinalizer */
 
 /** @typedef {'br'|'gzip'|'deflate'|'identity'|'*'} COMPATIBLE_ENCODING */
 

package/middleware/ContentLengthMiddleware.js

@@ -1,6 +1,6 @@
 /** @typedef {import('../lib/HttpResponse.js').default} HttpResponse */
-/** @typedef {import('../types').MiddlewareFunction} MiddlewareFunction */
-/** @typedef {import('../types').ResponseFinalizer} ResponseFinalizer */
+/** @typedef {import('../data/custom-types.js').MiddlewareFunction} MiddlewareFunction */
+/** @typedef {import('../data/custom-types.js').ResponseFinalizer} ResponseFinalizer */
 
 import { Transform } from 'node:stream';
 

package/middleware/HashMiddleware.js

@@ -4,8 +4,8 @@ import { Transform } from 'node:stream';
 /** @typedef {import('node:crypto').BinaryToTextEncoding} BinaryToTextEncoding */
 /** @typedef {import('../lib/HttpRequest.js').default} HttpRequest */
 /** @typedef {import('../lib/HttpResponse.js').default} HttpResponse */
-/** @typedef {import('../types/index.js').MiddlewareFunction} MiddlewareFunction */
-/** @typedef {import('../types/index.js').ResponseFinalizer} ResponseFinalizer */
+/** @typedef {import('../data/custom-types.js').MiddlewareFunction} MiddlewareFunction */
+/** @typedef {import('../data/custom-types.js').ResponseFinalizer} ResponseFinalizer */
 
 const DEFAULT_ALGORITHM = 'sha1';
 /** @type {BinaryToTextEncoding} */

package/middleware/HeadMethodMiddleware.js

@@ -1,6 +1,6 @@
-/** @typedef {import('../types/index.js').HttpTransaction} HttpTransaction */
-/** @typedef {import('../types/index.js').MiddlewareFunction} MiddlewareFunction */
-/** @typedef {import('../types/index.js').ResponseFinalizer} ResponseFinalizer */
+/** @typedef {import('../data/custom-types.js').HttpTransaction} HttpTransaction */
+/** @typedef {import('../data/custom-types.js').MiddlewareFunction} MiddlewareFunction */
+/** @typedef {import('../data/custom-types.js').ResponseFinalizer} ResponseFinalizer */
 
 import { Transform } from 'node:stream';
 

package/middleware/MethodMiddleware.js

@@ -1,6 +1,6 @@
-/** @typedef {import('../types').HttpTransaction} HttpTransaction */
-/** @typedef {import('../types').MiddlewareFunction} MiddlewareFunction */
-/** @typedef {import('../types').RequestMethod} RequestMethod */
+/** @typedef {import('../data/custom-types.js').HttpTransaction} HttpTransaction */
+/** @typedef {import('../data/custom-types.js').MiddlewareFunction} MiddlewareFunction */
+/** @typedef {import('../data/custom-types.js').RequestMethod} RequestMethod */
 
 /** @typedef {RegExp|RequestMethod} MethodEntry */
 

package/middleware/PathMiddleware.js

@@ -1,9 +1,9 @@
 import { posix } from 'node:path';
 
-/** @typedef {import('../types').HttpTransaction} HttpTransaction */
-/** @typedef {import('../types').IMiddleware} IMiddleware */
-/** @typedef {import('../types').MiddlewareFunction} MiddlewareFunction */
-/** @typedef {import('../types').RequestMethod} RequestMethod */
+/** @typedef {import('../data/custom-types.js').HttpTransaction} HttpTransaction */
+/** @typedef {import('../data/custom-types.js').IMiddleware} IMiddleware */
+/** @typedef {import('../data/custom-types.js').MiddlewareFunction} MiddlewareFunction */
+/** @typedef {import('../data/custom-types.js').RequestMethod} RequestMethod */
 
 /** @typedef {RegExp|string} PathEntry */
 

package/middleware/ReadFormData.js

@@ -1,5 +1,5 @@
 /** @typedef {import('../lib/HttpRequest.js').default} HttpRequest */
-/** @typedef {import('../types').MiddlewareFunction} MiddlewareFunction */
+/** @typedef {import('../data/custom-types.js').MiddlewareFunction} MiddlewareFunction */
 
 /**
  * The application/x-www-form-urlencoded format is in many ways an aberrant monstrosity,

package/middleware/SendJsonMiddleware.js

@@ -1,7 +1,7 @@
-/** @typedef {import('../types').IMiddleware} IMiddleware */
-/** @typedef {import('../types').MiddlewareResponseFunction} MiddlewareResponseFunction */
-/** @typedef {import('../types').MiddlewareFunction} MiddlewareFunction */
-/** @typedef {import('../types/index.js').ResponseFinalizer} ResponseFinalizer */
+/** @typedef {import('../data/custom-types.js').IMiddleware} IMiddleware */
+/** @typedef {import('../data/custom-types.js').MiddlewareResponseFunction} MiddlewareResponseFunction */
+/** @typedef {import('../data/custom-types.js').MiddlewareFunction} MiddlewareFunction */
+/** @typedef {import('../data/custom-types.js').ResponseFinalizer} ResponseFinalizer */
 
 /**
  * @typedef {Object} SendJsonMiddlewareOptions

package/middleware/SendStringMiddleware.js

@@ -1,6 +1,6 @@
-/** @typedef {import('../types/index.js').IMiddleware} IMiddleware */
-/** @typedef {import('../types/index.js').MiddlewareFunction} MiddlewareFunction */
-/** @typedef {import('../types/index.js').ResponseFinalizer} ResponseFinalizer */
+/** @typedef {import('../data/custom-types.js').IMiddleware} IMiddleware */
+/** @typedef {import('../data/custom-types.js').MiddlewareFunction} MiddlewareFunction */
+/** @typedef {import('../data/custom-types.js').ResponseFinalizer} ResponseFinalizer */
 
 /**
  * @typedef {Object} SendStringMiddlewareOptions

package/package.json

@@ -29,7 +29,7 @@
     "./examples/*": "./examples/*",
     "./helpers/*": "./helpers/*",
     "./lib/*": "./lib/*",
-    "./middlewares/*": "./middlewares/*",
+    "./middleware/*": "./middleware/*",
     "./polyfills/*": "./polyfills/*",
     "./templates/*": "./templates/*",
     "./types/*": "./types/*",
@@ -46,12 +46,23 @@
     "cors",
     "gzip"
   ],
+  "files": [
+    "data",
+    "errata",
+    "helpers",
+    "lib",
+    "middleware",
+    "polyfills",
+    "templates",
+    "types",
+    "utils"
+  ],
   "license": "MIT",
   "name": "webhoster",
   "scripts": {
     "debug-test": "ava --serial",
     "test": "c8 ava",
-    "prepublishOnly": "rm -Rf typings && tsc --emitDeclarationOnly",
+    "prepublishOnly": "rm -Rf types && tsc --emitDeclarationOnly",
     "pretestallsync": "rimraf coverage",
     "testallsync": "scripts/test-all-sync.sh",
     "posttestallsync": "c8 report",
@@ -60,6 +71,12 @@
     "posttestall": "c8 report"
   },
   "type": "module",
-  "types": "typings/index.d.ts",
-  "version": "0.3.3"
+  "typesVersions": {
+    "*": {
+      "*": [
+        "types/*"
+      ]
+    }
+  },
+  "version": "0.3.5"
 }

package/templates/starter.js

@@ -13,8 +13,8 @@ import HeadMethodMiddleware from '../middleware/HeadMethodMiddleware.js';
  * @param {Object} options
  * @param {string} [options.host='0.0.0.0']
  * @param {number} [options.port=8080]
- * @param {import('../types').Middleware[]} [options.middleware]
- * @param {import('../types').MiddlewareErrorHandler[]} [options.errorHandlers]
+ * @param {import('../data/custom-types.js').Middleware[]} [options.middleware]
+ * @param {import('../data/custom-types.js').MiddlewareErrorHandler[]} [options.errorHandlers]
  * @return {Promise<import('../helpers/HttpListener.js').default>}
  */
 export async function start(options) {

package/types/data/CookieObject.d.ts

@@ -0,0 +1,34 @@
+/** @typedef {import('./custom-types.js').CookieDetails} CookieDetails */
+/** @private */
+export default class CookieObject {
+    /**
+     * @param {string} cookieString
+     * @return {CookieObject}
+     */
+    static parse(cookieString: string): CookieObject;
+    /** @param {CookieDetails|string} options */
+    constructor(options: CookieDetails | string);
+    name: string;
+    value: string;
+    expires: Date;
+    maxAge: number;
+    domain: string;
+    path: string;
+    secure: boolean;
+    httpOnly: boolean;
+    sameSite: "Strict" | "Lax" | "None";
+    toString(): string;
+    toJSON(): {
+        name: string;
+        value: string;
+        expires: Date;
+        maxAge: number;
+        domain: string;
+        path: string;
+        secure: true;
+        httpOnly: true;
+        sameSite: "Strict" | "Lax" | "None";
+    };
+}
+export type CookieDetails = import("./custom-types.js").CookieDetails;
+//# sourceMappingURL=CookieObject.d.ts.map

package/types/data/CookieObject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CookieObject.d.ts","sourceRoot":"","sources":["../../data/CookieObject.js"],"names":[],"mappings":"AAAA,yEAAyE;AAEzE,eAAe;AACf;IAiBE;;;OAGG;IACH,2BAHW,MAAM,GACL,YAAY,CAuDvB;IAzED,4CAA4C;IAC5C,qBADY,aAAa,GAAC,MAAM,EAc/B;IATC,aAAwB;IACxB,cAA0B;IAC1B,cAA8B;IAC9B,eAA4B;IAC5B,eAA4B;IAC5B,aAAwB;IACxB,gBAA4B;IAC5B,kBAAgC;IAChC,oCAAgC;IA8DlC,mBAUC;IAED;;;;;;;;;;MAYC;CACF;4BAxGa,OAAO,mBAAmB,EAAE,aAAa"}

package/types/data/custom-types.d.ts

@@ -0,0 +1,111 @@
+declare const _default: {};
+export default _default;
+/**
+ * <T>
+ */
+export type HttpTransaction<T extends unknown = any> = import("../lib/HttpTransaction.js").default<T>;
+export type HttpRequest = import("../lib/HttpRequest.js").default;
+export type HttpResponse = import("../lib/HttpResponse.js").default;
+export type MediaType = {
+    type: string;
+    tree: string;
+    subtype: string;
+    suffix: string;
+    parameters: Record<string, string>;
+};
+export type Duplex = import("node:stream").Duplex;
+export type Middleware = import("./middleware.js").Middleware;
+export type MiddlewareFlowInstruction = true | false | 0;
+export type RequestMethod = "GET" | "HEAD" | "POST" | "PUT" | "DELETE" | "CONNECT" | "OPTIONS" | "TRACE" | "PATCH";
+export type MiddlewareFunctionResultType = 0 | true | false | null | undefined | void;
+export type MiddlewareFunctionResult = Promise<Middleware> | Middleware;
+export type MiddlewareContent = Record<string, any> | number | import("stream").Readable | Buffer | string;
+export type MiddlewareFunction<T extends unknown = any> = (transaction: HttpTransaction<T>) => MiddlewareFunctionResult;
+export type MiddlewareResponseFunction<T extends unknown = any> = (transaction: {
+    response: HttpTransaction<T>["response"];
+}) => MiddlewareFunctionResult;
+export type StaticMiddlewareFunction = (transaction: HttpTransaction) => MiddlewareFunctionResult;
+export type ResponseFinalizer = (response: HttpResponse) => void | null | boolean | Promise<void | null | boolean>;
+export type MiddlewareExecutor = {
+    execute: MiddlewareFunction;
+};
+export type MiddlewareStaticExecutor = {
+    Execute: StaticMiddlewareFunction;
+};
+export type MiddlewareStaticErrorHandler = {
+    OnError: StaticMiddlewareFunction;
+};
+export type MiddlewareErrorHandler = {
+    onError: MiddlewareFunction;
+};
+export type IMiddleware = MiddlewareExecutor | MiddlewareStaticExecutor | MiddlewareErrorHandler | MiddlewareStaticErrorHandler | MiddlewareStaticExecutor;
+export type CookieDetails = {
+    /**
+     * A cookie name can be any US-ASCII characters, except control characters, spaces, or tabs.
+     * It also must not contain a separator character like the following:( ) < > &#64; , ; : \ " / [ ] ? = { }.
+     * - __Secure- prefix: Cookies names starting with __Secure- (dash is part of the prefix) must be set with the secure flag from a secure page (HTTPS).
+     * - __Host- prefix: Cookies with names starting with __Host- must be set with the secure flag, must be from a secure page (HTTPS), must not have a domain specified (and therefore aren't sent to subdomains) and the path must be /.
+     */
+    name?: string;
+    /**
+     * A cookie value can optionally be wrapped in double quotes and include any US-ASCII characters excluding
+     * control characters, Whitespace, double quotes, comma, semicolon, and backslash.
+     *
+     * Encoding: Many implementations perform URL encoding on cookie values,
+     * however it is not required per the RFC specification.
+     * It does help satisfying the requirements about which characters are allowed for cookie value though.
+     */
+    value?: string;
+    /**
+     * The maximum lifetime of the cookie as an HTTP-date timestamp.
+     *
+     * If unspecified, the cookie becomes a session cookie.
+     * A session finishes when the client shuts down, and session cookies will be removed.
+     */
+    expires?: Date;
+    /**
+     * Number of seconds until the cookie expires. A zero or negative number will expire the cookie immediately.
+     * If both Expires and Max-Age are set, Max-Age has precedence.
+     */
+    maxAge?: number;
+    /**
+     * Host to which the cookie will be sent.
+     * - If omitted, defaults to the host of the current document URL, not including subdomains.
+     * - Contrary to earlier specifications, leading dots in domain names (.example.com) are ignored.
+     * - Multiple host/domain values are not allowed, but if a domain is specified, then subdomains are always included.
+     */
+    domain?: string;
+    /**
+     * A path that must exist in the requested URL, or the browser won't send the Cookie header.
+     *
+     * The forward slash (/) character is interpreted as a directory separator, and subdirectories will be matched as well:
+     * for Path=/docs, /docs, /docs/Web/, and /docs/Web/HTTP will all match.
+     */
+    path?: string;
+    /**
+     * A secure cookie is only sent to the server when a request is made with the https: scheme.
+     * (However, confidential information should never be stored in HTTP Cookies,
+     * as the entire mechanism is inherently insecure and doesn't encrypt any information.)
+     */
+    secure?: boolean;
+    /**
+     * Forbids JavaScript from accessing the cookie.
+     *
+     * For example, through the Document.cookie property, the XMLHttpRequest API, or the Request API.
+     * This mitigates attacks against cross-site scripting (XSS).
+     */
+    httpOnly?: boolean;
+    /**
+     * Asserts that a cookie must not be sent with cross-origin requests,
+     * providing some protection against cross-site request forgery attacks (CSRF).
+     * - Strict: The browser sends the cookie only for same-site requests
+     * (that is, requests originating from the same site that set the cookie).
+     * If the request originated from a different URL than the current one,
+     * no cookies with the SameSite=Strict attribute are sent.
+     * - Lax: The cookie is withheld on cross-site subrequests, such as calls to load images or frames,
+     * but is sent when a user navigates to the URL from an external site, such as by following a link.
+     * - None: The browser sends the cookie with both cross-site and same-site requests.
+     */
+    sameSite?: "Strict" | "Lax" | "None";
+};
+//# sourceMappingURL=custom-types.d.ts.map

package/types/data/custom-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-types.d.ts","sourceRoot":"","sources":["../../data/custom-types.js"],"names":[],"mappings":";;;;;4BACoB,CAAC,0BACR,OAAO,2BAA2B,EAAE,OAAO,CAAC,CAAC,CAAC;0BAE7C,OAAO,uBAAuB,EAAE,OAAO;2BACvC,OAAO,wBAAwB,EAAE,OAAO;;UAI5C,MAAM;UACN,MAAM;aACN,MAAM;YACN,MAAM;gBACN,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;qBAGlB,OAAO,aAAa,EAAE,MAAM;yBAE5B,OAAO,iBAAiB,EAAE,UAAU;wCAEpC,IAAI,GAAC,KAAK,GAAC,CAAC;4BAEZ,KAAK,GAAC,MAAM,GAAC,MAAM,GAAC,KAAK,GAAC,QAAQ,GAAC,SAAS,GAAC,SAAS,GAAC,OAAO,GAAC,OAAO;2CAEtE,CAAC,GAAC,IAAI,GAAC,KAAK,GAAC,IAAI,GAAC,SAAS,GAAC,IAAI;uCAEhC,OAAO,CAAC,UAAU,CAAC,GAAC,UAAU;gCAE9B,MAAM,CAAC,MAAM,EAAC,GAAG,CAAC,GAAC,MAAM,GAAC,OAAO,QAAQ,EAAE,QAAQ,GAAC,MAAM,GAAC,MAAM;+BAG3D,CAAC,wCAET,eAAe,CAAC,CAAC,CAAC,KAClB,wBAAwB;uCAIhB,CAAC,wCAEV;IAAE,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;CAAE,KAC3C,wBAAwB;qDAMxB,eAAe,KACf,wBAAwB;2CAKxB,YAAY,KACZ,IAAI,GAAC,IAAI,GAAC,OAAO,GAAC,OAAO,CAAC,IAAI,GAAC,IAAI,GAAC,OAAO,CAAC;;aAK9C,kBAAkB;;;aAKlB,wBAAwB;;;aAKxB,wBAAwB;;;aAKxB,kBAAkB;;0BAIf,kBAAkB,GAAC,wBAAwB,GAAC,sBAAsB,GAAC,4BAA4B,GAAC,wBAAwB;;;;;;;;WAK3H,MAAM;;;;;;;;;YAKN,MAAM;;;;;;;cAON,IAAI;;;;;aAKJ,MAAM;;;;;;;aAGN,MAAM;;;;;;;WAKN,MAAM;;;;;;aAKN,OAAO;;;;;;;eAIP,OAAO;;;;;;;;;;;;eAKP,QAAQ,GAAC,KAAK,GAAC,MAAM"}

package/types/errata/socketio.d.ts

@@ -0,0 +1,11 @@
+/** @typedef {import('../lib/HttpHandler').default} HttpHandler */
+/** @typedef {import('http2').Http2SecureServer} Http2SecureServer */
+/**
+ * @param {HttpHandler} httpHandler
+ * @param {RegExp} [socketioPath] /^\/socket.io\//i
+ * @return {void}
+ */
+export function addHttp2Support(httpHandler: HttpHandler, socketioPath?: RegExp): void;
+export type HttpHandler = import("../lib/HttpHandler").default;
+export type Http2SecureServer = import("http2").Http2SecureServer;
+//# sourceMappingURL=socketio.d.ts.map

package/types/errata/socketio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socketio.d.ts","sourceRoot":"","sources":["../../errata/socketio.js"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,qEAAqE;AAErE;;;;GAIG;AACH,6CAJW,WAAW,iBACX,MAAM,GACL,IAAI,CAYf;0BAlBa,OAAO,oBAAoB,EAAE,OAAO;gCACpC,OAAO,OAAO,EAAE,iBAAiB"}

package/types/examples/starter.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=starter.d.ts.map

package/types/examples/starter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starter.d.ts","sourceRoot":"","sources":["../../examples/starter.js"],"names":[],"mappings":""}

package/types/helpers/HeadersParser.d.ts

@@ -0,0 +1,27 @@
+export default class HeadersParser {
+    constructor(headers?: {});
+    /** @type {Object<string,any>} */
+    headers: {
+        [x: string]: any;
+    };
+    /** @return {string} */
+    get contentType(): string;
+    /**
+     * The `media-type` directive of `Content-Type`.
+     * The MIME type of the resource or the data.
+     * (Always lowercase)
+     * @return {string}
+     */
+    get mediaType(): string;
+    /**
+     * The `charset` direct of `Content-Type`.
+     * The character encoding standard.
+     * (Always lowercase)
+      @return {string} */
+    get charset(): string;
+    /** @return {string} */
+    get boundary(): string;
+    /** @return {?number} */
+    get contentLength(): number | null;
+}
+//# sourceMappingURL=HeadersParser.d.ts.map

package/types/helpers/HeadersParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeadersParser.d.ts","sourceRoot":"","sources":["../../helpers/HeadersParser.js"],"names":[],"mappings":"AAAA;IACE,0BAGC;IAFC,iCAAiC;IACjC;;MAAsB;IAGxB,uBAAuB;IACvB,mBADa,MAAM,CAGlB;IAED;;;;;OAKG;IACH,iBAFY,MAAM,CAIjB;IAED;;;;yBAIqB;IACrB,eADW,MAAM,CAkBhB;IAED,uBAAuB;IACvB,gBADa,MAAM,CAkBlB;IAED,wBAAwB;IACxB,qBADc,MAAM,OAAA,CAGnB;CACF"}