@sanity/client 8.0.0 → 8.2.0

package/dist/index.node.js

@@ -1,5 +1,7 @@
 import { t as require_dist } from "./dist-C9ExSk2R.js";
-import { a as ServerError, c as isHttpError, i as CorsOriginError, l as isQueryParseError, o as formatQueryParseError, r as ClientError, t as defineRequester } from "./request-k7VS_NnC.js";
+import { a as ServerError, c as isHttpError, i as CorsOriginError, l as isQueryParseError, o as formatQueryParseError, r as ClientError, t as defineRequester } from "./request-SnMg7nUX.js";
+import { t as isRecord } from "./isRecord-Kfmt-nk-.js";
+import { isTimeoutError } from "get-it";
 import { debug } from "get-it/middleware";
 import { Observable, catchError, concat, defer, finalize, isObservable, lastValueFrom, map, merge, mergeMap, of, share, tap, throwError, timer } from "rxjs";
 import { getDraftId, getPublishedId, getVersionFromId, getVersionId, isDraftId, isVersionId } from "@sanity/client/csm";
@@ -80,7 +82,7 @@ const createWarningPrinter = (message) => once((...args) => console.warn(message
 	"Since you haven't set a value for `useCdn`, we will deliver content using our",
 	"global, edge-cached API-CDN. If you wish to have content delivered faster, set",
 	"`useCdn: false` to use the Live API. Note: You may incur higher costs using the live API."
-]), printCdnPreviewDraftsWarning = createWarningPrinter(["The Sanity client is configured with the `perspective` set to `drafts` or `previewDrafts`, which doesn't support the API-CDN.", "The Live API will be used instead. Set `useCdn: false` in your configuration to hide this warning."]), printPreviewDraftsDeprecationWarning = createWarningPrinter(["The `previewDrafts` perspective has been renamed to  `drafts` and will be removed in a future API version"]), printBrowserTokenWarning = createWarningPrinter(["You have configured Sanity client to use a token in the browser. This may cause unintentional security issues.", `See ${generateHelpUrl("js-client-browser-token")} for more information and how to hide this warning.`]), printCredentialedTokenWarning = createWarningPrinter(["You have configured Sanity client to use a token, but also provided `withCredentials: true`.", "This is no longer supported - only token will be used - remove `withCredentials: true`."]), printNoApiVersionSpecifiedWarning = createWarningPrinter(["Using the Sanity client without specifying an API version is deprecated.", `See ${generateHelpUrl("js-client-api-version")}`]), printNoDefaultExport = createWarningPrinter(["The default export of @sanity/client has been deprecated. Use the named export `createClient` instead."]), printCreateVersionWithBaseIdWarning = createWarningPrinter(["You have called `createVersion()` with a defined `document`. The recommended approach is to provide a `baseId` and `releaseId` instead."]), printDeprecatedUriOptionWarning = createWarningPrinter(["The `uri` request option has been renamed to `url`.", "Please update your code to use `url` instead. Support for `uri` will be removed in a future version."]), printDeprecatedResourceConfigWarning = createWarningPrinter(["The `~experimental_resource` configuration property has been renamed to `resource`.", "Please update your client configuration to use `resource` instead. Support for `~experimental_resource` will be removed in a future version."]), defaultConfig = {
+]), printCdnPreviewDraftsWarning = createWarningPrinter(["The Sanity client is configured with the `perspective` set to `drafts` or `previewDrafts`, which doesn't support the API-CDN.", "The Live API will be used instead. Set `useCdn: false` in your configuration to hide this warning."]), printPreviewDraftsDeprecationWarning = createWarningPrinter(["The `previewDrafts` perspective has been renamed to  `drafts` and will be removed in a future API version"]), printBrowserTokenWarning = createWarningPrinter(["You have configured Sanity client to use a token in the browser. This may cause unintentional security issues.", `See ${generateHelpUrl("js-client-browser-token")} for more information and how to hide this warning.`]), printCredentialedTokenWarning = createWarningPrinter(["You have configured Sanity client to use a token, but also provided `withCredentials: true`.", "This is no longer supported - only token will be used - remove `withCredentials: true`."]), printNoApiVersionSpecifiedWarning = createWarningPrinter(["Using the Sanity client without specifying an API version is deprecated.", `See ${generateHelpUrl("js-client-api-version")}`]), printNoDefaultExport = createWarningPrinter(["The default export of @sanity/client has been deprecated. Use the named export `createClient` instead."]), printCreateVersionWithBaseIdWarning = createWarningPrinter(["You have called `createVersion()` with a defined `document`.", "If you are creating a version of a document that already exists, prefer providing `baseId` and `releaseId` instead."]), printDeprecatedUriOptionWarning = createWarningPrinter(["The `uri` request option has been renamed to `url`.", "Please update your code to use `url` instead. Support for `uri` will be removed in a future version."]), printDeprecatedResourceConfigWarning = createWarningPrinter(["The `~experimental_resource` configuration property has been renamed to `resource`.", "Please update your client configuration to use `resource` instead. Support for `~experimental_resource` will be removed in a future version."]), defaultConfig = {
 	apiHost: "https://api.sanity.io",
 	apiVersion: "1",
 	useProjectHostname: !0,
@@ -133,11 +135,12 @@ const initConfig = (config, prevConfig) => {
 	return projectBased ? (newConfig.url = `${protocol}://${newConfig.projectId}.${host}/v${newConfig.apiVersion}`, newConfig.cdnUrl = `${protocol}://${newConfig.projectId}.${cdnHost}/v${newConfig.apiVersion}`) : (newConfig.url = `${newConfig.apiHost}/v${newConfig.apiVersion}`, newConfig.cdnUrl = newConfig.url), newConfig;
 };
 /**
-* @public
 * Thrown when the EventSource connection could not be established, or was rejected by the server.
 * Transient failures (network drops, 5xx, 408, 429) are reconnected internally and emitted as
 * `reconnect` events; a permanent rejection (any other 4xx, eg an expired token) errors the
 * stream with this class so consumers can react — check `status` for the rejection code.
+*
+* @public
 */
 var ConnectionFailedError = class extends Error {
 	name = "ConnectionFailedError";
@@ -208,26 +211,30 @@ function connectEventSource(initEventSource, events) {
 */
 function connectWithESInstance(es, events) {
 	return new Observable((observer) => {
-		let emitOpen = events.includes("open"), emitReconnect = events.includes("reconnect");
+		let requestedEvents = new Set(events), isRequestedEvent = (type) => requestedEvents.has(type), emitOpen = isRequestedEvent("open");
 		function onError(evt) {
 			if ("data" in evt) {
 				let [parseError, event] = parseEvent(evt);
-				observer.error(parseError ? new MessageParseError("Unable to parse EventSource error message", { cause: parseError }) : new MessageError(event.data.message, event));
+				observer.error(parseError || !event ? new MessageParseError("Unable to parse EventSource error message", { cause: parseError }) : new MessageError(isRecord(event.data) && typeof event.data.message == "string" ? event.data.message : "", event));
 				return;
 			}
-			let rawStatus = evt.code, status = typeof rawStatus == "number" ? rawStatus : void 0;
-			if (status !== void 0) {
-				observer.error(new ConnectionFailedError("EventSource connection failed", { status }));
+			if (evt.code !== void 0) {
+				observer.error(new ConnectionFailedError("EventSource connection failed", { status: evt.code }));
 				return;
 			}
-			es.readyState === es.CLOSED ? observer.error(new ConnectionFailedError("EventSource connection failed")) : emitReconnect && observer.next({ type: "reconnect" });
+			if (es.readyState === es.CLOSED) observer.error(new ConnectionFailedError("EventSource connection failed"));
+			else {
+				let type = "reconnect";
+				isRequestedEvent(type) && observer.next({ type });
+			}
 		}
 		function onOpen() {
-			observer.next({ type: "open" });
+			let type = "open";
+			isRequestedEvent(type) && observer.next({ type });
 		}
 		function onMessage(message) {
 			let [parseError, event] = parseEvent(message);
-			if (parseError) {
+			if (parseError || !event) {
 				observer.error(new MessageParseError("Unable to parse EventSource message", { cause: parseError }));
 				return;
 			}
@@ -237,10 +244,10 @@ function connectWithESInstance(es, events) {
 				return;
 			}
 			if (message.type === "disconnect") {
-				observer.error(new DisconnectError(`Server disconnected client: ${event.data?.reason || "unknown error"}`));
+				observer.error(new DisconnectError(`Server disconnected client: ${isRecord(event.data) && typeof event.data.reason == "string" && event.data.reason || "unknown error"}`));
 				return;
 			}
-			observer.next({
+			isRequestedEvent(message.type) && observer.next({
 				type: message.type,
 				id: message.lastEventId,
 				...event.data ? { data: event.data } : {}
@@ -266,8 +273,16 @@ function parseEvent(message) {
 	}
 }
 function extractErrorMessage(err, tag) {
-	let error = err.error;
-	return error ? isQueryParseError(error) ? formatQueryParseError(error, tag) : error.description ? error.description : typeof error == "string" ? error : JSON.stringify(error, null, 2) : err.message || "Unknown listener error";
+	let error = isRecord(err) ? err.error : void 0;
+	if (!error) {
+		let message = isRecord(err) ? err.message : void 0;
+		return typeof message == "string" && message || "Unknown listener error";
+	}
+	if (isRecord(error)) {
+		if (isQueryParseError(error)) return formatQueryParseError(error, tag);
+		if (typeof error.description == "string") return error.description;
+	}
+	return typeof error == "string" ? error : JSON.stringify(error, null, 2);
 }
 function isEmptyObject(data) {
 	for (let _ in data) return !1;
@@ -711,7 +726,7 @@ function _fetchRequest(_stega, _params, options) {
 }
 /** @internal */
 function _fetchObservable(client, httpRequest, _stega, query, _params = {}, options = {}) {
-	return _observe(options.signal, (signal) => _fetch(client, httpRequest, _stega, query, _params, {
+	return _observe(options.signal, (signal) => _fetch$1(client, httpRequest, _stega, query, _params, {
 		...options,
 		signal
 	}));
@@ -721,12 +736,12 @@ function _fetchObservable(client, httpRequest, _stega, query, _params = {}, opti
 *
 * @internal
 */
-function _fetch(client, httpRequest, _stega, query, _params = {}, options = {}) {
+function _fetch$1(client, httpRequest, _stega, query, _params = {}, options = {}) {
 	let { stega, params, mapResponse, reqOpts } = _fetchRequest(_stega, _params, options), request = _dataRequest(client, httpRequest, "query", {
 		query,
 		params
 	}, reqOpts);
-	return stega.enabled ? Promise.all([request, import("./stegaEncodeSourceMap-DkoIlutY.js")]).then(([res, { stegaEncodeSourceMap }]) => {
+	return stega.enabled ? Promise.all([request, import("./stegaEncodeSourceMap-DbM2fTN4.js")]).then(([res, { stegaEncodeSourceMap }]) => {
 		let result = stegaEncodeSourceMap(res.result, res.resultSourceMap, stega);
 		return mapResponse({
 			...res,
@@ -874,7 +889,7 @@ function _createVersionFromBaseObservable(client, httpRequest, publishedId, base
 }
 /** @internal */
 function _deleteObservable(client, httpRequest, selection, options) {
-	return _observe(options?.signal, (signal) => _delete(client, httpRequest, selection, {
+	return _observe(options?.signal, (signal) => _delete$1(client, httpRequest, selection, {
 		...options,
 		signal
 	}));
@@ -969,8 +984,6 @@ function _mapDataResponse(res, isMutation, returnFirst, returnDocuments) {
 	};
 }
 /**
-* Promise-based sibling of {@link _dataRequestObservable}.
-*
 * @internal
 */
 function _dataRequest(client, httpRequest, endpoint, body, options = {}) {
@@ -981,7 +994,7 @@ function _dataRequest(client, httpRequest, endpoint, body, options = {}) {
 * @internal
 */
 function _createObservable(client, httpRequest, doc, op, options = {}) {
-	return _observe(options.signal, (signal) => _create(client, httpRequest, doc, op, {
+	return _observe(options.signal, (signal) => _create$1(client, httpRequest, doc, op, {
 		...options,
 		signal
 	}));
@@ -991,7 +1004,7 @@ function _createObservable(client, httpRequest, doc, op, options = {}) {
 *
 * @internal
 */
-function _create(client, httpRequest, doc, op, options = {}) {
+function _create$1(client, httpRequest, doc, op, options = {}) {
 	let mutation = { [op]: doc }, opts = Object.assign({
 		returnFirst: !0,
 		returnDocuments: !0
@@ -1028,7 +1041,7 @@ function _mutate(client, httpRequest, mutations, options) {
 *
 * @internal
 */
-function _delete(client, httpRequest, selection, options) {
+function _delete$1(client, httpRequest, selection, options) {
 	return _dataRequest(client, httpRequest, "mutate", { mutations: [{ delete: getSelection(selection) }] }, options);
 }
 /**
@@ -1037,7 +1050,7 @@ function _delete(client, httpRequest, selection, options) {
 * @internal
 */
 function _createIfNotExists(client, httpRequest, doc, options) {
-	return requireDocumentId("createIfNotExists", doc), _create(client, httpRequest, doc, "createIfNotExists", options);
+	return requireDocumentId("createIfNotExists", doc), _create$1(client, httpRequest, doc, "createIfNotExists", options);
 }
 /**
 * Promise-based sibling of {@link _createOrReplaceObservable}.
@@ -1045,7 +1058,7 @@ function _createIfNotExists(client, httpRequest, doc, options) {
 * @internal
 */
 function _createOrReplace(client, httpRequest, doc, options) {
-	return requireDocumentId("createOrReplace", doc), _create(client, httpRequest, doc, "createOrReplace", options);
+	return requireDocumentId("createOrReplace", doc), _create$1(client, httpRequest, doc, "createOrReplace", options);
 }
 /**
 * Promise-based sibling of {@link _createVersionObservable}.
@@ -1195,7 +1208,7 @@ function _observe(userSignal, run) {
 * @internal
 */
 function _request(client, httpRequest, options) {
-	return httpRequest(_prepareRequest(client, options)).then((body) => body);
+	return httpRequest(_prepareRequest(client, options), client.config().requestHandler).then((body) => body);
 }
 /**
 * Execute an HTTP request through the regular pipeline and resolve to the
@@ -1436,9 +1449,22 @@ var ObservableAgentsActionClient = class {
 	}
 	upload(assetType, body, options) {
 		let observable = _upload(this.#client, this.#httpRequest, assetType, body, options);
-		return lastValueFrom(observable.pipe(filter((event) => event.type === "response"), map$1((event) => event.body.document)));
+		return lastValueFrom(observable.pipe(filter((event) => event.type === "response"), map$1((event) => pluckUploadedAsset(event.body))));
 	}
 };
+/**
+* Content Lake's upload endpoint responds with `{document: ...}`; the Media
+* Library upload endpoint responds with `{asset: ...}` instead (a
+* `sanity.asset` document, not a Content Lake asset document). Narrowing on
+* the response body itself - rather than on the client's `resource` config -
+* keeps this correct regardless of how the two are ever wired together.
+*/
+function isMediaLibraryUploadBody(body) {
+	return "asset" in body;
+}
+function pluckUploadedAsset(body) {
+	return isMediaLibraryUploadBody(body) ? body.asset : body.document;
+}
 function _upload(client, _httpRequest, assetType, body, opts = {}) {
 	validateAssetType(assetType);
 	let meta = opts.extract || void 0;
@@ -1465,7 +1491,7 @@ function _upload(client, _httpRequest, assetType, body, opts = {}) {
 		body
 	};
 	return typeof XMLHttpRequest < "u" ? defer(async () => {
-		let { uploadWithProgress } = await import("./browserUpload-icWlVP15.js"), req = _prepareRequest(client, { ...baseRequest });
+		let { uploadWithProgress } = await import("./browserUpload-2tz6Sdqp.js"), req = _prepareRequest(client, { ...baseRequest });
 		return uploadWithProgress({
 			url: appendQuery(req.url, req.query),
 			method: req.method ?? "POST",
@@ -1552,9 +1578,18 @@ function resolveEventSourceFetch(config, options = {}) {
 		return credentials !== void 0 && (mergedInit.credentials = credentials), baseFetch(typeof url == "string" ? url : url.href, mergedInit);
 	};
 }
+/**
+* The fetch the client's own transport resolves for this config: the
+* configured `resolveFetch` (honouring an explicit `proxy`) if present,
+* otherwise the global fetch. Shared by the EventSource connection and the
+* `/check/cors` probe so both resolve identically.
+*
+* @internal
+*/
 function pickBaseFetch(config) {
 	return config.resolveFetch ? config.resolveFetch(typeof config.proxy == "string" ? config.proxy : void 0) : globalThis.fetch.bind(globalThis);
 }
+/** @internal */
 const possibleOptions = [
 	"includePreviousRevision",
 	"includeResult",
@@ -1566,8 +1601,8 @@ const possibleOptions = [
 	"tag"
 ], defaultOptions = { includeResult: !0 };
 /** @public */
-function _listen(query, params, opts = {}) {
-	let config = this.config(), { url, token, withCredentials, requestTagPrefix, headers: configHeaders } = config, tag = opts.tag && requestTagPrefix ? [requestTagPrefix, opts.tag].join(".") : opts.tag, options = {
+function _listen$1(query, params, opts = {}) {
+	let { url, requestTagPrefix } = this.config(), tag = opts.tag && requestTagPrefix ? [requestTagPrefix, opts.tag].join(".") : opts.tag, options = {
 		...defaults_default(opts, defaultOptions),
 		tag
 	}, listenOpts = pick(options, possibleOptions), qs = encodeQueryString({
@@ -1579,7 +1614,12 @@ function _listen(query, params, opts = {}) {
 		}
 	}), uri = `${url}${_getDataUrl(this, "listen", qs)}`;
 	if (uri.length > 14800) return throwError(() => /* @__PURE__ */ Error("Query too large for listener"));
-	let listenFor = options.events ? options.events : ["mutation"], headers = {};
+	let listenFor = options.events ? options.events : ["mutation"];
+	return _connectListenEventSource(this, uri, listenFor);
+}
+/** @internal */
+function _connectListenEventSource(client, uri, listenFor) {
+	let config = client.config(), { token, withCredentials, headers: configHeaders } = config, headers = {};
 	token && (headers.Authorization = `Bearer ${token}`), configHeaders && Object.assign(headers, configHeaders);
 	let initEventSource = () => new EventSource(uri, { fetch: resolveEventSourceFetch(config, {
 		headers: Object.keys(headers).length ? headers : void 0,
@@ -1590,6 +1630,358 @@ function _listen(query, params, opts = {}) {
 		..."data" in event ? event.data : {}
 	})));
 }
+/** @internal */
+const possibleRequestOptions = [
+	"headers",
+	"signal",
+	"tag",
+	"timeout",
+	"token"
+];
+function commentUrl(id) {
+	if (!id) throw Error("Comment ID must be provided");
+	return `/collaboration/comments/${encodeURIComponent(id)}`;
+}
+function resolveCommentResource(client) {
+	let { resource, projectId, dataset } = client.config();
+	if (resource) return resource;
+	if (projectId && dataset) return {
+		type: "dataset",
+		id: `${projectId}.${dataset}`
+	};
+	throw Error("`resource` or `projectId` and `dataset` must be configured to use collaboration comments");
+}
+function resourceQuery(client) {
+	let { collaboration } = client.config(), organizationId = collaboration?.organizationId;
+	if (!organizationId) throw Error("`collaboration.organizationId` must be configured to use collaboration comments");
+	let resource = resolveCommentResource(client);
+	return {
+		organizationId,
+		resourceId: resource.id,
+		resourceType: resource.type
+	};
+}
+/** @internal */
+function _getTargetDocumentRef(client, documentId) {
+	if (!documentId) throw Error("Document ID must be provided");
+	let resource = resolveCommentResource(client);
+	return `${resource.type}:${resource.id}:${getPublishedId(documentId)}`;
+}
+function write(client, httpRequest, method, url, body, options = {}) {
+	return _requestObservable(client, httpRequest, {
+		method,
+		url,
+		body,
+		query: {
+			...resourceQuery(client),
+			...options.transactionId ? { transactionId: options.transactionId } : {}
+		},
+		...pick(options, possibleRequestOptions)
+	});
+}
+/**
+* `commentId` picks the written comment out of the results: a status update
+* cascades to the comment's replies, and the API leaves the results unordered.
+* Creates pass the requested `_id`, which is undefined when the API assigns
+* one, and always come back with a single result.
+*/
+function writeDocument(commentId, ...args) {
+	return write(...args).pipe(map$1(({ results }) => {
+		let result = commentId ? results.find(({ id }) => id === commentId) : results[0];
+		if (!result?.document) throw Error("Comment write did not return a comment document");
+		return result.document;
+	}));
+}
+function writeMutationResult(...args) {
+	return write(...args).pipe(map$1(({ transactionId, results }) => ({
+		transactionId,
+		documentIds: results.map((result) => result.id),
+		results
+	})));
+}
+/** @internal */
+function _create(client, httpRequest, body, options) {
+	return writeDocument(body._id, client, httpRequest, "POST", "/collaboration/comments", body, options);
+}
+/** @internal */
+function _update(client, httpRequest, id, body, options) {
+	return writeDocument(id, client, httpRequest, "PATCH", commentUrl(id), body, options);
+}
+/** @internal */
+function _delete(client, httpRequest, id, options) {
+	return writeMutationResult(client, httpRequest, "DELETE", commentUrl(id), void 0, options);
+}
+/** @internal */
+function _addReaction(client, httpRequest, id, shortName, options) {
+	return writeDocument(id, client, httpRequest, "POST", `${commentUrl(id)}/reactions`, { shortName }, options);
+}
+/** @internal */
+function _removeReaction(client, httpRequest, id, shortName, options) {
+	return writeDocument(id, client, httpRequest, "DELETE", `${commentUrl(id)}/reactions/${encodeURIComponent(shortName)}`, void 0, options);
+}
+/** @internal */
+function _fetch(client, httpRequest, query, params, options) {
+	let search = resourceQuery(client);
+	return _requestObservable(client, httpRequest, {
+		...encodeQueryString({
+			query,
+			params
+		}).length < 11264 ? {
+			method: "GET",
+			url: `/collaboration/comments/query${encodeQueryString({
+				query,
+				params,
+				options: search
+			})}`
+		} : {
+			method: "POST",
+			url: "/collaboration/comments/query",
+			query: search,
+			body: {
+				query,
+				params: params ?? {}
+			}
+		},
+		...pick(options || {}, possibleRequestOptions)
+	}).pipe(map$1((response) => response.result));
+}
+/** @internal */
+function _listen(client, query, params, options) {
+	let opts = options ?? {}, { requestTagPrefix } = client.config(), tag = opts.tag && requestTagPrefix ? [requestTagPrefix, opts.tag].join(".") : opts.tag, listenOpts = pick({
+		...defaults_default(opts, defaultOptions),
+		tag
+	}, possibleOptions), qs = encodeQueryString({
+		query,
+		params,
+		options: {
+			...listenOpts,
+			...resourceQuery(client)
+		}
+	}), uri = `${client.getUrl("/collaboration/comments/listen")}${qs}`;
+	return uri.length > 14800 ? throwError(() => /* @__PURE__ */ Error("Query too large for listener")) : _connectListenEventSource(client, uri, opts.events ? opts.events : ["mutation"]);
+}
+/**
+* Comments on the configured organization resource.
+*
+* Requires `collaboration.organizationId`, plus either `resource` or `projectId` and `dataset`.
+*
+* @alpha
+*/
+var ObservableCollaborationCommentsClient = class {
+	#client;
+	#httpRequest;
+	constructor(client, httpRequest) {
+		this.#client = client, this.#httpRequest = httpRequest;
+	}
+	/**
+	* Create a comment or reply on the configured resource.
+	*
+	* A top-level comment requires `target`; a reply requires `parentCommentId` (never both).
+	* Replies inherit `target`, `status`, and `threadId` from the parent comment.
+	*
+	* @param body - Comment to create
+	* @param options - Optional request options
+	* @returns The created comment
+	*/
+	create(body, options) {
+		return _create(this.#client, this.#httpRequest, body, options);
+	}
+	/**
+	* Update an existing comment.
+	*
+	* Updating `status` cascades to the comment's replies.
+	*
+	* @param id - Comment document ID
+	* @param body - Fields to update
+	* @param options - Optional request options
+	* @returns The updated comment
+	*/
+	update(id, body, options) {
+		return _update(this.#client, this.#httpRequest, id, body, options);
+	}
+	/**
+	* Delete a comment and its replies.
+	*
+	* @param id - Comment document ID
+	* @param options - Optional request options
+	* @returns Mutation result, where `documentIds` covers the comment and every deleted reply
+	*/
+	delete(id, options) {
+		return _delete(this.#client, this.#httpRequest, id, options);
+	}
+	/**
+	* Add the current user's reaction to a comment.
+	*
+	* @param id - Comment document ID
+	* @param shortName - Emoji short name, for example `:+1:`
+	* @param options - Optional request options
+	* @returns The comment, with the reaction applied
+	*/
+	addReaction(id, shortName, options) {
+		return _addReaction(this.#client, this.#httpRequest, id, shortName, options);
+	}
+	/**
+	* Remove the current user's reaction from a comment.
+	*
+	* @param id - Comment document ID
+	* @param shortName - Emoji short name, for example `:+1:`
+	* @param options - Optional request options
+	* @returns The comment, with the reaction removed
+	*/
+	removeReaction(id, shortName, options) {
+		return _removeReaction(this.#client, this.#httpRequest, id, shortName, options);
+	}
+	/**
+	* Build the global document reference used by `target.document._ref`, for use in
+	* queries and listeners.
+	*
+	* The reference is built from the configured `resource` and the published ID of
+	* the given document ID, since comment references always use published IDs.
+	*
+	* @example
+	* ```ts
+	* client.collaboration.comments.listen(
+	*   '*[_type == "sanity.comment" && target.document._ref == $ref]',
+	*   {ref: client.collaboration.comments.getTargetDocumentRef('doc-1')},
+	* )
+	* ```
+	*
+	* @param documentId - Document ID, in published, draft or version form
+	* @returns Global document reference, of the form `resourceType:resourceId:documentId`
+	*/
+	getTargetDocumentRef(documentId) {
+		return _getTargetDocumentRef(this.#client, documentId);
+	}
+	/**
+	* Fetch comments on the configured resource.
+	*
+	* Takes the same `query` and `params` as `client.fetch`, and switches from a
+	* GET to a POST for queries too large for the request URL in the same way,
+	* but queries the comments endpoint, which accepts none of the query options
+	* `client.fetch` does (`perspective`, `useCdn`, `filterResponse`,
+	* `resultSourceMap`, stega).
+	*
+	* The query runs against the organization store, which is not scoped to
+	* comments, so filter on `_type == "sanity.comment"`.
+	*
+	* @param query - GROQ-query to perform
+	* @param params - Optional query parameters
+	* @param options - Optional request options
+	*/
+	fetch(query, params, options) {
+		return _fetch(this.#client, this.#httpRequest, query, params, options);
+	}
+	listen(query, params, options) {
+		return _listen(this.#client, query, params, options);
+	}
+}, CollaborationCommentsClient = class {
+	#client;
+	#httpRequest;
+	constructor(client, httpRequest) {
+		this.#client = client, this.#httpRequest = httpRequest;
+	}
+	/**
+	* Create a comment or reply on the configured resource.
+	*
+	* A top-level comment requires `target`; a reply requires `parentCommentId` (never both).
+	* Replies inherit `target`, `status`, and `threadId` from the parent comment.
+	*
+	* @param body - Comment to create
+	* @param options - Optional request options
+	* @returns The created comment
+	*/
+	create(body, options) {
+		return lastValueFrom(_create(this.#client, this.#httpRequest, body, options));
+	}
+	/**
+	* Update an existing comment.
+	*
+	* Updating `status` cascades to the comment's replies.
+	*
+	* @param id - Comment document ID
+	* @param body - Fields to update
+	* @param options - Optional request options
+	* @returns The updated comment
+	*/
+	update(id, body, options) {
+		return lastValueFrom(_update(this.#client, this.#httpRequest, id, body, options));
+	}
+	/**
+	* Delete a comment and its replies.
+	*
+	* @param id - Comment document ID
+	* @param options - Optional request options
+	* @returns Mutation result, where `documentIds` covers the comment and every deleted reply
+	*/
+	delete(id, options) {
+		return lastValueFrom(_delete(this.#client, this.#httpRequest, id, options));
+	}
+	/**
+	* Add the current user's reaction to a comment.
+	*
+	* @param id - Comment document ID
+	* @param shortName - Emoji short name, for example `:+1:`
+	* @param options - Optional request options
+	* @returns The comment, with the reaction applied
+	*/
+	addReaction(id, shortName, options) {
+		return lastValueFrom(_addReaction(this.#client, this.#httpRequest, id, shortName, options));
+	}
+	/**
+	* Remove the current user's reaction from a comment.
+	*
+	* @param id - Comment document ID
+	* @param shortName - Emoji short name, for example `:+1:`
+	* @param options - Optional request options
+	* @returns The comment, with the reaction removed
+	*/
+	removeReaction(id, shortName, options) {
+		return lastValueFrom(_removeReaction(this.#client, this.#httpRequest, id, shortName, options));
+	}
+	/**
+	* Build the global document reference used by `target.document._ref`, for use in
+	* queries and listeners.
+	*
+	* The reference is built from the configured `resource` and the published ID of
+	* the given document ID, since comment references always use published IDs.
+	*
+	* @example
+	* ```ts
+	* const comments = await client.collaboration.comments.fetch(
+	*   '*[_type == "sanity.comment" && target.document._ref == $ref]',
+	*   {ref: client.collaboration.comments.getTargetDocumentRef('doc-1')},
+	* )
+	* ```
+	*
+	* @param documentId - Document ID, in published, draft or version form
+	* @returns Global document reference, of the form `resourceType:resourceId:documentId`
+	*/
+	getTargetDocumentRef(documentId) {
+		return _getTargetDocumentRef(this.#client, documentId);
+	}
+	/**
+	* Fetch comments on the configured resource.
+	*
+	* Takes the same `query` and `params` as `client.fetch`, and switches from a
+	* GET to a POST for queries too large for the request URL in the same way,
+	* but queries the comments endpoint, which accepts none of the query options
+	* `client.fetch` does (`perspective`, `useCdn`, `filterResponse`,
+	* `resultSourceMap`, stega).
+	*
+	* The query runs against the organization store, which is not scoped to
+	* comments, so filter on `_type == "sanity.comment"`.
+	*
+	* @param query - GROQ-query to perform
+	* @param params - Optional query parameters
+	* @param options - Optional request options
+	*/
+	fetch(query, params, options) {
+		return lastValueFrom(_fetch(this.#client, this.#httpRequest, query, params, options));
+	}
+	listen(query, params, options) {
+		return _listen(this.#client, query, params, options);
+	}
+};
 /**
 * A variant of share that takes a predicate function to determine which value to replay to new subscribers
 * @param configOrPredicate - Predicate function to determine which value to replay
@@ -1651,7 +2043,7 @@ var LiveClient = class {
 			"welcome",
 			"reconnect",
 			"goaway"
-		]), checkCors = checkCorsObservable(new URL(this.#client.getUrl("/check/cors", !1)), projectId, eventSourceWithCredentials), observable = events.pipe(reconnectOnConnectionFailure(), mergeMap((event) => event.type === "reconnect" ? checkCors.pipe(mergeMap(() => of(event))) : of(event)), catchError((err) => err instanceof CorsOriginError ? throwError(() => err) : checkCors.pipe(mergeMap(() => {
+		]), checkCors = checkCorsObservable(new URL(this.#client.getUrl("/check/cors", !1)), projectId, eventSourceWithCredentials, pickBaseFetch(config)), observable = events.pipe(reconnectOnConnectionFailure(), mergeMap((event) => event.type === "reconnect" ? checkCors.pipe(mergeMap(() => of(event))) : of(event)), catchError((err) => err instanceof CorsOriginError ? throwError(() => err) : checkCors.pipe(mergeMap(() => {
 			throw err;
 		}))), map$1((event) => {
 			if (event.type === "message") {
@@ -1704,34 +2096,33 @@ var LiveClient = class {
 * In all of those cases the caller's original underlying error from the
 * EventSource is allowed to propagate unchanged.
 */
-function checkCorsObservable(url, projectId, requireCredentials) {
+function checkCorsObservable(url, projectId, requireCredentials, fetcher) {
 	return new Observable((observer) => {
 		let controller = new AbortController(), { signal } = controller;
-		return fetch(url, {
+		return fetcher(url.href, {
 			method: "GET",
-			mode: "cors",
 			credentials: "omit",
 			signal
 		}).then((response) => {
-			if (!(signal.aborted || !response.ok)) return response.json();
-		}).then((body) => {
-			if (!signal.aborted) {
-				if (requireCredentials && body?.result?.withCredentials === !1) {
-					observer.error(new CorsOriginError({
-						projectId,
-						credentials: !0
-					}));
-					return;
-				}
-				if (body?.result?.allowed === !1) {
-					observer.error(new CorsOriginError({
-						projectId,
-						credentials: requireCredentials
-					}));
-					return;
-				}
-				observer.next(), observer.complete();
+			if (!(signal.aborted || !response.ok)) return response.text();
+		}).then((text) => {
+			if (signal.aborted) return;
+			let parsed = text === void 0 ? void 0 : JSON.parse(text), result = isRecord(parsed) ? parsed.result : void 0;
+			if (requireCredentials && isRecord(result) && result.withCredentials === !1) {
+				observer.error(new CorsOriginError({
+					projectId,
+					credentials: !0
+				}));
+				return;
 			}
+			if (isRecord(result) && result.allowed === !1) {
+				observer.error(new CorsOriginError({
+					projectId,
+					credentials: requireCredentials
+				}));
+				return;
+			}
+			observer.next(), observer.complete();
 		}).catch(() => {
 			signal.aborted || observer.closed || (observer.next(), observer.complete());
 		}), () => controller.abort();
@@ -1901,8 +2292,106 @@ function _modify(client, httpRequest, method, name, options) {
 		tag: null
 	});
 }
+/** Function resource types in a blueprint are namespaced under this prefix. */
+const scopeHeaders = (config, request) => {
+	let organizationId = request?.organizationId || config.organizationId;
+	if (organizationId) return {
+		"X-Sanity-Scope-Type": "organization",
+		"X-Sanity-Scope-Id": organizationId
+	};
+	let { projectId } = config;
+	if (!projectId) throw Error("`functions.invoke()` requires a `projectId` to be set in the client config, or an `organizationId` for a stack deployed at organization scope");
+	return {
+		"X-Sanity-Scope-Type": "project",
+		"X-Sanity-Scope-Id": projectId
+	};
+}, resolveStackId = (config, request) => {
+	let stackId = request?.stackId || config.stackId;
+	if (!stackId) throw Error("`functions.invoke()` requires a `stackId`, either in the client config or on the request. Function names are only unique within a stack.");
+	return stackId;
+};
+/**
+* The invoke route is keyed by function id, but callers know functions by the
+* name declared in the blueprint. Names are unique within a stack, so the stack
+* both makes the name resolvable and confines the call to its own functions.
+*
+* @internal
+*/
+function _resolveFunctionId(client, httpRequest, functionName, stackId, headers, request) {
+	return _requestObservable(client, httpRequest, {
+		method: "GET",
+		url: `/blueprints/stacks/${stackId}`,
+		headers,
+		signal: request?.signal
+	}).pipe(map((stack) => {
+		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}`);
+		return match.externalId;
+	}));
+}
 /** @internal */
-var ObservableMediaLibraryVideoClient = class {
+function _invoke(client, httpRequest, functionName, request) {
+	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, {
+			method: "POST",
+			url: `/functions/${functionId}/invoke`,
+			headers,
+			body: { event: { data: request?.event?.data ?? {} } },
+			timeout: request?.timeout,
+			signal: request?.signal
+		})));
+	});
+}
+/** @public */
+var ObservableFunctionsClient = class {
+	#client;
+	#httpRequest;
+	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);
+	}
+}, FunctionsClient = class {
+	#client;
+	#httpRequest;
+	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));
+	}
+}, ObservableMediaLibraryVideoClient = class {
 	#client;
 	#httpRequest;
 	constructor(client, httpRequest) {
@@ -2558,6 +3047,8 @@ var ObservableReleasesClient = class {
 	projects;
 	users;
 	agent;
+	collaboration;
+	functions;
 	releases;
 	/**
 	* Private properties
@@ -2567,9 +3058,9 @@ var ObservableReleasesClient = class {
 	/**
 	* Instance properties
 	*/
-	listen = _listen;
+	listen = _listen$1;
 	constructor(httpRequest, config = defaultConfig) {
-		this.config(config), this.#httpRequest = httpRequest, this.assets = new ObservableAssetsClient(this, this.#httpRequest), this.datasets = new ObservableDatasetsClient(this, this.#httpRequest), this.live = new LiveClient(this), this.mediaLibrary = { video: new ObservableMediaLibraryVideoClient(this, this.#httpRequest) }, this.projects = new ObservableProjectsClient(this, this.#httpRequest), this.users = new ObservableUsersClient(this, this.#httpRequest), this.agent = { action: new ObservableAgentsActionClient(this, this.#httpRequest) }, this.releases = new ObservableReleasesClient(this, this.#httpRequest);
+		this.config(config), this.#httpRequest = httpRequest, this.assets = new ObservableAssetsClient(this, this.#httpRequest), this.datasets = new ObservableDatasetsClient(this, this.#httpRequest), this.live = new LiveClient(this), this.mediaLibrary = { video: new ObservableMediaLibraryVideoClient(this, this.#httpRequest) }, this.projects = new ObservableProjectsClient(this, this.#httpRequest), this.users = new ObservableUsersClient(this, this.#httpRequest), this.agent = { action: new ObservableAgentsActionClient(this, this.#httpRequest) }, this.collaboration = { comments: new ObservableCollaborationCommentsClient(this, this.#httpRequest) }, this.functions = new ObservableFunctionsClient(this, this.#httpRequest), this.releases = new ObservableReleasesClient(this, this.#httpRequest);
 	}
 	/**
 	* Clone the client - returns a new instance
@@ -2792,6 +3283,8 @@ var ObservableReleasesClient = class {
 	projects;
 	users;
 	agent;
+	collaboration;
+	functions;
 	releases;
 	/**
 	* Observable version of the Sanity client, with the same configuration as the promise-based one
@@ -2805,9 +3298,9 @@ var ObservableReleasesClient = class {
 	/**
 	* Instance properties
 	*/
-	listen = _listen;
+	listen = _listen$1;
 	constructor(httpRequest, config = defaultConfig) {
-		this.config(config), this.#httpRequest = httpRequest, this.assets = new AssetsClient(this, this.#httpRequest), this.datasets = new DatasetsClient(this, this.#httpRequest), this.live = new LiveClient(this), this.mediaLibrary = { video: new MediaLibraryVideoClient(this, this.#httpRequest) }, this.projects = new ProjectsClient(this, this.#httpRequest), this.users = new UsersClient(this, this.#httpRequest), this.agent = { action: new AgentActionsClient(this, this.#httpRequest) }, this.releases = new ReleasesClient(this, this.#httpRequest), this.observable = new ObservableSanityClient(httpRequest, config);
+		this.config(config), this.#httpRequest = httpRequest, this.assets = new AssetsClient(this, this.#httpRequest), this.datasets = new DatasetsClient(this, this.#httpRequest), this.live = new LiveClient(this), this.mediaLibrary = { video: new MediaLibraryVideoClient(this, this.#httpRequest) }, this.projects = new ProjectsClient(this, this.#httpRequest), this.users = new UsersClient(this, this.#httpRequest), this.agent = { action: new AgentActionsClient(this, this.#httpRequest) }, this.collaboration = { comments: new CollaborationCommentsClient(this, this.#httpRequest) }, this.functions = new FunctionsClient(this, this.#httpRequest), this.releases = new ReleasesClient(this, this.#httpRequest), this.observable = new ObservableSanityClient(httpRequest, config);
 	}
 	/**
 	* Clone the client - returns a new instance
@@ -2837,7 +3330,7 @@ var ObservableReleasesClient = class {
 		});
 	}
 	fetch(query, params, options) {
-		return _fetch(this, this.#httpRequest, this.#clientConfig.stega, query, params, options);
+		return _fetch$1(this, this.#httpRequest, this.#clientConfig.stega, query, params, options);
 	}
 	getDocument(id, options) {
 		if (options?.includeAllVersions === !0) return _getDocument(this, this.#httpRequest, id, {
@@ -2875,7 +3368,7 @@ var ObservableReleasesClient = class {
 		return _documentsExists(this, this.#httpRequest, ids, options);
 	}
 	create(document, options) {
-		return _create(this, this.#httpRequest, document, "create", options);
+		return _create$1(this, this.#httpRequest, document, "create", options);
 	}
 	createIfNotExists(document, options) {
 		return _createIfNotExists(this, this.#httpRequest, document, options);
@@ -2896,7 +3389,7 @@ var ObservableReleasesClient = class {
 		return _createVersion(this, this.#httpRequest, documentVersion, versionPublishedId, options);
 	}
 	delete(selection, options) {
-		return _delete(this, this.#httpRequest, selection, options);
+		return _delete$1(this, this.#httpRequest, selection, options);
 	}
 	/**
 	* @public
@@ -3049,10 +3542,10 @@ function defineCreateClientExports(envOptions, ClassConstructor) {
 			ignoreWarnings: config.ignoreWarnings,
 			maxRetries: config.maxRetries,
 			retryDelay: config.retryDelay
-		}), httpRequest = async (options) => (await clientRequesterPromise({
+		}), performRequest = async (options) => (await clientRequesterPromise({
 			redirect: "manual",
 			...options
-		})).body;
+		})).body, httpRequest = (options, requestHandler) => requestHandler ? requestHandler(options, performRequest) : performRequest(options);
 		return new ClassConstructor(httpRequest, {
 			...config,
 			requester: clientRequester,
@@ -3069,7 +3562,7 @@ function defineDeprecatedCreateClient(createClient) {
 		return printNoDefaultExport(), createClient(config);
 	};
 }
-var name = "@sanity/client", version = "8.0.0";
+var name = "@sanity/client", version = "8.2.0";
 const log = createDebug("sanity:client");
 function isNodeReadableStream(value) {
 	return typeof value != "object" || !value || !("pipe" in value) ? !1 : typeof value.pipe == "function";
@@ -3126,6 +3619,6 @@ const middleware = [
 	middleware,
 	resolveFetch
 }, SanityClient), requester = exp.requester, createClient = exp.createClient, deprecatedCreateClient = defineDeprecatedCreateClient(createClient);
-export { BasePatch, BaseTransaction, ChannelError, ClientError, ConnectionFailedError, CorsOriginError, DisconnectError, EXPERIMENTAL_API_WARNING, MessageError, MessageParseError, ObservablePatch, ObservableSanityClient, ObservableTransaction, Patch, SanityClient, ServerError, Transaction, connectEventSource, createClient, deprecatedCreateClient as default, formatQueryParseError, isHttpError, isQueryParseError, requester, validateApiPerspective };
+export { BasePatch, BaseTransaction, ChannelError, ClientError, ConnectionFailedError, CorsOriginError, DisconnectError, EXPERIMENTAL_API_WARNING, MessageError, MessageParseError, ObservablePatch, ObservableSanityClient, ObservableTransaction, Patch, SanityClient, ServerError, Transaction, connectEventSource, createClient, deprecatedCreateClient as default, formatQueryParseError, isHttpError, isQueryParseError, isTimeoutError, requester, validateApiPerspective };
 
 //# sourceMappingURL=index.node.js.map