@vercel/board 0.16.0 → 0.18.0

package/dist/backend-a2.mjs

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

package/dist/{backend-http-Bid7RIpC.d.mts → backend-http-7cNb8nJI.d.mts}

@@ -1,7 +1,7 @@
 import { i as Attachment } from "./schemas-CWxs3ECJ.mjs";
-import { t as Actor } from "./reducers-B_vUGQRp.mjs";
-import { Bt as SyncCodeView, G as Discovery, Gt as SyncFindView, Ht as SyncCopiesView, Ot as ScheduleView, Pt as SourceRead, Q as IdentityView, St as RegistrationView, U as ChannelView, Zt as SyncThreadView, ct as MatchView, dt as MessageView, en as ThreadView, et as InboxEntry, ft as MessagesPage, ht as PersonView, j as ProfileOption, q as EventsPage, sn as UploadTicket, st as LinkedAccount, tn as ThreadsPage, tt as InboxItem, ut as Me } from "./provider-BGjz-mDa.mjs";
-import { a as BackendRoute, o as BoardBinding, s as Caller } from "./a2-D24cvwpN.mjs";
+import { t as Actor } from "./folds-CRYY14kc.mjs";
+import { $ as Discovery, Mt as RegistrationView, Qt as SyncCopiesView, Rt as ScheduleView, Tt as PersonView, Wt as SourceRead, Xt as SyncCodeView, Z as ChannelView, _t as MatchView, bt as MessageView, ct as InboxEntry, dn as ThreadView, fn as ThreadsPage, ht as LinkedAccount, ln as SyncedView, lt as InboxItem, ot as IdentityView, sn as SyncThreadView, tn as SyncFindView, tt as EventsPage, vn as UploadTicket, xt as MessagesPage, yt as Me, z as ProfileOption } from "./provider-B0b9Qxw4.mjs";
+import { i as Caller, n as BackendRoute, r as BoardBinding } from "./backend-B-SJ7p6p.mjs";
 //#region src/server/backend-http.d.ts
 type HttpOptions = {
   /**
@@ -245,6 +245,12 @@ declare function createHttp(url: string | undefined, options: HttpOptions, envir
     target: string;
     limit?: number | undefined;
   }, signal: AbortSignal) => Promise<SourceRead>;
+  synced: (caller: Caller, input: {
+    id: string;
+  }, signal: AbortSignal) => Promise<SyncedView>;
+  linked: (caller: Caller, input: {
+    url: string;
+  }, signal: AbortSignal) => Promise<ThreadView>;
   syncImport: (caller: Caller, input: {
     author: {
       id: string;
@@ -555,6 +561,7 @@ declare function createHttp(url: string | undefined, options: HttpOptions, envir
         owns?: string[] | undefined;
         reply: string | null;
         createRoot: boolean;
+        retitled?: boolean | undefined;
         author: {
           id: string;
           handle: string;

package/dist/{backend-http-0roEmjl0.mjs → backend-http-CMlL3yq3.mjs}

@@ -1,5 +1,5 @@
-import { t as BoardError } from "./client-DGDPaN7U.mjs";
-import { t as createHttp } from "./backend-http-BVRno-ca.mjs";
+import { t as BoardError } from "./client-BA-J7usH.mjs";
+import { t as createHttp } from "./backend-http-Ddzd5kTS.mjs";
 import { execFile } from "node:child_process";
 import { createHash } from "node:crypto";
 import { mkdir, readFile, writeFile } from "node:fs/promises";

package/dist/{backend-http-BVRno-ca.mjs → backend-http-Ddzd5kTS.mjs}

@@ -1,8 +1,8 @@
 import "./files-SniSmeEr.mjs";
 import "./schemas-Be08nyfW.mjs";
-import { V as routes, a as DERIVED_ID, c as keyId, l as sha256, o as derivedId, t as compileWatcher, w as RegisterBody } from "./watch-spec-W0c7ypHJ.mjs";
-import { n as createBoardClient, t as BoardError } from "./client-DGDPaN7U.mjs";
-import { n as METHODS, t as canonicalWatchers } from "./watchers-hash-CLjsa6od.mjs";
+import { K as routes, k as RegisterBody, n as compileWatcher, o as METHODS, t as canonicalWatchers } from "./watchers-hash-RLtnSF-t.mjs";
+import { n as createBoardClient, t as BoardError } from "./client-BA-J7usH.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-DX3hpwWt.mjs";
 //#region src/server/backend-http.ts
 /** A watcher's or client's name is the profile its writes are by. */
@@ -308,6 +308,35 @@ function createHttp(url, options, environment) {
 			if ("self" in caller && bound().sync.some((entry) => entry.key === input.key)) return bound().readSource(input.key, input.target, input.limit ?? 50);
 			return remoteCall("readSource", caller, input, signal);
 		},
+		async synced(caller, input, signal) {
+			const { targets } = await remoteCall("synced", caller, input, signal);
+			return { targets: await Promise.all(targets.map(async (row) => ({
+				...row,
+				url: row.url ?? (row.thread !== null && row.message !== null ? await bound().linkOf(row.key, row.thread, row.message) : null)
+			}))) };
+		},
+		async linked(caller, input, signal) {
+			const missing = () => new HttpError(404, "message_not_found", "no message on this board for that link");
+			const first = async () => {
+				for (const { platform, thread, message } of bound().locate(input.url)) for (const entry of bound().sync.filter((candidate) => candidate.platform === platform)) {
+					const at = await own.syncFind({
+						thread: `${entry.key}:${thread}`,
+						...message !== null ? { message } : {}
+					}, { signal }).catch(rethrow);
+					const found = message !== null ? at.message : at.thread === null ? null : (await own.syncThread(at.thread).catch(rethrow)).root;
+					if (found !== null) return found;
+				}
+				return null;
+			};
+			const id = await first();
+			if (id === null) return remoteCall("linked", caller, input, signal);
+			try {
+				return await methods.message(caller, { id }, signal);
+			} catch (error) {
+				if (error instanceof HttpError && error.status === 404) throw missing();
+				throw error;
+			}
+		},
 		async typing(caller, input, signal) {
 			const { targets } = await remoteCall("typing", caller, input, signal);
 			if (!("self" in caller) || bound().sync.length === 0) return { targets };

package/dist/backend-http.d.mts

@@ -1,4 +1,4 @@
-import { n as HttpOptions, t as HttpBackend } from "./backend-http-Bid7RIpC.mjs";
+import { n as HttpOptions, t as HttpBackend } from "./backend-http-7cNb8nJI.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-Bkg77Pxn.mjs";
+import { t as http } from "./index.default-C5Cpz3sa.mjs";
 export { http };

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

@@ -1,4 +1,4 @@
-import { n as HttpOptions, t as HttpBackend } from "./backend-http-Bid7RIpC.mjs";
+import { n as HttpOptions, t as HttpBackend } from "./backend-http-7cNb8nJI.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-0roEmjl0.mjs";
+import { t as http } from "./backend-http-CMlL3yq3.mjs";
 export { http };

package/dist/{chat-provider-XCnQlxq6.d.mts → chat-provider-DNJQyajS.d.mts}

@@ -1,5 +1,5 @@
-import { _ as ExternalFile, h as ExternalAuthor, t as Actor, v as ExternalLink } from "./reducers-B_vUGQRp.mjs";
-import { Pt as SourceRead, a as ProviderFile, b as ProviderEvent, c as Receive, d as ResolvedTarget, h as SyncProvider, i as ProviderDelivery, l as ReceivedEvent, n as FetchedLink, o as ProviderOptions, r as FileDelivery, s as ProviderPost, w as SyncRoot } from "./provider-BGjz-mDa.mjs";
+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 SourceRead, 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-B0b9Qxw4.mjs";
 import { Adapter, Author, FileUpload, Message, ReactionEvent } from "chat";
 //#region src/sync/types.d.ts
 declare function externalAuthor(platform: string, author: Author): ExternalAuthor;
@@ -34,6 +34,13 @@ type ChatTransport = Omit<ProviderOptions, 'uploadsFiles'> & {
   /** Platform messages a message links to, located under sync key `key`. */
   links?(key: string, message: Message): ExternalLink[];
   fetchLink?(link: ExternalLink): Promise<FetchedLink>;
+  /** The message a URL of the platform's names, by its own IDs: `SyncProvider.locate`. */
+  locate?(url: string): {
+    thread: string;
+    message: string | null;
+  } | null;
+  /** The platform's URL for a message, by its own IDs: `SyncProvider.url`. */
+  url?(thread: string, message: string): Promise<string | null>;
   /** A channel or thread, read on demand without syncing it. */
   read?(target: string, options: {
     limit: number;
@@ -64,10 +71,10 @@ declare abstract class ChatSyncProvider<E extends ProviderEvent = ProviderEvent>
   private readonly chat;
   private readonly receiving;
   private initialized;
-  constructor(transport: ChatTransport);
+  constructor(transport: ChatTransport, sync: SyncFn<E>);
   protected toNative(id: string): string;
   protected toChat(id: string): string;
-  protected locate(key: string, chatThread: string): {
+  protected locationOf(key: string, chatThread: string): {
     channel: string;
     thread: string;
     subthread: string | null;
@@ -109,6 +116,11 @@ declare abstract class ChatSyncProvider<E extends ProviderEvent = ProviderEvent>
   mention(actor: Actor): string | null;
   fetchRoot(thread: string): Promise<SyncRoot | null>;
   fetchLink(link: ExternalLink): Promise<FetchedLink>;
+  locate(url: string): {
+    thread: string;
+    message: string | null;
+  } | null;
+  url(thread: string, message: string): Promise<string | null>;
   read(target: string, options: {
     limit: number;
   }): Promise<SourceRead>;

package/dist/{chat-provider-jFSeyNmB.mjs → chat-provider-YHy-WbrB.mjs}

@@ -1,6 +1,6 @@
-import "./contract-CuJmlrhw.mjs";
-import { n as ResolvedTarget, r as SyncProvider } from "./provider-CuewcDNZ.mjs";
-import { n as userTokensOf } from "./users-Dls7_ANV.mjs";
+import "./external-BV_cUncs.mjs";
+import { n as ResolvedTarget, r as SyncProvider } from "./provider-B3DpYSDq.mjs";
+import { n as userTokensOf } from "./users-yryHKFMo.mjs";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { Chat, stringifyMarkdown } from "chat";
 //#region src/sync/state.ts
@@ -128,12 +128,12 @@ var ChatSyncProvider = class extends SyncProvider {
 	chat;
 	receiving = new AsyncLocalStorage();
 	initialized;
-	constructor(transport) {
+	constructor(transport, sync) {
 		super({
 			...transport,
 			users: transport.users ?? userTokensOf(transport.adapter),
 			uploadsFiles: !!transport.uploadFiles
-		});
+		}, sync);
 		this.transport = transport;
 		this.chat = createChat(transport.adapter);
 		const onMessage = async (_thread, message) => this.emit({
@@ -164,7 +164,7 @@ var ChatSyncProvider = class extends SyncProvider {
 	toChat(id) {
 		return `${this.transport.adapter.name}:${this.transport.toChatId?.(id) ?? id}`;
 	}
-	locate(key, chatThread) {
+	locationOf(key, chatThread) {
 		const native = this.toNative(chatThread);
 		const precise = `${key}:${native}`;
 		const thread = `${key}:${this.transport.groupThread?.(native) ?? native}`;
@@ -203,7 +203,7 @@ var ChatSyncProvider = class extends SyncProvider {
 			raw: input.raw,
 			event: {
 				kind: "deleted",
-				...this.locate(key, input.thread),
+				...this.locationOf(key, input.thread),
 				message: input.message
 			}
 		};
@@ -215,7 +215,7 @@ var ChatSyncProvider = class extends SyncProvider {
 				raw: event.raw,
 				event: {
 					kind: "reaction",
-					...this.locate(key, event.threadId),
+					...this.locationOf(key, event.threadId),
 					message: event.messageId,
 					emoji,
 					added: event.added,
@@ -227,7 +227,7 @@ var ChatSyncProvider = class extends SyncProvider {
 		const found = this.transport.links?.(key, message) ?? [];
 		const links = found.length ? { links: found.slice(0, 10) } : {};
 		const common = {
-			...this.locate(key, message.threadId),
+			...this.locationOf(key, message.threadId),
 			message: message.id,
 			text: this.transport.markdown?.(message) ?? markdownOf(message),
 			author: await this.authorOf(message),
@@ -303,6 +303,12 @@ var ChatSyncProvider = class extends SyncProvider {
 	async fetchLink(link) {
 		return this.transport.fetchLink ? this.transport.fetchLink(link) : super.fetchLink(link);
 	}
+	locate(url) {
+		return this.transport.locate ? this.transport.locate(url) : super.locate(url);
+	}
+	async url(thread, message) {
+		return this.transport.url ? this.transport.url(thread, message) : super.url(thread, message);
+	}
 	async read(target, options) {
 		return this.transport.read ? this.transport.read(target, options) : super.read(target, options);
 	}

package/dist/cli.mjs

@@ -1,13 +1,12 @@
 #!/usr/bin/env node
 import { i as fileSize, n as DIRECT_UPLOAD_BYTES_MAX, t as ATTACHMENT_BYTES_MAX } from "./files-SniSmeEr.mjs";
 import { a as AttachmentId } from "./schemas-Be08nyfW.mjs";
-import { i as withMentions, r as FILTER_FLAGS } from "./watch-spec-W0c7ypHJ.mjs";
+import { a as withMentions, f as VERSION, i as FILTER_FLAGS } from "./watchers-hash-RLtnSF-t.mjs";
 import { n as displayEmoji, r as normalizeEmoji } from "./emoji-CTLpvH-A.mjs";
-import { t as BoardError } from "./client-DGDPaN7U.mjs";
-import { c as VERSION } from "./watchers-hash-CLjsa6od.mjs";
-import { a as detectAgent, c as projectUrl, i as connect, n as boardUrl, r as configDir, s as projectDir, t as http } from "./backend-http-0roEmjl0.mjs";
-import { t as board } from "./server-jwPY7_wi.mjs";
-import { t as conformance } from "./conformance-DRR23YNy.mjs";
+import { t as BoardError } from "./client-BA-J7usH.mjs";
+import { a as detectAgent, c as projectUrl, i as connect, n as boardUrl, r as configDir, s as projectDir, t as http } from "./backend-http-CMlL3yq3.mjs";
+import { t as board } from "./server-DPxBSogx.mjs";
+import { t as conformance } from "./conformance-CT5EeHeC.mjs";
 import { t as displayText } from "./bots-CGkO76qH.mjs";
 import { execFileSync, spawn } from "node:child_process";
 import { createHash, randomBytes, timingSafeEqual } from "node:crypto";
@@ -806,6 +805,19 @@ function formatEvent(event) {
 	}
 }
 /**
+* Where a thread is synced, for `vb sync <id>`: a row a target, its sync key and where it is, then
+* the link to the message's copy there, or why it didn't reach it.
+*/
+function formatSynced(targets) {
+	const where = (row) => row.target.slice(row.key.length + 1);
+	const keys = Math.max(...targets.map((row) => row.key.length));
+	const wheres = Math.max(...targets.map((row) => where(row).length));
+	return targets.map((row) => {
+		const copy = row.undelivered !== null ? `didn't reach it: ${row.undelivered}` : row.url ?? (row.message !== null ? `message ${row.message}` : "no copy yet");
+		return `${row.key.padEnd(keys)}  ${where(row).padEnd(wheres)}  ${terminalText(copy)}`;
+	}).join("\n");
+}
+/**
 * A channel or thread read with `vb sources <key> read`: a header, then each message under its ID,
 * with the target that reads its thread when it has replies.
 */
@@ -1284,6 +1296,7 @@ usage: board <command> [options]      (also installed as \`vb\`)
   read [channel] [filters] [--limit N]     the latest threads, one each: root, replies, latest reply
                                            (no channel: every channel)
   read <id>                                one thread, every message (filters: the root and the replies that match)
+  read <link>                              the thread a Slack or GitHub link names, if the board synced it
 
   post <channel|id> ["<text>"] [--label k=v]... [--attach <file>]... [--sync <target>]... [--no-sync] [--id <key>]
                                            a new thread in a channel, or with an id, a reply in its thread
@@ -1300,6 +1313,7 @@ usage: board <command> [options]      (also installed as \`vb\`)
   label <id> k=v... [--unset k]...
   typing <id> [status]                     show typing in the thread's synced platform threads (marks WhatsApp read);
                                            Slack shows the status, if given, instead of "Typing…"
+  sync <id>                                where the thread is synced, with this message's link on each
   sync <id> <target>                       attach the thread to e.g. slack:#incidents, backfilling it
   inbox <key> [channel] [--limit N]        raw platform events, for debugging sync
   sources                                  the board's sources (its sync entries: slack, github, …)
@@ -1842,8 +1856,9 @@ async function run(command, args) {
 		case "read": {
 			const target = args[0];
 			const board = client();
-			if (target && isMessageRef(target)) {
-				const thread = await board.thread(messageId(target));
+			const link = target !== void 0 && /^https?:\/\//i.test(target);
+			if (target && (link || isMessageRef(target))) {
+				const thread = link ? await board.linked(target) : await board.thread(messageId(target));
 				const narrowed = Object.keys(filters()).length > 0;
 				const replies = narrowed ? (await board.messages({
 					...filters(),
@@ -2099,7 +2114,12 @@ async function run(command, args) {
 		}
 		case "sync": {
 			const id = messageId(args[0]);
-			if (!args[1]) throw new UsageError("usage: board sync <id> <target>   (e.g. slack:#incidents)");
+			if (!args[1]) {
+				const { targets } = await client().sync(id);
+				if (flags.json) return targets.forEach(printJson), 0;
+				out(targets.length ? formatSynced(targets) : "not synced anywhere");
+				return 0;
+			}
 			const result = await client().sync(id, args[1]);
 			if (flags.json) printJson(result);
 			else out(result.attached ? `synced with ${result.target}` : `already synced with ${result.target}`);
@@ -2175,7 +2195,7 @@ async function run(command, args) {
 			if (args.length > 0) throw new UsageError("usage: board serve [--port N] [--dir <dir>] [--no-inspect] [--no-open]");
 			const port = portFlag();
 			const root = projectDir();
-			const { localHandle, serveLocal } = await import("./serve-BsOOc-6_.mjs");
+			const { localHandle, serveLocal } = await import("./serve-BGYw0uNL.mjs");
 			const handle = flags.handle ?? process.env.BOARD_HANDLE;
 			const local = await serveLocal({
 				dir: flags.dir ?? join(root, ".board"),

package/dist/{client-DGDPaN7U.mjs → client-BA-J7usH.mjs}

@@ -260,8 +260,16 @@ function createBoardClient(options) {
 		* `status` replaces "Typing…" on Slack ("running tests…").
 		*/
 		typing: async (id, status) => (await call("POST", `/messages/${path(id)}/typing`, { body: status ? { status } : {} })).targets,
-		/** Attaches the message's thread to an external target, backfilling it. Attaching twice is a no-op. */
-		sync: (id, target) => call("POST", `/messages/${path(id)}/sync`, { body: { target } }),
+		/**
+		* With a target, attaches the message's thread to it, backfilling it: attaching twice is a no-op.
+		* Without one, where the thread is synced, and this message's copy on each target, with its link.
+		*/
+		sync: ((id, target) => target === void 0 ? call("GET", `/messages/${path(id)}/sync`) : call("POST", `/messages/${path(id)}/sync`, { body: { target } })),
+		/**
+		* The thread of the board message a platform link names (a Slack permalink, a GitHub comment's
+		* URL), from what the board synced: the platform is never asked. 404 for one it didn't sync.
+		*/
+		linked: (url) => call("GET", `/links${queryString({ url })}`),
 		/** Raw platform events for a sync entry, newest first. */
 		inbox: async (key, opts = {}) => (await call("GET", `/inbox/${key}${queryString(opts)}`)).events,
 		/** Registers the caller's watchers, replacing its last registration: what a board on `http()` does. */

package/dist/{conformance-DRR23YNy.mjs → conformance-CT5EeHeC.mjs}

@@ -1,4 +1,4 @@
-import { t as BoardError } from "./client-DGDPaN7U.mjs";
+import { t as BoardError } from "./client-BA-J7usH.mjs";
 //#region src/conformance/index.ts
 var Mismatch = class extends Error {};
 const show = (value) => JSON.stringify(value) ?? String(value);
@@ -298,7 +298,7 @@ const CHECKS = [
 	},
 	{
 		group: "sync",
-		name: "keeps sync's records: an import as a platform author, its lookups by platform ID, and a receipt",
+		name: "keeps sync's records: an import as a platform author, its lookups by platform ID, a receipt, and where it's synced",
 		run: async (ctx) => {
 			const key = "conformance";
 			const thread = `${key}:${ctx.labels.conformance}:1`;
@@ -411,6 +411,9 @@ const CHECKS = [
 					external
 				});
 				same(JSON.stringify((await ctx.board.syncCopies([id]))[id]?.[external.thread]), JSON.stringify(external), "the copy its receipt recorded");
+				const { targets } = await ctx.board.sync(id);
+				check(targets.some((row) => row.target === external.thread && row.message === external.message), `where the thread is synced should show the copy its receipt recorded, got ${show(targets)}`);
+				await rejects(ctx.board.linked(`https://conformance.invalid/${ctx.labels.conformance}`), 404, "message_not_found", "a link no sync here knows");
 			} finally {
 				await ctx.board.syncImport({
 					op: "delete",

package/dist/conformance.d.mts

@@ -1,4 +1,4 @@
-import { m as Board } from "./a2-D24cvwpN.mjs";
+import { d as Board } from "./backend-B-SJ7p6p.mjs";
 //#region src/conformance/index.d.ts
 /**
  * Checks that a board speaks the protocol, through a handle on it (`conformance(board())`), as

package/dist/conformance.mjs

@@ -1,2 +1,2 @@
-import { t as conformance } from "./conformance-DRR23YNy.mjs";
+import { t as conformance } from "./conformance-CT5EeHeC.mjs";
 export { conformance };