@h3ravel/http 11.6.0 → 11.7.0

package/dist/index.d.ts

@@ -1,173 +1,58 @@
 /// <reference path="./app.globals.d.ts" />
 import { Command } from "@h3ravel/musket";
-import { DotNestedKeys, DotNestedValue, HttpContext as HttpContext$1, IApplication, IMiddleware, IParamBag, IRequest, IResponse, RequestMethod, RequestObject } from "@h3ravel/shared";
+import { DotNestedKeys, DotNestedValue, HttpContext as HttpContext$1, IApplication, IMiddleware, IParamBag, IRequest, IResponse, RequestMethod, RequestObject, ResponseObject } from "@h3ravel/shared";
 import { EventHandlerRequest, H3Event, HTTPResponse } from "h3";
+import { DateTime } from "@h3ravel/support";
 import { Application } from "@h3ravel/core";
 import { Url } from "@h3ravel/url";
 
-//#region src/Bags/ParamBag.d.ts
-/**
- * ParamBag is a container for key/value pairs
- * for Node/H3 environments.
- */
-declare class ParamBag implements IParamBag {
-  protected parameters: RequestObject;
-  /**
-   * The current H3 H3Event instance
-   */
-  readonly event: H3Event;
-  constructor(parameters: RequestObject | undefined,
-  /**
-   * The current H3 H3Event instance
-   */
-  event: H3Event);
-  /**
-   * Returns the parameters.
-   * @
-   * @param key The name of the parameter to return or null to get them all
-   *
-   * @throws BadRequestException if the value is not an array
-   */
-  all(key?: string): any;
-  get(key: string, defaultValue?: any): any;
-  set(key: string, value: any): void;
-  /**
-   * Returns true if the parameter is defined.
-   *
-   * @param key
-   */
-  has(key: string): boolean;
-  /**
-   * Removes a parameter.
-   *
-   * @param key
-   */
-  remove(key: string): void;
-  /**
-   *
-   * Returns the parameter as string.
-   *
-   * @param key
-   * @param defaultValue
-   * @throws UnexpectedValueException if the value cannot be converted to string
-   * @returns
-   */
-  getString(key: string, defaultValue?: string): string;
-  /**
-   * Returns the parameter value converted to integer.
-   *
-   * @param key
-   * @param defaultValue
-   * @throws UnexpectedValueException if the value cannot be converted to integer
-   */
-  getInt(key: string, defaultValue?: number): number;
-  /**
-   * Returns the parameter value converted to boolean.
-   *
-   * @param key
-   * @param defaultValue
-   * @throws UnexpectedValueException if the value cannot be converted to a boolean
-   */
-  getBoolean(key: string, defaultValue?: boolean): 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: string, defaultValue?: string): string;
-  /**
-   * 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: string, defaultValue?: string): string;
+//#region src/Commands/FireCommand.d.ts
+declare class FireCommand extends Command {
   /**
-   * Returns the digits of the parameter value.
+   * The name and signature of the console command.
    *
-   * @param key
-   * @param defaultValue
-   * @throws UnexpectedValueException if the value cannot be converted to string
-   * @returns
-   **/
-  getDigits(key: string, defaultValue?: string): string;
-  /**
-   * Returns the parameter keys.
-   */
-  keys(): string[];
-  /**
-   * Replaces the current parameters by a new set.
-   */
-  replace(parameters?: RequestObject): void;
-  /**
-   * Adds parameters.
-   */
-  add(parameters?: RequestObject): void;
-  /**
-   * Returns the number of parameters.
+   * @var string
    */
-  count(): number;
+  protected signature: string;
   /**
-   * Returns an iterator for parameters.
+   * The console command description.
    *
-   * @returns
+   * @var string
    */
-  [Symbol.iterator](): ArrayIterator<[string, any]>;
+  protected description: string;
+  handle(): Promise<void>;
+  protected fire(): Promise<void>;
 }
 //#endregion
-//#region src/UploadedFile.d.ts
-declare class UploadedFile {
-  originalName: string;
-  mimeType: string;
-  size: number;
-  content: File;
-  constructor(originalName: string, mimeType: string, size: number, content: File);
-  static createFromBase(file: File): UploadedFile;
-  /**
-   * Save to disk (Node environment only)
-   */
-  moveTo(destination: string): Promise<void>;
+//#region src/Contracts/HttpContract.d.ts
+type CacheOptions = Partial<{
+  must_revalidate: boolean;
+  no_cache: boolean;
+  no_store: boolean;
+  no_transform: boolean;
+  public: boolean;
+  private: boolean;
+  proxy_revalidate: boolean;
+  max_age: number;
+  s_maxage: number;
+  immutable: boolean;
+  stale_while_revalidate: number;
+  stale_if_error: number;
+  last_modified: string | Date;
+  etag: string;
+}>;
+//#endregion
+//#region src/Exceptions/BadRequestException.d.ts
+declare class BadRequestException extends Error {
+  constructor(message: string);
 }
 //#endregion
-//#region src/Bags/FileBag.d.ts
-type FileInput = UploadedFile | File | null | undefined;
-/**
- * FileBag is a container for uploaded files
- * for Node/H3 environments.
- */
-declare class FileBag extends ParamBag {
-  protected parameters: Record<string, UploadedFile | UploadedFile[] | null>;
-  constructor(parameters: Record<string, FileInput | FileInput[]> | undefined,
-  /**
-   * The current H3 H3Event instance
-   */
-  event: H3Event);
-  /**
-   * Replace all stored files.
-   */
-  replace(files?: Record<string, FileInput | FileInput[]>): void;
-  /**
-   * Set a file or array of files.
-   */
-  set(key: string, value: FileInput | FileInput[]): void;
-  /**
-   * Add multiple files.
-   */
-  add(files?: Record<string, FileInput | FileInput[]>): void;
-  /**
-   * Get all stored files.
-   */
-  all(): Record<string, UploadedFile | UploadedFile[] | null>;
-  /**
-   * Normalize file input into UploadedFile instances.
-   */
-  protected convertFileInformation(file: FileInput): UploadedFile | null;
+//#region src/Exceptions/ConflictingHeadersException.d.ts
+declare class ConflictingHeadersException extends Error {
+  constructor(message: string);
 }
 //#endregion
-//#region src/Bags/HeaderBag.d.ts
+//#region src/Utilities/HeaderBag.d.ts
 /**
  * HeaderBag — A container for HTTP headers
  * for Node/H3 environments.
@@ -176,6 +61,7 @@ declare class HeaderBag implements Iterable<[string, (string | null)[]]> {
   protected static readonly UPPER = "_ABCDEFGHIJKLMNOPQRSTUVWXYZ";
   protected static readonly LOWER = "-abcdefghijklmnopqrstuvwxyz";
   protected headers: Record<string, (string | null)[]>;
+  protected headerNames: Record<string, string>;
   protected cacheControl: Record<string, string | boolean>;
   constructor(headers?: Record<string, string | string[] | null>);
   /**
@@ -190,7 +76,7 @@ declare class HeaderBag implements Iterable<[string, (string | null)[]]> {
    * @param key
    * @returns
    */
-  all(key?: string): Record<string, (string | null)[]> | (string | null)[];
+  all<K extends string | undefined>(key?: K): K extends string ? (string | null)[] : Record<string, (string | null)[]>;
   /**
    * Returns header keys
    *
@@ -251,7 +137,7 @@ declare class HeaderBag implements Iterable<[string, (string | null)[]]> {
    * @param defaultValue
    * @returns
    */
-  getDate(key: string, defaultValue?: Date | null): Date | null;
+  getDate(key: string, defaultValue?: Date | null): DateTime | undefined;
   /**
    * Adds a Cache-Control directive
    *
@@ -315,163 +201,455 @@ declare class HeaderBag implements Iterable<[string, (string | null)[]]> {
   [Symbol.iterator](): Iterator<[string, (string | null)[]]>;
 }
 //#endregion
-//#region src/Bags/InputBag.d.ts
+//#region src/Utilities/Cookie.d.ts
 /**
- * InputBag is a container for user input values
- * (e.g., query params, body, cookies)
+ * Represents a Cookie
+ */
+declare class Cookie {
+  private name;
+  private value?;
+  private domain?;
+  private secure?;
+  private httpOnly;
+  static readonly SAMESITE_NONE = "none";
+  static readonly SAMESITE_LAX = "lax";
+  static readonly SAMESITE_STRICT = "strict";
+  private expire;
+  private path;
+  private sameSite?;
+  private raw;
+  private partitioned;
+  private secureDefault;
+  private static readonly RESERVED_CHARS_LIST;
+  private static readonly RESERVED_CHARS_FROM;
+  private static readonly RESERVED_CHARS_TO;
+  constructor(name: string, value?: string | null | undefined, expire?: number | string | Date, path?: string, domain?: string | null | undefined, secure?: boolean | null | undefined, httpOnly?: boolean, raw?: boolean, sameSite?: string | null, partitioned?: boolean);
+  /**
+   * Create a Cookie instance from a Set-Cookie header string.
+   */
+  static fromString(cookie: string, decode?: boolean): Cookie;
+  /**
+   * Convert various expiration formats into a timestamp (seconds)
+   */
+  private static expiresTimestamp;
+  private clone;
+  withValue(value: string | null): Cookie;
+  withDomain(domain: string | null): Cookie;
+  withPath(path: string | null): Cookie;
+  withSecure(secure?: boolean): Cookie;
+  withHttpOnly(httpOnly?: boolean): Cookie;
+  withRaw(raw?: boolean): Cookie;
+  withSameSite(sameSite?: string | null): Cookie;
+  withPartitioned(partitioned?: boolean): Cookie;
+  withExpires(expire: number | string | Date): Cookie;
+  getName(): string;
+  getValue(): string | undefined | null;
+  getDomain(): string | undefined | null;
+  getPath(): string;
+  getExpiresTime(): number;
+  getMaxAge(): number;
+  /**
+   * Checks whether the cookie should only be transmitted over a secure HTTPS connection from the client.
+   */
+  isSecure(): boolean;
+  isHttpOnly(): boolean;
+  isRaw(): boolean;
+  getSameSite(): string | undefined | null;
+  isPartitioned(): boolean;
+  /**
+   * Whether this cookie is about to be cleared.
+   */
+  isCleared(): boolean;
+  /**
+   * Convert the cookie to a Set-Cookie header string.
+   */
+  toString(): string;
+  /**
+   * @param bool $default The default value of the "secure" flag when it is set to null
+   */
+  setSecureDefault(defaultValue: boolean): void;
+}
+//#endregion
+//#region src/Utilities/ResponseHeaderBag.d.ts
+/**
+ * ResponseHeaderBag is a container for Response HTTP headers.
  * for Node/H3 environments.
  */
-declare class InputBag extends ParamBag {
-  constructor(inputs: RequestObject | undefined,
+declare class ResponseHeaderBag extends HeaderBag {
+  static readonly COOKIES_FLAT = "flat";
+  static readonly COOKIES_ARRAY = "array";
+  static readonly DISPOSITION_ATTACHMENT = "attachment";
+  static readonly DISPOSITION_INLINE = "inline";
+  protected computedCacheControl: Record<string, string | boolean>;
+  protected cookies: Record<string, Record<string, Record<string, Cookie>>>;
+  protected headerNames: Record<string, string>;
+  constructor(
   /**
    * The current H3 H3Event instance
    */
   event: H3Event);
   /**
-   * Returns a scalar input value by name.
-   *
-   * @param key
-   * @param defaultValue
-   * @throws BadRequestException if the input contains a non-scalar value
-   * @returns
+   * Returns the headers with original capitalizations.
    */
-  get<T extends string | number | boolean | null>(key: string, defaultValue?: T | null): T | string | number | boolean | null;
+  allPreserveCase(): Record<string, string[]>;
+  allPreserveCaseWithoutCookies(): Record<string, string[]>;
+  replace(headers?: Record<string, string | string[]>): void;
+  all<K extends string | undefined>(key?: K): K extends string ? (string | null)[] : Record<string, (string | null)[]>;
+  set(key: string, values: string | string[] | null, replace?: boolean): void;
+  remove(key: string): void;
+  hasCacheControlDirective(key: string): boolean;
+  getCacheControlDirective(key: string): boolean | string | null;
+  setCookie(cookie: Cookie): void;
+  removeCookie(name: string, path?: string, domain?: string | null): void;
   /**
-   * Replaces all current input values.
-   *
-   * @param inputs
-   * @returns
+   * @throws {Error} if format is invalid
    */
-  replace(inputs?: RequestObject): void;
+  getCookies(format?: string): Cookie[] | Record<string, any>;
+  clearCookie(name: string, path?: string, domain?: string | null, secure?: boolean, httpOnly?: boolean, sameSite?: string | null, partitioned?: boolean): void;
+  makeDisposition(disposition: string, filename: string, fallback?: string): string;
+  protected computeCacheControlValue(): string;
+  private initDate;
+}
+//#endregion
+//#region src/Utilities/HttpResponse.d.ts
+declare class HttpResponse {
   /**
-   * Adds multiple input values.
-   *
-   * @param inputs
-   * @returns
+   * The current H3 H3Event instance
    */
-  add(inputs?: RequestObject): void;
+  protected readonly event: H3Event;
+  protected statusCode: number;
+  protected headers: ResponseHeaderBag;
+  protected content: any;
+  protected version: string;
+  protected statusText: string;
+  protected charset?: string;
   /**
-   * Sets an input by name.
-   *
-   * @param key
-   * @param value
-   * @throws TypeError if value is not scalar or array
-   * @returns
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Cache-Control
    */
-  set(key: string, value: any): void;
+  private HTTP_RESPONSE_CACHE_CONTROL_DIRECTIVES;
   /**
-   * Returns true if a key exists.
-   *
-   * @param key
-   * @returns
+   * The exception that triggered the error response (if applicable).
    */
-  has(key: string): boolean;
+  exception?: Error;
   /**
-   * Returns all parameters.
-   *
-   * @returns
+   * Tracks headers already sent in informational responses.
    */
-  all(): RequestObject;
+  private sentHeaders;
   /**
-   * Converts a parameter value to string.
+   * Status codes translation table.
    *
-   * @param key
-   * @param defaultValue
-   * @throws BadRequestException if input contains a non-scalar value
-   * @returns
+   * 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.
    */
-  getString(key: string, defaultValue?: string): string;
+  static statusTexts: {
+    [key: number]: string;
+  };
+  constructor(
   /**
-   * 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
+   * The current H3 H3Event instance
    */
-  filter<T = any>(key: string, defaultValue?: T | null, filterFn?: (value: any) => boolean): T | null;
+  event: H3Event);
   /**
-   * Returns an enum value by key.
-   *
-   * @param key
-   * @param EnumClass
-   * @param defaultValue
-   * @throws BadRequestException if conversion fails
-   * @returns
+   * Set HTTP status code.
    */
-  getEnum<T extends Record<string, string | number>>(key: string, EnumClass: T, defaultValue?: T[keyof T] | null): T[keyof T] | null;
+  setStatusCode(code: number, text?: string): this;
   /**
-   * Removes a key.
-   *
-   * @param key
+   * Retrieves the status code for the current web response.
    */
-  remove(key: string): void;
+  getStatusCode(): number;
   /**
-   * Returns all keys.
-   *
-   * @returns
+   * Sets the response charset.
    */
-  keys(): string[];
+  setCharset(charset: string): this;
   /**
-   * Returns number of parameters.
-   *
-   * @returns
+   * Retrieves the response charset.
    */
-  count(): number;
-}
-//#endregion
-//#region src/Bags/ServerBag.d.ts
-/**
- * ServerBag — a simplified version of Symfony's ServerBag
- * for Node/H3 environments.
- *
- * Responsible for extracting and normalizing HTTP headers
- * from the incoming request.
- */
-declare class ServerBag extends ParamBag {
-  constructor(parameters: Record<string, string | undefined> | undefined,
+  getCharset(): string | undefined;
   /**
-   * The current H3 H3Event instance
+   * 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
    */
-  event: H3Event);
+  isCacheable(): boolean;
   /**
-   * Returns all request headers, normalized to uppercase with underscores.
-   * Example: content-type → CONTENT_TYPE
+   * 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.
    */
-  getHeaders(): Record<string, string>;
+  isFresh(): boolean;
   /**
-   * Returns a specific header by name, case-insensitive.
+   * Returns true if the response includes headers that can be used to validate
+   * the response with the origin server using a conditional GET request.
    */
-  get(name: string): string | undefined;
+  isValidateable(): boolean;
   /**
-   * Returns true if a header exists.
+   * Sets the response content.
    */
-  has(name: string): boolean;
-}
-//#endregion
-//#region src/Commands/FireCommand.d.ts
-declare class FireCommand extends Command {
+  setContent(content?: any): this;
   /**
-   * The name and signature of the console command.
+   * Gets the current response content.
+   */
+  getContent(): any;
+  /**
+   * Set a header.
+   */
+  setHeader(name: string, value: string): this;
+  /**
+   * Sets the HTTP protocol version (1.0 or 1.1).
+   */
+  setProtocolVersion(version: string): this;
+  /**
+   * Gets the HTTP protocol version.
+   */
+  getProtocolVersion(): string;
+  /**
+   * Marks the response as "private".
    *
-   * @var string
+   * It makes the response ineligible for serving other clients.
    */
-  protected signature: string;
+  setPrivate(): this;
   /**
-   * The console command description.
+   * Marks the response as "public".
    *
-   * @var string
+   * It makes the response eligible for serving other clients.
    */
-  protected description: string;
-  handle(): Promise<void>;
-  protected fire(): Promise<void>;
+  setPublic(): this;
+  /**
+   * Returns the Date header as a DateTime instance.
+   * @throws {RuntimeException} When the header is not parseable
+   */
+  getDate(): DateTime | undefined;
+  /**
+   * Returns the age of the response in seconds.
+   *
+   * @final
+   */
+  getAge(): number;
+  /**
+   * Marks the response stale by setting the Age header to be equal to the maximum age of the response.
+   */
+  expire(): this;
+  /**
+   * Returns the value of the Expires header as a DateTime instance.
+   *
+   * @final
+   */
+  getExpires(): DateTime | undefined;
+  /**
+   * 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(): number | undefined;
+  /**
+   * 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: number): 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: number): 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: number): 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(): number | undefined;
+  /**
+   * Sets the response's time-to-live for shared caches in seconds.
+   *
+   * This method adjusts the Cache-Control/s-maxage directive.
+   */
+  setTtl(seconds: number): 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: number): 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: number): this;
+  /**
+   * Returns the Last-Modified HTTP header as a DateTime instance.
+   *
+   * @throws \RuntimeException When the HTTP header is not parseable
+   *
+   * @final
+   */
+  getLastModified(): DateTime | undefined;
+  /**
+   * Sets the Last-Modified HTTP header with a DateTime instance.
+   *
+   * Passing null as value will remove the header.
+   *
+   * @return $this
+   *
+   * @final
+   */
+  setLastModified(date?: DateTime | Date | string): this;
+  /**
+   * Returns the literal value of the ETag HTTP header.
+   */
+  getEtag(): string | null;
+  /**
+   * 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?: string, weak?: boolean): 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: CacheOptions): 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;
+  /**
+   * Add an array of headers to the response.
+   *
+   */
+  withHeaders(headers: HeaderBag | ResponseObject): this;
+  /**
+   * Set the exception to attach to the response.
+   */
+  withException(e: Error): this;
+  /**
+   * Throws the response in a HttpResponseException instance.
+   *
+   * @throws {HttpResponseException}
+   */
+  throwResponse(): void;
+  /**
+   * Is response invalid?
+   *
+   * @see https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html
+   */
+  isInvalid(): boolean;
+  /**
+   * Is response informative?
+   */
+  isInformational(): boolean;
+  /**
+   * Is response successful?
+   */
+  isSuccessful(): boolean;
+  /**
+   * Is the response a redirect?
+   */
+  isRedirection(): boolean;
+  /**
+   * Is there a client error?
+   */
+  isClientError(): boolean;
+  /**
+   * Was there a server side error?
+   */
+  isServerError(): boolean;
+  /**
+   * Is the response OK?
+   */
+  isOk(): boolean;
+  /**
+   * Is the response forbidden?
+   */
+  isForbidden(): boolean;
+  /**
+   * Is the response a not found error?
+   */
+  isNotFound(): boolean;
+  /**
+   * Is the response a redirect of some form?
+   */
+  isRedirect(location?: string | null): boolean;
+  /**
+   * Is the response empty?
+   */
+  isEmpty(): boolean;
+  /**
+   * Apply headers before sending response.
+   */
+  sendHeaders(statusCode?: number): 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: Request): this;
+  /**
+   * Checks if we need to remove Cache-Control for SSL encrypted downloads when using IE < 9.
+   *
+   * @see http://support.microsoft.com/kb/323308
+   */
+  protected ensureIEOverSSLCompatibility(request: Request): void;
 }
 //#endregion
-//#region src/Exceptions/BadRequestException.d.ts
-declare class BadRequestException extends Error {
-  constructor(message: string);
+//#region src/Exceptions/HttpResponseException.d.ts
+declare class HttpResponseException extends Error {
+  /**
+   * The underlying response instance.
+   */
+  protected response: HttpResponse;
+  /**
+   * Create a new HTTP response exception instance.
+   *
+   * @param response
+   * @param previous
+   */
+  constructor(response: HttpResponse, previous?: Error);
+  /**
+   * Get the underlying response instance.
+   */
+  getResponse(): HttpResponse;
 }
 //#endregion
 //#region src/Exceptions/SuspiciousOperationException.d.ts
@@ -484,6 +662,20 @@ declare class UnexpectedValueException extends Error {
   constructor(message: string);
 }
 //#endregion
+//#region src/UploadedFile.d.ts
+declare class UploadedFile {
+  originalName: string;
+  mimeType: string;
+  size: number;
+  content: File;
+  constructor(originalName: string, mimeType: string, size: number, content: File);
+  static createFromBase(file: File): UploadedFile;
+  /**
+   * Save to disk (Node environment only)
+   */
+  moveTo(destination: string): Promise<void>;
+}
+//#endregion
 //#region src/FormRequest.d.ts
 declare class FormRequest {
   protected dataset: {
@@ -573,73 +765,576 @@ declare class HttpServiceProvider {
   boot(): void;
 }
 //#endregion
-//#region src/Request.d.ts
-declare class Request implements IRequest {
-  #private;
+//#region src/Utilities/ParamBag.d.ts
+/**
+ * ParamBag is a container for key/value pairs
+ * for Node/H3 environments.
+ */
+declare class ParamBag implements IParamBag {
+  protected parameters: RequestObject;
+  /**
+   * The current H3 H3Event instance
+   */
+  readonly event: H3Event;
+  constructor(parameters: RequestObject | undefined,
+  /**
+   * The current H3 H3Event instance
+   */
+  event: H3Event);
+  /**
+   * Returns the parameters.
+   * @
+   * @param key The name of the parameter to return or null to get them all
+   *
+   * @throws BadRequestException if the value is not an array
+   */
+  all(key?: string): any;
+  get(key: string, defaultValue?: any): any;
+  set(key: string, value: any): void;
+  /**
+   * Returns true if the parameter is defined.
+   *
+   * @param key
+   */
+  has(key: string): boolean;
+  /**
+   * Removes a parameter.
+   *
+   * @param key
+   */
+  remove(key: string): void;
+  /**
+   *
+   * Returns the parameter as string.
+   *
+   * @param key
+   * @param defaultValue
+   * @throws UnexpectedValueException if the value cannot be converted to string
+   * @returns
+   */
+  getString(key: string, defaultValue?: string): string;
+  /**
+   * Returns the parameter value converted to integer.
+   *
+   * @param key
+   * @param defaultValue
+   * @throws UnexpectedValueException if the value cannot be converted to integer
+   */
+  getInt(key: string, defaultValue?: number): number;
+  /**
+   * Returns the parameter value converted to boolean.
+   *
+   * @param key
+   * @param defaultValue
+   * @throws UnexpectedValueException if the value cannot be converted to a boolean
+   */
+  getBoolean(key: string, defaultValue?: boolean): 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: string, defaultValue?: string): string;
+  /**
+   * 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: string, defaultValue?: string): string;
+  /**
+   * Returns the digits of the parameter value.
+   *
+   * @param key
+   * @param defaultValue
+   * @throws UnexpectedValueException if the value cannot be converted to string
+   * @returns
+   **/
+  getDigits(key: string, defaultValue?: string): string;
+  /**
+   * Returns the parameter keys.
+   */
+  keys(): string[];
+  /**
+   * Replaces the current parameters by a new set.
+   */
+  replace(parameters?: RequestObject): void;
+  /**
+   * Adds parameters.
+   */
+  add(parameters?: RequestObject): void;
+  /**
+   * Returns the number of parameters.
+   */
+  count(): number;
+  /**
+   * Returns an iterator for parameters.
+   *
+   * @returns
+   */
+  [Symbol.iterator](): ArrayIterator<[string, any]>;
+}
+//#endregion
+//#region src/Utilities/InputBag.d.ts
+/**
+ * InputBag is a container for user input values
+ * (e.g., query params, body, cookies)
+ * for Node/H3 environments.
+ */
+declare class InputBag extends ParamBag {
+  constructor(inputs: RequestObject | undefined,
+  /**
+   * The current H3 H3Event instance
+   */
+  event: H3Event);
+  /**
+   * Returns a scalar input value by name.
+   *
+   * @param key
+   * @param defaultValue
+   * @throws BadRequestException if the input contains a non-scalar value
+   * @returns
+   */
+  get<T extends string | number | boolean | null>(key: string, defaultValue?: T | null): T | string | number | boolean | null;
+  /**
+   * Replaces all current input values.
+   *
+   * @param inputs
+   * @returns
+   */
+  replace(inputs?: RequestObject): void;
+  /**
+   * Adds multiple input values.
+   *
+   * @param inputs
+   * @returns
+   */
+  add(inputs?: RequestObject): void;
+  /**
+   * Sets an input by name.
+   *
+   * @param key
+   * @param value
+   * @throws TypeError if value is not scalar or array
+   * @returns
+   */
+  set(key: string, value: any): void;
+  /**
+   * Returns true if a key exists.
+   *
+   * @param key
+   * @returns
+   */
+  has(key: string): boolean;
+  /**
+   * Returns all parameters.
+   *
+   * @returns
+   */
+  all(): RequestObject;
+  /**
+   * Converts a parameter value to string.
+   *
+   * @param key
+   * @param defaultValue
+   * @throws BadRequestException if input contains a non-scalar value
+   * @returns
+   */
+  getString(key: string, defaultValue?: string): string;
+  /**
+   * 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<T = any>(key: string, defaultValue?: T | null, filterFn?: (value: any) => boolean): T | null;
+  /**
+   * Returns an enum value by key.
+   *
+   * @param key
+   * @param EnumClass
+   * @param defaultValue
+   * @throws BadRequestException if conversion fails
+   * @returns
+   */
+  getEnum<T extends Record<string, string | number>>(key: string, EnumClass: T, defaultValue?: T[keyof T] | null): T[keyof T] | null;
+  /**
+   * Removes a key.
+   *
+   * @param key
+   */
+  remove(key: string): void;
+  /**
+   * Returns all keys.
+   *
+   * @returns
+   */
+  keys(): string[];
+  /**
+   * Returns number of parameters.
+   *
+   * @returns
+   */
+  count(): number;
+}
+//#endregion
+//#region src/Utilities/FileBag.d.ts
+type FileInput = UploadedFile | File | null | undefined;
+/**
+ * FileBag is a container for uploaded files
+ * for Node/H3 environments.
+ */
+declare class FileBag extends ParamBag {
+  protected parameters: Record<string, UploadedFile | UploadedFile[] | null>;
+  constructor(parameters: Record<string, FileInput | FileInput[]> | undefined,
+  /**
+   * The current H3 H3Event instance
+   */
+  event: H3Event);
+  /**
+   * Replace all stored files.
+   */
+  replace(files?: Record<string, FileInput | FileInput[]>): void;
+  /**
+   * Set a file or array of files.
+   */
+  set(key: string, value: FileInput | FileInput[]): void;
+  /**
+   * Add multiple files.
+   */
+  add(files?: Record<string, FileInput | FileInput[]>): void;
+  /**
+   * Get all stored files.
+   */
+  all(): Record<string, UploadedFile | UploadedFile[] | null>;
+  /**
+   * Normalize file input into UploadedFile instances.
+   */
+  protected convertFileInformation(file: FileInput): UploadedFile | null;
+}
+//#endregion
+//#region src/Utilities/ServerBag.d.ts
+/**
+ * ServerBag — a simplified version of Symfony's ServerBag
+ * for Node/H3 environments.
+ *
+ * Responsible for extracting and normalizing HTTP headers
+ * from the incoming request.
+ */
+declare class ServerBag extends ParamBag {
+  constructor(parameters: Record<string, string | undefined> | undefined,
+  /**
+   * The current H3 H3Event instance
+   */
+  event: H3Event);
+  /**
+   * Returns all request headers, normalized to uppercase with underscores.
+   * Example: content-type → CONTENT_TYPE
+   */
+  getHeaders(): Record<string, string>;
+  /**
+   * Returns a specific header by name, case-insensitive.
+   */
+  get(name: string): string | undefined;
+  /**
+   * Returns true if a header exists.
+   */
+  has(name: string): boolean;
+}
+//#endregion
+//#region src/Utilities/HttpRequest.d.ts
+declare class HttpRequest {
+  #private;
+  /**
+   * The current H3 H3Event instance
+   */
+  protected readonly event: H3Event;
+  /**
+   * The current app instance
+   */
+  app: Application;
+  HEADER_FORWARDED: number;
+  HEADER_X_FORWARDED_FOR: number;
+  HEADER_X_FORWARDED_HOST: number;
+  HEADER_X_FORWARDED_PROTO: number;
+  HEADER_X_FORWARDED_PORT: number;
+  HEADER_X_FORWARDED_PREFIX: number;
+  HEADER_X_FORWARDED_AWS_ELB: number;
+  HEADER_X_FORWARDED_TRAEFIK: number;
+  METHOD_HEAD: string;
+  METHOD_GET: string;
+  METHOD_POST: string;
+  METHOD_PUT: string;
+  METHOD_PATCH: string;
+  METHOD_DELETE: string;
+  METHOD_PURGE: string;
+  METHOD_OPTIONS: string;
+  METHOD_TRACE: string;
+  METHOD_CONNECT: string;
+  /**
+   * 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).
+   */
+  private TRUSTED_HEADERS;
+  private FORWARDED_PARAMS;
+  /**
+   * Parsed request body
+   */
+  body: unknown;
+  protected format?: string;
+  protected formData: FormRequest;
+  private preferredFormat?;
+  private isForwardedValid;
+  private static trustedHeaderSet;
+  /**
+   * Gets route parameters.
+   * @returns An object containing route parameters.
+   */
+  params: NonNullable<H3Event['context']['params']>;
+  /**
+   * Request body parameters (POST).
+   *
+   * @see getPayload() for portability between content types
+   */
+  protected request: InputBag;
+  /**
+   * Uploaded files (FILES).
+   */
+  files: FileBag;
+  /**
+   * Query string parameters (GET).
+   */
+  query: InputBag;
+  /**
+   * Server and execution environment parameters
+   */
+  server: ServerBag;
+  /**
+   * Cookies
+   */
+  cookies: InputBag;
+  /**
+   * The request attributes (parameters parsed from the PATH_INFO, ...).
+   */
+  attributes: ParamBag;
+  /**
+   * Gets the request headers.
+   * @returns An object containing request headers.
+   */
+  headers: HeaderBag;
+  protected content?: ReadableStream | string | false | null;
+  protected static formats?: Record<string, string[]> | undefined | null;
+  protected static trustedProxies: string[];
+  protected static httpMethodParameterOverride: boolean;
+  /**
+   * List of Acceptable Content Types
+   */
+  private acceptableContentTypes;
+  private trustedValuesCache;
+  constructor(
+  /**
+   * The current H3 H3Event instance
+   */
+  event: H3Event,
+  /**
+   * The current app instance
+   */
+  app: Application);
+  /**
+   * 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(): Promise<void>;
+  /**
+   * Gets a list of content types acceptable by the client browser in preferable order.
+   * @returns {string[]}
+   */
+  getAcceptableContentTypes(): string[];
+  /**
+   * Get a URI instance for the request.
+   */
+  getUriInstance(): Url;
+  /**
+   * 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(): boolean;
+  /**
+   * Returns the value of the requested header.
+   */
+  getHeader(name: string): string | undefined | null;
+  /**
+   * Checks if the request method is of specified type.
+   *
+   * @param method Uppercase request method (GET, POST etc)
+   */
+  isMethod(method: string): boolean;
+  /**
+   * Checks whether or not the method is safe.
+   *
+   * @see https://tools.ietf.org/html/rfc7231#section-4.2.1
+   */
+  isMethodSafe(): boolean;
+  /**
+   * Checks whether or not the method is idempotent.
+   */
+  isMethodIdempotent(): boolean;
+  /**
+   * Checks whether the method is cacheable or not.
+   *
+   * @see https://tools.ietf.org/html/rfc7231#section-4.2.3
+   */
+  isMethodCacheable(): boolean;
+  /**
+   * Returns true if the request is an XMLHttpRequest (AJAX).
+   */
+  isXmlHttpRequest(): boolean;
+  /**
+   * Initializes HTTP request formats.
+   */
+  protected static initializeFormats(): void;
+  /**
+   * 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(): RequestMethod;
   /**
-   * The current H3 H3Event instance
+   * 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.
    */
-  private readonly event;
+  getPreferredFormat(defaultValue?: string): string | undefined;
   /**
-   * The current app instance
+   * Gets the format associated with the mime type.
    */
-  app: Application;
+  getFormat(mimeType: string): string | undefined;
   /**
-   * Parsed request body
+   * 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
    */
-  body: unknown;
+  getRequestFormat(defaultValue?: string): string | undefined;
   /**
-   * Gets route parameters.
-   * @returns An object containing route parameters.
+   * Sets the request format.
    */
-  params: NonNullable<H3Event['context']['params']>;
+  setRequestFormat(format: string): void;
   /**
-   * All of the converted files for the request.
+   * Gets the "real" request method.
+   *
+   * @see getMethod()
    */
-  protected convertedFiles?: Record<string, UploadedFile | UploadedFile[]>;
+  getRealMethod(): RequestMethod;
   /**
-   * Form data from incoming request.
-   * @returns The FormRequest object.
+   * Gets the mime type associated with the format.
    */
-  protected formData: FormRequest;
+  getMimeType(format: string): string | undefined;
   /**
-   * Request body parameters (POST).
-   *
-   * @see getPayload() for portability between content types
+   * Gets the mime types associated with the format.
    */
-  protected request: InputBag;
+  static getMimeTypes(format: string): string[];
   /**
-   * Uploaded files (FILES).
+   * Gets the list of trusted proxies.
    */
-  files: FileBag;
+  static getTrustedProxies(): string[];
   /**
-   * Query string parameters (GET).
+   * Returns the request body content.
+   *
+   * @param asStream If true, returns a ReadableStream instead of the parsed string
+   * @return {string | ReadableStream | Promise<string | ReadableStream>}
    */
-  query: InputBag;
+  getContent(asStream?: boolean): string | ReadableStream;
   /**
-   * Server and execution environment parameters
+   * 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
    */
-  server: ServerBag;
+  get(key: string, defaultValue?: any): any;
   /**
-   * Cookies
+   * 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.
    */
-  cookies: InputBag;
+  isFromTrustedProxy(): boolean;
   /**
-   * The request attributes (parameters parsed from the PATH_INFO, ...).
+   * 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(), getBaseUrl() etc. Thus, we try to cache the results for
+   * best performance.
    */
-  attributes: ParamBag;
+  private getTrustedValues;
+  private normalizeAndFilterClientIps;
   /**
-   * Gets the request headers.
-   * @returns An object containing request headers.
+   * 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.
    */
-  headers: HeaderBag;
-  protected content?: ReadableStream | string | false | null;
-  protected static formats?: Record<string, string[]> | undefined | null;
-  protected static httpMethodParameterOverride: boolean;
+  static enableHttpMethodParameterOverride(): void;
   /**
-   * List of Acceptable Content Types
+   * Checks whether support for the _method request parameter is enabled.
    */
-  private acceptableContentTypes;
+  static getHttpMethodParameterOverride(): boolean;
+}
+//#endregion
+//#region src/Request.d.ts
+declare class Request extends HttpRequest implements IRequest {
+  #private;
+  /**
+   * All of the converted files for the request.
+   */
+  protected convertedFiles?: Record<string, UploadedFile | UploadedFile[]>;
   constructor(
   /**
    * The current H3 H3Event instance
@@ -661,18 +1356,6 @@ declare class Request implements IRequest {
    * The current app instance
    */
   app: Application): Promise<Request>;
-  /**
-   * 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(): Promise<void>;
   private setBody;
   /**
    * Retrieve all data from the instance (query + body).
@@ -782,11 +1465,6 @@ declare class Request implements IRequest {
    * @returns
    */
   wantsJson(): boolean;
-  /**
-   * Gets a list of content types acceptable by the client browser in preferable order.
-   * @returns {string[]}
-   */
-  getAcceptableContentTypes(): string[];
   /**
    * Determine if the request is the result of a PJAX call.
    *
@@ -800,60 +1478,6 @@ declare class Request implements IRequest {
    * @returns {boolean}
    */
   ajax(): boolean;
-  /**
-   * Returns true if the request is an XMLHttpRequest (AJAX).
-   */
-  isXmlHttpRequest(): boolean;
-  /**
-   * Returns the value of the requested header.
-   */
-  getHeader(name: string): string | undefined | null;
-  /**
-   * Checks if the request method is of specified type.
-   *
-   * @param method Uppercase request method (GET, POST etc)
-   */
-  isMethod(method: string): boolean;
-  /**
-   * Checks whether or not the method is safe.
-   *
-   * @see https://tools.ietf.org/html/rfc7231#section-4.2.1
-   */
-  isMethodSafe(): boolean;
-  /**
-   * Checks whether or not the method is idempotent.
-   */
-  isMethodIdempotent(): boolean;
-  /**
-   * Checks whether the method is cacheable or not.
-   *
-   * @see https://tools.ietf.org/html/rfc7231#section-4.2.3
-   */
-  isMethodCacheable(): boolean;
-  /**
-   * Initializes HTTP request formats.
-   */
-  protected static initializeFormats(): void;
-  /**
-   * 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(): RequestMethod;
-  /**
-   * Gets the "real" request method.
-   *
-   * @see getMethod()
-   */
-  getRealMethod(): RequestMethod;
   /**
    * Get the client IP address.
    */
@@ -888,46 +1512,10 @@ declare class Request implements IRequest {
    * @return {InputBag}
    */
   protected getInputSource(): InputBag;
-  /**
-   * 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?: boolean): string | ReadableStream;
-  /**
-   * 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: string, defaultValue?: any): any;
-  /**
-   * 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(): void;
-  /**
-   * Checks whether support for the _method request parameter is enabled.
-   */
-  static getHttpMethodParameterOverride(): boolean;
   /**
    * Dump the items.
    *
    * @param  keys
-   * @return this
    */
   dump(...keys: any[]): this;
   /**
@@ -1033,47 +1621,66 @@ declare class JsonResource<R$1 extends Resource = any> {
 declare function ApiResource(instance: JsonResource): JsonResource<any>;
 //#endregion
 //#region src/Response.d.ts
-declare class Response implements IResponse {
+declare class Response extends HttpResponse implements IResponse {
   /**
    * The current app instance
    */
   app: Application;
+  constructor(
   /**
    * The current H3 H3Event instance
    */
-  private readonly event;
-  private statusCode;
-  private headers;
-  constructor(event: H3Event,
+  event: H3Event,
   /**
    * The current app instance
    */
   app: Application);
   /**
-   * Set HTTP status code.
+   * Sends content for the current web response.
    */
-  setStatusCode(code: number): this;
+  sendContent(type?: 'html' | 'json' | 'text' | 'xml', parse?: boolean): unknown;
   /**
-   * Set a header.
+   * Sends content for the current web response.
    */
-  setHeader(name: string, value: string): this;
-  html(content: string): HTTPResponse;
+  send(type?: 'html' | 'json' | 'text' | 'xml'): unknown;
+  /**
+   *
+   * @param content The content to serve
+   * @param send if set to true, the content will be returned, instead of the Response instance
+   * @returns
+   */
+  html(content?: string): this;
+  html(content: string, parse: boolean): HTTPResponse;
   /**
    * Send a JSON response.
    */
-  json<T = unknown>(data: T): T;
+  json<T = unknown>(data?: T): this;
+  json<T = unknown>(data: T, parse: boolean): T;
   /**
    * Send plain text.
    */
-  text(data: string): string;
+  text(content?: string): this;
+  text(content: string, parse: boolean): HTTPResponse;
+  /**
+   * Send plain xml.
+   */
+  xml(data?: string): this;
+  xml(data: string, parse: boolean): HTTPResponse;
+  /**
+   * Build the HTTP Response
+   *
+   * @param contentType
+   * @param data
+   */
+  private httpResponse;
   /**
    * Redirect to another URL.
    */
   redirect(location: string, status?: number, statusText?: string | undefined): HTTPResponse;
   /**
-   * Apply headers before sending response.
+   * Dump the response.
    */
-  private applyHeaders;
+  dump(): this;
   /**
    * Get the base event
    */
@@ -1081,4 +1688,210 @@ declare class Response implements IResponse {
   getEvent<K extends DotNestedKeys<H3Event>>(key: K): DotNestedValue<H3Event, K>;
 }
 //#endregion
-export { ApiResource, BadRequestException, FileBag, FireCommand, FormRequest, HeaderBag, HttpContext, HttpServiceProvider, InputBag, JsonResource, LogRequests, Middleware, ParamBag, Request, Resource, Response, ServerBag, SuspiciousOperationException, UnexpectedValueException, UploadedFile };
+//#region src/Utilities/HeaderUtility.d.ts
+/**
+ * HTTP header utility functions .
+ */
+declare class HeaderUtility {
+  static readonly DISPOSITION_ATTACHMENT = "attachment";
+  static readonly DISPOSITION_INLINE = "inline";
+  private 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: string, separators: string): string[][];
+  /**
+   * Combines an array of arrays into one associative object.
+   * [['foo', 'abc'], ['bar']] => { foo: 'abc', bar: true }
+   */
+  static combine(parts: (string | true)[][]): Record<string, string | boolean>;
+  /**
+   * 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: Record<string, string | boolean>, separator: string): string;
+  /**
+   * Encodes a string as a quoted string, if necessary.
+   */
+  static quote(s: string): string;
+  /**
+   * Decodes a quoted string.
+   */
+  static unquote(s: string): string;
+  /**
+   * Generates an HTTP Content-Disposition field-value.
+   *
+   * @see RFC 6266
+   */
+  static makeDisposition(disposition: string, filename: string, filenameFallback?: string): string;
+  /**
+   * Like parse_str(), but preserves dots in variable names.
+   */
+  static parseQuery(query: string, ignoreBrackets?: boolean, separator?: string): Record<string, any>;
+  private static groupParts;
+}
+//#endregion
+//#region src/Utilities/IpUtils.d.ts
+/**
+ * Http utility functions for IP handling.
+ */
+declare class IpUtils {
+  static readonly PRIVATE_SUBNETS: string[];
+  private static checkedIps;
+  private 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?: string, ips?: string | string[]): boolean;
+  /**
+   * 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: string, ip: string): boolean;
+  /**
+   * 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: string, ip: string): boolean;
+  /**
+   * Anonymizes an IPv4/IPv6 by zeroing out trailing bytes.
+   *
+   * @param ip
+   * @param v4Bytes
+   * @param v6Bytes
+   */
+  static anonymize(ip: string, v4Bytes?: number, v6Bytes?: number): string;
+  /**
+   * Checks if IP is within private subnets.
+   */
+  static isPrivateIp(requestIp: string): boolean;
+  private static isIPv4;
+  private static isIPv6;
+  private static ipv4ToLong;
+  private static inetPton;
+  private static inetPton4;
+  private static inetPton6;
+  private static inetNtop;
+  private static getCacheResult;
+  private static setCacheResult;
+}
+//#endregion
+//#region src/Utilities/ResponseUtilities.d.ts
+declare enum ResponseCodes {
+  HTTP_CONTINUE = 100,
+  HTTP_SWITCHING_PROTOCOLS = 101,
+  HTTP_PROCESSING = 102,
+  // RFC2518
+  HTTP_EARLY_HINTS = 103,
+  // RFC8297
+  HTTP_OK = 200,
+  HTTP_CREATED = 201,
+  HTTP_ACCEPTED = 202,
+  HTTP_NON_AUTHORITATIVE_INFORMATION = 203,
+  HTTP_NO_CONTENT = 204,
+  HTTP_RESET_CONTENT = 205,
+  HTTP_PARTIAL_CONTENT = 206,
+  HTTP_MULTI_STATUS = 207,
+  // RFC4918
+  HTTP_ALREADY_REPORTED = 208,
+  // RFC5842
+  HTTP_IM_USED = 226,
+  // RFC3229
+  HTTP_MULTIPLE_CHOICES = 300,
+  HTTP_MOVED_PERMANENTLY = 301,
+  HTTP_FOUND = 302,
+  HTTP_SEE_OTHER = 303,
+  HTTP_NOT_MODIFIED = 304,
+  HTTP_USE_PROXY = 305,
+  HTTP_RESERVED = 306,
+  HTTP_TEMPORARY_REDIRECT = 307,
+  HTTP_PERMANENTLY_REDIRECT = 308,
+  // RFC7238
+  HTTP_BAD_REQUEST = 400,
+  HTTP_UNAUTHORIZED = 401,
+  HTTP_PAYMENT_REQUIRED = 402,
+  HTTP_FORBIDDEN = 403,
+  HTTP_NOT_FOUND = 404,
+  HTTP_METHOD_NOT_ALLOWED = 405,
+  HTTP_NOT_ACCEPTABLE = 406,
+  HTTP_PROXY_AUTHENTICATION_REQUIRED = 407,
+  HTTP_REQUEST_TIMEOUT = 408,
+  HTTP_CONFLICT = 409,
+  HTTP_GONE = 410,
+  HTTP_LENGTH_REQUIRED = 411,
+  HTTP_PRECONDITION_FAILED = 412,
+  HTTP_REQUEST_ENTITY_TOO_LARGE = 413,
+  HTTP_REQUEST_URI_TOO_LONG = 414,
+  HTTP_UNSUPPORTED_MEDIA_TYPE = 415,
+  HTTP_REQUESTED_RANGE_NOT_SATISFIABLE = 416,
+  HTTP_EXPECTATION_FAILED = 417,
+  HTTP_I_AM_A_TEAPOT = 418,
+  // RFC2324
+  HTTP_MISDIRECTED_REQUEST = 421,
+  // RFC7540
+  HTTP_UNPROCESSABLE_ENTITY = 422,
+  // RFC4918
+  HTTP_LOCKED = 423,
+  // RFC4918
+  HTTP_FAILED_DEPENDENCY = 424,
+  // RFC4918
+  HTTP_TOO_EARLY = 425,
+  // RFC-ietf-httpbis-replay-04
+  HTTP_UPGRADE_REQUIRED = 426,
+  // RFC2817
+  HTTP_PRECONDITION_REQUIRED = 428,
+  // RFC6585
+  HTTP_TOO_MANY_REQUESTS = 429,
+  // RFC6585
+  HTTP_REQUEST_HEADER_FIELDS_TOO_LARGE = 431,
+  // RFC6585
+  HTTP_UNAVAILABLE_FOR_LEGAL_REASONS = 451,
+  // RFC7725
+  HTTP_INTERNAL_SERVER_ERROR = 500,
+  HTTP_NOT_IMPLEMENTED = 501,
+  HTTP_BAD_GATEWAY = 502,
+  HTTP_SERVICE_UNAVAILABLE = 503,
+  HTTP_GATEWAY_TIMEOUT = 504,
+  HTTP_VERSION_NOT_SUPPORTED = 505,
+  HTTP_VARIANT_ALSO_NEGOTIATES_EXPERIMENTAL = 506,
+  // RFC2295
+  HTTP_INSUFFICIENT_STORAGE = 507,
+  // RFC4918
+  HTTP_LOOP_DETECTED = 508,
+  // RFC5842
+  HTTP_NOT_EXTENDED = 510,
+  // RFC2774
+  HTTP_NETWORK_AUTHENTICATION_REQUIRED = 511,
+}
+declare const HTTP_RESPONSE_CACHE_CONTROL_DIRECTIVES: CacheOptions;
+/**
+ * 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.
+ */
+declare const statusTexts: {
+  [key: number]: string;
+};
+//#endregion
+export { ApiResource, BadRequestException, CacheOptions, ConflictingHeadersException, Cookie, FileBag, FireCommand, FormRequest, HTTP_RESPONSE_CACHE_CONTROL_DIRECTIVES, HeaderBag, HeaderUtility, HttpContext, HttpRequest, HttpResponse, HttpResponseException, HttpServiceProvider, InputBag, IpUtils, JsonResource, LogRequests, Middleware, ParamBag, Request, Resource, Response, ResponseCodes, ResponseHeaderBag, ServerBag, SuspiciousOperationException, UnexpectedValueException, UploadedFile, statusTexts };