@kubb/plugin-react-query 4.14.1 → 4.15.1

package/dist/generators.d.ts

@@ -1,5 +1,11 @@
-import { a as ReactGenerator, r as PluginReactQuery } from "./types-Cli5EJ4L.js";
+import { a as ReactGenerator, r as PluginReactQuery } from "./types-BAEc42Ae.js";
 
+//#region src/generators/customHookOptionsFileGenerator.d.ts
+declare const customHookOptionsFileGenerator: ReactGenerator<PluginReactQuery>;
+//#endregion
+//#region src/generators/hookOptionsGenerator.d.ts
+declare const hookOptionsGenerator: ReactGenerator<PluginReactQuery>;
+//#endregion
 //#region src/generators/infiniteQueryGenerator.d.ts
 declare const infiniteQueryGenerator: ReactGenerator<PluginReactQuery>;
 //#endregion
@@ -15,5 +21,5 @@ declare const suspenseInfiniteQueryGenerator: ReactGenerator<PluginReactQuery>;
 //#region src/generators/suspenseQueryGenerator.d.ts
 declare const suspenseQueryGenerator: ReactGenerator<PluginReactQuery>;
 //#endregion
-export { infiniteQueryGenerator, mutationGenerator, queryGenerator, suspenseInfiniteQueryGenerator, suspenseQueryGenerator };
+export { customHookOptionsFileGenerator, hookOptionsGenerator, infiniteQueryGenerator, mutationGenerator, queryGenerator, suspenseInfiniteQueryGenerator, suspenseQueryGenerator };
 //# sourceMappingURL=generators.d.ts.map

package/dist/generators.js

@@ -1,3 +1,3 @@
-import { a as infiniteQueryGenerator, i as mutationGenerator, n as suspenseInfiniteQueryGenerator, r as queryGenerator, t as suspenseQueryGenerator } from "./generators-Cz0OG9Qu.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-cZao868O.js";
 
-export { infiniteQueryGenerator, mutationGenerator, queryGenerator, suspenseInfiniteQueryGenerator, suspenseQueryGenerator };
+export { customHookOptionsFileGenerator, hookOptionsGenerator, infiniteQueryGenerator, mutationGenerator, queryGenerator, suspenseInfiniteQueryGenerator, suspenseQueryGenerator };

package/dist/index.cjs

@@ -1,5 +1,5 @@
-const require_generators = require('./generators-BNtUetHy.cjs');
-const require_components = require('./components-CO636qn3.cjs');
+const require_generators = require('./generators-CYoqgYAV.cjs');
+const require_components = require('./components-6nRaAppd.cjs');
 let node_path = require("node:path");
 node_path = require_generators.__toESM(node_path);
 let _kubb_core = require("@kubb/core");
@@ -21,8 +21,10 @@ const pluginReactQuery = (0, _kubb_core.definePlugin)((options) => {
 		require_generators.suspenseQueryGenerator,
 		require_generators.infiniteQueryGenerator,
 		require_generators.suspenseInfiniteQueryGenerator,
-		require_generators.mutationGenerator
-	].filter(Boolean), mutation = {}, query = {}, mutationKey = require_components.MutationKey.getTransformer, queryKey = require_components.QueryKey.getTransformer, paramsCasing, contentType, client } = options;
+		require_generators.mutationGenerator,
+		require_generators.hookOptionsGenerator,
+		require_generators.customHookOptionsFileGenerator
+	].filter(Boolean), mutation = {}, query = {}, mutationKey = require_components.MutationKey.getTransformer, queryKey = require_components.QueryKey.getTransformer, customOptions, paramsCasing, contentType, client } = options;
 	const clientName = client?.client ?? "axios";
 	const clientImportPath = client?.importPath ?? (!client?.bundle ? `@kubb/plugin-client/clients/${clientName}` : void 0);
 	return {
@@ -63,6 +65,10 @@ const pluginReactQuery = (0, _kubb_core.definePlugin)((options) => {
 				importPath: "@tanstack/react-query",
 				...mutation
 			},
+			customOptions: customOptions ? {
+				name: "useCustomHookOptions",
+				...customOptions
+			} : void 0,
 			paramsType,
 			pathParamsType,
 			parser,

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["queryGenerator","suspenseQueryGenerator","infiniteQueryGenerator","suspenseInfiniteQueryGenerator","mutationGenerator","MutationKey","QueryKey","pluginOasName","pluginTsName","pluginZodName","path","options","groupName: Group['name']","pluginClientName","OperationGenerator"],"sources":["../src/plugin.ts"],"sourcesContent":["import path from 'node:path'\nimport { definePlugin, type Group, getBarrelFiles, getMode } from '@kubb/core'\nimport { camelCase, pascalCase } from '@kubb/core/transformers'\nimport { resolveModuleSource } from '@kubb/core/utils'\nimport { pluginClientName } from '@kubb/plugin-client'\nimport { OperationGenerator, pluginOasName } from '@kubb/plugin-oas'\nimport { pluginTsName } from '@kubb/plugin-ts'\nimport { pluginZodName } from '@kubb/plugin-zod'\nimport { MutationKey } from './components'\nimport { QueryKey } from './components/QueryKey.tsx'\nimport { infiniteQueryGenerator, mutationGenerator, queryGenerator, suspenseInfiniteQueryGenerator, suspenseQueryGenerator } from './generators'\nimport type { PluginReactQuery } from './types.ts'\n\nexport const pluginReactQueryName = 'plugin-react-query' satisfies PluginReactQuery['name']\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    transformers = {},\n    paramsType = 'inline',\n    pathParamsType = paramsType === 'object' ? 'object' : options.pathParamsType || 'inline',\n    generators = [queryGenerator, suspenseQueryGenerator, infiniteQueryGenerator, suspenseInfiniteQueryGenerator, mutationGenerator].filter(Boolean),\n    mutation = {},\n    query = {},\n    mutationKey = MutationKey.getTransformer,\n    queryKey = QueryKey.getTransformer,\n    paramsCasing,\n    contentType,\n    client,\n  } = options\n\n  const clientName = client?.client ?? 'axios'\n  const clientImportPath = client?.importPath ?? (!client?.bundle ? `@kubb/plugin-client/clients/${clientName}` : undefined)\n\n  return {\n    name: pluginReactQueryName,\n    options: {\n      output,\n      client: {\n        ...options.client,\n        client: clientName,\n        clientType: client?.clientType ?? 'function',\n        dataReturnType: client?.dataReturnType ?? 'data',\n        pathParamsType,\n        importPath: clientImportPath,\n      },\n      infinite: infinite\n        ? {\n            queryParam: 'id',\n            initialPageParam: 0,\n            cursorParam: undefined,\n            nextParam: undefined,\n            previousParam: undefined,\n            ...infinite,\n          }\n        : false,\n      suspense,\n      queryKey,\n      query:\n        query === false\n          ? false\n          : {\n              methods: ['get'],\n              importPath: '@tanstack/react-query',\n              ...query,\n            },\n      mutationKey,\n      mutation:\n        mutation === false\n          ? false\n          : {\n              methods: ['post', 'put', 'patch', 'delete'],\n              importPath: '@tanstack/react-query',\n              ...mutation,\n            },\n      paramsType,\n      pathParamsType,\n      parser,\n      paramsCasing,\n      group,\n    },\n    pre: [pluginOasName, pluginTsName, parser === 'zod' ? pluginZodName : undefined].filter(Boolean),\n    resolvePath(baseName, pathMode, options) {\n      const root = path.resolve(this.config.root, this.config.output.path)\n      const mode = pathMode ?? getMode(path.resolve(root, output.path))\n\n      if (mode === 'single') {\n        /**\n         * when output is a file then we will always append to the same file(output file), see fileManager.addOrAppend\n         * Other plugins then need to call addOrAppend instead of just add from the fileManager class\n         */\n        return path.resolve(root, output.path)\n      }\n\n      if (group && (options?.group?.path || options?.group?.tag)) {\n        const groupName: Group['name'] = group?.name\n          ? group.name\n          : (ctx) => {\n              if (group?.type === 'path') {\n                return `${ctx.group.split('/')[1]}`\n              }\n              return `${camelCase(ctx.group)}Controller`\n            }\n\n        return path.resolve(\n          root,\n          output.path,\n          groupName({\n            group: group.type === 'path' ? options.group.path! : options.group.tag!,\n          }),\n          baseName,\n        )\n      }\n\n      return path.resolve(root, output.path, baseName)\n    },\n    resolveName(name, type) {\n      let resolvedName = camelCase(name)\n\n      if (type === 'file' || type === 'function') {\n        resolvedName = camelCase(name, {\n          isFile: type === 'file',\n        })\n      }\n      if (type === 'type') {\n        resolvedName = pascalCase(name)\n      }\n\n      if (type) {\n        return transformers?.name?.(resolvedName, type) || resolvedName\n      }\n\n      return resolvedName\n    },\n    async install() {\n      const root = path.resolve(this.config.root, this.config.output.path)\n      const mode = getMode(path.resolve(root, output.path))\n      const oas = await this.getOas()\n      const baseURL = await this.getBaseURL()\n\n      if (baseURL) {\n        this.plugin.options.client.baseURL = baseURL\n      }\n\n      const hasClientPlugin = !!this.pluginManager.getPluginByKey([pluginClientName])\n\n      if (this.plugin.options.client.bundle && !hasClientPlugin && !this.plugin.options.client.importPath) {\n        // pre add bundled fetch\n        await this.upsertFile({\n          baseName: 'fetch.ts',\n          path: path.resolve(root, '.kubb/fetch.ts'),\n          sources: [\n            {\n              name: 'fetch',\n              value: resolveModuleSource(\n                this.plugin.options.client.client === 'fetch' ? '@kubb/plugin-client/templates/clients/fetch' : '@kubb/plugin-client/templates/clients/axios',\n              ).source,\n              isExportable: true,\n              isIndexable: true,\n            },\n          ],\n        })\n      }\n\n      if (!hasClientPlugin) {\n        await this.upsertFile({\n          baseName: 'config.ts',\n          path: path.resolve(root, '.kubb/config.ts'),\n          sources: [\n            {\n              name: 'config',\n              value: resolveModuleSource('@kubb/plugin-client/templates/config').source,\n              isExportable: false,\n              isIndexable: false,\n            },\n          ],\n        })\n      }\n\n      const operationGenerator = new OperationGenerator(this.plugin.options, {\n        fabric: this.fabric,\n        oas,\n        pluginManager: this.pluginManager,\n        events: this.events,\n        plugin: this.plugin,\n        contentType,\n        exclude,\n        include,\n        override,\n        mode,\n      })\n\n      const files = await operationGenerator.build(...generators)\n      await this.upsertFile(...files)\n\n      const barrelFiles = await getBarrelFiles(this.fabric.files, {\n        type: output.barrelType ?? 'named',\n        root,\n        output,\n        meta: {\n          pluginKey: this.plugin.key,\n        },\n      })\n\n      await this.upsertFile(...barrelFiles)\n    },\n  }\n})\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["queryGenerator","suspenseQueryGenerator","infiniteQueryGenerator","suspenseInfiniteQueryGenerator","mutationGenerator","hookOptionsGenerator","customHookOptionsFileGenerator","MutationKey","QueryKey","pluginOasName","pluginTsName","pluginZodName","path","options","groupName: Group['name']","pluginClientName","OperationGenerator"],"sources":["../src/plugin.ts"],"sourcesContent":["import path from 'node:path'\nimport { definePlugin, type Group, getBarrelFiles, getMode } from '@kubb/core'\nimport { camelCase, pascalCase } from '@kubb/core/transformers'\nimport { resolveModuleSource } from '@kubb/core/utils'\nimport { pluginClientName } from '@kubb/plugin-client'\nimport { OperationGenerator, pluginOasName } from '@kubb/plugin-oas'\nimport { pluginTsName } from '@kubb/plugin-ts'\nimport { pluginZodName } from '@kubb/plugin-zod'\nimport { MutationKey } from './components'\nimport { QueryKey } from './components/QueryKey.tsx'\nimport {\n  customHookOptionsFileGenerator,\n  hookOptionsGenerator,\n  infiniteQueryGenerator,\n  mutationGenerator,\n  queryGenerator,\n  suspenseInfiniteQueryGenerator,\n  suspenseQueryGenerator,\n} from './generators'\nimport type { PluginReactQuery } from './types.ts'\n\nexport const pluginReactQueryName = 'plugin-react-query' satisfies PluginReactQuery['name']\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    transformers = {},\n    paramsType = 'inline',\n    pathParamsType = paramsType === 'object' ? 'object' : options.pathParamsType || 'inline',\n    generators = [\n      queryGenerator,\n      suspenseQueryGenerator,\n      infiniteQueryGenerator,\n      suspenseInfiniteQueryGenerator,\n      mutationGenerator,\n      hookOptionsGenerator,\n      customHookOptionsFileGenerator,\n    ].filter(Boolean),\n    mutation = {},\n    query = {},\n    mutationKey = MutationKey.getTransformer,\n    queryKey = QueryKey.getTransformer,\n    customOptions,\n    paramsCasing,\n    contentType,\n    client,\n  } = options\n\n  const clientName = client?.client ?? 'axios'\n  const clientImportPath = client?.importPath ?? (!client?.bundle ? `@kubb/plugin-client/clients/${clientName}` : undefined)\n\n  return {\n    name: pluginReactQueryName,\n    options: {\n      output,\n      client: {\n        ...options.client,\n        client: clientName,\n        clientType: client?.clientType ?? 'function',\n        dataReturnType: client?.dataReturnType ?? 'data',\n        pathParamsType,\n        importPath: clientImportPath,\n      },\n      infinite: infinite\n        ? {\n            queryParam: 'id',\n            initialPageParam: 0,\n            cursorParam: undefined,\n            nextParam: undefined,\n            previousParam: undefined,\n            ...infinite,\n          }\n        : false,\n      suspense,\n      queryKey,\n      query:\n        query === false\n          ? false\n          : {\n              methods: ['get'],\n              importPath: '@tanstack/react-query',\n              ...query,\n            },\n      mutationKey,\n      mutation:\n        mutation === false\n          ? false\n          : {\n              methods: ['post', 'put', 'patch', 'delete'],\n              importPath: '@tanstack/react-query',\n              ...mutation,\n            },\n      customOptions: customOptions ? { name: 'useCustomHookOptions', ...customOptions } : undefined,\n      paramsType,\n      pathParamsType,\n      parser,\n      paramsCasing,\n      group,\n    },\n    pre: [pluginOasName, pluginTsName, parser === 'zod' ? pluginZodName : undefined].filter(Boolean),\n    resolvePath(baseName, pathMode, options) {\n      const root = path.resolve(this.config.root, this.config.output.path)\n      const mode = pathMode ?? getMode(path.resolve(root, output.path))\n\n      if (mode === 'single') {\n        /**\n         * when output is a file then we will always append to the same file(output file), see fileManager.addOrAppend\n         * Other plugins then need to call addOrAppend instead of just add from the fileManager class\n         */\n        return path.resolve(root, output.path)\n      }\n\n      if (group && (options?.group?.path || options?.group?.tag)) {\n        const groupName: Group['name'] = group?.name\n          ? group.name\n          : (ctx) => {\n              if (group?.type === 'path') {\n                return `${ctx.group.split('/')[1]}`\n              }\n              return `${camelCase(ctx.group)}Controller`\n            }\n\n        return path.resolve(\n          root,\n          output.path,\n          groupName({\n            group: group.type === 'path' ? options.group.path! : options.group.tag!,\n          }),\n          baseName,\n        )\n      }\n\n      return path.resolve(root, output.path, baseName)\n    },\n    resolveName(name, type) {\n      let resolvedName = camelCase(name)\n\n      if (type === 'file' || type === 'function') {\n        resolvedName = camelCase(name, {\n          isFile: type === 'file',\n        })\n      }\n      if (type === 'type') {\n        resolvedName = pascalCase(name)\n      }\n\n      if (type) {\n        return transformers?.name?.(resolvedName, type) || resolvedName\n      }\n\n      return resolvedName\n    },\n    async install() {\n      const root = path.resolve(this.config.root, this.config.output.path)\n      const mode = getMode(path.resolve(root, output.path))\n      const oas = await this.getOas()\n      const baseURL = await this.getBaseURL()\n\n      if (baseURL) {\n        this.plugin.options.client.baseURL = baseURL\n      }\n\n      const hasClientPlugin = !!this.pluginManager.getPluginByKey([pluginClientName])\n\n      if (this.plugin.options.client.bundle && !hasClientPlugin && !this.plugin.options.client.importPath) {\n        // pre add bundled fetch\n        await this.upsertFile({\n          baseName: 'fetch.ts',\n          path: path.resolve(root, '.kubb/fetch.ts'),\n          sources: [\n            {\n              name: 'fetch',\n              value: resolveModuleSource(\n                this.plugin.options.client.client === 'fetch' ? '@kubb/plugin-client/templates/clients/fetch' : '@kubb/plugin-client/templates/clients/axios',\n              ).source,\n              isExportable: true,\n              isIndexable: true,\n            },\n          ],\n        })\n      }\n\n      if (!hasClientPlugin) {\n        await this.upsertFile({\n          baseName: 'config.ts',\n          path: path.resolve(root, '.kubb/config.ts'),\n          sources: [\n            {\n              name: 'config',\n              value: resolveModuleSource('@kubb/plugin-client/templates/config').source,\n              isExportable: false,\n              isIndexable: false,\n            },\n          ],\n        })\n      }\n\n      const operationGenerator = new OperationGenerator(this.plugin.options, {\n        fabric: this.fabric,\n        oas,\n        pluginManager: this.pluginManager,\n        events: this.events,\n        plugin: this.plugin,\n        contentType,\n        exclude,\n        include,\n        override,\n        mode,\n      })\n\n      const files = await operationGenerator.build(...generators)\n      await this.upsertFile(...files)\n\n      const barrelFiles = await getBarrelFiles(this.fabric.files, {\n        type: output.barrelType ?? 'named',\n        root,\n        output,\n        meta: {\n          pluginKey: this.plugin.key,\n        },\n      })\n\n      await this.upsertFile(...barrelFiles)\n    },\n  }\n})\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { n as Options, r as PluginReactQuery, s as UserPluginWithLifeCycle } from "./types-B2aUnqdY.cjs";
+import { n as Options, r as PluginReactQuery, s as UserPluginWithLifeCycle } from "./types-B9xv5S0R.cjs";
 
 //#region src/plugin.d.ts
 declare const pluginReactQueryName = "plugin-react-query";

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { n as Options, r as PluginReactQuery, s as UserPluginWithLifeCycle } from "./types-Cli5EJ4L.js";
+import { n as Options, r as PluginReactQuery, s as UserPluginWithLifeCycle } from "./types-BAEc42Ae.js";
 
 //#region src/plugin.d.ts
 declare const pluginReactQueryName = "plugin-react-query";

package/dist/index.js

@@ -1,5 +1,5 @@
-import { d as QueryKey, s as MutationKey } from "./components-DQHnoHX_.js";
-import { a as infiniteQueryGenerator, i as mutationGenerator, n as suspenseInfiniteQueryGenerator, r as queryGenerator, t as suspenseQueryGenerator } from "./generators-Cz0OG9Qu.js";
+import { d as QueryKey, s as MutationKey } from "./components-B6lqcqgn.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-cZao868O.js";
 import path from "node:path";
 import { definePlugin, getBarrelFiles, getMode } from "@kubb/core";
 import { camelCase, pascalCase } from "@kubb/core/transformers";
@@ -20,8 +20,10 @@ const pluginReactQuery = definePlugin((options) => {
 		suspenseQueryGenerator,
 		infiniteQueryGenerator,
 		suspenseInfiniteQueryGenerator,
-		mutationGenerator
-	].filter(Boolean), mutation = {}, query = {}, mutationKey = MutationKey.getTransformer, queryKey = QueryKey.getTransformer, paramsCasing, contentType, client } = options;
+		mutationGenerator,
+		hookOptionsGenerator,
+		customHookOptionsFileGenerator
+	].filter(Boolean), mutation = {}, query = {}, mutationKey = MutationKey.getTransformer, queryKey = QueryKey.getTransformer, customOptions, paramsCasing, contentType, client } = options;
 	const clientName = client?.client ?? "axios";
 	const clientImportPath = client?.importPath ?? (!client?.bundle ? `@kubb/plugin-client/clients/${clientName}` : void 0);
 	return {
@@ -62,6 +64,10 @@ const pluginReactQuery = definePlugin((options) => {
 				importPath: "@tanstack/react-query",
 				...mutation
 			},
+			customOptions: customOptions ? {
+				name: "useCustomHookOptions",
+				...customOptions
+			} : void 0,
 			paramsType,
 			pathParamsType,
 			parser,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["options","groupName: Group['name']"],"sources":["../src/plugin.ts"],"sourcesContent":["import path from 'node:path'\nimport { definePlugin, type Group, getBarrelFiles, getMode } from '@kubb/core'\nimport { camelCase, pascalCase } from '@kubb/core/transformers'\nimport { resolveModuleSource } from '@kubb/core/utils'\nimport { pluginClientName } from '@kubb/plugin-client'\nimport { OperationGenerator, pluginOasName } from '@kubb/plugin-oas'\nimport { pluginTsName } from '@kubb/plugin-ts'\nimport { pluginZodName } from '@kubb/plugin-zod'\nimport { MutationKey } from './components'\nimport { QueryKey } from './components/QueryKey.tsx'\nimport { infiniteQueryGenerator, mutationGenerator, queryGenerator, suspenseInfiniteQueryGenerator, suspenseQueryGenerator } from './generators'\nimport type { PluginReactQuery } from './types.ts'\n\nexport const pluginReactQueryName = 'plugin-react-query' satisfies PluginReactQuery['name']\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    transformers = {},\n    paramsType = 'inline',\n    pathParamsType = paramsType === 'object' ? 'object' : options.pathParamsType || 'inline',\n    generators = [queryGenerator, suspenseQueryGenerator, infiniteQueryGenerator, suspenseInfiniteQueryGenerator, mutationGenerator].filter(Boolean),\n    mutation = {},\n    query = {},\n    mutationKey = MutationKey.getTransformer,\n    queryKey = QueryKey.getTransformer,\n    paramsCasing,\n    contentType,\n    client,\n  } = options\n\n  const clientName = client?.client ?? 'axios'\n  const clientImportPath = client?.importPath ?? (!client?.bundle ? `@kubb/plugin-client/clients/${clientName}` : undefined)\n\n  return {\n    name: pluginReactQueryName,\n    options: {\n      output,\n      client: {\n        ...options.client,\n        client: clientName,\n        clientType: client?.clientType ?? 'function',\n        dataReturnType: client?.dataReturnType ?? 'data',\n        pathParamsType,\n        importPath: clientImportPath,\n      },\n      infinite: infinite\n        ? {\n            queryParam: 'id',\n            initialPageParam: 0,\n            cursorParam: undefined,\n            nextParam: undefined,\n            previousParam: undefined,\n            ...infinite,\n          }\n        : false,\n      suspense,\n      queryKey,\n      query:\n        query === false\n          ? false\n          : {\n              methods: ['get'],\n              importPath: '@tanstack/react-query',\n              ...query,\n            },\n      mutationKey,\n      mutation:\n        mutation === false\n          ? false\n          : {\n              methods: ['post', 'put', 'patch', 'delete'],\n              importPath: '@tanstack/react-query',\n              ...mutation,\n            },\n      paramsType,\n      pathParamsType,\n      parser,\n      paramsCasing,\n      group,\n    },\n    pre: [pluginOasName, pluginTsName, parser === 'zod' ? pluginZodName : undefined].filter(Boolean),\n    resolvePath(baseName, pathMode, options) {\n      const root = path.resolve(this.config.root, this.config.output.path)\n      const mode = pathMode ?? getMode(path.resolve(root, output.path))\n\n      if (mode === 'single') {\n        /**\n         * when output is a file then we will always append to the same file(output file), see fileManager.addOrAppend\n         * Other plugins then need to call addOrAppend instead of just add from the fileManager class\n         */\n        return path.resolve(root, output.path)\n      }\n\n      if (group && (options?.group?.path || options?.group?.tag)) {\n        const groupName: Group['name'] = group?.name\n          ? group.name\n          : (ctx) => {\n              if (group?.type === 'path') {\n                return `${ctx.group.split('/')[1]}`\n              }\n              return `${camelCase(ctx.group)}Controller`\n            }\n\n        return path.resolve(\n          root,\n          output.path,\n          groupName({\n            group: group.type === 'path' ? options.group.path! : options.group.tag!,\n          }),\n          baseName,\n        )\n      }\n\n      return path.resolve(root, output.path, baseName)\n    },\n    resolveName(name, type) {\n      let resolvedName = camelCase(name)\n\n      if (type === 'file' || type === 'function') {\n        resolvedName = camelCase(name, {\n          isFile: type === 'file',\n        })\n      }\n      if (type === 'type') {\n        resolvedName = pascalCase(name)\n      }\n\n      if (type) {\n        return transformers?.name?.(resolvedName, type) || resolvedName\n      }\n\n      return resolvedName\n    },\n    async install() {\n      const root = path.resolve(this.config.root, this.config.output.path)\n      const mode = getMode(path.resolve(root, output.path))\n      const oas = await this.getOas()\n      const baseURL = await this.getBaseURL()\n\n      if (baseURL) {\n        this.plugin.options.client.baseURL = baseURL\n      }\n\n      const hasClientPlugin = !!this.pluginManager.getPluginByKey([pluginClientName])\n\n      if (this.plugin.options.client.bundle && !hasClientPlugin && !this.plugin.options.client.importPath) {\n        // pre add bundled fetch\n        await this.upsertFile({\n          baseName: 'fetch.ts',\n          path: path.resolve(root, '.kubb/fetch.ts'),\n          sources: [\n            {\n              name: 'fetch',\n              value: resolveModuleSource(\n                this.plugin.options.client.client === 'fetch' ? '@kubb/plugin-client/templates/clients/fetch' : '@kubb/plugin-client/templates/clients/axios',\n              ).source,\n              isExportable: true,\n              isIndexable: true,\n            },\n          ],\n        })\n      }\n\n      if (!hasClientPlugin) {\n        await this.upsertFile({\n          baseName: 'config.ts',\n          path: path.resolve(root, '.kubb/config.ts'),\n          sources: [\n            {\n              name: 'config',\n              value: resolveModuleSource('@kubb/plugin-client/templates/config').source,\n              isExportable: false,\n              isIndexable: false,\n            },\n          ],\n        })\n      }\n\n      const operationGenerator = new OperationGenerator(this.plugin.options, {\n        fabric: this.fabric,\n        oas,\n        pluginManager: this.pluginManager,\n        events: this.events,\n        plugin: this.plugin,\n        contentType,\n        exclude,\n        include,\n        override,\n        mode,\n      })\n\n      const files = await operationGenerator.build(...generators)\n      await this.upsertFile(...files)\n\n      const barrelFiles = await getBarrelFiles(this.fabric.files, {\n        type: output.barrelType ?? 'named',\n        root,\n        output,\n        meta: {\n          pluginKey: this.plugin.key,\n        },\n      })\n\n      await this.upsertFile(...barrelFiles)\n    },\n  }\n})\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["options","groupName: Group['name']"],"sources":["../src/plugin.ts"],"sourcesContent":["import path from 'node:path'\nimport { definePlugin, type Group, getBarrelFiles, getMode } from '@kubb/core'\nimport { camelCase, pascalCase } from '@kubb/core/transformers'\nimport { resolveModuleSource } from '@kubb/core/utils'\nimport { pluginClientName } from '@kubb/plugin-client'\nimport { OperationGenerator, pluginOasName } from '@kubb/plugin-oas'\nimport { pluginTsName } from '@kubb/plugin-ts'\nimport { pluginZodName } from '@kubb/plugin-zod'\nimport { MutationKey } from './components'\nimport { QueryKey } from './components/QueryKey.tsx'\nimport {\n  customHookOptionsFileGenerator,\n  hookOptionsGenerator,\n  infiniteQueryGenerator,\n  mutationGenerator,\n  queryGenerator,\n  suspenseInfiniteQueryGenerator,\n  suspenseQueryGenerator,\n} from './generators'\nimport type { PluginReactQuery } from './types.ts'\n\nexport const pluginReactQueryName = 'plugin-react-query' satisfies PluginReactQuery['name']\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    transformers = {},\n    paramsType = 'inline',\n    pathParamsType = paramsType === 'object' ? 'object' : options.pathParamsType || 'inline',\n    generators = [\n      queryGenerator,\n      suspenseQueryGenerator,\n      infiniteQueryGenerator,\n      suspenseInfiniteQueryGenerator,\n      mutationGenerator,\n      hookOptionsGenerator,\n      customHookOptionsFileGenerator,\n    ].filter(Boolean),\n    mutation = {},\n    query = {},\n    mutationKey = MutationKey.getTransformer,\n    queryKey = QueryKey.getTransformer,\n    customOptions,\n    paramsCasing,\n    contentType,\n    client,\n  } = options\n\n  const clientName = client?.client ?? 'axios'\n  const clientImportPath = client?.importPath ?? (!client?.bundle ? `@kubb/plugin-client/clients/${clientName}` : undefined)\n\n  return {\n    name: pluginReactQueryName,\n    options: {\n      output,\n      client: {\n        ...options.client,\n        client: clientName,\n        clientType: client?.clientType ?? 'function',\n        dataReturnType: client?.dataReturnType ?? 'data',\n        pathParamsType,\n        importPath: clientImportPath,\n      },\n      infinite: infinite\n        ? {\n            queryParam: 'id',\n            initialPageParam: 0,\n            cursorParam: undefined,\n            nextParam: undefined,\n            previousParam: undefined,\n            ...infinite,\n          }\n        : false,\n      suspense,\n      queryKey,\n      query:\n        query === false\n          ? false\n          : {\n              methods: ['get'],\n              importPath: '@tanstack/react-query',\n              ...query,\n            },\n      mutationKey,\n      mutation:\n        mutation === false\n          ? false\n          : {\n              methods: ['post', 'put', 'patch', 'delete'],\n              importPath: '@tanstack/react-query',\n              ...mutation,\n            },\n      customOptions: customOptions ? { name: 'useCustomHookOptions', ...customOptions } : undefined,\n      paramsType,\n      pathParamsType,\n      parser,\n      paramsCasing,\n      group,\n    },\n    pre: [pluginOasName, pluginTsName, parser === 'zod' ? pluginZodName : undefined].filter(Boolean),\n    resolvePath(baseName, pathMode, options) {\n      const root = path.resolve(this.config.root, this.config.output.path)\n      const mode = pathMode ?? getMode(path.resolve(root, output.path))\n\n      if (mode === 'single') {\n        /**\n         * when output is a file then we will always append to the same file(output file), see fileManager.addOrAppend\n         * Other plugins then need to call addOrAppend instead of just add from the fileManager class\n         */\n        return path.resolve(root, output.path)\n      }\n\n      if (group && (options?.group?.path || options?.group?.tag)) {\n        const groupName: Group['name'] = group?.name\n          ? group.name\n          : (ctx) => {\n              if (group?.type === 'path') {\n                return `${ctx.group.split('/')[1]}`\n              }\n              return `${camelCase(ctx.group)}Controller`\n            }\n\n        return path.resolve(\n          root,\n          output.path,\n          groupName({\n            group: group.type === 'path' ? options.group.path! : options.group.tag!,\n          }),\n          baseName,\n        )\n      }\n\n      return path.resolve(root, output.path, baseName)\n    },\n    resolveName(name, type) {\n      let resolvedName = camelCase(name)\n\n      if (type === 'file' || type === 'function') {\n        resolvedName = camelCase(name, {\n          isFile: type === 'file',\n        })\n      }\n      if (type === 'type') {\n        resolvedName = pascalCase(name)\n      }\n\n      if (type) {\n        return transformers?.name?.(resolvedName, type) || resolvedName\n      }\n\n      return resolvedName\n    },\n    async install() {\n      const root = path.resolve(this.config.root, this.config.output.path)\n      const mode = getMode(path.resolve(root, output.path))\n      const oas = await this.getOas()\n      const baseURL = await this.getBaseURL()\n\n      if (baseURL) {\n        this.plugin.options.client.baseURL = baseURL\n      }\n\n      const hasClientPlugin = !!this.pluginManager.getPluginByKey([pluginClientName])\n\n      if (this.plugin.options.client.bundle && !hasClientPlugin && !this.plugin.options.client.importPath) {\n        // pre add bundled fetch\n        await this.upsertFile({\n          baseName: 'fetch.ts',\n          path: path.resolve(root, '.kubb/fetch.ts'),\n          sources: [\n            {\n              name: 'fetch',\n              value: resolveModuleSource(\n                this.plugin.options.client.client === 'fetch' ? '@kubb/plugin-client/templates/clients/fetch' : '@kubb/plugin-client/templates/clients/axios',\n              ).source,\n              isExportable: true,\n              isIndexable: true,\n            },\n          ],\n        })\n      }\n\n      if (!hasClientPlugin) {\n        await this.upsertFile({\n          baseName: 'config.ts',\n          path: path.resolve(root, '.kubb/config.ts'),\n          sources: [\n            {\n              name: 'config',\n              value: resolveModuleSource('@kubb/plugin-client/templates/config').source,\n              isExportable: false,\n              isIndexable: false,\n            },\n          ],\n        })\n      }\n\n      const operationGenerator = new OperationGenerator(this.plugin.options, {\n        fabric: this.fabric,\n        oas,\n        pluginManager: this.pluginManager,\n        events: this.events,\n        plugin: this.plugin,\n        contentType,\n        exclude,\n        include,\n        override,\n        mode,\n      })\n\n      const files = await operationGenerator.build(...generators)\n      await this.upsertFile(...files)\n\n      const barrelFiles = await getBarrelFiles(this.fabric.files, {\n        type: output.barrelType ?? 'named',\n        root,\n        output,\n        meta: {\n          pluginKey: this.plugin.key,\n        },\n      })\n\n      await this.upsertFile(...barrelFiles)\n    },\n  }\n})\n"],"mappings":"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"}

package/dist/{types-Cli5EJ4L.d.ts → types-B9xv5S0R.d.cts}

@@ -1,9 +1,9 @@
-import { Fabric } from "@kubb/react-fabric";
 import * as oas_normalize_lib_types0 from "oas-normalize/lib/types";
 import BaseOas from "oas";
 import { Operation } from "oas/operation";
 import { DiscriminatorObject, HttpMethods, OASDocument, SchemaObject } from "oas/types";
 import { KubbFile } from "@kubb/fabric-core/types";
+import { Fabric } from "@kubb/react-fabric";
 import { KubbNode } from "@kubb/react-fabric/types";
 
 //#region ../oas/src/types.d.ts
@@ -391,6 +391,13 @@ type Config<TInput = Input> = {
      * @default 'simple'
      */
     defaultBanner?: 'simple' | 'full' | false;
+    /**
+     * Whether to override existing external files if they already exist.
+     * When setting the option in the global configuration, all plugins inherit the same behavior by default.
+     * However, all plugins also have an `output.override` option, which can be used to override the behavior for a specific plugin.
+     * @default false
+     */
+    override?: boolean;
   };
   /**
    * An array of Kubb plugins that will be used in the generation.
@@ -578,6 +585,11 @@ type Output<TOptions> = {
    * Add a footer text in the beginning of every file
    */
   footer?: string | ((options: TOptions) => string);
+  /**
+   * Whether to override existing external files if they already exist.
+   * @default false
+   */
+  override?: boolean;
 };
 type GroupContext = {
   group: string;
@@ -831,6 +843,7 @@ type Context$1<TOptions, TPluginOptions extends PluginFactoryOptions> = {
 };
 declare class OperationGenerator<TPluginOptions extends PluginFactoryOptions = PluginFactoryOptions, TFileMeta extends FileMetaBase = FileMetaBase> extends BaseGenerator<TPluginOptions['resolvedOptions'], Context$1<TPluginOptions['resolvedOptions'], TPluginOptions>> {
   #private;
+  getOptions(operation: Operation$1, method: HttpMethod): Partial<TPluginOptions['resolvedOptions']>;
   getSchemas(operation: Operation$1, {
     resolveName
   }?: {
@@ -1367,6 +1380,20 @@ type Infinite = {
    */
   initialPageParam: unknown;
 };
+type CustomOptions = {
+  /**
+   * Path to the hook that will be used to customize the hook options.
+   * It will be used as `import ${customOptions.name} from '${customOptions.importPath}'`.
+   * It allows both relative and absolute paths but be aware that we will not change the path.
+   */
+  importPath: string;
+  /**
+   * Name of the exported hook that will be used to customize the hook options.
+   * It will be used as `import ${customOptions.name} from '${customOptions.importPath}'`.
+   * @default 'useCustomHookOptions'
+   */
+  name?: string;
+};
 type Options = {
   /**
    * Specify the export location for the files and define the behavior of the output
@@ -1432,6 +1459,11 @@ type Options = {
    * Override some useMutation behaviours.
    */
   mutation?: Partial<Mutation> | false;
+  /**
+   * When set, a custom hook will be used to customize the options of the generated hooks.
+   * It will also generate a `HookOptions` type that can be used to type the custom options of each hook for type-safety.
+   */
+  customOptions?: CustomOptions;
   /**
    * Which parser should be used before returning the data to `@tanstack/query`.
    * `'zod'` will use `@kubb/plugin-zod` to parse the data.
@@ -1465,8 +1497,9 @@ type ResolvedOptions = {
   query: NonNullable<Required<Query>> | false;
   mutationKey: MutationKey | undefined;
   mutation: NonNullable<Required<Mutation>> | false;
+  customOptions: NonNullable<Required<CustomOptions>> | undefined;
 };
 type PluginReactQuery = PluginFactoryOptions<'plugin-react-query', Options, ResolvedOptions, never, ResolvePathOptions>;
 //#endregion
 export { ReactGenerator as a, Operation$1 as c, Transformer as i, Options as n, OperationSchemas as o, PluginReactQuery as r, UserPluginWithLifeCycle as s, Infinite as t };
-//# sourceMappingURL=types-Cli5EJ4L.d.ts.map
+//# sourceMappingURL=types-B9xv5S0R.d.cts.map

package/dist/{types-B2aUnqdY.d.cts → types-BAEc42Ae.d.ts}

@@ -1,9 +1,9 @@
+import { Fabric } from "@kubb/react-fabric";
 import * as oas_normalize_lib_types0 from "oas-normalize/lib/types";
 import BaseOas from "oas";
 import { Operation } from "oas/operation";
 import { DiscriminatorObject, HttpMethods, OASDocument, SchemaObject } from "oas/types";
 import { KubbFile } from "@kubb/fabric-core/types";
-import { Fabric } from "@kubb/react-fabric";
 import { KubbNode } from "@kubb/react-fabric/types";
 
 //#region ../oas/src/types.d.ts
@@ -391,6 +391,13 @@ type Config<TInput = Input> = {
      * @default 'simple'
      */
     defaultBanner?: 'simple' | 'full' | false;
+    /**
+     * Whether to override existing external files if they already exist.
+     * When setting the option in the global configuration, all plugins inherit the same behavior by default.
+     * However, all plugins also have an `output.override` option, which can be used to override the behavior for a specific plugin.
+     * @default false
+     */
+    override?: boolean;
   };
   /**
    * An array of Kubb plugins that will be used in the generation.
@@ -578,6 +585,11 @@ type Output<TOptions> = {
    * Add a footer text in the beginning of every file
    */
   footer?: string | ((options: TOptions) => string);
+  /**
+   * Whether to override existing external files if they already exist.
+   * @default false
+   */
+  override?: boolean;
 };
 type GroupContext = {
   group: string;
@@ -831,6 +843,7 @@ type Context$1<TOptions, TPluginOptions extends PluginFactoryOptions> = {
 };
 declare class OperationGenerator<TPluginOptions extends PluginFactoryOptions = PluginFactoryOptions, TFileMeta extends FileMetaBase = FileMetaBase> extends BaseGenerator<TPluginOptions['resolvedOptions'], Context$1<TPluginOptions['resolvedOptions'], TPluginOptions>> {
   #private;
+  getOptions(operation: Operation$1, method: HttpMethod): Partial<TPluginOptions['resolvedOptions']>;
   getSchemas(operation: Operation$1, {
     resolveName
   }?: {
@@ -1367,6 +1380,20 @@ type Infinite = {
    */
   initialPageParam: unknown;
 };
+type CustomOptions = {
+  /**
+   * Path to the hook that will be used to customize the hook options.
+   * It will be used as `import ${customOptions.name} from '${customOptions.importPath}'`.
+   * It allows both relative and absolute paths but be aware that we will not change the path.
+   */
+  importPath: string;
+  /**
+   * Name of the exported hook that will be used to customize the hook options.
+   * It will be used as `import ${customOptions.name} from '${customOptions.importPath}'`.
+   * @default 'useCustomHookOptions'
+   */
+  name?: string;
+};
 type Options = {
   /**
    * Specify the export location for the files and define the behavior of the output
@@ -1432,6 +1459,11 @@ type Options = {
    * Override some useMutation behaviours.
    */
   mutation?: Partial<Mutation> | false;
+  /**
+   * When set, a custom hook will be used to customize the options of the generated hooks.
+   * It will also generate a `HookOptions` type that can be used to type the custom options of each hook for type-safety.
+   */
+  customOptions?: CustomOptions;
   /**
    * Which parser should be used before returning the data to `@tanstack/query`.
    * `'zod'` will use `@kubb/plugin-zod` to parse the data.
@@ -1465,8 +1497,9 @@ type ResolvedOptions = {
   query: NonNullable<Required<Query>> | false;
   mutationKey: MutationKey | undefined;
   mutation: NonNullable<Required<Mutation>> | false;
+  customOptions: NonNullable<Required<CustomOptions>> | undefined;
 };
 type PluginReactQuery = PluginFactoryOptions<'plugin-react-query', Options, ResolvedOptions, never, ResolvePathOptions>;
 //#endregion
 export { ReactGenerator as a, Operation$1 as c, Transformer as i, Options as n, OperationSchemas as o, PluginReactQuery as r, UserPluginWithLifeCycle as s, Infinite as t };
-//# sourceMappingURL=types-B2aUnqdY.d.cts.map
+//# sourceMappingURL=types-BAEc42Ae.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/plugin-react-query",
-  "version": "4.14.1",
+  "version": "4.15.1",
   "description": "React Query hooks generator plugin for Kubb, creating type-safe API client hooks from OpenAPI specifications for React applications.",
   "keywords": [
     "react-query",
@@ -69,12 +69,12 @@
   "dependencies": {
     "@kubb/react-fabric": "0.9.2",
     "remeda": "^2.33.1",
-    "@kubb/core": "4.14.1",
-    "@kubb/oas": "4.14.1",
-    "@kubb/plugin-client": "4.14.1",
-    "@kubb/plugin-oas": "4.14.1",
-    "@kubb/plugin-ts": "4.14.1",
-    "@kubb/plugin-zod": "4.14.1"
+    "@kubb/core": "4.15.1",
+    "@kubb/oas": "4.15.1",
+    "@kubb/plugin-client": "4.15.1",
+    "@kubb/plugin-oas": "4.15.1",
+    "@kubb/plugin-ts": "4.15.1",
+    "@kubb/plugin-zod": "4.15.1"
   },
   "peerDependencies": {
     "@kubb/react-fabric": "0.9.2"

package/src/components/InfiniteQuery.tsx

@@ -23,6 +23,7 @@ type Props = {
   dataReturnType: PluginReactQuery['resolvedOptions']['client']['dataReturnType']
   initialPageParam: Infinite['initialPageParam']
   queryParam?: Infinite['queryParam']
+  customOptions: PluginReactQuery['resolvedOptions']['customOptions']
 }
 
 type GetParamsProps = {
@@ -129,6 +130,7 @@ export function InfiniteQuery({
   operation,
   initialPageParam,
   queryParam,
+  customOptions,
 }: Props): KubbNode {
   const responseType = dataReturnType === 'data' ? typeSchemas.response.name : `ResponseConfig<${typeSchemas.response.name}>`
   const errorType = `ResponseErrorConfig<${typeSchemas.errors?.map((item) => item.name).join(' | ') || 'Error'}>`
@@ -193,9 +195,10 @@ export function InfiniteQuery({
        const { query: queryConfig = {}, client: config = {} } = options ?? {}
        const { client: queryClient, ...queryOptions } = queryConfig
        const queryKey = queryOptions?.queryKey ?? ${queryKeyName}(${queryKeyParams.toCall()})
+       ${customOptions ? `const customOptions = ${customOptions.name}({ hookName: '${name}', operationId: '${operation.getOperationId()}' })` : ''}
 
        const query = useInfiniteQuery({
-        ...${queryOptions},
+        ...${queryOptions},${customOptions ? '\n...customOptions,' : ''}
         queryKey,
         ...queryOptions
        } as unknown as InfiniteQueryObserverOptions<TQueryFnData, TError, TData, TQueryKey, TPageParam>, queryClient) as ${returnType}

package/src/components/Mutation.tsx

@@ -20,6 +20,7 @@ type Props = {
   dataReturnType: PluginReactQuery['resolvedOptions']['client']['dataReturnType']
   paramsCasing: PluginReactQuery['resolvedOptions']['paramsCasing']
   pathParamsType: PluginReactQuery['resolvedOptions']['pathParamsType']
+  customOptions: PluginReactQuery['resolvedOptions']['customOptions']
 }
 
 type GetParamsProps = {
@@ -78,6 +79,7 @@ export function Mutation({
   typeSchemas,
   operation,
   mutationKeyName,
+  customOptions,
 }: Props): KubbNode {
   const mutationKeyParams = MutationKey.getParams({
     pathParamsType,
@@ -140,9 +142,10 @@ export function Mutation({
         const mutationKey = mutationOptions.mutationKey ?? ${mutationKeyName}(${mutationKeyParams.toCall()})
 
         const baseOptions = ${mutationOptions} as UseMutationOptions<${generics}>
+        ${customOptions ? `const customOptions = ${customOptions.name}({ hookName: '${name}', operationId: '${operation.getOperationId()}' }) as UseMutationOptions<${generics}>` : ''}
 
         return useMutation<${generics}>({
-          ...baseOptions,
+          ...baseOptions,${customOptions ? '\n...customOptions,' : ''}
           mutationKey,
           ...mutationOptions,
         }, queryClient) as ${returnType}

package/src/components/MutationOptions.tsx

@@ -95,10 +95,10 @@ export function MutationOptions({ name, clientName, dataReturnType, typeSchemas,
 
   return (
     <File.Source name={name} isExportable isIndexable>
-      <Function name={name} export params={params.toConstructor()}>
+      <Function name={name} export params={params.toConstructor()} generics={['TContext = unknown']}>
         {`
       const mutationKey = ${mutationKeyName}(${mutationKeyParams.toCall()})
-      return mutationOptions<${TData}, ResponseErrorConfig<${TError}>, ${TRequest ? `{${TRequest}}` : 'void'}, typeof mutationKey>({
+      return mutationOptions<${TData}, ResponseErrorConfig<${TError}>, ${TRequest ? `{${TRequest}}` : 'void'}, TContext>({
         mutationKey,
         mutationFn: async(${dataParams.toConstructor()}) => {
           return ${clientName}(${clientParams.toCall()})

package/src/components/Query.tsx

@@ -21,6 +21,7 @@ type Props = {
   paramsType: PluginReactQuery['resolvedOptions']['paramsType']
   pathParamsType: PluginReactQuery['resolvedOptions']['pathParamsType']
   dataReturnType: PluginReactQuery['resolvedOptions']['client']['dataReturnType']
+  customOptions: PluginReactQuery['resolvedOptions']['customOptions']
 }
 
 type GetParamsProps = {
@@ -122,6 +123,7 @@ export function Query({
   dataReturnType,
   typeSchemas,
   operation,
+  customOptions,
 }: Props): KubbNode {
   const TData = dataReturnType === 'data' ? typeSchemas.response.name : `ResponseConfig<${typeSchemas.response.name}>`
   const TError = `ResponseErrorConfig<${typeSchemas.errors?.map((item) => item.name).join(' | ') || 'Error'}>`
@@ -164,9 +166,10 @@ export function Query({
        const { query: queryConfig = {}, client: config = {} } = options ?? {}
        const { client: queryClient, ...queryOptions } = queryConfig
        const queryKey = queryOptions?.queryKey ?? ${queryKeyName}(${queryKeyParams.toCall()})
+       ${customOptions ? `const customOptions = ${customOptions.name}({ hookName: '${name}', operationId: '${operation.getOperationId()}' })` : ''}
 
        const query = useQuery({
-        ...${queryOptions},
+        ...${queryOptions},${customOptions ? '\n...customOptions,' : ''}
         queryKey,
         ...queryOptions
        } as unknown as QueryObserverOptions, queryClient) as ${returnType}

package/src/components/SuspenseInfiniteQuery.tsx

@@ -21,6 +21,7 @@ type Props = {
   paramsType: PluginReactQuery['resolvedOptions']['paramsType']
   pathParamsType: PluginReactQuery['resolvedOptions']['pathParamsType']
   dataReturnType: PluginReactQuery['resolvedOptions']['client']['dataReturnType']
+  customOptions: PluginReactQuery['resolvedOptions']['customOptions']
   initialPageParam: Infinite['initialPageParam']
   queryParam?: Infinite['queryParam']
 }
@@ -127,6 +128,7 @@ export function SuspenseInfiniteQuery({
   dataReturnType,
   typeSchemas,
   operation,
+  customOptions,
   initialPageParam,
   queryParam,
 }: Props): KubbNode {
@@ -193,9 +195,10 @@ export function SuspenseInfiniteQuery({
        const { query: queryConfig = {}, client: config = {} } = options ?? {}
        const { client: queryClient, ...queryOptions } = queryConfig
        const queryKey = queryOptions?.queryKey ?? ${queryKeyName}(${queryKeyParams.toCall()})
+       ${customOptions ? `const customOptions = ${customOptions.name}({ hookName: '${name}', operationId: '${operation.getOperationId()}' })` : ''}
 
        const query = useSuspenseInfiniteQuery({
-        ...${queryOptions},
+        ...${queryOptions},${customOptions ? '\n...customOptions,' : ''}
         queryKey,
         ...queryOptions
        } as unknown as UseSuspenseInfiniteQueryOptions<TQueryFnData, TError, TData, TQueryKey, TPageParam>, queryClient) as ${returnType}

package/src/components/SuspenseQuery.tsx

@@ -21,6 +21,7 @@ type Props = {
   paramsType: PluginReactQuery['resolvedOptions']['paramsType']
   pathParamsType: PluginReactQuery['resolvedOptions']['pathParamsType']
   dataReturnType: PluginReactQuery['resolvedOptions']['client']['dataReturnType']
+  customOptions: PluginReactQuery['resolvedOptions']['customOptions']
 }
 
 type GetParamsProps = {
@@ -129,6 +130,7 @@ export function SuspenseQuery({
   dataReturnType,
   typeSchemas,
   operation,
+  customOptions,
 }: Props): KubbNode {
   const TData = dataReturnType === 'data' ? typeSchemas.response.name : `ResponseConfig<${typeSchemas.response.name}>`
   const TError = `ResponseErrorConfig<${typeSchemas.errors?.map((item) => item.name).join(' | ') || 'Error'}>`
@@ -171,9 +173,10 @@ export function SuspenseQuery({
        const { query: queryConfig = {}, client: config = {} } = options ?? {}
        const { client: queryClient, ...queryOptions } = queryConfig
        const queryKey = queryOptions?.queryKey ?? ${queryKeyName}(${queryKeyParams.toCall()})
+       ${customOptions ? `const customOptions = ${customOptions.name}({ hookName: '${name}', operationId: '${operation.getOperationId()}' })` : ''}
 
        const query = useSuspenseQuery({
-        ...${queryOptions},
+        ...${queryOptions},${customOptions ? '\n...customOptions,' : ''}
         queryKey,
         ...queryOptions
        } as unknown as UseSuspenseQueryOptions, queryClient) as ${returnType}

package/src/generators/__snapshots__/clientPostImportPath.ts

@@ -35,13 +35,15 @@ export async function updatePetWithForm(
   return updatePetWithFormMutationResponse.parse(res.data)
 }
 
-export function updatePetWithFormMutationOptions(config: Partial<RequestConfig<UpdatePetWithFormMutationRequest>> & { client?: typeof fetch } = {}) {
+export function updatePetWithFormMutationOptions<TContext = unknown>(
+  config: Partial<RequestConfig<UpdatePetWithFormMutationRequest>> & { client?: typeof fetch } = {},
+) {
   const mutationKey = updatePetWithFormMutationKey()
   return mutationOptions<
     UpdatePetWithFormMutationResponse,
     ResponseErrorConfig<UpdatePetWithForm405>,
     { petId: UpdatePetWithFormPathParams['petId']; data?: UpdatePetWithFormMutationRequest; params?: UpdatePetWithFormQueryParams },
-    typeof mutationKey
+    TContext
   >({
     mutationKey,
     mutationFn: async ({ petId, data, params }) => {