@sanity/client 6.4.7 → 6.4.9

package/README.md

@@ -58,6 +58,7 @@ export async function updateDocumentTitle(_id, title) {
     - [ESM](#esm)
     - [CommonJS](#commonjs)
     - [TypeScript](#typescript)
+    - [Next.js App Router](#nextjs-app-router)
     - [Bun](#bun)
     - [Deno](#deno)
     - [Edge Runtime](#edge-runtime)
@@ -201,6 +202,43 @@ console.log(`Number of documents: ${data}`)
 
 Another alternative is [groqd].
 
+#### [Next.js App Router](https://nextjs.org/docs/app/building-your-application/data-fetching/fetching-caching-and-revalidating#fetching-data-on-the-server-with-fetch)
+
+```tsx
+import {createClient} from '@sanity/client'
+
+const client = createClient({
+  projectId: 'your-project-id',
+  dataset: 'your-dataset-name',
+  useCdn: true, // set to `false` to bypass the edge cache
+  apiVersion: '2023-05-03', // use current date (YYYY-MM-DD) to target the latest API version
+})
+
+export default async function ReactServerComponent() {
+  const data = await client.fetch<number>(
+    `count(*[_type == "page"])`,
+    {},
+    {
+      // You can set any of the `cache` and `next` options as you would on a standard `fetch` call
+      cache: 'force-cache',
+      next: {tags: ['pages']},
+    },
+  )
+
+  return <h1>Number of pages: {data}</h1>
+}
+```
+
+The `cache` and `next` options are documented in the [Next.js documentation](https://nextjs.org/docs/app/api-reference/functions/fetch#fetchurl-options).
+Since [request memoization](https://nextjs.org/docs/app/building-your-application/caching#request-memoization) is supported it's unnecessary to use [the `React.cache`](https://nextjs.org/docs/app/building-your-application/caching#react-cache-function) API.
+To [opt-out of memoization](https://nextjs.org/docs/app/building-your-application/caching#opting-out), set the `signal` property:
+
+```tsx
+const {signal} = new AbortController()
+// By passing `signal` this request will not be memoized and `now()` will execute for every React Server Component that runs this query
+const data = await client.fetch<number>(`{"dynamic": now()}`, {}, {signal})
+```
+
 #### [Bun]
 
 ```bash

package/dist/index.browser.cjs

@@ -225,6 +225,7 @@ once(function () {
   return console.warn(message.join(" "), ...args);
 });
 const printCdnWarning = createWarningPrinter(["Since you haven't set a value for `useCdn`, we will deliver content using our", "global, edge-cached API-CDN. If you wish to have content delivered faster, set", "`useCdn: false` to use the Live API. Note: You may incur higher costs using the live API."]);
+const printCdnPreviewDraftsWarning = createWarningPrinter(["The Sanity client is configured with the `perspective` set to `previewDrafts`, which doesn't support the API-CDN.", "The Live API will be used instead. Set `useCdn: false` in your configuration to hide this warning."]);
 const printBrowserTokenWarning = createWarningPrinter(["You have configured Sanity client to use a token in the browser. This may cause unintentional security issues.", "See ".concat(generateHelpUrl("js-client-browser-token"), " for more information and how to hide this warning.")]);
 const printNoApiVersionSpecifiedWarning = createWarningPrinter(["Using the Sanity client without specifying an API version is deprecated.", "See ".concat(generateHelpUrl("js-client-api-version"))]);
 const printNoDefaultExport = createWarningPrinter(["The default export of @sanity/client has been deprecated. Use the named export `createClient` instead."]);
@@ -1005,7 +1006,7 @@ function _requestObservable(client, httpRequest, options) {
   const uri = options.url || options.uri;
   const config = client.config();
   const canUseCdn = typeof options.canUseCdn === "undefined" ? ["GET", "HEAD"].indexOf(options.method || "GET") >= 0 && uri.indexOf("/data/") === 0 : options.canUseCdn;
-  const useCdn = config.useCdn && canUseCdn;
+  let useCdn = config.useCdn && canUseCdn;
   const tag = options.tag && config.requestTagPrefix ? [config.requestTagPrefix, options.tag].join(".") : options.tag || config.requestTagPrefix;
   if (tag) {
     options.query = {
@@ -1027,6 +1028,10 @@ function _requestObservable(client, httpRequest, options) {
         perspective,
         ...options.query
       };
+      if (perspective === "previewDrafts" && useCdn) {
+        useCdn = false;
+        printCdnPreviewDraftsWarning();
+      }
     }
   }
   const reqOptions = requestOptions(config, Object.assign({}, options, {