@vercel/board 0.25.1 → 0.26.1

package/docs/04-reference/01-cli.md

@@ -47,6 +47,12 @@ const code = await createApp({
   onError: (failure, { json }) => console.error(json ? JSON.stringify(failure) : failureLines(failure).join('\n')),
   // { reason, message }: a write that went through, with something to say. With --json, it's in the result.
   onWarning: (warning) => console.error(warning.message),
+  // Your Vercel login, and the team whose board to use when --scope names none, as this CLI
+  // resolves its own: asked for only when a request needs them. Help, a typo, or misuse never asks.
+  // A login that throws fails the request: board never falls back to `vercel login`'s. A team
+  // that throws fails it too, with what it threw as the failure's details.
+  login: async () => process.env.VERCEL_AUTH_TOKEN!,
+  team: async () => process.env.VERCEL_ORG_ID ?? null,
 }).run(process.argv.slice(3))
 ```
 
@@ -485,7 +491,7 @@ schedules that reply in that thread. `--all` adds done and canceled ones.
 ### post
 
 ```text
-vb post <channel|id> ["<text>"] [--label k=v]... [--attach <file>]... [--sync <target>]... [--no-sync] [--id <key>]
+vb post <channel|id> ["<text>"] [--label k=v]... [--attach <file>]... [--sync <target>]... [--no-sync] [--idempotency-key <key>]
 ```
 
 Starts a thread. The channel is created by its first post. Given a message ID
@@ -499,7 +505,7 @@ for new threads only.
 | `--attach <file>` | uploads a file (at most 4 MB, or 100 MB on a board whose blob store takes direct uploads; 10 per message) and attaches it. Every file is checked before any uploads. A board that keeps no files refuses: ``error: this board keeps no files: pass `blob` to `a2()` `` |
 | `--sync <target>` | also starts or joins a thread there: `slack:#incidents`, `github:owner/repo:12`; new threads only |
 | `--no-sync` | keeps the message on the board: it reaches none of the channel's mirrored channels |
-| `--id <key>` | an idempotency key: the same key never posts twice |
+| `--idempotency-key <key>` | the same key never posts twice, so a retried step posts once |
 
 `--sync` and `--no-sync` together are a usage error. See
 [Messages](../01-board/04-messages.md) and
@@ -508,7 +514,7 @@ for new threads only.
 ### reply
 
 ```text
-vb reply <id> ["<text>"] [--attach <file>]... [--no-sync] [--id <key>]
+vb reply <id> ["<text>"] [--attach <file>]... [--no-sync] [--idempotency-key <key>]
 ```
 
 Replies in a thread. `<id>` may be any message in it: the board stores the
@@ -739,7 +745,7 @@ of them must match.
 | `--by <handle>` | messages by an actor, by handle or exact actor ID. A person's handle covers their agents (`julian/claude`) and linked accounts |
 | `--mentions` | messages that mention you |
 | `--mentions @handle` | messages that mention that actor |
-| `--from <source>` | where a message came from: a sync key (`slack`, `github`), or `board` for messages written on the board |
+| `--source <source>` | where a message came from: a sync key (`slack`, `github`), or `board` for messages written on the board |
 | `--label <key>` | messages with the label, any value |
 | `--label <key>=<value>` | that value; `state=open\|draft` means either |
 | `--text <words>` | a case-insensitive substring of the text (1 to 200 characters), not search |

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

@@ -122,7 +122,7 @@ a refused write it can read answers 403. `GET /me` returns the caller's
 | GET | `/watchers` | `{ watchers }`: the caller's registration, or every one for `manage` in every channel |
 | GET | `/watchers/matches` | `{ matches }`: the caller's matches it can run now, one thread at a time and in order, each `{ id, watcher, thread, lease, attempt, event }` and leased to it for 5 minutes. Query: `limit` (10 by default, at most 50), `wait` (seconds to hold for one, at most 25). 404 `no_registration` without a registration |
 | POST | `/watchers/matches/:id/ack` | `{ lease, error?, skip? }`: done, an error to try again after a wait (after 5 tries it's `watch.failed`), or `skip` to drop it. 404 `no_match`, 409 `stale_lease` for a lease that ran out |
-| POST | `/wake` | On a board on `http()` (no token): it has matches to pull. Answers `{ ran }` |
+| POST | `/wake` | On a board on `http()` (no token): it has matches to pull. Answers `{ ran }` once they've run, or 202 after 2 seconds while they keep running |
 | GET | `/inbox/:key` | `{ events }`: raw platform events for a sync entry, newest first. Query: `channel`, `limit` (50 by default, at most 500). With `sync` in every channel, the board's own and every registered sync's; a sync elsewhere sees what it pushed |
 | GET | `/sources/:key/read` | Read a platform channel, thread, or permalink without syncing it. Query: `target`, `limit` (50 by default, at most 200). The board reads it with entry `key`'s app, through the sync it runs, and needs `manage` in every channel; a board that runs no entry `key` answers 404 `not_synced_here` |
 | POST | `/sources/:key/join` | Add entry `key`'s app to a public channel so `/sources/:key/read` can read it. Body: `{ target }`, a channel (`#name`, an ID) or a link into it. Answers `{ channel, name, joined }`, `joined: false` when the app was already in. Only where the entry opted in (`slack({ join: true })`), 403 `join_disabled` otherwise; private and Slack Connect channels are never joined. Needs `manage` in every channel; a board that runs no entry `key` answers 404 `not_synced_here` |

package/docs/index.md

@@ -110,7 +110,7 @@ const team = board({
   // sync as above
   watch: {
     triage: {
-      tail: 'errors-www --from slack',
+      tail: 'errors-www --source slack',
       run: async ({ event, board }) => {
         if (event.type !== 'message.posted' || event.message?.re !== null) return
         // the reply reaches the Slack thread too:
@@ -124,7 +124,7 @@ export const { scheduler } = backend
 ```
 
 A watcher is a `vb tail` the board runs for you. Try the expression in a
-terminal first (`vb tail errors-www --from slack --json`); `run` gets exactly
+terminal first (`vb tail errors-www --source slack --json`); `run` gets exactly
 those events, durably, with retries and nothing kept open. See
 [Watchers](./01-board/06-watchers.md).
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/board",
-  "version": "0.25.1",
+  "version": "0.26.1",
   "description": "A message board you mount in one route: one durable log, verified authors, live tail, and two-way sync.",
   "license": "MIT",
   "type": "module",