@sanity/client 7.1.0-views.0 → 7.1.0-views.1

package/dist/index.js

@@ -1,12 +1,15 @@
-import { _request, _requestObservable, encodeQueryString, _getDataUrl, CorsOriginError, _fetch, _getDocument, _getDocuments, _create, _createIfNotExists, _createOrReplace, _delete, _mutate, Patch, Transaction, _action, _dataRequest, _getUrl, ObservablePatch, ObservableTransaction, defineHttpRequest } from "./_chunks-es/dataMethods.js";
+import { formatQueryParseError, isQueryParseError, _request, _requestObservable, encodeQueryString, _getDataUrl, CorsOriginError, _getDocument, _action, _getReleaseDocuments, _fetch, _getDocuments, _create, _createIfNotExists, _createOrReplace, _createVersion, _delete, _discardVersion, _replaceVersion, _unpublishVersion, _mutate, Patch, Transaction, _dataRequest, _getUrl, ObservablePatch, ObservableTransaction, defineHttpRequest } from "./_chunks-es/dataMethods.js";
 import { BasePatch, BaseTransaction, ClientError, ServerError } from "./_chunks-es/dataMethods.js";
 import "./_chunks-es/stegaClean.js";
-import { defer, of, isObservable, mergeMap, Observable, lastValueFrom, shareReplay, catchError, concat, throwError, timer, tap, finalize, share, merge, EMPTY } from "rxjs";
+import { defer, of, isObservable, mergeMap, Observable, lastValueFrom, shareReplay, catchError, concat, throwError, timer, tap, finalize, share, merge, EMPTY, map as map$1, firstValueFrom } from "rxjs";
 import { filter, map, finalize as finalize$1 } from "rxjs/operators";
-import { hasDataset, validateAssetType, resourceGuard, dataset, defaultConfig, initConfig, printNoDefaultExport } from "./_chunks-es/config.js";
+import { hasDataset, validateAssetType, resourceGuard, dataset, validateVersionIdMatch, defaultConfig, initConfig, printNoDefaultExport } from "./_chunks-es/config.js";
 import { validateApiPerspective } from "./_chunks-es/config.js";
 import { debug, headers, agent } from "get-it/middleware";
+import { getVersionId, getDraftId, isDraftId, isVersionId, getVersionFromId, getPublishedId } from "@sanity/client/csm";
+import crypto from "crypto";
 import { adapter, environment } from "get-it";
+var ViewResourceType = /* @__PURE__ */ ((ViewResourceType2) => (ViewResourceType2.Dataset = "dataset", ViewResourceType2))(ViewResourceType || {});
 class ConnectionFailedError extends Error {
   name = "ConnectionFailedError";
 }
@@ -66,7 +69,8 @@ function connectWithESInstance(es, events) {
         return;
       }
       if (message.type === "channelError") {
-        observer.error(new ChannelError(extractErrorMessage(event?.data), event.data));
+        const tag = new URL(es.url).searchParams.get("tag");
+        observer.error(new ChannelError(extractErrorMessage(event?.data, tag), event.data));
         return;
       }
       if (message.type === "disconnect") {
@@ -105,8 +109,9 @@ function parseEvent(message) {
     return [err, null];
   }
 }
-function extractErrorMessage(err) {
-  return err.error ? err.error.description ? err.error.description : typeof err.error == "string" ? err.error : JSON.stringify(err.error, null, 2) : err.message || "Unknown listener error";
+function extractErrorMessage(err, tag) {
+  const 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";
 }
 function isEmptyObject(data) {
   for (const _ in data)
@@ -121,6 +126,22 @@ function _generate(client, httpRequest, request) {
     body: request
   });
 }
+function _patch(client, httpRequest, request) {
+  const dataset2 = hasDataset(client.config());
+  return _request(client.config(), httpRequest, {
+    method: "POST",
+    uri: `/agent/action/patch/${dataset2}`,
+    body: request
+  });
+}
+function _prompt(client, httpRequest, request) {
+  const dataset2 = hasDataset(client.config());
+  return _request(client.config(), httpRequest, {
+    method: "POST",
+    uri: `/agent/action/prompt/${dataset2}`,
+    body: request
+  });
+}
 function _transform(client, httpRequest, request) {
   const dataset2 = hasDataset(client.config());
   return _request(client.config(), httpRequest, {
@@ -192,6 +213,21 @@ class AgentActionsClient {
   translate(request) {
     return lastValueFrom(_translate(this.#client, this.#httpRequest, request));
   }
+  /**
+   * Run a raw instruction and return the result either as text or json
+   * @param request - prompt request
+   */
+  prompt(request) {
+    return lastValueFrom(_prompt(this.#client, this.#httpRequest, request));
+  }
+  /**
+   * Patch a document using a schema aware API.
+   * Does not use an LLM, but uses the schema to ensure paths and values matches the schema.
+   * @param request - instruction request
+   */
+  patch(request) {
+    return lastValueFrom(_patch(this.#client, this.#httpRequest, request));
+  }
 }
 class ObservableAssetsClient {
   #client;
@@ -300,13 +336,11 @@ const MAX_URL_LENGTH = 14800, possibleOptions = [
   includeResult: !0
 };
 function _listen(query, params, opts = {}) {
-  const { url, token, withCredentials, requestTagPrefix } = this.config(), tag = opts.tag && requestTagPrefix ? [requestTagPrefix, opts.tag].join(".") : opts.tag, options = { ...defaults(opts, defaultOptions), tag }, listenOpts = pick(options, possibleOptions), qs = encodeQueryString({ query, params, options: { tag, ...listenOpts } }), uri = `${url}${_getDataUrl(this.config(), "listen", qs)}`;
+  const { url, token, withCredentials, requestTagPrefix, headers: configHeaders } = this.config(), tag = opts.tag && requestTagPrefix ? [requestTagPrefix, opts.tag].join(".") : opts.tag, options = { ...defaults(opts, defaultOptions), tag }, listenOpts = pick(options, possibleOptions), qs = encodeQueryString({ query, params, options: { tag, ...listenOpts } }), uri = `${url}${_getDataUrl(this.config(), "listen", qs)}`;
   if (uri.length > MAX_URL_LENGTH)
     return throwError(() => new Error("Query too large for listener"));
   const listenFor = options.events ? options.events : ["mutation"], esOptions = {};
-  return withCredentials && (esOptions.withCredentials = !0), token && (esOptions.headers = {
-    Authorization: `Bearer ${token}`
-  }), connectEventSource(() => (
+  return withCredentials && (esOptions.withCredentials = !0), (token || configHeaders) && (esOptions.headers = {}, token && (esOptions.headers.Authorization = `Bearer ${token}`), configHeaders && Object.assign(esOptions.headers, configHeaders)), connectEventSource(() => (
     // use polyfill if there is no global EventSource or if we need to set headers
     (typeof EventSource > "u" || esOptions.headers ? eventSourcePolyfill : of(EventSource)).pipe(map((EventSource2) => new EventSource2(uri, esOptions)))
   ), listenFor).pipe(
@@ -364,7 +398,8 @@ class LiveClient {
       apiVersion: _apiVersion,
       token,
       withCredentials,
-      requestTagPrefix
+      requestTagPrefix,
+      headers: configHeaders
     } = this.#client.config(), apiVersion = _apiVersion.replace(/^v/, "");
     if (apiVersion !== "X" && apiVersion < requiredApiVersion)
       throw new Error(
@@ -377,9 +412,7 @@ class LiveClient {
     const path = _getDataUrl(this.#client.config(), "live/events"), url = new URL(this.#client.getUrl(path, !1)), tag = _tag && requestTagPrefix ? [requestTagPrefix, _tag].join(".") : _tag;
     tag && url.searchParams.set("tag", tag), includeDrafts && url.searchParams.set("includeDrafts", "true");
     const esOptions = {};
-    includeDrafts && token && (esOptions.headers = {
-      Authorization: `Bearer ${token}`
-    }), includeDrafts && withCredentials && (esOptions.withCredentials = !0);
+    includeDrafts && withCredentials && (esOptions.withCredentials = !0), (includeDrafts && token || configHeaders) && (esOptions.headers = {}, includeDrafts && token && (esOptions.headers.Authorization = `Bearer ${token}`), configHeaders && Object.assign(esOptions.headers, configHeaders));
     const key = `${url.href}::${JSON.stringify(esOptions)}`, existing = eventsCache.get(key);
     if (existing)
       return existing;
@@ -517,7 +550,10 @@ class DatasetsClient {
    */
   list() {
     return resourceGuard("dataset", this.#client.config()), lastValueFrom(
-      _request(this.#client.config(), this.#httpRequest, { uri: "/datasets", tag: null })
+      _request(this.#client.config(), this.#httpRequest, {
+        uri: "/datasets",
+        tag: null
+      })
     );
   }
 }
@@ -546,7 +582,9 @@ class ObservableProjectsClient {
    * @param projectId - ID of the project to fetch
    */
   getById(projectId) {
-    return resourceGuard("projects", this.#client.config()), _request(this.#client.config(), this.#httpRequest, { uri: `/projects/${projectId}` });
+    return resourceGuard("projects", this.#client.config()), _request(this.#client.config(), this.#httpRequest, {
+      uri: `/projects/${projectId}`
+    });
   }
 }
 class ProjectsClient {
@@ -567,7 +605,521 @@ class ProjectsClient {
    */
   getById(projectId) {
     return resourceGuard("projects", this.#client.config()), lastValueFrom(
-      _request(this.#client.config(), this.#httpRequest, { uri: `/projects/${projectId}` })
+      _request(this.#client.config(), this.#httpRequest, {
+        uri: `/projects/${projectId}`
+      })
+    );
+  }
+}
+const POOL_SIZE_MULTIPLIER = 128;
+let pool, poolOffset, fillPool = (bytes) => {
+  !pool || pool.length < bytes ? (pool = Buffer.allocUnsafe(bytes * POOL_SIZE_MULTIPLIER), crypto.randomFillSync(pool), poolOffset = 0) : poolOffset + bytes > pool.length && (crypto.randomFillSync(pool), poolOffset = 0), poolOffset += bytes;
+}, random = (bytes) => (fillPool(bytes |= 0), pool.subarray(poolOffset - bytes, poolOffset)), customRandom = (alphabet, defaultSize, getRandom) => {
+  let mask = (2 << 31 - Math.clz32(alphabet.length - 1 | 1)) - 1, step = Math.ceil(1.6 * mask * defaultSize / alphabet.length);
+  return (size = defaultSize) => {
+    let id = "";
+    for (; ; ) {
+      let bytes = getRandom(step), i = step;
+      for (; i--; )
+        if (id += alphabet[bytes[i] & mask] || "", id.length === size) return id;
+    }
+  };
+}, customAlphabet = (alphabet, size = 21) => customRandom(alphabet, size, random);
+const generateReleaseId = customAlphabet(
+  "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789",
+  8
+), getDocumentVersionId = (publishedId, releaseId) => releaseId ? getVersionId(publishedId, releaseId) : getDraftId(publishedId);
+function deriveDocumentVersionId(op, {
+  releaseId,
+  publishedId,
+  document
+}) {
+  if (publishedId && document._id) {
+    const versionId = getDocumentVersionId(publishedId, releaseId);
+    return validateVersionIdMatch(versionId, document), versionId;
+  }
+  if (document._id) {
+    const isDraft = isDraftId(document._id), isVersion = isVersionId(document._id);
+    if (!isDraft && !isVersion)
+      throw new Error(
+        `\`${op}()\` requires a document with an \`_id\` that is a version or draft ID`
+      );
+    if (releaseId) {
+      if (isDraft)
+        throw new Error(
+          `\`${op}()\` was called with a document ID (\`${document._id}\`) that is a draft ID, but a release ID (\`${releaseId}\`) was also provided.`
+        );
+      const builtVersionId = getVersionFromId(document._id);
+      if (builtVersionId !== releaseId)
+        throw new Error(
+          `\`${op}()\` was called with a document ID (\`${document._id}\`) that is a version ID, but the release ID (\`${releaseId}\`) does not match the document's version ID (\`${builtVersionId}\`).`
+        );
+    }
+    return document._id;
+  }
+  if (publishedId)
+    return getDocumentVersionId(publishedId, releaseId);
+  throw new Error(`\`${op}()\` requires either a publishedId or a document with an \`_id\``);
+}
+const getArgs = (releaseOrOptions, maybeOptions) => {
+  if (typeof releaseOrOptions == "object" && releaseOrOptions !== null && ("releaseId" in releaseOrOptions || "metadata" in releaseOrOptions)) {
+    const { releaseId = generateReleaseId(), metadata = {} } = releaseOrOptions;
+    return [releaseId, metadata, maybeOptions];
+  }
+  return [generateReleaseId(), {}, releaseOrOptions];
+}, createRelease = (releaseOrOptions, maybeOptions) => {
+  const [releaseId, metadata, options] = getArgs(releaseOrOptions, maybeOptions), finalMetadata = {
+    ...metadata,
+    releaseType: metadata.releaseType || "undecided"
+  };
+  return { action: {
+    actionType: "sanity.action.release.create",
+    releaseId,
+    metadata: finalMetadata
+  }, options };
+};
+class ObservableReleasesClient {
+  #client;
+  #httpRequest;
+  constructor(client, httpRequest) {
+    this.#client = client, this.#httpRequest = httpRequest;
+  }
+  /**
+   * @public
+   *
+   * Retrieve a release by id.
+   *
+   * @category Releases
+   *
+   * @param params - Release action parameters:
+   *   - `releaseId` - The id of the release to retrieve.
+   * @param options - Additional query options including abort signal and query tag.
+   * @returns An observable that resolves to the release document {@link ReleaseDocument}.
+   *
+   * @example Retrieving a release by id
+   * ```ts
+   * client.observable.releases.get({releaseId: 'my-release'}).pipe(
+   *   tap((release) => console.log(release)),
+   *   // {
+   *   //   _id: '_.releases.my-release',
+   *   //   name: 'my-release'
+   *   //   _type: 'system.release',
+   *   //   metadata: {releaseType: 'asap'},
+   *   //   _createdAt: '2021-01-01T00:00:00.000Z',
+   *   //   ...
+   *   // }
+   * ).subscribe()
+   * ```
+   */
+  get({ releaseId }, options) {
+    return _getDocument(
+      this.#client.config(),
+      this.#httpRequest,
+      `_.releases.${releaseId}`,
+      options
+    );
+  }
+  create(releaseOrOptions, maybeOptions) {
+    const { action, options } = createRelease(releaseOrOptions, maybeOptions), { releaseId, metadata } = action;
+    return _action(this.#client.config(), this.#httpRequest, action, options).pipe(
+      map$1((actionResult) => ({
+        ...actionResult,
+        releaseId,
+        metadata
+      }))
+    );
+  }
+  /**
+   * @public
+   *
+   * Edits an existing release, updating the metadata.
+   *
+   * @category Releases
+   *
+   * @param params - Release action parameters:
+   *   - `releaseId` - The id of the release to edit.
+   *   - `patch` - The patch operation to apply on the release metadata {@link PatchMutationOperation}.
+   * @param options - Additional action options.
+   * @returns An observable that resolves to the `transactionId`.
+   */
+  edit({ releaseId, patch }, options) {
+    const editAction = {
+      actionType: "sanity.action.release.edit",
+      releaseId,
+      patch
+    };
+    return _action(this.#client.config(), this.#httpRequest, editAction, options);
+  }
+  /**
+   * @public
+   *
+   * Publishes all documents in a release at once. For larger releases the effect of the publish
+   * will be visible immediately when querying but the removal of the `versions.<releasesId>.*`
+   * documents and creation of the corresponding published documents with the new content may
+   * take some time.
+   *
+   * During this period both the source and target documents are locked and cannot be
+   * modified through any other means.
+   *
+   * @category Releases
+   *
+   * @param params - Release action parameters:
+   *   - `releaseId` - The id of the release to publish.
+   * @param options - Additional action options.
+   * @returns An observable that resolves to the `transactionId`.
+   */
+  publish({ releaseId }, options) {
+    const publishAction = {
+      actionType: "sanity.action.release.publish",
+      releaseId
+    };
+    return _action(this.#client.config(), this.#httpRequest, publishAction, options);
+  }
+  /**
+   * @public
+   *
+   * An archive action removes an active release. The documents that comprise the release
+   * are deleted and therefore no longer queryable.
+   *
+   * While the documents remain in retention the last version can still be accessed using document history endpoint.
+   *
+   * @category Releases
+   *
+   * @param params - Release action parameters:
+   *   - `releaseId` - The id of the release to archive.
+   * @param options - Additional action options.
+   * @returns An observable that resolves to the `transactionId`.
+   */
+  archive({ releaseId }, options) {
+    const archiveAction = {
+      actionType: "sanity.action.release.archive",
+      releaseId
+    };
+    return _action(this.#client.config(), this.#httpRequest, archiveAction, options);
+  }
+  /**
+   * @public
+   *
+   * An unarchive action restores an archived release and all documents
+   * with the content they had just prior to archiving.
+   *
+   * @category Releases
+   *
+   * @param params - Release action parameters:
+   *   - `releaseId` - The id of the release to unarchive.
+   * @param options - Additional action options.
+   * @returns An observable that resolves to the `transactionId`.
+   */
+  unarchive({ releaseId }, options) {
+    const unarchiveAction = {
+      actionType: "sanity.action.release.unarchive",
+      releaseId
+    };
+    return _action(this.#client.config(), this.#httpRequest, unarchiveAction, options);
+  }
+  /**
+   * @public
+   *
+   * A schedule action queues a release for publishing at the given future time.
+   * The release is locked such that no documents in the release can be modified and
+   * no documents that it references can be deleted as this would make the publish fail.
+   * At the given time, the same logic as for the publish action is triggered.
+   *
+   * @category Releases
+   *
+   * @param params - Release action parameters:
+   *   - `releaseId` - The id of the release to schedule.
+   *   - `publishAt` - The serialised date and time to publish the release. If the `publishAt` is in the past, the release will be published immediately.
+   * @param options - Additional action options.
+   * @returns An observable that resolves to the `transactionId`.
+   */
+  schedule({ releaseId, publishAt }, options) {
+    const scheduleAction = {
+      actionType: "sanity.action.release.schedule",
+      releaseId,
+      publishAt
+    };
+    return _action(this.#client.config(), this.#httpRequest, scheduleAction, options);
+  }
+  /**
+   * @public
+   *
+   * An unschedule action stops a release from being published.
+   * The documents in the release are considered unlocked and can be edited again.
+   * This may fail if another release is scheduled to be published after this one and
+   * has a reference to a document created by this one.
+   *
+   * @category Releases
+   *
+   * @param params - Release action parameters:
+   *   - `releaseId` - The id of the release to unschedule.
+   * @param options - Additional action options.
+   * @returns An observable that resolves to the `transactionId`.
+   */
+  unschedule({ releaseId }, options) {
+    const unscheduleAction = {
+      actionType: "sanity.action.release.unschedule",
+      releaseId
+    };
+    return _action(this.#client.config(), this.#httpRequest, unscheduleAction, options);
+  }
+  /**
+   * @public
+   *
+   * A delete action removes a published or archived release.
+   * The backing system document will be removed from the dataset.
+   *
+   * @category Releases
+   *
+   * @param params - Release action parameters:
+   *   - `releaseId` - The id of the release to delete.
+   * @param options - Additional action options.
+   * @returns An observable that resolves to the `transactionId`.
+   */
+  delete({ releaseId }, options) {
+    const deleteAction = {
+      actionType: "sanity.action.release.delete",
+      releaseId
+    };
+    return _action(this.#client.config(), this.#httpRequest, deleteAction, options);
+  }
+  /**
+   * @public
+   *
+   * Fetch the documents in a release by release id.
+   *
+   * @category Releases
+   *
+   * @param params - Release action parameters:
+   *   - `releaseId` - The id of the release to fetch documents for.
+   * @param options - Additional mutation options {@link BaseMutationOptions}.
+   * @returns An observable that resolves to the documents in the release.
+   */
+  fetchDocuments({ releaseId }, options) {
+    return _getReleaseDocuments(this.#client.config(), this.#httpRequest, releaseId, options);
+  }
+}
+class ReleasesClient {
+  #client;
+  #httpRequest;
+  constructor(client, httpRequest) {
+    this.#client = client, this.#httpRequest = httpRequest;
+  }
+  /**
+   * @public
+   *
+   * Retrieve a release by id.
+   *
+   * @category Releases
+   *
+   * @param params - Release action parameters:
+   *   - `releaseId` - The id of the release to retrieve.
+   * @param options - Additional query options including abort signal and query tag.
+   * @returns A promise that resolves to the release document {@link ReleaseDocument}.
+   *
+   * @example Retrieving a release by id
+   * ```ts
+   * const release = await client.releases.get({releaseId: 'my-release'})
+   * console.log(release)
+   * // {
+   * //   _id: '_.releases.my-release',
+   * //   name: 'my-release'
+   * //   _type: 'system.release',
+   * //   metadata: {releaseType: 'asap'},
+   * //   _createdAt: '2021-01-01T00:00:00.000Z',
+   * //   ...
+   * // }
+   * ```
+   */
+  get({ releaseId }, options) {
+    return lastValueFrom(
+      _getDocument(
+        this.#client.config(),
+        this.#httpRequest,
+        `_.releases.${releaseId}`,
+        options
+      )
+    );
+  }
+  async create(releaseOrOptions, maybeOptions) {
+    const { action, options } = createRelease(releaseOrOptions, maybeOptions), { releaseId, metadata } = action;
+    return { ...await lastValueFrom(
+      _action(this.#client.config(), this.#httpRequest, action, options)
+    ), releaseId, metadata };
+  }
+  /**
+   * @public
+   *
+   * Edits an existing release, updating the metadata.
+   *
+   * @category Releases
+   *
+   * @param params - Release action parameters:
+   *   - `releaseId` - The id of the release to edit.
+   *   - `patch` - The patch operation to apply on the release metadata {@link PatchMutationOperation}.
+   * @param options - Additional action options.
+   * @returns A promise that resolves to the `transactionId`.
+   */
+  edit({ releaseId, patch }, options) {
+    const editAction = {
+      actionType: "sanity.action.release.edit",
+      releaseId,
+      patch
+    };
+    return lastValueFrom(_action(this.#client.config(), this.#httpRequest, editAction, options));
+  }
+  /**
+   * @public
+   *
+   * Publishes all documents in a release at once. For larger releases the effect of the publish
+   * will be visible immediately when querying but the removal of the `versions.<releasesId>.*`
+   * documents and creation of the corresponding published documents with the new content may
+   * take some time.
+   *
+   * During this period both the source and target documents are locked and cannot be
+   * modified through any other means.
+   *
+   * @category Releases
+   *
+   * @param params - Release action parameters:
+   *   - `releaseId` - The id of the release to publish.
+   * @param options - Additional action options.
+   * @returns A promise that resolves to the `transactionId`.
+   */
+  publish({ releaseId }, options) {
+    const publishAction = {
+      actionType: "sanity.action.release.publish",
+      releaseId
+    };
+    return lastValueFrom(_action(this.#client.config(), this.#httpRequest, publishAction, options));
+  }
+  /**
+   * @public
+   *
+   * An archive action removes an active release. The documents that comprise the release
+   * are deleted and therefore no longer queryable.
+   *
+   * While the documents remain in retention the last version can still be accessed using document history endpoint.
+   *
+   * @category Releases
+   *
+   * @param params - Release action parameters:
+   *   - `releaseId` - The id of the release to archive.
+   * @param options - Additional action options.
+   * @returns A promise that resolves to the `transactionId`.
+   */
+  archive({ releaseId }, options) {
+    const archiveAction = {
+      actionType: "sanity.action.release.archive",
+      releaseId
+    };
+    return lastValueFrom(_action(this.#client.config(), this.#httpRequest, archiveAction, options));
+  }
+  /**
+   * @public
+   *
+   * An unarchive action restores an archived release and all documents
+   * with the content they had just prior to archiving.
+   *
+   * @category Releases
+   *
+   * @param params - Release action parameters:
+   *   - `releaseId` - The id of the release to unarchive.
+   * @param options - Additional action options.
+   * @returns A promise that resolves to the `transactionId`.
+   */
+  unarchive({ releaseId }, options) {
+    const unarchiveAction = {
+      actionType: "sanity.action.release.unarchive",
+      releaseId
+    };
+    return lastValueFrom(
+      _action(this.#client.config(), this.#httpRequest, unarchiveAction, options)
+    );
+  }
+  /**
+   * @public
+   *
+   * A schedule action queues a release for publishing at the given future time.
+   * The release is locked such that no documents in the release can be modified and
+   * no documents that it references can be deleted as this would make the publish fail.
+   * At the given time, the same logic as for the publish action is triggered.
+   *
+   * @category Releases
+   *
+   * @param params - Release action parameters:
+   *   - `releaseId` - The id of the release to schedule.
+   *   - `publishAt` - The serialised date and time to publish the release. If the `publishAt` is in the past, the release will be published immediately.
+   * @param options - Additional action options.
+   * @returns A promise that resolves to the `transactionId`.
+   */
+  schedule({ releaseId, publishAt }, options) {
+    const scheduleAction = {
+      actionType: "sanity.action.release.schedule",
+      releaseId,
+      publishAt
+    };
+    return lastValueFrom(_action(this.#client.config(), this.#httpRequest, scheduleAction, options));
+  }
+  /**
+   * @public
+   *
+   * An unschedule action stops a release from being published.
+   * The documents in the release are considered unlocked and can be edited again.
+   * This may fail if another release is scheduled to be published after this one and
+   * has a reference to a document created by this one.
+   *
+   * @category Releases
+   *
+   * @param params - Release action parameters:
+   *   - `releaseId` - The id of the release to unschedule.
+   * @param options - Additional action options.
+   * @returns A promise that resolves to the `transactionId`.
+   */
+  unschedule({ releaseId }, options) {
+    const unscheduleAction = {
+      actionType: "sanity.action.release.unschedule",
+      releaseId
+    };
+    return lastValueFrom(
+      _action(this.#client.config(), this.#httpRequest, unscheduleAction, options)
+    );
+  }
+  /**
+   * @public
+   *
+   * A delete action removes a published or archived release.
+   * The backing system document will be removed from the dataset.
+   *
+   * @category Releases
+   *
+   * @param params - Release action parameters:
+   *   - `releaseId` - The id of the release to delete.
+   * @param options - Additional action options.
+   * @returns A promise that resolves to the `transactionId`.
+   */
+  delete({ releaseId }, options) {
+    const deleteAction = {
+      actionType: "sanity.action.release.delete",
+      releaseId
+    };
+    return lastValueFrom(_action(this.#client.config(), this.#httpRequest, deleteAction, options));
+  }
+  /**
+   * @public
+   *
+   * Fetch the documents in a release by release id.
+   *
+   * @category Releases
+   *
+   * @param params - Release action parameters:
+   *   - `releaseId` - The id of the release to fetch documents for.
+   * @param options - Additional mutation options {@link BaseMutationOptions}.
+   * @returns A promise that resolves to the documents in the release.
+   */
+  fetchDocuments({ releaseId }, options) {
+    return lastValueFrom(
+      _getReleaseDocuments(this.#client.config(), this.#httpRequest, releaseId, options)
     );
   }
 }
@@ -603,9 +1155,13 @@ class UsersClient {
    */
   getById(id) {
     return lastValueFrom(
-      _request(this.#client.config(), this.#httpRequest, {
-        uri: `/users/${id}`
-      })
+      _request(
+        this.#client.config(),
+        this.#httpRequest,
+        {
+          uri: `/users/${id}`
+        }
+      )
     );
   }
 }
@@ -616,6 +1172,7 @@ class ObservableSanityClient {
   projects;
   users;
   agent;
+  releases;
   /**
    * Private properties
    */
@@ -628,7 +1185,7 @@ class ObservableSanityClient {
   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.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);
   }
   /**
    * Clone the client - returns a new instance
@@ -693,17 +1250,132 @@ class ObservableSanityClient {
     return _getDocuments(this.#clientConfig, this.#httpRequest, ids, options);
   }
   create(document, options) {
-    return _create(this.#clientConfig, this.#httpRequest, document, "create", options);
+    return _create(
+      this.#clientConfig,
+      this.#httpRequest,
+      document,
+      "create",
+      options
+    );
   }
   createIfNotExists(document, options) {
-    return _createIfNotExists(this.#clientConfig, this.#httpRequest, document, options);
+    return _createIfNotExists(
+      this.#clientConfig,
+      this.#httpRequest,
+      document,
+      options
+    );
   }
   createOrReplace(document, options) {
     return _createOrReplace(this.#clientConfig, this.#httpRequest, document, options);
   }
+  createVersion({
+    document,
+    publishedId,
+    releaseId
+  }, options) {
+    const documentVersionId = deriveDocumentVersionId("createVersion", {
+      document,
+      publishedId,
+      releaseId
+    }), documentVersion = { ...document, _id: documentVersionId }, versionPublishedId = publishedId || getPublishedId(document._id);
+    return _createVersion(
+      this.config(),
+      this.#httpRequest,
+      documentVersion,
+      versionPublishedId,
+      options
+    );
+  }
   delete(selection, options) {
     return _delete(this.#clientConfig, this.#httpRequest, selection, options);
   }
+  /**
+   * @public
+   *
+   * Deletes the draft or release version of a document.
+   *
+   * @remarks
+   * * Discarding a version with no `releaseId` will discard the draft version of the published document.
+   * * If the draft or release version does not exist, any error will throw.
+   *
+   * @param params - Version action parameters:
+   *   - `releaseId` - The ID of the release to discard the document from.
+   *   - `publishedId` - The published ID of the document to discard.
+   * @param purge - if `true` the document history is also discarded.
+   * @param options - Additional action options.
+   * @returns an observable that resolves to the `transactionId`.
+   *
+   * @example Discarding a release version of a document
+   * ```ts
+   * client.observable.discardVersion({publishedId: 'myDocument', releaseId: 'myRelease'})
+   * // The document with the ID `versions.myRelease.myDocument` will be discarded.
+   * ```
+   *
+   * @example Discarding a draft version of a document
+   * ```ts
+   * client.observable.discardVersion({publishedId: 'myDocument'})
+   * // The document with the ID `drafts.myDocument` will be discarded.
+   * ```
+   */
+  discardVersion({ releaseId, publishedId }, purge, options) {
+    const documentVersionId = getDocumentVersionId(publishedId, releaseId);
+    return _discardVersion(
+      this.config(),
+      this.#httpRequest,
+      documentVersionId,
+      purge,
+      options
+    );
+  }
+  replaceVersion({
+    document,
+    publishedId,
+    releaseId
+  }, options) {
+    const documentVersionId = deriveDocumentVersionId("replaceVersion", {
+      document,
+      publishedId,
+      releaseId
+    }), documentVersion = { ...document, _id: documentVersionId };
+    return _replaceVersion(
+      this.config(),
+      this.#httpRequest,
+      documentVersion,
+      options
+    );
+  }
+  /**
+   * @public
+   *
+   * Used to indicate when a document within a release should be unpublished when
+   * the release is run.
+   *
+   * @remarks
+   * * If the published document does not exist, an error will be thrown.
+   *
+   * @param params - Version action parameters:
+   *   - `releaseId` - The ID of the release to unpublish the document from.
+   *   - `publishedId` - The published ID of the document to unpublish.
+   * @param options - Additional action options.
+   * @returns an observable that resolves to the `transactionId`.
+   *
+   * @example Unpublishing a release version of a published document
+   * ```ts
+   * client.observable.unpublishVersion({publishedId: 'myDocument', releaseId: 'myRelease'})
+   * // The document with the ID `versions.myRelease.myDocument` will be unpublished. when `myRelease` is run.
+   * ```
+   */
+  unpublishVersion({ releaseId, publishedId }, options) {
+    const versionId = getVersionId(publishedId, releaseId);
+    return _unpublishVersion(
+      this.config(),
+      this.#httpRequest,
+      versionId,
+      publishedId,
+      options
+    );
+  }
   mutate(operations, options) {
     return _mutate(this.#clientConfig, this.#httpRequest, operations, options);
   }
@@ -768,6 +1440,7 @@ class SanityClient {
   projects;
   users;
   agent;
+  releases;
   /**
    * Observable version of the Sanity client, with the same configuration as the promise-based one
    */
@@ -784,7 +1457,7 @@ class SanityClient {
   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.projects = new ProjectsClient(this, this.#httpRequest), this.users = new UsersClient(this, this.#httpRequest), this.agent = {
       action: new AgentActionsClient(this, this.#httpRequest)
-    }, this.observable = new ObservableSanityClient(httpRequest, config);
+    }, this.releases = new ReleasesClient(this, this.#httpRequest), this.observable = new ObservableSanityClient(httpRequest, config);
   }
   /**
    * Clone the client - returns a new instance
@@ -836,7 +1509,9 @@ class SanityClient {
    * @param options - Request options
    */
   getDocument(id, options) {
-    return lastValueFrom(_getDocument(this.#clientConfig, this.#httpRequest, id, options));
+    return lastValueFrom(
+      _getDocument(this.#clientConfig, this.#httpRequest, id, options)
+    );
   }
   /**
    * Fetch multiple documents in one request.
@@ -848,7 +1523,9 @@ class SanityClient {
    * @param options - Request options
    */
   getDocuments(ids, options) {
-    return lastValueFrom(_getDocuments(this.#clientConfig, this.#httpRequest, ids, options));
+    return lastValueFrom(
+      _getDocuments(this.#clientConfig, this.#httpRequest, ids, options)
+    );
   }
   create(document, options) {
     return lastValueFrom(
@@ -865,11 +1542,122 @@ class SanityClient {
       _createOrReplace(this.#clientConfig, this.#httpRequest, document, options)
     );
   }
+  createVersion({
+    document,
+    publishedId,
+    releaseId
+  }, options) {
+    const documentVersionId = deriveDocumentVersionId("createVersion", {
+      document,
+      publishedId,
+      releaseId
+    }), documentVersion = { ...document, _id: documentVersionId }, versionPublishedId = publishedId || getPublishedId(document._id);
+    return firstValueFrom(
+      _createVersion(
+        this.config(),
+        this.#httpRequest,
+        documentVersion,
+        versionPublishedId,
+        options
+      )
+    );
+  }
   delete(selection, options) {
-    return lastValueFrom(_delete(this.#clientConfig, this.#httpRequest, selection, options));
+    return lastValueFrom(
+      _delete(this.#clientConfig, this.#httpRequest, selection, options)
+    );
+  }
+  /**
+   * @public
+   *
+   * Deletes the draft or release version of a document.
+   *
+   * @remarks
+   * * Discarding a version with no `releaseId` will discard the draft version of the published document.
+   * * If the draft or release version does not exist, any error will throw.
+   *
+   * @param params - Version action parameters:
+   *   - `releaseId` - The ID of the release to discard the document from.
+   *   - `publishedId` - The published ID of the document to discard.
+   * @param purge - if `true` the document history is also discarded.
+   * @param options - Additional action options.
+   * @returns a promise that resolves to the `transactionId`.
+   *
+   * @example Discarding a release version of a document
+   * ```ts
+   * client.discardVersion({publishedId: 'myDocument', releaseId: 'myRelease'})
+   * // The document with the ID `versions.myRelease.myDocument` will be discarded.
+   * ```
+   *
+   * @example Discarding a draft version of a document
+   * ```ts
+   * client.discardVersion({publishedId: 'myDocument'})
+   * // The document with the ID `drafts.myDocument` will be discarded.
+   * ```
+   */
+  discardVersion({ releaseId, publishedId }, purge, options) {
+    const documentVersionId = getDocumentVersionId(publishedId, releaseId);
+    return lastValueFrom(
+      _discardVersion(
+        this.config(),
+        this.#httpRequest,
+        documentVersionId,
+        purge,
+        options
+      )
+    );
+  }
+  replaceVersion({
+    document,
+    publishedId,
+    releaseId
+  }, options) {
+    const documentVersionId = deriveDocumentVersionId("replaceVersion", {
+      document,
+      publishedId,
+      releaseId
+    }), documentVersion = { ...document, _id: documentVersionId };
+    return firstValueFrom(
+      _replaceVersion(this.config(), this.#httpRequest, documentVersion, options)
+    );
+  }
+  /**
+   * @public
+   *
+   * Used to indicate when a document within a release should be unpublished when
+   * the release is run.
+   *
+   * @remarks
+   * * If the published document does not exist, an error will be thrown.
+   *
+   * @param params - Version action parameters:
+   *   - `releaseId` - The ID of the release to unpublish the document from.
+   *   - `publishedId` - The published ID of the document to unpublish.
+   * @param options - Additional action options.
+   * @returns a promise that resolves to the `transactionId`.
+   *
+   * @example Unpublishing a release version of a published document
+   * ```ts
+   * await client.unpublishVersion({publishedId: 'myDocument', releaseId: 'myRelease'})
+   * // The document with the ID `versions.myRelease.myDocument` will be unpublished. when `myRelease` is run.
+   * ```
+   */
+  unpublishVersion({ releaseId, publishedId }, options) {
+    const versionId = getVersionId(publishedId, releaseId);
+    return lastValueFrom(
+      _unpublishVersion(
+        this.config(),
+        this.#httpRequest,
+        versionId,
+        publishedId,
+        options
+      )
+    );
   }
   mutate(operations, options) {
-    return lastValueFrom(_mutate(this.#clientConfig, this.#httpRequest, operations, options));
+    return lastValueFrom(
+      _mutate(this.#clientConfig, this.#httpRequest, operations, options)
+    );
   }
   /**
    * Create a new buildable patch of operations to perform
@@ -897,7 +1685,9 @@ class SanityClient {
    * @param options - Action options
    */
   action(operations, options) {
-    return lastValueFrom(_action(this.#clientConfig, this.#httpRequest, operations, options));
+    return lastValueFrom(
+      _action(this.#clientConfig, this.#httpRequest, operations, options)
+    );
   }
   /**
    * Perform a request against the Sanity API
@@ -920,7 +1710,9 @@ class SanityClient {
    * @internal
    */
   dataRequest(endpoint, body, options) {
-    return lastValueFrom(_dataRequest(this.#clientConfig, this.#httpRequest, endpoint, body, options));
+    return lastValueFrom(
+      _dataRequest(this.#clientConfig, this.#httpRequest, endpoint, body, options)
+    );
   }
   /**
    * Get a Sanity API URL for the URI provided
@@ -960,7 +1752,7 @@ function defineDeprecatedCreateClient(createClient2) {
     return printNoDefaultExport(), createClient2(config);
   };
 }
-var name = "@sanity/client", version = "7.1.0-views.0";
+var name = "@sanity/client", version = "7.1.0-views.1";
 const middleware = [
   debug({ verbose: !0, namespace: "sanity:client" }),
   headers({ "User-Agent": `${name} ${version}` }),
@@ -995,9 +1787,12 @@ export {
   SanityClient,
   ServerError,
   Transaction,
+  ViewResourceType,
   connectEventSource,
   createClient,
   deprecatedCreateClient as default,
+  formatQueryParseError,
+  isQueryParseError,
   requester,
   adapter as unstable__adapter,
   environment as unstable__environment,