@sanity/client 8.6.2 → 8.8.0

package/dist/index.node.js

@@ -1544,7 +1544,7 @@ function optionsFromFile(opts, file) {
 		contentType: file.type
 	}, opts);
 }
-var defaults_default = (obj, defaults) => Object.keys(defaults).concat(Object.keys(obj)).reduce((target, prop) => (target[prop] = obj[prop] === void 0 ? defaults[prop] : obj[prop], target), {});
+var name = "@sanity/client", version = "8.8.0", defaults_default = (obj, defaults) => Object.keys(defaults).concat(Object.keys(obj)).reduce((target, prop) => (target[prop] = obj[prop] === void 0 ? defaults[prop] : obj[prop], target), {});
 const pick = (obj, props) => props.reduce((selection, prop) => (obj[prop] === void 0 || (selection[prop] = obj[prop]), selection), {}), RETRYABLE_STATUSES = /* @__PURE__ */ new Set([408, 429]);
 /**
 * Note: connection failure is not the same as network disconnect which may happen more frequent.
@@ -1646,6 +1646,33 @@ function _connectListenEventSource(client, uri, listenFor) {
 		..."data" in event ? event.data : {}
 	})));
 }
+/**
+* Build the global document reference a comment stores in `target.document._ref`,
+* without a client.
+*
+* `client.collaboration.comments.getTargetDocumentRef` reads the resource off the
+* client's configuration and calls this. Use this directly when the resource is
+* already at hand and no client should be involved, for example inside a state
+* selector that has to stay free of side effects.
+*
+* The reference always names the published document: a draft or version ID is
+* reduced to its published form first.
+*
+* @example
+* ```ts
+* getCommentTargetDocumentRef({type: 'dataset', id: 'abc123.production'}, 'drafts.doc-1')
+* // 'dataset:abc123.production:doc-1'
+* ```
+*
+* @param resource - The resource the comments are stored against, as `ClientConfig['resource']` takes it
+* @param documentId - Document ID, in published, draft or version form
+* @returns Global document reference, of the form `resourceType:resourceId:documentId`
+* @alpha
+*/
+function getCommentTargetDocumentRef(resource, documentId) {
+	if (!documentId) throw Error("Document ID must be provided");
+	return `${resource.type}:${resource.id}:${getPublishedId(documentId)}`;
+}
 /** @internal */
 const possibleRequestOptions = [
 	"headers",
@@ -1680,8 +1707,7 @@ function resourceQuery(client) {
 /** @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)}`;
+	return getCommentTargetDocumentRef(resolveCommentResource(client), documentId);
 }
 function write(client, httpRequest, method, url, body, options = {}) {
 	return _requestObservable(client, httpRequest, {
@@ -1690,6 +1716,7 @@ function write(client, httpRequest, method, url, body, options = {}) {
 		body,
 		query: {
 			...resourceQuery(client),
+			clientVersion: version,
 			...options.transactionId ? { transactionId: options.transactionId } : {}
 		},
 		...pick(options, possibleRequestOptions)
@@ -1715,13 +1742,35 @@ function writeMutationResult(...args) {
 		results
 	})));
 }
+/**
+* Moves the deprecated `range` + `fieldValue` onto a `portable-text` `anchor`.
+* Anything else passes through unchanged, and invalid combinations are left
+* for the API to reject.
+*/
+function withAnchor(input) {
+	let { range, fieldValue, ...rest } = input;
+	return range === void 0 || input.anchor !== void 0 ? input : range === null ? fieldValue ? input : {
+		...rest,
+		anchor: null
+	} : {
+		...rest,
+		anchor: {
+			type: "portable-text",
+			...range,
+			...fieldValue && { fieldValue }
+		}
+	};
+}
 /** @internal */
 function _create(client, httpRequest, body, options) {
-	return writeDocument(body._id, client, httpRequest, "POST", "/collaboration/comments", body, options);
+	return writeDocument(body._id, client, httpRequest, "POST", "/collaboration/comments", body.target ? {
+		...body,
+		target: withAnchor(body.target)
+	} : body, options);
 }
 /** @internal */
 function _update(client, httpRequest, id, body, options) {
-	return writeDocument(id, client, httpRequest, "PATCH", commentUrl(id), body, options);
+	return writeDocument(id, client, httpRequest, "PATCH", commentUrl(id), withAnchor(body), options);
 }
 /** @internal */
 function _delete(client, httpRequest, id, options) {
@@ -4506,7 +4555,6 @@ function defineDeprecatedCreateClient(createClient) {
 		return printNoDefaultExport(), createClient(config);
 	};
 }
-var name = "@sanity/client", version = "8.6.2";
 const log = createDebug("sanity:client");
 function isNodeReadableStream(value) {
 	return typeof value != "object" || !value || !("pipe" in value) ? !1 : typeof value.pipe == "function";