acrylblends 0.4.1 → 0.5.1

package/lib/serve-static-Dw_m6KxR.js

@@ -0,0 +1,213 @@
+import { getMimeType } from "./utils/mime.js";
+import "./factory.js";
+import "./connection-C7xgP1hP.js";
+import { Readable } from "node:stream";
+import { createReadStream, existsSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { versions } from "node:process";
+//#region ../../plugins/acryl-node-server/src/adapter/utils/stream.ts
+const pr54206Applied = () => {
+	const [major, minor] = versions.node.split(".").map((component) => parseInt(component));
+	return major >= 23 || major === 22 && minor >= 7 || major === 20 && minor >= 18;
+};
+const useReadableToWeb = pr54206Applied();
+const createStreamBody = (stream, useNativeReadableToWeb = useReadableToWeb) => {
+	if (useNativeReadableToWeb) return Readable.toWeb(stream);
+	let controller;
+	let settled = false;
+	const cleanup = () => {
+		stream.off("data", onData);
+		stream.off("error", onError);
+		stream.off("end", onTerminate);
+		stream.off("close", onTerminate);
+	};
+	const settle = (callback) => {
+		if (settled) return;
+		settled = true;
+		cleanup();
+		callback?.();
+	};
+	const onData = (chunk) => {
+		if (settled || !controller) return;
+		controller.enqueue(chunk);
+		if ((controller.desiredSize ?? 0) <= 0) stream.pause();
+	};
+	const onError = (error) => {
+		settle(() => {
+			controller?.error(error);
+		});
+	};
+	const onTerminate = () => {
+		settle(() => {
+			controller?.close();
+		});
+	};
+	return new ReadableStream({
+		start(streamController) {
+			controller = streamController;
+			stream.on("data", onData);
+			stream.on("error", onError);
+			stream.on("end", onTerminate);
+			stream.on("close", onTerminate);
+			stream.pause();
+		},
+		pull() {
+			if (!settled) stream.resume();
+		},
+		cancel() {
+			settle();
+			const ignoreError = () => {};
+			stream.on("error", ignoreError);
+			stream.once("close", () => stream.off("error", ignoreError));
+			stream.destroy();
+		}
+	});
+};
+//#endregion
+//#region ../../plugins/acryl-node-server/src/adapter/serve-static.ts
+const COMPRESSIBLE_CONTENT_TYPE_REGEX = /^\s*(?:text\/[^;\s]+|application\/(?:javascript|json|xml|xml-dtd|ecmascript|dart|postscript|rtf|tar|toml|vnd\.dart|vnd\.ms-fontobject|vnd\.ms-opentype|wasm|x-httpd-php|x-javascript|x-ns-proxy-autoconfig|x-sh|x-tar|x-virtualbox-hdd|x-virtualbox-ova|x-virtualbox-ovf|x-virtualbox-vbox|x-virtualbox-vdi|x-virtualbox-vhd|x-virtualbox-vmdk|x-www-form-urlencoded)|font\/(?:otf|ttf)|image\/(?:bmp|vnd\.adobe\.photoshop|vnd\.microsoft\.icon|vnd\.ms-dds|x-icon|x-ms-bmp)|message\/rfc822|model\/gltf-binary|x-shader\/x-fragment|x-shader\/x-vertex|[^;\s]+?\+(?:json|text|xml|yaml))(?:[;\s]|$)/i;
+const ENCODINGS = {
+	br: ".br",
+	zstd: ".zst",
+	gzip: ".gz"
+};
+const ENCODINGS_ORDERED_KEYS = Object.keys(ENCODINGS);
+const getStats = (path) => {
+	let stats;
+	try {
+		stats = statSync(path);
+	} catch {}
+	return stats;
+};
+const BYTE_RANGE_PATTERN = /^(?:bytes=)?(?!-$)(\d*)-(\d*)$/;
+const parseByteRange = (range) => {
+	const match = range.match(BYTE_RANGE_PATTERN);
+	if (!match) return;
+	const [, start, end] = match;
+	if (start === "") return {
+		type: "suffix",
+		length: Number(end)
+	};
+	if (end === "") return {
+		type: "open-ended",
+		start: Number(start)
+	};
+	return {
+		type: "bounded",
+		start: Number(start),
+		end: Number(end)
+	};
+};
+const resolveByteRange = (spec, size) => {
+	if (size === 0) return;
+	if (spec.type === "suffix") {
+		if (spec.length === 0) return;
+		return {
+			start: Math.max(size - spec.length, 0),
+			end: size - 1
+		};
+	}
+	const end = spec.type === "bounded" ? Math.min(spec.end, size - 1) : size - 1;
+	if (spec.start >= size || spec.start > end) return;
+	return {
+		start: spec.start,
+		end
+	};
+};
+const tryDecode = (str, decoder) => {
+	try {
+		return decoder(str);
+	} catch {
+		return str.replace(/(?:%[0-9A-Fa-f]{2})+/g, (match) => {
+			try {
+				return decoder(match);
+			} catch {
+				return match;
+			}
+		});
+	}
+};
+const tryDecodeURI = (str) => tryDecode(str, decodeURI);
+const serveStatic = (options = { root: "" }) => {
+	const root = options.root || "";
+	const optionPath = options.path;
+	if (root !== "" && !existsSync(root)) console.error(`serveStatic: root path '${root}' is not found, are you sure it's correct?`);
+	return async (c, next) => {
+		if (c.finalized) return next();
+		if (c.req.method !== "GET" && c.req.method !== "HEAD") return next();
+		let filename;
+		if (optionPath) filename = optionPath;
+		else try {
+			if (!options.allowPercentInPath && c.req.path.includes("%")) throw new Error();
+			filename = tryDecodeURI(c.req.path);
+			if (/(?:^|[\/\\])\.{1,2}(?:$|[\/\\])|[\/\\]{2,}|\\/.test(filename)) throw new Error();
+		} catch {
+			await options.onNotFound?.(c.req.path, c);
+			return next();
+		}
+		let path = join(root, !optionPath && options.rewriteRequestPath ? options.rewriteRequestPath(filename, c) : filename);
+		let stats = getStats(path);
+		if (stats && stats.isDirectory()) {
+			const indexFile = options.index ?? "index.html";
+			path = join(path, indexFile);
+			stats = getStats(path);
+		}
+		if (!stats) {
+			await options.onNotFound?.(path, c);
+			return next();
+		}
+		const mimeType = getMimeType(path);
+		c.header("Content-Type", mimeType || "application/octet-stream");
+		if (options.precompressed && (!mimeType || mimeType === "application/octet-stream" || COMPRESSIBLE_CONTENT_TYPE_REGEX.test(mimeType))) {
+			const acceptEncodingSet = new Set(c.req.header("Accept-Encoding")?.split(",").map((encoding) => encoding.trim()));
+			for (const encoding of ENCODINGS_ORDERED_KEYS) {
+				if (!acceptEncodingSet.has(encoding)) continue;
+				const precompressedStats = getStats(path + ENCODINGS[encoding]);
+				if (precompressedStats) {
+					c.header("Content-Encoding", encoding);
+					c.header("Vary", "Accept-Encoding", { append: true });
+					stats = precompressedStats;
+					path = path + ENCODINGS[encoding];
+					break;
+				}
+			}
+		}
+		let result;
+		const size = stats.size;
+		const range = c.req.header("range") || "";
+		c.header("Last-Modified", stats.mtime.toUTCString());
+		if (c.req.method === "HEAD") {
+			c.header("Content-Length", size.toString());
+			c.status(200);
+			result = c.body(null);
+		} else if (!range) {
+			c.header("Content-Length", size.toString());
+			result = c.body(createStreamBody(createReadStream(path)), 200);
+		} else {
+			c.header("Accept-Ranges", "bytes");
+			const rangeSpec = parseByteRange(range) ?? {
+				type: "open-ended",
+				start: 0
+			};
+			const resolvedRange = resolveByteRange(rangeSpec, size);
+			if (!resolvedRange) {
+				c.header("Content-Range", `bytes */${size}`);
+				result = c.body(null, 416);
+			} else {
+				const { start, end } = resolvedRange;
+				const chunkSize = end - start + 1;
+				const stream = createReadStream(path, {
+					start,
+					end
+				});
+				c.header("Content-Length", chunkSize.toString());
+				c.header("Content-Range", `bytes ${start}-${end}/${size}`);
+				result = c.body(createStreamBody(stream), 206);
+			}
+		}
+		await options.onFound?.(path, c);
+		return result;
+	};
+};
+//#endregion
+export { serveStatic as t };

package/lib/serve-static.d.ts

@@ -0,0 +1,31 @@
+import { I as MiddlewareHandler, _ as Env, i as Data, t as Context } from "./context-Bm7rI-oK.js";
+
+//#region ../../plugins/acryl-router/src/core/middleware/serve-static/index.d.ts
+type ServeStaticOptions<E extends Env = Env> = {
+  root?: string;
+  path?: string;
+  precompressed?: boolean; /** Allow percent signs in the routed request path. Defaults to false. */
+  allowPercentInPath?: boolean;
+  mimes?: Record<string, string>;
+  rewriteRequestPath?: (path: string) => string;
+  onFound?: (path: string, c: Context<E>) => void | Promise<void>;
+  onNotFound?: (path: string, c: Context<E>) => void | Promise<void>;
+};
+/**
+ * This middleware is not directly used by the user. Create a wrapper specifying `getContent()` by the environment such as Deno or Bun.
+ */
+declare const serveStatic: <E extends Env = Env>(options: ServeStaticOptions<E> & {
+  getContent: (path: string, c: Context<E>) => Promise<Data | Response | null>;
+  /**
+   *
+   * `join` option according to the runtime. Example `import { join } from 'node:path`. If not specified, it will fall back to the default join function.`
+   */
+  join?: (...paths: string[]) => string;
+  /**
+   * @deprecated Currently, `pathResolve` is no longer used.
+   */
+  pathResolve?: (path: string) => string;
+  isDir?: (path: string) => boolean | undefined | Promise<boolean | undefined>;
+}) => MiddlewareHandler;
+//#endregion
+export { ServeStaticOptions, serveStatic };

package/lib/serve-static.js

@@ -0,0 +1,77 @@
+import { tryDecodeURI } from "./utils/url.js";
+import { parseAccept } from "./utils/accept.js";
+import { COMPRESSIBLE_CONTENT_TYPE_REGEX } from "./utils/compress.js";
+import { getMimeType } from "./utils/mime.js";
+//#region ../../plugins/acryl-router/src/core/middleware/serve-static/path.ts
+/**
+* `defaultJoin` does not support Windows paths and always uses `/` separators.
+* If you need Windows path support, please use `join` exported from `node:path` etc. instead.
+*/
+const defaultJoin = (...paths) => {
+	let result = paths.filter((p) => p !== "").join("/");
+	result = result.replace(/(?<=\/)\/+/g, "");
+	const segments = result.split("/");
+	const resolved = [];
+	for (const segment of segments) if (segment === ".." && resolved.length > 0 && resolved.at(-1) !== "..") resolved.pop();
+	else if (segment !== ".") resolved.push(segment);
+	return resolved.join("/") || ".";
+};
+//#endregion
+//#region ../../plugins/acryl-router/src/core/middleware/serve-static/index.ts
+const ENCODINGS = {
+	br: ".br",
+	zstd: ".zst",
+	gzip: ".gz"
+};
+const ENCODINGS_ORDERED_KEYS = Object.keys(ENCODINGS);
+const DEFAULT_DOCUMENT = "index.html";
+/**
+* This middleware is not directly used by the user. Create a wrapper specifying `getContent()` by the environment such as Deno or Bun.
+*/
+const serveStatic = (options) => {
+	const root = options.root ?? "./";
+	const optionPath = options.path;
+	const join = options.join ?? defaultJoin;
+	return async (c, next) => {
+		if (c.finalized) return next();
+		if (c.req.method !== "GET" && c.req.method !== "HEAD") return next();
+		let filename;
+		if (options.path) filename = options.path;
+		else try {
+			if (!options.allowPercentInPath && c.req.path.includes("%")) throw new Error();
+			filename = tryDecodeURI(c.req.path);
+			if (/(?:^|[\/\\])\.{1,2}(?:$|[\/\\])|[\/\\]{2,}|\\/.test(filename)) throw new Error();
+		} catch {
+			await options.onNotFound?.(c.req.path, c);
+			return next();
+		}
+		let path = join(root, !optionPath && options.rewriteRequestPath ? options.rewriteRequestPath(filename) : filename);
+		if (options.isDir && await options.isDir(path)) path = join(path, DEFAULT_DOCUMENT);
+		const getContent = options.getContent;
+		let content = await getContent(path, c);
+		if (content instanceof Response) return c.newResponse(content.body, content);
+		if (content != null) {
+			const mimeType = options.mimes && getMimeType(path, options.mimes) || getMimeType(path);
+			c.header("Content-Type", mimeType || "application/octet-stream");
+			if (options.precompressed && (!mimeType || COMPRESSIBLE_CONTENT_TYPE_REGEX.test(mimeType))) {
+				const acceptEncodingSet = new Set(parseAccept(c.req.header("Accept-Encoding") ?? "").filter((encoding) => encoding.q > 0).map((encoding) => encoding.type));
+				for (const encoding of ENCODINGS_ORDERED_KEYS) {
+					if (!acceptEncodingSet.has(encoding)) continue;
+					const compressedContent = await getContent(path + ENCODINGS[encoding], c);
+					if (compressedContent) {
+						content = compressedContent;
+						c.header("Content-Encoding", encoding);
+						c.header("Vary", "Accept-Encoding", { append: true });
+						break;
+					}
+				}
+			}
+			await options.onFound?.(path, c);
+			return c.body(content);
+		}
+		await options.onNotFound?.(path, c);
+		await next();
+	};
+};
+//#endregion
+export { serveStatic };

package/lib/smart-router-C5CZ5XSM.js

@@ -0,0 +1,49 @@
+import { MESSAGE_MATCHER_IS_ALREADY_BUILT, UnsupportedPathError } from "./router.js";
+//#region ../../plugins/acryl-router/src/core/router/smart-router/router.ts
+var SmartRouter = class {
+	name = "SmartRouter";
+	#routers = [];
+	#routes = [];
+	constructor(init) {
+		this.#routers = init.routers;
+	}
+	add(method, path, handler) {
+		if (!this.#routes) throw new Error(MESSAGE_MATCHER_IS_ALREADY_BUILT);
+		this.#routes.push([
+			method,
+			path,
+			handler
+		]);
+	}
+	match(method, path) {
+		if (!this.#routes) throw new Error("Fatal error");
+		const routers = this.#routers;
+		const routes = this.#routes;
+		const len = routers.length;
+		let i = 0;
+		let res;
+		for (; i < len; i++) {
+			const router = routers[i];
+			try {
+				for (let i = 0, len = routes.length; i < len; i++) router.add(...routes[i]);
+				res = router.match(method, path);
+			} catch (e) {
+				if (e instanceof UnsupportedPathError) continue;
+				throw e;
+			}
+			this.match = router.match.bind(router);
+			this.#routers = [router];
+			this.#routes = void 0;
+			break;
+		}
+		if (i === len) throw new Error("Fatal error");
+		this.name = `SmartRouter + ${this.activeRouter.name}`;
+		return res;
+	}
+	get activeRouter() {
+		if (this.#routes || this.#routers.length !== 1) throw new Error("No active router has been determined yet.");
+		return this.#routers[0];
+	}
+};
+//#endregion
+export { SmartRouter as t };

package/lib/stream-CPdqZ0Fp.d.ts

@@ -0,0 +1,34 @@
+//#region ../../plugins/acryl-router/src/core/utils/stream.d.ts
+/**
+ * @module
+ * Stream utility.
+ */
+declare class StreamingApi {
+  private writer;
+  private encoder;
+  private writable;
+  private abortSubscribers;
+  responseReadable: ReadableStream;
+  /**
+   * Whether the stream has been aborted.
+   */
+  aborted: boolean;
+  /**
+   * Whether the stream has been closed normally.
+   */
+  closed: boolean;
+  constructor(writable: WritableStream, _readable: ReadableStream);
+  write(input: Uint8Array | string): Promise<StreamingApi>;
+  writeln(input: string): Promise<StreamingApi>;
+  sleep(ms: number): Promise<unknown>;
+  close(): Promise<void>;
+  pipe(body: ReadableStream): Promise<void>;
+  onAbort(listener: () => void | Promise<void>): void;
+  /**
+   * Abort the stream.
+   * You can call this method when stream is aborted by external event.
+   */
+  abort(): void;
+}
+//#endregion
+export { StreamingApi as t };

package/lib/streaming-DHST3Scg.js

@@ -0,0 +1,96 @@
+import { HtmlEscapedCallbackPhase, resolveCallback } from "./utils/html.js";
+import { n as TEXT_PLAIN } from "./context-DDO0cfuP.js";
+import { StreamingApi } from "./utils/stream.js";
+//#region ../../plugins/acryl-router/src/core/helper/streaming/utils.ts
+let isOldBunVersion = () => {
+	const version = typeof Bun !== "undefined" ? Bun.version : void 0;
+	if (version === void 0) return false;
+	const result = version.startsWith("1.1") || version.startsWith("1.0") || version.startsWith("0.");
+	isOldBunVersion = () => result;
+	return result;
+};
+//#endregion
+//#region ../../plugins/acryl-router/src/core/helper/streaming/stream.ts
+const contextStash$1 = /* @__PURE__ */ new WeakMap();
+const stream = (c, cb, onError) => {
+	const { readable, writable } = new TransformStream();
+	const stream = new StreamingApi(writable, readable);
+	if (isOldBunVersion()) c.req.raw.signal.addEventListener("abort", () => {
+		if (!stream.closed) stream.abort();
+	});
+	contextStash$1.set(stream.responseReadable, c);
+	(async () => {
+		try {
+			await cb(stream);
+		} catch (e) {
+			if (e === void 0) {} else if (e instanceof Error && onError) await onError(e, stream);
+			else console.error(e);
+		} finally {
+			stream.close();
+		}
+	})();
+	return c.newResponse(stream.responseReadable);
+};
+//#endregion
+//#region ../../plugins/acryl-router/src/core/helper/streaming/sse.ts
+var SSEStreamingApi = class extends StreamingApi {
+	constructor(writable, readable) {
+		super(writable, readable);
+	}
+	async writeSSE(message) {
+		const dataLines = (await resolveCallback(message.data, HtmlEscapedCallbackPhase.Stringify, false, {})).split(/\r\n|\r|\n/).map((line) => {
+			return `data: ${line}`;
+		}).join("\n");
+		for (const key of ["event", "id"]) {
+			const value = message[key];
+			if (value && /[\r\n]/.test(value)) throw new Error(`${key} must not contain "\\r" or "\\n"`);
+		}
+		const sseData = [
+			message.event && `event: ${message.event}`,
+			dataLines,
+			message.id !== void 0 && `id: ${message.id}`,
+			message.retry !== void 0 && `retry: ${message.retry}`
+		].filter(Boolean).join("\n") + "\n\n";
+		await this.write(sseData);
+	}
+};
+const run = async (stream, cb, onError) => {
+	try {
+		await cb(stream);
+	} catch (e) {
+		if (e instanceof Error && onError) {
+			await onError(e, stream);
+			await stream.writeSSE({
+				event: "error",
+				data: e.message
+			});
+		} else console.error(e);
+	} finally {
+		stream.close();
+	}
+};
+const contextStash = /* @__PURE__ */ new WeakMap();
+const streamSSE = (c, cb, onError) => {
+	const { readable, writable } = new TransformStream();
+	const stream = new SSEStreamingApi(writable, readable);
+	if (isOldBunVersion()) c.req.raw.signal.addEventListener("abort", () => {
+		if (!stream.closed) stream.abort();
+	});
+	contextStash.set(stream.responseReadable, c);
+	c.header("Transfer-Encoding", "chunked");
+	c.header("Content-Type", "text/event-stream");
+	c.header("Cache-Control", "no-cache");
+	c.header("Connection", "keep-alive");
+	run(stream, cb, onError);
+	return c.newResponse(stream.responseReadable);
+};
+//#endregion
+//#region ../../plugins/acryl-router/src/core/helper/streaming/text.ts
+const streamText = (c, cb, onError) => {
+	c.header("Content-Type", TEXT_PLAIN);
+	c.header("X-Content-Type-Options", "nosniff");
+	c.header("Transfer-Encoding", "chunked");
+	return stream(c, cb, onError);
+};
+//#endregion
+export { stream as i, SSEStreamingApi as n, streamSSE as r, streamText as t };

package/lib/streaming.d.ts

@@ -0,0 +1,23 @@
+import { t as Context } from "./context-Bm7rI-oK.js";
+import { t as StreamingApi } from "./stream-CPdqZ0Fp.js";
+
+//#region ../../plugins/acryl-router/src/core/helper/streaming/stream.d.ts
+declare const stream: (c: Context, cb: (stream: StreamingApi) => Promise<void>, onError?: (e: Error, stream: StreamingApi) => Promise<void>) => Response;
+//#endregion
+//#region ../../plugins/acryl-router/src/core/helper/streaming/sse.d.ts
+interface SSEMessage {
+  data: string | Promise<string>;
+  event?: string;
+  id?: string;
+  retry?: number;
+}
+declare class SSEStreamingApi extends StreamingApi {
+  constructor(writable: WritableStream, readable: ReadableStream);
+  writeSSE(message: SSEMessage): Promise<void>;
+}
+declare const streamSSE: (c: Context, cb: (stream: SSEStreamingApi) => Promise<void>, onError?: (e: Error, stream: SSEStreamingApi) => Promise<void>) => Response;
+//#endregion
+//#region ../../plugins/acryl-router/src/core/helper/streaming/text.d.ts
+declare const streamText: (c: Context, cb: (stream: StreamingApi) => Promise<void>, onError?: (e: Error, stream: StreamingApi) => Promise<void>) => Response;
+//#endregion
+export { type SSEMessage, SSEStreamingApi, stream, streamSSE, streamText };

package/lib/streaming.js

@@ -0,0 +1,2 @@
+import { i as stream, n as SSEStreamingApi, r as streamSSE, t as streamText } from "./streaming-DHST3Scg.js";
+export { SSEStreamingApi, stream, streamSSE, streamText };

package/lib/testing.d.ts

@@ -0,0 +1,10 @@
+import { J as Schema, a as ExecutionContext } from "./context-Bm7rI-oK.js";
+import { T as UnionToIntersection } from "./types-CwrQjlaM.js";
+import { t as Acryl } from "./app-CmAYW1Al.js";
+import { i as ClientRequestOptions, n as Client } from "./types-CHesD1KG.js";
+
+//#region ../../plugins/acryl-router/src/core/helper/testing/index.d.ts
+type ExtractEnv<T> = T extends Acryl<infer E, Schema, string> ? E : never;
+declare const testClient: <T extends Acryl<any, Schema, string>>(app: T, Env?: ExtractEnv<T>["Bindings"] | {}, executionCtx?: ExecutionContext, options?: Omit<ClientRequestOptions, "fetch">) => UnionToIntersection<Client<T, "http://localhost">>;
+//#endregion
+export { testClient };

package/lib/testing.js

@@ -0,0 +1,17 @@
+import { t as hc } from "./client-BHTr318g.js";
+//#region ../../plugins/acryl-router/src/core/helper/testing/index.ts
+/**
+* @module
+* Testing Helper for Acryl.
+*/
+const testClient = (app, Env, executionCtx, options) => {
+	const customFetch = (input, init) => {
+		return app.request(input, init, Env, executionCtx);
+	};
+	return hc("http://localhost", {
+		...options,
+		fetch: customFetch
+	});
+};
+//#endregion
+export { testClient };

package/lib/timeout.d.ts

@@ -0,0 +1,30 @@
+import { I as MiddlewareHandler, t as Context } from "./context-Bm7rI-oK.js";
+import { HTTPException } from "./http-exception.js";
+
+//#region ../../plugins/acryl-router/src/core/middleware/timeout/index.d.ts
+type HTTPExceptionFunction = (context: Context) => HTTPException;
+/**
+ * Timeout Middleware for Acryl.
+ *
+ * @param {number} duration - The timeout duration in milliseconds.
+ * @param {HTTPExceptionFunction | HTTPException} [exception=defaultTimeoutException] - The exception to throw when the timeout occurs. Can be a function that returns an HTTPException or an HTTPException object.
+ * @returns {MiddlewareHandler} The middleware handler function.
+ *
+ * @example
+ * ```ts
+ * const app = new Acryl()
+ *
+ * app.use(
+ *   '/long-request',
+ *   timeout(5000) // Set timeout to 5 seconds
+ * )
+ *
+ * app.get('/long-request', async (c) => {
+ *   await someLongRunningFunction()
+ *   return c.text('Completed within time limit')
+ * })
+ * ```
+ */
+declare const timeout: (duration: number, exception?: HTTPExceptionFunction | HTTPException) => MiddlewareHandler;
+//#endregion
+export { HTTPExceptionFunction, timeout };

package/lib/timeout.js

@@ -0,0 +1,42 @@
+import { HTTPException } from "./http-exception.js";
+//#region ../../plugins/acryl-router/src/core/middleware/timeout/index.ts
+const defaultTimeoutException = new HTTPException(504, { message: "Gateway Timeout" });
+/**
+* Timeout Middleware for Acryl.
+*
+* @param {number} duration - The timeout duration in milliseconds.
+* @param {HTTPExceptionFunction | HTTPException} [exception=defaultTimeoutException] - The exception to throw when the timeout occurs. Can be a function that returns an HTTPException or an HTTPException object.
+* @returns {MiddlewareHandler} The middleware handler function.
+*
+* @example
+* ```ts
+* const app = new Acryl()
+*
+* app.use(
+*   '/long-request',
+*   timeout(5000) // Set timeout to 5 seconds
+* )
+*
+* app.get('/long-request', async (c) => {
+*   await someLongRunningFunction()
+*   return c.text('Completed within time limit')
+* })
+* ```
+*/
+const timeout = (duration, exception = defaultTimeoutException) => {
+	return async function timeout(context, next) {
+		let timer;
+		const timeoutPromise = new Promise((_, reject) => {
+			timer = setTimeout(() => {
+				reject(typeof exception === "function" ? exception(context) : exception);
+			}, duration);
+		});
+		try {
+			await Promise.race([next(), timeoutPromise]);
+		} finally {
+			if (timer !== void 0) clearTimeout(timer);
+		}
+	};
+};
+//#endregion
+export { timeout };