@sanity/client 8.2.0 → 8.3.0

package/dist/media-library.d.ts

@@ -1,4 +1,4 @@
-import { _r as VideoSubtitleInfoPublic, dr as VideoPlaybackInfoSigned, fr as VideoPlaybackTokens, gr as VideoSubtitleInfo, hr as VideoRenditionInfoSigned, mr as VideoRenditionInfoPublic, or as VideoPlaybackInfo, pr as VideoRenditionInfo, vr as VideoSubtitleInfoSigned } from "./types-nJhm5Nyq.js";
+import { _r as VideoSubtitleInfoPublic, dr as VideoPlaybackInfoSigned, fr as VideoPlaybackTokens, gr as VideoSubtitleInfo, hr as VideoRenditionInfoSigned, mr as VideoRenditionInfoPublic, or as VideoPlaybackInfo, pr as VideoRenditionInfo, vr as VideoSubtitleInfoSigned } from "./types-0x2hPfhJ.js";
 /**
  * Check if the entire playback info response requires signed URLs
  * @public

package/dist/{types-nJhm5Nyq.d.ts → types-0x2hPfhJ.d.ts}

@@ -1285,6 +1285,17 @@ interface CollaborationCommentRange {
     offset: number;
   };
 }
+/**
+ * Portable Text covering a comment `range`. Callers can send just the blocks
+ * from the `range` start `_key` through end `_key`, or the full field.
+ *
+ * @alpha
+ */
+type CollaborationCommentFieldValue = Array<{
+  _type: string;
+  _key: string;
+  [key: string]: Any$1;
+}>;
 /**
  * Target for a top-level comment. Inline selections require both `path` and
  * `range`; field-level comments may set `path` alone.
@@ -1293,6 +1304,9 @@ interface CollaborationCommentRange {
  * `target.path.field`, and `range` is resolved against the document into
  * `target.path.selection` and `contentSnapshot` rather than being stored.
  *
+ * An optional `fieldValue` is Portable Text covering the `range`. When set,
+ * the `range` is resolved from those blocks instead of from the live document.
+ *
  * @alpha
  */
 type CollaborationCommentTarget = {
@@ -1303,10 +1317,16 @@ type CollaborationCommentTarget = {
   /** Path to the field containing the inline comment selection */
   path: string;
   range: CollaborationCommentRange;
+  /**
+   * Portable Text covering the `range`. When set, the `range` is resolved
+   * from these blocks instead of from the live document.
+   */
+  fieldValue?: CollaborationCommentFieldValue;
 } | {
   /** Path to the commented field */
   path?: string;
   range?: never;
+  fieldValue?: never;
 });
 /**
  * Comment to create with `collaboration.comments.create`.
@@ -1325,6 +1345,19 @@ type CollaborationCommentTarget = {
  * })
  * ```
  *
+ * #### Inline comment
+ * ```ts
+ * await client.collaboration.comments.create({
+ *   message,
+ *   target: {
+ *     documentId: 'doc-1',
+ *     documentType: 'article',
+ *     path: 'body',
+ *     range: {start: {_key: 'block-1', offset: 0}, end: {_key: 'block-1', offset: 5}},
+ *   },
+ * })
+ * ```
+ *
  * #### Reply
  * ```ts
  * await client.collaboration.comments.create({
@@ -1352,20 +1385,33 @@ type CollaborationCommentCreate = {
 /**
  * Fields that can be updated on an existing comment.
  *
+ * A `range` re-anchors the comment within the field it already targets.
+ * Pass `null` to remove the selection and leave a field-level comment.
+ * An optional `fieldValue` is Portable Text covering that `range`; when set,
+ * the `range` is resolved from those blocks instead of from the live document.
+ * `fieldValue` cannot be sent alone or together with `range: null`.
+ *
  * @alpha
  */
-interface CollaborationCommentUpdate {
+type CollaborationCommentUpdate = {
   /** Replaces the current message */
   message?: CollaborationCommentMessage;
   /** Cascades to the comment's replies */
   status?: CollaborationCommentStatus;
+} & ({
+  range: CollaborationCommentRange;
   /**
-   * Re-anchors the comment within the field and source document it already
-   * targets. Pass `null` to remove the selection and leave a field-level
-   * comment.
+   * Portable Text covering the `range`. When set, the `range` is resolved
+   * from these blocks instead of from the live document.
    */
-  range?: CollaborationCommentRange | null;
-}
+  fieldValue?: CollaborationCommentFieldValue;
+} | {
+  range: null;
+  fieldValue?: never;
+} | {
+  range?: undefined;
+  fieldValue?: never;
+});
 /**
  * Comments on the configured organization resource.
  *
@@ -2091,6 +2137,17 @@ interface InvokeFunctionRequest {
   signal?: AbortSignal;
 }
 /** @public */
+interface InvokeFunctionOptions {
+  /**
+   * Wait for the function to finish and resolve with its return value.
+   *
+   * Defaults to `false`: the invocation is started, the request resolves as soon
+   * as it is accepted, and the value is always `undefined`. Only function types
+   * that support running inline can be invoked synchronously.
+   */
+  sync?: boolean;
+}
+/** @public */
 declare class ObservableFunctionsClient {
   #private;
   constructor(client: ObservableSanityClient$1, httpRequest: HttpRequest);
@@ -2098,12 +2155,21 @@ declare class ObservableFunctionsClient {
    * Invoke a deployed function by its blueprint name.
    *
    * The name is resolved within the stack given by `stackId` on the request or
-   * the client config. Passes the function's return value once it finishes.
+   * the client config. Starts the invocation and emits `undefined` as soon as
+   * it is accepted; pass `{sync: true}` to wait for the function's return value
+   * instead.
    *
    * @param functionName - name of the function, as declared in the blueprint
    * @param request - payload and request options
+   * @param options - invocation options
    */
-  invoke<R = unknown>(functionName: string, request?: InvokeFunctionRequest): Observable<R | undefined>;
+  invoke(functionName: string, request?: InvokeFunctionRequest, options?: InvokeFunctionOptions & {
+    sync?: false;
+  }): Observable<undefined>;
+  invoke<R = unknown>(functionName: string, request: InvokeFunctionRequest | undefined, options: InvokeFunctionOptions & {
+    sync: true;
+  }): Observable<R>;
+  invoke<R = unknown>(functionName: string, request?: InvokeFunctionRequest, options?: InvokeFunctionOptions): Observable<R | undefined>;
 }
 /** @public */
 declare class FunctionsClient {
@@ -2114,20 +2180,30 @@ declare class FunctionsClient {
    *
    * The name is resolved within the stack given by `stackId` on the request or
    * the client config, which costs one extra request per call. Rejects if the
-   * stack has no function by that name, or if the name resolves to anything
-   * other than a `sanity.function.pubsub` function.
+   * stack has no function by that name, or if the name resolves to a function
+   * type that cannot be invoked the way it was asked for.
    *
    * The lookup is scoped to `projectId`, or to `organizationId` when one is set
    * for a stack deployed at organization scope.
    *
-   * The request stays open until the function finishes, and resolves with its
-   * return value, or `undefined` if it returns nothing. Long-running functions
-   * may need an explicit `timeout`.
+   * The invocation is started by default: the promise resolves with `undefined`
+   * as soon as the call is accepted, without waiting for the function to run.
+   * Pass `{sync: true}` to keep the request open until the function finishes
+   * and resolve with its return value — long-running functions may then need an
+   * explicit `timeout`. Only `sanity.function.pubsub` functions can be invoked
+   * synchronously.
    *
    * @param functionName - name of the function, as declared in the blueprint
    * @param request - payload and request options
+   * @param options - invocation options
    */
-  invoke<R = unknown>(functionName: string, request?: InvokeFunctionRequest): Promise<R | undefined>;
+  invoke(functionName: string, request?: InvokeFunctionRequest, options?: InvokeFunctionOptions & {
+    sync?: false;
+  }): Promise<undefined>;
+  invoke<R = unknown>(functionName: string, request: InvokeFunctionRequest | undefined, options: InvokeFunctionOptions & {
+    sync: true;
+  }): Promise<R>;
+  invoke<R = unknown>(functionName: string, request?: InvokeFunctionRequest, options?: InvokeFunctionOptions): Promise<R | undefined>;
 }
 /** @internal */
 declare class ObservableMediaLibraryVideoClient {
@@ -6384,5 +6460,5 @@ interface MediaLibraryAssetDocument {
   parent?: SanityReference | null;
   rootDirectory?: Any$1;
 }
-export { DisconnectEvent as $, UploadClientConfig as $n, CollaborationCommentRange as $r, QueryWithoutParams as $t, ContentSourceMapMappings as A, DocumentAgentActionParam as Ai, SanityReference as An, ObservableProjectsClient as Ar, MediaLibraryAssetVersion as At, CreateVersionAction as B, TransactionAllDocumentIdsMutationOptions as Bn, ObservableTransaction as Br, MutationSelection as Bt, ContentSourceMap$1 as C, PatchTarget as Ci, SanityDocument$1 as Cn, GenerateTarget as Cr, LiveEventGoAway as Ct, ContentSourceMapDocuments$1 as D, AgentActionPathSegment as Di, SanityProject as Dn, SanityClient$1 as Dr, LiveEventWelcome as Dt, ContentSourceMapDocumentValueSource as E, AgentActionPath as Ei, SanityImagePalette as En, ObservableSanityClient$1 as Er, LiveEventRestart as Et, ContentSourceMapValueMapping as F, StackablePerspective as Fn, InvokeFunctionRequest as Fr, Mutation as Ft, DatasetResponse as G, UnarchiveReleaseAction as Gn, Patch as Gr, PatchOperations as Gt, DatasetAclMode as H, TransactionFirstDocumentIdMutationOptions as Hn, Transaction as Hr, OpenEvent as Ht, CreateAction as I, StillImageFormat as In, DatasetsClient as Ir, MutationError as It, DeleteReleaseAction as J, UnpublishAction as Jn, ObservableCollaborationCommentsClient as Jr, PublishReleaseAction as Jt, DatasetsResponse as K, UnfilteredResponseQueryOptions as Kn, LiveClient as Kr, PatchSelection as Kt, CreateReleaseAction as L, StoryboardTransformOptions as Ln, ObservableDatasetsClient as Lr, MutationErrorItem as Lt, ContentSourceMapRemoteDocument as M, GroqAgentActionParam as Mi, ScheduleReleaseAction as Mn, MediaLibraryVideoClient as Mr, MediaLibraryVideoPlaybackTransformations as Mt, ContentSourceMapSource as N, SingleActionResult as Nn, ObservableMediaLibraryVideoClient as Nr, MultipleActionResult as Nt, ContentSourceMapLiteralSource as O, AgentActionTarget as Oi, SanityProjectMember as On, ObservableUsersClient as Or, MediaLibraryAssetDocument as Ot, ContentSourceMapUnknownSource as P, SingleMutationResult as Pn, InvokeFunctionEvent as Pr, MultipleMutationResult as Pt, DiscardVersionAction as Q, UploadBody as Qn, CollaborationCommentPortableTextBlock as Qr, QueryParseError as Qt, CreateVariantAction as R, SyncTag as Rn, BaseTransaction as Rr, MutationEvent as Rt, ClientVariantConditions as S, PatchOperation as Si, SanityAssetDocument as Sn, GenerateOperation as Sr, LiveEvent as St, ContentSourceMapDocumentBase as T, AgentActionParams as Ti, SanityImageAssetDocument as Tn, GenerateTargetInclude as Tr, LiveEventReconnect as Tt, DatasetCreateOptions as U, TransactionFirstDocumentMutationOptions as Un, BasePatch as Ur, PartialExcept as Ut, CurrentSanityUser as V, TransactionAllDocumentsMutationOptions as Vn, PatchBuilder as Vr, MutationSelectionQueryParams as Vt, DatasetEditOptions as W, TransactionMutationOptions as Wn, ObservablePatch as Wr, PatchMutationOperation as Wt, DeleteVariantDefinitionAction as X, UnpublishVersionAction as Xn, CollaborationCommentDocument as Xr, QueryOptions as Xt, DeleteVariantAction as Y, UnpublishVariantAction as Yn, CollaborationCommentCreate as Yr, PublishVariantAction as Yt, DiscardAction as Z, UnscheduleReleaseAction as Zn, CollaborationCommentMessage as Zr, QueryParams as Zt, ChannelErrorEvent as _, TransformTarget as _i, Requester as _n, VideoSubtitleInfoPublic as _r, InsertPatch as _t, AllDocumentsMutationOptions as a, CollaborationCommentsListenOptions as ai, ReleaseCardinality as an, VersionAction as ar, EditableReleaseDocument as at, ClientReturn$1 as b, PromptRequest as bi, ResumableListenEventNames as bn, WelcomeEvent as br, ListenOptions as bt, Any$1 as c, _listen as ci, ReleaseState as cn, VideoPlaybackInfoItemPublic as cr, ErrorProps as ct, AssetMetadataType as d, TranslateDocument as di, ReplaceVersionAction as dn, VideoPlaybackInfoSigned as dr, FirstDocumentMutationOptions as dt, CollaborationCommentReactionShortName as ei, RawQueryResponse$1 as en, UploadEvent as er, EXPERIMENTAL_API_WARNING as et, AttributeSet as f, TranslateTarget as fi, RequestHandler as fn, VideoPlaybackTokens as fr, FitMode as ft, BaseMutationOptions as g, TransformOperation as gi, RequestUrlOptions as gn, VideoSubtitleInfo as gr, InitializedClientConfig$1 as gt, BaseActionOptions as h, TransformDocument as hi, RequestOptions$1 as hn, VideoRenditionInfoSigned as hr, ImportReleaseAction as ht, AllDocumentIdsMutationOptions as i, CollaborationCommentUpdate as ii, ReleaseAction as in, VariantDefinitionAction as ir, EditVariantDefinitionAction as it, ContentSourceMapPaths as j, FieldAgentActionParam as ji, SanityUser as jn, ProjectsClient as jr, MediaLibraryPlaybackInfoOptions as jt, ContentSourceMapMapping as k, ConstantAgentActionParam as ki, SanityQueries as kn, UsersClient as kr, MediaLibraryAssetInstanceIdentifier as kt, ApiError as l, AssetsClient as li, ReleaseType as ln, VideoPlaybackInfoItemSigned as lr, FilteredResponseQueryOptions as lt, AuthProviderResponse as m, ImageDescriptionOperation as mi, RequestObservableOptions as mn, VideoRenditionInfoPublic as mr, IdentifiedSanityDocumentStub as mt, ActionError as n, CollaborationCommentStatus as ni, RawRequestOptions as nn, UploadResponseEvent as nr, EditReleaseAction as nt, AnimatedImageFormat as o, CollaborationCommentsRequestOptions as oi, ReleaseDocument as on, VideoPlaybackInfo as or, EmbeddingsSettings as ot, AuthProvider as p, TranslateTargetInclude as pi, RequestHandlerOptions as pn, VideoRenditionInfo as pr, HttpRequest as pt, DeleteAction as q, UnfilteredResponseWithoutQuery as qn, CollaborationCommentsClient as qr, PublishAction as qt, ActionErrorItem as r, CollaborationCommentTarget as ri, ReconnectEvent as rn, VariantAction as rr, EditVariantAction as rt, AnimatedTransformOptions as s, CollaborationCommentsWriteOptions as si, ReleaseId as sn, VideoPlaybackInfoItem as sr, EmbeddingsSettingsBody as st, Action as t, CollaborationCommentSelection as ti, RawQuerylessQueryResponse as tn, UploadProgressEvent as tr, EditAction as tt, ArchiveReleaseAction as u, ObservableAssetsClient as ui, ReplaceDraftAction as un, VideoPlaybackInfoPublic as ur, FirstDocumentIdMutationOptions as ut, ClientConfig$1 as v, TransformTargetDocument as vi, ResetEvent as vn, VideoSubtitleInfoSigned as vr, ListenEvent as vt, ContentSourceMapDocument as w, AgentActionParam as wi, SanityDocumentStub as wn, GenerateTargetDocument as wr, LiveEventMessage as wt, ClientVariant as x, PatchDocument as xi, ResumableListenOptions as xn, GenerateInstruction as xr, ListenParams as xt, ClientPerspective$1 as y, TransformTargetInclude as yi, ResponseQueryOptions as yn, WelcomeBackEvent as yr, ListenEventName as yt, CreateVariantDefinitionAction as z, ThumbnailTransformOptions as zn, ObservablePatchBuilder as zr, MutationOperation as zt };
-//# sourceMappingURL=types-nJhm5Nyq.d.ts.map
+export { DisconnectEvent as $, UploadClientConfig as $n, CollaborationCommentMessage as $r, QueryWithoutParams as $t, ContentSourceMapMappings as A, AgentActionTarget as Ai, SanityReference as An, ObservableProjectsClient as Ar, MediaLibraryAssetVersion as At, CreateVersionAction as B, TransactionAllDocumentIdsMutationOptions as Bn, ObservablePatchBuilder as Br, MutationSelection as Bt, ContentSourceMap$1 as C, PatchDocument as Ci, SanityDocument$1 as Cn, GenerateTarget as Cr, LiveEventGoAway as Ct, ContentSourceMapDocuments$1 as D, AgentActionParams as Di, SanityProject as Dn, SanityClient$1 as Dr, LiveEventWelcome as Dt, ContentSourceMapDocumentValueSource as E, AgentActionParam as Ei, SanityImagePalette as En, ObservableSanityClient$1 as Er, LiveEventRestart as Et, ContentSourceMapValueMapping as F, StackablePerspective as Fn, InvokeFunctionOptions as Fr, Mutation as Ft, DatasetResponse as G, UnarchiveReleaseAction as Gn, ObservablePatch as Gr, PatchOperations as Gt, DatasetAclMode as H, TransactionFirstDocumentIdMutationOptions as Hn, PatchBuilder as Hr, OpenEvent as Ht, CreateAction as I, StillImageFormat as In, InvokeFunctionRequest as Ir, MutationError as It, DeleteReleaseAction as J, UnpublishAction as Jn, CollaborationCommentsClient as Jr, PublishReleaseAction as Jt, DatasetsResponse as K, UnfilteredResponseQueryOptions as Kn, Patch as Kr, PatchSelection as Kt, CreateReleaseAction as L, StoryboardTransformOptions as Ln, DatasetsClient as Lr, MutationErrorItem as Lt, ContentSourceMapRemoteDocument as M, DocumentAgentActionParam as Mi, ScheduleReleaseAction as Mn, MediaLibraryVideoClient as Mr, MediaLibraryVideoPlaybackTransformations as Mt, ContentSourceMapSource as N, FieldAgentActionParam as Ni, SingleActionResult as Nn, ObservableMediaLibraryVideoClient as Nr, MultipleActionResult as Nt, ContentSourceMapLiteralSource as O, AgentActionPath as Oi, SanityProjectMember as On, ObservableUsersClient as Or, MediaLibraryAssetDocument as Ot, ContentSourceMapUnknownSource as P, GroqAgentActionParam as Pi, SingleMutationResult as Pn, InvokeFunctionEvent as Pr, MultipleMutationResult as Pt, DiscardVersionAction as Q, UploadBody as Qn, CollaborationCommentFieldValue as Qr, QueryParseError as Qt, CreateVariantAction as R, SyncTag as Rn, ObservableDatasetsClient as Rr, MutationEvent as Rt, ClientVariantConditions as S, PromptRequest as Si, SanityAssetDocument as Sn, GenerateOperation as Sr, LiveEvent as St, ContentSourceMapDocumentBase as T, PatchTarget as Ti, SanityImageAssetDocument as Tn, GenerateTargetInclude as Tr, LiveEventReconnect as Tt, DatasetCreateOptions as U, TransactionFirstDocumentMutationOptions as Un, Transaction as Ur, PartialExcept as Ut, CurrentSanityUser as V, TransactionAllDocumentsMutationOptions as Vn, ObservableTransaction as Vr, MutationSelectionQueryParams as Vt, DatasetEditOptions as W, TransactionMutationOptions as Wn, BasePatch as Wr, PatchMutationOperation as Wt, DeleteVariantDefinitionAction as X, UnpublishVersionAction as Xn, CollaborationCommentCreate as Xr, QueryOptions as Xt, DeleteVariantAction as Y, UnpublishVariantAction as Yn, ObservableCollaborationCommentsClient as Yr, PublishVariantAction as Yt, DiscardAction as Z, UnscheduleReleaseAction as Zn, CollaborationCommentDocument as Zr, QueryParams as Zt, ChannelErrorEvent as _, TransformDocument as _i, Requester as _n, VideoSubtitleInfoPublic as _r, InsertPatch as _t, AllDocumentsMutationOptions as a, CollaborationCommentTarget as ai, ReleaseCardinality as an, VersionAction as ar, EditableReleaseDocument as at, ClientReturn$1 as b, TransformTargetDocument as bi, ResumableListenEventNames as bn, WelcomeEvent as br, ListenOptions as bt, Any$1 as c, CollaborationCommentsRequestOptions as ci, ReleaseState as cn, VideoPlaybackInfoItemPublic as cr, ErrorProps as ct, AssetMetadataType as d, AssetsClient as di, ReplaceVersionAction as dn, VideoPlaybackInfoSigned as dr, FirstDocumentMutationOptions as dt, CollaborationCommentPortableTextBlock as ei, RawQueryResponse$1 as en, UploadEvent as er, EXPERIMENTAL_API_WARNING as et, AttributeSet as f, ObservableAssetsClient as fi, RequestHandler as fn, VideoPlaybackTokens as fr, FitMode as ft, BaseMutationOptions as g, ImageDescriptionOperation as gi, RequestUrlOptions as gn, VideoSubtitleInfo as gr, InitializedClientConfig$1 as gt, BaseActionOptions as h, TranslateTargetInclude as hi, RequestOptions$1 as hn, VideoRenditionInfoSigned as hr, ImportReleaseAction as ht, AllDocumentIdsMutationOptions as i, CollaborationCommentStatus as ii, ReleaseAction as in, VariantDefinitionAction as ir, EditVariantDefinitionAction as it, ContentSourceMapPaths as j, ConstantAgentActionParam as ji, SanityUser as jn, ProjectsClient as jr, MediaLibraryPlaybackInfoOptions as jt, ContentSourceMapMapping as k, AgentActionPathSegment as ki, SanityQueries as kn, UsersClient as kr, MediaLibraryAssetInstanceIdentifier as kt, ApiError as l, CollaborationCommentsWriteOptions as li, ReleaseType as ln, VideoPlaybackInfoItemSigned as lr, FilteredResponseQueryOptions as lt, AuthProviderResponse as m, TranslateTarget as mi, RequestObservableOptions as mn, VideoRenditionInfoPublic as mr, IdentifiedSanityDocumentStub as mt, ActionError as n, CollaborationCommentReactionShortName as ni, RawRequestOptions as nn, UploadResponseEvent as nr, EditReleaseAction as nt, AnimatedImageFormat as o, CollaborationCommentUpdate as oi, ReleaseDocument as on, VideoPlaybackInfo as or, EmbeddingsSettings as ot, AuthProvider as p, TranslateDocument as pi, RequestHandlerOptions as pn, VideoRenditionInfo as pr, HttpRequest as pt, DeleteAction as q, UnfilteredResponseWithoutQuery as qn, LiveClient as qr, PublishAction as qt, ActionErrorItem as r, CollaborationCommentSelection as ri, ReconnectEvent as rn, VariantAction as rr, EditVariantAction as rt, AnimatedTransformOptions as s, CollaborationCommentsListenOptions as si, ReleaseId as sn, VideoPlaybackInfoItem as sr, EmbeddingsSettingsBody as st, Action as t, CollaborationCommentRange as ti, RawQuerylessQueryResponse as tn, UploadProgressEvent as tr, EditAction as tt, ArchiveReleaseAction as u, _listen as ui, ReplaceDraftAction as un, VideoPlaybackInfoPublic as ur, FirstDocumentIdMutationOptions as ut, ClientConfig$1 as v, TransformOperation as vi, ResetEvent as vn, VideoSubtitleInfoSigned as vr, ListenEvent as vt, ContentSourceMapDocument as w, PatchOperation as wi, SanityDocumentStub as wn, GenerateTargetDocument as wr, LiveEventMessage as wt, ClientVariant as x, TransformTargetInclude as xi, ResumableListenOptions as xn, GenerateInstruction as xr, ListenParams as xt, ClientPerspective$1 as y, TransformTarget as yi, ResponseQueryOptions as yn, WelcomeBackEvent as yr, ListenEventName as yt, CreateVariantDefinitionAction as z, ThumbnailTransformOptions as zn, BaseTransaction as zr, MutationOperation as zt };
+//# sourceMappingURL=types-0x2hPfhJ.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanity/client",
-  "version": "8.2.0",
+  "version": "8.3.0",
   "description": "Client for retrieving, creating and patching data from Sanity.io",
   "keywords": [
     "api",
@@ -51,7 +51,6 @@
   "dependencies": {
     "eventsource": "^5.1.0",
     "get-it": "^9.5.0",
-    "nanoid": "^6.0.1",
     "obug": "^2.1.4",
     "rxjs": "^7.8.2"
   },

package/src/collaboration/types.ts

@@ -161,6 +161,18 @@ export interface CollaborationCommentRange {
   end: {_key: string; offset: number}
 }
 
+/**
+ * Portable Text covering a comment `range`. Callers can send just the blocks
+ * from the `range` start `_key` through end `_key`, or the full field.
+ *
+ * @alpha
+ */
+export type CollaborationCommentFieldValue = Array<{
+  _type: string
+  _key: string
+  [key: string]: Any
+}>
+
 /**
  * Target for a top-level comment. Inline selections require both `path` and
  * `range`; field-level comments may set `path` alone.
@@ -169,6 +181,9 @@ export interface CollaborationCommentRange {
  * `target.path.field`, and `range` is resolved against the document into
  * `target.path.selection` and `contentSnapshot` rather than being stored.
  *
+ * An optional `fieldValue` is Portable Text covering the `range`. When set,
+ * the `range` is resolved from those blocks instead of from the live document.
+ *
  * @alpha
  */
 export type CollaborationCommentTarget = {
@@ -180,11 +195,17 @@ export type CollaborationCommentTarget = {
       /** Path to the field containing the inline comment selection */
       path: string
       range: CollaborationCommentRange
+      /**
+       * Portable Text covering the `range`. When set, the `range` is resolved
+       * from these blocks instead of from the live document.
+       */
+      fieldValue?: CollaborationCommentFieldValue
     }
   | {
       /** Path to the commented field */
       path?: string
       range?: never
+      fieldValue?: never
     }
 )
 
@@ -205,6 +226,19 @@ export type CollaborationCommentTarget = {
  * })
  * ```
  *
+ * #### Inline comment
+ * ```ts
+ * await client.collaboration.comments.create({
+ *   message,
+ *   target: {
+ *     documentId: 'doc-1',
+ *     documentType: 'article',
+ *     path: 'body',
+ *     range: {start: {_key: 'block-1', offset: 0}, end: {_key: 'block-1', offset: 5}},
+ *   },
+ * })
+ * ```
+ *
  * #### Reply
  * ```ts
  * await client.collaboration.comments.create({
@@ -236,17 +270,34 @@ export type CollaborationCommentCreate = {
 /**
  * Fields that can be updated on an existing comment.
  *
+ * A `range` re-anchors the comment within the field it already targets.
+ * Pass `null` to remove the selection and leave a field-level comment.
+ * An optional `fieldValue` is Portable Text covering that `range`; when set,
+ * the `range` is resolved from those blocks instead of from the live document.
+ * `fieldValue` cannot be sent alone or together with `range: null`.
+ *
  * @alpha
  */
-export interface CollaborationCommentUpdate {
+export type CollaborationCommentUpdate = {
   /** Replaces the current message */
   message?: CollaborationCommentMessage
   /** Cascades to the comment's replies */
   status?: CollaborationCommentStatus
-  /**
-   * Re-anchors the comment within the field and source document it already
-   * targets. Pass `null` to remove the selection and leave a field-level
-   * comment.
-   */
-  range?: CollaborationCommentRange | null
-}
+} & (
+  | {
+      range: CollaborationCommentRange
+      /**
+       * Portable Text covering the `range`. When set, the `range` is resolved
+       * from these blocks instead of from the live document.
+       */
+      fieldValue?: CollaborationCommentFieldValue
+    }
+  | {
+      range: null
+      fieldValue?: never
+    }
+  | {
+      range?: undefined
+      fieldValue?: never
+    }
+)

package/src/functions/FunctionsClient.ts

@@ -2,7 +2,7 @@ import {lastValueFrom, type Observable} from 'rxjs'
 
 import type {ObservableSanityClient, SanityClient} from '../SanityClient'
 import type {HttpRequest} from '../types'
-import {_invoke, type InvokeFunctionRequest} from './invoke'
+import {_invoke, type InvokeFunctionOptions, type InvokeFunctionRequest} from './invoke'
 
 /** @public */
 export class ObservableFunctionsClient {
@@ -17,16 +17,36 @@ export class ObservableFunctionsClient {
    * Invoke a deployed function by its blueprint name.
    *
    * The name is resolved within the stack given by `stackId` on the request or
-   * the client config. Passes the function's return value once it finishes.
+   * the client config. Starts the invocation and emits `undefined` as soon as
+   * it is accepted; pass `{sync: true}` to wait for the function's return value
+   * instead.
    *
    * @param functionName - name of the function, as declared in the blueprint
    * @param request - payload and request options
+   * @param options - invocation options
    */
+  invoke(
+    functionName: string,
+    request?: InvokeFunctionRequest,
+    options?: InvokeFunctionOptions & {sync?: false},
+  ): Observable<undefined>
+  invoke<R = unknown>(
+    functionName: string,
+    request: InvokeFunctionRequest | undefined,
+    options: InvokeFunctionOptions & {sync: true},
+  ): Observable<R>
+  invoke<R = unknown>(
+    functionName: string,
+    request?: InvokeFunctionRequest,
+    options?: InvokeFunctionOptions,
+  ): Observable<R | undefined>
+  // Implementation signature — not part of the public API.
   invoke<R = unknown>(
     functionName: string,
     request?: InvokeFunctionRequest,
+    options?: InvokeFunctionOptions,
   ): Observable<R | undefined> {
-    return _invoke<R>(this.#client, this.#httpRequest, functionName, request)
+    return _invoke<R>(this.#client, this.#httpRequest, functionName, request, options)
   }
 }
 
@@ -44,23 +64,46 @@ export class FunctionsClient {
    *
    * The name is resolved within the stack given by `stackId` on the request or
    * the client config, which costs one extra request per call. Rejects if the
-   * stack has no function by that name, or if the name resolves to anything
-   * other than a `sanity.function.pubsub` function.
+   * stack has no function by that name, or if the name resolves to a function
+   * type that cannot be invoked the way it was asked for.
    *
    * The lookup is scoped to `projectId`, or to `organizationId` when one is set
    * for a stack deployed at organization scope.
    *
-   * The request stays open until the function finishes, and resolves with its
-   * return value, or `undefined` if it returns nothing. Long-running functions
-   * may need an explicit `timeout`.
+   * The invocation is started by default: the promise resolves with `undefined`
+   * as soon as the call is accepted, without waiting for the function to run.
+   * Pass `{sync: true}` to keep the request open until the function finishes
+   * and resolve with its return value — long-running functions may then need an
+   * explicit `timeout`. Only `sanity.function.pubsub` functions can be invoked
+   * synchronously.
    *
    * @param functionName - name of the function, as declared in the blueprint
    * @param request - payload and request options
+   * @param options - invocation options
    */
+  invoke(
+    functionName: string,
+    request?: InvokeFunctionRequest,
+    options?: InvokeFunctionOptions & {sync?: false},
+  ): Promise<undefined>
+  invoke<R = unknown>(
+    functionName: string,
+    request: InvokeFunctionRequest | undefined,
+    options: InvokeFunctionOptions & {sync: true},
+  ): Promise<R>
+  invoke<R = unknown>(
+    functionName: string,
+    request?: InvokeFunctionRequest,
+    options?: InvokeFunctionOptions,
+  ): Promise<R | undefined>
+  // Implementation signature — not part of the public API.
   invoke<R = unknown>(
     functionName: string,
     request?: InvokeFunctionRequest,
+    options?: InvokeFunctionOptions,
   ): Promise<R | undefined> {
-    return lastValueFrom(_invoke<R>(this.#client, this.#httpRequest, functionName, request))
+    return lastValueFrom(
+      _invoke<R>(this.#client, this.#httpRequest, functionName, request, options),
+    )
   }
 }

package/src/functions/invoke.ts

@@ -6,7 +6,15 @@ import type {HttpRequest, InitializedClientConfig} from '../types'
 
 /** Function resource types in a blueprint are namespaced under this prefix. */
 const FUNCTION_RESOURCE_PREFIX = 'sanity.function.'
-const INVOKABLE_FUNCTION_TYPE = 'sanity.function.pubsub'
+const SYNC_INVOCABLE_FUNCTION_TYPES = ['sanity.function.pubsub']
+const ASYNC_INVOCABLE_FUNCTION_TYPES = [
+  'sanity.function.durable',
+  'sanity.function.pubsub',
+  'sanity.function.queue',
+]
+const INVOCABLE_FUNCTION_TYPES = [
+  ...new Set([...SYNC_INVOCABLE_FUNCTION_TYPES, ...ASYNC_INVOCABLE_FUNCTION_TYPES]),
+]
 
 /** @public */
 export interface InvokeFunctionEvent {
@@ -37,6 +45,18 @@ export interface InvokeFunctionRequest {
   signal?: AbortSignal
 }
 
+/** @public */
+export interface InvokeFunctionOptions {
+  /**
+   * Wait for the function to finish and resolve with its return value.
+   *
+   * Defaults to `false`: the invocation is started, the request resolves as soon
+   * as it is accepted, and the value is always `undefined`. Only function types
+   * that support running inline can be invoked synchronously.
+   */
+  sync?: boolean
+}
+
 /**
  * Subset of a stack resource the client needs in order to resolve a name.
  *
@@ -109,6 +129,7 @@ function _resolveFunctionId(
   stackId: string,
   headers: Record<string, string>,
   request: InvokeFunctionRequest | undefined,
+  sync: boolean,
 ): Observable<string> {
   return _requestObservable<{resources?: StackResource[]}>(client, httpRequest, {
     method: 'GET',
@@ -132,9 +153,15 @@ function _resolveFunctionId(
         )
       }
 
-      if (match.type !== INVOKABLE_FUNCTION_TYPE) {
+      if (!INVOCABLE_FUNCTION_TYPES.includes(match.type)) {
         throw new Error(`Function invocation is not supported for ${match.type}`)
       }
+      if (sync && !SYNC_INVOCABLE_FUNCTION_TYPES.includes(match.type)) {
+        throw new Error(`Synchronous function invocation is not supported for ${match.type}`)
+      }
+      if (!sync && !ASYNC_INVOCABLE_FUNCTION_TYPES.includes(match.type)) {
+        throw new Error(`Asynchronous function invocation is not supported for ${match.type}`)
+      }
 
       return match.externalId
     }),
@@ -147,6 +174,7 @@ export function _invoke<R = unknown>(
   httpRequest: HttpRequest,
   functionName: string,
   request?: InvokeFunctionRequest,
+  options?: InvokeFunctionOptions,
 ): Observable<R | undefined> {
   // Deferred so a bad config surfaces as an error on the returned observable
   // (and so a rejected promise) rather than throwing at the call site.
@@ -154,17 +182,30 @@ export function _invoke<R = unknown>(
     const config = client.config()
     const headers = scopeHeaders(config, request)
     const stackId = resolveStackId(config, request)
-
-    return _resolveFunctionId(client, httpRequest, functionName, stackId, headers, request).pipe(
-      // A function that returns nothing answers 204, which the transport parses
+    const sync = options?.sync ?? false
+
+    return _resolveFunctionId(
+      client,
+      httpRequest,
+      functionName,
+      stackId,
+      headers,
+      request,
+      sync,
+    ).pipe(
+      // An async invocation is only acknowledged (202, no body), and a sync
+      // function that returns nothing answers 204, which the transport parses
       // to an `undefined` body. The status code is not observable from here —
       // the `HttpRequest` boundary resolves to the body alone — so an empty
       // response and a function that returned nothing both surface as
       // `undefined`.
+      //
+      // The route is async by default, so `sync=false` is left off the wire
+      // rather than spelled out.
       mergeMap((functionId) =>
         _requestObservable<R | undefined>(client, httpRequest, {
           method: 'POST',
-          url: `/functions/${functionId}/invoke`,
+          url: `/functions/${functionId}/invoke${sync ? '?sync=true' : ''}`,
           headers,
           body: {event: {data: request?.event?.data ?? {}}},
           timeout: request?.timeout,

package/src/types.ts

@@ -2297,7 +2297,11 @@ export type {
   TranslateTarget,
   TranslateTargetInclude,
 } from './agent/actions/translate'
-export type {InvokeFunctionEvent, InvokeFunctionRequest} from './functions/invoke'
+export type {
+  InvokeFunctionEvent,
+  InvokeFunctionOptions,
+  InvokeFunctionRequest,
+} from './functions/invoke'
 export type {
   CollaborationCommentCreate,
   CollaborationCommentDocument,
@@ -2312,6 +2316,7 @@ export type {
   CollaborationCommentTarget,
   CollaborationCommentUpdate,
   CollaborationCommentRange,
+  CollaborationCommentFieldValue,
 } from './collaboration/types'
 export type {
   ContentSourceMapParsedPath,

package/src/util/createVersionId.ts

@@ -5,20 +5,30 @@ import {
   isDraftId,
   isVersionId,
 } from '@sanity/client/csm'
-import {customAlphabet} from 'nanoid'
 
 import type {IdentifiedSanityDocumentStub, SanityDocumentStub} from '../types'
 import {validateVersionIdMatch} from '../validators'
 
+const alphabet = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789'
+
 /**
  * @internal
  *
  * ~24 years (or 7.54e+8 seconds) needed, in order to have a 1% probability of at least one collision if 10 ID's are generated every hour.
  */
-export const generateReleaseId = customAlphabet(
-  'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789',
-  8,
-)
+export function generateReleaseId() {
+  let id = ''
+
+  while (id.length < 8) {
+    const bytes = crypto.getRandomValues(new Uint8Array(8 - id.length))
+    for (const byte of bytes) {
+      const index = byte & 63
+      if (index < alphabet.length) id += alphabet[index]
+    }
+  }
+
+  return id
+}
 
 /** @internal */
 export const getDocumentVersionId = (publishedId: string, releaseId?: string) =>