@wooksjs/event-http 0.7.3 → 0.7.5

package/dist/index.cjs

@@ -28,9 +28,9 @@ const node_util = __toESM(require("node:util"));
 const node_zlib = __toESM(require("node:zlib"));
 const url = __toESM(require("url"));
 const http = __toESM(require("http"));
+const net = __toESM(require("net"));
 const wooks = __toESM(require("wooks"));
 const stream = __toESM(require("stream"));
-const net = __toESM(require("net"));
 
 //#region packages/event-http/src/http-kind.ts
 /** Event kind definition for HTTP requests. Provides typed context slots for `req`, `response`, and `requestLimits`. */
@@ -669,430 +669,80 @@ function useHttpContext(ctx) {
 }
 
 //#endregion
-//#region packages/event-http/src/errors/403.tl.svg
-function _403_tl_default(ctx) {
-	return `<svg height="64" viewBox="0 4 100 96" fill="none" xmlns="http://www.w3.org/2000/svg" stroke="#888888" stroke-width="2">
-  <path d="M50 90.625C64.4042 87.1875 83.5751 69.8667 83.5751 48.6937V24.0854L50 9.375L16.425 24.0833V48.6937C16.425 69.8667 35.5959 87.1875 50 90.625Z" fill="#ff000050">
-    <animate attributeName="fill" dur="2s" repeatCount="indefinite"
-             values="#ff000000;#ff000050;#ff000000" />
-  </path>
-
-  <path d="M61.5395 46.0812H38.4604C37.1061 46.0812 36.0083 47.1791 36.0083 48.5333V65.075C36.0083 66.4292 37.1061 67.5271 38.4604 67.5271H61.5395C62.8938 67.5271 63.9916 66.4292 63.9916 65.075V48.5333C63.9916 47.1791 62.8938 46.0812 61.5395 46.0812Z" />
-
-  <path d="M41.7834 46.0834V39.6813C41.7834 37.5021 42.6491 35.4121 44.1901 33.8712C45.731 32.3303 47.8209 31.4646 50.0001 31.4646C52.1793 31.4646 54.2693 32.3303 55.8102 33.8712C57.3511 35.4121 58.2168 37.5021 58.2168 39.6813V46.0813" />
-</svg>
-`;
+//#region packages/event-http/src/utils/time.ts
+function convertTime(time, unit = "ms") {
+	if (typeof time === "number") return time / units[unit];
+	const rg = /(\d+)(\w+)/gu;
+	let t = 0;
+	let r;
+	while (r = rg.exec(time)) t += Number(r[1]) * (units[r[2]] || 0);
+	return t / units[unit];
 }
+const units = {
+	ms: 1,
+	s: 1e3,
+	m: 1e3 * 60,
+	h: 1e3 * 60 * 60,
+	d: 1e3 * 60 * 60 * 24,
+	w: 1e3 * 60 * 60 * 24 * 7,
+	M: 1e3 * 60 * 60 * 24 * 30,
+	Y: 1e3 * 60 * 60 * 24 * 365
+};
 
 //#endregion
-//#region packages/event-http/src/errors/404.tl.svg
-function _404_tl_default(ctx) {
-	return `<svg height="64" viewBox="0 20 100 64" fill="none" xmlns="http://www.w3.org/2000/svg">
-  <defs>
-    <path id="sheet" d="M86.5 36.5V47.5H97.5V92.5H52.5V36.5H86.5ZM63 68.5H87V67.5H63V68.5ZM63 63.5H87V62.5H63V63.5ZM63 58.5H87V57.5H63V58.5ZM96.793 46.5H87.5V37.207L96.793 46.5Z" fill="#88888833" stroke="#888888aa"/>
-  </defs>
-
-  <g id="queue" transform="translate(-5 -10)">
-    <use href="#sheet" opacity="0">
-      <animateTransform attributeName="transform" type="translate"
-                        dur="3s" repeatCount="indefinite"
-                        keyTimes="0;0.1;0.32;0.42;1"
-                        values="30 0; -20 0; -20 0; -70 0; -70 0" />
-      <animate attributeName="opacity"
-               dur="3s" repeatCount="indefinite"
-                        keyTimes="0;0.1;0.32;0.42;1"
-               values="0;1;1;0;0" />
-    </use>
-
-    <use href="#sheet" opacity="0">
-      <animateTransform attributeName="transform" type="translate"
-                        dur="3s" begin="1s" repeatCount="indefinite"
-                        keyTimes="0;0.1;0.32;0.42;1"
-                        values="30 0; -20 0; -20 0; -70 0; -70 0" />
-      <animate attributeName="opacity"
-               dur="3s" begin="1s" repeatCount="indefinite"
-                        keyTimes="0;0.1;0.32;0.42;1"
-               values="0;1;1;0;0" />
-    </use>
-
-    <use href="#sheet" opacity="0">
-      <animateTransform attributeName="transform" type="translate"
-                        dur="3s" begin="2s" repeatCount="indefinite"
-                        keyTimes="0;0.1;0.32;0.42;1"
-                        values="30 0; -20 0; -20 0; -70 0; -70 0" />
-      <animate attributeName="opacity"
-               dur="3s" begin="2s" repeatCount="indefinite"
-                        keyTimes="0;0.1;0.32;0.42;1"
-               values="0;1;1;0;0" />
-    </use>
-  </g>
-
-  <g>
-    <path d="M49.5 32.5C58.3366 32.5 65.5 39.6634 65.5 48.5C65.5 54.4781 62.222 59.6923 57.3584 62.4404C55.0386 63.7512 52.3591 64.5 49.5 64.5C40.6634 64.5 33.5 57.3366 33.5 48.5C33.5 39.6634 40.6634 32.5 49.5 32.5Z" fill="#ffffff50" stroke="#888888" stroke-width="3"/>
-
-    <path d="M62.7101 74.5691C63.117 75.2907 64.0318 75.5459 64.7534 75.139C65.4751 74.7321 65.7302 73.8173 65.3233 73.0957L62.7101 74.5691ZM58.05 63.25L56.7434 63.9867L62.7101 74.5691L64.0167 73.8324L65.3233 73.0957L59.3567 62.5133L58.05 63.25Z" fill="#888888"/>
-  </g>
-</svg>
-
-`;
+//#region packages/event-http/src/utils/cache-control.ts
+/** Renders a `TCacheControl` object into a `Cache-Control` header string. */
+function renderCacheControl(data) {
+	let attrs = "";
+	for (const [a, v] of Object.entries(data)) {
+		if (v === void 0) continue;
+		const func = cacheControlFunc[a];
+		if (typeof func === "function") {
+			const val = func(v);
+			if (val) attrs += attrs ? `, ${val}` : val;
+		} else throw new TypeError(`Unknown Cache-Control attribute ${a}`);
+	}
+	return attrs;
 }
+const cacheControlFunc = {
+	mustRevalidate: (v) => v ? "must-revalidate" : "",
+	noCache: (v) => v ? typeof v === "string" ? `no-cache="${v}"` : "no-cache" : "",
+	noStore: (v) => v ? "no-store" : "",
+	noTransform: (v) => v ? "no-transform" : "",
+	public: (v) => v ? "public" : "",
+	private: (v) => v ? typeof v === "string" ? `private="${v}"` : "private" : "",
+	proxyRevalidate: (v) => v ? "proxy-revalidate" : "",
+	maxAge: (v) => `max-age=${convertTime(v, "s").toString()}`,
+	sMaxage: (v) => `s-maxage=${convertTime(v, "s").toString()}`
+};
 
 //#endregion
-//#region packages/event-http/src/errors/500.tl.svg
-function _500_tl_default(ctx) {
-	return `<svg  height="64" viewBox="0 0 120 100" xmlns="http://www.w3.org/2000/svg">
-
-  <g id="server">
-
-<g fill="#88888888" stroke="#88888888" stroke-width="2" >
-<path d="M18 90C13.5817 90 10 86.4182 10 82V38C10 33.5817 13.5817 30 18 30H50.5L58 43L52.5 53L56 68.5L49.0098 89.97L61.2141 71.4358L58.363 54.315L64.7769 43.5511L58.2763 30.2943L104.243 32.0434C108.658 32.2114 112.101 35.9267 111.933 40.3418L110.26 84.31C110.092 88.725 106.377 92.168 101.962 92L49 90H18Z" />
-</g>
-    <circle cx="30" cy="60" r="6" fill="red">
-      <animate attributeName="fill" dur="0.8s"
-               values="red;#2d0000;red" repeatCount="indefinite"/>
-    </circle>
-
-  </g>
-
-  <g fill="lightgray" opacity="0.75">
-    <circle cx="50" cy="35" r="6">
-      <animate attributeName="cy" from="35" to="15" dur="2s"
-               repeatCount="indefinite"/>
-      <animate attributeName="opacity" values="0.75;0" dur="2s"
-               repeatCount="indefinite"/>
-    </circle>
-    <circle cx="60" cy="40" r="4">
-      <animate attributeName="cy" from="40" to="20" dur="2s"
-               begin="0.4s" repeatCount="indefinite"/>
-      <animate attributeName="opacity" values="0.75;0" dur="2s"
-               begin="0.4s" repeatCount="indefinite"/>
-    </circle>
-  </g>
-
-</svg>
-`;
+//#region packages/event-http/src/utils/set-cookie.ts
+const COOKIE_NAME_RE = /^[\w!#$%&'*+\-.^`|~]+$/;
+function sanitizeCookieAttrValue(v) {
+	return v.replace(/[;\r\n]/g, "");
 }
-
-//#endregion
-//#region packages/event-http/src/errors/error.tl.html
-function error_tl_default(ctx) {
-	const { statusCode, statusMessage, icon, message, details, link, image, version } = ctx;
-	return `<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>${statusCode} ${statusMessage}</title>
-    <style>
-      body {
-        font-family:
-          -apple-system, BlinkMacMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell,
-          'Open Sans', 'Helvetica Neue', sans-serif;
-        display: flex;
-        justify-content: center;
-        align-items: flex-start;
-        min-height: 100vh;
-        margin: 0;
-        padding: 0 20px;
-        box-sizing: border-box;
-        transition:
-          background-color 0.3s ease,
-          color 0.3s ease;
-      }
-
-      .error-container {
-        padding: 48px;
-        padding-bottom: 12px !important;
-        background-color: #ffffff;
-        border-radius: 0 0 12px 12px;
-        box-shadow: 0 8px 20px rgba(0, 0, 0, 0.08);
-        text-align: center;
-        max-width: 650px;
-        width: 100%;
-        transition:
-          background-color 0.3s ease,
-          border-color 0.3s ease,
-          box-shadow 0.3s ease;
-      }
-
-      .status-code {
-        font-size: 5rem;
-        font-weight: 900;
-        margin-bottom: 5px;
-        line-height: 1;
-        transition: color 0.3s ease;
-        display: flex;
-        align-items: center;
-        justify-content: center;
-        gap: 1rem;
-        position: relative;
-        margin-right: 24px;
-      }
-
-      .status-text {
-        font-size: 2.25rem;
-        font-weight: 700;
-        margin-bottom: 25px;
-        transition: color 0.3s ease;
-      }
-
-      .error-message {
-        font-size: 1.25rem;
-        margin-bottom: 40px;
-        line-height: 1.7;
-        transition: color 0.3s ease;
-      }
-
-      .json-details-container {
-        padding: 20px;
-        border-radius: 8px;
-        text-align: left;
-        overflow-x: auto;
-        font-family: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, Courier, monospace;
-        font-size: 0.9rem;
-        border: 1px solid;
-        transition:
-          background-color 0.3s ease,
-          color 0.3s ease,
-          border-color 0.3s ease;
-      }
-
-      .json-details-container pre {
-        margin: 0;
-        white-space: pre-wrap;
-        word-break: break-all;
-      }
-
-      .json-details-container code {
-        display: block;
-      }
-
-      body {
-        background-color: #f8fafc;
-        color: #1f2937;
-      }
-      .error-container {
-        background-color: #ffffff;
-        box-shadow: 0 8px 20px rgba(0, 0, 0, 0.08);
-      }
-      .status-code {
-        color: #dc2626;
-      }
-      .status-text {
-        color: #1f2937;
-      }
-      .error-message {
-        color: #4b5563;
-      }
-      .json-details-container {
-        background-color: #f0f4f8;
-        color: #374151;
-        border-color: #d1d5db;
-      }
-      .json-details-container p {
-        color: #6b7280;
-      }
-
-      @media (prefers-color-scheme: dark) {
-        body {
-          background-color: #2d3748;
-          color: #e2e8f0;
-        }
-        .error-container {
-          background-color: #1a202c;
-          box-shadow: 0 8px 20px rgba(0, 0, 0, 0.4);
-        }
-        .status-code {
-          color: #f56565;
-        }
-        .status-text {
-          color: #cbd5e1;
-        }
-        .error-message {
-          color: #a0aec0;
-        }
-        .json-details-container {
-          background-color: #2d3748;
-          color: #e2e8f0;
-          border-color: #4a5568;
-        }
-        .json-details-container p {
-          color: #a0aec0;
-        }
-      }
-
-      .footer {
-        display: flex;
-        gap: 0.25rem;
-        font-size: 0.6em;
-        justify-content: flex-end;
-        align-items: center;
-        margin-top: 12px;
-        opacity: 0.5;
-        transition: 0.25s ease-in-out;
-      }
-
-      .footer img {
-        filter: grayscale(0.5);
-        transition: 0.25s ease-in-out;
-      }
-
-      .footer:hover {
-        opacity: 1;
-      }
-      .footer:hover img {
-        filter: grayscale(0);
-      }
-
-      @media (max-width: 768px) {
-        body {
-          padding: 15px;
-        }
-        .error-container {
-          padding: 32px;
-        }
-        .status-code {
-          font-size: 4rem;
-        }
-        .status-text {
-          font-size: 1.8rem;
-        }
-        .error-message {
-          font-size: 1.1rem;
-          margin-bottom: 30px;
-        }
-        .json-details-container {
-          font-size: 0.85rem;
-        }
-      }
-
-      @media (max-width: 480px) {
-        body {
-          padding: 10px;
-        }
-        .error-container {
-          padding: 24px;
-          border-radius: 8px;
-        }
-        .status-code {
-          font-size: 3rem;
-        }
-        .status-text {
-          font-size: 1.5rem;
-          margin-bottom: 20px;
-        }
-        .error-message {
-          font-size: 1rem;
-          margin-bottom: 25px;
-        }
-        .json-details-container {
-          padding: 15px;
-          font-size: 0.8rem;
-        }
-      }
-    </style>
-  </head>
-  <body>
-    <div class="error-container">
-      <div id="statusCode" class="status-code">${icon} ${statusCode}</div>
-
-      <div id="statusText" class="status-text">${statusMessage}</div>
-
-      <p id="errorMessage" class="error-message">${message}</p>
-
-      <!-- prettier-ignore -->
-      <div class="json-details-container"style="display: ${details ? "block" : "none"};">
-        <p class="text-sm">Technical Details:</p>
-        <pre><code id="jsonDetails">${details}</code></pre>
-      </div>
-      <div class="footer">
-        Powered by
-        <a href="${link}" target="_blank">
-          <img height="20" alt="%{poweredBy}" src="${image}" />
-        </a>
-        v${version}
-      </div>
-    </div>
-  </body>
-</html>
-`;
-}
-
-//#endregion
-//#region packages/event-http/src/utils/time.ts
-function convertTime(time, unit = "ms") {
-	if (typeof time === "number") return time / units[unit];
-	const rg = /(\d+)(\w+)/gu;
-	let t = 0;
-	let r;
-	while (r = rg.exec(time)) t += Number(r[1]) * (units[r[2]] || 0);
-	return t / units[unit];
-}
-const units = {
-	ms: 1,
-	s: 1e3,
-	m: 1e3 * 60,
-	h: 1e3 * 60 * 60,
-	d: 1e3 * 60 * 60 * 24,
-	w: 1e3 * 60 * 60 * 24 * 7,
-	M: 1e3 * 60 * 60 * 24 * 30,
-	Y: 1e3 * 60 * 60 * 24 * 365
-};
-
-//#endregion
-//#region packages/event-http/src/utils/cache-control.ts
-/** Renders a `TCacheControl` object into a `Cache-Control` header string. */
-function renderCacheControl(data) {
-	let attrs = "";
-	for (const [a, v] of Object.entries(data)) {
-		if (v === void 0) continue;
-		const func = cacheControlFunc[a];
-		if (typeof func === "function") {
-			const val = func(v);
-			if (val) attrs += attrs ? `, ${val}` : val;
-		} else throw new TypeError(`Unknown Cache-Control attribute ${a}`);
-	}
-	return attrs;
-}
-const cacheControlFunc = {
-	mustRevalidate: (v) => v ? "must-revalidate" : "",
-	noCache: (v) => v ? typeof v === "string" ? `no-cache="${v}"` : "no-cache" : "",
-	noStore: (v) => v ? "no-store" : "",
-	noTransform: (v) => v ? "no-transform" : "",
-	public: (v) => v ? "public" : "",
-	private: (v) => v ? typeof v === "string" ? `private="${v}"` : "private" : "",
-	proxyRevalidate: (v) => v ? "proxy-revalidate" : "",
-	maxAge: (v) => `max-age=${convertTime(v, "s").toString()}`,
-	sMaxage: (v) => `s-maxage=${convertTime(v, "s").toString()}`
-};
-
-//#endregion
-//#region packages/event-http/src/utils/set-cookie.ts
-const COOKIE_NAME_RE = /^[\w!#$%&'*+\-.^`|~]+$/;
-function sanitizeCookieAttrValue(v) {
-	return v.replace(/[;\r\n]/g, "");
-}
-function renderCookie(key, data) {
-	if (!COOKIE_NAME_RE.test(key)) throw new TypeError(`Invalid cookie name "${key}"`);
-	let attrs = "";
-	for (const [a, v] of Object.entries(data.attrs)) {
-		const func = cookieAttrFunc[a];
-		if (typeof func === "function") {
-			const val = func(v);
-			attrs += val ? `; ${val}` : "";
-		} else throw new TypeError(`Unknown Set-Cookie attribute ${a}`);
-	}
-	return `${key}=${encodeURIComponent(data.value)}${attrs}`;
-}
-const cookieAttrFunc = {
-	expires: (v) => `Expires=${typeof v === "string" || typeof v === "number" ? new Date(v).toUTCString() : v.toUTCString()}`,
-	maxAge: (v) => `Max-Age=${convertTime(v, "s").toString()}`,
-	domain: (v) => `Domain=${sanitizeCookieAttrValue(String(v))}`,
-	path: (v) => `Path=${sanitizeCookieAttrValue(String(v))}`,
-	secure: (v) => v ? "Secure" : "",
-	httpOnly: (v) => v ? "HttpOnly" : "",
-	sameSite: (v) => v ? `SameSite=${typeof v === "string" ? v : "Strict"}` : ""
-};
+function renderCookie(key, data) {
+	if (!COOKIE_NAME_RE.test(key)) throw new TypeError(`Invalid cookie name "${key}"`);
+	let attrs = "";
+	for (const [a, v] of Object.entries(data.attrs)) {
+		const func = cookieAttrFunc[a];
+		if (typeof func === "function") {
+			const val = func(v);
+			attrs += val ? `; ${val}` : "";
+		} else throw new TypeError(`Unknown Set-Cookie attribute ${a}`);
+	}
+	return `${key}=${encodeURIComponent(data.value)}${attrs}`;
+}
+const cookieAttrFunc = {
+	expires: (v) => `Expires=${typeof v === "string" || typeof v === "number" ? new Date(v).toUTCString() : v.toUTCString()}`,
+	maxAge: (v) => `Max-Age=${convertTime(v, "s").toString()}`,
+	domain: (v) => `Domain=${sanitizeCookieAttrValue(String(v))}`,
+	path: (v) => `Path=${sanitizeCookieAttrValue(String(v))}`,
+	secure: (v) => v ? "Secure" : "",
+	httpOnly: (v) => v ? "HttpOnly" : "",
+	sameSite: (v) => v ? `SameSite=${typeof v === "string" ? v : "Strict"}` : ""
+};
 
 //#endregion
 //#region packages/event-http/src/response/http-response.ts
@@ -1124,10 +774,11 @@ var HttpResponse = class {
 	* @param _logger - Logger instance for error reporting.
 	* @param defaultHeaders - Optional headers to pre-populate on this response (e.g. from `securityHeaders()`).
 	*/
-	constructor(_res, _req, _logger, defaultHeaders) {
+	constructor(_res, _req, _logger, defaultHeaders, _captureMode = false) {
 		this._res = _res;
 		this._req = _req;
 		this._logger = _logger;
+		this._captureMode = _captureMode;
 		if (defaultHeaders) for (const key in defaultHeaders) this._headers[key] = defaultHeaders[key];
 	}
 	_status = 0;
@@ -1261,6 +912,53 @@ var HttpResponse = class {
 	get responded() {
 		return this._responded || !this._res.writable || this._res.writableEnded;
 	}
+	/**
+	* Builds a Web Standard `Response` from the accumulated response state
+	* (status, headers, cookies, body) without writing to the underlying `ServerResponse`.
+	*
+	* Used by `WooksHttp.fetch()` for programmatic invocation.
+	*/
+	toWebResponse() {
+		this.finalizeCookies();
+		const body = this._body;
+		const method = this._req.method;
+		if (body instanceof stream.Readable) {
+			this.autoStatus(true);
+			return new globalThis.Response(method === "HEAD" ? null : stream.Readable.toWeb(body), {
+				status: this._status,
+				headers: this._buildWebHeaders()
+			});
+		}
+		if (hasFetchResponse && body instanceof globalThis.Response) {
+			this._status = this._status || body.status;
+			body.headers.forEach((v, k) => {
+				if (!this._headers[k]) this._headers[k] = v;
+			});
+			return new globalThis.Response(method === "HEAD" ? null : body.body, {
+				status: this._status,
+				headers: this._buildWebHeaders()
+			});
+		}
+		const rendered = this.renderBody();
+		this.autoStatus(!!rendered);
+		if (rendered) {
+			const contentLength = typeof rendered === "string" ? Buffer.byteLength(rendered) : rendered.byteLength;
+			this._headers["content-length"] = contentLength.toString();
+		}
+		const webResponse = new globalThis.Response(method === "HEAD" ? null : rendered || null, {
+			status: this._status,
+			headers: this._buildWebHeaders()
+		});
+		if (typeof rendered === "string" && rendered) webResponse.text = () => Promise.resolve(rendered);
+		if (typeof body === "object" && body !== null && !(body instanceof Uint8Array) && !(body instanceof stream.Readable) && !(hasFetchResponse && body instanceof globalThis.Response)) {
+			const original = body;
+			webResponse.json = () => Promise.resolve(original);
+		}
+		return webResponse;
+	}
+	_buildWebHeaders() {
+		return recordToWebHeaders(this._headers);
+	}
 	renderBody() {
 		const body = this._body;
 		if (body === void 0 || body === null) return "";
@@ -1305,6 +1003,10 @@ var HttpResponse = class {
 			throw err;
 		}
 		this._responded = true;
+		if (this._captureMode) {
+			this.finalizeCookies();
+			return;
+		}
 		this.finalizeCookies();
 		const body = this._body;
 		const method = this._req.method;
@@ -1323,6 +1025,7 @@ var HttpResponse = class {
 			if (existing) this._headers["set-cookie"] = [...Array.isArray(existing) ? existing : [existing], ...rendered];
 			else this._headers["set-cookie"] = rendered;
 		}
+		this._hasCookies = false;
 	}
 	autoStatus(hasBody) {
 		if (this._status) return;
@@ -1384,11 +1087,368 @@ var HttpResponse = class {
 		this._res.writeHead(this._status, this._headers).end(method === "HEAD" ? "" : renderedBody);
 	}
 };
+/** Converts a Record of headers to a Web Standard `Headers` object. */
+function recordToWebHeaders(record) {
+	const headers = new Headers();
+	for (const [key, value] of Object.entries(record)) if (Array.isArray(value)) for (const v of value) headers.append(key, v);
+	else if (value) headers.set(key, value);
+	return headers;
+}
+
+//#endregion
+//#region packages/event-http/src/errors/403.tl.svg
+function _403_tl_default(ctx) {
+	return `<svg height="64" viewBox="0 4 100 96" fill="none" xmlns="http://www.w3.org/2000/svg" stroke="#888888" stroke-width="2">
+  <path d="M50 90.625C64.4042 87.1875 83.5751 69.8667 83.5751 48.6937V24.0854L50 9.375L16.425 24.0833V48.6937C16.425 69.8667 35.5959 87.1875 50 90.625Z" fill="#ff000050">
+    <animate attributeName="fill" dur="2s" repeatCount="indefinite"
+             values="#ff000000;#ff000050;#ff000000" />
+  </path>
+
+  <path d="M61.5395 46.0812H38.4604C37.1061 46.0812 36.0083 47.1791 36.0083 48.5333V65.075C36.0083 66.4292 37.1061 67.5271 38.4604 67.5271H61.5395C62.8938 67.5271 63.9916 66.4292 63.9916 65.075V48.5333C63.9916 47.1791 62.8938 46.0812 61.5395 46.0812Z" />
+
+  <path d="M41.7834 46.0834V39.6813C41.7834 37.5021 42.6491 35.4121 44.1901 33.8712C45.731 32.3303 47.8209 31.4646 50.0001 31.4646C52.1793 31.4646 54.2693 32.3303 55.8102 33.8712C57.3511 35.4121 58.2168 37.5021 58.2168 39.6813V46.0813" />
+</svg>
+`;
+}
+
+//#endregion
+//#region packages/event-http/src/errors/404.tl.svg
+function _404_tl_default(ctx) {
+	return `<svg height="64" viewBox="0 20 100 64" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <path id="sheet" d="M86.5 36.5V47.5H97.5V92.5H52.5V36.5H86.5ZM63 68.5H87V67.5H63V68.5ZM63 63.5H87V62.5H63V63.5ZM63 58.5H87V57.5H63V58.5ZM96.793 46.5H87.5V37.207L96.793 46.5Z" fill="#88888833" stroke="#888888aa"/>
+  </defs>
+
+  <g id="queue" transform="translate(-5 -10)">
+    <use href="#sheet" opacity="0">
+      <animateTransform attributeName="transform" type="translate"
+                        dur="3s" repeatCount="indefinite"
+                        keyTimes="0;0.1;0.32;0.42;1"
+                        values="30 0; -20 0; -20 0; -70 0; -70 0" />
+      <animate attributeName="opacity"
+               dur="3s" repeatCount="indefinite"
+                        keyTimes="0;0.1;0.32;0.42;1"
+               values="0;1;1;0;0" />
+    </use>
+
+    <use href="#sheet" opacity="0">
+      <animateTransform attributeName="transform" type="translate"
+                        dur="3s" begin="1s" repeatCount="indefinite"
+                        keyTimes="0;0.1;0.32;0.42;1"
+                        values="30 0; -20 0; -20 0; -70 0; -70 0" />
+      <animate attributeName="opacity"
+               dur="3s" begin="1s" repeatCount="indefinite"
+                        keyTimes="0;0.1;0.32;0.42;1"
+               values="0;1;1;0;0" />
+    </use>
+
+    <use href="#sheet" opacity="0">
+      <animateTransform attributeName="transform" type="translate"
+                        dur="3s" begin="2s" repeatCount="indefinite"
+                        keyTimes="0;0.1;0.32;0.42;1"
+                        values="30 0; -20 0; -20 0; -70 0; -70 0" />
+      <animate attributeName="opacity"
+               dur="3s" begin="2s" repeatCount="indefinite"
+                        keyTimes="0;0.1;0.32;0.42;1"
+               values="0;1;1;0;0" />
+    </use>
+  </g>
+
+  <g>
+    <path d="M49.5 32.5C58.3366 32.5 65.5 39.6634 65.5 48.5C65.5 54.4781 62.222 59.6923 57.3584 62.4404C55.0386 63.7512 52.3591 64.5 49.5 64.5C40.6634 64.5 33.5 57.3366 33.5 48.5C33.5 39.6634 40.6634 32.5 49.5 32.5Z" fill="#ffffff50" stroke="#888888" stroke-width="3"/>
+
+    <path d="M62.7101 74.5691C63.117 75.2907 64.0318 75.5459 64.7534 75.139C65.4751 74.7321 65.7302 73.8173 65.3233 73.0957L62.7101 74.5691ZM58.05 63.25L56.7434 63.9867L62.7101 74.5691L64.0167 73.8324L65.3233 73.0957L59.3567 62.5133L58.05 63.25Z" fill="#888888"/>
+  </g>
+</svg>
+
+`;
+}
+
+//#endregion
+//#region packages/event-http/src/errors/500.tl.svg
+function _500_tl_default(ctx) {
+	return `<svg  height="64" viewBox="0 0 120 100" xmlns="http://www.w3.org/2000/svg">
+
+  <g id="server">
+
+<g fill="#88888888" stroke="#88888888" stroke-width="2" >
+<path d="M18 90C13.5817 90 10 86.4182 10 82V38C10 33.5817 13.5817 30 18 30H50.5L58 43L52.5 53L56 68.5L49.0098 89.97L61.2141 71.4358L58.363 54.315L64.7769 43.5511L58.2763 30.2943L104.243 32.0434C108.658 32.2114 112.101 35.9267 111.933 40.3418L110.26 84.31C110.092 88.725 106.377 92.168 101.962 92L49 90H18Z" />
+</g>
+    <circle cx="30" cy="60" r="6" fill="red">
+      <animate attributeName="fill" dur="0.8s"
+               values="red;#2d0000;red" repeatCount="indefinite"/>
+    </circle>
+
+  </g>
+
+  <g fill="lightgray" opacity="0.75">
+    <circle cx="50" cy="35" r="6">
+      <animate attributeName="cy" from="35" to="15" dur="2s"
+               repeatCount="indefinite"/>
+      <animate attributeName="opacity" values="0.75;0" dur="2s"
+               repeatCount="indefinite"/>
+    </circle>
+    <circle cx="60" cy="40" r="4">
+      <animate attributeName="cy" from="40" to="20" dur="2s"
+               begin="0.4s" repeatCount="indefinite"/>
+      <animate attributeName="opacity" values="0.75;0" dur="2s"
+               begin="0.4s" repeatCount="indefinite"/>
+    </circle>
+  </g>
+
+</svg>
+`;
+}
+
+//#endregion
+//#region packages/event-http/src/errors/error.tl.html
+function error_tl_default(ctx) {
+	const { statusCode, statusMessage, icon, message, details, link, image, version } = ctx;
+	return `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>${statusCode} ${statusMessage}</title>
+    <style>
+      body {
+        font-family:
+          -apple-system, BlinkMacMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell,
+          'Open Sans', 'Helvetica Neue', sans-serif;
+        display: flex;
+        justify-content: center;
+        align-items: flex-start;
+        min-height: 100vh;
+        margin: 0;
+        padding: 0 20px;
+        box-sizing: border-box;
+        transition:
+          background-color 0.3s ease,
+          color 0.3s ease;
+      }
+
+      .error-container {
+        padding: 48px;
+        padding-bottom: 12px !important;
+        background-color: #ffffff;
+        border-radius: 0 0 12px 12px;
+        box-shadow: 0 8px 20px rgba(0, 0, 0, 0.08);
+        text-align: center;
+        max-width: 650px;
+        width: 100%;
+        transition:
+          background-color 0.3s ease,
+          border-color 0.3s ease,
+          box-shadow 0.3s ease;
+      }
+
+      .status-code {
+        font-size: 5rem;
+        font-weight: 900;
+        margin-bottom: 5px;
+        line-height: 1;
+        transition: color 0.3s ease;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        gap: 1rem;
+        position: relative;
+        margin-right: 24px;
+      }
+
+      .status-text {
+        font-size: 2.25rem;
+        font-weight: 700;
+        margin-bottom: 25px;
+        transition: color 0.3s ease;
+      }
+
+      .error-message {
+        font-size: 1.25rem;
+        margin-bottom: 40px;
+        line-height: 1.7;
+        transition: color 0.3s ease;
+      }
+
+      .json-details-container {
+        padding: 20px;
+        border-radius: 8px;
+        text-align: left;
+        overflow-x: auto;
+        font-family: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, Courier, monospace;
+        font-size: 0.9rem;
+        border: 1px solid;
+        transition:
+          background-color 0.3s ease,
+          color 0.3s ease,
+          border-color 0.3s ease;
+      }
+
+      .json-details-container pre {
+        margin: 0;
+        white-space: pre-wrap;
+        word-break: break-all;
+      }
+
+      .json-details-container code {
+        display: block;
+      }
+
+      body {
+        background-color: #f8fafc;
+        color: #1f2937;
+      }
+      .error-container {
+        background-color: #ffffff;
+        box-shadow: 0 8px 20px rgba(0, 0, 0, 0.08);
+      }
+      .status-code {
+        color: #dc2626;
+      }
+      .status-text {
+        color: #1f2937;
+      }
+      .error-message {
+        color: #4b5563;
+      }
+      .json-details-container {
+        background-color: #f0f4f8;
+        color: #374151;
+        border-color: #d1d5db;
+      }
+      .json-details-container p {
+        color: #6b7280;
+      }
+
+      @media (prefers-color-scheme: dark) {
+        body {
+          background-color: #2d3748;
+          color: #e2e8f0;
+        }
+        .error-container {
+          background-color: #1a202c;
+          box-shadow: 0 8px 20px rgba(0, 0, 0, 0.4);
+        }
+        .status-code {
+          color: #f56565;
+        }
+        .status-text {
+          color: #cbd5e1;
+        }
+        .error-message {
+          color: #a0aec0;
+        }
+        .json-details-container {
+          background-color: #2d3748;
+          color: #e2e8f0;
+          border-color: #4a5568;
+        }
+        .json-details-container p {
+          color: #a0aec0;
+        }
+      }
+
+      .footer {
+        display: flex;
+        gap: 0.25rem;
+        font-size: 0.6em;
+        justify-content: flex-end;
+        align-items: center;
+        margin-top: 12px;
+        opacity: 0.5;
+        transition: 0.25s ease-in-out;
+      }
+
+      .footer img {
+        filter: grayscale(0.5);
+        transition: 0.25s ease-in-out;
+      }
+
+      .footer:hover {
+        opacity: 1;
+      }
+      .footer:hover img {
+        filter: grayscale(0);
+      }
+
+      @media (max-width: 768px) {
+        body {
+          padding: 15px;
+        }
+        .error-container {
+          padding: 32px;
+        }
+        .status-code {
+          font-size: 4rem;
+        }
+        .status-text {
+          font-size: 1.8rem;
+        }
+        .error-message {
+          font-size: 1.1rem;
+          margin-bottom: 30px;
+        }
+        .json-details-container {
+          font-size: 0.85rem;
+        }
+      }
+
+      @media (max-width: 480px) {
+        body {
+          padding: 10px;
+        }
+        .error-container {
+          padding: 24px;
+          border-radius: 8px;
+        }
+        .status-code {
+          font-size: 3rem;
+        }
+        .status-text {
+          font-size: 1.5rem;
+          margin-bottom: 20px;
+        }
+        .error-message {
+          font-size: 1rem;
+          margin-bottom: 25px;
+        }
+        .json-details-container {
+          padding: 15px;
+          font-size: 0.8rem;
+        }
+      }
+    </style>
+  </head>
+  <body>
+    <div class="error-container">
+      <div id="statusCode" class="status-code">${icon} ${statusCode}</div>
+
+      <div id="statusText" class="status-text">${statusMessage}</div>
+
+      <p id="errorMessage" class="error-message">${message}</p>
+
+      <!-- prettier-ignore -->
+      <div class="json-details-container"style="display: ${details ? "block" : "none"};">
+        <p class="text-sm">Technical Details:</p>
+        <pre><code id="jsonDetails">${details}</code></pre>
+      </div>
+      <div class="footer">
+        Powered by
+        <a href="${link}" target="_blank">
+          <img height="20" alt="%{poweredBy}" src="${image}" />
+        </a>
+        v${version}
+      </div>
+    </div>
+  </body>
+</html>
+`;
+}
 
 //#endregion
 //#region packages/event-http/src/response/wooks-http-response.ts
 let framework = {
-	version: "0.7.2",
+	version: "0.7.4",
 	poweredBy: "wooksjs",
 	link: "https://wooks.moost.org/",
 	image: "https://wooks.moost.org/wooks-full-logo.svg"
@@ -1459,6 +1519,13 @@ function renderErrorText(data) {
 
 //#endregion
 //#region packages/event-http/src/http-adapter.ts
+const DEFAULT_FORWARD_HEADERS = [
+	"authorization",
+	"cookie",
+	"accept-language",
+	"x-forwarded-for",
+	"x-request-id"
+];
 /** HTTP adapter for Wooks that provides route registration, server lifecycle, and request handling. */
 var WooksHttp = class extends wooks.WooksAdapterBase {
 	logger;
@@ -1720,7 +1787,127 @@ var WooksHttp = class extends wooks.WooksAdapterBase {
 			}
 		}
 	}
+	/**
+	* Programmatic route invocation using the Web Standard fetch API.
+	* Goes through the full dispatch pipeline: context creation, route matching,
+	* handler execution, response finalization.
+	*
+	* When called from within an existing HTTP context (e.g. during SSR),
+	* identity headers (authorization, cookie) are automatically forwarded
+	* from the calling request unless already present on the given Request.
+	*
+	* @param request - A Web Standard Request object.
+	* @returns A Web Standard Response.
+	*/
+	async fetch(request) {
+		const url$1 = new URL(request.url);
+		const method = request.method;
+		const pathname = url$1.pathname + url$1.search;
+		const callerCtx = (0, __wooksjs_event_core.tryGetCurrent)();
+		let callerReq;
+		if (callerCtx) try {
+			callerReq = callerCtx.get(httpKind.keys.req);
+		} catch {}
+		const fakeReq = createFakeIncomingMessage(request, pathname, callerReq, this.opts?.forwardHeaders);
+		const fakeRes = new http.ServerResponse(fakeReq);
+		const rawChunks = [];
+		const rawHeaders = {};
+		let rawStatusCode = 0;
+		fakeRes.writeHead = (...args) => {
+			rawStatusCode = args[0];
+			for (const arg of args) if (typeof arg === "object" && arg !== null) for (const [k, v] of Object.entries(arg)) rawHeaders[k] = v;
+			return fakeRes;
+		};
+		fakeRes.write = (chunk, ...args) => {
+			if (chunk !== null && chunk !== void 0) rawChunks.push(typeof chunk === "string" ? buffer.Buffer.from(chunk) : chunk);
+			const cb = args.find((a) => typeof a === "function");
+			if (cb) cb();
+			return true;
+		};
+		fakeRes.end = (chunk, ...args) => {
+			if (chunk !== null && chunk !== void 0 && typeof chunk !== "function") rawChunks.push(typeof chunk === "string" ? buffer.Buffer.from(chunk) : chunk);
+			const cb = args.find((a) => typeof a === "function");
+			if (cb) cb();
+			return fakeRes;
+		};
+		const response = new this.ResponseClass(fakeRes, fakeReq, this.logger, this.opts?.defaultHeaders, true);
+		let bodyBuffer;
+		if (request.body) bodyBuffer = buffer.Buffer.from(await request.bytes());
+		const ctxOptions = this.eventContextOptions;
+		const requestLimits = this.opts?.requestLimits;
+		const notFoundHandler = this.opts?.onNotFound;
+		return createHttpContext(ctxOptions, {
+			req: fakeReq,
+			response,
+			requestLimits
+		}, async () => {
+			const ctx = (0, __wooksjs_event_core.current)();
+			if (bodyBuffer) ctx.set(rawBodySlot, Promise.resolve(bodyBuffer));
+			try {
+				const handlers = this.wooks.lookupHandlers(method, pathname, ctx);
+				if (handlers || notFoundHandler) {
+					const result = this.processHandlers(handlers || [notFoundHandler], ctx, response);
+					if (result !== null && result !== void 0 && typeof result.then === "function") await result.catch((error) => {
+						if (!response.responded) this.respond(error, response, ctx);
+					});
+				} else {
+					const error = new HttpError(404);
+					this.respond(error, response, ctx);
+				}
+			} finally {
+				fakeReq.emit("end");
+				fakeReq.emit("close");
+			}
+			let webResponse;
+			if (rawChunks.length > 0 || rawStatusCode > 0) {
+				const body = buffer.Buffer.concat(rawChunks);
+				webResponse = new Response(body.length > 0 ? body : null, {
+					status: rawStatusCode || 200,
+					headers: recordToWebHeaders(rawHeaders)
+				});
+			} else webResponse = response.toWebResponse();
+			if (callerReq) try {
+				const parentResponse = callerCtx?.get(httpKind.keys.response);
+				if (parentResponse) for (const cookie of webResponse.headers.getSetCookie()) parentResponse.setCookieRaw(cookie);
+			} catch {}
+			fakeReq.destroy();
+			fakeRes.destroy();
+			return webResponse;
+		});
+	}
+	/**
+	* Convenience wrapper for programmatic route invocation.
+	* Accepts a URL string (relative paths auto-prefixed with `http://localhost`),
+	* URL object, or Request, plus optional `RequestInit`.
+	*
+	* @param input - URL string, URL object, or Request.
+	* @param init - Optional RequestInit (method, headers, body, etc.).
+	* @returns A Web Standard Response.
+	*/
+	request(input, init) {
+		if (typeof input === "string" && !input.startsWith("http://") && !input.startsWith("https://")) input = `http://localhost${input.startsWith("/") ? "" : "/"}${input}`;
+		const req = input instanceof Request ? input : new Request(input, init);
+		return this.fetch(req);
+	}
 };
+function createFakeIncomingMessage(request, pathname, forwardFrom, forwardHeaders) {
+	const req = new http.IncomingMessage(new net.Socket({}));
+	req.method = request.method;
+	req.url = pathname;
+	const headers = {};
+	if (forwardFrom && forwardHeaders !== false) {
+		const headerList = Array.isArray(forwardHeaders) ? forwardHeaders : DEFAULT_FORWARD_HEADERS;
+		for (const h of headerList) {
+			const val = forwardFrom.headers[h];
+			if (typeof val === "string" && val) headers[h] = val;
+		}
+	}
+	request.headers.forEach((value, key) => {
+		headers[key] = value;
+	});
+	req.headers = headers;
+	return req;
+}
 /**
 * Creates a new WooksHttp application instance.
 * @example
@@ -1844,6 +2031,7 @@ exports.httpKind = httpKind;
 exports.httpStatusCodes = httpStatusCodes;
 exports.prepareTestHttpContext = prepareTestHttpContext;
 exports.rawBodySlot = rawBodySlot;
+exports.recordToWebHeaders = recordToWebHeaders;
 exports.renderCacheControl = renderCacheControl;
 exports.securityHeaders = securityHeaders;
 exports.useAccept = useAccept;