@vercel/board 0.29.0 → 0.30.0

package/dist/{client-BqAjk0Q4.d.mts → client-CjAatpV4.d.mts}

@@ -1,10 +1,11 @@
 import { n as AccessSummary } from "./access-CV96SYgr.mjs";
-import { a as ExternalCopy, g as BoardEvent, o as Message, p as Link, r as Channel, t as Actor, u as ExternalEvent, x as Attachment } from "./folds-ZkHM4M-v.mjs";
+import { a as ExternalCopy, g as BoardEvent, o as Message, p as Link, r as Channel, t as Actor, u as ExternalEvent, x as Attachment } from "./folds-8wRRXjAt.mjs";
 import { z } from "zod";
 //#region src/api/routes.d.ts
 /**
  * A message's, schedule's, or cursor's ID: a string clients pass back as they got it, and never
- * parse, compare, or count with. Each backend picks its own; a board on `a2()` writes decimals.
+ * parse, compare, or count with. Each backend picks its own; a board on `a2()` writes decimals,
+ * and `s12` for a schedule.
  */
 declare const Ref: z.ZodString;
 /** A sync target as the board that syncs it resolved it: a platform channel to start a thread in, or a thread to join. */
@@ -78,6 +79,7 @@ declare const PostBody: z.ZodObject<{
   }, z.core.$strip>]>>>;
   id: z.ZodOptional<z.ZodString>;
   attachments: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  after: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /**
  * A message to post later, as the caller: once (`in` or `at`), or repeating
@@ -232,6 +234,7 @@ declare const SyncImportBody: z.ZodDiscriminatedUnion<[z.ZodObject<{
     message: z.ZodNullable<z.ZodString>;
   }, z.core.$strip>>>;
   id: z.ZodOptional<z.ZodString>;
+  after: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
   author: z.ZodObject<{
     id: z.ZodString;
@@ -253,6 +256,7 @@ declare const SyncImportBody: z.ZodDiscriminatedUnion<[z.ZodObject<{
     channel: z.ZodString;
     thread: z.ZodString;
   }, z.core.$strip>>;
+  revision: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>, z.ZodObject<{
   author: z.ZodObject<{
     id: z.ZodString;
@@ -268,6 +272,7 @@ declare const SyncImportBody: z.ZodDiscriminatedUnion<[z.ZodObject<{
   }, z.core.$strip>>;
   message: z.ZodOptional<z.ZodString>;
   op: z.ZodLiteral<"delete">;
+  revision: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>, z.ZodObject<{
   author: z.ZodObject<{
     id: z.ZodString;
@@ -302,6 +307,7 @@ declare const SyncImportBody: z.ZodDiscriminatedUnion<[z.ZodObject<{
   op: z.ZodLiteral<"labels">;
   set: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
   unset: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  if: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
 }, z.core.$strip>, z.ZodObject<{
   author: z.ZodObject<{
     id: z.ZodString;
@@ -553,11 +559,15 @@ declare const SignInQuery: z.ZodObject<{
 declare const SyncUnlinkBody: z.ZodObject<{
   account: z.ZodString;
 }, z.core.$strip>;
-/** A direct upload, before its bytes: what the file will be called, its type, and its exact size. */
+/**
+ * A direct upload, before its bytes: what the file will be called, its type, its exact size, and
+ * the SHA-256 of its bytes, in base64, for a store that signs its URL for them (Vercel's).
+ */
 declare const UploadStartBody: z.ZodObject<{
   name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   size: z.ZodNumber;
+  sha256: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /** Where to send a direct upload's bytes: `PUT` the file to `url` with `headers` (its `content-type` included), before `expiresAt`, then finish it. */
 type UploadTicket = {
@@ -568,8 +578,11 @@ type UploadTicket = {
 };
 declare const EditBody: z.ZodObject<{
   text: z.ZodString;
+  revision: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
-declare const DeleteBody: z.ZodOptional<z.ZodObject<{}, z.core.$strip>>;
+declare const DeleteBody: z.ZodOptional<z.ZodObject<{
+  revision: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>>;
 /** `status`: what Slack shows in place of "Typing…" (WhatsApp and GitHub ignore it). */
 declare const TypingBody: z.ZodOptional<z.ZodObject<{
   status: z.ZodOptional<z.ZodString>;
@@ -578,9 +591,12 @@ declare const ReactBody: z.ZodObject<{
   emoji: z.ZodString;
   remove: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
+/** At most this many labels in a label write's `if`. */
+declare const LABEL_CONDITIONS_MAX = 16;
 declare const LabelBody: z.ZodObject<{
   set: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
   unset: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  if: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
 }, z.core.$strip>;
 type FiltersInput = z.input<typeof Filters$1>;
 type SyncImportInput = z.input<typeof SyncImportBody>;
@@ -655,7 +671,7 @@ type ActorView = Pick<Actor, 'kind' | 'handle' | 'name' | 'avatar'> & {
   person?: PersonView;
 };
 /** A message as clients see it: its IDs are refs, and `version` says which of two views of it is newer. */
-type MessageView = Omit<Message, 'id' | 're' | 'replyTo' | 'links' | 'schedule' | 'version'> & {
+type MessageView = Omit<Message, 'id' | 're' | 'replyTo' | 'links' | 'schedule' | 'version' | 'revision'> & {
   id: string;
   /** The thread's root, or null for a root. */
   re: string | null;
@@ -663,6 +679,11 @@ type MessageView = Omit<Message, 'id' | 're' | 'replyTo' | 'links' | 'schedule'
   replyTo: string | null;
   /** Grows with each change to this message: of two views of it, the one with the higher version is newer. */
   version: number;
+  /**
+   * Changes with each edit and delete, and only then: what an edit or a delete passes as `revision`
+   * to change it only if no one has since.
+   */
+  revision: number;
   links: LinkView[];
   /** Set when a schedule posted it: the schedule's ID and which send this was, from 0. */
   schedule?: {
@@ -1016,6 +1037,7 @@ declare const routes: {
       }, z.core.$strip>]>>>;
       id: z.ZodOptional<z.ZodString>;
       attachments: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      after: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
   };
   readonly edit: {
@@ -1023,12 +1045,15 @@ declare const routes: {
     readonly path: '/messages/:id/edit';
     readonly body: z.ZodObject<{
       text: z.ZodString;
+      revision: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
   };
   readonly delete: {
     readonly method: 'POST';
     readonly path: '/messages/:id/delete';
-    readonly body: z.ZodOptional<z.ZodObject<{}, z.core.$strip>>;
+    readonly body: z.ZodOptional<z.ZodObject<{
+      revision: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
   };
   readonly react: {
     readonly method: 'POST';
@@ -1044,6 +1069,7 @@ declare const routes: {
     readonly body: z.ZodObject<{
       set: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
       unset: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      if: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
     }, z.core.$strip>;
   };
   /** Attaches the thread to a sync target, recording a `thread` receipt: needs `sync` where the thread is. */
@@ -1313,6 +1339,7 @@ declare const routes: {
         message: z.ZodNullable<z.ZodString>;
       }, z.core.$strip>>>;
       id: z.ZodOptional<z.ZodString>;
+      after: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
       author: z.ZodObject<{
         id: z.ZodString;
@@ -1334,6 +1361,7 @@ declare const routes: {
         channel: z.ZodString;
         thread: z.ZodString;
       }, z.core.$strip>>;
+      revision: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>, z.ZodObject<{
       author: z.ZodObject<{
         id: z.ZodString;
@@ -1349,6 +1377,7 @@ declare const routes: {
       }, z.core.$strip>>;
       message: z.ZodOptional<z.ZodString>;
       op: z.ZodLiteral<"delete">;
+      revision: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>, z.ZodObject<{
       author: z.ZodObject<{
         id: z.ZodString;
@@ -1383,6 +1412,7 @@ declare const routes: {
       op: z.ZodLiteral<"labels">;
       set: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
       unset: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      if: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>;
     }, z.core.$strip>, z.ZodObject<{
       author: z.ZodObject<{
         id: z.ZodString;
@@ -1592,6 +1622,7 @@ declare const routes: {
       name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
       type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
       size: z.ZodNumber;
+      sha256: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
   };
   /** After the `PUT`: the board checks what landed in the store and records the attachment. */
@@ -1766,7 +1797,13 @@ type PostOptions = {
   /** Files from `upload`, or their IDs. */
   attachments?: (Attachment | string)[];
 };
-type ReplyOptions = Omit<PostOptions, 'sync'>;
+type ReplyOptions = Omit<PostOptions, 'sync'> & {
+  /**
+   * Posts only while this is the thread's newest message: the ID of the last one you read. If
+   * another has come after it, nothing is posted, and it throws a 409 `newer_message`.
+   */
+  after?: string;
+};
 /**
  * When a scheduled message goes out: once `in` a while or `at` a time, or
  * `every` so often (first at `at`, `in`, or one `every` from now), stopping
@@ -1865,11 +1902,19 @@ declare function createBoardClient(options: ClientOptions): {
   download: (id: string, opts?: {
     signal?: AbortSignal;
   }) => Promise<Response>;
-  edit: (id: string, text: string) => Promise<{
+  /**
+   * `revision` is the message's as you read it: if it's been edited or deleted since, nothing
+   * changes, and it throws a 409 `revision_conflict`.
+   */
+  edit: (id: string, text: string, opts?: {
+    revision?: number;
+  }) => Promise<{
     ok: true;
     unknownMentions?: string[];
   }>;
-  delete: (id: string) => Promise<{
+  delete: (id: string, opts?: {
+    revision?: number;
+  }) => Promise<{
     ok: true;
   }>;
   /** `emoji` is a short name, `:name:`, or the character itself. */
@@ -1878,9 +1923,14 @@ declare function createBoardClient(options: ClientOptions): {
   }) => Promise<{
     ok: true;
   }>;
+  /**
+   * `if` is what the labels must be now, a value or null for one that mustn't be set: if one
+   * isn't, nothing changes, and it throws a 409 `label_conflict`.
+   */
   label: (id: string, change: {
     set?: Record<string, string>;
     unset?: string[];
+    if?: Record<string, string | null>;
   }) => Promise<{
     ok: true;
   }>;
@@ -2009,4 +2059,4 @@ declare function createBoardClient(options: ClientOptions): {
   }, opts?: WaitOptions): Promise<BoardEventView | null>;
 };
 //#endregion
-export { RegisterInput as $, InboxItem as A, SyncRootsQuery as At, Me as B, TypingResult as Bt, EventsQuery as C, SyncFindInput as Ct, IdentityView as D, SyncImportInput as Dt, IdentityUnlinkBody as E, SyncImportBody as Et, LinkView as F, ThreadView as Ft, ParsedFilters as G, MessagesPage as H, UploadTicket as Ht, LinkedAccount as I, ThreadsPage as It, PostInput as J, PersonView as K, LinkedQuery as L, ThreadsQuery as Lt, InboxPushBody as M, SyncUnlinkBody as Mt, InboxQuery as N, SyncedView as Nt, InboxAckBody as O, SyncReceiptBody as Ot, LabelBody as P, ThreadSummaryView as Pt, RegisterBody as Q, MatchView as R, ThreadsQueryInput as Rt, EventsPage as S, SyncCopiesView as St, FiltersInput as T, SyncFindView as Tt, MessagesQuery as U, routes as Ut, MessageView as V, UploadStartBody as Vt, MessagesQueryInput as W, ReactBody as X, REGISTERED_WATCHERS_MAX as Y, Ref as Z, BoardEventView as _, SyncAccountInput as _t, PostOptions as a, ScheduleInput as at, Discovery as b, SyncCodeView as bt, ScheduleOptions as c, SchedulesQueryInput as ct, WaitOptions as d, SourceJoin as dt, RegistrationView as et, Written as f, SourceJoinBody as ft, ApiError as g, SyncAccountBody as gt, ActorView as h, SourceReadQuery as ht, Filters as i, ScheduleBodyOutput as it, InboxNextQuery as j, SyncThreadView as jt, InboxEntry as k, SyncReceiptInput as kt, ScheduleTiming as l, SchedulesQueryOutput as lt, AckBody as m, SourceRead as mt, BoardError as n, RouteName as nt, ProfileOption as o, ScheduleView as ot, duration as p, SourceMessage as pt, PostBody as q, ErrorOrigin as r, ScheduleBody as rt, ReplyOptions as s, SchedulesQuery as st, BoardClient as t, ResolvedSyncTarget as tt, UploadInput as u, SignInQuery as ut, ChannelView as v, SyncBody as vt, EventsQueryInput as w, SyncFindQuery as wt, EditBody as x, SyncCopiesQuery as xt, DeleteBody as y, SyncCodeBody as yt, MatchesQuery as z, TypingBody as zt };
+export { RegisterBody as $, InboxItem as A, SyncReceiptInput as At, MatchesQuery as B, TypingBody as Bt, EventsQuery as C, SyncCopiesView as Ct, IdentityView as D, SyncImportBody as Dt, IdentityUnlinkBody as E, SyncFindView as Et, LabelBody as F, ThreadSummaryView as Ft, MessagesQueryInput as G, MessageView as H, UploadStartBody as Ht, LinkView as I, ThreadView as It, PostBody as J, ParsedFilters as K, LinkedAccount as L, ThreadsPage as Lt, InboxPushBody as M, SyncThreadView as Mt, InboxQuery as N, SyncUnlinkBody as Nt, InboxAckBody as O, SyncImportInput as Ot, LABEL_CONDITIONS_MAX as P, SyncedView as Pt, Ref as Q, LinkedQuery as R, ThreadsQuery as Rt, EventsPage as S, SyncCopiesQuery as St, FiltersInput as T, SyncFindQuery as Tt, MessagesPage as U, UploadTicket as Ut, Me as V, TypingResult as Vt, MessagesQuery as W, routes as Wt, REGISTERED_WATCHERS_MAX as X, PostInput as Y, ReactBody as Z, BoardEventView as _, SyncAccountBody as _t, PostOptions as a, ScheduleBodyOutput as at, Discovery as b, SyncCodeBody as bt, ScheduleOptions as c, SchedulesQuery as ct, WaitOptions as d, SignInQuery as dt, RegisterInput as et, Written as f, SourceJoin as ft, ApiError as g, SourceReadQuery as gt, ActorView as h, SourceRead as ht, Filters as i, ScheduleBody as it, InboxNextQuery as j, SyncRootsQuery as jt, InboxEntry as k, SyncReceiptBody as kt, ScheduleTiming as l, SchedulesQueryInput as lt, AckBody as m, SourceMessage as mt, BoardError as n, ResolvedSyncTarget as nt, ProfileOption as o, ScheduleInput as ot, duration as p, SourceJoinBody as pt, PersonView as q, ErrorOrigin as r, RouteName as rt, ReplyOptions as s, ScheduleView as st, BoardClient as t, RegistrationView as tt, UploadInput as u, SchedulesQueryOutput as ut, ChannelView as v, SyncAccountInput as vt, EventsQueryInput as w, SyncFindInput as wt, EditBody as x, SyncCodeView as xt, DeleteBody as y, SyncBody as yt, MatchView as z, ThreadsQueryInput as zt };

package/dist/{commands-C3R1AWgm.mjs → commands-B5DHjZKK.mjs}

@@ -120,6 +120,23 @@ const options = {
 		value: "k",
 		description: "remove a label"
 	},
+	if: {
+		type: "string",
+		multiple: true,
+		value: "k=v",
+		description: "only while the message has this label now"
+	},
+	"if-unset": {
+		type: "string",
+		multiple: true,
+		value: "k",
+		description: "only while the message doesn't have this label"
+	},
+	"if-revision": {
+		type: "string",
+		value: "N",
+		description: "only if it is still at this revision, as read --json shows it"
+	},
 	channel: {
 		type: "string",
 		value: "c",
@@ -243,6 +260,8 @@ const text = (description = "what it says: - reads it from stdin, and it may be
 	required: false,
 	description
 });
+/** What `--after` means on a reply: a precondition, where on a read it's a position. */
+const AFTER = "a reply only while this is the thread's newest message";
 /** What one of the CLI's help pages lists together, in this order. */
 const groups = [
 	"you",
@@ -369,7 +388,8 @@ const commands = [
 			option("attach"),
 			option("sync"),
 			option("no-sync"),
-			option("idempotency-key")
+			option("idempotency-key"),
+			option("after", AFTER)
 		],
 		examples: [{
 			name: "start a thread",
@@ -387,11 +407,15 @@ const commands = [
 		options: [
 			option("attach"),
 			option("idempotency-key"),
-			option("no-sync")
+			option("no-sync"),
+			option("after", AFTER)
 		],
 		examples: [{
 			name: "reply in a thread",
 			value: "reply 812 \"on it\""
+		}, {
+			name: "reply only if #815 is still the thread's newest",
+			value: "reply 812 \"on it\" --after 815"
 		}]
 	},
 	{
@@ -465,10 +489,13 @@ const commands = [
 			required: true,
 			description: "its new text: - reads it from stdin"
 		}],
-		options: [],
+		options: [option("if-revision")],
 		examples: [{
 			name: "fix a typo",
 			value: "edit 812 \"deploys are green again\""
+		}, {
+			name: "only if no one changed it since you read it",
+			value: "edit 812 \"step 3 of 5\" --if-revision 820"
 		}]
 	},
 	{
@@ -477,7 +504,7 @@ const commands = [
 		aliases: ["rm", "del"],
 		description: "delete a message, leaving a tombstone",
 		arguments: [id()],
-		options: [],
+		options: [option("if-revision")],
 		examples: [{
 			name: "delete a message",
 			value: "delete 812"
@@ -508,11 +535,25 @@ const commands = [
 			multiple: true,
 			description: "a label to set"
 		}],
-		options: [option("unset")],
-		examples: [{
-			name: "mark a bug fixed",
-			value: "label 812 state=fixed --unset wip"
-		}]
+		options: [
+			option("unset"),
+			option("if"),
+			option("if-unset")
+		],
+		examples: [
+			{
+				name: "mark a bug fixed",
+				value: "label 812 state=fixed --unset wip"
+			},
+			{
+				name: "claim a thread, unless someone has",
+				value: "label 812 owner=claude --if-unset owner"
+			},
+			{
+				name: "move it on from open only",
+				value: "label 812 state=fixing --if state=open"
+			}
+		]
 	},
 	{
 		group: "messages",

package/dist/{commands-D6gvrOh3.d.mts → commands-BtH69yqt.d.mts}

@@ -166,6 +166,23 @@ declare const options: {
     readonly value: 'k';
     readonly description: 'remove a label';
   };
+  readonly if: {
+    readonly type: 'string';
+    readonly multiple: true;
+    readonly value: 'k=v';
+    readonly description: 'only while the message has this label now';
+  };
+  readonly 'if-unset': {
+    readonly type: 'string';
+    readonly multiple: true;
+    readonly value: 'k';
+    readonly description: "only while the message doesn't have this label";
+  };
+  readonly 'if-revision': {
+    readonly type: 'string';
+    readonly value: 'N';
+    readonly description: 'only if it is still at this revision, as read --json shows it';
+  };
   readonly channel: {
     readonly type: 'string';
     readonly value: 'c';