@h3ravel/http 11.15.0-alpha.16 → 11.17.0

package/dist/index.cjs

@@ -1,4240 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region \0rolldown/runtime.js
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-//#endregion
-let _h3ravel_musket = require("@h3ravel/musket");
-let _h3ravel_shared = require("@h3ravel/shared");
-let execa = require("execa");
-let preferred_pm = require("preferred-pm");
-preferred_pm = __toESM(preferred_pm, 1);
-let fs_promises = require("fs/promises");
-let _h3ravel_contracts = require("@h3ravel/contracts");
-let _h3ravel_foundation = require("@h3ravel/foundation");
-let _h3ravel_support_facades = require("@h3ravel/support/facades");
-let _h3ravel_support = require("@h3ravel/support");
-let h3 = require("h3");
-let node_path = require("node:path");
-node_path = __toESM(node_path, 1);
-//#region src/Commands/FireCommand.ts
-var FireCommand = class extends _h3ravel_musket.Command {
-	/**
-	* The name and signature of the console command.
-	*
-	* @var string
-	*/
-	signature = `fire:
-        {--a|host=localhost : The host address to serve the application on}
-        {--p|port=3000 : The port to serve the application on}
-        {--t|tries=10 : The max number of ports to attempt to serve from}
-    `;
-	/**
-	* The console command description.
-	*
-	* @var string
-	*/
-	description = "Fire up the developement server";
-	async handle() {
-		try {
-			await this.fire();
-		} catch (e) {
-			_h3ravel_shared.Logger.error(e);
-		}
-	}
-	async fire() {
-		const outDir = env("DIST_DIR", ".h3ravel/serve");
-		const pm = (await (0, preferred_pm.default)(base_path()))?.name ?? "pnpm";
-		const port = this.option("port");
-		const host = this.option("host");
-		const tries = this.option("tries");
-		const verbose = Number(this.option("verbose", 0));
-		const ENV_VARS = {
-			EXTENDED_DEBUG: verbose > 0 ? "true" : "false",
-			CLI_BUILD: "false",
-			NODE_ENV: "development",
-			DIST_DIR: outDir,
-			HOSTNAME: host,
-			RETRIES: tries,
-			PORT: port,
-			VERBOSE: verbose,
-			LOG_LEVEL: [
-				"silent",
-				"silent",
-				"info",
-				"warn",
-				"error"
-			][verbose]
-		};
-		await (0, execa.execa)(pm, [
-			"tsdown",
-			ENV_VARS.LOG_LEVEL === "silent" ? "--silent" : null,
-			"--config-loader",
-			"unrun",
-			"-c",
-			"tsdown.default.config.ts"
-		].filter((e) => e !== null), {
-			stdout: "inherit",
-			stderr: "inherit",
-			cwd: base_path(),
-			env: Object.assign({}, process.env, ENV_VARS)
-		});
-	}
-};
-//#endregion
-//#region src/Exceptions/BadRequestException.ts
-var BadRequestException = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "BadRequestException";
-	}
-};
-//#endregion
-//#region src/Exceptions/ConflictingHeadersException.ts
-var ConflictingHeadersException = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "ConflictingHeadersException";
-	}
-};
-//#endregion
-//#region src/Exceptions/HttpResponseException.ts
-var HttpResponseException = class extends Error {
-	/**
-	* The underlying response instance.
-	*/
-	response;
-	/**
-	* Create a new HTTP response exception instance.
-	* 
-	* @param response 
-	* @param previous 
-	*/
-	constructor(response, previous) {
-		super(previous?.message ?? "");
-		this.name = "HttpResponseException";
-		this.response = response;
-	}
-	/**
-	* Get the underlying response instance.
-	*/
-	getResponse() {
-		return this.response;
-	}
-};
-//#endregion
-//#region src/Exceptions/SuspiciousOperationException.ts
-var SuspiciousOperationException = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "SuspiciousOperationException";
-	}
-};
-//#endregion
-//#region src/Exceptions/UnexpectedValueException.ts
-var UnexpectedValueException = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "UnexpectedValueException";
-	}
-};
-//#endregion
-//#region src/UploadedFile.ts
-var UploadedFile = class UploadedFile {
-	originalName;
-	mimeType;
-	size;
-	content;
-	constructor(originalName, mimeType, size, content) {
-		this.originalName = originalName;
-		this.mimeType = mimeType;
-		this.size = size;
-		this.content = content;
-	}
-	static createFromBase(file) {
-		return new UploadedFile(file.name, file.type, file.size, file);
-	}
-	/**
-	* Save to disk (Node environment only)
-	*/
-	async moveTo(destination) {
-		await (0, fs_promises.writeFile)(destination, Buffer.from(await this.content.arrayBuffer()));
-	}
-};
-//#endregion
-//#region src/FormRequest.ts
-var FormRequest = class {
-	dataset;
-	constructor(data) {
-		this.initialize(data);
-	}
-	/**
-	* Initialize the data
-	* @param data 
-	*/
-	initialize(data) {
-		this.dataset = {
-			files: {},
-			input: {}
-		};
-		for (const [rawKey, value] of data.entries()) {
-			const key = rawKey.endsWith("[]") ? rawKey.slice(0, -2) : rawKey;
-			if (value instanceof UploadedFile || value instanceof File) {
-				const uploaded = value instanceof UploadedFile ? value : UploadedFile.createFromBase(value);
-				if (this.dataset.files[key]) {
-					const existing = this.dataset.files[key];
-					if (Array.isArray(existing)) existing.push(uploaded);
-					else this.dataset.files[key] = [existing, uploaded];
-				} else this.dataset.files[key] = uploaded;
-			} else if (this.dataset.input[key]) {
-				const existing = this.dataset.input[key];
-				if (Array.isArray(existing)) existing.push(value);
-				else this.dataset.input[key] = [existing, value];
-			} else this.dataset.input[key] = value;
-		}
-	}
-	/**
-	* Get all uploaded files
-	*/
-	files() {
-		return this.dataset.files;
-	}
-	/**
-	* Get all input fields
-	*/
-	input() {
-		return this.dataset.input;
-	}
-	/**
-	* Get combined input and files
-	* File entries take precedence if names overlap.
-	*/
-	all() {
-		return Object.assign({}, this.dataset.input, this.dataset.files);
-	}
-};
-//#endregion
-//#region \0@oxc-project+runtime@0.135.0/helpers/esm/decorateMetadata.js
-function __decorateMetadata(k, v) {
-	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-}
-//#endregion
-//#region \0@oxc-project+runtime@0.135.0/helpers/esm/decorate.js
-function __decorate(decorators, target, key, desc) {
-	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-	return c > 3 && r && Object.defineProperty(target, key, r), r;
-}
-//#endregion
-//#region src/Middleware.ts
-let Middleware = class Middleware extends _h3ravel_contracts.IMiddleware {
-	app;
-	constructor(app) {
-		super();
-		this.app = app;
-	}
-};
-Middleware = __decorate([(0, _h3ravel_foundation.Injectable)(), __decorateMetadata("design:paramtypes", [typeof _h3ravel_contracts.IApplication === "undefined" ? Object : _h3ravel_contracts.IApplication])], Middleware);
-//#endregion
-//#region src/Middleware/FlashDataMiddleware.ts
-var FlashDataMiddleware = class extends Middleware {
-	async handle(request, next) {
-		const _next = await next(request);
-		request.session().ageFlashData();
-		return _next;
-	}
-};
-__decorate([
-	(0, _h3ravel_foundation.Injectable)(),
-	__decorateMetadata("design:type", Function),
-	__decorateMetadata("design:paramtypes", [typeof Request === "undefined" ? Object : Request, Function]),
-	__decorateMetadata("design:returntype", Promise)
-], FlashDataMiddleware.prototype, "handle", null);
-//#endregion
-//#region src/Middleware/LogRequests.ts
-var LogRequests = class extends Middleware {
-	async handle(request, next) {
-		const _next = await next(request);
-		const code = Number(_h3ravel_support_facades.Response.getStatusCode());
-		const method = request.method().toLowerCase();
-		let color = "bgRed";
-		if (code < 200) color = "bgWhite";
-		else if (code >= 200 && code <= 300) color = "bgBlue";
-		else if (code >= 300 && code <= 400) color = "bgYellow";
-		let mColor = "bgYellow";
-		if (method == "get") mColor = "bgBlue";
-		else if (method == "head") mColor = "bgGray";
-		else if (method == "delete") mColor = "bgRed";
-		_h3ravel_shared.Logger.log([
-			[` ${method.toUpperCase()} `, mColor],
-			[request.fullUrl(), "white"],
-			["→", "blue"],
-			[` ${code} `, color]
-		], " ");
-		return _next;
-	}
-};
-__decorate([
-	(0, _h3ravel_foundation.Injectable)(),
-	__decorateMetadata("design:type", Function),
-	__decorateMetadata("design:paramtypes", [typeof _h3ravel_contracts.IRequest === "undefined" ? Object : _h3ravel_contracts.IRequest, Function]),
-	__decorateMetadata("design:returntype", Promise)
-], LogRequests.prototype, "handle", null);
-//#endregion
-//#region src/HttpContext.ts
-/**
-* Represents the HTTP context for a single request lifecycle.
-* Encapsulates the application instance, request, and response objects.
-*/
-var HttpContext = class HttpContext extends _h3ravel_contracts.IHttpContext {
-	app;
-	request;
-	response;
-	static contexts = /* @__PURE__ */ new WeakMap();
-	event;
-	constructor(app, request, response) {
-		super();
-		this.app = app;
-		this.request = request;
-		this.response = response;
-		this.app.bindMiddleware("LogRequests", LogRequests);
-		this.app.bindMiddleware("FlashDataMiddleware", FlashDataMiddleware);
-	}
-	/**
-	* Factory method to create a new HttpContext instance from a context object.
-	* @param ctx - Object containing app, request, and response
-	* @returns A new HttpContext instance
-	*/
-	static init(ctx, event) {
-		if (!!event && HttpContext.contexts.has(event)) return HttpContext.contexts.get(event);
-		const instance = new HttpContext(ctx.app, ctx.request, ctx.response);
-		instance.event = event;
-		ctx.request.context = instance;
-		ctx.response.context = instance;
-		ctx.app.setHttpContext(instance);
-		if (event) HttpContext.contexts.set(event, instance);
-		return instance;
-	}
-	/**
-	* Retrieve an existing HttpContext instance for an event, if any.
-	*/
-	static get(event) {
-		return HttpContext.contexts.get(event);
-	}
-	/**
-	* Delete the cached context for a given event (optional cleanup).
-	*/
-	static forget(event) {
-		HttpContext.contexts.delete(event);
-	}
-};
-//#endregion
-//#region src/Utilities/HeaderBag.ts
-/**
-* HeaderBag — A container for HTTP headers
-* for H3ravel App.
-*/
-var HeaderBag = class HeaderBag extends _h3ravel_contracts.IHeaderBag {
-	static UPPER = "_ABCDEFGHIJKLMNOPQRSTUVWXYZ";
-	static LOWER = "-abcdefghijklmnopqrstuvwxyz";
-	headers = {};
-	headerNames = {};
-	cacheControl = {};
-	constructor(headers = {}) {
-		super();
-		for (const [key, values] of Object.entries(headers)) {
-			this.set(key, values);
-			if (key.startsWith("HTTP_")) this.set(key.slice(5), values);
-		}
-	}
-	/**
-	* Returns all headers as string (for debugging / toString) 
-	* 
-	* @returns 
-	*/
-	toString() {
-		const headers = this.all();
-		if (!Object.keys(headers).length) return "";
-		const sortedKeys = Object.keys(headers).sort();
-		const max = Math.max(...sortedKeys.map((k) => k.length)) + 1;
-		let content = "";
-		for (const name of sortedKeys) {
-			const values = headers[name] ?? [];
-			const displayName = name.split("-").map((p) => p.charAt(0).toUpperCase() + p.slice(1)).join("-");
-			for (const value of values) content += `${displayName + ":"}`.padEnd(max + 1, " ") + `${value ?? ""}\r\n`;
-		}
-		return content;
-	}
-	/**
-	* Returns all headers or specific header list
-	* 
-	* @param key 
-	* @returns 
-	*/
-	all(key) {
-		if (key !== void 0) return this.headers[this.normalizeKey(key)] ?? [];
-		return this.headers;
-	}
-	/**
-	* Returns header keys
-	* 
-	* @returns 
-	*/
-	keys() {
-		return Object.keys(this.headers);
-	}
-	/**
-	* Replace all headers with new set
-	* 
-	* @param headers 
-	*/
-	replace(headers = {}) {
-		this.headers = {};
-		this.add(headers);
-	}
-	/**
-	* Add multiple headers
-	* 
-	* @param headers 
-	*/
-	add(headers) {
-		for (const [key, values] of Object.entries(headers)) this.set(key, values);
-	}
-	/**
-	* Returns first header value by name or default
-	* 
-	* @param key 
-	* @param defaultValue 
-	* @returns 
-	*/
-	get(key, defaultValue = null) {
-		const headers = this.all(key) || this.all("http-" + key);
-		if (!headers.length) return defaultValue;
-		return headers[0];
-	}
-	/**
-	* Sets a header by name.
-	* 
-	* @param replace Whether to replace existing values (default true)
-	*/
-	set(key, values, replace = true) {
-		const normalized = this.normalizeKey(key);
-		if (Array.isArray(values)) {
-			const valList = values.map((v) => v === void 0 ? null : v);
-			if (replace || !this.headers[normalized]) this.headers[normalized] = valList;
-			else this.headers[normalized].push(...valList);
-		} else {
-			const val = values === void 0 ? null : values;
-			if (replace || !this.headers[normalized]) this.headers[normalized] = [val];
-			else this.headers[normalized].push(val);
-		}
-		if (normalized === "cache-control") this.cacheControl = this.parseCacheControl((this.headers[normalized] ?? []).join(", "));
-	}
-	/**
-	* Returns true if header exists
-	* 
-	* @param key 
-	* @returns 
-	*/
-	has(key) {
-		return Object.prototype.hasOwnProperty.call(this.headers, this.normalizeKey(key));
-	}
-	/**
-	* Returns true if header contains value
-	* 
-	* @param key 
-	* @param value 
-	* @returns 
-	*/
-	contains(key, value) {
-		return this.all(key).includes(value);
-	}
-	/**
-	* Removes a header
-	* 
-	* @param key 
-	*/
-	remove(key) {
-		const normalized = this.normalizeKey(key);
-		delete this.headers[normalized];
-		if (normalized === "cache-control") this.cacheControl = {};
-	}
-	/**
-	* Returns parsed date from header
-	* 
-	* @param key 
-	* @param defaultValue 
-	* @returns 
-	*/
-	getDate(key, defaultValue = null) {
-		const value = this.get(key);
-		if (!value) return defaultValue ? _h3ravel_support.DateTime.parse(defaultValue) : void 0;
-		const parsed = _h3ravel_support.DateTime.parse(value);
-		if (isNaN(parsed.unix())) throw new _h3ravel_support.RuntimeException(`The "${key}" HTTP header is not parseable (${value}).`);
-		return parsed;
-	}
-	/**
-	* Adds a Cache-Control directive
-	* 
-	* @param key 
-	* @param value 
-	*/
-	addCacheControlDirective(key, value = true) {
-		this.cacheControl[key] = value;
-		this.set("Cache-Control", this.getCacheControlHeader());
-	}
-	/**
-	* Returns true if Cache-Control directive is defined
-	* 
-	* @param key 
-	* @returns 
-	*/
-	hasCacheControlDirective(key) {
-		return Object.prototype.hasOwnProperty.call(this.cacheControl, key);
-	}
-	/**
-	* Returns a Cache-Control directive value by name
-	* 
-	* @param key 
-	* @returns 
-	*/
-	getCacheControlDirective(key) {
-		return this.cacheControl[key] ?? null;
-	}
-	/**
-	* Removes a Cache-Control directive
-	* 
-	* @param key 
-	* @returns 
-	*/
-	removeCacheControlDirective(key) {
-		delete this.cacheControl[key];
-		this.set("Cache-Control", this.getCacheControlHeader());
-	}
-	/**
-	* Number of headers
-	* 
-	* @param key 
-	* @returns 
-	*/
-	count() {
-		return Object.keys(this.headers).length;
-	}
-	/**
-	* Normalize header name to lowercase with hyphens
-	* 
-	* @param key 
-	* @returns 
-	*/
-	normalizeKey(key) {
-		return key.replace(/[A-Z_]/g, (ch) => {
-			const idx = HeaderBag.UPPER.indexOf(ch);
-			return idx === -1 ? ch : HeaderBag.LOWER[idx];
-		}).toLowerCase();
-	}
-	/**
-	* Generates Cache-Control header string
-	* 
-	* @param header 
-	* @returns 
-	*/
-	getCacheControlHeader() {
-		return Object.entries(this.cacheControl).sort(([a], [b]) => a.localeCompare(b)).map(([k, v]) => v === true ? k : v === false ? "" : `${k}=${v}`).filter(Boolean).join(", ");
-	}
-	/**
-	* Parses Cache-Control header
-	* 
-	* @param header 
-	* @returns 
-	*/
-	parseCacheControl(header) {
-		const directives = {};
-		const parts = header.split(",").map((p) => p.trim()).filter(Boolean);
-		for (const part of parts) {
-			const [key, val] = part.split("=", 2);
-			directives[key.trim()] = val !== void 0 ? val.trim() : true;
-		}
-		return directives;
-	}
-	/**
-	* Iterator support
-	* @returns 
-	*/
-	[Symbol.iterator]() {
-		return Object.entries(this.headers)[Symbol.iterator]();
-	}
-};
-//#endregion
-//#region src/Utilities/HeaderUtility.ts
-/**
-* HTTP header utility functions .
-*/
-var HeaderUtility = class HeaderUtility {
-	static DISPOSITION_ATTACHMENT = "attachment";
-	static DISPOSITION_INLINE = "inline";
-	constructor() {}
-	/**
-	* Splits an HTTP header by one or more separators.
-	*
-	* Example:
-	* HeaderUtility.split('da, en-gb;q=0.8', ',;')
-	* // returns [['da'], ['en-gb', 'q=0.8']]
-	*/
-	static split(header, separators) {
-		if (!separators) throw new Error("At least one separator must be specified.");
-		const quotedSeparators = separators.replace(/[-/\\^$*+?.()|[\]{}]/g, "\\$&");
-		const regex = new RegExp(`(?!\\s)(?:(?:"(?:[^"\\\\]|\\\\.)*(?:"|\\\\|$))|[^"${quotedSeparators}"]+)+(?<!\\s)|\\s*(?<separator>[${quotedSeparators}])\\s*`, "g");
-		const matches = [];
-		let match;
-		while ((match = regex.exec(header.trim())) !== null) matches.push(match.groups ? {
-			separator: match.groups.separator ?? "",
-			0: match[0]
-		} : { 0: match[0] });
-		return this.groupParts(matches, separators);
-	}
-	/**
-	* Combines an array of arrays into one associative object.
-	* [['foo', 'abc'], ['bar']] => { foo: 'abc', bar: true }
-	*/
-	static combine(parts) {
-		const assoc = {};
-		for (const part of parts) {
-			const name = String(part[0]).toLowerCase();
-			assoc[name] = part[1] ?? true;
-		}
-		return assoc;
-	}
-	/**
-	* Joins an associative object into a string for use in an HTTP header.
-	* { foo: 'abc', bar: true, baz: 'a b c' } => 'foo=abc, bar, baz="a b c"'
-	*/
-	static toString(assoc, separator) {
-		return Object.entries(assoc).map(([name, value]) => {
-			return value === true ? name : `${name}=${HeaderUtility.quote(value)}`;
-		}).join(`${separator} `);
-	}
-	/**
-	* Encodes a string as a quoted string, if necessary.
-	*/
-	static quote(s) {
-		if (/^[a-z0-9!#$%&'*.^_`|~-]+$/i.test(s)) return s;
-		return `"${s.replace(/(["\\])/g, "\\$1")}"`;
-	}
-	/**
-	* Decodes a quoted string.
-	*/
-	static unquote(s) {
-		return s.replace(/\\(.)|"/g, "$1");
-	}
-	/**
-	* Generates an HTTP Content-Disposition field-value.
-	*
-	* @see RFC 6266
-	*/
-	static makeDisposition(disposition, filename, filenameFallback = "") {
-		if (![HeaderUtility.DISPOSITION_ATTACHMENT, HeaderUtility.DISPOSITION_INLINE].includes(disposition)) throw new Error(`The disposition must be either "${HeaderUtility.DISPOSITION_ATTACHMENT}" or "${HeaderUtility.DISPOSITION_INLINE}".`);
-		if (filenameFallback === "") filenameFallback = filename;
-		if (!/^[\x20-\x7e]*$/.test(filenameFallback)) throw new _h3ravel_support.InvalidArgumentException("The filename fallback must only contain ASCII characters.");
-		if (filenameFallback.includes("%")) throw new _h3ravel_support.InvalidArgumentException("The filename fallback cannot contain the \"%\" character.");
-		if ([filename, filenameFallback].some((f) => f.includes("/") || f.includes("\\"))) throw new _h3ravel_support.InvalidArgumentException("The filename and the fallback cannot contain the \"/\" and \"\\\" characters.");
-		const params = { filename: filenameFallback };
-		if (filename !== filenameFallback) params["filename*"] = `utf-8''${encodeURIComponent(filename)}`;
-		return `${disposition}; ${HeaderUtility.toString(params, ";")}`;
-	}
-	/**
-	* Like parse_str(), but preserves dots in variable names.
-	*/
-	static parseQuery(query, ignoreBrackets = false, separator = "&") {
-		const q = {};
-		const pairs = query.split(separator);
-		for (let v of pairs) {
-			const nullPos = v.indexOf("\0");
-			if (nullPos !== -1) v = v.slice(0, nullPos);
-			const eqPos = v.indexOf("=");
-			let k;
-			let val;
-			if (eqPos === -1) {
-				k = decodeURIComponent(v);
-				val = "";
-			} else {
-				k = decodeURIComponent(v.slice(0, eqPos));
-				val = v.slice(eqPos);
-			}
-			const nullKeyPos = k.indexOf("\0");
-			if (nullKeyPos !== -1) k = k.slice(0, nullKeyPos);
-			k = k.trimStart();
-			if (ignoreBrackets) {
-				q[k] = q[k] || [];
-				q[k].push(decodeURIComponent(val.slice(1)));
-				continue;
-			}
-			const bracketPos = k.indexOf("[");
-			if (bracketPos === -1) q[Buffer.from(k).toString("hex") + val] = val;
-			else {
-				const prefix = Buffer.from(k.slice(0, bracketPos)).toString("hex");
-				q[prefix + encodeURIComponent(k.slice(bracketPos)) + val] = val;
-			}
-		}
-		if (ignoreBrackets) return q;
-		const parsed = new URLSearchParams(Object.keys(q).join("&"));
-		const result = {};
-		for (const [key, value] of parsed.entries()) {
-			const underscorePos = key.indexOf("_");
-			if (underscorePos !== -1) {
-				const newKey = key.slice(0, underscorePos) + Buffer.from(key.slice(0, underscorePos), "hex").toString("utf8") + "[" + key.slice(underscorePos + 1) + "]";
-				result[newKey] = value;
-			} else result[Buffer.from(key, "hex").toString("utf8")] = value;
-		}
-		return result;
-	}
-	static groupParts(matches, separators, first = true) {
-		const separator = separators[0];
-		const rest = separators.slice(1);
-		let i = 0;
-		if (!rest && !first) {
-			const parts = [""];
-			for (const match of matches) if (!i && match.separator) {
-				i = 1;
-				parts[1] = "";
-			} else parts[i] += this.unquote(match[0]);
-			return parts;
-		}
-		const parts = [];
-		const grouped = {};
-		for (const match of matches) if (match.separator === separator) ++i;
-		else (grouped[i] ||= []).push(match);
-		for (const group of Object.values(grouped)) if (!rest && this.unquote(group[0][0]) !== "") parts.push(this.unquote(group[0][0]));
-		else {
-			const sub = this.groupParts(group, rest, false);
-			if (sub) parts.push(sub);
-		}
-		return parts;
-	}
-};
-//#endregion
-//#region src/Utilities/Cookie.ts
-/**
-* Represents a Cookie
-*/
-var Cookie = class Cookie {
-	name;
-	value;
-	domain;
-	secure;
-	httpOnly;
-	static SAMESITE_NONE = "none";
-	static SAMESITE_LAX = "lax";
-	static SAMESITE_STRICT = "strict";
-	expire;
-	path;
-	sameSite;
-	raw;
-	partitioned;
-	secureDefault = false;
-	static RESERVED_CHARS_LIST = "=,; 	\r\n\v\f";
-	static RESERVED_CHARS_FROM = [
-		"=",
-		",",
-		";",
-		" ",
-		"	",
-		"\r",
-		"\n",
-		"\v",
-		"\f"
-	];
-	static RESERVED_CHARS_TO = [
-		"%3D",
-		"%2C",
-		"%3B",
-		"%20",
-		"%09",
-		"%0D",
-		"%0A",
-		"%0B",
-		"%0C"
-	];
-	constructor(name, value, expire = 0, path = "/", domain, secure, httpOnly = true, raw = false, sameSite = Cookie.SAMESITE_LAX, partitioned = false) {
-		this.name = name;
-		this.value = value;
-		this.domain = domain;
-		this.secure = secure;
-		this.httpOnly = httpOnly;
-		if (raw && [...Cookie.RESERVED_CHARS_LIST].some((c) => name.includes(c))) throw new Error(`The cookie name "${name}" contains invalid characters.`);
-		if (!name) throw new Error("The cookie name cannot be empty.");
-		this.expire = Cookie.expiresTimestamp(expire);
-		this.path = path || "/";
-		this.sameSite = this.withSameSite(sameSite).sameSite;
-		this.raw = raw;
-		this.partitioned = partitioned;
-	}
-	/**
-	* Create a Cookie instance from a Set-Cookie header string.
-	*/
-	static fromString(cookie, decode = false) {
-		const data = {
-			expires: 0,
-			path: "/",
-			domain: null,
-			secure: false,
-			httponly: false,
-			raw: !decode,
-			samesite: null,
-			partitioned: false
-		};
-		const parts = HeaderUtility.split(cookie, ";=");
-		const part = parts.shift();
-		const name = decode ? decodeURIComponent(part[0]) : part[0];
-		const value = part[1] ? decode ? decodeURIComponent(part[1]) : part[1] : null;
-		Object.assign(data, HeaderUtility.combine(parts));
-		data.expires = Cookie.expiresTimestamp(data.expires);
-		if (data["max-age"] && (data["max-age"] > 0 || data.expires > Date.now() / 1e3)) data.expires = Math.floor(Date.now() / 1e3) + Number(data["max-age"]);
-		return new Cookie(name, value, data.expires, data.path, data.domain, data.secure, data.httponly, data.raw, data.samesite, data.partitioned);
-	}
-	/**
-	* Convert various expiration formats into a timestamp (seconds)
-	*/
-	static expiresTimestamp(expire = 0) {
-		if (expire instanceof Date) return Math.floor(expire.getTime() / 1e3);
-		if (typeof expire === "string") {
-			const parsed = Date.parse(expire);
-			if (isNaN(parsed)) throw new Error("The cookie expiration time is not valid.");
-			return Math.floor(parsed / 1e3);
-		}
-		return expire > 0 ? expire : 0;
-	}
-	clone() {
-		return Object.assign(Object.create(Object.getPrototypeOf(this)), this);
-	}
-	withValue(value) {
-		const c = this.clone();
-		c.value = value;
-		return c;
-	}
-	withDomain(domain) {
-		const c = this.clone();
-		c.domain = domain;
-		return c;
-	}
-	withPath(path) {
-		const c = this.clone();
-		c.path = path || "/";
-		return c;
-	}
-	withSecure(secure = true) {
-		const c = this.clone();
-		c.secure = secure;
-		return c;
-	}
-	withHttpOnly(httpOnly = true) {
-		const c = this.clone();
-		c.httpOnly = httpOnly;
-		return c;
-	}
-	withRaw(raw = true) {
-		const c = this.clone();
-		c.raw = raw;
-		return c;
-	}
-	withSameSite(sameSite) {
-		if (sameSite && ![
-			Cookie.SAMESITE_LAX,
-			Cookie.SAMESITE_STRICT,
-			Cookie.SAMESITE_NONE
-		].includes(sameSite.toLowerCase())) throw new Error("The \"sameSite\" value must be \"lax\", \"strict\", \"none\" or null.");
-		const c = this.clone();
-		c.sameSite = sameSite ? sameSite.toLowerCase() : null;
-		return c;
-	}
-	withPartitioned(partitioned = true) {
-		const c = this.clone();
-		c.partitioned = partitioned;
-		return c;
-	}
-	withExpires(expire) {
-		const c = this.clone();
-		c.expire = Cookie.expiresTimestamp(expire);
-		return c;
-	}
-	getName() {
-		return this.name;
-	}
-	getValue() {
-		return this.value;
-	}
-	getDomain() {
-		return this.domain;
-	}
-	getPath() {
-		return this.path;
-	}
-	getExpiresTime() {
-		return this.expire;
-	}
-	getMaxAge() {
-		if (this.expire === 0) return 0;
-		return this.expire - Math.floor(Date.now() / 1e3);
-	}
-	/**
-	* Checks whether the cookie should only be transmitted over a secure HTTPS connection from the client.
-	*/
-	isSecure() {
-		return this.secure ?? this.secureDefault;
-	}
-	isHttpOnly() {
-		return this.httpOnly;
-	}
-	isRaw() {
-		return this.raw;
-	}
-	getSameSite() {
-		return this.sameSite;
-	}
-	isPartitioned() {
-		return this.partitioned;
-	}
-	/**
-	* Whether this cookie is about to be cleared.
-	*/
-	isCleared() {
-		return 0 !== this.expire && this.expire < (/* @__PURE__ */ new Date()).getTime();
-	}
-	/**
-	* Convert the cookie to a Set-Cookie header string.
-	*/
-	toString() {
-		const from = Cookie.RESERVED_CHARS_FROM;
-		const to = Cookie.RESERVED_CHARS_TO;
-		const encodeName = (name) => this.isRaw() ? name : name.replaceAll(new RegExp(from.map((x) => `\\${x}`).join("|"), "g"), (m) => to[from.indexOf(m)]);
-		const encodeValue = (val) => this.isRaw() ? val : encodeURIComponent(val);
-		let str = `${encodeName(this.name)}=`;
-		if (!this.value) str += `deleted; expires=${(/* @__PURE__ */ new Date(Date.now() - 31536001e3)).toUTCString()}; Max-Age=0`;
-		else {
-			str += encodeValue(this.value);
-			if (this.expire !== 0) {
-				const expiresAt = (/* @__PURE__ */ new Date(this.expire * 1e3)).toUTCString();
-				str += `; expires=${expiresAt}; Max-Age=${this.getMaxAge()}`;
-			}
-		}
-		if (this.path) str += `; path=${this.path}`;
-		if (this.domain) str += `; domain=${this.domain}`;
-		if (this.isSecure()) str += "; secure";
-		if (this.isHttpOnly()) str += "; httponly";
-		if (this.sameSite) str += `; samesite=${this.sameSite}`;
-		if (this.partitioned) str += "; partitioned";
-		return str;
-	}
-	/**
-	* @param bool $default The default value of the "secure" flag when it is set to null
-	*/
-	setSecureDefault(defaultValue) {
-		this.secureDefault = defaultValue;
-	}
-};
-//#endregion
-//#region src/Utilities/ResponseHeaderBag.ts
-/**
-* ResponseHeaderBag is a container for Response HTTP headers.
-* for Node/H3 environments.
-*/
-var ResponseHeaderBag = class ResponseHeaderBag extends HeaderBag {
-	static COOKIES_FLAT = "flat";
-	static COOKIES_ARRAY = "array";
-	static DISPOSITION_ATTACHMENT = "attachment";
-	static DISPOSITION_INLINE = "inline";
-	computedCacheControl = {};
-	cookies = {};
-	headerNames = {};
-	constructor(event) {
-		super(Object.fromEntries(event.res.headers.entries()));
-		if (!this.headers["cache-control"]) this.set("Cache-Control", "");
-		if (!this.headers["date"]) this.initDate();
-	}
-	/**
-	* Returns the headers with original capitalizations.
-	*/
-	allPreserveCase() {
-		const headers = {};
-		for (const [name, value] of Object.entries(this.all())) {
-			const originalName = this.headerNames[name] ?? name;
-			headers[originalName] = value;
-		}
-		return headers;
-	}
-	allPreserveCaseWithoutCookies() {
-		const headers = this.allPreserveCase();
-		if (this.headerNames["set-cookie"]) delete headers[this.headerNames["set-cookie"]];
-		return headers;
-	}
-	replace(headers = {}) {
-		this.headerNames = {};
-		super.replace(headers);
-		if (!this.headers["cache-control"]) this.set("Cache-Control", "");
-		if (!this.headers["date"]) this.initDate();
-	}
-	all(key) {
-		const headers = super.all();
-		if (key) {
-			const normalized = key.toLowerCase();
-			if (normalized === "set-cookie") return this.getCookies().map(String);
-			return headers[normalized] ?? [];
-		}
-		const cookies = this.getCookies().map(String);
-		if (cookies.length > 0) headers["set-cookie"] = cookies;
-		return headers;
-	}
-	set(key, values, replace = true) {
-		const uniqueKey = key.toLowerCase();
-		if (uniqueKey === "set-cookie") {
-			if (replace) this.cookies = {};
-			for (const cookie of Array.isArray(values) ? values : [values]) if (cookie) this.setCookie(Cookie.fromString(cookie));
-			this.headerNames[uniqueKey] = key;
-			return;
-		}
-		this.headerNames[uniqueKey] = key;
-		super.set(key, values, replace);
-		if ([
-			"cache-control",
-			"etag",
-			"last-modified",
-			"expires"
-		].includes(uniqueKey) && this.computeCacheControlValue() !== "") {
-			const computed = this.computeCacheControlValue();
-			this.headers["cache-control"] = [computed];
-			this.headerNames["cache-control"] = "Cache-Control";
-			this.computedCacheControl = this.parseCacheControl(computed);
-		}
-	}
-	remove(key) {
-		const uniqueKey = key.toLowerCase();
-		delete this.headerNames[uniqueKey];
-		if (uniqueKey === "set-cookie") {
-			this.cookies = {};
-			return;
-		}
-		super.remove(key);
-		if (uniqueKey === "cache-control") this.computedCacheControl = {};
-		if (uniqueKey === "date") this.initDate();
-	}
-	hasCacheControlDirective(key) {
-		return key in this.computedCacheControl;
-	}
-	getCacheControlDirective(key) {
-		return this.computedCacheControl[key] ?? null;
-	}
-	setCookie(cookie) {
-		const domain = cookie.getDomain() ?? "";
-		const path = cookie.getPath() ?? "/";
-		this.cookies[domain] ??= {};
-		this.cookies[domain][path] ??= {};
-		this.cookies[domain][path][cookie.getName()] = cookie;
-		this.headerNames["set-cookie"] = "Set-Cookie";
-	}
-	removeCookie(name, path = "/", domain = null) {
-		const d = domain ?? "";
-		delete this.cookies[d]?.[path]?.[name];
-		if (this.cookies[d] && Object.keys(this.cookies[d][path] ?? {}).length === 0) {
-			delete this.cookies[d][path];
-			if (Object.keys(this.cookies[d]).length === 0) delete this.cookies[d];
-		}
-		if (Object.keys(this.cookies).length === 0) delete this.headerNames["set-cookie"];
-	}
-	/**
-	* @throws {Error} if format is invalid
-	*/
-	getCookies(format = ResponseHeaderBag.COOKIES_FLAT) {
-		if (![ResponseHeaderBag.COOKIES_FLAT, ResponseHeaderBag.COOKIES_ARRAY].includes(format)) throw new Error(`Format "${format}" invalid (${ResponseHeaderBag.COOKIES_FLAT}, ${ResponseHeaderBag.COOKIES_ARRAY}).`);
-		if (format === ResponseHeaderBag.COOKIES_ARRAY) return this.cookies;
-		const flattened = [];
-		for (const domain of Object.values(this.cookies)) for (const path of Object.values(domain)) for (const cookie of Object.values(path)) flattened.push(cookie);
-		return flattened;
-	}
-	clearCookie(name, path = "/", domain = null, secure = false, httpOnly = true, sameSite, partitioned = false) {
-		this.setCookie(new Cookie(name, null, 1, path, domain, secure, httpOnly, false, sameSite, partitioned));
-	}
-	makeDisposition(disposition, filename, fallback = "") {
-		return HeaderUtility.makeDisposition(disposition, filename, fallback);
-	}
-	computeCacheControlValue() {
-		if (Object.keys(this.cacheControl).length === 0) {
-			if (this.has("Last-Modified") || this.has("Expires")) return "private, must-revalidate";
-			return "no-cache, private";
-		}
-		const header = this.getCacheControlHeader();
-		if (this.cacheControl["public"] || this.cacheControl["private"]) return header;
-		if (!this.cacheControl["s-maxage"]) return `${header}, private`;
-		return header;
-	}
-	initDate() {
-		const now = (/* @__PURE__ */ new Date()).toUTCString();
-		this.set("Date", now);
-	}
-};
-//#endregion
-//#region src/Utilities/HttpResponse.ts
-var HttpResponse = class HttpResponse extends _h3ravel_contracts.IHttpResponse {
-	event;
-	statusCode = 200;
-	headers;
-	content;
-	version;
-	statusText;
-	charset;
-	/**
-	* @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Cache-Control
-	*/
-	HTTP_RESPONSE_CACHE_CONTROL_DIRECTIVES = _h3ravel_foundation.HTTP_RESPONSE_CACHE_CONTROL_DIRECTIVES;
-	/**
-	* The exception that triggered the error response (if applicable).
-	*/
-	exception;
-	/**
-	* Tracks headers already sent in informational responses.
-	*/
-	sentHeaders = {};
-	/**
-	* Status codes translation table.
-	*
-	* The list of codes is complete according to the
-	* @link https://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml Hypertext Transfer Protocol (HTTP) Status Code Registry
-	* (last updated 2021-10-01).
-	*
-	* Unless otherwise noted, the status code is defined in RFC2616.
-	*/
-	static statusTexts = _h3ravel_foundation.statusTexts;
-	constructor(event) {
-		super();
-		this.event = event;
-		this.headers = new ResponseHeaderBag(this.event);
-		this.setContent();
-		this.setProtocolVersion("1.0");
-	}
-	/**
-	* Set HTTP status code.
-	*/
-	setStatusCode(code, text) {
-		this.statusCode = code;
-		this.event.res.status = code;
-		if (this.isInvalid()) throw new _h3ravel_support.InvalidArgumentException(`The HTTP status code "${code}" is not valid.`);
-		if (!text) {
-			this.statusText = HttpResponse.statusTexts[code] ?? "unknown status";
-			this.event.res.statusText = this.statusText;
-			return this;
-		}
-		this.statusText = text;
-		this.event.res.statusText = this.statusText;
-		return this;
-	}
-	/**
-	* Retrieves the status code for the current web response.
-	*/
-	getStatusCode() {
-		return this.statusCode;
-	}
-	/**
-	* Sets the response charset.
-	*/
-	setCharset(charset) {
-		this.charset = charset;
-		return this;
-	}
-	/**
-	* Retrieves the response charset.
-	*/
-	getCharset() {
-		return this.charset;
-	}
-	/**
-	* Returns true if the response may safely be kept in a shared (surrogate) cache.
-	*
-	* Responses marked "private" with an explicit Cache-Control directive are
-	* considered uncacheable.
-	*
-	* Responses with neither a freshness lifetime (Expires, max-age) nor cache
-	* validator (Last-Modified, ETag) are considered uncacheable because there is
-	* no way to tell when or how to remove them from the cache.
-	*
-	* Note that RFC 7231 and RFC 7234 possibly allow for a more permissive implementation,
-	* for example "status codes that are defined as cacheable by default [...]
-	* can be reused by a cache with heuristic expiration unless otherwise indicated"
-	* (https://tools.ietf.org/html/rfc7231#section-6.1)
-	*
-	* @final
-	*/
-	isCacheable() {
-		if (![
-			200,
-			203,
-			300,
-			301,
-			302,
-			404,
-			410
-		].includes(this.statusCode)) return false;
-		if (this.headers.hasCacheControlDirective("no-store") || this.headers.getCacheControlDirective("private")) return false;
-		return this.isValidateable() || this.isFresh();
-	}
-	/**
-	* Returns true if the response is "fresh".
-	*
-	* Fresh responses may be served from cache without any interaction with the
-	* origin. A response is considered fresh when it includes a Cache-Control/max-age
-	* indicator or Expires header and the calculated age is less than the freshness lifetime.
-	*/
-	isFresh() {
-		return Number(this.getTtl()) > 0;
-	}
-	/**
-	* Returns true if the response includes headers that can be used to validate
-	* the response with the origin server using a conditional GET request.
-	*/
-	isValidateable() {
-		return this.headers.has("Last-Modified") || this.headers.has("ETag");
-	}
-	/**
-	* Sets the response content.
-	*/
-	setContent(content) {
-		this.content = content ?? "";
-		return this;
-	}
-	/**
-	* Gets the current response content.
-	*/
-	getContent() {
-		return this.content;
-	}
-	/**
-	* Set a header.
-	*/
-	setHeader(name, value) {
-		this.headers.set(name, value);
-		return this;
-	}
-	/**
-	* Sets the HTTP protocol version (1.0 or 1.1).
-	*/
-	setProtocolVersion(version) {
-		this.version = version;
-		return this;
-	}
-	/**
-	* Gets the HTTP protocol version.
-	*/
-	getProtocolVersion() {
-		return this.version;
-	}
-	/**
-	* Marks the response as "private".
-	*
-	* It makes the response ineligible for serving other clients.
-	*/
-	setPrivate() {
-		this.headers.removeCacheControlDirective("public");
-		this.headers.addCacheControlDirective("private");
-		return this;
-	}
-	/**
-	* Marks the response as "public".
-	*
-	* It makes the response eligible for serving other clients.
-	*/
-	setPublic() {
-		this.headers.addCacheControlDirective("public");
-		this.headers.removeCacheControlDirective("private");
-		return this;
-	}
-	/**
-	* Returns the Date header as a DateTime instance.
-	* @throws {RuntimeException} When the header is not parseable
-	*/
-	getDate() {
-		return this.headers.getDate("Date");
-	}
-	/**
-	* Returns the age of the response in seconds.
-	*
-	* @final
-	*/
-	getAge() {
-		const age = this.headers.get("Age");
-		if (age) return Number(age);
-		return Math.max(_h3ravel_support.DateTime.now().unix() - this.getDate().unix(), 0);
-	}
-	/**
-	* Marks the response stale by setting the Age header to be equal to the maximum age of the response.
-	*/
-	expire() {
-		if (this.isFresh()) {
-			this.headers.set("Age", String(this.getMaxAge()));
-			this.headers.remove("Expires");
-		}
-		return this;
-	}
-	/**
-	* Returns the value of the Expires header as a DateTime instance.
-	*
-	* @final
-	*/
-	getExpires() {
-		try {
-			return new _h3ravel_support.DateTime(this.headers.getDate("Expires"));
-		} catch {
-			return new _h3ravel_support.DateTime(_h3ravel_support.DateTime.now().subtract(2, "days"));
-		}
-	}
-	/**
-	* Returns the number of seconds after the time specified in the response's Date
-	* header when the response should no longer be considered fresh.
-	*
-	* First, it checks for a s-maxage directive, then a max-age directive, and then it falls
-	* back on an expires header. It returns null when no maximum age can be established. 
-	*/
-	getMaxAge() {
-		if (this.headers.hasCacheControlDirective("s-maxage")) return Number(this.headers.getCacheControlDirective("s-maxage"));
-		if (this.headers.hasCacheControlDirective("max-age")) return Number(this.headers.getCacheControlDirective("max-age"));
-		const expires = this.getExpires();
-		if (expires) {
-			const maxAge = Number(expires.unix() - this.getDate().unix());
-			return Math.max(maxAge, 0);
-		}
-	}
-	/**
-	* Sets the number of seconds after which the response should no longer be considered fresh.
-	*
-	* This method sets the Cache-Control max-age directive.
-	*/
-	setMaxAge(value) {
-		this.headers.addCacheControlDirective("max-age", String(value));
-		return this;
-	}
-	/**
-	* Sets the number of seconds after which the response should no longer be returned by shared caches when backend is down.
-	*
-	* This method sets the Cache-Control stale-if-error directive.
-	*/
-	setStaleIfError(value) {
-		this.headers.addCacheControlDirective("stale-if-error", String(value));
-		return this;
-	}
-	/**
-	* Sets the number of seconds after which the response should no longer return stale content by shared caches.
-	*
-	* This method sets the Cache-Control stale-while-revalidate directive.
-	*/
-	setStaleWhileRevalidate(value) {
-		this.headers.addCacheControlDirective("stale-while-revalidate", String(value));
-		return this;
-	}
-	/**
-	* Returns the response's time-to-live in seconds.
-	*
-	* It returns null when no freshness information is present in the response.
-	*
-	* When the response's TTL is 0, the response may not be served from cache without first
-	* revalidating with the origin.
-	*
-	* @final
-	*/
-	getTtl() {
-		const maxAge = Number(this.getMaxAge());
-		return null !== maxAge ? Math.max(maxAge - this.getAge(), 0) : void 0;
-	}
-	/**
-	* Sets the response's time-to-live for shared caches in seconds.
-	*
-	* This method adjusts the Cache-Control/s-maxage directive.
-	*/
-	setTtl(seconds) {
-		this.setSharedMaxAge(this.getAge() + seconds);
-		return this;
-	}
-	/**
-	* Sets the response's time-to-live for private/client caches in seconds.
-	*
-	* This method adjusts the Cache-Control/max-age directive.
-	*/
-	setClientTtl(seconds) {
-		this.setMaxAge(this.getAge() + seconds);
-		return this;
-	}
-	/**
-	* Sets the number of seconds after which the response should no longer be considered fresh by shared caches.
-	*
-	* This method sets the Cache-Control s-maxage directive.
-	*/
-	setSharedMaxAge(value) {
-		this.setPublic();
-		this.headers.addCacheControlDirective("s-maxage", String(value));
-		return this;
-	}
-	/**
-	* Returns the Last-Modified HTTP header as a DateTime instance.
-	*
-	* @throws \RuntimeException When the HTTP header is not parseable
-	*
-	* @final
-	*/
-	getLastModified() {
-		return this.headers.getDate("Last-Modified");
-	}
-	/**
-	* Sets the Last-Modified HTTP header with a DateTime instance.
-	*
-	* Passing null as value will remove the header.
-	*
-	* @return $this
-	*
-	* @final
-	*/
-	setLastModified(date) {
-		if (!date) {
-			this.headers.remove("Last-Modified");
-			return this;
-		}
-		date = new _h3ravel_support.DateTime(date).setTimezone("UTC");
-		this.headers.set("Last-Modified", date.format("ddd, DD MMM YYYY HH:mm:ss") + " GMT");
-		return this;
-	}
-	/**
-	* Returns the literal value of the ETag HTTP header.
-	*/
-	getEtag() {
-		return this.headers.get("ETag");
-	}
-	/**
-	* Sets the ETag value.
-	*
-	* @param etag The ETag unique identifier or null to remove the header
-	* @param weak Whether you want a weak ETag or not
-	*/
-	setEtag(etag, weak = false) {
-		if (!etag) this.headers.remove("Etag");
-		else {
-			if (!etag.startsWith("\"")) etag = "\"" + etag + "\"";
-			this.headers.set("ETag", (true === weak ? "W/" : "") + etag);
-		}
-		return this;
-	}
-	/**
-	* Sets the response's cache headers (validation and/or expiration).
-	*
-	* Available options are: must_revalidate, no_cache, no_store, no_transform, public, private, proxy_revalidate, max_age, s_maxage, immutable, last_modified and etag.
-	*
-	* @throws {InvalidArgumentException}
-	*/
-	setCache(options) {
-		const invalidKeys = Object.keys(options).filter((key) => !(key in _h3ravel_foundation.HTTP_RESPONSE_CACHE_CONTROL_DIRECTIVES));
-		if (invalidKeys.length > 0) throw new _h3ravel_support.InvalidArgumentException(`Response does not support the following options: "${invalidKeys.join("\", \"")}"`);
-		if (options.etag) this.setEtag(options.etag);
-		if (options.last_modified) this.setLastModified(options.last_modified);
-		if (options.max_age) this.setMaxAge(options.max_age);
-		if (options.s_maxage) this.setSharedMaxAge(options.s_maxage);
-		if (options.stale_while_revalidate) this.setStaleWhileRevalidate(options.stale_while_revalidate);
-		if (options.stale_if_error) this.setStaleIfError(options.stale_if_error);
-		for (const [directive, hasValue] of Object.entries(_h3ravel_foundation.HTTP_RESPONSE_CACHE_CONTROL_DIRECTIVES)) if (!hasValue && directive in options) {
-			const token = directive.replace(/_/g, "-");
-			if (options[directive]) this.headers.addCacheControlDirective(token);
-			else this.headers.removeCacheControlDirective(token);
-		}
-		if (options.public !== void 0) if (options.public) this.setPublic();
-		else this.setPrivate();
-		if (options.private !== void 0) if (options.private) this.setPrivate();
-		else this.setPublic();
-		return this;
-	}
-	/**
-	* Modifies the response so that it conforms to the rules defined for a 304 status code.
-	*
-	* This sets the status, removes the body, and discards any headers
-	* that MUST NOT be included in 304 responses.
-	* @see https://tools.ietf.org/html/rfc2616#section-10.3.5
-	*/
-	setNotModified() {
-		this.setStatusCode(304);
-		this.setContent();
-		for (const header of [
-			"Allow",
-			"Content-Encoding",
-			"Content-Language",
-			"Content-Length",
-			"Content-MD5",
-			"Content-Type",
-			"Last-Modified"
-		]) this.headers.remove(header);
-		return this;
-	}
-	/**
-	* Add an array of headers to the response.
-	*
-	*/
-	withHeaders(headers) {
-		if (headers instanceof HeaderBag) headers = headers.all();
-		for (const [key, value] of Object.entries(headers)) this.headers.set(key, value);
-		return this;
-	}
-	/**
-	* Set the exception to attach to the response.
-	*/
-	withException(e) {
-		this.exception = e;
-		return this;
-	}
-	/**
-	* Throws the response in a HttpResponseException instance.
-	*
-	* @throws {HttpResponseException}
-	*/
-	throwResponse() {
-		throw new HttpResponseException(this);
-	}
-	/**
-	* Is response invalid?
-	*
-	* @see https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html
-	*/
-	isInvalid() {
-		return this.statusCode < 100 || this.statusCode >= 600;
-	}
-	/**
-	* Is response informative?
-	*/
-	isInformational() {
-		return this.statusCode >= 100 && this.statusCode < 200;
-	}
-	/**
-	* Is response successful?
-	*/
-	isSuccessful() {
-		return this.statusCode >= 200 && this.statusCode < 300;
-	}
-	/**
-	* Is the response a redirect?
-	*/
-	isRedirection() {
-		return this.statusCode >= 300 && this.statusCode < 400;
-	}
-	/**
-	* Is there a client error?
-	*/
-	isClientError() {
-		return this.statusCode >= 400 && this.statusCode < 500;
-	}
-	/**
-	* Was there a server side error?
-	*/
-	isServerError() {
-		return this.statusCode >= 500 && this.statusCode < 600;
-	}
-	/**
-	* Is the response OK?
-	*/
-	isOk() {
-		return 200 === this.statusCode;
-	}
-	/**
-	* Is the response forbidden?
-	*/
-	isForbidden() {
-		return 403 === this.statusCode;
-	}
-	/**
-	* Is the response a not found error?
-	*/
-	isNotFound() {
-		return 404 === this.statusCode;
-	}
-	/**
-	* Is the response a redirect of some form?
-	*/
-	isRedirect(location) {
-		if (![
-			201,
-			301,
-			302,
-			303,
-			307,
-			308
-		].includes(this.statusCode)) return false;
-		if (!location) return true;
-		return location === this.headers.get("Location");
-	}
-	/**
-	* Is the response empty?
-	*/
-	isEmpty() {
-		return [204, 304].includes(this.statusCode);
-	}
-	/**
-	* Apply headers before sending response.
-	*/
-	sendHeaders(statusCode) {
-		statusCode ??= this.statusCode;
-		const informational = statusCode >= 100 && statusCode < 200;
-		for (const [name, values] of Object.entries(this.headers.allPreserveCaseWithoutCookies())) {
-			const previousValues = this.sentHeaders[name] ?? null;
-			if (previousValues && JSON.stringify(previousValues) === JSON.stringify(values)) continue;
-			const replace = name.localeCompare("Content-Type", void 0, { sensitivity: "accent" }) === 0;
-			if (previousValues && previousValues.some((v) => !values.includes(v))) this.event.res.headers.delete(name);
-			const newValues = !previousValues ? values : values.filter((v) => !previousValues.includes(v));
-			for (const value of newValues) if (replace) this.event.res.headers.set(name, value);
-			else this.event.res.headers.append(name, value);
-			if (informational) this.sentHeaders[name] = values;
-		}
-		for (const cookie of this.headers.getCookies()) this.event.res.headers.append("Set-Cookie", cookie.toString());
-		if (informational) return this;
-		this.setStatusCode(statusCode, this.statusText);
-		return this;
-	}
-	/**
-	* Prepares the Response before it is sent to the client. 
-	* 
-	* This method tweaks the Response to ensure that it is 
-	* compliant with RFC 2616. Most of the changes are based on 
-	* the Request that is "associated" with this Response.
-	**/
-	prepare(request) {
-		const isInformational = this.isInformational();
-		const isEmpty = this.isEmpty();
-		if (isInformational || isEmpty) {
-			this.setContent();
-			this.headers.remove("Content-Type");
-			this.headers.remove("Content-Length");
-			return this;
-		}
-		if (!this.headers.has("Content-Type")) {
-			const format = request.getRequestFormat();
-			if (format) {
-				const mimeType = request.getMimeType(format);
-				if (mimeType) this.headers.set("Content-Type", mimeType);
-			}
-		}
-		const charset = this.charset || "UTF-8";
-		this.charset ??= charset;
-		const currentType = this.headers.get("Content-Type") || "";
-		if (!this.headers.has("Content-Type")) this.headers.set("Content-Type", `text/html; charset=${charset}`);
-		else if (currentType.toLowerCase().startsWith("text/") && !/charset=/i.test(currentType)) this.headers.set("Content-Type", `${currentType}; charset=${charset}`);
-		if (this.headers.has("Transfer-Encoding")) this.headers.remove("Content-Length");
-		if (request.isMethod("HEAD")) {
-			const length = this.headers.get("Content-Length");
-			this.setContent(void 0);
-			if (length) this.headers.set("Content-Length", length);
-		}
-		if ((request._server?.get("SERVER_PROTOCOL") || "HTTP/1.1") !== "HTTP/1.0") this.setProtocolVersion("1.1");
-		if (this.getProtocolVersion() === "1.0" && (this.headers.get("Cache-Control") || "").includes("no-cache")) {
-			this.headers.set("pragma", "no-cache");
-			this.headers.set("expires", "-1");
-		}
-		this.ensureIEOverSSLCompatibility(request);
-		if (request.isSecure()) for (const cookie of this.headers.getCookies()) cookie.setSecureDefault(true);
-		return this;
-	}
-	/**
-	* Checks if we need to remove Cache-Control for SSL encrypted downloads when using IE < 9.
-	*
-	* @see http://support.microsoft.com/kb/323308
-	*/
-	ensureIEOverSSLCompatibility(request) {
-		const contentDisposition = this.headers.get("Content-Disposition") || "";
-		const userAgent = request.headers.get("user-agent") || "";
-		if (contentDisposition.toLowerCase().includes("attachment") && /MSIE (.*?);/i.test(userAgent) && request.headers.get("x-forwarded-proto") === "https") {
-			const match = userAgent.match(/MSIE (.*?);/i);
-			if (match) {
-				if (parseInt(match[1], 10) < 9) this.headers.remove("Cache-Control");
-			}
-		}
-	}
-};
-//#endregion
-//#region src/Utilities/Responsable.ts
-var Responsable = class extends _h3ravel_contracts.IResponsable {
-	toResponse(request) {
-		return new Response(request.app, this.body, this.status, Object.fromEntries(this.headers.entries()));
-	}
-	HTTPResponse() {
-		return super.constructor;
-	}
-};
-//#endregion
-//#region src/Response.ts
-var Response = class Response extends HttpResponse {
-	app;
-	static codes = _h3ravel_foundation.ResponseCodes;
-	initializationData = {};
-	/**
-	* The current Http Context
-	*/
-	context;
-	constructor(app, event, status = 200, headers = {}) {
-		const hasHeaders = Object.entries(headers).length > 0;
-		const content = !(event instanceof h3.H3Event) ? event : "";
-		event = event instanceof h3.H3Event ? event : app.getHttpContext("event");
-		super(event);
-		this.app = app;
-		if (content || status !== 200 || hasHeaders) {
-			this.setContent(content).setStatusCode(status);
-			if (hasHeaders) this.withHeaders(headers);
-		}
-		this.initializationData = {
-			app,
-			event,
-			status,
-			headers,
-			content
-		};
-	}
-	/**
-	* Sends content for the current web response.
-	*/
-	sendContent(type, parse) {
-		if (!type) type = _h3ravel_support.Str.detectContentType(this.content);
-		return this[type].call(this, this.content, parse);
-	}
-	/**
-	* Sends content for the current web response.
-	*/
-	send(type) {
-		return this.sendContent(type, true);
-	}
-	async view(viewPath, data, parse) {
-		const base = this.html(await this.app.make("edge").render(viewPath, data), parse);
-		return new Responsable(base.body, base);
-	}
-	async viewTemplate(content, data, parse) {
-		return this.html(await this.app.make("edge").renderRaw(content, data), parse);
-	}
-	html(content, parse) {
-		const base = this.httpResponse("text/html", content ?? this.content, parse);
-		if (base instanceof Response) return new Responsable(base.content, {
-			status: base.statusCode,
-			statusText: base.statusText,
-			headers: base.headers
-		});
-		return new Responsable(base.body, base);
-	}
-	json(data, parse) {
-		const content = data ?? this.content;
-		return this.httpResponse("application/json", typeof content !== "string" ? JSON.stringify(content) : content, parse);
-	}
-	text(content, parse) {
-		return this.httpResponse("text/plain", content ?? this.content, parse);
-	}
-	xml(data, parse) {
-		return this.httpResponse("application/xml", data ?? this.content, parse);
-	}
-	httpResponse(contentType, data, parse) {
-		if (parse) {
-			this.sendHeaders();
-			return new Responsable(data ?? this.content, {
-				status: this.statusCode,
-				statusText: this.statusText,
-				headers: { "content-type": `${contentType}; charset=${this.charset}` }
-			});
-		}
-		if (this.content?.trim()?.length <= 0) this.content = data ?? "";
-		this.setStatusCode(this.statusCode, this.statusText);
-		this.setHeader("content-type", `${contentType}; charset=${this.charset}`);
-		return this;
-	}
-	/**
-	* Redirect to another URL.
-	*/
-	redirect(location, status = 302, statusText) {
-		return this.setStatusCode(status, statusText || (status === 301 ? "Moved Permanently" : "Found")).setContent(`<html><head><meta http-equiv="refresh" content="0; url=${location.replace(/"/g, "%22")}" /></head></html>`).withHeaders({
-			"content-type": "text/html; charset=utf-8",
-			location
-		});
-	}
-	/**
-	* Dump the response.
-	*/
-	dump() {
-		dump(this.headers.all(), { charset: this.charset }, { version: this.version }, { statusText: this.statusText }, { statusCode: this.statusCode });
-		return this;
-	}
-	getEvent(key) {
-		return (0, _h3ravel_support.safeDot)(this.event, key);
-	}
-	/**
-	* Reset the response class to it's defautl
-	*/
-	reset() {
-		return this;
-	}
-};
-//#endregion
-//#region src/JsonResponse.ts
-/**
-* Response represents an HTTP response in JSON format.
-*
-* Note that this class does not force the returned JSON content to be an
-* object. It is however recommended that you do return an object as it
-* protects yourself against XSSI and JSON-JavaScript Hijacking.
-*
-* @see https://github.com/OWASP/CheatSheetSeries/blob/master/cheatsheets/AJAX_Security_Cheat_Sheet.md#always-return-json-with-an-object-on-the-outside
-*/
-var JsonResponse = class JsonResponse extends Response {
-	data;
-	callback;
-	/**
-	* @param bool $json If the data is already a JSON string
-	*/
-	constructor(app, data, status = 200, headers = {}, json = false) {
-		super(app, "", status, headers);
-		if (json && typeof data !== "string" && typeof data !== "number" && typeof data.toString === "undefined") throw new TypeError(`"${this.constructor.name}": If \`json\` is set to true, argument \`data\` must be a string or object implementing toString(), "${typeof data}" given.`);
-		data ??= {};
-		if (json) this.setJson(data);
-		else this.setData(data);
-	}
-	/**
-	* Sets the JSONP callback.
-	*
-	* @param  callback The JSONP callback or null to use none
-	*
-	* @throws {InvalidArgumentException} When the callback name is not valid
-	*/
-	setCallback(callback) {
-		if (typeof callback !== "undefined") {
-			const pattern = /^[$_\p{L}][$_\p{L}\p{Mn}\p{Mc}\p{Nd}\p{Pc}\u200C\u200D]*(?:\[(?:"(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'|\d+)\])*?$/u;
-			const reserved = [
-				"break",
-				"do",
-				"instanceof",
-				"typeof",
-				"case",
-				"else",
-				"new",
-				"var",
-				"catch",
-				"finally",
-				"return",
-				"void",
-				"continue",
-				"for",
-				"switch",
-				"while",
-				"debugger",
-				"function",
-				"this",
-				"with",
-				"default",
-				"if",
-				"throw",
-				"delete",
-				"in",
-				"try",
-				"class",
-				"enum",
-				"extends",
-				"super",
-				"const",
-				"export",
-				"import",
-				"implements",
-				"let",
-				"private",
-				"public",
-				"yield",
-				"interface",
-				"package",
-				"protected",
-				"static",
-				"null",
-				"true",
-				"false"
-			];
-			const parts = callback.split(".");
-			for (const part of parts) if (!pattern.test(part) || reserved.includes(part)) throw new _h3ravel_support.InvalidArgumentException("The callback name is not valid.");
-		}
-		this.callback = callback;
-		return this.update();
-	}
-	/**
-	* Factory method for chainability.
-	*
-	* @example
-	* 
-	* return JsonResponse.fromJsonString('{"key": "value"}').setSharedMaxAge(300);
-	*
-	* @param  data    The JSON response string
-	* @param  status  The response status code (200 "OK" by default)
-	* @param  headers An array of response headers
-	*/
-	static fromJsonString(app, data, status = 200, headers = {}) {
-		return new JsonResponse(app, data, status, headers, true);
-	}
-	/**
-	* Sets a raw string containing a JSON document to be sent.
-	* 
-	* @param json 
-	* @returns 
-	*/
-	setJson(json) {
-		this.data = json;
-		return this.update();
-	}
-	/**
-	* Sets the data to be sent as JSON.
-	* 
-	* @param data 
-	* @returns 
-	*/
-	setData(data = {}) {
-		let content;
-		try {
-			if (data.toJson === "undefined") content = JSON.stringify(data.toJson());
-			else if (data.toArray === "undefined") content = JSON.stringify(data.toArray());
-			else content = JSON.stringify(data);
-		} catch (e) {
-			if (e instanceof Error && e.message.startsWith("Failed calling ")) throw e.getPrevious() || e;
-			throw e;
-		}
-		return this.setJson(content);
-	}
-	/**
-	* Get the json_decoded data from the response.
-	*
-	* @param  assoc
-	*/
-	getData() {
-		return JSON.parse(String(this.data));
-	}
-	/**
-	* Sets the JSONP callback.
-	*
-	* @param  callback
-	*/
-	withCallback(callback) {
-		return this.setCallback(callback);
-	}
-	/**
-	* Updates the content and headers according to the JSON data and callback.
-	*/
-	update() {
-		if (typeof this.callback !== "undefined") {
-			this.headers.set("Content-Type", "text/javascript");
-			return this.setContent(`/**/${this.callback}(${this.data});`);
-		}
-		if (!this.headers.has("Content-Type") || "text/javascript" === this.headers.get("Content-Type")) this.headers.set("Content-Type", "application/json");
-		return this.setContent(this.data);
-	}
-};
-//#endregion
-//#region src/Middleware/TrustHosts.ts
-var TrustHosts = class TrustHosts extends Middleware {
-	/**
-	* The trusted hosts that have been configured to always be trusted.
-	*/
-	static alwaysTrust;
-	/**
-	* Indicates whether subdomains of the application URL should be trusted.
-	*/
-	static subdomains;
-	/**
-	* Get the host patterns that should be trusted.
-	*/
-	hosts() {
-		if (!TrustHosts.alwaysTrust) return [this.allSubdomainsOfApplicationUrl()];
-		let hosts;
-		switch (true) {
-			case Array.isArray(TrustHosts.alwaysTrust):
-				hosts = TrustHosts.alwaysTrust;
-				break;
-			case typeof TrustHosts.alwaysTrust === "function":
-				hosts = TrustHosts.alwaysTrust();
-				break;
-			default:
-				hosts = [];
-				break;
-		}
-		if (TrustHosts.subdomains) hosts.push(this.allSubdomainsOfApplicationUrl());
-		return hosts;
-	}
-	/**
-	* Handle the incoming request.
-	*
-	* @param  request
-	* @param  next
-	*/
-	async handle(request, next) {
-		if (this.shouldSpecifyTrustedHosts()) Request.setTrustedHosts(this.hosts().filter((e) => typeof e !== "undefined"));
-		return next(request);
-	}
-	/**
-	* Specify the hosts that should always be trusted.
-	*
-	* @param  hosts
-	* @param  subdomains 
-	*/
-	static at(hosts, subdomains = true) {
-		TrustHosts.alwaysTrust = hosts;
-		TrustHosts.subdomains = subdomains;
-	}
-	/**
-	* Determine if the application should specify trusted hosts.
-	*
-	* @return bool
-	*/
-	shouldSpecifyTrustedHosts() {
-		return !this.app?.environment("local") && !this.app?.runningUnitTests();
-	}
-	/**
-	* Get a regular expression matching the application URL and all of its subdomains.
-	*/
-	allSubdomainsOfApplicationUrl() {
-		const appUrl = this.app?.make("config").get("app.url");
-		const host = new URL(appUrl).host;
-		if (host) return `^(.+\\.)?${host.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}$`;
-	}
-	/**
-	* Flush the state of the middleware.
-	*
-	* @return void
-	*/
-	static flushState() {
-		TrustHosts.alwaysTrust = void 0;
-		TrustHosts.subdomains = void 0;
-	}
-};
-__decorate([
-	(0, _h3ravel_foundation.Injectable)(),
-	__decorateMetadata("design:type", Function),
-	__decorateMetadata("design:paramtypes", [typeof Request === "undefined" ? Object : Request, Function]),
-	__decorateMetadata("design:returntype", Promise)
-], TrustHosts.prototype, "handle", null);
-//#endregion
-//#region src/Providers/HttpServiceProvider.ts
-/**
-* Sets up HTTP kernel and request lifecycle.
-* 
-* Register Request, Response, and Middleware classes.
-* Configure global middleware stack.
-* Boot HTTP kernel.
-* 
-* Auto-Registered
-*/
-var HttpServiceProvider = class {
-	app;
-	static priority = 998;
-	registeredCommands;
-	constructor(app) {
-		this.app = app;
-	}
-	register() {
-		/**
-		* Register Musket Commands
-		*/
-		this.registeredCommands = [FireCommand];
-		this.app.alias([
-			[Request, "http.request"],
-			[_h3ravel_contracts.IRequest, "http.request"],
-			[Response, "http.response"],
-			[_h3ravel_contracts.IResponse, "http.response"],
-			[HttpContext, "http.context"],
-			[_h3ravel_contracts.IHttpContext, "http.context"]
-		]);
-	}
-	boot() {}
-};
-//#endregion
-//#region src/Utilities/ParamBag.ts
-/**
-* ParamBag is a container for key/value pairs
-* for Node/H3 environments.
-*/
-var ParamBag = class {
-	parameters;
-	event;
-	constructor(parameters = {}, event) {
-		this.parameters = parameters;
-		this.event = event;
-		this.parameters = { ...parameters };
-	}
-	/**
-	* Returns the parameters.
-	* @
-	* @param key The name of the parameter to return or undefined to get them all
-	*
-	* @throws BadRequestException if the value is not an array
-	*/
-	all(key) {
-		if (!key) return { ...this.parameters };
-		const value = key ? this.parameters[key] : void 0;
-		if (value && typeof value !== "object") throw new BadRequestException(`Unexpected value for parameter "${key}": expected object, got ${typeof value}`);
-		return value || {};
-	}
-	get(key, defaultValue) {
-		return key in this.parameters ? this.parameters[key] : defaultValue;
-	}
-	set(key, value) {
-		this.parameters[key] = value;
-	}
-	/**
-	* Returns true if the parameter is defined.
-	* 
-	* @param key  
-	*/
-	has(key) {
-		return Object.prototype.hasOwnProperty.call(this.parameters, key);
-	}
-	/**
-	* Removes a parameter.
-	* 
-	* @param key  
-	*/
-	remove(key) {
-		delete this.parameters[key];
-	}
-	/**
-	* 
-	* Returns the parameter as string.
-	*
-	* @param key 
-	* @param defaultValue 
-	* @throws UnexpectedValueException if the value cannot be converted to string
-	* @returns 
-	*/
-	getString(key, defaultValue = "") {
-		const value = this.get(key, defaultValue);
-		if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") return String(value);
-		throw new UnexpectedValueException(`Parameter "${key}" cannot be converted to string`);
-	}
-	/**
-	* Returns the parameter value converted to integer.
-	*
-	* @param key 
-	* @param defaultValue 
-	* @throws UnexpectedValueException if the value cannot be converted to integer
-	*/
-	getInt(key, defaultValue = 0) {
-		const value = parseInt(this.get(key, defaultValue), 10);
-		if (isNaN(value)) throw new Error(`Parameter "${key}" is not an integer`);
-		return value;
-	}
-	/**
-	* Returns the parameter value converted to boolean.
-	*
-	* @param key 
-	* @param defaultValue 
-	* @throws UnexpectedValueException if the value cannot be converted to a boolean
-	*/
-	getBoolean(key, defaultValue = false) {
-		const value = this.get(key, defaultValue);
-		if (typeof value === "boolean") return value;
-		if ([
-			"1",
-			"true",
-			"yes"
-		].includes(String(value).toLowerCase())) return true;
-		if ([
-			"0",
-			"false",
-			"no"
-		].includes(String(value).toLowerCase())) return false;
-		throw new Error(`Parameter "${key}" cannot be converted to boolean`);
-	}
-	/**
-	* Returns the alphabetic characters of the parameter value.
-	*
-	* @param key 
-	* @param defaultValue 
-	* @throws UnexpectedValueException if the value cannot be converted to string
-	*/
-	getAlpha(key, defaultValue = "") {
-		return this.getString(key, defaultValue).replace(/[^a-z]/gi, "");
-	}
-	/**
-	* Returns the alphabetic characters and digits of the parameter value.
-	*
-	* @param key 
-	* @param defaultValue 
-	* @throws UnexpectedValueException if the value cannot be converted to string
-	*/
-	getAlnum(key, defaultValue = "") {
-		return this.getString(key, defaultValue).replace(/[^a-z0-9]/gi, "");
-	}
-	/**
-	* Returns the digits of the parameter value.
-	* 
-	* @param key 
-	* @param defaultValue 
-	* @throws UnexpectedValueException if the value cannot be converted to string
-	* @returns 
-	**/
-	getDigits(key, defaultValue = "") {
-		return this.getString(key, defaultValue).replace(/\D/g, "");
-	}
-	/**
-	* Returns the parameter keys.
-	*/
-	keys() {
-		return Object.keys(this.parameters);
-	}
-	/**
-	* Replaces the current parameters by a new set.
-	*/
-	replace(parameters = {}) {
-		this.parameters = { ...parameters };
-	}
-	/**
-	* Adds parameters.
-	*/
-	add(parameters = {}) {
-		this.parameters = {
-			...this.parameters,
-			...parameters
-		};
-	}
-	/**
-	* Returns the number of parameters.
-	*/
-	count() {
-		return Object.keys(this.parameters).length;
-	}
-	/**
-	* Returns an iterator for parameters.
-	*
-	* @returns 
-	*/
-	[Symbol.iterator]() {
-		return Object.entries(this.parameters)[Symbol.iterator]();
-	}
-};
-//#endregion
-//#region src/Utilities/InputBag.ts
-/**
-* InputBag is a container for user input values
-* (e.g., query params, body, cookies)
-* for Node/H3 environments.
-*/
-var InputBag = class extends ParamBag {
-	constructor(inputs = {}, event) {
-		super(inputs, event);
-		this.add(inputs);
-	}
-	/**
-	* Returns a scalar input value by name.
-	*
-	* @param key 
-	* @param defaultValue 
-	* @throws BadRequestException if the input contains a non-scalar value
-	* @returns 
-	*/
-	get(key, defaultValue = null) {
-		if (defaultValue !== null && typeof defaultValue !== "string" && typeof defaultValue !== "number" && typeof defaultValue !== "boolean") throw new TypeError(`Expected a scalar value as 2nd argument to get(), got ${typeof defaultValue}`);
-		const value = _h3ravel_support.Obj.get(this.parameters, key, defaultValue);
-		if (value !== null && typeof value !== "string" && typeof value !== "number" && typeof value !== "boolean") throw new BadRequestException(`Input value "${key}" contains a non-scalar value.`);
-		return value;
-	}
-	/**
-	* Replaces all current input values.
-	* 
-	* @param inputs 
-	* @returns
-	*/
-	replace(inputs = {}) {
-		this.parameters = {};
-		this.add(inputs);
-	}
-	/**
-	* Adds multiple input values.
-	* 
-	* @param inputs 
-	* @returns
-	*/
-	add(inputs = {}) {
-		Object.entries(inputs).forEach(([key, value]) => this.set(key, value));
-	}
-	/**
-	* Sets an input by name.
-	*
-	* @param key 
-	* @param value 
-	* @throws TypeError if value is not scalar or array
-	* @returns
-	*/
-	set(key, value) {
-		if (value !== null && typeof value !== "string" && typeof value !== "number" && typeof value !== "boolean" && !Array.isArray(value) && typeof value !== "object") throw new TypeError(`Expected scalar, array, object, or null as value for set(), got ${typeof value}`);
-		this.parameters[key] = value;
-	}
-	/**
-	* Returns true if a key exists.
-	* 
-	* @param key 
-	* @returns
-	*/
-	has(key) {
-		return Object.prototype.hasOwnProperty.call(this.parameters, key);
-	}
-	/**
-	* Returns all parameters.
-	* 
-	* @returns
-	*/
-	all() {
-		return { ...this.parameters };
-	}
-	/**
-	* Converts a parameter value to string.
-	*
-	* @param key 
-	* @param defaultValue 
-	* @throws BadRequestException if input contains a non-scalar value
-	* @returns
-	*/
-	getString(key, defaultValue = "") {
-		const value = this.get(key, defaultValue);
-		return String(value ?? "");
-	}
-	/**
-	* Filters input value with a predicate.
-	* Mimics PHP’s filter_var() in spirit, but simpler.
-	*
-	* @param key 
-	* @param defaultValue 
-	* @param filterFn 
-	* @throws BadRequestException if validation fails
-	* @returns 
-	*/
-	filter(key, defaultValue = null, filterFn) {
-		const value = this.has(key) ? this.parameters[key] : defaultValue;
-		if (Array.isArray(value)) throw new BadRequestException(`Input value "${key}" contains an array, but array filtering not allowed.`);
-		if (filterFn && !filterFn(value)) throw new BadRequestException(`Input value "${key}" is invalid and did not pass filter.`);
-		return value;
-	}
-	/**
-	* Returns an enum value by key.
-	*
-	* @param key 
-	* @param EnumClass 
-	* @param defaultValue 
-	* @throws BadRequestException if conversion fails
-	* @returns 
-	*/
-	getEnum(key, EnumClass, defaultValue = null) {
-		const value = this.get(key, defaultValue);
-		if (value === null) return defaultValue;
-		if (!Object.values(EnumClass).includes(value)) throw new BadRequestException(`Input "${key}" cannot be converted to enum.`);
-		return value;
-	}
-	/**
-	* Removes a key.
-	*
-	* @param key 
-	*/
-	remove(key) {
-		delete this.parameters[key];
-	}
-	/**
-	* Returns all keys.
-	* 
-	* @returns
-	*/
-	keys() {
-		return Object.keys(this.parameters);
-	}
-	/**
-	* Returns number of parameters.
-	* 
-	* @returns
-	*/
-	count() {
-		return this.keys().length;
-	}
-};
-//#endregion
-//#region src/Utilities/FileBag.ts
-/**
-* FileBag is a container for uploaded files
-* for Node/H3 environments.
-*/
-var FileBag = class extends ParamBag {
-	parameters = {};
-	constructor(parameters = {}, event) {
-		super(parameters, event);
-		this.replace(parameters);
-	}
-	/**
-	* Replace all stored files.
-	*/
-	replace(files = {}) {
-		this.parameters = {};
-		this.add(files);
-	}
-	/**
-	* Set a file or array of files.
-	*/
-	set(key, value) {
-		if (Array.isArray(value)) this.parameters[key] = value.map((v) => v ? this.convertFileInformation(v) : null).filter(Boolean);
-		else if (value) this.parameters[key] = this.convertFileInformation(value);
-		else this.parameters[key] = null;
-	}
-	/**
-	* Add multiple files.
-	*/
-	add(files = {}) {
-		for (const [key, file] of Object.entries(files)) this.set(key, file);
-	}
-	/**
-	* Get all stored files.
-	*/
-	all() {
-		return this.parameters;
-	}
-	/**
-	* Normalize file input into UploadedFile instances.
-	*/
-	convertFileInformation(file) {
-		if (!file) return null;
-		if (file instanceof UploadedFile) return file;
-		if (file instanceof File) return UploadedFile.createFromBase(file);
-		throw new TypeError("Invalid file input — expected File or UploadedFile instance.");
-	}
-};
-//#endregion
-//#region src/Utilities/ServerBag.ts
-/**
-* ServerBag — a simplified version of Symfony's ServerBag
-* for Node/H3 environments.
-*
-* Responsible for extracting and normalizing HTTP headers
-* from the incoming request.
-*/
-var ServerBag = class ServerBag extends ParamBag {
-	static serverData = {};
-	constructor(parameters = {}, event) {
-		super({}, event);
-		this.add(Object.fromEntries(Object.entries(parameters).map(([k, v]) => [k.toLowerCase(), v])));
-		this.add(Object.fromEntries(Object.entries(ServerBag.initialize(event, this.getHeaders())).map(([k, v]) => [_h3ravel_support.Str.slugify(k, "-", { "_": "-" }), v])));
-		this.add(ServerBag.initialize(event, this.getHeaders()));
-	}
-	static initialize(event, headers) {
-		const req = event.req;
-		const url = new URL(req.url ?? "/");
-		const host = headers.host;
-		const method = req.method ?? "GET";
-		const protocol = (0, h3.getRequestProtocol)(event);
-		const isHttps = protocol === "https" || !!event.req.headers.get("x-forwarded-proto")?.includes("https");
-		this.serverData.SERVER_PROTOCOL = protocol;
-		this.serverData.REQUEST_METHOD = method;
-		this.serverData.REQUEST_URI = url.href;
-		this.serverData.PATH_INFO = url.pathname;
-		this.serverData.QUERY_STRING = url.search;
-		this.serverData.SERVER_NAME = host;
-		this.serverData.SERVER_PORT = url.port;
-		this.serverData.REMOTE_ADDR = void 0;
-		this.serverData.REMOTE_PORT = void 0;
-		this.serverData.HTTP_HOST = headers.HOST ?? headers.HTTP_HOST ?? host;
-		this.serverData.HTTP_USER_AGENT = headers.USER_AGENT ?? headers.HTTP_USER_AGENT ?? "";
-		this.serverData.HTTP_ACCEPT = headers.ACCEPT ?? "";
-		this.serverData.HTTP_ACCEPT_LANGUAGE = headers.ACCEPT_LANGUAGE ?? headers.HTTP_ACCEPT_LANGUAGE ?? "";
-		this.serverData.HTTP_ACCEPT_ENCODING = headers.ACCEPT_ENCODING ?? headers.HTTP_ACCEPT_ENCODING ?? "";
-		this.serverData.HTTP_REFERER = headers.REFERER ?? headers.HTTP_REFERER ?? "";
-		this.serverData.HTTPS = isHttps ? "on" : "off";
-		return this.serverData;
-	}
-	/**
-	* Returns all request headers, normalized to uppercase with underscores.
-	* Example: content-type → CONTENT_TYPE
-	*/
-	getHeaders() {
-		const headers = {};
-		for (const [key, value] of Object.entries(this.parameters)) {
-			if (value === void 0 || value === "") continue;
-			switch (key) {
-				case "accept":
-				case "content-type":
-				case "content-length":
-				case "content-md5":
-				case "authorization":
-					headers[key.toUpperCase().replace(/-/g, "_")] = value;
-					break;
-				default: headers[`HTTP_${key.toUpperCase().replace(/-/g, "_")}`] = value;
-			}
-		}
-		if (headers["HTTP_AUTHORIZATION"] || headers["AUTHORIZATION"]) {
-			const auth = headers["HTTP_AUTHORIZATION"] || headers["AUTHORIZATION"] || "";
-			if (auth.toLowerCase().startsWith("basic ")) {
-				const [user, pass] = Buffer.from(auth.slice(6), "base64").toString().split(":", 2);
-				headers["AUTH_TYPE"] = "Basic";
-				headers["AUTH_USER"] = user;
-				headers["AUTH_PASS"] = pass;
-			} else if (auth.toLowerCase().startsWith("bearer ")) {
-				headers["AUTH_TYPE"] = "Bearer";
-				headers["AUTH_TOKEN"] = auth.slice(7);
-			} else if (auth.toLowerCase().startsWith("digest ")) {
-				headers["AUTH_TYPE"] = "Digest";
-				headers["AUTH_DIGEST"] = auth;
-			}
-		}
-		return headers;
-	}
-	/**
-	* Returns a specific header by name, case-insensitive.
-	*/
-	get(name) {
-		return this.parameters[name.toLowerCase()] || this.parameters[name];
-	}
-	/**
-	* Returns true if a header exists.
-	*/
-	has(name) {
-		return name.toLowerCase() in this.parameters || name in this.parameters;
-	}
-};
-//#endregion
-//#region src/Utilities/IpUtils.ts
-/**
-* Http utility functions for IP handling.
-*/
-var IpUtils = class {
-	static PRIVATE_SUBNETS = [
-		"127.0.0.0/8",
-		"10.0.0.0/8",
-		"192.168.0.0/16",
-		"172.16.0.0/12",
-		"169.254.0.0/16",
-		"0.0.0.0/8",
-		"240.0.0.0/4",
-		"::1/128",
-		"fc00::/7",
-		"fe80::/10",
-		"::ffff:0:0/96",
-		"::/128"
-	];
-	static checkedIps = {};
-	constructor() {}
-	/**
-	* Checks if an IPv4 or IPv6 address is contained in the list of given IPs or subnets.
-	* 
-	* @param requestIp
-	* @param ips List of IPs or subnets (can be a string if only a single one)
-	*/
-	static checkIp(requestIp, ips) {
-		if (ips && !Array.isArray(ips)) ips = [ips];
-		const method = requestIp?.includes(":") ? this.checkIp6 : this.checkIp4;
-		for (const ip of ips ?? []) if (method.call(this, requestIp ?? "", ip)) return true;
-		return false;
-	}
-	/**
-	* Compares two IPv4 addresses or checks if one belongs to a CIDR subnet.
-	*
-	* @param requestIp
-	* @param ip IPv4 address or subnet in CIDR notation
-	*
-	* @return bool Whether the request IP matches the IP, or whether the request IP is within the CIDR subnet
-	*/
-	static checkIp4(requestIp, ip) {
-		const cacheKey = `${requestIp}-${ip}-v4`;
-		const cached = this.getCacheResult(cacheKey);
-		if (cached !== null) return cached;
-		if (!this.isIPv4(requestIp)) return this.setCacheResult(cacheKey, false);
-		let address;
-		let netmask;
-		if (ip.includes("/")) {
-			const parts = ip.split("/", 2);
-			address = parts[0];
-			netmask = parseInt(parts[1], 10);
-			if (netmask === 0) return this.setCacheResult(cacheKey, this.isIPv4(address));
-			if (netmask < 0 || netmask > 32) return this.setCacheResult(cacheKey, false);
-		} else {
-			address = ip;
-			netmask = 32;
-		}
-		const addrLong = this.ipv4ToLong(address);
-		const reqLong = this.ipv4ToLong(requestIp);
-		if (addrLong === null || reqLong === null) return this.setCacheResult(cacheKey, false);
-		const mask = netmask === 0 ? 0 : -1 << 32 - netmask >>> 0;
-		const result = (addrLong & mask) === (reqLong & mask);
-		return this.setCacheResult(cacheKey, result);
-	}
-	/**
-	* Compares two IPv6 addresses or checks if one belongs to a CIDR subnet.
-	* 
-	* @see https://github.com/dsp/v6tools
-	*
-	* @param requestIp
-	* @param ip IPv6 address or subnet in CIDR notation
-	*
-	* @throws {RuntimeException} When IPV6 support is not enabled
-	*/
-	static checkIp6(requestIp, ip) {
-		const cacheKey = `${requestIp}-${ip}-v6`;
-		const cached = this.getCacheResult(cacheKey);
-		if (cached !== null) return cached;
-		if (!this.isIPv6(requestIp)) return this.setCacheResult(cacheKey, false);
-		let address;
-		let netmask;
-		if (ip.includes("/")) {
-			const parts = ip.split("/", 2);
-			address = parts[0];
-			netmask = parseInt(parts[1], 10);
-			if (!this.isIPv6(address)) return this.setCacheResult(cacheKey, false);
-			if (netmask < 1 || netmask > 128) return this.setCacheResult(cacheKey, false);
-		} else {
-			address = ip;
-			netmask = 128;
-		}
-		const addrBytes = this.inetPton6(address);
-		const reqBytes = this.inetPton6(requestIp);
-		if (!addrBytes || !reqBytes) return this.setCacheResult(cacheKey, false);
-		const bytesToCheck = Math.ceil(netmask / 8);
-		for (let i = 0; i < bytesToCheck; i++) {
-			const left = netmask - i * 8;
-			const mask = 255 << 8 - (left >= 8 ? 8 : left);
-			if ((addrBytes[i] & mask) !== (reqBytes[i] & mask)) return this.setCacheResult(cacheKey, false);
-		}
-		return this.setCacheResult(cacheKey, true);
-	}
-	/**
-	* Anonymizes an IPv4/IPv6 by zeroing out trailing bytes.
-	*
-	* @param ip
-	* @param v4Bytes
-	* @param v6Bytes
-	*/
-	static anonymize(ip, v4Bytes = 1, v6Bytes = 8) {
-		if (v4Bytes < 0 || v6Bytes < 0) throw new _h3ravel_support.RuntimeException("Cannot anonymize less than 0 bytes.");
-		if (v4Bytes > 4 || v6Bytes > 16) throw new _h3ravel_support.RuntimeException("Cannot anonymize more than 4 bytes for IPv4 and 16 bytes for IPv6.");
-		if (ip.includes("%")) ip = ip.split("%")[0];
-		let wrappedIPv6 = false;
-		if (ip.startsWith("[") && ip.endsWith("]")) {
-			wrappedIPv6 = true;
-			ip = ip.slice(1, -1);
-		}
-		const packed = this.inetPton(ip);
-		if (!packed) throw new _h3ravel_support.RuntimeException("Invalid IP address");
-		let mask;
-		if (packed.length === 4) {
-			mask = new Uint8Array(4);
-			mask.fill(255, 0, 4 - v4Bytes);
-			mask.fill(0, 4 - v4Bytes);
-		} else {
-			mask = new Uint8Array(16);
-			mask.fill(255, 0, 16 - v6Bytes);
-			mask.fill(0, 16 - v6Bytes);
-		}
-		const anon = new Uint8Array(packed.length);
-		for (let i = 0; i < packed.length; i++) anon[i] = packed[i] & mask[i];
-		const result = this.inetNtop(anon);
-		return wrappedIPv6 ? `[${result}]` : result;
-	}
-	/**
-	* Checks if IP is within private subnets.
-	*/
-	static isPrivateIp(requestIp) {
-		return this.checkIp(requestIp, this.PRIVATE_SUBNETS);
-	}
-	static isIPv4(ip) {
-		return /^(\d{1,3}\.){3}\d{1,3}$/.test(ip);
-	}
-	static isIPv6(ip) {
-		return ip.includes(":");
-	}
-	static ipv4ToLong(ip) {
-		const parts = ip.split(".").map((n) => parseInt(n, 10));
-		if (parts.length !== 4 || parts.some((n) => n < 0 || n > 255)) return null;
-		return (parts[0] << 24 >>> 0) + (parts[1] << 16 >>> 0) + (parts[2] << 8 >>> 0) + parts[3] >>> 0;
-	}
-	static inetPton(ip) {
-		try {
-			return this.isIPv4(ip) ? this.inetPton4(ip) : this.inetPton6(ip);
-		} catch {
-			return null;
-		}
-	}
-	static inetPton4(ip) {
-		return new Uint8Array(ip.split(".").map((n) => parseInt(n, 10)));
-	}
-	static inetPton6(ip) {
-		const buf = new Uint8Array(16);
-		try {
-			const parts = ip.split("::");
-			const left = parts[0] ? parts[0].split(":") : [];
-			const right = parts[1] ? parts[1].split(":") : [];
-			const fill = 8 - (left.length + right.length);
-			const full = [
-				...left,
-				...Array(fill).fill("0"),
-				...right
-			].map((p) => parseInt(p || "0", 16));
-			for (let i = 0; i < 8; i++) {
-				buf[i * 2] = full[i] >> 8 & 255;
-				buf[i * 2 + 1] = full[i] & 255;
-			}
-			return buf;
-		} catch {
-			return null;
-		}
-	}
-	static inetNtop(buf) {
-		if (buf.length === 4) return Array.from(buf).join(".");
-		const words = [];
-		for (let i = 0; i < 16; i += 2) words.push((buf[i] << 8 | buf[i + 1]).toString(16));
-		return words.join(":").replace(/(^|:)0(:0)*:0(:|$)/, "::");
-	}
-	static getCacheResult(key) {
-		if (key in this.checkedIps) {
-			const val = this.checkedIps[key];
-			delete this.checkedIps[key];
-			this.checkedIps[key] = val;
-			return val;
-		}
-		return null;
-	}
-	static setCacheResult(key, result) {
-		if (Object.keys(this.checkedIps).length > 1e3) {
-			const entries = Object.entries(this.checkedIps).slice(500);
-			this.checkedIps = Object.fromEntries(entries);
-		}
-		this.checkedIps[key] = result;
-		return result;
-	}
-};
-//#endregion
-//#region src/Utilities/HttpRequest.ts
-var HttpRequest = class HttpRequest {
-	event;
-	app;
-	static HEADER_FORWARDED = 1;
-	static HEADER_X_FORWARDED_FOR = 2;
-	static HEADER_X_FORWARDED_HOST = 4;
-	static HEADER_X_FORWARDED_PROTO = 8;
-	static HEADER_X_FORWARDED_PORT = 16;
-	static HEADER_X_FORWARDED_PREFIX = 32;
-	static HEADER_X_FORWARDED_AWS_ELB = 26;
-	static HEADER_X_FORWARDED_TRAEFIK = 62;
-	static METHOD_HEAD = "HEAD";
-	static METHOD_GET = "GET";
-	static METHOD_POST = "POST";
-	static METHOD_PUT = "PUT";
-	static METHOD_PATCH = "PATCH";
-	static METHOD_DELETE = "DELETE";
-	static METHOD_PURGE = "PURGE";
-	static METHOD_OPTIONS = "OPTIONS";
-	static METHOD_TRACE = "TRACE";
-	static METHOD_CONNECT = "CONNECT";
-	/**
-	* Names for headers that can be trusted when
-	* using trusted proxies.
-	*
-	* The FORWARDED header is the standard as of rfc7239.
-	*
-	* The other headers are non-standard, but widely used
-	* by popular reverse proxies (like Apache mod_proxy or Amazon EC2).
-	*/
-	TRUSTED_HEADERS = {
-		[HttpRequest.HEADER_FORWARDED]: "FORWARDED",
-		[HttpRequest.HEADER_X_FORWARDED_FOR]: "X_FORWARDED_FOR",
-		[HttpRequest.HEADER_X_FORWARDED_HOST]: "X_FORWARDED_HOST",
-		[HttpRequest.HEADER_X_FORWARDED_PROTO]: "X_FORWARDED_PROTO",
-		[HttpRequest.HEADER_X_FORWARDED_PORT]: "X_FORWARDED_PORT",
-		[HttpRequest.HEADER_X_FORWARDED_PREFIX]: "X_FORWARDED_PREFIX"
-	};
-	FORWARDED_PARAMS = {
-		[HttpRequest.HEADER_X_FORWARDED_FOR]: "for",
-		[HttpRequest.HEADER_X_FORWARDED_HOST]: "host",
-		[HttpRequest.HEADER_X_FORWARDED_PROTO]: "proto",
-		[HttpRequest.HEADER_X_FORWARDED_PORT]: "host"
-	};
-	#uri;
-	/**
-	* Parsed request body
-	*/
-	body;
-	#method = void 0;
-	#isHostValid = true;
-	#isIisRewrite = false;
-	format;
-	basePath;
-	baseUrl;
-	requestUri;
-	pathInfo;
-	formData;
-	preferredFormat;
-	isForwardedValid = true;
-	static trustedHosts = [];
-	static trustedHeaderSet = -1;
-	static trustedHostPatterns = [];
-	/**
-	* Gets route parameters.
-	* @returns An object containing route parameters.
-	*/
-	params;
-	/**
-	* Request body parameters (POST).
-	*
-	* @see getPayload() for portability between content types
-	*/
-	request;
-	/**
-	* Uploaded files (FILES).
-	*/
-	files;
-	/**
-	* Query string parameters (GET).
-	*/
-	_query;
-	/**
-	* Server and execution environment parameters
-	*/
-	_server;
-	/**
-	* Cookies
-	*/
-	cookies;
-	/**
-	* The current Http Context
-	*/
-	context;
-	/**
-	* The request attributes (parameters parsed from the PATH_INFO, ...).
-	*/
-	attributes;
-	/**
-	* Gets the request headers.
-	* @returns An object containing request headers.
-	*/
-	headers;
-	content = void 0;
-	static formats = void 0;
-	static trustedProxies = [];
-	static httpMethodParameterOverride = false;
-	sessionManager;
-	sessionManagerClass;
-	/**
-	* List of Acceptable Content Types
-	*/
-	acceptableContentTypes = [];
-	trustedValuesCache = {};
-	constructor(event, app) {
-		this.event = event;
-		this.app = app;
-	}
-	/**
-	* Sets the parameters for this request.
-	*
-	* This method also re-initializes all properties.
-	*
-	* @param attributes 
-	* @param cookies    The COOKIE parameters
-	* @param files      The FILES parameters
-	* @param server     The SERVER parameters
-	* @param content    The raw body data
-	*/
-	initialize() {
-		this.buildRequirements();
-	}
-	buildRequirements() {
-		this.params = (0, h3.getRouterParams)(this.event);
-		this.request = new InputBag(this.formData ? this.formData.input() : {}, this.event);
-		this._query = new InputBag((0, h3.getQuery)(this.event), this.event);
-		this.attributes = new ParamBag((0, h3.getRouterParams)(this.event), this.event);
-		this.cookies = new InputBag((0, h3.parseCookies)(this.event), this.event);
-		this.files = new FileBag(this.formData ? this.formData.files() : {}, this.event);
-		this._server = new ServerBag(Object.fromEntries(this.event.req.headers.entries()), this.event);
-		this.headers = new HeaderBag(this._server.getHeaders());
-		this.acceptableContentTypes = [];
-		this.pathInfo = void 0;
-		this.requestUri = void 0;
-		this.baseUrl = void 0;
-		this.basePath = void 0;
-		this.#method = void 0;
-		this.format = void 0;
-	}
-	/**
-	* Gets a list of content types acceptable by the client browser in preferable order.
-	* @returns {string[]}
-	*/
-	getAcceptableContentTypes() {
-		if (this.acceptableContentTypes.length > 0) return this.acceptableContentTypes;
-		const accept = this.getHeader("accept");
-		if (!accept) return [];
-		const types = accept.split(",").map((type) => type.trim()).map((type) => type.split(";")[0]).filter(Boolean);
-		return this.acceptableContentTypes = types;
-	}
-	/**
-	* Get a URI instance for the request.
-	*/
-	getUriInstance() {
-		return this.#uri;
-	}
-	/**
-	* Returns the requested URI (path and query string).
-	*
-	* @return {string} The raw URI (i.e. not URI decoded)
-	*/
-	getRequestUri() {
-		return this.requestUri ??= this.prepareRequestUri();
-	}
-	/**
-	* Gets the scheme and HTTP host.
-	*
-	* If the URL was called with basic authentication, the user
-	* and the password are not added to the generated string.
-	*/
-	getSchemeAndHttpHost() {
-		return this.getScheme() + "://" + this.getHttpHost();
-	}
-	/**
-	* Returns the HTTP host being requested.
-	*
-	* The port name will be appended to the host if it's non-standard.
-	*/
-	getHttpHost() {
-		const scheme = this.getScheme();
-		const port = this.getPort();
-		if ("http" === scheme && 80 == port || "https" === scheme && 443 == port) return this.getHost();
-		return this.getHost() + ":" + port;
-	}
-	/**
-	* Returns the root path from which this request is executed.
-	*
-	* @returns {string} The raw path (i.e. not urldecoded)
-	*/
-	getBasePath() {
-		return this.basePath ??= this.prepareBasePath();
-	}
-	/**
-	* Returns the root URL from which this request is executed.
-	*
-	* The base URL never ends with a /.
-	*
-	* This is similar to getBasePath(), except that it also includes the
-	* script filename (e.g. index.php) if one exists.
-	*
-	* @return string The raw URL (i.e. not urldecoded)
-	*/
-	getBaseUrl() {
-		let trustedPrefix = "";
-		let trustedPrefixValues;
-		if (this.isFromTrustedProxy() && (trustedPrefixValues = this.getTrustedValues(HttpRequest.HEADER_X_FORWARDED_PREFIX))) trustedPrefix = _h3ravel_support.Str.rtrim(trustedPrefixValues[0], "/");
-		return trustedPrefix + this.getBaseUrlReal();
-	}
-	/**
-	* Returns the real base URL received by the webserver from which this request is executed.
-	* The URL does not include trusted reverse proxy prefix.
-	*
-	* @return string The raw URL (i.e. not urldecoded)
-	*/
-	getBaseUrlReal() {
-		return this.baseUrl ??= this.prepareBaseUrl();
-	}
-	/**
-	* Gets the request's scheme.
-	*/
-	getScheme() {
-		return this.isSecure() ? "https" : "http";
-	}
-	/**
-	* Prepares the base URL.
-	*/
-	prepareBaseUrl() {
-		const requestUri = this.getRequestUri() ?? "";
-		const baseUrl = "/" + node_path.default.basename(__filename);
-		const normalizedRequestUri = requestUri.startsWith("/") ? requestUri : "/" + requestUri;
-		if (normalizedRequestUri.startsWith(baseUrl)) return baseUrl;
-		const dirBase = node_path.default.dirname(baseUrl);
-		if (normalizedRequestUri.startsWith(dirBase)) return dirBase.replace(/[/\\]+$/, "");
-		return "";
-	}
-	/**
-	* Prepares the Request URI.
-	*/
-	prepareRequestUri() {
-		let requestUri = "";
-		const unencodedUrl = this._server.get("x-original-url") ?? "";
-		if (this.isIisRewrite() && unencodedUrl) {
-			requestUri = unencodedUrl;
-			this._server.remove("x-original-url");
-		} else if (this._server.has("REQUEST_URI")) {
-			requestUri = this._server.get("REQUEST_URI") ?? "";
-			if (requestUri && requestUri[0] === "/") {
-				const hashPos = requestUri.indexOf("#");
-				if (hashPos !== -1) requestUri = requestUri.substring(0, hashPos);
-			} else try {
-				const urlObj = new URL(requestUri);
-				requestUri = urlObj.pathname;
-				if (urlObj.search) requestUri += urlObj.search;
-			} catch {}
-		} else requestUri = this.getRequestUri() ?? "/";
-		this._server.set("REQUEST_URI", requestUri);
-		return requestUri;
-	}
-	/**
-	* Prepares the base path.
-	*/
-	prepareBasePath() {
-		const baseUrl = this.getBaseUrl();
-		if (!baseUrl) return "";
-		const scriptFilename = this._server.get("SCRIPT_FILENAME") ?? "";
-		const filename = node_path.default.basename(scriptFilename);
-		let basePath;
-		if (node_path.default.basename(baseUrl) === filename) basePath = node_path.default.dirname(baseUrl);
-		else basePath = baseUrl;
-		basePath = basePath.replace(/\\/g, "/");
-		return basePath.replace(/\/+$/, "");
-	}
-	/**
-	* Prepares the path info.
-	*/
-	preparePathInfo() {
-		let requestUri = this.getRequestUri();
-		if (!requestUri) return "/";
-		const qPos = requestUri.indexOf("?");
-		if (qPos !== -1) requestUri = requestUri.substring(0, qPos);
-		if (requestUri && requestUri[0] !== "/") requestUri = "/" + requestUri;
-		const baseUrl = this.getBaseUrlReal();
-		if (baseUrl == null) return requestUri;
-		let pathInfo = requestUri.substring(baseUrl.length);
-		if (!pathInfo || pathInfo[0] !== "/") pathInfo = "/" + pathInfo;
-		return pathInfo;
-	}
-	/**
-	* Returns the port on which the request is made.
-	*
-	* This method can read the client port from the "X-Forwarded-Port" header
-	* when trusted proxies were set via "setTrustedProxies()".
-	*
-	* The "X-Forwarded-Port" header must contain the client port.
-	*
-	* @return int|string|null Can be a string if fetched from the server bag
-	*/
-	getPort() {
-		let pos;
-		let host;
-		if (this.isFromTrustedProxy() && (host = this.getTrustedValues(HttpRequest.HEADER_X_FORWARDED_PORT))) host = host[0];
-		else if (this.isFromTrustedProxy() && (host = this.getTrustedValues(HttpRequest.HEADER_X_FORWARDED_HOST))) host = host[0];
-		else if (!(host = this.headers.get("HOST"))) return this._server.get("SERVER_PORT");
-		if (host[0] === "[") pos = host.lastIndexOf(":", host.lastIndexOf("]"));
-		else pos = host.lastIndexOf(":");
-		if (pos !== -1) {
-			const portStr = typeof host === "string" ? host.substring(pos + 1) : host.at(0)?.substring(pos + 1);
-			if (portStr) return parseInt(portStr, 10);
-		}
-		return "https" === this.getScheme() ? 443 : 80;
-	}
-	getHost() {
-		let host;
-		if (this.isFromTrustedProxy() && (host = this.getTrustedValues(HttpRequest.HEADER_X_FORWARDED_HOST)?.[0])) {} else if (!(host = this.headers.get("HOST"))) host = this._server.get("SERVER_NAME") ?? this._server.get("SERVER_ADDR") ?? process.env.SERVER_NAME ?? "";
-		host = (host ?? "").trim().replace(/:\d+$/, "").toLowerCase();
-		if (host && !HttpRequest.isHostValid(host)) {
-			if (!this.#isHostValid) return "";
-			this.#isHostValid = false;
-			throw new SuspiciousOperationException(`Invalid Host "${host}".`);
-		}
-		const ctor = this.constructor;
-		if (ctor.trustedHostPatterns.length > 0) {
-			if (ctor.trustedHosts.includes(host)) return host;
-			for (const pattern of ctor.trustedHostPatterns) if (pattern.test(host)) {
-				ctor.trustedHosts.push(host);
-				return host;
-			}
-			if (!this.#isHostValid) return "";
-			this.#isHostValid = false;
-			throw new SuspiciousOperationException(`Untrusted Host "${host}".`);
-		}
-		return host;
-	}
-	/**
-	* Checks whether the request is secure or not.
-	*
-	* This method can read the client protocol from the "X-Forwarded-Proto" header
-	* when trusted proxies were set via "setTrustedProxies()".
-	*
-	* The "X-Forwarded-Proto" header must contain the protocol: "https" or "http".
-	*/
-	isSecure() {
-		const proto = this.getTrustedValues(HttpRequest.HEADER_X_FORWARDED_PROTO);
-		if (this.isFromTrustedProxy() && proto) return [
-			"https",
-			"on",
-			"ssl",
-			"1"
-		].includes(proto[0]?.toLowerCase());
-		const https = this._server.get("HTTPS");
-		return !!https && "off" !== https.toLowerCase();
-	}
-	/**
-	* Is this IIS with UrlRewriteModule?
-	*
-	* This method consumes, caches and removed the IIS_WasUrlRewritten env var,
-	* so we don't inherit it to sub-requests.
-	*/
-	isIisRewrite() {
-		try {
-			if (1 === this._server.getInt("IIS_WasUrlRewritten")) {
-				this.#isIisRewrite = true;
-				this._server.remove("IIS_WasUrlRewritten");
-			}
-		} catch {}
-		return this.#isIisRewrite;
-	}
-	/**
-	* Returns the value of the requested header.
-	*/
-	getHeader(name) {
-		return this.headers.get(name);
-	}
-	/**
-	* Checks if the request method is of specified type.
-	*
-	* @param method Uppercase request method (GET, POST etc)
-	*/
-	isMethod(method) {
-		return this.getMethod() === method.toUpperCase();
-	}
-	/**
-	* Checks whether or not the method is safe.
-	*
-	* @see https://tools.ietf.org/html/rfc7231#section-4.2.1
-	*/
-	isMethodSafe() {
-		return [
-			"GET",
-			"HEAD",
-			"OPTIONS",
-			"TRACE"
-		].includes(this.getMethod());
-	}
-	/**
-	* Checks whether or not the method is idempotent.
-	*/
-	isMethodIdempotent() {
-		return [
-			"HEAD",
-			"GET",
-			"PUT",
-			"DELETE",
-			"TRACE",
-			"OPTIONS",
-			"PURGE"
-		].includes(this.getMethod());
-	}
-	/**
-	* Checks whether the method is cacheable or not.
-	*
-	* @see https://tools.ietf.org/html/rfc7231#section-4.2.3
-	*/
-	isMethodCacheable() {
-		return ["GET", "HEAD"].includes(this.getMethod());
-	}
-	/**
-	* Returns true if the request is an XMLHttpRequest (AJAX).
-	*/
-	isXmlHttpRequest() {
-		return "XMLHttpRequest" === this.getHeader("X-Requested-With");
-	}
-	/**
-	* See https://url.spec.whatwg.org/.
-	*/
-	static isHostValid(host) {
-		/**
-		* Validate IPv6: [::1] or similar
-		*/
-		if (host[0] === "[") {
-			if (host[host.length - 1] === "]") {
-				const inside = host.substring(1, host.length - 1);
-				return _h3ravel_support.Str.validateIp(inside, "ipv6");
-			}
-			return false;
-		}
-		/**
-		* Validate IPv4: ends with .123 or .123.
-		*/
-		if (/\.[0-9]+\.?$/.test(host)) return _h3ravel_support.Str.validateIp(host, "ipv4");
-		/**
-		* fallback: remove valid chars and check if anything remains
-		*/
-		return "" === host.replace(/[-a-zA-Z0-9_]+\.?/g, "");
-	}
-	/**
-	* Initializes HTTP request formats.
-	*/
-	static initializeFormats() {
-		this.formats = {
-			html: ["text/html", "application/xhtml+xml"],
-			txt: ["text/plain"],
-			js: [
-				"application/javascript",
-				"application/x-javascript",
-				"text/javascript"
-			],
-			css: ["text/css"],
-			json: ["application/json", "application/x-json"],
-			jsonld: ["application/ld+json"],
-			xml: [
-				"text/xml",
-				"application/xml",
-				"application/x-xml"
-			],
-			rdf: ["application/rdf+xml"],
-			atom: ["application/atom+xml"],
-			rss: ["application/rss+xml"],
-			form: ["application/x-www-form-urlencoded", "multipart/form-data"]
-		};
-	}
-	/**
-	* Gets the request "intended" method.
-	*
-	* If the X-HTTP-Method-Override header is set, and if the method is a POST,
-	* then it is used to determine the "real" intended HTTP method.
-	*
-	* The _method request parameter can also be used to determine the HTTP method,
-	* but only if enableHttpMethodParameterOverride() has been called.
-	*
-	* The method is always an uppercased string.
-	*
-	* @see getRealMethod()
-	*/
-	getMethod() {
-		if (this.#method) return this.#method;
-		this.#method = this.getRealMethod();
-		if ("POST" !== this.#method) return this.#method;
-		let method = this.event.req.headers.get("X-HTTP-METHOD-OVERRIDE");
-		if (!method && HttpRequest.httpMethodParameterOverride) method = this.request.get("_method", this._query.get("_method", "POST"));
-		if (typeof method !== "string") return this.#method;
-		method = method.toUpperCase();
-		if ([
-			"GET",
-			"HEAD",
-			"POST",
-			"PUT",
-			"DELETE",
-			"CONNECT",
-			"OPTIONS",
-			"PATCH",
-			"PURGE",
-			"TRACE"
-		].includes(method)) {
-			this.#method = method;
-			return this.#method;
-		}
-		if (!/^[A-Z]+$/.test(method)) throw new SuspiciousOperationException("Invalid HTTP method override.");
-		this.#method = method;
-		return this.#method;
-	}
-	/**
-	* Gets the preferred format for the response by inspecting, in the following order:
-	*   * the request format set using setRequestFormat;
-	*   * the values of the Accept HTTP header.
-	*
-	* Note that if you use this method, you should send the "Vary: Accept" header
-	* in the response to prevent any issues with intermediary HTTP caches.
-	*/
-	getPreferredFormat(defaultValue = "html") {
-		const preferredFormat = this.getRequestFormat();
-		if (!this.preferredFormat && !!preferredFormat) this.preferredFormat = preferredFormat;
-		if (this.preferredFormat ?? null) return this.preferredFormat;
-		for (const mimeType of this.getAcceptableContentTypes()) {
-			this.preferredFormat = this.getFormat(mimeType);
-			if (this.preferredFormat) return this.preferredFormat;
-		}
-		return defaultValue;
-	}
-	/**
-	* Gets the format associated with the mime type.
-	*/
-	getFormat(mimeType) {
-		const pos = mimeType.indexOf(";");
-		let canonicalMimeType = null;
-		if (mimeType && pos > -1) canonicalMimeType = mimeType.slice(0, pos).trim();
-		if (!HttpRequest.formats) HttpRequest.initializeFormats();
-		let exactFormat = null;
-		let canonicalFormat = null;
-		for (const [format, mimeTypes] of Object.entries(HttpRequest.formats ?? {})) {
-			if (mimeTypes.includes(mimeType)) exactFormat = format;
-			if (null !== canonicalMimeType && mimeTypes.includes(canonicalMimeType)) canonicalFormat = format;
-		}
-		if (exactFormat ?? canonicalFormat) return exactFormat ?? canonicalFormat;
-	}
-	/**
-	* Gets the request format.
-	*
-	* Here is the process to determine the format:
-	*
-	*  * format defined by the user (with setRequestFormat())
-	*  * _format request attribute
-	*  * $default
-	*
-	* @see getPreferredFormat
-	*/
-	getRequestFormat(defaultValue = "html") {
-		this.format ??= this.attributes.get("_format");
-		return this.format ?? defaultValue;
-	}
-	/**
-	* Sets the request format.
-	*/
-	setRequestFormat(format) {
-		this.format = format;
-	}
-	/**
-	* Gets the "real" request method.
-	*
-	* @see getMethod()
-	*/
-	getRealMethod() {
-		return this.event.req.method.toUpperCase();
-	}
-	/**
-	* Gets the mime type associated with the format.
-	*/
-	getMimeType(format) {
-		if (!HttpRequest.formats) HttpRequest.initializeFormats();
-		return HttpRequest.formats?.[format] ? HttpRequest.formats[format][0] : void 0;
-	}
-	/**
-	* Gets the mime types associated with the format.
-	*/
-	static getMimeTypes(format) {
-		if (!HttpRequest.formats) HttpRequest.initializeFormats();
-		return HttpRequest.formats?.[format] ?? [];
-	}
-	/**
-	* Gets the list of trusted proxies.
-	*/
-	static getTrustedProxies() {
-		return this.trustedProxies;
-	}
-	/**
-	* Returns the request body content.
-	*
-	* @param asStream If true, returns a ReadableStream instead of the parsed string
-	* @return {string | ReadableStream | Promise<string | ReadableStream>}
-	*/
-	getContent(asStream = false) {
-		let content = this.body;
-		if (content !== void 0 && content !== null) {
-			if (asStream) {
-				if (content instanceof ReadableStream) return content;
-				const encoder = new TextEncoder();
-				return new ReadableStream({ start(controller) {
-					controller.enqueue(encoder.encode(String(content)));
-					controller.close();
-				} });
-			}
-			if (typeof content === "string") return content;
-		}
-		if (asStream) return this.content;
-		content = this.content;
-		this.body = content;
-		return content;
-	}
-	/**
-	* Gets a "parameter" value from any bag.
-	*
-	* This method is mainly useful for libraries that want to provide some flexibility. If you don't need the
-	* flexibility in controllers, it is better to explicitly get request parameters from the appropriate
-	* public property instead (attributes, query, request).
-	*
-	* Order of precedence: PATH (routing placeholders or custom attributes), GET, POST
-	*
-	* @internal use explicit input sources instead
-	*/
-	get(key, defaultValue) {
-		const result = this.attributes.get(key, this);
-		if (this !== result) return result;
-		if (this._query.has(key)) return this._query.all()[key];
-		if (this.request.has(key)) return this.request.all()[key];
-		return defaultValue;
-	}
-	/**
-	* Indicates whether this request originated from a trusted proxy.
-	*
-	* This can be useful to determine whether or not to trust the
-	* contents of a proxy-specific header.
-	*/
-	isFromTrustedProxy() {
-		return !HttpRequest.trustedProxies?.length && IpUtils.checkIp(this._server.get("REMOTE_ADDR"), HttpRequest.trustedProxies);
-	}
-	/**
-	* This method is rather heavy because it splits and merges headers, and it's called by many other methods such as
-	* getPort(), isSecure(), getHost(), getClientIps(), this.() etc. Thus, we try to cache the results for
-	* best performance.
-	*/
-	getTrustedValues(type, ip) {
-		const trustedHeaders = this.TRUSTED_HEADERS;
-		const trustedHeaderSet = HttpRequest.trustedHeaderSet;
-		const cacheKey = type + "\0" + (trustedHeaderSet & type ? this.headers.get(trustedHeaders[type]) ?? "" : "") + "\0" + (ip ?? "") + "\0" + (this.headers.get(trustedHeaders[HttpRequest.HEADER_FORWARDED]) ?? "");
-		if (this.trustedValuesCache[cacheKey]) return this.trustedValuesCache[cacheKey];
-		let clientValues = [];
-		let forwardedValues = [];
-		if (trustedHeaderSet & type && this.headers.has(trustedHeaders[type])) {
-			const headerValue = this.headers.get(trustedHeaders[type]);
-			for (const v of headerValue.split(",")) {
-				const value = (type === HttpRequest.HEADER_X_FORWARDED_PORT ? "0.0.0.0:" : "") + v.trim();
-				clientValues.push(value);
-			}
-		}
-		if (trustedHeaderSet & HttpRequest.HEADER_FORWARDED && this.FORWARDED_PARAMS[type] && this.headers.has(trustedHeaders[HttpRequest.HEADER_FORWARDED])) {
-			const forwarded = this.headers.get(trustedHeaders[HttpRequest.HEADER_FORWARDED]);
-			const parts = HeaderUtility.split(forwarded, ",;=");
-			const param = this.FORWARDED_PARAMS[type];
-			for (const subParts of parts) {
-				let v = HeaderUtility.combine(subParts)[param];
-				if (typeof v === "boolean") v = "0";
-				if (v == null) continue;
-				if (type === HttpRequest.HEADER_X_FORWARDED_PORT) {
-					if (v.endsWith("]") || !(v = v.substring(v.lastIndexOf(":")))) v = this.isSecure() ? ":443" : ":80";
-					v = "0.0.0.0" + v;
-				}
-				forwardedValues.push(v);
-			}
-		}
-		if (ip != null) {
-			clientValues = this.normalizeAndFilterClientIps(clientValues, ip);
-			forwardedValues = this.normalizeAndFilterClientIps(forwardedValues, ip);
-		}
-		if (JSON.stringify(forwardedValues) === JSON.stringify(clientValues) || clientValues.length === 0) {
-			this.trustedValuesCache[cacheKey] = forwardedValues;
-			return forwardedValues;
-		}
-		if (forwardedValues.length === 0) {
-			this.trustedValuesCache[cacheKey] = clientValues;
-			return clientValues;
-		}
-		if (!this.isForwardedValid) {
-			const fallback = ip != null ? ["0.0.0.0", ip] : [];
-			this.trustedValuesCache[cacheKey] = fallback;
-			return fallback;
-		}
-		this.isForwardedValid = false;
-		throw new ConflictingHeadersException(`The request has both a trusted "${trustedHeaders[HttpRequest.HEADER_FORWARDED]}" header and a trusted "${trustedHeaders[type]}" header, conflicting with each other. You should either configure your proxy to remove one of them, or configure your project to distrust the offending one.`);
-	}
-	/**
-	* 
-	* @param clientIps 
-	* @param ip 
-	* @returns 
-	*/
-	normalizeAndFilterClientIps(clientIps, ip) {
-		if (!clientIps || clientIps.length === 0) return [];
-		clientIps = [...clientIps, ip];
-		let firstTrustedIp = null;
-		for (let i = 0; i < clientIps.length; i++) {
-			let clientIp = clientIps[i];
-			if (clientIp.includes(".")) {
-				const colonIndex = clientIp.indexOf(":");
-				if (colonIndex > -1) {
-					clientIp = clientIp.substring(0, colonIndex);
-					clientIps[i] = clientIp;
-				}
-			} else if (clientIp.startsWith("[")) {
-				const endBracketIndex = clientIp.indexOf("]", 1);
-				if (endBracketIndex > -1) {
-					clientIp = clientIp.substring(1, endBracketIndex);
-					clientIps[i] = clientIp;
-				}
-			}
-			if (_h3ravel_support.Str.validateIp(clientIp)) {
-				clientIps.splice(i, 1);
-				i--;
-				continue;
-			}
-			if (IpUtils.checkIp(clientIp, HttpRequest.trustedProxies)) {
-				clientIps.splice(i, 1);
-				i--;
-				firstTrustedIp ??= clientIp;
-			}
-		}
-		return clientIps.length > 0 ? clientIps.reverse() : firstTrustedIp ? [firstTrustedIp] : [];
-	}
-	/**
-	* Sets a list of trusted host patterns.
-	*
-	* You should only list the hosts you manage using regexes.
-	* 
-	* @param hostPatterns 
-	*/
-	static setTrustedHosts(hostPatterns) {
-		this.trustedHostPatterns = hostPatterns.map((hostPattern) => new RegExp(hostPattern, "i"));
-		/**
-		* reset trusted hosts when patterns change
-		*/
-		this.trustedHosts = [];
-	}
-	/**
-	* Returns the path being requested relative to the executed script.
-	*
-	* The path info always starts with a /.
-	*
-	* @return {string} The raw path (i.e. not urldecoded)
-	*/
-	getPathInfo() {
-		return this.pathInfo ??= this.preparePathInfo();
-	}
-	/**
-	* Gets the list of trusted host patterns.
-	*/
-	static getTrustedHosts() {
-		return this.trustedHostPatterns;
-	}
-	/**
-	* Enables support for the _method request parameter to determine the intended HTTP method.
-	*
-	* Be warned that enabling this feature might lead to CSRF issues in your code.
-	* Check that you are using CSRF tokens when required.
-	* If the HTTP method parameter override is enabled, an html-form with method "POST" can be altered
-	* and used to send a "PUT" or "DELETE" request via the _method request parameter.
-	* If these methods are not protected against CSRF, this presents a possible vulnerability.
-	*
-	* The HTTP method can only be overridden when the real HTTP method is POST.
-	*/
-	static enableHttpMethodParameterOverride() {
-		this.httpMethodParameterOverride = true;
-	}
-	/**
-	* Checks whether support for the _method request parameter is enabled.
-	*/
-	static getHttpMethodParameterOverride() {
-		return this.httpMethodParameterOverride;
-	}
-};
-//#endregion
-//#region src/Request.ts
-var Request = class Request extends HttpRequest {
-	/**
-	* The decoded JSON content for the request.
-	*/
-	#json;
-	/**
-	* All of the converted files for the request.
-	*/
-	convertedFiles;
-	/**
-	* The route resolver callback.
-	*/
-	routeResolver;
-	/**
-	* The user resolver callback.
-	*/
-	userResolver;
-	constructor(event, app) {
-		if (Request.httpMethodParameterOverride) HttpRequest.enableHttpMethodParameterOverride();
-		super(event, app);
-	}
-	/**
-	* Factory method to create a Request instance from an H3Event.
-	*/
-	static async create(event, app) {
-		const instance = new Request(event, app);
-		await instance.setBody();
-		instance.initialize();
-		return instance;
-	}
-	/**
-	* Factory method to create a syncronous Request instance from an H3Event.
-	*/
-	static createSync(event, app) {
-		const instance = new Request(event, app);
-		instance.content = event.req.body;
-		instance.body = instance.content;
-		instance.buildRequirements();
-		return instance;
-	}
-	async setBody() {
-		const type = this.event.req.headers.get("content-type") || "";
-		if (this.body) return;
-		if (type.includes("application/json")) {
-			this.body = await this.event.req.json().catch(() => ({}));
-			this.content = this.body;
-		} else if (type.includes("form-data") || type.includes("x-www-form-urlencoded")) {
-			this.formData = new FormRequest(await this.event.req.formData());
-			this.body = this.formData.all();
-			this.content = JSON.stringify(this.formData.input());
-		} else if (type.startsWith("text/")) {
-			this.body = await this.event.req.text();
-			this.content = this.body;
-		} else {
-			const content = this.event.req.body;
-			this.content = content;
-			if (content instanceof ReadableStream) {
-				const reader = content.getReader();
-				const chunks = [];
-				let done = false;
-				while (!done) {
-					const { value, done: isDone } = await reader.read();
-					if (value) chunks.push(value);
-					done = isDone;
-				}
-				this.body = new TextDecoder().decode(new Uint8Array(chunks.flatMap((chunk) => Array.from(chunk))));
-			} else this.body = content;
-		}
-	}
-	/**
-	* Validate the incoming request data
-	* 
-	* @param data 
-	* @param rules 
-	* @param messages 
-	*/
-	async validate(rules, messages = {}) {
-		const { Validator } = await import("@h3ravel/validation");
-		return await new Validator(this.all(), rules, messages).validate();
-	}
-	/**
-	* Retrieve all data from the instance (query + body).
-	*/
-	all(keys) {
-		const input = _h3ravel_support.Obj.deepMerge({}, this.input(), this.allFiles());
-		if (!keys) return input;
-		const results = {};
-		const list = Array.isArray(keys) ? keys : [keys];
-		for (const key of list) (0, _h3ravel_support.data_set)(results, key, _h3ravel_support.Obj.get(input, key));
-		return results;
-	}
-	/**
-	* Retrieve an input item from the request.
-	* 
-	* @param key 
-	* @param defaultValue 
-	* @returns 
-	*/
-	input(key, defaultValue) {
-		const source = {
-			...this.getInputSource().all(),
-			...this._query.all()
-		};
-		return key ? (0, _h3ravel_support.data_get)(source, key, defaultValue) : _h3ravel_support.Arr.except(source, ["_method"]);
-	}
-	file(key, defaultValue, expectArray) {
-		const files = (0, _h3ravel_support.data_get)(this.allFiles(), key, defaultValue);
-		if (!files) return defaultValue;
-		if (Array.isArray(files)) return expectArray ? files : files[0];
-		return files;
-	}
-	/**
-	* Get the user making the request.
-	*
-	* @param  guard
-	*/
-	user(guard) {
-		return Reflect.apply(this.getUserResolver(), this, [guard]);
-	}
-	route(param, defaultParam) {
-		const route = Reflect.apply(this.getRouteResolver(), this, []);
-		if (typeof route === "undefined" || !param) return route;
-		return route.parameter(param, defaultParam);
-	}
-	/**
-	* Determine if the uploaded data contains a file.
-	*
-	* @param  key
-	* @return boolean
-	*/
-	hasFile(key) {
-		let files = this.file(key, void 0, true);
-		if (!Array.isArray(files)) files = [files];
-		return files.some((e) => this.isValidFile(e));
-	}
-	/**
-	* Check that the given file is a valid file instance.
-	*
-	* @param file
-	* @return boolean
-	*/
-	isValidFile(file) {
-		return file.content instanceof File && file.size > 0;
-	}
-	/**
-	* Get an object with all the files on the request.
-	*/
-	allFiles() {
-		if (this.convertedFiles) return this.convertedFiles;
-		const entries = Object.entries(this.files.all()).filter((e) => e[1] != null);
-		const files = Object.fromEntries(entries);
-		this.convertedFiles = this.convertUploadedFiles(files);
-		return this.convertedFiles;
-	}
-	/**
-	* Extract and convert uploaded files from FormData.
-	*/
-	convertUploadedFiles(files) {
-		if (!this.formData) return files;
-		for (const [key, value] of Object.entries(this.formData.files())) {
-			if (!(value instanceof File)) continue;
-			if (key.endsWith("[]")) {
-				const normalizedKey = key.slice(0, -2);
-				if (!files[normalizedKey]) files[normalizedKey] = [];
-				files[normalizedKey].push(UploadedFile.createFromBase(value));
-			} else files[key] = UploadedFile.createFromBase(value);
-		}
-		return files;
-	}
-	/**
-	* Get the current decoded path info for the request.
-	*/
-	decodedPath() {
-		try {
-			return decodeURIComponent(this.path());
-		} catch {
-			return this.path();
-		}
-	}
-	/**
-	* Determine if the data contains a given key.
-	* 
-	* @param keys 
-	* @returns 
-	*/
-	has(keys) {
-		return _h3ravel_support.Obj.has(this.all(), keys);
-	}
-	/**
-	* Determine if the instance is missing a given key.
-	*/
-	missing(key) {
-		const keys = Array.isArray(key) ? key : [key];
-		return !this.has(keys);
-	}
-	/**
-	* Get a subset containing the provided keys with values from the instance data.
-	* 
-	* @param keys 
-	* @returns 
-	*/
-	only(keys) {
-		const data = Object.entries(this.all()).filter(([key]) => keys.includes(key));
-		return Object.fromEntries(data);
-	}
-	/**
-	* Determine if the request is over HTTPS.
-	*/
-	secure() {
-		return this.isSecure();
-	}
-	/**
-	* Get all of the data except for a specified array of items.
-	* 
-	* @param keys 
-	* @returns 
-	*/
-	except(keys) {
-		const data = Object.entries(this.all()).filter(([key]) => !keys.includes(key));
-		return Object.fromEntries(data);
-	}
-	/**
-	* Merges new input data into the current request's input source.
-	*
-	* @param input - An object containing key-value pairs to merge.
-	* @returns this - For fluent chaining.
-	*/
-	merge(input) {
-		const source = this.getInputSource();
-		for (const [key, value] of Object.entries(input)) source.set(key, value);
-		return this;
-	}
-	/**
-	* Merge new input into the request's input, but only when that key is missing from the request.
-	*
-	* @param input
-	*/
-	mergeIfMissing(input) {
-		return this.merge(Object.fromEntries(Object.entries(input).filter(([key]) => this.missing(key))));
-	}
-	/**
-	* Get the keys for all of the input and files.
-	*/
-	keys() {
-		return [...Object.keys(this.input()), ...this.files.keys()];
-	}
-	/**
-	* Get an instance of the current session manager
-	* 
-	* @param key 
-	* @param defaultValue 
-	* @returns a global instance of the current session manager.
-	*/
-	session(key, defaultValue) {
-		this.sessionManager ??= this.app.make("session");
-		if (typeof key === "string") return this.sessionManager.get(key, defaultValue);
-		else if (typeof key === "object") {
-			for (const [k, val] of Object.entries(key)) this.sessionManager.put(k, val);
-			return;
-		}
-		return this.sessionManager;
-	}
-	/**
-	* Get the host name.
-	*/
-	host() {
-		return this.getHost();
-	}
-	/**
-	* Get the HTTP host being requested.
-	*/
-	httpHost() {
-		return this.getHttpHost();
-	}
-	/**
-	* Get the scheme and HTTP host.
-	*/
-	schemeAndHttpHost() {
-		return this.getSchemeAndHttpHost();
-	}
-	/**
-	* Determine if the request is sending JSON.
-	*
-	* @return bool
-	*/
-	isJson() {
-		return _h3ravel_support.Str.contains(this.getHeader("CONTENT_TYPE") ?? "", ["/json", "+json"]);
-	}
-	/**
-	* Determine if the current request probably expects a JSON response.
-	* 
-	* @returns 
-	*/
-	expectsJson() {
-		return _h3ravel_support.Str.contains(this.getHeader("Accept") ?? "", "application/json");
-	}
-	/**
-	* Determine if the current request is asking for JSON.
-	* 
-	* @returns 
-	*/
-	wantsJson() {
-		const acceptable = this.getAcceptableContentTypes();
-		return !!acceptable[0] && _h3ravel_support.Str.contains(acceptable[0].toLowerCase(), ["/json", "+json"]);
-	}
-	/**
-	* Determine if the request is the result of a PJAX call.
-	*
-	* @return bool
-	*/
-	pjax() {
-		return this.headers.get("X-PJAX") == true;
-	}
-	/**
-	* Returns true if the request is an XMLHttpRequest (AJAX).
-	* 
-	* @alias isXmlHttpRequest()
-	* @returns {boolean}
-	*/
-	ajax() {
-		return this.isXmlHttpRequest();
-	}
-	/**
-	* Get the client IP address.
-	*/
-	ip() {
-		return (0, h3.getRequestIP)(this.event);
-	}
-	async old(key, defaultValue) {
-		const payload = await this.session().get("_old", {});
-		if (key) return (0, _h3ravel_support.safeDot)(payload, key) || defaultValue;
-		return payload;
-	}
-	/**
-	* Get a URI instance for the request.
-	*/
-	uri() {
-		return Reflect.apply(this.app.getUriResolver(), this, []).of(this.fullUrl(), this.app);
-	}
-	/**
-	* Get the root URL for the application.
-	*
-	* @return string
-	*/
-	root() {
-		return _h3ravel_support.Str.rtrim(this.getSchemeAndHttpHost() + this.getBaseUrl(), "/");
-	}
-	/**
-	* Get the URL (no query string) for the request.
-	*
-	* @return string
-	*/
-	url() {
-		return _h3ravel_support.Str.rtrim(this.uri().toString().replace(/\?.*/, ""), "/");
-	}
-	/**
-	* Get the full URL for the request. 
-	*/
-	fullUrl() {
-		return this.event.req.url;
-	}
-	/**
-	* Get the current path info for the request.
-	*/
-	path() {
-		const pattern = (this.getPathInfo() ?? "").replace(/^\/+|\/+$/g, "");
-		return pattern === "" ? "/" : pattern;
-	}
-	/**
-	* Return the Request instance.
-	*/
-	instance() {
-		return this;
-	}
-	/**
-	* Get the request method.
-	*/
-	method() {
-		return this.getMethod();
-	}
-	/**
-	* Get the JSON payload for the request.
-	*
-	* @param  key
-	* @param  defaultValue
-	* @return {InputBag}
-	*/
-	json(key, defaultValue) {
-		if (!this.#json) {
-			let json = this.getContent();
-			if (typeof json == "string") json = JSON.parse(json || "{}");
-			this.#json = new InputBag(json, this.event);
-		}
-		if (!key) return this.#json;
-		return _h3ravel_support.Obj.get(this.#json.all(), key, defaultValue);
-	}
-	/**
-	* Get the user resolver callback.
-	*/
-	getUserResolver() {
-		return this.userResolver ?? (() => void 0);
-	}
-	/**
-	* Set the user resolver callback.
-	*
-	* @param  callback
-	*/
-	setUserResolver(callback) {
-		this.userResolver = callback;
-		return this;
-	}
-	/**
-	* Get the route resolver callback.
-	*/
-	getRouteResolver() {
-		return this.routeResolver ?? (() => void 0);
-	}
-	/**
-	* Set the route resolver callback.
-	*
-	* @param  callback
-	*/
-	setRouteResolver(callback) {
-		this.routeResolver = callback;
-		return this;
-	}
-	/**
-	* Get the bearer token from the request headers.
-	*/
-	bearerToken() {
-		let header = this.header("Authorization", "");
-		const position = header.toLowerCase().lastIndexOf("bearer ");
-		if (position !== -1) {
-			header = header.slice(position + 7);
-			const commaIndex = header.indexOf(",");
-			return commaIndex !== -1 ? header.slice(0, commaIndex) : header;
-		}
-	}
-	/**
-	* Retrieve data from the instance.
-	*
-	* @param  key
-	* @param  defaultValue
-	*/
-	data(key, defaultValue) {
-		return this.input(key, defaultValue);
-	}
-	/**
-	* Retrieve a request payload item from the request.
-	* 
-	* @param  key
-	* @param  default
-	*/
-	post(key, defaultValue) {
-		return this.retrieveItem("request", key, defaultValue);
-	}
-	/**
-	* Determine if a header is set on the request.
-	*
-	* @param  key
-	*/
-	hasHeader(key) {
-		return this.header(key) != null;
-	}
-	/**
-	* Retrieve a header from the request.
-	*
-	* @param  key
-	* @param  default
-	*/
-	header(key, defaultValue) {
-		return this.retrieveItem("headers", key, defaultValue);
-	}
-	/**
-	* Determine if a cookie is set on the request.
-	*
-	* @param  string  $key
-	*/
-	hasCookie(key) {
-		return this.cookie(key) != null;
-	}
-	/**
-	* Retrieve a cookie from the request.
-	*
-	* @param  key
-	* @param  default
-	*/
-	cookie(key, defaultValue) {
-		return this.retrieveItem("cookies", key, defaultValue);
-	}
-	/**
-	* Retrieve a query string item from the request.
-	*
-	* @param  key
-	* @param  default
-	*/
-	query(key, defaultValue) {
-		return this.retrieveItem("_query", key, defaultValue);
-	}
-	/**
-	* Retrieve a server variable from the request.
-	*
-	* @param  key
-	* @param  default
-	*/
-	server(key, defaultValue) {
-		return this.retrieveItem("_server", key, defaultValue);
-	}
-	/**
-	* Get the input source for the request.
-	*
-	* @return {InputBag}
-	*/
-	getInputSource() {
-		if (this.isJson()) return this.json();
-		return ["GET", "HEAD"].includes(this.getRealMethod()) ? this._query : this.request;
-	}
-	/**
-	* Retrieve a parameter item from a given source.
-	*
-	* @param  source
-	* @param  key
-	* @param  defaultValue
-	*/
-	retrieveItem(source, key, defaultValue) {
-		if (key == null) return this[source].all();
-		if (this[source] instanceof InputBag) return this[source].all()[key] ?? defaultValue;
-		return this[source].get(key, defaultValue);
-	}
-	/**
-	* Dump the items.
-	*
-	* @param  keys
-	*/
-	dump(...keys) {
-		if (keys.length > 0) this.only(keys).then(dump);
-		else this.all().then(dump);
-		return this;
-	}
-	getEvent(key) {
-		return (0, _h3ravel_support.safeDot)(this.event, key);
-	}
-};
-//#endregion
-//#region src/Resources/JsonResource.ts
-/**
-* Class to render API resource
-*/
-var JsonResource = class {
-	event;
-	/**
-	* The request instance
-	*/
-	request;
-	/**
-	* The response instance
-	*/
-	response;
-	/**
-	* The data to send to the client
-	*/
-	resource;
-	/**
-	* The final response data object
-	*/
-	body = { data: {} };
-	/**
-	* Flag to track if response should be sent automatically
-	*/
-	shouldSend = false;
-	/**
-	* Flag to track if response has been sent
-	*/
-	responseSent = false;
-	/**
-	* @param req The request instance
-	* @param res The response instance
-	* @param rsc The data to send to the client
-	*/
-	constructor(event, rsc) {
-		this.event = event;
-		this.request = event.req;
-		this.response = event.res;
-		this.resource = rsc;
-		for (const key of Object.keys(rsc)) if (!(key in this)) Object.defineProperty(this, key, {
-			enumerable: true,
-			configurable: true,
-			get: () => this.resource[key],
-			set: (value) => {
-				this.resource[key] = value;
-			}
-		});
-	}
-	/**
-	* Return the data in the expected format
-	* 
-	* @returns 
-	*/
-	data() {
-		return this.resource;
-	}
-	/**
-	* Build the response object
-	* @returns this
-	*/
-	json() {
-		this.shouldSend = true;
-		this.response.status = 200;
-		const resource = this.data();
-		let data = Array.isArray(resource) ? [...resource] : { ...resource };
-		if (typeof data.data !== "undefined") data = data.data;
-		if (!Array.isArray(resource)) delete data.pagination;
-		this.body = { data };
-		if (!Array.isArray(resource) && resource.pagination) {
-			const meta = this.body.meta ?? {};
-			meta.pagination = resource.pagination;
-			this.body.meta = meta;
-		}
-		if (this.resource.pagination && !this.body.meta?.pagination) {
-			const meta = this.body.meta ?? {};
-			meta.pagination = this.resource.pagination;
-			this.body.meta = meta;
-		}
-		return this;
-	}
-	/**
-	* Add context data to the response object
-	* @param data Context data
-	* @returns this
-	*/
-	additional(data) {
-		this.shouldSend = true;
-		delete data.data;
-		delete data.pagination;
-		this.body = {
-			...this.body,
-			...data
-		};
-		return this;
-	}
-	/**
-	* Send the output to the client
-	* @returns this
-	*/
-	send() {
-		this.shouldSend = false;
-		if (!this.responseSent) this.#send();
-		return this;
-	}
-	/**
-	* Set the status code for this response
-	* @param code Status code
-	* @returns this
-	*/
-	status(code) {
-		this.response.status = code;
-		return this;
-	}
-	/**
-	* Private method to send the response
-	*/
-	#send() {
-		if (!this.responseSent) this.responseSent = true;
-	}
-	/**
-	* Check if send should be triggered automatically
-	*/
-	checkSend() {
-		if (this.shouldSend && !this.responseSent) this.#send();
-	}
-};
-//#endregion
-//#region src/Resources/ApiResource.ts
-function ApiResource(instance) {
-	return new Proxy(instance, { get(target, prop, receiver) {
-		const value = Reflect.get(target, prop, receiver);
-		if (typeof value === "function") {
-			if (prop === "json" || prop === "additional") return (...args) => {
-				const result = value.apply(target, args);
-				setImmediate(() => target["checkSend"]());
-				return result;
-			};
-			else if (prop === "send") return (...args) => {
-				target["shouldSend"] = false;
-				return value.apply(target, args);
-			};
-		}
-		return value;
-	} });
-}
-//#endregion
-exports.ApiResource = ApiResource;
-exports.BadRequestException = BadRequestException;
-exports.ConflictingHeadersException = ConflictingHeadersException;
-exports.Cookie = Cookie;
-exports.FileBag = FileBag;
-exports.FireCommand = FireCommand;
-exports.FlashDataMiddleware = FlashDataMiddleware;
-exports.FormRequest = FormRequest;
-exports.HeaderBag = HeaderBag;
-exports.HeaderUtility = HeaderUtility;
-exports.HttpContext = HttpContext;
-exports.HttpRequest = HttpRequest;
-exports.HttpResponse = HttpResponse;
-exports.HttpResponseException = HttpResponseException;
-exports.HttpServiceProvider = HttpServiceProvider;
-exports.InputBag = InputBag;
-exports.IpUtils = IpUtils;
-exports.JsonResource = JsonResource;
-exports.JsonResponse = JsonResponse;
-exports.LogRequests = LogRequests;
-Object.defineProperty(exports, "Middleware", {
-	enumerable: true,
-	get: function() {
-		return Middleware;
-	}
-});
-exports.ParamBag = ParamBag;
-exports.Request = Request;
-exports.Responsable = Responsable;
-exports.Response = Response;
-exports.ResponseHeaderBag = ResponseHeaderBag;
-exports.ServerBag = ServerBag;
-exports.SuspiciousOperationException = SuspiciousOperationException;
-exports.TrustHosts = TrustHosts;
-exports.UnexpectedValueException = UnexpectedValueException;
-exports.UploadedFile = UploadedFile;