@sanity/client 7.7.0 → 7.8.0

package/src/data/dataMethods.ts

@@ -1,4 +1,4 @@
-import {getVersionFromId, getVersionId, isDraftId} from '@sanity/client/csm'
+import {getDraftId, getVersionFromId, getVersionId, isDraftId} from '@sanity/client/csm'
 import {from, type MonoTypeOperatorFunction, Observable} from 'rxjs'
 import {combineLatestWith, filter, map} from 'rxjs/operators'
 
@@ -39,7 +39,11 @@ import type {
 import {getSelection} from '../util/getSelection'
 import * as validate from '../validators'
 import * as validators from '../validators'
-import {printCdnPreviewDraftsWarning, printPreviewDraftsDeprecationWarning} from '../warnings'
+import {
+  printCdnPreviewDraftsWarning,
+  printCreateVersionWithBaseIdWarning,
+  printPreviewDraftsDeprecationWarning,
+} from '../warnings'
 import {encodeQueryString} from './encodeQueryString'
 import {ObservablePatch, Patch} from './patch'
 import {ObservableTransaction, Transaction} from './transaction'
@@ -266,6 +270,7 @@ export function _createVersion<R extends Record<string, Any>>(
 ): Observable<SingleActionResult> {
   validators.requireDocumentId('createVersion', doc)
   validators.requireDocumentType('createVersion', doc)
+  printCreateVersionWithBaseIdWarning()
 
   const createVersionAction: CreateVersionAction = {
     actionType: 'sanity.action.document.version.create',
@@ -276,6 +281,38 @@ export function _createVersion<R extends Record<string, Any>>(
   return _action(client, httpRequest, createVersionAction, options)
 }
 
+/** @internal */
+export function _createVersionFromBase(
+  client: ObservableSanityClient | SanityClient,
+  httpRequest: HttpRequest,
+  publishedId?: string,
+  baseId?: string,
+  releaseId?: string,
+  ifBaseRevisionId?: string,
+  options?: BaseActionOptions,
+): Observable<SingleActionResult> {
+  if (!baseId) {
+    throw new Error('`createVersion()` requires `baseId` when no `document` is provided')
+  }
+
+  if (!publishedId) {
+    throw new Error('`createVersion()` requires `publishedId` when `baseId` is provided')
+  }
+
+  validators.validateDocumentId('createVersion', baseId)
+  validators.validateDocumentId('createVersion', publishedId)
+
+  const createVersionAction: CreateVersionAction = {
+    actionType: 'sanity.action.document.version.create',
+    publishedId,
+    baseId,
+    versionId: releaseId ? getVersionId(publishedId, releaseId) : getDraftId(publishedId),
+    ifBaseRevisionId,
+  }
+
+  return _action(client, httpRequest, createVersionAction, options)
+}
+
 /** @internal */
 export function _delete<R extends Record<string, Any>>(
   client: Client,

package/src/types.ts

@@ -725,16 +725,29 @@ export interface DeleteReleaseAction {
 }
 
 /**
- * Creates a new version of an existing document, attached to the release as given
- * by `document._id`
+ * Creates a new version of an existing document.
+ *
+ * If the `document` is provided, the version is created from the document
+ * attached to the release as given by `document._id`
+ *
+ * If the `baseId` and `versionId` are provided, the version is created from the base document
+ * and the version is attached to the release as given by `publishedId` and `versionId`
  *
  * @public
  */
-export interface CreateVersionAction {
+export type CreateVersionAction = {
   actionType: 'sanity.action.document.version.create'
   publishedId: string
-  document: IdentifiedSanityDocumentStub
-}
+} & (
+  | {
+      document: IdentifiedSanityDocumentStub
+    }
+  | {
+      baseId: string
+      versionId: string
+      ifBaseRevisionId?: string
+    }
+)
 
 /**
  * Delete a version of a document.

package/src/warnings.ts

@@ -46,3 +46,7 @@ export const printNoApiVersionSpecifiedWarning = createWarningPrinter([
 export const printNoDefaultExport = createWarningPrinter([
   'The default export of @sanity/client has been deprecated. Use the named export `createClient` instead.',
 ])
+
+export const printCreateVersionWithBaseIdWarning = createWarningPrinter([
+  'You have called `createVersion()` with a defined `document`. The recommended approach is to provide a `baseId` and `releaseId` instead.',
+])

package/umd/sanityClient.js

@@ -2293,6 +2293,8 @@ ${codeFrame(query, { start, end }, description)}${withTag}`;
     `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."
   ]), defaultCdnHost = "apicdn.sanity.io", defaultConfig = {
     apiHost: "https://api.sanity.io",
     apiVersion: "1",
@@ -2928,12 +2930,27 @@ ${selectionOpts}`);
     return requireDocumentId("createOrReplace", doc), _create(client, httpRequest, doc, "createOrReplace", options);
   }
   function _createVersion(client, httpRequest, doc, publishedId, options) {
-    return requireDocumentId("createVersion", doc), requireDocumentType("createVersion", doc), _action(client, httpRequest, {
+    return requireDocumentId("createVersion", doc), requireDocumentType("createVersion", doc), printCreateVersionWithBaseIdWarning(), _action(client, httpRequest, {
       actionType: "sanity.action.document.version.create",
       publishedId,
       document: doc
     }, options);
   }
+  function _createVersionFromBase(client, httpRequest, publishedId, baseId, releaseId, ifBaseRevisionId, options) {
+    if (!baseId)
+      throw new Error("`createVersion()` requires `baseId` when no `document` is provided");
+    if (!publishedId)
+      throw new Error("`createVersion()` requires `publishedId` when `baseId` is provided");
+    validateDocumentId("createVersion", baseId), validateDocumentId("createVersion", publishedId);
+    const createVersionAction = {
+      actionType: "sanity.action.document.version.create",
+      publishedId,
+      baseId,
+      versionId: releaseId ? getVersionId(publishedId, releaseId) : getDraftId(publishedId),
+      ifBaseRevisionId
+    };
+    return _action(client, httpRequest, createVersionAction, options);
+  }
   function _delete(client, httpRequest, selection, options) {
     return _dataRequest(
       client,
@@ -4219,8 +4236,20 @@ ${selectionOpts}`);
     createVersion({
       document,
       publishedId,
-      releaseId
+      releaseId,
+      baseId,
+      ifBaseRevisionId
     }, options) {
+      if (!document)
+        return _createVersionFromBase(
+          this,
+          this.#httpRequest,
+          publishedId,
+          baseId,
+          releaseId,
+          ifBaseRevisionId,
+          options
+        );
       const documentVersionId = deriveDocumentVersionId("createVersion", {
         document,
         publishedId,
@@ -4471,8 +4500,22 @@ ${selectionOpts}`);
     createVersion({
       document,
       publishedId,
-      releaseId
+      releaseId,
+      baseId,
+      ifBaseRevisionId
     }, options) {
+      if (!document)
+        return firstValueFrom(
+          _createVersionFromBase(
+            this,
+            this.#httpRequest,
+            publishedId,
+            baseId,
+            releaseId,
+            ifBaseRevisionId,
+            options
+          )
+        );
       const documentVersionId = deriveDocumentVersionId("createVersion", {
         document,
         publishedId,