@kubb/plugin-react-query 5.0.0-beta.103 → 5.0.0-beta.105

package/dist/index.cjs

@@ -70,6 +70,26 @@ function operationFileEntry(node, name, extname = ".ts") {
 		path: node.path
 	};
 }
+/**
+* Resolves a dependency plugin's generated file for `node.operationId`, cached in `cache` (the
+* current node's `ctx.cache`) under the resolver's own plugin name. Several dependents reading the
+* same dependency for the same operation in one pass (a query plugin's several hook generators, the
+* MCP handler, ...) share one computed name and path instead of each calling `resolver.file` again.
+*
+* @example Cache `plugin-ts`'s file for the current operation
+* ```ts
+* const fileTs = resolveDependencyOperationFile({ cache: ctx.cache, node, resolver: tsResolver, root, output })
+* ```
+*/
+function resolveDependencyOperationFile(options) {
+	const { cache, node, resolver, root, output, group } = options;
+	return cache.getOrSet(`${resolver.pluginName}:operationFile`, () => resolver.file({
+		...operationFileEntry(node, node.operationId),
+		root,
+		output,
+		group: group ?? void 0
+	}));
+}
 function getOperationLink(node, link) {
 	if (!link) return null;
 	if (typeof link === "function") return link(node) ?? null;
@@ -163,13 +183,24 @@ function buildOperationComments(node, options = {}) {
 	if (!splitLines) return filteredComments;
 	return filteredComments.flatMap((text) => text.split(/\r?\n/).map((line) => line.trim())).filter((comment) => Boolean(comment));
 }
+const operationParameterGroupsByNode = /* @__PURE__ */ new WeakMap();
+/**
+* Groups an operation's parameters by location (`path`/`query`/`header`/`cookie`), deduping each
+* group by name. Every plugin generator visiting the same `OperationNode` shares one AST instance
+* (see `KubbDriver`), so the result is cached per node to avoid re-filtering and re-deduping the
+* same parameters once per plugin.
+*/
 function getOperationParameters(node) {
-	return {
+	const cached = operationParameterGroupsByNode.get(node);
+	if (cached) return cached;
+	const groups = {
 		path: dedupeParams(node.parameters.filter((param) => param.in === "path")),
 		query: dedupeParams(node.parameters.filter((param) => param.in === "query")),
 		header: dedupeParams(node.parameters.filter((param) => param.in === "header")),
 		cookie: dedupeParams(node.parameters.filter((param) => param.in === "cookie"))
 	};
+	operationParameterGroupsByNode.set(node, groups);
+	return groups;
 }
 function getStatusCodeNumber(statusCode) {
 	const code = Number(statusCode);
@@ -407,23 +438,30 @@ function resolveContractClient(options) {
 * (plugin-fetch or plugin-axios). Returns `null` when no contract plugin is in play (the inline
 * path). The plugin injects `.kubb/client.ts` at the global output root, the same path consumers
 * read `RequestConfig` / `ResponseErrorConfig` from.
+*
+* The result is cached in the current node's `cache` (`ctx.cache`) under the client plugin's name,
+* so several dependents reading the same client plugin for one operation in a single pass
+* (react-query's query/mutation/infinite generators, vue-query, swr, the MCP handler, ...) share
+* one computed result instead of each re-deriving the name and path.
 */
 function resolveClientOperation(options) {
-	const { clientPlugin, driver, node, root, output } = options;
+	const { clientPlugin, driver, node, root, output, cache } = options;
 	if (!clientPlugin) return null;
-	const resolver = driver.getResolver(clientPlugin.pluginName);
-	const plugin = driver.getPlugin(clientPlugin.pluginName);
-	const file = resolver.file({
-		...operationFileEntry(node, node.operationId),
-		root,
-		output: plugin?.options?.output ?? output,
-		group: plugin?.options?.group ?? void 0
+	return cache.getOrSet(`${clientPlugin.pluginName}:clientOperation`, () => {
+		const resolver = driver.getResolver(clientPlugin.pluginName);
+		const plugin = driver.getPlugin(clientPlugin.pluginName);
+		const file = resolver.file({
+			...operationFileEntry(node, node.operationId),
+			root,
+			output: plugin?.options?.output ?? output,
+			group: plugin?.options?.group ?? void 0
+		});
+		return {
+			name: resolver.name(node.operationId),
+			path: file.path,
+			clientPath: node_path.default.resolve(root, ".kubb/client.ts")
+		};
 	});
-	return {
-		name: resolver.name(node.operationId),
-		path: file.path,
-		clientPath: node_path.default.resolve(root, ".kubb/client.ts")
-	};
 }
 //#endregion
 //#region ../../internals/tanstack-query/src/utils.ts
@@ -1448,29 +1486,36 @@ function QueryOptions({ name, clientName, node, tsResolver, queryKeyName }) {
 const infiniteQueryGenerator = (0, kubb_kit.defineGenerator)({
 	name: "react-infinite-query",
 	renderer: kubb_jsx.jsxRenderer,
+	match(node, ctx) {
+		const operationNode = node;
+		if (!kubb_kit.ast.isHttpOperationNode(operationNode)) return false;
+		const { query, mutation, infinite, hooks } = ctx.options;
+		const { isQuery, isMutation } = classifyOperation(operationNode, {
+			query,
+			mutation
+		});
+		const infiniteOptions = infinite && typeof infinite === "object" ? infinite : null;
+		if (!isQuery || isMutation || !infiniteOptions || !hooks) return false;
+		const queryParamKeys = getOperationParameters(operationNode).query.map((p) => p.name);
+		return infiniteOptions.queryParam ? queryParamKeys.includes(infiniteOptions.queryParam) || queryParamKeys.includes(`${infiniteOptions.queryParam}?`) : false;
+	},
 	operation(node, ctx) {
 		if (!kubb_kit.ast.isHttpOperationNode(node)) return null;
 		const { config, driver, resolver, root } = ctx;
-		const { output, query, mutation, infinite, client, group, customOptions, hooks } = ctx.options;
+		const { output, query, infinite, client, group, customOptions } = ctx.options;
 		const pluginTs = driver.getPlugin(_kubb_plugin_ts.pluginTsName);
 		if (!pluginTs) return null;
 		const tsResolver = driver.getResolver(_kubb_plugin_ts.pluginTsName);
-		const { isQuery, isMutation } = classifyOperation(node, {
-			query,
-			mutation
-		});
 		const infiniteOptions = infinite && typeof infinite === "object" ? infinite : null;
-		if (!isQuery || isMutation || !infiniteOptions || !hooks) return null;
-		const normalizeKey = (key) => key.replace(/\?$/, "");
-		const queryParamKeys = getOperationParameters(node).query.map((p) => p.name);
-		if (!(infiniteOptions.queryParam ? queryParamKeys.some((k) => normalizeKey(k) === infiniteOptions.queryParam) : false)) return null;
+		if (!infiniteOptions) return null;
 		const importPath = query ? query.importPath : "@tanstack/react-query";
 		const contractOp = resolveClientOperation({
 			clientPlugin: { pluginName: client.pluginName },
 			driver,
 			node,
 			root,
-			output
+			output,
+			cache: ctx.cache
 		});
 		if (!contractOp) return null;
 		const queryName = resolver.infiniteQuery.name(node);
@@ -1484,11 +1529,13 @@ const infiniteQueryGenerator = (0, kubb_kit.defineGenerator)({
 				output,
 				group: group ?? void 0
 			}),
-			fileTs: tsResolver.file({
-				...operationFileEntry(node, node.operationId),
+			fileTs: resolveDependencyOperationFile({
+				cache: ctx.cache,
+				node,
+				resolver: tsResolver,
 				root,
 				output: pluginTs.options?.output ?? output,
-				group: pluginTs.options?.group ?? void 0
+				group: pluginTs.options?.group
 			})
 		};
 		const { queryParamsTypeName } = resolvePageParamType(node, {
@@ -1615,25 +1662,30 @@ const infiniteQueryGenerator = (0, kubb_kit.defineGenerator)({
 const mutationGenerator = (0, kubb_kit.defineGenerator)({
 	name: "react-query-mutation",
 	renderer: kubb_jsx.jsxRenderer,
+	match(node, ctx) {
+		const operationNode = node;
+		if (!kubb_kit.ast.isHttpOperationNode(operationNode)) return false;
+		const { query, mutation } = ctx.options;
+		return classifyOperation(operationNode, {
+			query,
+			mutation
+		}).isMutation;
+	},
 	operation(node, ctx) {
 		if (!kubb_kit.ast.isHttpOperationNode(node)) return null;
 		const { config, driver, resolver, root } = ctx;
-		const { output, query, mutation, client, group, customOptions, hooks } = ctx.options;
+		const { output, mutation, client, group, customOptions, hooks } = ctx.options;
 		const pluginTs = driver.getPlugin(_kubb_plugin_ts.pluginTsName);
 		if (!pluginTs) return null;
 		const tsResolver = driver.getResolver(_kubb_plugin_ts.pluginTsName);
-		const { isMutation } = classifyOperation(node, {
-			query,
-			mutation
-		});
-		if (!isMutation) return null;
 		const importPath = mutation ? mutation.importPath : "@tanstack/react-query";
 		const contractOp = resolveClientOperation({
 			clientPlugin: { pluginName: client.pluginName },
 			driver,
 			node,
 			root,
-			output
+			output,
+			cache: ctx.cache
 		});
 		if (!contractOp) return null;
 		const mutationHookName = resolver.mutation.name(node);
@@ -1647,11 +1699,13 @@ const mutationGenerator = (0, kubb_kit.defineGenerator)({
 				output,
 				group: group ?? void 0
 			}),
-			fileTs: tsResolver.file({
-				...operationFileEntry(node, node.operationId),
+			fileTs: resolveDependencyOperationFile({
+				cache: ctx.cache,
+				node,
+				resolver: tsResolver,
 				root,
 				output: pluginTs.options?.output ?? output,
-				group: pluginTs.options?.group ?? void 0
+				group: pluginTs.options?.group
 			})
 		};
 		const importedTypeNames = [tsResolver.response.options(node), ...resolveOperationTypeNames(node, tsResolver, {
@@ -1755,25 +1809,31 @@ const mutationGenerator = (0, kubb_kit.defineGenerator)({
 const queryGenerator = (0, kubb_kit.defineGenerator)({
 	name: "react-query",
 	renderer: kubb_jsx.jsxRenderer,
+	match(node, ctx) {
+		const operationNode = node;
+		if (!kubb_kit.ast.isHttpOperationNode(operationNode)) return false;
+		const { query, mutation } = ctx.options;
+		const { isQuery, isMutation } = classifyOperation(operationNode, {
+			query,
+			mutation
+		});
+		return isQuery && !isMutation;
+	},
 	operation(node, ctx) {
 		if (!kubb_kit.ast.isHttpOperationNode(node)) return null;
 		const { config, driver, resolver, root } = ctx;
-		const { output, query, mutation, client, group, customOptions, hooks } = ctx.options;
+		const { output, query, client, group, customOptions, hooks } = ctx.options;
 		const pluginTs = driver.getPlugin(_kubb_plugin_ts.pluginTsName);
 		if (!pluginTs) return null;
 		const tsResolver = driver.getResolver(_kubb_plugin_ts.pluginTsName);
-		const { isQuery, isMutation } = classifyOperation(node, {
-			query,
-			mutation
-		});
-		if (!isQuery || isMutation) return null;
 		const importPath = query ? query.importPath : "@tanstack/react-query";
 		const contractOp = resolveClientOperation({
 			clientPlugin: { pluginName: client.pluginName },
 			driver,
 			node,
 			root,
-			output
+			output,
+			cache: ctx.cache
 		});
 		if (!contractOp) return null;
 		const queryName = resolver.query.name(node);
@@ -1787,11 +1847,13 @@ const queryGenerator = (0, kubb_kit.defineGenerator)({
 				output,
 				group: group ?? void 0
 			}),
-			fileTs: tsResolver.file({
-				...operationFileEntry(node, node.operationId),
+			fileTs: resolveDependencyOperationFile({
+				cache: ctx.cache,
+				node,
+				resolver: tsResolver,
 				root,
 				output: pluginTs.options?.output ?? output,
-				group: pluginTs.options?.group ?? void 0
+				group: pluginTs.options?.group
 			})
 		};
 		const importedTypeNames = [tsResolver.response.options(node), ...resolveOperationTypeNames(node, tsResolver, {
@@ -1900,30 +1962,36 @@ const queryGenerator = (0, kubb_kit.defineGenerator)({
 const suspenseInfiniteQueryGenerator = (0, kubb_kit.defineGenerator)({
 	name: "react-suspense-infinite-query",
 	renderer: kubb_jsx.jsxRenderer,
+	match(node, ctx) {
+		const operationNode = node;
+		if (!kubb_kit.ast.isHttpOperationNode(operationNode)) return false;
+		const { query, mutation, infinite, suspense, hooks } = ctx.options;
+		const { isQuery, isMutation } = classifyOperation(operationNode, {
+			query,
+			mutation
+		});
+		const infiniteOptions = infinite && typeof infinite === "object" ? infinite : null;
+		if (!isQuery || isMutation || !suspense || !infiniteOptions || !hooks) return false;
+		const queryParamKeys = getOperationParameters(operationNode).query.map((p) => p.name);
+		return infiniteOptions.queryParam ? queryParamKeys.includes(infiniteOptions.queryParam) || queryParamKeys.includes(`${infiniteOptions.queryParam}?`) : false;
+	},
 	operation(node, ctx) {
 		if (!kubb_kit.ast.isHttpOperationNode(node)) return null;
 		const { config, driver, resolver, root } = ctx;
-		const { output, query, mutation, infinite, suspense, client, group, customOptions, hooks } = ctx.options;
+		const { output, query, infinite, client, group, customOptions } = ctx.options;
 		const pluginTs = driver.getPlugin(_kubb_plugin_ts.pluginTsName);
 		if (!pluginTs) return null;
 		const tsResolver = driver.getResolver(_kubb_plugin_ts.pluginTsName);
-		const { isQuery, isMutation } = classifyOperation(node, {
-			query,
-			mutation
-		});
-		const isSuspense = !!suspense;
 		const infiniteOptions = infinite && typeof infinite === "object" ? infinite : null;
-		if (!isQuery || isMutation || !isSuspense || !infiniteOptions || !hooks) return null;
-		const normalizeKey = (key) => key.replace(/\?$/, "");
-		const queryParamKeys = getOperationParameters(node).query.map((p) => p.name);
-		if (!(infiniteOptions.queryParam ? queryParamKeys.some((k) => normalizeKey(k) === infiniteOptions.queryParam) : false)) return null;
+		if (!infiniteOptions) return null;
 		const importPath = query ? query.importPath : "@tanstack/react-query";
 		const contractOp = resolveClientOperation({
 			clientPlugin: { pluginName: client.pluginName },
 			driver,
 			node,
 			root,
-			output
+			output,
+			cache: ctx.cache
 		});
 		if (!contractOp) return null;
 		const queryName = resolver.suspenseInfiniteQuery.name(node);
@@ -1937,11 +2005,13 @@ const suspenseInfiniteQueryGenerator = (0, kubb_kit.defineGenerator)({
 				output,
 				group: group ?? void 0
 			}),
-			fileTs: tsResolver.file({
-				...operationFileEntry(node, node.operationId),
+			fileTs: resolveDependencyOperationFile({
+				cache: ctx.cache,
+				node,
+				resolver: tsResolver,
 				root,
 				output: pluginTs.options?.output ?? output,
-				group: pluginTs.options?.group ?? void 0
+				group: pluginTs.options?.group
 			})
 		};
 		const rawQueryParams = getOperationParameters(node).query;
@@ -2067,25 +2137,31 @@ const suspenseInfiniteQueryGenerator = (0, kubb_kit.defineGenerator)({
 const suspenseQueryGenerator = (0, kubb_kit.defineGenerator)({
 	name: "react-suspense-query",
 	renderer: kubb_jsx.jsxRenderer,
+	match(node, ctx) {
+		const operationNode = node;
+		if (!kubb_kit.ast.isHttpOperationNode(operationNode)) return false;
+		const { query, mutation, suspense, hooks } = ctx.options;
+		const { isQuery, isMutation } = classifyOperation(operationNode, {
+			query,
+			mutation
+		});
+		return isQuery && !isMutation && !!suspense && hooks;
+	},
 	operation(node, ctx) {
 		if (!kubb_kit.ast.isHttpOperationNode(node)) return null;
 		const { config, driver, resolver, root } = ctx;
-		const { output, query, mutation, suspense, client, group, customOptions, hooks } = ctx.options;
+		const { output, query, client, group, customOptions } = ctx.options;
 		const pluginTs = driver.getPlugin(_kubb_plugin_ts.pluginTsName);
 		if (!pluginTs) return null;
 		const tsResolver = driver.getResolver(_kubb_plugin_ts.pluginTsName);
-		const { isQuery, isMutation } = classifyOperation(node, {
-			query,
-			mutation
-		});
-		if (!isQuery || isMutation || !!!suspense || !hooks) return null;
 		const importPath = query ? query.importPath : "@tanstack/react-query";
 		const contractOp = resolveClientOperation({
 			clientPlugin: { pluginName: client.pluginName },
 			driver,
 			node,
 			root,
-			output
+			output,
+			cache: ctx.cache
 		});
 		if (!contractOp) return null;
 		const queryName = resolver.suspenseQuery.name(node);
@@ -2099,11 +2175,13 @@ const suspenseQueryGenerator = (0, kubb_kit.defineGenerator)({
 				output,
 				group: group ?? void 0
 			}),
-			fileTs: tsResolver.file({
-				...operationFileEntry(node, node.operationId),
+			fileTs: resolveDependencyOperationFile({
+				cache: ctx.cache,
+				node,
+				resolver: tsResolver,
 				root,
 				output: pluginTs.options?.output ?? output,
-				group: pluginTs.options?.group ?? void 0
+				group: pluginTs.options?.group
 			})
 		};
 		const importedTypeNames = [tsResolver.response.options(node), ...resolveOperationTypeNames(node, tsResolver, {