webhoster 0.3.4 → 0.3.6

package/data/custom-types.js

@@ -1,3 +1,4 @@
+/* eslint-disable max-len */
 /**
  * @template {any} [T=any]
  * @typedef {import('../lib/HttpTransaction.js').default<T>} HttpTransaction<T>
@@ -16,7 +17,19 @@
 
 /** @typedef {import('node:stream').Duplex} Duplex */
 
-/** @typedef {import('./middleware.js').Middleware} Middleware */
+/** @typedef {MiddlewareExecutor|MiddlewareStaticExecutor|MiddlewareErrorHandler|MiddlewareStaticErrorHandler|MiddlewareStaticExecutor} IMiddleware */
+
+/**
+ * @template {any} [T=any]
+ * @callback MiddlewareFunction
+ * @param {!HttpTransaction<T>} transaction
+ * @return {MiddlewareFunctionResult}
+ */
+
+/** @typedef {Promise<Middleware>|Middleware} MiddlewareFunctionResult */
+
+/** @typedef {IMiddleware|MiddlewareFunction|MiddlewareContent|MiddlewareFunctionResultType} MiddlewareBase */
+/** @typedef {MiddlewareBase|MiddlewareBase[]|Set<MiddlewareBase>} Middleware */
 
 /** @typedef {true|false|0} MiddlewareFlowInstruction */
 
@@ -24,17 +37,8 @@
 
 /** @typedef {0|true|false|null|undefined|void} MiddlewareFunctionResultType */
 
-/** @typedef {Promise<Middleware>|Middleware} MiddlewareFunctionResult */
-
 /** @typedef {Record<string,any>|number|import('stream').Readable|Buffer|string} MiddlewareContent */
 
-/**
- * @template {any} [T=any]
- * @callback MiddlewareFunction
- * @param {!HttpTransaction<T>} transaction
- * @return {MiddlewareFunctionResult}
- */
-
 /**
  * @template {any} [T=any]
  * @callback MiddlewareResponseFunction
@@ -75,10 +79,6 @@
  * @prop {MiddlewareFunction} onError
  */
 
-/**
- * @typedef {MiddlewareExecutor|MiddlewareStaticExecutor|MiddlewareErrorHandler|MiddlewareStaticErrorHandler|MiddlewareStaticExecutor} IMiddleware
- */
-
 /**
  * @typedef {Object} CookieDetails
  * @prop {string} [name='']

package/package.json

@@ -46,6 +46,17 @@
     "cors",
     "gzip"
   ],
+  "files": [
+    "data",
+    "errata",
+    "helpers",
+    "lib",
+    "middleware",
+    "polyfills",
+    "templates",
+    "types",
+    "utils"
+  ],
   "license": "MIT",
   "name": "webhoster",
   "scripts": {
@@ -67,5 +78,5 @@
       ]
     }
   },
-  "version": "0.3.4"
+  "version": "0.3.6"
 }

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,112 @@
+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 IMiddleware = MiddlewareExecutor | MiddlewareStaticExecutor | MiddlewareErrorHandler | MiddlewareStaticErrorHandler | MiddlewareStaticExecutor;
+export type MiddlewareFunction<T extends unknown = any> = (transaction: HttpTransaction<T>) => MiddlewareFunctionResult;
+export type MiddlewareFunctionResult = Promise<Middleware> | Middleware;
+export type MiddlewareBase = IMiddleware | MiddlewareFunction | MiddlewareContent | MiddlewareFunctionResultType;
+export type Middleware = MiddlewareBase | MiddlewareBase[] | Set<MiddlewareBase>;
+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 MiddlewareContent = Record<string, any> | number | import("stream").Readable | Buffer | string;
+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 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":";;;;;4BAEoB,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;0BAE5B,kBAAkB,GAAC,wBAAwB,GAAC,sBAAsB,GAAC,4BAA4B,GAAC,wBAAwB;+BAGlH,CAAC,wCAET,eAAe,CAAC,CAAC,CAAC,KAClB,wBAAwB;uCAGtB,OAAO,CAAC,UAAU,CAAC,GAAC,UAAU;6BAE9B,WAAW,GAAC,kBAAkB,GAAC,iBAAiB,GAAC,4BAA4B;yBAC7E,cAAc,GAAC,cAAc,EAAE,GAAC,GAAG,CAAC,cAAc,CAAC;wCAEnD,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;gCAEhC,MAAM,CAAC,MAAM,EAAC,GAAG,CAAC,GAAC,MAAM,GAAC,OAAO,QAAQ,EAAE,QAAQ,GAAC,MAAM,GAAC,MAAM;uCAG3D,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;;;;;;;;;WAKlB,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"}

package/types/helpers/HttpListener.d.ts

@@ -0,0 +1,84 @@
+export const SERVER_ALREADY_CREATED: "SERVER_ALREADY_CREATED";
+export default class HttpListener {
+    /** @return {HttpListener} */
+    static get defaultInstance(): HttpListener;
+    /** @param {HttpListenerOptions} options */
+    constructor(options?: HttpListenerOptions);
+    /** @param {HttpListenerOptions} options */
+    configure(options?: HttpListenerOptions): void;
+    httpHandler: HttpHandler;
+    insecurePort: number;
+    insecureHost: string;
+    securePort: number;
+    secureHost: string;
+    useHttp: boolean;
+    useHttps: boolean;
+    useHttp2: boolean;
+    tlsOptions: import("tls").TlsOptions;
+    /**
+     * @param {import('node:http').ServerOptions} [options]
+     * @return {import('node:http').Server}
+     */
+    createHttpServer(options?: import("node:http").ServerOptions): import("node:http").Server;
+    httpServer: import("http").Server<typeof import("http").IncomingMessage, typeof import("http").ServerResponse>;
+    /**
+     * @param {import('node:https').ServerOptions} [options]
+     * @return {import('node:https').Server}
+     */
+    createHttpsServer(options?: import("node:https").ServerOptions): import("node:https").Server;
+    httpsServer: import("https").Server<typeof import("http").IncomingMessage, typeof import("http").ServerResponse>;
+    /**
+     * @param {import('node:http2').ServerOptions} [options]
+     * @return {import('node:http2').Http2SecureServer}
+     */
+    createHttp2Server(options?: import("node:http2").ServerOptions): import("node:http2").Http2SecureServer;
+    http2Server: import("http2").Http2SecureServer<typeof import("http").IncomingMessage, typeof import("http").ServerResponse, typeof import("http2").Http2ServerRequest, typeof import("http2").Http2ServerResponse>;
+    /** @return {Promise<import('node:http').Server>} */
+    startHttpServer(): Promise<import("node:http").Server>;
+    /** @return {Promise<import('node:https').Server>} */
+    startHttpsServer(): Promise<import("node:https").Server>;
+    /** @return {Promise<import('node:http2').Http2SecureServer>} */
+    startHttp2Server(): Promise<import("node:http2").Http2SecureServer>;
+    /** @return {Promise<void>} */
+    stopHttpServer(): Promise<void>;
+    /** @return {Promise<void>} */
+    stopHttpsServer(): Promise<void>;
+    /** @return {Promise<void>} */
+    stopHttp2Server(): Promise<void>;
+    /**
+     * @return {Promise<[
+     *  import('node:http').Server,
+     *  import('node:https').Server,
+     *  import('node:http2').Http2SecureServer
+     * ]>
+     * }
+     */
+    startAll(): Promise<[import("node:http").Server, import("node:https").Server, import("node:http2").Http2SecureServer]>;
+    /**
+     * @return {Promise<void>}
+     */
+    stopAll(): Promise<void>;
+    #private;
+}
+export type TlsOptions = import("tls").TlsOptions;
+export type Http2Session = import("http2").Http2Session;
+export type Http2Stream = import("http2").Http2Stream;
+export type HttpListenerOptions = {
+    httpHandler?: HttpHandler;
+    insecurePort?: number;
+    /**
+     * blank defaults to '::' or '0.0.0.0'
+     */
+    insecureHost?: string;
+    securePort?: number;
+    /**
+     * blank defaults to '::' or '0.0.0.0'
+     */
+    secureHost?: string;
+    useHttp?: boolean;
+    useHttps?: boolean;
+    useHttp2?: boolean;
+    tlsOptions?: TlsOptions;
+};
+import HttpHandler from '../lib/HttpHandler.js';
+//# sourceMappingURL=HttpListener.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HttpListener.d.ts","sourceRoot":"","sources":["../../helpers/HttpListener.js"],"names":[],"mappings":"AAOA,qCAAsC,wBAAwB,CAAC;AAsB/D;IACE,6BAA6B;IAC7B,8BADa,YAAY,CAMxB;IAsCD,2CAA2C;IAC3C,sBADY,mBAAmB,EAG9B;IAED,2CAA2C;IAC3C,oBADY,mBAAmB,QAW9B;IATC,yBAAqE;IACrE,qBAAgD;IAChD,qBAAwC;IACxC,mBAA4C;IAC5C,mBAAoC;IACpC,iBAAwC;IACxC,kBAAyC;IACzC,kBAA0C;IAC1C,qCAA0C;IAG5C;;;OAGG;IACH,2BAHW,OAAO,WAAW,EAAE,aAAa,GAChC,OAAO,WAAW,EAAE,MAAM,CASrC;IALG,+GAA2C;IAO/C;;;OAGG;IACH,4BAHW,OAAO,YAAY,EAAE,aAAa,GACjC,OAAO,YAAY,EAAE,MAAM,CAYtC;IARG,iHAGE;IAON;;;OAGG;IACH,4BAHW,OAAO,YAAY,EAAE,aAAa,GACjC,OAAO,YAAY,EAAE,iBAAiB,CAajD;IATG,mNAIE;IAON,oDAAoD;IACpD,mBADa,OAAO,CAAC,OAAO,WAAW,EAAE,MAAM,CAAC,CA8C/C;IAED,qDAAqD;IACrD,oBADa,OAAO,CAAC,OAAO,YAAY,EAAE,MAAM,CAAC,CA8ChD;IAED,gEAAgE;IAChE,oBADa,OAAO,CAAC,OAAO,YAAY,EAAE,iBAAiB,CAAC,CA0I3D;IAED,8BAA8B;IAC9B,kBADa,OAAO,CAAC,IAAI,CAAC,CAwBzB;IAED,8BAA8B;IAC9B,mBADa,OAAO,CAAC,IAAI,CAAC,CAwBzB;IAED,8BAA8B;IAC9B,mBADa,OAAO,CAAC,IAAI,CAAC,CAmCzB;IAED;;;;;;;OAOG;IACH,YAPY,OAAO,CAAC,CACnB,OAAU,WAAW,EAAE,MAAM,EAC7B,OAAU,YAAY,EAAE,MAAM,EAC9B,OAAU,YAAY,EAAE,iBAAiB,CACtC,CAAC,CASJ;IAED;;OAEG;IACH,WAFY,OAAO,CAAC,IAAI,CAAC,CAQxB;;CACF;yBAhea,OAAO,KAAK,EAAE,UAAU;2BACxB,OAAO,OAAO,EAAE,YAAY;0BAC5B,OAAO,OAAO,EAAE,WAAW;;kBAI/B,WAAW;mBACX,MAAM;;;;mBACN,MAAM;iBACN,MAAM;;;;iBACN,MAAM;cACN,OAAO;eACP,OAAO;eACP,OAAO;iBACP,UAAU;;wBAlBI,uBAAuB"}

package/types/helpers/RequestHeaders.d.ts

@@ -0,0 +1,25 @@
+export default class RequestHeaders extends HeadersHandler {
+    /**
+     * @param {HttpRequest} request
+     * @return {{get:(name:string)=>string,all:(name:string)=>string[]}}
+     */
+    static cookies(request: HttpRequest): {
+        get: (name: string) => string;
+        all: (name: string) => string[];
+    };
+    /** @param {HttpRequest} request */
+    constructor(request: HttpRequest);
+    /** @return {{get:(name:string)=>string,all:(name:string)=>string[]}} */
+    get cookies(): {
+        get: (name: string) => string;
+        all: (name: string) => string[];
+    };
+    /** @return {Object<string,string[]>} */
+    get cookieEntries(): {
+        [x: string]: string[];
+    };
+    #private;
+}
+export type HttpRequest = import("../lib/HttpRequest.js").default;
+import HeadersHandler from './HeadersParser.js';
+//# sourceMappingURL=RequestHeaders.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RequestHeaders.d.ts","sourceRoot":"","sources":["../../helpers/RequestHeaders.js"],"names":[],"mappings":"AAgCA;IASE;;;OAGG;IACH,wBAHW,WAAW,GACV;QAAC,GAAG,EAAC,CAAC,IAAI,EAAC,MAAM,KAAG,MAAM,CAAC;QAAA,GAAG,EAAC,CAAC,IAAI,EAAC,MAAM,KAAG,MAAM,EAAE,CAAA;KAAC,CAKlE;IAfD,mCAAmC;IACnC,qBADY,WAAW,EAMtB;IAcD,wEAAwE;IACxE,eADa;QAAC,GAAG,EAAC,CAAC,IAAI,EAAC,MAAM,KAAG,MAAM,CAAC;QAAA,GAAG,EAAC,CAAC,IAAI,EAAC,MAAM,KAAG,MAAM,EAAE,CAAA;KAAC,CAYnE;IAED,wCAAwC;IACxC;;MAqFC;;CACF;0BAxJa,OAAO,uBAAuB,EAAE,OAAO;2BAF1B,oBAAoB"}

package/types/helpers/RequestReader.d.ts

@@ -0,0 +1,52 @@
+export default class RequestReader {
+    /**
+     * @param {HttpRequest} request
+     * @param {RequestReaderOptions} [options]
+     */
+    constructor(request: HttpRequest, options?: RequestReaderOptions);
+    request: import("../lib/HttpRequest.js").default;
+    /** @return {Promise<Buffer>} */
+    readBuffer(): Promise<Buffer>;
+    /** @return {Promise<string>} */
+    readString(): Promise<string>;
+    /** @return {Promise<Object<string,any>>} */
+    readJSON(): Promise<{
+        [x: string]: any;
+    }>;
+    /**
+     * The application/x-www-form-urlencoded format is in many ways an aberrant monstrosity,
+     * the result of many years of implementation accidents and compromises leading to a set of
+     * requirements necessary for interoperability, but in no way representing good design practices.
+     * In particular, readers are cautioned to pay close attention to the twisted details
+     * involving repeated (and in some cases nested) conversions between character encodings and byte sequences.
+     * Unfortunately the format is in widespread use due to the prevalence of HTML forms. [HTML]
+     * @return {Promise<[string, string][]>}
+     */
+    readUrlEncoded(): Promise<[string, string][]>;
+    /** @return {Promise<Map<string,string>>} */
+    readUrlEncodedAsMap(): Promise<Map<string, string>>;
+    /** @return {Promise<Object<string,string>>} */
+    readUrlEncodedAsObject(): Promise<{
+        [x: string]: string;
+    }>;
+    /**
+     * Returns `readJSON()`, `readUrlEncodedAsObject`, or `Promise<null>` based on Content-Type
+     * @return {Promise<Object<string, any>|null>}
+     */
+    readObject(): Promise<{
+        [x: string]: any;
+    } | null>;
+    /**
+     * Returns `readJSON()`, `readUrlEncoded`, `readBuffer()`, or `readString()` based on Content-Type
+     * @return {Promise<Object<string,any>|string|Buffer>}
+     */
+    read(): Promise<{
+        [x: string]: any;
+    } | string | Buffer>;
+    #private;
+}
+export type HttpRequest = import("../data/custom-types.js").HttpRequest;
+export type RequestReaderOptions = {
+    cache?: boolean;
+};
+//# sourceMappingURL=RequestReader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RequestReader.d.ts","sourceRoot":"","sources":["../../helpers/RequestReader.js"],"names":[],"mappings":"AAgBA;IAIE;;;OAGG;IACH,qBAHW,WAAW,YACX,oBAAoB,EAc9B;IADC,iDAAsB;IAGxB,gCAAgC;IAChC,cADa,OAAO,CAAC,MAAM,CAAC,CA0C3B;IAED,gCAAgC;IAChC,cADa,OAAO,CAAC,MAAM,CAAC,CAQ3B;IAED,4CAA4C;IAC5C,YADa,OAAO,CAAC;YAAO,MAAM,GAAC,GAAG;KAAC,CAAC,CAGvC;IAED;;;;;;;;OAQG;IACH,kBAFY,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAuDtC;IAED,4CAA4C;IAC5C,uBADa,OAAO,CAAC,GAAG,CAAC,MAAM,EAAC,MAAM,CAAC,CAAC,CAGvC;IAED,+CAA+C;IAC/C,0BADa,OAAO,CAAC;YAAO,MAAM,GAAC,MAAM;KAAC,CAAC,CAG1C;IAED;;;OAGG;IACH,cAFY,OAAO,CAAC;YAAO,MAAM,GAAE,GAAG;KAAC,GAAC,IAAI,CAAC,CAa5C;IAED;;;OAGG;IACH,QAFY,OAAO,CAAC;YAAO,MAAM,GAAC,GAAG;KAAC,GAAC,MAAM,GAAC,MAAM,CAAC,CAmBpD;;CACF;0BAlNa,OAAO,yBAAyB,EAAE,WAAW;;YAQjD,OAAO"}

package/types/helpers/ResponseHeaders.d.ts

@@ -0,0 +1,126 @@
+export default class ResponseHeaders extends HeadersHandler {
+    /** @param {HttpResponse} response */
+    static cookies(response: HttpResponse): {
+        /**
+         * @param {string|CookieDetails|CookieObject} nameOrDetails
+         * @return {boolean}
+         */
+        has(nameOrDetails: string | CookieDetails | CookieObject): boolean;
+        /**
+         * @param {string|CookieDetails} partial
+         * @return {CookieObject}
+         */
+        get(partial: string | CookieDetails): CookieObject;
+        /**
+         * @param {string|CookieDetails} [partial]
+         * @return {CookieObject[]}
+         */
+        getAll(partial?: string | CookieDetails): CookieObject[];
+        /**
+         * @param {CookieDetails} details
+         * @return {CookieObject}
+         */
+        find(details: CookieDetails): CookieObject;
+        /**
+         * @param {CookieDetails} [details]
+         * @return {CookieObject[]}
+         */
+        findAll(details?: CookieDetails): CookieObject[];
+        /**
+         * @param {string|CookieDetails} cookie
+         * @return {CookieObject}
+         */
+        set(cookie: string | CookieDetails): CookieObject;
+        /**
+         * @param {string|CookieDetails} partial
+         * @return {number} count
+         */
+        remove(partial: string | CookieDetails): number;
+        /**
+         * @param {string|CookieDetails} partial name or details
+         * @return {CookieObject}
+         */
+        expire(partial: string | CookieDetails): CookieObject;
+        /**
+         * @param {string|CookieDetails} [partial]
+         * @return {CookieObject[]}
+         */
+        expireAll(partial?: string | CookieDetails): CookieObject[];
+    };
+    /** @param {HttpResponse} response */
+    constructor(response: HttpResponse);
+    /** @param {string} contentType */
+    set contentType(contentType: string);
+    get contentType(): string;
+    /** @param {string} mediaType */
+    set mediaType(mediaType: string);
+    get mediaType(): string;
+    /** @param {string} charset */
+    set charset(charset: string);
+    get charset(): string;
+    /** @param {BufferEncoding} bufferEncoding */
+    set charsetAsBufferEncoding(bufferEncoding: BufferEncoding);
+    /** @return {BufferEncoding} */
+    get charsetAsBufferEncoding(): BufferEncoding;
+    /** @param {string} boundary */
+    set boundary(boundary: string);
+    get boundary(): string;
+    /** @param {number} value */
+    set contentLength(value: number);
+    get contentLength(): number;
+    get cookies(): {
+        /**
+         * @param {string|CookieDetails|CookieObject} nameOrDetails
+         * @return {boolean}
+         */
+        has(nameOrDetails: string | CookieDetails | CookieObject): boolean;
+        /**
+         * @param {string|CookieDetails} partial
+         * @return {CookieObject}
+         */
+        get(partial: string | CookieDetails): CookieObject;
+        /**
+         * @param {string|CookieDetails} [partial]
+         * @return {CookieObject[]}
+         */
+        getAll(partial?: string | CookieDetails): CookieObject[];
+        /**
+         * @param {CookieDetails} details
+         * @return {CookieObject}
+         */
+        find(details: CookieDetails): CookieObject;
+        /**
+         * @param {CookieDetails} [details]
+         * @return {CookieObject[]}
+         */
+        findAll(details?: CookieDetails): CookieObject[];
+        /**
+         * @param {string|CookieDetails} cookie
+         * @return {CookieObject}
+         */
+        set(cookie: string | CookieDetails): CookieObject;
+        /**
+         * @param {string|CookieDetails} partial
+         * @return {number} count
+         */
+        remove(partial: string | CookieDetails): number;
+        /**
+         * @param {string|CookieDetails} partial name or details
+         * @return {CookieObject}
+         */
+        expire(partial: string | CookieDetails): CookieObject;
+        /**
+         * @param {string|CookieDetails} [partial]
+         * @return {CookieObject[]}
+         */
+        expireAll(partial?: string | CookieDetails): CookieObject[];
+    };
+    /** @return {Array<CookieObject>} */
+    get cookieEntries(): Array<CookieObject>;
+    #private;
+}
+export type HttpResponse = import("../lib/HttpResponse.js").default;
+export type CookieDetails = import("../data/custom-types.js").CookieDetails;
+import HeadersHandler from './HeadersParser.js';
+import CookieObject from '../data/CookieObject.js';
+//# sourceMappingURL=ResponseHeaders.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ResponseHeaders.d.ts","sourceRoot":"","sources":["../../helpers/ResponseHeaders.js"],"names":[],"mappings":"AAuBA;IASE,qCAAqC;IACrC,yBADY,YAAY;QAsIpB;;;WAGG;2BAFQ,MAAM,GAAC,aAAa,GAAC,YAAY,GAChC,OAAO;QAKnB;;;WAGG;qBAFQ,MAAM,GAAC,aAAa,GACnB,YAAY;QAKxB;;;WAGG;yBAFQ,MAAM,GAAC,aAAa,GACnB,YAAY,EAAE;QAW1B;;;WAGG;sBAFQ,aAAa,GACZ,YAAY;QAKxB;;;WAGG;0BAFQ,aAAa,GACZ,YAAY,EAAE;QAmB1B;;;WAGG;oBAFQ,MAAM,GAAC,aAAa,GACnB,YAAY;QAmBxB;;;WAGG;wBAFQ,MAAM,GAAC,aAAa,GACnB,MAAM;QAUlB;;;WAGG;wBAFQ,MAAM,GAAC,aAAa,GACnB,YAAY;QAcxB;;;WAGG;4BAFQ,MAAM,GAAC,aAAa,GACnB,YAAY,EAAE;MA5O7B;IAZD,qCAAqC;IACrC,sBADY,YAAY,EAMvB;IA4BD,kCAAkC;IAClC,6BADY,MAAM,EAGjB;IAPD,mBAIY,MAAM,CAFjB;IAWD,gCAAgC;IAChC,yBADY,MAAM,EAQjB;IAZD,iBAIY,MAAM,CAFjB;IAgBD,8BAA8B;IAC9B,qBADY,MAAM,EAQjB;IAZD,eAIY,MAAM,CAFjB;IAoCD,6CAA6C;IAC7C,4CADY,cAAc,EAsBzB;IA9CD,+BAA+B;IAC/B,+BADa,cAAc,CAsB1B;IA8BD,+BAA+B;IAC/B,uBADY,MAAM,EAQjB;IAZD,gBAIY,MAAM,CAFjB;IAgBD,4BAA4B;IAC5B,yBADY,MAAM,EAGjB;IAPD,qBAIY,MAAM,CAFjB;IAOD;QAII;;;WAGG;2BAFQ,MAAM,GAAC,aAAa,GAAC,YAAY,GAChC,OAAO;QAKnB;;;WAGG;qBAFQ,MAAM,GAAC,aAAa,GACnB,YAAY;QAKxB;;;WAGG;yBAFQ,MAAM,GAAC,aAAa,GACnB,YAAY,EAAE;QAW1B;;;WAGG;sBAFQ,aAAa,GACZ,YAAY;QAKxB;;;WAGG;0BAFQ,aAAa,GACZ,YAAY,EAAE;QAmB1B;;;WAGG;oBAFQ,MAAM,GAAC,aAAa,GACnB,YAAY;QAmBxB;;;WAGG;wBAFQ,MAAM,GAAC,aAAa,GACnB,MAAM;QAUlB;;;WAGG;wBAFQ,MAAM,GAAC,aAAa,GACnB,YAAY;QAcxB;;;WAGG;4BAFQ,MAAM,GAAC,aAAa,GACnB,YAAY,EAAE;MAY7B;IAED,oCAAoC;IACpC,qBADa,KAAK,CAAC,YAAY,CAAC,CAoD/B;;CACF;2BA/Ua,OAAO,wBAAwB,EAAE,OAAO;4BACxC,OAAO,yBAAyB,EAAE,aAAa;2BAHlC,oBAAoB;yBAFtB,yBAAyB"}

package/types/helpers/index.d.ts

@@ -0,0 +1,6 @@
+export { default as HttpListener } from "./HttpListener.js";
+export { default as HeadersParser } from "./HeadersParser.js";
+export { default as RequestHeaders } from "./RequestHeaders.js";
+export { default as RequestReader } from "./RequestReader.js";
+export { default as ResponseHeaders } from "./ResponseHeaders.js";
+//# sourceMappingURL=index.d.ts.map

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

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