acrylblends 1.0.3 → 1.0.5

package/lib/compress.js

@@ -1,79 +1,3 @@
-import { parseAccept } from "./utils/accept.js";
-import { COMPRESSIBLE_CONTENT_TYPE_REGEX } from "./utils/compress.js";
-//#region ../../plugins/acryl-router/src/core/middleware/compress/index.ts
-const ENCODING_TYPES = ["gzip", "deflate"];
-const cacheControlNoTransformRegExp = /(?:^|,)\s*?no-transform\s*?(?:,|$)/i;
-const selectEncoding = (header, candidates) => {
-	if (header === void 0) return;
-	const accepts = parseAccept(header);
-	const wildcardQ = accepts.find((a) => a.type === "*")?.q;
-	let best;
-	for (const enc of candidates) {
-		const explicit = accepts.find((a) => a.type.toLowerCase() === enc);
-		const q = explicit ? explicit.q : wildcardQ ?? 0;
-		if (q === 1) return enc;
-		else if (q > 0 && (!best || q > best.q)) best = {
-			encoding: enc,
-			q
-		};
-	}
-	return best?.encoding;
-};
-const varyAcceptEncodingRegExp = /(?:^|,)\s*accept-encoding\s*(?:,|$)/i;
-/**
-* Compress Middleware for Acryl.
-*
-*
-* @param {CompressionOptions} [options] - The options for the compress middleware.
-* @param {'gzip' | 'deflate'} [options.encoding] - The compression scheme to allow for response compression. Either 'gzip' or 'deflate'. If not defined, both are allowed and will be used based on the Accept-Encoding header. 'gzip' is prioritized if this option is not provided and the client provides both in the Accept-Encoding header.
-* @param {number} [options.threshold=1024] - The minimum size in bytes to compress. Defaults to 1024 bytes.
-* @param {RegExp | Function} [options.contentTypeFilter=COMPRESSIBLE_CONTENT_TYPE_REGEX] - A RegExp or function to determine if the response Content-Type should be compressed.
-* @returns {MiddlewareHandler} The middleware handler function.
-*
-* @example
-* ```ts
-* const app = new Acryl()
-*
-* app.use(compress())
-*
-* // Compress only JSON responses
-* app.use(compress({ contentTypeFilter: /^application\/json/ }))
-*
-* // Compress based on custom Content-Type logic
-* app.use(compress({ contentTypeFilter: (type) => COMPRESSIBLE_CONTENT_TYPE_REGEX.test(type) || type === "application/x-myformat" }))
-* ```
-*/
-const compress = (options) => {
-	const threshold = options?.threshold ?? 1024;
-	const candidates = options?.encoding ? [options.encoding] : ENCODING_TYPES;
-	const contentTypeFilter = options?.contentTypeFilter ?? COMPRESSIBLE_CONTENT_TYPE_REGEX;
-	const shouldCompress = typeof contentTypeFilter === "function" ? (res) => {
-		const type = res.headers.get("Content-Type");
-		return type && contentTypeFilter(type);
-	} : (res) => {
-		const type = res.headers.get("Content-Type");
-		return type && contentTypeFilter.test(type);
-	};
-	return async function compress(ctx, next) {
-		await next();
-		const contentLength = ctx.res.headers.get("Content-Length");
-		if (ctx.res.status === 206 || ctx.res.headers.has("Content-Encoding") || ctx.res.headers.has("Transfer-Encoding") || ctx.req.method === "HEAD" || contentLength && Number(contentLength) < threshold || !shouldCompress(ctx.res) || !shouldTransform(ctx.res)) return;
-		const current = ctx.res.headers.get("Vary");
-		if (current !== "*" && !(current && varyAcceptEncodingRegExp.test(current))) ctx.header("Vary", current ? `${current}, Accept-Encoding` : "Accept-Encoding");
-		const accepted = ctx.req.header("Accept-Encoding");
-		const encoding = selectEncoding(accepted, candidates);
-		if (!encoding || !ctx.res.body) return;
-		const stream = new CompressionStream(encoding);
-		ctx.res = new Response(ctx.res.body.pipeThrough(stream), ctx.res);
-		ctx.res.headers.delete("Content-Length");
-		ctx.res.headers.set("Content-Encoding", encoding);
-		const etag = ctx.res.headers.get("ETag");
-		if (etag && !etag.startsWith("W/")) ctx.res.headers.set("ETag", `W/${etag}`);
-	};
-};
-const shouldTransform = (res) => {
-	const cacheControl = res.headers.get("Cache-Control");
-	return !cacheControl || !cacheControlNoTransformRegExp.test(cacheControl);
-};
-//#endregion
+import { t as COMPRESSIBLE_CONTENT_TYPE_REGEX } from "./compress-DCyrrQ5D.js";
+import { t as compress } from "./compress-BzWqsHF1.js";
 export { COMPRESSIBLE_CONTENT_TYPE_REGEX, compress };

package/lib/concurrent-DrF3d2c-.js

@@ -0,0 +1,30 @@
+//#region ../../plugins/acryl-router/src/core/utils/concurrent.ts
+/**
+* @module
+* Concurrent utility.
+*/
+const DEFAULT_CONCURRENCY = 1024;
+const createPool = ({ concurrency, interval } = {}) => {
+	concurrency ||= DEFAULT_CONCURRENCY;
+	if (concurrency === Infinity) return { run: async (fn) => fn() };
+	const pool = /* @__PURE__ */ new Set();
+	const run = async (fn, promise, resolve) => {
+		if (pool.size >= concurrency) {
+			promise ||= new Promise((r) => resolve = r);
+			setTimeout(() => run(fn, promise, resolve));
+			return promise;
+		}
+		const marker = {};
+		pool.add(marker);
+		const result = await fn();
+		if (interval) setTimeout(() => pool.delete(marker), interval);
+		else pool.delete(marker);
+		if (resolve) {
+			resolve(result);
+			return promise;
+		} else return result;
+	};
+	return { run };
+};
+//#endregion
+export { createPool as t };

package/lib/conninfo-BCROmdnf.d.ts

@@ -0,0 +1,11 @@
+import { r as GetConnInfo } from "./types-Dv_nV2cv.js";
+
+//#region ../../plugins/acryl-node-server/src/adapter/conninfo.d.ts
+/**
+ * ConnInfo Helper for Node.js
+ * @param c Context
+ * @returns ConnInfo
+ */
+declare const getConnInfo: GetConnInfo;
+//#endregion
+export { getConnInfo as t };

package/lib/conninfo-CWJwieh4.js

@@ -0,0 +1,19 @@
+//#region ../../plugins/acryl-node-server/src/adapter/conninfo.ts
+/**
+* ConnInfo Helper for Node.js
+* @param c Context
+* @returns ConnInfo
+*/
+const getConnInfo = (c) => {
+	const bindings = c.env.server ? c.env.server : c.env;
+	const address = bindings.incoming.socket.remoteAddress;
+	const port = bindings.incoming.socket.remotePort;
+	const family = bindings.incoming.socket.remoteFamily;
+	return { remote: {
+		address,
+		port,
+		addressType: family === "IPv4" ? "IPv4" : family === "IPv6" ? "IPv6" : void 0
+	} };
+};
+//#endregion
+export { getConnInfo as t };

package/lib/constants-CBSEudrb.js

@@ -0,0 +1,7 @@
+//#region ../../plugins/acryl-router/src/core/utils/constants.ts
+/**
+* Constant used to mark a composed handler.
+*/
+const COMPOSED_HANDLER = "__COMPOSED_HANDLER";
+//#endregion
+export { COMPOSED_HANDLER as t };

package/lib/{context-DDO0cfuP.js → context-CkOh7Ygv.js}

@@ -1,5 +1,5 @@
-import { AcrylRequest } from "./request.js";
-import { HtmlEscapedCallbackPhase, resolveCallback } from "./utils/html.js";
+import { t as AcrylRequest } from "./request-DvMgGtlW.js";
+import { i as resolveCallback, t as HtmlEscapedCallbackPhase } from "./html-DGExBFNg.js";
 //#region ../../plugins/acryl-router/src/core/context.ts
 const TEXT_PLAIN = "text/plain; charset=UTF-8";
 const setDefaultContentType = (contentType, headers) => {

package/lib/context-storage-iuPoI_CR.js

@@ -0,0 +1,52 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+//#region ../../plugins/acryl-router/src/core/middleware/context-storage/index.ts
+/**
+* @module
+* Context Storage Middleware for Acryl.
+*/
+const asyncLocalStorage = new AsyncLocalStorage();
+/**
+* Context Storage Middleware for Acryl.
+*
+*
+* @returns {MiddlewareHandler} The middleware handler function.
+*
+* @example
+* ```ts
+* type Env = {
+*   Variables: {
+*     message: string
+*   }
+* }
+*
+* const app = new Acryl<Env>()
+*
+* app.use(contextStorage())
+*
+* app.use(async (c, next) => {
+*   c.set('message', 'Acryl is hot!!')
+*   await next()
+* })
+*
+* app.get('/', async (c) => c.text(getMessage()))
+*
+* const getMessage = () => {
+*   return getContext<Env>().var.message
+* }
+* ```
+*/
+const contextStorage = () => {
+	return async function contextStorage(c, next) {
+		await asyncLocalStorage.run(c, next);
+	};
+};
+const tryGetContext = () => {
+	return asyncLocalStorage.getStore();
+};
+const getContext = () => {
+	const context = tryGetContext();
+	if (!context) throw new Error("Context is not available");
+	return context;
+};
+//#endregion
+export { getContext as n, tryGetContext as r, contextStorage as t };

package/lib/context-storage.js

@@ -1,52 +1,2 @@
-import { AsyncLocalStorage } from "node:async_hooks";
-//#region ../../plugins/acryl-router/src/core/middleware/context-storage/index.ts
-/**
-* @module
-* Context Storage Middleware for Acryl.
-*/
-const asyncLocalStorage = new AsyncLocalStorage();
-/**
-* Context Storage Middleware for Acryl.
-*
-*
-* @returns {MiddlewareHandler} The middleware handler function.
-*
-* @example
-* ```ts
-* type Env = {
-*   Variables: {
-*     message: string
-*   }
-* }
-*
-* const app = new Acryl<Env>()
-*
-* app.use(contextStorage())
-*
-* app.use(async (c, next) => {
-*   c.set('message', 'Acryl is hot!!')
-*   await next()
-* })
-*
-* app.get('/', async (c) => c.text(getMessage()))
-*
-* const getMessage = () => {
-*   return getContext<Env>().var.message
-* }
-* ```
-*/
-const contextStorage = () => {
-	return async function contextStorage(c, next) {
-		await asyncLocalStorage.run(c, next);
-	};
-};
-const tryGetContext = () => {
-	return asyncLocalStorage.getStore();
-};
-const getContext = () => {
-	const context = tryGetContext();
-	if (!context) throw new Error("Context is not available");
-	return context;
-};
-//#endregion
+import { n as getContext, r as tryGetContext, t as contextStorage } from "./context-storage-iuPoI_CR.js";
 export { contextStorage, getContext, tryGetContext };

package/lib/cookie-B1LlkzOe.js

@@ -0,0 +1,125 @@
+import { m as tryDecodeURIComponent } from "./url-BPh4d6j-.js";
+//#region ../../plugins/acryl-router/src/core/utils/cookie.ts
+/**
+* @module
+* Cookie utility.
+*/
+const algorithm = {
+	name: "HMAC",
+	hash: "SHA-256"
+};
+const getCryptoKey = async (secret) => {
+	const secretBuf = typeof secret === "string" ? new TextEncoder().encode(secret) : secret;
+	return await crypto.subtle.importKey("raw", secretBuf, algorithm, false, ["sign", "verify"]);
+};
+const makeSignature = async (value, secret) => {
+	const key = await getCryptoKey(secret);
+	const signature = await crypto.subtle.sign(algorithm.name, key, new TextEncoder().encode(value));
+	return btoa(String.fromCharCode(...new Uint8Array(signature)));
+};
+const verifySignature = async (base64Signature, value, secret) => {
+	try {
+		const signatureBinStr = atob(base64Signature);
+		const signature = new Uint8Array(signatureBinStr.length);
+		for (let i = 0, len = signatureBinStr.length; i < len; i++) signature[i] = signatureBinStr.charCodeAt(i);
+		return await crypto.subtle.verify(algorithm, secret, signature, new TextEncoder().encode(value));
+	} catch {
+		return false;
+	}
+};
+const validCookieNameRegEx = /^[\w!#$%&'*.^`|~+-]+$/;
+const relaxedCookieNameRegEx = /^[!#-:<>-[\]-~]+$/;
+const validCookieValueRegEx = /^[ !#-:<-[\]-~]*$/;
+const trimCookieWhitespace = (value) => {
+	let start = 0;
+	let end = value.length;
+	while (start < end) {
+		const charCode = value.charCodeAt(start);
+		if (charCode !== 32 && charCode !== 9) break;
+		start++;
+	}
+	while (end > start) {
+		const charCode = value.charCodeAt(end - 1);
+		if (charCode !== 32 && charCode !== 9) break;
+		end--;
+	}
+	return start === 0 && end === value.length ? value : value.slice(start, end);
+};
+const parse = (cookie, name) => {
+	if (name && cookie.indexOf(name) === -1) return {};
+	const pairs = cookie.split(";");
+	const parsedCookie = Object.create(null);
+	for (const pairStr of pairs) {
+		const valueStartPos = pairStr.indexOf("=");
+		if (valueStartPos === -1) continue;
+		const cookieName = trimCookieWhitespace(pairStr.substring(0, valueStartPos));
+		if (name && name !== cookieName || !relaxedCookieNameRegEx.test(cookieName) || cookieName in parsedCookie) continue;
+		let cookieValue = trimCookieWhitespace(pairStr.substring(valueStartPos + 1));
+		if (cookieValue.startsWith("\"") && cookieValue.endsWith("\"")) cookieValue = cookieValue.slice(1, -1);
+		if (validCookieValueRegEx.test(cookieValue)) {
+			parsedCookie[cookieName] = tryDecodeURIComponent(cookieValue);
+			if (name) break;
+		}
+	}
+	return parsedCookie;
+};
+const parseSigned = async (cookie, secret, name) => {
+	const parsedCookie = Object.create(null);
+	const secretKey = await getCryptoKey(secret);
+	for (const [key, value] of Object.entries(parse(cookie, name))) {
+		const signatureStartPos = value.lastIndexOf(".");
+		if (signatureStartPos < 0) continue;
+		const signedValue = value.substring(0, signatureStartPos);
+		const signature = value.substring(signatureStartPos + 1);
+		if (signature.length !== 44 || !signature.endsWith("=")) continue;
+		parsedCookie[key] = await verifySignature(signature, signedValue, secretKey) ? signedValue : false;
+	}
+	return parsedCookie;
+};
+const _serialize = (name, value, opt = {}) => {
+	if (!validCookieNameRegEx.test(name)) throw new Error("Invalid cookie name");
+	let cookie = `${name}=${value}`;
+	if (name.startsWith("__Secure-") && !opt.secure) throw new Error("__Secure- Cookie must have Secure attributes");
+	if (name.startsWith("__Host-")) {
+		if (!opt.secure) throw new Error("__Host- Cookie must have Secure attributes");
+		if (opt.path !== "/") throw new Error("__Host- Cookie must have Path attributes with \"/\"");
+		if (opt.domain) throw new Error("__Host- Cookie must not have Domain attributes");
+	}
+	for (const key of [
+		"domain",
+		"path",
+		"sameSite",
+		"priority"
+	]) if (opt[key] && /[;\r\n]/.test(opt[key])) throw new Error(`${key} must not contain ";", "\\r", or "\\n"`);
+	if (opt && typeof opt.maxAge === "number" && opt.maxAge >= 0) {
+		if (opt.maxAge > 3456e4) throw new Error("Cookies Max-Age SHOULD NOT be greater than 400 days (34560000 seconds) in duration.");
+		cookie += `; Max-Age=${opt.maxAge | 0}`;
+	}
+	if (opt.domain && opt.prefix !== "host") cookie += `; Domain=${opt.domain}`;
+	if (opt.path) cookie += `; Path=${opt.path}`;
+	if (opt.expires) {
+		if (opt.expires.getTime() - Date.now() > 3456e7) throw new Error("Cookies Expires SHOULD NOT be greater than 400 days (34560000 seconds) in the future.");
+		cookie += `; Expires=${opt.expires.toUTCString()}`;
+	}
+	if (opt.httpOnly) cookie += "; HttpOnly";
+	if (opt.secure) cookie += "; Secure";
+	if (opt.sameSite) cookie += `; SameSite=${opt.sameSite.charAt(0).toUpperCase() + opt.sameSite.slice(1)}`;
+	if (opt.priority) cookie += `; Priority=${opt.priority.charAt(0).toUpperCase() + opt.priority.slice(1)}`;
+	if (opt.partitioned) {
+		if (!opt.secure) throw new Error("Partitioned Cookie must have Secure attributes");
+		cookie += "; Partitioned";
+	}
+	return cookie;
+};
+const serialize = (name, value, opt) => {
+	value = encodeURIComponent(value);
+	return _serialize(name, value, opt);
+};
+const serializeSigned = async (name, value, secret, opt = {}) => {
+	const signature = await makeSignature(value, secret);
+	value = `${value}.${signature}`;
+	value = encodeURIComponent(value);
+	return _serialize(name, value, opt);
+};
+//#endregion
+export { serializeSigned as i, parseSigned as n, serialize as r, parse as t };

package/lib/cookie-BHIduy2T.js

@@ -0,0 +1,82 @@
+import { i as serializeSigned, n as parseSigned, r as serialize, t as parse } from "./cookie-B1LlkzOe.js";
+//#region ../../plugins/acryl-router/src/core/helper/cookie/index.ts
+const getCookie = (c, key, prefix) => {
+	const cookie = c.req.raw.headers.get("Cookie");
+	if (typeof key === "string") {
+		if (!cookie) return;
+		let finalKey = key;
+		if (prefix === "secure") finalKey = "__Secure-" + key;
+		else if (prefix === "host") finalKey = "__Host-" + key;
+		return parse(cookie, finalKey)[finalKey];
+	}
+	if (!cookie) return {};
+	return parse(cookie);
+};
+const getSignedCookie = async (c, secret, key, prefix) => {
+	const cookie = c.req.raw.headers.get("Cookie");
+	if (typeof key === "string") {
+		if (!cookie) return;
+		let finalKey = key;
+		if (prefix === "secure") finalKey = "__Secure-" + key;
+		else if (prefix === "host") finalKey = "__Host-" + key;
+		return (await parseSigned(cookie, secret, finalKey))[finalKey];
+	}
+	if (!cookie) return {};
+	return await parseSigned(cookie, secret);
+};
+const generateCookie = (name, value, opt) => {
+	let cookie;
+	if (opt?.prefix === "secure") cookie = serialize("__Secure-" + name, value, {
+		path: "/",
+		...opt,
+		secure: true
+	});
+	else if (opt?.prefix === "host") cookie = serialize("__Host-" + name, value, {
+		...opt,
+		path: "/",
+		secure: true,
+		domain: void 0
+	});
+	else cookie = serialize(name, value, {
+		path: "/",
+		...opt
+	});
+	return cookie;
+};
+const setCookie = (c, name, value, opt) => {
+	const cookie = generateCookie(name, value, opt);
+	c.header("Set-Cookie", cookie, { append: true });
+};
+const generateSignedCookie = async (name, value, secret, opt) => {
+	let cookie;
+	if (opt?.prefix === "secure") cookie = await serializeSigned("__Secure-" + name, value, secret, {
+		path: "/",
+		...opt,
+		secure: true
+	});
+	else if (opt?.prefix === "host") cookie = await serializeSigned("__Host-" + name, value, secret, {
+		...opt,
+		path: "/",
+		secure: true,
+		domain: void 0
+	});
+	else cookie = await serializeSigned(name, value, secret, {
+		path: "/",
+		...opt
+	});
+	return cookie;
+};
+const setSignedCookie = async (c, name, value, secret, opt) => {
+	const cookie = await generateSignedCookie(name, value, secret, opt);
+	c.header("set-cookie", cookie, { append: true });
+};
+const deleteCookie = (c, name, opt) => {
+	const deletedCookie = getCookie(c, name, opt?.prefix);
+	setCookie(c, name, "", {
+		...opt,
+		maxAge: 0
+	});
+	return deletedCookie;
+};
+//#endregion
+export { getSignedCookie as a, getCookie as i, generateCookie as n, setCookie as o, generateSignedCookie as r, setSignedCookie as s, deleteCookie as t };

package/lib/cookie.js

@@ -1,82 +1,2 @@
-import { parse, parseSigned, serialize, serializeSigned } from "./utils/cookie.js";
-//#region ../../plugins/acryl-router/src/core/helper/cookie/index.ts
-const getCookie = (c, key, prefix) => {
-	const cookie = c.req.raw.headers.get("Cookie");
-	if (typeof key === "string") {
-		if (!cookie) return;
-		let finalKey = key;
-		if (prefix === "secure") finalKey = "__Secure-" + key;
-		else if (prefix === "host") finalKey = "__Host-" + key;
-		return parse(cookie, finalKey)[finalKey];
-	}
-	if (!cookie) return {};
-	return parse(cookie);
-};
-const getSignedCookie = async (c, secret, key, prefix) => {
-	const cookie = c.req.raw.headers.get("Cookie");
-	if (typeof key === "string") {
-		if (!cookie) return;
-		let finalKey = key;
-		if (prefix === "secure") finalKey = "__Secure-" + key;
-		else if (prefix === "host") finalKey = "__Host-" + key;
-		return (await parseSigned(cookie, secret, finalKey))[finalKey];
-	}
-	if (!cookie) return {};
-	return await parseSigned(cookie, secret);
-};
-const generateCookie = (name, value, opt) => {
-	let cookie;
-	if (opt?.prefix === "secure") cookie = serialize("__Secure-" + name, value, {
-		path: "/",
-		...opt,
-		secure: true
-	});
-	else if (opt?.prefix === "host") cookie = serialize("__Host-" + name, value, {
-		...opt,
-		path: "/",
-		secure: true,
-		domain: void 0
-	});
-	else cookie = serialize(name, value, {
-		path: "/",
-		...opt
-	});
-	return cookie;
-};
-const setCookie = (c, name, value, opt) => {
-	const cookie = generateCookie(name, value, opt);
-	c.header("Set-Cookie", cookie, { append: true });
-};
-const generateSignedCookie = async (name, value, secret, opt) => {
-	let cookie;
-	if (opt?.prefix === "secure") cookie = await serializeSigned("__Secure-" + name, value, secret, {
-		path: "/",
-		...opt,
-		secure: true
-	});
-	else if (opt?.prefix === "host") cookie = await serializeSigned("__Host-" + name, value, secret, {
-		...opt,
-		path: "/",
-		secure: true,
-		domain: void 0
-	});
-	else cookie = await serializeSigned(name, value, secret, {
-		path: "/",
-		...opt
-	});
-	return cookie;
-};
-const setSignedCookie = async (c, name, value, secret, opt) => {
-	const cookie = await generateSignedCookie(name, value, secret, opt);
-	c.header("set-cookie", cookie, { append: true });
-};
-const deleteCookie = (c, name, opt) => {
-	const deletedCookie = getCookie(c, name, opt?.prefix);
-	setCookie(c, name, "", {
-		...opt,
-		maxAge: 0
-	});
-	return deletedCookie;
-};
-//#endregion
+import { a as getSignedCookie, i as getCookie, n as generateCookie, o as setCookie, r as generateSignedCookie, s as setSignedCookie, t as deleteCookie } from "./cookie-BHIduy2T.js";
 export { deleteCookie, generateCookie, generateSignedCookie, getCookie, getSignedCookie, setCookie, setSignedCookie };

package/lib/cordis/db-sqlite.d.ts

@@ -1,5 +1,5 @@
 import { n as DbExecutor, r as SqlValue, t as Db } from "../database-DBHdwefi.js";
-import { OpenDb, OpenDbOptions, openDb } from "../db/sqlite.js";
+import { n as OpenDbOptions, r as openDb, t as OpenDb } from "../open-T7kgbO2O.js";
 import { DatabaseSync, StatementSync } from "node:sqlite";
 import { Context } from "@deepseek-ai/cordis";
 import z from "@deepseek-ai/schemastery";

package/lib/cordis/door.d.ts

@@ -1,5 +1,5 @@
-import { d as UiActionResult, v as UiSnapshot } from "../protocol-BizVt4J6.js";
-import { i as UiChannel, t as AuditLog } from "../audit-BXnYsLge.js";
+import { f as UiActionResult, y as UiSnapshot } from "../protocol-C37gPePD.js";
+import { i as UiChannel, t as AuditLog } from "../audit-D5z9uwOP.js";
 import { Context } from "@deepseek-ai/cordis";
 import z from "@deepseek-ai/schemastery";
 
@@ -21,6 +21,7 @@ interface ToolsPort {
   /** @returns the function that removes the tool. @throws when the name is taken. */
   register(name: string, tool: {
     readonly description: string;
+    readonly parameters?: Readonly<Record<string, unknown>>;
     run(input: unknown): unknown;
   }): () => void;
   list(): ReadonlyArray<{
@@ -43,6 +44,10 @@ interface DoorDeps {
   readonly tools: () => ToolsPort | undefined;
   /** The app tools the door offers; anything else is refused before it reaches the registry. */
   readonly expose: readonly string[];
+  /** Reload the open pages after a plugin was added, removed or reloaded, so the page an agent looks at next is the new one. Default: true. */
+  readonly reloadOnChange?: boolean;
+  /** How long a reload or a move may take before the new page has connected again (tests shorten it). Default 15 s. */
+  readonly pageBackMs?: number;
 }
 /** What one verb answered: the value for `--json` and programs, the text for an agent reading a terminal. */
 interface VerbAnswer {
@@ -57,6 +62,11 @@ declare class Door {
   brief(): VerbAnswer;
   look(input: Record<string, unknown>, signal: AbortSignal): Promise<UiSnapshot>;
   act(input: Record<string, unknown>, signal: AbortSignal): Promise<UiActionResult>;
+  /**
+   * What the app answers at a path the page was sent to, so an agent that mistyped one is told ("404 at /nope") and not left to find out from a page it did not expect.
+   * A second GET of the same path (a page is read-only); nothing when the app has no address or does not answer in time.
+   */
+  private statusAt;
   private parse;
   /** Run one call on the page and record it. The audit holds which control was touched and how it ended, never what was typed. */
   private callPage;
@@ -158,8 +168,12 @@ interface Config {
    * run it in production (a packaged desktop app whose user drives it with an agent) says so here; `ACRYL_DOOR=off` still wins.
    */
   allowInProduction?: boolean;
+  /** Reload the open pages after a live plugin change, so an agent that built a feature sees it on the page it has open. Default: true. */
+  reloadOnChange?: boolean;
 }
 declare const Config: z<Config>;
+/** The page of a path the app does not serve, development only: what is missing, a way back, and the door's script. */
+declare function notFoundPage(path: string, scriptTag: string): string;
 declare function apply(ctx: Context, rawConfig?: Config): void;
 //#endregion
-export { type CallResponse, Config, DOOR_PREFIX, Door, DoorError, type DoorFile, STATE_DIR, VERBS, VERB_SPECS, type Verb, type VerbAnswer, type VerbSpec, apply, chatToolName, doorFilePath, inject, mcpTools, name, readDoorFile };
+export { type CallResponse, Config, DOOR_PREFIX, Door, DoorError, type DoorFile, STATE_DIR, VERBS, VERB_SPECS, type Verb, type VerbAnswer, type VerbSpec, apply, chatToolName, doorFilePath, inject, mcpTools, name, notFoundPage, readDoorFile };