@adonix.org/cloud-spark 0.0.141 → 0.0.143

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import CacheLib from 'cache-control-parser';
+import { MatchFunction } from 'path-to-regexp';
 import { StatusCodes } from 'http-status-codes';
 export { StatusCodes } from 'http-status-codes';
-import { MatchFunction } from 'path-to-regexp';
 
 /**
  * @see {@link https://github.com/etienne-martin/cache-control-parser | cache-control-parser}
@@ -10,7 +10,7 @@ type CacheControl = CacheLib.CacheControl;
 declare const CacheControl: {
     parse: (cacheControlHeader: string) => CacheLib.CacheControl;
     stringify: (cacheControl: CacheLib.CacheControl) => string;
-    /** A Cache-Control directive that disables all caching. */
+    /** A CacheControl directive that disables all caching. */
     DISABLE: Readonly<{
         "no-cache": true;
         "no-store": true;
@@ -19,16 +19,20 @@ declare const CacheControl: {
     }>;
 };
 
+/**
+ * https://github.com/prettymuchbryce/http-status-codes
+ */
+
 /**
  * Standard HTTP header names and common values.
  */
 declare namespace HttpHeader {
     const VARY = "Vary";
     const ALLOW = "Allow";
+    const ORIGIN = "Origin";
     const USER_AGENT = "User-Agent";
     const CONTENT_TYPE = "Content-Type";
     const CACHE_CONTROL = "Cache-Control";
-    const SEC_FETCH_SITE = "Sec-Fetch-Site";
     const X_FRAME_OPTIONS = "X-Frame-Options";
     const X_CONTENT_TYPE_OPTIONS = "X-Content-Type-Options";
     const REFERRER_POLICY = "Referrer-Policy";
@@ -41,22 +45,9 @@ declare namespace HttpHeader {
     const ALLOW_METHODS = "Access-Control-Allow-Methods";
     const EXPOSE_HEADERS = "Access-Control-Expose-Headers";
     const ALLOW_CREDENTIALS = "Access-Control-Allow-Credentials";
-    const ORIGIN = "Origin";
     const ALLOW_ALL_ORIGINS = "*";
     const CROSS_SITE = "cross-site";
 }
-/**
- * Time constants in seconds. Month is approximated as 30 days.
- */
-declare const Time: {
-    readonly Second: 1;
-    readonly Minute: 60;
-    readonly Hour: 3600;
-    readonly Day: 86400;
-    readonly Week: 604800;
-    readonly Month: 2592000;
-    readonly Year: 31536000;
-};
 /**
  * Standard HTTP request methods.
  */
@@ -82,21 +73,7 @@ declare const POST: Method;
 declare const PATCH: Method;
 declare const DELETE: Method;
 declare const OPTIONS: Method;
-/**
- * Type guard that checks if a string is a valid HTTP method.
- *
- * @param value - The string to test.
- * @returns True if `value` is a recognized HTTP method.
- */
-declare function isMethod(value: string): value is Method;
-/**
- * Returns the proper Content-Type string for a given media type.
- * Appends `charset=utf-8` for text-based types that require it.
- *
- * @param type - The media type.
- * @returns A string suitable for the `Content-Type` header.
- */
-declare function getContentType(type: MediaType): string;
+
 /**
  * Common media types used for HTTP headers.
  */
@@ -145,241 +122,19 @@ declare enum MediaType {
     TAR = "application/x-tar",
     BZIP2 = "application/x-bzip2"
 }
-/**
- * Sets a header on the given Headers object.
- *
- * - If `value` is an array, any duplicates and empty strings are removed.
- * - If the resulting value array is empty, the header is deleted.
- * - Otherwise, values are joined with `", "` and set as the header value.
- *
- * @param headers - The Headers object to modify.
- * @param key - The header name to set.
- * @param value - The header value(s) to set. Can be a string or array of strings.
- */
-declare function setHeader(headers: Headers, key: string, value: string | string[]): void;
-/**
- * Merges new value(s) into an existing header on the given Headers object.
- *
- * - Preserves any existing values and adds new ones.
- * - Removes duplicates and trims all values.
- * - If the header does not exist, it is created.
- *
- * @param headers - The Headers object to modify.
- * @param key - The header name to merge into.
- * @param value - The new header value(s) to add. Can be a string or array of strings.
- */
-declare function mergeHeader(headers: Headers, key: string, value: string | string[]): void;
-/**
- * Normalizes a URL string for use as a consistent cache key.
- *
- * - Sorts query parameters alphabetically so `?b=2&a=1` and `?a=1&b=2` are treated the same.
- * - Strips fragment identifiers (`#...`) since they are not sent in HTTP requests.
- * - Leaves protocol, host, path, and query values intact.
- *
- * @param url The original URL string to normalize.
- * @returns A normalized URL string suitable for hashing or direct cache key use.
- */
-declare function normalizeUrl(url: string): URL;
-/**
- * Lexicographically compares two strings.
- *
- * This comparator can be used in `Array.prototype.sort()` to produce a
- * consistent, stable ordering of string arrays.
- *
- * @param a - The first string to compare.
- * @param b - The second string to compare.
- * @returns A number indicating the relative order of `a` and `b`.
- */
-declare function lexCompare(a: string, b: string): number;
-/**
- * Extracts the `Origin` header value from a request.
- *
- * The `Origin` header identifies the origin (scheme, host, and port)
- * of the request initiator. It is commonly used for CORS checks.
- *
- * @param request - The incoming {@link Request} object.
- * @returns The origin string if present, otherwise `null`.
- */
-declare function getOrigin(request: Request): string | null;
-
-/**
- * Represents the constructor of a Worker subclass.
- *
- * @template T - The specific type of Worker being constructed. Defaults to `Worker`.
- * @param req - The `Request` object to be handled by the worker instance.
- * @param env - The environment bindings available to the worker.
- * @param ctx - The `ExecutionContext` for the worker invocation.
- * @returns An instance of the worker type `T`.
- */
-type WorkerClass<T extends Worker = Worker> = new (request: Request, env: Env, ctx: ExecutionContext) => T;
-/**
- * Defines the contract for a Cloudflare-compatible Worker.
- *
- * Implementations are responsible for handling incoming requests,
- * providing access to the request, environment bindings, and
- * execution context.
- */
-interface Worker {
-    /**
-     * Processes the incoming {@link Request} and produces a {@link Response}.
-     *
-     * @returns A Promise that resolves to the HTTP {@link Response}.
-     */
-    fetch(): Promise<Response>;
-    /**
-     * The original {@link Request} being processed by this worker instance.
-     */
-    get request(): Request;
-    /**
-     * The environment bindings provided at runtime (e.g., KV, R2, secrets).
-     */
-    get env(): Env;
-    /**
-     * The {@link ExecutionContext} associated with the current request,
-     * used to manage background tasks and request lifecycle.
-     */
-    get ctx(): ExecutionContext;
-    /**
-     * The HTTP methods supported by this worker.
-     */
-    getAllowedMethods(): Method[];
-}
 
 /**
- * Base class for building HTTP responses.
- * Manages headers, status, and media type.
- */
-declare abstract class BaseResponse {
-    constructor();
-    /** HTTP headers for the response. */
-    headers: Headers;
-    /** HTTP status code (default 200 OK). */
-    status: StatusCodes;
-    /** Optional status text. Defaults to standard reason phrase. */
-    statusText?: string;
-    /** Default media type of the response body. */
-    mediaType: MediaType;
-    /** Converts current state to ResponseInit for constructing a Response. */
-    protected get responseInit(): ResponseInit;
-    /** Sets a header, overwriting any existing value. */
-    setHeader(key: string, value: string | string[]): void;
-    /** Merges a header with existing values (does not overwrite). */
-    mergeHeader(key: string, value: string | string[]): void;
-    /** Adds a Content-Type header if not already existing (does not overwrite). */
-    addContentType(): void;
-}
-/**
- * Base response class that adds caching headers.
- */
-declare abstract class CacheResponse extends BaseResponse {
-    cache?: CacheControl | undefined;
-    constructor(cache?: CacheControl | undefined);
-    /** Adds Cache-Control header if caching is configured. */
-    protected addCacheHeader(): void;
-}
-/**
- * Core worker response. Combines caching, and security headers.
- */
-declare abstract class WorkerResponse extends CacheResponse {
-    readonly worker: Worker;
-    private readonly body;
-    constructor(worker: Worker, body?: BodyInit | null, cache?: CacheControl);
-    /** Builds the Response object with body, headers, and status. */
-    getResponse(): Promise<Response>;
-}
-/**
- * Wraps an existing Response and clones its body, headers, and status.
- */
-declare class ClonedResponse extends WorkerResponse {
-    constructor(worker: Worker, response: Response, cache?: CacheControl);
-}
-/**
- * Represents a successful response with customizable body and status.
- */
-declare class SuccessResponse extends WorkerResponse {
-    constructor(worker: Worker, body?: BodyInit | null, cache?: CacheControl, status?: StatusCodes);
-}
-/**
- * JSON response. Automatically sets Content-Type to application/json.
- */
-declare class JsonResponse extends SuccessResponse {
-    constructor(worker: Worker, json?: unknown, cache?: CacheControl, status?: StatusCodes);
-}
-/**
- * HTML response. Automatically sets Content-Type to text/html.
- */
-declare class HtmlResponse extends SuccessResponse {
-    constructor(worker: Worker, body: string, cache?: CacheControl, status?: StatusCodes);
-}
-/**
- * Plain text response. Automatically sets Content-Type to text/plain.
- */
-declare class TextResponse extends SuccessResponse {
-    constructor(worker: Worker, content: string, cache?: CacheControl, status?: StatusCodes);
-}
-/**
- * Response for HEAD requests. Clones headers but has no body.
- */
-declare class Head extends WorkerResponse {
-    constructor(worker: Worker, get: Response);
-}
-/**
- * Response for OPTIONS preflight requests.
- * Sets CORS headers and returns 204 No Content.
- */
-declare class Options extends SuccessResponse {
-    constructor(worker: Worker);
-}
-
-/**
- * Generic HTTP error response.
- * Sends a JSON body with status, error message, and details.
+ * Time constants in seconds. Month is approximated as 30 days.
  */
-declare class HttpError extends JsonResponse {
-    protected readonly details?: string | undefined;
-    /**
-     * @param worker The worker handling the request.
-     * @param status HTTP status code.
-     * @param details Optional detailed error message.
-     */
-    constructor(worker: Worker, status: StatusCodes, details?: string | undefined);
-}
-/** 400 Bad Request error response. */
-declare class BadRequest extends HttpError {
-    constructor(worker: Worker, details?: string);
-}
-/** 401 Unauthorized error response. */
-declare class Unauthorized extends HttpError {
-    constructor(worker: Worker, details?: string);
-}
-/** 403 Forbidden error response. */
-declare class Forbidden extends HttpError {
-    constructor(worker: Worker, details?: string);
-}
-/** 404 Not Found error response. */
-declare class NotFound extends HttpError {
-    constructor(worker: Worker, details?: string);
-}
-/** 405 Method Not Allowed error response. */
-declare class MethodNotAllowed extends HttpError {
-    constructor(worker: Worker);
-}
-/** 500 Internal Server Error response. */
-declare class InternalServerError extends HttpError {
-    constructor(worker: Worker, details?: string);
-}
-/** 501 Not Implemented error response. */
-declare class NotImplemented extends HttpError {
-    constructor(worker: Worker, details?: string);
-}
-/** 501 Method Not Implemented error response for unsupported HTTP methods. */
-declare class MethodNotImplemented extends NotImplemented {
-    constructor(worker: Worker);
-}
-/** 503 Service Unavailable error response. */
-declare class ServiceUnavailable extends HttpError {
-    constructor(worker: Worker, details?: string);
-}
+declare const Time: {
+    readonly Second: 1;
+    readonly Minute: 60;
+    readonly Hour: 3600;
+    readonly Day: 86400;
+    readonly Week: 604800;
+    readonly Month: 2592000;
+    readonly Year: 31536000;
+};
 
 /**
  * Override only what is needed from the default CORS configuration.
@@ -427,8 +182,8 @@ interface CorsConfig {
  * Structure for JSON-formatted error responses.
  *
  * This interface defines the standard shape of error responses returned
- * by middleware or workers when an operation fails. It ensures consistent
- * error reporting and easy parsing by clients.
+ * when an operation fails. It ensures consistent error reporting and easy
+ * parsing by clients.
  */
 interface ErrorJson {
     /**
@@ -447,12 +202,57 @@ interface ErrorJson {
      * Optional detailed message describing the error.
      *
      * This can include additional context, debugging hints, or
-     * information useful to the client. May be an empty string
+     * information useful to the client. Will be an empty string
      * if no details are provided.
      */
     details: string;
 }
 
+/**
+ * Represents the constructor of a Worker subclass.
+ *
+ * @template T - The specific type of Worker being constructed. Defaults to `Worker`.
+ * @param req - The `Request` object to be handled by the worker instance.
+ * @param env - The environment bindings available to the worker.
+ * @param ctx - The `ExecutionContext` for the worker invocation.
+ * @returns An instance of the worker type `T`.
+ */
+type WorkerClass<T extends Worker = Worker> = new (request: Request, env: Env, ctx: ExecutionContext) => T;
+/**
+ * Defines the contract for a Cloudflare-compatible Worker.
+ *
+ * Implementations are responsible for handling incoming requests,
+ * providing access to the request, environment bindings, and
+ * execution context.
+ */
+interface Worker {
+    /**
+     * Processes the incoming {@link Request} and produces a {@link Response}.
+     *
+     * @returns A Promise that resolves to the HTTP {@link Response}.
+     */
+    fetch(): Promise<Response>;
+    /**
+     * The original {@link Request} being processed by this worker instance.
+     */
+    get request(): Request;
+    /**
+     * The environment bindings provided at runtime (e.g., KV, R2, secrets).
+     */
+    get env(): Env;
+    /**
+     * The {@link ExecutionContext} associated with the current request,
+     * used to manage background tasks and request lifecycle.
+     */
+    get ctx(): ExecutionContext;
+    /**
+     * Returns the list of HTTP methods that are allowed for this worker.
+     *
+     * @returns An array of allowed HTTP methods.
+     */
+    getAllowedMethods(): Method[];
+}
+
 /**
  * Parameters extracted from a matched route.
  *
@@ -562,26 +362,131 @@ declare abstract class Middleware {
     abstract handle(worker: Worker, next: () => Promise<Response>): Promise<Response>;
 }
 
+/**
+ * Middleware for caching GET requests.
+ *
+ * This middleware checks a cache (either a named cache or the default)
+ * before passing the request down the middleware chain. Responses for
+ * successful GET requests are automatically stored in the cache.
+ *
+ * Non-GET requests are never cached. The cache key can be customized
+ * via the `getKey` function; otherwise, the URL is normalized and used.
+ *
+ * @param cacheName - Optional name of the cache to use. Defaults to `caches.default`.
+ * @param getKey - Optional function to generate a cache key from a request.
+ * @returns A {@link Middleware} instance that can be added to your middleware chain.
+ */
+declare function cache(cacheName?: string, getKey?: (request: Request) => URL | RequestInfo): Middleware;
+
+/**
+ * Creates a CORS middleware instance.
+ *
+ * This middleware automatically handles Cross-Origin Resource Sharing (CORS)
+ * for incoming requests, including preflight OPTIONS requests, and adds
+ * appropriate headers to responses.
+ *
+ * @param init - Optional configuration for CORS behavior. See {@link CorsConfig}.
+ * @returns A {@link Middleware} instance that can be used in your middleware chain.
+ */
 declare function cors(init?: CorsInit): Middleware;
 
-declare function cache(cacheName?: string, getKey?: (request: Request) => URL | RequestInfo): Middleware;
+/**
+ * Lexicographically compares two strings.
+ *
+ * This comparator can be used in `Array.prototype.sort()` to produce a
+ * consistent, stable ordering of string arrays.
+ *
+ * @param a - The first string to compare.
+ * @param b - The second string to compare.
+ * @returns A number indicating the relative order of `a` and `b`.
+ */
+declare function lexCompare(a: string, b: string): number;
 
 /**
- * A type-safe Cloudflare Worker handler.
+ * Sets a header on the given Headers object.
+ *
+ * - If `value` is an array, any duplicates and empty strings are removed.
+ * - If the resulting value array is empty, the header is deleted.
+ * - Otherwise, values are joined with `", "` and set as the header value.
+ *
+ * @param headers - The Headers object to modify.
+ * @param key - The header name to set.
+ * @param value - The header value(s) to set. Can be a string or array of strings.
+ */
+declare function setHeader(headers: Headers, key: string, value: string | string[]): void;
+/**
+ * Merges new value(s) into an existing header on the given Headers object.
+ *
+ * - Preserves any existing values and adds new ones.
+ * - Removes duplicates and trims all values.
+ * - If the header does not exist, it is created.
+ * - If the resulting value array is empty, the header is deleted.
  *
- * Extends `ExportedHandler` but guarantees that the `fetch` method exists
- * and has the correct signature for Cloudflare Worker invocation.
+ * @param headers - The Headers object to modify.
+ * @param key - The header name to merge into.
+ * @param value - The new header value(s) to add. Can be a string or array of strings.
+ */
+declare function mergeHeader(headers: Headers, key: string, value: string | string[]): void;
+
+/**
+ * Type guard that checks if a string is a valid HTTP method.
  *
- * @template E - The type of environment bindings passed to the worker. Defaults to `Env`.
+ * @param value - The string to test.
+ * @returns True if `value` is a recognized HTTP method.
+ */
+declare function isMethod(value: string): value is Method;
+/**
+ * Returns the proper Content-Type string for a given media type.
+ * Appends `charset=utf-8` for text-based types that require it.
+ *
+ * @param type - The media type.
+ * @returns A string suitable for the `Content-Type` header.
+ */
+declare function getContentType(type: MediaType): string;
+/**
+ * Extracts and normalizes the `Origin` header from a request.
+ *
+ * Returns the origin (scheme + host + port) as a string if present and valid.
+ * Returns `null` if:
+ *   - The `Origin` header is missing
+ *   - The `Origin` header is `"null"` (opaque origin)
+ *   - The `Origin` header is malformed
+ *
+ * @param request - The incoming {@link Request} object.
+ * @returns The normalized origin string, or `null` if not present or invalid.
+ */
+declare function getOrigin(request: Request): string | null;
+
+/**
+ * Normalizes a URL string for use as a consistent cache key.
+ *
+ * - Sorts query parameters alphabetically so `?b=2&a=1` and `?a=1&b=2` are treated the same.
+ * - Strips fragment identifiers (`#...`) since they are not sent in HTTP requests.
+ * - Leaves protocol, host, path, and query values intact.
+ *
+ * @param url The original URL string to normalize.
+ * @returns A normalized URL string suitable for hashing or direct cache key use.
+ */
+declare function normalizeUrl(url: string): URL;
+
+/**
+ * A type-safe Cloudflare Worker handler with a guaranteed `fetch` method.
+ *
+ * Extends `ExportedHandler` but ensures that `fetch` exists and has the
+ * correct signature for Cloudflare Worker invocation.
+ *
+ * `Env` is a placeholder type for the environment bindings provided by
+ * the user (e.g., KV namespaces, secrets, Durable Objects). This interface
+ * does not constrain the actual type; it only ensures `fetch` is present.
  */
 interface FetchHandler extends ExportedHandler<Env> {
     /**
      * Handles an incoming request and produces a response.
      *
      * @param request - The incoming `Request` object.
-     * @param env - Environment bindings (e.g., KV namespaces, secrets, Durable Objects).
+     * @param env - User-provided environment bindings (placeholder type).
      * @param ctx - Execution context for background tasks (`waitUntil`).
-     * @returns A `Promise` that resolves to the response.
+     * @returns A `Promise` that resolves to a `Response`.
      */
     fetch: (request: Request, env: Env, ctx: ExecutionContext) => Promise<Response>;
 }
@@ -616,13 +521,7 @@ declare abstract class BaseWorker implements Worker {
      * @returns A Promise that resolves to the `Response` for the request.
      */
     protected abstract dispatch(): Promise<Response>;
-    /**
-     * DEFAULT allowed HTTP methods for subclasses.
-     *
-     * These defaults were selected for getting started quickly and should be
-     * overridden for the specific worker.
-     */
-    getAllowedMethods(): Method[];
+    abstract getAllowedMethods(): Method[];
     /**
      * Creates a new instance of the current Worker subclass.
      *
@@ -712,6 +611,13 @@ declare abstract class BasicWorker extends MiddlewareWorker {
      * standard HEAD requirements.
      */
     protected head(): Promise<Response>;
+    /**
+     * DEFAULT allowed HTTP methods for subclasses.
+     *
+     * These defaults were selected for getting started quickly and should be
+     * overridden for each specific worker.
+     */
+    getAllowedMethods(): Method[];
     /**
      * Simplify and standardize {@link Response} creation by extending {@link WorkerResponse}
      * or any of its subclasses and passing to this method.
@@ -726,7 +632,9 @@ declare abstract class BasicWorker extends MiddlewareWorker {
      * @param args Additional constructor arguments
      * @returns A Promise resolving to the {@link Response} object
      */
-    protected getResponse<T extends WorkerResponse, Ctor extends new (worker: Worker, ...args: any[]) => T>(ResponseClass: Ctor, ...args: ConstructorParameters<Ctor> extends [Worker, ...infer R] ? R : never): Promise<Response>;
+    protected getResponse<Ctor extends new (...args: any[]) => {
+        getResponse(): Promise<Response>;
+    }>(ResponseClass: Ctor, ...args: ConstructorParameters<Ctor>): Promise<Response>;
 }
 
 /**
@@ -795,4 +703,138 @@ declare abstract class RouteWorker extends BasicWorker {
     protected options(): Promise<Response>;
 }
 
+/**
+ * Base class for building HTTP responses.
+ * Manages headers, status, and media type.
+ */
+declare abstract class BaseResponse {
+    /** HTTP headers for the response. */
+    headers: Headers;
+    /** HTTP status code (default 200 OK). */
+    status: StatusCodes;
+    /** Optional status text. Defaults to standard reason phrase. */
+    statusText?: string;
+    /** Default media type of the response body. */
+    mediaType: MediaType;
+    /** Converts current state to ResponseInit for constructing a Response. */
+    protected get responseInit(): ResponseInit;
+    /** Sets a header, overwriting any existing value. */
+    setHeader(key: string, value: string | string[]): void;
+    /** Merges a header with existing values (does not overwrite). */
+    mergeHeader(key: string, value: string | string[]): void;
+    /** Adds a Content-Type header if not already existing (does not overwrite). */
+    addContentType(): void;
+}
+/**
+ * Base response class that adds caching headers.
+ */
+declare abstract class CacheResponse extends BaseResponse {
+    cache?: CacheControl | undefined;
+    constructor(cache?: CacheControl | undefined);
+    /** Adds Cache-Control header if caching is configured. */
+    protected addCacheHeader(): void;
+}
+/**
+ * Core worker response. Combines caching, and security headers.
+ */
+declare abstract class WorkerResponse extends CacheResponse {
+    private readonly body;
+    constructor(body?: BodyInit | null, cache?: CacheControl);
+    /** Builds the Response object with body, headers, and status. */
+    getResponse(): Promise<Response>;
+}
+/**
+ * Wraps an existing Response and clones its body, headers, and status.
+ */
+declare class ClonedResponse extends WorkerResponse {
+    constructor(response: Response, cache?: CacheControl);
+}
+/**
+ * Represents a successful response with customizable body, cache and status.
+ */
+declare class SuccessResponse extends WorkerResponse {
+    constructor(body?: BodyInit | null, cache?: CacheControl, status?: StatusCodes);
+}
+/**
+ * JSON response. Automatically sets Content-Type to application/json.
+ */
+declare class JsonResponse extends SuccessResponse {
+    constructor(json?: unknown, cache?: CacheControl, status?: StatusCodes);
+}
+/**
+ * HTML response. Automatically sets Content-Type to text/html.
+ */
+declare class HtmlResponse extends SuccessResponse {
+    constructor(body: string, cache?: CacheControl, status?: StatusCodes);
+}
+/**
+ * Plain text response. Automatically sets Content-Type to text/plain.
+ */
+declare class TextResponse extends SuccessResponse {
+    constructor(content: string, cache?: CacheControl, status?: StatusCodes);
+}
+/**
+ * Response for HEAD requests. Copy headers and status from a GET response
+ * without the body.
+ */
+declare class Head extends WorkerResponse {
+    constructor(get: Response);
+}
+/**
+ * Response for OPTIONS preflight requests.
+ */
+declare class Options extends SuccessResponse {
+    constructor();
+}
+
+/**
+ * Generic HTTP error response.
+ * Sends a JSON body with status, error message, and details.
+ */
+declare class HttpError extends JsonResponse {
+    protected readonly details?: string | undefined;
+    /**
+     * @param worker The worker handling the request.
+     * @param status HTTP status code.
+     * @param details Optional detailed error message.
+     */
+    constructor(status: StatusCodes, details?: string | undefined);
+}
+/** 400 Bad Request error response. */
+declare class BadRequest extends HttpError {
+    constructor(details?: string);
+}
+/** 401 Unauthorized error response. */
+declare class Unauthorized extends HttpError {
+    constructor(details?: string);
+}
+/** 403 Forbidden error response. */
+declare class Forbidden extends HttpError {
+    constructor(details?: string);
+}
+/** 404 Not Found error response. */
+declare class NotFound extends HttpError {
+    constructor(details?: string);
+}
+/** 405 Method Not Allowed error response. */
+declare class MethodNotAllowed extends HttpError {
+    constructor(worker: Worker);
+}
+/** 500 Internal Server Error response. */
+declare class InternalServerError extends HttpError {
+    constructor(details?: string);
+}
+/** 501 Not Implemented error response. */
+declare class NotImplemented extends HttpError {
+    constructor(details?: string);
+}
+/** 501 Method Not Implemented error response for unsupported HTTP methods. */
+declare class MethodNotImplemented extends NotImplemented {
+    constructor(worker: Worker);
+}
+/** 503 Service Unavailable error response. */
+declare class ServiceUnavailable extends HttpError {
+    constructor(details?: string);
+}
+
 export { BadRequest, BasicWorker, CacheControl, ClonedResponse, type CorsConfig, type CorsInit, DELETE, type ErrorJson, Forbidden, GET, HEAD, Head, HtmlResponse, HttpError, HttpHeader, InternalServerError, JsonResponse, type MatchedRoute, MediaType, Method, MethodNotAllowed, MethodNotImplemented, Middleware, NotFound, NotImplemented, OPTIONS, Options, PATCH, POST, PUT, type PathParams, type Route, type RouteCallback, type RouteHandler, type RouteTable, type RouteTuple, RouteWorker, ServiceUnavailable, SuccessResponse, TextResponse, Time, Unauthorized, type Worker, type WorkerClass, WorkerResponse, cache, cors, getContentType, getOrigin, isMethod, lexCompare, mergeHeader, normalizeUrl, setHeader };