@adonix.org/cloud-spark 0.0.165 → 0.0.166

package/dist/index.d.ts

@@ -753,42 +753,47 @@ declare class TextResponse extends SuccessResponse {
 /**
  * Represents an HTTP response for serving binary data as `application/octet-stream`.
  *
- * This class validates the provided `OctetStreamInit` configuration and
- * automatically sets the correct HTTP headers for either a full or partial
- * content response.
- *
- * Behavior:
- * - Always sets `Content-Type` to `application/octet-stream`.
- * - Always sets `Accept-Ranges: bytes`.
- * - Always sets `Content-Length` to the validated length of the response body.
- * - If either `offset` or `length` is provided and the size is non-zero, the response
- *   is treated as partial content (`206 Partial Content`) and a `Content-Range` header
- *   is added, even if the specified range spans the entire file.
- * - Special case: a requested range of `0-0` on a non-empty file returns 1 byte.
- * - Zero-length streams (`size = 0`) are never treated as partial content.
+ * This class wraps a `ReadableStream` and sets all necessary headers for both
+ * full and partial content responses, handling range requests in a hybrid way
+ * to maximize browser and CDN caching.
+ *
+ * Key behaviors:
+ * - `Content-Type` is set to `application/octet-stream`.
+ * - `Accept-Ranges: bytes` is always included.
+ * - `Content-Length` is always set to the validated length of the response body.
+ * - If the request is a true partial range (offset > 0 or length < size), the response
+ *   will be `206 Partial Content` with the appropriate `Content-Range` header.
+ * - If the requested range covers the entire file (even if a Range header is present),
+ *   the response will return `200 OK` to enable browser and edge caching.
+ * - Zero-length streams (`size = 0`) are never treated as partial.
+ * - Special case: a requested range of `0-0` on a non-empty file is normalized to 1 byte.
  */
 declare class OctetStream extends WorkerResponse {
     constructor(stream: ReadableStream, init: OctetStreamInit, cache?: CacheControl);
     /**
-     * Returns a fully specified `OctetStreamInit` with all fields set.
+     * Normalizes a partially-specified `OctetStreamInit` into a fully-specified object.
      *
-     * Fills in defaults for any missing values:
-     * - `offset` defaults to 0
-     * - `length` defaults to `size - offset`
-     * - If `offset` and `length` are both 0 but `size > 0`, `length` is set to 1
+     * Ensures that all required fields (`size`, `offset`, `length`) are defined:
+     * - `offset` defaults to 0 if not provided.
+     * - `length` defaults to `size - offset` if not provided.
+     * - Special case: if `offset` and `length` are both 0 but `size > 0`, `length` is set to 1
+     *   to avoid zero-length partial streams.
      *
-     * @param init - Partial or complete OctetStreamInit
-     * @returns An object with `size`, `offset`, and `length` guaranteed
+     * @param init - The initial `OctetStreamInit` object, possibly with missing `offset` or `length`.
+     * @returns A fully-specified `OctetStreamInit` object with `size`, `offset`, and `length` guaranteed.
      */
     private static normalizeInit;
     /**
-     * Returns true if the given `OctetStreamInit` represents a partial range.
+     * Determines whether the given `OctetStreamInit` represents a partial range.
      *
-     * A partial range is any init with an explicit `offset` or `length`, provided
-     * the stream size is greater than zero.
+     * Partial ranges are defined as any range that does **not** cover the entire file:
+     * - If `size === 0`, the stream is never partial.
+     * - If `offset === 0` and `length === size`, the stream is treated as a full file (not partial),
+     *   even if a Range header is present. This enables browser and CDN caching.
+     * - All other cases are considered partial, and will result in a `206 Partial Content` response.
      *
-     * @param init - The OctetStreamInit to check.
-     * @returns `true` if partial, `false` otherwise.
+     * @param init - A fully-normalized `OctetStreamInit` object.
+     * @returns `true` if the stream represents a partial range; `false` if it represents the full file.
      */
     private static isPartial;
 }

package/dist/index.js

@@ -1,2 +1,2 @@
-import{StatusCodes as h}from"http-status-codes";import pe from"cache-control-parser";var L={parse:pe.parse,stringify:pe.stringify,DISABLE:Object.freeze({"no-cache":!0,"no-store":!0,"must-revalidate":!0,"max-age":0})};var M=(u=>(u.GET="GET",u.PUT="PUT",u.HEAD="HEAD",u.POST="POST",u.PATCH="PATCH",u.DELETE="DELETE",u.OPTIONS="OPTIONS",u))(M||{}),{GET:f,PUT:Pt,HEAD:D,POST:kt,PATCH:Mt,DELETE:Dt,OPTIONS:b}=M;var de={Second:1,Minute:60,Hour:3600,Day:86400,Week:604800,Month:2592e3,Year:31536e3};var m=class{};function H(t){return Array.isArray(t)&&t.every(e=>typeof e=="string")}function x(t){return typeof t=="string"}function le(t){return typeof t=="function"}function E(t){return typeof t=="number"&&!Number.isNaN(t)}function he(t){return typeof t=="boolean"}function me(t){if(t!==void 0&&!x(t))throw new TypeError("Cache name must be a string.")}function fe(t){if(t!==void 0&&!le(t))throw new TypeError("getKey must be a function.")}function Ce(t){if(!(t instanceof URL))throw new TypeError("getKey must return a URL.")}var n;(a=>(a.ACCEPT_ENCODING="Accept-Encoding",a.ACCEPT_RANGES="Accept-Ranges",a.ALLOW="Allow",a.CACHE_CONTROL="Cache-Control",a.CONNECTION="Connection",a.CONTENT_DISPOSITION="Content-Disposition",a.CONTENT_ENCODING="Content-Encoding",a.CONTENT_LANGUAGE="Content-Language",a.CONTENT_LENGTH="Content-Length",a.CONTENT_RANGE="Content-Range",a.CONTENT_TYPE="Content-Type",a.CONTENT_MD5="Content-MD5",a.ETAG="ETag",a.ORIGIN="Origin",a.VARY="Vary",a.ACCESS_CONTROL_ALLOW_CREDENTIALS="Access-Control-Allow-Credentials",a.ACCESS_CONTROL_ALLOW_HEADERS="Access-Control-Allow-Headers",a.ACCESS_CONTROL_ALLOW_METHODS="Access-Control-Allow-Methods",a.ACCESS_CONTROL_ALLOW_ORIGIN="Access-Control-Allow-Origin",a.ACCESS_CONTROL_EXPOSE_HEADERS="Access-Control-Expose-Headers",a.ACCESS_CONTROL_MAX_AGE="Access-Control-Max-Age",a.SEC_WEBSOCKET_VERSION="Sec-WebSocket-Version",a.UPGRADE="Upgrade"))(n||={});var Ee=[n.CONTENT_TYPE,n.CONTENT_LENGTH,n.CONTENT_RANGE,n.CONTENT_ENCODING,n.CONTENT_LANGUAGE,n.CONTENT_DISPOSITION,n.CONTENT_MD5],Se=[n.CONTENT_LENGTH,n.CONTENT_RANGE];function S(t,e){return t<e?-1:t>e?1:0}function d(t,e,r){let s=Array.isArray(r)?r:[r],o=Array.from(new Set(s.map(i=>i.trim()))).filter(i=>i.length).sort(S);if(!o.length){t.delete(e);return}t.set(e,o.join(", "))}function G(t,e,r){let s=Array.isArray(r)?r:[r];if(s.length===0)return;let i=R(t,e).concat(s.map(c=>c.trim()));d(t,e,i)}function R(t,e){let r=t.get(e)?.split(",").map(s=>s.trim()).filter(s=>s.length>0)??[];return Array.from(new Set(r)).sort(S)}function Q(t,e){for(let r of e)t.delete(r)}var Ze="https://vary";function Oe(t){return!(!t.ok||Z(t).includes("*"))}function Z(t){let e=R(t.headers,n.VARY);return Array.from(new Set(e.map(r=>r.toLowerCase()))).sort(S)}function ee(t){return t.map(e=>e.toLowerCase()).filter(e=>e!==n.ACCEPT_ENCODING.toLowerCase())}function te(t,e,r){let s=[],o=ee(e);o.sort(S);for(let c of o){let u=t.headers.get(c);u!==null&&s.push([c,u])}let i=et(JSON.stringify([r.toString(),s]));return new URL(i,Ze).href}function et(t){let e=new TextEncoder().encode(t),r="";for(let s of e)r+=String.fromCodePoint(s);return btoa(r).replaceAll("+","-").replaceAll("/","_").replace(/={1,2}$/,"")}function ur(t,e){return me(t),fe(e),new re(t,e)}function tt(t){let e=new URL(t.url),r=new URLSearchParams([...e.searchParams.entries()].sort(([s],[o])=>S(s,o)));return e.search=r.toString(),e.hash="",e}function pr(t){let e=new URL(t.url);return e.search="",e.hash="",e}var re=class extends m{constructor(r,s){super();this.cacheName=r;this.getKey=s;this.cacheName=r?.trim()||void 0}async handle(r,s){if(r.request.method!==f)return s();let o=this.cacheName?await caches.open(this.cacheName):caches.default,i=await this.getCached(o,r.request);if(i)return i;let c=await s();return this.setCached(o,r,c),c}async getCached(r,s){let o=this.getCacheKey(s),i=await r.match(o);if(!i)return;let c=this.getFilteredVary(i);if(c.length===0)return i;let u=te(s,c,o);return r.match(u)}async setCached(r,s,o){if(!Oe(o))return;let i=this.getCacheKey(s.request);s.ctx.waitUntil(r.put(i,o.clone()));let c=this.getFilteredVary(o);c.length>0&&s.ctx.waitUntil(r.put(te(s.request,c,i),o.clone()))}getFilteredVary(r){return ee(Z(r))}getCacheKey(r){let s=this.getKey?this.getKey(r):tt(r);return Ce(s),s.hash="",s}};var rt=new Set(Object.values(M));function se(t){return x(t)&&rt.has(t)}function st(t){return Array.isArray(t)&&t.every(se)}function N(t){if(!st(t)){let e=Array.isArray(t)?JSON.stringify(t):String(t);throw new TypeError(`Invalid method array: ${e}`)}}import{getReasonPhrase as ot,StatusCodes as p}from"http-status-codes";var v="utf-8";function I(t,e){return!e||t.toLowerCase().includes("charset=")?t:`${t}; charset=${e.toLowerCase()}`}function ge(t){if(typeof t!="object"||t===null)throw new TypeError("OctetStreamInit must be an object.");let e=t,r=e.size;if(!E(r)||r<0||!Number.isInteger(r))throw new RangeError(`OctetStreamInit.size must be a non-negative integer (size=${JSON.stringify(r)}).`);let s=e.offset??0;if(!E(s)||s<0||s>r||!Number.isInteger(s))throw new RangeError(`OctetStreamInit.offset must be a non-negative integer less than or equal to size (size=${JSON.stringify(r)}, offset=${JSON.stringify(s)}).`);let o=e.length??r-s;if(!E(o)||o<0||s+o>r||!Number.isInteger(o))throw new RangeError(`OctetStreamInit.length must be a non-negative integer less than or equal to size - offset (size=${JSON.stringify(r)}, offset=${JSON.stringify(s)}, length=${JSON.stringify(o)}).`)}var oe=class{headers=new Headers;status=p.OK;statusText;webSocket=null;mediaType=I("text/plain",v);get responseInit(){return{headers:this.headers,status:this.status,statusText:this.statusText??ot(this.status),webSocket:this.webSocket,encodeBody:"automatic"}}setHeader(e,r){d(this.headers,e,r)}mergeHeader(e,r){G(this.headers,e,r)}addContentType(){this.headers.get(n.CONTENT_TYPE)||this.setHeader(n.CONTENT_TYPE,this.mediaType)}filterHeaders(){this.status===p.NO_CONTENT?Q(this.headers,Se):this.status===p.NOT_MODIFIED&&Q(this.headers,Ee)}},ne=class extends oe{constructor(r){super();this.cache=r}addCacheHeader(){this.cache&&this.setHeader(n.CACHE_CONTROL,L.stringify(this.cache))}},O=class extends ne{constructor(r=null,s){super(s);this.body=r}async response(){this.addCacheHeader();let r=[p.NO_CONTENT,p.NOT_MODIFIED].includes(this.status)?null:this.body;return r&&this.addContentType(),this.filterHeaders(),new Response(r,this.responseInit)}},U=class extends O{constructor(e,r){let s=e.clone();super(s.body,r),this.headers=new Headers(s.headers),this.status=s.status,this.statusText=s.statusText}},W=class extends O{constructor(e=null,r,s=p.OK){super(e,r),this.status=s}},V=class extends W{constructor(e={},r,s=p.OK){super(JSON.stringify(e),r,s),this.mediaType=I("application/json",v)}},Ae=class extends W{constructor(e,r,s=p.OK,o=v){super(e,r,s),this.mediaType=I("text/html",o)}},xe=class extends W{constructor(e,r,s=p.OK,o=v){super(e,r,s),this.mediaType=I("text/plain",o)}},ie=class t extends O{constructor(e,r,s){ge(r),super(e,s),this.mediaType="application/octet-stream";let{size:o,offset:i,length:c}=t.normalizeInit(r);t.isPartial(r)&&(this.setHeader(n.CONTENT_RANGE,`bytes ${i}-${i+c-1}/${o}`),this.status=p.PARTIAL_CONTENT),this.setHeader(n.ACCEPT_RANGES,"bytes"),this.setHeader(n.CONTENT_LENGTH,`${c}`)}static normalizeInit(e){let{size:r}=e,s=e.offset??0,o=e.length??r-s;return s===0&&o===0&&r>0&&(o=1),{size:r,offset:s,length:o}}static isPartial(e){return e.size===0?!1:e.offset!==void 0||e.length!==void 0}},Te=class t extends ie{constructor(e,r){let s=r;!s&&e.httpMetadata?.cacheControl&&(s=L.parse(e.httpMetadata.cacheControl)),super(e.body,t.computeRange(e.size,e.range),s),this.setHeader(n.ETAG,e.httpEtag),e.httpMetadata?.contentType&&(this.mediaType=e.httpMetadata.contentType)}static computeRange(e,r){if(!r)return{size:e};if("suffix"in r){let s=Math.max(0,e-r.suffix),o=e-s;return{size:e,offset:s,length:o}}return{size:e,...r}}},be=class extends O{constructor(e){super(null),this.status=p.SWITCHING_PROTOCOLS,this.webSocket=e}},q=class extends O{constructor(e){super(),this.status=e.status,this.statusText=e.statusText,this.headers=new Headers(e.headers)}},y=class extends O{constructor(){super(),this.status=p.NO_CONTENT}};var K="*",Re=new Set([f,D,b]),Ne=[h.SWITCHING_PROTOCOLS,h.CONTINUE,h.PROCESSING,h.EARLY_HINTS,h.MOVED_PERMANENTLY,h.MOVED_TEMPORARILY,h.SEE_OTHER,h.TEMPORARY_REDIRECT,h.PERMANENT_REDIRECT],ye={allowedOrigins:[K],allowedHeaders:[n.CONTENT_TYPE],exposedHeaders:[],allowCredentials:!1,maxAge:5*de.Minute};async function _e(t,e){let r=new y,s=Pe(t.request);return s&&(Le(r.headers,e,s),ve(r.headers,e,s)),nt(r.headers,t),at(r.headers,e),it(r.headers,e),r.response()}async function we(t,e,r){let s=new U(t),o=Pe(e.request);return ut(s.headers),o&&(Le(s.headers,r,o),ve(s.headers,r,o),ct(s.headers,r)),s.response()}function Le(t,e,r){Ie(e)?d(t,n.ACCESS_CONTROL_ALLOW_ORIGIN,K):(e.allowedOrigins.includes(r)&&d(t,n.ACCESS_CONTROL_ALLOW_ORIGIN,r),G(t,n.VARY,n.ORIGIN))}function ve(t,e,r){e.allowCredentials&&(Ie(e)||e.allowedOrigins.includes(r)&&d(t,n.ACCESS_CONTROL_ALLOW_CREDENTIALS,"true"))}function nt(t,e){let r=e.getAllowedMethods();N(r);let s=r.filter(o=>!Re.has(o));s.length>0&&d(t,n.ACCESS_CONTROL_ALLOW_METHODS,s)}function it(t,e){let r=Math.max(0,Math.floor(e.maxAge));d(t,n.ACCESS_CONTROL_MAX_AGE,String(r))}function at(t,e){e.allowedHeaders.length>0&&d(t,n.ACCESS_CONTROL_ALLOW_HEADERS,e.allowedHeaders)}function ct(t,e){d(t,n.ACCESS_CONTROL_EXPOSE_HEADERS,e.exposedHeaders)}function Ie(t){return t.allowedOrigins.includes(K)}function ut(t){t.delete(n.ACCESS_CONTROL_MAX_AGE),t.delete(n.ACCESS_CONTROL_ALLOW_ORIGIN),t.delete(n.ACCESS_CONTROL_ALLOW_HEADERS),t.delete(n.ACCESS_CONTROL_ALLOW_METHODS),t.delete(n.ACCESS_CONTROL_EXPOSE_HEADERS),t.delete(n.ACCESS_CONTROL_ALLOW_CREDENTIALS)}function We(t){let{status:e,headers:r}=t;return!!(Ne.includes(e)||r.has(n.UPGRADE))}function Pe(t){let e=t.headers.get(n.ORIGIN)?.trim();if(!e||e==="null")return null;try{return new URL(e).origin}catch{return null}}function ke(t){if(t===void 0)return;if(typeof t!="object"||t===null)throw new TypeError("CorsInit must be an object.");let e=t;if(e.allowedOrigins!==void 0&&!H(e.allowedOrigins))throw new TypeError("CorsInit.allowedOrigins must be a string array.");if(e.allowedHeaders!==void 0&&!H(e.allowedHeaders))throw new TypeError("CorsInit.allowedHeaders must be a string array.");if(e.exposedHeaders!==void 0&&!H(e.exposedHeaders))throw new TypeError("CorsInit.exposedHeaders must be a string array.");if(e.allowCredentials!==void 0&&!he(e.allowCredentials))throw new TypeError("CorsInit.allowCredentials must be a boolean.");if(e.maxAge!==void 0&&!E(e.maxAge))throw new TypeError("CorsInit.maxAge must be a number.")}function jr(t){return ke(t),new ae(t)}var ae=class extends m{config;constructor(e){super(),this.config={...ye,...e}}async handle(e,r){if(e.request.method===b)return _e(e,this.config);let s=await r();return We(s)?s:we(s,e,this.config)}};import{getReasonPhrase as pt,StatusCodes as C}from"http-status-codes";var Me="upgrade",De="websocket";var T={NORMAL:1e3,GOING_AWAY:1001,PROTOCOL_ERROR:1002,UNSUPPORTED_DATA:1003,NO_STATUS:1005,ABNORMAL:1006,INVALID_PAYLOAD:1007,POLICY_VIOLATION:1008,MESSAGE_TOO_BIG:1009,MISSING_EXTENSION:1010,INTERNAL_ERROR:1011,TLS_HANDSHAKE:1015},He=new Set([T.NO_STATUS,T.ABNORMAL,T.TLS_HANDSHAKE]);var l=class extends V{constructor(r,s){let o={status:r,error:pt(r),details:s??""};super(o,L.DISABLE,r);this.details=s}},P=class extends l{constructor(e){super(C.BAD_REQUEST,e)}},Ge=class extends l{constructor(e){super(C.UNAUTHORIZED,e)}},Ue=class extends l{constructor(e){super(C.FORBIDDEN,e)}},g=class extends l{constructor(e){super(C.NOT_FOUND,e)}},k=class extends l{constructor(e){let r=e.getAllowedMethods();N(r),super(C.METHOD_NOT_ALLOWED,`${e.request.method} method not allowed.`),this.setHeader(n.ALLOW,r)}},B=class extends l{constructor(){super(C.UPGRADE_REQUIRED),this.headers.set(n.SEC_WEBSOCKET_VERSION,"13")}},F=class extends l{constructor(e){super(C.INTERNAL_SERVER_ERROR,e)}},ce=class extends l{constructor(e){super(C.NOT_IMPLEMENTED,e)}},A=class extends ce{constructor(e){super(`${e.request.method} method not implemented.`)}},Ve=class extends l{constructor(e){super(C.SERVICE_UNAVAILABLE,e)}};function Ke(t){return R(t,n.CONNECTION).some(e=>e.toLowerCase()===Me)}function Be(t){return R(t,n.UPGRADE).some(e=>e.toLowerCase()===De)}function Fe(t){return t.get(n.SEC_WEBSOCKET_VERSION)?.trim()==="13"}function ps(t="/"){return new ue(t)}var ue=class extends m{constructor(r){super();this.path=r}handle(r,s){if(r.request.method!==f||this.getPath(r.request)!==this.path)return s();let o=r.request.headers;return Ke(o)?Be(o)?Fe(o)?s():new B().response():new P("Missing or invalid Upgrade header").response():new P("Missing or invalid Connection header").response()}getPath(r){return new URL(r.url).pathname}};function ht(t){return t instanceof ArrayBuffer||ArrayBuffer.isView(t)}function Ye(t){return x(t)?t.length>0:ht(t)?t.byteLength>0:!1}function je(t){return E(t)?mt(t)&&!ft(t)?t:T.NORMAL:T.NORMAL}function mt(t){return t>=T.NORMAL&&t<=4999}function ft(t){return He.has(t)}function ze(t){if(x(t))return t.replaceAll(/[^\x20-\x7E]/g,"").slice(0,123)}function $e(t){if(t===null||typeof t!="object")throw new TypeError("WebSocket attachment must be an object");try{JSON.stringify(t)}catch{throw new TypeError("WebSocket attachment is not serializable")}}var Y=class t{server;static isCustomEvent(e){return["open","warn"].includes(e)}customListeners={};constructor(e){this.server=e}addEventListener(e,r,s){if(t.isCustomEvent(e)){let o=this.customListeners[e];o||(o=[],this.customListeners[e]=o),o.push(r)}else{let o=e==="close"?{...s,once:!0}:s;this.server.addEventListener(e,r,o)}}removeEventListener(e,r){if(t.isCustomEvent(e)){let s=this.customListeners[e];if(s){let o=s.indexOf(r);o!==-1&&s.splice(o,1)}}else this.server.removeEventListener(e,r)}dispatch(e,r,s=!1){let o=this.customListeners[e]?.slice()??[];s&&(this.customListeners[e]=[]);for(let i of o)i(r)}warn(e){this.dispatch("warn",{type:"warn",message:e})}open(){this.dispatch("open",new Event("open"),!0)}};var _=class extends Y{accepted=!1;server;constructor(e){super(e),this.server=e,this.server.addEventListener("close",this.onclose)}send(e){if(this.isState(WebSocket.CONNECTING,WebSocket.CLOSED)){this.warn("Cannot send: WebSocket not open");return}if(!Ye(e)){this.warn("Cannot send: empty or invalid data");return}this.server.send(e)}get attachment(){return this.server.deserializeAttachment()??{}}attach(e){if(e!==void 0)if(e===null)this.server.serializeAttachment({});else{let s={...this.attachment,...e};$e(s),this.server.serializeAttachment(s)}}get readyState(){return this.accepted?this.server.readyState:WebSocket.CONNECTING}isState(...e){return e.includes(this.readyState)}close(e,r){this.server.removeEventListener("close",this.onclose),this.server.close(je(e),ze(r))}onclose=e=>{this.close(e.code,e.reason)}};var j=class extends _{client;constructor(){let e=new WebSocketPair,[r,s]=[e[0],e[1]];super(s),this.client=r}acceptWebSocket(e,r){return e.acceptWebSocket(this.server,r),this.ready()}accept(){return this.server.accept(),this.ready()}ready(){return this.accepted=!0,this.open(),this.client}};var z=class extends _{constructor(e){super(e),this.accepted=!0}accept(){throw new Error("Do not call accept() on restore")}acceptWebSocket(){throw new Error("Do not call acceptWebSocket() on restore")}};var Je=class{map=new Map;create(e){class r extends j{constructor(c){super();this.sessions=c}accept(){return this.addEventListener("close",()=>this.sessions.unregister(this.server)),this.sessions.register(this.server,this),super.accept()}acceptWebSocket(c,u){return this.sessions.register(this.server,this),super.acceptWebSocket(c,u)}}let s=new r(this);return s.attach(e),s}restore(e){class r extends z{constructor(o,i){super(i),o.register(this.server,this)}}return new r(this,e)}restoreAll(e){let r=[];for(let s of e)r.push(this.restore(s));return r}get(e){return this.map.get(e)}values(){return this.map.values()}keys(){return this.map.keys()}close(e,r,s){let o=this.get(e);return o&&o.close(r,s),this.unregister(e)}*[Symbol.iterator](){yield*this.values()}register(e,r){this.map.set(e,r)}unregister(e){return this.map.delete(e)}};var w=class{constructor(e,r,s){this._request=e;this._env=r;this._ctx=s}get request(){return this._request}get env(){return this._env}get ctx(){return this._ctx}isAllowed(e){let r=this.getAllowedMethods();return N(r),se(e)&&r.includes(e)}create(e){let r=this.constructor;return new r(e,this.env,this.ctx)}async response(e,...r){return new e(...r).response()}static ignite(){return{fetch:(e,r,s)=>new this(e,r,s).fetch()}}};function Xe(t){if(!(t instanceof m))throw new TypeError("Handler must be a subclass of Middleware.")}var $=class extends w{middlewares=[];init(){}use(e){return Xe(e),this.middlewares.push(e),this}async fetch(){return await this.middlewares.reduceRight((r,s)=>()=>s.handle(this,r),()=>this.dispatch())()}};var J=class extends ${async fetch(){if(!this.isAllowed(this.request.method))return this.response(k,this);try{return await this.init(),await super.fetch()}catch(e){return console.error(e),this.response(F)}}async dispatch(){let e=this.request.method;return({GET:()=>this.get(),PUT:()=>this.put(),HEAD:()=>this.head(),POST:()=>this.post(),PATCH:()=>this.patch(),DELETE:()=>this.delete(),OPTIONS:()=>this.options()}[e]??(()=>this.response(k,this)))()}async get(){return this.response(A,this)}async put(){return this.response(A,this)}async post(){return this.response(A,this)}async patch(){return this.response(A,this)}async delete(){return this.response(A,this)}async options(){return this.response(y)}async head(){let e=this.create(new Request(this.request.url,{method:f,headers:this.request.headers}));return this.response(q,await e.fetch())}getAllowedMethods(){return[f,D,b]}};import{match as Ct}from"path-to-regexp";var X=class{routes=[];add(e){for(let[r,s,o]of e){let i=Ct(s);this.routes.push({method:r,matcher:i,handler:o})}}match(e,r){let s=new URL(r).pathname;for(let o of this){if(o.method!==e)continue;let i=o.matcher(s);if(i)return{route:o,params:i.params}}return null}*[Symbol.iterator](){yield*this.routes}};var Qe=class t extends J{_routes=new X;route(e,r,s){return this.routes([[e,r,s]]),this}routes(e){return this._routes.add(e),this}async dispatch(){let e=this._routes.match(this.request.method,this.request.url);if(!e)return super.dispatch();let{handler:r}=e.route;return t.isWorkerClass(r)?new r(this.request,this.env,this.ctx).fetch():r.call(this,e.params)}static isWorkerClass(e){return w.prototype.isPrototypeOf(e.prototype)}async get(){return this.response(g)}async put(){return this.response(g)}async post(){return this.response(g)}async patch(){return this.response(g)}async delete(){return this.response(g)}};export{P as BadRequest,J as BasicWorker,L as CacheControl,U as ClonedResponse,Dt as DELETE,Ue as Forbidden,f as GET,D as HEAD,q as Head,Ae as HtmlResponse,l as HttpError,F as InternalServerError,V as JsonResponse,M as Method,k as MethodNotAllowed,A as MethodNotImplemented,g as NotFound,ce as NotImplemented,b as OPTIONS,ie as OctetStream,y as Options,Mt as PATCH,kt as POST,Pt as PUT,Te as R2ObjectStream,Qe as RouteWorker,Ve as ServiceUnavailable,h as StatusCodes,W as SuccessResponse,xe as TextResponse,de as Time,Ge as Unauthorized,B as UpgradeRequired,Je as WebSocketSessions,be as WebSocketUpgrade,O as WorkerResponse,ur as cache,jr as cors,tt as sortSearchParams,pr as stripSearchParams,ps as websocket};
+import{StatusCodes as h}from"http-status-codes";import pe from"cache-control-parser";var L={parse:pe.parse,stringify:pe.stringify,DISABLE:Object.freeze({"no-cache":!0,"no-store":!0,"must-revalidate":!0,"max-age":0})};var M=(u=>(u.GET="GET",u.PUT="PUT",u.HEAD="HEAD",u.POST="POST",u.PATCH="PATCH",u.DELETE="DELETE",u.OPTIONS="OPTIONS",u))(M||{}),{GET:f,PUT:Pt,HEAD:D,POST:kt,PATCH:Mt,DELETE:Dt,OPTIONS:b}=M;var de={Second:1,Minute:60,Hour:3600,Day:86400,Week:604800,Month:2592e3,Year:31536e3};var m=class{};function H(t){return Array.isArray(t)&&t.every(e=>typeof e=="string")}function x(t){return typeof t=="string"}function le(t){return typeof t=="function"}function E(t){return typeof t=="number"&&!Number.isNaN(t)}function he(t){return typeof t=="boolean"}function me(t){if(t!==void 0&&!x(t))throw new TypeError("Cache name must be a string.")}function fe(t){if(t!==void 0&&!le(t))throw new TypeError("getKey must be a function.")}function Ce(t){if(!(t instanceof URL))throw new TypeError("getKey must return a URL.")}var n;(a=>(a.ACCEPT_ENCODING="Accept-Encoding",a.ACCEPT_RANGES="Accept-Ranges",a.ALLOW="Allow",a.CACHE_CONTROL="Cache-Control",a.CONNECTION="Connection",a.CONTENT_DISPOSITION="Content-Disposition",a.CONTENT_ENCODING="Content-Encoding",a.CONTENT_LANGUAGE="Content-Language",a.CONTENT_LENGTH="Content-Length",a.CONTENT_RANGE="Content-Range",a.CONTENT_TYPE="Content-Type",a.CONTENT_MD5="Content-MD5",a.ETAG="ETag",a.ORIGIN="Origin",a.VARY="Vary",a.ACCESS_CONTROL_ALLOW_CREDENTIALS="Access-Control-Allow-Credentials",a.ACCESS_CONTROL_ALLOW_HEADERS="Access-Control-Allow-Headers",a.ACCESS_CONTROL_ALLOW_METHODS="Access-Control-Allow-Methods",a.ACCESS_CONTROL_ALLOW_ORIGIN="Access-Control-Allow-Origin",a.ACCESS_CONTROL_EXPOSE_HEADERS="Access-Control-Expose-Headers",a.ACCESS_CONTROL_MAX_AGE="Access-Control-Max-Age",a.SEC_WEBSOCKET_VERSION="Sec-WebSocket-Version",a.UPGRADE="Upgrade"))(n||={});var Ee=[n.CONTENT_TYPE,n.CONTENT_LENGTH,n.CONTENT_RANGE,n.CONTENT_ENCODING,n.CONTENT_LANGUAGE,n.CONTENT_DISPOSITION,n.CONTENT_MD5],Se=[n.CONTENT_LENGTH,n.CONTENT_RANGE];function S(t,e){return t<e?-1:t>e?1:0}function d(t,e,r){let s=Array.isArray(r)?r:[r],o=Array.from(new Set(s.map(i=>i.trim()))).filter(i=>i.length).sort(S);if(!o.length){t.delete(e);return}t.set(e,o.join(", "))}function G(t,e,r){let s=Array.isArray(r)?r:[r];if(s.length===0)return;let i=R(t,e).concat(s.map(c=>c.trim()));d(t,e,i)}function R(t,e){let r=t.get(e)?.split(",").map(s=>s.trim()).filter(s=>s.length>0)??[];return Array.from(new Set(r)).sort(S)}function Q(t,e){for(let r of e)t.delete(r)}var Ze="https://vary";function Oe(t){return!(!t.ok||Z(t).includes("*"))}function Z(t){let e=R(t.headers,n.VARY);return Array.from(new Set(e.map(r=>r.toLowerCase()))).sort(S)}function ee(t){return t.map(e=>e.toLowerCase()).filter(e=>e!==n.ACCEPT_ENCODING.toLowerCase())}function te(t,e,r){let s=[],o=ee(e);o.sort(S);for(let c of o){let u=t.headers.get(c);u!==null&&s.push([c,u])}let i=et(JSON.stringify([r.toString(),s]));return new URL(i,Ze).href}function et(t){let e=new TextEncoder().encode(t),r="";for(let s of e)r+=String.fromCodePoint(s);return btoa(r).replaceAll("+","-").replaceAll("/","_").replace(/={1,2}$/,"")}function ur(t,e){return me(t),fe(e),new re(t,e)}function tt(t){let e=new URL(t.url),r=new URLSearchParams([...e.searchParams.entries()].sort(([s],[o])=>S(s,o)));return e.search=r.toString(),e.hash="",e}function pr(t){let e=new URL(t.url);return e.search="",e.hash="",e}var re=class extends m{constructor(r,s){super();this.cacheName=r;this.getKey=s;this.cacheName=r?.trim()||void 0}async handle(r,s){if(r.request.method!==f)return s();let o=this.cacheName?await caches.open(this.cacheName):caches.default,i=await this.getCached(o,r.request);if(i)return i;let c=await s();return this.setCached(o,r,c),c}async getCached(r,s){let o=this.getCacheKey(s),i=await r.match(o);if(!i)return;let c=this.getFilteredVary(i);if(c.length===0)return i;let u=te(s,c,o);return r.match(u)}async setCached(r,s,o){if(!Oe(o))return;let i=this.getCacheKey(s.request);s.ctx.waitUntil(r.put(i,o.clone()));let c=this.getFilteredVary(o);c.length>0&&s.ctx.waitUntil(r.put(te(s.request,c,i),o.clone()))}getFilteredVary(r){return ee(Z(r))}getCacheKey(r){let s=this.getKey?this.getKey(r):tt(r);return Ce(s),s.hash="",s}};var rt=new Set(Object.values(M));function se(t){return x(t)&&rt.has(t)}function st(t){return Array.isArray(t)&&t.every(se)}function N(t){if(!st(t)){let e=Array.isArray(t)?JSON.stringify(t):String(t);throw new TypeError(`Invalid method array: ${e}`)}}import{getReasonPhrase as ot,StatusCodes as p}from"http-status-codes";var v="utf-8";function I(t,e){return!e||t.toLowerCase().includes("charset=")?t:`${t}; charset=${e.toLowerCase()}`}function ge(t){if(typeof t!="object"||t===null)throw new TypeError("OctetStreamInit must be an object.");let e=t,r=e.size;if(!E(r)||r<0||!Number.isInteger(r))throw new RangeError(`OctetStreamInit.size must be a non-negative integer (size=${JSON.stringify(r)}).`);let s=e.offset??0;if(!E(s)||s<0||s>r||!Number.isInteger(s))throw new RangeError(`OctetStreamInit.offset must be a non-negative integer less than or equal to size (size=${JSON.stringify(r)}, offset=${JSON.stringify(s)}).`);let o=e.length??r-s;if(!E(o)||o<0||s+o>r||!Number.isInteger(o))throw new RangeError(`OctetStreamInit.length must be a non-negative integer less than or equal to size - offset (size=${JSON.stringify(r)}, offset=${JSON.stringify(s)}, length=${JSON.stringify(o)}).`)}var oe=class{headers=new Headers;status=p.OK;statusText;webSocket=null;mediaType=I("text/plain",v);get responseInit(){return{headers:this.headers,status:this.status,statusText:this.statusText??ot(this.status),webSocket:this.webSocket,encodeBody:"automatic"}}setHeader(e,r){d(this.headers,e,r)}mergeHeader(e,r){G(this.headers,e,r)}addContentType(){this.headers.get(n.CONTENT_TYPE)||this.setHeader(n.CONTENT_TYPE,this.mediaType)}filterHeaders(){this.status===p.NO_CONTENT?Q(this.headers,Se):this.status===p.NOT_MODIFIED&&Q(this.headers,Ee)}},ne=class extends oe{constructor(r){super();this.cache=r}addCacheHeader(){this.cache&&this.setHeader(n.CACHE_CONTROL,L.stringify(this.cache))}},O=class extends ne{constructor(r=null,s){super(s);this.body=r}async response(){this.addCacheHeader();let r=[p.NO_CONTENT,p.NOT_MODIFIED].includes(this.status)?null:this.body;return r&&this.addContentType(),this.filterHeaders(),new Response(r,this.responseInit)}},U=class extends O{constructor(e,r){let s=e.clone();super(s.body,r),this.headers=new Headers(s.headers),this.status=s.status,this.statusText=s.statusText}},W=class extends O{constructor(e=null,r,s=p.OK){super(e,r),this.status=s}},q=class extends W{constructor(e={},r,s=p.OK){super(JSON.stringify(e),r,s),this.mediaType=I("application/json",v)}},Ae=class extends W{constructor(e,r,s=p.OK,o=v){super(e,r,s),this.mediaType=I("text/html",o)}},xe=class extends W{constructor(e,r,s=p.OK,o=v){super(e,r,s),this.mediaType=I("text/plain",o)}},ie=class t extends O{constructor(e,r,s){ge(r),super(e,s),this.mediaType="application/octet-stream";let o=t.normalizeInit(r),{size:i,offset:c,length:u}=o;t.isPartial(o)&&(this.setHeader(n.CONTENT_RANGE,`bytes ${c}-${c+u-1}/${i}`),this.status=p.PARTIAL_CONTENT),this.setHeader(n.ACCEPT_RANGES,"bytes"),this.setHeader(n.CONTENT_LENGTH,`${u}`)}static normalizeInit(e){let{size:r}=e,s=e.offset??0,o=e.length??r-s;return s===0&&o===0&&r>0&&(o=1),{size:r,offset:s,length:o}}static isPartial(e){return e.size===0?!1:!(e.offset===0&&e.length===e.size)}},Te=class t extends ie{constructor(e,r){let s=r;!s&&e.httpMetadata?.cacheControl&&(s=L.parse(e.httpMetadata.cacheControl)),super(e.body,t.computeRange(e.size,e.range),s),this.setHeader(n.ETAG,e.httpEtag),e.httpMetadata?.contentType&&(this.mediaType=e.httpMetadata.contentType)}static computeRange(e,r){if(!r)return{size:e};if("suffix"in r){let s=Math.max(0,e-r.suffix),o=e-s;return{size:e,offset:s,length:o}}return{size:e,...r}}},be=class extends O{constructor(e){super(null),this.status=p.SWITCHING_PROTOCOLS,this.webSocket=e}},V=class extends O{constructor(e){super(),this.status=e.status,this.statusText=e.statusText,this.headers=new Headers(e.headers)}},y=class extends O{constructor(){super(),this.status=p.NO_CONTENT}};var K="*",Re=new Set([f,D,b]),Ne=[h.SWITCHING_PROTOCOLS,h.CONTINUE,h.PROCESSING,h.EARLY_HINTS,h.MOVED_PERMANENTLY,h.MOVED_TEMPORARILY,h.SEE_OTHER,h.TEMPORARY_REDIRECT,h.PERMANENT_REDIRECT],ye={allowedOrigins:[K],allowedHeaders:[n.CONTENT_TYPE],exposedHeaders:[],allowCredentials:!1,maxAge:5*de.Minute};async function _e(t,e){let r=new y,s=Pe(t.request);return s&&(Le(r.headers,e,s),ve(r.headers,e,s)),nt(r.headers,t),at(r.headers,e),it(r.headers,e),r.response()}async function we(t,e,r){let s=new U(t),o=Pe(e.request);return ut(s.headers),o&&(Le(s.headers,r,o),ve(s.headers,r,o),ct(s.headers,r)),s.response()}function Le(t,e,r){Ie(e)?d(t,n.ACCESS_CONTROL_ALLOW_ORIGIN,K):(e.allowedOrigins.includes(r)&&d(t,n.ACCESS_CONTROL_ALLOW_ORIGIN,r),G(t,n.VARY,n.ORIGIN))}function ve(t,e,r){e.allowCredentials&&(Ie(e)||e.allowedOrigins.includes(r)&&d(t,n.ACCESS_CONTROL_ALLOW_CREDENTIALS,"true"))}function nt(t,e){let r=e.getAllowedMethods();N(r);let s=r.filter(o=>!Re.has(o));s.length>0&&d(t,n.ACCESS_CONTROL_ALLOW_METHODS,s)}function it(t,e){let r=Math.max(0,Math.floor(e.maxAge));d(t,n.ACCESS_CONTROL_MAX_AGE,String(r))}function at(t,e){e.allowedHeaders.length>0&&d(t,n.ACCESS_CONTROL_ALLOW_HEADERS,e.allowedHeaders)}function ct(t,e){d(t,n.ACCESS_CONTROL_EXPOSE_HEADERS,e.exposedHeaders)}function Ie(t){return t.allowedOrigins.includes(K)}function ut(t){t.delete(n.ACCESS_CONTROL_MAX_AGE),t.delete(n.ACCESS_CONTROL_ALLOW_ORIGIN),t.delete(n.ACCESS_CONTROL_ALLOW_HEADERS),t.delete(n.ACCESS_CONTROL_ALLOW_METHODS),t.delete(n.ACCESS_CONTROL_EXPOSE_HEADERS),t.delete(n.ACCESS_CONTROL_ALLOW_CREDENTIALS)}function We(t){let{status:e,headers:r}=t;return!!(Ne.includes(e)||r.has(n.UPGRADE))}function Pe(t){let e=t.headers.get(n.ORIGIN)?.trim();if(!e||e==="null")return null;try{return new URL(e).origin}catch{return null}}function ke(t){if(t===void 0)return;if(typeof t!="object"||t===null)throw new TypeError("CorsInit must be an object.");let e=t;if(e.allowedOrigins!==void 0&&!H(e.allowedOrigins))throw new TypeError("CorsInit.allowedOrigins must be a string array.");if(e.allowedHeaders!==void 0&&!H(e.allowedHeaders))throw new TypeError("CorsInit.allowedHeaders must be a string array.");if(e.exposedHeaders!==void 0&&!H(e.exposedHeaders))throw new TypeError("CorsInit.exposedHeaders must be a string array.");if(e.allowCredentials!==void 0&&!he(e.allowCredentials))throw new TypeError("CorsInit.allowCredentials must be a boolean.");if(e.maxAge!==void 0&&!E(e.maxAge))throw new TypeError("CorsInit.maxAge must be a number.")}function Yr(t){return ke(t),new ae(t)}var ae=class extends m{config;constructor(e){super(),this.config={...ye,...e}}async handle(e,r){if(e.request.method===b)return _e(e,this.config);let s=await r();return We(s)?s:we(s,e,this.config)}};import{getReasonPhrase as pt,StatusCodes as C}from"http-status-codes";var Me="upgrade",De="websocket";var T={NORMAL:1e3,GOING_AWAY:1001,PROTOCOL_ERROR:1002,UNSUPPORTED_DATA:1003,NO_STATUS:1005,ABNORMAL:1006,INVALID_PAYLOAD:1007,POLICY_VIOLATION:1008,MESSAGE_TOO_BIG:1009,MISSING_EXTENSION:1010,INTERNAL_ERROR:1011,TLS_HANDSHAKE:1015},He=new Set([T.NO_STATUS,T.ABNORMAL,T.TLS_HANDSHAKE]);var l=class extends q{constructor(r,s){let o={status:r,error:pt(r),details:s??""};super(o,L.DISABLE,r);this.details=s}},P=class extends l{constructor(e){super(C.BAD_REQUEST,e)}},Ge=class extends l{constructor(e){super(C.UNAUTHORIZED,e)}},Ue=class extends l{constructor(e){super(C.FORBIDDEN,e)}},g=class extends l{constructor(e){super(C.NOT_FOUND,e)}},k=class extends l{constructor(e){let r=e.getAllowedMethods();N(r),super(C.METHOD_NOT_ALLOWED,`${e.request.method} method not allowed.`),this.setHeader(n.ALLOW,r)}},B=class extends l{constructor(){super(C.UPGRADE_REQUIRED),this.headers.set(n.SEC_WEBSOCKET_VERSION,"13")}},z=class extends l{constructor(e){super(C.INTERNAL_SERVER_ERROR,e)}},ce=class extends l{constructor(e){super(C.NOT_IMPLEMENTED,e)}},A=class extends ce{constructor(e){super(`${e.request.method} method not implemented.`)}},qe=class extends l{constructor(e){super(C.SERVICE_UNAVAILABLE,e)}};function Ke(t){return R(t,n.CONNECTION).some(e=>e.toLowerCase()===Me)}function Be(t){return R(t,n.UPGRADE).some(e=>e.toLowerCase()===De)}function ze(t){return t.get(n.SEC_WEBSOCKET_VERSION)?.trim()==="13"}function ps(t="/"){return new ue(t)}var ue=class extends m{constructor(r){super();this.path=r}handle(r,s){if(r.request.method!==f||this.getPath(r.request)!==this.path)return s();let o=r.request.headers;return Ke(o)?Be(o)?ze(o)?s():new B().response():new P("Missing or invalid Upgrade header").response():new P("Missing or invalid Connection header").response()}getPath(r){return new URL(r.url).pathname}};function ht(t){return t instanceof ArrayBuffer||ArrayBuffer.isView(t)}function Fe(t){return x(t)?t.length>0:ht(t)?t.byteLength>0:!1}function Ye(t){return E(t)?mt(t)&&!ft(t)?t:T.NORMAL:T.NORMAL}function mt(t){return t>=T.NORMAL&&t<=4999}function ft(t){return He.has(t)}function je(t){if(x(t))return t.replaceAll(/[^\x20-\x7E]/g,"").slice(0,123)}function $e(t){if(t===null||typeof t!="object")throw new TypeError("WebSocket attachment must be an object");try{JSON.stringify(t)}catch{throw new TypeError("WebSocket attachment is not serializable")}}var F=class t{server;static isCustomEvent(e){return["open","warn"].includes(e)}customListeners={};constructor(e){this.server=e}addEventListener(e,r,s){if(t.isCustomEvent(e)){let o=this.customListeners[e];o||(o=[],this.customListeners[e]=o),o.push(r)}else{let o=e==="close"?{...s,once:!0}:s;this.server.addEventListener(e,r,o)}}removeEventListener(e,r){if(t.isCustomEvent(e)){let s=this.customListeners[e];if(s){let o=s.indexOf(r);o!==-1&&s.splice(o,1)}}else this.server.removeEventListener(e,r)}dispatch(e,r,s=!1){let o=this.customListeners[e]?.slice()??[];s&&(this.customListeners[e]=[]);for(let i of o)i(r)}warn(e){this.dispatch("warn",{type:"warn",message:e})}open(){this.dispatch("open",new Event("open"),!0)}};var _=class extends F{accepted=!1;server;constructor(e){super(e),this.server=e,this.server.addEventListener("close",this.onclose)}send(e){if(this.isState(WebSocket.CONNECTING,WebSocket.CLOSED)){this.warn("Cannot send: WebSocket not open");return}if(!Fe(e)){this.warn("Cannot send: empty or invalid data");return}this.server.send(e)}get attachment(){return this.server.deserializeAttachment()??{}}attach(e){if(e!==void 0)if(e===null)this.server.serializeAttachment({});else{let s={...this.attachment,...e};$e(s),this.server.serializeAttachment(s)}}get readyState(){return this.accepted?this.server.readyState:WebSocket.CONNECTING}isState(...e){return e.includes(this.readyState)}close(e,r){this.server.removeEventListener("close",this.onclose),this.server.close(Ye(e),je(r))}onclose=e=>{this.close(e.code,e.reason)}};var Y=class extends _{client;constructor(){let e=new WebSocketPair,[r,s]=[e[0],e[1]];super(s),this.client=r}acceptWebSocket(e,r){return e.acceptWebSocket(this.server,r),this.ready()}accept(){return this.server.accept(),this.ready()}ready(){return this.accepted=!0,this.open(),this.client}};var j=class extends _{constructor(e){super(e),this.accepted=!0}accept(){throw new Error("Do not call accept() on restore")}acceptWebSocket(){throw new Error("Do not call acceptWebSocket() on restore")}};var Je=class{map=new Map;create(e){class r extends Y{constructor(c){super();this.sessions=c}accept(){return this.addEventListener("close",()=>this.sessions.unregister(this.server)),this.sessions.register(this.server,this),super.accept()}acceptWebSocket(c,u){return this.sessions.register(this.server,this),super.acceptWebSocket(c,u)}}let s=new r(this);return s.attach(e),s}restore(e){class r extends j{constructor(o,i){super(i),o.register(this.server,this)}}return new r(this,e)}restoreAll(e){let r=[];for(let s of e)r.push(this.restore(s));return r}get(e){return this.map.get(e)}values(){return this.map.values()}keys(){return this.map.keys()}close(e,r,s){let o=this.get(e);return o&&o.close(r,s),this.unregister(e)}*[Symbol.iterator](){yield*this.values()}register(e,r){this.map.set(e,r)}unregister(e){return this.map.delete(e)}};var w=class{constructor(e,r,s){this._request=e;this._env=r;this._ctx=s}get request(){return this._request}get env(){return this._env}get ctx(){return this._ctx}isAllowed(e){let r=this.getAllowedMethods();return N(r),se(e)&&r.includes(e)}create(e){let r=this.constructor;return new r(e,this.env,this.ctx)}async response(e,...r){return new e(...r).response()}static ignite(){return{fetch:(e,r,s)=>new this(e,r,s).fetch()}}};function Xe(t){if(!(t instanceof m))throw new TypeError("Handler must be a subclass of Middleware.")}var $=class extends w{middlewares=[];init(){}use(e){return Xe(e),this.middlewares.push(e),this}async fetch(){return await this.middlewares.reduceRight((r,s)=>()=>s.handle(this,r),()=>this.dispatch())()}};var J=class extends ${async fetch(){if(!this.isAllowed(this.request.method))return this.response(k,this);try{return await this.init(),await super.fetch()}catch(e){return console.error(e),this.response(z)}}async dispatch(){let e=this.request.method;return({GET:()=>this.get(),PUT:()=>this.put(),HEAD:()=>this.head(),POST:()=>this.post(),PATCH:()=>this.patch(),DELETE:()=>this.delete(),OPTIONS:()=>this.options()}[e]??(()=>this.response(k,this)))()}async get(){return this.response(A,this)}async put(){return this.response(A,this)}async post(){return this.response(A,this)}async patch(){return this.response(A,this)}async delete(){return this.response(A,this)}async options(){return this.response(y)}async head(){let e=this.create(new Request(this.request.url,{method:f,headers:this.request.headers}));return this.response(V,await e.fetch())}getAllowedMethods(){return[f,D,b]}};import{match as Ct}from"path-to-regexp";var X=class{routes=[];add(e){for(let[r,s,o]of e){let i=Ct(s);this.routes.push({method:r,matcher:i,handler:o})}}match(e,r){let s=new URL(r).pathname;for(let o of this){if(o.method!==e)continue;let i=o.matcher(s);if(i)return{route:o,params:i.params}}return null}*[Symbol.iterator](){yield*this.routes}};var Qe=class t extends J{_routes=new X;route(e,r,s){return this.routes([[e,r,s]]),this}routes(e){return this._routes.add(e),this}async dispatch(){let e=this._routes.match(this.request.method,this.request.url);if(!e)return super.dispatch();let{handler:r}=e.route;return t.isWorkerClass(r)?new r(this.request,this.env,this.ctx).fetch():r.call(this,e.params)}static isWorkerClass(e){return w.prototype.isPrototypeOf(e.prototype)}async get(){return this.response(g)}async put(){return this.response(g)}async post(){return this.response(g)}async patch(){return this.response(g)}async delete(){return this.response(g)}};export{P as BadRequest,J as BasicWorker,L as CacheControl,U as ClonedResponse,Dt as DELETE,Ue as Forbidden,f as GET,D as HEAD,V as Head,Ae as HtmlResponse,l as HttpError,z as InternalServerError,q as JsonResponse,M as Method,k as MethodNotAllowed,A as MethodNotImplemented,g as NotFound,ce as NotImplemented,b as OPTIONS,ie as OctetStream,y as Options,Mt as PATCH,kt as POST,Pt as PUT,Te as R2ObjectStream,Qe as RouteWorker,qe as ServiceUnavailable,h as StatusCodes,W as SuccessResponse,xe as TextResponse,de as Time,Ge as Unauthorized,B as UpgradeRequired,Je as WebSocketSessions,be as WebSocketUpgrade,O as WorkerResponse,ur as cache,Yr as cors,tt as sortSearchParams,pr as stripSearchParams,ps as websocket};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/constants/index.ts","../src/constants/cache.ts","../src/constants/methods.ts","../src/constants/time.ts","../src/middleware/middleware.ts","../src/guards/basic.ts","../src/guards/cache.ts","../src/constants/headers.ts","../src/utils/compare.ts","../src/utils/headers.ts","../src/middleware/cache/utils.ts","../src/middleware/cache/handler.ts","../src/guards/methods.ts","../src/responses.ts","../src/constants/media.ts","../src/utils/media.ts","../src/guards/responses.ts","../src/middleware/cors/constants.ts","../src/middleware/cors/utils.ts","../src/guards/cors.ts","../src/middleware/cors/handler.ts","../src/errors.ts","../src/constants/websocket.ts","../src/middleware/websocket/utils.ts","../src/middleware/websocket/handler.ts","../src/guards/websocket.ts","../src/websocket/events.ts","../src/websocket/base.ts","../src/websocket/new.ts","../src/websocket/restore.ts","../src/websocket/sessions.ts","../src/workers/base.ts","../src/guards/middleware.ts","../src/workers/middleware.ts","../src/workers/basic.ts","../src/routes.ts","../src/workers/route.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\n/**\n * https://github.com/prettymuchbryce/http-status-codes\n */\nexport { StatusCodes } from \"http-status-codes\";\n\nexport * from \"./cache\";\nexport * from \"./methods\";\nexport * from \"./time\";\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 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 CacheControl 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 * 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\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}\n\n/**\n * Shorthand constants for each HTTP method.\n *\n * These are equivalent to the corresponding enum members in `Method`.\n * For example, `GET === Method.GET`.\n */\nexport const { GET, PUT, HEAD, POST, PATCH, DELETE, OPTIONS } = Method;\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\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 * 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 { Worker } from \"../interfaces/worker\";\n\n/**\n * Abstract base class for middleware.\n *\n * Middleware classes implement request/response processing logic in a\n * chainable manner. Each middleware receives a `Worker` object and a\n * `next` function that invokes the next middleware in the chain.\n *\n * Subclasses **must implement** the `handle` method.\n *\n * Example subclass:\n * ```ts\n * class LoggingMiddleware extends Middleware {\n *     public async handle(worker: Worker, next: () => Promise<Response>): Promise<Response> {\n *         console.log(`Processing request: ${worker.request.url}`);\n *         const response = await next();\n *         console.log(`Response status: ${response.status}`);\n *         return response;\n *      }\n * }\n * ```\n */\nexport abstract class Middleware {\n    /**\n     * Process a request in the middleware chain.\n     *\n     * @param worker - The `Worker` instance representing the request context.\n     * @param next - Function to invoke the next middleware in the chain.\n     *               Must be called to continue the chain unless the middleware\n     *               terminates early (e.g., returns a response directly).\n     * @returns A `Response` object, either returned directly or from `next()`.\n     */\n    public abstract handle(worker: Worker, next: () => Promise<Response>): Promise<Response>;\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\n/**\n * Checks if the provided value is an array of strings.\n *\n * @param value - The value to check.\n * @returns True if `array` is an array where every item is a string.\n */\nexport function isStringArray(value: unknown): value is string[] {\n    return Array.isArray(value) && value.every((item) => typeof item === \"string\");\n}\n\n/**\n * Checks if a value is a string.\n *\n * @param value - The value to check.\n * @returns `true` if the value is a string, otherwise `false`.\n */\nexport function isString(value: unknown): value is string {\n    return typeof value === \"string\";\n}\n\n/**\n * Checks if a value is a function.\n *\n * @param value - The value to check.\n * @returns `true` if the value is a function, otherwise `false`.\n */\nexport function isFunction(value: unknown): value is Function {\n    return typeof value === \"function\";\n}\n\n/**\n * Checks if a value is a valid number (not NaN).\n *\n * This function returns `true` if the value is of type `number`\n * and is not `NaN`. It works as a type guard for TypeScript.\n *\n * @param value - The value to check.\n * @returns `true` if the value is a number and not `NaN`, otherwise `false`.\n */\nexport function isNumber(value: unknown): value is number {\n    return typeof value === \"number\" && !Number.isNaN(value);\n}\n\n/**\n * Checks if a value is a boolean.\n *\n * @param value - The value to check.\n * @returns `true` if the value is a boolean (`true` or `false`), otherwise `false`.\n */\nexport function isBoolean(value: unknown): value is boolean {\n    return typeof value === \"boolean\";\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 { isFunction, isString } from \"./basic\";\n\n/**\n * Asserts that a value is a string suitable for a cache name.\n *\n * If the value is `undefined`, this function does nothing.\n * Otherwise, it throws a `TypeError` if the value is not a string.\n *\n * @param value - The value to check.\n * @throws TypeError If the value is defined but not a string.\n */\nexport function assertCacheName(value: unknown): asserts value is string | undefined {\n    if (value === undefined) return;\n    if (!isString(value)) {\n        throw new TypeError(\"Cache name must be a string.\");\n    }\n}\n\n/**\n * Asserts that a value is a function suitable for `getKey`.\n *\n * If the value is `undefined`, this function does nothing.\n * Otherwise, it throws a `TypeError` if the value is not a function.\n *\n * @param value - The value to check.\n * @throws TypeError If the value is defined but not a function.\n */\nexport function assertGetKey(value: unknown): asserts value is Function | undefined {\n    if (value === undefined) return;\n    if (!isFunction(value)) {\n        throw new TypeError(\"getKey must be a function.\");\n    }\n}\n\n/**\n * Asserts that a value is a `URL` instance suitable for use as a cache key.\n *\n * If the value is not a `URL`, this function throws a `TypeError`.\n *\n * @param value - The value to check.\n * @throws TypeError If the value is not a `URL`.\n */\nexport function assertKey(value: unknown): asserts value is URL {\n    if (!(value instanceof URL)) {\n        throw new TypeError(\"getKey must return a URL.\");\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\n/**\n * Internally used headers.\n */\nexport namespace HttpHeader {\n    export const ACCEPT_ENCODING = \"Accept-Encoding\";\n    export const ACCEPT_RANGES = \"Accept-Ranges\";\n    export const ALLOW = \"Allow\";\n    export const CACHE_CONTROL = \"Cache-Control\";\n    export const CONNECTION = \"Connection\";\n    export const CONTENT_DISPOSITION = \"Content-Disposition\";\n    export const CONTENT_ENCODING = \"Content-Encoding\";\n    export const CONTENT_LANGUAGE = \"Content-Language\";\n    export const CONTENT_LENGTH = \"Content-Length\";\n    export const CONTENT_RANGE = \"Content-Range\";\n    export const CONTENT_TYPE = \"Content-Type\";\n    export const CONTENT_MD5 = \"Content-MD5\";\n    export const ETAG = \"ETag\";\n    export const ORIGIN = \"Origin\";\n    export const VARY = \"Vary\";\n\n    // Cors Headers\n    export const ACCESS_CONTROL_ALLOW_CREDENTIALS = \"Access-Control-Allow-Credentials\";\n    export const ACCESS_CONTROL_ALLOW_HEADERS = \"Access-Control-Allow-Headers\";\n    export const ACCESS_CONTROL_ALLOW_METHODS = \"Access-Control-Allow-Methods\";\n    export const ACCESS_CONTROL_ALLOW_ORIGIN = \"Access-Control-Allow-Origin\";\n    export const ACCESS_CONTROL_EXPOSE_HEADERS = \"Access-Control-Expose-Headers\";\n    export const ACCESS_CONTROL_MAX_AGE = \"Access-Control-Max-Age\";\n\n    // Websocket Headers\n    export const SEC_WEBSOCKET_VERSION = \"Sec-WebSocket-Version\";\n    export const UPGRADE = \"Upgrade\";\n}\n\n/**\n * Headers that must not be sent in 304 Not Modified responses.\n * These are stripped to comply with the HTTP spec.\n */\nexport const FORBIDDEN_304_HEADERS = [\n    HttpHeader.CONTENT_TYPE,\n    HttpHeader.CONTENT_LENGTH,\n    HttpHeader.CONTENT_RANGE,\n    HttpHeader.CONTENT_ENCODING,\n    HttpHeader.CONTENT_LANGUAGE,\n    HttpHeader.CONTENT_DISPOSITION,\n    HttpHeader.CONTENT_MD5,\n];\n\n/**\n * Headers that should not be sent in 204 No Content responses.\n * Stripping them is recommended but optional per spec.\n */\nexport const FORBIDDEN_204_HEADERS = [HttpHeader.CONTENT_LENGTH, HttpHeader.CONTENT_RANGE];\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\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 * 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 { lexCompare } from \"./compare\";\n\n/**\n * Sets a header on the given Headers object.\n *\n * - If `value` is an array, any duplicates and empty strings are removed.\n * - If the resulting value 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 * - If the resulting value array is empty, the header is deleted.\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 === 0) return;\n\n    const existing = getHeaderValues(headers, key);\n    const merged = existing.concat(values.map((v) => v.trim()));\n\n    setHeader(headers, key, merged);\n}\n\n/**\n * Returns the values of an HTTP header as an array of strings.\n *\n * This helper:\n * - Retrieves the header value by `key`.\n * - Splits the value on commas.\n * - Trims surrounding whitespace from each entry.\n * - Filters out any empty tokens.\n * - Removes duplicate values (case-sensitive)\n *\n * If the header is not present, an empty array is returned.\n *\n */\nexport function getHeaderValues(headers: Headers, key: string): string[] {\n    const values =\n        headers\n            .get(key)\n            ?.split(\",\")\n            .map((v) => v.trim())\n            .filter((v) => v.length > 0) ?? [];\n    return Array.from(new Set(values)).sort(lexCompare);\n}\n\n/**\n * Removes a list of header fields from a {@link Headers} object.\n *\n * @param headers - The {@link Headers} object to modify in place.\n * @param keys - An array of header field names to remove. Header names are\n *               matched case-insensitively per the Fetch spec.\n */\nexport function filterHeaders(headers: Headers, keys: string[]): void {\n    for (const key of keys) {\n        headers.delete(key);\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 *\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 { HttpHeader } from \"../../constants/headers\";\nimport { lexCompare } from \"../../utils/compare\";\nimport { getHeaderValues } from \"../../utils/headers\";\nimport { VARY_WILDCARD } from \"./constants\";\n\n/** Base URL used for constructing cache keys. Only used internally. */\nconst VARY_CACHE_URL = \"https://vary\";\n\n/**\n * Determines whether a Response is cacheable.\n * - Must have `ok` status (2xx-3xx)\n * - Must not contain a Vary header with a wildcard (`*`)\n *\n * @param response The Response object to check.\n * @returns `true` if the response can be cached; `false` otherwise.\n */\nexport function isCacheable(response: Response): boolean {\n    if (!response.ok) return false;\n    if (getVaryHeader(response).includes(VARY_WILDCARD)) return false;\n\n    return true;\n}\n\n/**\n * Extracts and normalizes the `Vary` header from a Response.\n * - Splits comma-separated values\n * - Deduplicates\n * - Converts all values to lowercase\n * - Sorts lexicographically\n *\n * @param response The Response object containing headers.\n * @returns An array of normalized header names from the Vary header.\n */\nexport function getVaryHeader(response: Response): string[] {\n    const values = getHeaderValues(response.headers, HttpHeader.VARY);\n    return Array.from(new Set(values.map((v) => v.toLowerCase()))).sort(lexCompare);\n}\n\n/**\n * Filters out headers that should be ignored for caching, currently:\n * - `Accept-Encoding` (handled automatically by the platform)\n *\n * @param vary Array of normalized Vary header names.\n * @returns Array of headers used for computing cache variations.\n */\nexport function filterVaryHeader(vary: string[]): string[] {\n    return vary\n        .map((h) => h.toLowerCase())\n        .filter((value) => value !== HttpHeader.ACCEPT_ENCODING.toLowerCase());\n}\n\n/**\n * Generates a Vary-aware cache key for a request.\n *\n * The key is based on:\n * 1. The provided `key` URL, which is normalized by default but can be fully customized\n *    by the caller. For example, users can:\n *      - Sort query parameters\n *      - Remove the search/query string entirely\n *      - Exclude certain query parameters\n *    This allows full control over how this cache key is generated.\n * 2. The request headers listed in `vary` (after filtering and lowercasing).\n *\n * Behavior:\n * - Headers in `vary` are sorted and included in the key.\n * - The combination of the key URL and header values is base64-encoded to produce\n *   a safe cache key.\n * - The resulting string is returned as an absolute URL rooted at `VARY_CACHE_URL`.\n *\n * @param request The Request object to generate a key for.\n * @param vary Array of header names from the `Vary` header that affect caching.\n * @param key The cache key to be used for this request. Can be modified by the caller for\n *            custom cache key behavior.\n * @returns A string URL representing a unique cache key for this request + Vary headers.\n */\nexport function getVaryKey(request: Request, vary: string[], key: URL): string {\n    const varyPairs: [string, string][] = [];\n    const filtered = filterVaryHeader(vary);\n\n    filtered.sort(lexCompare);\n    for (const header of filtered) {\n        const value = request.headers.get(header);\n        if (value !== null) {\n            varyPairs.push([header, value]);\n        }\n    }\n\n    const encoded = base64UrlEncode(JSON.stringify([key.toString(), varyPairs]));\n    return new URL(encoded, VARY_CACHE_URL).href;\n}\n\n/**\n * Encodes a string as URL-safe Base64.\n * - Converts to UTF-8 bytes\n * - Base64-encodes\n * - Replaces `+` with `-` and `/` with `_`\n * - Removes trailing `=`\n *\n * @param str The input string to encode.\n * @returns URL-safe Base64 string.\n */\nexport function base64UrlEncode(str: string): string {\n    const utf8 = new TextEncoder().encode(str);\n    let binary = \"\";\n    for (const byte of utf8) {\n        binary += String.fromCodePoint(byte);\n    }\n    return btoa(binary)\n        .replaceAll(\"+\", \"-\")\n        .replaceAll(\"/\", \"_\")\n        .replace(/={1,2}$/, \"\");\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 { Middleware } from \"../middleware\";\nimport { Worker } from \"../../interfaces/worker\";\nimport { GET } from \"../../constants/methods\";\nimport { assertCacheName, assertGetKey, assertKey } from \"../../guards/cache\";\nimport { filterVaryHeader, getVaryHeader, getVaryKey, isCacheable } from \"./utils\";\nimport { lexCompare } from \"../../utils/compare\";\n\n/**\n * Creates a Vary-aware caching middleware for Workers.\n *\n * This middleware:\n * - Caches `GET` requests **only**.\n * - Respects the `Vary` header of responses, ensuring that requests\n *   with different headers (e.g., `Origin`) receive the correct cached response.\n * - Skips caching for non-cacheable responses (e.g., error responses or\n *   responses with `Vary: *`).\n *\n * @param cacheName Optional name of the cache to use. If omitted, the default cache is used.\n * @param getKey Optional function to compute a custom cache key from a request.\n *               If omitted, the request URL is normalized and used as the key.\n * @returns A `Middleware` instance that can be used in a Worker pipeline.\n */\nexport function cache(cacheName?: string, getKey?: (request: Request) => URL): Middleware {\n    assertCacheName(cacheName);\n    assertGetKey(getKey);\n\n    return new CacheHandler(cacheName, getKey);\n}\n\n/**\n * Returns a new URL with its query parameters sorted into a stable order.\n *\n * This is used for cache key generation: URLs that differ only in the\n * order of their query parameters will normalize to the same key.\n *\n * @param request - The incoming Request whose URL will be normalized.\n * @returns A new URL with query parameters sorted by name.\n */\nexport function sortSearchParams(request: Request): URL {\n    const url = new URL(request.url);\n    const sorted = new URLSearchParams(\n        [...url.searchParams.entries()].sort(([a], [b]) => lexCompare(a, b)),\n    );\n    url.search = sorted.toString();\n    url.hash = \"\";\n    return url;\n}\n\n/**\n * Returns a new URL with all query parameters removed.\n *\n * This is used when query parameters are not relevant to cache lookups,\n * ensuring that variants of the same resource share a single cache entry.\n *\n * @param request - The incoming Request whose URL will be normalized.\n * @returns A new URL with no query parameters.\n */\nexport function stripSearchParams(request: Request): URL {\n    const url = new URL(request.url);\n    url.search = \"\";\n    url.hash = \"\";\n    return url;\n}\n\n/**\n * Cache Middleware Implementation\n * @see {@link cache}\n */\nclass CacheHandler extends Middleware {\n    constructor(\n        private readonly cacheName?: string,\n        private readonly getKey?: (request: Request) => URL,\n    ) {\n        super();\n        this.cacheName = cacheName?.trim() || undefined;\n    }\n\n    /**\n     * Handles an incoming request.\n     * - Bypasses caching for non-`GET` requests.\n     * - Checks the cache for a stored response.\n     * - Calls next if no cached response exists.\n     * - Caches the response if it is cacheable.\n     *\n     * @param worker The Worker instance containing the request and context.\n     * @param next Function to call the next middleware or origin fetch.\n     * @returns A cached or freshly fetched Response.\n     */\n    public override async handle(worker: Worker, next: () => Promise<Response>): Promise<Response> {\n        if (worker.request.method !== GET) {\n            return next();\n        }\n\n        const cache = this.cacheName ? await caches.open(this.cacheName) : caches.default;\n        const cached = await this.getCached(cache, worker.request);\n        if (cached) return cached;\n\n        const response = await next();\n\n        this.setCached(cache, worker, response);\n        return response;\n    }\n\n    /**\n     * Retrieves a cached response for a given request.\n     * - Checks both the base cache key and any Vary-specific keys.\n     *\n     * @param cache The Cache object to check.\n     * @param request The request to retrieve a cached response for.\n     * @returns A cached Response if available, otherwise `undefined`.\n     */\n    public async getCached(cache: Cache, request: Request): Promise<Response | undefined> {\n        const url = this.getCacheKey(request);\n        const response = await cache.match(url);\n        if (!response) return;\n\n        const vary = this.getFilteredVary(response);\n        if (vary.length === 0) return response;\n\n        const key = getVaryKey(request, vary, url);\n        return cache.match(key);\n    }\n\n    /**\n     * Caches a response if it is cacheable.\n     *\n     * Behavior:\n     * - Always stores the response under the main cache key. This ensures that\n     *   the response’s Vary headers are available for later cache lookups.\n     * - If the response varies based on certain request headers (per the Vary header),\n     *   also stores a copy under a Vary-specific cache key so future requests\n     *   with matching headers can retrieve the correct response.\n     *\n     * @param cache The Cache object to store the response in.\n     * @param worker The Worker instance containing the request and context.\n     * @param response The Response to cache.\n     */\n    public async setCached(cache: Cache, worker: Worker, response: Response): Promise<void> {\n        if (!isCacheable(response)) return;\n\n        const url = this.getCacheKey(worker.request);\n\n        // Always store the main cache entry to preserve Vary headers\n        worker.ctx.waitUntil(cache.put(url, response.clone()));\n\n        // Store request-specific cache entry if the response varies\n        const vary = this.getFilteredVary(response);\n        if (vary.length > 0) {\n            worker.ctx.waitUntil(\n                cache.put(getVaryKey(worker.request, vary, url), response.clone()),\n            );\n        }\n    }\n\n    /**\n     * Extracts and filters the `Vary` header from a response.\n     *\n     * @param response - The HTTP response to inspect.\n     * @returns An array of filtered header names from the `Vary` header.\n     */\n    public getFilteredVary(response: Response): string[] {\n        return filterVaryHeader(getVaryHeader(response));\n    }\n\n    /**\n     * Returns the cache key for a request.\n     *\n     * By default, this is a normalized URL including the path and query string.\n     * However, users can provide a custom `getKey` function when creating the\n     * `cache` middleware to fully control how the cache keys are generated.\n     *\n     * For example, a custom function could:\n     *  - Sort or remove query parameters\n     *  - Exclude the search/query string entirely\n     *  - Modify the path or host\n     *\n     * This allows complete flexibility over cache key generation.\n     *\n     * @param request The Request object to generate a cache key for.\n     * @returns A URL representing the main cache key for this request.\n     */\n    public getCacheKey(request: Request): URL {\n        const key = this.getKey ? this.getKey(request) : sortSearchParams(request);\n        assertKey(key);\n\n        key.hash = \"\";\n        return key;\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 \"../constants/methods\";\nimport { isString } from \"./basic\";\n\n/**\n * A set containing all supported HTTP methods.\n *\n * Useful for runtime checks like validating request methods.\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: unknown): value is Method {\n    return isString(value) && METHOD_SET.has(value);\n}\n\n/**\n * Checks if a value is an array of valid HTTP methods.\n *\n * Each element is verified using the `isMethod` type guard.\n *\n * @param value - The value to check.\n * @returns `true` if `value` is an array and every element is a valid `Method`, otherwise `false`.\n */\nexport function isMethodArray(value: unknown): value is Method[] {\n    return Array.isArray(value) && value.every(isMethod);\n}\n\n/**\n * Asserts that a value is an array of valid HTTP methods.\n *\n * This function uses {@link isMethodArray} to validate the input. If the\n * value is not an array of `Method` elements, it throws a `TypeError`.\n * Otherwise, TypeScript will narrow the type of `value` to `Method[]`\n * within the calling scope.\n *\n * @param value - The value to check.\n * @throws TypeError If `value` is not a valid method array.\n */\nexport function assertMethods(value: unknown): asserts value is Method[] {\n    if (!isMethodArray(value)) {\n        const desc = Array.isArray(value) ? JSON.stringify(value) : String(value);\n        throw new TypeError(`Invalid method array: ${desc}`);\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 { CacheControl } from \"./constants/cache\";\nimport { setHeader, mergeHeader, filterHeaders } from \"./utils/headers\";\nimport { UTF8_CHARSET, MediaType } from \"./constants/media\";\nimport { FORBIDDEN_204_HEADERS, FORBIDDEN_304_HEADERS, HttpHeader } from \"./constants/headers\";\nimport { OctetStreamInit } from \"./interfaces/response\";\nimport { withCharset } from \"./utils/media\";\nimport { assertOctetStreamInit } from \"./guards/responses\";\n\n/**\n * Base class for building HTTP responses.\n * Manages headers, status, and media type.\n */\nabstract class BaseResponse {\n    /** HTTP headers for the response. */\n    public headers: Headers = new Headers();\n\n    /** HTTP status code (default 200 OK). */\n    public status: StatusCodes = StatusCodes.OK;\n\n    /** Optional status text. Defaults to standard reason phrase. */\n    public statusText?: string;\n\n    /** Enable websocket responses. */\n    public webSocket: WebSocket | null = null;\n\n    /** Default media type of the response body. */\n    public mediaType: string = withCharset(MediaType.PLAIN_TEXT, UTF8_CHARSET);\n\n    /** Converts current state to ResponseInit for constructing a Response. */\n    protected get responseInit(): ResponseInit {\n        return {\n            headers: this.headers,\n            status: this.status,\n            statusText: this.statusText ?? getReasonPhrase(this.status),\n            webSocket: this.webSocket,\n            encodeBody: \"automatic\",\n        };\n    }\n\n    /** Sets a header, overwriting any existing value. */\n    public setHeader(key: string, value: string | string[]): void {\n        setHeader(this.headers, key, value);\n    }\n\n    /** Merges a header with existing values (does not overwrite). */\n    public mergeHeader(key: string, value: string | string[]): void {\n        mergeHeader(this.headers, key, value);\n    }\n\n    /** Adds a Content-Type header if not already existing (does not overwrite). */\n    public addContentType() {\n        if (!this.headers.get(HttpHeader.CONTENT_TYPE)) {\n            this.setHeader(HttpHeader.CONTENT_TYPE, this.mediaType);\n        }\n    }\n\n    /**\n     * Removes headers that are disallowed or discouraged based on the current\n     * status code.\n     *\n     * - **204 No Content:** strips headers that \"should not\" be sent\n     *   (`Content-Length`, `Content-Range`), per the HTTP spec.\n     * - **304 Not Modified:** strips headers that \"must not\" be sent\n     *   (`Content-Type`, `Content-Length`, `Content-Range`, etc.), per the HTTP spec.\n     *\n     * This ensures that responses remain compliant with HTTP/1.1 standards while preserving\n     * custom headers that are allowed.\n     */\n    public filterHeaders(): void {\n        if (this.status === StatusCodes.NO_CONTENT) {\n            filterHeaders(this.headers, FORBIDDEN_204_HEADERS);\n        } else if (this.status === StatusCodes.NOT_MODIFIED) {\n            filterHeaders(this.headers, FORBIDDEN_304_HEADERS);\n        }\n    }\n}\n\n/**\n * Base response class that adds caching headers.\n */\nabstract class CacheResponse extends BaseResponse {\n    constructor(public cache?: CacheControl) {\n        super();\n    }\n\n    /** Adds Cache-Control header if caching is configured. */\n    protected addCacheHeader(): void {\n        if (this.cache) {\n            this.setHeader(HttpHeader.CACHE_CONTROL, CacheControl.stringify(this.cache));\n        }\n    }\n}\n\n/**\n * Core response. Combines caching, and content type headers.\n */\nexport abstract class WorkerResponse extends CacheResponse {\n    constructor(\n        private readonly body: BodyInit | null = null,\n        cache?: CacheControl,\n    ) {\n        super(cache);\n    }\n\n    /** Builds the Response with body, headers, and status. */\n    public async response(): Promise<Response> {\n        this.addCacheHeader();\n\n        const body = [StatusCodes.NO_CONTENT, StatusCodes.NOT_MODIFIED].includes(this.status)\n            ? null\n            : this.body;\n\n        if (body) this.addContentType();\n\n        this.filterHeaders();\n\n        return new Response(body, this.responseInit);\n    }\n}\n\n/**\n * Wraps an existing Response and clones its body, headers, and status.\n */\nexport class ClonedResponse extends WorkerResponse {\n    constructor(response: Response, cache?: CacheControl) {\n        const clone = response.clone();\n        super(clone.body, cache);\n        this.headers = new Headers(clone.headers);\n        this.status = clone.status;\n        this.statusText = clone.statusText;\n    }\n}\n\n/**\n * Represents a successful response with customizable body, cache and status.\n */\nexport class SuccessResponse extends WorkerResponse {\n    constructor(\n        body: BodyInit | null = null,\n        cache?: CacheControl,\n        status: StatusCodes = StatusCodes.OK,\n    ) {\n        super(body, cache);\n        this.status = status;\n    }\n}\n\n/**\n * JSON response. Automatically sets Content-Type to application/json.\n */\nexport class JsonResponse extends SuccessResponse {\n    constructor(json: unknown = {}, cache?: CacheControl, status: StatusCodes = StatusCodes.OK) {\n        super(JSON.stringify(json), cache, status);\n        this.mediaType = withCharset(MediaType.JSON, UTF8_CHARSET);\n    }\n}\n\n/**\n * HTML response. Automatically sets Content-Type to text/html.\n */\nexport class HtmlResponse extends SuccessResponse {\n    constructor(\n        body: string,\n        cache?: CacheControl,\n        status: StatusCodes = StatusCodes.OK,\n        charset: string = UTF8_CHARSET,\n    ) {\n        super(body, cache, status);\n        this.mediaType = withCharset(MediaType.HTML, charset);\n    }\n}\n\n/**\n * Plain text response. Automatically sets Content-Type to text/plain.\n */\nexport class TextResponse extends SuccessResponse {\n    constructor(\n        body: string,\n        cache?: CacheControl,\n        status: StatusCodes = StatusCodes.OK,\n        charset: string = UTF8_CHARSET,\n    ) {\n        super(body, cache, status);\n        this.mediaType = withCharset(MediaType.PLAIN_TEXT, charset);\n    }\n}\n\n/**\n * Represents an HTTP response for serving binary data as `application/octet-stream`.\n *\n * This class validates the provided `OctetStreamInit` configuration and\n * automatically sets the correct HTTP headers for either a full or partial\n * content response.\n *\n * Behavior:\n * - Always sets `Content-Type` to `application/octet-stream`.\n * - Always sets `Accept-Ranges: bytes`.\n * - Always sets `Content-Length` to the validated length of the response body.\n * - If either `offset` or `length` is provided and the size is non-zero, the response\n *   is treated as partial content (`206 Partial Content`) and a `Content-Range` header\n *   is added, even if the specified range spans the entire file.\n * - Special case: a requested range of `0-0` on a non-empty file returns 1 byte.\n * - Zero-length streams (`size = 0`) are never treated as partial content.\n */\nexport class OctetStream extends WorkerResponse {\n    constructor(stream: ReadableStream, init: OctetStreamInit, cache?: CacheControl) {\n        assertOctetStreamInit(init);\n\n        super(stream, cache);\n        this.mediaType = MediaType.OCTET_STREAM;\n\n        const { size, offset, length } = OctetStream.normalizeInit(init);\n\n        if (OctetStream.isPartial(init)) {\n            this.setHeader(\n                HttpHeader.CONTENT_RANGE,\n                `bytes ${offset}-${offset + length - 1}/${size}`,\n            );\n            this.status = StatusCodes.PARTIAL_CONTENT;\n        }\n\n        this.setHeader(HttpHeader.ACCEPT_RANGES, \"bytes\");\n        this.setHeader(HttpHeader.CONTENT_LENGTH, `${length}`);\n    }\n\n    /**\n     * Returns a fully specified `OctetStreamInit` with all fields set.\n     *\n     * Fills in defaults for any missing values:\n     * - `offset` defaults to 0\n     * - `length` defaults to `size - offset`\n     * - If `offset` and `length` are both 0 but `size > 0`, `length` is set to 1\n     *\n     * @param init - Partial or complete OctetStreamInit\n     * @returns An object with `size`, `offset`, and `length` guaranteed\n     */\n    private static normalizeInit(init: OctetStreamInit): Required<OctetStreamInit> {\n        const { size } = init;\n        const offset = init.offset ?? 0;\n        let length = init.length ?? size - offset;\n\n        if (offset === 0 && length === 0 && size > 0) {\n            length = 1;\n        }\n\n        return { size, offset, length };\n    }\n\n    /**\n     * Returns true if the given `OctetStreamInit` represents a partial range.\n     *\n     * A partial range is any init with an explicit `offset` or `length`, provided\n     * the stream size is greater than zero.\n     *\n     * @param init - The OctetStreamInit to check.\n     * @returns `true` if partial, `false` otherwise.\n     */\n    private static isPartial(init: OctetStreamInit): boolean {\n        if (init.size === 0) return false;\n        return init.offset !== undefined || init.length !== undefined;\n    }\n}\n\n/**\n * A streaming response for Cloudflare R2 objects.\n *\n * @param source - The R2 object to stream.\n * @param cache - Optional caching information.\n */\nexport class R2ObjectStream extends OctetStream {\n    constructor(source: R2ObjectBody, cache?: CacheControl) {\n        let useCache = cache;\n        if (!useCache && source.httpMetadata?.cacheControl) {\n            useCache = CacheControl.parse(source.httpMetadata.cacheControl);\n        }\n\n        super(source.body, R2ObjectStream.computeRange(source.size, source.range), useCache);\n\n        this.setHeader(HttpHeader.ETAG, source.httpEtag);\n\n        if (source.httpMetadata?.contentType) {\n            this.mediaType = source.httpMetadata.contentType;\n        }\n    }\n\n    /**\n     * Computes an `OctetStreamInit` object from a given R2 range.\n     *\n     * This function normalizes a Cloudflare R2 `R2Range` into the shape expected\n     * by `OctetStream`. It handles the following cases:\n     *\n     * - No range provided → returns `{ size }` (full content).\n     * - `suffix` range → calculates the offset and length from the end of the file.\n     * - Explicit `offset` and/or `length` → passed through as-is.\n     *\n     * @param size - The total size of the file/object.\n     * @param range - Optional range to extract (from R2). Can be:\n     *   - `{ offset: number; length?: number }`\n     *   - `{ offset?: number; length: number }`\n     *   - `{ suffix: number }`\n     * @returns An `OctetStreamInit` object suitable for `OctetStream`.\n     */\n    private static computeRange(size: number, range?: R2Range): OctetStreamInit {\n        if (!range) return { size };\n\n        if (\"suffix\" in range) {\n            const offset = Math.max(0, size - range.suffix);\n            const length = size - offset;\n            return { size, offset, length };\n        }\n\n        return { size, ...range };\n    }\n}\n\n/**\n * Response for WebSocket upgrade requests.\n * Automatically sets status to 101 and attaches the client socket.\n */\nexport class WebSocketUpgrade extends WorkerResponse {\n    constructor(client: WebSocket) {\n        super(null);\n        this.status = StatusCodes.SWITCHING_PROTOCOLS;\n        this.webSocket = client;\n    }\n}\n\n/**\n * Response for `HEAD` requests. Copy headers and status from a `GET` response\n * without the body.\n */\nexport class Head extends WorkerResponse {\n    constructor(get: Response) {\n        super();\n        this.status = get.status;\n        this.statusText = get.statusText;\n        this.headers = new Headers(get.headers);\n    }\n}\n\n/**\n * Response for `OPTIONS` preflight requests.\n */\nexport class Options extends WorkerResponse {\n    constructor() {\n        super();\n        this.status = StatusCodes.NO_CONTENT;\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\nexport const UTF8_CHARSET = \"utf-8\";\n\n/**\n * Internal media types.\n */\nexport enum MediaType {\n    PLAIN_TEXT = \"text/plain\",\n    HTML = \"text/html\",\n    JSON = \"application/json\",\n    OCTET_STREAM = \"application/octet-stream\",\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\n/**\n * Appends a charset parameter to a given media type string,\n * avoiding duplicates and ignoring empty charsets.\n *\n * @param {string} mediaType - The MIME type (e.g., \"text/html\").\n * @param {string} charset - The character set to append (e.g., \"utf-8\").\n * @returns {string} The media type with charset appended if provided.\n */\nexport function withCharset(mediaType: string, charset: string): string {\n    if (!charset || mediaType.toLowerCase().includes(\"charset=\")) {\n        return mediaType;\n    }\n    return `${mediaType}; charset=${charset.toLowerCase()}`;\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 { OctetStreamInit } from \"../interfaces\";\nimport { isNumber } from \"./basic\";\n\n/**\n * Asserts that a given value is a valid `OctetStreamInit` object.\n *\n * Properties:\n * - `size` (required): must be a non-negative number.\n * - `offset` (optional): if provided, must be a number between 0 and `size`.\n * - `length` (optional): if provided, must be a non-negative number such that `offset + length <= size`.\n *\n * If `offset` or `length` are `undefined`, they are considered as `0` and `size` respectively.\n *\n * Throws an error if validation fails.\n *\n * Acts as a TypeScript type predicate, so after calling it, `value` is narrowed to `OctetStreamInit`.\n *\n * @param value - The value to validate as `OctetStreamInit`.\n * @throws {TypeError} If the value is not a non-null object.\n * @throws {RangeError} If `size`, `offset`, or `length` are invalid.\n * @returns `true` if the value is a valid `OctetStreamInit`.\n */\nexport function assertOctetStreamInit(value: unknown): asserts value is OctetStreamInit {\n    if (typeof value !== \"object\" || value === null) {\n        throw new TypeError(\"OctetStreamInit must be an object.\");\n    }\n\n    const obj = value as Record<string, unknown>;\n\n    // size\n    const size = obj[\"size\"];\n    if (!isNumber(size) || size < 0 || !Number.isInteger(size)) {\n        throw new RangeError(\n            `OctetStreamInit.size must be a non-negative integer (size=${JSON.stringify(size)}).`,\n        );\n    }\n\n    // offset\n    const offset = obj[\"offset\"] ?? 0;\n    if (!isNumber(offset) || offset < 0 || offset > size || !Number.isInteger(offset)) {\n        throw new RangeError(\n            `OctetStreamInit.offset must be a non-negative integer less than or equal to size (size=${JSON.stringify(size)}, offset=${JSON.stringify(offset)}).`,\n        );\n    }\n\n    // length\n    const length = obj[\"length\"] ?? size - offset;\n    if (!isNumber(length) || length < 0 || offset + length > size || !Number.isInteger(length)) {\n        throw new RangeError(\n            `OctetStreamInit.length must be a non-negative integer less than or equal to size - offset (size=${JSON.stringify(size)}, offset=${JSON.stringify(offset)}, length=${JSON.stringify(length)}).`,\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 { StatusCodes } from \"../../constants\";\nimport { HttpHeader } from \"../../constants/headers\";\nimport { GET, HEAD, Method, OPTIONS } from \"../../constants/methods\";\nimport { Time } from \"../../constants/time\";\nimport { CorsConfig } from \"../../interfaces/cors\";\n\nexport const ALLOW_ALL_ORIGINS = \"*\";\n\n/**\n * Set of HTTP methods considered \"simple\" under the `CORS` specification.\n *\n * Simple methods do not trigger a preflight request on their own.\n * (Other factors like headers can still cause a preflight.)\n */\nexport const SIMPLE_METHODS = new Set<Method>([GET, HEAD, OPTIONS]);\n\n/**\n * Status codes for which `CORS` should be skipped.\n *\n * Skips `CORS` for:\n * - 101 Switching Protocols (WebSocket upgrade)\n * - 100 Continue\n * - 3xx Redirects (`CORS` is applied to the final URL only)\n */\nexport const SKIP_CORS_STATUSES = [\n    StatusCodes.SWITCHING_PROTOCOLS,\n    StatusCodes.CONTINUE,\n    StatusCodes.PROCESSING,\n    StatusCodes.EARLY_HINTS,\n    StatusCodes.MOVED_PERMANENTLY,\n    StatusCodes.MOVED_TEMPORARILY,\n    StatusCodes.SEE_OTHER,\n    StatusCodes.TEMPORARY_REDIRECT,\n    StatusCodes.PERMANENT_REDIRECT,\n];\n\n/**\n * Default configuration for`CORS`middleware.\n */\nexport const defaultCorsConfig: CorsConfig = {\n    allowedOrigins: [ALLOW_ALL_ORIGINS],\n    allowedHeaders: [HttpHeader.CONTENT_TYPE],\n    exposedHeaders: [],\n    allowCredentials: false,\n    maxAge: 5 * Time.Minute,\n} as const;\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 { HttpHeader } from \"../../constants/headers\";\nimport { assertMethods } from \"../../guards/methods\";\nimport { CorsConfig } from \"../../interfaces/cors\";\nimport { Worker } from \"../../interfaces/worker\";\nimport { ClonedResponse, Options } from \"../../responses\";\nimport { mergeHeader, setHeader } from \"../../utils/headers\";\nimport { ALLOW_ALL_ORIGINS, SIMPLE_METHODS, SKIP_CORS_STATUSES } from \"./constants\";\n\n/**\n * Handles a `CORS` preflight `OPTIONS` request.\n *\n * Sets the appropriate`CORS`headers based on the provided configuration\n * and the origin of the request.\n *\n * @param worker - The Worker handling the request.\n * @param cors - The `CORS` configuration.\n * @returns A Response object for the preflight request.\n */\nexport async function options(worker: Worker, cors: CorsConfig): Promise<Response> {\n    const options = new Options();\n    const origin = getOrigin(worker.request);\n\n    if (origin) {\n        setAllowOrigin(options.headers, cors, origin);\n        setAllowCredentials(options.headers, cors, origin);\n    }\n\n    setAllowMethods(options.headers, worker);\n    setAllowHeaders(options.headers, cors);\n    setMaxAge(options.headers, cors);\n\n    return options.response();\n}\n\n/**\n * Applies`CORS`headers to an existing response.\n *\n * Useful for normal (non-preflight) responses where the response\n * should include`CORS`headers based on the request origin.\n *\n * @param response - The original Response object.\n * @param worker - The Worker handling the request.\n * @param cors - The`CORS`configuration.\n * @returns A new Response object with`CORS`headers applied.\n */\nexport async function apply(\n    response: Response,\n    worker: Worker,\n    cors: CorsConfig,\n): Promise<Response> {\n    const clone = new ClonedResponse(response);\n    const origin = getOrigin(worker.request);\n\n    deleteCorsHeaders(clone.headers);\n\n    if (origin) {\n        setAllowOrigin(clone.headers, cors, origin);\n        setAllowCredentials(clone.headers, cors, origin);\n        setExposedHeaders(clone.headers, cors);\n    }\n\n    return clone.response();\n}\n\n/**\n * Sets the Access-Control-Allow-Origin header based on the`CORS`config\n * and request origin.\n *\n * @param headers - The headers object to modify.\n * @param cors - The`CORS`configuration.\n * @param origin - The request's origin, or null if not present.\n */\nexport function setAllowOrigin(headers: Headers, cors: CorsConfig, origin: string): void {\n    if (allowAllOrigins(cors)) {\n        setHeader(headers, HttpHeader.ACCESS_CONTROL_ALLOW_ORIGIN, ALLOW_ALL_ORIGINS);\n    } else {\n        if (cors.allowedOrigins.includes(origin)) {\n            setHeader(headers, HttpHeader.ACCESS_CONTROL_ALLOW_ORIGIN, origin);\n        }\n        mergeHeader(headers, HttpHeader.VARY, HttpHeader.ORIGIN);\n    }\n}\n\n/**\n * Conditionally sets the `Access-Control-Allow-Credentials` header\n * for a`CORS`response.\n *\n * This header is only set if:\n * 1. `cors.allowCredentials` is true,\n * 2. The configuration does **not** allow any origin (`*`), and\n * 3. The provided `origin` is explicitly listed in `cors.allowedOrigins`.\n *\n * @param headers - The Headers object to modify.\n * @param cors - The`CORS`configuration.\n * @param origin - The origin of the incoming request.\n */\nexport function setAllowCredentials(headers: Headers, cors: CorsConfig, origin: string): void {\n    if (!cors.allowCredentials) return;\n    if (allowAllOrigins(cors)) return;\n    if (!cors.allowedOrigins.includes(origin)) return;\n\n    setHeader(headers, HttpHeader.ACCESS_CONTROL_ALLOW_CREDENTIALS, \"true\");\n}\n\n/**\n * Sets the `Access-Control-Allow-Methods` header for a`CORS`response,\n * but only for non-simple methods.\n *\n * Simple methods (`GET`, `HEAD`, `OPTIONS`) are automatically allowed by the\n *`CORS`spec, so this function only adds methods beyond those.\n *\n * @param headers - The Headers object to modify.\n * @param worker - The Worker instance used to retrieve allowed methods.\n */\nexport function setAllowMethods(headers: Headers, worker: Worker): void {\n    const methods = worker.getAllowedMethods();\n    assertMethods(methods);\n\n    const allowed = methods.filter((method) => !SIMPLE_METHODS.has(method));\n\n    if (allowed.length > 0) {\n        setHeader(headers, HttpHeader.ACCESS_CONTROL_ALLOW_METHODS, allowed);\n    }\n}\n\n/**\n * Sets the `Access-Control-Max-Age` header for a`CORS`response.\n *\n * This header indicates how long the results of a preflight request\n * can be cached by the client (in seconds).\n *\n * The value is **clamped to a non-negative integer** to comply with\n * the`CORS`specification:\n * - Decimal values are floored to the nearest integer.\n * - Negative values are treated as `0`.\n *\n * @param headers - The Headers object to modify.\n * @param cors - The`CORS`configuration containing the `maxAge` value in seconds.\n */\nexport function setMaxAge(headers: Headers, cors: CorsConfig): void {\n    const maxAge = Math.max(0, Math.floor(cors.maxAge));\n    setHeader(headers, HttpHeader.ACCESS_CONTROL_MAX_AGE, String(maxAge));\n}\n\n/**\n * Sets the Access-Control-Allow-Headers header based on the`CORS`configuration.\n *\n * Only the headers explicitly listed in `cors.allowedHeaders` are sent.\n * If the array is empty, no Access-Control-Allow-Headers header is added.\n *\n * @param headers - The Headers object to modify.\n * @param cors - The`CORS`configuration.\n */\nexport function setAllowHeaders(headers: Headers, cors: CorsConfig): void {\n    if (cors.allowedHeaders.length > 0) {\n        setHeader(headers, HttpHeader.ACCESS_CONTROL_ALLOW_HEADERS, cors.allowedHeaders);\n    }\n}\n\n/**\n * Sets the Access-Control-Expose-Headers header for a response.\n *\n * @param headers - The headers object to modify.\n * @param cors - The`CORS`configuration.\n */\nexport function setExposedHeaders(headers: Headers, cors: CorsConfig): void {\n    setHeader(headers, HttpHeader.ACCESS_CONTROL_EXPOSE_HEADERS, cors.exposedHeaders);\n}\n\n/**\n * Returns true if the`CORS`config allows all origins ('*').\n *\n * @param cors - The`CORS`configuration.\n */\nexport function allowAllOrigins(cors: CorsConfig): boolean {\n    return cors.allowedOrigins.includes(ALLOW_ALL_ORIGINS);\n}\n\n/**\n * Deletes any existing`CORS`headers from the provided headers object.\n *\n * @param headers - The headers object to modify.\n */\nexport function deleteCorsHeaders(headers: Headers): void {\n    headers.delete(HttpHeader.ACCESS_CONTROL_MAX_AGE);\n    headers.delete(HttpHeader.ACCESS_CONTROL_ALLOW_ORIGIN);\n    headers.delete(HttpHeader.ACCESS_CONTROL_ALLOW_HEADERS);\n    headers.delete(HttpHeader.ACCESS_CONTROL_ALLOW_METHODS);\n    headers.delete(HttpHeader.ACCESS_CONTROL_EXPOSE_HEADERS);\n    headers.delete(HttpHeader.ACCESS_CONTROL_ALLOW_CREDENTIALS);\n}\n\n/**\n * Determines whether`CORS`headers should be skipped for a response.\n *\n * @param response - The Response object to inspect\n * @returns `true` if`CORS`should be skipped, `false` otherwise\n */\nexport function skipCors(response: Response): boolean {\n    const { status, headers } = response;\n    if (SKIP_CORS_STATUSES.includes(status)) return true;\n    if (headers.has(HttpHeader.UPGRADE)) return true;\n\n    return false;\n}\n\n/**\n * Extracts and normalizes the `Origin` header from a request.\n *\n * Returns the origin (scheme + host + port) as a string if present and valid.\n * Returns `null` if:\n *   - The `Origin` header is missing\n *   - The `Origin` header is `\"null\"` (opaque origin)\n *   - The `Origin` header is malformed\n *\n * @param request - The incoming {@link Request} object.\n * @returns The normalized origin string, or `null` if not present or invalid.\n */\nexport function getOrigin(request: Request): string | null {\n    const origin = request.headers.get(HttpHeader.ORIGIN)?.trim();\n    if (!origin || origin === \"null\") return null;\n\n    try {\n        return new URL(origin).origin;\n    } catch {\n        return null;\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 { CorsInit } from \"../interfaces/cors\";\nimport { isBoolean, isNumber, isStringArray } from \"./basic\";\n\n/**\n * Throws if the given value is not a valid CorsInit.\n *\n * Checks only the fields that are present, since CorsInit is Partial<CorsConfig>.\n *\n * @param value - The value to check.\n */\nexport function assertCorsInit(value: unknown): asserts value is CorsInit {\n    if (value === undefined) return;\n\n    if (typeof value !== \"object\" || value === null) {\n        throw new TypeError(\"CorsInit must be an object.\");\n    }\n\n    const obj = value as Record<string, unknown>;\n\n    if (obj[\"allowedOrigins\"] !== undefined && !isStringArray(obj[\"allowedOrigins\"])) {\n        throw new TypeError(\"CorsInit.allowedOrigins must be a string array.\");\n    }\n\n    if (obj[\"allowedHeaders\"] !== undefined && !isStringArray(obj[\"allowedHeaders\"])) {\n        throw new TypeError(\"CorsInit.allowedHeaders must be a string array.\");\n    }\n\n    if (obj[\"exposedHeaders\"] !== undefined && !isStringArray(obj[\"exposedHeaders\"])) {\n        throw new TypeError(\"CorsInit.exposedHeaders must be a string array.\");\n    }\n\n    if (obj[\"allowCredentials\"] !== undefined && !isBoolean(obj[\"allowCredentials\"])) {\n        throw new TypeError(\"CorsInit.allowCredentials must be a boolean.\");\n    }\n\n    if (obj[\"maxAge\"] !== undefined && !isNumber(obj[\"maxAge\"])) {\n        throw new TypeError(\"CorsInit.maxAge must be a number.\");\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 { apply, options, skipCors } from \"./utils\";\nimport { Worker } from \"../../interfaces/worker\";\nimport { Middleware } from \"../middleware\";\nimport { CorsConfig, CorsInit } from \"../../interfaces/cors\";\nimport { defaultCorsConfig } from \"./constants\";\nimport { OPTIONS } from \"../../constants/methods\";\nimport { assertCorsInit } from \"../../guards/cors\";\n\n/**\n * Creates a`CORS`middleware instance.\n *\n * This middleware automatically handles Cross-Origin Resource Sharing (CORS)\n * for incoming requests, including preflight `OPTIONS` requests, and adds\n * appropriate headers to responses.\n *\n * @param init - Optional configuration for `CORS` behavior. See {@link CorsConfig}.\n * @returns A {@link Middleware} instance that can be used in your middleware chain.\n */\nexport function cors(init?: CorsInit): Middleware {\n    assertCorsInit(init);\n    return new CorsHandler(init);\n}\n\n/**\n * Cors Middleware Implementation\n * @see {@link cors}\n */\nclass CorsHandler extends Middleware {\n    /** The configuration used for this instance, with all defaults applied. */\n    private readonly config: CorsConfig;\n\n    /**\n     * Create a new`CORS`middleware instance.\n     *\n     * @param init - Partial configuration to override the defaults. Any values\n     *               not provided will use `defaultCorsConfig`.\n     */\n    constructor(init?: CorsInit) {\n        super();\n        this.config = { ...defaultCorsConfig, ...init };\n    }\n\n    /**\n     * Applies`CORS`headers to a request.\n     *\n     * - Returns a preflight response for `OPTIONS` requests.\n     * - For other methods, calls `next()` and applies`CORS`headers to the result.\n     *\n     * @param worker - The Worker handling the request.\n     * @param next - Function to invoke the next middleware.\n     * @returns Response with`CORS`headers applied.\n     */\n    public override async handle(worker: Worker, next: () => Promise<Response>): Promise<Response> {\n        if (worker.request.method === OPTIONS) {\n            return options(worker, this.config);\n        }\n\n        const response = await next();\n\n        if (skipCors(response)) return response;\n\n        return apply(response, worker, this.config);\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 { JsonResponse } from \"./responses\";\nimport { ErrorJson } from \"./interfaces/error\";\nimport { Worker } from \"./interfaces/worker\";\nimport { CacheControl } from \"./constants/cache\";\nimport { HttpHeader } from \"./constants/headers\";\nimport { assertMethods } from \"./guards/methods\";\nimport { WS_VERSION } from \"./constants/websocket\";\n\n/**\n * Generic HTTP error response.\n * Sends a JSON body with status, error message, and details.\n */\nexport class HttpError extends JsonResponse {\n    /**\n     * @param worker The worker handling the request.\n     * @param status HTTP status code.\n     * @param details Optional detailed error message.\n     */\n    constructor(\n        status: StatusCodes,\n        protected readonly details?: string,\n    ) {\n        const json: ErrorJson = {\n            status,\n            error: getReasonPhrase(status),\n            details: details ?? \"\",\n        };\n        super(json, CacheControl.DISABLE, status);\n    }\n}\n\n/** 400 Bad Request error response. */\nexport class BadRequest extends HttpError {\n    constructor(details?: string) {\n        super(StatusCodes.BAD_REQUEST, details);\n    }\n}\n\n/** 401 Unauthorized error response. */\nexport class Unauthorized extends HttpError {\n    constructor(details?: string) {\n        super(StatusCodes.UNAUTHORIZED, details);\n    }\n}\n\n/** 403 Forbidden error response. */\nexport class Forbidden extends HttpError {\n    constructor(details?: string) {\n        super(StatusCodes.FORBIDDEN, details);\n    }\n}\n\n/** 404 Not Found error response. */\nexport class NotFound extends HttpError {\n    constructor(details?: string) {\n        super(StatusCodes.NOT_FOUND, details);\n    }\n}\n\n/** 405 Method Not Allowed error response. */\nexport class MethodNotAllowed extends HttpError {\n    constructor(worker: Worker) {\n        const methods = worker.getAllowedMethods();\n        assertMethods(methods);\n\n        super(StatusCodes.METHOD_NOT_ALLOWED, `${worker.request.method} method not allowed.`);\n        this.setHeader(HttpHeader.ALLOW, methods);\n    }\n}\n\n/** 426 Upgrade Required error response. */\nexport class UpgradeRequired extends HttpError {\n    constructor() {\n        super(StatusCodes.UPGRADE_REQUIRED);\n        this.headers.set(HttpHeader.SEC_WEBSOCKET_VERSION, WS_VERSION);\n    }\n}\n\n/** 500 Internal Server Error response. */\nexport class InternalServerError extends HttpError {\n    constructor(details?: string) {\n        super(StatusCodes.INTERNAL_SERVER_ERROR, details);\n    }\n}\n\n/** 501 Not Implemented error response. */\nexport class NotImplemented extends HttpError {\n    constructor(details?: string) {\n        super(StatusCodes.NOT_IMPLEMENTED, details);\n    }\n}\n\n/** 501 Method Not Implemented error response for unsupported HTTP methods. */\nexport class MethodNotImplemented extends NotImplemented {\n    constructor(worker: Worker) {\n        super(`${worker.request.method} method not implemented.`);\n    }\n}\n\n/** 503 Service Unavailable error response. */\nexport class ServiceUnavailable extends HttpError {\n    constructor(details?: string) {\n        super(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\n/** WebSocket upgrade header value */\nexport const WS_UPGRADE = \"upgrade\";\n/** WebSocket protocol header value */\nexport const WS_WEBSOCKET = \"websocket\";\n/** WebSocket protocol version */\nexport const WS_VERSION = \"13\";\n/** Max close code a user can send */\nexport const WS_MAX_CLOSE_CODE = 4999;\n/** Max number of reason chars a user can send */\nexport const WS_MAX_REASON_CHARS = 123;\n\n/** WebSocket close codes */\nexport const CloseCode = {\n    NORMAL: 1000,\n    GOING_AWAY: 1001,\n    PROTOCOL_ERROR: 1002,\n    UNSUPPORTED_DATA: 1003,\n    NO_STATUS: 1005,\n    ABNORMAL: 1006,\n    INVALID_PAYLOAD: 1007,\n    POLICY_VIOLATION: 1008,\n    MESSAGE_TOO_BIG: 1009,\n    MISSING_EXTENSION: 1010,\n    INTERNAL_ERROR: 1011,\n    TLS_HANDSHAKE: 1015,\n} as const;\n\n/** WebSocket RESERVED close codes */\nexport const WS_RESERVED_CODES = new Set<number>([\n    CloseCode.NO_STATUS,\n    CloseCode.ABNORMAL,\n    CloseCode.TLS_HANDSHAKE,\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 { HttpHeader } from \"../../constants/headers\";\nimport { WS_UPGRADE, WS_VERSION, WS_WEBSOCKET } from \"../../constants/websocket\";\nimport { getHeaderValues } from \"../../utils/headers\";\n\nexport function hasConnectionHeader(headers: Headers): boolean {\n    return getHeaderValues(headers, HttpHeader.CONNECTION).some(\n        (value) => value.toLowerCase() === WS_UPGRADE,\n    );\n}\n\nexport function hasUpgradeHeader(headers: Headers): boolean {\n    return getHeaderValues(headers, HttpHeader.UPGRADE).some(\n        (value) => value.toLowerCase() === WS_WEBSOCKET,\n    );\n}\n\nexport function hasWebSocketVersion(headers: Headers): boolean {\n    return headers.get(HttpHeader.SEC_WEBSOCKET_VERSION)?.trim() === WS_VERSION;\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 { GET } from \"../../constants/methods\";\nimport { BadRequest, UpgradeRequired } from \"../../errors\";\nimport { Worker } from \"../../interfaces/worker\";\nimport { Middleware } from \"../middleware\";\nimport { hasConnectionHeader, hasUpgradeHeader, hasWebSocketVersion } from \"./utils\";\n\nexport function websocket(path: string = \"/\"): Middleware {\n    return new WebSocketHandler(path);\n}\n\nclass WebSocketHandler extends Middleware {\n    constructor(private readonly path: string) {\n        super();\n    }\n\n    public handle(worker: Worker, next: () => Promise<Response>): Promise<Response> {\n        if (worker.request.method !== GET) {\n            return next();\n        }\n\n        if (this.getPath(worker.request) !== this.path) {\n            return next();\n        }\n\n        const headers = worker.request.headers;\n        if (!hasConnectionHeader(headers)) {\n            return new BadRequest(\"Missing or invalid Connection header\").response();\n        }\n        if (!hasUpgradeHeader(headers)) {\n            return new BadRequest(\"Missing or invalid Upgrade header\").response();\n        }\n        if (!hasWebSocketVersion(headers)) {\n            return new UpgradeRequired().response();\n        }\n\n        return next();\n    }\n\n    private getPath(request: Request): string {\n        return new URL(request.url).pathname;\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 { CloseCode, WS_MAX_CLOSE_CODE, WS_MAX_REASON_CHARS, WS_RESERVED_CODES } from \"../constants/websocket\";\nimport { isNumber, isString } from \"./basic\";\n\nexport function isBinary(value: unknown): value is ArrayBuffer | ArrayBufferView {\n    return value instanceof ArrayBuffer || ArrayBuffer.isView(value);\n}\n\nexport function isSendable(value: unknown): value is string | ArrayBuffer | ArrayBufferView {\n    if (isString(value)) return value.length > 0;\n    if (isBinary(value)) return value.byteLength > 0;\n    return false;\n}\n\nexport function safeCloseCode(code?: number): number {\n    if (!isNumber(code)) return CloseCode.NORMAL;\n    if (isCodeInRange(code) && !isReservedCode(code)) return code;\n    return CloseCode.NORMAL;\n}\n\nexport function isCodeInRange(code: number): boolean {\n    return code >= CloseCode.NORMAL && code <= WS_MAX_CLOSE_CODE;\n}\n\nexport function isReservedCode(code: number): boolean {\n    return WS_RESERVED_CODES.has(code);\n}\n\nexport function safeReason(reason?: string): string | undefined {\n    if (!isString(reason)) return;\n    return reason.replaceAll(/[^\\x20-\\x7E]/g, \"\").slice(0, WS_MAX_REASON_CHARS);\n}\n\nexport function assertSerializable(value: unknown): asserts value is object {\n    if (value === null || typeof value !== \"object\") {\n        throw new TypeError(\"WebSocket attachment must be an object\");\n    }\n    try {\n        JSON.stringify(value);\n    } catch {\n        throw new TypeError(\"WebSocket attachment is not serializable\");\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 {\n    CustomEventType,\n    EventOptions,\n    ExtendedEventListener,\n    ExtendedEventMap,\n    ExtendedEventType,\n} from \"../interfaces/websocket\";\n\nexport abstract class WebSocketEvents {\n    protected readonly server: WebSocket;\n\n    private static isCustomEvent(type: ExtendedEventType): boolean {\n        return [\"open\", \"warn\"].includes(type);\n    }\n\n    private customListeners: {\n        [K in ExtendedEventType]?: ((ev: ExtendedEventMap[K]) => void)[];\n    } = {};\n\n    constructor(server: WebSocket) {\n        this.server = server;\n    }\n\n    public addEventListener<K extends ExtendedEventType>(\n        type: K,\n        listener: ExtendedEventListener<K>,\n        options?: EventOptions,\n    ): void {\n        if (WebSocketEvents.isCustomEvent(type)) {\n            let arr = this.customListeners[type];\n            if (!arr) {\n                arr = [];\n                this.customListeners[type] = arr;\n            }\n            arr.push(listener);\n        } else {\n            const finalOptions = type === \"close\" ? { ...options, once: true } : options;\n            this.server.addEventListener(\n                type as keyof WebSocketEventMap,\n                listener as EventListener,\n                finalOptions,\n            );\n        }\n    }\n\n    public removeEventListener<K extends ExtendedEventType>(\n        type: K,\n        listener: ExtendedEventListener<K>,\n    ): void {\n        if (WebSocketEvents.isCustomEvent(type)) {\n            const arr = this.customListeners[type];\n            if (arr) {\n                const index = arr.indexOf(listener);\n                if (index !== -1) arr.splice(index, 1);\n            }\n        } else {\n            this.server.removeEventListener(\n                type as keyof WebSocketEventMap,\n                listener as EventListener,\n            );\n        }\n    }\n\n    private dispatch<K extends CustomEventType>(\n        type: K,\n        ev: ExtendedEventMap[K],\n        once: boolean = false,\n    ): void {\n        const listeners = this.customListeners[type]?.slice() ?? [];\n        if (once) {\n            this.customListeners[type] = [];\n        }\n        for (const listener of listeners) {\n            listener(ev);\n        }\n    }\n\n    protected warn(msg: string) {\n        this.dispatch(\"warn\", { type: \"warn\", message: msg });\n    }\n\n    protected open() {\n        this.dispatch(\"open\", new Event(\"open\"), true);\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 { assertSerializable, isSendable, safeCloseCode, safeReason } from \"../guards/websocket\";\nimport { WSAttachment } from \"../interfaces/websocket\";\nimport { WebSocketEvents } from \"./events\";\n\nexport abstract class BaseWebSocket<A extends WSAttachment> extends WebSocketEvents {\n    protected accepted = false;\n    protected readonly server: WebSocket;\n\n    constructor(server: WebSocket) {\n        super(server);\n        this.server = server;\n        this.server.addEventListener(\"close\", this.onclose);\n    }\n\n    public send(data: string | ArrayBuffer | ArrayBufferView): void {\n        if (this.isState(WebSocket.CONNECTING, WebSocket.CLOSED)) {\n            this.warn(\"Cannot send: WebSocket not open\");\n            return;\n        }\n        if (!isSendable(data)) {\n            this.warn(\"Cannot send: empty or invalid data\");\n            return;\n        }\n\n        this.server.send(data);\n    }\n\n    public get attachment(): A {\n        return (this.server.deserializeAttachment() ?? {}) as A;\n    }\n\n    public attach(attachment?: Partial<A> | null): void {\n        if (attachment === undefined) return;\n        if (attachment === null) {\n            this.server.serializeAttachment({});\n        } else {\n            const current = this.attachment;\n            const merged = { ...current, ...attachment };\n            assertSerializable(merged);\n            this.server.serializeAttachment(merged);\n        }\n    }\n\n    public get readyState(): number {\n        if (!this.accepted) return WebSocket.CONNECTING;\n        return this.server.readyState;\n    }\n\n    public isState(...states: number[]): boolean {\n        return states.includes(this.readyState);\n    }\n\n    public close(code?: number, reason?: string): void {\n        this.server.removeEventListener(\"close\", this.onclose);\n        this.server.close(safeCloseCode(code), safeReason(reason));\n    }\n\n    private readonly onclose = (event: CloseEvent): void => {\n        this.close(event.code, event.reason);\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 { WSAttachment, WebSocketConnection } from \"../interfaces/websocket\";\nimport { BaseWebSocket } from \"./base\";\n\nexport abstract class NewConnectionBase<A extends WSAttachment>\n    extends BaseWebSocket<A>\n    implements WebSocketConnection<A>\n{\n    private readonly client: WebSocket;\n\n    public constructor() {\n        const pair = new WebSocketPair();\n        const [client, server] = [pair[0], pair[1]];\n        super(server);\n        this.client = client;\n    }\n\n    public acceptWebSocket(ctx: DurableObjectState, tags?: string[]): WebSocket {\n        ctx.acceptWebSocket(this.server, tags);\n        return this.ready();\n    }\n\n    public accept(): WebSocket {\n        this.server.accept();\n        return this.ready();\n    }\n\n    private ready(): WebSocket {\n        this.accepted = true;\n        this.open();\n\n        return this.client;\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 { WSAttachment, WebSocketConnection } from \"../interfaces/websocket\";\nimport { BaseWebSocket } from \"./base\";\n\nexport abstract class RestoredConnectionBase<A extends WSAttachment>\n    extends BaseWebSocket<A>\n    implements WebSocketConnection<A>\n{\n    constructor(ws: WebSocket) {\n        super(ws);\n        this.accepted = true;\n    }\n\n    public accept(): WebSocket {\n        throw new Error(\"Do not call accept() on restore\");\n    }\n\n    public acceptWebSocket(): WebSocket {\n        throw new Error(\"Do not call acceptWebSocket() on restore\");\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 { WSAttachment, WebSocketConnection } from \"../interfaces/websocket\";\nimport { NewConnectionBase } from \"./new\";\nimport { RestoredConnectionBase } from \"./restore\";\n\nexport class WebSocketSessions<A extends WSAttachment = WSAttachment> {\n    private readonly map = new Map<WebSocket, WebSocketConnection<A>>();\n\n    public create(attachment?: Partial<A>): WebSocketConnection<A> {\n        class NewConnection extends NewConnectionBase<A> {\n            constructor(private readonly sessions: WebSocketSessions<A>) {\n                super();\n            }\n\n            public override accept(): WebSocket {\n                this.addEventListener(\"close\", () => this.sessions.unregister(this.server));\n                this.sessions.register(this.server, this);\n                return super.accept();\n            }\n\n            public override acceptWebSocket(ctx: DurableObjectState, tags?: string[]): WebSocket {\n                this.sessions.register(this.server, this);\n                return super.acceptWebSocket(ctx, tags);\n            }\n        }\n\n        const connection = new NewConnection(this);\n        connection.attach(attachment);\n        return connection;\n    }\n\n    public restore(ws: WebSocket): WebSocketConnection<A> {\n        class RestoredConnection extends RestoredConnectionBase<A> {\n            constructor(sessions: WebSocketSessions<A>, restore: WebSocket) {\n                super(restore);\n                sessions.register(this.server, this);\n            }\n        }\n        return new RestoredConnection(this, ws);\n    }\n\n    public restoreAll(all: WebSocket[]): ReadonlyArray<WebSocketConnection<A>> {\n        const restored: WebSocketConnection<A>[] = [];\n        for (const ws of all) {\n            restored.push(this.restore(ws));\n        }\n        return restored;\n    }\n\n    public get(ws: WebSocket): WebSocketConnection<A> | undefined {\n        return this.map.get(ws);\n    }\n\n    public values(): IterableIterator<WebSocketConnection<A>> {\n        return this.map.values();\n    }\n\n    public keys(): IterableIterator<WebSocket> {\n        return this.map.keys();\n    }\n\n    public close(ws: WebSocket, code?: number, reason?: string): boolean {\n        const con = this.get(ws);\n        if (con) con.close(code, reason);\n\n        return this.unregister(ws);\n    }\n\n    public *[Symbol.iterator](): IterableIterator<WebSocketConnection<A>> {\n        yield* this.values();\n    }\n\n    private register(ws: WebSocket, con: WebSocketConnection<A>): void {\n        this.map.set(ws, con);\n    }\n\n    private unregister(ws: WebSocket): boolean {\n        return this.map.delete(ws);\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 \"../constants/methods\";\nimport { assertMethods, isMethod } from \"../guards/methods\";\nimport { FetchHandler } from \"../interfaces/fetch\";\nimport { Worker, WorkerClass } from \"../interfaces/worker\";\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     * Dispatches the incoming request to the appropriate handler and produces a response.\n     *\n     * Subclasses must implement this method to define how the worker generates a `Response`\n     * for the current request. This is the central point where request processing occurs.\n     *\n     * @returns A Promise that resolves to the `Response` for the request.\n     */\n    protected abstract dispatch(): Promise<Response>;\n\n    /**\n     * Checks if the given HTTP method is allowed for this worker.\n     * @param method HTTP method string\n     * @returns true if the method is allowed\n     */\n    public isAllowed(method: string): boolean {\n        const methods = this.getAllowedMethods();\n        assertMethods(methods);\n\n        return isMethod(method) && methods.includes(method);\n    }\n\n    public abstract getAllowedMethods(): Method[];\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 WorkerClass<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     * Simplify and standardize {@link Response} creation by extending {@link WorkerResponse}\n     * or any of its subclasses and passing to this method.\n     *\n     * Or directly use any of the built-in classes.\n     *\n     * ```ts\n     * this.response(TextResponse, \"Hello World!\")\n     * ```\n     *\n     * @param ResponseClass The response class to instantiate\n     * @param args Additional constructor arguments\n     * @returns A Promise resolving to the {@link Response} object\n     */\n    protected async response<\n        Ctor extends new (...args: any[]) => { response(): Promise<Response> },\n    >(ResponseClass: Ctor, ...args: ConstructorParameters<Ctor>): Promise<Response> {\n        return new ResponseClass(...args).response();\n    }\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     * ```ts\n     * export default MyWorker.ignite();\n     * ```\n     */\n    public static ignite<W extends Worker>(this: WorkerClass<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 { Middleware } from \"../middleware/middleware\";\n\n/**\n * Asserts at runtime that a value is a Middleware instance.\n *\n * @param handler - The value to check.\n * @throws TypeError If `handler` is not a `Middleware` subclass instance.\n */\nexport function assertMiddleware(handler: unknown): asserts handler is Middleware {\n    if (handler instanceof Middleware) return;\n\n    throw new TypeError(\"Handler must be a subclass of Middleware.\");\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\";\nimport { Middleware } from \"../middleware/middleware\";\nimport { assertMiddleware } from \"../guards/middleware\";\n\n/** Internal base worker for handling middleware chains. */\nexport abstract class MiddlewareWorker extends BaseWorker {\n    /** Middleware handlers registered for this worker. */\n    protected readonly middlewares: Middleware[] = [];\n\n    /**\n     * Hook for subclasses to perform any initialization.\n     */\n    protected init(): void | Promise<void> {\n        return;\n    }\n\n    /**\n     * Add a middleware instance to this worker.\n     *\n     * The middleware will run for every request handled by this worker,\n     * in the order they are added.\n     *\n     * @param handler - The middleware to run.\n     * @returns `this` to allow chaining multiple `.use()` calls.\n     */\n    public use(handler: Middleware): this {\n        assertMiddleware(handler);\n\n        this.middlewares.push(handler);\n        return this;\n    }\n\n    /**\n     * Executes the middleware chain and dispatches the request.\n     *\n     * @returns The Response produced by the last middleware or `dispatch()`.\n     */\n    public override async fetch(): Promise<Response> {\n        const chain = this.middlewares.reduceRight(\n            (next, handler) => () => handler.handle(this, next),\n            () => this.dispatch(),\n        );\n        return await chain();\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 { MethodNotAllowed, InternalServerError, MethodNotImplemented } from \"../errors\";\nimport { MiddlewareWorker } from \"./middleware\";\nimport { Head, Options } from \"../responses\";\nimport { Method, GET, HEAD, OPTIONS } from \"../constants/methods\";\n\n/**\n * Basic worker class providing HTTP method dispatching and error handling.\n */\nexport abstract class BasicWorker extends MiddlewareWorker {\n    /**\n     * Entry point to handle a fetch request.\n     */\n    public override async fetch(): Promise<Response> {\n        if (!this.isAllowed(this.request.method)) {\n            return this.response(MethodNotAllowed, this);\n        }\n\n        try {\n            await this.init();\n            return await super.fetch();\n        } catch (error) {\n            console.error(error);\n            return this.response(InternalServerError);\n        }\n    }\n\n    /**\n     * Dispatches the request to the method-specific handler.\n     */\n    protected override 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\n        return (handler[method] ?? (() => this.response(MethodNotAllowed, this)))();\n    }\n\n    /** Override and implement this method for `GET` requests. */\n    protected async get(): Promise<Response> {\n        return this.response(MethodNotImplemented, this);\n    }\n\n    /** Override and implement this method for `PUT` requests. */\n    protected async put(): Promise<Response> {\n        return this.response(MethodNotImplemented, this);\n    }\n\n    /** Override and implement this method for `POST` requests. */\n    protected async post(): Promise<Response> {\n        return this.response(MethodNotImplemented, this);\n    }\n\n    /** Override and implement this method for `PATCH` requests. */\n    protected async patch(): Promise<Response> {\n        return this.response(MethodNotImplemented, this);\n    }\n\n    /** Override and implement this method for `DELETE` requests. */\n    protected async delete(): Promise<Response> {\n        return this.response(MethodNotImplemented, this);\n    }\n\n    /** Returns a default empty `OPTIONS` response. */\n    protected async options(): Promise<Response> {\n        return this.response(Options);\n    }\n\n    /**\n     * Default handler for `HEAD` requests.\n     * Performs a `GET` request and removes the body for `HEAD` semantics.\n     *\n     * Usually does not need to be overridden as this behavior covers\n     * standard `HEAD` requirements.\n     */\n    protected async head(): Promise<Response> {\n        const worker = this.create(\n            new Request(this.request.url, { method: GET, headers: this.request.headers }),\n        );\n        return this.response(Head, await worker.fetch());\n    }\n\n    /**\n     * The DEFAULT allowed HTTP methods for subclasses are `GET`, `HEAD`, `OPTIONS`.\n     *\n     * These defaults were selected for getting started quickly and can be\n     * overridden for each worker subclass.\n     */\n    public getAllowedMethods(): Method[] {\n        return [GET, HEAD, OPTIONS];\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 } from \"path-to-regexp\";\nimport { MatchedRoute, Route, PathParams, RouteTable } from \"./interfaces/route\";\nimport { Method } from \"./constants/methods\";\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     * Add routes to the router.\n     *\n     * Accepts any iterable of [method, path, handler] tuples.\n     * This includes arrays, Sets, or generators.\n     *\n     * @param routes - Iterable of route tuples to add.\n     */\n    public add(routes: RouteTable): void {\n        for (const [method, path, handler] of routes) {\n            const matcher = match<PathParams>(path);\n            this.routes.push({ method, matcher, handler });\n        }\n    }\n\n    /**\n     * Attempt to match a URL against the registered routes.\n     *\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\n            const found = route.matcher(pathname);\n            if (found) return { route, params: found.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 { BasicWorker } from \"./basic\";\nimport { NotFound } from \"../errors\";\nimport { Routes } from \"../routes\";\nimport { RouteHandler, RouteTable } from \"../interfaces/route\";\nimport { WorkerClass } from \"../interfaces/worker\";\nimport { BaseWorker } from \"./base\";\nimport { Method } from \"../constants/methods\";\n\n/**\n * Base worker supporting route-based request handling.\n *\n * Subclass `RouteWorker` to define a worker with multiple route handlers.\n *\n * Routes can be registered individually via `route()` or in bulk via `routes()`.\n */\nexport abstract class RouteWorker extends BasicWorker {\n    /** Internal table of registered routes. */\n    private readonly _routes: Routes = new Routes();\n\n    /**\n     * Registers a single new route in the worker.\n     *\n     * When a request matches the specified method and path, the provided handler\n     * will be executed. The handler can be either:\n     * - A function that receives URL parameters, or\n     * - A Worker subclass that will handle the request.\n     *\n     * @param method  - HTTP method for the route (`GET`, `POST`, etc.).\n     * @param path    - URL path pattern (Express-style, e.g., \"/users/:id\").\n     * @param handler - The function or Worker class to run when the route matches.\n     * @returns The current worker instance, allowing method chaining.\n     */\n    protected route(method: Method, path: string, handler: RouteHandler): this {\n        this.routes([[method, path, handler]]);\n        return this;\n    }\n\n    /**\n     * Registers multiple routes at once in the worker.\n     *\n     * Each route should be a tuple `[method, path, handler]` where:\n     * - `method`  - HTTP method for the route (`GET`, `POST`, etc.).\n     * - `path`    - URL path pattern (Express-style, e.g., \"/users/:id\").\n     * - `handler` - A function that receives URL parameters or a Worker subclass\n     *               that will handle the request.\n     *\n     * @param routes - An iterable of routes to register. Each item is a `[method, path, handler]` tuple.\n     * @returns The current worker instance, allowing method chaining.\n     */\n    protected routes(routes: RouteTable): this {\n        this._routes.add(routes);\n        return this;\n    }\n\n    /**\n     * Matches the incoming request against registered routes and dispatches it.\n     *\n     * If a route is found:\n     * - If the handler is a Worker class, a new instance is created and its `fetch()` is called.\n     * - If the handler is a callback function, it is invoked with the extracted path parameters.\n     *\n     * If no route matches, the request is passed to the parent `dispatch()` handler.\n     *\n     * @returns A `Promise<Response>` from the matched handler or parent dispatch.\n     */\n    protected override 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        const { handler } = found.route;\n        if (RouteWorker.isWorkerClass(handler)) {\n            return new handler(this.request, this.env, this.ctx).fetch();\n        }\n        return handler.call(this, found.params);\n    }\n\n    /**\n     * Runtime type guard to check if a given handler is a Worker class.\n     *\n     * A Worker class is any class that extends `BaseWorker`.\n     *\n     * @param handler - The constructor function to test.\n     * @returns `true` if `handler` is a subclass of `BaseWorker` at runtime, `false` otherwise.\n     */\n    private static isWorkerClass(handler: RouteHandler): handler is WorkerClass {\n        return BaseWorker.prototype.isPrototypeOf(handler.prototype);\n    }\n\n    protected override async get(): Promise<Response> {\n        return this.response(NotFound);\n    }\n\n    protected override async put(): Promise<Response> {\n        return this.response(NotFound);\n    }\n\n    protected override async post(): Promise<Response> {\n        return this.response(NotFound);\n    }\n\n    protected override async patch(): Promise<Response> {\n        return this.response(NotFound);\n    }\n\n    protected override async delete(): Promise<Response> {\n        return this.response(NotFound);\n    }\n}\n"],"mappings":"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","names":["StatusCodes","CacheLib","CacheControl","Method","GET","PUT","HEAD","POST","PATCH","DELETE","OPTIONS","Time","Middleware","isStringArray","value","item","isString","isFunction","isNumber","isBoolean","assertCacheName","value","isString","assertGetKey","isFunction","assertKey","HttpHeader","FORBIDDEN_304_HEADERS","FORBIDDEN_204_HEADERS","lexCompare","a","b","setHeader","headers","key","value","raw","values","v","lexCompare","mergeHeader","merged","getHeaderValues","filterHeaders","keys","VARY_CACHE_URL","isCacheable","response","getVaryHeader","values","getHeaderValues","HttpHeader","v","lexCompare","filterVaryHeader","vary","h","value","getVaryKey","request","key","varyPairs","filtered","header","encoded","base64UrlEncode","str","utf8","binary","byte","cache","cacheName","getKey","assertCacheName","assertGetKey","CacheHandler","sortSearchParams","request","url","sorted","a","b","lexCompare","stripSearchParams","Middleware","worker","next","GET","cached","response","vary","key","getVaryKey","isCacheable","filterVaryHeader","getVaryHeader","assertKey","METHOD_SET","Method","isMethod","value","isString","isMethodArray","assertMethods","desc","getReasonPhrase","StatusCodes","UTF8_CHARSET","withCharset","mediaType","charset","assertOctetStreamInit","value","obj","size","isNumber","offset","length","BaseResponse","StatusCodes","withCharset","UTF8_CHARSET","getReasonPhrase","key","value","setHeader","mergeHeader","HttpHeader","filterHeaders","FORBIDDEN_204_HEADERS","FORBIDDEN_304_HEADERS","CacheResponse","cache","CacheControl","WorkerResponse","body","ClonedResponse","response","clone","SuccessResponse","status","JsonResponse","json","HtmlResponse","charset","TextResponse","OctetStream","_OctetStream","stream","init","assertOctetStreamInit","size","offset","length","R2ObjectStream","_R2ObjectStream","source","useCache","range","WebSocketUpgrade","client","Head","get","Options","ALLOW_ALL_ORIGINS","SIMPLE_METHODS","GET","HEAD","OPTIONS","SKIP_CORS_STATUSES","StatusCodes","defaultCorsConfig","HttpHeader","Time","options","worker","cors","Options","origin","getOrigin","setAllowOrigin","setAllowCredentials","setAllowMethods","setAllowHeaders","setMaxAge","apply","response","clone","ClonedResponse","deleteCorsHeaders","setExposedHeaders","headers","allowAllOrigins","setHeader","HttpHeader","ALLOW_ALL_ORIGINS","mergeHeader","methods","assertMethods","allowed","method","SIMPLE_METHODS","maxAge","skipCors","status","SKIP_CORS_STATUSES","request","assertCorsInit","value","obj","isStringArray","isBoolean","isNumber","cors","init","assertCorsInit","CorsHandler","Middleware","defaultCorsConfig","worker","next","OPTIONS","options","response","skipCors","apply","getReasonPhrase","StatusCodes","WS_UPGRADE","WS_WEBSOCKET","CloseCode","WS_RESERVED_CODES","HttpError","JsonResponse","status","details","json","getReasonPhrase","CacheControl","BadRequest","StatusCodes","Unauthorized","Forbidden","NotFound","MethodNotAllowed","worker","methods","assertMethods","HttpHeader","UpgradeRequired","InternalServerError","NotImplemented","MethodNotImplemented","ServiceUnavailable","hasConnectionHeader","headers","getHeaderValues","HttpHeader","value","WS_UPGRADE","hasUpgradeHeader","WS_WEBSOCKET","hasWebSocketVersion","websocket","path","WebSocketHandler","Middleware","worker","next","GET","headers","hasConnectionHeader","hasUpgradeHeader","hasWebSocketVersion","UpgradeRequired","BadRequest","request","isBinary","value","isSendable","isString","safeCloseCode","code","isNumber","isCodeInRange","isReservedCode","CloseCode","WS_RESERVED_CODES","safeReason","reason","assertSerializable","WebSocketEvents","_WebSocketEvents","type","server","listener","options","arr","finalOptions","index","ev","once","listeners","msg","BaseWebSocket","WebSocketEvents","server","data","isSendable","attachment","merged","assertSerializable","states","code","reason","safeCloseCode","safeReason","event","NewConnectionBase","BaseWebSocket","pair","client","server","ctx","tags","RestoredConnectionBase","BaseWebSocket","ws","WebSocketSessions","attachment","NewConnection","NewConnectionBase","sessions","ctx","tags","connection","ws","RestoredConnection","RestoredConnectionBase","restore","all","restored","code","reason","con","BaseWorker","_request","_env","_ctx","method","methods","assertMethods","isMethod","request","ctor","ResponseClass","args","env","ctx","assertMiddleware","handler","Middleware","MiddlewareWorker","BaseWorker","handler","assertMiddleware","next","BasicWorker","MiddlewareWorker","MethodNotAllowed","error","InternalServerError","method","MethodNotImplemented","Options","worker","GET","Head","HEAD","OPTIONS","match","Routes","routes","method","path","handler","matcher","url","pathname","route","found","RouteWorker","_RouteWorker","BasicWorker","Routes","method","path","handler","routes","found","BaseWorker","NotFound"]}
+{"version":3,"sources":["../src/constants/index.ts","../src/constants/cache.ts","../src/constants/methods.ts","../src/constants/time.ts","../src/middleware/middleware.ts","../src/guards/basic.ts","../src/guards/cache.ts","../src/constants/headers.ts","../src/utils/compare.ts","../src/utils/headers.ts","../src/middleware/cache/utils.ts","../src/middleware/cache/handler.ts","../src/guards/methods.ts","../src/responses.ts","../src/constants/media.ts","../src/utils/media.ts","../src/guards/responses.ts","../src/middleware/cors/constants.ts","../src/middleware/cors/utils.ts","../src/guards/cors.ts","../src/middleware/cors/handler.ts","../src/errors.ts","../src/constants/websocket.ts","../src/middleware/websocket/utils.ts","../src/middleware/websocket/handler.ts","../src/guards/websocket.ts","../src/websocket/events.ts","../src/websocket/base.ts","../src/websocket/new.ts","../src/websocket/restore.ts","../src/websocket/sessions.ts","../src/workers/base.ts","../src/guards/middleware.ts","../src/workers/middleware.ts","../src/workers/basic.ts","../src/routes.ts","../src/workers/route.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\n/**\n * https://github.com/prettymuchbryce/http-status-codes\n */\nexport { StatusCodes } from \"http-status-codes\";\n\nexport * from \"./cache\";\nexport * from \"./methods\";\nexport * from \"./time\";\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 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 CacheControl 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 * 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\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}\n\n/**\n * Shorthand constants for each HTTP method.\n *\n * These are equivalent to the corresponding enum members in `Method`.\n * For example, `GET === Method.GET`.\n */\nexport const { GET, PUT, HEAD, POST, PATCH, DELETE, OPTIONS } = Method;\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\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 * 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 { Worker } from \"../interfaces/worker\";\n\n/**\n * Abstract base class for middleware.\n *\n * Middleware classes implement request/response processing logic in a\n * chainable manner. Each middleware receives a `Worker` object and a\n * `next` function that invokes the next middleware in the chain.\n *\n * Subclasses **must implement** the `handle` method.\n *\n * Example subclass:\n * ```ts\n * class LoggingMiddleware extends Middleware {\n *     public async handle(worker: Worker, next: () => Promise<Response>): Promise<Response> {\n *         console.log(`Processing request: ${worker.request.url}`);\n *         const response = await next();\n *         console.log(`Response status: ${response.status}`);\n *         return response;\n *      }\n * }\n * ```\n */\nexport abstract class Middleware {\n    /**\n     * Process a request in the middleware chain.\n     *\n     * @param worker - The `Worker` instance representing the request context.\n     * @param next - Function to invoke the next middleware in the chain.\n     *               Must be called to continue the chain unless the middleware\n     *               terminates early (e.g., returns a response directly).\n     * @returns A `Response` object, either returned directly or from `next()`.\n     */\n    public abstract handle(worker: Worker, next: () => Promise<Response>): Promise<Response>;\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\n/**\n * Checks if the provided value is an array of strings.\n *\n * @param value - The value to check.\n * @returns True if `array` is an array where every item is a string.\n */\nexport function isStringArray(value: unknown): value is string[] {\n    return Array.isArray(value) && value.every((item) => typeof item === \"string\");\n}\n\n/**\n * Checks if a value is a string.\n *\n * @param value - The value to check.\n * @returns `true` if the value is a string, otherwise `false`.\n */\nexport function isString(value: unknown): value is string {\n    return typeof value === \"string\";\n}\n\n/**\n * Checks if a value is a function.\n *\n * @param value - The value to check.\n * @returns `true` if the value is a function, otherwise `false`.\n */\nexport function isFunction(value: unknown): value is Function {\n    return typeof value === \"function\";\n}\n\n/**\n * Checks if a value is a valid number (not NaN).\n *\n * This function returns `true` if the value is of type `number`\n * and is not `NaN`. It works as a type guard for TypeScript.\n *\n * @param value - The value to check.\n * @returns `true` if the value is a number and not `NaN`, otherwise `false`.\n */\nexport function isNumber(value: unknown): value is number {\n    return typeof value === \"number\" && !Number.isNaN(value);\n}\n\n/**\n * Checks if a value is a boolean.\n *\n * @param value - The value to check.\n * @returns `true` if the value is a boolean (`true` or `false`), otherwise `false`.\n */\nexport function isBoolean(value: unknown): value is boolean {\n    return typeof value === \"boolean\";\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 { isFunction, isString } from \"./basic\";\n\n/**\n * Asserts that a value is a string suitable for a cache name.\n *\n * If the value is `undefined`, this function does nothing.\n * Otherwise, it throws a `TypeError` if the value is not a string.\n *\n * @param value - The value to check.\n * @throws TypeError If the value is defined but not a string.\n */\nexport function assertCacheName(value: unknown): asserts value is string | undefined {\n    if (value === undefined) return;\n    if (!isString(value)) {\n        throw new TypeError(\"Cache name must be a string.\");\n    }\n}\n\n/**\n * Asserts that a value is a function suitable for `getKey`.\n *\n * If the value is `undefined`, this function does nothing.\n * Otherwise, it throws a `TypeError` if the value is not a function.\n *\n * @param value - The value to check.\n * @throws TypeError If the value is defined but not a function.\n */\nexport function assertGetKey(value: unknown): asserts value is Function | undefined {\n    if (value === undefined) return;\n    if (!isFunction(value)) {\n        throw new TypeError(\"getKey must be a function.\");\n    }\n}\n\n/**\n * Asserts that a value is a `URL` instance suitable for use as a cache key.\n *\n * If the value is not a `URL`, this function throws a `TypeError`.\n *\n * @param value - The value to check.\n * @throws TypeError If the value is not a `URL`.\n */\nexport function assertKey(value: unknown): asserts value is URL {\n    if (!(value instanceof URL)) {\n        throw new TypeError(\"getKey must return a URL.\");\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\n/**\n * Internally used headers.\n */\nexport namespace HttpHeader {\n    export const ACCEPT_ENCODING = \"Accept-Encoding\";\n    export const ACCEPT_RANGES = \"Accept-Ranges\";\n    export const ALLOW = \"Allow\";\n    export const CACHE_CONTROL = \"Cache-Control\";\n    export const CONNECTION = \"Connection\";\n    export const CONTENT_DISPOSITION = \"Content-Disposition\";\n    export const CONTENT_ENCODING = \"Content-Encoding\";\n    export const CONTENT_LANGUAGE = \"Content-Language\";\n    export const CONTENT_LENGTH = \"Content-Length\";\n    export const CONTENT_RANGE = \"Content-Range\";\n    export const CONTENT_TYPE = \"Content-Type\";\n    export const CONTENT_MD5 = \"Content-MD5\";\n    export const ETAG = \"ETag\";\n    export const ORIGIN = \"Origin\";\n    export const VARY = \"Vary\";\n\n    // Cors Headers\n    export const ACCESS_CONTROL_ALLOW_CREDENTIALS = \"Access-Control-Allow-Credentials\";\n    export const ACCESS_CONTROL_ALLOW_HEADERS = \"Access-Control-Allow-Headers\";\n    export const ACCESS_CONTROL_ALLOW_METHODS = \"Access-Control-Allow-Methods\";\n    export const ACCESS_CONTROL_ALLOW_ORIGIN = \"Access-Control-Allow-Origin\";\n    export const ACCESS_CONTROL_EXPOSE_HEADERS = \"Access-Control-Expose-Headers\";\n    export const ACCESS_CONTROL_MAX_AGE = \"Access-Control-Max-Age\";\n\n    // Websocket Headers\n    export const SEC_WEBSOCKET_VERSION = \"Sec-WebSocket-Version\";\n    export const UPGRADE = \"Upgrade\";\n}\n\n/**\n * Headers that must not be sent in 304 Not Modified responses.\n * These are stripped to comply with the HTTP spec.\n */\nexport const FORBIDDEN_304_HEADERS = [\n    HttpHeader.CONTENT_TYPE,\n    HttpHeader.CONTENT_LENGTH,\n    HttpHeader.CONTENT_RANGE,\n    HttpHeader.CONTENT_ENCODING,\n    HttpHeader.CONTENT_LANGUAGE,\n    HttpHeader.CONTENT_DISPOSITION,\n    HttpHeader.CONTENT_MD5,\n];\n\n/**\n * Headers that should not be sent in 204 No Content responses.\n * Stripping them is recommended but optional per spec.\n */\nexport const FORBIDDEN_204_HEADERS = [HttpHeader.CONTENT_LENGTH, HttpHeader.CONTENT_RANGE];\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\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 * 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 { lexCompare } from \"./compare\";\n\n/**\n * Sets a header on the given Headers object.\n *\n * - If `value` is an array, any duplicates and empty strings are removed.\n * - If the resulting value 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 * - If the resulting value array is empty, the header is deleted.\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 === 0) return;\n\n    const existing = getHeaderValues(headers, key);\n    const merged = existing.concat(values.map((v) => v.trim()));\n\n    setHeader(headers, key, merged);\n}\n\n/**\n * Returns the values of an HTTP header as an array of strings.\n *\n * This helper:\n * - Retrieves the header value by `key`.\n * - Splits the value on commas.\n * - Trims surrounding whitespace from each entry.\n * - Filters out any empty tokens.\n * - Removes duplicate values (case-sensitive)\n *\n * If the header is not present, an empty array is returned.\n *\n */\nexport function getHeaderValues(headers: Headers, key: string): string[] {\n    const values =\n        headers\n            .get(key)\n            ?.split(\",\")\n            .map((v) => v.trim())\n            .filter((v) => v.length > 0) ?? [];\n    return Array.from(new Set(values)).sort(lexCompare);\n}\n\n/**\n * Removes a list of header fields from a {@link Headers} object.\n *\n * @param headers - The {@link Headers} object to modify in place.\n * @param keys - An array of header field names to remove. Header names are\n *               matched case-insensitively per the Fetch spec.\n */\nexport function filterHeaders(headers: Headers, keys: string[]): void {\n    for (const key of keys) {\n        headers.delete(key);\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 *\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 { HttpHeader } from \"../../constants/headers\";\nimport { lexCompare } from \"../../utils/compare\";\nimport { getHeaderValues } from \"../../utils/headers\";\nimport { VARY_WILDCARD } from \"./constants\";\n\n/** Base URL used for constructing cache keys. Only used internally. */\nconst VARY_CACHE_URL = \"https://vary\";\n\n/**\n * Determines whether a Response is cacheable.\n * - Must have `ok` status (2xx-3xx)\n * - Must not contain a Vary header with a wildcard (`*`)\n *\n * @param response The Response object to check.\n * @returns `true` if the response can be cached; `false` otherwise.\n */\nexport function isCacheable(response: Response): boolean {\n    if (!response.ok) return false;\n    if (getVaryHeader(response).includes(VARY_WILDCARD)) return false;\n\n    return true;\n}\n\n/**\n * Extracts and normalizes the `Vary` header from a Response.\n * - Splits comma-separated values\n * - Deduplicates\n * - Converts all values to lowercase\n * - Sorts lexicographically\n *\n * @param response The Response object containing headers.\n * @returns An array of normalized header names from the Vary header.\n */\nexport function getVaryHeader(response: Response): string[] {\n    const values = getHeaderValues(response.headers, HttpHeader.VARY);\n    return Array.from(new Set(values.map((v) => v.toLowerCase()))).sort(lexCompare);\n}\n\n/**\n * Filters out headers that should be ignored for caching, currently:\n * - `Accept-Encoding` (handled automatically by the platform)\n *\n * @param vary Array of normalized Vary header names.\n * @returns Array of headers used for computing cache variations.\n */\nexport function filterVaryHeader(vary: string[]): string[] {\n    return vary\n        .map((h) => h.toLowerCase())\n        .filter((value) => value !== HttpHeader.ACCEPT_ENCODING.toLowerCase());\n}\n\n/**\n * Generates a Vary-aware cache key for a request.\n *\n * The key is based on:\n * 1. The provided `key` URL, which is normalized by default but can be fully customized\n *    by the caller. For example, users can:\n *      - Sort query parameters\n *      - Remove the search/query string entirely\n *      - Exclude certain query parameters\n *    This allows full control over how this cache key is generated.\n * 2. The request headers listed in `vary` (after filtering and lowercasing).\n *\n * Behavior:\n * - Headers in `vary` are sorted and included in the key.\n * - The combination of the key URL and header values is base64-encoded to produce\n *   a safe cache key.\n * - The resulting string is returned as an absolute URL rooted at `VARY_CACHE_URL`.\n *\n * @param request The Request object to generate a key for.\n * @param vary Array of header names from the `Vary` header that affect caching.\n * @param key The cache key to be used for this request. Can be modified by the caller for\n *            custom cache key behavior.\n * @returns A string URL representing a unique cache key for this request + Vary headers.\n */\nexport function getVaryKey(request: Request, vary: string[], key: URL): string {\n    const varyPairs: [string, string][] = [];\n    const filtered = filterVaryHeader(vary);\n\n    filtered.sort(lexCompare);\n    for (const header of filtered) {\n        const value = request.headers.get(header);\n        if (value !== null) {\n            varyPairs.push([header, value]);\n        }\n    }\n\n    const encoded = base64UrlEncode(JSON.stringify([key.toString(), varyPairs]));\n    return new URL(encoded, VARY_CACHE_URL).href;\n}\n\n/**\n * Encodes a string as URL-safe Base64.\n * - Converts to UTF-8 bytes\n * - Base64-encodes\n * - Replaces `+` with `-` and `/` with `_`\n * - Removes trailing `=`\n *\n * @param str The input string to encode.\n * @returns URL-safe Base64 string.\n */\nexport function base64UrlEncode(str: string): string {\n    const utf8 = new TextEncoder().encode(str);\n    let binary = \"\";\n    for (const byte of utf8) {\n        binary += String.fromCodePoint(byte);\n    }\n    return btoa(binary)\n        .replaceAll(\"+\", \"-\")\n        .replaceAll(\"/\", \"_\")\n        .replace(/={1,2}$/, \"\");\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 { Middleware } from \"../middleware\";\nimport { Worker } from \"../../interfaces/worker\";\nimport { GET } from \"../../constants/methods\";\nimport { assertCacheName, assertGetKey, assertKey } from \"../../guards/cache\";\nimport { filterVaryHeader, getVaryHeader, getVaryKey, isCacheable } from \"./utils\";\nimport { lexCompare } from \"../../utils/compare\";\n\n/**\n * Creates a Vary-aware caching middleware for Workers.\n *\n * This middleware:\n * - Caches `GET` requests **only**.\n * - Respects the `Vary` header of responses, ensuring that requests\n *   with different headers (e.g., `Origin`) receive the correct cached response.\n * - Skips caching for non-cacheable responses (e.g., error responses or\n *   responses with `Vary: *`).\n *\n * @param cacheName Optional name of the cache to use. If omitted, the default cache is used.\n * @param getKey Optional function to compute a custom cache key from a request.\n *               If omitted, the request URL is normalized and used as the key.\n * @returns A `Middleware` instance that can be used in a Worker pipeline.\n */\nexport function cache(cacheName?: string, getKey?: (request: Request) => URL): Middleware {\n    assertCacheName(cacheName);\n    assertGetKey(getKey);\n\n    return new CacheHandler(cacheName, getKey);\n}\n\n/**\n * Returns a new URL with its query parameters sorted into a stable order.\n *\n * This is used for cache key generation: URLs that differ only in the\n * order of their query parameters will normalize to the same key.\n *\n * @param request - The incoming Request whose URL will be normalized.\n * @returns A new URL with query parameters sorted by name.\n */\nexport function sortSearchParams(request: Request): URL {\n    const url = new URL(request.url);\n    const sorted = new URLSearchParams(\n        [...url.searchParams.entries()].sort(([a], [b]) => lexCompare(a, b)),\n    );\n    url.search = sorted.toString();\n    url.hash = \"\";\n    return url;\n}\n\n/**\n * Returns a new URL with all query parameters removed.\n *\n * This is used when query parameters are not relevant to cache lookups,\n * ensuring that variants of the same resource share a single cache entry.\n *\n * @param request - The incoming Request whose URL will be normalized.\n * @returns A new URL with no query parameters.\n */\nexport function stripSearchParams(request: Request): URL {\n    const url = new URL(request.url);\n    url.search = \"\";\n    url.hash = \"\";\n    return url;\n}\n\n/**\n * Cache Middleware Implementation\n * @see {@link cache}\n */\nclass CacheHandler extends Middleware {\n    constructor(\n        private readonly cacheName?: string,\n        private readonly getKey?: (request: Request) => URL,\n    ) {\n        super();\n        this.cacheName = cacheName?.trim() || undefined;\n    }\n\n    /**\n     * Handles an incoming request.\n     * - Bypasses caching for non-`GET` requests.\n     * - Checks the cache for a stored response.\n     * - Calls next if no cached response exists.\n     * - Caches the response if it is cacheable.\n     *\n     * @param worker The Worker instance containing the request and context.\n     * @param next Function to call the next middleware or origin fetch.\n     * @returns A cached or freshly fetched Response.\n     */\n    public override async handle(worker: Worker, next: () => Promise<Response>): Promise<Response> {\n        if (worker.request.method !== GET) {\n            return next();\n        }\n\n        const cache = this.cacheName ? await caches.open(this.cacheName) : caches.default;\n        const cached = await this.getCached(cache, worker.request);\n        if (cached) return cached;\n\n        const response = await next();\n\n        this.setCached(cache, worker, response);\n        return response;\n    }\n\n    /**\n     * Retrieves a cached response for a given request.\n     * - Checks both the base cache key and any Vary-specific keys.\n     *\n     * @param cache The Cache object to check.\n     * @param request The request to retrieve a cached response for.\n     * @returns A cached Response if available, otherwise `undefined`.\n     */\n    public async getCached(cache: Cache, request: Request): Promise<Response | undefined> {\n        const url = this.getCacheKey(request);\n        const response = await cache.match(url);\n        if (!response) return;\n\n        const vary = this.getFilteredVary(response);\n        if (vary.length === 0) return response;\n\n        const key = getVaryKey(request, vary, url);\n        return cache.match(key);\n    }\n\n    /**\n     * Caches a response if it is cacheable.\n     *\n     * Behavior:\n     * - Always stores the response under the main cache key. This ensures that\n     *   the response’s Vary headers are available for later cache lookups.\n     * - If the response varies based on certain request headers (per the Vary header),\n     *   also stores a copy under a Vary-specific cache key so future requests\n     *   with matching headers can retrieve the correct response.\n     *\n     * @param cache The Cache object to store the response in.\n     * @param worker The Worker instance containing the request and context.\n     * @param response The Response to cache.\n     */\n    public async setCached(cache: Cache, worker: Worker, response: Response): Promise<void> {\n        if (!isCacheable(response)) return;\n\n        const url = this.getCacheKey(worker.request);\n\n        // Always store the main cache entry to preserve Vary headers\n        worker.ctx.waitUntil(cache.put(url, response.clone()));\n\n        // Store request-specific cache entry if the response varies\n        const vary = this.getFilteredVary(response);\n        if (vary.length > 0) {\n            worker.ctx.waitUntil(\n                cache.put(getVaryKey(worker.request, vary, url), response.clone()),\n            );\n        }\n    }\n\n    /**\n     * Extracts and filters the `Vary` header from a response.\n     *\n     * @param response - The HTTP response to inspect.\n     * @returns An array of filtered header names from the `Vary` header.\n     */\n    public getFilteredVary(response: Response): string[] {\n        return filterVaryHeader(getVaryHeader(response));\n    }\n\n    /**\n     * Returns the cache key for a request.\n     *\n     * By default, this is a normalized URL including the path and query string.\n     * However, users can provide a custom `getKey` function when creating the\n     * `cache` middleware to fully control how the cache keys are generated.\n     *\n     * For example, a custom function could:\n     *  - Sort or remove query parameters\n     *  - Exclude the search/query string entirely\n     *  - Modify the path or host\n     *\n     * This allows complete flexibility over cache key generation.\n     *\n     * @param request The Request object to generate a cache key for.\n     * @returns A URL representing the main cache key for this request.\n     */\n    public getCacheKey(request: Request): URL {\n        const key = this.getKey ? this.getKey(request) : sortSearchParams(request);\n        assertKey(key);\n\n        key.hash = \"\";\n        return key;\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 \"../constants/methods\";\nimport { isString } from \"./basic\";\n\n/**\n * A set containing all supported HTTP methods.\n *\n * Useful for runtime checks like validating request methods.\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: unknown): value is Method {\n    return isString(value) && METHOD_SET.has(value);\n}\n\n/**\n * Checks if a value is an array of valid HTTP methods.\n *\n * Each element is verified using the `isMethod` type guard.\n *\n * @param value - The value to check.\n * @returns `true` if `value` is an array and every element is a valid `Method`, otherwise `false`.\n */\nexport function isMethodArray(value: unknown): value is Method[] {\n    return Array.isArray(value) && value.every(isMethod);\n}\n\n/**\n * Asserts that a value is an array of valid HTTP methods.\n *\n * This function uses {@link isMethodArray} to validate the input. If the\n * value is not an array of `Method` elements, it throws a `TypeError`.\n * Otherwise, TypeScript will narrow the type of `value` to `Method[]`\n * within the calling scope.\n *\n * @param value - The value to check.\n * @throws TypeError If `value` is not a valid method array.\n */\nexport function assertMethods(value: unknown): asserts value is Method[] {\n    if (!isMethodArray(value)) {\n        const desc = Array.isArray(value) ? JSON.stringify(value) : String(value);\n        throw new TypeError(`Invalid method array: ${desc}`);\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 { CacheControl } from \"./constants/cache\";\nimport { setHeader, mergeHeader, filterHeaders } from \"./utils/headers\";\nimport { UTF8_CHARSET, MediaType } from \"./constants/media\";\nimport { FORBIDDEN_204_HEADERS, FORBIDDEN_304_HEADERS, HttpHeader } from \"./constants/headers\";\nimport { OctetStreamInit } from \"./interfaces/response\";\nimport { withCharset } from \"./utils/media\";\nimport { assertOctetStreamInit } from \"./guards/responses\";\n\n/**\n * Base class for building HTTP responses.\n * Manages headers, status, and media type.\n */\nabstract class BaseResponse {\n    /** HTTP headers for the response. */\n    public headers: Headers = new Headers();\n\n    /** HTTP status code (default 200 OK). */\n    public status: StatusCodes = StatusCodes.OK;\n\n    /** Optional status text. Defaults to standard reason phrase. */\n    public statusText?: string;\n\n    /** Enable websocket responses. */\n    public webSocket: WebSocket | null = null;\n\n    /** Default media type of the response body. */\n    public mediaType: string = withCharset(MediaType.PLAIN_TEXT, UTF8_CHARSET);\n\n    /** Converts current state to ResponseInit for constructing a Response. */\n    protected get responseInit(): ResponseInit {\n        return {\n            headers: this.headers,\n            status: this.status,\n            statusText: this.statusText ?? getReasonPhrase(this.status),\n            webSocket: this.webSocket,\n            encodeBody: \"automatic\",\n        };\n    }\n\n    /** Sets a header, overwriting any existing value. */\n    public setHeader(key: string, value: string | string[]): void {\n        setHeader(this.headers, key, value);\n    }\n\n    /** Merges a header with existing values (does not overwrite). */\n    public mergeHeader(key: string, value: string | string[]): void {\n        mergeHeader(this.headers, key, value);\n    }\n\n    /** Adds a Content-Type header if not already existing (does not overwrite). */\n    public addContentType() {\n        if (!this.headers.get(HttpHeader.CONTENT_TYPE)) {\n            this.setHeader(HttpHeader.CONTENT_TYPE, this.mediaType);\n        }\n    }\n\n    /**\n     * Removes headers that are disallowed or discouraged based on the current\n     * status code.\n     *\n     * - **204 No Content:** strips headers that \"should not\" be sent\n     *   (`Content-Length`, `Content-Range`), per the HTTP spec.\n     * - **304 Not Modified:** strips headers that \"must not\" be sent\n     *   (`Content-Type`, `Content-Length`, `Content-Range`, etc.), per the HTTP spec.\n     *\n     * This ensures that responses remain compliant with HTTP/1.1 standards while preserving\n     * custom headers that are allowed.\n     */\n    public filterHeaders(): void {\n        if (this.status === StatusCodes.NO_CONTENT) {\n            filterHeaders(this.headers, FORBIDDEN_204_HEADERS);\n        } else if (this.status === StatusCodes.NOT_MODIFIED) {\n            filterHeaders(this.headers, FORBIDDEN_304_HEADERS);\n        }\n    }\n}\n\n/**\n * Base response class that adds caching headers.\n */\nabstract class CacheResponse extends BaseResponse {\n    constructor(public cache?: CacheControl) {\n        super();\n    }\n\n    /** Adds Cache-Control header if caching is configured. */\n    protected addCacheHeader(): void {\n        if (this.cache) {\n            this.setHeader(HttpHeader.CACHE_CONTROL, CacheControl.stringify(this.cache));\n        }\n    }\n}\n\n/**\n * Core response. Combines caching, and content type headers.\n */\nexport abstract class WorkerResponse extends CacheResponse {\n    constructor(\n        private readonly body: BodyInit | null = null,\n        cache?: CacheControl,\n    ) {\n        super(cache);\n    }\n\n    /** Builds the Response with body, headers, and status. */\n    public async response(): Promise<Response> {\n        this.addCacheHeader();\n\n        const body = [StatusCodes.NO_CONTENT, StatusCodes.NOT_MODIFIED].includes(this.status)\n            ? null\n            : this.body;\n\n        if (body) this.addContentType();\n\n        this.filterHeaders();\n\n        return new Response(body, this.responseInit);\n    }\n}\n\n/**\n * Wraps an existing Response and clones its body, headers, and status.\n */\nexport class ClonedResponse extends WorkerResponse {\n    constructor(response: Response, cache?: CacheControl) {\n        const clone = response.clone();\n        super(clone.body, cache);\n        this.headers = new Headers(clone.headers);\n        this.status = clone.status;\n        this.statusText = clone.statusText;\n    }\n}\n\n/**\n * Represents a successful response with customizable body, cache and status.\n */\nexport class SuccessResponse extends WorkerResponse {\n    constructor(\n        body: BodyInit | null = null,\n        cache?: CacheControl,\n        status: StatusCodes = StatusCodes.OK,\n    ) {\n        super(body, cache);\n        this.status = status;\n    }\n}\n\n/**\n * JSON response. Automatically sets Content-Type to application/json.\n */\nexport class JsonResponse extends SuccessResponse {\n    constructor(json: unknown = {}, cache?: CacheControl, status: StatusCodes = StatusCodes.OK) {\n        super(JSON.stringify(json), cache, status);\n        this.mediaType = withCharset(MediaType.JSON, UTF8_CHARSET);\n    }\n}\n\n/**\n * HTML response. Automatically sets Content-Type to text/html.\n */\nexport class HtmlResponse extends SuccessResponse {\n    constructor(\n        body: string,\n        cache?: CacheControl,\n        status: StatusCodes = StatusCodes.OK,\n        charset: string = UTF8_CHARSET,\n    ) {\n        super(body, cache, status);\n        this.mediaType = withCharset(MediaType.HTML, charset);\n    }\n}\n\n/**\n * Plain text response. Automatically sets Content-Type to text/plain.\n */\nexport class TextResponse extends SuccessResponse {\n    constructor(\n        body: string,\n        cache?: CacheControl,\n        status: StatusCodes = StatusCodes.OK,\n        charset: string = UTF8_CHARSET,\n    ) {\n        super(body, cache, status);\n        this.mediaType = withCharset(MediaType.PLAIN_TEXT, charset);\n    }\n}\n\n/**\n * Represents an HTTP response for serving binary data as `application/octet-stream`.\n *\n * This class wraps a `ReadableStream` and sets all necessary headers for both\n * full and partial content responses, handling range requests in a hybrid way\n * to maximize browser and CDN caching.\n *\n * Key behaviors:\n * - `Content-Type` is set to `application/octet-stream`.\n * - `Accept-Ranges: bytes` is always included.\n * - `Content-Length` is always set to the validated length of the response body.\n * - If the request is a true partial range (offset > 0 or length < size), the response\n *   will be `206 Partial Content` with the appropriate `Content-Range` header.\n * - If the requested range covers the entire file (even if a Range header is present),\n *   the response will return `200 OK` to enable browser and edge caching.\n * - Zero-length streams (`size = 0`) are never treated as partial.\n * - Special case: a requested range of `0-0` on a non-empty file is normalized to 1 byte.\n */\nexport class OctetStream extends WorkerResponse {\n    constructor(stream: ReadableStream, init: OctetStreamInit, cache?: CacheControl) {\n        assertOctetStreamInit(init);\n\n        super(stream, cache);\n        this.mediaType = MediaType.OCTET_STREAM;\n\n        const normalized = OctetStream.normalizeInit(init);\n        const { size, offset, length } = normalized;\n\n        if (OctetStream.isPartial(normalized)) {\n            this.setHeader(\n                HttpHeader.CONTENT_RANGE,\n                `bytes ${offset}-${offset + length - 1}/${size}`,\n            );\n            this.status = StatusCodes.PARTIAL_CONTENT;\n        }\n\n        this.setHeader(HttpHeader.ACCEPT_RANGES, \"bytes\");\n        this.setHeader(HttpHeader.CONTENT_LENGTH, `${length}`);\n    }\n\n    /**\n     * Normalizes a partially-specified `OctetStreamInit` into a fully-specified object.\n     *\n     * Ensures that all required fields (`size`, `offset`, `length`) are defined:\n     * - `offset` defaults to 0 if not provided.\n     * - `length` defaults to `size - offset` if not provided.\n     * - Special case: if `offset` and `length` are both 0 but `size > 0`, `length` is set to 1\n     *   to avoid zero-length partial streams.\n     *\n     * @param init - The initial `OctetStreamInit` object, possibly with missing `offset` or `length`.\n     * @returns A fully-specified `OctetStreamInit` object with `size`, `offset`, and `length` guaranteed.\n     */\n    private static normalizeInit(init: OctetStreamInit): Required<OctetStreamInit> {\n        const { size } = init;\n        const offset = init.offset ?? 0;\n        let length = init.length ?? size - offset;\n\n        if (offset === 0 && length === 0 && size > 0) {\n            length = 1;\n        }\n\n        return { size, offset, length };\n    }\n\n    /**\n     * Determines whether the given `OctetStreamInit` represents a partial range.\n     *\n     * Partial ranges are defined as any range that does **not** cover the entire file:\n     * - If `size === 0`, the stream is never partial.\n     * - If `offset === 0` and `length === size`, the stream is treated as a full file (not partial),\n     *   even if a Range header is present. This enables browser and CDN caching.\n     * - All other cases are considered partial, and will result in a `206 Partial Content` response.\n     *\n     * @param init - A fully-normalized `OctetStreamInit` object.\n     * @returns `true` if the stream represents a partial range; `false` if it represents the full file.\n     */\n    private static isPartial(init: Required<OctetStreamInit>): boolean {\n        if (init.size === 0) return false;\n        return !(init.offset === 0 && init.length === init.size);\n    }\n}\n\n/**\n * A streaming response for Cloudflare R2 objects.\n *\n * @param source - The R2 object to stream.\n * @param cache - Optional caching information.\n */\nexport class R2ObjectStream extends OctetStream {\n    constructor(source: R2ObjectBody, cache?: CacheControl) {\n        let useCache = cache;\n        if (!useCache && source.httpMetadata?.cacheControl) {\n            useCache = CacheControl.parse(source.httpMetadata.cacheControl);\n        }\n\n        super(source.body, R2ObjectStream.computeRange(source.size, source.range), useCache);\n\n        this.setHeader(HttpHeader.ETAG, source.httpEtag);\n\n        if (source.httpMetadata?.contentType) {\n            this.mediaType = source.httpMetadata.contentType;\n        }\n    }\n\n    /**\n     * Computes an `OctetStreamInit` object from a given R2 range.\n     *\n     * This function normalizes a Cloudflare R2 `R2Range` into the shape expected\n     * by `OctetStream`. It handles the following cases:\n     *\n     * - No range provided → returns `{ size }` (full content).\n     * - `suffix` range → calculates the offset and length from the end of the file.\n     * - Explicit `offset` and/or `length` → passed through as-is.\n     *\n     * @param size - The total size of the file/object.\n     * @param range - Optional range to extract (from R2). Can be:\n     *   - `{ offset: number; length?: number }`\n     *   - `{ offset?: number; length: number }`\n     *   - `{ suffix: number }`\n     * @returns An `OctetStreamInit` object suitable for `OctetStream`.\n     */\n    private static computeRange(size: number, range?: R2Range): OctetStreamInit {\n        if (!range) return { size };\n\n        if (\"suffix\" in range) {\n            const offset = Math.max(0, size - range.suffix);\n            const length = size - offset;\n            return { size, offset, length };\n        }\n\n        return { size, ...range };\n    }\n}\n\n/**\n * Response for WebSocket upgrade requests.\n * Automatically sets status to 101 and attaches the client socket.\n */\nexport class WebSocketUpgrade extends WorkerResponse {\n    constructor(client: WebSocket) {\n        super(null);\n        this.status = StatusCodes.SWITCHING_PROTOCOLS;\n        this.webSocket = client;\n    }\n}\n\n/**\n * Response for `HEAD` requests. Copy headers and status from a `GET` response\n * without the body.\n */\nexport class Head extends WorkerResponse {\n    constructor(get: Response) {\n        super();\n        this.status = get.status;\n        this.statusText = get.statusText;\n        this.headers = new Headers(get.headers);\n    }\n}\n\n/**\n * Response for `OPTIONS` preflight requests.\n */\nexport class Options extends WorkerResponse {\n    constructor() {\n        super();\n        this.status = StatusCodes.NO_CONTENT;\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\nexport const UTF8_CHARSET = \"utf-8\";\n\n/**\n * Internal media types.\n */\nexport enum MediaType {\n    PLAIN_TEXT = \"text/plain\",\n    HTML = \"text/html\",\n    JSON = \"application/json\",\n    OCTET_STREAM = \"application/octet-stream\",\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\n/**\n * Appends a charset parameter to a given media type string,\n * avoiding duplicates and ignoring empty charsets.\n *\n * @param {string} mediaType - The MIME type (e.g., \"text/html\").\n * @param {string} charset - The character set to append (e.g., \"utf-8\").\n * @returns {string} The media type with charset appended if provided.\n */\nexport function withCharset(mediaType: string, charset: string): string {\n    if (!charset || mediaType.toLowerCase().includes(\"charset=\")) {\n        return mediaType;\n    }\n    return `${mediaType}; charset=${charset.toLowerCase()}`;\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 { OctetStreamInit } from \"../interfaces\";\nimport { isNumber } from \"./basic\";\n\n/**\n * Asserts that a given value is a valid `OctetStreamInit` object.\n *\n * Properties:\n * - `size` (required): must be a non-negative number.\n * - `offset` (optional): if provided, must be a number between 0 and `size`.\n * - `length` (optional): if provided, must be a non-negative number such that `offset + length <= size`.\n *\n * If `offset` or `length` are `undefined`, they are considered as `0` and `size` respectively.\n *\n * Throws an error if validation fails.\n *\n * Acts as a TypeScript type predicate, so after calling it, `value` is narrowed to `OctetStreamInit`.\n *\n * @param value - The value to validate as `OctetStreamInit`.\n * @throws {TypeError} If the value is not a non-null object.\n * @throws {RangeError} If `size`, `offset`, or `length` are invalid.\n * @returns `true` if the value is a valid `OctetStreamInit`.\n */\nexport function assertOctetStreamInit(value: unknown): asserts value is OctetStreamInit {\n    if (typeof value !== \"object\" || value === null) {\n        throw new TypeError(\"OctetStreamInit must be an object.\");\n    }\n\n    const obj = value as Record<string, unknown>;\n\n    // size\n    const size = obj[\"size\"];\n    if (!isNumber(size) || size < 0 || !Number.isInteger(size)) {\n        throw new RangeError(\n            `OctetStreamInit.size must be a non-negative integer (size=${JSON.stringify(size)}).`,\n        );\n    }\n\n    // offset\n    const offset = obj[\"offset\"] ?? 0;\n    if (!isNumber(offset) || offset < 0 || offset > size || !Number.isInteger(offset)) {\n        throw new RangeError(\n            `OctetStreamInit.offset must be a non-negative integer less than or equal to size (size=${JSON.stringify(size)}, offset=${JSON.stringify(offset)}).`,\n        );\n    }\n\n    // length\n    const length = obj[\"length\"] ?? size - offset;\n    if (!isNumber(length) || length < 0 || offset + length > size || !Number.isInteger(length)) {\n        throw new RangeError(\n            `OctetStreamInit.length must be a non-negative integer less than or equal to size - offset (size=${JSON.stringify(size)}, offset=${JSON.stringify(offset)}, length=${JSON.stringify(length)}).`,\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 { StatusCodes } from \"../../constants\";\nimport { HttpHeader } from \"../../constants/headers\";\nimport { GET, HEAD, Method, OPTIONS } from \"../../constants/methods\";\nimport { Time } from \"../../constants/time\";\nimport { CorsConfig } from \"../../interfaces/cors\";\n\nexport const ALLOW_ALL_ORIGINS = \"*\";\n\n/**\n * Set of HTTP methods considered \"simple\" under the `CORS` specification.\n *\n * Simple methods do not trigger a preflight request on their own.\n * (Other factors like headers can still cause a preflight.)\n */\nexport const SIMPLE_METHODS = new Set<Method>([GET, HEAD, OPTIONS]);\n\n/**\n * Status codes for which `CORS` should be skipped.\n *\n * Skips `CORS` for:\n * - 101 Switching Protocols (WebSocket upgrade)\n * - 100 Continue\n * - 3xx Redirects (`CORS` is applied to the final URL only)\n */\nexport const SKIP_CORS_STATUSES = [\n    StatusCodes.SWITCHING_PROTOCOLS,\n    StatusCodes.CONTINUE,\n    StatusCodes.PROCESSING,\n    StatusCodes.EARLY_HINTS,\n    StatusCodes.MOVED_PERMANENTLY,\n    StatusCodes.MOVED_TEMPORARILY,\n    StatusCodes.SEE_OTHER,\n    StatusCodes.TEMPORARY_REDIRECT,\n    StatusCodes.PERMANENT_REDIRECT,\n];\n\n/**\n * Default configuration for`CORS`middleware.\n */\nexport const defaultCorsConfig: CorsConfig = {\n    allowedOrigins: [ALLOW_ALL_ORIGINS],\n    allowedHeaders: [HttpHeader.CONTENT_TYPE],\n    exposedHeaders: [],\n    allowCredentials: false,\n    maxAge: 5 * Time.Minute,\n} as const;\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 { HttpHeader } from \"../../constants/headers\";\nimport { assertMethods } from \"../../guards/methods\";\nimport { CorsConfig } from \"../../interfaces/cors\";\nimport { Worker } from \"../../interfaces/worker\";\nimport { ClonedResponse, Options } from \"../../responses\";\nimport { mergeHeader, setHeader } from \"../../utils/headers\";\nimport { ALLOW_ALL_ORIGINS, SIMPLE_METHODS, SKIP_CORS_STATUSES } from \"./constants\";\n\n/**\n * Handles a `CORS` preflight `OPTIONS` request.\n *\n * Sets the appropriate`CORS`headers based on the provided configuration\n * and the origin of the request.\n *\n * @param worker - The Worker handling the request.\n * @param cors - The `CORS` configuration.\n * @returns A Response object for the preflight request.\n */\nexport async function options(worker: Worker, cors: CorsConfig): Promise<Response> {\n    const options = new Options();\n    const origin = getOrigin(worker.request);\n\n    if (origin) {\n        setAllowOrigin(options.headers, cors, origin);\n        setAllowCredentials(options.headers, cors, origin);\n    }\n\n    setAllowMethods(options.headers, worker);\n    setAllowHeaders(options.headers, cors);\n    setMaxAge(options.headers, cors);\n\n    return options.response();\n}\n\n/**\n * Applies`CORS`headers to an existing response.\n *\n * Useful for normal (non-preflight) responses where the response\n * should include`CORS`headers based on the request origin.\n *\n * @param response - The original Response object.\n * @param worker - The Worker handling the request.\n * @param cors - The`CORS`configuration.\n * @returns A new Response object with`CORS`headers applied.\n */\nexport async function apply(\n    response: Response,\n    worker: Worker,\n    cors: CorsConfig,\n): Promise<Response> {\n    const clone = new ClonedResponse(response);\n    const origin = getOrigin(worker.request);\n\n    deleteCorsHeaders(clone.headers);\n\n    if (origin) {\n        setAllowOrigin(clone.headers, cors, origin);\n        setAllowCredentials(clone.headers, cors, origin);\n        setExposedHeaders(clone.headers, cors);\n    }\n\n    return clone.response();\n}\n\n/**\n * Sets the Access-Control-Allow-Origin header based on the`CORS`config\n * and request origin.\n *\n * @param headers - The headers object to modify.\n * @param cors - The`CORS`configuration.\n * @param origin - The request's origin, or null if not present.\n */\nexport function setAllowOrigin(headers: Headers, cors: CorsConfig, origin: string): void {\n    if (allowAllOrigins(cors)) {\n        setHeader(headers, HttpHeader.ACCESS_CONTROL_ALLOW_ORIGIN, ALLOW_ALL_ORIGINS);\n    } else {\n        if (cors.allowedOrigins.includes(origin)) {\n            setHeader(headers, HttpHeader.ACCESS_CONTROL_ALLOW_ORIGIN, origin);\n        }\n        mergeHeader(headers, HttpHeader.VARY, HttpHeader.ORIGIN);\n    }\n}\n\n/**\n * Conditionally sets the `Access-Control-Allow-Credentials` header\n * for a`CORS`response.\n *\n * This header is only set if:\n * 1. `cors.allowCredentials` is true,\n * 2. The configuration does **not** allow any origin (`*`), and\n * 3. The provided `origin` is explicitly listed in `cors.allowedOrigins`.\n *\n * @param headers - The Headers object to modify.\n * @param cors - The`CORS`configuration.\n * @param origin - The origin of the incoming request.\n */\nexport function setAllowCredentials(headers: Headers, cors: CorsConfig, origin: string): void {\n    if (!cors.allowCredentials) return;\n    if (allowAllOrigins(cors)) return;\n    if (!cors.allowedOrigins.includes(origin)) return;\n\n    setHeader(headers, HttpHeader.ACCESS_CONTROL_ALLOW_CREDENTIALS, \"true\");\n}\n\n/**\n * Sets the `Access-Control-Allow-Methods` header for a`CORS`response,\n * but only for non-simple methods.\n *\n * Simple methods (`GET`, `HEAD`, `OPTIONS`) are automatically allowed by the\n *`CORS`spec, so this function only adds methods beyond those.\n *\n * @param headers - The Headers object to modify.\n * @param worker - The Worker instance used to retrieve allowed methods.\n */\nexport function setAllowMethods(headers: Headers, worker: Worker): void {\n    const methods = worker.getAllowedMethods();\n    assertMethods(methods);\n\n    const allowed = methods.filter((method) => !SIMPLE_METHODS.has(method));\n\n    if (allowed.length > 0) {\n        setHeader(headers, HttpHeader.ACCESS_CONTROL_ALLOW_METHODS, allowed);\n    }\n}\n\n/**\n * Sets the `Access-Control-Max-Age` header for a`CORS`response.\n *\n * This header indicates how long the results of a preflight request\n * can be cached by the client (in seconds).\n *\n * The value is **clamped to a non-negative integer** to comply with\n * the`CORS`specification:\n * - Decimal values are floored to the nearest integer.\n * - Negative values are treated as `0`.\n *\n * @param headers - The Headers object to modify.\n * @param cors - The`CORS`configuration containing the `maxAge` value in seconds.\n */\nexport function setMaxAge(headers: Headers, cors: CorsConfig): void {\n    const maxAge = Math.max(0, Math.floor(cors.maxAge));\n    setHeader(headers, HttpHeader.ACCESS_CONTROL_MAX_AGE, String(maxAge));\n}\n\n/**\n * Sets the Access-Control-Allow-Headers header based on the`CORS`configuration.\n *\n * Only the headers explicitly listed in `cors.allowedHeaders` are sent.\n * If the array is empty, no Access-Control-Allow-Headers header is added.\n *\n * @param headers - The Headers object to modify.\n * @param cors - The`CORS`configuration.\n */\nexport function setAllowHeaders(headers: Headers, cors: CorsConfig): void {\n    if (cors.allowedHeaders.length > 0) {\n        setHeader(headers, HttpHeader.ACCESS_CONTROL_ALLOW_HEADERS, cors.allowedHeaders);\n    }\n}\n\n/**\n * Sets the Access-Control-Expose-Headers header for a response.\n *\n * @param headers - The headers object to modify.\n * @param cors - The`CORS`configuration.\n */\nexport function setExposedHeaders(headers: Headers, cors: CorsConfig): void {\n    setHeader(headers, HttpHeader.ACCESS_CONTROL_EXPOSE_HEADERS, cors.exposedHeaders);\n}\n\n/**\n * Returns true if the`CORS`config allows all origins ('*').\n *\n * @param cors - The`CORS`configuration.\n */\nexport function allowAllOrigins(cors: CorsConfig): boolean {\n    return cors.allowedOrigins.includes(ALLOW_ALL_ORIGINS);\n}\n\n/**\n * Deletes any existing`CORS`headers from the provided headers object.\n *\n * @param headers - The headers object to modify.\n */\nexport function deleteCorsHeaders(headers: Headers): void {\n    headers.delete(HttpHeader.ACCESS_CONTROL_MAX_AGE);\n    headers.delete(HttpHeader.ACCESS_CONTROL_ALLOW_ORIGIN);\n    headers.delete(HttpHeader.ACCESS_CONTROL_ALLOW_HEADERS);\n    headers.delete(HttpHeader.ACCESS_CONTROL_ALLOW_METHODS);\n    headers.delete(HttpHeader.ACCESS_CONTROL_EXPOSE_HEADERS);\n    headers.delete(HttpHeader.ACCESS_CONTROL_ALLOW_CREDENTIALS);\n}\n\n/**\n * Determines whether`CORS`headers should be skipped for a response.\n *\n * @param response - The Response object to inspect\n * @returns `true` if`CORS`should be skipped, `false` otherwise\n */\nexport function skipCors(response: Response): boolean {\n    const { status, headers } = response;\n    if (SKIP_CORS_STATUSES.includes(status)) return true;\n    if (headers.has(HttpHeader.UPGRADE)) return true;\n\n    return false;\n}\n\n/**\n * Extracts and normalizes the `Origin` header from a request.\n *\n * Returns the origin (scheme + host + port) as a string if present and valid.\n * Returns `null` if:\n *   - The `Origin` header is missing\n *   - The `Origin` header is `\"null\"` (opaque origin)\n *   - The `Origin` header is malformed\n *\n * @param request - The incoming {@link Request} object.\n * @returns The normalized origin string, or `null` if not present or invalid.\n */\nexport function getOrigin(request: Request): string | null {\n    const origin = request.headers.get(HttpHeader.ORIGIN)?.trim();\n    if (!origin || origin === \"null\") return null;\n\n    try {\n        return new URL(origin).origin;\n    } catch {\n        return null;\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 { CorsInit } from \"../interfaces/cors\";\nimport { isBoolean, isNumber, isStringArray } from \"./basic\";\n\n/**\n * Throws if the given value is not a valid CorsInit.\n *\n * Checks only the fields that are present, since CorsInit is Partial<CorsConfig>.\n *\n * @param value - The value to check.\n */\nexport function assertCorsInit(value: unknown): asserts value is CorsInit {\n    if (value === undefined) return;\n\n    if (typeof value !== \"object\" || value === null) {\n        throw new TypeError(\"CorsInit must be an object.\");\n    }\n\n    const obj = value as Record<string, unknown>;\n\n    if (obj[\"allowedOrigins\"] !== undefined && !isStringArray(obj[\"allowedOrigins\"])) {\n        throw new TypeError(\"CorsInit.allowedOrigins must be a string array.\");\n    }\n\n    if (obj[\"allowedHeaders\"] !== undefined && !isStringArray(obj[\"allowedHeaders\"])) {\n        throw new TypeError(\"CorsInit.allowedHeaders must be a string array.\");\n    }\n\n    if (obj[\"exposedHeaders\"] !== undefined && !isStringArray(obj[\"exposedHeaders\"])) {\n        throw new TypeError(\"CorsInit.exposedHeaders must be a string array.\");\n    }\n\n    if (obj[\"allowCredentials\"] !== undefined && !isBoolean(obj[\"allowCredentials\"])) {\n        throw new TypeError(\"CorsInit.allowCredentials must be a boolean.\");\n    }\n\n    if (obj[\"maxAge\"] !== undefined && !isNumber(obj[\"maxAge\"])) {\n        throw new TypeError(\"CorsInit.maxAge must be a number.\");\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 { apply, options, skipCors } from \"./utils\";\nimport { Worker } from \"../../interfaces/worker\";\nimport { Middleware } from \"../middleware\";\nimport { CorsConfig, CorsInit } from \"../../interfaces/cors\";\nimport { defaultCorsConfig } from \"./constants\";\nimport { OPTIONS } from \"../../constants/methods\";\nimport { assertCorsInit } from \"../../guards/cors\";\n\n/**\n * Creates a`CORS`middleware instance.\n *\n * This middleware automatically handles Cross-Origin Resource Sharing (CORS)\n * for incoming requests, including preflight `OPTIONS` requests, and adds\n * appropriate headers to responses.\n *\n * @param init - Optional configuration for `CORS` behavior. See {@link CorsConfig}.\n * @returns A {@link Middleware} instance that can be used in your middleware chain.\n */\nexport function cors(init?: CorsInit): Middleware {\n    assertCorsInit(init);\n    return new CorsHandler(init);\n}\n\n/**\n * Cors Middleware Implementation\n * @see {@link cors}\n */\nclass CorsHandler extends Middleware {\n    /** The configuration used for this instance, with all defaults applied. */\n    private readonly config: CorsConfig;\n\n    /**\n     * Create a new`CORS`middleware instance.\n     *\n     * @param init - Partial configuration to override the defaults. Any values\n     *               not provided will use `defaultCorsConfig`.\n     */\n    constructor(init?: CorsInit) {\n        super();\n        this.config = { ...defaultCorsConfig, ...init };\n    }\n\n    /**\n     * Applies`CORS`headers to a request.\n     *\n     * - Returns a preflight response for `OPTIONS` requests.\n     * - For other methods, calls `next()` and applies`CORS`headers to the result.\n     *\n     * @param worker - The Worker handling the request.\n     * @param next - Function to invoke the next middleware.\n     * @returns Response with`CORS`headers applied.\n     */\n    public override async handle(worker: Worker, next: () => Promise<Response>): Promise<Response> {\n        if (worker.request.method === OPTIONS) {\n            return options(worker, this.config);\n        }\n\n        const response = await next();\n\n        if (skipCors(response)) return response;\n\n        return apply(response, worker, this.config);\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 { JsonResponse } from \"./responses\";\nimport { ErrorJson } from \"./interfaces/error\";\nimport { Worker } from \"./interfaces/worker\";\nimport { CacheControl } from \"./constants/cache\";\nimport { HttpHeader } from \"./constants/headers\";\nimport { assertMethods } from \"./guards/methods\";\nimport { WS_VERSION } from \"./constants/websocket\";\n\n/**\n * Generic HTTP error response.\n * Sends a JSON body with status, error message, and details.\n */\nexport class HttpError extends JsonResponse {\n    /**\n     * @param worker The worker handling the request.\n     * @param status HTTP status code.\n     * @param details Optional detailed error message.\n     */\n    constructor(\n        status: StatusCodes,\n        protected readonly details?: string,\n    ) {\n        const json: ErrorJson = {\n            status,\n            error: getReasonPhrase(status),\n            details: details ?? \"\",\n        };\n        super(json, CacheControl.DISABLE, status);\n    }\n}\n\n/** 400 Bad Request error response. */\nexport class BadRequest extends HttpError {\n    constructor(details?: string) {\n        super(StatusCodes.BAD_REQUEST, details);\n    }\n}\n\n/** 401 Unauthorized error response. */\nexport class Unauthorized extends HttpError {\n    constructor(details?: string) {\n        super(StatusCodes.UNAUTHORIZED, details);\n    }\n}\n\n/** 403 Forbidden error response. */\nexport class Forbidden extends HttpError {\n    constructor(details?: string) {\n        super(StatusCodes.FORBIDDEN, details);\n    }\n}\n\n/** 404 Not Found error response. */\nexport class NotFound extends HttpError {\n    constructor(details?: string) {\n        super(StatusCodes.NOT_FOUND, details);\n    }\n}\n\n/** 405 Method Not Allowed error response. */\nexport class MethodNotAllowed extends HttpError {\n    constructor(worker: Worker) {\n        const methods = worker.getAllowedMethods();\n        assertMethods(methods);\n\n        super(StatusCodes.METHOD_NOT_ALLOWED, `${worker.request.method} method not allowed.`);\n        this.setHeader(HttpHeader.ALLOW, methods);\n    }\n}\n\n/** 426 Upgrade Required error response. */\nexport class UpgradeRequired extends HttpError {\n    constructor() {\n        super(StatusCodes.UPGRADE_REQUIRED);\n        this.headers.set(HttpHeader.SEC_WEBSOCKET_VERSION, WS_VERSION);\n    }\n}\n\n/** 500 Internal Server Error response. */\nexport class InternalServerError extends HttpError {\n    constructor(details?: string) {\n        super(StatusCodes.INTERNAL_SERVER_ERROR, details);\n    }\n}\n\n/** 501 Not Implemented error response. */\nexport class NotImplemented extends HttpError {\n    constructor(details?: string) {\n        super(StatusCodes.NOT_IMPLEMENTED, details);\n    }\n}\n\n/** 501 Method Not Implemented error response for unsupported HTTP methods. */\nexport class MethodNotImplemented extends NotImplemented {\n    constructor(worker: Worker) {\n        super(`${worker.request.method} method not implemented.`);\n    }\n}\n\n/** 503 Service Unavailable error response. */\nexport class ServiceUnavailable extends HttpError {\n    constructor(details?: string) {\n        super(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\n/** WebSocket upgrade header value */\nexport const WS_UPGRADE = \"upgrade\";\n/** WebSocket protocol header value */\nexport const WS_WEBSOCKET = \"websocket\";\n/** WebSocket protocol version */\nexport const WS_VERSION = \"13\";\n/** Max close code a user can send */\nexport const WS_MAX_CLOSE_CODE = 4999;\n/** Max number of reason chars a user can send */\nexport const WS_MAX_REASON_CHARS = 123;\n\n/** WebSocket close codes */\nexport const CloseCode = {\n    NORMAL: 1000,\n    GOING_AWAY: 1001,\n    PROTOCOL_ERROR: 1002,\n    UNSUPPORTED_DATA: 1003,\n    NO_STATUS: 1005,\n    ABNORMAL: 1006,\n    INVALID_PAYLOAD: 1007,\n    POLICY_VIOLATION: 1008,\n    MESSAGE_TOO_BIG: 1009,\n    MISSING_EXTENSION: 1010,\n    INTERNAL_ERROR: 1011,\n    TLS_HANDSHAKE: 1015,\n} as const;\n\n/** WebSocket RESERVED close codes */\nexport const WS_RESERVED_CODES = new Set<number>([\n    CloseCode.NO_STATUS,\n    CloseCode.ABNORMAL,\n    CloseCode.TLS_HANDSHAKE,\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 { HttpHeader } from \"../../constants/headers\";\nimport { WS_UPGRADE, WS_VERSION, WS_WEBSOCKET } from \"../../constants/websocket\";\nimport { getHeaderValues } from \"../../utils/headers\";\n\nexport function hasConnectionHeader(headers: Headers): boolean {\n    return getHeaderValues(headers, HttpHeader.CONNECTION).some(\n        (value) => value.toLowerCase() === WS_UPGRADE,\n    );\n}\n\nexport function hasUpgradeHeader(headers: Headers): boolean {\n    return getHeaderValues(headers, HttpHeader.UPGRADE).some(\n        (value) => value.toLowerCase() === WS_WEBSOCKET,\n    );\n}\n\nexport function hasWebSocketVersion(headers: Headers): boolean {\n    return headers.get(HttpHeader.SEC_WEBSOCKET_VERSION)?.trim() === WS_VERSION;\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 { GET } from \"../../constants/methods\";\nimport { BadRequest, UpgradeRequired } from \"../../errors\";\nimport { Worker } from \"../../interfaces/worker\";\nimport { Middleware } from \"../middleware\";\nimport { hasConnectionHeader, hasUpgradeHeader, hasWebSocketVersion } from \"./utils\";\n\nexport function websocket(path: string = \"/\"): Middleware {\n    return new WebSocketHandler(path);\n}\n\nclass WebSocketHandler extends Middleware {\n    constructor(private readonly path: string) {\n        super();\n    }\n\n    public handle(worker: Worker, next: () => Promise<Response>): Promise<Response> {\n        if (worker.request.method !== GET) {\n            return next();\n        }\n\n        if (this.getPath(worker.request) !== this.path) {\n            return next();\n        }\n\n        const headers = worker.request.headers;\n        if (!hasConnectionHeader(headers)) {\n            return new BadRequest(\"Missing or invalid Connection header\").response();\n        }\n        if (!hasUpgradeHeader(headers)) {\n            return new BadRequest(\"Missing or invalid Upgrade header\").response();\n        }\n        if (!hasWebSocketVersion(headers)) {\n            return new UpgradeRequired().response();\n        }\n\n        return next();\n    }\n\n    private getPath(request: Request): string {\n        return new URL(request.url).pathname;\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 { CloseCode, WS_MAX_CLOSE_CODE, WS_MAX_REASON_CHARS, WS_RESERVED_CODES } from \"../constants/websocket\";\nimport { isNumber, isString } from \"./basic\";\n\nexport function isBinary(value: unknown): value is ArrayBuffer | ArrayBufferView {\n    return value instanceof ArrayBuffer || ArrayBuffer.isView(value);\n}\n\nexport function isSendable(value: unknown): value is string | ArrayBuffer | ArrayBufferView {\n    if (isString(value)) return value.length > 0;\n    if (isBinary(value)) return value.byteLength > 0;\n    return false;\n}\n\nexport function safeCloseCode(code?: number): number {\n    if (!isNumber(code)) return CloseCode.NORMAL;\n    if (isCodeInRange(code) && !isReservedCode(code)) return code;\n    return CloseCode.NORMAL;\n}\n\nexport function isCodeInRange(code: number): boolean {\n    return code >= CloseCode.NORMAL && code <= WS_MAX_CLOSE_CODE;\n}\n\nexport function isReservedCode(code: number): boolean {\n    return WS_RESERVED_CODES.has(code);\n}\n\nexport function safeReason(reason?: string): string | undefined {\n    if (!isString(reason)) return;\n    return reason.replaceAll(/[^\\x20-\\x7E]/g, \"\").slice(0, WS_MAX_REASON_CHARS);\n}\n\nexport function assertSerializable(value: unknown): asserts value is object {\n    if (value === null || typeof value !== \"object\") {\n        throw new TypeError(\"WebSocket attachment must be an object\");\n    }\n    try {\n        JSON.stringify(value);\n    } catch {\n        throw new TypeError(\"WebSocket attachment is not serializable\");\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 {\n    CustomEventType,\n    EventOptions,\n    ExtendedEventListener,\n    ExtendedEventMap,\n    ExtendedEventType,\n} from \"../interfaces/websocket\";\n\nexport abstract class WebSocketEvents {\n    protected readonly server: WebSocket;\n\n    private static isCustomEvent(type: ExtendedEventType): boolean {\n        return [\"open\", \"warn\"].includes(type);\n    }\n\n    private customListeners: {\n        [K in ExtendedEventType]?: ((ev: ExtendedEventMap[K]) => void)[];\n    } = {};\n\n    constructor(server: WebSocket) {\n        this.server = server;\n    }\n\n    public addEventListener<K extends ExtendedEventType>(\n        type: K,\n        listener: ExtendedEventListener<K>,\n        options?: EventOptions,\n    ): void {\n        if (WebSocketEvents.isCustomEvent(type)) {\n            let arr = this.customListeners[type];\n            if (!arr) {\n                arr = [];\n                this.customListeners[type] = arr;\n            }\n            arr.push(listener);\n        } else {\n            const finalOptions = type === \"close\" ? { ...options, once: true } : options;\n            this.server.addEventListener(\n                type as keyof WebSocketEventMap,\n                listener as EventListener,\n                finalOptions,\n            );\n        }\n    }\n\n    public removeEventListener<K extends ExtendedEventType>(\n        type: K,\n        listener: ExtendedEventListener<K>,\n    ): void {\n        if (WebSocketEvents.isCustomEvent(type)) {\n            const arr = this.customListeners[type];\n            if (arr) {\n                const index = arr.indexOf(listener);\n                if (index !== -1) arr.splice(index, 1);\n            }\n        } else {\n            this.server.removeEventListener(\n                type as keyof WebSocketEventMap,\n                listener as EventListener,\n            );\n        }\n    }\n\n    private dispatch<K extends CustomEventType>(\n        type: K,\n        ev: ExtendedEventMap[K],\n        once: boolean = false,\n    ): void {\n        const listeners = this.customListeners[type]?.slice() ?? [];\n        if (once) {\n            this.customListeners[type] = [];\n        }\n        for (const listener of listeners) {\n            listener(ev);\n        }\n    }\n\n    protected warn(msg: string) {\n        this.dispatch(\"warn\", { type: \"warn\", message: msg });\n    }\n\n    protected open() {\n        this.dispatch(\"open\", new Event(\"open\"), true);\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 { assertSerializable, isSendable, safeCloseCode, safeReason } from \"../guards/websocket\";\nimport { WSAttachment } from \"../interfaces/websocket\";\nimport { WebSocketEvents } from \"./events\";\n\nexport abstract class BaseWebSocket<A extends WSAttachment> extends WebSocketEvents {\n    protected accepted = false;\n    protected readonly server: WebSocket;\n\n    constructor(server: WebSocket) {\n        super(server);\n        this.server = server;\n        this.server.addEventListener(\"close\", this.onclose);\n    }\n\n    public send(data: string | ArrayBuffer | ArrayBufferView): void {\n        if (this.isState(WebSocket.CONNECTING, WebSocket.CLOSED)) {\n            this.warn(\"Cannot send: WebSocket not open\");\n            return;\n        }\n        if (!isSendable(data)) {\n            this.warn(\"Cannot send: empty or invalid data\");\n            return;\n        }\n\n        this.server.send(data);\n    }\n\n    public get attachment(): A {\n        return (this.server.deserializeAttachment() ?? {}) as A;\n    }\n\n    public attach(attachment?: Partial<A> | null): void {\n        if (attachment === undefined) return;\n        if (attachment === null) {\n            this.server.serializeAttachment({});\n        } else {\n            const current = this.attachment;\n            const merged = { ...current, ...attachment };\n            assertSerializable(merged);\n            this.server.serializeAttachment(merged);\n        }\n    }\n\n    public get readyState(): number {\n        if (!this.accepted) return WebSocket.CONNECTING;\n        return this.server.readyState;\n    }\n\n    public isState(...states: number[]): boolean {\n        return states.includes(this.readyState);\n    }\n\n    public close(code?: number, reason?: string): void {\n        this.server.removeEventListener(\"close\", this.onclose);\n        this.server.close(safeCloseCode(code), safeReason(reason));\n    }\n\n    private readonly onclose = (event: CloseEvent): void => {\n        this.close(event.code, event.reason);\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 { WSAttachment, WebSocketConnection } from \"../interfaces/websocket\";\nimport { BaseWebSocket } from \"./base\";\n\nexport abstract class NewConnectionBase<A extends WSAttachment>\n    extends BaseWebSocket<A>\n    implements WebSocketConnection<A>\n{\n    private readonly client: WebSocket;\n\n    public constructor() {\n        const pair = new WebSocketPair();\n        const [client, server] = [pair[0], pair[1]];\n        super(server);\n        this.client = client;\n    }\n\n    public acceptWebSocket(ctx: DurableObjectState, tags?: string[]): WebSocket {\n        ctx.acceptWebSocket(this.server, tags);\n        return this.ready();\n    }\n\n    public accept(): WebSocket {\n        this.server.accept();\n        return this.ready();\n    }\n\n    private ready(): WebSocket {\n        this.accepted = true;\n        this.open();\n\n        return this.client;\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 { WSAttachment, WebSocketConnection } from \"../interfaces/websocket\";\nimport { BaseWebSocket } from \"./base\";\n\nexport abstract class RestoredConnectionBase<A extends WSAttachment>\n    extends BaseWebSocket<A>\n    implements WebSocketConnection<A>\n{\n    constructor(ws: WebSocket) {\n        super(ws);\n        this.accepted = true;\n    }\n\n    public accept(): WebSocket {\n        throw new Error(\"Do not call accept() on restore\");\n    }\n\n    public acceptWebSocket(): WebSocket {\n        throw new Error(\"Do not call acceptWebSocket() on restore\");\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 { WSAttachment, WebSocketConnection } from \"../interfaces/websocket\";\nimport { NewConnectionBase } from \"./new\";\nimport { RestoredConnectionBase } from \"./restore\";\n\nexport class WebSocketSessions<A extends WSAttachment = WSAttachment> {\n    private readonly map = new Map<WebSocket, WebSocketConnection<A>>();\n\n    public create(attachment?: Partial<A>): WebSocketConnection<A> {\n        class NewConnection extends NewConnectionBase<A> {\n            constructor(private readonly sessions: WebSocketSessions<A>) {\n                super();\n            }\n\n            public override accept(): WebSocket {\n                this.addEventListener(\"close\", () => this.sessions.unregister(this.server));\n                this.sessions.register(this.server, this);\n                return super.accept();\n            }\n\n            public override acceptWebSocket(ctx: DurableObjectState, tags?: string[]): WebSocket {\n                this.sessions.register(this.server, this);\n                return super.acceptWebSocket(ctx, tags);\n            }\n        }\n\n        const connection = new NewConnection(this);\n        connection.attach(attachment);\n        return connection;\n    }\n\n    public restore(ws: WebSocket): WebSocketConnection<A> {\n        class RestoredConnection extends RestoredConnectionBase<A> {\n            constructor(sessions: WebSocketSessions<A>, restore: WebSocket) {\n                super(restore);\n                sessions.register(this.server, this);\n            }\n        }\n        return new RestoredConnection(this, ws);\n    }\n\n    public restoreAll(all: WebSocket[]): ReadonlyArray<WebSocketConnection<A>> {\n        const restored: WebSocketConnection<A>[] = [];\n        for (const ws of all) {\n            restored.push(this.restore(ws));\n        }\n        return restored;\n    }\n\n    public get(ws: WebSocket): WebSocketConnection<A> | undefined {\n        return this.map.get(ws);\n    }\n\n    public values(): IterableIterator<WebSocketConnection<A>> {\n        return this.map.values();\n    }\n\n    public keys(): IterableIterator<WebSocket> {\n        return this.map.keys();\n    }\n\n    public close(ws: WebSocket, code?: number, reason?: string): boolean {\n        const con = this.get(ws);\n        if (con) con.close(code, reason);\n\n        return this.unregister(ws);\n    }\n\n    public *[Symbol.iterator](): IterableIterator<WebSocketConnection<A>> {\n        yield* this.values();\n    }\n\n    private register(ws: WebSocket, con: WebSocketConnection<A>): void {\n        this.map.set(ws, con);\n    }\n\n    private unregister(ws: WebSocket): boolean {\n        return this.map.delete(ws);\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 \"../constants/methods\";\nimport { assertMethods, isMethod } from \"../guards/methods\";\nimport { FetchHandler } from \"../interfaces/fetch\";\nimport { Worker, WorkerClass } from \"../interfaces/worker\";\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     * Dispatches the incoming request to the appropriate handler and produces a response.\n     *\n     * Subclasses must implement this method to define how the worker generates a `Response`\n     * for the current request. This is the central point where request processing occurs.\n     *\n     * @returns A Promise that resolves to the `Response` for the request.\n     */\n    protected abstract dispatch(): Promise<Response>;\n\n    /**\n     * Checks if the given HTTP method is allowed for this worker.\n     * @param method HTTP method string\n     * @returns true if the method is allowed\n     */\n    public isAllowed(method: string): boolean {\n        const methods = this.getAllowedMethods();\n        assertMethods(methods);\n\n        return isMethod(method) && methods.includes(method);\n    }\n\n    public abstract getAllowedMethods(): Method[];\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 WorkerClass<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     * Simplify and standardize {@link Response} creation by extending {@link WorkerResponse}\n     * or any of its subclasses and passing to this method.\n     *\n     * Or directly use any of the built-in classes.\n     *\n     * ```ts\n     * this.response(TextResponse, \"Hello World!\")\n     * ```\n     *\n     * @param ResponseClass The response class to instantiate\n     * @param args Additional constructor arguments\n     * @returns A Promise resolving to the {@link Response} object\n     */\n    protected async response<\n        Ctor extends new (...args: any[]) => { response(): Promise<Response> },\n    >(ResponseClass: Ctor, ...args: ConstructorParameters<Ctor>): Promise<Response> {\n        return new ResponseClass(...args).response();\n    }\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     * ```ts\n     * export default MyWorker.ignite();\n     * ```\n     */\n    public static ignite<W extends Worker>(this: WorkerClass<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 { Middleware } from \"../middleware/middleware\";\n\n/**\n * Asserts at runtime that a value is a Middleware instance.\n *\n * @param handler - The value to check.\n * @throws TypeError If `handler` is not a `Middleware` subclass instance.\n */\nexport function assertMiddleware(handler: unknown): asserts handler is Middleware {\n    if (handler instanceof Middleware) return;\n\n    throw new TypeError(\"Handler must be a subclass of Middleware.\");\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\";\nimport { Middleware } from \"../middleware/middleware\";\nimport { assertMiddleware } from \"../guards/middleware\";\n\n/** Internal base worker for handling middleware chains. */\nexport abstract class MiddlewareWorker extends BaseWorker {\n    /** Middleware handlers registered for this worker. */\n    protected readonly middlewares: Middleware[] = [];\n\n    /**\n     * Hook for subclasses to perform any initialization.\n     */\n    protected init(): void | Promise<void> {\n        return;\n    }\n\n    /**\n     * Add a middleware instance to this worker.\n     *\n     * The middleware will run for every request handled by this worker,\n     * in the order they are added.\n     *\n     * @param handler - The middleware to run.\n     * @returns `this` to allow chaining multiple `.use()` calls.\n     */\n    public use(handler: Middleware): this {\n        assertMiddleware(handler);\n\n        this.middlewares.push(handler);\n        return this;\n    }\n\n    /**\n     * Executes the middleware chain and dispatches the request.\n     *\n     * @returns The Response produced by the last middleware or `dispatch()`.\n     */\n    public override async fetch(): Promise<Response> {\n        const chain = this.middlewares.reduceRight(\n            (next, handler) => () => handler.handle(this, next),\n            () => this.dispatch(),\n        );\n        return await chain();\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 { MethodNotAllowed, InternalServerError, MethodNotImplemented } from \"../errors\";\nimport { MiddlewareWorker } from \"./middleware\";\nimport { Head, Options } from \"../responses\";\nimport { Method, GET, HEAD, OPTIONS } from \"../constants/methods\";\n\n/**\n * Basic worker class providing HTTP method dispatching and error handling.\n */\nexport abstract class BasicWorker extends MiddlewareWorker {\n    /**\n     * Entry point to handle a fetch request.\n     */\n    public override async fetch(): Promise<Response> {\n        if (!this.isAllowed(this.request.method)) {\n            return this.response(MethodNotAllowed, this);\n        }\n\n        try {\n            await this.init();\n            return await super.fetch();\n        } catch (error) {\n            console.error(error);\n            return this.response(InternalServerError);\n        }\n    }\n\n    /**\n     * Dispatches the request to the method-specific handler.\n     */\n    protected override 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\n        return (handler[method] ?? (() => this.response(MethodNotAllowed, this)))();\n    }\n\n    /** Override and implement this method for `GET` requests. */\n    protected async get(): Promise<Response> {\n        return this.response(MethodNotImplemented, this);\n    }\n\n    /** Override and implement this method for `PUT` requests. */\n    protected async put(): Promise<Response> {\n        return this.response(MethodNotImplemented, this);\n    }\n\n    /** Override and implement this method for `POST` requests. */\n    protected async post(): Promise<Response> {\n        return this.response(MethodNotImplemented, this);\n    }\n\n    /** Override and implement this method for `PATCH` requests. */\n    protected async patch(): Promise<Response> {\n        return this.response(MethodNotImplemented, this);\n    }\n\n    /** Override and implement this method for `DELETE` requests. */\n    protected async delete(): Promise<Response> {\n        return this.response(MethodNotImplemented, this);\n    }\n\n    /** Returns a default empty `OPTIONS` response. */\n    protected async options(): Promise<Response> {\n        return this.response(Options);\n    }\n\n    /**\n     * Default handler for `HEAD` requests.\n     * Performs a `GET` request and removes the body for `HEAD` semantics.\n     *\n     * Usually does not need to be overridden as this behavior covers\n     * standard `HEAD` requirements.\n     */\n    protected async head(): Promise<Response> {\n        const worker = this.create(\n            new Request(this.request.url, { method: GET, headers: this.request.headers }),\n        );\n        return this.response(Head, await worker.fetch());\n    }\n\n    /**\n     * The DEFAULT allowed HTTP methods for subclasses are `GET`, `HEAD`, `OPTIONS`.\n     *\n     * These defaults were selected for getting started quickly and can be\n     * overridden for each worker subclass.\n     */\n    public getAllowedMethods(): Method[] {\n        return [GET, HEAD, OPTIONS];\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 } from \"path-to-regexp\";\nimport { MatchedRoute, Route, PathParams, RouteTable } from \"./interfaces/route\";\nimport { Method } from \"./constants/methods\";\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     * Add routes to the router.\n     *\n     * Accepts any iterable of [method, path, handler] tuples.\n     * This includes arrays, Sets, or generators.\n     *\n     * @param routes - Iterable of route tuples to add.\n     */\n    public add(routes: RouteTable): void {\n        for (const [method, path, handler] of routes) {\n            const matcher = match<PathParams>(path);\n            this.routes.push({ method, matcher, handler });\n        }\n    }\n\n    /**\n     * Attempt to match a URL against the registered routes.\n     *\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\n            const found = route.matcher(pathname);\n            if (found) return { route, params: found.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 { BasicWorker } from \"./basic\";\nimport { NotFound } from \"../errors\";\nimport { Routes } from \"../routes\";\nimport { RouteHandler, RouteTable } from \"../interfaces/route\";\nimport { WorkerClass } from \"../interfaces/worker\";\nimport { BaseWorker } from \"./base\";\nimport { Method } from \"../constants/methods\";\n\n/**\n * Base worker supporting route-based request handling.\n *\n * Subclass `RouteWorker` to define a worker with multiple route handlers.\n *\n * Routes can be registered individually via `route()` or in bulk via `routes()`.\n */\nexport abstract class RouteWorker extends BasicWorker {\n    /** Internal table of registered routes. */\n    private readonly _routes: Routes = new Routes();\n\n    /**\n     * Registers a single new route in the worker.\n     *\n     * When a request matches the specified method and path, the provided handler\n     * will be executed. The handler can be either:\n     * - A function that receives URL parameters, or\n     * - A Worker subclass that will handle the request.\n     *\n     * @param method  - HTTP method for the route (`GET`, `POST`, etc.).\n     * @param path    - URL path pattern (Express-style, e.g., \"/users/:id\").\n     * @param handler - The function or Worker class to run when the route matches.\n     * @returns The current worker instance, allowing method chaining.\n     */\n    protected route(method: Method, path: string, handler: RouteHandler): this {\n        this.routes([[method, path, handler]]);\n        return this;\n    }\n\n    /**\n     * Registers multiple routes at once in the worker.\n     *\n     * Each route should be a tuple `[method, path, handler]` where:\n     * - `method`  - HTTP method for the route (`GET`, `POST`, etc.).\n     * - `path`    - URL path pattern (Express-style, e.g., \"/users/:id\").\n     * - `handler` - A function that receives URL parameters or a Worker subclass\n     *               that will handle the request.\n     *\n     * @param routes - An iterable of routes to register. Each item is a `[method, path, handler]` tuple.\n     * @returns The current worker instance, allowing method chaining.\n     */\n    protected routes(routes: RouteTable): this {\n        this._routes.add(routes);\n        return this;\n    }\n\n    /**\n     * Matches the incoming request against registered routes and dispatches it.\n     *\n     * If a route is found:\n     * - If the handler is a Worker class, a new instance is created and its `fetch()` is called.\n     * - If the handler is a callback function, it is invoked with the extracted path parameters.\n     *\n     * If no route matches, the request is passed to the parent `dispatch()` handler.\n     *\n     * @returns A `Promise<Response>` from the matched handler or parent dispatch.\n     */\n    protected override 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        const { handler } = found.route;\n        if (RouteWorker.isWorkerClass(handler)) {\n            return new handler(this.request, this.env, this.ctx).fetch();\n        }\n        return handler.call(this, found.params);\n    }\n\n    /**\n     * Runtime type guard to check if a given handler is a Worker class.\n     *\n     * A Worker class is any class that extends `BaseWorker`.\n     *\n     * @param handler - The constructor function to test.\n     * @returns `true` if `handler` is a subclass of `BaseWorker` at runtime, `false` otherwise.\n     */\n    private static isWorkerClass(handler: RouteHandler): handler is WorkerClass {\n        return BaseWorker.prototype.isPrototypeOf(handler.prototype);\n    }\n\n    protected override async get(): Promise<Response> {\n        return this.response(NotFound);\n    }\n\n    protected override async put(): Promise<Response> {\n        return this.response(NotFound);\n    }\n\n    protected override async post(): Promise<Response> {\n        return this.response(NotFound);\n    }\n\n    protected override async patch(): Promise<Response> {\n        return this.response(NotFound);\n    }\n\n    protected override async delete(): Promise<Response> {\n        return this.response(NotFound);\n    }\n}\n"],"mappings":"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","names":["StatusCodes","CacheLib","CacheControl","Method","GET","PUT","HEAD","POST","PATCH","DELETE","OPTIONS","Time","Middleware","isStringArray","value","item","isString","isFunction","isNumber","isBoolean","assertCacheName","value","isString","assertGetKey","isFunction","assertKey","HttpHeader","FORBIDDEN_304_HEADERS","FORBIDDEN_204_HEADERS","lexCompare","a","b","setHeader","headers","key","value","raw","values","v","lexCompare","mergeHeader","merged","getHeaderValues","filterHeaders","keys","VARY_CACHE_URL","isCacheable","response","getVaryHeader","values","getHeaderValues","HttpHeader","v","lexCompare","filterVaryHeader","vary","h","value","getVaryKey","request","key","varyPairs","filtered","header","encoded","base64UrlEncode","str","utf8","binary","byte","cache","cacheName","getKey","assertCacheName","assertGetKey","CacheHandler","sortSearchParams","request","url","sorted","a","b","lexCompare","stripSearchParams","Middleware","worker","next","GET","cached","response","vary","key","getVaryKey","isCacheable","filterVaryHeader","getVaryHeader","assertKey","METHOD_SET","Method","isMethod","value","isString","isMethodArray","assertMethods","desc","getReasonPhrase","StatusCodes","UTF8_CHARSET","withCharset","mediaType","charset","assertOctetStreamInit","value","obj","size","isNumber","offset","length","BaseResponse","StatusCodes","withCharset","UTF8_CHARSET","getReasonPhrase","key","value","setHeader","mergeHeader","HttpHeader","filterHeaders","FORBIDDEN_204_HEADERS","FORBIDDEN_304_HEADERS","CacheResponse","cache","CacheControl","WorkerResponse","body","ClonedResponse","response","clone","SuccessResponse","status","JsonResponse","json","HtmlResponse","charset","TextResponse","OctetStream","_OctetStream","stream","init","assertOctetStreamInit","normalized","size","offset","length","R2ObjectStream","_R2ObjectStream","source","useCache","range","WebSocketUpgrade","client","Head","get","Options","ALLOW_ALL_ORIGINS","SIMPLE_METHODS","GET","HEAD","OPTIONS","SKIP_CORS_STATUSES","StatusCodes","defaultCorsConfig","HttpHeader","Time","options","worker","cors","Options","origin","getOrigin","setAllowOrigin","setAllowCredentials","setAllowMethods","setAllowHeaders","setMaxAge","apply","response","clone","ClonedResponse","deleteCorsHeaders","setExposedHeaders","headers","allowAllOrigins","setHeader","HttpHeader","ALLOW_ALL_ORIGINS","mergeHeader","methods","assertMethods","allowed","method","SIMPLE_METHODS","maxAge","skipCors","status","SKIP_CORS_STATUSES","request","assertCorsInit","value","obj","isStringArray","isBoolean","isNumber","cors","init","assertCorsInit","CorsHandler","Middleware","defaultCorsConfig","worker","next","OPTIONS","options","response","skipCors","apply","getReasonPhrase","StatusCodes","WS_UPGRADE","WS_WEBSOCKET","CloseCode","WS_RESERVED_CODES","HttpError","JsonResponse","status","details","json","getReasonPhrase","CacheControl","BadRequest","StatusCodes","Unauthorized","Forbidden","NotFound","MethodNotAllowed","worker","methods","assertMethods","HttpHeader","UpgradeRequired","InternalServerError","NotImplemented","MethodNotImplemented","ServiceUnavailable","hasConnectionHeader","headers","getHeaderValues","HttpHeader","value","WS_UPGRADE","hasUpgradeHeader","WS_WEBSOCKET","hasWebSocketVersion","websocket","path","WebSocketHandler","Middleware","worker","next","GET","headers","hasConnectionHeader","hasUpgradeHeader","hasWebSocketVersion","UpgradeRequired","BadRequest","request","isBinary","value","isSendable","isString","safeCloseCode","code","isNumber","isCodeInRange","isReservedCode","CloseCode","WS_RESERVED_CODES","safeReason","reason","assertSerializable","WebSocketEvents","_WebSocketEvents","type","server","listener","options","arr","finalOptions","index","ev","once","listeners","msg","BaseWebSocket","WebSocketEvents","server","data","isSendable","attachment","merged","assertSerializable","states","code","reason","safeCloseCode","safeReason","event","NewConnectionBase","BaseWebSocket","pair","client","server","ctx","tags","RestoredConnectionBase","BaseWebSocket","ws","WebSocketSessions","attachment","NewConnection","NewConnectionBase","sessions","ctx","tags","connection","ws","RestoredConnection","RestoredConnectionBase","restore","all","restored","code","reason","con","BaseWorker","_request","_env","_ctx","method","methods","assertMethods","isMethod","request","ctor","ResponseClass","args","env","ctx","assertMiddleware","handler","Middleware","MiddlewareWorker","BaseWorker","handler","assertMiddleware","next","BasicWorker","MiddlewareWorker","MethodNotAllowed","error","InternalServerError","method","MethodNotImplemented","Options","worker","GET","Head","HEAD","OPTIONS","match","Routes","routes","method","path","handler","matcher","url","pathname","route","found","RouteWorker","_RouteWorker","BasicWorker","Routes","method","path","handler","routes","found","BaseWorker","NotFound"]}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@adonix.org/cloud-spark",
-    "version": "0.0.165",
+    "version": "0.0.166",
     "description": "Ignite your Cloudflare Workers with a type-safe library for rapid development.",
     "license": "Apache-2.0",
     "type": "module",
@@ -53,7 +53,7 @@
         "tsup": "^8.5.0",
         "typescript": "^5.9.2",
         "vitest": "^3.2.4",
-        "wrangler": "^4.40.2"
+        "wrangler": "^4.40.3"
     },
     "dependencies": {
         "cache-control-parser": "^2.0.6",