@vercel/board 0.18.1 → 0.20.0

package/dist/{middleware-CqaCwucP.mjs → middleware-DUjyQP_a.mjs}

@@ -1,5 +1,5 @@
 import { m as MESSAGE_TEXT_MAX, p as Labels } from "./schemas-Be08nyfW.mjs";
-import { t as HttpError } from "./errors-DX3hpwWt.mjs";
+import { t as HttpError } from "./errors-CQ-fwxM3.mjs";
 import { z } from "zod";
 //#region src/server/middleware.ts
 /** A write the middleware didn't let through: the API answers 422 with what it responded. */

package/dist/{provider-B0b9Qxw4.d.mts → provider-D11Dfda0.d.mts}

@@ -115,9 +115,27 @@ declare const InboxQuery: z.ZodObject<{
 }, z.core.$strip>;
 /** How many watchers one registration holds: the board matches every event against every tail. */
 declare const REGISTERED_WATCHERS_MAX = 32;
-/** What a board on `http()` registers with the board it uses: its watchers' tails, and where to wake it. */
-declare const RegisterBody: z.ZodObject<{
+/**
+ * What a board on `http()` registers with the board it uses: its watchers, and where to wake it,
+ * at a URL or at a path on its own project, never both.
+ */
+declare const RegisterBody: z.ZodUnion<readonly [z.ZodObject<{
+  watch: z.ZodRecord<z.ZodString, z.ZodObject<{
+    tail: z.ZodString;
+    when: z.ZodDefault<z.ZodEnum<{
+      enters: "enters";
+      matches: "matches";
+    }>>;
+  }, z.core.$strip>>;
+  sync: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    key: z.ZodString;
+    platform: z.ZodString;
+    signIn: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strip>>>;
   url: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>>;
+  path: z.ZodOptional<z.ZodNull>;
+  branch: z.ZodOptional<z.ZodNull>;
+}, z.core.$strip>, z.ZodObject<{
   watch: z.ZodRecord<z.ZodString, z.ZodObject<{
     tail: z.ZodString;
     when: z.ZodDefault<z.ZodEnum<{
@@ -130,7 +148,12 @@ declare const RegisterBody: z.ZodObject<{
     platform: z.ZodString;
     signIn: z.ZodDefault<z.ZodBoolean>;
   }, z.core.$strip>>>;
-}, z.core.$strip>;
+  url: z.ZodOptional<z.ZodNull>;
+  path: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+  branch: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>]>;
+/** A registration as a board on `http()` sends it: `{ url?, watch, sync? }` or `{ path, branch?, watch, sync? }`. */
+type RegisterInput = z.input<typeof RegisterBody>;
 /** A pull of the caller's matches: at most `limit`, waiting up to `wait` seconds for one. */
 declare const MatchesQuery: z.ZodObject<{
   limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
@@ -150,6 +173,10 @@ declare const SourceReadQuery: z.ZodObject<{
   target: z.ZodString;
   limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
 }, z.core.$strip>;
+/** A channel to add the board's app to, so it can be read on demand: `#name`, an ID, or a link into it. */
+declare const SourceJoinBody: z.ZodObject<{
+  target: z.ZodString;
+}, z.core.$strip>;
 /** A platform's link to a message or thread, such as a Slack permalink or a GitHub comment's URL. */
 declare const LinkedQuery: z.ZodObject<{
   url: z.ZodString;
@@ -680,13 +707,19 @@ type Discovery = {
     key: string;
     platform: string;
   }[];
+  /**
+   * Whether `POST /watchers` takes a `path`: the board wakes the caller's own Vercel project there,
+   * through its Deployment Protection. A board that can't find a project's deployments leaves it out.
+   */
+  wake_by_path?: boolean;
 };
-/** Watchers a board on `http()` registered here: one registration per principal. */
+/**
+ * Watchers a board on `http()` registered here: one registration per principal, woken at a URL
+ * or at a path on its own project, never both.
+ */
 type RegistrationView = {
   /** The principal that registered. Its watchers write as it, with their IDs as profiles. */
   owner: string;
-  /** Where it's woken: `<url>/wake`. `null` when it pulls on its own. */
-  url: string | null;
   watch: Record<string, {
     tail: string;
     when: 'matches' | 'enters';
@@ -699,7 +732,18 @@ type RegistrationView = {
   }[];
   /** Every wake-up carries it, so the board can tell its registration is stale. */
   hash: string;
-};
+} & ({
+  /** Where it's woken: `<url>/wake`. `null` when it pulls on its own. */
+  url: string | null;
+  path?: undefined;
+  branch?: undefined;
+} | {
+  url: null;
+  /** Where it's woken on its own Vercel project, on a board with `wake_by_path`. */
+  path: string;
+  /** The branch whose latest ready preview a preview's `path` wakes. */
+  branch?: string;
+});
 /** One match, leased to the registrant that pulled it. */
 type MatchView = {
   /** The match's ID, which its watcher's writes derive their IDs from. */
@@ -869,6 +913,12 @@ type SourceRead = {
   /** The platform has more than `limit`: older messages in a channel, later replies in a thread. */
   more: boolean;
 };
+/** A channel the board's app joined, or was already in (`joined: false`). */
+type SourceJoin = {
+  channel: string;
+  name: string | null;
+  joined: boolean;
+};
 type ApiError = {
   error: {
     code: string;
@@ -1486,6 +1536,14 @@ declare const routes: {
       limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
     }, z.core.$strip>;
   };
+  /** Adds the app to a public channel so it can be read, where that sync runs and opted in with `join`. Full access only. */
+  readonly joinSource: {
+    readonly method: 'POST';
+    readonly path: '/sources/:key/join';
+    readonly body: z.ZodObject<{
+      target: z.ZodString;
+    }, z.core.$strip>;
+  };
   readonly webhook: {
     readonly method: 'POST';
     readonly path: '/webhooks/:key';
@@ -1577,8 +1635,23 @@ declare const routes: {
   readonly register: {
     readonly method: 'POST';
     readonly path: '/watchers';
-    readonly body: z.ZodObject<{
+    readonly body: z.ZodUnion<readonly [z.ZodObject<{
+      watch: z.ZodRecord<z.ZodString, z.ZodObject<{
+        tail: z.ZodString;
+        when: z.ZodDefault<z.ZodEnum<{
+          enters: "enters";
+          matches: "matches";
+        }>>;
+      }, z.core.$strip>>;
+      sync: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        platform: z.ZodString;
+        signIn: z.ZodDefault<z.ZodBoolean>;
+      }, z.core.$strip>>>;
       url: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>>;
+      path: z.ZodOptional<z.ZodNull>;
+      branch: z.ZodOptional<z.ZodNull>;
+    }, z.core.$strip>, z.ZodObject<{
       watch: z.ZodRecord<z.ZodString, z.ZodObject<{
         tail: z.ZodString;
         when: z.ZodDefault<z.ZodEnum<{
@@ -1591,7 +1664,10 @@ declare const routes: {
         platform: z.ZodString;
         signIn: z.ZodDefault<z.ZodBoolean>;
       }, z.core.$strip>>>;
-    }, z.core.$strip>;
+      url: z.ZodOptional<z.ZodNull>;
+      path: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+      branch: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>]>;
   };
   /** The caller's matches it can run now, each leased to it until it acks. */
   readonly matches: {
@@ -1814,18 +1890,7 @@ declare function createBoardClient(options: ClientOptions): {
     limit?: number;
   }) => Promise<InboxEntry[]>;
   /** Registers the caller's watchers, replacing its last registration: what a board on `http()` does. */
-  register: (input: {
-    url?: string | null;
-    watch: Record<string, {
-      tail: string;
-      when?: 'matches' | 'enters';
-    }>;
-    sync?: {
-      key: string;
-      platform: string;
-      signIn?: boolean;
-    }[];
-  }) => Promise<RegistrationView>;
+  register: (input: RegisterInput) => Promise<RegistrationView>;
   /** Registered watchers: every one to `manage` everywhere, the caller's own to anyone else. */
   watchers: () => Promise<RegistrationView[]>;
   /** The caller's matches it can run now, each leased to it until it acks. `wait` holds the request up to that many seconds for one. */
@@ -1849,6 +1914,8 @@ declare function createBoardClient(options: ClientOptions): {
   readSource: (key: string, target: string, opts?: {
     limit?: number;
   }) => Promise<SourceRead>;
+  /** Adds the app to a public channel so `readSource` can read it, where the sync opted in with `join`. Full access only. */
+  joinSource: (key: string, target: string) => Promise<SourceJoin>;
   poll: (query?: Filters & {
     after?: string;
     wait?: number;
@@ -2580,6 +2647,8 @@ declare abstract class SyncProvider<E extends ProviderEvent = ProviderEvent> {
   read(_target: string, _options: {
     limit: number;
   }): Promise<SourceRead>;
+  /** Adds the board's app to a channel so `read` can read it, where the board opted in. Throws `UnreadableError` otherwise. */
+  join(_target: string): Promise<SourceJoin>;
   edit(_thread: string, _message: string, _body: ProviderPost): Promise<void>;
   delete(_thread: string, _message: string): Promise<void>;
   react(_thread: string, _message: string, _emoji: string, _added: boolean): Promise<void>;
@@ -2600,4 +2669,4 @@ declare abstract class SyncProvider<E extends ProviderEvent = ProviderEvent> {
   render(input: RenderInput): string;
 }
 //#endregion
-export { Discovery as $, SyncFindInput as $t, SyncOverrides as A, Ref as At, ReplyOptions as B, SchedulesQueryInput as Bt, channels as C, MessagesQueryInput as Ct, EventBase as D, PostInput as Dt, render as E, PostBody as Et, BoardClient as F, ScheduleBody as Ft, Written as G, SourceReadQuery as Gt, ScheduleTiming as H, SignInQuery as Ht, BoardError as I, ScheduleBodyOutput as It, ActorView as J, SyncBody as Jt, duration as K, SyncAccountBody as Kt, Filters as L, ScheduleInput as Lt, SyncRoot as M, RegistrationView as Mt, envelope as N, ResolvedSyncTarget as Nt, ProviderEvent as O, REGISTERED_WATCHERS_MAX as Ot, eventSchema as P, RouteName as Pt, DeleteBody as Q, SyncCopiesView as Qt, PostOptions as R, ScheduleView as Rt, SyncUnit as S, MessagesQuery as St, mirror as T, PersonView as Tt, UploadInput as U, SourceMessage as Ut, ScheduleOptions as V, SchedulesQueryOutput as Vt, WaitOptions as W, SourceRead as Wt, BoardEventView as X, SyncCodeView as Xt, ApiError as Y, SyncCodeBody as Yt, ChannelView as Z, SyncCopiesQuery as Zt, withUserTokens as _, UploadStartBody as _n, MatchView as _t, ProviderOptions as a, SyncReceiptInput as an, IdentityUnlinkBody as at, SyncIn as b, MessageView as bt, ReceivedEvent as c, SyncUnlinkBody as cn, InboxEntry as ct, ResolvedTarget as d, ThreadView as dn, InboxPushBody as dt, SyncFindQuery as en, EditBody as et, SyncContext as f, ThreadsPage as fn, InboxQuery as ft, connectUserTokens as g, TypingResult as gn, LinkedQuery as gt, UserTokens as h, TypingBody as hn, LinkedAccount as ht, ProviderFile as i, SyncReceiptBody as in, FiltersInput as it, SyncResult as j, RegisterBody as jt, RootOverride as k, ReactBody as kt, RenderInput as l, SyncedView as ln, InboxItem as lt, UnreadableError as m, ThreadsQueryInput as mn, LinkView as mt, FileDelivery as n, SyncImportBody as nn, EventsQuery as nt, ProviderPost as o, SyncRootsQuery as on, IdentityView as ot, SyncProvider as p, ThreadsQuery as pn, LabelBody as pt, AckBody as q, SyncAccountInput as qt, ProviderDelivery as r, SyncImportInput as rn, EventsQueryInput as rt, Receive as s, SyncThreadView as sn, InboxAckBody as st, FetchedLink as t, SyncFindView as tn, EventsPage as tt, Renderer as u, ThreadSummaryView as un, InboxNextQuery as ut, Sync as v, UploadTicket as vn, MatchesQuery as vt, into as w, ParsedFilters as wt, SyncOut as x, MessagesPage as xt, SyncFn as y, routes as yn, Me as yt, ProfileOption as z, SchedulesQuery as zt };
+export { Discovery as $, SyncCodeView as $t, SyncOverrides as A, Ref as At, ReplyOptions as B, SchedulesQuery as Bt, channels as C, MessagesQueryInput as Ct, EventBase as D, PostInput as Dt, render as E, PostBody as Et, BoardClient as F, RouteName as Ft, Written as G, SourceJoinBody as Gt, ScheduleTiming as H, SchedulesQueryOutput as Ht, BoardError as I, ScheduleBody as It, ActorView as J, SourceReadQuery as Jt, duration as K, SourceMessage as Kt, Filters as L, ScheduleBodyOutput as Lt, SyncRoot as M, RegisterInput as Mt, envelope as N, RegistrationView as Nt, ProviderEvent as O, REGISTERED_WATCHERS_MAX as Ot, eventSchema as P, ResolvedSyncTarget as Pt, DeleteBody as Q, SyncCodeBody as Qt, PostOptions as R, ScheduleInput as Rt, SyncUnit as S, routes as Sn, MessagesQuery as St, mirror as T, PersonView as Tt, UploadInput as U, SignInQuery as Ut, ScheduleOptions as V, SchedulesQueryInput as Vt, WaitOptions as W, SourceJoin as Wt, BoardEventView as X, SyncAccountInput as Xt, ApiError as Y, SyncAccountBody as Yt, ChannelView as Z, SyncBody as Zt, withUserTokens as _, ThreadsQueryInput as _n, MatchView as _t, ProviderOptions as a, SyncImportBody as an, IdentityUnlinkBody as at, SyncIn as b, UploadStartBody as bn, MessageView as bt, ReceivedEvent as c, SyncReceiptInput as cn, InboxEntry as ct, ResolvedTarget as d, SyncUnlinkBody as dn, InboxPushBody as dt, SyncCopiesQuery as en, EditBody as et, SyncContext as f, SyncedView as fn, InboxQuery as ft, connectUserTokens as g, ThreadsQuery as gn, LinkedQuery as gt, UserTokens as h, ThreadsPage as hn, LinkedAccount as ht, ProviderFile as i, SyncFindView as in, FiltersInput as it, SyncResult as j, RegisterBody as jt, RootOverride as k, ReactBody as kt, RenderInput as l, SyncRootsQuery as ln, InboxItem as lt, UnreadableError as m, ThreadView as mn, LinkView as mt, FileDelivery as n, SyncFindInput as nn, EventsQuery as nt, ProviderPost as o, SyncImportInput as on, IdentityView as ot, SyncProvider as p, ThreadSummaryView as pn, LabelBody as pt, AckBody as q, SourceRead as qt, ProviderDelivery as r, SyncFindQuery as rn, EventsQueryInput as rt, Receive as s, SyncReceiptBody as sn, InboxAckBody as st, FetchedLink as t, SyncCopiesView as tn, EventsPage as tt, Renderer as u, SyncThreadView as un, InboxNextQuery as ut, Sync as v, TypingBody as vn, MatchesQuery as vt, into as w, ParsedFilters as wt, SyncOut as x, UploadTicket as xn, MessagesPage as xt, SyncFn as y, TypingResult as yn, Me as yt, ProfileOption as z, ScheduleView as zt };

package/dist/{provider-B3DpYSDq.mjs → provider-poIkXapd.mjs}

@@ -188,6 +188,10 @@ var SyncProvider = class {
 	async read(_target, _options) {
 		throw new UnreadableError("unsupported", `${this.platform} can't be read on demand`);
 	}
+	/** Adds the board's app to a channel so `read` can read it, where the board opted in. Throws `UnreadableError` otherwise. */
+	async join(_target) {
+		throw new UnreadableError("unsupported", `${this.platform} can't join channels on demand`);
+	}
 	async edit(_thread, _message, _body) {}
 	async delete(_thread, _message) {}
 	async react(_thread, _message, _emoji, _added) {}

package/dist/{serve-Dpb7zMJ0.mjs → serve-AnApUWOR.mjs}

@@ -1,7 +1,7 @@
-import { o as localTokenFile } from "./backend-http-BjH8jMDi.mjs";
-import { t as board } from "./server-Bj1_ugXd.mjs";
-import { t as oidcTokens } from "./tokens-DhuzKzAl.mjs";
-import { n as fsBlob, t as a2 } from "./a2-CW8jHGD_.mjs";
+import { o as localTokenFile } from "./backend-http-c-VHpUOs.mjs";
+import { t as board } from "./server-BqVickb5.mjs";
+import { t as oidcTokens } from "./tokens-DUXaXwOj.mjs";
+import { n as fsBlob, t as a2 } from "./a2-D__qQpe7.mjs";
 import { t as localScheduler } from "./local-DhkrAqPP.mjs";
 import { mkdir, rm, writeFile } from "node:fs/promises";
 import { userInfo } from "node:os";

package/dist/{server-Bj1_ugXd.mjs → server-BqVickb5.mjs}

@@ -1,5 +1,5 @@
-import { t as createBoard } from "./exports-CwsfgCul.mjs";
-import { t as http } from "./backend-http-BjH8jMDi.mjs";
+import { t as createBoard } from "./exports-DqWJ7nzC.mjs";
+import { t as http } from "./backend-http-c-VHpUOs.mjs";
 //#region src/server/index.ts
 /**
 * The handle on a board. With a `backend`, the board lives there: `a2()` keeps it in this
@@ -9,8 +9,8 @@ import { t as http } from "./backend-http-BjH8jMDi.mjs";
 function board(options = {}) {
 	return createBoard(options, {
 		http: () => http(),
-		sync: () => import("./engine-D0oBUBEK.mjs"),
-		serving: () => import("./serving-CNkgUPW1.mjs")
+		sync: () => import("./engine-kHfSOXnQ.mjs"),
+		serving: () => import("./serving-B307gppu.mjs")
 	});
 }
 //#endregion

package/dist/{serving-CNkgUPW1.mjs → serving-B307gppu.mjs}

@@ -1,2 +1,2 @@
-import { i as ownTeamId, n as discoveryIdentity, r as ownProjectId, t as oidcTokens } from "./tokens-DhuzKzAl.mjs";
+import { i as ownTeamId, n as discoveryIdentity, r as ownProjectId, t as oidcTokens } from "./tokens-DUXaXwOj.mjs";
 export { discoveryIdentity, oidcTokens, ownProjectId, ownTeamId };

package/dist/sync-github.d.mts

@@ -1,5 +1,5 @@
-import { S as SyncUnit, _ as withUserTokens, d as ResolvedTarget, f as SyncContext, h as UserTokens, o as ProviderPost, r as ProviderDelivery, y as SyncFn } from "./provider-B0b9Qxw4.mjs";
-import { n as ChatSyncProvider } from "./chat-provider-DNJQyajS.mjs";
+import { S as SyncUnit, _ as withUserTokens, d as ResolvedTarget, f as SyncContext, h as UserTokens, o as ProviderPost, r as ProviderDelivery, y as SyncFn } from "./provider-D11Dfda0.mjs";
+import { n as ChatSyncProvider } from "./chat-provider-D0k3y8zY.mjs";
 import { z } from "zod";
 import { Adapter } from "chat";
 //#region src/sync/github.d.ts

package/dist/sync-github.mjs

@@ -1,7 +1,7 @@
-import { c as into, d as withRoutes } from "./provider-B3DpYSDq.mjs";
+import { c as into, d as withRoutes } from "./provider-poIkXapd.mjs";
 import { i as eventSchema, r as envelope } from "./events-CewD4kw7.mjs";
 import { r as withUserTokens, t as connectUserTokens } from "./users-yryHKFMo.mjs";
-import { r as markdownOf, t as ChatSyncProvider } from "./chat-provider-YHy-WbrB.mjs";
+import { r as markdownOf, t as ChatSyncProvider } from "./chat-provider-DnHibqnM.mjs";
 import { z } from "zod";
 import { connectGitHubAdapter } from "@vercel/connect/chat";
 import { createGitHubAdapter } from "@chat-adapter/github";

package/dist/sync-kapso.d.mts

@@ -1,5 +1,5 @@
-import { S as SyncUnit, f as SyncContext, y as SyncFn } from "./provider-B0b9Qxw4.mjs";
-import { n as ChatSyncProvider, t as ChatInput } from "./chat-provider-DNJQyajS.mjs";
+import { S as SyncUnit, f as SyncContext, y as SyncFn } from "./provider-D11Dfda0.mjs";
+import { n as ChatSyncProvider, t as ChatInput } from "./chat-provider-D0k3y8zY.mjs";
 import { z } from "zod";
 import { Adapter } from "chat";
 //#region src/sync/kapso.d.ts

package/dist/sync-kapso.mjs

@@ -1,6 +1,6 @@
-import { s as channels } from "./provider-B3DpYSDq.mjs";
+import { s as channels } from "./provider-poIkXapd.mjs";
 import { i as eventSchema, r as envelope } from "./events-CewD4kw7.mjs";
-import { r as markdownOf, t as ChatSyncProvider } from "./chat-provider-YHy-WbrB.mjs";
+import { r as markdownOf, t as ChatSyncProvider } from "./chat-provider-DnHibqnM.mjs";
 import { z } from "zod";
 //#region src/sync/kapso.ts
 const decode = (id) => id.split(":").map((part) => Buffer.from(part, "base64url").toString("utf8")).join(":");

package/dist/sync-linear.d.mts

@@ -1,5 +1,5 @@
-import { S as SyncUnit, c as ReceivedEvent, d as ResolvedTarget, f as SyncContext, o as ProviderPost, r as ProviderDelivery, y as SyncFn } from "./provider-B0b9Qxw4.mjs";
-import { n as ChatSyncProvider, t as ChatInput } from "./chat-provider-DNJQyajS.mjs";
+import { S as SyncUnit, c as ReceivedEvent, d as ResolvedTarget, f as SyncContext, o as ProviderPost, r as ProviderDelivery, y as SyncFn } from "./provider-D11Dfda0.mjs";
+import { n as ChatSyncProvider, t as ChatInput } from "./chat-provider-D0k3y8zY.mjs";
 import { z } from "zod";
 import { Adapter } from "chat";
 //#region src/sync/linear.d.ts

package/dist/sync-linear.mjs

@@ -1,6 +1,6 @@
-import { i as UnreadableError, s as channels } from "./provider-B3DpYSDq.mjs";
+import { i as UnreadableError, s as channels } from "./provider-poIkXapd.mjs";
 import { i as eventSchema, r as envelope } from "./events-CewD4kw7.mjs";
-import { r as markdownOf, t as ChatSyncProvider } from "./chat-provider-YHy-WbrB.mjs";
+import { r as markdownOf, t as ChatSyncProvider } from "./chat-provider-DnHibqnM.mjs";
 import "zod";
 import { connectLinearAdapter } from "@vercel/connect/chat";
 import { createLinearAdapter } from "@chat-adapter/linear";

package/dist/sync-slack.d.mts

@@ -1,6 +1,6 @@
 import { f as ExternalLink } from "./folds-CRYY14kc.mjs";
-import { C as channels, _ as withUserTokens, d as ResolvedTarget, f as SyncContext, h as UserTokens, o as ProviderPost, r as ProviderDelivery, y as SyncFn } from "./provider-B0b9Qxw4.mjs";
-import { n as ChatSyncProvider, t as ChatInput } from "./chat-provider-DNJQyajS.mjs";
+import { C as channels, _ as withUserTokens, d as ResolvedTarget, f as SyncContext, h as UserTokens, o as ProviderPost, r as ProviderDelivery, y as SyncFn } from "./provider-D11Dfda0.mjs";
+import { n as ChatSyncProvider, t as ChatInput } from "./chat-provider-D0k3y8zY.mjs";
 import { z } from "zod";
 import { Adapter } from "chat";
 //#region src/sync/slack.d.ts
@@ -46,6 +46,10 @@ export type SlackClient = {
       messages?: SlackMessage[];
       has_more?: boolean;
     }>;
+    /** Adds the app to a public channel, for `vb sources <key> join`; needs `channels:join`. */
+    join?(args: {
+      channel: string;
+    }): Promise<unknown>;
   };
   users?: {
     info(args: {
@@ -320,6 +324,11 @@ export type SlackOptions = {
   adapter: Adapter | string;
   /** Not needed with a connector. */
   client?: () => Promise<SlackClient>;
+  /**
+   * Lets `vb sources <key> join` add the app to a public channel, so it can be read on demand
+   * without syncing it. Off by default; the app needs `channels:join`.
+   */
+  join?: boolean;
 };
 /**
  * Syncs a Slack workspace with the board: `app` is a Vercel Connect connector

package/dist/sync-slack.mjs

@@ -1,9 +1,9 @@
 import { m as MESSAGE_TEXT_MAX } from "./schemas-Be08nyfW.mjs";
 import "./external-BV_cUncs.mjs";
-import { i as UnreadableError, s as channels } from "./provider-B3DpYSDq.mjs";
+import { i as UnreadableError, s as channels } from "./provider-poIkXapd.mjs";
 import { i as eventSchema, r as envelope } from "./events-CewD4kw7.mjs";
 import { r as withUserTokens, t as connectUserTokens } from "./users-yryHKFMo.mjs";
-import { r as markdownOf, t as ChatSyncProvider } from "./chat-provider-YHy-WbrB.mjs";
+import { r as markdownOf, t as ChatSyncProvider } from "./chat-provider-DnHibqnM.mjs";
 import { z } from "zod";
 import { stringifyMarkdown } from "chat";
 import { createSlackAdapter } from "@chat-adapter/slack";
@@ -318,6 +318,26 @@ var SlackProvider = class extends ChatSyncProvider {
 			if (!found) throw new UnreadableError("channel_not_found", publicOnly ? `no public Slack channel named #${name} (the app lacks groups:read, so a private channel needs its ID)` : `no Slack channel named #${name} (a private channel shows up once the app is invited)`);
 			return found;
 		}
+		async function targetOf(web, target) {
+			const link = new RegExp(PERMALINK.source).exec(target);
+			if (link) {
+				const [, id, seconds, micros, query] = link;
+				return {
+					channel: id,
+					thread: /[?&]thread_ts=(\d+\.\d+)/.exec(query?.replaceAll("&", "&") ?? "")?.[1] ?? `${seconds}.${micros}`
+				};
+			}
+			if (target.startsWith("#")) return {
+				channel: (await find(web, target.slice(1))).id,
+				thread: null
+			};
+			const parsed = /^([A-Z0-9]+)(?::(\d+\.\d+))?$/.exec(target);
+			if (!parsed) throw new UnreadableError("invalid_target", `not a Slack channel, thread, or message link: ${target} (try #name, C0123, C0123:1727000000.123456, or a permalink)`);
+			return {
+				channel: parsed[1],
+				thread: parsed[2] ?? null
+			};
+		}
 		const avatars = /* @__PURE__ */ new Map();
 		function avatarOf(user) {
 			let promise = avatars.get(user);
@@ -488,20 +508,9 @@ var SlackProvider = class extends ChatSyncProvider {
 			async read(target, { limit }) {
 				const web = await client();
 				if (!web) throw new UnreadableError("no_client", "no Slack client to read it with");
-				let channel;
-				let thread = null;
-				const link = new RegExp(PERMALINK.source).exec(target);
-				if (link) {
-					const [, id, seconds, micros, query] = link;
-					channel = id;
-					thread = /[?&]thread_ts=(\d+\.\d+)/.exec(query?.replaceAll("&", "&") ?? "")?.[1] ?? `${seconds}.${micros}`;
-				} else if (target.startsWith("#")) channel = (await find(web, target.slice(1))).id;
-				else {
-					const parsed = /^([A-Z0-9]+)(?::(\d+\.\d+))?$/.exec(target);
-					if (!parsed) throw new UnreadableError("invalid_target", `not a Slack channel, thread, or message link: ${target} (try #name, C0123, C0123:1727000000.123456, or a permalink)`);
-					channel = parsed[1];
-					thread = parsed[2] ?? null;
-				}
+				const parsed = await targetOf(web, target);
+				const channel = parsed.channel;
+				let thread = parsed.thread;
 				let found;
 				let more = false;
 				let name = null;
@@ -512,7 +521,7 @@ var SlackProvider = class extends ChatSyncProvider {
 					const label = name ? `#${name}` : channel;
 					if (info.is_private || info.is_im || info.is_mpim) throw new UnreadableError("private_channel", `${label} is private: the board only reads public channels on demand`);
 					if (info.is_ext_shared) throw new UnreadableError("shared_channel", `${label} is shared with another organization: the board doesn't read those on demand`);
-					if (!info.is_member) throw new UnreadableError("not_in_channel", `the app isn't in ${label}: someone needs to add it (it won't join on its own)`);
+					if (!info.is_member) throw new UnreadableError("not_in_channel", options.join ? `the app isn't in ${label}: join it first with \`vb sources <key> join ${label}\`, which adds the app there` : `the app isn't in ${label}: someone needs to add it (it won't join on its own)`);
 					if (thread) {
 						const replies = web.conversations.replies;
 						if (!replies) throw new UnreadableError("no_client", "this Slack client can't read threads");
@@ -562,6 +571,37 @@ var SlackProvider = class extends ChatSyncProvider {
 					more: more || found.length > limit
 				};
 			},
+			async join(target) {
+				if (!options.join) throw new UnreadableError("join_disabled", "this board doesn't join Slack channels: it needs `join: true` on slack()");
+				const web = await client();
+				if (!web) throw new UnreadableError("no_client", "no Slack client to join with");
+				const { channel } = await targetOf(web, target);
+				try {
+					const info = (await web.conversations.info({ channel })).channel;
+					if (!info) throw new UnreadableError("channel_not_found", `no Slack channel ${channel}`);
+					const name = info.name ?? null;
+					const label = name ? `#${name}` : channel;
+					if (info.is_private || info.is_im || info.is_mpim) throw new UnreadableError("private_channel", `${label} is private: the app can only be invited there`);
+					if (info.is_ext_shared) throw new UnreadableError("shared_channel", `${label} is shared with another organization: the board doesn't join those`);
+					if (info.is_member) return {
+						channel,
+						name,
+						joined: false
+					};
+					if (!web.conversations.join) throw new UnreadableError("no_client", "this Slack client can't join channels");
+					await web.conversations.join({ channel });
+					return {
+						channel,
+						name,
+						joined: true
+					};
+				} catch (error) {
+					if (error instanceof UnreadableError) throw error;
+					const code = slackError(error).split(",")[0];
+					if (code === "missing_scope") throw new UnreadableError(code, "the Slack app can't join channels: it needs the channels:join scope");
+					throw new UnreadableError(code, `Slack refused to join ${target}: ${slackError(error)}`);
+				}
+			},
 			intercept(key, _headers, body) {
 				let event;
 				try {

package/dist/sync.chat.d.mts

@@ -1,2 +1,2 @@
-import { i as externalAuthor, n as ChatSyncProvider, r as ChatTransport, t as ChatInput } from "./chat-provider-DNJQyajS.mjs";
+import { i as externalAuthor, n as ChatSyncProvider, r as ChatTransport, t as ChatInput } from "./chat-provider-D0k3y8zY.mjs";
 export { ChatInput, ChatSyncProvider, ChatTransport, externalAuthor };

package/dist/sync.chat.mjs

@@ -1,2 +1,2 @@
-import { n as externalAuthor, t as ChatSyncProvider } from "./chat-provider-YHy-WbrB.mjs";
+import { n as externalAuthor, t as ChatSyncProvider } from "./chat-provider-DnHibqnM.mjs";
 export { ChatSyncProvider, externalAuthor };

package/dist/sync.d.mts

@@ -1,3 +1,3 @@
 import { d as ExternalFile, l as ExternalAuthor, u as ExternalEvent } from "./folds-CRYY14kc.mjs";
-import { A as SyncOverrides, C as channels, D as EventBase, E as render, M as SyncRoot, N as envelope, O as ProviderEvent, P as eventSchema, S as SyncUnit, T as mirror, _ as withUserTokens, a as ProviderOptions, b as SyncIn, c as ReceivedEvent, d as ResolvedTarget, f as SyncContext, g as connectUserTokens, h as UserTokens, i as ProviderFile, j as SyncResult, k as RootOverride, l as RenderInput, m as UnreadableError, n as FileDelivery, o as ProviderPost, p as SyncProvider, r as ProviderDelivery, s as Receive, u as Renderer, v as Sync, w as into, x as SyncOut, y as SyncFn } from "./provider-B0b9Qxw4.mjs";
+import { A as SyncOverrides, C as channels, D as EventBase, E as render, M as SyncRoot, N as envelope, O as ProviderEvent, P as eventSchema, S as SyncUnit, T as mirror, _ as withUserTokens, a as ProviderOptions, b as SyncIn, c as ReceivedEvent, d as ResolvedTarget, f as SyncContext, g as connectUserTokens, h as UserTokens, i as ProviderFile, j as SyncResult, k as RootOverride, l as RenderInput, m as UnreadableError, n as FileDelivery, o as ProviderPost, p as SyncProvider, r as ProviderDelivery, s as Receive, u as Renderer, v as Sync, w as into, x as SyncOut, y as SyncFn } from "./provider-D11Dfda0.mjs";
 export { EventBase, type ExternalAuthor, ExternalEvent, type ExternalFile, type FileDelivery, type ProviderDelivery, type ProviderEvent, type ProviderFile, type ProviderOptions, type ProviderPost, type Receive, ReceivedEvent, type RenderInput, type Renderer, ResolvedTarget, type RootOverride, type Sync, type SyncContext, type SyncFn, type SyncIn, type SyncOut, SyncOverrides, SyncProvider, type SyncResult, type SyncRoot, type SyncUnit, UnreadableError, type UserTokens, channels, connectUserTokens, envelope, eventSchema, into, mirror, render, withUserTokens };

package/dist/sync.mjs

@@ -1,5 +1,5 @@
 import { n as ExternalEvent } from "./external-BV_cUncs.mjs";
-import { c as into, i as UnreadableError, l as mirror, n as ResolvedTarget, r as SyncProvider, s as channels, t as ReceivedEvent, u as render } from "./provider-B3DpYSDq.mjs";
+import { c as into, i as UnreadableError, l as mirror, n as ResolvedTarget, r as SyncProvider, s as channels, t as ReceivedEvent, u as render } from "./provider-poIkXapd.mjs";
 import { i as eventSchema, n as SyncOverrides, r as envelope, t as EventBase } from "./events-CewD4kw7.mjs";
 import { r as withUserTokens, t as connectUserTokens } from "./users-yryHKFMo.mjs";
 export { EventBase, ExternalEvent, ReceivedEvent, ResolvedTarget, SyncOverrides, SyncProvider, UnreadableError, channels, connectUserTokens, envelope, eventSchema, into, mirror, render, withUserTokens };

package/dist/{tokens-DhuzKzAl.mjs → tokens-DUXaXwOj.mjs}

@@ -1,5 +1,5 @@
-import { l as unauthorized } from "./errors-DX3hpwWt.mjs";
-import { f as markVerified, m as trustedIssuers, n as TOKENS, r as VERCEL_ISSUER, u as issuerName } from "./auth-Drg9FiC2.mjs";
+import { l as unauthorized } from "./errors-CQ-fwxM3.mjs";
+import { f as markVerified, m as trustedIssuers, n as TOKENS, r as VERCEL_ISSUER, u as issuerName } from "./auth-5nLsx9qB.mjs";
 import { createRemoteJWKSet, decodeJwt, jwtVerify } from "jose";
 //#region src/server/identity.ts
 let fromDisk;

package/dist/{watchers-hash-qlnbKQQ0.mjs → watchers-hash-DYwvkhdX.mjs}

@@ -1,7 +1,7 @@
 import { n as DIRECT_UPLOAD_BYTES_MAX, t as ATTACHMENT_BYTES_MAX } from "./files-SniSmeEr.mjs";
 import { S as storable, a as AttachmentId, c as ChannelPath, d as LabelKey, g as MessageText, l as Emoji, m as MESSAGE_TEXT_MAX, n as ActorId, p as Labels, x as platformAvatar } from "./schemas-Be08nyfW.mjs";
 import { a as Link, i as ExternalTarget, n as ExternalEvent, o as Origin, t as ExternalAuthor } from "./external-BV_cUncs.mjs";
-import { r as badRequest, t as HttpError } from "./errors-DX3hpwWt.mjs";
+import { r as badRequest, t as HttpError } from "./errors-CQ-fwxM3.mjs";
 import { z } from "zod";
 //#region src/api/routes.ts
 /**
@@ -114,10 +114,8 @@ const InboxQuery = z.object({
 	channel: z.string().optional(),
 	limit: z.coerce.number().int().min(1).max(500).optional()
 });
-/** What a board on `http()` registers with the board it uses: its watchers' tails, and where to wake it. */
-const RegisterBody = z.object({
-	/** Without one, the board pulls on its own instead of being woken. */
-	url: z.string().url().max(500).refine((url) => /^https:\/\//.test(url), "wake-ups go over https").transform((url) => url.replace(/\/+$/, "")).nullable().optional(),
+/** What every registration carries: its watchers' tails, and its sync entries. */
+const Registering = z.object({
 	watch: z.record(z.string().max(100), z.object({
 		tail: z.string().max(1e3),
 		when: z.enum(["matches", "enters"]).default("matches")
@@ -132,6 +130,30 @@ const RegisterBody = z.object({
 		signIn: z.boolean().default(false)
 	})).max(32).optional()
 });
+/**
+* What a board on `http()` registers with the board it uses: its watchers, and where to wake it,
+* at a URL or at a path on its own project, never both.
+*/
+const RegisterBody = z.union([Registering.extend({
+	/** Without one, the board pulls on its own instead of being woken. */
+	url: z.string().url().max(500).refine((url) => /^https:\/\//.test(url), "wake-ups go over https").transform((url) => url.replace(/\/+$/, "")).nullable().optional(),
+	path: z.null({ error: "register a url or a path, not both" }).optional(),
+	branch: z.null({ error: "a branch goes with a path" }).optional()
+}), Registering.extend({
+	url: z.null({ error: "register a url or a path, not both" }).optional(),
+	/**
+	* Where to wake the caller on its own Vercel project, on a board whose discovery says
+	* `wake_by_path`. The board takes the project and environment from the caller's token and
+	* finds the deployment, so a project can only register itself, and anyone else gets 403
+	* `not_a_project`.
+	*/
+	path: z.string().max(300).regex(/^\/[^?#]*$/, "a path starts with / and has no query or fragment").transform((path) => path.replace(/(.)\/+$/, "$1")),
+	/**
+	* From a preview: the branch whose latest ready preview is woken, since a token says which
+	* project and environment called but not which deployment. Production names none.
+	*/
+	branch: z.string().min(1).max(255).nullable().optional()
+})]);
 /** A pull of the caller's matches: at most `limit`, waiting up to `wait` seconds for one. */
 const MatchesQuery = z.object({
 	limit: z.coerce.number().int().min(1).max(50).optional(),
@@ -151,6 +173,8 @@ const SourceReadQuery = z.object({
 	target: z.string().min(1).max(4e3),
 	limit: z.coerce.number().int().min(1).max(200).optional()
 });
+/** A channel to add the board's app to, so it can be read on demand: `#name`, an ID, or a link into it. */
+const SourceJoinBody = z.object({ target: z.string().min(1).max(4e3) });
 /** A platform's link to a message or thread, such as a Slack permalink or a GitHub comment's URL. */
 const LinkedQuery = z.object({ url: z.string().url().max(4e3) });
 const IdentityUnlinkBody = z.object({ actor: z.string().min(1).max(256) });
@@ -538,6 +562,12 @@ const routes = {
 		path: "/sources/:key/read",
 		query: SourceReadQuery
 	},
+	/** Adds the app to a public channel so it can be read, where that sync runs and opted in with `join`. Full access only. */
+	joinSource: {
+		method: "POST",
+		path: "/sources/:key/join",
+		body: SourceJoinBody
+	},
 	webhook: {
 		method: "POST",
 		path: "/webhooks/:key"
@@ -631,7 +661,7 @@ const routes = {
 const SYNC = "@sync";
 //#endregion
 //#region src/version.ts
-const VERSION = "0.18.1";
+const VERSION = "0.20.0";
 //#endregion
 //#region src/server/routing.ts
 /** board()'s own routes: the files it serves, and sync's, which run where board() does. */
@@ -687,6 +717,7 @@ const METHODS = [
 	"syncUnlink",
 	"typing",
 	"readSource",
+	"joinSource",
 	"synced",
 	"linked"
 ];
@@ -989,4 +1020,4 @@ function canonicalWatchers(watch, sync = []) {
 	return JSON.stringify(canonical);
 }
 //#endregion
-export { ScheduleBody as A, SyncReceiptBody as B, LinkedQuery as C, ReactBody as D, PostBody as E, SyncBody as F, UploadStartBody as G, SyncUnlinkBody as H, SyncCodeBody as I, routes as K, SyncCopiesQuery as L, SignInQuery as M, SourceReadQuery as N, Ref as O, SyncAccountBody as P, SyncFindQuery as R, LabelBody as S, MessagesQuery as T, ThreadsQuery as U, SyncRootsQuery as V, TypingBody as W, IdentityUnlinkBody as _, withMentions as a, InboxPushBody as b, openapi as c, readJson as d, VERSION as f, EventsQuery as g, EditBody as h, FILTER_FLAGS as i, SchedulesQuery as j, RegisterBody as k, queryObject as l, AckBody as m, compileWatcher as n, METHODS as o, SYNC as p, hasCriteria as r, createRouter as s, canonicalWatchers as t, readCapped as u, InboxAckBody as v, MatchesQuery as w, InboxQuery as x, InboxNextQuery as y, SyncImportBody as z };
+export { ScheduleBody as A, SyncImportBody as B, LinkedQuery as C, ReactBody as D, PostBody as E, SyncAccountBody as F, TypingBody as G, SyncRootsQuery as H, SyncBody as I, UploadStartBody as K, SyncCodeBody as L, SignInQuery as M, SourceJoinBody as N, Ref as O, SourceReadQuery as P, SyncCopiesQuery as R, LabelBody as S, MessagesQuery as T, SyncUnlinkBody as U, SyncReceiptBody as V, ThreadsQuery as W, IdentityUnlinkBody as _, withMentions as a, InboxPushBody as b, openapi as c, readJson as d, VERSION as f, EventsQuery as g, EditBody as h, FILTER_FLAGS as i, SchedulesQuery as j, RegisterBody as k, queryObject as l, AckBody as m, compileWatcher as n, METHODS as o, SYNC as p, routes as q, hasCriteria as r, createRouter as s, canonicalWatchers as t, readCapped as u, InboxAckBody as v, MatchesQuery as w, InboxQuery as x, InboxNextQuery as y, SyncFindQuery as z };

package/docs/01-board/06-watchers.md

@@ -236,6 +236,13 @@ export const GET = team.fetch, POST = team.fetch
   makes this board pull with its own credentials. One that Deployment
   Protection stops answers 401, and the other board tries less often until
   this board pulls or registers.
+- **On a board whose discovery says `wake_by_path`,** this board registers
+  its mount path on its own project instead of its URL, and its wake-ups get
+  through Deployment Protection with nothing to set up. Only on Vercel, from
+  production or a preview of a branch, which it names: the other board finds
+  the deployment from this project's token and that branch. Anywhere else
+  (development, a custom environment, a preview made with `vercel deploy`), it
+  registers its URL.
 - **Retries need the other board's scheduler,** as its own watchers do.
   Without one there, nothing waits on a clock: a retry, a lease that ran out,
   and a wake-up that didn't get there (once its back-off is over) each wait