@adonix.org/cloud-spark 0.0.104 → 0.0.106

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import { StatusCodes } from 'http-status-codes';
 export { StatusCodes } from 'http-status-codes';
 import CacheLib from 'cache-control-parser';
+import { MatchFunction } from 'path-to-regexp';
 
 /**
  * @see {@link https://github.com/etienne-martin/cache-control-parser | cache-control-parser}
@@ -247,7 +248,7 @@ declare abstract class CacheResponse extends CorsResponse {
 declare abstract class WorkerResponse extends CacheResponse {
     private readonly body;
     constructor(worker: CorsWorker, body?: BodyInit | null, cache?: CacheControl);
-    getResponse(): Response;
+    getResponse(): Promise<Response>;
     protected addSecurityHeaders(): void;
 }
 declare class ClonedResponse extends WorkerResponse {
@@ -355,87 +356,65 @@ declare class ServiceUnavailable extends HttpError {
 }
 
 /**
- * A callback function for a route.
- *
- * @param match - Captured groups from the route RegExp, or the full match at index 0
- * @returns A Response object or a Promise that resolves to a Response
- */
-type RouteCallback = (match: RegExpExecArray) => Promise<Response>;
-/**
- * A single route definition.
- *
- * Tuple of:
- * - HTTP method
- * - Path pattern (string or RegExp)
- * - Callback function
+ * Type for a route callback function.
+ * @param params - Named parameters extracted from the URL path.
+ * @returns A Response object or a Promise resolving to a Response.
  */
-type RouteTuple = [Method, RegExp | string, RouteCallback];
+type RouteCallback = (params: Record<string, string>) => Promise<Response> | Response;
 /**
- * A collection of route definitions.
- *
- * Used to initialize the router with multiple routes.
+ * Represents a single route.
  */
-type RouteTable = RouteTuple[];
+interface Route {
+    /** HTTP method for the route */
+    method: Method;
+    /** Path-to-regexp matcher function for this route */
+    matcher: MatchFunction<Record<string, string>>;
+    /** Callback to execute when the route is matched */
+    callback: RouteCallback;
+}
 /**
- * Represents the result of matching a request to a route.
- *
- * Contains the route that was matched and the corresponding
- * capture groups from the match.
+ * Result of a route match.
  */
 interface MatchedRoute {
+    /** The route that matched */
     route: Route;
-    match: RegExpExecArray;
-}
-/**
- * Represents a route in the application.
- *
- * A route defines an HTTP method, a pattern to match request paths,
- * and a callback to handle requests that match the pattern.
- */
-declare class Route {
-    readonly method: Method;
-    readonly pattern: RegExp;
-    readonly callback: RouteCallback;
-    /**
-     * Creates a new Route instance.
-     *
-     * @param method   The HTTP method (GET, POST, etc.) this route responds to.
-     * @param pattern  A RegExp used to match the request path.
-     * @param callback The function to execute when a request matches this route.
-     */
-    constructor(method: Method, pattern: RegExp, callback: RouteCallback);
+    /** Parameters extracted from the URL path */
+    params: Record<string, string>;
 }
+/** Tuple type representing a single route: [method, path, callback] */
+type RouteTuple = [Method, string, RouteCallback];
+/** Array of route tuples, used to initialize Routes */
+type RouteTable = RouteTuple[];
 /**
- * A collection of routes grouped by HTTP method.
- *
- * Supports adding routes and retrieving the first matching route for a given method and URL.
+ * Container for route definitions and matching logic.
+ * Implements Iterable to allow iteration over all routes.
  */
 declare class Routes implements Iterable<Route> {
+    /** Internal array of registered routes */
     private readonly routes;
     /**
-     * Reset all routes and register the given ones.
-     *
-     * @param table - Tuples of [method, pattern, callback].
+     * Initialize the route container with a table of routes.
+     * Clears any previously registered routes.
+     * @param table - Array of [method, path, callback] tuples
      */
     initialize(table: RouteTable): void;
     /**
-     * Adds a route to the collection.
-     *
+     * Add a single route to the container.
      * @param method - HTTP method (GET, POST, etc.)
-     * @param pattern - String or RegExp to match the path
-     * @param callback - Function to handle the request
-     * @returns The Routes instance (for chaining)
+     * @param path - URL path pattern (Express-style, e.g., "/users/:id")
+     * @param callback - Function to execute when this route matches
      */
-    add(method: Method, pattern: RegExp | string, callback: RouteCallback): this;
+    add(method: Method, path: string, callback: RouteCallback): void;
     /**
-     * Finds the first route that matches the given method and URL.
-     *
+     * Attempt to match a URL against the registered routes.
      * @param method - HTTP method of the request
-     * @param url - Full URL string of the request
-     * @returns The first matching Route, or undefined if none match
+     * @param url - Full URL string to match against
+     * @returns A MatchedRoute object if a route matches, otherwise null
+     */
+    match(method: Method, url: string): MatchedRoute | null;
+    /**
+     * Iterate over all registered routes.
      */
-    match(method: Method, url: string): MatchedRoute | undefined;
-    /** Allow iteration over all routes */
     [Symbol.iterator](): Iterator<Route>;
 }
 
@@ -597,7 +576,7 @@ declare abstract class CacheWorker extends CorsDefaults {
      * environment variables.
      *
      * @returns {boolean} `true` if the library should use its default caching,
-     *                    `false` to bypass the library cache.
+     *                    `false` to disable the library cache.
      */
     protected isCacheEnabled(): boolean | Promise<boolean>;
     /**
@@ -643,7 +622,7 @@ declare abstract class BasicWorker extends CacheWorker {
 declare abstract class RouteWorker extends BasicWorker {
     protected readonly routes: Routes;
     protected initialize(table: RouteTable): void;
-    protected add(method: Method, pattern: RegExp | string, callback: RouteCallback): this;
+    protected add<Path extends string>(method: Method, path: Path, callback: RouteCallback): this;
     protected dispatch(): Promise<Response>;
     protected get(): Promise<Response>;
     protected put(): Promise<Response>;
@@ -652,4 +631,4 @@ declare abstract class RouteWorker extends BasicWorker {
     protected delete(): Promise<Response>;
 }
 
-export { BadRequest, BasicWorker, CacheControl, ClonedResponse, Cors, type CorsProvider, type CorsWorker, type ErrorJson, Forbidden, Head, HtmlResponse, HttpError, HttpHeader, InternalServerError, JsonResponse, type MatchedRoute, MediaType, Method, MethodNotAllowed, MethodNotImplemented, NotFound, NotImplemented, Options, Route, type RouteCallback, type RouteTable, type RouteTuple, RouteWorker, Routes, ServiceUnavailable, SuccessResponse, TextResponse, Time, Unauthorized, type Worker, type WorkerConstructor, WorkerResponse, addCorsHeaders, getContentType, getOrigin, isMethod, lexCompare, mergeHeader, normalizeUrl, setHeader };
+export { BadRequest, BasicWorker, CacheControl, ClonedResponse, Cors, type CorsProvider, type CorsWorker, type ErrorJson, Forbidden, Head, HtmlResponse, HttpError, HttpHeader, InternalServerError, JsonResponse, type MatchedRoute, MediaType, Method, MethodNotAllowed, MethodNotImplemented, NotFound, NotImplemented, Options, type Route, type RouteCallback, type RouteTable, type RouteTuple, RouteWorker, Routes, ServiceUnavailable, SuccessResponse, TextResponse, Time, Unauthorized, type Worker, type WorkerConstructor, WorkerResponse, addCorsHeaders, getContentType, getOrigin, isMethod, lexCompare, mergeHeader, normalizeUrl, setHeader };

package/dist/index.js

@@ -253,7 +253,7 @@ var WorkerResponse = class extends CacheResponse {
     super(worker, cache);
     this.body = body;
   }
-  getResponse() {
+  async getResponse() {
     this.addCorsHeaders();
     this.addCacheHeader();
     this.addSecurityHeaders();
@@ -375,61 +375,49 @@ var ServiceUnavailable = class extends HttpError {
 };
 
 // src/routes.ts
-var Route = class {
-  /**
-   * Creates a new Route instance.
-   *
-   * @param method   The HTTP method (GET, POST, etc.) this route responds to.
-   * @param pattern  A RegExp used to match the request path.
-   * @param callback The function to execute when a request matches this route.
-   */
-  constructor(method, pattern, callback) {
-    this.method = method;
-    this.pattern = pattern;
-    this.callback = callback;
-  }
-};
+import { match } from "path-to-regexp";
 var Routes = class {
+  /** Internal array of registered routes */
   routes = [];
   /**
-   * Reset all routes and register the given ones.
-   *
-   * @param table - Tuples of [method, pattern, callback].
+   * Initialize the route container with a table of routes.
+   * Clears any previously registered routes.
+   * @param table - Array of [method, path, callback] tuples
    */
   initialize(table) {
     this.routes.length = 0;
-    table.forEach(([method, pattern, callback]) => this.add(method, pattern, callback));
+    table.forEach(([method, path, callback]) => this.add(method, path, callback));
   }
   /**
-   * Adds a route to the collection.
-   *
+   * Add a single route to the container.
    * @param method - HTTP method (GET, POST, etc.)
-   * @param pattern - String or RegExp to match the path
-   * @param callback - Function to handle the request
-   * @returns The Routes instance (for chaining)
+   * @param path - URL path pattern (Express-style, e.g., "/users/:id")
+   * @param callback - Function to execute when this route matches
    */
-  add(method, pattern, callback) {
-    this.routes.push(new Route(method, new RegExp(pattern), callback));
-    return this;
+  add(method, path, callback) {
+    const matcher = match(path, {
+      decode: decodeURIComponent
+    });
+    this.routes.push({ method, matcher, callback });
   }
   /**
-   * Finds the first route that matches the given method and URL.
-   *
+   * Attempt to match a URL against the registered routes.
    * @param method - HTTP method of the request
-   * @param url - Full URL string of the request
-   * @returns The first matching Route, or undefined if none match
+   * @param url - Full URL string to match against
+   * @returns A MatchedRoute object if a route matches, otherwise null
    */
   match(method, url) {
     const pathname = new URL(url).pathname;
     for (const route of this) {
-      if (route.method === method) {
-        const match = route.pattern.exec(pathname);
-        if (match) return { route, match };
-      }
+      if (route.method !== method) continue;
+      const result = route.matcher(pathname);
+      if (result) return { route, params: result.params };
     }
-    return void 0;
+    return null;
   }
-  /** Allow iteration over all routes */
+  /**
+   * Iterate over all registered routes.
+   */
   *[Symbol.iterator]() {
     yield* this.routes;
   }
@@ -580,7 +568,7 @@ var CacheWorker = class extends CorsDefaults {
    * environment variables.
    *
    * @returns {boolean} `true` if the library should use its default caching,
-   *                    `false` to bypass the library cache.
+   *                    `false` to disable the library cache.
    */
   isCacheEnabled() {
     return true;
@@ -705,16 +693,18 @@ var BasicWorker = class extends CacheWorker {
 var RouteWorker = class extends BasicWorker {
   routes = new Routes();
   initialize(table) {
-    this.routes.initialize(table);
+    for (const [method, path, callback] of table) {
+      this.routes.add(method, path, callback);
+    }
   }
-  add(method, pattern, callback) {
-    this.routes.add(method, pattern, callback);
+  add(method, path, callback) {
+    this.routes.add(method, path, callback);
     return this;
   }
   async dispatch() {
     const found = this.routes.match(this.request.method, this.request.url);
     if (!found) return super.dispatch();
-    return found.route.callback.call(this, found.match);
+    return found.route.callback.call(this, found.params);
   }
   async get() {
     return this.getResponse(NotFound);
@@ -752,7 +742,6 @@ export {
   NotFound,
   NotImplemented,
   Options,
-  Route,
   RouteWorker,
   Routes,
   ServiceUnavailable,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/common.ts","../src/cors.ts","../src/errors.ts","../src/response.ts","../src/routes.ts","../src/base-worker.ts","../src/cors-defaults.ts","../src/cache-worker.ts","../src/basic-worker.ts","../src/route-worker.ts"],"sourcesContent":["/*\n * Copyright (C) 2025 Ty Busby\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport CacheLib from \"cache-control-parser\";\n\n/**\n * @see {@link https://github.com/etienne-martin/cache-control-parser | cache-control-parser}\n */\nexport type CacheControl = CacheLib.CacheControl;\nexport const CacheControl = {\n    parse: CacheLib.parse,\n    stringify: CacheLib.stringify,\n\n    /** A Cache-Control directive that disables all caching. */\n    DISABLE: Object.freeze({\n        \"no-cache\": true,\n        \"no-store\": true,\n        \"must-revalidate\": true,\n        \"max-age\": 0,\n    }) satisfies CacheControl,\n};\n\n/**\n * https://github.com/prettymuchbryce/http-status-codes\n */\nexport { StatusCodes } from \"http-status-codes\";\n\n/**\n * Standard HTTP header names and common values.\n */\nexport namespace HttpHeader {\n    export const VARY = \"Vary\";\n    export const ALLOW = \"Allow\";\n    export const CONTENT_TYPE = \"Content-Type\";\n    export const CACHE_CONTROL = \"Cache-Control\";\n\n    // Security Headers\n    export const X_FRAME_OPTIONS = \"X-Frame-Options\"; // e.g. \"DENY\" or \"SAMEORIGIN\"\n    export const X_CONTENT_TYPE_OPTIONS = \"X-Content-Type-Options\"; // usually \"nosniff\"\n    export const REFERRER_POLICY = \"Referrer-Policy\"; // e.g. \"no-referrer\", \"strict-origin-when-cross-origin\"\n    export const PERMISSIONS_POLICY = \"Permissions-Policy\"; // formerly Feature-Policy, controls APIs like geolocation/camera\n    export const CONTENT_SECURITY_POLICY = \"Content-Security-Policy\"; // fine-grained script/style/image restrictions\n    export const STRICT_TRANSPORT_SECURITY = \"Strict-Transport-Security\"; // e.g. \"max-age=63072000; includeSubDomains; preload\"\n\n    // Values\n    export const NOSNIFF = \"nosniff\";\n    export const ORIGIN = \"Origin\";\n}\n\n/**\n * Time constants in seconds. Month is approximated as 30 days.\n */\nexport const Time = {\n    Second: 1,\n    Minute: 60,\n    Hour: 3600, // 60 * 60\n    Day: 86400, // 60 * 60 * 24\n    Week: 604800, // 60 * 60 * 24 * 7\n    Month: 2592000, // 60 * 60 * 24 * 30\n    Year: 31536000, // 60 * 60 * 24 * 365\n} as const;\n\n/**\n * Standard HTTP request methods.\n */\nexport enum Method {\n    GET = \"GET\",\n    PUT = \"PUT\",\n    HEAD = \"HEAD\",\n    POST = \"POST\",\n    PATCH = \"PATCH\",\n    DELETE = \"DELETE\",\n    OPTIONS = \"OPTIONS\",\n}\nconst METHOD_SET: Set<string> = new Set(Object.values(Method));\n\n/**\n * Type guard that checks if a string is a valid HTTP method.\n *\n * @param value - The string to test.\n * @returns True if `value` is a recognized HTTP method.\n */\nexport function isMethod(value: string): value is Method {\n    return METHOD_SET.has(value);\n}\n\n/**\n * Returns the proper Content-Type string for a given media type.\n * Appends `charset=utf-8` for text-based types that require it.\n *\n * @param type - The media type.\n * @returns A string suitable for the `Content-Type` header.\n */\nexport function getContentType(type: MediaType): string {\n    if (ADD_CHARSET.has(type)) {\n        return `${type}; charset=utf-8`;\n    }\n    return type;\n}\n\n/**\n * Common media types types used for HTTP headers.\n */\nexport enum MediaType {\n    PLAIN_TEXT = \"text/plain\",\n    HTML = \"text/html\",\n    CSS = \"text/css\",\n    CSV = \"text/csv\",\n    XML = \"text/xml\",\n    MARKDOWN = \"text/markdown\",\n    RICH_TEXT = \"text/richtext\",\n    JSON = \"application/json\",\n    XML_APP = \"application/xml\",\n    YAML = \"application/x-yaml\",\n    FORM_URLENCODED = \"application/x-www-form-urlencoded\",\n    NDJSON = \"application/x-ndjson\",\n    MSGPACK = \"application/x-msgpack\",\n    PROTOBUF = \"application/x-protobuf\",\n    MULTIPART_FORM_DATA = \"multipart/form-data\",\n    MULTIPART_MIXED = \"multipart/mixed\",\n    MULTIPART_ALTERNATIVE = \"multipart/alternative\",\n    MULTIPART_DIGEST = \"multipart/digest\",\n    MULTIPART_RELATED = \"multipart/related\",\n    MULTIPART_SIGNED = \"multipart/signed\",\n    MULTIPART_ENCRYPTED = \"multipart/encrypted\",\n    OCTET_STREAM = \"application/octet-stream\",\n    PDF = \"application/pdf\",\n    ZIP = \"application/zip\",\n    GZIP = \"application/gzip\",\n    MSWORD = \"application/msword\",\n    DOCX = \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\",\n    EXCEL = \"application/vnd.ms-excel\",\n    XLSX = \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\",\n    POWERPOINT = \"application/vnd.ms-powerpoint\",\n    PPTX = \"application/vnd.openxmlformats-officedocument.presentationml.presentation\",\n    ICO = \"image/x-icon\",\n    ICO_MS = \"image/vnd.microsoft.icon\",\n    GIF = \"image/gif\",\n    PNG = \"image/png\",\n    JPEG = \"image/jpeg\",\n    WEBP = \"image/webp\",\n    SVG = \"image/svg+xml\",\n    HEIF = \"image/heif\",\n    AVIF = \"image/avif\",\n    EVENT_STREAM = \"text/event-stream\",\n    TAR = \"application/x-tar\",\n    BZIP2 = \"application/x-bzip2\",\n}\n\n/**\n * A set of media types that require a `charset` parameter when setting\n * the `Content-Type` header.\n *\n * This includes common text-based media types such as HTML, CSS, JSON,\n * XML, CSV, Markdown, and others.\n */\nconst ADD_CHARSET: Set<MediaType> = new Set([\n    MediaType.CSS,\n    MediaType.CSV,\n    MediaType.XML,\n    MediaType.SVG,\n    MediaType.HTML,\n    MediaType.JSON,\n    MediaType.NDJSON,\n    MediaType.XML_APP,\n    MediaType.MARKDOWN,\n    MediaType.RICH_TEXT,\n    MediaType.PLAIN_TEXT,\n    MediaType.FORM_URLENCODED,\n]);\n\n/**\n * Sets a header on the given Headers object.\n *\n * - If `value` is an array, duplicates and empty strings are removed.\n * - If the resulting value array is empty, the header is deleted.\n * - Otherwise, values are joined with `\", \"` and set as the header value.\n *\n * @param headers - The Headers object to modify.\n * @param key - The header name to set.\n * @param value - The header value(s) to set. Can be a string or array of strings.\n */\nexport function setHeader(headers: Headers, key: string, value: string | string[]): void {\n    const raw = Array.isArray(value) ? value : [value];\n    const values = Array.from(new Set(raw.map((v) => v.trim())))\n        .filter((v) => v.length)\n        .sort(lexCompare);\n\n    if (!values.length) {\n        headers.delete(key);\n        return;\n    }\n\n    headers.set(key, values.join(\", \"));\n}\n\n/**\n * Merges new value(s) into an existing header on the given Headers object.\n *\n * - Preserves any existing values and adds new ones.\n * - Removes duplicates and trims all values.\n * - If the header does not exist, it is created.\n *\n * @param headers - The Headers object to modify.\n * @param key - The header name to merge into.\n * @param value - The new header value(s) to add. Can be a string or array of strings.\n */\nexport function mergeHeader(headers: Headers, key: string, value: string | string[]): void {\n    const values = Array.isArray(value) ? value : [value];\n    if (!values.length) return;\n\n    const existing = headers.get(key);\n    if (existing) {\n        const merged = existing.split(\",\").map((v) => v.trim());\n        values.forEach((v) => merged.push(v.trim()));\n        setHeader(headers, key, merged);\n    } else {\n        setHeader(headers, key, values);\n    }\n}\n\n/**\n * Normalizes a URL string for use as a consistent cache key.\n *\n * - Sorts query parameters alphabetically so `?b=2&a=1` and `?a=1&b=2` are treated the same.\n * - Strips fragment identifiers (`#...`) since they are not sent in HTTP requests.\n * - Leaves protocol, host, path, and query values intact.\n *\n * @param url The original URL string to normalize.\n * @returns A normalized URL string suitable for hashing or direct cache key use.\n */\nexport function normalizeUrl(url: string): URL {\n    const u = new URL(url);\n\n    const params = [...u.searchParams.entries()];\n    params.sort(([a], [b]) => lexCompare(a, b));\n\n    u.search = params\n        .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`)\n        .join(\"&\");\n    u.hash = \"\";\n\n    return u;\n}\n\n/**\n * Lexicographically compares two strings.\n * \n * This comparator can be used in `Array.prototype.sort()` to produce a\n * consistent, stable ordering of string arrays.\n *\n * @param a - The first string to compare.\n * @param b - The second string to compare.\n * @returns A number indicating the relative order of `a` and `b`.\n */\nexport function lexCompare(a: string, b: string): number {\n    if (a < b) return -1;\n    if (a > b) return 1;\n    return 0;\n}\n\n/**\n * Extracts the `Origin` header value from a request.\n *\n * The `Origin` header identifies the origin (scheme, host, and port)\n * of the request initiator. It is commonly used for CORS checks.\n *\n * @param request - The incoming {@link Request} object.\n * @returns The origin string if present, otherwise `null`.\n */\nexport function getOrigin(request: Request): string | null {\n    return request.headers.get(HttpHeader.ORIGIN);\n}\n","/*\n * Copyright (C) 2025 Ty Busby\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { mergeHeader, setHeader } from \"./common\";\nimport { CorsWorker } from \"./response\";\n\n/**\n * Implementations will provide a specific CORS policy.\n */\nexport interface CorsProvider {\n    /** Returns a list of allowed origins. */\n    getAllowedOrigins(): string[];\n\n    /** Returns true if any origin is allowed (`*`). */\n    allowAnyOrigin(): boolean;\n\n    /** Returns the HTTP headers allowed by CORS. */\n    getAllowedHeaders(): string[];\n\n    /** Returns the HTTP headers that should be exposed to the browser. */\n    getExposedHeaders(): string[];\n\n    /** Returns the max age (in seconds) for CORS preflight caching. */\n    getMaxAge(): number;\n}\n\n/**\n * Constants for common CORS headers.\n */\nexport namespace Cors {\n    export const MAX_AGE = \"Access-Control-Max-Age\";\n    export const ALLOW_ORIGIN = \"Access-Control-Allow-Origin\";\n    export const ALLOW_HEADERS = \"Access-Control-Allow-Headers\";\n    export const ALLOW_METHODS = \"Access-Control-Allow-Methods\";\n    export const EXPOSE_HEADERS = \"Access-Control-Expose-Headers\";\n    export const ALLOW_CREDENTIALS = \"Access-Control-Allow-Credentials\";\n    export const ALLOW_ALL_ORIGINS = \"*\";\n}\n\n/**\n * Adds or updates CORS headers on a Headers object according to the provided policy.\n *\n * Behavior:\n * - Removes any existing CORS headers to avoid stale values.\n * - If the request has no origin, the function exits early.\n * - If wildcard `*` is allowed, sets Access-Control-Allow-Origin to `*`.\n * - If the origin is explicitly allowed, sets the correct headers including credentials and Vary: Origin.\n * - Optional headers (Expose-Headers, Allow-Headers, Allow-Methods, Max-Age) are always applied.\n *\n * @param cors The CorsProvider instance that determines allowed origins and headers\n * @param headers The Headers object to update\n */\nexport function addCorsHeaders(origin: string | null, cors: CorsWorker, headers: Headers): void {\n    deleteCorsHeaders(headers);\n\n    // CORS is not required.\n    if (!origin || origin.trim() === \"\") return;\n\n    if (cors.allowAnyOrigin()) {\n        setHeader(headers, Cors.ALLOW_ORIGIN, Cors.ALLOW_ALL_ORIGINS);\n    } else if (cors.getAllowedOrigins().includes(origin)) {\n        setHeader(headers, Cors.ALLOW_ORIGIN, origin);\n        setHeader(headers, Cors.ALLOW_CREDENTIALS, \"true\");\n    }\n\n    // Optional headers always applied if CORS.\n    setHeader(headers, Cors.MAX_AGE, String(cors.getMaxAge()));\n    setHeader(headers, Cors.ALLOW_METHODS, cors.getAllowedMethods());\n    setHeader(headers, Cors.ALLOW_HEADERS, cors.getAllowedHeaders());\n    mergeHeader(headers, Cors.EXPOSE_HEADERS, cors.getExposedHeaders());\n}\n\n/**\n * Deletes all standard CORS headers from the given Headers object.\n * Useful for cleaning cached responses or resetting headers before reapplying CORS.\n *\n * @param headers The Headers object to clean\n */\nfunction deleteCorsHeaders(headers: Headers) {\n    headers.delete(Cors.MAX_AGE);\n    headers.delete(Cors.ALLOW_ORIGIN);\n    headers.delete(Cors.ALLOW_HEADERS);\n    headers.delete(Cors.ALLOW_METHODS);\n    headers.delete(Cors.EXPOSE_HEADERS);\n    headers.delete(Cors.ALLOW_CREDENTIALS);\n}\n","/*\n * Copyright (C) 2025 Ty Busby\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { getReasonPhrase } from \"http-status-codes\";\nimport { CacheControl, HttpHeader, StatusCodes } from \"./common\";\nimport { CorsWorker, JsonResponse } from \"./response\";\n\nexport interface ErrorJson {\n    status: number;\n    error: string;\n    details: string;\n}\n\nexport class HttpError extends JsonResponse {\n    constructor(worker: CorsWorker, status: StatusCodes, protected readonly details?: string) {\n        const json: ErrorJson = {\n            status,\n            error: getReasonPhrase(status),\n            details: details ?? getReasonPhrase(status),\n        };\n        super(worker, json, CacheControl.DISABLE, status);\n    }\n}\n\nexport class BadRequest extends HttpError {\n    constructor(worker: CorsWorker, details?: string) {\n        super(worker, StatusCodes.BAD_REQUEST, details);\n    }\n}\n\nexport class Unauthorized extends HttpError {\n    constructor(worker: CorsWorker, details?: string) {\n        super(worker, StatusCodes.UNAUTHORIZED, details);\n    }\n}\n\nexport class Forbidden extends HttpError {\n    constructor(worker: CorsWorker, details?: string) {\n        super(worker, StatusCodes.FORBIDDEN, details);\n    }\n}\n\nexport class NotFound extends HttpError {\n    constructor(worker: CorsWorker, details?: string) {\n        super(worker, StatusCodes.NOT_FOUND, details);\n    }\n}\n\nexport class MethodNotAllowed extends HttpError {\n    constructor(worker: CorsWorker) {\n        super(\n            worker,\n            StatusCodes.METHOD_NOT_ALLOWED,\n            `${worker.request.method} method not allowed.`\n        );\n        this.setHeader(HttpHeader.ALLOW, this.worker.getAllowedMethods());\n    }\n}\n\nexport class InternalServerError extends HttpError {\n    constructor(worker: CorsWorker, details?: string) {\n        super(worker, StatusCodes.INTERNAL_SERVER_ERROR, details);\n    }\n}\n\nexport class NotImplemented extends HttpError {\n    constructor(worker: CorsWorker, details?: string) {\n        super(worker, StatusCodes.NOT_IMPLEMENTED, details);\n    }\n}\n\nexport class MethodNotImplemented extends NotImplemented {\n    constructor(worker: CorsWorker) {\n        super(worker, `${worker.request.method} method not implemented.`);\n    }\n}\n\nexport class ServiceUnavailable extends HttpError {\n    constructor(worker: CorsWorker, details?: string) {\n        super(worker, StatusCodes.SERVICE_UNAVAILABLE, details);\n    }\n}\n","/*\n * Copyright (C) 2025 Ty Busby\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { getReasonPhrase, StatusCodes } from \"http-status-codes\";\nimport {\n    CacheControl,\n    getContentType,\n    HttpHeader,\n    mergeHeader,\n    MediaType,\n    setHeader,\n    getOrigin,\n} from \"./common\";\nimport { addCorsHeaders, CorsProvider } from \"./cors\";\nimport { Worker } from \"./worker\";\n\nexport type CorsWorker = Worker & CorsProvider;\n\nabstract class BaseResponse {\n    public headers: Headers = new Headers();\n    public status: StatusCodes = StatusCodes.OK;\n    public statusText?: string;\n    public mediaType?: MediaType;\n\n    protected get responseInit(): ResponseInit {\n        return {\n            headers: this.headers,\n            status: this.status,\n            statusText: this.statusText ?? getReasonPhrase(this.status),\n        };\n    }\n\n    public setHeader(key: string, value: string | string[]): void {\n        setHeader(this.headers, key, value);\n    }\n\n    public mergeHeader(key: string, value: string | string[]): void {\n        mergeHeader(this.headers, key, value);\n    }\n\n    public addContentType() {\n        if (this.mediaType) {\n            this.headers.set(HttpHeader.CONTENT_TYPE, getContentType(this.mediaType));\n        }\n    }\n}\n\nabstract class CorsResponse extends BaseResponse {\n    constructor(public readonly worker: CorsWorker) {\n        super();\n    }\n\n    protected addCorsHeaders(): void {\n        addCorsHeaders(this.getOrigin(), this.worker, this.headers);\n\n        if (!this.worker.allowAnyOrigin()) {\n            this.mergeHeader(HttpHeader.VARY, HttpHeader.ORIGIN);\n        }\n    }\n\n    protected getOrigin() {\n        return getOrigin(this.worker.request);\n    }\n}\n\nabstract class CacheResponse extends CorsResponse {\n    constructor(worker: CorsWorker, public cache?: CacheControl) {\n        super(worker);\n    }\n\n    protected addCacheHeader(): void {\n        if (this.cache) {\n            this.headers.set(HttpHeader.CACHE_CONTROL, CacheControl.stringify(this.cache));\n        }\n    }\n}\n\nexport abstract class WorkerResponse extends CacheResponse {\n    constructor(\n        worker: CorsWorker,\n        private readonly body: BodyInit | null = null,\n        cache?: CacheControl\n    ) {\n        super(worker, cache);\n    }\n\n    public getResponse(): Response {\n        this.addCorsHeaders();\n        this.addCacheHeader();\n        this.addSecurityHeaders();\n\n        const body = this.status === StatusCodes.NO_CONTENT ? null : this.body;\n\n        if (body) this.addContentType();\n        return new Response(body, this.responseInit);\n    }\n\n    protected addSecurityHeaders(): void {\n        this.setHeader(HttpHeader.X_CONTENT_TYPE_OPTIONS, HttpHeader.NOSNIFF);\n    }\n}\n\nexport class ClonedResponse extends WorkerResponse {\n    constructor(worker: CorsWorker, response: Response, cache?: CacheControl) {\n        const clone = response.clone();\n        super(worker, clone.body, cache);\n        this.headers = new Headers(clone.headers);\n        this.status = clone.status;\n        this.statusText = clone.statusText;\n    }\n}\n\nexport class SuccessResponse extends WorkerResponse {\n    constructor(\n        worker: CorsWorker,\n        body: BodyInit | null = null,\n        cache?: CacheControl,\n        status: StatusCodes = StatusCodes.OK\n    ) {\n        super(worker, body, cache);\n        this.status = status;\n    }\n}\n\nexport class JsonResponse extends SuccessResponse {\n    constructor(\n        worker: CorsWorker,\n        json: unknown = {},\n        cache?: CacheControl,\n        status: StatusCodes = StatusCodes.OK\n    ) {\n        super(worker, JSON.stringify(json), cache, status);\n        this.mediaType = MediaType.JSON;\n    }\n}\n\nexport class HtmlResponse extends SuccessResponse {\n    constructor(\n        worker: CorsWorker,\n        body: string,\n        cache?: CacheControl,\n        status: StatusCodes = StatusCodes.OK\n    ) {\n        super(worker, body, cache, status);\n        this.mediaType = MediaType.HTML;\n    }\n}\n\nexport class TextResponse extends SuccessResponse {\n    constructor(\n        worker: CorsWorker,\n        content: string,\n        cache?: CacheControl,\n        status: StatusCodes = StatusCodes.OK\n    ) {\n        super(worker, content, cache, status);\n        this.mediaType = MediaType.PLAIN_TEXT;\n    }\n}\n\n/**\n * Removes the body from a GET response.\n */\nexport class Head extends WorkerResponse {\n    constructor(worker: CorsWorker, get: Response) {\n        super(worker);\n        this.headers = new Headers(get.headers);\n    }\n}\n\nexport class Options extends SuccessResponse {\n    constructor(worker: CorsWorker) {\n        super(worker, null, undefined, StatusCodes.NO_CONTENT);\n        this.setHeader(HttpHeader.ALLOW, this.worker.getAllowedMethods());\n    }\n}\n","/*\n * Copyright (C) 2025 Ty Busby\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Method } from \"./common\";\n\n/**\n * A callback function for a route.\n *\n * @param match - Captured groups from the route RegExp, or the full match at index 0\n * @returns A Response object or a Promise that resolves to a Response\n */\nexport type RouteCallback = (match: RegExpExecArray) => Promise<Response>;\n\n/**\n * A single route definition.\n *\n * Tuple of:\n * - HTTP method\n * - Path pattern (string or RegExp)\n * - Callback function\n */\nexport type RouteTuple = [Method, RegExp | string, RouteCallback];\n\n/**\n * A collection of route definitions.\n *\n * Used to initialize the router with multiple routes.\n */\nexport type RouteTable = RouteTuple[];\n\n/**\n * Represents the result of matching a request to a route.\n *\n * Contains the route that was matched and the corresponding\n * capture groups from the match.\n */\nexport interface MatchedRoute {\n    route: Route;\n    match: RegExpExecArray;\n}\n\n/**\n * Represents a route in the application.\n *\n * A route defines an HTTP method, a pattern to match request paths,\n * and a callback to handle requests that match the pattern.\n */\nexport class Route {\n    /**\n     * Creates a new Route instance.\n     *\n     * @param method   The HTTP method (GET, POST, etc.) this route responds to.\n     * @param pattern  A RegExp used to match the request path.\n     * @param callback The function to execute when a request matches this route.\n     */\n    constructor(\n        public readonly method: Method,\n        public readonly pattern: RegExp,\n        public readonly callback: RouteCallback\n    ) {}\n}\n\n/**\n * A collection of routes grouped by HTTP method.\n *\n * Supports adding routes and retrieving the first matching route for a given method and URL.\n */\nexport class Routes implements Iterable<Route> {\n    private readonly routes: Route[] = [];\n\n    /**\n     * Reset all routes and register the given ones.\n     *\n     * @param table - Tuples of [method, pattern, callback].\n     */\n    public initialize(table: RouteTable): void {\n        this.routes.length = 0;\n        table.forEach(([method, pattern, callback]) => this.add(method, pattern, callback));\n    }\n\n    /**\n     * Adds a route to the collection.\n     *\n     * @param method - HTTP method (GET, POST, etc.)\n     * @param pattern - String or RegExp to match the path\n     * @param callback - Function to handle the request\n     * @returns The Routes instance (for chaining)\n     */\n    public add(method: Method, pattern: RegExp | string, callback: RouteCallback): this {\n        this.routes.push(new Route(method, new RegExp(pattern), callback));\n        return this;\n    }\n\n    /**\n     * Finds the first route that matches the given method and URL.\n     *\n     * @param method - HTTP method of the request\n     * @param url - Full URL string of the request\n     * @returns The first matching Route, or undefined if none match\n     */\n    public match(method: Method, url: string): MatchedRoute | undefined {\n        const pathname = new URL(url).pathname;\n        for (const route of this) {\n            if (route.method === method) {\n                const match = route.pattern.exec(pathname);\n                if (match) return { route, match };\n            }\n        }\n        return undefined;\n    }\n\n    /** Allow iteration over all routes */\n    public *[Symbol.iterator](): Iterator<Route> {\n        yield* this.routes;\n    }\n}\n","/*\n * Copyright (C) 2025 Ty Busby\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Method } from \"./common\";\nimport { Worker, WorkerConstructor } from \"./worker\";\n\n/**\n * A type-safe Cloudflare Worker handler.\n *\n * Extends `ExportedHandler` but guarantees that the `fetch` method exists\n * and has the correct signature for Cloudflare Worker invocation.\n *\n * @template E - The type of environment bindings passed to the worker. Defaults to `Env`.\n */\ninterface FetchHandler extends ExportedHandler<Env> {\n    /**\n     * Handles an incoming request and produces a response.\n     *\n     * @param request - The incoming `Request` object.\n     * @param env - Environment bindings (e.g., KV namespaces, secrets, Durable Objects).\n     * @param ctx - Execution context for background tasks (`waitUntil`).\n     * @returns A `Promise` that resolves to the response.\n     */\n    fetch: (request: Request, env: Env, ctx: ExecutionContext) => Promise<Response>;\n}\n\n/**\n * Provides the foundational structure for handling requests,\n * environment bindings, and the worker execution context.\n *\n * Features:\n * - Holds the current `Request` object (`request` getter).\n * - Provides access to environment bindings (`env` getter).\n * - Provides access to the worker execution context (`ctx` getter).\n * - Subclasses must implement `fetch()` to process the request.\n */\nexport abstract class BaseWorker implements Worker {\n    constructor(\n        private readonly _request: Request,\n        private readonly _env: Env,\n        private readonly _ctx: ExecutionContext\n    ) {}\n\n    /** The Request object associated with this worker invocation */\n    public get request(): Request {\n        return this._request;\n    }\n\n    /** Environment bindings (e.g., KV, secrets, or other globals) */\n    public get env(): Env {\n        return this._env;\n    }\n\n    /** Execution context for background tasks or `waitUntil` */\n    public get ctx(): ExecutionContext {\n        return this._ctx;\n    }\n\n    /**\n     * The DEFAULT allowed HTTP methods for subclasses.\n     */\n    public getAllowedMethods(): Method[] {\n        return [Method.GET, Method.HEAD, Method.OPTIONS];\n    }\n\n    /**\n     * Creates a new instance of the current Worker subclass.\n     *\n     * @param request - The {@link Request} to pass to the new worker instance.\n     * @returns A new worker instance of the same subclass as `this`.\n     */\n    protected create(request: Request): this {\n        const ctor = this.constructor as WorkerConstructor<this>;\n        return new ctor(request, this.env, this.ctx);\n    }\n\n    /**\n     * Process the {@link Request} and produce a {@link Response}.\n     *\n     * @returns A {@link Response} promise for the {@link Request}.\n     */\n    public abstract fetch(): Promise<Response>;\n\n    /**\n     * **Ignite** your `Worker` implementation into a Cloudflare handler.\n     *\n     * @returns A `FetchHandler` that launches a new worker instance for each request.\n     *\n     * @example\n     * ```ts\n     * export default MyWorker.ignite();\n     * ```\n     */\n    public static ignite<W extends Worker>(this: WorkerConstructor<W>): FetchHandler {\n        return {\n            fetch: (request: Request, env: Env, ctx: ExecutionContext) =>\n                new this(request, env, ctx).fetch(),\n        };\n    }\n}\n","/*\n * Copyright (C) 2025 Ty Busby\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { BaseWorker } from \"./base-worker\";\nimport { Time } from \"./common\";\nimport { CorsProvider } from \"./cors\";\n\n/**\n * Abstract base class for Workers to provide a default CORS policy.\n *\n * Implements the `CorsProvider` interface and provides a standard policy:\n * - Allows all origins (`*`) by default.\n * - Allows the `Content-Type` header.\n * - Exposes no additional headers.\n * - Sets CORS preflight max-age to one week.\n *\n * Subclasses can override any of the methods to customize the CORS behavior.\n */\nexport abstract class CorsDefaults extends BaseWorker implements CorsProvider {\n    public getAllowedOrigins(): string[] {\n        return [\"*\"];\n    }\n\n    public allowAnyOrigin(): boolean {\n        return this.getAllowedOrigins().includes(\"*\");\n    }\n\n    public getAllowedHeaders(): string[] {\n        return [\"Content-Type\"];\n    }\n\n    public getExposedHeaders(): string[] {\n        return [];\n    }\n\n    public getMaxAge(): number {\n        return Time.Week;\n    }\n}\n","/*\n * Copyright (C) 2025 Ty Busby\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { getOrigin, Method, normalizeUrl } from \"./common\";\nimport { addCorsHeaders, Cors } from \"./cors\";\nimport { CorsDefaults } from \"./cors-defaults\";\n\n/**\n * Abstract worker class that adds caching support for GET requests.\n *\n * Behavior:\n * - Caches successful GET responses (`response.ok === true`) in the selected cache.\n * - Strips CORS headers from cached responses; all other origin headers are preserved.\n * - Dynamically adds CORS headers to cached responses when returned to the client.\n *\n * Subclasses should override `getCacheKey()` to customize cache key generation if needed.\n */\nexport abstract class CacheWorker extends CorsDefaults {\n    /**\n     * Returns the cache key for the current request.\n     *\n     * Behavior:\n     * - By default, returns the normalized request URL.\n     * - Query parameters are normalized so that the order does not affect the cache key.\n     *   For example, `?a=1&b=2` and `?b=2&a=1` produce the same cache key.\n     *\n     * Subclasses may override this method to implement custom cache key strategies.\n     *\n     * @returns {URL | RequestInfo} The URL or RequestInfo used as the cache key.\n     */\n    protected getCacheKey(): URL | RequestInfo {\n        return normalizeUrl(this.request.url);\n    }\n\n    /**\n     * Retrieves a cached Response for the current request, if one exists.\n     *\n     * Behavior:\n     * - Only GET requests are considered.\n     * - Returns a new Response with dynamic CORS headers applied via `addCacheHeaders`.\n     * - Returns `undefined` if no cached response is found.\n     * - Cloudflare dynamic headers (`CF-Cache-Status`, `Age`, `Connection`, etc.) will\n     *   always be present on the returned response, even though they are not stored in the cache.\n     *\n     * @param {string} [cacheName] Optional named cache; defaults to `caches.default`.\n     * @returns {Promise<Response | undefined>} A Response with CORS headers, or undefined.\n     * @see {@link setCachedResponse}\n     * @see {@link getCacheKey}\n     */\n    protected async getCachedResponse(cacheName?: string): Promise<Response | undefined> {\n        if (!(await this.isCacheEnabled()) || this.request.method !== Method.GET) return undefined;\n\n        const cache = cacheName ? await caches.open(cacheName) : caches.default;\n        const response = await cache.match(this.getCacheKey());\n        return response ? this.addCacheHeaders(response) : undefined;\n    }\n\n    /**\n     * Stores a Response in the cache for the current request.\n     *\n     * Behavior:\n     * - Only caches successful GET responses (`response.ok === true`).\n     * - Strips headers via `removeCacheHeaders` before storing.\n     * - Uses `ctx.waitUntil` to perform caching asynchronously without blocking the response.\n     * - All other origin headers (e.g., Cache-Control, Expires) are preserved.\n     *\n     * @param {Response} response The Response to cache.\n     * @param {string} [cacheName] Optional named cache; defaults to `caches.default`.\n     * @see {@link getCachedResponse}\n     * @see {@link getCacheKey}\n     */\n    protected async setCachedResponse(response: Response, cacheName?: string): Promise<void> {\n        if (!(await this.isCacheEnabled()) || this.request.method !== Method.GET || !response.ok)\n            return;\n\n        const cache = cacheName ? await caches.open(cacheName) : caches.default;\n        this.ctx.waitUntil(\n            cache.put(this.getCacheKey(), this.removeCacheHeaders(response.clone()))\n        );\n    }\n\n    /**\n     * Controls whether the library's automatic caching is enabled.\n     *\n     * This method only affects the caching behavior provided by the library’s\n     * `getCachedResponse()` and `setCachedResponse()` methods. It does **not**\n     * prevent users from manually reading from or writing to `caches.default`\n     * or any other Cache API. By default, this returns `true`, enabling the\n     * library’s default caching behavior.\n     *\n     * Subclasses can override this method to disable automatic caching in\n     * development environments, for certain pathnames, or based on\n     * environment variables.\n     *\n     * @returns {boolean} `true` if the library should use its default caching,\n     *                    `false` to bypass the library cache.\n     */\n    protected isCacheEnabled(): boolean | Promise<boolean> {\n        return true;\n    }\n\n    /**\n     * Adds headers to a cached response.\n     *\n     * @param {Response} cached The cached Response.\n     * @returns {Response} A new Response with dynamic CORS headers applied.\n     * @see {@link removeCacheHeaders}\n     */\n    protected addCacheHeaders(cached: Response): Response {\n        const headers = new Headers(cached.headers);\n        addCorsHeaders(getOrigin(this.request), this, headers);\n\n        return new Response(cached.body, {\n            status: cached.status,\n            statusText: cached.statusText,\n            headers,\n        });\n    }\n\n    /**\n     * Removes headers that should not be stored in the cache (currently only CORS headers).\n     *\n     * @param {Response} response The Response to clean before caching.\n     * @returns {Response} A new Response with excluded headers removed.\n     * @see {@link addCacheHeaders}\n     */\n    protected removeCacheHeaders(response: Response): Response {\n        const excludeSet = new Set(this.excludeCacheHeaders().map((h) => h.toLowerCase()));\n        const headers = new Headers();\n\n        for (const [key, value] of response.headers) {\n            if (!excludeSet.has(key)) {\n                headers.set(key, value);\n            }\n        }\n\n        return new Response(response.body, {\n            status: response.status,\n            statusText: response.statusText,\n            headers,\n        });\n    }\n\n    /**\n     * Returns the list of headers to exclude from the cached response.\n     * By default, excludes only dynamic CORS headers.\n     *\n     * @returns {string[]} Array of header names to exclude.\n     * @see {@link removeCacheHeaders}\n     */\n    protected excludeCacheHeaders(): string[] {\n        return [\n            Cors.ALLOW_ORIGIN,\n            Cors.ALLOW_CREDENTIALS,\n            Cors.EXPOSE_HEADERS,\n            Cors.ALLOW_METHODS,\n            Cors.ALLOW_HEADERS,\n            Cors.MAX_AGE,\n        ];\n    }\n}\n","/*\n * Copyright (C) 2025 Ty Busby\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { CacheWorker } from \"./cache-worker\";\nimport { isMethod, Method } from \"./common\";\nimport { MethodNotAllowed, InternalServerError, MethodNotImplemented } from \"./errors\";\nimport { CorsWorker, Head, Options, WorkerResponse } from \"./response\";\n\nexport abstract class BasicWorker extends CacheWorker {\n    public async fetch(): Promise<Response> {\n        if (!this.isAllowed(this.request.method)) {\n            return this.getResponse(MethodNotAllowed);\n        }\n\n        try {\n            const cached = await this.getCachedResponse();\n            if (cached) return cached;\n\n            const response = await this.dispatch();\n            this.setCachedResponse(response);\n            return response;\n        } catch (error) {\n            console.error(error);\n            return this.getResponse(InternalServerError);\n        }\n    }\n\n    protected async dispatch(): Promise<Response> {\n        const method = this.request.method as Method;\n        const handler: Record<Method, () => Promise<Response>> = {\n            GET: () => this.get(),\n            PUT: () => this.put(),\n            HEAD: () => this.head(),\n            POST: () => this.post(),\n            PATCH: () => this.patch(),\n            DELETE: () => this.delete(),\n            OPTIONS: () => this.options(),\n        };\n        return (handler[method] ?? (() => this.getResponse(MethodNotAllowed)))();\n    }\n\n    public isAllowed(method: string): boolean {\n        return isMethod(method) && this.getAllowedMethods().includes(method);\n    }\n\n    protected async get(): Promise<Response> {\n        return this.getResponse(MethodNotImplemented);\n    }\n\n    protected async put(): Promise<Response> {\n        return this.getResponse(MethodNotImplemented);\n    }\n\n    protected async post(): Promise<Response> {\n        return this.getResponse(MethodNotImplemented);\n    }\n\n    protected async patch(): Promise<Response> {\n        return this.getResponse(MethodNotImplemented);\n    }\n\n    protected async delete(): Promise<Response> {\n        return this.getResponse(MethodNotImplemented);\n    }\n\n    protected async options(): Promise<Response> {\n        return this.getResponse(Options);\n    }\n\n    protected async head(): Promise<Response> {\n        const worker = this.create(new Request(this.request, { method: Method.GET }));\n        return this.getResponse(Head, await worker.fetch());\n    }\n\n    protected async getResponse<\n        T extends WorkerResponse,\n        Ctor extends new (worker: CorsWorker, ...args: any[]) => T\n    >(\n        ResponseClass: Ctor,\n        ...args: ConstructorParameters<Ctor> extends [CorsWorker, ...infer R] ? R : never\n    ): Promise<Response> {\n        return new ResponseClass(this, ...args).getResponse();\n    }\n}\n","/*\n * Copyright (C) 2025 Ty Busby\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { BasicWorker } from \"./basic-worker\";\nimport { Method } from \"./common\";\nimport { NotFound } from \"./errors\";\nimport { Routes, RouteTable, RouteCallback } from \"./routes\";\n\nexport abstract class RouteWorker extends BasicWorker {\n    protected readonly routes: Routes = new Routes();\n\n    protected initialize(table: RouteTable) {\n        this.routes.initialize(table);\n    }\n\n    protected add(method: Method, pattern: RegExp | string, callback: RouteCallback) {\n        this.routes.add(method, pattern, callback);\n        return this;\n    }\n\n    protected async dispatch(): Promise<Response> {\n        const found = this.routes.match(this.request.method as Method, this.request.url);\n        if (!found) return super.dispatch();\n\n        return found.route.callback.call(this, found.match);\n    }\n\n    protected override async get(): Promise<Response> {\n        return this.getResponse(NotFound);\n    }\n\n    protected override async put(): Promise<Response> {\n        return this.getResponse(NotFound);\n    }\n\n    protected override async post(): Promise<Response> {\n        return this.getResponse(NotFound);\n    }\n\n    protected override async patch(): Promise<Response> {\n        return this.getResponse(NotFound);\n    }\n\n    protected override async delete(): Promise<Response> {\n        return this.getResponse(NotFound);\n    }\n}\n"],"mappings":"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","names":["HttpHeader","Method","MediaType","Cors","getReasonPhrase","StatusCodes","StatusCodes","getReasonPhrase"]}
+{"version":3,"sources":["../src/common.ts","../src/cors.ts","../src/errors.ts","../src/response.ts","../src/routes.ts","../src/base-worker.ts","../src/cors-defaults.ts","../src/cache-worker.ts","../src/basic-worker.ts","../src/route-worker.ts"],"sourcesContent":["/*\n * Copyright (C) 2025 Ty Busby\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport CacheLib from \"cache-control-parser\";\n\n/**\n * @see {@link https://github.com/etienne-martin/cache-control-parser | cache-control-parser}\n */\nexport type CacheControl = CacheLib.CacheControl;\nexport const CacheControl = {\n    parse: CacheLib.parse,\n    stringify: CacheLib.stringify,\n\n    /** A Cache-Control directive that disables all caching. */\n    DISABLE: Object.freeze({\n        \"no-cache\": true,\n        \"no-store\": true,\n        \"must-revalidate\": true,\n        \"max-age\": 0,\n    }) satisfies CacheControl,\n};\n\n/**\n * https://github.com/prettymuchbryce/http-status-codes\n */\nexport { StatusCodes } from \"http-status-codes\";\n\n/**\n * Standard HTTP header names and common values.\n */\nexport namespace HttpHeader {\n    export const VARY = \"Vary\";\n    export const ALLOW = \"Allow\";\n    export const CONTENT_TYPE = \"Content-Type\";\n    export const CACHE_CONTROL = \"Cache-Control\";\n\n    // Security Headers\n    export const X_FRAME_OPTIONS = \"X-Frame-Options\"; // e.g. \"DENY\" or \"SAMEORIGIN\"\n    export const X_CONTENT_TYPE_OPTIONS = \"X-Content-Type-Options\"; // usually \"nosniff\"\n    export const REFERRER_POLICY = \"Referrer-Policy\"; // e.g. \"no-referrer\", \"strict-origin-when-cross-origin\"\n    export const PERMISSIONS_POLICY = \"Permissions-Policy\"; // formerly Feature-Policy, controls APIs like geolocation/camera\n    export const CONTENT_SECURITY_POLICY = \"Content-Security-Policy\"; // fine-grained script/style/image restrictions\n    export const STRICT_TRANSPORT_SECURITY = \"Strict-Transport-Security\"; // e.g. \"max-age=63072000; includeSubDomains; preload\"\n\n    // Values\n    export const NOSNIFF = \"nosniff\";\n    export const ORIGIN = \"Origin\";\n}\n\n/**\n * Time constants in seconds. Month is approximated as 30 days.\n */\nexport const Time = {\n    Second: 1,\n    Minute: 60,\n    Hour: 3600, // 60 * 60\n    Day: 86400, // 60 * 60 * 24\n    Week: 604800, // 60 * 60 * 24 * 7\n    Month: 2592000, // 60 * 60 * 24 * 30\n    Year: 31536000, // 60 * 60 * 24 * 365\n} as const;\n\n/**\n * Standard HTTP request methods.\n */\nexport enum Method {\n    GET = \"GET\",\n    PUT = \"PUT\",\n    HEAD = \"HEAD\",\n    POST = \"POST\",\n    PATCH = \"PATCH\",\n    DELETE = \"DELETE\",\n    OPTIONS = \"OPTIONS\",\n}\nconst METHOD_SET: Set<string> = new Set(Object.values(Method));\n\n/**\n * Type guard that checks if a string is a valid HTTP method.\n *\n * @param value - The string to test.\n * @returns True if `value` is a recognized HTTP method.\n */\nexport function isMethod(value: string): value is Method {\n    return METHOD_SET.has(value);\n}\n\n/**\n * Returns the proper Content-Type string for a given media type.\n * Appends `charset=utf-8` for text-based types that require it.\n *\n * @param type - The media type.\n * @returns A string suitable for the `Content-Type` header.\n */\nexport function getContentType(type: MediaType): string {\n    if (ADD_CHARSET.has(type)) {\n        return `${type}; charset=utf-8`;\n    }\n    return type;\n}\n\n/**\n * Common media types types used for HTTP headers.\n */\nexport enum MediaType {\n    PLAIN_TEXT = \"text/plain\",\n    HTML = \"text/html\",\n    CSS = \"text/css\",\n    CSV = \"text/csv\",\n    XML = \"text/xml\",\n    MARKDOWN = \"text/markdown\",\n    RICH_TEXT = \"text/richtext\",\n    JSON = \"application/json\",\n    XML_APP = \"application/xml\",\n    YAML = \"application/x-yaml\",\n    FORM_URLENCODED = \"application/x-www-form-urlencoded\",\n    NDJSON = \"application/x-ndjson\",\n    MSGPACK = \"application/x-msgpack\",\n    PROTOBUF = \"application/x-protobuf\",\n    MULTIPART_FORM_DATA = \"multipart/form-data\",\n    MULTIPART_MIXED = \"multipart/mixed\",\n    MULTIPART_ALTERNATIVE = \"multipart/alternative\",\n    MULTIPART_DIGEST = \"multipart/digest\",\n    MULTIPART_RELATED = \"multipart/related\",\n    MULTIPART_SIGNED = \"multipart/signed\",\n    MULTIPART_ENCRYPTED = \"multipart/encrypted\",\n    OCTET_STREAM = \"application/octet-stream\",\n    PDF = \"application/pdf\",\n    ZIP = \"application/zip\",\n    GZIP = \"application/gzip\",\n    MSWORD = \"application/msword\",\n    DOCX = \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\",\n    EXCEL = \"application/vnd.ms-excel\",\n    XLSX = \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\",\n    POWERPOINT = \"application/vnd.ms-powerpoint\",\n    PPTX = \"application/vnd.openxmlformats-officedocument.presentationml.presentation\",\n    ICO = \"image/x-icon\",\n    ICO_MS = \"image/vnd.microsoft.icon\",\n    GIF = \"image/gif\",\n    PNG = \"image/png\",\n    JPEG = \"image/jpeg\",\n    WEBP = \"image/webp\",\n    SVG = \"image/svg+xml\",\n    HEIF = \"image/heif\",\n    AVIF = \"image/avif\",\n    EVENT_STREAM = \"text/event-stream\",\n    TAR = \"application/x-tar\",\n    BZIP2 = \"application/x-bzip2\",\n}\n\n/**\n * A set of media types that require a `charset` parameter when setting\n * the `Content-Type` header.\n *\n * This includes common text-based media types such as HTML, CSS, JSON,\n * XML, CSV, Markdown, and others.\n */\nconst ADD_CHARSET: Set<MediaType> = new Set([\n    MediaType.CSS,\n    MediaType.CSV,\n    MediaType.XML,\n    MediaType.SVG,\n    MediaType.HTML,\n    MediaType.JSON,\n    MediaType.NDJSON,\n    MediaType.XML_APP,\n    MediaType.MARKDOWN,\n    MediaType.RICH_TEXT,\n    MediaType.PLAIN_TEXT,\n    MediaType.FORM_URLENCODED,\n]);\n\n/**\n * Sets a header on the given Headers object.\n *\n * - If `value` is an array, duplicates and empty strings are removed.\n * - If the resulting value array is empty, the header is deleted.\n * - Otherwise, values are joined with `\", \"` and set as the header value.\n *\n * @param headers - The Headers object to modify.\n * @param key - The header name to set.\n * @param value - The header value(s) to set. Can be a string or array of strings.\n */\nexport function setHeader(headers: Headers, key: string, value: string | string[]): void {\n    const raw = Array.isArray(value) ? value : [value];\n    const values = Array.from(new Set(raw.map((v) => v.trim())))\n        .filter((v) => v.length)\n        .sort(lexCompare);\n\n    if (!values.length) {\n        headers.delete(key);\n        return;\n    }\n\n    headers.set(key, values.join(\", \"));\n}\n\n/**\n * Merges new value(s) into an existing header on the given Headers object.\n *\n * - Preserves any existing values and adds new ones.\n * - Removes duplicates and trims all values.\n * - If the header does not exist, it is created.\n *\n * @param headers - The Headers object to modify.\n * @param key - The header name to merge into.\n * @param value - The new header value(s) to add. Can be a string or array of strings.\n */\nexport function mergeHeader(headers: Headers, key: string, value: string | string[]): void {\n    const values = Array.isArray(value) ? value : [value];\n    if (!values.length) return;\n\n    const existing = headers.get(key);\n    if (existing) {\n        const merged = existing.split(\",\").map((v) => v.trim());\n        values.forEach((v) => merged.push(v.trim()));\n        setHeader(headers, key, merged);\n    } else {\n        setHeader(headers, key, values);\n    }\n}\n\n/**\n * Normalizes a URL string for use as a consistent cache key.\n *\n * - Sorts query parameters alphabetically so `?b=2&a=1` and `?a=1&b=2` are treated the same.\n * - Strips fragment identifiers (`#...`) since they are not sent in HTTP requests.\n * - Leaves protocol, host, path, and query values intact.\n *\n * @param url The original URL string to normalize.\n * @returns A normalized URL string suitable for hashing or direct cache key use.\n */\nexport function normalizeUrl(url: string): URL {\n    const u = new URL(url);\n\n    const params = [...u.searchParams.entries()];\n    params.sort(([a], [b]) => lexCompare(a, b));\n\n    u.search = params\n        .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`)\n        .join(\"&\");\n    u.hash = \"\";\n\n    return u;\n}\n\n/**\n * Lexicographically compares two strings.\n * \n * This comparator can be used in `Array.prototype.sort()` to produce a\n * consistent, stable ordering of string arrays.\n *\n * @param a - The first string to compare.\n * @param b - The second string to compare.\n * @returns A number indicating the relative order of `a` and `b`.\n */\nexport function lexCompare(a: string, b: string): number {\n    if (a < b) return -1;\n    if (a > b) return 1;\n    return 0;\n}\n\n/**\n * Extracts the `Origin` header value from a request.\n *\n * The `Origin` header identifies the origin (scheme, host, and port)\n * of the request initiator. It is commonly used for CORS checks.\n *\n * @param request - The incoming {@link Request} object.\n * @returns The origin string if present, otherwise `null`.\n */\nexport function getOrigin(request: Request): string | null {\n    return request.headers.get(HttpHeader.ORIGIN);\n}\n","/*\n * Copyright (C) 2025 Ty Busby\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { mergeHeader, setHeader } from \"./common\";\nimport { CorsWorker } from \"./response\";\n\n/**\n * Implementations will provide a specific CORS policy.\n */\nexport interface CorsProvider {\n    /** Returns a list of allowed origins. */\n    getAllowedOrigins(): string[];\n\n    /** Returns true if any origin is allowed (`*`). */\n    allowAnyOrigin(): boolean;\n\n    /** Returns the HTTP headers allowed by CORS. */\n    getAllowedHeaders(): string[];\n\n    /** Returns the HTTP headers that should be exposed to the browser. */\n    getExposedHeaders(): string[];\n\n    /** Returns the max age (in seconds) for CORS preflight caching. */\n    getMaxAge(): number;\n}\n\n/**\n * Constants for common CORS headers.\n */\nexport namespace Cors {\n    export const MAX_AGE = \"Access-Control-Max-Age\";\n    export const ALLOW_ORIGIN = \"Access-Control-Allow-Origin\";\n    export const ALLOW_HEADERS = \"Access-Control-Allow-Headers\";\n    export const ALLOW_METHODS = \"Access-Control-Allow-Methods\";\n    export const EXPOSE_HEADERS = \"Access-Control-Expose-Headers\";\n    export const ALLOW_CREDENTIALS = \"Access-Control-Allow-Credentials\";\n    export const ALLOW_ALL_ORIGINS = \"*\";\n}\n\n/**\n * Adds or updates CORS headers on a Headers object according to the provided policy.\n *\n * Behavior:\n * - Removes any existing CORS headers to avoid stale values.\n * - If the request has no origin, the function exits early.\n * - If wildcard `*` is allowed, sets Access-Control-Allow-Origin to `*`.\n * - If the origin is explicitly allowed, sets the correct headers including credentials and Vary: Origin.\n * - Optional headers (Expose-Headers, Allow-Headers, Allow-Methods, Max-Age) are always applied.\n *\n * @param cors The CorsProvider instance that determines allowed origins and headers\n * @param headers The Headers object to update\n */\nexport function addCorsHeaders(origin: string | null, cors: CorsWorker, headers: Headers): void {\n    deleteCorsHeaders(headers);\n\n    // CORS is not required.\n    if (!origin || origin.trim() === \"\") return;\n\n    if (cors.allowAnyOrigin()) {\n        setHeader(headers, Cors.ALLOW_ORIGIN, Cors.ALLOW_ALL_ORIGINS);\n    } else if (cors.getAllowedOrigins().includes(origin)) {\n        setHeader(headers, Cors.ALLOW_ORIGIN, origin);\n        setHeader(headers, Cors.ALLOW_CREDENTIALS, \"true\");\n    }\n\n    // Optional headers always applied if CORS.\n    setHeader(headers, Cors.MAX_AGE, String(cors.getMaxAge()));\n    setHeader(headers, Cors.ALLOW_METHODS, cors.getAllowedMethods());\n    setHeader(headers, Cors.ALLOW_HEADERS, cors.getAllowedHeaders());\n    mergeHeader(headers, Cors.EXPOSE_HEADERS, cors.getExposedHeaders());\n}\n\n/**\n * Deletes all standard CORS headers from the given Headers object.\n * Useful for cleaning cached responses or resetting headers before reapplying CORS.\n *\n * @param headers The Headers object to clean\n */\nfunction deleteCorsHeaders(headers: Headers) {\n    headers.delete(Cors.MAX_AGE);\n    headers.delete(Cors.ALLOW_ORIGIN);\n    headers.delete(Cors.ALLOW_HEADERS);\n    headers.delete(Cors.ALLOW_METHODS);\n    headers.delete(Cors.EXPOSE_HEADERS);\n    headers.delete(Cors.ALLOW_CREDENTIALS);\n}\n","/*\n * Copyright (C) 2025 Ty Busby\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { getReasonPhrase } from \"http-status-codes\";\nimport { CacheControl, HttpHeader, StatusCodes } from \"./common\";\nimport { CorsWorker, JsonResponse } from \"./response\";\n\nexport interface ErrorJson {\n    status: number;\n    error: string;\n    details: string;\n}\n\nexport class HttpError extends JsonResponse {\n    constructor(worker: CorsWorker, status: StatusCodes, protected readonly details?: string) {\n        const json: ErrorJson = {\n            status,\n            error: getReasonPhrase(status),\n            details: details ?? getReasonPhrase(status),\n        };\n        super(worker, json, CacheControl.DISABLE, status);\n    }\n}\n\nexport class BadRequest extends HttpError {\n    constructor(worker: CorsWorker, details?: string) {\n        super(worker, StatusCodes.BAD_REQUEST, details);\n    }\n}\n\nexport class Unauthorized extends HttpError {\n    constructor(worker: CorsWorker, details?: string) {\n        super(worker, StatusCodes.UNAUTHORIZED, details);\n    }\n}\n\nexport class Forbidden extends HttpError {\n    constructor(worker: CorsWorker, details?: string) {\n        super(worker, StatusCodes.FORBIDDEN, details);\n    }\n}\n\nexport class NotFound extends HttpError {\n    constructor(worker: CorsWorker, details?: string) {\n        super(worker, StatusCodes.NOT_FOUND, details);\n    }\n}\n\nexport class MethodNotAllowed extends HttpError {\n    constructor(worker: CorsWorker) {\n        super(\n            worker,\n            StatusCodes.METHOD_NOT_ALLOWED,\n            `${worker.request.method} method not allowed.`\n        );\n        this.setHeader(HttpHeader.ALLOW, this.worker.getAllowedMethods());\n    }\n}\n\nexport class InternalServerError extends HttpError {\n    constructor(worker: CorsWorker, details?: string) {\n        super(worker, StatusCodes.INTERNAL_SERVER_ERROR, details);\n    }\n}\n\nexport class NotImplemented extends HttpError {\n    constructor(worker: CorsWorker, details?: string) {\n        super(worker, StatusCodes.NOT_IMPLEMENTED, details);\n    }\n}\n\nexport class MethodNotImplemented extends NotImplemented {\n    constructor(worker: CorsWorker) {\n        super(worker, `${worker.request.method} method not implemented.`);\n    }\n}\n\nexport class ServiceUnavailable extends HttpError {\n    constructor(worker: CorsWorker, details?: string) {\n        super(worker, StatusCodes.SERVICE_UNAVAILABLE, details);\n    }\n}\n","/*\n * Copyright (C) 2025 Ty Busby\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { getReasonPhrase, StatusCodes } from \"http-status-codes\";\nimport {\n    CacheControl,\n    getContentType,\n    HttpHeader,\n    mergeHeader,\n    MediaType,\n    setHeader,\n    getOrigin,\n} from \"./common\";\nimport { addCorsHeaders, CorsProvider } from \"./cors\";\nimport { Worker } from \"./worker\";\n\nexport type CorsWorker = Worker & CorsProvider;\n\nabstract class BaseResponse {\n    public headers: Headers = new Headers();\n    public status: StatusCodes = StatusCodes.OK;\n    public statusText?: string;\n    public mediaType?: MediaType;\n\n    protected get responseInit(): ResponseInit {\n        return {\n            headers: this.headers,\n            status: this.status,\n            statusText: this.statusText ?? getReasonPhrase(this.status),\n        };\n    }\n\n    public setHeader(key: string, value: string | string[]): void {\n        setHeader(this.headers, key, value);\n    }\n\n    public mergeHeader(key: string, value: string | string[]): void {\n        mergeHeader(this.headers, key, value);\n    }\n\n    public addContentType() {\n        if (this.mediaType) {\n            this.headers.set(HttpHeader.CONTENT_TYPE, getContentType(this.mediaType));\n        }\n    }\n}\n\nabstract class CorsResponse extends BaseResponse {\n    constructor(public readonly worker: CorsWorker) {\n        super();\n    }\n\n    protected addCorsHeaders(): void {\n        addCorsHeaders(this.getOrigin(), this.worker, this.headers);\n\n        if (!this.worker.allowAnyOrigin()) {\n            this.mergeHeader(HttpHeader.VARY, HttpHeader.ORIGIN);\n        }\n    }\n\n    protected getOrigin() {\n        return getOrigin(this.worker.request);\n    }\n}\n\nabstract class CacheResponse extends CorsResponse {\n    constructor(worker: CorsWorker, public cache?: CacheControl) {\n        super(worker);\n    }\n\n    protected addCacheHeader(): void {\n        if (this.cache) {\n            this.headers.set(HttpHeader.CACHE_CONTROL, CacheControl.stringify(this.cache));\n        }\n    }\n}\n\nexport abstract class WorkerResponse extends CacheResponse {\n    constructor(\n        worker: CorsWorker,\n        private readonly body: BodyInit | null = null,\n        cache?: CacheControl\n    ) {\n        super(worker, cache);\n    }\n\n    public async getResponse(): Promise<Response> {\n        this.addCorsHeaders();\n        this.addCacheHeader();\n        this.addSecurityHeaders();\n\n        const body = this.status === StatusCodes.NO_CONTENT ? null : this.body;\n\n        if (body) this.addContentType();\n        return new Response(body, this.responseInit);\n    }\n\n    protected addSecurityHeaders(): void {\n        this.setHeader(HttpHeader.X_CONTENT_TYPE_OPTIONS, HttpHeader.NOSNIFF);\n    }\n}\n\nexport class ClonedResponse extends WorkerResponse {\n    constructor(worker: CorsWorker, response: Response, cache?: CacheControl) {\n        const clone = response.clone();\n        super(worker, clone.body, cache);\n        this.headers = new Headers(clone.headers);\n        this.status = clone.status;\n        this.statusText = clone.statusText;\n    }\n}\n\nexport class SuccessResponse extends WorkerResponse {\n    constructor(\n        worker: CorsWorker,\n        body: BodyInit | null = null,\n        cache?: CacheControl,\n        status: StatusCodes = StatusCodes.OK\n    ) {\n        super(worker, body, cache);\n        this.status = status;\n    }\n}\n\nexport class JsonResponse extends SuccessResponse {\n    constructor(\n        worker: CorsWorker,\n        json: unknown = {},\n        cache?: CacheControl,\n        status: StatusCodes = StatusCodes.OK\n    ) {\n        super(worker, JSON.stringify(json), cache, status);\n        this.mediaType = MediaType.JSON;\n    }\n}\n\nexport class HtmlResponse extends SuccessResponse {\n    constructor(\n        worker: CorsWorker,\n        body: string,\n        cache?: CacheControl,\n        status: StatusCodes = StatusCodes.OK\n    ) {\n        super(worker, body, cache, status);\n        this.mediaType = MediaType.HTML;\n    }\n}\n\nexport class TextResponse extends SuccessResponse {\n    constructor(\n        worker: CorsWorker,\n        content: string,\n        cache?: CacheControl,\n        status: StatusCodes = StatusCodes.OK\n    ) {\n        super(worker, content, cache, status);\n        this.mediaType = MediaType.PLAIN_TEXT;\n    }\n}\n\n/**\n * Removes the body from a GET response.\n */\nexport class Head extends WorkerResponse {\n    constructor(worker: CorsWorker, get: Response) {\n        super(worker);\n        this.headers = new Headers(get.headers);\n    }\n}\n\nexport class Options extends SuccessResponse {\n    constructor(worker: CorsWorker) {\n        super(worker, null, undefined, StatusCodes.NO_CONTENT);\n        this.setHeader(HttpHeader.ALLOW, this.worker.getAllowedMethods());\n    }\n}\n","/*\n * Copyright (C) 2025 Ty Busby\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { match, MatchFunction } from \"path-to-regexp\";\nimport { Method } from \"./common\";\n\n/**\n * Type for a route callback function.\n * @param params - Named parameters extracted from the URL path.\n * @returns A Response object or a Promise resolving to a Response.\n */\nexport type RouteCallback = (params: Record<string, string>) => Promise<Response> | Response;\n\n/**\n * Represents a single route.\n */\nexport interface Route {\n    /** HTTP method for the route */\n    method: Method;\n    /** Path-to-regexp matcher function for this route */\n    matcher: MatchFunction<Record<string, string>>;\n    /** Callback to execute when the route is matched */\n    callback: RouteCallback;\n}\n\n/**\n * Result of a route match.\n */\nexport interface MatchedRoute {\n    /** The route that matched */\n    route: Route;\n    /** Parameters extracted from the URL path */\n    params: Record<string, string>;\n}\n\n/** Tuple type representing a single route: [method, path, callback] */\nexport type RouteTuple = [Method, string, RouteCallback];\n\n/** Array of route tuples, used to initialize Routes */\nexport type RouteTable = RouteTuple[];\n\n/**\n * Container for route definitions and matching logic.\n * Implements Iterable to allow iteration over all routes.\n */\nexport class Routes implements Iterable<Route> {\n    /** Internal array of registered routes */\n    private readonly routes: Route[] = [];\n\n    /**\n     * Initialize the route container with a table of routes.\n     * Clears any previously registered routes.\n     * @param table - Array of [method, path, callback] tuples\n     */\n    public initialize(table: RouteTable): void {\n        this.routes.length = 0;\n        table.forEach(([method, path, callback]) => this.add(method, path, callback));\n    }\n\n    /**\n     * Add a single route to the container.\n     * @param method - HTTP method (GET, POST, etc.)\n     * @param path - URL path pattern (Express-style, e.g., \"/users/:id\")\n     * @param callback - Function to execute when this route matches\n     */\n    public add(method: Method, path: string, callback: RouteCallback) {\n        const matcher = match<Record<string, string>>(path, {\n            decode: decodeURIComponent,\n        });\n        this.routes.push({ method, matcher, callback });\n    }\n\n    /**\n     * Attempt to match a URL against the registered routes.\n     * @param method - HTTP method of the request\n     * @param url - Full URL string to match against\n     * @returns A MatchedRoute object if a route matches, otherwise null\n     */\n    public match(method: Method, url: string): MatchedRoute | null {\n        const pathname = new URL(url).pathname;\n\n        for (const route of this) {\n            if (route.method !== method) continue;\n            const result = route.matcher(pathname);\n            if (result) return { route, params: result.params };\n        }\n\n        return null;\n    }\n\n    /**\n     * Iterate over all registered routes.\n     */\n    public *[Symbol.iterator](): Iterator<Route> {\n        yield* this.routes;\n    }\n}\n","/*\n * Copyright (C) 2025 Ty Busby\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Method } from \"./common\";\nimport { Worker, WorkerConstructor } from \"./worker\";\n\n/**\n * A type-safe Cloudflare Worker handler.\n *\n * Extends `ExportedHandler` but guarantees that the `fetch` method exists\n * and has the correct signature for Cloudflare Worker invocation.\n *\n * @template E - The type of environment bindings passed to the worker. Defaults to `Env`.\n */\ninterface FetchHandler extends ExportedHandler<Env> {\n    /**\n     * Handles an incoming request and produces a response.\n     *\n     * @param request - The incoming `Request` object.\n     * @param env - Environment bindings (e.g., KV namespaces, secrets, Durable Objects).\n     * @param ctx - Execution context for background tasks (`waitUntil`).\n     * @returns A `Promise` that resolves to the response.\n     */\n    fetch: (request: Request, env: Env, ctx: ExecutionContext) => Promise<Response>;\n}\n\n/**\n * Provides the foundational structure for handling requests,\n * environment bindings, and the worker execution context.\n *\n * Features:\n * - Holds the current `Request` object (`request` getter).\n * - Provides access to environment bindings (`env` getter).\n * - Provides access to the worker execution context (`ctx` getter).\n * - Subclasses must implement `fetch()` to process the request.\n */\nexport abstract class BaseWorker implements Worker {\n    constructor(\n        private readonly _request: Request,\n        private readonly _env: Env,\n        private readonly _ctx: ExecutionContext\n    ) {}\n\n    /** The Request object associated with this worker invocation */\n    public get request(): Request {\n        return this._request;\n    }\n\n    /** Environment bindings (e.g., KV, secrets, or other globals) */\n    public get env(): Env {\n        return this._env;\n    }\n\n    /** Execution context for background tasks or `waitUntil` */\n    public get ctx(): ExecutionContext {\n        return this._ctx;\n    }\n\n    /**\n     * The DEFAULT allowed HTTP methods for subclasses.\n     */\n    public getAllowedMethods(): Method[] {\n        return [Method.GET, Method.HEAD, Method.OPTIONS];\n    }\n\n    /**\n     * Creates a new instance of the current Worker subclass.\n     *\n     * @param request - The {@link Request} to pass to the new worker instance.\n     * @returns A new worker instance of the same subclass as `this`.\n     */\n    protected create(request: Request): this {\n        const ctor = this.constructor as WorkerConstructor<this>;\n        return new ctor(request, this.env, this.ctx);\n    }\n\n    /**\n     * Process the {@link Request} and produce a {@link Response}.\n     *\n     * @returns A {@link Response} promise for the {@link Request}.\n     */\n    public abstract fetch(): Promise<Response>;\n\n    /**\n     * **Ignite** your `Worker` implementation into a Cloudflare handler.\n     *\n     * @returns A `FetchHandler` that launches a new worker instance for each request.\n     *\n     * @example\n     * ```ts\n     * export default MyWorker.ignite();\n     * ```\n     */\n    public static ignite<W extends Worker>(this: WorkerConstructor<W>): FetchHandler {\n        return {\n            fetch: (request: Request, env: Env, ctx: ExecutionContext) =>\n                new this(request, env, ctx).fetch(),\n        };\n    }\n}\n","/*\n * Copyright (C) 2025 Ty Busby\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { BaseWorker } from \"./base-worker\";\nimport { Time } from \"./common\";\nimport { CorsProvider } from \"./cors\";\n\n/**\n * Abstract base class for Workers to provide a default CORS policy.\n *\n * Implements the `CorsProvider` interface and provides a standard policy:\n * - Allows all origins (`*`) by default.\n * - Allows the `Content-Type` header.\n * - Exposes no additional headers.\n * - Sets CORS preflight max-age to one week.\n *\n * Subclasses can override any of the methods to customize the CORS behavior.\n */\nexport abstract class CorsDefaults extends BaseWorker implements CorsProvider {\n    public getAllowedOrigins(): string[] {\n        return [\"*\"];\n    }\n\n    public allowAnyOrigin(): boolean {\n        return this.getAllowedOrigins().includes(\"*\");\n    }\n\n    public getAllowedHeaders(): string[] {\n        return [\"Content-Type\"];\n    }\n\n    public getExposedHeaders(): string[] {\n        return [];\n    }\n\n    public getMaxAge(): number {\n        return Time.Week;\n    }\n}\n","/*\n * Copyright (C) 2025 Ty Busby\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { getOrigin, Method, normalizeUrl } from \"./common\";\nimport { addCorsHeaders, Cors } from \"./cors\";\nimport { CorsDefaults } from \"./cors-defaults\";\n\n/**\n * Abstract worker class that adds caching support for GET requests.\n *\n * Behavior:\n * - Caches successful GET responses (`response.ok === true`) in the selected cache.\n * - Strips CORS headers from cached responses; all other origin headers are preserved.\n * - Dynamically adds CORS headers to cached responses when returned to the client.\n *\n * Subclasses should override `getCacheKey()` to customize cache key generation if needed.\n */\nexport abstract class CacheWorker extends CorsDefaults {\n    /**\n     * Returns the cache key for the current request.\n     *\n     * Behavior:\n     * - By default, returns the normalized request URL.\n     * - Query parameters are normalized so that the order does not affect the cache key.\n     *   For example, `?a=1&b=2` and `?b=2&a=1` produce the same cache key.\n     *\n     * Subclasses may override this method to implement custom cache key strategies.\n     *\n     * @returns {URL | RequestInfo} The URL or RequestInfo used as the cache key.\n     */\n    protected getCacheKey(): URL | RequestInfo {\n        return normalizeUrl(this.request.url);\n    }\n\n    /**\n     * Retrieves a cached Response for the current request, if one exists.\n     *\n     * Behavior:\n     * - Only GET requests are considered.\n     * - Returns a new Response with dynamic CORS headers applied via `addCacheHeaders`.\n     * - Returns `undefined` if no cached response is found.\n     * - Cloudflare dynamic headers (`CF-Cache-Status`, `Age`, `Connection`, etc.) will\n     *   always be present on the returned response, even though they are not stored in the cache.\n     *\n     * @param {string} [cacheName] Optional named cache; defaults to `caches.default`.\n     * @returns {Promise<Response | undefined>} A Response with CORS headers, or undefined.\n     * @see {@link setCachedResponse}\n     * @see {@link getCacheKey}\n     */\n    protected async getCachedResponse(cacheName?: string): Promise<Response | undefined> {\n        if (!(await this.isCacheEnabled()) || this.request.method !== Method.GET) return undefined;\n\n        const cache = cacheName ? await caches.open(cacheName) : caches.default;\n        const response = await cache.match(this.getCacheKey());\n        return response ? this.addCacheHeaders(response) : undefined;\n    }\n\n    /**\n     * Stores a Response in the cache for the current request.\n     *\n     * Behavior:\n     * - Only caches successful GET responses (`response.ok === true`).\n     * - Strips headers via `removeCacheHeaders` before storing.\n     * - Uses `ctx.waitUntil` to perform caching asynchronously without blocking the response.\n     * - All other origin headers (e.g., Cache-Control, Expires) are preserved.\n     *\n     * @param {Response} response The Response to cache.\n     * @param {string} [cacheName] Optional named cache; defaults to `caches.default`.\n     * @see {@link getCachedResponse}\n     * @see {@link getCacheKey}\n     */\n    protected async setCachedResponse(response: Response, cacheName?: string): Promise<void> {\n        if (!(await this.isCacheEnabled()) || this.request.method !== Method.GET || !response.ok)\n            return;\n\n        const cache = cacheName ? await caches.open(cacheName) : caches.default;\n        this.ctx.waitUntil(\n            cache.put(this.getCacheKey(), this.removeCacheHeaders(response.clone()))\n        );\n    }\n\n    /**\n     * Controls whether the library's automatic caching is enabled.\n     *\n     * This method only affects the caching behavior provided by the library’s\n     * `getCachedResponse()` and `setCachedResponse()` methods. It does **not**\n     * prevent users from manually reading from or writing to `caches.default`\n     * or any other Cache API. By default, this returns `true`, enabling the\n     * library’s default caching behavior.\n     *\n     * Subclasses can override this method to disable automatic caching in\n     * development environments, for certain pathnames, or based on\n     * environment variables.\n     *\n     * @returns {boolean} `true` if the library should use its default caching,\n     *                    `false` to disable the library cache.\n     */\n    protected isCacheEnabled(): boolean | Promise<boolean> {\n        return true;\n    }\n\n    /**\n     * Adds headers to a cached response.\n     *\n     * @param {Response} cached The cached Response.\n     * @returns {Response} A new Response with dynamic CORS headers applied.\n     * @see {@link removeCacheHeaders}\n     */\n    protected addCacheHeaders(cached: Response): Response {\n        const headers = new Headers(cached.headers);\n        addCorsHeaders(getOrigin(this.request), this, headers);\n\n        return new Response(cached.body, {\n            status: cached.status,\n            statusText: cached.statusText,\n            headers,\n        });\n    }\n\n    /**\n     * Removes headers that should not be stored in the cache (currently only CORS headers).\n     *\n     * @param {Response} response The Response to clean before caching.\n     * @returns {Response} A new Response with excluded headers removed.\n     * @see {@link addCacheHeaders}\n     */\n    protected removeCacheHeaders(response: Response): Response {\n        const excludeSet = new Set(this.excludeCacheHeaders().map((h) => h.toLowerCase()));\n        const headers = new Headers();\n\n        for (const [key, value] of response.headers) {\n            if (!excludeSet.has(key)) {\n                headers.set(key, value);\n            }\n        }\n\n        return new Response(response.body, {\n            status: response.status,\n            statusText: response.statusText,\n            headers,\n        });\n    }\n\n    /**\n     * Returns the list of headers to exclude from the cached response.\n     * By default, excludes only dynamic CORS headers.\n     *\n     * @returns {string[]} Array of header names to exclude.\n     * @see {@link removeCacheHeaders}\n     */\n    protected excludeCacheHeaders(): string[] {\n        return [\n            Cors.ALLOW_ORIGIN,\n            Cors.ALLOW_CREDENTIALS,\n            Cors.EXPOSE_HEADERS,\n            Cors.ALLOW_METHODS,\n            Cors.ALLOW_HEADERS,\n            Cors.MAX_AGE,\n        ];\n    }\n}\n","/*\n * Copyright (C) 2025 Ty Busby\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { CacheWorker } from \"./cache-worker\";\nimport { isMethod, Method } from \"./common\";\nimport { MethodNotAllowed, InternalServerError, MethodNotImplemented } from \"./errors\";\nimport { CorsWorker, Head, Options, WorkerResponse } from \"./response\";\n\nexport abstract class BasicWorker extends CacheWorker {\n    public async fetch(): Promise<Response> {\n        if (!this.isAllowed(this.request.method)) {\n            return this.getResponse(MethodNotAllowed);\n        }\n\n        try {\n            const cached = await this.getCachedResponse();\n            if (cached) return cached;\n\n            const response = await this.dispatch();\n            this.setCachedResponse(response);\n            return response;\n        } catch (error) {\n            console.error(error);\n            return this.getResponse(InternalServerError);\n        }\n    }\n\n    protected async dispatch(): Promise<Response> {\n        const method = this.request.method as Method;\n        const handler: Record<Method, () => Promise<Response>> = {\n            GET: () => this.get(),\n            PUT: () => this.put(),\n            HEAD: () => this.head(),\n            POST: () => this.post(),\n            PATCH: () => this.patch(),\n            DELETE: () => this.delete(),\n            OPTIONS: () => this.options(),\n        };\n        return (handler[method] ?? (() => this.getResponse(MethodNotAllowed)))();\n    }\n\n    public isAllowed(method: string): boolean {\n        return isMethod(method) && this.getAllowedMethods().includes(method);\n    }\n\n    protected async get(): Promise<Response> {\n        return this.getResponse(MethodNotImplemented);\n    }\n\n    protected async put(): Promise<Response> {\n        return this.getResponse(MethodNotImplemented);\n    }\n\n    protected async post(): Promise<Response> {\n        return this.getResponse(MethodNotImplemented);\n    }\n\n    protected async patch(): Promise<Response> {\n        return this.getResponse(MethodNotImplemented);\n    }\n\n    protected async delete(): Promise<Response> {\n        return this.getResponse(MethodNotImplemented);\n    }\n\n    protected async options(): Promise<Response> {\n        return this.getResponse(Options);\n    }\n\n    protected async head(): Promise<Response> {\n        const worker = this.create(new Request(this.request, { method: Method.GET }));\n        return this.getResponse(Head, await worker.fetch());\n    }\n\n    protected async getResponse<\n        T extends WorkerResponse,\n        Ctor extends new (worker: CorsWorker, ...args: any[]) => T\n    >(\n        ResponseClass: Ctor,\n        ...args: ConstructorParameters<Ctor> extends [CorsWorker, ...infer R] ? R : never\n    ): Promise<Response> {\n        return new ResponseClass(this, ...args).getResponse();\n    }\n}\n","/*\n * Copyright (C) 2025 Ty Busby\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { BasicWorker } from \"./basic-worker\";\nimport { Method } from \"./common\";\nimport { NotFound } from \"./errors\";\nimport { Routes, RouteCallback, RouteTable } from \"./routes\";\n\nexport abstract class RouteWorker extends BasicWorker {\n    protected readonly routes: Routes = new Routes();\n\n    protected initialize(table: RouteTable): void {\n        for (const [method, path, callback] of table) {\n            this.routes.add(method, path, callback);\n        }\n    }\n\n    protected add<Path extends string>(method: Method, path: Path, callback: RouteCallback): this {\n        this.routes.add(method, path, callback);\n        return this;\n    }\n\n    protected async dispatch(): Promise<Response> {\n        const found = this.routes.match(this.request.method as Method, this.request.url);\n        if (!found) return super.dispatch();\n\n        return found.route.callback.call(this, found.params);\n    }\n\n    protected override async get(): Promise<Response> {\n        return this.getResponse(NotFound);\n    }\n\n    protected override async put(): Promise<Response> {\n        return this.getResponse(NotFound);\n    }\n\n    protected override async post(): Promise<Response> {\n        return this.getResponse(NotFound);\n    }\n\n    protected override async patch(): Promise<Response> {\n        return this.getResponse(NotFound);\n    }\n\n    protected override async delete(): Promise<Response> {\n        return this.getResponse(NotFound);\n    }\n}\n"],"mappings":";AAgBA,OAAO,cAAc;AAsBrB,SAAS,mBAAmB;AAhBrB,IAAM,eAAe;AAAA,EACxB,OAAO,SAAS;AAAA,EAChB,WAAW,SAAS;AAAA;AAAA,EAGpB,SAAS,OAAO,OAAO;AAAA,IACnB,YAAY;AAAA,IACZ,YAAY;AAAA,IACZ,mBAAmB;AAAA,IACnB,WAAW;AAAA,EACf,CAAC;AACL;AAUO,IAAU;AAAA,CAAV,CAAUA,gBAAV;AACI,EAAMA,YAAA,OAAO;AACb,EAAMA,YAAA,QAAQ;AACd,EAAMA,YAAA,eAAe;AACrB,EAAMA,YAAA,gBAAgB;AAGtB,EAAMA,YAAA,kBAAkB;AACxB,EAAMA,YAAA,yBAAyB;AAC/B,EAAMA,YAAA,kBAAkB;AACxB,EAAMA,YAAA,qBAAqB;AAC3B,EAAMA,YAAA,0BAA0B;AAChC,EAAMA,YAAA,4BAA4B;AAGlC,EAAMA,YAAA,UAAU;AAChB,EAAMA,YAAA,SAAS;AAAA,GAhBT;AAsBV,IAAM,OAAO;AAAA,EAChB,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,MAAM;AAAA;AAAA,EACN,KAAK;AAAA;AAAA,EACL,MAAM;AAAA;AAAA,EACN,OAAO;AAAA;AAAA,EACP,MAAM;AAAA;AACV;AAKO,IAAK,SAAL,kBAAKC,YAAL;AACH,EAAAA,QAAA,SAAM;AACN,EAAAA,QAAA,SAAM;AACN,EAAAA,QAAA,UAAO;AACP,EAAAA,QAAA,UAAO;AACP,EAAAA,QAAA,WAAQ;AACR,EAAAA,QAAA,YAAS;AACT,EAAAA,QAAA,aAAU;AAPF,SAAAA;AAAA,GAAA;AASZ,IAAM,aAA0B,IAAI,IAAI,OAAO,OAAO,MAAM,CAAC;AAQtD,SAAS,SAAS,OAAgC;AACrD,SAAO,WAAW,IAAI,KAAK;AAC/B;AASO,SAAS,eAAe,MAAyB;AACpD,MAAI,YAAY,IAAI,IAAI,GAAG;AACvB,WAAO,GAAG,IAAI;AAAA,EAClB;AACA,SAAO;AACX;AAKO,IAAK,YAAL,kBAAKC,eAAL;AACH,EAAAA,WAAA,gBAAa;AACb,EAAAA,WAAA,UAAO;AACP,EAAAA,WAAA,SAAM;AACN,EAAAA,WAAA,SAAM;AACN,EAAAA,WAAA,SAAM;AACN,EAAAA,WAAA,cAAW;AACX,EAAAA,WAAA,eAAY;AACZ,EAAAA,WAAA,UAAO;AACP,EAAAA,WAAA,aAAU;AACV,EAAAA,WAAA,UAAO;AACP,EAAAA,WAAA,qBAAkB;AAClB,EAAAA,WAAA,YAAS;AACT,EAAAA,WAAA,aAAU;AACV,EAAAA,WAAA,cAAW;AACX,EAAAA,WAAA,yBAAsB;AACtB,EAAAA,WAAA,qBAAkB;AAClB,EAAAA,WAAA,2BAAwB;AACxB,EAAAA,WAAA,sBAAmB;AACnB,EAAAA,WAAA,uBAAoB;AACpB,EAAAA,WAAA,sBAAmB;AACnB,EAAAA,WAAA,yBAAsB;AACtB,EAAAA,WAAA,kBAAe;AACf,EAAAA,WAAA,SAAM;AACN,EAAAA,WAAA,SAAM;AACN,EAAAA,WAAA,UAAO;AACP,EAAAA,WAAA,YAAS;AACT,EAAAA,WAAA,UAAO;AACP,EAAAA,WAAA,WAAQ;AACR,EAAAA,WAAA,UAAO;AACP,EAAAA,WAAA,gBAAa;AACb,EAAAA,WAAA,UAAO;AACP,EAAAA,WAAA,SAAM;AACN,EAAAA,WAAA,YAAS;AACT,EAAAA,WAAA,SAAM;AACN,EAAAA,WAAA,SAAM;AACN,EAAAA,WAAA,UAAO;AACP,EAAAA,WAAA,UAAO;AACP,EAAAA,WAAA,SAAM;AACN,EAAAA,WAAA,UAAO;AACP,EAAAA,WAAA,UAAO;AACP,EAAAA,WAAA,kBAAe;AACf,EAAAA,WAAA,SAAM;AACN,EAAAA,WAAA,WAAQ;AA3CA,SAAAA;AAAA,GAAA;AAqDZ,IAAM,cAA8B,oBAAI,IAAI;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACJ,CAAC;AAaM,SAAS,UAAU,SAAkB,KAAa,OAAgC;AACrF,QAAM,MAAM,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK;AACjD,QAAM,SAAS,MAAM,KAAK,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EACtD,OAAO,CAAC,MAAM,EAAE,MAAM,EACtB,KAAK,UAAU;AAEpB,MAAI,CAAC,OAAO,QAAQ;AAChB,YAAQ,OAAO,GAAG;AAClB;AAAA,EACJ;AAEA,UAAQ,IAAI,KAAK,OAAO,KAAK,IAAI,CAAC;AACtC;AAaO,SAAS,YAAY,SAAkB,KAAa,OAAgC;AACvF,QAAM,SAAS,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK;AACpD,MAAI,CAAC,OAAO,OAAQ;AAEpB,QAAM,WAAW,QAAQ,IAAI,GAAG;AAChC,MAAI,UAAU;AACV,UAAM,SAAS,SAAS,MAAM,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC;AACtD,WAAO,QAAQ,CAAC,MAAM,OAAO,KAAK,EAAE,KAAK,CAAC,CAAC;AAC3C,cAAU,SAAS,KAAK,MAAM;AAAA,EAClC,OAAO;AACH,cAAU,SAAS,KAAK,MAAM;AAAA,EAClC;AACJ;AAYO,SAAS,aAAa,KAAkB;AAC3C,QAAM,IAAI,IAAI,IAAI,GAAG;AAErB,QAAM,SAAS,CAAC,GAAG,EAAE,aAAa,QAAQ,CAAC;AAC3C,SAAO,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AAE1C,IAAE,SAAS,OACN,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,mBAAmB,CAAC,CAAC,IAAI,mBAAmB,CAAC,CAAC,EAAE,EACnE,KAAK,GAAG;AACb,IAAE,OAAO;AAET,SAAO;AACX;AAYO,SAAS,WAAW,GAAW,GAAmB;AACrD,MAAI,IAAI,EAAG,QAAO;AAClB,MAAI,IAAI,EAAG,QAAO;AAClB,SAAO;AACX;AAWO,SAAS,UAAU,SAAiC;AACvD,SAAO,QAAQ,QAAQ,IAAI,WAAW,MAAM;AAChD;;;ACnPO,IAAU;AAAA,CAAV,CAAUC,UAAV;AACI,EAAMA,MAAA,UAAU;AAChB,EAAMA,MAAA,eAAe;AACrB,EAAMA,MAAA,gBAAgB;AACtB,EAAMA,MAAA,gBAAgB;AACtB,EAAMA,MAAA,iBAAiB;AACvB,EAAMA,MAAA,oBAAoB;AAC1B,EAAMA,MAAA,oBAAoB;AAAA,GAPpB;AAuBV,SAAS,eAAe,QAAuB,MAAkB,SAAwB;AAC5F,oBAAkB,OAAO;AAGzB,MAAI,CAAC,UAAU,OAAO,KAAK,MAAM,GAAI;AAErC,MAAI,KAAK,eAAe,GAAG;AACvB,cAAU,SAAS,KAAK,cAAc,KAAK,iBAAiB;AAAA,EAChE,WAAW,KAAK,kBAAkB,EAAE,SAAS,MAAM,GAAG;AAClD,cAAU,SAAS,KAAK,cAAc,MAAM;AAC5C,cAAU,SAAS,KAAK,mBAAmB,MAAM;AAAA,EACrD;AAGA,YAAU,SAAS,KAAK,SAAS,OAAO,KAAK,UAAU,CAAC,CAAC;AACzD,YAAU,SAAS,KAAK,eAAe,KAAK,kBAAkB,CAAC;AAC/D,YAAU,SAAS,KAAK,eAAe,KAAK,kBAAkB,CAAC;AAC/D,cAAY,SAAS,KAAK,gBAAgB,KAAK,kBAAkB,CAAC;AACtE;AAQA,SAAS,kBAAkB,SAAkB;AACzC,UAAQ,OAAO,KAAK,OAAO;AAC3B,UAAQ,OAAO,KAAK,YAAY;AAChC,UAAQ,OAAO,KAAK,aAAa;AACjC,UAAQ,OAAO,KAAK,aAAa;AACjC,UAAQ,OAAO,KAAK,cAAc;AAClC,UAAQ,OAAO,KAAK,iBAAiB;AACzC;;;AClFA,SAAS,mBAAAC,wBAAuB;;;ACAhC,SAAS,iBAAiB,eAAAC,oBAAmB;AAe7C,IAAe,eAAf,MAA4B;AAAA,EACjB,UAAmB,IAAI,QAAQ;AAAA,EAC/B,SAAsBC,aAAY;AAAA,EAClC;AAAA,EACA;AAAA,EAEP,IAAc,eAA6B;AACvC,WAAO;AAAA,MACH,SAAS,KAAK;AAAA,MACd,QAAQ,KAAK;AAAA,MACb,YAAY,KAAK,cAAc,gBAAgB,KAAK,MAAM;AAAA,IAC9D;AAAA,EACJ;AAAA,EAEO,UAAU,KAAa,OAAgC;AAC1D,cAAU,KAAK,SAAS,KAAK,KAAK;AAAA,EACtC;AAAA,EAEO,YAAY,KAAa,OAAgC;AAC5D,gBAAY,KAAK,SAAS,KAAK,KAAK;AAAA,EACxC;AAAA,EAEO,iBAAiB;AACpB,QAAI,KAAK,WAAW;AAChB,WAAK,QAAQ,IAAI,WAAW,cAAc,eAAe,KAAK,SAAS,CAAC;AAAA,IAC5E;AAAA,EACJ;AACJ;AAEA,IAAe,eAAf,cAAoC,aAAa;AAAA,EAC7C,YAA4B,QAAoB;AAC5C,UAAM;AADkB;AAAA,EAE5B;AAAA,EAEU,iBAAuB;AAC7B,mBAAe,KAAK,UAAU,GAAG,KAAK,QAAQ,KAAK,OAAO;AAE1D,QAAI,CAAC,KAAK,OAAO,eAAe,GAAG;AAC/B,WAAK,YAAY,WAAW,MAAM,WAAW,MAAM;AAAA,IACvD;AAAA,EACJ;AAAA,EAEU,YAAY;AAClB,WAAO,UAAU,KAAK,OAAO,OAAO;AAAA,EACxC;AACJ;AAEA,IAAe,gBAAf,cAAqC,aAAa;AAAA,EAC9C,YAAY,QAA2B,OAAsB;AACzD,UAAM,MAAM;AADuB;AAAA,EAEvC;AAAA,EAEU,iBAAuB;AAC7B,QAAI,KAAK,OAAO;AACZ,WAAK,QAAQ,IAAI,WAAW,eAAe,aAAa,UAAU,KAAK,KAAK,CAAC;AAAA,IACjF;AAAA,EACJ;AACJ;AAEO,IAAe,iBAAf,cAAsC,cAAc;AAAA,EACvD,YACI,QACiB,OAAwB,MACzC,OACF;AACE,UAAM,QAAQ,KAAK;AAHF;AAAA,EAIrB;AAAA,EAEA,MAAa,cAAiC;AAC1C,SAAK,eAAe;AACpB,SAAK,eAAe;AACpB,SAAK,mBAAmB;AAExB,UAAM,OAAO,KAAK,WAAWA,aAAY,aAAa,OAAO,KAAK;AAElE,QAAI,KAAM,MAAK,eAAe;AAC9B,WAAO,IAAI,SAAS,MAAM,KAAK,YAAY;AAAA,EAC/C;AAAA,EAEU,qBAA2B;AACjC,SAAK,UAAU,WAAW,wBAAwB,WAAW,OAAO;AAAA,EACxE;AACJ;AAEO,IAAM,iBAAN,cAA6B,eAAe;AAAA,EAC/C,YAAY,QAAoB,UAAoB,OAAsB;AACtE,UAAM,QAAQ,SAAS,MAAM;AAC7B,UAAM,QAAQ,MAAM,MAAM,KAAK;AAC/B,SAAK,UAAU,IAAI,QAAQ,MAAM,OAAO;AACxC,SAAK,SAAS,MAAM;AACpB,SAAK,aAAa,MAAM;AAAA,EAC5B;AACJ;AAEO,IAAM,kBAAN,cAA8B,eAAe;AAAA,EAChD,YACI,QACA,OAAwB,MACxB,OACA,SAAsBA,aAAY,IACpC;AACE,UAAM,QAAQ,MAAM,KAAK;AACzB,SAAK,SAAS;AAAA,EAClB;AACJ;AAEO,IAAM,eAAN,cAA2B,gBAAgB;AAAA,EAC9C,YACI,QACA,OAAgB,CAAC,GACjB,OACA,SAAsBA,aAAY,IACpC;AACE,UAAM,QAAQ,KAAK,UAAU,IAAI,GAAG,OAAO,MAAM;AACjD,SAAK;AAAA,EACT;AACJ;AAEO,IAAM,eAAN,cAA2B,gBAAgB;AAAA,EAC9C,YACI,QACA,MACA,OACA,SAAsBA,aAAY,IACpC;AACE,UAAM,QAAQ,MAAM,OAAO,MAAM;AACjC,SAAK;AAAA,EACT;AACJ;AAEO,IAAM,eAAN,cAA2B,gBAAgB;AAAA,EAC9C,YACI,QACA,SACA,OACA,SAAsBA,aAAY,IACpC;AACE,UAAM,QAAQ,SAAS,OAAO,MAAM;AACpC,SAAK;AAAA,EACT;AACJ;AAKO,IAAM,OAAN,cAAmB,eAAe;AAAA,EACrC,YAAY,QAAoB,KAAe;AAC3C,UAAM,MAAM;AACZ,SAAK,UAAU,IAAI,QAAQ,IAAI,OAAO;AAAA,EAC1C;AACJ;AAEO,IAAM,UAAN,cAAsB,gBAAgB;AAAA,EACzC,YAAY,QAAoB;AAC5B,UAAM,QAAQ,MAAM,QAAWA,aAAY,UAAU;AACrD,SAAK,UAAU,WAAW,OAAO,KAAK,OAAO,kBAAkB,CAAC;AAAA,EACpE;AACJ;;;ADlKO,IAAM,YAAN,cAAwB,aAAa;AAAA,EACxC,YAAY,QAAoB,QAAwC,SAAkB;AACtF,UAAM,OAAkB;AAAA,MACpB;AAAA,MACA,OAAOC,iBAAgB,MAAM;AAAA,MAC7B,SAAS,WAAWA,iBAAgB,MAAM;AAAA,IAC9C;AACA,UAAM,QAAQ,MAAM,aAAa,SAAS,MAAM;AANoB;AAAA,EAOxE;AACJ;AAEO,IAAM,aAAN,cAAyB,UAAU;AAAA,EACtC,YAAY,QAAoB,SAAkB;AAC9C,UAAM,QAAQ,YAAY,aAAa,OAAO;AAAA,EAClD;AACJ;AAEO,IAAM,eAAN,cAA2B,UAAU;AAAA,EACxC,YAAY,QAAoB,SAAkB;AAC9C,UAAM,QAAQ,YAAY,cAAc,OAAO;AAAA,EACnD;AACJ;AAEO,IAAM,YAAN,cAAwB,UAAU;AAAA,EACrC,YAAY,QAAoB,SAAkB;AAC9C,UAAM,QAAQ,YAAY,WAAW,OAAO;AAAA,EAChD;AACJ;AAEO,IAAM,WAAN,cAAuB,UAAU;AAAA,EACpC,YAAY,QAAoB,SAAkB;AAC9C,UAAM,QAAQ,YAAY,WAAW,OAAO;AAAA,EAChD;AACJ;AAEO,IAAM,mBAAN,cAA+B,UAAU;AAAA,EAC5C,YAAY,QAAoB;AAC5B;AAAA,MACI;AAAA,MACA,YAAY;AAAA,MACZ,GAAG,OAAO,QAAQ,MAAM;AAAA,IAC5B;AACA,SAAK,UAAU,WAAW,OAAO,KAAK,OAAO,kBAAkB,CAAC;AAAA,EACpE;AACJ;AAEO,IAAM,sBAAN,cAAkC,UAAU;AAAA,EAC/C,YAAY,QAAoB,SAAkB;AAC9C,UAAM,QAAQ,YAAY,uBAAuB,OAAO;AAAA,EAC5D;AACJ;AAEO,IAAM,iBAAN,cAA6B,UAAU;AAAA,EAC1C,YAAY,QAAoB,SAAkB;AAC9C,UAAM,QAAQ,YAAY,iBAAiB,OAAO;AAAA,EACtD;AACJ;AAEO,IAAM,uBAAN,cAAmC,eAAe;AAAA,EACrD,YAAY,QAAoB;AAC5B,UAAM,QAAQ,GAAG,OAAO,QAAQ,MAAM,0BAA0B;AAAA,EACpE;AACJ;AAEO,IAAM,qBAAN,cAAiC,UAAU;AAAA,EAC9C,YAAY,QAAoB,SAAkB;AAC9C,UAAM,QAAQ,YAAY,qBAAqB,OAAO;AAAA,EAC1D;AACJ;;;AE9EA,SAAS,aAA4B;AA0C9B,IAAM,SAAN,MAAwC;AAAA;AAAA,EAE1B,SAAkB,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO7B,WAAW,OAAyB;AACvC,SAAK,OAAO,SAAS;AACrB,UAAM,QAAQ,CAAC,CAAC,QAAQ,MAAM,QAAQ,MAAM,KAAK,IAAI,QAAQ,MAAM,QAAQ,CAAC;AAAA,EAChF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQO,IAAI,QAAgB,MAAc,UAAyB;AAC9D,UAAM,UAAU,MAA8B,MAAM;AAAA,MAChD,QAAQ;AAAA,IACZ,CAAC;AACD,SAAK,OAAO,KAAK,EAAE,QAAQ,SAAS,SAAS,CAAC;AAAA,EAClD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQO,MAAM,QAAgB,KAAkC;AAC3D,UAAM,WAAW,IAAI,IAAI,GAAG,EAAE;AAE9B,eAAW,SAAS,MAAM;AACtB,UAAI,MAAM,WAAW,OAAQ;AAC7B,YAAM,SAAS,MAAM,QAAQ,QAAQ;AACrC,UAAI,OAAQ,QAAO,EAAE,OAAO,QAAQ,OAAO,OAAO;AAAA,IACtD;AAEA,WAAO;AAAA,EACX;AAAA;AAAA;AAAA;AAAA,EAKA,EAAS,OAAO,QAAQ,IAAqB;AACzC,WAAO,KAAK;AAAA,EAChB;AACJ;;;AC5DO,IAAe,aAAf,MAA4C;AAAA,EAC/C,YACqB,UACA,MACA,MACnB;AAHmB;AACA;AACA;AAAA,EAClB;AAAA;AAAA,EAGH,IAAW,UAAmB;AAC1B,WAAO,KAAK;AAAA,EAChB;AAAA;AAAA,EAGA,IAAW,MAAW;AAClB,WAAO,KAAK;AAAA,EAChB;AAAA;AAAA,EAGA,IAAW,MAAwB;AAC/B,WAAO,KAAK;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAKO,oBAA8B;AACjC,WAAO,4DAAwC;AAAA,EACnD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQU,OAAO,SAAwB;AACrC,UAAM,OAAO,KAAK;AAClB,WAAO,IAAI,KAAK,SAAS,KAAK,KAAK,KAAK,GAAG;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBA,OAAc,SAAmE;AAC7E,WAAO;AAAA,MACH,OAAO,CAAC,SAAkB,KAAU,QAChC,IAAI,KAAK,SAAS,KAAK,GAAG,EAAE,MAAM;AAAA,IAC1C;AAAA,EACJ;AACJ;;;ACjFO,IAAe,eAAf,cAAoC,WAAmC;AAAA,EACnE,oBAA8B;AACjC,WAAO,CAAC,GAAG;AAAA,EACf;AAAA,EAEO,iBAA0B;AAC7B,WAAO,KAAK,kBAAkB,EAAE,SAAS,GAAG;AAAA,EAChD;AAAA,EAEO,oBAA8B;AACjC,WAAO,CAAC,cAAc;AAAA,EAC1B;AAAA,EAEO,oBAA8B;AACjC,WAAO,CAAC;AAAA,EACZ;AAAA,EAEO,YAAoB;AACvB,WAAO,KAAK;AAAA,EAChB;AACJ;;;ACrBO,IAAe,cAAf,cAAmC,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAazC,cAAiC;AACvC,WAAO,aAAa,KAAK,QAAQ,GAAG;AAAA,EACxC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBA,MAAgB,kBAAkB,WAAmD;AACjF,QAAI,CAAE,MAAM,KAAK,eAAe,KAAM,KAAK,QAAQ,2BAAuB,QAAO;AAEjF,UAAM,QAAQ,YAAY,MAAM,OAAO,KAAK,SAAS,IAAI,OAAO;AAChE,UAAM,WAAW,MAAM,MAAM,MAAM,KAAK,YAAY,CAAC;AACrD,WAAO,WAAW,KAAK,gBAAgB,QAAQ,IAAI;AAAA,EACvD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBA,MAAgB,kBAAkB,UAAoB,WAAmC;AACrF,QAAI,CAAE,MAAM,KAAK,eAAe,KAAM,KAAK,QAAQ,8BAAyB,CAAC,SAAS;AAClF;AAEJ,UAAM,QAAQ,YAAY,MAAM,OAAO,KAAK,SAAS,IAAI,OAAO;AAChE,SAAK,IAAI;AAAA,MACL,MAAM,IAAI,KAAK,YAAY,GAAG,KAAK,mBAAmB,SAAS,MAAM,CAAC,CAAC;AAAA,IAC3E;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkBU,iBAA6C;AACnD,WAAO;AAAA,EACX;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASU,gBAAgB,QAA4B;AAClD,UAAM,UAAU,IAAI,QAAQ,OAAO,OAAO;AAC1C,mBAAe,UAAU,KAAK,OAAO,GAAG,MAAM,OAAO;AAErD,WAAO,IAAI,SAAS,OAAO,MAAM;AAAA,MAC7B,QAAQ,OAAO;AAAA,MACf,YAAY,OAAO;AAAA,MACnB;AAAA,IACJ,CAAC;AAAA,EACL;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASU,mBAAmB,UAA8B;AACvD,UAAM,aAAa,IAAI,IAAI,KAAK,oBAAoB,EAAE,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AACjF,UAAM,UAAU,IAAI,QAAQ;AAE5B,eAAW,CAAC,KAAK,KAAK,KAAK,SAAS,SAAS;AACzC,UAAI,CAAC,WAAW,IAAI,GAAG,GAAG;AACtB,gBAAQ,IAAI,KAAK,KAAK;AAAA,MAC1B;AAAA,IACJ;AAEA,WAAO,IAAI,SAAS,SAAS,MAAM;AAAA,MAC/B,QAAQ,SAAS;AAAA,MACjB,YAAY,SAAS;AAAA,MACrB;AAAA,IACJ,CAAC;AAAA,EACL;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASU,sBAAgC;AACtC,WAAO;AAAA,MACH,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,IACT;AAAA,EACJ;AACJ;;;ACxJO,IAAe,cAAf,cAAmC,YAAY;AAAA,EAClD,MAAa,QAA2B;AACpC,QAAI,CAAC,KAAK,UAAU,KAAK,QAAQ,MAAM,GAAG;AACtC,aAAO,KAAK,YAAY,gBAAgB;AAAA,IAC5C;AAEA,QAAI;AACA,YAAM,SAAS,MAAM,KAAK,kBAAkB;AAC5C,UAAI,OAAQ,QAAO;AAEnB,YAAM,WAAW,MAAM,KAAK,SAAS;AACrC,WAAK,kBAAkB,QAAQ;AAC/B,aAAO;AAAA,IACX,SAAS,OAAO;AACZ,cAAQ,MAAM,KAAK;AACnB,aAAO,KAAK,YAAY,mBAAmB;AAAA,IAC/C;AAAA,EACJ;AAAA,EAEA,MAAgB,WAA8B;AAC1C,UAAM,SAAS,KAAK,QAAQ;AAC5B,UAAM,UAAmD;AAAA,MACrD,KAAK,MAAM,KAAK,IAAI;AAAA,MACpB,KAAK,MAAM,KAAK,IAAI;AAAA,MACpB,MAAM,MAAM,KAAK,KAAK;AAAA,MACtB,MAAM,MAAM,KAAK,KAAK;AAAA,MACtB,OAAO,MAAM,KAAK,MAAM;AAAA,MACxB,QAAQ,MAAM,KAAK,OAAO;AAAA,MAC1B,SAAS,MAAM,KAAK,QAAQ;AAAA,IAChC;AACA,YAAQ,QAAQ,MAAM,MAAM,MAAM,KAAK,YAAY,gBAAgB,IAAI;AAAA,EAC3E;AAAA,EAEO,UAAU,QAAyB;AACtC,WAAO,SAAS,MAAM,KAAK,KAAK,kBAAkB,EAAE,SAAS,MAAM;AAAA,EACvE;AAAA,EAEA,MAAgB,MAAyB;AACrC,WAAO,KAAK,YAAY,oBAAoB;AAAA,EAChD;AAAA,EAEA,MAAgB,MAAyB;AACrC,WAAO,KAAK,YAAY,oBAAoB;AAAA,EAChD;AAAA,EAEA,MAAgB,OAA0B;AACtC,WAAO,KAAK,YAAY,oBAAoB;AAAA,EAChD;AAAA,EAEA,MAAgB,QAA2B;AACvC,WAAO,KAAK,YAAY,oBAAoB;AAAA,EAChD;AAAA,EAEA,MAAgB,SAA4B;AACxC,WAAO,KAAK,YAAY,oBAAoB;AAAA,EAChD;AAAA,EAEA,MAAgB,UAA6B;AACzC,WAAO,KAAK,YAAY,OAAO;AAAA,EACnC;AAAA,EAEA,MAAgB,OAA0B;AACtC,UAAM,SAAS,KAAK,OAAO,IAAI,QAAQ,KAAK,SAAS,EAAE,wBAAmB,CAAC,CAAC;AAC5E,WAAO,KAAK,YAAY,MAAM,MAAM,OAAO,MAAM,CAAC;AAAA,EACtD;AAAA,EAEA,MAAgB,YAIZ,kBACG,MACc;AACjB,WAAO,IAAI,cAAc,MAAM,GAAG,IAAI,EAAE,YAAY;AAAA,EACxD;AACJ;;;AC5EO,IAAe,cAAf,cAAmC,YAAY;AAAA,EAC/B,SAAiB,IAAI,OAAO;AAAA,EAErC,WAAW,OAAyB;AAC1C,eAAW,CAAC,QAAQ,MAAM,QAAQ,KAAK,OAAO;AAC1C,WAAK,OAAO,IAAI,QAAQ,MAAM,QAAQ;AAAA,IAC1C;AAAA,EACJ;AAAA,EAEU,IAAyB,QAAgB,MAAY,UAA+B;AAC1F,SAAK,OAAO,IAAI,QAAQ,MAAM,QAAQ;AACtC,WAAO;AAAA,EACX;AAAA,EAEA,MAAgB,WAA8B;AAC1C,UAAM,QAAQ,KAAK,OAAO,MAAM,KAAK,QAAQ,QAAkB,KAAK,QAAQ,GAAG;AAC/E,QAAI,CAAC,MAAO,QAAO,MAAM,SAAS;AAElC,WAAO,MAAM,MAAM,SAAS,KAAK,MAAM,MAAM,MAAM;AAAA,EACvD;AAAA,EAEA,MAAyB,MAAyB;AAC9C,WAAO,KAAK,YAAY,QAAQ;AAAA,EACpC;AAAA,EAEA,MAAyB,MAAyB;AAC9C,WAAO,KAAK,YAAY,QAAQ;AAAA,EACpC;AAAA,EAEA,MAAyB,OAA0B;AAC/C,WAAO,KAAK,YAAY,QAAQ;AAAA,EACpC;AAAA,EAEA,MAAyB,QAA2B;AAChD,WAAO,KAAK,YAAY,QAAQ;AAAA,EACpC;AAAA,EAEA,MAAyB,SAA4B;AACjD,WAAO,KAAK,YAAY,QAAQ;AAAA,EACpC;AACJ;","names":["HttpHeader","Method","MediaType","Cors","getReasonPhrase","StatusCodes","StatusCodes","getReasonPhrase"]}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@adonix.org/cloud-spark",
-    "version": "0.0.104",
+    "version": "0.0.106",
     "description": "Ignite your Cloudflare Workers with a type-safe library for rapid development.",
     "license": "Apache-2.0",
     "type": "module",
@@ -52,6 +52,7 @@
     },
     "dependencies": {
         "cache-control-parser": "^2.0.6",
-        "http-status-codes": "^2.3.0"
+        "http-status-codes": "^2.3.0",
+        "path-to-regexp": "^8.2.0"
     }
 }