@sanity/client 6.22.5 → 6.23.0

package/dist/index.browser.d.cts

@@ -2061,6 +2061,8 @@ export declare interface QueryParams {
   useCdn?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
   lastLiveEventId?: never
+  /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
+  cacheMode?: never
 }
 
 /**
@@ -2102,6 +2104,7 @@ export declare interface RawRequestOptions {
   proxy?: string
   body?: Any
   maxRedirects?: number
+  signal?: AbortSignal
 }
 
 /**
@@ -2145,6 +2148,7 @@ export declare interface RequestObservableOptions extends Omit<RequestOptions, '
   resultSourceMap?: boolean | 'withKeyArraySelector'
   perspective?: ClientPerspective
   lastLiveEventId?: string
+  cacheMode?: 'noStale'
 }
 
 /** @public */
@@ -2182,6 +2186,13 @@ export declare interface ResponseQueryOptions extends RequestOptions {
   cache?: 'next' extends keyof RequestInit ? RequestInit['cache'] : never
   next?: ('next' extends keyof RequestInit ? RequestInit : never)['next']
   lastLiveEventId?: string | string[] | null
+  /**
+   * When set to `noStale`, APICDN will not return a cached response if the content is stale.
+   * Tradeoff between latency and freshness of content.
+   *
+   * Only to be used with live content queries and when useCdn is true.
+   */
+  cacheMode?: 'noStale'
 }
 
 /** @internal */

package/dist/index.browser.d.ts

@@ -2061,6 +2061,8 @@ export declare interface QueryParams {
   useCdn?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
   lastLiveEventId?: never
+  /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
+  cacheMode?: never
 }
 
 /**
@@ -2102,6 +2104,7 @@ export declare interface RawRequestOptions {
   proxy?: string
   body?: Any
   maxRedirects?: number
+  signal?: AbortSignal
 }
 
 /**
@@ -2145,6 +2148,7 @@ export declare interface RequestObservableOptions extends Omit<RequestOptions, '
   resultSourceMap?: boolean | 'withKeyArraySelector'
   perspective?: ClientPerspective
   lastLiveEventId?: string
+  cacheMode?: 'noStale'
 }
 
 /** @public */
@@ -2182,6 +2186,13 @@ export declare interface ResponseQueryOptions extends RequestOptions {
   cache?: 'next' extends keyof RequestInit ? RequestInit['cache'] : never
   next?: ('next' extends keyof RequestInit ? RequestInit : never)['next']
   lastLiveEventId?: string | string[] | null
+  /**
+   * When set to `noStale`, APICDN will not return a cached response if the content is stale.
+   * Tradeoff between latency and freshness of content.
+   *
+   * Only to be used with live content queries and when useCdn is true.
+   */
+  cacheMode?: 'noStale'
 }
 
 /** @internal */

package/dist/index.browser.js

@@ -698,7 +698,7 @@ function _action(client, httpRequest, actions, options) {
   );
 }
 function _dataRequest(client, httpRequest, endpoint, body, options = {}) {
-  const isMutation = endpoint === "mutate", isAction = endpoint === "actions", isQuery = endpoint === "query", strQuery = isMutation || isAction ? "" : encodeQueryString(body), useGet = !isMutation && !isAction && strQuery.length < getQuerySizeLimit, stringQuery = useGet ? strQuery : "", returnFirst = options.returnFirst, { timeout, token, tag, headers, returnQuery, lastLiveEventId } = options, uri = _getDataUrl(client, endpoint, stringQuery), reqOptions = {
+  const isMutation = endpoint === "mutate", isAction = endpoint === "actions", isQuery = endpoint === "query", strQuery = isMutation || isAction ? "" : encodeQueryString(body), useGet = !isMutation && !isAction && strQuery.length < getQuerySizeLimit, stringQuery = useGet ? strQuery : "", returnFirst = options.returnFirst, { timeout, token, tag, headers, returnQuery, lastLiveEventId, cacheMode } = options, uri = _getDataUrl(client, endpoint, stringQuery), reqOptions = {
     method: useGet ? "GET" : "POST",
     uri,
     json: !0,
@@ -712,6 +712,7 @@ function _dataRequest(client, httpRequest, endpoint, body, options = {}) {
     perspective: options.perspective,
     resultSourceMap: options.resultSourceMap,
     lastLiveEventId: Array.isArray(lastLiveEventId) ? lastLiveEventId[0] : lastLiveEventId,
+    cacheMode,
     canUseCdn: isQuery,
     signal: options.signal,
     fetch: options.fetch,
@@ -748,7 +749,7 @@ function _requestObservable(client, httpRequest, options) {
     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 });
+    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 reqOptions = requestOptions(
     config,