@sanity/client 7.11.2-audience-decide.8 → 7.12.0

package/dist/stega.browser.d.cts

@@ -699,10 +699,6 @@ export declare interface ClientConfig {
    * @defaultValue 'published'
    */
   perspective?: ClientPerspective
-  /**
-   * Parameters to pass to Sanity Decide for personalisation
-   */
-  decideParameters?: DecideParameters
   apiHost?: string
   /**
      @remarks
@@ -784,6 +780,10 @@ export declare interface ClientConfig {
    * Options for how, if enabled, Content Source Maps are encoded into query results using steganography
    */
   stega?: StegaConfig | boolean
+  /**
+   * Lineage token for recursion control
+   */
+  lineage?: string
 }
 
 declare type ClientConfigResource =
@@ -1230,12 +1230,6 @@ export declare type DatasetsResponse = {
   tags: string[]
 }[]
 
-/** @public */
-export declare interface DecideParameters {
-  audience: string | string[]
-  [key: string]: unknown
-}
-
 /**
  * Deletes the published version of a document and optionally some (likely all known) draft versions.
  * If any draft version exists that is not specified for deletion this is an error.
@@ -4321,8 +4315,6 @@ export declare interface QueryParams {
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
   cache?: 'next' extends keyof RequestInit ? never : any
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  decideParameters?: never
-  /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
   filterResponse?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
   headers?: never
@@ -4835,7 +4827,6 @@ export declare interface RequestObservableOptions extends Omit<RequestOptions, '
   returnQuery?: boolean
   resultSourceMap?: boolean | 'withKeyArraySelector'
   perspective?: ClientPerspective
-  decideParameters?: DecideParameters
   lastLiveEventId?: string
   cacheMode?: 'noStale'
 }
@@ -4871,7 +4862,6 @@ export declare interface ResponseEvent<T = unknown> {
 /** @public */
 export declare interface ResponseQueryOptions extends RequestOptions {
   perspective?: ClientPerspective
-  decideParameters?: DecideParameters
   resultSourceMap?: boolean | 'withKeyArraySelector'
   returnQuery?: boolean
   useCdn?: boolean

package/dist/stega.browser.d.ts

@@ -699,10 +699,6 @@ export declare interface ClientConfig {
    * @defaultValue 'published'
    */
   perspective?: ClientPerspective
-  /**
-   * Parameters to pass to Sanity Decide for personalisation
-   */
-  decideParameters?: DecideParameters
   apiHost?: string
   /**
      @remarks
@@ -784,6 +780,10 @@ export declare interface ClientConfig {
    * Options for how, if enabled, Content Source Maps are encoded into query results using steganography
    */
   stega?: StegaConfig | boolean
+  /**
+   * Lineage token for recursion control
+   */
+  lineage?: string
 }
 
 declare type ClientConfigResource =
@@ -1230,12 +1230,6 @@ export declare type DatasetsResponse = {
   tags: string[]
 }[]
 
-/** @public */
-export declare interface DecideParameters {
-  audience: string | string[]
-  [key: string]: unknown
-}
-
 /**
  * Deletes the published version of a document and optionally some (likely all known) draft versions.
  * If any draft version exists that is not specified for deletion this is an error.
@@ -4321,8 +4315,6 @@ export declare interface QueryParams {
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
   cache?: 'next' extends keyof RequestInit ? never : any
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  decideParameters?: never
-  /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
   filterResponse?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
   headers?: never
@@ -4835,7 +4827,6 @@ export declare interface RequestObservableOptions extends Omit<RequestOptions, '
   returnQuery?: boolean
   resultSourceMap?: boolean | 'withKeyArraySelector'
   perspective?: ClientPerspective
-  decideParameters?: DecideParameters
   lastLiveEventId?: string
   cacheMode?: 'noStale'
 }
@@ -4871,7 +4862,6 @@ export declare interface ResponseEvent<T = unknown> {
 /** @public */
 export declare interface ResponseQueryOptions extends RequestOptions {
   perspective?: ClientPerspective
-  decideParameters?: DecideParameters
   resultSourceMap?: boolean | 'withKeyArraySelector'
   returnQuery?: boolean
   useCdn?: boolean

package/dist/stega.d.cts

@@ -699,10 +699,6 @@ export declare interface ClientConfig {
    * @defaultValue 'published'
    */
   perspective?: ClientPerspective
-  /**
-   * Parameters to pass to Sanity Decide for personalisation
-   */
-  decideParameters?: DecideParameters
   apiHost?: string
   /**
      @remarks
@@ -784,6 +780,10 @@ export declare interface ClientConfig {
    * Options for how, if enabled, Content Source Maps are encoded into query results using steganography
    */
   stega?: StegaConfig | boolean
+  /**
+   * Lineage token for recursion control
+   */
+  lineage?: string
 }
 
 declare type ClientConfigResource =
@@ -1230,12 +1230,6 @@ export declare type DatasetsResponse = {
   tags: string[]
 }[]
 
-/** @public */
-export declare interface DecideParameters {
-  audience: string | string[]
-  [key: string]: unknown
-}
-
 /**
  * Deletes the published version of a document and optionally some (likely all known) draft versions.
  * If any draft version exists that is not specified for deletion this is an error.
@@ -4321,8 +4315,6 @@ export declare interface QueryParams {
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
   cache?: 'next' extends keyof RequestInit ? never : any
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  decideParameters?: never
-  /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
   filterResponse?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
   headers?: never
@@ -4835,7 +4827,6 @@ export declare interface RequestObservableOptions extends Omit<RequestOptions, '
   returnQuery?: boolean
   resultSourceMap?: boolean | 'withKeyArraySelector'
   perspective?: ClientPerspective
-  decideParameters?: DecideParameters
   lastLiveEventId?: string
   cacheMode?: 'noStale'
 }
@@ -4871,7 +4862,6 @@ export declare interface ResponseEvent<T = unknown> {
 /** @public */
 export declare interface ResponseQueryOptions extends RequestOptions {
   perspective?: ClientPerspective
-  decideParameters?: DecideParameters
   resultSourceMap?: boolean | 'withKeyArraySelector'
   returnQuery?: boolean
   useCdn?: boolean

package/dist/stega.d.ts

@@ -699,10 +699,6 @@ export declare interface ClientConfig {
    * @defaultValue 'published'
    */
   perspective?: ClientPerspective
-  /**
-   * Parameters to pass to Sanity Decide for personalisation
-   */
-  decideParameters?: DecideParameters
   apiHost?: string
   /**
      @remarks
@@ -784,6 +780,10 @@ export declare interface ClientConfig {
    * Options for how, if enabled, Content Source Maps are encoded into query results using steganography
    */
   stega?: StegaConfig | boolean
+  /**
+   * Lineage token for recursion control
+   */
+  lineage?: string
 }
 
 declare type ClientConfigResource =
@@ -1230,12 +1230,6 @@ export declare type DatasetsResponse = {
   tags: string[]
 }[]
 
-/** @public */
-export declare interface DecideParameters {
-  audience: string | string[]
-  [key: string]: unknown
-}
-
 /**
  * Deletes the published version of a document and optionally some (likely all known) draft versions.
  * If any draft version exists that is not specified for deletion this is an error.
@@ -4321,8 +4315,6 @@ export declare interface QueryParams {
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
   cache?: 'next' extends keyof RequestInit ? never : any
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  decideParameters?: never
-  /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
   filterResponse?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
   headers?: never
@@ -4835,7 +4827,6 @@ export declare interface RequestObservableOptions extends Omit<RequestOptions, '
   returnQuery?: boolean
   resultSourceMap?: boolean | 'withKeyArraySelector'
   perspective?: ClientPerspective
-  decideParameters?: DecideParameters
   lastLiveEventId?: string
   cacheMode?: 'noStale'
 }
@@ -4871,7 +4862,6 @@ export declare interface ResponseEvent<T = unknown> {
 /** @public */
 export declare interface ResponseQueryOptions extends RequestOptions {
   perspective?: ClientPerspective
-  decideParameters?: DecideParameters
   resultSourceMap?: boolean | 'withKeyArraySelector'
   returnQuery?: boolean
   useCdn?: boolean

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanity/client",
-  "version": "7.11.2-audience-decide.8",
+  "version": "7.12.0",
   "description": "Client for retrieving, creating and patching data from Sanity.io",
   "keywords": [
     "sanity",

package/src/SanityClient.ts

@@ -225,19 +225,6 @@ export class ObservableSanityClient {
     params?: Q,
     options?: QueryOptions,
   ): Observable<RawQueryResponse<R> | R> {
-    // Log the public API call to track parameter flow
-    // eslint-disable-next-line no-console
-    console.log('[client-8] ObservableSanityClient.fetch called with:', {
-      query: query.substring(0, 100) + (query.length > 100 ? '...' : ''),
-      params,
-      options: {
-        ...options,
-        decideParameters: options?.decideParameters,
-      },
-      clientConfig: {
-        decideParameters: this.#clientConfig.decideParameters,
-      },
-    })
     return dataMethods._fetch<R, Q>(
       this,
       this.#httpRequest,
@@ -1285,19 +1272,6 @@ export class SanityClient {
     params?: Q,
     options?: QueryOptions,
   ): Promise<RawQueryResponse<ClientReturn<G, R>> | ClientReturn<G, R>> {
-    // Log the public API call to track parameter flow
-    // eslint-disable-next-line no-console
-    console.log('[client-8] SanityClient.fetch called with:', {
-      query: query.substring(0, 100) + (query.length > 100 ? '...' : ''),
-      params,
-      options: {
-        ...options,
-        decideParameters: options?.decideParameters,
-      },
-      clientConfig: {
-        decideParameters: this.#clientConfig.decideParameters,
-      },
-    })
     return lastValueFrom(
       dataMethods._fetch<ClientReturn<G, R>, Q>(
         this,

package/src/data/dataMethods.ts

@@ -44,7 +44,6 @@ import {
   printCreateVersionWithBaseIdWarning,
   printPreviewDraftsDeprecationWarning,
 } from '../warnings'
-import {processDecideFields} from './decideResponseProcessor'
 import {encodeQueryString} from './encodeQueryString'
 import {ObservablePatch, Patch} from './patch'
 import {ObservableTransaction, Transaction} from './transaction'
@@ -98,12 +97,6 @@ export function _fetch<R, Q>(
   const mapResponse =
     options.filterResponse === false ? (res: Any) => res : (res: Any) => res.result
 
-  // Helper function to apply decide processing to response data
-  const processDecideResponse = (response: Any): Any => {
-    const processedData = processDecideFields(response, options.decideParameters)
-    return processedData
-  }
-
   const {cache, next, ...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.
@@ -121,7 +114,6 @@ export function _fetch<R, Q>(
       : opts
 
   const $request = _dataRequest(client, httpRequest, 'query', {query, params}, reqOpts)
-
   return stega.enabled
     ? $request.pipe(
         combineLatestWith(
@@ -136,20 +128,12 @@ export function _fetch<R, Q>(
             Any,
             (typeof import('../stega/stegaEncodeSourceMap'))['stegaEncodeSourceMap'],
           ]) => {
-            // Process decide fields BEFORE stega encoding to avoid processing source map references
-            const processedResult = processDecideFields(res.result, options.decideParameters)
-            const result = stegaEncodeSourceMap(processedResult, res.resultSourceMap, stega)
-            const mappedResponse = mapResponse({...res, result})
-            return mappedResponse
+            const result = stegaEncodeSourceMap(res.result, res.resultSourceMap, stega)
+            return mapResponse({...res, result})
           },
         ),
       )
-    : $request.pipe(
-        map((res) => {
-          const mappedResponse = mapResponse(res)
-          return processDecideResponse(mappedResponse)
-        }),
-      )
+    : $request.pipe(map(mapResponse))
 }
 
 /** @internal */
@@ -520,7 +504,6 @@ export function _dataRequest(
     tag,
     returnQuery,
     perspective: options.perspective,
-    decideParameters: options.decideParameters,
     resultSourceMap: options.resultSourceMap,
     lastLiveEventId: Array.isArray(lastLiveEventId) ? lastLiveEventId[0] : lastLiveEventId,
     cacheMode: cacheMode,
@@ -531,7 +514,6 @@ export function _dataRequest(
     useCdn: options.useCdn,
   }
 
-
   return _requestObservable(client, httpRequest, reqOptions).pipe(
     filter(isResponse),
     map(getBody),
@@ -615,7 +597,6 @@ export function _requestObservable<R>(
   const uri = options.url || (options.uri as string)
   const config = client.config()
 
-
   // If the `canUseCdn`-option is not set we detect it automatically based on the method + URL.
   // Only the /data endpoint is currently available through API-CDN.
   const canUseCdn =
@@ -665,14 +646,6 @@ export function _requestObservable<R>(
       }
     }
 
-    // Process decideParameters - keep them available for response processing but don't send to HTTP
-    const decideParametersOption = options.decideParameters || config.decideParameters
-
-    if (decideParametersOption && typeof decideParametersOption === 'object') {
-      // Note: We intentionally do NOT add decideParameters to the query string
-      // They should only be used for response formatting, not sent as HTTP query params
-    }
-
     if (options.lastLiveEventId) {
       options.query = {...options.query, lastLiveEventId: options.lastLiveEventId}
     }
@@ -686,13 +659,12 @@ export function _requestObservable<R>(
     }
   }
 
-  const finalOptions = Object.assign({}, options, {
-    url: _getUrl(client, uri, useCdn),
-  })
-
-
-  const reqOptions = requestOptions(config, finalOptions) as RequestOptions
-
+  const reqOptions = requestOptions(
+    config,
+    Object.assign({}, options, {
+      url: _getUrl(client, uri, useCdn),
+    }),
+  ) as RequestOptions
 
   const request = new Observable<HttpRequestEvent<R>>((subscriber) =>
     httpRequest(reqOptions, config.requester!).subscribe(subscriber),

package/src/defineCreateClient.ts

@@ -56,6 +56,7 @@ export default function defineCreateClientExports<
           maxRedirects: 0,
           maxRetries: config.maxRetries,
           retryDelay: config.retryDelay,
+          lineage: config.lineage,
           ...options,
         } as Any),
       config,

package/src/http/nodeMiddleware.ts

@@ -1,11 +1,28 @@
+import type {Middleware, RequestOptions} from 'get-it'
 import {agent, debug, headers} from 'get-it/middleware'
 
 import {name, version} from '../../package.json'
 
-const middleware = [
+const middleware: Middleware[] = [
   debug({verbose: true, namespace: 'sanity:client'}),
   headers({'User-Agent': `${name} ${version}`}),
 
+  // Lineage is used for recursion control/tracing and can be passed either through
+  // client constructor or through environent variable.
+  // Not used in browser environments.
+  {
+    processOptions(opts: RequestOptions & {lineage?: string}) {
+      const lineage =
+        (typeof process !== 'undefined' && process.env.X_SANITY_LINEAGE) || opts.lineage
+
+      if (lineage) {
+        opts.headers = opts.headers || {}
+        opts.headers['x-sanity-lineage'] = lineage
+      }
+      return opts
+    },
+  },
+
   // Enable keep-alive, and in addition limit the number of sockets that can be opened.
   // This avoids opening too many connections to the server if someone tries to execute
   // a bunch of requests in parallel. It's recommended to have a concurrency limit

package/src/http/request.ts

@@ -58,10 +58,14 @@ function printWarnings(config: {ignoreWarnings?: string | RegExp | Array<string
   }
 }
 
+type HttpRequestConfig = {
+  ignoreWarnings?: string | RegExp | Array<string | RegExp>
+}
+
 /** @internal */
 export function defineHttpRequest(
   envMiddleware: Middlewares,
-  config: {ignoreWarnings?: string | RegExp | Array<string | RegExp>} = {},
+  config: HttpRequestConfig = {},
 ): Requester {
   return getIt([
     retry({shouldRetry}),

package/src/types.ts

@@ -53,12 +53,6 @@ export type ClientPerspective =
   | 'raw'
   | StackablePerspective[]
 
-/** @public */
-export interface DecideParameters {
-  audience: string | string[]
-  [key: string]: unknown
-}
-
 type ClientConfigResource =
   | {
       type: 'canvas'
@@ -95,12 +89,6 @@ export interface ClientConfig {
    * @defaultValue 'published'
    */
   perspective?: ClientPerspective
-
-  /**
-   * Parameters to pass to Sanity Decide for personalisation
-   */
-  decideParameters?: DecideParameters
-
   apiHost?: string
 
   /**
@@ -191,6 +179,10 @@ export interface ClientConfig {
    * Options for how, if enabled, Content Source Maps are encoded into query results using steganography
    */
   stega?: StegaConfig | boolean
+  /**
+   * Lineage token for recursion control
+   */
+  lineage?: string
 }
 
 /** @public */
@@ -408,7 +400,6 @@ export interface RequestObservableOptions extends Omit<RequestOptions, 'url'> {
   returnQuery?: boolean
   resultSourceMap?: boolean | 'withKeyArraySelector'
   perspective?: ClientPerspective
-  decideParameters?: DecideParameters
   lastLiveEventId?: string
   cacheMode?: 'noStale'
 }
@@ -566,8 +557,6 @@ export interface QueryParams {
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
   cache?: 'next' extends keyof RequestInit ? never : any
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  decideParameters?: never
-  /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
   filterResponse?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
   headers?: never
@@ -1246,7 +1235,6 @@ export interface ListenOptions {
 /** @public */
 export interface ResponseQueryOptions extends RequestOptions {
   perspective?: ClientPerspective
-  decideParameters?: DecideParameters
   resultSourceMap?: boolean | 'withKeyArraySelector'
   returnQuery?: boolean
   useCdn?: boolean