@kubb/plugin-react-query 5.0.0-beta.30 → 5.0.0-beta.33

package/dist/index.cjs

@@ -2,8 +2,8 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_components = require("./components-MPBTffPl.cjs");
-const require_generators = require("./generators-BtsWNz-6.cjs");
+const require_components = require("./components-DLUeLMsz.cjs");
+const require_generators = require("./generators--AcF4Y4n.cjs");
 let node_path = require("node:path");
 node_path = require_components.__toESM(node_path, 1);
 let _kubb_core = require("@kubb/core");
@@ -13,6 +13,39 @@ let _kubb_plugin_client_templates_clients_fetch_source = require("@kubb/plugin-c
 let _kubb_plugin_client_templates_config_source = require("@kubb/plugin-client/templates/config.source");
 let _kubb_plugin_ts = require("@kubb/plugin-ts");
 let _kubb_plugin_zod = require("@kubb/plugin-zod");
+//#region ../../internals/shared/src/group.ts
+/**
+* Builds the `group` config a Kubb plugin passes to `ctx.setOptions`, applying the
+* shared default naming so every plugin groups output consistently:
+*
+* - `path` groups use the second path segment (`/pet/findByStatus` → `pet`).
+* - other groups use `${camelCase(group)}${suffix}` (e.g. `petController`).
+*
+* Returns `null` when grouping is disabled, matching the per-plugin convention.
+*
+* @param group - The user-supplied group option, or `undefined` to disable grouping.
+* @param options.suffix - Appended to non-`path` group names, e.g. `'Controller'` or `'Requests'`.
+* @param options.honorName - When `true`, a user-provided `group.name` overrides the default namer.
+*
+* @example
+* ```ts
+* createGroupConfig(group, { suffix: 'Controller' })                  // plugin-ts, plugin-zod
+* createGroupConfig(group, { suffix: 'Controller', honorName: true }) // plugin-faker, plugin-client, …
+* createGroupConfig(group, { suffix: 'Requests', honorName: true })   // plugin-cypress, plugin-mcp
+* ```
+*/
+function createGroupConfig(group, options) {
+	if (!group) return null;
+	const defaultName = (ctx) => {
+		if (group.type === "path") return `${ctx.group.split("/")[1]}`;
+		return `${require_components.camelCase(ctx.group)}${options.suffix}`;
+	};
+	return {
+		...group,
+		name: options.honorName && group.name ? group.name : defaultName
+	};
+}
+//#endregion
 //#region src/resolvers/resolverReactQuery.ts
 function capitalize(name) {
 	return `${name.charAt(0).toUpperCase()}${name.slice(1)}`;
@@ -163,7 +196,7 @@ const pluginReactQuery = (0, _kubb_core.definePlugin)((options) => {
 	const { output = {
 		path: "hooks",
 		barrelType: "named"
-	}, group, exclude = [], include, override = [], parser = "client", suspense = {}, infinite = false, paramsType = "inline", pathParamsType = paramsType === "object" ? "object" : options.pathParamsType || "inline", mutation = {}, query = {}, mutationKey = require_components.mutationKeyTransformer, queryKey = require_components.queryKeyTransformer, customOptions, paramsCasing, client, resolver: userResolver, transformer: userTransformer, generators: userGenerators = [] } = options;
+	}, group, exclude = [], include, override = [], parser = false, suspense = {}, infinite = false, paramsType = "inline", pathParamsType = paramsType === "object" ? "object" : options.pathParamsType || "inline", mutation = {}, query = {}, mutationKey = require_components.mutationKeyTransformer, queryKey = require_components.queryKeyTransformer, customOptions, paramsCasing, client, resolver: userResolver, transformer: userTransformer, generators: userGenerators = [] } = options;
 	const clientName = client?.client ?? "axios";
 	const clientImportPath = client?.importPath ?? (!client?.bundle ? `@kubb/plugin-client/clients/${clientName}` : void 0);
 	const selectedGenerators = options.generators ?? [
@@ -175,13 +208,10 @@ const pluginReactQuery = (0, _kubb_core.definePlugin)((options) => {
 		require_generators.hookOptionsGenerator,
 		require_generators.customHookOptionsFileGenerator
 	].filter((generator) => Boolean(generator));
-	const groupConfig = group ? {
-		...group,
-		name: group.name ? group.name : (ctx) => {
-			if (group.type === "path") return `${ctx.group.split("/")[1]}`;
-			return `${require_components.camelCase(ctx.group)}Controller`;
-		}
-	} : null;
+	const groupConfig = createGroupConfig(group, {
+		suffix: "Controller",
+		honorName: true
+	});
 	return {
 		name: pluginReactQueryName,
 		options,

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["camelCase","mutationKeyTransformer","queryKeyTransformer","queryGenerator","suspenseQueryGenerator","infiniteQueryGenerator","suspenseInfiniteQueryGenerator","mutationGenerator","hookOptionsGenerator","customHookOptionsFileGenerator","camelCase","pluginTsName","pluginZodName","path","pluginClientName","ast","fetchClientSource","axiosClientSource","configSource"],"sources":["../src/resolvers/resolverReactQuery.ts","../src/plugin.ts"],"sourcesContent":["import { camelCase } from '@internals/utils'\nimport { defineResolver } from '@kubb/core'\nimport type { PluginReactQuery } from '../types.ts'\n\nfunction capitalize(name: string): string {\n  return `${name.charAt(0).toUpperCase()}${name.slice(1)}`\n}\n\n/**\n * Default resolver used by `@kubb/plugin-react-query`. Decides the names and\n * file paths for every generated TanStack Query hook (`useFooQuery`,\n * `useFooMutation`, `useFooInfiniteQuery`, ...) and its companion helpers\n * (`fooQueryKey`, `fooQueryOptions`).\n *\n * Functions and files use camelCase; hooks get the `use` prefix; suspense and\n * infinite variants are suffixed with `Suspense`/`Infinite`.\n *\n * @example Resolve hook and helper names\n * ```ts\n * import { resolverReactQuery } from '@kubb/plugin-react-query'\n *\n * resolverReactQuery.resolveQueryName(operationNode)       // 'useGetPetById'\n * resolverReactQuery.resolveMutationName(operationNode)    // 'useUpdatePet'\n * resolverReactQuery.resolveQueryKeyName(operationNode)    // 'getPetByIdQueryKey'\n * resolverReactQuery.resolveQueryOptionsName(operationNode) // 'getPetByIdQueryOptions'\n * ```\n */\nexport const resolverReactQuery = defineResolver<PluginReactQuery>(() => ({\n  name: 'default',\n  pluginName: 'plugin-react-query',\n  default(name, type) {\n    return camelCase(name, { isFile: type === 'file' })\n  },\n  resolveName(name) {\n    return this.default(name, 'function')\n  },\n  resolvePathName(name, type) {\n    return this.default(name, type)\n  },\n  resolveQueryName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}`\n  },\n  resolveSuspenseQueryName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}Suspense`\n  },\n  resolveInfiniteQueryName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}Infinite`\n  },\n  resolveSuspenseInfiniteQueryName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}SuspenseInfinite`\n  },\n  resolveMutationName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}`\n  },\n  resolveQueryOptionsName(node) {\n    return `${this.resolveName(node.operationId)}QueryOptions`\n  },\n  resolveSuspenseQueryOptionsName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseQueryOptions`\n  },\n  resolveInfiniteQueryOptionsName(node) {\n    return `${this.resolveName(node.operationId)}InfiniteQueryOptions`\n  },\n  resolveSuspenseInfiniteQueryOptionsName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseInfiniteQueryOptions`\n  },\n  resolveMutationOptionsName(node) {\n    return `${this.resolveName(node.operationId)}MutationOptions`\n  },\n  resolveQueryKeyName(node) {\n    return `${this.resolveName(node.operationId)}QueryKey`\n  },\n  resolveSuspenseQueryKeyName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseQueryKey`\n  },\n  resolveInfiniteQueryKeyName(node) {\n    return `${this.resolveName(node.operationId)}InfiniteQueryKey`\n  },\n  resolveSuspenseInfiniteQueryKeyName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseInfiniteQueryKey`\n  },\n  resolveMutationKeyName(node) {\n    return `${this.resolveName(node.operationId)}MutationKey`\n  },\n  resolveQueryKeyTypeName(node) {\n    return `${capitalize(this.resolveName(node.operationId))}QueryKey`\n  },\n  resolveSuspenseQueryKeyTypeName(node) {\n    return `${capitalize(this.resolveName(node.operationId))}SuspenseQueryKey`\n  },\n  resolveInfiniteQueryKeyTypeName(node) {\n    return `${capitalize(this.resolveName(node.operationId))}InfiniteQueryKey`\n  },\n  resolveSuspenseInfiniteQueryKeyTypeName(node) {\n    return `${capitalize(this.resolveName(node.operationId))}SuspenseInfiniteQueryKey`\n  },\n  resolveMutationTypeName(node) {\n    return capitalize(this.resolveName(node.operationId))\n  },\n  resolveClientName(node) {\n    return this.resolveName(node.operationId)\n  },\n  resolveSuspenseClientName(node) {\n    return `${this.resolveName(node.operationId)}Suspense`\n  },\n  resolveInfiniteClientName(node) {\n    return `${this.resolveName(node.operationId)}Infinite`\n  },\n  resolveSuspenseInfiniteClientName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseInfinite`\n  },\n  resolveHookOptionsName() {\n    return 'HookOptions'\n  },\n  resolveCustomHookOptionsName() {\n    return 'getCustomHookOptions'\n  },\n}))\n","import path from 'node:path'\nimport { camelCase } from '@internals/utils'\nimport { ast, definePlugin, type Group } from '@kubb/core'\nimport { pluginClientName } from '@kubb/plugin-client'\nimport { source as axiosClientSource } from '@kubb/plugin-client/templates/clients/axios.source'\nimport { source as fetchClientSource } from '@kubb/plugin-client/templates/clients/fetch.source'\nimport { source as configSource } from '@kubb/plugin-client/templates/config.source'\nimport { pluginTsName } from '@kubb/plugin-ts'\nimport { pluginZodName } from '@kubb/plugin-zod'\nimport { mutationKeyTransformer, queryKeyTransformer } from '@internals/tanstack-query'\nimport {\n  customHookOptionsFileGenerator,\n  hookOptionsGenerator,\n  infiniteQueryGenerator,\n  mutationGenerator,\n  queryGenerator,\n  suspenseInfiniteQueryGenerator,\n  suspenseQueryGenerator,\n} from './generators'\nimport { resolverReactQuery } from './resolvers/resolverReactQuery.ts'\nimport type { PluginReactQuery } from './types.ts'\n\n/**\n * Canonical plugin name for `@kubb/plugin-react-query`. Used for driver lookups\n * and cross-plugin dependency references.\n */\nexport const pluginReactQueryName = 'plugin-react-query' satisfies PluginReactQuery['name']\n\n/**\n * Generates one TanStack Query hook per OpenAPI operation for React. Queries\n * become `useFooQuery`/`useFooSuspenseQuery`/`useFooInfiniteQuery`; mutations\n * become `useFooMutation`. Each hook is fully typed: query keys, input\n * variables, response data, and error shape all come from the spec.\n *\n * @example\n * ```ts\n * import { defineConfig } from 'kubb'\n * import { pluginTs } from '@kubb/plugin-ts'\n * import { pluginReactQuery } from '@kubb/plugin-react-query'\n *\n * export default defineConfig({\n *   input: { path: './petStore.yaml' },\n *   output: { path: './src/gen' },\n *   plugins: [\n *     pluginTs(),\n *     pluginReactQuery({\n *       output: { path: './hooks' },\n *       suspense: {},\n *     }),\n *   ],\n * })\n * ```\n */\nexport const pluginReactQuery = definePlugin<PluginReactQuery>((options) => {\n  const {\n    output = { path: 'hooks', barrelType: 'named' },\n    group,\n    exclude = [],\n    include,\n    override = [],\n    parser = 'client',\n    suspense = {},\n    infinite = false,\n    paramsType = 'inline',\n    pathParamsType = paramsType === 'object' ? 'object' : options.pathParamsType || 'inline',\n    mutation = {},\n    query = {},\n    mutationKey = mutationKeyTransformer,\n    queryKey = queryKeyTransformer,\n    customOptions,\n    paramsCasing,\n    client,\n    resolver: userResolver,\n    transformer: userTransformer,\n    generators: userGenerators = [],\n  } = options\n\n  const clientName = client?.client ?? 'axios'\n  const clientImportPath = client?.importPath ?? (!client?.bundle ? `@kubb/plugin-client/clients/${clientName}` : undefined)\n\n  const selectedGenerators =\n    options.generators ??\n    [\n      queryGenerator,\n      suspenseQueryGenerator,\n      infiniteQueryGenerator,\n      suspenseInfiniteQueryGenerator,\n      mutationGenerator,\n      hookOptionsGenerator,\n      customHookOptionsFileGenerator,\n    ].filter((generator): generator is NonNullable<typeof generator> => Boolean(generator))\n\n  const groupConfig = group\n    ? ({\n        ...group,\n        name: group.name\n          ? group.name\n          : (ctx: { group: string }) => {\n              if (group.type === 'path') {\n                return `${ctx.group.split('/')[1]}`\n              }\n              return `${camelCase(ctx.group)}Controller`\n            },\n      } satisfies Group)\n    : null\n\n  return {\n    name: pluginReactQueryName,\n    options,\n    dependencies: [pluginTsName, parser === 'zod' ? pluginZodName : undefined].filter((dependency): dependency is string => Boolean(dependency)),\n    hooks: {\n      'kubb:plugin:setup'(ctx) {\n        const resolver = userResolver ? { ...resolverReactQuery, ...userResolver } : resolverReactQuery\n\n        ctx.setOptions({\n          output,\n          client: {\n            bundle: client?.bundle,\n            baseURL: client?.baseURL,\n            client: clientName,\n            clientType: client?.clientType ?? 'function',\n            importPath: clientImportPath,\n            dataReturnType: client?.dataReturnType ?? 'data',\n            paramsCasing,\n          },\n          queryKey,\n          query:\n            query === false\n              ? false\n              : {\n                  importPath: '@tanstack/react-query',\n                  methods: ['get'],\n                  ...query,\n                },\n          mutationKey,\n          mutation:\n            mutation === false\n              ? false\n              : {\n                  importPath: '@tanstack/react-query',\n                  methods: ['post', 'put', 'patch', 'delete'],\n                  ...mutation,\n                },\n          infinite: infinite\n            ? {\n                queryParam: 'id',\n                initialPageParam: 0,\n                cursorParam: null,\n                nextParam: null,\n                previousParam: null,\n                ...infinite,\n              }\n            : false,\n          suspense,\n          customOptions: customOptions ? { name: 'useCustomHookOptions', ...customOptions } : null,\n          parser,\n          paramsType,\n          pathParamsType,\n          paramsCasing,\n          group: groupConfig,\n          exclude,\n          include,\n          override,\n          resolver,\n        })\n        ctx.setResolver(resolver)\n        if (userTransformer) {\n          ctx.setTransformer(userTransformer)\n        }\n\n        for (const gen of selectedGenerators) {\n          ctx.addGenerator(gen)\n        }\n        for (const gen of userGenerators) {\n          ctx.addGenerator(gen)\n        }\n\n        const root = path.resolve(ctx.config.root, ctx.config.output.path)\n        const hasClientPlugin = !!ctx.config.plugins?.some((p) => (p as { name?: string }).name === pluginClientName)\n\n        if (client?.bundle && !hasClientPlugin && !clientImportPath) {\n          ctx.injectFile({\n            baseName: 'client.ts',\n            path: path.resolve(root, '.kubb/client.ts'),\n            sources: [\n              ast.createSource({\n                name: 'client',\n                nodes: [ast.createText(clientName === 'fetch' ? fetchClientSource : axiosClientSource)],\n                isExportable: true,\n                isIndexable: true,\n              }),\n            ],\n          })\n        }\n\n        if (!hasClientPlugin) {\n          ctx.injectFile({\n            baseName: 'config.ts',\n            path: path.resolve(root, '.kubb/config.ts'),\n            sources: [\n              ast.createSource({\n                name: 'config',\n                nodes: [ast.createText(configSource)],\n                isExportable: false,\n                isIndexable: false,\n              }),\n            ],\n          })\n        }\n      },\n    },\n  }\n})\n\nexport default pluginReactQuery\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["camelCase","camelCase","mutationKeyTransformer","queryKeyTransformer","queryGenerator","suspenseQueryGenerator","infiniteQueryGenerator","suspenseInfiniteQueryGenerator","mutationGenerator","hookOptionsGenerator","customHookOptionsFileGenerator","pluginTsName","pluginZodName","path","pluginClientName","ast","fetchClientSource","axiosClientSource","configSource"],"sources":["../../../internals/shared/src/group.ts","../src/resolvers/resolverReactQuery.ts","../src/plugin.ts"],"sourcesContent":["import { camelCase } from '@internals/utils'\nimport type { Group } from '@kubb/core'\n\n/**\n * Builds the `group` config a Kubb plugin passes to `ctx.setOptions`, applying the\n * shared default naming so every plugin groups output consistently:\n *\n * - `path` groups use the second path segment (`/pet/findByStatus` → `pet`).\n * - other groups use `${camelCase(group)}${suffix}` (e.g. `petController`).\n *\n * Returns `null` when grouping is disabled, matching the per-plugin convention.\n *\n * @param group - The user-supplied group option, or `undefined` to disable grouping.\n * @param options.suffix - Appended to non-`path` group names, e.g. `'Controller'` or `'Requests'`.\n * @param options.honorName - When `true`, a user-provided `group.name` overrides the default namer.\n *\n * @example\n * ```ts\n * createGroupConfig(group, { suffix: 'Controller' })                  // plugin-ts, plugin-zod\n * createGroupConfig(group, { suffix: 'Controller', honorName: true }) // plugin-faker, plugin-client, …\n * createGroupConfig(group, { suffix: 'Requests', honorName: true })   // plugin-cypress, plugin-mcp\n * ```\n */\nexport function createGroupConfig(group: Group | undefined, options: { suffix: string; honorName?: boolean }): Group | null {\n  if (!group) {\n    return null\n  }\n\n  const defaultName = (ctx: { group: string }): string => {\n    if (group.type === 'path') {\n      return `${ctx.group.split('/')[1]}`\n    }\n\n    return `${camelCase(ctx.group)}${options.suffix}`\n  }\n\n  return {\n    ...group,\n    name: options.honorName && group.name ? group.name : defaultName,\n  } satisfies Group\n}\n","import { camelCase } from '@internals/utils'\nimport { defineResolver } from '@kubb/core'\nimport type { PluginReactQuery } from '../types.ts'\n\nfunction capitalize(name: string): string {\n  return `${name.charAt(0).toUpperCase()}${name.slice(1)}`\n}\n\n/**\n * Default resolver used by `@kubb/plugin-react-query`. Decides the names and\n * file paths for every generated TanStack Query hook (`useFooQuery`,\n * `useFooMutation`, `useFooInfiniteQuery`, ...) and its companion helpers\n * (`fooQueryKey`, `fooQueryOptions`).\n *\n * Functions and files use camelCase; hooks get the `use` prefix; suspense and\n * infinite variants are suffixed with `Suspense`/`Infinite`.\n *\n * @example Resolve hook and helper names\n * ```ts\n * import { resolverReactQuery } from '@kubb/plugin-react-query'\n *\n * resolverReactQuery.resolveQueryName(operationNode)       // 'useGetPetById'\n * resolverReactQuery.resolveMutationName(operationNode)    // 'useUpdatePet'\n * resolverReactQuery.resolveQueryKeyName(operationNode)    // 'getPetByIdQueryKey'\n * resolverReactQuery.resolveQueryOptionsName(operationNode) // 'getPetByIdQueryOptions'\n * ```\n */\nexport const resolverReactQuery = defineResolver<PluginReactQuery>(() => ({\n  name: 'default',\n  pluginName: 'plugin-react-query',\n  default(name, type) {\n    return camelCase(name, { isFile: type === 'file' })\n  },\n  resolveName(name) {\n    return this.default(name, 'function')\n  },\n  resolvePathName(name, type) {\n    return this.default(name, type)\n  },\n  resolveQueryName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}`\n  },\n  resolveSuspenseQueryName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}Suspense`\n  },\n  resolveInfiniteQueryName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}Infinite`\n  },\n  resolveSuspenseInfiniteQueryName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}SuspenseInfinite`\n  },\n  resolveMutationName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}`\n  },\n  resolveQueryOptionsName(node) {\n    return `${this.resolveName(node.operationId)}QueryOptions`\n  },\n  resolveSuspenseQueryOptionsName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseQueryOptions`\n  },\n  resolveInfiniteQueryOptionsName(node) {\n    return `${this.resolveName(node.operationId)}InfiniteQueryOptions`\n  },\n  resolveSuspenseInfiniteQueryOptionsName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseInfiniteQueryOptions`\n  },\n  resolveMutationOptionsName(node) {\n    return `${this.resolveName(node.operationId)}MutationOptions`\n  },\n  resolveQueryKeyName(node) {\n    return `${this.resolveName(node.operationId)}QueryKey`\n  },\n  resolveSuspenseQueryKeyName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseQueryKey`\n  },\n  resolveInfiniteQueryKeyName(node) {\n    return `${this.resolveName(node.operationId)}InfiniteQueryKey`\n  },\n  resolveSuspenseInfiniteQueryKeyName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseInfiniteQueryKey`\n  },\n  resolveMutationKeyName(node) {\n    return `${this.resolveName(node.operationId)}MutationKey`\n  },\n  resolveQueryKeyTypeName(node) {\n    return `${capitalize(this.resolveName(node.operationId))}QueryKey`\n  },\n  resolveSuspenseQueryKeyTypeName(node) {\n    return `${capitalize(this.resolveName(node.operationId))}SuspenseQueryKey`\n  },\n  resolveInfiniteQueryKeyTypeName(node) {\n    return `${capitalize(this.resolveName(node.operationId))}InfiniteQueryKey`\n  },\n  resolveSuspenseInfiniteQueryKeyTypeName(node) {\n    return `${capitalize(this.resolveName(node.operationId))}SuspenseInfiniteQueryKey`\n  },\n  resolveMutationTypeName(node) {\n    return capitalize(this.resolveName(node.operationId))\n  },\n  resolveClientName(node) {\n    return this.resolveName(node.operationId)\n  },\n  resolveSuspenseClientName(node) {\n    return `${this.resolveName(node.operationId)}Suspense`\n  },\n  resolveInfiniteClientName(node) {\n    return `${this.resolveName(node.operationId)}Infinite`\n  },\n  resolveSuspenseInfiniteClientName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseInfinite`\n  },\n  resolveHookOptionsName() {\n    return 'HookOptions'\n  },\n  resolveCustomHookOptionsName() {\n    return 'getCustomHookOptions'\n  },\n}))\n","import path from 'node:path'\nimport { createGroupConfig } from '@internals/shared'\nimport { ast, definePlugin } from '@kubb/core'\nimport { pluginClientName } from '@kubb/plugin-client'\nimport { source as axiosClientSource } from '@kubb/plugin-client/templates/clients/axios.source'\nimport { source as fetchClientSource } from '@kubb/plugin-client/templates/clients/fetch.source'\nimport { source as configSource } from '@kubb/plugin-client/templates/config.source'\nimport { pluginTsName } from '@kubb/plugin-ts'\nimport { pluginZodName } from '@kubb/plugin-zod'\nimport { mutationKeyTransformer, queryKeyTransformer } from '@internals/tanstack-query'\nimport {\n  customHookOptionsFileGenerator,\n  hookOptionsGenerator,\n  infiniteQueryGenerator,\n  mutationGenerator,\n  queryGenerator,\n  suspenseInfiniteQueryGenerator,\n  suspenseQueryGenerator,\n} from './generators'\nimport { resolverReactQuery } from './resolvers/resolverReactQuery.ts'\nimport type { PluginReactQuery } from './types.ts'\n\n/**\n * Canonical plugin name for `@kubb/plugin-react-query`. Used for driver lookups\n * and cross-plugin dependency references.\n */\nexport const pluginReactQueryName = 'plugin-react-query' satisfies PluginReactQuery['name']\n\n/**\n * Generates one TanStack Query hook per OpenAPI operation for React. Queries\n * become `useFooQuery`/`useFooSuspenseQuery`/`useFooInfiniteQuery`; mutations\n * become `useFooMutation`. Each hook is fully typed: query keys, input\n * variables, response data, and error shape all come from the spec.\n *\n * @example\n * ```ts\n * import { defineConfig } from 'kubb'\n * import { pluginTs } from '@kubb/plugin-ts'\n * import { pluginReactQuery } from '@kubb/plugin-react-query'\n *\n * export default defineConfig({\n *   input: { path: './petStore.yaml' },\n *   output: { path: './src/gen' },\n *   plugins: [\n *     pluginTs(),\n *     pluginReactQuery({\n *       output: { path: './hooks' },\n *       suspense: {},\n *     }),\n *   ],\n * })\n * ```\n */\nexport const pluginReactQuery = definePlugin<PluginReactQuery>((options) => {\n  const {\n    output = { path: 'hooks', barrelType: 'named' },\n    group,\n    exclude = [],\n    include,\n    override = [],\n    parser = false,\n    suspense = {},\n    infinite = false,\n    paramsType = 'inline',\n    pathParamsType = paramsType === 'object' ? 'object' : options.pathParamsType || 'inline',\n    mutation = {},\n    query = {},\n    mutationKey = mutationKeyTransformer,\n    queryKey = queryKeyTransformer,\n    customOptions,\n    paramsCasing,\n    client,\n    resolver: userResolver,\n    transformer: userTransformer,\n    generators: userGenerators = [],\n  } = options\n\n  const clientName = client?.client ?? 'axios'\n  const clientImportPath = client?.importPath ?? (!client?.bundle ? `@kubb/plugin-client/clients/${clientName}` : undefined)\n\n  const selectedGenerators =\n    options.generators ??\n    [\n      queryGenerator,\n      suspenseQueryGenerator,\n      infiniteQueryGenerator,\n      suspenseInfiniteQueryGenerator,\n      mutationGenerator,\n      hookOptionsGenerator,\n      customHookOptionsFileGenerator,\n    ].filter((generator): generator is NonNullable<typeof generator> => Boolean(generator))\n\n  const groupConfig = createGroupConfig(group, { suffix: 'Controller', honorName: true })\n\n  return {\n    name: pluginReactQueryName,\n    options,\n    dependencies: [pluginTsName, parser === 'zod' ? pluginZodName : undefined].filter((dependency): dependency is string => Boolean(dependency)),\n    hooks: {\n      'kubb:plugin:setup'(ctx) {\n        const resolver = userResolver ? { ...resolverReactQuery, ...userResolver } : resolverReactQuery\n\n        ctx.setOptions({\n          output,\n          client: {\n            bundle: client?.bundle,\n            baseURL: client?.baseURL,\n            client: clientName,\n            clientType: client?.clientType ?? 'function',\n            importPath: clientImportPath,\n            dataReturnType: client?.dataReturnType ?? 'data',\n            paramsCasing,\n          },\n          queryKey,\n          query:\n            query === false\n              ? false\n              : {\n                  importPath: '@tanstack/react-query',\n                  methods: ['get'],\n                  ...query,\n                },\n          mutationKey,\n          mutation:\n            mutation === false\n              ? false\n              : {\n                  importPath: '@tanstack/react-query',\n                  methods: ['post', 'put', 'patch', 'delete'],\n                  ...mutation,\n                },\n          infinite: infinite\n            ? {\n                queryParam: 'id',\n                initialPageParam: 0,\n                cursorParam: null,\n                nextParam: null,\n                previousParam: null,\n                ...infinite,\n              }\n            : false,\n          suspense,\n          customOptions: customOptions ? { name: 'useCustomHookOptions', ...customOptions } : null,\n          parser,\n          paramsType,\n          pathParamsType,\n          paramsCasing,\n          group: groupConfig,\n          exclude,\n          include,\n          override,\n          resolver,\n        })\n        ctx.setResolver(resolver)\n        if (userTransformer) {\n          ctx.setTransformer(userTransformer)\n        }\n\n        for (const gen of selectedGenerators) {\n          ctx.addGenerator(gen)\n        }\n        for (const gen of userGenerators) {\n          ctx.addGenerator(gen)\n        }\n\n        const root = path.resolve(ctx.config.root, ctx.config.output.path)\n        const hasClientPlugin = !!ctx.config.plugins?.some((p) => (p as { name?: string }).name === pluginClientName)\n\n        if (client?.bundle && !hasClientPlugin && !clientImportPath) {\n          ctx.injectFile({\n            baseName: 'client.ts',\n            path: path.resolve(root, '.kubb/client.ts'),\n            sources: [\n              ast.createSource({\n                name: 'client',\n                nodes: [ast.createText(clientName === 'fetch' ? fetchClientSource : axiosClientSource)],\n                isExportable: true,\n                isIndexable: true,\n              }),\n            ],\n          })\n        }\n\n        if (!hasClientPlugin) {\n          ctx.injectFile({\n            baseName: 'config.ts',\n            path: path.resolve(root, '.kubb/config.ts'),\n            sources: [\n              ast.createSource({\n                name: 'config',\n                nodes: [ast.createText(configSource)],\n                isExportable: false,\n                isIndexable: false,\n              }),\n            ],\n          })\n        }\n      },\n    },\n  }\n})\n\nexport default pluginReactQuery\n"],"mappings":"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"}

package/dist/index.js

@@ -1,6 +1,6 @@
 import "./chunk--u3MIqq1.js";
-import { _ as mutationKeyTransformer, d as queryKeyTransformer, v as camelCase } from "./components-CDmg-RPi.js";
-import { a as infiniteQueryGenerator, i as mutationGenerator, n as suspenseInfiniteQueryGenerator, o as hookOptionsGenerator, r as queryGenerator, s as customHookOptionsFileGenerator, t as suspenseQueryGenerator } from "./generators-Bma51Uar.js";
+import { d as queryKeyTransformer, h as mutationKeyTransformer, y as camelCase } from "./components-BVmVgpLX.js";
+import { a as infiniteQueryGenerator, i as mutationGenerator, n as suspenseInfiniteQueryGenerator, o as hookOptionsGenerator, r as queryGenerator, s as customHookOptionsFileGenerator, t as suspenseQueryGenerator } from "./generators-BFn9CLBS.js";
 import path from "node:path";
 import { ast, definePlugin, defineResolver } from "@kubb/core";
 import { pluginClientName } from "@kubb/plugin-client";
@@ -9,6 +9,39 @@ import { source as source$1 } from "@kubb/plugin-client/templates/clients/fetch.
 import { source as source$2 } from "@kubb/plugin-client/templates/config.source";
 import { pluginTsName } from "@kubb/plugin-ts";
 import { pluginZodName } from "@kubb/plugin-zod";
+//#region ../../internals/shared/src/group.ts
+/**
+* Builds the `group` config a Kubb plugin passes to `ctx.setOptions`, applying the
+* shared default naming so every plugin groups output consistently:
+*
+* - `path` groups use the second path segment (`/pet/findByStatus` → `pet`).
+* - other groups use `${camelCase(group)}${suffix}` (e.g. `petController`).
+*
+* Returns `null` when grouping is disabled, matching the per-plugin convention.
+*
+* @param group - The user-supplied group option, or `undefined` to disable grouping.
+* @param options.suffix - Appended to non-`path` group names, e.g. `'Controller'` or `'Requests'`.
+* @param options.honorName - When `true`, a user-provided `group.name` overrides the default namer.
+*
+* @example
+* ```ts
+* createGroupConfig(group, { suffix: 'Controller' })                  // plugin-ts, plugin-zod
+* createGroupConfig(group, { suffix: 'Controller', honorName: true }) // plugin-faker, plugin-client, …
+* createGroupConfig(group, { suffix: 'Requests', honorName: true })   // plugin-cypress, plugin-mcp
+* ```
+*/
+function createGroupConfig(group, options) {
+	if (!group) return null;
+	const defaultName = (ctx) => {
+		if (group.type === "path") return `${ctx.group.split("/")[1]}`;
+		return `${camelCase(ctx.group)}${options.suffix}`;
+	};
+	return {
+		...group,
+		name: options.honorName && group.name ? group.name : defaultName
+	};
+}
+//#endregion
 //#region src/resolvers/resolverReactQuery.ts
 function capitalize(name) {
 	return `${name.charAt(0).toUpperCase()}${name.slice(1)}`;
@@ -159,7 +192,7 @@ const pluginReactQuery = definePlugin((options) => {
 	const { output = {
 		path: "hooks",
 		barrelType: "named"
-	}, group, exclude = [], include, override = [], parser = "client", suspense = {}, infinite = false, paramsType = "inline", pathParamsType = paramsType === "object" ? "object" : options.pathParamsType || "inline", mutation = {}, query = {}, mutationKey = mutationKeyTransformer, queryKey = queryKeyTransformer, customOptions, paramsCasing, client, resolver: userResolver, transformer: userTransformer, generators: userGenerators = [] } = options;
+	}, group, exclude = [], include, override = [], parser = false, suspense = {}, infinite = false, paramsType = "inline", pathParamsType = paramsType === "object" ? "object" : options.pathParamsType || "inline", mutation = {}, query = {}, mutationKey = mutationKeyTransformer, queryKey = queryKeyTransformer, customOptions, paramsCasing, client, resolver: userResolver, transformer: userTransformer, generators: userGenerators = [] } = options;
 	const clientName = client?.client ?? "axios";
 	const clientImportPath = client?.importPath ?? (!client?.bundle ? `@kubb/plugin-client/clients/${clientName}` : void 0);
 	const selectedGenerators = options.generators ?? [
@@ -171,13 +204,10 @@ const pluginReactQuery = definePlugin((options) => {
 		hookOptionsGenerator,
 		customHookOptionsFileGenerator
 	].filter((generator) => Boolean(generator));
-	const groupConfig = group ? {
-		...group,
-		name: group.name ? group.name : (ctx) => {
-			if (group.type === "path") return `${ctx.group.split("/")[1]}`;
-			return `${camelCase(ctx.group)}Controller`;
-		}
-	} : null;
+	const groupConfig = createGroupConfig(group, {
+		suffix: "Controller",
+		honorName: true
+	});
 	return {
 		name: pluginReactQueryName,
 		options,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["fetchClientSource","axiosClientSource","configSource"],"sources":["../src/resolvers/resolverReactQuery.ts","../src/plugin.ts"],"sourcesContent":["import { camelCase } from '@internals/utils'\nimport { defineResolver } from '@kubb/core'\nimport type { PluginReactQuery } from '../types.ts'\n\nfunction capitalize(name: string): string {\n  return `${name.charAt(0).toUpperCase()}${name.slice(1)}`\n}\n\n/**\n * Default resolver used by `@kubb/plugin-react-query`. Decides the names and\n * file paths for every generated TanStack Query hook (`useFooQuery`,\n * `useFooMutation`, `useFooInfiniteQuery`, ...) and its companion helpers\n * (`fooQueryKey`, `fooQueryOptions`).\n *\n * Functions and files use camelCase; hooks get the `use` prefix; suspense and\n * infinite variants are suffixed with `Suspense`/`Infinite`.\n *\n * @example Resolve hook and helper names\n * ```ts\n * import { resolverReactQuery } from '@kubb/plugin-react-query'\n *\n * resolverReactQuery.resolveQueryName(operationNode)       // 'useGetPetById'\n * resolverReactQuery.resolveMutationName(operationNode)    // 'useUpdatePet'\n * resolverReactQuery.resolveQueryKeyName(operationNode)    // 'getPetByIdQueryKey'\n * resolverReactQuery.resolveQueryOptionsName(operationNode) // 'getPetByIdQueryOptions'\n * ```\n */\nexport const resolverReactQuery = defineResolver<PluginReactQuery>(() => ({\n  name: 'default',\n  pluginName: 'plugin-react-query',\n  default(name, type) {\n    return camelCase(name, { isFile: type === 'file' })\n  },\n  resolveName(name) {\n    return this.default(name, 'function')\n  },\n  resolvePathName(name, type) {\n    return this.default(name, type)\n  },\n  resolveQueryName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}`\n  },\n  resolveSuspenseQueryName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}Suspense`\n  },\n  resolveInfiniteQueryName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}Infinite`\n  },\n  resolveSuspenseInfiniteQueryName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}SuspenseInfinite`\n  },\n  resolveMutationName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}`\n  },\n  resolveQueryOptionsName(node) {\n    return `${this.resolveName(node.operationId)}QueryOptions`\n  },\n  resolveSuspenseQueryOptionsName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseQueryOptions`\n  },\n  resolveInfiniteQueryOptionsName(node) {\n    return `${this.resolveName(node.operationId)}InfiniteQueryOptions`\n  },\n  resolveSuspenseInfiniteQueryOptionsName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseInfiniteQueryOptions`\n  },\n  resolveMutationOptionsName(node) {\n    return `${this.resolveName(node.operationId)}MutationOptions`\n  },\n  resolveQueryKeyName(node) {\n    return `${this.resolveName(node.operationId)}QueryKey`\n  },\n  resolveSuspenseQueryKeyName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseQueryKey`\n  },\n  resolveInfiniteQueryKeyName(node) {\n    return `${this.resolveName(node.operationId)}InfiniteQueryKey`\n  },\n  resolveSuspenseInfiniteQueryKeyName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseInfiniteQueryKey`\n  },\n  resolveMutationKeyName(node) {\n    return `${this.resolveName(node.operationId)}MutationKey`\n  },\n  resolveQueryKeyTypeName(node) {\n    return `${capitalize(this.resolveName(node.operationId))}QueryKey`\n  },\n  resolveSuspenseQueryKeyTypeName(node) {\n    return `${capitalize(this.resolveName(node.operationId))}SuspenseQueryKey`\n  },\n  resolveInfiniteQueryKeyTypeName(node) {\n    return `${capitalize(this.resolveName(node.operationId))}InfiniteQueryKey`\n  },\n  resolveSuspenseInfiniteQueryKeyTypeName(node) {\n    return `${capitalize(this.resolveName(node.operationId))}SuspenseInfiniteQueryKey`\n  },\n  resolveMutationTypeName(node) {\n    return capitalize(this.resolveName(node.operationId))\n  },\n  resolveClientName(node) {\n    return this.resolveName(node.operationId)\n  },\n  resolveSuspenseClientName(node) {\n    return `${this.resolveName(node.operationId)}Suspense`\n  },\n  resolveInfiniteClientName(node) {\n    return `${this.resolveName(node.operationId)}Infinite`\n  },\n  resolveSuspenseInfiniteClientName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseInfinite`\n  },\n  resolveHookOptionsName() {\n    return 'HookOptions'\n  },\n  resolveCustomHookOptionsName() {\n    return 'getCustomHookOptions'\n  },\n}))\n","import path from 'node:path'\nimport { camelCase } from '@internals/utils'\nimport { ast, definePlugin, type Group } from '@kubb/core'\nimport { pluginClientName } from '@kubb/plugin-client'\nimport { source as axiosClientSource } from '@kubb/plugin-client/templates/clients/axios.source'\nimport { source as fetchClientSource } from '@kubb/plugin-client/templates/clients/fetch.source'\nimport { source as configSource } from '@kubb/plugin-client/templates/config.source'\nimport { pluginTsName } from '@kubb/plugin-ts'\nimport { pluginZodName } from '@kubb/plugin-zod'\nimport { mutationKeyTransformer, queryKeyTransformer } from '@internals/tanstack-query'\nimport {\n  customHookOptionsFileGenerator,\n  hookOptionsGenerator,\n  infiniteQueryGenerator,\n  mutationGenerator,\n  queryGenerator,\n  suspenseInfiniteQueryGenerator,\n  suspenseQueryGenerator,\n} from './generators'\nimport { resolverReactQuery } from './resolvers/resolverReactQuery.ts'\nimport type { PluginReactQuery } from './types.ts'\n\n/**\n * Canonical plugin name for `@kubb/plugin-react-query`. Used for driver lookups\n * and cross-plugin dependency references.\n */\nexport const pluginReactQueryName = 'plugin-react-query' satisfies PluginReactQuery['name']\n\n/**\n * Generates one TanStack Query hook per OpenAPI operation for React. Queries\n * become `useFooQuery`/`useFooSuspenseQuery`/`useFooInfiniteQuery`; mutations\n * become `useFooMutation`. Each hook is fully typed: query keys, input\n * variables, response data, and error shape all come from the spec.\n *\n * @example\n * ```ts\n * import { defineConfig } from 'kubb'\n * import { pluginTs } from '@kubb/plugin-ts'\n * import { pluginReactQuery } from '@kubb/plugin-react-query'\n *\n * export default defineConfig({\n *   input: { path: './petStore.yaml' },\n *   output: { path: './src/gen' },\n *   plugins: [\n *     pluginTs(),\n *     pluginReactQuery({\n *       output: { path: './hooks' },\n *       suspense: {},\n *     }),\n *   ],\n * })\n * ```\n */\nexport const pluginReactQuery = definePlugin<PluginReactQuery>((options) => {\n  const {\n    output = { path: 'hooks', barrelType: 'named' },\n    group,\n    exclude = [],\n    include,\n    override = [],\n    parser = 'client',\n    suspense = {},\n    infinite = false,\n    paramsType = 'inline',\n    pathParamsType = paramsType === 'object' ? 'object' : options.pathParamsType || 'inline',\n    mutation = {},\n    query = {},\n    mutationKey = mutationKeyTransformer,\n    queryKey = queryKeyTransformer,\n    customOptions,\n    paramsCasing,\n    client,\n    resolver: userResolver,\n    transformer: userTransformer,\n    generators: userGenerators = [],\n  } = options\n\n  const clientName = client?.client ?? 'axios'\n  const clientImportPath = client?.importPath ?? (!client?.bundle ? `@kubb/plugin-client/clients/${clientName}` : undefined)\n\n  const selectedGenerators =\n    options.generators ??\n    [\n      queryGenerator,\n      suspenseQueryGenerator,\n      infiniteQueryGenerator,\n      suspenseInfiniteQueryGenerator,\n      mutationGenerator,\n      hookOptionsGenerator,\n      customHookOptionsFileGenerator,\n    ].filter((generator): generator is NonNullable<typeof generator> => Boolean(generator))\n\n  const groupConfig = group\n    ? ({\n        ...group,\n        name: group.name\n          ? group.name\n          : (ctx: { group: string }) => {\n              if (group.type === 'path') {\n                return `${ctx.group.split('/')[1]}`\n              }\n              return `${camelCase(ctx.group)}Controller`\n            },\n      } satisfies Group)\n    : null\n\n  return {\n    name: pluginReactQueryName,\n    options,\n    dependencies: [pluginTsName, parser === 'zod' ? pluginZodName : undefined].filter((dependency): dependency is string => Boolean(dependency)),\n    hooks: {\n      'kubb:plugin:setup'(ctx) {\n        const resolver = userResolver ? { ...resolverReactQuery, ...userResolver } : resolverReactQuery\n\n        ctx.setOptions({\n          output,\n          client: {\n            bundle: client?.bundle,\n            baseURL: client?.baseURL,\n            client: clientName,\n            clientType: client?.clientType ?? 'function',\n            importPath: clientImportPath,\n            dataReturnType: client?.dataReturnType ?? 'data',\n            paramsCasing,\n          },\n          queryKey,\n          query:\n            query === false\n              ? false\n              : {\n                  importPath: '@tanstack/react-query',\n                  methods: ['get'],\n                  ...query,\n                },\n          mutationKey,\n          mutation:\n            mutation === false\n              ? false\n              : {\n                  importPath: '@tanstack/react-query',\n                  methods: ['post', 'put', 'patch', 'delete'],\n                  ...mutation,\n                },\n          infinite: infinite\n            ? {\n                queryParam: 'id',\n                initialPageParam: 0,\n                cursorParam: null,\n                nextParam: null,\n                previousParam: null,\n                ...infinite,\n              }\n            : false,\n          suspense,\n          customOptions: customOptions ? { name: 'useCustomHookOptions', ...customOptions } : null,\n          parser,\n          paramsType,\n          pathParamsType,\n          paramsCasing,\n          group: groupConfig,\n          exclude,\n          include,\n          override,\n          resolver,\n        })\n        ctx.setResolver(resolver)\n        if (userTransformer) {\n          ctx.setTransformer(userTransformer)\n        }\n\n        for (const gen of selectedGenerators) {\n          ctx.addGenerator(gen)\n        }\n        for (const gen of userGenerators) {\n          ctx.addGenerator(gen)\n        }\n\n        const root = path.resolve(ctx.config.root, ctx.config.output.path)\n        const hasClientPlugin = !!ctx.config.plugins?.some((p) => (p as { name?: string }).name === pluginClientName)\n\n        if (client?.bundle && !hasClientPlugin && !clientImportPath) {\n          ctx.injectFile({\n            baseName: 'client.ts',\n            path: path.resolve(root, '.kubb/client.ts'),\n            sources: [\n              ast.createSource({\n                name: 'client',\n                nodes: [ast.createText(clientName === 'fetch' ? fetchClientSource : axiosClientSource)],\n                isExportable: true,\n                isIndexable: true,\n              }),\n            ],\n          })\n        }\n\n        if (!hasClientPlugin) {\n          ctx.injectFile({\n            baseName: 'config.ts',\n            path: path.resolve(root, '.kubb/config.ts'),\n            sources: [\n              ast.createSource({\n                name: 'config',\n                nodes: [ast.createText(configSource)],\n                isExportable: false,\n                isIndexable: false,\n              }),\n            ],\n          })\n        }\n      },\n    },\n  }\n})\n\nexport default pluginReactQuery\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["fetchClientSource","axiosClientSource","configSource"],"sources":["../../../internals/shared/src/group.ts","../src/resolvers/resolverReactQuery.ts","../src/plugin.ts"],"sourcesContent":["import { camelCase } from '@internals/utils'\nimport type { Group } from '@kubb/core'\n\n/**\n * Builds the `group` config a Kubb plugin passes to `ctx.setOptions`, applying the\n * shared default naming so every plugin groups output consistently:\n *\n * - `path` groups use the second path segment (`/pet/findByStatus` → `pet`).\n * - other groups use `${camelCase(group)}${suffix}` (e.g. `petController`).\n *\n * Returns `null` when grouping is disabled, matching the per-plugin convention.\n *\n * @param group - The user-supplied group option, or `undefined` to disable grouping.\n * @param options.suffix - Appended to non-`path` group names, e.g. `'Controller'` or `'Requests'`.\n * @param options.honorName - When `true`, a user-provided `group.name` overrides the default namer.\n *\n * @example\n * ```ts\n * createGroupConfig(group, { suffix: 'Controller' })                  // plugin-ts, plugin-zod\n * createGroupConfig(group, { suffix: 'Controller', honorName: true }) // plugin-faker, plugin-client, …\n * createGroupConfig(group, { suffix: 'Requests', honorName: true })   // plugin-cypress, plugin-mcp\n * ```\n */\nexport function createGroupConfig(group: Group | undefined, options: { suffix: string; honorName?: boolean }): Group | null {\n  if (!group) {\n    return null\n  }\n\n  const defaultName = (ctx: { group: string }): string => {\n    if (group.type === 'path') {\n      return `${ctx.group.split('/')[1]}`\n    }\n\n    return `${camelCase(ctx.group)}${options.suffix}`\n  }\n\n  return {\n    ...group,\n    name: options.honorName && group.name ? group.name : defaultName,\n  } satisfies Group\n}\n","import { camelCase } from '@internals/utils'\nimport { defineResolver } from '@kubb/core'\nimport type { PluginReactQuery } from '../types.ts'\n\nfunction capitalize(name: string): string {\n  return `${name.charAt(0).toUpperCase()}${name.slice(1)}`\n}\n\n/**\n * Default resolver used by `@kubb/plugin-react-query`. Decides the names and\n * file paths for every generated TanStack Query hook (`useFooQuery`,\n * `useFooMutation`, `useFooInfiniteQuery`, ...) and its companion helpers\n * (`fooQueryKey`, `fooQueryOptions`).\n *\n * Functions and files use camelCase; hooks get the `use` prefix; suspense and\n * infinite variants are suffixed with `Suspense`/`Infinite`.\n *\n * @example Resolve hook and helper names\n * ```ts\n * import { resolverReactQuery } from '@kubb/plugin-react-query'\n *\n * resolverReactQuery.resolveQueryName(operationNode)       // 'useGetPetById'\n * resolverReactQuery.resolveMutationName(operationNode)    // 'useUpdatePet'\n * resolverReactQuery.resolveQueryKeyName(operationNode)    // 'getPetByIdQueryKey'\n * resolverReactQuery.resolveQueryOptionsName(operationNode) // 'getPetByIdQueryOptions'\n * ```\n */\nexport const resolverReactQuery = defineResolver<PluginReactQuery>(() => ({\n  name: 'default',\n  pluginName: 'plugin-react-query',\n  default(name, type) {\n    return camelCase(name, { isFile: type === 'file' })\n  },\n  resolveName(name) {\n    return this.default(name, 'function')\n  },\n  resolvePathName(name, type) {\n    return this.default(name, type)\n  },\n  resolveQueryName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}`\n  },\n  resolveSuspenseQueryName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}Suspense`\n  },\n  resolveInfiniteQueryName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}Infinite`\n  },\n  resolveSuspenseInfiniteQueryName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}SuspenseInfinite`\n  },\n  resolveMutationName(node) {\n    return `use${capitalize(this.resolveName(node.operationId))}`\n  },\n  resolveQueryOptionsName(node) {\n    return `${this.resolveName(node.operationId)}QueryOptions`\n  },\n  resolveSuspenseQueryOptionsName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseQueryOptions`\n  },\n  resolveInfiniteQueryOptionsName(node) {\n    return `${this.resolveName(node.operationId)}InfiniteQueryOptions`\n  },\n  resolveSuspenseInfiniteQueryOptionsName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseInfiniteQueryOptions`\n  },\n  resolveMutationOptionsName(node) {\n    return `${this.resolveName(node.operationId)}MutationOptions`\n  },\n  resolveQueryKeyName(node) {\n    return `${this.resolveName(node.operationId)}QueryKey`\n  },\n  resolveSuspenseQueryKeyName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseQueryKey`\n  },\n  resolveInfiniteQueryKeyName(node) {\n    return `${this.resolveName(node.operationId)}InfiniteQueryKey`\n  },\n  resolveSuspenseInfiniteQueryKeyName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseInfiniteQueryKey`\n  },\n  resolveMutationKeyName(node) {\n    return `${this.resolveName(node.operationId)}MutationKey`\n  },\n  resolveQueryKeyTypeName(node) {\n    return `${capitalize(this.resolveName(node.operationId))}QueryKey`\n  },\n  resolveSuspenseQueryKeyTypeName(node) {\n    return `${capitalize(this.resolveName(node.operationId))}SuspenseQueryKey`\n  },\n  resolveInfiniteQueryKeyTypeName(node) {\n    return `${capitalize(this.resolveName(node.operationId))}InfiniteQueryKey`\n  },\n  resolveSuspenseInfiniteQueryKeyTypeName(node) {\n    return `${capitalize(this.resolveName(node.operationId))}SuspenseInfiniteQueryKey`\n  },\n  resolveMutationTypeName(node) {\n    return capitalize(this.resolveName(node.operationId))\n  },\n  resolveClientName(node) {\n    return this.resolveName(node.operationId)\n  },\n  resolveSuspenseClientName(node) {\n    return `${this.resolveName(node.operationId)}Suspense`\n  },\n  resolveInfiniteClientName(node) {\n    return `${this.resolveName(node.operationId)}Infinite`\n  },\n  resolveSuspenseInfiniteClientName(node) {\n    return `${this.resolveName(node.operationId)}SuspenseInfinite`\n  },\n  resolveHookOptionsName() {\n    return 'HookOptions'\n  },\n  resolveCustomHookOptionsName() {\n    return 'getCustomHookOptions'\n  },\n}))\n","import path from 'node:path'\nimport { createGroupConfig } from '@internals/shared'\nimport { ast, definePlugin } from '@kubb/core'\nimport { pluginClientName } from '@kubb/plugin-client'\nimport { source as axiosClientSource } from '@kubb/plugin-client/templates/clients/axios.source'\nimport { source as fetchClientSource } from '@kubb/plugin-client/templates/clients/fetch.source'\nimport { source as configSource } from '@kubb/plugin-client/templates/config.source'\nimport { pluginTsName } from '@kubb/plugin-ts'\nimport { pluginZodName } from '@kubb/plugin-zod'\nimport { mutationKeyTransformer, queryKeyTransformer } from '@internals/tanstack-query'\nimport {\n  customHookOptionsFileGenerator,\n  hookOptionsGenerator,\n  infiniteQueryGenerator,\n  mutationGenerator,\n  queryGenerator,\n  suspenseInfiniteQueryGenerator,\n  suspenseQueryGenerator,\n} from './generators'\nimport { resolverReactQuery } from './resolvers/resolverReactQuery.ts'\nimport type { PluginReactQuery } from './types.ts'\n\n/**\n * Canonical plugin name for `@kubb/plugin-react-query`. Used for driver lookups\n * and cross-plugin dependency references.\n */\nexport const pluginReactQueryName = 'plugin-react-query' satisfies PluginReactQuery['name']\n\n/**\n * Generates one TanStack Query hook per OpenAPI operation for React. Queries\n * become `useFooQuery`/`useFooSuspenseQuery`/`useFooInfiniteQuery`; mutations\n * become `useFooMutation`. Each hook is fully typed: query keys, input\n * variables, response data, and error shape all come from the spec.\n *\n * @example\n * ```ts\n * import { defineConfig } from 'kubb'\n * import { pluginTs } from '@kubb/plugin-ts'\n * import { pluginReactQuery } from '@kubb/plugin-react-query'\n *\n * export default defineConfig({\n *   input: { path: './petStore.yaml' },\n *   output: { path: './src/gen' },\n *   plugins: [\n *     pluginTs(),\n *     pluginReactQuery({\n *       output: { path: './hooks' },\n *       suspense: {},\n *     }),\n *   ],\n * })\n * ```\n */\nexport const pluginReactQuery = definePlugin<PluginReactQuery>((options) => {\n  const {\n    output = { path: 'hooks', barrelType: 'named' },\n    group,\n    exclude = [],\n    include,\n    override = [],\n    parser = false,\n    suspense = {},\n    infinite = false,\n    paramsType = 'inline',\n    pathParamsType = paramsType === 'object' ? 'object' : options.pathParamsType || 'inline',\n    mutation = {},\n    query = {},\n    mutationKey = mutationKeyTransformer,\n    queryKey = queryKeyTransformer,\n    customOptions,\n    paramsCasing,\n    client,\n    resolver: userResolver,\n    transformer: userTransformer,\n    generators: userGenerators = [],\n  } = options\n\n  const clientName = client?.client ?? 'axios'\n  const clientImportPath = client?.importPath ?? (!client?.bundle ? `@kubb/plugin-client/clients/${clientName}` : undefined)\n\n  const selectedGenerators =\n    options.generators ??\n    [\n      queryGenerator,\n      suspenseQueryGenerator,\n      infiniteQueryGenerator,\n      suspenseInfiniteQueryGenerator,\n      mutationGenerator,\n      hookOptionsGenerator,\n      customHookOptionsFileGenerator,\n    ].filter((generator): generator is NonNullable<typeof generator> => Boolean(generator))\n\n  const groupConfig = createGroupConfig(group, { suffix: 'Controller', honorName: true })\n\n  return {\n    name: pluginReactQueryName,\n    options,\n    dependencies: [pluginTsName, parser === 'zod' ? pluginZodName : undefined].filter((dependency): dependency is string => Boolean(dependency)),\n    hooks: {\n      'kubb:plugin:setup'(ctx) {\n        const resolver = userResolver ? { ...resolverReactQuery, ...userResolver } : resolverReactQuery\n\n        ctx.setOptions({\n          output,\n          client: {\n            bundle: client?.bundle,\n            baseURL: client?.baseURL,\n            client: clientName,\n            clientType: client?.clientType ?? 'function',\n            importPath: clientImportPath,\n            dataReturnType: client?.dataReturnType ?? 'data',\n            paramsCasing,\n          },\n          queryKey,\n          query:\n            query === false\n              ? false\n              : {\n                  importPath: '@tanstack/react-query',\n                  methods: ['get'],\n                  ...query,\n                },\n          mutationKey,\n          mutation:\n            mutation === false\n              ? false\n              : {\n                  importPath: '@tanstack/react-query',\n                  methods: ['post', 'put', 'patch', 'delete'],\n                  ...mutation,\n                },\n          infinite: infinite\n            ? {\n                queryParam: 'id',\n                initialPageParam: 0,\n                cursorParam: null,\n                nextParam: null,\n                previousParam: null,\n                ...infinite,\n              }\n            : false,\n          suspense,\n          customOptions: customOptions ? { name: 'useCustomHookOptions', ...customOptions } : null,\n          parser,\n          paramsType,\n          pathParamsType,\n          paramsCasing,\n          group: groupConfig,\n          exclude,\n          include,\n          override,\n          resolver,\n        })\n        ctx.setResolver(resolver)\n        if (userTransformer) {\n          ctx.setTransformer(userTransformer)\n        }\n\n        for (const gen of selectedGenerators) {\n          ctx.addGenerator(gen)\n        }\n        for (const gen of userGenerators) {\n          ctx.addGenerator(gen)\n        }\n\n        const root = path.resolve(ctx.config.root, ctx.config.output.path)\n        const hasClientPlugin = !!ctx.config.plugins?.some((p) => (p as { name?: string }).name === pluginClientName)\n\n        if (client?.bundle && !hasClientPlugin && !clientImportPath) {\n          ctx.injectFile({\n            baseName: 'client.ts',\n            path: path.resolve(root, '.kubb/client.ts'),\n            sources: [\n              ast.createSource({\n                name: 'client',\n                nodes: [ast.createText(clientName === 'fetch' ? fetchClientSource : axiosClientSource)],\n                isExportable: true,\n                isIndexable: true,\n              }),\n            ],\n          })\n        }\n\n        if (!hasClientPlugin) {\n          ctx.injectFile({\n            baseName: 'config.ts',\n            path: path.resolve(root, '.kubb/config.ts'),\n            sources: [\n              ast.createSource({\n                name: 'config',\n                nodes: [ast.createText(configSource)],\n                isExportable: false,\n                isIndexable: false,\n              }),\n            ],\n          })\n        }\n      },\n    },\n  }\n})\n\nexport default pluginReactQuery\n"],"mappings":"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"}

package/extension.yaml

@@ -317,31 +317,6 @@ options:
                       }),
                     ],
                   })
-  - name: contentType
-    type: "'application/json' | (string & {})"
-    required: false
-    description: |
-      Selects which request/response media type the generator reads from the OpenAPI spec.
-
-      When omitted, Kubb picks the first JSON-compatible media type it finds (`application/json`, `application/vnd.api+json`, anything ending in `+json`). Set this when your spec defines multiple media types for the same operation and you want a non-default one.
-    examples:
-      - name: JSON API media type
-        files:
-          - lang: typescript
-            twoslash: false
-            code: |
-              import { defineConfig } from 'kubb'
-              import { pluginTs } from '@kubb/plugin-ts'
-
-              export default defineConfig({
-                input: { path: './petStore.yaml' },
-                output: { path: './src/gen' },
-                plugins: [
-                  pluginTs({
-                    contentType: 'application/vnd.api+json',
-                  }),
-                ],
-              })
   - name: group
     type: Group
     required: false
@@ -763,13 +738,13 @@ options:
                 // ...
               }
   - name: parser
-    type: "'client' | 'zod'"
+    type: false | 'zod'
     required: false
-    default: "'client'"
+    default: 'false'
     description: |
       Runtime validator applied to the response body before it is returned to the caller.
 
-      - `'client'` (default) — no validation. The response is cast to the generated TypeScript type and returned as-is. Fastest path, trusts the API.
+      - `false` (default) — no validation. The client has no runtime parser; the response is cast to the generated TypeScript type and returned as-is. Fastest path, trusts the API.
       - `'zod'` — pipes the response through the Zod schema produced by `@kubb/plugin-zod`. Catches mismatches between spec and API at runtime, at the cost of a parse on every call.
 
       Use `'zod'` when you want a defensive boundary against drift between your OpenAPI spec and the live API. Requires `@kubb/plugin-zod` in the plugins list.
@@ -1046,13 +1021,13 @@ options:
       - name: methods
         type: Array<HttpMethod>
         required: false
-        default: "['post', 'put', 'delete']"
+        default: "['post', 'put', 'patch', 'delete']"
         description: |
           HTTP methods treated as mutations. Operations using one of these methods generate a `useMutation`-style hook instead of a query.
 
-          Defaults to `['post', 'put', 'delete']`. Add `'patch'` if your API uses it for partial updates.
+          Defaults to `['post', 'put', 'patch', 'delete']`. Narrow the list if your API uses one of these methods for reads.
         examples:
-          - name: Include PATCH as a mutation
+          - name: Treat only POST and PUT as mutations
             files:
               - lang: typescript
                 twoslash: false
@@ -1065,7 +1040,7 @@ options:
                     output: { path: './src/gen' },
                     plugins: [
                       pluginReactQuery({
-                        mutation: { methods: ['post', 'put', 'patch', 'delete'] },
+                        mutation: { methods: ['post', 'put'] },
                       }),
                     ],
                   })
@@ -1385,7 +1360,9 @@ options:
       | --- | --- |
       | `@kubb/plugin-ts` | `resolverTs` |
       | `@kubb/plugin-zod` | `resolverZod` |
+      | `@kubb/plugin-faker` | `resolverFaker` |
       | `@kubb/plugin-cypress` | `resolverCypress` |
+      | `@kubb/plugin-msw` | `resolverMsw` |
       | `@kubb/plugin-mcp` | `resolverMcp` |
       | `@kubb/plugin-client` | `resolverClient` |
     codeBlock:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/plugin-react-query",
-  "version": "5.0.0-beta.30",
+  "version": "5.0.0-beta.33",
   "description": "Generate type-safe TanStack Query (React Query) hooks from your OpenAPI specification. Covers useQuery, useMutation, useInfiniteQuery, and queryOptions with full TypeScript support.",
   "keywords": [
     "code-generation",
@@ -68,12 +68,12 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@kubb/core": "5.0.0-beta.29",
-    "@kubb/renderer-jsx": "5.0.0-beta.29",
-    "remeda": "^2.34.1",
-    "@kubb/plugin-client": "5.0.0-beta.30",
-    "@kubb/plugin-ts": "5.0.0-beta.30",
-    "@kubb/plugin-zod": "5.0.0-beta.30"
+    "@kubb/core": "5.0.0-beta.33",
+    "@kubb/renderer-jsx": "5.0.0-beta.33",
+    "remeda": "^2.36.0",
+    "@kubb/plugin-client": "5.0.0-beta.33",
+    "@kubb/plugin-ts": "5.0.0-beta.33",
+    "@kubb/plugin-zod": "5.0.0-beta.33"
   },
   "devDependencies": {
     "@internals/shared": "0.0.0",
@@ -81,7 +81,7 @@
     "@internals/utils": "0.0.0"
   },
   "peerDependencies": {
-    "@kubb/renderer-jsx": "5.0.0-beta.29"
+    "@kubb/renderer-jsx": "5.0.0-beta.33"
   },
   "size-limit": [
     {

package/src/components/InfiniteQuery.tsx

@@ -5,6 +5,7 @@ import { functionPrinter } from '@kubb/plugin-ts'
 import { File, Function } from '@kubb/renderer-jsx'
 import type { KubbReactNode } from '@kubb/renderer-jsx/types'
 import type { Infinite, PluginReactQuery } from '../types.ts'
+import { getEnabledParamNames, markParamsOptional } from '@internals/tanstack-query'
 import { buildQueryKeyParams, getComments, resolveErrorNames, resolveSuccessNames } from '../utils.ts'
 import { getQueryOptionsParams } from './QueryOptions.tsx'
 
@@ -123,18 +124,22 @@ export function InfiniteQuery({
 
   const queryKeyParamsNode = buildQueryKeyParams(node, { pathParamsType, paramsCasing, resolver: tsResolver })
   const queryKeyParamsCall = callPrinter.print(queryKeyParamsNode) ?? ''
+  const enabledNames = getEnabledParamNames(queryKeyParamsNode)
 
   const queryOptionsParamsNode = getQueryOptionsParams(node, { paramsType, paramsCasing, pathParamsType, resolver: tsResolver })
   const queryOptionsParamsCall = callPrinter.print(queryOptionsParamsNode) ?? ''
 
-  const paramsNode = buildInfiniteQueryParamsNode(node, {
-    paramsType,
-    paramsCasing,
-    pathParamsType,
-    dataReturnType,
-    resolver: tsResolver,
-    pageParamGeneric: 'TPageParam',
-  })
+  const paramsNode = markParamsOptional(
+    buildInfiniteQueryParamsNode(node, {
+      paramsType,
+      paramsCasing,
+      pathParamsType,
+      dataReturnType,
+      resolver: tsResolver,
+      pageParamGeneric: 'TPageParam',
+    }),
+    enabledNames,
+  )
   const paramsSignature = declarationPrinter.print(paramsNode) ?? ''
 
   return (

package/src/components/InfiniteQueryOptions.tsx

@@ -7,7 +7,7 @@ import { File, Function } from '@kubb/renderer-jsx'
 import type { KubbReactNode } from '@kubb/renderer-jsx/types'
 import type { Infinite, PluginReactQuery } from '../types.ts'
 import { buildQueryKeyParams, resolveErrorNames, resolveSuccessNames } from '../utils.ts'
-import { buildEnabledCheck } from '@internals/tanstack-query'
+import { getEnabledParamNames, injectNonNullAssertions, markParamsOptional } from '@internals/tanstack-query'
 import { getQueryOptionsParams } from './QueryOptions.tsx'
 
 type Props = {
@@ -80,16 +80,16 @@ export function InfiniteQueryOptions({
   const queryParamType = queryParam && queryParamsTypeName ? `${queryParamsTypeName}['${queryParam}']` : null
   const pageParamType = queryParamType ? (isInitialPageParamDefined ? `NonNullable<${queryParamType}>` : queryParamType) : fallbackPageParamType
 
-  const paramsNode = getQueryOptionsParams(node, { paramsType, paramsCasing, pathParamsType, resolver: tsResolver })
-  const paramsSignature = declarationPrinter.print(paramsNode) ?? ''
-  const rawParamsCall = callPrinter.print(paramsNode) ?? ''
-  const clientCallStr = rawParamsCall.replace(/\bconfig\b(?=[^,]*$)/, '{ ...config, signal: config.signal ?? signal }')
-
   const queryKeyParamsNode = buildQueryKeyParams(node, { pathParamsType, paramsCasing, resolver: tsResolver })
   const queryKeyParamsCall = callPrinter.print(queryKeyParamsNode) ?? ''
 
-  const enabledSource = buildEnabledCheck(queryKeyParamsNode)
-  const enabledText = enabledSource ? `enabled: !!(${enabledSource}),` : ''
+  const enabledNames = getEnabledParamNames(queryKeyParamsNode)
+  const enabledText = enabledNames.length ? `enabled: !!(${enabledNames.join(' && ')}),` : ''
+
+  const paramsNode = markParamsOptional(getQueryOptionsParams(node, { paramsType, paramsCasing, pathParamsType, resolver: tsResolver }), enabledNames)
+  const paramsSignature = declarationPrinter.print(paramsNode) ?? ''
+  const rawParamsCall = callPrinter.print(paramsNode) ?? ''
+  const clientCallStr = injectNonNullAssertions(rawParamsCall.replace(/\bconfig\b(?=[^,]*$)/, '{ ...config, signal: config.signal ?? signal }'), enabledNames)
 
   const hasNewParams = nextParam != null || previousParam != null
 

package/src/components/Query.tsx

@@ -4,6 +4,7 @@ import { functionPrinter } from '@kubb/plugin-ts'
 import { File, Function } from '@kubb/renderer-jsx'
 import type { KubbReactNode } from '@kubb/renderer-jsx/types'
 import type { PluginReactQuery } from '../types.ts'
+import { getEnabledParamNames, markParamsOptional } from '@internals/tanstack-query'
 import { buildQueryKeyParams, getComments, resolveErrorNames, resolveSuccessNames } from '../utils.ts'
 import { getQueryOptionsParams } from './QueryOptions.tsx'
 
@@ -88,11 +89,15 @@ export function Query({
 
   const queryKeyParamsNode = buildQueryKeyParams(node, { pathParamsType, paramsCasing, resolver: tsResolver })
   const queryKeyParamsCall = callPrinter.print(queryKeyParamsNode) ?? ''
+  const enabledNames = getEnabledParamNames(queryKeyParamsNode)
 
   const queryOptionsParamsNode = getQueryOptionsParams(node, { paramsType, paramsCasing, pathParamsType, resolver: tsResolver })
   const queryOptionsParamsCall = callPrinter.print(queryOptionsParamsNode) ?? ''
 
-  const paramsNode = buildQueryParamsNode(node, { paramsType, paramsCasing, pathParamsType, dataReturnType, resolver: tsResolver })
+  const paramsNode = markParamsOptional(
+    buildQueryParamsNode(node, { paramsType, paramsCasing, pathParamsType, dataReturnType, resolver: tsResolver }),
+    enabledNames,
+  )
   const paramsSignature = declarationPrinter.print(paramsNode) ?? ''
 
   return (

package/src/components/QueryOptions.tsx

@@ -3,7 +3,7 @@ import type { ResolverTs } from '@kubb/plugin-ts'
 import { functionPrinter } from '@kubb/plugin-ts'
 import { File, Function } from '@kubb/renderer-jsx'
 import type { KubbReactNode } from '@kubb/renderer-jsx/types'
-import { buildEnabledCheck } from '@internals/tanstack-query'
+import { getEnabledParamNames, injectNonNullAssertions, markParamsOptional } from '@internals/tanstack-query'
 import type { PluginReactQuery } from '../types.ts'
 import { buildQueryKeyParams, resolveErrorNames, resolveSuccessNames } from '../utils.ts'
 
@@ -17,6 +17,7 @@ type Props = {
   paramsType: PluginReactQuery['resolvedOptions']['paramsType']
   pathParamsType: PluginReactQuery['resolvedOptions']['pathParamsType']
   dataReturnType: PluginReactQuery['resolvedOptions']['client']['dataReturnType']
+  suspense?: boolean
 }
 
 const declarationPrinter = functionPrinter({ mode: 'declaration' })
@@ -62,6 +63,7 @@ export function QueryOptions({
   paramsType,
   pathParamsType,
   queryKeyName,
+  suspense,
 }: Props): KubbReactNode {
   const successNames = resolveSuccessNames(node, tsResolver)
   const responseName = successNames.length > 0 ? successNames.join(' | ') : tsResolver.resolveResponseName(node)
@@ -70,16 +72,18 @@ export function QueryOptions({
   const TData = dataReturnType === 'data' ? responseName : `ResponseConfig<${responseName}>`
   const TError = `ResponseErrorConfig<${errorNames.length > 0 ? errorNames.join(' | ') : 'Error'}>`
 
-  const paramsNode = getQueryOptionsParams(node, { paramsType, paramsCasing, pathParamsType, resolver: tsResolver })
-  const paramsSignature = declarationPrinter.print(paramsNode) ?? ''
-  const rawParamsCall = callPrinter.print(paramsNode) ?? ''
-  const clientCallStr = rawParamsCall.replace(/\bconfig\b(?=[^,]*$)/, '{ ...config, signal: config.signal ?? signal }')
-
   const queryKeyParamsNode = buildQueryKeyParams(node, { pathParamsType, paramsCasing, resolver: tsResolver })
   const queryKeyParamsCall = callPrinter.print(queryKeyParamsNode) ?? ''
 
-  const enabledSource = buildEnabledCheck(queryKeyParamsNode)
-  const enabledText = enabledSource ? `enabled: !!(${enabledSource}),` : ''
+  const enabledNames = getEnabledParamNames(queryKeyParamsNode)
+  // Suspense queries can't be disabled, so their params stay required.
+  const optionalNames = suspense ? [] : enabledNames
+  const enabledText = suspense ? '' : enabledNames.length ? `enabled: !!(${enabledNames.join(' && ')}),` : ''
+
+  const paramsNode = markParamsOptional(getQueryOptionsParams(node, { paramsType, paramsCasing, pathParamsType, resolver: tsResolver }), optionalNames)
+  const paramsSignature = declarationPrinter.print(paramsNode) ?? ''
+  const rawParamsCall = callPrinter.print(paramsNode) ?? ''
+  const clientCallStr = injectNonNullAssertions(rawParamsCall.replace(/\bconfig\b(?=[^,]*$)/, '{ ...config, signal: config.signal ?? signal }'), optionalNames)
 
   return (
     <File.Source name={name} isExportable isIndexable>

package/src/components/SuspenseInfiniteQueryOptions.tsx

@@ -7,7 +7,6 @@ import { File, Function } from '@kubb/renderer-jsx'
 import type { KubbReactNode } from '@kubb/renderer-jsx/types'
 import type { Infinite, PluginReactQuery } from '../types.ts'
 import { buildQueryKeyParams, resolveErrorNames, resolveSuccessNames } from '../utils.ts'
-import { buildEnabledCheck } from '@internals/tanstack-query'
 import { getQueryOptionsParams } from './QueryOptions.tsx'
 
 type Props = {
@@ -88,9 +87,6 @@ export function SuspenseInfiniteQueryOptions({
   const queryKeyParamsNode = buildQueryKeyParams(node, { pathParamsType, paramsCasing, resolver: tsResolver })
   const queryKeyParamsCall = callPrinter.print(queryKeyParamsNode) ?? ''
 
-  const enabledSource = buildEnabledCheck(queryKeyParamsNode)
-  const enabledText = enabledSource ? `enabled: !!(${enabledSource}),` : ''
-
   const hasNewParams = nextParam != null || previousParam != null
 
   const [getNextPageParamExpr, getPreviousPageParamExpr] = (() => {
@@ -135,7 +131,6 @@ export function SuspenseInfiniteQueryOptions({
           {`
       const queryKey = ${queryKeyName}(${queryKeyParamsCall})
       return infiniteQueryOptions<${queryFnDataType}, ${errorType}, InfiniteData<${queryFnDataType}>, typeof queryKey, ${pageParamType}>({
-       ${enabledText}
        queryKey,
        queryFn: async ({ signal, pageParam }) => {
           ${infiniteOverrideParams}
@@ -155,7 +150,6 @@ export function SuspenseInfiniteQueryOptions({
         {`
       const queryKey = ${queryKeyName}(${queryKeyParamsCall})
       return infiniteQueryOptions<${queryFnDataType}, ${errorType}, InfiniteData<${queryFnDataType}>, typeof queryKey, ${pageParamType}>({
-       ${enabledText}
        queryKey,
        queryFn: async ({ signal }) => {
           return ${clientName}(${clientCallStr})