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

package/src/agent/actions/transform.ts

@@ -2,7 +2,13 @@ import {type Observable} from 'rxjs'
 
 import {_request} from '../../data/dataMethods'
 import type {ObservableSanityClient, SanityClient} from '../../SanityClient'
-import type {AgentActionParams, Any, HttpRequest, IdentifiedSanityDocumentStub} from '../../types'
+import type {
+  AgentActionParams,
+  AgentActionPath,
+  Any,
+  HttpRequest,
+  IdentifiedSanityDocumentStub,
+} from '../../types'
 import {hasDataset} from '../../validators'
 import type {
   AgentActionAsync,
@@ -20,6 +26,8 @@ export interface TransformRequestBase extends AgentActionRequestBase {
 
   /**
    * The source document the transformation will use as input.
+   *
+   * @see #AgentActionSchema.forcePublishedWrite
    */
   documentId: string
 
@@ -28,13 +36,15 @@ export interface TransformRequestBase extends AgentActionRequestBase {
    * then it is transformed according to the instruction.
    *
    * When omitted, the source document (documentId) is also the target document.
+   *
+   *  @see #AgentActionSchema.forcePublishedWrite
    */
   targetDocument?: TransformTargetDocument
 
   /**
    * Instruct the LLM how to transform the input to th output.
    *
-   * String template using $variable from instructionParams.
+   * String template with support for $variable from `instructionParams`.
    *
    * Capped to 2000 characters, after variables has been injected.
    * */
@@ -134,24 +144,97 @@ export interface TransformRequestBase extends AgentActionRequestBase {
    * It is therefor an error to provide conflicting include/exclude across targets (ie, include title in one, and exclude it in another)
    *
    * Default max depth for transform: 12
+   *
+   * ## Transforming images
+   *
+   * To transform an existing image, directly target an image asset path.
+   *
+   * For example, all the following will transform the image into the provided asset:
+   * * `target: {path: ['image', 'asset'] }`
+   * * `target: {path: 'image', include: ['asset'] }`
+   *
+   * Image transform can be combined with regular content targets:
+   * * `target: [{path: ['image', 'asset'] }, {include: ['title', 'description']}]`
+   *
+   * Image transform can have per-path instructions, just like any other target paths:
+   * * `target: [{path: ['image', 'asset'], instruction: 'Make the sky blue' }`
+   *
    * @see AgentActionRequestBase#conditionalPaths
    */
   target?: TransformTarget | TransformTarget[]
 }
 
-/**  @beta */
+/**
+ * @see #AgentActionSchema.forcePublishedWrite
+ *
+ * @beta
+ */
 export type TransformTargetDocument =
   | {operation: 'edit'; _id: string}
   | {operation: 'create'; _id?: string}
   | {operation: 'createIfNotExists'; _id: string}
   | {operation: 'createOrReplace'; _id: string}
 
-/**  @beta */
+/**
+ *
+ * @see #TransformOperation
+ * @beta
+ */
+export interface ImageDescriptionOperation {
+  type: 'image-description'
+  /**
+   * When omitted, parent image value will be inferred from the arget path.
+   *
+   * When specified, the `sourcePath` should be a path to an image (or image asset) field:
+   * - `['image']`
+   * - `['wrapper', 'mainImage']`
+   * - `['heroImage', 'asset'] // the asset segment is optional, but supported`
+   */
+  sourcePath?: AgentActionPath
+}
+
+/**
+ *
+ * ## `set` by default
+ * By default, Transform will change the value of every target field in place using a set operation.
+ *
+ * ## Image description
+ *
+ * ### Targeting image fields
+ * Images can be transformed to a textual description by targeting a `string`, `text` or Portable Text field (`array` with `block`)
+ * with `operation: {type: 'image-description'}`.
+ *
+ * Custom instructions for image description targets will be used to generate the description.
+ *
+ * Such targets must be a descendant field of an image object.
+ *
+ * For example:
+ * - `target: {path: ['image', 'description'], operation: {type: 'image-description'} }`
+ * - `target: {path: ['array', {_key: 'abc'}, 'alt'], operation: {type: 'image-description'} } //assuming the item in the array on the key-ed path is an image`
+ * - `target: {path: ['image'], include: ['portableTextField'], operation: {type: 'image-description'}, instruction: 'Use formatting and headings to describe the image in great detail' }`
+ *
+ * ### Targeting non-image fields
+ * If the target image description lives outside an image object, use the `sourcePath` option to specify the path to the image field.
+ * `sourcePath` must be an image or image asset field.
+ *
+ * For example:
+ * - `target: {path: ['description'], operation: operation: {type: 'image-description', sourcePath: ['image', 'asset'] }`
+ * - `target: {path: ['wrapper', 'title'], operation: {type: 'image-description', sourcePath: ['array', {_key: 'abc'}, 'image'] }`
+ * - `target: {path: ['wrapper'], include: ['portableTextField'], operation: {type: 'image-description', sourcePath: ['image', 'asset'] }, instruction: 'Use formatting and headings to describe the image in great detail' }`
+ *
+ * @beta
+ */
+export type TransformOperation = 'set' | ImageDescriptionOperation
+
+/**
+ * @see #TransformOperation
+ * @beta
+ * */
 export interface TransformTargetInclude extends AgentActionTargetInclude {
   /**
    * Specifies a tailored instruction of this target.
    *
-   * string template using $variable from instructionParams  */
+   * String template with support for $variable from `instructionParams`.  */
   instruction?: string
 
   /**
@@ -162,14 +245,23 @@ export interface TransformTargetInclude extends AgentActionTargetInclude {
    * Fields or array items not on the include list, are implicitly excluded.
    */
   include?: (AgentActionPathSegment | TransformTargetInclude)[]
+
+  /**
+   * Default: `set`
+   * @see #TransformOperation
+   */
+  operation?: TransformOperation
 }
 
-/**  @beta */
+/**
+ * @see #TransformOperation
+ * @beta
+ * */
 export interface TransformTarget extends AgentActionTarget {
   /**
    * Specifies a tailored instruction of this target.
    *
-   * string template using $variable from instructionParams.
+   * String template with support for $variable from `instructionParams`.
    * */
   instruction?: string
 
@@ -181,6 +273,12 @@ export interface TransformTarget extends AgentActionTarget {
    * Fields or array items not on the include list, are implicitly excluded.
    */
   include?: (AgentActionPathSegment | TransformTargetInclude)[]
+
+  /**
+   * Default: `set`
+   * @see #TransformOperation
+   */
+  operation?: TransformOperation
 }
 
 /** @beta */

package/src/agent/actions/translate.ts

@@ -27,6 +27,7 @@ export interface TranslateRequestBase extends AgentActionRequestBase {
 
   /**
    * The source document the transformation will use as input.
+   * @see #AgentActionSchema.forcePublishedWrite
    */
   documentId: string
 
@@ -35,6 +36,8 @@ export interface TranslateRequestBase extends AgentActionRequestBase {
    * then it is translated according to the instruction.
    *
    * When omitted, the source document (documentId) is also the target document.
+   *
+   * @see #AgentActionSchema.forcePublishedWrite
    */
   targetDocument?: TransformTargetDocument
 
@@ -105,7 +108,7 @@ export interface TranslateLanguage {
 
 /**  @beta */
 export interface TranslateTargetInclude extends AgentActionTargetInclude {
-  /** string template using $variable from instructionParams  */
+  /** String template using $variable from styleGuideParams.  */
   styleGuide?: string
 
   /**
@@ -120,7 +123,7 @@ export interface TranslateTargetInclude extends AgentActionTargetInclude {
 
 /**  @beta */
 export interface TranslateTarget extends AgentActionTarget {
-  /** string template using $variable from instructionParams  */
+  /** String template using $variable from styleGuideParams.  */
   styleGuide?: string
 
   /**

package/src/config.ts

@@ -154,7 +154,9 @@ export const initConfig = (
   const protocol = hostParts[0]
   const host = hostParts[1]
 
-  const cdnURL = newConfig.isDefaultApi ? `https://${defaultCdnHost}` : newConfig.apiCdnHost || newConfig.apiHost
+  const cdnURL = newConfig.isDefaultApi
+    ? `https://${defaultCdnHost}`
+    : newConfig.apiCdnHost || newConfig.apiHost
   const cdnURLParts = cdnURL.split('://', 2)
   const cdnProtocol = cdnURLParts[0]
   const cdnHost = cdnURLParts[1]

package/src/csm/walkMap.ts

@@ -1,5 +1,5 @@
+import {isRecord} from '../util/isRecord'
 import {isArray} from './isArray'
-import {isRecord} from './isRecord'
 import type {ContentSourceMapParsedPath, WalkMapFn} from './types'
 
 /**

package/src/data/dataMethods.ts

@@ -1,3 +1,4 @@
+import {getVersionFromId, getVersionId, isDraftId} from '@sanity/client/csm'
 import {from, type MonoTypeOperatorFunction, Observable} from 'rxjs'
 import {combineLatestWith, filter, map} from 'rxjs/operators'
 
@@ -11,6 +12,8 @@ import type {
   Any,
   BaseActionOptions,
   BaseMutationOptions,
+  CreateVersionAction,
+  DiscardVersionAction,
   FirstDocumentIdMutationOptions,
   FirstDocumentMutationOptions,
   HttpRequest,
@@ -24,11 +27,13 @@ import type {
   MutationSelection,
   QueryOptions,
   RawQueryResponse,
+  ReplaceVersionAction,
   RequestObservableOptions,
   RequestOptions,
   SanityDocument,
   SingleActionResult,
   SingleMutationResult,
+  UnpublishVersionAction,
 } from '../types'
 import {getSelection} from '../util/getSelection'
 import * as validate from '../validators'
@@ -85,12 +90,19 @@ export function _fetch<R, Q>(
   const mapResponse =
     options.filterResponse === false ? (res: Any) => res : (res: Any) => res.result
 
-  const {cache, next, ...opts} = {
+  const {cache, next, useEmulate, connections, ...opts} = {
     // Opt out of setting a `signal` on an internal `fetch` if one isn't provided.
     // This is necessary in React Server Components to avoid opting out of Request Memoization.
     useAbortSignal: typeof options.signal !== 'undefined',
     // Set `resultSourceMap' when stega is enabled, as it's required for encoding.
     resultSourceMap: stega.enabled ? 'withKeyArraySelector' : options.resultSourceMap,
+
+    // Only use emulate if explicitly asked for
+    useEmulate: false,
+
+    // Having connections is a special case for views
+    connections: undefined,
+
     ...options,
     // Default to not returning the query, unless `filterResponse` is `false`,
     // or `returnQuery` is explicitly set. `true` is the default in Content Lake, so skip if truthy
@@ -101,7 +113,17 @@ export function _fetch<R, Q>(
       ? {...opts, fetch: {cache, next}}
       : opts
 
-  const $request = _dataRequest(config, httpRequest, 'query', {query, params}, reqOpts)
+  // Use 'emulate' endpoint for view emulation, otherwise use 'query'
+  const endpoint = useEmulate ? 'emulate' : 'query'
+  const requestBody = useEmulate
+    ? {
+        query,
+        params,
+        connections: connections,
+      }
+    : {query, params}
+
+  const $request = _dataRequest(config, httpRequest, endpoint, requestBody, reqOpts)
   return stega.enabled
     ? $request.pipe(
         combineLatestWith(
@@ -129,10 +151,36 @@ export function _getDocument<R extends Record<string, Any>>(
   config: InitializedClientConfig,
   httpRequest: HttpRequest,
   id: string,
-  opts: {signal?: AbortSignal; tag?: string} = {},
+  opts: {signal?: AbortSignal; tag?: string; releaseId?: string} = {},
 ): Observable<SanityDocument<R> | undefined> {
+  const getDocId = () => {
+    if (!opts.releaseId) {
+      return id
+    }
+
+    const versionId = getVersionFromId(id)
+    if (!versionId) {
+      if (isDraftId(id)) {
+        throw new Error(
+          `The document ID (\`${id}\`) is a draft, but \`options.releaseId\` is set as \`${opts.releaseId}\``,
+        )
+      }
+
+      return getVersionId(id, opts.releaseId)
+    }
+
+    if (versionId !== opts.releaseId) {
+      throw new Error(
+        `The document ID (\`${id}\`) is already a version of \`${versionId}\` release, but this does not match the provided \`options.releaseId\` (\`${opts.releaseId}\`)`,
+      )
+    }
+
+    return id
+  }
+  const docId = getDocId()
+
   const options = {
-    uri: _getDataUrl(config, 'doc', id),
+    uri: _getDataUrl(config, 'doc', docId),
     json: true,
     tag: opts.tag,
     signal: opts.signal,
@@ -165,6 +213,27 @@ export function _getDocuments<R extends Record<string, Any>>(
   )
 }
 
+/** @internal */
+export function _getReleaseDocuments<R extends Record<string, Any>>(
+  config: InitializedClientConfig,
+  httpRequest: HttpRequest,
+  releaseId: string,
+  opts: BaseMutationOptions = {},
+): Observable<RawQueryResponse<SanityDocument<R>[]>> {
+  return _dataRequest(
+    config,
+    httpRequest,
+    'query',
+    {
+      query: '*[sanity::partOfRelease($releaseId)]',
+      params: {
+        releaseId,
+      },
+    },
+    opts,
+  )
+}
+
 /** @internal */
 export function _createIfNotExists<R extends Record<string, Any>>(
   config: InitializedClientConfig,
@@ -201,6 +270,26 @@ export function _createOrReplace<R extends Record<string, Any>>(
   return _create<R>(config, httpRequest, doc, 'createOrReplace', options)
 }
 
+/** @internal */
+export function _createVersion<R extends Record<string, Any>>(
+  config: InitializedClientConfig,
+  httpRequest: HttpRequest,
+  doc: IdentifiedSanityDocumentStub<R>,
+  publishedId: string,
+  options?: BaseActionOptions,
+): Observable<SingleActionResult> {
+  validators.requireDocumentId('createVersion', doc)
+  validators.requireDocumentType('createVersion', doc)
+
+  const createVersionAction: CreateVersionAction = {
+    actionType: 'sanity.action.document.version.create',
+    publishedId,
+    document: doc,
+  }
+
+  return _action(config, httpRequest, createVersionAction, options)
+}
+
 /** @internal */
 export function _delete<R extends Record<string, Any>>(
   config: InitializedClientConfig,
@@ -224,6 +313,58 @@ export function _delete<R extends Record<string, Any>>(
   )
 }
 
+/** @internal */
+export function _discardVersion(
+  config: InitializedClientConfig,
+  httpRequest: HttpRequest,
+  versionId: string,
+  purge: boolean = false,
+  options?: BaseActionOptions,
+): Observable<SingleActionResult> {
+  const discardVersionAction: DiscardVersionAction = {
+    actionType: 'sanity.action.document.version.discard',
+    versionId,
+    purge,
+  }
+
+  return _action(config, httpRequest, discardVersionAction, options)
+}
+
+/** @internal */
+export function _replaceVersion<R extends Record<string, Any>>(
+  config: InitializedClientConfig,
+  httpRequest: HttpRequest,
+  doc: IdentifiedSanityDocumentStub<R>,
+  options?: BaseActionOptions,
+): Observable<SingleActionResult> {
+  validators.requireDocumentId('replaceVersion', doc)
+  validators.requireDocumentType('replaceVersion', doc)
+
+  const replaceVersionAction: ReplaceVersionAction = {
+    actionType: 'sanity.action.document.version.replace',
+    document: doc,
+  }
+
+  return _action(config, httpRequest, replaceVersionAction, options)
+}
+
+/** @internal */
+export function _unpublishVersion(
+  config: InitializedClientConfig,
+  httpRequest: HttpRequest,
+  versionId: string,
+  publishedId: string,
+  options?: BaseActionOptions,
+): Observable<SingleActionResult> {
+  const unpublishVersionAction: UnpublishVersionAction = {
+    actionType: 'sanity.action.document.version.unpublish',
+    versionId,
+    publishedId,
+  }
+
+  return _action(config, httpRequest, unpublishVersionAction, options)
+}
+
 /** @internal */
 export function _mutate<R extends Record<string, Any>>(
   config: InitializedClientConfig,
@@ -289,11 +430,13 @@ export function _dataRequest(
   const isMutation = endpoint === 'mutate'
   const isAction = endpoint === 'actions'
   const isQuery = endpoint === 'query'
+  const isEmulate = endpoint === 'emulate'
 
   // Check if the query string is within a configured threshold,
   // in which case we can use GET. Otherwise, use POST.
-  const strQuery = isMutation || isAction ? '' : encodeQueryString(body)
-  const useGet = !isMutation && !isAction && strQuery.length < getQuerySizeLimit
+  // Emulate endpoint always uses POST
+  const strQuery = isMutation || isAction || isEmulate ? '' : encodeQueryString(body)
+  const useGet = !isMutation && !isAction && !isEmulate && strQuery.length < getQuerySizeLimit
   const stringQuery = useGet ? strQuery : ''
   const returnFirst = options.returnFirst
   const {timeout, token, tag, headers, returnQuery, lastLiveEventId, cacheMode} = options
@@ -377,6 +520,9 @@ const isQuery = (config: InitializedClientConfig, uri: string) =>
 const isViewQuery = (config: InitializedClientConfig, uri: string) =>
   hasDataConfig(config) && uri.startsWith(_getDataUrl(config, 'views'))
 
+const isEmulate = (config: InitializedClientConfig, uri: string) =>
+  hasDataConfig(config) && uri.startsWith(_getDataUrl(config, 'emulate'))
+
 const isMutate = (config: InitializedClientConfig, uri: string) =>
   hasDataConfig(config) && uri.startsWith(_getDataUrl(config, 'mutate'))
 
@@ -396,7 +542,8 @@ const isData = (config: InitializedClientConfig, uri: string) =>
   isDoc(config, uri) ||
   isListener(config, uri) ||
   isHistory(config, uri) ||
-  isViewQuery(config, uri)
+  isViewQuery(config, uri) ||
+  isEmulate(config, uri)
 
 /**
  * @internal
@@ -425,8 +572,11 @@ export function _requestObservable<R>(
     options.query = {tag: validate.requestTag(tag), ...options.query}
   }
 
-  // GROQ query-only parameters
-  if (['GET', 'HEAD', 'POST'].indexOf(options.method || 'GET') >= 0 && isQuery(config, uri)) {
+  // GROQ query-only parameters (applies to both query and emulate endpoints)
+  if (
+    ['GET', 'HEAD', 'POST'].indexOf(options.method || 'GET') >= 0 &&
+    (isQuery(config, uri) || isEmulate(config, uri))
+  ) {
     const resultSourceMap = options.resultSourceMap ?? config.resultSourceMap
     if (resultSourceMap !== undefined && resultSourceMap !== false) {
       options.query = {resultSourceMap, ...options.query}
@@ -486,7 +636,11 @@ export function _requestObservable<R>(
 /**
  * @internal
  */
-export function _request<R>(config: InitializedClientConfig, httpRequest: HttpRequest, options: Any): Observable<R> {
+export function _request<R>(
+  config: InitializedClientConfig,
+  httpRequest: HttpRequest,
+  options: Any,
+): Observable<R> {
   const observable = _requestObservable<R>(config, httpRequest, options).pipe(
     filter((event: Any) => event.type === 'response'),
     map((event: Any) => event.body),
@@ -498,7 +652,11 @@ export function _request<R>(config: InitializedClientConfig, httpRequest: HttpRe
 /**
  * @internal
  */
-export function _getDataUrl(config: InitializedClientConfig, operation: string, path?: string): string {
+export function _getDataUrl(
+  config: InitializedClientConfig,
+  operation: string,
+  path?: string,
+): string {
   if (config['~experimental_resource']) {
     validators.resourceConfig(config)
     const resourceBase = resourceDataBase(config)
@@ -514,7 +672,7 @@ export function _getDataUrl(config: InitializedClientConfig, operation: string,
 /**
  * @internal
  */
-export function _getUrl(config: InitializedClientConfig, uri: string, canUseCdn = false, options: {forceApiUrl?: boolean} = {}): string {
+export function _getUrl(config: InitializedClientConfig, uri: string, canUseCdn = false): string {
   const {url, cdnUrl} = config
   const base = canUseCdn ? cdnUrl : url
   return `${base}/${uri.replace(/^\//, '')}`

package/src/data/encodeQueryString.ts

@@ -18,7 +18,7 @@ export const encodeQueryString = ({
 
   // Iterate params, the keys are prefixed with `$` and their values JSON stringified
   for (const [key, value] of Object.entries(params)) {
-    searchParams.append(`$${key}`, JSON.stringify(value))
+    if (value !== undefined) searchParams.append(`$${key}`, JSON.stringify(value))
   }
   // Options are passed as-is
   for (const [key, value] of Object.entries(opts)) {

package/src/data/eventsource.ts

@@ -1,5 +1,6 @@
 import {defer, isObservable, mergeMap, Observable, of} from 'rxjs'
 
+import {formatQueryParseError, isQueryParseError} from '../http/errors'
 import {type Any} from '../types'
 
 /**
@@ -169,8 +170,10 @@ function connectWithESInstance<EventTypeName extends string>(
       }
       if (message.type === 'channelError') {
         // An error occurred. This is different from a network-level error (which will be emitted as 'error').
-        // Possible causes are things such as malformed filters, non-existant datasets or similar.
-        observer.error(new ChannelError(extractErrorMessage(event?.data), event.data))
+        // Possible causes are things such as malformed filters, non-existant datasets
+        // or similar.
+        const tag = new URL(es.url).searchParams.get('tag')
+        observer.error(new ChannelError(extractErrorMessage(event?.data, tag), event.data))
         return
       }
       if (message.type === 'disconnect') {
@@ -235,16 +238,22 @@ function parseEvent(
   }
 }
 
-function extractErrorMessage(err: Any) {
-  if (!err.error) {
+function extractErrorMessage(err: Any, tag?: string | null) {
+  const error = err.error
+
+  if (!error) {
     return err.message || 'Unknown listener error'
   }
 
-  if (err.error.description) {
-    return err.error.description
+  if (isQueryParseError(error)) {
+    return formatQueryParseError(error, tag)
+  }
+
+  if (error.description) {
+    return error.description
   }
 
-  return typeof err.error === 'string' ? err.error : JSON.stringify(err.error, null, 2)
+  return typeof error === 'string' ? error : JSON.stringify(error, null, 2)
 }
 
 function isEmptyObject(data: object) {

package/src/data/listen.ts

@@ -70,7 +70,7 @@ export function _listen<R extends Record<string, Any> = Record<string, Any>>(
   params?: ListenParams,
   opts: ListenOptions = {},
 ): Observable<MutationEvent<R> | ListenEvent<R>> {
-  const {url, token, withCredentials, requestTagPrefix} = this.config()
+  const {url, token, withCredentials, requestTagPrefix, headers: configHeaders} = this.config()
   const tag = opts.tag && requestTagPrefix ? [requestTagPrefix, opts.tag].join('.') : opts.tag
   const options = {...defaults(opts, defaultOptions), tag}
   const listenOpts = pick(options, possibleOptions)
@@ -88,9 +88,15 @@ export function _listen<R extends Record<string, Any> = Record<string, Any>>(
     esOptions.withCredentials = true
   }
 
-  if (token) {
-    esOptions.headers = {
-      Authorization: `Bearer ${token}`,
+  if (token || configHeaders) {
+    esOptions.headers = {}
+
+    if (token) {
+      esOptions.headers.Authorization = `Bearer ${token}`
+    }
+
+    if (configHeaders) {
+      Object.assign(esOptions.headers, configHeaders)
     }
   }
 

package/src/data/live.ts

@@ -52,6 +52,7 @@ export class LiveClient {
       token,
       withCredentials,
       requestTagPrefix,
+      headers: configHeaders,
     } = this.#client.config()
     const apiVersion = _apiVersion.replace(/^v/, '')
     if (apiVersion !== 'X' && apiVersion < requiredApiVersion) {
@@ -76,15 +77,22 @@ export class LiveClient {
       url.searchParams.set('includeDrafts', 'true')
     }
     const esOptions: EventSourceInit & {headers?: Record<string, string>} = {}
-    if (includeDrafts && token) {
-      esOptions.headers = {
-        Authorization: `Bearer ${token}`,
-      }
-    }
     if (includeDrafts && withCredentials) {
       esOptions.withCredentials = true
     }
 
+    if ((includeDrafts && token) || configHeaders) {
+      esOptions.headers = {}
+
+      if (includeDrafts && token) {
+        esOptions.headers.Authorization = `Bearer ${token}`
+      }
+
+      if (configHeaders) {
+        Object.assign(esOptions.headers, configHeaders)
+      }
+    }
+
     const key = `${url.href}::${JSON.stringify(esOptions)}`
     const existing = eventsCache.get(key)
 

package/src/datasets/DatasetsClient.ts

@@ -105,7 +105,10 @@ export class DatasetsClient {
   list(): Promise<DatasetsResponse> {
     validate.resourceGuard('dataset', this.#client.config())
     return lastValueFrom(
-      _request<DatasetsResponse>(this.#client.config(), this.#httpRequest, {uri: '/datasets', tag: null}),
+      _request<DatasetsResponse>(this.#client.config(), this.#httpRequest, {
+        uri: '/datasets',
+        tag: null,
+      }),
     )
   }
 }

package/src/defineCreateClient.ts

@@ -17,7 +17,13 @@ export {
 } from './data/eventsource'
 export * from './data/patch'
 export * from './data/transaction'
-export {ClientError, CorsOriginError, ServerError} from './http/errors'
+export {
+  ClientError,
+  CorsOriginError,
+  formatQueryParseError,
+  isQueryParseError,
+  ServerError,
+} from './http/errors'
 export * from './SanityClient'
 export * from './types'