@kubb/plugin-vue-query 5.2.0-canary.20261007T095624 → 5.2.1

package/dist/index.d.ts

@@ -13,8 +13,8 @@ import "@kubb/plugin-zod";
  *
  * - `contract` — a registered contract client plugin owns the `<op>` functions and the consumer
  *   imports and calls them.
- * - `error` — no client plugin is registered, several are registered without a selector, or the
- *   requested one is missing.
+ * - `error` — no client plugin is registered, several are registered without a selector, the
+ *   requested one is missing, or `client` is not a known selector.
  *
  * The `client` string selects explicitly (`'fetch'` / `'axios'`); when it is unset a lone registered
  * contract client plugin is picked up automatically.
@@ -36,9 +36,19 @@ type ResolvedContractClient = {
 //#endregion
 //#region ../../internals/tanstack-query/src/types.d.ts
 type ParamsCasing = 'camelcase' | undefined;
+/**
+ * The hook a key is built for. Plain and suspense queries can share a key, but an infinite query
+ * caches `InfiniteData` and must never share one with a plain query.
+ */
+type KeyVariant = 'query' | 'suspenseQuery' | 'infiniteQuery' | 'suspenseInfiniteQuery' | 'mutation';
+/**
+ * Builds query or mutation key segments for an operation node.
+ * Receives `variant` indicating which hook or composable the key is built for.
+ */
 type Transformer = (props: {
   node: ast.OperationNode;
   casing: ParamsCasing;
+  variant: KeyVariant;
 }) => Array<unknown>;
 /**
  * Configures the query side of a TanStack-family plugin: which HTTP methods produce query
@@ -187,7 +197,8 @@ type ResolverVueQuery = Resolver & {
   };
 };
 /**
- * Builds the `queryKey` used by each generated query composable.
+ * Builds the `queryKey` used by each generated query composable. `variant` tells which composable
+ * the key is for, so infinite keys can stay apart from plain ones.
  *
  * @note String values are inlined verbatim into generated code. Wrap literal
  * strings in `JSON.stringify(...)`.
@@ -259,8 +270,8 @@ type Options = OutputOptions & {
    */
   resolver?: ResolverPatch<ResolverVueQuery>;
   /**
-   * Set to `false` to skip generating `use*` composable functions. `queryOptions`,
-   * `queryKey`, and `mutationKey` helpers are still emitted.
+   * Set to `true` to also generate `use*` composable functions. By default only the
+   * `queryOptions`, `queryKey`, and `mutationKey` helpers are emitted.
    *
    * @default false
    */

package/dist/index.js

@@ -646,7 +646,8 @@ function MutationKey({ name, node, transformer }) {
 	const paramsSignature = declarationPrinter$6.print(paramsNode) ?? "";
 	const keys = (transformer ?? mutationKeyTransformer)({
 		node,
-		casing: "camelcase"
+		casing: "camelcase",
+		variant: "mutation"
 	});
 	return /* @__PURE__ */ jsx(File.Source, {
 		name,
@@ -715,16 +716,17 @@ function createMutationResolver() {
 	};
 }
 functionPrinter({ mode: "declaration" });
-const queryKeyTransformer = ({ node }) => {
+const queryKeyTransformer = ({ node, variant }) => {
 	if (!node.path) return [];
-	const hasPathParams = getOperationParameters(node).path.length > 0;
-	const hasQueryParams = getOperationParameters(node).query.length > 0;
-	const hasRequestBody = !!node.requestBody?.content?.[0]?.schema;
-	return [
-		hasPathParams ? `{ url: '${Url.toPath(node.path)}', params: path }` : `{ url: '${Url.toPath(node.path)}' }`,
-		hasQueryParams ? "...(query ? [query] : [])" : null,
-		hasRequestBody ? "...(body ? [body] : [])" : null
-	].filter(Boolean);
+	const { path, query } = getOperationParameters(node);
+	const isInfinite = variant === "infiniteQuery" || variant === "suspenseInfiniteQuery";
+	const urlFields = [`url: '${Url.toPath(node.path)}'`];
+	if (path.length > 0) urlFields.push("params: path");
+	if (isInfinite) urlFields.push("infinite: true");
+	const result = [`{ ${urlFields.join(", ")} }`];
+	if (query.length > 0) result.push("...(query ? [query] : [])");
+	if (node.requestBody?.content?.[0]?.schema) result.push("...(body ? [body] : [])");
+	return result;
 };
 //#endregion
 //#region ../../internals/client/src/resolveClient.ts
@@ -737,8 +739,8 @@ const queryKeyTransformer = ({ node }) => {
 *
 * - `contract` — a registered contract client plugin owns the `<op>` functions and the consumer
 *   imports and calls them.
-* - `error` — no client plugin is registered, several are registered without a selector, or the
-*   requested one is missing.
+* - `error` — no client plugin is registered, several are registered without a selector, the
+*   requested one is missing, or `client` is not a known selector.
 *
 * The `client` string selects explicitly (`'fetch'` / `'axios'`); when it is unset a lone registered
 * contract client plugin is picked up automatically.
@@ -779,6 +781,10 @@ function resolveClient(options) {
 			pluginName
 		};
 	}
+	if (client !== void 0) return {
+		kind: "error",
+		message: `Option \`client\` is ${typeof client === "string" ? `'${client}'` : String(client)}, but it must be one of 'fetch', 'axios'. Drop \`client\` to use the registered client plugin.`
+	};
 	const registered = contractPlugins.filter(has);
 	if (registered.length === 1) return {
 		kind: "contract",
@@ -880,12 +886,13 @@ function buildQueryKeyParamsNode(node, options) {
 	});
 	return createFunctionParameters({ params: groupedParam ? [groupedParam] : [] });
 }
-function QueryKey({ name, node, tsResolver, typeName, transformer }) {
+function QueryKey({ name, node, tsResolver, typeName, transformer, variant = "query" }) {
 	const paramsNode = buildQueryKeyParamsNode(node, { resolver: tsResolver });
 	const paramsSignature = declarationPrinter$4.print(paramsNode) ?? "";
 	const keys = (transformer ?? queryKeyTransformer)({
 		node,
-		casing: "camelcase"
+		casing: "camelcase",
+		variant
 	});
 	return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(File.Source, {
 		name,
@@ -1189,8 +1196,7 @@ const infiniteQueryGenerator = defineGenerator({
 		if (!ast.isHttpOperationNode(node)) return null;
 		const { config, driver, resolver, root } = ctx;
 		const { output, query, mutation, infinite, client, group, hooks } = ctx.options;
-		const pluginTs = driver.getPlugin(pluginTsName);
-		if (!pluginTs) return null;
+		const pluginTs = ctx.requirePlugin(pluginTsName);
 		const tsResolver = driver.getResolver(pluginTsName);
 		const { isQuery, isMutation } = classifyOperation(node, {
 			query,
@@ -1298,7 +1304,8 @@ const infiniteQueryGenerator = defineGenerator({
 					typeName: queryKeyTypeName,
 					node,
 					tsResolver,
-					transformer: ctx.options.queryKey
+					transformer: ctx.options.queryKey,
+					variant: "infiniteQuery"
 				}),
 				/* @__PURE__ */ jsx(File.Import, {
 					name: ["InfiniteData"],
@@ -1364,8 +1371,7 @@ const mutationGenerator = defineGenerator({
 		if (!ast.isHttpOperationNode(node)) return null;
 		const { config, driver, resolver, root } = ctx;
 		const { output, query, mutation, client, group, hooks } = ctx.options;
-		const pluginTs = driver.getPlugin(pluginTsName);
-		if (!pluginTs) return null;
+		const pluginTs = ctx.requirePlugin(pluginTsName);
 		const tsResolver = driver.getResolver(pluginTsName);
 		const { isMutation } = classifyOperation(node, {
 			query,
@@ -1498,8 +1504,7 @@ const queryGenerator = defineGenerator({
 		if (!ast.isHttpOperationNode(node)) return null;
 		const { config, driver, resolver, root } = ctx;
 		const { output, query, mutation, client, group, hooks } = ctx.options;
-		const pluginTs = driver.getPlugin(pluginTsName);
-		if (!pluginTs) return null;
+		const pluginTs = ctx.requirePlugin(pluginTsName);
 		const tsResolver = driver.getResolver(pluginTsName);
 		const { isQuery, isMutation } = classifyOperation(node, {
 			query,
@@ -1594,7 +1599,8 @@ const queryGenerator = defineGenerator({
 					typeName: queryKeyTypeName,
 					node,
 					tsResolver,
-					transformer: ctx.options.queryKey
+					transformer: ctx.options.queryKey,
+					variant: "query"
 				}),
 				/* @__PURE__ */ jsx(File.Import, {
 					name: ["queryOptions"],
@@ -1714,6 +1720,7 @@ const pluginVueQuery = definePlugin((options) => {
 		options,
 		dependencies: [pluginTsName],
 		hooks: { "kubb:plugin:setup"(ctx) {
+			ctx.requirePlugin(pluginTsName);
 			const resolver = userResolver ? Resolver.merge(resolverVueQuery, userResolver) : resolverVueQuery;
 			ctx.setOptions({
 				output,