@vercel/board 0.16.0 → 0.17.0

package/docs/04-reference/02-board.md

@@ -240,12 +240,25 @@ This handle's own post with `id`, as posting it answered, or a 404
 ### sync
 
 ```ts
+sync(id: string): Promise<SyncedView>
 sync(id: string, target: string): Promise<{ target: string; attached: boolean }>
+linked(url: string): Promise<ThreadView>
 ```
 
-Attaches the message's thread to an external target and backfills it.
-`target` is the normalized target; `attached` is false when the thread was
-already synced there. See [Sync](../02-sync/01-overview.md).
+With a target, `sync` attaches the message's thread to an external target and
+backfills it. `target` is the normalized target; `attached` is false when the
+thread was already synced there.
+
+With no target, it says where the thread is synced: `{ targets }`, each
+`{ target, key, thread, message, url, undelivered }`, with this message's copy
+there by the platform's ID and the platform's link to it. It needs `read` where
+the message is.
+
+`linked(url)` is the thread a platform link names (a Slack permalink, a GitHub
+PR, issue, or comment), as `thread(id)` answers it. The board looks it up in
+what its sync recorded and never asks the platform: a link it didn't sync, or
+to a message you can't read, is 404 `message_not_found`. See
+[Sync](../02-sync/01-overview.md).
 
 ### typing
 
@@ -574,6 +587,6 @@ export async function POST(request: Request) {
   calls `http()`'s methods, which call that board, whose middleware sees its
   writes.
 
-Sync callbacks get a client of their own, acting as the platform user who
+Sync functions get a client of their own, acting as the platform user who
 triggered the event. See [Mounting](../01-board/01-mounting.md),
-[Watchers](../01-board/06-watchers.md), and [Callbacks](../02-sync/02-callbacks.md).
+[Watchers](../01-board/06-watchers.md), and [Sync functions](../02-sync/02-functions.md).

package/docs/04-reference/03-http.md

@@ -109,6 +109,8 @@ a refused write it can read answers 403. `GET /me` returns the caller's
 | POST | `/messages/:id/reactions` | `{ emoji, remove? }`. `emoji` is a short name: `eyes`, `thumbs_up` |
 | POST | `/messages/:id/labels` | `{ set?, unset? }`, at least one |
 | POST | `/messages/:id/sync` | `{ target }`: attach the thread to an external target and backfill it. Answers `{ target, attached }` |
+| GET | `/messages/:id/sync` | Where the thread is synced: `{ targets }`, each `{ target, key, thread, message, url, undelivered }`, with this message's copy there and the platform's link to it. Needs `read` where it is |
+| GET | `/links` | The thread a platform link names, as `GET /messages/:id` answers it. Query: `url`. From sync's records alone; a link the board didn't sync, or to a message the caller can't read, is 404 `message_not_found` |
 | POST | `/messages/:id/typing` | `{ status? }`: show typing in the thread's synced platform threads. Answers `{ targets }`. Writes nothing to the log |
 | POST | `/attachments` | Upload one file. Answers 201 `{ attachment: { id, name, type, size } }`. See [Attachments](#attachments) |
 | GET | `/attachments/:id` | The file |
@@ -139,8 +141,9 @@ Every board that keeps its own log answers every route here. The sync routes
 a person calls (`/webhooks/:key`, `/messages/:id/sync`, `/identity/sign-in`,
 `/identity/signed-in`, and `/identity/unlink`) are `board()`'s, and work on any
 backend: the ones that need a sync entry answer 404 on a board that doesn't
-run it. `/sources/:key/read` and `/messages/:id/typing` are the backend's
-methods, which `a2()` answers through the sync `board()` runs beside it. A
+run it. `/sources/:key/read`, `/messages/:id/typing`, `GET /messages/:id/sync`,
+and `/links` are the backend's methods, which `a2()` answers through the sync
+`board()` runs beside it. A
 board on `http()` answers only wake-ups, webhooks, and its sync's sign-ins,
 unless it has an `access` of its own: then it serves its callers as its
 project on the board it uses (see [A board on `http()`](../01-board/09-access.md#a-board-on-http)). There are no

package/docs/04-reference/05-conformance.md

@@ -56,7 +56,7 @@ Then the rest, a group each in the report:
 | `schedules` | schedules a reply a day out, lists it, and cancels it |
 | `attachments` | uploads a file, posts it, and downloads it |
 | `watchers` | registers a tail, pulls the match for a post, and acks it. Skipped when the token already has watchers or a sync registered there, since registering replaces them |
-| `sync` | imports a message as a platform user of its own (`conformance:user:<id>`), finds it by its platform IDs, imports it again to the same message, refuses a second root from the same platform thread, records a receipt and reads the copy back, and deletes it. Skipped when the token can't register a sync or `sync` in the channel, or already has watchers or a sync registered |
+| `sync` | imports a message as a platform user of its own (`conformance:user:<id>`), finds it by its platform IDs, imports it again to the same message, refuses a second root from the same platform thread, records a receipt and reads the copy back, lists where the thread is synced with it, answers 404 for a link no sync there knows, and deletes it. Skipped when the token can't register a sync or `sync` in the channel, or already has watchers or a sync registered |
 
 Every board answers all of them: see
 [the whole protocol](./03-http.md#the-whole-protocol). A board may keep no

package/docs/index.md

@@ -51,8 +51,8 @@ import { board } from '@vercel/board'
 import { a2 } from '@vercel/board/backend-a2'
 import { vercelQueues } from '@vercel/board/backend-a2/scheduler-vercel'
 import { postgres } from '@vercel/board/backend-a2/store-postgres'
-import { slack } from '@vercel/board/sync-slack'
-import { github } from '@vercel/board/sync-github'
+import { channels, slack } from '@vercel/board/sync-slack'
+import { github, repos } from '@vercel/board/sync-github'
 
 const backend = a2({
   store: postgres({ connectionString: process.env.DATABASE_URL! }),
@@ -62,14 +62,9 @@ const backend = a2({
 const team = board({
   backend,
   sync: {
-    slack: slack({
-      adapter: 'slack/acme', // a Vercel Connect connector
-      channels: { '#errors-www': 'errors-www', '#prs': 'prs' },
-    }),
-    github: github({
-      adapter: 'github/acme',
-      repos: { 'acme/www': 'prs' },
-    }),
+    // A Vercel Connect connector, and what each event does.
+    slack: slack('slack/acme', channels({ '#errors-www': 'errors-www', '#prs': 'prs' })),
+    github: github('github/acme', repos({ 'acme/www': 'prs' })),
   },
 })
 export const GET = team.fetch, POST = team.fetch

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/board",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "A message board you mount in one route: one durable log, verified authors, live tail, and two-way sync.",
   "license": "MIT",
   "type": "module",
@@ -103,24 +103,25 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@chat-adapter/github": "^4.41.1",
-    "@chat-adapter/slack": "^4.41.1",
-    "@vercel/connect": "^2.3.4",
     "@vercel/oidc": "^3.8.9",
-    "chat": "^4.41.1",
-    "experimental-a2": "0.22.0",
     "jose": "^6.2.12",
     "zod": "^4.6.5"
   },
   "peerDependencies": {
+    "@chat-adapter/github": "^4.41.1",
+    "@chat-adapter/slack": "^4.41.1",
     "@upstash/qstash": "^2.11.0",
     "@vercel/blob": "^2.8.0",
+    "@vercel/connect": "^2.3.4",
     "@vercel/queue": "*",
+    "chat": "^4.41.1",
     "ioredis": "^5.4.0",
     "pg": "^8.11.0"
   },
   "devDependencies": {
     "@base-ui/react": "^1.8.0",
+    "@chat-adapter/github": "^4.41.1",
+    "@chat-adapter/slack": "^4.41.1",
     "@chat-adapter/tests": "^4.41.1",
     "@electric-sql/pglite": "0.3.15",
     "@kapso/chat-adapter": "^0.1.1",
@@ -129,7 +130,10 @@
     "@types/react": "^19.3.0",
     "@types/react-dom": "^19.3.0",
     "@vercel/blob": "^2.8.0",
+    "@vercel/connect": "^2.3.4",
     "ai": "^7.0.130",
+    "chat": "^4.41.1",
+    "experimental-a2": "0.22.0",
     "ioredis": "5.11.1",
     "lucide-react": "^1.49.0",
     "pg": "^8.16.3",
@@ -143,15 +147,27 @@
     "vitest": "^5.0.3"
   },
   "peerDependenciesMeta": {
+    "@chat-adapter/github": {
+      "optional": true
+    },
+    "@chat-adapter/slack": {
+      "optional": true
+    },
     "@upstash/qstash": {
       "optional": true
     },
     "@vercel/blob": {
       "optional": true
     },
+    "@vercel/connect": {
+      "optional": true
+    },
     "@vercel/queue": {
       "optional": true
     },
+    "chat": {
+      "optional": true
+    },
     "ioredis": {
       "optional": true
     },