@sanity/client 7.26.1 → 7.27.0

package/dist/index.d.cts

@@ -424,14 +424,7 @@ export declare interface ArchiveReleaseAction {
 
 /** @public */
 export declare type AssetMetadataType =
-  | 'location'
-  | 'exif'
-  | 'image'
-  | 'palette'
-  | 'lqip'
-  | 'blurhash'
-  | 'thumbhash'
-  | 'none'
+  'location' | 'exif' | 'image' | 'palette' | 'lqip' | 'blurhash' | 'thumbhash' | 'none'
 
 /** @internal */
 export declare class AssetsClient {
@@ -873,17 +866,13 @@ export declare class ClientError extends Error {
 
 /** @public */
 export declare type ClientPerspective =
-  | DeprecatedPreviewDrafts
-  | 'published'
-  | 'drafts'
-  | 'raw'
-  | StackablePerspective[]
+  DeprecatedPreviewDrafts | 'published' | 'drafts' | 'raw' | StackablePerspective[]
 
 /** @public */
 export declare type ClientReturn<
   GroqString extends string,
   Fallback = Any,
-> = GroqString extends keyof SanityQueries ? SanityQueries[GroqString] : Fallback
+> = GroqString extends keyof SanityQueries_2 ? SanityQueries_2[GroqString] : Fallback
 
 /**
  * @public
@@ -1003,8 +992,7 @@ export declare interface ContentSourceMapDocumentBase {
 
 /** @public */
 export declare type ContentSourceMapDocuments = (
-  | ContentSourceMapDocument
-  | ContentSourceMapRemoteDocument
+  ContentSourceMapDocument | ContentSourceMapRemoteDocument
 )[]
 
 /**
@@ -1600,8 +1588,7 @@ export declare function formatQueryParseError(
 
 /** @beta */
 declare type GenerateAsyncInstruction<T extends Record<string, Any> = Record<string, Any>> = (
-  | GenerateExistingDocumentRequest
-  | GenerateTargetDocumentRequest<T>
+  GenerateExistingDocumentRequest | GenerateTargetDocumentRequest<T>
 ) &
   GenerateRequestBase &
   AgentActionAsync
@@ -1620,8 +1607,7 @@ declare interface GenerateExistingDocumentRequest {
 
 /** @beta */
 export declare type GenerateInstruction<T extends Record<string, Any> = Record<string, Any>> =
-  | GenerateSyncInstruction<T>
-  | GenerateAsyncInstruction<T>
+  GenerateSyncInstruction<T> | GenerateAsyncInstruction<T>
 
 /**  @beta */
 export declare type GenerateOperation = 'set' | 'append' | 'mixed'
@@ -1752,8 +1738,7 @@ declare interface GenerateRequestBase extends AgentActionRequestBase {
 
 /** @beta */
 declare type GenerateSyncInstruction<T extends Record<string, Any> = Record<string, Any>> = (
-  | GenerateExistingDocumentRequest
-  | GenerateTargetDocumentRequest<T>
+  GenerateExistingDocumentRequest | GenerateTargetDocumentRequest<T>
 ) &
   GenerateRequestBase &
   AgentActionSync
@@ -2090,12 +2075,7 @@ export declare function _listen<
 
 /** @public */
 export declare type ListenEvent<R extends Record<string, Any> = Record<string, Any>> =
-  | MutationEvent<R>
-  | ReconnectEvent
-  | WelcomeBackEvent
-  | ResetEvent
-  | WelcomeEvent
-  | OpenEvent
+  MutationEvent<R> | ReconnectEvent | WelcomeBackEvent | ResetEvent | WelcomeEvent | OpenEvent
 
 /**
  * Maps a ListenOptions object and returns the Listen events opted for, e.g:
@@ -2235,11 +2215,7 @@ export declare class LiveClient {
 
 /** @public */
 export declare type LiveEvent =
-  | LiveEventRestart
-  | LiveEventReconnect
-  | LiveEventMessage
-  | LiveEventWelcome
-  | LiveEventGoAway
+  LiveEventRestart | LiveEventReconnect | LiveEventMessage | LiveEventWelcome | LiveEventGoAway
 
 /**
  * The `id` field is the position at which the connection was rejected or closed.
@@ -2294,8 +2270,7 @@ export declare type Logger =
 declare type MapListenEventNamesToListenEvents<
   R extends Record<string, Any> = Record<string, Any>,
   Events extends (ResumableListenEventNames | ListenEventName)[] = (
-    | ResumableListenEventNames
-    | ListenEventName
+    ResumableListenEventNames | ListenEventName
   )[],
 > = Events extends (infer E)[]
   ? E extends 'welcome'
@@ -4016,21 +3991,18 @@ export declare type PatchBuilder = (patch: Patch) => Patch
 
 /** @beta */
 export declare type PatchDocument<T extends Record<string, Any> = Record<string, Any>> =
-  | PatchDocumentSync<T>
-  | PatchDocumentAsync<T>
+  PatchDocumentSync<T> | PatchDocumentAsync<T>
 
 /** @beta */
 declare type PatchDocumentAsync<T extends Record<string, Any> = Record<string, Any>> = (
-  | PatchExistingDocumentRequest
-  | PatchTargetDocumentRequest<T>
+  PatchExistingDocumentRequest | PatchTargetDocumentRequest<T>
 ) &
   PatchRequestBase &
   AgentActionAsync
 
 /** @beta */
 declare type PatchDocumentSync<T extends Record<string, Any> = Record<string, Any>> = (
-  | PatchExistingDocumentRequest
-  | PatchTargetDocumentRequest<T>
+  PatchExistingDocumentRequest | PatchTargetDocumentRequest<T>
 ) &
   PatchRequestBase &
   AgentActionSync
@@ -4196,8 +4168,7 @@ declare interface PromptJsonResponse<T extends Record<string, Any> = Record<stri
 
 /** @beta */
 export declare type PromptRequest<T extends Record<string, Any> = Record<string, Any>> = (
-  | PromptTextResponse
-  | PromptJsonResponse<T>
+  PromptTextResponse | PromptJsonResponse<T>
 ) &
   PromptRequestBase
 
@@ -4342,9 +4313,7 @@ export declare interface PublishReleaseAction {
 
 /** @public */
 export declare type QueryOptions =
-  | FilteredResponseQueryOptions
-  | UnfilteredResponseQueryOptions
-  | UnfilteredResponseWithoutQuery
+  FilteredResponseQueryOptions | UnfilteredResponseQueryOptions | UnfilteredResponseWithoutQuery
 
 /** @public */
 export declare interface QueryParams {
@@ -4981,8 +4950,10 @@ export declare type ResumableListenEventNames =
   | 'reset'
 
 /** @public */
-export declare interface ResumableListenOptions
-  extends Omit<ListenOptions, 'events' | 'enableResume'> {
+export declare interface ResumableListenOptions extends Omit<
+  ListenOptions,
+  'events' | 'enableResume'
+> {
   /**
    * If this is enabled, the client will normally resume events upon reconnect
    * Note that you should also subscribe to `reset`-events and handle the case where the backend is unable to resume
@@ -5908,8 +5879,28 @@ export declare interface SanityProjectMember {
   isCurrentUser: boolean
 }
 
-/** @public */
-export declare interface SanityQueries {}
+/**
+ * The query registry as seen from `@sanity/client`. Inherits every query registered on the global
+ * `SanityQueries` interface, and still accepts the older module augmentation form:
+ * ```ts
+ * declare module '@sanity/client' {
+ *   interface SanityQueries {
+ *     '*[_type == "post"]': PostsQueryResult
+ *   }
+ * }
+ * ```
+ * `@sanity/client` releases that predate the global registry only read this interface, so a
+ * generated file that registers queries globally can bridge them with an augmentation that adds
+ * the global as a base type. It is harmless on releases that already inherit it:
+ * ```ts
+ * declare module '@sanity/client' {
+ *   interface SanityQueries extends globalThis.SanityQueries {}
+ * }
+ * ```
+ * @public
+ */
+declare interface SanityQueries_2 extends globalThis.SanityQueries {}
+export {SanityQueries_2 as SanityQueries}
 
 /** @internal */
 export declare interface SanityReference {
@@ -6151,8 +6142,7 @@ export declare type TransactionMutationOptions =
 
 /** @beta */
 export declare type TransformDocument<T extends Record<string, Any> = Record<string, Any>> =
-  | TransformDocumentSync<T>
-  | TransformDocumentAsync
+  TransformDocumentSync<T> | TransformDocumentAsync
 
 /** @beta */
 declare type TransformDocumentAsync = TransformRequestBase & AgentActionAsync
@@ -6416,8 +6406,7 @@ export declare interface TransformTargetInclude extends AgentActionTargetInclude
 
 /** @beta */
 export declare type TranslateDocument<T extends Record<string, Any> = Record<string, Any>> =
-  | TranslateDocumentSync<T>
-  | TranslateDocumentAsync
+  TranslateDocumentSync<T> | TranslateDocumentAsync
 
 /** @beta */
 declare type TranslateDocumentAsync = TranslateRequestBase & AgentActionAsync
@@ -6694,10 +6683,7 @@ export declare function validateApiPerspective(
 
 /** @public */
 export declare type VersionAction =
-  | CreateVersionAction
-  | DiscardVersionAction
-  | ReplaceVersionAction
-  | UnpublishVersionAction
+  CreateVersionAction | DiscardVersionAction | ReplaceVersionAction | UnpublishVersionAction
 
 /** @public */
 export declare interface VideoPlaybackInfo<
@@ -6722,8 +6708,7 @@ export declare interface VideoPlaybackInfo<
 
 /** @public */
 export declare type VideoPlaybackInfoItem =
-  | VideoPlaybackInfoItemPublic
-  | VideoPlaybackInfoItemSigned
+  VideoPlaybackInfoItemPublic | VideoPlaybackInfoItemSigned
 
 /** @public */
 export declare interface VideoPlaybackInfoItemPublic {
@@ -6828,3 +6813,27 @@ export declare type WelcomeEvent = {
 }
 
 export {}
+
+declare global {
+  interface File {}
+}
+
+declare global {
+  /**
+   * Query result types, keyed by GROQ query string. Empty by default, `sanity typegen` registers
+   * the queries it finds:
+   * ```ts
+   * declare global {
+   *   interface SanityQueries {
+   *     '*[_type == "post"]': PostsQueryResult
+   *   }
+   * }
+   * ```
+   * `client.fetch(query)` and `ClientReturn<typeof query>` then resolve to the registered type.
+   *
+   * The registry is a global rather than a module augmentation of `@sanity/client` so that it
+   * does not depend on module resolution: it resolves the same whether `@sanity/client` is a
+   * direct dependency, how many copies of it are installed, and from every subpath export.
+   */
+  interface SanityQueries {}
+}

package/dist/index.d.ts

@@ -424,14 +424,7 @@ export declare interface ArchiveReleaseAction {
 
 /** @public */
 export declare type AssetMetadataType =
-  | 'location'
-  | 'exif'
-  | 'image'
-  | 'palette'
-  | 'lqip'
-  | 'blurhash'
-  | 'thumbhash'
-  | 'none'
+  'location' | 'exif' | 'image' | 'palette' | 'lqip' | 'blurhash' | 'thumbhash' | 'none'
 
 /** @internal */
 export declare class AssetsClient {
@@ -873,17 +866,13 @@ export declare class ClientError extends Error {
 
 /** @public */
 export declare type ClientPerspective =
-  | DeprecatedPreviewDrafts
-  | 'published'
-  | 'drafts'
-  | 'raw'
-  | StackablePerspective[]
+  DeprecatedPreviewDrafts | 'published' | 'drafts' | 'raw' | StackablePerspective[]
 
 /** @public */
 export declare type ClientReturn<
   GroqString extends string,
   Fallback = Any,
-> = GroqString extends keyof SanityQueries ? SanityQueries[GroqString] : Fallback
+> = GroqString extends keyof SanityQueries_2 ? SanityQueries_2[GroqString] : Fallback
 
 /**
  * @public
@@ -1003,8 +992,7 @@ export declare interface ContentSourceMapDocumentBase {
 
 /** @public */
 export declare type ContentSourceMapDocuments = (
-  | ContentSourceMapDocument
-  | ContentSourceMapRemoteDocument
+  ContentSourceMapDocument | ContentSourceMapRemoteDocument
 )[]
 
 /**
@@ -1600,8 +1588,7 @@ export declare function formatQueryParseError(
 
 /** @beta */
 declare type GenerateAsyncInstruction<T extends Record<string, Any> = Record<string, Any>> = (
-  | GenerateExistingDocumentRequest
-  | GenerateTargetDocumentRequest<T>
+  GenerateExistingDocumentRequest | GenerateTargetDocumentRequest<T>
 ) &
   GenerateRequestBase &
   AgentActionAsync
@@ -1620,8 +1607,7 @@ declare interface GenerateExistingDocumentRequest {
 
 /** @beta */
 export declare type GenerateInstruction<T extends Record<string, Any> = Record<string, Any>> =
-  | GenerateSyncInstruction<T>
-  | GenerateAsyncInstruction<T>
+  GenerateSyncInstruction<T> | GenerateAsyncInstruction<T>
 
 /**  @beta */
 export declare type GenerateOperation = 'set' | 'append' | 'mixed'
@@ -1752,8 +1738,7 @@ declare interface GenerateRequestBase extends AgentActionRequestBase {
 
 /** @beta */
 declare type GenerateSyncInstruction<T extends Record<string, Any> = Record<string, Any>> = (
-  | GenerateExistingDocumentRequest
-  | GenerateTargetDocumentRequest<T>
+  GenerateExistingDocumentRequest | GenerateTargetDocumentRequest<T>
 ) &
   GenerateRequestBase &
   AgentActionSync
@@ -2090,12 +2075,7 @@ export declare function _listen<
 
 /** @public */
 export declare type ListenEvent<R extends Record<string, Any> = Record<string, Any>> =
-  | MutationEvent<R>
-  | ReconnectEvent
-  | WelcomeBackEvent
-  | ResetEvent
-  | WelcomeEvent
-  | OpenEvent
+  MutationEvent<R> | ReconnectEvent | WelcomeBackEvent | ResetEvent | WelcomeEvent | OpenEvent
 
 /**
  * Maps a ListenOptions object and returns the Listen events opted for, e.g:
@@ -2235,11 +2215,7 @@ export declare class LiveClient {
 
 /** @public */
 export declare type LiveEvent =
-  | LiveEventRestart
-  | LiveEventReconnect
-  | LiveEventMessage
-  | LiveEventWelcome
-  | LiveEventGoAway
+  LiveEventRestart | LiveEventReconnect | LiveEventMessage | LiveEventWelcome | LiveEventGoAway
 
 /**
  * The `id` field is the position at which the connection was rejected or closed.
@@ -2294,8 +2270,7 @@ export declare type Logger =
 declare type MapListenEventNamesToListenEvents<
   R extends Record<string, Any> = Record<string, Any>,
   Events extends (ResumableListenEventNames | ListenEventName)[] = (
-    | ResumableListenEventNames
-    | ListenEventName
+    ResumableListenEventNames | ListenEventName
   )[],
 > = Events extends (infer E)[]
   ? E extends 'welcome'
@@ -4016,21 +3991,18 @@ export declare type PatchBuilder = (patch: Patch) => Patch
 
 /** @beta */
 export declare type PatchDocument<T extends Record<string, Any> = Record<string, Any>> =
-  | PatchDocumentSync<T>
-  | PatchDocumentAsync<T>
+  PatchDocumentSync<T> | PatchDocumentAsync<T>
 
 /** @beta */
 declare type PatchDocumentAsync<T extends Record<string, Any> = Record<string, Any>> = (
-  | PatchExistingDocumentRequest
-  | PatchTargetDocumentRequest<T>
+  PatchExistingDocumentRequest | PatchTargetDocumentRequest<T>
 ) &
   PatchRequestBase &
   AgentActionAsync
 
 /** @beta */
 declare type PatchDocumentSync<T extends Record<string, Any> = Record<string, Any>> = (
-  | PatchExistingDocumentRequest
-  | PatchTargetDocumentRequest<T>
+  PatchExistingDocumentRequest | PatchTargetDocumentRequest<T>
 ) &
   PatchRequestBase &
   AgentActionSync
@@ -4196,8 +4168,7 @@ declare interface PromptJsonResponse<T extends Record<string, Any> = Record<stri
 
 /** @beta */
 export declare type PromptRequest<T extends Record<string, Any> = Record<string, Any>> = (
-  | PromptTextResponse
-  | PromptJsonResponse<T>
+  PromptTextResponse | PromptJsonResponse<T>
 ) &
   PromptRequestBase
 
@@ -4342,9 +4313,7 @@ export declare interface PublishReleaseAction {
 
 /** @public */
 export declare type QueryOptions =
-  | FilteredResponseQueryOptions
-  | UnfilteredResponseQueryOptions
-  | UnfilteredResponseWithoutQuery
+  FilteredResponseQueryOptions | UnfilteredResponseQueryOptions | UnfilteredResponseWithoutQuery
 
 /** @public */
 export declare interface QueryParams {
@@ -4981,8 +4950,10 @@ export declare type ResumableListenEventNames =
   | 'reset'
 
 /** @public */
-export declare interface ResumableListenOptions
-  extends Omit<ListenOptions, 'events' | 'enableResume'> {
+export declare interface ResumableListenOptions extends Omit<
+  ListenOptions,
+  'events' | 'enableResume'
+> {
   /**
    * If this is enabled, the client will normally resume events upon reconnect
    * Note that you should also subscribe to `reset`-events and handle the case where the backend is unable to resume
@@ -5908,8 +5879,28 @@ export declare interface SanityProjectMember {
   isCurrentUser: boolean
 }
 
-/** @public */
-export declare interface SanityQueries {}
+/**
+ * The query registry as seen from `@sanity/client`. Inherits every query registered on the global
+ * `SanityQueries` interface, and still accepts the older module augmentation form:
+ * ```ts
+ * declare module '@sanity/client' {
+ *   interface SanityQueries {
+ *     '*[_type == "post"]': PostsQueryResult
+ *   }
+ * }
+ * ```
+ * `@sanity/client` releases that predate the global registry only read this interface, so a
+ * generated file that registers queries globally can bridge them with an augmentation that adds
+ * the global as a base type. It is harmless on releases that already inherit it:
+ * ```ts
+ * declare module '@sanity/client' {
+ *   interface SanityQueries extends globalThis.SanityQueries {}
+ * }
+ * ```
+ * @public
+ */
+declare interface SanityQueries_2 extends globalThis.SanityQueries {}
+export {SanityQueries_2 as SanityQueries}
 
 /** @internal */
 export declare interface SanityReference {
@@ -6151,8 +6142,7 @@ export declare type TransactionMutationOptions =
 
 /** @beta */
 export declare type TransformDocument<T extends Record<string, Any> = Record<string, Any>> =
-  | TransformDocumentSync<T>
-  | TransformDocumentAsync
+  TransformDocumentSync<T> | TransformDocumentAsync
 
 /** @beta */
 declare type TransformDocumentAsync = TransformRequestBase & AgentActionAsync
@@ -6416,8 +6406,7 @@ export declare interface TransformTargetInclude extends AgentActionTargetInclude
 
 /** @beta */
 export declare type TranslateDocument<T extends Record<string, Any> = Record<string, Any>> =
-  | TranslateDocumentSync<T>
-  | TranslateDocumentAsync
+  TranslateDocumentSync<T> | TranslateDocumentAsync
 
 /** @beta */
 declare type TranslateDocumentAsync = TranslateRequestBase & AgentActionAsync
@@ -6694,10 +6683,7 @@ export declare function validateApiPerspective(
 
 /** @public */
 export declare type VersionAction =
-  | CreateVersionAction
-  | DiscardVersionAction
-  | ReplaceVersionAction
-  | UnpublishVersionAction
+  CreateVersionAction | DiscardVersionAction | ReplaceVersionAction | UnpublishVersionAction
 
 /** @public */
 export declare interface VideoPlaybackInfo<
@@ -6722,8 +6708,7 @@ export declare interface VideoPlaybackInfo<
 
 /** @public */
 export declare type VideoPlaybackInfoItem =
-  | VideoPlaybackInfoItemPublic
-  | VideoPlaybackInfoItemSigned
+  VideoPlaybackInfoItemPublic | VideoPlaybackInfoItemSigned
 
 /** @public */
 export declare interface VideoPlaybackInfoItemPublic {
@@ -6828,3 +6813,27 @@ export declare type WelcomeEvent = {
 }
 
 export {}
+
+declare global {
+  interface File {}
+}
+
+declare global {
+  /**
+   * Query result types, keyed by GROQ query string. Empty by default, `sanity typegen` registers
+   * the queries it finds:
+   * ```ts
+   * declare global {
+   *   interface SanityQueries {
+   *     '*[_type == "post"]': PostsQueryResult
+   *   }
+   * }
+   * ```
+   * `client.fetch(query)` and `ClientReturn<typeof query>` then resolve to the registered type.
+   *
+   * The registry is a global rather than a module augmentation of `@sanity/client` so that it
+   * does not depend on module resolution: it resolves the same whether `@sanity/client` is a
+   * direct dependency, how many copies of it are installed, and from every subpath export.
+   */
+  interface SanityQueries {}
+}

package/dist/index.js

@@ -8,7 +8,7 @@ import { combineLatestWith, map, filter, concatMap, reduce, finalize as finalize
 import { getVersionFromId, isDraftId, getVersionId, getDraftId, isVersionId, getPublishedId } from "@sanity/client/csm";
 import { customAlphabet } from "nanoid";
 import { validateObject, validateInsert, requireDocumentId, validateDocumentId, requireDocumentType, printCreateVersionWithBaseIdWarning, resourceConfig, hasDataset, requestTag, printPreviewDraftsDeprecationWarning, validateApiPerspective, printCdnPreviewDraftsWarning, validateAssetType, resourceGuard, dataset, validateVersionIdMatch, defaultConfig, initConfig, printNoDefaultExport } from "./_chunks-es/config.js";
-const NEWLINE = /\r\n|[\n\r\u2028\u2029]/;
+const EXPERIMENTAL_API_WARNING = "This is an experimental API version", NEWLINE = /\r\n|[\n\r\u2028\u2029]/;
 function codeFrame(query, location2, message) {
   const lines = query.split(NEWLINE), loc = {
     start: columnToLine(location2.start, lines),
@@ -220,7 +220,6 @@ function shouldRetry(err, attempt, options) {
   const isSafe = options.method === "GET" || options.method === "HEAD", isQuery2 = (options.uri || options.url).startsWith("/data/query"), isRetriableResponse = err.response && (err.response.statusCode === 429 || err.response.statusCode === 502 || err.response.statusCode === 503);
   return (isSafe || isQuery2) && isRetriableResponse ? !0 : retry.shouldRetry(err, attempt, options);
 }
-const EXPERIMENTAL_API_WARNING = "This is an experimental API version";
 class ConnectionFailedError extends Error {
   name = "ConnectionFailedError";
   /**
@@ -688,7 +687,7 @@ function requestOptions(config, overrides = {}) {
   const withCredentials = !!(typeof overrides.withCredentials > "u" ? config.withCredentials : overrides.withCredentials), timeout = typeof overrides.timeout > "u" ? config.timeout : overrides.timeout;
   return Object.assign({}, overrides, {
     headers: Object.assign({}, headers2, overrides.headers || {}),
-    timeout: typeof timeout > "u" ? 5 * 60 * 1e3 : timeout,
+    timeout: typeof timeout > "u" ? 300 * 1e3 : timeout,
     proxy: overrides.proxy || config.proxy,
     json: !0,
     withCredentials,
@@ -2866,7 +2865,7 @@ function defineDeprecatedCreateClient(createClient2) {
     return printNoDefaultExport(), createClient2(config);
   };
 }
-var name = "@sanity/client", version = "7.26.1";
+var name = "@sanity/client", version = "7.27.0";
 const middleware = [
   debug({ verbose: !0, namespace: "sanity:client" }),
   headers({ "User-Agent": `${name} ${version}` }),