@sanity/client 8.2.0 → 8.3.0

package/dist/index.node.d.ts

@@ -1369,6 +1369,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;
+}>;
 /**
  * Target for a top-level comment. Inline selections require both `path` and
  * `range`; field-level comments may set `path` alone.
@@ -1377,6 +1388,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 = {
@@ -1387,10 +1401,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`.
@@ -1409,6 +1429,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({
@@ -1436,20 +1469,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.
  *
@@ -2175,6 +2221,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, httpRequest: HttpRequest);
@@ -2182,12 +2239,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 {
@@ -2198,20 +2264,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 {
@@ -6646,5 +6722,5 @@ declare const createClient: (config: ClientConfig) => SanityClient;
  * @deprecated Use the named export `createClient` instead of the `default` export
  */
 declare const deprecatedCreateClient: (config: ClientConfig) => SanityClient;
-export { Action, ActionError, ActionErrorItem, type AgentActionParam, type AgentActionParams, type AgentActionPath, type AgentActionPathSegment, type AgentActionTarget, AllDocumentIdsMutationOptions, AllDocumentsMutationOptions, AnimatedImageFormat, AnimatedTransformOptions, Any, ApiError, ArchiveReleaseAction, AssetMetadataType, type AssetsClient, AttributeSet, AuthProvider, AuthProviderResponse, BaseActionOptions, BaseMutationOptions, BasePatch, BaseTransaction, ChannelError, ChannelErrorEvent, ClientConfig, ClientError, ClientPerspective, ClientReturn, ClientVariant, ClientVariantConditions, type CollaborationCommentCreate, type CollaborationCommentDocument, type CollaborationCommentMessage, type CollaborationCommentPortableTextBlock, type CollaborationCommentRange, type CollaborationCommentReactionShortName, type CollaborationCommentSelection, type CollaborationCommentStatus, type CollaborationCommentTarget, type CollaborationCommentUpdate, type CollaborationCommentsClient, type CollaborationCommentsListenOptions, type CollaborationCommentsRequestOptions, type CollaborationCommentsWriteOptions, ConnectionFailedError, type ConstantAgentActionParam, ContentSourceMap, ContentSourceMapDocument, ContentSourceMapDocumentBase, ContentSourceMapDocumentValueSource, ContentSourceMapDocuments, ContentSourceMapLiteralSource, ContentSourceMapMapping, ContentSourceMapMappings, type ContentSourceMapParsedPath, type ContentSourceMapParsedPathKeyedSegment, ContentSourceMapPaths, ContentSourceMapRemoteDocument, ContentSourceMapSource, ContentSourceMapUnknownSource, ContentSourceMapValueMapping, CorsOriginError, CreateAction, CreateReleaseAction, CreateVariantAction, CreateVariantDefinitionAction, CreateVersionAction, CurrentSanityUser, DatasetAclMode, DatasetCreateOptions, DatasetEditOptions, DatasetResponse, type DatasetsClient, DatasetsResponse, DeleteAction, DeleteReleaseAction, DeleteVariantAction, DeleteVariantDefinitionAction, DiscardAction, DiscardVersionAction, DisconnectError, DisconnectEvent, type DocumentAgentActionParam, EXPERIMENTAL_API_WARNING, EditAction, EditReleaseAction, EditVariantAction, EditVariantDefinitionAction, EditableReleaseDocument, EmbeddingsSettings, EmbeddingsSettingsBody, ErrorProps, type EventSourceEvent, type EventSourceInstance, type FieldAgentActionParam, type FilterDefault, FilteredResponseQueryOptions, FirstDocumentIdMutationOptions, FirstDocumentMutationOptions, FitMode, type GenerateInstruction, type GenerateOperation, type GenerateTarget, type GenerateTargetDocument, type GenerateTargetInclude, type GroqAgentActionParam, type HttpError, HttpRequest, IdentifiedSanityDocumentStub, type ImageDescriptionOperation, ImportReleaseAction, InitializedClientConfig, type InitializedStegaConfig, InsertPatch, type InvokeFunctionEvent, type InvokeFunctionRequest, ListenEvent, ListenEventName, ListenOptions, ListenParams, type LiveClient, LiveEvent, LiveEventGoAway, LiveEventMessage, LiveEventReconnect, LiveEventRestart, LiveEventWelcome, type Logger, MediaLibraryAssetDocument, MediaLibraryAssetInstanceIdentifier, MediaLibraryAssetVersion, MediaLibraryPlaybackInfoOptions, type MediaLibraryVideoClient, MediaLibraryVideoPlaybackTransformations, MessageError, MessageParseError, MultipleActionResult, MultipleMutationResult, Mutation, MutationError, MutationErrorItem, MutationEvent, MutationOperation, MutationSelection, MutationSelectionQueryParams, type ObservableAssetsClient, type ObservableCollaborationCommentsClient, type ObservableDatasetsClient, type ObservableMediaLibraryVideoClient, ObservablePatch, ObservablePatchBuilder, type ObservableProjectsClient, ObservableSanityClient, ObservableTransaction, type ObservableUsersClient, OpenEvent, PartialExcept, Patch, PatchBuilder, type PatchDocument, PatchMutationOperation, type PatchOperation, PatchOperations, PatchSelection, type PatchTarget, type ProjectsClient, type PromptRequest, PublishAction, PublishReleaseAction, PublishVariantAction, QueryOptions, QueryParams, QueryParseError, QueryWithoutParams, RawQueryResponse, RawQuerylessQueryResponse, RawRequestOptions, ReconnectEvent, ReleaseAction, ReleaseCardinality, ReleaseDocument, ReleaseId, ReleaseState, ReleaseType, ReplaceDraftAction, ReplaceVersionAction, RequestHandler, RequestHandlerOptions, RequestObservableOptions, RequestOptions, RequestUrlOptions, Requester, ResetEvent, type ResolveStudioUrl, ResponseQueryOptions, ResumableListenEventNames, ResumableListenOptions, SanityAssetDocument, SanityClient, SanityDocument, SanityDocumentStub, SanityImageAssetDocument, SanityImagePalette, SanityProject, SanityProjectMember, SanityQueries, SanityReference, SanityUser, ScheduleReleaseAction, ServerError, type ServerSentEvent, SingleActionResult, SingleMutationResult, StackablePerspective, type StegaConfig, type StegaConfigRequiredKeys, StillImageFormat, StoryboardTransformOptions, type StudioBaseRoute, type StudioBaseUrl, type StudioUrl, SyncTag, ThumbnailTransformOptions, type TimeoutErrorLike, Transaction, TransactionAllDocumentIdsMutationOptions, TransactionAllDocumentsMutationOptions, TransactionFirstDocumentIdMutationOptions, TransactionFirstDocumentMutationOptions, TransactionMutationOptions, type TransformDocument, type TransformOperation, type TransformTarget, type TransformTargetDocument, type TransformTargetInclude, type TranslateDocument, type TranslateTarget, type TranslateTargetInclude, UnarchiveReleaseAction, UnfilteredResponseQueryOptions, UnfilteredResponseWithoutQuery, UnpublishAction, UnpublishVariantAction, UnpublishVersionAction, UnscheduleReleaseAction, UploadBody, UploadClientConfig, UploadEvent, UploadProgressEvent, UploadResponseEvent, type UsersClient, VariantAction, VariantDefinitionAction, VersionAction, VideoPlaybackInfo, VideoPlaybackInfoItem, VideoPlaybackInfoItemPublic, VideoPlaybackInfoItemSigned, VideoPlaybackInfoPublic, VideoPlaybackInfoSigned, VideoPlaybackTokens, VideoRenditionInfo, VideoRenditionInfoPublic, VideoRenditionInfoSigned, VideoSubtitleInfo, VideoSubtitleInfoPublic, VideoSubtitleInfoSigned, WelcomeBackEvent, WelcomeEvent, type _listen, connectEventSource, createClient, deprecatedCreateClient as default, formatQueryParseError, isHttpError, isQueryParseError, isTimeoutError, requester, validateApiPerspective };
+export { Action, ActionError, ActionErrorItem, type AgentActionParam, type AgentActionParams, type AgentActionPath, type AgentActionPathSegment, type AgentActionTarget, AllDocumentIdsMutationOptions, AllDocumentsMutationOptions, AnimatedImageFormat, AnimatedTransformOptions, Any, ApiError, ArchiveReleaseAction, AssetMetadataType, type AssetsClient, AttributeSet, AuthProvider, AuthProviderResponse, BaseActionOptions, BaseMutationOptions, BasePatch, BaseTransaction, ChannelError, ChannelErrorEvent, ClientConfig, ClientError, ClientPerspective, ClientReturn, ClientVariant, ClientVariantConditions, type CollaborationCommentCreate, type CollaborationCommentDocument, type CollaborationCommentFieldValue, type CollaborationCommentMessage, type CollaborationCommentPortableTextBlock, type CollaborationCommentRange, type CollaborationCommentReactionShortName, type CollaborationCommentSelection, type CollaborationCommentStatus, type CollaborationCommentTarget, type CollaborationCommentUpdate, type CollaborationCommentsClient, type CollaborationCommentsListenOptions, type CollaborationCommentsRequestOptions, type CollaborationCommentsWriteOptions, ConnectionFailedError, type ConstantAgentActionParam, ContentSourceMap, ContentSourceMapDocument, ContentSourceMapDocumentBase, ContentSourceMapDocumentValueSource, ContentSourceMapDocuments, ContentSourceMapLiteralSource, ContentSourceMapMapping, ContentSourceMapMappings, type ContentSourceMapParsedPath, type ContentSourceMapParsedPathKeyedSegment, ContentSourceMapPaths, ContentSourceMapRemoteDocument, ContentSourceMapSource, ContentSourceMapUnknownSource, ContentSourceMapValueMapping, CorsOriginError, CreateAction, CreateReleaseAction, CreateVariantAction, CreateVariantDefinitionAction, CreateVersionAction, CurrentSanityUser, DatasetAclMode, DatasetCreateOptions, DatasetEditOptions, DatasetResponse, type DatasetsClient, DatasetsResponse, DeleteAction, DeleteReleaseAction, DeleteVariantAction, DeleteVariantDefinitionAction, DiscardAction, DiscardVersionAction, DisconnectError, DisconnectEvent, type DocumentAgentActionParam, EXPERIMENTAL_API_WARNING, EditAction, EditReleaseAction, EditVariantAction, EditVariantDefinitionAction, EditableReleaseDocument, EmbeddingsSettings, EmbeddingsSettingsBody, ErrorProps, type EventSourceEvent, type EventSourceInstance, type FieldAgentActionParam, type FilterDefault, FilteredResponseQueryOptions, FirstDocumentIdMutationOptions, FirstDocumentMutationOptions, FitMode, type GenerateInstruction, type GenerateOperation, type GenerateTarget, type GenerateTargetDocument, type GenerateTargetInclude, type GroqAgentActionParam, type HttpError, HttpRequest, IdentifiedSanityDocumentStub, type ImageDescriptionOperation, ImportReleaseAction, InitializedClientConfig, type InitializedStegaConfig, InsertPatch, type InvokeFunctionEvent, type InvokeFunctionOptions, type InvokeFunctionRequest, ListenEvent, ListenEventName, ListenOptions, ListenParams, type LiveClient, LiveEvent, LiveEventGoAway, LiveEventMessage, LiveEventReconnect, LiveEventRestart, LiveEventWelcome, type Logger, MediaLibraryAssetDocument, MediaLibraryAssetInstanceIdentifier, MediaLibraryAssetVersion, MediaLibraryPlaybackInfoOptions, type MediaLibraryVideoClient, MediaLibraryVideoPlaybackTransformations, MessageError, MessageParseError, MultipleActionResult, MultipleMutationResult, Mutation, MutationError, MutationErrorItem, MutationEvent, MutationOperation, MutationSelection, MutationSelectionQueryParams, type ObservableAssetsClient, type ObservableCollaborationCommentsClient, type ObservableDatasetsClient, type ObservableMediaLibraryVideoClient, ObservablePatch, ObservablePatchBuilder, type ObservableProjectsClient, ObservableSanityClient, ObservableTransaction, type ObservableUsersClient, OpenEvent, PartialExcept, Patch, PatchBuilder, type PatchDocument, PatchMutationOperation, type PatchOperation, PatchOperations, PatchSelection, type PatchTarget, type ProjectsClient, type PromptRequest, PublishAction, PublishReleaseAction, PublishVariantAction, QueryOptions, QueryParams, QueryParseError, QueryWithoutParams, RawQueryResponse, RawQuerylessQueryResponse, RawRequestOptions, ReconnectEvent, ReleaseAction, ReleaseCardinality, ReleaseDocument, ReleaseId, ReleaseState, ReleaseType, ReplaceDraftAction, ReplaceVersionAction, RequestHandler, RequestHandlerOptions, RequestObservableOptions, RequestOptions, RequestUrlOptions, Requester, ResetEvent, type ResolveStudioUrl, ResponseQueryOptions, ResumableListenEventNames, ResumableListenOptions, SanityAssetDocument, SanityClient, SanityDocument, SanityDocumentStub, SanityImageAssetDocument, SanityImagePalette, SanityProject, SanityProjectMember, SanityQueries, SanityReference, SanityUser, ScheduleReleaseAction, ServerError, type ServerSentEvent, SingleActionResult, SingleMutationResult, StackablePerspective, type StegaConfig, type StegaConfigRequiredKeys, StillImageFormat, StoryboardTransformOptions, type StudioBaseRoute, type StudioBaseUrl, type StudioUrl, SyncTag, ThumbnailTransformOptions, type TimeoutErrorLike, Transaction, TransactionAllDocumentIdsMutationOptions, TransactionAllDocumentsMutationOptions, TransactionFirstDocumentIdMutationOptions, TransactionFirstDocumentMutationOptions, TransactionMutationOptions, type TransformDocument, type TransformOperation, type TransformTarget, type TransformTargetDocument, type TransformTargetInclude, type TranslateDocument, type TranslateTarget, type TranslateTargetInclude, UnarchiveReleaseAction, UnfilteredResponseQueryOptions, UnfilteredResponseWithoutQuery, UnpublishAction, UnpublishVariantAction, UnpublishVersionAction, UnscheduleReleaseAction, UploadBody, UploadClientConfig, UploadEvent, UploadProgressEvent, UploadResponseEvent, type UsersClient, VariantAction, VariantDefinitionAction, VersionAction, VideoPlaybackInfo, VideoPlaybackInfoItem, VideoPlaybackInfoItemPublic, VideoPlaybackInfoItemSigned, VideoPlaybackInfoPublic, VideoPlaybackInfoSigned, VideoPlaybackTokens, VideoRenditionInfo, VideoRenditionInfoPublic, VideoRenditionInfoSigned, VideoSubtitleInfo, VideoSubtitleInfoPublic, VideoSubtitleInfoSigned, WelcomeBackEvent, WelcomeEvent, type _listen, connectEventSource, createClient, deprecatedCreateClient as default, formatQueryParseError, isHttpError, isQueryParseError, isTimeoutError, requester, validateApiPerspective };
 //# sourceMappingURL=index.node.d.ts.map

package/dist/index.node.js

@@ -7,7 +7,6 @@ import { Observable, catchError, concat, defer, finalize, isObservable, lastValu
 import { getDraftId, getPublishedId, getVersionFromId, getVersionId, isDraftId, isVersionId } from "@sanity/client/csm";
 import { filter, finalize as finalize$1, map as map$1, mergeAll } from "rxjs/operators";
 import { EventSource } from "eventsource";
-import { customAlphabet } from "nanoid";
 import { Readable } from "node:stream";
 import { createNodeFetch } from "get-it/node";
 import { createDebug } from "obug";
@@ -2293,7 +2292,11 @@ function _modify(client, httpRequest, method, name, options) {
 	});
 }
 /** Function resource types in a blueprint are namespaced under this prefix. */
-const scopeHeaders = (config, request) => {
+const SYNC_INVOCABLE_FUNCTION_TYPES = ["sanity.function.pubsub"], ASYNC_INVOCABLE_FUNCTION_TYPES = [
+	"sanity.function.durable",
+	"sanity.function.pubsub",
+	"sanity.function.queue"
+], INVOCABLE_FUNCTION_TYPES = [.../* @__PURE__ */ new Set([...SYNC_INVOCABLE_FUNCTION_TYPES, ...ASYNC_INVOCABLE_FUNCTION_TYPES])], scopeHeaders = (config, request) => {
 	let organizationId = request?.organizationId || config.organizationId;
 	if (organizationId) return {
 		"X-Sanity-Scope-Type": "organization",
@@ -2317,7 +2320,7 @@ const scopeHeaders = (config, request) => {
 *
 * @internal
 */
-function _resolveFunctionId(client, httpRequest, functionName, stackId, headers, request) {
+function _resolveFunctionId(client, httpRequest, functionName, stackId, headers, request, sync) {
 	return _requestObservable(client, httpRequest, {
 		method: "GET",
 		url: `/blueprints/stacks/${stackId}`,
@@ -2327,17 +2330,19 @@ function _resolveFunctionId(client, httpRequest, functionName, stackId, headers,
 		let match = (stack?.resources || []).find((resource) => resource.type?.startsWith("sanity.function.") && resource.name === functionName);
 		if (!match) throw Error(`Function "${functionName}" not found in stack "${stackId}"`);
 		if (!match.externalId) throw Error(`Function "${functionName}" is declared in stack "${stackId}" but is not deployed`);
-		if (match.type !== "sanity.function.pubsub") throw Error(`Function invocation is not supported for ${match.type}`);
+		if (!INVOCABLE_FUNCTION_TYPES.includes(match.type)) throw Error(`Function invocation is not supported for ${match.type}`);
+		if (sync && !SYNC_INVOCABLE_FUNCTION_TYPES.includes(match.type)) throw Error(`Synchronous function invocation is not supported for ${match.type}`);
+		if (!sync && !ASYNC_INVOCABLE_FUNCTION_TYPES.includes(match.type)) throw Error(`Asynchronous function invocation is not supported for ${match.type}`);
 		return match.externalId;
 	}));
 }
 /** @internal */
-function _invoke(client, httpRequest, functionName, request) {
+function _invoke(client, httpRequest, functionName, request, options) {
 	return defer(() => {
-		let config = client.config(), headers = scopeHeaders(config, request);
-		return _resolveFunctionId(client, httpRequest, functionName, resolveStackId(config, request), headers, request).pipe(mergeMap((functionId) => _requestObservable(client, httpRequest, {
+		let config = client.config(), headers = scopeHeaders(config, request), stackId = resolveStackId(config, request), sync = options?.sync ?? !1;
+		return _resolveFunctionId(client, httpRequest, functionName, stackId, headers, request, sync).pipe(mergeMap((functionId) => _requestObservable(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,
@@ -2352,17 +2357,8 @@ var ObservableFunctionsClient = class {
 	constructor(client, httpRequest) {
 		this.#client = client, this.#httpRequest = httpRequest;
 	}
-	/**
-	* 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.
-	*
-	* @param functionName - name of the function, as declared in the blueprint
-	* @param request - payload and request options
-	*/
-	invoke(functionName, request) {
-		return _invoke(this.#client, this.#httpRequest, functionName, request);
+	invoke(functionName, request, options) {
+		return _invoke(this.#client, this.#httpRequest, functionName, request, options);
 	}
 }, FunctionsClient = class {
 	#client;
@@ -2370,26 +2366,8 @@ var ObservableFunctionsClient = class {
 	constructor(client, httpRequest) {
 		this.#client = client, this.#httpRequest = httpRequest;
 	}
-	/**
-	* 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, 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.
-	*
-	* 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`.
-	*
-	* @param functionName - name of the function, as declared in the blueprint
-	* @param request - payload and request options
-	*/
-	invoke(functionName, request) {
-		return lastValueFrom(_invoke(this.#client, this.#httpRequest, functionName, request));
+	invoke(functionName, request, options) {
+		return lastValueFrom(_invoke(this.#client, this.#httpRequest, functionName, request, options));
 	}
 }, ObservableMediaLibraryVideoClient = class {
 	#client;
@@ -2537,7 +2515,19 @@ var ObservableProjectsClient = class {
 *
 * ~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.
 */
-const generateReleaseId = customAlphabet("abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789", 8), getDocumentVersionId = (publishedId, releaseId) => releaseId ? getVersionId(publishedId, releaseId) : getDraftId(publishedId);
+function generateReleaseId() {
+	let id = "";
+	for (; id.length < 8;) {
+		let bytes = crypto.getRandomValues(new Uint8Array(8 - id.length));
+		for (let byte of bytes) {
+			let index = byte & 63;
+			index < 62 && (id += "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"[index]);
+		}
+	}
+	return id;
+}
+/** @internal */
+const getDocumentVersionId = (publishedId, releaseId) => releaseId ? getVersionId(publishedId, releaseId) : getDraftId(publishedId);
 /** @internal */
 function deriveDocumentVersionId(op, { releaseId, publishedId, document }) {
 	if (publishedId && document._id) {
@@ -3562,7 +3552,7 @@ function defineDeprecatedCreateClient(createClient) {
 		return printNoDefaultExport(), createClient(config);
 	};
 }
-var name = "@sanity/client", version = "8.2.0";
+var name = "@sanity/client", version = "8.3.0";
 const log = createDebug("sanity:client");
 function isNodeReadableStream(value) {
 	return typeof value != "object" || !value || !("pipe" in value) ? !1 : typeof value.pipe == "function";