@vercel/board 0.24.0 → 0.25.1

package/dist/{client-ClznIBMg.mjs → client-D0Px7KzF.mjs}

@@ -39,16 +39,31 @@ async function* parseSse(body, signal) {
 }
 //#endregion
 //#region src/client/client.ts
+/**
+* What went wrong: `message` says what and why, `code` is what to branch on, `hint`, when there's
+* one, what fixes it, and `origin` who said so. Trust a `board` one's message and hint as you would
+* the board.
+*/
 var BoardError = class extends Error {
 	code;
 	status;
-	constructor(code, message, status) {
+	hint;
+	origin;
+	constructor(code, message, status, options = {}) {
 		super(message);
 		this.name = "BoardError";
 		this.code = code;
 		this.status = status;
+		this.hint = options.hint;
+		this.origin = options.origin ?? "handle";
 	}
 };
+/**
+* The responses, made in this process, that carry an error the handle raised: a handle's request
+* to a board in this process keeps its errors the handle's on the way back. Nothing a board sends
+* can be one.
+*/
+const handleErrors = /* @__PURE__ */ new WeakSet();
 const resolve = async (value) => typeof value === "function" ? await value() : value;
 const scheduleBody = (input) => {
 	const { at, until, ...rest } = messageBody(input);
@@ -76,7 +91,7 @@ const UNITS = {
 function duration(value) {
 	if (typeof value === "number") return value;
 	const match = value.trim().match(/^(\d+(?:\.\d+)?)(ms|s|m|h|d)?$/);
-	if (!match) throw new BoardError("invalid_duration", `invalid duration: ${value}`, 0);
+	if (!match) throw new BoardError("invalid_duration", `${value} isn't a duration like 30s, 10m, or 1h.`, 0);
 	return Number(match[1]) * UNITS[match[2] ?? "ms"];
 }
 /** A ref as a path segment: opaque, so it's encoded as it is. */
@@ -214,13 +229,13 @@ function createBoardClient(options) {
 			const type = input.type || (input.data instanceof Blob ? input.data.type : "") || typeOf(input.name);
 			const size = input.data instanceof Blob ? input.data.size : input.data.byteLength;
 			if (size > 4194304) {
-				if (size > 104857600) throw new BoardError("too_large", `attachments are at most ${DIRECT_UPLOAD_BYTES_MAX / 1024 / 1024} MB`, 413);
+				if (size > 104857600) throw new BoardError("too_large", `Attachments are at most ${DIRECT_UPLOAD_BYTES_MAX / 1024 / 1024} MB.`, 413);
 				const ticket = await call("POST", "/attachments/uploads", { body: {
 					name: input.name,
 					type,
 					size
 				} }).catch((error) => {
-					if (error instanceof BoardError && error.status === 404 && error.code === "not_found") throw new BoardError("too_large", `this board takes files of at most ${ATTACHMENT_BYTES_MAX / 1024 / 1024} MB`, 413);
+					if (error instanceof BoardError && error.status === 404 && error.code === "not_found") throw new BoardError("too_large", `This board takes files of at most ${ATTACHMENT_BYTES_MAX / 1024 / 1024} MB.`, 413);
 					throw error;
 				});
 				const put = await storeFetch(ticket.url, {
@@ -228,7 +243,7 @@ function createBoardClient(options) {
 					headers: ticket.headers,
 					body: input.data
 				});
-				if (!put.ok) throw new BoardError("upload_failed", `the blob store refused the file: ${put.status} ${(await put.text().catch(() => "")).slice(0, 300) || put.statusText}`, put.status);
+				if (!put.ok) throw new BoardError("upload_failed", `The blob store refused the file: ${put.status} ${(await put.text().catch(() => "")).slice(0, 300) || put.statusText}`, put.status);
 				return (await call("POST", `/attachments/uploads/${encodeURIComponent(ticket.id)}`, { body: {} })).attachment;
 			}
 			const response = await doFetch(`${base}/attachments`, {
@@ -382,9 +397,12 @@ function createBoardClient(options) {
 async function toError(response) {
 	try {
 		const body = await response.json();
-		if (body.error?.message) return new BoardError(body.error.code ?? "error", body.error.message, response.status);
+		if (body.error?.message) return new BoardError(body.error.code ?? "error", body.error.message, response.status, {
+			...typeof body.error.hint === "string" ? { hint: body.error.hint } : {},
+			origin: handleErrors.has(response) ? "handle" : "board"
+		});
 	} catch {}
-	return new BoardError("http_error", `${response.status} ${response.statusText}`, response.status);
+	return new BoardError("http_error", `The board answered ${`${response.status} ${response.statusText}`.trim()}.`, response.status);
 }
 //#endregion
-export { createBoardClient as n, duration as r, BoardError as t };
+export { handleErrors as i, createBoardClient as n, duration as r, BoardError as t };