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

package/dist/index.cjs

@@ -21,7 +21,11 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 Object.defineProperty(exports, "__esModule", { value: !0 });
 var dataMethods = require("./_chunks-cjs/dataMethods.cjs");
 require("./_chunks-cjs/stegaClean.cjs");
-var rxjs = require("rxjs"), operators = require("rxjs/operators"), config = require("./_chunks-cjs/config.cjs"), middleware$1 = require("get-it/middleware"), getIt = require("get-it");
+var rxjs = require("rxjs"), operators = require("rxjs/operators"), config = require("./_chunks-cjs/config.cjs"), middleware$1 = require("get-it/middleware"), csm = require("@sanity/client/csm"), crypto = require("crypto"), getIt = require("get-it");
+function _interopDefaultCompat(e) {
+  return e && typeof e == "object" && "default" in e ? e : { default: e };
+}
+var crypto__default = /* @__PURE__ */ _interopDefaultCompat(crypto), ViewResourceType = /* @__PURE__ */ ((ViewResourceType2) => (ViewResourceType2.Dataset = "dataset", ViewResourceType2))(ViewResourceType || {});
 class ConnectionFailedError extends Error {
   name = "ConnectionFailedError";
 }
@@ -81,7 +85,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") {
@@ -120,8 +125,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 ? dataMethods.isQueryParseError(error) ? dataMethods.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)
@@ -136,6 +142,22 @@ function _generate(client, httpRequest, request) {
     body: request
   });
 }
+function _patch(client, httpRequest, request) {
+  const dataset = config.hasDataset(client.config());
+  return dataMethods._request(client.config(), httpRequest, {
+    method: "POST",
+    uri: `/agent/action/patch/${dataset}`,
+    body: request
+  });
+}
+function _prompt(client, httpRequest, request) {
+  const dataset = config.hasDataset(client.config());
+  return dataMethods._request(client.config(), httpRequest, {
+    method: "POST",
+    uri: `/agent/action/prompt/${dataset}`,
+    body: request
+  });
+}
 function _transform(client, httpRequest, request) {
   const dataset = config.hasDataset(client.config());
   return dataMethods._request(client.config(), httpRequest, {
@@ -207,6 +229,21 @@ class AgentActionsClient {
   translate(request) {
     return rxjs.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 rxjs.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 rxjs.lastValueFrom(_patch(this.#client, this.#httpRequest, request));
+  }
 }
 class ObservableAssetsClient {
   #client;
@@ -315,13 +352,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 = dataMethods.encodeQueryString({ query, params, options: { tag, ...listenOpts } }), uri = `${url}${dataMethods._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 = dataMethods.encodeQueryString({ query, params, options: { tag, ...listenOpts } }), uri = `${url}${dataMethods._getDataUrl(this.config(), "listen", qs)}`;
   if (uri.length > MAX_URL_LENGTH)
     return rxjs.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 : rxjs.of(EventSource)).pipe(operators.map((EventSource2) => new EventSource2(uri, esOptions)))
   ), listenFor).pipe(
@@ -379,7 +414,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(
@@ -392,9 +428,7 @@ class LiveClient {
     const path = dataMethods._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;
@@ -532,7 +566,10 @@ class DatasetsClient {
    */
   list() {
     return config.resourceGuard("dataset", this.#client.config()), rxjs.lastValueFrom(
-      dataMethods._request(this.#client.config(), this.#httpRequest, { uri: "/datasets", tag: null })
+      dataMethods._request(this.#client.config(), this.#httpRequest, {
+        uri: "/datasets",
+        tag: null
+      })
     );
   }
 }
@@ -561,7 +598,9 @@ class ObservableProjectsClient {
    * @param projectId - ID of the project to fetch
    */
   getById(projectId) {
-    return config.resourceGuard("projects", this.#client.config()), dataMethods._request(this.#client.config(), this.#httpRequest, { uri: `/projects/${projectId}` });
+    return config.resourceGuard("projects", this.#client.config()), dataMethods._request(this.#client.config(), this.#httpRequest, {
+      uri: `/projects/${projectId}`
+    });
   }
 }
 class ProjectsClient {
@@ -582,7 +621,521 @@ class ProjectsClient {
    */
   getById(projectId) {
     return config.resourceGuard("projects", this.#client.config()), rxjs.lastValueFrom(
-      dataMethods._request(this.#client.config(), this.#httpRequest, { uri: `/projects/${projectId}` })
+      dataMethods._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__default.default.randomFillSync(pool), poolOffset = 0) : poolOffset + bytes > pool.length && (crypto__default.default.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 ? csm.getVersionId(publishedId, releaseId) : csm.getDraftId(publishedId);
+function deriveDocumentVersionId(op, {
+  releaseId,
+  publishedId,
+  document
+}) {
+  if (publishedId && document._id) {
+    const versionId = getDocumentVersionId(publishedId, releaseId);
+    return config.validateVersionIdMatch(versionId, document), versionId;
+  }
+  if (document._id) {
+    const isDraft = csm.isDraftId(document._id), isVersion = csm.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 = csm.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 dataMethods._getDocument(
+      this.#client.config(),
+      this.#httpRequest,
+      `_.releases.${releaseId}`,
+      options
+    );
+  }
+  create(releaseOrOptions, maybeOptions) {
+    const { action, options } = createRelease(releaseOrOptions, maybeOptions), { releaseId, metadata } = action;
+    return dataMethods._action(this.#client.config(), this.#httpRequest, action, options).pipe(
+      rxjs.map((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 dataMethods._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 dataMethods._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 dataMethods._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 dataMethods._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 dataMethods._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 dataMethods._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 dataMethods._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 dataMethods._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 rxjs.lastValueFrom(
+      dataMethods._getDocument(
+        this.#client.config(),
+        this.#httpRequest,
+        `_.releases.${releaseId}`,
+        options
+      )
+    );
+  }
+  async create(releaseOrOptions, maybeOptions) {
+    const { action, options } = createRelease(releaseOrOptions, maybeOptions), { releaseId, metadata } = action;
+    return { ...await rxjs.lastValueFrom(
+      dataMethods._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 rxjs.lastValueFrom(dataMethods._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 rxjs.lastValueFrom(dataMethods._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 rxjs.lastValueFrom(dataMethods._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 rxjs.lastValueFrom(
+      dataMethods._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 rxjs.lastValueFrom(dataMethods._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 rxjs.lastValueFrom(
+      dataMethods._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 rxjs.lastValueFrom(dataMethods._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 rxjs.lastValueFrom(
+      dataMethods._getReleaseDocuments(this.#client.config(), this.#httpRequest, releaseId, options)
     );
   }
 }
@@ -618,9 +1171,13 @@ class UsersClient {
    */
   getById(id) {
     return rxjs.lastValueFrom(
-      dataMethods._request(this.#client.config(), this.#httpRequest, {
-        uri: `/users/${id}`
-      })
+      dataMethods._request(
+        this.#client.config(),
+        this.#httpRequest,
+        {
+          uri: `/users/${id}`
+        }
+      )
     );
   }
 }
@@ -631,6 +1188,7 @@ class ObservableSanityClient {
   projects;
   users;
   agent;
+  releases;
   /**
    * Private properties
    */
@@ -643,7 +1201,7 @@ class ObservableSanityClient {
   constructor(httpRequest, config$1 = config.defaultConfig) {
     this.config(config$1), 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
@@ -708,17 +1266,132 @@ class ObservableSanityClient {
     return dataMethods._getDocuments(this.#clientConfig, this.#httpRequest, ids, options);
   }
   create(document, options) {
-    return dataMethods._create(this.#clientConfig, this.#httpRequest, document, "create", options);
+    return dataMethods._create(
+      this.#clientConfig,
+      this.#httpRequest,
+      document,
+      "create",
+      options
+    );
   }
   createIfNotExists(document, options) {
-    return dataMethods._createIfNotExists(this.#clientConfig, this.#httpRequest, document, options);
+    return dataMethods._createIfNotExists(
+      this.#clientConfig,
+      this.#httpRequest,
+      document,
+      options
+    );
   }
   createOrReplace(document, options) {
     return dataMethods._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 || csm.getPublishedId(document._id);
+    return dataMethods._createVersion(
+      this.config(),
+      this.#httpRequest,
+      documentVersion,
+      versionPublishedId,
+      options
+    );
+  }
   delete(selection, options) {
     return dataMethods._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 dataMethods._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 dataMethods._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 = csm.getVersionId(publishedId, releaseId);
+    return dataMethods._unpublishVersion(
+      this.config(),
+      this.#httpRequest,
+      versionId,
+      publishedId,
+      options
+    );
+  }
   mutate(operations, options) {
     return dataMethods._mutate(this.#clientConfig, this.#httpRequest, operations, options);
   }
@@ -783,6 +1456,7 @@ class SanityClient {
   projects;
   users;
   agent;
+  releases;
   /**
    * Observable version of the Sanity client, with the same configuration as the promise-based one
    */
@@ -799,7 +1473,7 @@ class SanityClient {
   constructor(httpRequest, config$1 = config.defaultConfig) {
     this.config(config$1), 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$1);
+    }, this.releases = new ReleasesClient(this, this.#httpRequest), this.observable = new ObservableSanityClient(httpRequest, config$1);
   }
   /**
    * Clone the client - returns a new instance
@@ -851,7 +1525,9 @@ class SanityClient {
    * @param options - Request options
    */
   getDocument(id, options) {
-    return rxjs.lastValueFrom(dataMethods._getDocument(this.#clientConfig, this.#httpRequest, id, options));
+    return rxjs.lastValueFrom(
+      dataMethods._getDocument(this.#clientConfig, this.#httpRequest, id, options)
+    );
   }
   /**
    * Fetch multiple documents in one request.
@@ -863,7 +1539,9 @@ class SanityClient {
    * @param options - Request options
    */
   getDocuments(ids, options) {
-    return rxjs.lastValueFrom(dataMethods._getDocuments(this.#clientConfig, this.#httpRequest, ids, options));
+    return rxjs.lastValueFrom(
+      dataMethods._getDocuments(this.#clientConfig, this.#httpRequest, ids, options)
+    );
   }
   create(document, options) {
     return rxjs.lastValueFrom(
@@ -880,11 +1558,122 @@ class SanityClient {
       dataMethods._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 || csm.getPublishedId(document._id);
+    return rxjs.firstValueFrom(
+      dataMethods._createVersion(
+        this.config(),
+        this.#httpRequest,
+        documentVersion,
+        versionPublishedId,
+        options
+      )
+    );
+  }
   delete(selection, options) {
-    return rxjs.lastValueFrom(dataMethods._delete(this.#clientConfig, this.#httpRequest, selection, options));
+    return rxjs.lastValueFrom(
+      dataMethods._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 rxjs.lastValueFrom(
+      dataMethods._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 rxjs.firstValueFrom(
+      dataMethods._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 = csm.getVersionId(publishedId, releaseId);
+    return rxjs.lastValueFrom(
+      dataMethods._unpublishVersion(
+        this.config(),
+        this.#httpRequest,
+        versionId,
+        publishedId,
+        options
+      )
+    );
   }
   mutate(operations, options) {
-    return rxjs.lastValueFrom(dataMethods._mutate(this.#clientConfig, this.#httpRequest, operations, options));
+    return rxjs.lastValueFrom(
+      dataMethods._mutate(this.#clientConfig, this.#httpRequest, operations, options)
+    );
   }
   /**
    * Create a new buildable patch of operations to perform
@@ -912,7 +1701,9 @@ class SanityClient {
    * @param options - Action options
    */
   action(operations, options) {
-    return rxjs.lastValueFrom(dataMethods._action(this.#clientConfig, this.#httpRequest, operations, options));
+    return rxjs.lastValueFrom(
+      dataMethods._action(this.#clientConfig, this.#httpRequest, operations, options)
+    );
   }
   /**
    * Perform a request against the Sanity API
@@ -935,7 +1726,9 @@ class SanityClient {
    * @internal
    */
   dataRequest(endpoint, body, options) {
-    return rxjs.lastValueFrom(dataMethods._dataRequest(this.#clientConfig, this.#httpRequest, endpoint, body, options));
+    return rxjs.lastValueFrom(
+      dataMethods._dataRequest(this.#clientConfig, this.#httpRequest, endpoint, body, options)
+    );
   }
   /**
    * Get a Sanity API URL for the URI provided
@@ -975,7 +1768,7 @@ function defineDeprecatedCreateClient(createClient2) {
     return config.printNoDefaultExport(), createClient2(config$1);
   };
 }
-var name = "@sanity/client", version = "7.1.0-views.0";
+var name = "@sanity/client", version = "7.1.0-views.1";
 const middleware = [
   middleware$1.debug({ verbose: !0, namespace: "sanity:client" }),
   middleware$1.headers({ "User-Agent": `${name} ${version}` }),
@@ -1002,6 +1795,8 @@ exports.ObservableTransaction = dataMethods.ObservableTransaction;
 exports.Patch = dataMethods.Patch;
 exports.ServerError = dataMethods.ServerError;
 exports.Transaction = dataMethods.Transaction;
+exports.formatQueryParseError = dataMethods.formatQueryParseError;
+exports.isQueryParseError = dataMethods.isQueryParseError;
 exports.validateApiPerspective = config.validateApiPerspective;
 Object.defineProperty(exports, "unstable__adapter", {
   enumerable: !0,
@@ -1022,6 +1817,7 @@ exports.MessageError = MessageError;
 exports.MessageParseError = MessageParseError;
 exports.ObservableSanityClient = ObservableSanityClient;
 exports.SanityClient = SanityClient;
+exports.ViewResourceType = ViewResourceType;
 exports.connectEventSource = connectEventSource;
 exports.createClient = createClient;
 exports.default = deprecatedCreateClient;