@sanity/client 6.23.0 → 6.24.0-canary.0

package/dist/index.browser.d.cts

@@ -390,7 +390,12 @@ export declare class ClientError extends Error {
 }
 
 /** @public */
-export declare type ClientPerspective = 'previewDrafts' | 'published' | 'raw'
+export declare type ClientPerspective =
+  | 'previewDrafts'
+  | 'published'
+  | 'drafts'
+  | 'raw'
+  | ('published' | 'drafts' | ReleaseId)[]
 
 /** @public */
 export declare type ClientReturn<
@@ -2116,6 +2121,9 @@ export declare type ReconnectEvent = {
   type: 'reconnect'
 }
 
+/** @public */
+export declare type ReleaseId = `r${string}`
+
 /**
  * Replaces an existing draft document.
  * At least one of the draft or published versions of the document must exist.

package/dist/index.browser.d.ts

@@ -390,7 +390,12 @@ export declare class ClientError extends Error {
 }
 
 /** @public */
-export declare type ClientPerspective = 'previewDrafts' | 'published' | 'raw'
+export declare type ClientPerspective =
+  | 'previewDrafts'
+  | 'published'
+  | 'drafts'
+  | 'raw'
+  | ('published' | 'drafts' | ReleaseId)[]
 
 /** @public */
 export declare type ClientReturn<
@@ -2116,6 +2121,9 @@ export declare type ReconnectEvent = {
   type: 'reconnect'
 }
 
+/** @public */
+export declare type ReleaseId = `r${string}`
+
 /**
  * Replaces an existing draft document.
  * At least one of the draft or published versions of the document must exist.

package/dist/index.browser.js

@@ -522,8 +522,17 @@ function validateApiVersion(apiVersion) {
     throw new Error("Invalid API version string, expected `1` or date in format `YYYY-MM-DD`");
 }
 const validateApiPerspective = function(perspective) {
+  if (Array.isArray(perspective)) {
+    for (const perspectiveValue of perspective)
+      if (perspectiveValue !== "published" && perspectiveValue !== "drafts" && !(typeof perspectiveValue == "string" && perspectiveValue.startsWith("r") && perspectiveValue !== "raw"))
+        throw new TypeError(
+          "Invalid API perspective value, expected `published`, `drafts` or a valid release identifier string"
+        );
+    return;
+  }
   switch (perspective) {
     case "previewDrafts":
+    case "drafts":
     case "published":
     case "raw":
       return;
@@ -552,7 +561,7 @@ const validateApiPerspective = function(perspective) {
   }
   if (projectBased && !newConfig.projectId)
     throw new Error("Configuration must contain `projectId`");
-  if (typeof newConfig.perspective == "string" && validateApiPerspective(newConfig.perspective), "encodeSourceMap" in newConfig)
+  if (typeof newConfig.perspective < "u" && validateApiPerspective(newConfig.perspective), "encodeSourceMap" in newConfig)
     throw new Error(
       "It looks like you're using options meant for '@sanity/preview-kit/client'. 'encodeSourceMap' is not supported in '@sanity/client'. Did you mean 'stega.enabled'?"
     );
@@ -748,8 +757,11 @@ function _requestObservable(client, httpRequest, options) {
   if (tag && options.tag !== null && (options.query = { tag: requestTag(tag), ...options.query }), ["GET", "HEAD", "POST"].indexOf(options.method || "GET") >= 0 && uri.indexOf("/data/query/") === 0) {
     const resultSourceMap = options.resultSourceMap ?? config.resultSourceMap;
     resultSourceMap !== void 0 && resultSourceMap !== !1 && (options.query = { resultSourceMap, ...options.query });
-    const perspective = options.perspective || config.perspective;
-    typeof perspective == "string" && perspective !== "raw" && (validateApiPerspective(perspective), options.query = { perspective, ...options.query }, perspective === "previewDrafts" && useCdn && (useCdn = !1, printCdnPreviewDraftsWarning())), options.lastLiveEventId && (options.query = { ...options.query, lastLiveEventId: options.lastLiveEventId }), options.returnQuery === !1 && (options.query = { returnQuery: "false", ...options.query }), useCdn && options.cacheMode == "noStale" && (options.query = { cacheMode: "noStale", ...options.query });
+    const perspectiveOption = options.perspective || config.perspective;
+    typeof perspectiveOption < "u" && (validateApiPerspective(perspectiveOption), options.query = {
+      perspective: Array.isArray(perspectiveOption) ? perspectiveOption.join(",") : perspectiveOption,
+      ...options.query
+    }, perspectiveOption === "previewDrafts" && useCdn && (useCdn = !1, printCdnPreviewDraftsWarning())), options.lastLiveEventId && (options.query = { ...options.query, lastLiveEventId: options.lastLiveEventId }), options.returnQuery === !1 && (options.query = { returnQuery: "false", ...options.query }), useCdn && options.cacheMode == "noStale" && (options.query = { cacheMode: "noStale", ...options.query });
   }
   const reqOptions = requestOptions(
     config,