@kubb/plugin-react-query 5.8.0-canary.20261027T072349 → 5.8.0-canary.20261027T172409

package/dist/index.cjs

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-//#region \0rolldown/runtime.js
+// \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -23,7 +23,6 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	value: mod,
 	enumerable: true
 }) : target, mod));
-//#endregion
 let kubb_kit = require("kubb/kit");
 let node_path = require("node:path");
 node_path = __toESM(node_path, 1);
@@ -33,7 +32,7 @@ let _kubb_plugin_ts = require("@kubb/plugin-ts");
 let kubb_jsx_jsx_runtime = require("kubb/jsx/jsx-runtime");
 let node_fs = require("node:fs");
 node_fs = __toESM(node_fs, 1);
-//#region ../../internals/shared/src/operation.ts
+// ../../internals/shared/src/operation.ts
 /**
 * Builds the `ResolverFileParams` every operation generator passes to
 * `resolver.file`: a file named `name`, tagged by the operation's first
@@ -289,8 +288,7 @@ function resolveOperationTypeNames(node, resolver, options = {}) {
 	byResolver.set(cacheKey, result);
 	return result;
 }
-//#endregion
-//#region ../../internals/utils/src/casing.ts
+// ../../internals/utils/src/casing.ts
 /**
 * Shared implementation for camelCase and PascalCase conversion.
 * Splits on common word boundaries (spaces, hyphens, underscores, dots, slashes, colons)
@@ -337,8 +335,7 @@ function camelCase(text, { prefix = "", suffix = "" } = {}) {
 function capitalize(text) {
 	return `${text.charAt(0).toUpperCase()}${text.slice(1)}`;
 }
-//#endregion
-//#region ../../internals/utils/src/reserved.ts
+// ../../internals/utils/src/reserved.ts
 /**
 * JavaScript and Java reserved words.
 * @link https://github.com/jonschlinkert/reserved/blob/master/index.js
@@ -477,8 +474,7 @@ function ensureValidVarName(name) {
 function isIdentifier(name) {
 	return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name);
 }
-//#endregion
-//#region ../../internals/utils/src/strings.ts
+// ../../internals/utils/src/strings.ts
 /**
 * Renders a dotted path or string array as an optional-chaining accessor expression rooted at
 * `accessor`. Returns `null` for an empty path.
@@ -494,13 +490,29 @@ function getNestedAccessor(param, accessor) {
 	if (parts.length === 0 || parts.length === 1 && parts[0] === "") return null;
 	return `${accessor}?.['${`${parts.join("']?.['")}']`}`;
 }
-//#endregion
-//#region ../../internals/shared/src/resolver.ts
+// ../../internals/shared/src/resolver.ts
 function resolveOperationName(name) {
 	return ensureValidVarName(camelCase(name));
 }
-//#endregion
-//#region ../../internals/shared/src/group.ts
+/**
+* Builds the allocation key for a declaration an operation owns. `scope` names which declaration
+* it is, so two of them never share an allocation even when a custom resolver gives both the same
+* name. Leave `scope` empty for the operation's own declaration.
+*
+* @example
+* ```ts
+* resolver.resolveName({ key: operationKey(node, 'response', 'status', 404), name })
+* ```
+*/
+function operationKey(node, ...scope) {
+	return [
+		"operation",
+		node.method,
+		node.path,
+		...scope.map(String)
+	];
+}
+// ../../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:
@@ -530,17 +542,14 @@ function createGroupConfig(group) {
 		name: group.name ? group.name : defaultName
 	};
 }
-//#endregion
-//#region kubb-extension.json
+// kubb-extension.json
 var compatibility = {
-	"kubb": ">=5.8.3",
+	"kubb": ">=5.14.6",
 	"node": ">=22.22"
 };
-//#endregion
-//#region package.json
-var version = "5.8.0-canary.20261027T072349";
-//#endregion
-//#region ../../internals/client/src/resolveOperationTypes.ts
+// package.json
+var version = "5.8.0-canary.20261027T172409";
+// ../../internals/client/src/resolveOperationTypes.ts
 /**
 * A `plugin-ts` shaped resolver whose operation type names point at the types `pluginZod({ inferred })`
 * exports next to each schema, so code written against `plugin-ts` names picks up the zod types.
@@ -606,8 +615,7 @@ function resolveOperationTypes(driver, pluginName) {
 		group: pluginZod.options.group ?? void 0
 	};
 }
-//#endregion
-//#region ../../internals/client/src/resolveClient.ts
+// ../../internals/client/src/resolveClient.ts
 /**
 * Resolves which client plugin a consumer (react-query, vue-query, swr, mcp) should call for an
 * operation, shared so the selection rules and diagnostics stay in one place.
@@ -717,8 +725,7 @@ function resolveContractClient(options) {
 	}
 	return resolved;
 }
-//#endregion
-//#region ../../internals/client/src/resolveClientOperation.ts
+// ../../internals/client/src/resolveClientOperation.ts
 function isRelativeImport(importPath) {
 	return importPath.startsWith(".");
 }
@@ -765,8 +772,12 @@ function resolveClientOperation(options) {
 			group: operationOptions.group ?? void 0
 		});
 		const { importPath } = operationOptions;
+		const name = resolver.name(node.operationId);
 		return {
-			name: resolver.name(node.operationId),
+			name: resolver.resolveName({
+				key: operationKey(node),
+				name
+			}),
 			path: file.path,
 			clientPath: importPath === void 0 ? node_path.default.resolve(root, ".kubb/client.ts") : resolveImportPath({
 				importPath,
@@ -777,8 +788,7 @@ function resolveClientOperation(options) {
 		};
 	});
 }
-//#endregion
-//#region ../../internals/tanstack-query/src/components/HookFile.tsx
+// ../../internals/tanstack-query/src/components/HookFile.tsx
 /**
 * Resolves what every TanStack hook file shares: its file, the operation types file and names (`@kubb/plugin-ts`, or
 * `pluginZod({ inferred: 'codec' })`), banner and footer.
@@ -867,8 +877,7 @@ function HookFile({ hook, imports, children }) {
 		]
 	});
 }
-//#endregion
-//#region ../../internals/tanstack-query/src/utils.ts
+// ../../internals/tanstack-query/src/utils.ts
 /**
 * The grouped request options, ordered for both the destructured signature and the
 * call passed to the underlying client.
@@ -1234,8 +1243,7 @@ function buildResolvedRequestParams(node) {
 	if (names.length === 0) return null;
 	return `{ ${names.map((name) => `${name}: typeof ${name} === 'function' ? ${name}() : ${name}`).join(", ")} }`;
 }
-//#endregion
-//#region ../../internals/tanstack-query/src/components/InfiniteQueryOptions.tsx
+// ../../internals/tanstack-query/src/components/InfiniteQueryOptions.tsx
 const declarationPrinter$6 = (0, _kubb_plugin_ts.functionPrinter)({ mode: "declaration" });
 const callPrinter$3 = (0, _kubb_plugin_ts.functionPrinter)({ mode: "call" });
 function InfiniteQueryOptions({ name, clientName, initialPageParam, hasExplicitInitialPageParam, cursorParam, nextParam, previousParam, getNextPageParam, getPreviousPageParam, node, tsResolver, queryParam, queryKeyName, queryKeyType = "typeof queryKey", memberTypeWrapper, unwrapName, returnType = "full" }) {
@@ -1311,8 +1319,7 @@ return infiniteQueryOptions<${queryFnDataType}, ${errorType}, InfiniteData<${que
 		})
 	});
 }
-//#endregion
-//#region ../../internals/tanstack-query/src/components/MutationKey.tsx
+// ../../internals/tanstack-query/src/components/MutationKey.tsx
 const declarationPrinter$5 = (0, _kubb_plugin_ts.functionPrinter)({ mode: "declaration" });
 /**
 * Default `mutationKey` builder. Call it from a custom builder to extend the default key.
@@ -1359,8 +1366,7 @@ function MutationKey({ name, node, transformer, typeName }) {
 		})
 	})] });
 }
-//#endregion
-//#region ../../internals/tanstack-query/src/resolver.ts
+// ../../internals/tanstack-query/src/resolver.ts
 /**
 * Builds the shared query namespace for a variant. Spread the result into
 * `createResolver` once per variant the plugin supports.
@@ -1376,19 +1382,39 @@ function MutationKey({ name, node, transformer, typeName }) {
 function createQueryResolver(variant = "") {
 	return {
 		name(node) {
-			return `use${capitalize(this.name(node.operationId))}${variant}`;
+			const name = `use${capitalize(this.name(node.operationId))}${variant}`;
+			return this.resolveName({
+				key: operationKey(node, "query", variant, "name"),
+				name
+			});
 		},
 		optionsName(node) {
-			return `${this.name(node.operationId)}${variant}QueryOptions`;
+			const name = `${this.name(node.operationId)}${variant}QueryOptions`;
+			return this.resolveName({
+				key: operationKey(node, "query", variant, "optionsName"),
+				name
+			});
 		},
 		keyName(node) {
-			return `${this.name(node.operationId)}${variant}QueryKey`;
+			const name = `${this.name(node.operationId)}${variant}QueryKey`;
+			return this.resolveName({
+				key: operationKey(node, "query", variant, "keyName"),
+				name
+			});
 		},
 		keyTypeName(node) {
-			return `${capitalize(this.name(node.operationId))}${variant}QueryKey`;
+			const name = `${capitalize(this.name(node.operationId))}${variant}QueryKey`;
+			return this.resolveName({
+				key: operationKey(node, "query", variant, "keyTypeName"),
+				name
+			});
 		},
 		clientName(node) {
-			return `${this.name(node.operationId)}${variant}`;
+			const name = `${this.name(node.operationId)}${variant}`;
+			return this.resolveName({
+				key: operationKey(node, "query", variant, "clientName"),
+				name
+			});
 		}
 	};
 }
@@ -1405,15 +1431,22 @@ function createQueryResolver(variant = "") {
 function createMutationResolver() {
 	return {
 		name(node) {
-			return `use${capitalize(this.name(node.operationId))}`;
+			const name = `use${capitalize(this.name(node.operationId))}`;
+			return this.resolveName({
+				key: operationKey(node, "mutation", "name"),
+				name
+			});
 		},
 		keyName(node) {
-			return `${this.name(node.operationId)}MutationKey`;
+			const name = `${this.name(node.operationId)}MutationKey`;
+			return this.resolveName({
+				key: operationKey(node, "mutation", "keyName"),
+				name
+			});
 		}
 	};
 }
-//#endregion
-//#region ../../internals/tanstack-query/src/components/QueryKey.tsx
+// ../../internals/tanstack-query/src/components/QueryKey.tsx
 const declarationPrinter$4 = (0, _kubb_plugin_ts.functionPrinter)({ mode: "declaration" });
 /**
 * Default `queryKey` builder. Call it from a custom builder to extend the default key.
@@ -1471,8 +1504,7 @@ function QueryKey({ name, node, tsResolver, typeName, transformer, variant = "qu
 		})
 	})] });
 }
-//#endregion
-//#region src/generators/customHookOptionsFileGenerator.tsx
+// src/generators/customHookOptionsFileGenerator.tsx
 /**
 * Scaffolds the user-editable `useCustomHookOptions` file when
 * `pluginReactQuery({ customOptions: { ... }, hooks: true })` is configured. The file is
@@ -1569,8 +1601,7 @@ const customHookOptionsFileGenerator = (0, kubb_kit.defineGenerator)({
 		});
 	}
 });
-//#endregion
-//#region src/generators/hookOptionsGenerator.tsx
+// src/generators/hookOptionsGenerator.tsx
 /**
 * Emits the `HookOptions` type used by `customOptions`. Enabled when
 * `pluginReactQuery({ customOptions: { ... } })`. The generated type lists
@@ -1729,8 +1760,7 @@ const hookOptionsGenerator = (0, kubb_kit.defineGenerator)({
 		});
 	}
 });
-//#endregion
-//#region src/components/Query.tsx
+// src/components/Query.tsx
 const declarationPrinter$3 = (0, _kubb_plugin_ts.functionPrinter)({ mode: "declaration" });
 const OBSERVER_OPTIONS_NAMES = {
 	infinite: {
@@ -1840,8 +1870,7 @@ function Query({ name, queryKeyTypeName, queryOptionsName, queryKeyName, node, t
 		})
 	});
 }
-//#endregion
-//#region src/components/QueryOptions.tsx
+// src/components/QueryOptions.tsx
 const declarationPrinter$2 = (0, _kubb_plugin_ts.functionPrinter)({ mode: "declaration" });
 const callPrinter$2 = (0, _kubb_plugin_ts.functionPrinter)({ mode: "call" });
 function QueryOptions({ name, clientName, node, tsResolver, queryKeyName, returnType = "full" }) {
@@ -1874,8 +1903,7 @@ function QueryOptions({ name, clientName, node, tsResolver, queryKeyName, return
 		})
 	});
 }
-//#endregion
-//#region src/generators/createQueryGenerator.tsx
+// src/generators/createQueryGenerator.tsx
 const OBSERVER_IMPORTS = {
 	query: ["QueryObserverOptions", "UseQueryResult"],
 	suspenseQuery: ["UseSuspenseQueryOptions", "UseSuspenseQueryResult"],
@@ -2034,8 +2062,7 @@ function createQueryGenerator({ name, variant }) {
 		}
 	});
 }
-//#endregion
-//#region src/generators/infiniteQueryGenerator.tsx
+// src/generators/infiniteQueryGenerator.tsx
 /**
 * Built-in generator for `useInfiniteQuery` hooks. Enabled when
 * `pluginReactQuery({ infinite: { ... }, hooks: true })`. Emits one
@@ -2047,8 +2074,7 @@ const infiniteQueryGenerator = createQueryGenerator({
 	name: "react-infinite-query",
 	variant: "infiniteQuery"
 });
-//#endregion
-//#region src/components/MutationOptions.tsx
+// src/components/MutationOptions.tsx
 const declarationPrinter$1 = (0, _kubb_plugin_ts.functionPrinter)({ mode: "declaration" });
 const callPrinter$1 = (0, _kubb_plugin_ts.functionPrinter)({ mode: "call" });
 function buildMutationConfigParamsNode(node) {
@@ -2097,8 +2123,7 @@ function MutationOptions({ name, clientName, node, tsResolver, mutationKeyName,
 		})
 	});
 }
-//#endregion
-//#region src/components/Mutation.tsx
+// src/components/Mutation.tsx
 const declarationPrinter = (0, _kubb_plugin_ts.functionPrinter)({ mode: "declaration" });
 const callPrinter = (0, _kubb_plugin_ts.functionPrinter)({ mode: "call" });
 function buildMutationParamsNode(node, options) {
@@ -2157,8 +2182,7 @@ function Mutation({ name, mutationOptionsName, node, tsResolver, mutationKeyName
 		})
 	});
 }
-//#endregion
-//#region src/generators/mutationGenerator.tsx
+// src/generators/mutationGenerator.tsx
 /**
 * Built-in generator for `useMutation` hooks. Emits one `useFooMutation` hook
 * per POST/PUT/DELETE operation (configurable via `mutation.methods`) plus
@@ -2251,8 +2275,7 @@ const mutationGenerator = (0, kubb_kit.defineGenerator)({
 		});
 	}
 });
-//#endregion
-//#region src/generators/queryGenerator.tsx
+// src/generators/queryGenerator.tsx
 /**
 * Built-in generator for `useQuery` hooks. Emits one `useFooQuery` hook per
 * GET and QUERY operation (configurable via `query.methods`) plus the matching
@@ -2262,8 +2285,7 @@ const queryGenerator = createQueryGenerator({
 	name: "react-query",
 	variant: "query"
 });
-//#endregion
-//#region src/generators/suspenseInfiniteQueryGenerator.tsx
+// src/generators/suspenseInfiniteQueryGenerator.tsx
 /**
 * Built-in generator for `useSuspenseInfiniteQuery` hooks. Enabled when
 * `suspense`, `infinite`, and `hooks` are all configured. Combines suspense
@@ -2274,8 +2296,7 @@ const suspenseInfiniteQueryGenerator = createQueryGenerator({
 	name: "react-suspense-infinite-query",
 	variant: "suspenseInfiniteQuery"
 });
-//#endregion
-//#region src/generators/suspenseQueryGenerator.tsx
+// src/generators/suspenseQueryGenerator.tsx
 /**
 * Built-in generator for `useSuspenseQuery` hooks. Enabled when
 * `pluginReactQuery({ suspense: {}, hooks: true })`. Emits one
@@ -2287,8 +2308,7 @@ const suspenseQueryGenerator = createQueryGenerator({
 	name: "react-suspense-query",
 	variant: "suspenseQuery"
 });
-//#endregion
-//#region src/resolvers/resolverReactQuery.ts
+// src/resolvers/resolverReactQuery.ts
 /**
 * Default resolver used by `@kubb/plugin-react-query`. Decides the names and
 * file paths for every generated TanStack Query hook (`useFoo`,
@@ -2318,23 +2338,36 @@ const resolverReactQuery = (0, kubb_kit.createResolver)({
 	mutation: {
 		...createMutationResolver(),
 		optionsName(node) {
-			return `${this.name(node.operationId)}MutationOptions`;
+			const name = `${this.name(node.operationId)}MutationOptions`;
+			return this.resolveName({
+				key: operationKey(node, "mutation", "optionsName"),
+				name
+			});
 		},
 		typeName(node) {
-			return capitalize(this.name(node.operationId));
+			const name = capitalize(this.name(node.operationId));
+			return this.resolveName({
+				key: operationKey(node, "mutation", "typeName"),
+				name
+			});
 		}
 	},
 	hook: {
 		optionsName() {
-			return "HookOptions";
+			return this.resolveName({
+				key: ["hook", "options"],
+				name: "HookOptions"
+			});
 		},
 		customOptionsName() {
-			return "getCustomHookOptions";
+			return this.resolveName({
+				key: ["hook", "custom-options"],
+				name: "getCustomHookOptions"
+			});
 		}
 	}
 });
-//#endregion
-//#region src/plugin.ts
+// src/plugin.ts
 /**
 * Canonical plugin name for `@kubb/plugin-react-query`. Used for driver lookups
 * and cross-plugin dependency references.
@@ -2408,7 +2441,6 @@ const pluginReactQuery = (0, kubb_kit.defineExtension)({
 		};
 	}
 });
-//#endregion
 exports.default = pluginReactQuery;
 exports.definePageParam = definePageParam;
 exports.mutationKeyTransformer = mutationKeyTransformer;