@sanity/client 6.12.2 → 6.12.3

package/dist/stega.d.ts

@@ -324,7 +324,12 @@ export declare interface ClientConfig {
   /**
    *@deprecated set `cache` and `next` options on `client.fetch` instead
    */
-  fetch?: RequestFetchOptions | boolean
+  fetch?:
+    | {
+        cache?: ResponseQueryOptions['cache']
+        next?: ResponseQueryOptions['next']
+      }
+    | boolean
   /**
    * Options for how, if enabled, Content Source Maps are encoded into query results using steganography
    */
@@ -704,7 +709,7 @@ export declare type InsertPatch =
 export declare function _listen<R extends Record<string, Any> = Record<string, Any>>(
   this: SanityClient | ObservableSanityClient,
   query: string,
-  params?: QueryParams,
+  params?: ListenParams,
 ): Observable<MutationEvent_2<R>>
 
 /**
@@ -718,7 +723,7 @@ export declare function _listen<R extends Record<string, Any> = Record<string, A
 export declare function _listen<R extends Record<string, Any> = Record<string, Any>>(
   this: SanityClient | ObservableSanityClient,
   query: string,
-  params?: QueryParams,
+  params?: ListenParams,
   options?: ListenOptions,
 ): Observable<ListenEvent<R>>
 
@@ -788,6 +793,11 @@ export declare interface ListenOptions {
   tag?: string
 }
 
+/** @public */
+export declare type ListenParams = {
+  [key: string]: Any
+}
+
 /** @public */
 export declare type Logger =
   | typeof console
@@ -945,12 +955,17 @@ export declare type MutationOperation = 'create' | 'delete' | 'update' | 'none'
 export declare type MutationSelection =
   | {
       query: string
-      params?: QueryParams
+      params?: MutationSelectionQueryParams
     }
   | {
       id: string | string[]
     }
 
+/** @internal */
+export declare type MutationSelectionQueryParams = {
+  [key: string]: Any
+}
+
 /** @internal */
 export declare class ObservableAssetsClient {
   #private
@@ -1155,54 +1170,34 @@ export declare class ObservableSanityClient {
    *
    * @param query - GROQ-query to perform
    */
-  fetch<R = Any>(query: string): Observable<R>
-  /**
-   * Perform a GROQ-query against the configured dataset.
-   *
-   * @param query - GROQ-query to perform
-   * @param params - Query parameters
-   */
-  fetch<R = Any, Q = QueryParamsWithoutQueryOptions>(query: string, params: Q): Observable<R>
+  fetch<R = Any, Q extends QueryWithoutParams = QueryWithoutParams>(
+    query: string,
+    params?: Q | QueryWithoutParams,
+  ): Observable<R>
   /**
    * Perform a GROQ-query against the configured dataset.
    *
    * @param query - GROQ-query to perform
-   * @param params - Query parameters
-   * @param options - Request options
+   * @param params - Optional query parameters
+   * @param options - Optional request options
    */
-  fetch<R = Any, Q = QueryParamsWithoutQueryOptions>(
+  fetch<R = Any, Q extends QueryWithoutParams | QueryParams = QueryParams>(
     query: string,
-    params: Q | undefined,
-    options: FilteredResponseQueryOptions,
+    params: Q extends QueryWithoutParams ? QueryWithoutParams : Q,
+    options?: FilteredResponseQueryOptions,
   ): Observable<R>
   /**
    * Perform a GROQ-query against the configured dataset.
    *
    * @param query - GROQ-query to perform
-   * @param params - Query parameters
+   * @param params - Optional query parameters
    * @param options - Request options
    */
-  fetch<R = Any, Q = QueryParamsWithoutQueryOptions>(
+  fetch<R = Any, Q extends QueryWithoutParams | QueryParams = QueryParams>(
     query: string,
-    params: Q | undefined,
+    params: Q extends QueryWithoutParams ? QueryWithoutParams : Q,
     options: UnfilteredResponseQueryOptions,
   ): Observable<RawQueryResponse<R>>
-  /**
-   * You're passing in query parameters to a GROQ query that looks like query options.
-   * This is likely a mistake, you can either:
-   * a) replace the second argument with an empty object, and move the options to the third argument
-   * ```diff
-   * -client.fetch(query, {cache: 'no-store'})
-   * +client.fetch(query, {}, {cache: 'no-store'})
-   * ```
-   * b) add a generic type parameter that allows the query parameters to be passed in to silence the error
-   * @deprecated not actually deprecated, marking it as deprecated makes this error easier to spot
-   */
-  fetch<R = Any>(
-    query: string,
-    params: QueryParamsLikelyByMistake & QueryParams,
-    options?: QueryOptions,
-  ): unknown
   /**
    * Fetch a single document with the given ID.
    *
@@ -1799,68 +1794,45 @@ export declare class ProjectsClient {
 export declare type QueryOptions = FilteredResponseQueryOptions | UnfilteredResponseQueryOptions
 
 /** @public */
-export declare type QueryParams = {
-  [key: string]: Any
-}
-
-/**
- * It's easy to accidentally set query options such as `filterResponse`, `cache` and `next` as the second parameter in `client.fetch`,
- * as that is a wide type used to set GROQ query paramaters and it accepts anything that can serialize to JSON.
- * This type is used to prevent that, and will cause a type error if you try to pass a query option as the second parameter.
- * If this type is `never`, it means `_QueryParamsLikelyByMistake` is missing keys from `QueryOptions`.
- * @internal
- */
-export declare type QueryParamsLikelyByMistake =
-  Required<_QueryParamsLikelyByMistake> extends Record<keyof QueryOptions, Any>
-    ? _QueryParamsLikelyByMistake
-    : never
-
-/**
- * Verify this type has all the same keys as QueryOptions before exporting
- * @internal
- */
-export declare type _QueryParamsLikelyByMistake = {
+export declare interface QueryParams {
+  [key: string]: any
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  body?: Any
+  body?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  cache?: Any
+  cache?: 'next' extends keyof RequestInit ? never : any
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  filterResponse?: Any
+  filterResponse?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  headers?: Any
+  headers?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  method?: Any
+  method?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  next?: Any
+  next?: 'next' extends keyof RequestInit ? never : any
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  perspective?: Any
+  perspective?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  query?: Any
+  query?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  resultSourceMap?: Any
+  resultSourceMap?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  signal?: Any
+  signal?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  stega?: Any
+  stega?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  tag?: Any
+  tag?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  timeout?: Any
+  timeout?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  token?: Any
+  token?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  useCdn?: Any
+  useCdn?: never
 }
 
 /**
- * It's easy to accidentally set query options such as `filterResponse`, `cache` and `next` as the second parameter in `client.fetch`,
- * as that is a wide type used to set GROQ query paramaters and it accepts anything that can serialize to JSON.
- * This type is used to prevent that, and will cause a type error if you try to pass a query option as the second parameter.
- * @internal
+ * This type can be used with `client.fetch` to indicate that the query has no GROQ parameters.
+ * @public
  */
-export declare type QueryParamsWithoutQueryOptions = {
-  [K in keyof _QueryParamsLikelyByMistake]: never
-} & QueryParams
+export declare type QueryWithoutParams = Record<string, never> | undefined
 
 /** @public */
 export declare interface RawQueryResponse<R> {
@@ -1904,15 +1876,6 @@ export declare type ReconnectEvent = {
 /** @public */
 export declare const requester: Requester
 
-/**
- * Options for the native `fetch` feature, used by the Next.js app-router
- * @public
- */
-export declare interface RequestFetchOptions<T = 'next'> {
-  cache?: RequestInit['cache']
-  next?: T extends keyof RequestInit ? RequestInit[T] : never
-}
-
 /** @internal */
 export declare interface RequestObservableOptions extends Omit<RequestOptions, 'url'> {
   url?: string
@@ -2014,25 +1977,21 @@ export declare class SanityClient {
    *
    * @param query - GROQ-query to perform
    */
-  fetch<R = Any>(query: string): Promise<R>
-  /**
-   * Perform a GROQ-query against the configured dataset.
-   *
-   * @param query - GROQ-query to perform
-   * @param params - Optional query parameters
-   */
-  fetch<R = Any, Q = QueryParamsWithoutQueryOptions>(query: string, params: Q): Promise<R>
+  fetch<R = Any, Q extends QueryWithoutParams = QueryWithoutParams>(
+    query: string,
+    params?: Q | QueryWithoutParams,
+  ): Promise<R>
   /**
    * Perform a GROQ-query against the configured dataset.
    *
    * @param query - GROQ-query to perform
    * @param params - Optional query parameters
-   * @param options - Request options
+   * @param options - Optional request options
    */
-  fetch<R = Any, Q = QueryParamsWithoutQueryOptions>(
+  fetch<R = Any, Q extends QueryWithoutParams | QueryParams = QueryParams>(
     query: string,
-    params: Q | undefined,
-    options: FilteredResponseQueryOptions,
+    params: Q extends QueryWithoutParams ? QueryWithoutParams : Q,
+    options?: FilteredResponseQueryOptions,
   ): Promise<R>
   /**
    * Perform a GROQ-query against the configured dataset.
@@ -2041,27 +2000,11 @@ export declare class SanityClient {
    * @param params - Optional query parameters
    * @param options - Request options
    */
-  fetch<R = Any, Q = QueryParamsWithoutQueryOptions>(
+  fetch<R = Any, Q extends QueryWithoutParams | QueryParams = QueryParams>(
     query: string,
-    params: Q | undefined,
+    params: Q extends QueryWithoutParams ? QueryWithoutParams : Q,
     options: UnfilteredResponseQueryOptions,
   ): Promise<RawQueryResponse<R>>
-  /**
-   * You're passing in query parameters to a GROQ query that looks like query options.
-   * This is likely a mistake, you can either:
-   * a) replace the second argument with an empty object, and move the options to the third argument
-   * ```diff
-   * -client.fetch(query, {cache: 'no-store'})
-   * +client.fetch(query, {}, {cache: 'no-store'})
-   * ```
-   * b) add a generic type parameter that allows the query parameters to be passed in to silence the error
-   * @deprecated not actually deprecated, marking it as deprecated makes this error easier to spot
-   */
-  fetch<R = Any>(
-    query: string,
-    params: QueryParamsLikelyByMistake & QueryParams,
-    options?: QueryOptions,
-  ): unknown
   /**
    * Fetch a single document with the given ID.
    *

package/dist/stega.js

@@ -1,7 +1,7 @@
-import { SanityClient, ObservableSanityClient, defineCreateClientExports, middleware } from './_chunks/nodeMiddleware-itgO-mht.js';
-export { BasePatch, BaseTransaction, ClientError, ObservablePatch, ObservableTransaction, Patch, ServerError, Transaction, vercelStegaCleanAll } from './_chunks/nodeMiddleware-itgO-mht.js';
+import { SanityClient, ObservableSanityClient, defineCreateClientExports, middleware } from './_chunks/nodeMiddleware-OX5-R8Hk.js';
+export { BasePatch, BaseTransaction, ClientError, ObservablePatch, ObservableTransaction, Patch, ServerError, Transaction, vercelStegaCleanAll } from './_chunks/nodeMiddleware-OX5-R8Hk.js';
 export { adapter as unstable__adapter, environment as unstable__environment } from 'get-it';
-export { encodeIntoResult, stegaEncodeSourceMap } from './_chunks/stegaEncodeSourceMap-6b6FFhTO.js';
+export { encodeIntoResult, stegaEncodeSourceMap } from './_chunks/stegaEncodeSourceMap-OKnT3zAM.js';
 
 class SanityStegaClient extends SanityClient {
 }

package/package.json

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

package/src/SanityClient.ts

@@ -27,8 +27,7 @@ import type {
   PatchSelection,
   QueryOptions,
   QueryParams,
-  QueryParamsLikelyByMistake,
-  QueryParamsWithoutQueryOptions,
+  QueryWithoutParams,
   RawQueryResponse,
   RawRequestOptions,
   SanityDocument,
@@ -133,58 +132,35 @@ export class ObservableSanityClient {
    *
    * @param query - GROQ-query to perform
    */
-  fetch<R = Any>(query: string): Observable<R>
-  /**
-   * Perform a GROQ-query against the configured dataset.
-   *
-   * @param query - GROQ-query to perform
-   * @param params - Query parameters
-   */
-  fetch<R = Any, Q = QueryParamsWithoutQueryOptions>(query: string, params: Q): Observable<R>
+  fetch<R = Any, Q extends QueryWithoutParams = QueryWithoutParams>(
+    query: string,
+    params?: Q | QueryWithoutParams,
+  ): Observable<R>
   /**
    * Perform a GROQ-query against the configured dataset.
    *
    * @param query - GROQ-query to perform
-   * @param params - Query parameters
-   * @param options - Request options
+   * @param params - Optional query parameters
+   * @param options - Optional request options
    */
-  fetch<R = Any, Q = QueryParamsWithoutQueryOptions>(
+  fetch<R = Any, Q extends QueryWithoutParams | QueryParams = QueryParams>(
     query: string,
-    params: Q | undefined,
-    options: FilteredResponseQueryOptions,
+    params: Q extends QueryWithoutParams ? QueryWithoutParams : Q,
+    options?: FilteredResponseQueryOptions,
   ): Observable<R>
   /**
    * Perform a GROQ-query against the configured dataset.
    *
    * @param query - GROQ-query to perform
-   * @param params - Query parameters
+   * @param params - Optional query parameters
    * @param options - Request options
    */
-  fetch<R = Any, Q = QueryParamsWithoutQueryOptions>(
+  fetch<R = Any, Q extends QueryWithoutParams | QueryParams = QueryParams>(
     query: string,
-    params: Q | undefined,
+    params: Q extends QueryWithoutParams ? QueryWithoutParams : Q,
     options: UnfilteredResponseQueryOptions,
   ): Observable<RawQueryResponse<R>>
-  /**
-   * You're passing in query parameters to a GROQ query that looks like query options.
-   * This is likely a mistake, you can either:
-   * a) replace the second argument with an empty object, and move the options to the third argument
-   * ```diff
-   * -client.fetch(query, {cache: 'no-store'})
-   * +client.fetch(query, {}, {cache: 'no-store'})
-   * ```
-   * b) add a generic type parameter that allows the query parameters to be passed in to silence the error
-   * @deprecated not actually deprecated, marking it as deprecated makes this error easier to spot
-   */
-  fetch<
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    R = Any,
-  >(
-    query: string,
-    params: QueryParamsLikelyByMistake & QueryParams,
-    options?: QueryOptions,
-  ): unknown
-  fetch<R, Q extends QueryParams>(
+  fetch<R, Q>(
     query: string,
     params?: Q,
     options?: QueryOptions,
@@ -795,25 +771,21 @@ export class SanityClient {
    *
    * @param query - GROQ-query to perform
    */
-  fetch<R = Any>(query: string): Promise<R>
-  /**
-   * Perform a GROQ-query against the configured dataset.
-   *
-   * @param query - GROQ-query to perform
-   * @param params - Optional query parameters
-   */
-  fetch<R = Any, Q = QueryParamsWithoutQueryOptions>(query: string, params: Q): Promise<R>
+  fetch<R = Any, Q extends QueryWithoutParams = QueryWithoutParams>(
+    query: string,
+    params?: Q | QueryWithoutParams,
+  ): Promise<R>
   /**
    * Perform a GROQ-query against the configured dataset.
    *
    * @param query - GROQ-query to perform
    * @param params - Optional query parameters
-   * @param options - Request options
+   * @param options - Optional request options
    */
-  fetch<R = Any, Q = QueryParamsWithoutQueryOptions>(
+  fetch<R = Any, Q extends QueryWithoutParams | QueryParams = QueryParams>(
     query: string,
-    params: Q | undefined,
-    options: FilteredResponseQueryOptions,
+    params: Q extends QueryWithoutParams ? QueryWithoutParams : Q,
+    options?: FilteredResponseQueryOptions,
   ): Promise<R>
   /**
    * Perform a GROQ-query against the configured dataset.
@@ -822,35 +794,12 @@ export class SanityClient {
    * @param params - Optional query parameters
    * @param options - Request options
    */
-  fetch<R = Any, Q = QueryParamsWithoutQueryOptions>(
+  fetch<R = Any, Q extends QueryWithoutParams | QueryParams = QueryParams>(
     query: string,
-    params: Q | undefined,
+    params: Q extends QueryWithoutParams ? QueryWithoutParams : Q,
     options: UnfilteredResponseQueryOptions,
   ): Promise<RawQueryResponse<R>>
-  /**
-   * You're passing in query parameters to a GROQ query that looks like query options.
-   * This is likely a mistake, you can either:
-   * a) replace the second argument with an empty object, and move the options to the third argument
-   * ```diff
-   * -client.fetch(query, {cache: 'no-store'})
-   * +client.fetch(query, {}, {cache: 'no-store'})
-   * ```
-   * b) add a generic type parameter that allows the query parameters to be passed in to silence the error
-   * @deprecated not actually deprecated, marking it as deprecated makes this error easier to spot
-   */
-  fetch<
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    R = Any,
-  >(
-    query: string,
-    params: QueryParamsLikelyByMistake & QueryParams,
-    options?: QueryOptions,
-  ): unknown
-  fetch<R, Q extends QueryParams>(
-    query: string,
-    params?: Q,
-    options?: QueryOptions,
-  ): Promise<RawQueryResponse<R> | R> {
+  fetch<R, Q>(query: string, params?: Q, options?: QueryOptions): Promise<RawQueryResponse<R> | R> {
     return lastValueFrom(
       dataMethods._fetch<R, Q>(
         this,

package/src/data/encodeQueryString.ts

@@ -1,4 +1,4 @@
-import type {Any, QueryParams} from '../types'
+import type {Any, ListenParams, QueryParams} from '../types'
 
 export const encodeQueryString = ({
   query,
@@ -6,7 +6,7 @@ export const encodeQueryString = ({
   options = {},
 }: {
   query: string
-  params?: QueryParams
+  params?: ListenParams | QueryParams
   options?: Any
 }) => {
   const searchParams = new URLSearchParams()

package/src/data/listen.ts

@@ -1,7 +1,7 @@
 import {Observable} from 'rxjs'
 
 import type {ObservableSanityClient, SanityClient} from '../SanityClient'
-import type {Any, ListenEvent, ListenOptions, MutationEvent, QueryParams} from '../types'
+import type {Any, ListenEvent, ListenOptions, ListenParams, MutationEvent} from '../types'
 import defaults from '../util/defaults'
 import {pick} from '../util/pick'
 import {_getDataUrl} from './dataMethods'
@@ -35,7 +35,7 @@ const defaultOptions = {
 export function _listen<R extends Record<string, Any> = Record<string, Any>>(
   this: SanityClient | ObservableSanityClient,
   query: string,
-  params?: QueryParams,
+  params?: ListenParams,
 ): Observable<MutationEvent<R>>
 /**
  * Set up a listener that will be notified when mutations occur on documents matching the provided query/filter.
@@ -48,14 +48,14 @@ export function _listen<R extends Record<string, Any> = Record<string, Any>>(
 export function _listen<R extends Record<string, Any> = Record<string, Any>>(
   this: SanityClient | ObservableSanityClient,
   query: string,
-  params?: QueryParams,
+  params?: ListenParams,
   options?: ListenOptions,
 ): Observable<ListenEvent<R>>
 /** @public */
 export function _listen<R extends Record<string, Any> = Record<string, Any>>(
   this: SanityClient | ObservableSanityClient,
   query: string,
-  params?: QueryParams,
+  params?: ListenParams,
   opts: ListenOptions = {},
 ): Observable<MutationEvent<R> | ListenEvent<R>> {
   const {url, token, withCredentials, requestTagPrefix} = this.config()

package/src/types.ts

@@ -30,15 +30,6 @@ export interface RequestOptions {
   signal?: AbortSignal
 }
 
-/**
- * Options for the native `fetch` feature, used by the Next.js app-router
- * @public
- */
-export interface RequestFetchOptions<T = 'next'> {
-  cache?: RequestInit['cache']
-  next?: T extends keyof RequestInit ? RequestInit[T] : never
-}
-
 /** @public */
 export type ClientPerspective = 'previewDrafts' | 'published' | 'raw'
 
@@ -90,7 +81,12 @@ export interface ClientConfig {
   /**
    *@deprecated set `cache` and `next` options on `client.fetch` instead
    */
-  fetch?: RequestFetchOptions | boolean
+  fetch?:
+    | {
+        cache?: ResponseQueryOptions['cache']
+        next?: ResponseQueryOptions['next']
+      }
+    | boolean
   /**
    * Options for how, if enabled, Content Source Maps are encoded into query results using steganography
    */
@@ -434,69 +430,54 @@ export interface PatchOperations {
 }
 
 /** @public */
-export type QueryParams = {[key: string]: Any}
-
-/**
- * Verify this type has all the same keys as QueryOptions before exporting
- * @internal
- */
-export type _QueryParamsLikelyByMistake = {
+export interface QueryParams {
+  /* eslint-disable @typescript-eslint/no-explicit-any */
+  [key: string]: any
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  body?: Any
+  body?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  cache?: Any
+  cache?: 'next' extends keyof RequestInit ? never : any
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  filterResponse?: Any
+  filterResponse?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  headers?: Any
+  headers?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  method?: Any
+  method?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  next?: Any
+  next?: 'next' extends keyof RequestInit ? never : any
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  perspective?: Any
+  perspective?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  query?: Any
+  query?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  resultSourceMap?: Any
+  resultSourceMap?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  signal?: Any
+  signal?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  stega?: Any
+  stega?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  tag?: Any
+  tag?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  timeout?: Any
+  timeout?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  token?: Any
+  token?: never
   /** @deprecated you're using a fetch option as a GROQ parameter, this is likely a mistake */
-  useCdn?: Any
+  useCdn?: never
+  /* eslint-enable @typescript-eslint/no-explicit-any */
 }
 
 /**
- * It's easy to accidentally set query options such as `filterResponse`, `cache` and `next` as the second parameter in `client.fetch`,
- * as that is a wide type used to set GROQ query paramaters and it accepts anything that can serialize to JSON.
- * This type is used to prevent that, and will cause a type error if you try to pass a query option as the second parameter.
- * If this type is `never`, it means `_QueryParamsLikelyByMistake` is missing keys from `QueryOptions`.
- * @internal
- */
-export type QueryParamsLikelyByMistake =
-  Required<_QueryParamsLikelyByMistake> extends Record<keyof QueryOptions, Any>
-    ? _QueryParamsLikelyByMistake
-    : never
-
-/**
- * It's easy to accidentally set query options such as `filterResponse`, `cache` and `next` as the second parameter in `client.fetch`,
- * as that is a wide type used to set GROQ query paramaters and it accepts anything that can serialize to JSON.
- * This type is used to prevent that, and will cause a type error if you try to pass a query option as the second parameter.
- * @internal
+ * This type can be used with `client.fetch` to indicate that the query has no GROQ parameters.
+ * @public
  */
-export type QueryParamsWithoutQueryOptions = {
-  [K in keyof _QueryParamsLikelyByMistake]: never
-} & QueryParams
+export type QueryWithoutParams = Record<string, never> | undefined
 
 /** @internal */
-export type MutationSelection = {query: string; params?: QueryParams} | {id: string | string[]}
+export type MutationSelectionQueryParams = {[key: string]: Any}
+/** @internal */
+export type MutationSelection =
+  | {query: string; params?: MutationSelectionQueryParams}
+  | {id: string | string[]}
 /** @internal */
 export type PatchSelection = string | string[] | MutationSelection
 /** @internal */
@@ -679,6 +660,9 @@ export type ListenEventName =
   /** The listener has been disconnected, and a reconnect attempt is scheduled */
   | 'reconnect'
 
+/** @public */
+export type ListenParams = {[key: string]: Any}
+
 /** @public */
 export interface ListenOptions {
   /**