acrylblends 0.8.1 → 0.9.0

package/lib/door/protocol.d.ts

@@ -0,0 +1,2 @@
+import { S as parseUiRequest, _ as UiResult, a as MAX_SNAPSHOT_NODES, b as parseChannelToHost, c as MUTATING_OPS, d as UiActionResult, f as UiControlError, g as UiRequest, h as UiOp, i as DEFAULT_SNAPSHOT_NODES, l as UI_ERROR_CODES, m as UiNode, n as ChannelToHost, o as MAX_TEXT_LENGTH, p as UiErrorCode, r as ChannelToPage, s as MAX_WAIT_MS, t as AuditEntry, u as UI_OPS, v as UiSnapshot, x as parseChannelToPage, y as WINDOW_ID } from "../protocol-BizVt4J6.js";
+export { AuditEntry, ChannelToHost, ChannelToPage, DEFAULT_SNAPSHOT_NODES, MAX_SNAPSHOT_NODES, MAX_TEXT_LENGTH, MAX_WAIT_MS, MUTATING_OPS, UI_ERROR_CODES, UI_OPS, UiActionResult, UiControlError, UiErrorCode, UiNode, UiOp, UiRequest, UiResult, UiSnapshot, WINDOW_ID, parseChannelToHost, parseChannelToPage, parseUiRequest };

package/lib/door/protocol.js

@@ -0,0 +1,197 @@
+//#region ../../plugins/acryl-door/src/page/protocol.ts
+/**
+* The one shape of a door call, shared by the Host and the in-page driver (moved from `acryl-agent-control`, spec 041).
+*
+* The Host turns a verb's arguments into a {@link UiRequest}, sends it to the page over the channel, and gets a {@link UiResult} back.
+* Everything crossing the channel is validated here once, so neither side trusts the other's JSON. The page imports this file too, so it
+* lives with the page code and has no Node imports.
+*/
+/** The operations the driver performs on the page. */
+const UI_OPS = [
+	"snapshot",
+	"click",
+	"type",
+	"select",
+	"press",
+	"scroll",
+	"wait"
+];
+/** Operations that change the page, so each call needs approval. `snapshot`, `scroll` and `wait` only look. */
+const MUTATING_OPS = [
+	"click",
+	"type",
+	"select",
+	"press"
+];
+const MAX_TEXT_LENGTH = 1e4;
+const MAX_WAIT_MS = 1e4;
+const MAX_SNAPSHOT_NODES = 1e3;
+const DEFAULT_SNAPSHOT_NODES = 300;
+var UiControlError = class extends Error {
+	code;
+	constructor(code, message) {
+		super(message);
+		this.code = code;
+		this.name = "UiControlError";
+	}
+};
+const KEYS = /^(?:[A-Za-z0-9]|Enter|Escape|Tab|Backspace|Delete|Space|Arrow(?:Up|Down|Left|Right)|Home|End|PageUp|PageDown)$/;
+const REF = /^\d{1,9}\.\d{1,6}$/;
+const isRecord = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const invalid = (message) => {
+	throw new UiControlError("invalid", message);
+};
+function ref(value) {
+	if (typeof value !== "string" || !REF.test(value)) return invalid("ref must look like 3.17, from the latest snapshot");
+	return value;
+}
+function text(value, max = MAX_TEXT_LENGTH) {
+	if (typeof value !== "string" || value.length > max || value.includes("\0")) return invalid(`text must be a string of at most ${String(max)} characters`);
+	return value;
+}
+/** @param value - untrusted JSON. @throws UiControlError `invalid`. */
+function parseUiRequest(value) {
+	if (!isRecord(value) || typeof value.op !== "string") return invalid("a call needs an op");
+	const op = value.op;
+	const only = (allowed) => {
+		const extra = Object.keys(value).find((key) => key !== "op" && !allowed.includes(key));
+		if (extra !== void 0) invalid(`unknown field ${extra}`);
+	};
+	switch (op) {
+		case "snapshot": {
+			only(["cursor", "maxNodes"]);
+			const cursor = value.cursor === void 0 ? void 0 : Number(value.cursor);
+			const maxNodes = value.maxNodes === void 0 ? void 0 : Number(value.maxNodes);
+			if (cursor !== void 0 && (!Number.isInteger(cursor) || cursor < 0) || maxNodes !== void 0 && (!Number.isInteger(maxNodes) || maxNodes < 1 || maxNodes > 1e3)) return invalid("cursor and maxNodes must be small positive integers");
+			return {
+				op,
+				...cursor === void 0 ? {} : { cursor },
+				...maxNodes === void 0 ? {} : { maxNodes }
+			};
+		}
+		case "click":
+			only(["ref"]);
+			return {
+				op,
+				ref: ref(value.ref)
+			};
+		case "type":
+			only([
+				"ref",
+				"text",
+				"submit",
+				"clear"
+			]);
+			if (value.submit !== void 0 && typeof value.submit !== "boolean" || value.clear !== void 0 && typeof value.clear !== "boolean") return invalid("submit and clear must be true or false");
+			return {
+				op,
+				ref: ref(value.ref),
+				text: text(value.text),
+				...value.submit === void 0 ? {} : { submit: value.submit },
+				...value.clear === void 0 ? {} : { clear: value.clear }
+			};
+		case "select":
+			only(["ref", "option"]);
+			return {
+				op,
+				ref: ref(value.ref),
+				option: text(value.option, 500)
+			};
+		case "press":
+			only(["key", "ref"]);
+			if (typeof value.key !== "string" || !KEYS.test(value.key)) return invalid("key must be a single character or a name such as Enter, Escape, Tab or ArrowDown");
+			return {
+				op,
+				key: value.key,
+				...value.ref === void 0 ? {} : { ref: ref(value.ref) }
+			};
+		case "scroll": {
+			only([
+				"direction",
+				"ref",
+				"amount"
+			]);
+			if (value.direction !== "up" && value.direction !== "down" && value.direction !== "left" && value.direction !== "right") return invalid("direction must be up, down, left or right");
+			const amount = value.amount === void 0 ? void 0 : Number(value.amount);
+			if (amount !== void 0 && (!Number.isFinite(amount) || amount <= 0 || amount > 1e4)) return invalid("amount must be between 1 and 10000 pixels");
+			return {
+				op,
+				direction: value.direction,
+				...value.ref === void 0 ? {} : { ref: ref(value.ref) },
+				...amount === void 0 ? {} : { amount }
+			};
+		}
+		case "wait": {
+			only([
+				"text",
+				"role",
+				"name",
+				"gone",
+				"timeoutMs"
+			]);
+			const timeoutMs = value.timeoutMs === void 0 ? void 0 : Number(value.timeoutMs);
+			if (timeoutMs !== void 0 && (!Number.isFinite(timeoutMs) || timeoutMs < 0 || timeoutMs > 1e4)) return invalid(`timeoutMs must be between 0 and ${String(MAX_WAIT_MS)}`);
+			if (value.gone !== void 0 && typeof value.gone !== "boolean") return invalid("gone must be true or false");
+			if (value.text === void 0 && value.role === void 0 && value.name === void 0) return invalid("wait needs text, or a role and name");
+			return {
+				op,
+				...value.text === void 0 ? {} : { text: text(value.text, 500) },
+				...value.role === void 0 ? {} : { role: text(value.role, 60) },
+				...value.name === void 0 ? {} : { name: text(value.name, 500) },
+				...value.gone === void 0 ? {} : { gone: value.gone },
+				...timeoutMs === void 0 ? {} : { timeoutMs }
+			};
+		}
+		default: return invalid(`unknown op ${String(op)}`);
+	}
+}
+/** @param text - one `call` event's data from the Host. @throws when it is not a well-formed call. */
+function parseChannelToPage(text) {
+	const value = JSON.parse(text);
+	if (isRecord(value) && value.t === "call" && typeof value.id === "number" && Number.isSafeInteger(value.id)) return {
+		t: "call",
+		id: value.id,
+		request: parseUiRequest(value.request)
+	};
+	throw new UiControlError("invalid", "not a channel call");
+}
+/** Every code a {@link UiControlError} can carry, so a code read off the wire is validated, not cast. */
+const UI_ERROR_CODES = [
+	"no-window",
+	"stale-ref",
+	"unknown-ref",
+	"sensitive",
+	"protected",
+	"not-actionable",
+	"not-found",
+	"killed",
+	"timeout",
+	"aborted",
+	"unloaded",
+	"disconnected",
+	"invalid"
+];
+/** A window id the page chose: short, printable, so it can travel in a query string and a log line. */
+const WINDOW_ID = /^[A-Za-z0-9-]{1,80}$/u;
+/** @param value - one parsed message from the page; null when it is not a well-formed message. */
+function parseChannelToHost(value) {
+	if (!isRecord(value)) return null;
+	if (value.t === "focus" && typeof value.focused === "boolean") return {
+		t: "focus",
+		focused: value.focused
+	};
+	if (value.t === "result" && typeof value.id === "number" && isRecord(value.value)) return {
+		t: "result",
+		id: value.id,
+		value: value.value
+	};
+	if (value.t === "error" && typeof value.id === "number" && typeof value.message === "string" && UI_ERROR_CODES.includes(value.code)) return {
+		t: "error",
+		id: value.id,
+		code: value.code,
+		message: value.message.slice(0, 500)
+	};
+	return null;
+}
+//#endregion
+export { DEFAULT_SNAPSHOT_NODES, MAX_SNAPSHOT_NODES, MAX_TEXT_LENGTH, MAX_WAIT_MS, MUTATING_OPS, UI_ERROR_CODES, UI_OPS, UiControlError, WINDOW_ID, parseChannelToHost, parseChannelToPage, parseUiRequest };

package/lib/error-t4N2js2I.d.ts

@@ -0,0 +1,8 @@
+//#region ../../plugins/acryl-node-server/src/adapter/error.d.ts
+declare class RequestError extends Error {
+  constructor(message: string, options?: {
+    cause?: unknown;
+  });
+}
+//#endregion
+export { RequestError as t };

package/lib/etag-DaKMOjty.js

@@ -0,0 +1,135 @@
+//#region ../../plugins/acryl-router/src/core/middleware/etag/digest.ts
+const mergeBuffers = (buffer1, buffer2) => {
+	if (!buffer1) return buffer2;
+	const merged = new Uint8Array(new ArrayBuffer(buffer1.byteLength + buffer2.byteLength));
+	merged.set(new Uint8Array(buffer1), 0);
+	merged.set(buffer2, buffer1.byteLength);
+	return merged;
+};
+const CHUNK_SIZE = 256 * 1024;
+const generateDigest = async (stream, generator) => {
+	if (!stream) return null;
+	let result = void 0;
+	let chunk;
+	let chunkLength = 0;
+	const digest = async (body) => {
+		result = await generator(mergeBuffers(result, body));
+	};
+	const reader = stream.getReader();
+	for (;;) {
+		const { value, done } = await reader.read();
+		if (done) break;
+		let offset = 0;
+		while (offset < value.byteLength) {
+			const remaining = value.byteLength - offset;
+			if (chunkLength === 0 && remaining >= CHUNK_SIZE) {
+				await digest(value.subarray(offset, offset + CHUNK_SIZE));
+				offset += CHUNK_SIZE;
+				continue;
+			}
+			const requiredLength = chunkLength + remaining;
+			if (requiredLength < CHUNK_SIZE) {
+				if (!chunk) chunk = value.slice(offset);
+				else {
+					if (chunk.byteLength < requiredLength) {
+						const nextChunk = new Uint8Array(new ArrayBuffer(Math.min(CHUNK_SIZE, Math.max(requiredLength, chunk.byteLength * 2))));
+						nextChunk.set(chunk.subarray(0, chunkLength));
+						chunk = nextChunk;
+					}
+					chunk.set(value.subarray(offset), chunkLength);
+				}
+				chunkLength = requiredLength;
+				break;
+			}
+			const length = CHUNK_SIZE - chunkLength;
+			if (chunk?.byteLength !== CHUNK_SIZE) {
+				const nextChunk = new Uint8Array(/* @__PURE__ */ new ArrayBuffer(CHUNK_SIZE));
+				if (chunk) nextChunk.set(chunk.subarray(0, chunkLength));
+				chunk = nextChunk;
+			}
+			chunk.set(value.subarray(offset, offset + length), chunkLength);
+			await digest(chunk);
+			chunkLength = 0;
+			offset += length;
+		}
+	}
+	if (chunk && chunkLength > 0) await digest(chunk.subarray(0, chunkLength));
+	if (!result) return null;
+	return Array.prototype.map.call(new Uint8Array(result), (x) => x.toString(16).padStart(2, "0")).join("");
+};
+//#endregion
+//#region ../../plugins/acryl-router/src/core/middleware/etag/index.ts
+/**
+* Default headers to pass through on 304 responses. From the spec:
+* > The response must not contain a body and must include the headers that
+* > would have been sent in an equivalent 200 OK response: Cache-Control,
+* > Content-Location, Date, ETag, Expires, and Vary.
+*/
+const RETAINED_304_HEADERS = [
+	"cache-control",
+	"content-location",
+	"date",
+	"etag",
+	"expires",
+	"vary"
+];
+const stripWeak = (tag) => tag.replace(/^W\//, "");
+function etagMatches(etag, ifNoneMatch) {
+	return ifNoneMatch != null && ifNoneMatch.split(",").some((t) => stripWeak(t.trim()) === stripWeak(etag));
+}
+function initializeGenerator(generator) {
+	if (!generator) {
+		if (crypto && crypto.subtle) generator = (body) => crypto.subtle.digest({ name: "SHA-1" }, body);
+	}
+	return generator;
+}
+/**
+* ETag Middleware for Acryl.
+*
+*
+* @param {ETagOptions} [options] - The options for the ETag middleware.
+* @param {boolean} [options.weak=false] - Define using or not using a weak validation. If true is set, then `W/` is added to the prefix of the value.
+* @param {string[]} [options.retainedHeaders=RETAINED_304_HEADERS] - The headers that you want to retain in the 304 Response.
+* @param {function(Uint8Array): ArrayBuffer | Promise<ArrayBuffer>} [options.generateDigest] -
+* A custom digest generation function. By default, it uses 'SHA-1'
+* This function is called with the response body as a `Uint8Array` and should return a hash as an `ArrayBuffer` or a Promise of one.
+* @returns {MiddlewareHandler} The middleware handler function.
+*
+* @example
+* ```ts
+* const app = new Acryl()
+*
+* app.use('/etag/*', etag())
+* app.get('/etag/abc', (c) => {
+*   return c.text('Acryl is hot')
+* })
+* ```
+*/
+const etag = (options) => {
+	const retainedHeaders = new Set((options?.retainedHeaders ?? RETAINED_304_HEADERS).map((header) => header.toLowerCase()));
+	const weak = options?.weak ?? false;
+	const generator = initializeGenerator(options?.generateDigest);
+	return async function etag(c, next) {
+		const ifNoneMatch = c.req.header("If-None-Match") ?? null;
+		await next();
+		if (!(c.req.method === "GET" || c.req.method === "HEAD" || c.req.method === "QUERY") || !c.res.ok) return;
+		const res = c.res;
+		let etag = res.headers.get("ETag");
+		if (!etag) {
+			if (!generator) return;
+			const hash = await generateDigest(res.clone().body, generator);
+			if (hash === null) return;
+			etag = weak ? `W/"${hash}"` : `"${hash}"`;
+		}
+		if (ifNoneMatch === "*" || etagMatches(etag, ifNoneMatch)) {
+			c.res = new Response(null, {
+				status: 304,
+				statusText: "Not Modified",
+				headers: { ETag: etag }
+			});
+			for (const key of Array.from(c.res.headers.keys())) if (!retainedHeaders.has(key.toLowerCase())) c.res.headers.delete(key);
+		} else c.res.headers.set("ETag", etag);
+	};
+};
+//#endregion
+export { etag as n, RETAINED_304_HEADERS as t };

package/lib/etag.js

@@ -1,135 +1,2 @@
-//#region ../../plugins/acryl-router/src/core/middleware/etag/digest.ts
-const mergeBuffers = (buffer1, buffer2) => {
-	if (!buffer1) return buffer2;
-	const merged = new Uint8Array(new ArrayBuffer(buffer1.byteLength + buffer2.byteLength));
-	merged.set(new Uint8Array(buffer1), 0);
-	merged.set(buffer2, buffer1.byteLength);
-	return merged;
-};
-const CHUNK_SIZE = 256 * 1024;
-const generateDigest = async (stream, generator) => {
-	if (!stream) return null;
-	let result = void 0;
-	let chunk;
-	let chunkLength = 0;
-	const digest = async (body) => {
-		result = await generator(mergeBuffers(result, body));
-	};
-	const reader = stream.getReader();
-	for (;;) {
-		const { value, done } = await reader.read();
-		if (done) break;
-		let offset = 0;
-		while (offset < value.byteLength) {
-			const remaining = value.byteLength - offset;
-			if (chunkLength === 0 && remaining >= CHUNK_SIZE) {
-				await digest(value.subarray(offset, offset + CHUNK_SIZE));
-				offset += CHUNK_SIZE;
-				continue;
-			}
-			const requiredLength = chunkLength + remaining;
-			if (requiredLength < CHUNK_SIZE) {
-				if (!chunk) chunk = value.slice(offset);
-				else {
-					if (chunk.byteLength < requiredLength) {
-						const nextChunk = new Uint8Array(new ArrayBuffer(Math.min(CHUNK_SIZE, Math.max(requiredLength, chunk.byteLength * 2))));
-						nextChunk.set(chunk.subarray(0, chunkLength));
-						chunk = nextChunk;
-					}
-					chunk.set(value.subarray(offset), chunkLength);
-				}
-				chunkLength = requiredLength;
-				break;
-			}
-			const length = CHUNK_SIZE - chunkLength;
-			if (chunk?.byteLength !== CHUNK_SIZE) {
-				const nextChunk = new Uint8Array(/* @__PURE__ */ new ArrayBuffer(CHUNK_SIZE));
-				if (chunk) nextChunk.set(chunk.subarray(0, chunkLength));
-				chunk = nextChunk;
-			}
-			chunk.set(value.subarray(offset, offset + length), chunkLength);
-			await digest(chunk);
-			chunkLength = 0;
-			offset += length;
-		}
-	}
-	if (chunk && chunkLength > 0) await digest(chunk.subarray(0, chunkLength));
-	if (!result) return null;
-	return Array.prototype.map.call(new Uint8Array(result), (x) => x.toString(16).padStart(2, "0")).join("");
-};
-//#endregion
-//#region ../../plugins/acryl-router/src/core/middleware/etag/index.ts
-/**
-* Default headers to pass through on 304 responses. From the spec:
-* > The response must not contain a body and must include the headers that
-* > would have been sent in an equivalent 200 OK response: Cache-Control,
-* > Content-Location, Date, ETag, Expires, and Vary.
-*/
-const RETAINED_304_HEADERS = [
-	"cache-control",
-	"content-location",
-	"date",
-	"etag",
-	"expires",
-	"vary"
-];
-const stripWeak = (tag) => tag.replace(/^W\//, "");
-function etagMatches(etag, ifNoneMatch) {
-	return ifNoneMatch != null && ifNoneMatch.split(",").some((t) => stripWeak(t.trim()) === stripWeak(etag));
-}
-function initializeGenerator(generator) {
-	if (!generator) {
-		if (crypto && crypto.subtle) generator = (body) => crypto.subtle.digest({ name: "SHA-1" }, body);
-	}
-	return generator;
-}
-/**
-* ETag Middleware for Acryl.
-*
-*
-* @param {ETagOptions} [options] - The options for the ETag middleware.
-* @param {boolean} [options.weak=false] - Define using or not using a weak validation. If true is set, then `W/` is added to the prefix of the value.
-* @param {string[]} [options.retainedHeaders=RETAINED_304_HEADERS] - The headers that you want to retain in the 304 Response.
-* @param {function(Uint8Array): ArrayBuffer | Promise<ArrayBuffer>} [options.generateDigest] -
-* A custom digest generation function. By default, it uses 'SHA-1'
-* This function is called with the response body as a `Uint8Array` and should return a hash as an `ArrayBuffer` or a Promise of one.
-* @returns {MiddlewareHandler} The middleware handler function.
-*
-* @example
-* ```ts
-* const app = new Acryl()
-*
-* app.use('/etag/*', etag())
-* app.get('/etag/abc', (c) => {
-*   return c.text('Acryl is hot')
-* })
-* ```
-*/
-const etag = (options) => {
-	const retainedHeaders = new Set((options?.retainedHeaders ?? RETAINED_304_HEADERS).map((header) => header.toLowerCase()));
-	const weak = options?.weak ?? false;
-	const generator = initializeGenerator(options?.generateDigest);
-	return async function etag(c, next) {
-		const ifNoneMatch = c.req.header("If-None-Match") ?? null;
-		await next();
-		if (!(c.req.method === "GET" || c.req.method === "HEAD" || c.req.method === "QUERY") || !c.res.ok) return;
-		const res = c.res;
-		let etag = res.headers.get("ETag");
-		if (!etag) {
-			if (!generator) return;
-			const hash = await generateDigest(res.clone().body, generator);
-			if (hash === null) return;
-			etag = weak ? `W/"${hash}"` : `"${hash}"`;
-		}
-		if (ifNoneMatch === "*" || etagMatches(etag, ifNoneMatch)) {
-			c.res = new Response(null, {
-				status: 304,
-				statusText: "Not Modified",
-				headers: { ETag: etag }
-			});
-			for (const key of Array.from(c.res.headers.keys())) if (!retainedHeaders.has(key.toLowerCase())) c.res.headers.delete(key);
-		} else c.res.headers.set("ETag", etag);
-	};
-};
-//#endregion
+import { n as etag, t as RETAINED_304_HEADERS } from "./etag-DaKMOjty.js";
 export { RETAINED_304_HEADERS, etag };

package/lib/helpers-CvTauQT5.js

@@ -0,0 +1,5 @@
+import "./factory.js";
+import "./ssg-BwjcA-Ge.js";
+import "./css.js";
+import "./connection-C7xgP1hP.js";
+export {};

package/lib/http-exception-kpGJkmpi.d.ts

@@ -0,0 +1,57 @@
+import { n as ContentfulStatusCode } from "./http-status-DaAwGAFL.js";
+
+//#region ../../plugins/acryl-router/src/core/http-exception.d.ts
+/**
+ * Options for creating an `HTTPException`.
+ * @property res - Optional response object to use.
+ * @property message - Optional custom error message.
+ * @property cause - Optional cause of the error.
+ */
+type HTTPExceptionOptions = {
+  res?: Response;
+  message?: string;
+  cause?: unknown;
+};
+/**
+ * `HTTPException` must be used when a fatal error such as authentication failure occurs.
+ *
+ *
+ * @param {StatusCode} status - status code of HTTPException
+ * @param {HTTPExceptionOptions} options - options of HTTPException
+ * @param {HTTPExceptionOptions["res"]} options.res - response of options of HTTPException
+ * @param {HTTPExceptionOptions["message"]} options.message - message of options of HTTPException
+ * @param {HTTPExceptionOptions["cause"]} options.cause - cause of options of HTTPException
+ *
+ * @example
+ * ```ts
+ * import { HTTPException } from 'acrylblends/http-exception'
+ *
+ * // ...
+ *
+ * app.post('/auth', async (c, next) => {
+ *   // authentication
+ *   if (authorized === false) {
+ *     throw new HTTPException(401, { message: 'Custom error message' })
+ *   }
+ *   await next()
+ * })
+ * ```
+ */
+declare class HTTPException extends Error {
+  readonly res?: Response;
+  readonly status: ContentfulStatusCode;
+  /**
+   * Creates an instance of `HTTPException`.
+   * @param status - HTTP status code for the exception. Defaults to 500.
+   * @param options - Additional options for the exception.
+   */
+  constructor(status?: ContentfulStatusCode, options?: HTTPExceptionOptions);
+  /**
+   * Returns the response object associated with the exception.
+   * If a response object is not provided, a new response is created with the error message and status code.
+   * @returns The response object.
+   */
+  getResponse(): Response;
+}
+//#endregion
+export { HTTPException as t };

package/lib/http-exception.d.ts

@@ -1,57 +1,2 @@
-import { n as ContentfulStatusCode } from "./http-status-DaAwGAFL.js";
-
-//#region ../../plugins/acryl-router/src/core/http-exception.d.ts
-/**
- * Options for creating an `HTTPException`.
- * @property res - Optional response object to use.
- * @property message - Optional custom error message.
- * @property cause - Optional cause of the error.
- */
-type HTTPExceptionOptions = {
-  res?: Response;
-  message?: string;
-  cause?: unknown;
-};
-/**
- * `HTTPException` must be used when a fatal error such as authentication failure occurs.
- *
- *
- * @param {StatusCode} status - status code of HTTPException
- * @param {HTTPExceptionOptions} options - options of HTTPException
- * @param {HTTPExceptionOptions["res"]} options.res - response of options of HTTPException
- * @param {HTTPExceptionOptions["message"]} options.message - message of options of HTTPException
- * @param {HTTPExceptionOptions["cause"]} options.cause - cause of options of HTTPException
- *
- * @example
- * ```ts
- * import { HTTPException } from 'acrylblends/http-exception'
- *
- * // ...
- *
- * app.post('/auth', async (c, next) => {
- *   // authentication
- *   if (authorized === false) {
- *     throw new HTTPException(401, { message: 'Custom error message' })
- *   }
- *   await next()
- * })
- * ```
- */
-declare class HTTPException extends Error {
-  readonly res?: Response;
-  readonly status: ContentfulStatusCode;
-  /**
-   * Creates an instance of `HTTPException`.
-   * @param status - HTTP status code for the exception. Defaults to 500.
-   * @param options - Additional options for the exception.
-   */
-  constructor(status?: ContentfulStatusCode, options?: HTTPExceptionOptions);
-  /**
-   * Returns the response object associated with the exception.
-   * If a response object is not provided, a new response is created with the error message and status code.
-   * @returns The response object.
-   */
-  getResponse(): Response;
-}
-//#endregion
+import { t as HTTPException } from "./http-exception-kpGJkmpi.js";
 export { HTTPException };

package/lib/{index-BLTYsyc1.d.ts → index-BnGgRKTv.d.ts}

@@ -1,41 +1,5 @@
-//#region ../../plugins/acryl-kv/src/kv.d.ts
-/** `T`, except a promise: the callback of `update` is synchronous, and an async one is a type error. */
-type NotPromise<T> = T extends PromiseLike<unknown> ? never : T;
-/** Anything JSON can hold. */
-type JsonValue = null | boolean | number | string | JsonValue[] | {
-  [key: string]: JsonValue;
-};
-/**
- * Named JSON documents. Every call returns a promise, so a file, SQLite and Postgres answer alike.
- *
- * Keys are non-empty strings. Values are JSON: `undefined`, functions, symbols, bigints and non-finite numbers are refused with a
- * `TypeError` before anything is written, and a value read back is a copy.
- *
- * There is no `close`: the code that opened a store closes it (see {@link KvOpened}), so a plugin cannot close the store another uses.
- */
-interface Kv {
-  /** The value stored under the key, or `undefined`. */
-  get<T = JsonValue>(key: string): Promise<T | undefined>;
-  /** Store a value under the key, replacing any. Resolves once it is durable. */
-  set<T = JsonValue>(key: string, value: T): Promise<void>;
-  /**
-   * Replace the value under the key by `change(current)`, atomically: `current` is `undefined` when the key is missing, `change` is
-   * synchronous (an `async` function is a type error, and a returned promise is rejected at run time: read what you need first, then update), and no other write to the key happens between reading it and writing the result. Resolves the new value. A `change` that
-   * throws, or returns something that is not JSON, leaves the value as it was and rejects with its error.
-   */
-  update<T = JsonValue>(key: string, change: (current: T | undefined) => NotPromise<T>): Promise<T>;
-  /** Remove the key. A missing key is not an error. */
-  delete(key: string): Promise<void>;
-  /** The keys that start with the prefix (all of them without one), sorted by code point (the order of their UTF-8 bytes, not of UTF-16 units). */
-  list(prefix?: string): Promise<string[]>;
-}
-/** An open store and the one function that closes it. */
-interface KvOpened {
-  readonly kv: Kv;
-  /** Waits for the writes in flight, then releases the storage. Calling it again does nothing; calls on `kv` after it reject. */
-  close(): Promise<void>;
-}
-//#endregion
+import { n as Kv } from "./kv-9f-AlRKN.js";
+
 //#region ../../plugins/acryl-kv/src/check.d.ts
 /**
  * What every `kv` provider checks the same way, so a bad call fails alike on a file and on SQL: the key, the value, and the order of keys.
@@ -90,4 +54,4 @@ declare function copyKv(source: Kv, target: Kv, options?: CopyKvOptions): Promis
 /** The service name every `kv` provider registers. */
 declare const KV_SERVICE = "kv";
 //#endregion
-export { checkKey as a, decodeValue as c, JsonValue as d, Kv as f, copyKv as i, encodeValue as l, NotPromise as m, CopyKvOptions as n, codePoints as o, KvOpened as p, CopyKvResult as r, compareKeys as s, KV_SERVICE as t, runChange as u };
+export { checkKey as a, decodeValue as c, copyKv as i, encodeValue as l, CopyKvOptions as n, codePoints as o, CopyKvResult as r, compareKeys as s, KV_SERVICE as t, runChange as u };