@sanity/client 5.0.0-esm.10 → 5.0.0-esm.11

package/README.md

@@ -19,7 +19,7 @@ Import and create a new client instance, and use its methods to interact with yo
 
 ```js
 // sanity.js
-import {createClient} from '@sanity/client'
+import {createClient} from '@sanity/client'
 // Import using ESM URL imports in environments that supports it:
 // import {createClient} from 'https://esm.sh/@sanity/client'
 
@@ -127,13 +127,13 @@ import {createClient} from '@sanity/client'
 
 const client = createClient({
   projectId: 'your-project-id',
-  dataset: 'bikeshop',
-  apiVersion: '2021-03-25', // use current UTC date - see "specifying API version"!
-  token: 'sanity-auth-token', // or leave blank for unauthenticated usage
-  useCdn: true, // `false` if you want to ensure fresh data
+  dataset: 'your-dataset-name',
+  useCdn: false, // set to `true` to fetch from edge cache
+  apiVersion: '2022-01-12', // use current date (YYYY-MM-DD) to target the latest API version
 })
 
-export default client
+const data = await client.fetch(`count(*)`)
+console.log(`Number of documents: ${data}`)
 ```
 
 #### [CommonJS]
@@ -143,13 +143,15 @@ const {createClient} = require('@sanity/client')
 
 const client = createClient({
   projectId: 'your-project-id',
-  dataset: 'bikeshop',
-  apiVersion: '2021-03-25', // use current UTC date - see "specifying API version"!
-  token: 'sanity-auth-token', // or leave blank for unauthenticated usage
-  useCdn: true, // `false` if you want to ensure fresh data
+  dataset: 'your-dataset-name',
+  useCdn: false, // set to `true` to fetch from edge cache
+  apiVersion: '2022-01-12', // use current date (YYYY-MM-DD) to target the latest API version
 })
 
-module.exports = client
+client
+  .fetch(`count(*)`)
+  .then((data) => console.log(`Number of documents: ${data}`))
+  .catch(console.error)
 ```
 
 #### [TypeScript]
@@ -157,17 +159,41 @@ module.exports = client
 ```ts
 import {createClient, type ClientConfig} from '@sanity/client'
 
-const client: ClientConfig = {
+const config: ClientConfig = {
   projectId: 'your-project-id',
-  dataset: 'bikeshop',
-  apiVersion: '2021-03-25', // use current UTC date - see "specifying API version"!
-  token: 'sanity-auth-token', // or leave blank for unauthenticated usage
-  useCdn: true, // `false` if you want to ensure fresh data
+  dataset: 'your-dataset-name',
+  useCdn: false, // set to `true` to fetch from edge cache
+  apiVersion: '2022-01-12', // use current date (YYYY-MM-DD) to target the latest API version
 }
+const client = createClient(config)
+
+const data = await client.fetch<number>(`count(*)`)
+// data is typed as `number`
+console.log(`Number of documents: ${data}`)
+```
+
+We're currently exploring typed GROQ queries that are runtime safe, and will share more when we've landed on a solution we're satisifed with.
+Until then you can achieve this using [Zod]:
+
+```ts
+import {createClient} from '@sanity/client'
+import {z} from 'zod'
 
-export default createClient(config)
+const client = createClient({
+  projectId: 'your-project-id',
+  dataset: 'your-dataset-name',
+  useCdn: false, // set to `true` to fetch from edge cache
+  apiVersion: '2022-01-12', // use current date (YYYY-MM-DD) to target the latest API version
+})
+
+const schema = z.number()
+const data = schema.parse(await client.fetch(`count(*)`))
+// data is guaranteed to be `number`, or zod will throw an error
+console.log(`Number of documents: ${data}`)
 ```
 
+Another alternative is [groqd].
+
 #### [Bun]
 
 ```bash
@@ -182,13 +208,12 @@ import {createClient} from '@sanity/client'
 
 const client = createClient({
   projectId: 'your-project-id',
-  dataset: 'bikeshop',
-  apiVersion: '2021-03-25', // use current UTC date - see "specifying API version"!
-  token: 'sanity-auth-token', // or leave blank for unauthenticated usage
-  useCdn: true, // `false` if you want to ensure fresh data
+  dataset: 'your-dataset-name',
+  useCdn: false, // set to `true` to fetch from edge cache
+  apiVersion: '2022-01-12', // use current date (YYYY-MM-DD) to target the latest API version
 })
 
-const data = await client.fetch(`count(*[])`)
+const data = await client.fetch<number>(`count(*)`)
 
 console.write(`Number of documents: ${data}`)
 ```
@@ -211,13 +236,12 @@ import {createClient} from 'https://esm.sh/@sanity/client'
 
 const client = createClient({
   projectId: 'your-project-id',
-  dataset: 'bikeshop',
-  apiVersion: '2021-03-25', // use current UTC date - see "specifying API version"!
-  token: 'sanity-auth-token', // or leave blank for unauthenticated usage
-  useCdn: true, // `false` if you want to ensure fresh data
+  dataset: 'your-dataset-name',
+  useCdn: false, // set to `true` to fetch from edge cache
+  apiVersion: '2022-01-12', // use current date (YYYY-MM-DD) to target the latest API version
 })
 
-const data = await client.fetch(`count(*[])`)
+const data = await client.fetch<number>(`count(*)`)
 
 console.log(`Number of documents: ${data}`)
 ```
@@ -245,23 +269,18 @@ export const config = {
 export default async function handler(req: NextRequest) {
   const client = createClient({
     projectId: 'your-project-id',
-    dataset: 'bikeshop',
-    apiVersion: '2021-03-25', // use current UTC date - see "specifying API version"!
-    token: 'sanity-auth-token', // or leave blank for unauthenticated usage
-    useCdn: true, // `false` if you want to ensure fresh data
+    dataset: 'your-dataset-name',
+    useCdn: false, // set to `true` to fetch from edge cache
+    apiVersion: '2022-01-12', // use current date (YYYY-MM-DD) to target the latest API version
   })
 
-  return new Response(
-    JSON.stringify({
-      count: await client.fetch(`count(*[])`),
-    }),
-    {
-      status: 200,
-      headers: {
-        'content-type': 'application/json',
-      },
-    }
-  )
+  const count = await client.fetch<number>(`count(*)`)
+  return new Response(JSON.stringify({count}), {
+    status: 200,
+    headers: {
+      'content-type': 'application/json',
+    },
+  })
 }
 ```
 
@@ -281,13 +300,12 @@ Using [esm.sh] you can either load the client using a `<script type="module">` t
 
   const client = createClient({
     projectId: 'your-project-id',
-    dataset: 'bikeshop',
-    apiVersion: '2021-03-25', // use current UTC date - see "specifying API version"!
-    token: 'sanity-auth-token', // or leave blank for unauthenticated usage
-    useCdn: true, // `false` if you want to ensure fresh data
+    dataset: 'your-dataset-name',
+    useCdn: false, // set to `true` to fetch from edge cache
+    apiVersion: '2022-01-12', // use current date (YYYY-MM-DD) to target the latest API version
   })
 
-  const data = await client.fetch(`count(*[])`)
+  const data = await client.fetch(`count(*)`)
   document.getElementById('results').innerText = `Number of documents: ${data}`
 </script>
 <div id="results"></div>
@@ -296,18 +314,17 @@ Using [esm.sh] you can either load the client using a `<script type="module">` t
 Or from anywhere using a dynamic `import()`:
 
 ```js
-// You can run this snippet from your browwser DevTools console.
+// You can run this snippet from your browser DevTools console.
 // Super handy when you're quickly testing out queries.
 const {createClient} = await import('https://esm.sh/@sanity/client')
 const client = createClient({
   projectId: 'your-project-id',
-  dataset: 'bikeshop',
-  apiVersion: '2021-03-25', // use current UTC date - see "specifying API version"!
-  token: 'sanity-auth-token', // or leave blank for unauthenticated usage
-  useCdn: true, // `false` if you want to ensure fresh data
+  dataset: 'your-dataset-name',
+  useCdn: false, // set to `true` to fetch from edge cache
+  apiVersion: '2022-01-12', // use current date (YYYY-MM-DD) to target the latest API version
 })
 
-const data = await client.fetch(`count(*[])`)
+const data = await client.fetch(`count(*)`)
 console.log(`Number of documents: ${data}`)
 ```
 
@@ -324,13 +341,12 @@ Loading the UMD script creates a `SanityClient` global that have the same export
 
   const client = createClient({
     projectId: 'your-project-id',
-    dataset: 'bikeshop',
-    apiVersion: '2021-03-25', // use current UTC date - see "specifying API version"!
-    token: 'sanity-auth-token', // or leave blank for unauthenticated usage
-    useCdn: true, // `false` if you want to ensure fresh data
+    dataset: 'your-dataset-name',
+    useCdn: false, // set to `true` to fetch from edge cache
+    apiVersion: '2022-01-12', // use current date (YYYY-MM-DD) to target the latest API version
   })
 
-  client.fetch(`count(*[])`).then((data) => console.log(`Number of documents: ${data}`))
+  client.fetch(`count(*)`).then((data) => console.log(`Number of documents: ${data}`))
 </script>
 ```
 
@@ -346,13 +362,12 @@ The `require-unpkg` library lets you consume `npm` packages from `unpkg.com` sim
 
     const client = createClient({
       projectId: 'your-project-id',
-      dataset: 'bikeshop',
-      apiVersion: '2021-03-25', // use current UTC date - see "specifying API version"!
-      useCdn: true, // `false` if you want to ensure fresh data
-      token: 'sanity-secret-auth-token', // leave blank for unauthenticated usage
+      dataset: 'your-dataset-name',
+      useCdn: false, // set to `true` to fetch from edge cache
+      apiVersion: '2022-01-12', // use current date (YYYY-MM-DD) to target the latest API version
     })
 
-    const data = await client.fetch(`count(*[])`)
+    const data = await client.fetch(`count(*)`)
     $('#results').text(`Number of documents: ${data}`)
   })()
 </script>
@@ -1157,4 +1172,6 @@ client.createOrReplace(doc, options)
 [api-cdn]: https://www.sanity.io/docs/api-cdn
 [CommonJS]: https://nodejs.org/api/modules.html#modules-commonjs-modules
 [TypeScript]: https://www.typescriptlang.org/
-[api-versioning]: http://sanity.io/docs/api-versioning
+[api-versioning]: http://sanity.io/docs/api-versioning
+[zod]: https://zod.dev/
+[groqd]: https://github.com/FormidableLabs/groqd#readme

package/dist/index.browser.cjs

@@ -6,7 +6,6 @@ Object.defineProperty(exports, '__esModule', {
 var getIt = require('get-it');
 var middleware = require('get-it/middleware');
 var rxjs = require('rxjs');
-var makeError = require('make-error');
 var operators = require('rxjs/operators');
 var polyfilledEventSource = require('@sanity/eventsource');
 function _interopDefaultCompat(e) {
@@ -16,7 +15,7 @@ function _interopDefaultCompat(e) {
 }
 var polyfilledEventSource__default = /*#__PURE__*/_interopDefaultCompat(polyfilledEventSource);
 var envMiddleware = [];
-class ClientError extends makeError.BaseError {
+class ClientError extends Error {
   constructor(res) {
     const props = extractErrorProps(res);
     super(props.message);
@@ -24,7 +23,7 @@ class ClientError extends makeError.BaseError {
     Object.assign(this, props);
   }
 }
-class ServerError extends makeError.BaseError {
+class ServerError extends Error {
   constructor(res) {
     const props = extractErrorProps(res);
     super(props.message);
@@ -1023,7 +1022,7 @@ once(function () {
   }
   return console.warn(message.join(" "), ...args);
 });
-const printCdnWarning = createWarningPrinter(["You are not using the Sanity CDN. That means your data is always fresh, but the CDN is faster and", "cheaper. Think about it! For more info, see ".concat(generateHelpUrl("js-client-cdn-configuration"), "."), "To hide this warning, please set the `useCdn` option to either `true` or `false` when creating", "the client."]);
+const printCdnWarning = createWarningPrinter(["You are not using the Sanity CDN. That means your data is always fresh, but the CDN is faster and", "cheaper. Think about it! For more info, see ".concat(generateHelpUrl("js-client-cdn-configuration"), " "), "To hide this warning, please set the `useCdn` option to either `true` or `false` when creating", "the client."]);
 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 defaultCdnHost = "apicdn.sanity.io";