@vercel/board 0.24.0 → 0.25.1

package/dist/{a2-BxfKZFvJ.mjs → a2-A830f5NS.mjs}

@@ -1,15 +1,15 @@
 import { n as DIRECT_UPLOAD_BYTES_MAX, r as IMPORT_BYTES_MAX, t as ATTACHMENT_BYTES_MAX } from "./files-SniSmeEr.mjs";
 import { _ as RemoteWatcherId, b as actorKind, i as Attachment, x as platformAvatar } from "./schemas-Be08nyfW.mjs";
 import "./external-BV_cUncs.mjs";
-import { a as METHODS, d as VERSION, f as SYNC, n as compileWatcher, r as hasCriteria, t as canonicalWatchers } from "./watchers-hash-C_1jGA53.mjs";
-import { r as duration, t as BoardError } from "./client-ClznIBMg.mjs";
+import { a as METHODS, d as VERSION, f as SYNC, n as compileWatcher, r as hasCriteria, t as canonicalWatchers } from "./watchers-hash-BHNXy_N7.mjs";
+import { r as duration, t as BoardError } from "./client-D0Px7KzF.mjs";
 import { n as derivedId, r as isKeyIdOf } from "./ids-C6AYo1bu.mjs";
-import { a as forbidden, c as toErrorResponse, i as duplicateId, r as badRequest, s as notFound, t as HttpError } from "./errors-CQ-fwxM3.mjs";
+import { a as forbidden, c as toErrorResponse, i as duplicateId, r as badRequest, s as notFound, t as HttpError } from "./errors-CusN4x2l.mjs";
 import { t as own } from "./own-OwgPWdmh.mjs";
 import { n as replaceMentions } from "./mentions-CB6ShY4R.mjs";
-import { _ as FULL_ACCESS, i as authenticates, v as authorize } from "./auth-5nLsx9qB.mjs";
-import { a as resolveMentions, n as actorSeen } from "./actors-rPnEQLZu.mjs";
-import { n as MIDDLEWARE_ACTOR, t as DroppedError } from "./middleware-DUjyQP_a.mjs";
+import { _ as FULL_ACCESS, i as authenticates, v as authorize } from "./auth-lTkOgvcE.mjs";
+import { a as resolveMentions, n as actorSeen } from "./actors-BLXVp4oZ.mjs";
+import { n as MIDDLEWARE_ACTOR, t as DroppedError } from "./middleware-ChKM1zuu.mjs";
 import { n as syncTarget, r as withEmailMentions } from "./targets-C-wdR5wP.mjs";
 import { t as A2Error } from "./session-clear-wHd5GCpZ-BnKSxReK.mjs";
 import { a as reducer } from "./reducer-CjmvZSAb-D_OSISmj.mjs";

package/dist/access.d.mts

@@ -1,7 +1,6 @@
 import { a as Grant, i as ChannelPattern, n as AccessSummary, o as Permission, r as Can, t as Access } from "./access-CV96SYgr.mjs";
 import { _ as oidc, a as CallerRequest, c as HostPrincipal, d as OidcTokensOptions, f as Principal, g as githubActions, h as compileRules, i as AuthenticateContext, l as IssuerConfig, m as RuleFunction, n as AccessRule, o as Claims, p as PrincipalKind, r as Authenticate, t as AccessFunction, u as Known, v as vercelProject } from "./auth-CU56Q2Xh.mjs";
-import { o as Author } from "./schemas-CWxs3ECJ.mjs";
-import { t as Actor } from "./folds-CRYY14kc.mjs";
+import { C as Author, t as Actor } from "./folds-jS9wlh9_.mjs";
 //#region src/server/tokens.d.ts
 /**
  * The OIDC tokens made out to this board: a request's bearer token, from Vercel (people and

package/dist/access.mjs

@@ -1,4 +1,4 @@
-import { a as compileRules, c as githubActions, h as vercelProject, p as oidc } from "./auth-5nLsx9qB.mjs";
-import { i as resolveActor } from "./actors-rPnEQLZu.mjs";
-import { t as oidcTokens } from "./tokens-DUXaXwOj.mjs";
+import { a as compileRules, c as githubActions, h as vercelProject, p as oidc } from "./auth-lTkOgvcE.mjs";
+import { i as resolveActor } from "./actors-BLXVp4oZ.mjs";
+import { t as oidcTokens } from "./tokens-BuCU-61R.mjs";
 export { compileRules, githubActions, oidc, oidcTokens, resolveActor, vercelProject };

package/dist/{actors-rPnEQLZu.mjs → actors-BLXVp4oZ.mjs}

@@ -1,8 +1,8 @@
 import { C as toStorable } from "./schemas-Be08nyfW.mjs";
-import { r as badRequest } from "./errors-CQ-fwxM3.mjs";
+import { r as badRequest } from "./errors-CusN4x2l.mjs";
 import { t as own } from "./own-OwgPWdmh.mjs";
 import { t as extractMentions } from "./mentions-CB6ShY4R.mjs";
-import { y as parseScope } from "./auth-5nLsx9qB.mjs";
+import { y as parseScope } from "./auth-lTkOgvcE.mjs";
 //#region src/server/actors.ts
 /** Agents whose avatars the board serves itself. */
 const KNOWN_AGENTS = [

package/dist/{auth-5nLsx9qB.mjs → auth-lTkOgvcE.mjs}

@@ -1,5 +1,5 @@
 import { c as ChannelPath, v as SCOPE_MAX } from "./schemas-Be08nyfW.mjs";
-import { a as forbidden, l as unauthorized } from "./errors-CQ-fwxM3.mjs";
+import { a as forbidden, l as unauthorized } from "./errors-CusN4x2l.mjs";
 //#region src/server/access.ts
 /**
 * What a principal may do in a channel. `read` covers messages, threads,

package/dist/{backend-D0GDYiFr.d.mts → backend-ZKYTe3xa.d.mts}

@@ -1,8 +1,9 @@
 import { t as Access } from "./access-CV96SYgr.mjs";
 import { m as RuleFunction, n as AccessRule, r as Authenticate, s as Granted, t as AccessFunction, u as Known } from "./auth-CU56Q2Xh.mjs";
-import { i as Attachment, o as Author, p as Labels } from "./schemas-CWxs3ECJ.mjs";
-import { t as Actor, u as ExternalEvent } from "./folds-CRYY14kc.mjs";
-import { $ as Discovery, $t as SyncCodeView, Bt as SchedulesQuery, Et as PostBody, F as BoardClient, Gt as SourceJoinBody, It as ScheduleBody, Jt as SourceReadQuery, Nt as RegistrationView, Qt as SyncCodeBody, St as MessagesQuery, Tt as PersonView, Wt as SourceJoin, X as BoardEventView, Yt as SyncAccountBody, Z as ChannelView, _t as MatchView, an as SyncImportBody, bn as UploadStartBody, bt as MessageView, ct as InboxEntry, dn as SyncUnlinkBody, dt as InboxPushBody, en as SyncCopiesQuery, et as EditBody, fn as SyncedView, ft as InboxQuery, gn as ThreadsQuery, gt as LinkedQuery, hn as ThreadsPage, ht as LinkedAccount, in as SyncFindView, jt as RegisterBody, kt as ReactBody, ln as SyncRootsQuery, lt as InboxItem, mn as ThreadView, nt as EventsQuery, ot as IdentityView, p as SyncProvider, pt as LabelBody, q as AckBody, qt as SourceRead, rn as SyncFindQuery, sn as SyncReceiptBody, st as InboxAckBody, tn as SyncCopiesView, tt as EventsPage, un as SyncThreadView, ut as InboxNextQuery, vn as TypingBody, vt as MatchesQuery, xn as UploadTicket, xt as MessagesPage, yt as Me, z as ProfileOption, zt as ScheduleView } from "./provider-D11Dfda0.mjs";
+import { A as Labels, C as Author, t as Actor, u as ExternalEvent, x as Attachment } from "./folds-jS9wlh9_.mjs";
+import { A as InboxItem, At as SyncRootsQuery, B as Me, C as EventsQuery, D as IdentityView, Et as SyncImportBody, Ft as ThreadView, H as MessagesPage, Ht as UploadTicket, I as LinkedAccount, It as ThreadsPage, K as PersonView, L as LinkedQuery, Lt as ThreadsQuery, M as InboxPushBody, Mt as SyncUnlinkBody, N as InboxQuery, Nt as SyncedView, O as InboxAckBody, Ot as SyncReceiptBody, P as LabelBody, Q as RegisterBody, R as MatchView, S as EventsPage, St as SyncCopiesView, Tt as SyncFindView, U as MessagesQuery, V as MessageView, Vt as UploadStartBody, X as ReactBody, _ as BoardEventView, b as Discovery, bt as SyncCodeView, dt as SourceJoin, et as RegistrationView, ft as SourceJoinBody, gt as SyncAccountBody, ht as SourceReadQuery, j as InboxNextQuery, jt as SyncThreadView, k as InboxEntry, m as AckBody, mt as SourceRead, o as ProfileOption, ot as ScheduleView, q as PostBody, rt as ScheduleBody, st as SchedulesQuery, t as BoardClient, v as ChannelView, wt as SyncFindQuery, x as EditBody, xt as SyncCopiesQuery, yt as SyncCodeBody, z as MatchesQuery, zt as TypingBody } from "./client-xLxeDz0f.mjs";
+import { t as HttpError } from "./errors-CB4tnZGz.mjs";
+import { p as SyncProvider } from "./provider-Cdg1qadh.mjs";
 import { z } from "zod";
 //#region src/api/protocol.d.ts
 type Input<S extends z.ZodType> = NonNullable<z.output<S>>;
@@ -294,13 +295,6 @@ type Protocol = {
 };
 type Method = keyof Protocol;
 //#endregion
-//#region src/server/errors.d.ts
-declare class HttpError extends Error {
-  readonly status: number;
-  readonly code: string;
-  constructor(status: number, code: string, message: string);
-}
-//#endregion
 //#region src/server/middleware.d.ts
 /** Where a write came from, as the middleware sees it. */
 type WriteSource =
@@ -684,4 +678,4 @@ interface Backend extends ProtocolMethods {
   bind(board: BoardBinding): void;
 }
 //#endregion
-export { Protocol as C, Method as S, MiddlewareContext as _, Identity as a, WriteSource as b, SelfCaller as c, Board as d, BoardOptions as f, Middleware as g, DroppedError as h, Caller as i, Subscription as l, WatcherContext as m, BackendRoute as n, InboxDelivery as o, Watcher as p, BoardBinding as r, ProtocolMethods as s, Backend as t, VerifiedCaller as u, Write as v, HttpError as x, WritePatch as y };
+export { Protocol as S, MiddlewareContext as _, Identity as a, WriteSource as b, SelfCaller as c, Board as d, BoardOptions as f, Middleware as g, DroppedError as h, Caller as i, Subscription as l, WatcherContext as m, BackendRoute as n, InboxDelivery as o, Watcher as p, BoardBinding as r, ProtocolMethods as s, Backend as t, VerifiedCaller as u, Write as v, Method as x, WritePatch as y };

package/dist/backend-a2/blob-vercel.d.mts

@@ -1,4 +1,4 @@
-import { t as BlobStore } from "../blob-C0J3wbGv.mjs";
+import { t as BlobStore } from "../blob-B-9AvYis.mjs";
 //#region src/blob/vercel.d.ts
 export declare function vercelBlob(options?: {
   token?: string;

package/dist/backend-a2/contract.d.mts

@@ -1,5 +1,4 @@
-import { a as AttachmentId, c as ChannelPath, d as LabelKey, f as LabelValue, g as MessageText, h as MessageId, i as Attachment, l as Emoji, m as MESSAGE_TEXT_MAX, n as ActorId, o as Author, p as Labels, r as ActorKind, s as CHANNEL_PATH_MAX, t as ATTACHMENTS_PER_MESSAGE_MAX, u as Handle } from "../schemas-CWxs3ECJ.mjs";
-import { _ as BoardEvents, g as BoardEvent, h as BOARD_SESSION, i as ChannelsState, l as ExternalAuthor, m as Origin, n as ActorsState, o as Message, r as Channel, s as MessagesState, t as Actor } from "../folds-CRYY14kc.mjs";
+import { A as Labels, C as Author, D as Handle, E as Emoji, M as MessageId, N as MessageText, O as LabelKey, S as AttachmentId, T as ChannelPath, _ as BoardEvents, b as ActorKind, g as BoardEvent, h as BOARD_SESSION, i as ChannelsState, j as MESSAGE_TEXT_MAX, k as LabelValue, l as ExternalAuthor, m as Origin, n as ActorsState, o as Message, r as Channel, s as MessagesState, t as Actor, v as ATTACHMENTS_PER_MESSAGE_MAX, w as CHANNEL_PATH_MAX, x as Attachment, y as ActorId } from "../folds-jS9wlh9_.mjs";
 import { l as Reducer, n as Contract } from "../reducer-CYPHsSmd-BQIfozGi.mjs";
 import { z } from "zod";
 //#region src/contract/files.d.ts

package/dist/backend-a2/store-memory.d.mts

@@ -1,5 +1,5 @@
 import { n as Clock } from "../store-D0MhBvg6-4Z2L0Kqd.mjs";
-import { t as BoardStore } from "../types-8yq2VnKI.mjs";
+import { t as BoardStore } from "../types-aCAf6lGU.mjs";
 //#region src/store/memory.d.ts
 /**
  * A board that lives in memory, for tests: its log in A2's memory store, its

package/dist/backend-a2/store-postgres.d.mts

@@ -1,4 +1,4 @@
-import { t as BoardStore } from "../types-8yq2VnKI.mjs";
+import { t as BoardStore } from "../types-aCAf6lGU.mjs";
 //#region src/store/postgres-db.d.ts
 /** What the tables need of a `pg` Pool, or of anything shaped like one. */
 type PgQueryable = {

package/dist/backend-a2/store-redis-http.d.mts

@@ -1,4 +1,4 @@
-import { t as BoardStore } from "../types-8yq2VnKI.mjs";
+import { t as BoardStore } from "../types-aCAf6lGU.mjs";
 //#region src/store/redis-http.d.ts
 export type RedisHttpOptions = {
   /** The REST endpoint, e.g. `process.env.UPSTASH_REDIS_REST_URL`. */

package/dist/backend-a2/store-redis.d.mts

@@ -1,4 +1,4 @@
-import { t as BoardStore } from "../types-8yq2VnKI.mjs";
+import { t as BoardStore } from "../types-aCAf6lGU.mjs";
 //#region ../../node_modules/.pnpm/experimental-a2@0.22.0_@upstash+qstash@2.12.0_@vercel+queue@0.7.0_ai@7.0.130_zod@4.6.5__52060f00b21aecfab049c27fa3abd2f9/node_modules/experimental-a2/dist/store-redis.d.ts
 //#region src/store-redis-notify.d.ts
 type RedisConnection = {

package/dist/backend-a2/store-sqlite.d.mts

@@ -1,4 +1,4 @@
-import { t as BoardStore } from "../types-8yq2VnKI.mjs";
+import { t as BoardStore } from "../types-aCAf6lGU.mjs";
 //#region src/store/sqlite.d.ts
 /**
  * A board in one SQLite file, A2's log and board's tables side by side: `a2()`'s

package/dist/backend-a2.d.mts

@@ -1,11 +1,10 @@
-import { i as Attachment } from "./schemas-CWxs3ECJ.mjs";
-import { t as Actor } from "./folds-CRYY14kc.mjs";
+import { t as Actor, x as Attachment } from "./folds-jS9wlh9_.mjs";
 import { l as Reducer, r as ContractEvent } from "./reducer-CYPHsSmd-BQIfozGi.mjs";
 import { a as SessionAppend, c as SessionConsumeOptions, d as SessionSchedule, f as StateOptions, l as SessionConsumeResult, n as A2Server, o as SessionClearOptions, p as SessionCleared, r as Consumer, s as SessionClearResult, t as A2Scheduler, u as SessionDeadLetters } from "./server-qgez0Xny-D5mLfqFQ.mjs";
-import { $ as Discovery, $t as SyncCodeView, Nt as RegistrationView, Tt as PersonView, Wt as SourceJoin, Z as ChannelView, _t as MatchView, bt as MessageView, ct as InboxEntry, fn as SyncedView, hn as ThreadsPage, ht as LinkedAccount, in as SyncFindView, lt as InboxItem, mn as ThreadView, ot as IdentityView, qt as SourceRead, tn as SyncCopiesView, tt as EventsPage, un as SyncThreadView, xn as UploadTicket, xt as MessagesPage, yt as Me, zt as ScheduleView } from "./provider-D11Dfda0.mjs";
-import { i as Caller, n as BackendRoute, r as BoardBinding } from "./backend-D0GDYiFr.mjs";
-import { n as fsBlob, r as memoryBlob, t as BlobStore } from "./blob-C0J3wbGv.mjs";
-import { t as BoardStore } from "./types-8yq2VnKI.mjs";
+import { A as InboxItem, B as Me, D as IdentityView, Ft as ThreadView, H as MessagesPage, Ht as UploadTicket, I as LinkedAccount, It as ThreadsPage, K as PersonView, Nt as SyncedView, R as MatchView, S as EventsPage, St as SyncCopiesView, Tt as SyncFindView, V as MessageView, b as Discovery, bt as SyncCodeView, dt as SourceJoin, et as RegistrationView, jt as SyncThreadView, k as InboxEntry, mt as SourceRead, ot as ScheduleView, v as ChannelView } from "./client-xLxeDz0f.mjs";
+import { i as Caller, n as BackendRoute, r as BoardBinding } from "./backend-ZKYTe3xa.mjs";
+import { n as fsBlob, r as memoryBlob, t as BlobStore } from "./blob-B-9AvYis.mjs";
+import { t as BoardStore } from "./types-aCAf6lGU.mjs";
 import { z } from "zod";
 //#region src/server/transport.d.ts
 /**

package/dist/backend-a2.mjs

@@ -1,2 +1,2 @@
-import { n as fsBlob, r as memoryBlob, t as a2 } from "./a2-BxfKZFvJ.mjs";
+import { n as fsBlob, r as memoryBlob, t as a2 } from "./a2-A830f5NS.mjs";
 export { a2, fsBlob, memoryBlob };

package/dist/{backend-http-tGUo0e8j.mjs → backend-http-CJd4Fu0U.mjs}

@@ -1,5 +1,5 @@
-import { r as createHttp } from "./backend-http-rfiG-AKP.mjs";
-import { n as connect, r as environmentProfile, t as boardUrl } from "./node-CirFYqw0.mjs";
+import { r as createHttp } from "./backend-http-CYtfwqAW.mjs";
+import { n as connect, r as environmentProfile, t as boardUrl } from "./node-Bkd1x0QI.mjs";
 //#region src/backend-http/index.ts
 const environment = {
 	url: boardUrl,

package/dist/{backend-http-rfiG-AKP.mjs → backend-http-CYtfwqAW.mjs}

@@ -1,9 +1,9 @@
 import "./files-SniSmeEr.mjs";
 import "./schemas-Be08nyfW.mjs";
-import { K as routes, O as RegisterBody, a as METHODS, n as compileWatcher, t as canonicalWatchers } from "./watchers-hash-C_1jGA53.mjs";
-import { n as createBoardClient, t as BoardError } from "./client-ClznIBMg.mjs";
+import { K as routes, O as RegisterBody, a as METHODS, n as compileWatcher, t as canonicalWatchers } from "./watchers-hash-BHNXy_N7.mjs";
+import { n as createBoardClient, t as BoardError } from "./client-D0Px7KzF.mjs";
 import { a as sha256, i as keyId, n as derivedId, t as DERIVED_ID } from "./ids-C6AYo1bu.mjs";
-import { a as forbidden, o as json, t as HttpError } from "./errors-CQ-fwxM3.mjs";
+import { a as forbidden, o as json, t as HttpError } from "./errors-CusN4x2l.mjs";
 //#region src/server/registrant.ts
 /** Registering again this soon after the same registration only repeats it. */
 const REGISTER_EVERY_MS = 1e4;
@@ -239,7 +239,10 @@ function scopeOf(identity) {
 const describe = (error) => ((error instanceof Error ? error.message : String(error)) || "unknown error").slice(0, 500);
 /** The SDK's error, as the board answers it: the remote's own status and code, or 502 when it never answered. */
 const rethrow = (error) => {
-	if (error instanceof BoardError) throw new HttpError(error.status >= 400 ? error.status : 502, error.code, error.message);
+	if (error instanceof BoardError) throw new HttpError(error.status >= 400 ? error.status : 502, error.code, error.message, {
+		...error.hint !== void 0 ? { hint: error.hint } : {},
+		origin: error.origin
+	});
 	if (error instanceof HttpError || error instanceof Error && error.name === "AbortError") throw error;
 	throw new HttpError(502, "unreachable", `the board didn't answer: ${describe(error)}`);
 };
@@ -339,7 +342,7 @@ function createHttp(url, options, environment) {
 	let discovered = null;
 	/** The board it uses' discovery, for a handle here: who it is, and the sync entries it lists. */
 	const discovery = () => (discovered ??= doFetch(remote).then(async (response) => {
-		if (!response.ok) throw new HttpError(response.status >= 400 ? response.status : 502, "no_board", `no board at ${remote} (${response.status})`);
+		if (!response.ok) throw new HttpError(response.status >= 400 ? response.status : 502, "no_board", `There's no board at ${remote}: it answered ${response.status}.`, { origin: "handle" });
 		return await response.json();
 	}, rethrow)).catch((error) => {
 		discovered = null;
@@ -395,7 +398,7 @@ function createHttp(url, options, environment) {
 		if (response.ok) return response;
 		try {
 			const body = await response.json();
-			if (body.error?.message) throw new HttpError(response.status, body.error.code ?? "error", body.error.message);
+			if (body.error?.message) throw new HttpError(response.status, body.error.code ?? "error", body.error.message, typeof body.error.hint === "string" ? { hint: body.error.hint } : {});
 		} catch (error) {
 			if (error instanceof HttpError) throw error;
 		}

package/dist/{backend-http-Dvq2p__1.d.mts → backend-http-E7YU0qhn.d.mts}

@@ -1,7 +1,6 @@
-import { i as Attachment } from "./schemas-CWxs3ECJ.mjs";
-import { t as Actor } from "./folds-CRYY14kc.mjs";
-import { $ as Discovery, $t as SyncCodeView, Nt as RegistrationView, Tt as PersonView, Wt as SourceJoin, Z as ChannelView, _t as MatchView, bt as MessageView, ct as InboxEntry, fn as SyncedView, hn as ThreadsPage, ht as LinkedAccount, in as SyncFindView, lt as InboxItem, mn as ThreadView, ot as IdentityView, qt as SourceRead, tn as SyncCopiesView, tt as EventsPage, un as SyncThreadView, xn as UploadTicket, xt as MessagesPage, yt as Me, z as ProfileOption, zt as ScheduleView } from "./provider-D11Dfda0.mjs";
-import { i as Caller, n as BackendRoute, r as BoardBinding } from "./backend-D0GDYiFr.mjs";
+import { t as Actor, x as Attachment } from "./folds-jS9wlh9_.mjs";
+import { A as InboxItem, B as Me, D as IdentityView, Ft as ThreadView, H as MessagesPage, Ht as UploadTicket, I as LinkedAccount, It as ThreadsPage, K as PersonView, Nt as SyncedView, R as MatchView, S as EventsPage, St as SyncCopiesView, Tt as SyncFindView, V as MessageView, b as Discovery, bt as SyncCodeView, dt as SourceJoin, et as RegistrationView, jt as SyncThreadView, k as InboxEntry, mt as SourceRead, o as ProfileOption, ot as ScheduleView, v as ChannelView } from "./client-xLxeDz0f.mjs";
+import { i as Caller, n as BackendRoute, r as BoardBinding } from "./backend-ZKYTe3xa.mjs";
 //#region src/server/backend-http.d.ts
 type HttpOptions = {
   /**

package/dist/backend-http.d.mts

@@ -1,4 +1,4 @@
-import { n as HttpOptions, t as HttpBackend } from "./backend-http-Dvq2p__1.mjs";
+import { n as HttpOptions, t as HttpBackend } from "./backend-http-E7YU0qhn.mjs";
 //#region src/backend-http/index.default.d.ts
 /**
  * The board at `url`, which keeps the log. Outside Node there's no environment to find it or a

package/dist/backend-http.mjs

@@ -1,2 +1,2 @@
-import { t as http } from "./index.default-B6oPlvEa.mjs";
+import { t as http } from "./index.default-BejExznB.mjs";
 export { http };

package/dist/backend-http.node.d.mts

@@ -1,4 +1,4 @@
-import { n as HttpOptions, t as HttpBackend } from "./backend-http-Dvq2p__1.mjs";
+import { n as HttpOptions, t as HttpBackend } from "./backend-http-E7YU0qhn.mjs";
 //#region src/backend-http/index.d.ts
 /**
  * The board at `url`, which keeps the log: this board uses it as this deployment. Without a

package/dist/backend-http.node.mjs

@@ -1,2 +1,2 @@
-import { t as http } from "./backend-http-tGUo0e8j.mjs";
+import { t as http } from "./backend-http-CJd4Fu0U.mjs";
 export { http };

package/dist/{backend-vercel-DM5PyMc2.mjs → backend-vercel-BhwPExmE.mjs}

@@ -1,8 +1,8 @@
 import { _ as RemoteWatcherId } from "./schemas-Be08nyfW.mjs";
-import { O as RegisterBody, a as METHODS, d as VERSION, n as compileWatcher, t as canonicalWatchers } from "./watchers-hash-C_1jGA53.mjs";
+import { O as RegisterBody, a as METHODS, d as VERSION, n as compileWatcher, t as canonicalWatchers } from "./watchers-hash-BHNXy_N7.mjs";
 import { a as sha256, n as derivedId } from "./ids-C6AYo1bu.mjs";
-import { a as forbidden, o as json, s as notFound, t as HttpError } from "./errors-CQ-fwxM3.mjs";
-import { a as wakePath, i as registrant, n as callerProfile, t as PROJECTS_OWN } from "./backend-http-rfiG-AKP.mjs";
+import { a as forbidden, o as json, s as notFound, t as HttpError } from "./errors-CusN4x2l.mjs";
+import { a as wakePath, i as registrant, n as callerProfile, t as PROJECTS_OWN } from "./backend-http-CYtfwqAW.mjs";
 //#region src/server/backend-vercel.ts
 const PROFILE = /^[A-Za-z][A-Za-z0-9-]{0,31}$/;
 const SESSION = /^[A-Za-z0-9_.:-]{1,128}$/;

package/dist/{backend-vercel-C3zuxmcD.mjs → backend-vercel-Bqg2QfTd.mjs}

@@ -1,6 +1,6 @@
-import { t as HttpError } from "./errors-CQ-fwxM3.mjs";
-import { o as vercelLogin, r as environmentProfile, s as vercelProjectFile } from "./node-CirFYqw0.mjs";
-import { t as createVercel } from "./backend-vercel-DM5PyMc2.mjs";
+import { t as HttpError } from "./errors-CusN4x2l.mjs";
+import { o as vercelLogin, r as environmentProfile, s as vercelProjectFile } from "./node-Bkd1x0QI.mjs";
+import { t as createVercel } from "./backend-vercel-BhwPExmE.mjs";
 import { readFile } from "node:fs/promises";
 import { decodeJwt } from "jose";
 import { getVercelOidcToken } from "@vercel/oidc";
@@ -15,7 +15,10 @@ async function token() {
 	if (process.env.VERCEL_TOKEN) return process.env.VERCEL_TOKEN;
 	if (deployed()) return getVercelOidcToken();
 	return vercelLogin().catch(() => {
-		throw new HttpError(401, "not_logged_in", "not signed in to Vercel: run `vercel login`");
+		throw new HttpError(401, "not_logged_in", "You're not logged in to Vercel.", {
+			hint: "Run vercel login.",
+			origin: "handle"
+		});
 	});
 }
 /** Where `token` comes from, in words: what `vb whoami` says. */

package/dist/{backend-vercel-01QKDobk.d.mts → backend-vercel-CIRObA0t.d.mts}

@@ -1,7 +1,6 @@
-import { i as Attachment } from "./schemas-CWxs3ECJ.mjs";
-import { t as Actor } from "./folds-CRYY14kc.mjs";
-import { $ as Discovery, $t as SyncCodeView, Nt as RegistrationView, Tt as PersonView, Wt as SourceJoin, Z as ChannelView, _t as MatchView, bt as MessageView, ct as InboxEntry, fn as SyncedView, hn as ThreadsPage, ht as LinkedAccount, in as SyncFindView, lt as InboxItem, mn as ThreadView, ot as IdentityView, qt as SourceRead, tn as SyncCopiesView, tt as EventsPage, un as SyncThreadView, xn as UploadTicket, xt as MessagesPage, yt as Me, z as ProfileOption, zt as ScheduleView } from "./provider-D11Dfda0.mjs";
-import { i as Caller, n as BackendRoute, r as BoardBinding } from "./backend-D0GDYiFr.mjs";
+import { t as Actor, x as Attachment } from "./folds-jS9wlh9_.mjs";
+import { A as InboxItem, B as Me, D as IdentityView, Ft as ThreadView, H as MessagesPage, Ht as UploadTicket, I as LinkedAccount, It as ThreadsPage, K as PersonView, Nt as SyncedView, R as MatchView, S as EventsPage, St as SyncCopiesView, Tt as SyncFindView, V as MessageView, b as Discovery, bt as SyncCodeView, dt as SourceJoin, et as RegistrationView, jt as SyncThreadView, k as InboxEntry, mt as SourceRead, o as ProfileOption, ot as ScheduleView, v as ChannelView } from "./client-xLxeDz0f.mjs";
+import { i as Caller, n as BackendRoute, r as BoardBinding } from "./backend-ZKYTe3xa.mjs";
 //#region src/server/backend-vercel.d.ts
 type VercelOptions = {
   /** The team whose board it is: its ID (`team_…`) or its slug. In Node, by default your deployment's, or `VERCEL_ORG_ID`. */

package/dist/backend-vercel.d.mts

@@ -1,4 +1,4 @@
-import { n as VercelOptions, t as VercelBackend } from "./backend-vercel-01QKDobk.mjs";
+import { n as VercelOptions, t as VercelBackend } from "./backend-vercel-CIRObA0t.mjs";
 //#region src/backend-vercel/index.default.d.ts
 /**
  * Your team's board, in Vercel's API. Outside Node there's no environment to find credentials or

package/dist/backend-vercel.mjs

@@ -1,4 +1,4 @@
-import { t as createVercel } from "./backend-vercel-DM5PyMc2.mjs";
+import { t as createVercel } from "./backend-vercel-BhwPExmE.mjs";
 //#region src/backend-vercel/index.default.ts
 /**
 * Your team's board, in Vercel's API. Outside Node there's no environment to find credentials or

package/dist/backend-vercel.node.d.mts

@@ -1,4 +1,4 @@
-import { n as VercelOptions, t as VercelBackend } from "./backend-vercel-01QKDobk.mjs";
+import { n as VercelOptions, t as VercelBackend } from "./backend-vercel-CIRObA0t.mjs";
 //#region src/backend-vercel/index.d.ts
 /** Where `token` comes from, in words: what `vb whoami` says. */
 export declare function credentialSource(): string;

package/dist/backend-vercel.node.mjs

@@ -1,2 +1,2 @@
-import { n as vercel, t as credentialSource } from "./backend-vercel-C3zuxmcD.mjs";
+import { n as vercel, t as credentialSource } from "./backend-vercel-Bqg2QfTd.mjs";
 export { credentialSource, vercel };

package/dist/{blob-C0J3wbGv.d.mts → blob-B-9AvYis.d.mts}

@@ -1,4 +1,5 @@
-import "./schemas-CWxs3ECJ.mjs";
+import "./folds-jS9wlh9_.mjs";
+import "./errors-CB4tnZGz.mjs";
 //#region src/server/blob.d.ts
 /**
  * Where attachments' bytes live. The board writes each file once, under a key

package/dist/{chat-provider-D0k3y8zY.d.mts → chat-provider-DsNEBQiA.d.mts}

@@ -1,5 +1,6 @@
-import { d as ExternalFile, f as ExternalLink, l as ExternalAuthor, t as Actor } from "./folds-CRYY14kc.mjs";
-import { M as SyncRoot, O as ProviderEvent, Wt as SourceJoin, a as ProviderOptions, c as ReceivedEvent, d as ResolvedTarget, i as ProviderFile, n as FileDelivery, o as ProviderPost, p as SyncProvider, qt as SourceRead, r as ProviderDelivery, s as Receive, t as FetchedLink, y as SyncFn } from "./provider-D11Dfda0.mjs";
+import { d as ExternalFile, f as ExternalLink, l as ExternalAuthor, t as Actor } from "./folds-jS9wlh9_.mjs";
+import { dt as SourceJoin, mt as SourceRead } from "./client-xLxeDz0f.mjs";
+import { M as SyncRoot, O as ProviderEvent, a as ProviderOptions, c as ReceivedEvent, d as ResolvedTarget, i as ProviderFile, n as FileDelivery, o as ProviderPost, p as SyncProvider, r as ProviderDelivery, s as Receive, t as FetchedLink, y as SyncFn } from "./provider-Cdg1qadh.mjs";
 import { Adapter, Author, FileUpload, Message, ReactionEvent } from "chat";
 //#region src/sync/types.d.ts
 declare function externalAuthor(platform: string, author: Author): ExternalAuthor;

package/dist/cli-embedded.d.mts

@@ -1,5 +1,47 @@
-import { d as Board } from "./backend-D0GDYiFr.mjs";
-import "./index-B_hWanKF.mjs";
+import { d as Board } from "./backend-ZKYTe3xa.mjs";
+import "./index-C05it0mC.mjs";
+//#region src/cli/failure.d.ts
+/**
+ * What kind of failure it is, which fixes the exit code: 2 for `usage` and `missing_input`, 124
+ * for `timeout`, 130 for `canceled`, and 1 for the rest.
+ */
+type FailureClass = 'usage' | 'missing_input' | 'auth' | 'permission' | 'not_found' | 'conflict' | 'limit' | 'rate_limit' | 'network' | 'platform' | 'timeout' | 'canceled' | 'unknown';
+/** One way out: what to do, and the command that does it, whole (`['vb', 'read', 'dev', '--scope', '<TEAM>']`). */
+type Recovery = {
+  instruction: string;
+  argv?: string[];
+};
+type Failure = {
+  class: FailureClass;
+  /** Stable and snake_case: what a program branches on. */
+  reason: string;
+  /** The headline: what failed, then the known cause, as sentences. */
+  message: string;
+  /** What the headline can't hold, a line each: the board's own message, say. */
+  details?: string[];
+  /** Facts needed to act on it, as rows: `['Board', 'https://…']`. */
+  context?: [string, string][];
+  /** At most two, likeliest first. */
+  next?: Recovery[];
+  /** Blocked before anything happened, until someone gives it what it needs (a team, say). */
+  actionRequired?: boolean;
+  /** For programs: what the CLI resolved, and the board's own error (`{ code, message }`) when it answered with one. */
+  data?: Record<string, unknown>;
+};
+/** A write went through, with something to say about it. */
+type Warning = {
+  reason: string;
+  message: string;
+};
+/** A recovery's command, as a person types it. */
+export declare const commandLine: (argv: readonly string[]) => string;
+/**
+ * The failure as lines, the headline first and the rest as they sit under it, before the indent a
+ * CLI adds under its own mark (`error: `, `✗ `): details, context rows, then each way out after a
+ * blank line, its command two spaces in.
+ */
+export declare function failureLines(failure: Failure): string[];
+//#endregion
 //#region src/cli/main.d.ts
 /**
  * The command `argv` runs, by its own name (`delete` for `rm`), as the parser reads it: the
@@ -13,11 +55,19 @@ export declare function commandWord(argv: string[]): string | undefined;
  * Board's CLI as `appName` names it in help, usage, and errors (`vercel board`). With no board
  * URL anywhere, it talks to the team's board in Vercel's API: `VERCEL_ORG_ID`'s, the nearest linked
  * project's team's (`.vercel`), your login's, or `--scope`'s. `run` takes what follows the name, and answers the exit code:
- * 0 success, 1 error, 2 misuse, 124 when `wait` times out. It never exits the process itself. One `run`
+ * 0 success, 1 error, 2 misuse, 124 when `wait` times out, 130 when Ctrl-C stops it. It never exits the process itself. One `run`
  * at a time: a run's flags are the CLI's while it runs.
+ *
+ * A failure goes to `onError`, with whether the run asked for `--json`, to show as the app shows
+ * its own, and a warning to `onWarning` (with `--json`, it's in the result). Without them, the CLI
+ * prints its own on stderr.
  */
 export declare function createApp(options: {
   appName: string;
+  onError?: (failure: Failure, mode: {
+    json: boolean;
+  }) => void;
+  onWarning?: (warning: Warning) => void;
 }): {
   run(args: string[]): Promise<number>;
 };
@@ -48,4 +98,5 @@ export type VbResult = {
  * `tail` and `wait`, which hold the rest until they end, need `options.signal`.
  */
 export declare function vb(board: Board, argv: string[], options?: VbOptions): Promise<VbResult>;
-//#endregion
+//#endregion
+export type { Failure, FailureClass, Recovery, Warning };

package/dist/cli-embedded.mjs

@@ -1,22 +1,42 @@
-import { n as main, r as mainWith, t as commandWord } from "./main-CzWvRy91.mjs";
+import { a as commandLine, c as failureLines, i as mainWith, l as formatFailure, n as commandWord, o as exitCode, r as main, s as failureDocument, t as Failed } from "./main-DOhNCWMd.mjs";
 //#region src/cli/embedded.ts
 /**
 * Board's CLI as `appName` names it in help, usage, and errors (`vercel board`). With no board
 * URL anywhere, it talks to the team's board in Vercel's API: `VERCEL_ORG_ID`'s, the nearest linked
 * project's team's (`.vercel`), your login's, or `--scope`'s. `run` takes what follows the name, and answers the exit code:
-* 0 success, 1 error, 2 misuse, 124 when `wait` times out. It never exits the process itself. One `run`
+* 0 success, 1 error, 2 misuse, 124 when `wait` times out, 130 when Ctrl-C stops it. It never exits the process itself. One `run`
 * at a time: a run's flags are the CLI's while it runs.
+*
+* A failure goes to `onError`, with whether the run asked for `--json`, to show as the app shows
+* its own, and a warning to `onWarning` (with `--json`, it's in the result). Without them, the CLI
+* prints its own on stderr.
 */
 function createApp(options) {
+	const { appName, onError, onWarning } = options;
 	return { run: (args) => main(args, {
-		name: options.appName,
+		name: appName,
 		commands: {},
-		teamBoard: true
+		teamBoard: true,
+		...onError ? { onError } : {},
+		...onWarning ? { onWarning } : {}
 	}) };
 }
-const lacking = (what) => async () => {
-	throw new Error(`${what}: pass it in vb()'s options`);
+const lacking = (what, option) => async () => {
+	throw new Failed({
+		class: "usage",
+		reason: "not_available",
+		message: `${what} here: pass ${option} in vb()'s options.`
+	});
 };
+/** A call `vb()` answers itself, printed as the CLI would print it. */
+function refused(argv, failure) {
+	const stderr = argv.slice(0, argv.includes("--") ? argv.indexOf("--") : void 0).includes("--json") ? JSON.stringify(failureDocument(failure)) : formatFailure(failure);
+	return Promise.resolve({
+		code: exitCode(failure),
+		stdout: "",
+		stderr: `${stderr}\n`
+	});
+}
 let queue = Promise.resolve();
 /**
 * Runs the vb command `argv` (`['read', '42']`, `['reply', '42', 'on it']`) on `board`, in this
@@ -27,15 +47,15 @@ let queue = Promise.resolve();
 */
 function vb(board, argv, options = {}) {
 	const word = commandWord(argv);
-	if (word !== void 0 && options.refuse?.includes(word)) return Promise.resolve({
-		code: 2,
-		stdout: "",
-		stderr: `error: ${word} isn't available here\n`
+	if (word !== void 0 && options.refuse?.includes(word)) return refused(argv, {
+		class: "usage",
+		reason: "not_available",
+		message: `${word} isn't available here.`
 	});
-	if ((word === "tail" || word === "wait") && !options.signal) return Promise.resolve({
-		code: 2,
-		stdout: "",
-		stderr: `error: ${word} runs until it's stopped, and vb() runs one call at a time: pass a signal\n`
+	if ((word === "tail" || word === "wait") && !options.signal) return refused(argv, {
+		class: "usage",
+		reason: "not_available",
+		message: `${word} runs until it's stopped, and vb() runs one call at a time: pass a signal.`
 	});
 	const result = queue.then(async () => {
 		let stdout = "";
@@ -49,9 +69,9 @@ function vb(board, argv, options = {}) {
 				board,
 				write: (chunk) => void (stdout += typeof chunk === "string" ? chunk : decoder.decode(chunk, { stream: true })),
 				error: (chunk) => void (stderr += chunk),
-				readFile: options.readFile ? async (path) => options.readFile(path) : lacking("--attach reads files"),
-				writeFile: options.writeFile ? async (path, data) => options.writeFile(path, data) : lacking("download saves files"),
-				stdin: options.stdin !== void 0 ? async () => options.stdin : lacking("- reads stdin"),
+				readFile: options.readFile ? async (path) => options.readFile(path) : lacking("--attach can't read files", "readFile"),
+				writeFile: options.writeFile ? async (path, data) => options.writeFile(path, data) : lacking("download can't save files", "writeFile"),
+				stdin: options.stdin !== void 0 ? async () => options.stdin : lacking("- can't read stdin", "stdin"),
 				...options.signal ? { signal: options.signal } : {}
 			}),
 			stdout,
@@ -62,4 +82,4 @@ function vb(board, argv, options = {}) {
 	return result;
 }
 //#endregion
-export { commandWord, createApp, vb };
+export { commandLine, commandWord, createApp, failureLines, vb };

package/dist/cli.mjs

@@ -2,8 +2,8 @@
 import { t as ATTACHMENT_BYTES_MAX } from "./files-SniSmeEr.mjs";
 import "./schemas-Be08nyfW.mjs";
 import { a as option } from "./commands-BtL4jFq8.mjs";
-import { a as projectDir } from "./node-CirFYqw0.mjs";
-import { i as who, n as main } from "./main-CzWvRy91.mjs";
+import { a as projectDir } from "./node-Bkd1x0QI.mjs";
+import { r as main, u as who } from "./main-DOhNCWMd.mjs";
 import { randomBytes, timingSafeEqual } from "node:crypto";
 import { appendFile, readFile } from "node:fs/promises";
 import { join } from "node:path";
@@ -658,10 +658,10 @@ const local = {
 			}]
 		},
 		async run(args, { flags, out, usage, portFlag, connection, openBrowser }) {
-			if (args.length > 0) throw usage("usage: board serve [--port N] [--dir <dir>] [--no-inspect] [--no-open]");
+			if (args.length > 0) throw usage("serve takes no arguments: pass its port with --port, and its directory with --dir.");
 			const port = portFlag();
 			const root = projectDir();
-			const { localHandle, serveLocal } = await import("./serve-DHyA-6FR.mjs");
+			const { localHandle, serveLocal } = await import("./serve-D2O0C6Kk.mjs");
 			const handle = flags.handle ?? process.env.BOARD_HANDLE;
 			const local = await serveLocal({
 				dir: flags.dir ?? join(root, ".board"),