@kubb/plugin-react-query 5.0.0-beta.22 → 5.0.0-beta.25

package/dist/{generators-BZ_sX2lp.js → generators-9srJC_zb.js}

@@ -1,5 +1,5 @@
 import "./chunk--u3MIqq1.js";
-import { a as Mutation, c as InfiniteQuery, f as resolveOperationOverrides, g as MutationKey, h as resolveOperationTypeNames, i as Query, l as QueryOptions, m as getOperationParameters, n as SuspenseInfiniteQueryOptions, o as MutationOptions, p as resolveZodSchemaNames, r as SuspenseInfiniteQuery, s as InfiniteQueryOptions, t as SuspenseQuery, u as QueryKey } from "./components-BTwB9V-K.js";
+import { a as Mutation, c as InfiniteQuery, f as resolveOperationOverrides, g as MutationKey, h as resolveOperationTypeNames, i as Query, l as QueryOptions, m as getOperationParameters, n as SuspenseInfiniteQueryOptions, o as MutationOptions, p as resolveZodSchemaNames, r as SuspenseInfiniteQuery, s as InfiniteQueryOptions, t as SuspenseQuery, u as QueryKey } from "./components-C91DnOOV.js";
 import path from "node:path";
 import { defineGenerator } from "@kubb/core";
 import { Client, pluginClientName } from "@kubb/plugin-client";
@@ -10,6 +10,12 @@ import { Fragment, jsx, jsxs } from "@kubb/renderer-jsx/jsx-runtime";
 import fs from "node:fs";
 import { difference } from "remeda";
 //#region src/generators/customHookOptionsFileGenerator.tsx
+/**
+* Scaffolds the user-editable `useCustomHookOptions` file when
+* `pluginReactQuery({ customOptions: { ... } })` is configured. The file is
+* only created when it does not already exist, so user edits persist across
+* regeneration.
+*/
 const customHookOptionsFileGenerator = defineGenerator({
 	name: "react-query-custom-hook-options-file",
 	renderer: jsxRendererSync,
@@ -34,7 +40,7 @@ const customHookOptionsFileGenerator = defineGenerator({
 			}, {
 				root,
 				output,
-				group
+				group: group ?? void 0
 			}).path;
 		} else hookFilePath = path.resolve(root, "index.ts");
 		const ensureExtension = (filePath, extname) => {
@@ -101,6 +107,12 @@ const customHookOptionsFileGenerator = defineGenerator({
 });
 //#endregion
 //#region src/generators/hookOptionsGenerator.tsx
+/**
+* Emits the `HookOptions` type used by `customOptions`. Enabled when
+* `pluginReactQuery({ customOptions: { ... } })`. The generated type lists
+* every hook keyed by name so user-supplied options stay in sync with the
+* generated hooks at compile time.
+*/
 const hookOptionsGenerator = defineGenerator({
 	name: "react-query-hook-options",
 	renderer: jsxRendererSync,
@@ -115,7 +127,7 @@ const hookOptionsGenerator = defineGenerator({
 		}, {
 			root,
 			output,
-			group
+			group: group ?? void 0
 		});
 		const hookOptionsFile = {
 			...resolvedFile,
@@ -129,7 +141,7 @@ const hookOptionsGenerator = defineGenerator({
 			const nodeQuery = "query" in opOverrides ? opOverrides.query : query;
 			const nodeMutation = "mutation" in opOverrides ? opOverrides.mutation : mutation;
 			const nodeInfinite = "infinite" in opOverrides ? opOverrides.infinite : infinite;
-			const nodeInfiniteOptions = nodeInfinite && typeof nodeInfinite === "object" ? nodeInfinite : void 0;
+			const nodeInfiniteOptions = nodeInfinite && typeof nodeInfinite === "object" ? nodeInfinite : null;
 			const isQueryOp = nodeQuery === false ? !!query && query.methods.some((m) => node.method.toLowerCase() === m.toLowerCase()) : !!nodeQuery && nodeQuery.methods.some((m) => node.method.toLowerCase() === m.toLowerCase());
 			const isMutationOp = nodeMutation !== false && !isQueryOp && difference(nodeMutation ? nodeMutation.methods : [], nodeQuery ? nodeQuery.methods : []).some((m) => node.method.toLowerCase() === m.toLowerCase());
 			const isSuspenseOp = !!suspense;
@@ -145,7 +157,7 @@ const hookOptionsGenerator = defineGenerator({
 				}, {
 					root,
 					output,
-					group
+					group: group ?? void 0
 				});
 				imports.push(/* @__PURE__ */ jsx(File.Import, {
 					name: [queryOptionsName],
@@ -164,7 +176,7 @@ const hookOptionsGenerator = defineGenerator({
 					}, {
 						root,
 						output,
-						group
+						group: group ?? void 0
 					});
 					imports.push(/* @__PURE__ */ jsx(File.Import, {
 						name: [suspenseOptionsName],
@@ -187,7 +199,7 @@ const hookOptionsGenerator = defineGenerator({
 						}, {
 							root,
 							output,
-							group
+							group: group ?? void 0
 						});
 						imports.push(/* @__PURE__ */ jsx(File.Import, {
 							name: [infiniteOptionsName],
@@ -206,7 +218,7 @@ const hookOptionsGenerator = defineGenerator({
 							}, {
 								root,
 								output,
-								group
+								group: group ?? void 0
 							});
 							imports.push(/* @__PURE__ */ jsx(File.Import, {
 								name: [suspenseInfiniteOptionsName],
@@ -229,7 +241,7 @@ const hookOptionsGenerator = defineGenerator({
 				}, {
 					root,
 					output,
-					group
+					group: group ?? void 0
 				});
 				imports.push(/* @__PURE__ */ jsx(File.Import, {
 					name: [mutationOptionsName],
@@ -267,6 +279,12 @@ const hookOptionsGenerator = defineGenerator({
 });
 //#endregion
 //#region src/generators/infiniteQueryGenerator.tsx
+/**
+* Built-in generator for `useInfiniteQuery` hooks. Enabled when
+* `pluginReactQuery({ infinite: { ... } })`. Emits one `useFooInfiniteQuery`
+* hook per query operation, wiring the configured `nextParam` /
+* `previousParam` paths into TanStack Query's cursor-based pagination.
+*/
 const infiniteQueryGenerator = defineGenerator({
 	name: "react-infinite-query",
 	renderer: jsxRendererSync,
@@ -278,7 +296,7 @@ const infiniteQueryGenerator = defineGenerator({
 		const tsResolver = driver.getResolver(pluginTsName);
 		const isQuery = query === false || !!query && query.methods.some((method) => node.method.toLowerCase() === method.toLowerCase());
 		const isMutation = mutation !== false && !isQuery && difference(mutation ? mutation.methods : [], query ? query.methods : []).some((method) => node.method.toLowerCase() === method.toLowerCase());
-		const infiniteOptions = infinite && typeof infinite === "object" ? infinite : void 0;
+		const infiniteOptions = infinite && typeof infinite === "object" ? infinite : null;
 		if (!isQuery || isMutation || !infiniteOptions) return null;
 		const normalizeKey = (key) => key.replace(/\?$/, "");
 		const queryParamKeys = getOperationParameters(node).query.map((p) => p.name);
@@ -300,7 +318,7 @@ const infiniteQueryGenerator = defineGenerator({
 			}, {
 				root,
 				output,
-				group
+				group: group ?? void 0
 			}),
 			fileTs: tsResolver.resolveFile({
 				name: node.operationId,
@@ -310,7 +328,7 @@ const infiniteQueryGenerator = defineGenerator({
 			}, {
 				root,
 				output: pluginTs.options?.output ?? output,
-				group: pluginTs.options?.group
+				group: pluginTs.options?.group ?? void 0
 			})
 		};
 		const importedTypeNames = resolveOperationTypeNames(node, tsResolver, {
@@ -318,8 +336,8 @@ const infiniteQueryGenerator = defineGenerator({
 			exclude: [queryKeyTypeName],
 			order: "body-response-first"
 		});
-		const pluginZod = parser === "zod" ? driver.getPlugin(pluginZodName) : void 0;
-		const zodResolver = pluginZod ? driver.getResolver(pluginZodName) : void 0;
+		const pluginZod = parser === "zod" ? driver.getPlugin(pluginZodName) : null;
+		const zodResolver = pluginZod ? driver.getResolver(pluginZodName) : null;
 		const fileZod = zodResolver ? zodResolver.resolveFile({
 			name: node.operationId,
 			extname: ".ts",
@@ -328,12 +346,12 @@ const infiniteQueryGenerator = defineGenerator({
 		}, {
 			root,
 			output: pluginZod?.options?.output ?? output,
-			group: pluginZod?.options?.group
-		}) : void 0;
+			group: pluginZod?.options?.group ?? void 0
+		}) : null;
 		const zodSchemaNames = resolveZodSchemaNames(node, zodResolver);
 		const clientPlugin = driver.getPlugin(pluginClientName);
 		const shouldUseClientPlugin = clientPlugin?.name === pluginClientName && clientOptions.clientType !== "class";
-		const clientResolver = shouldUseClientPlugin ? driver.getResolver(pluginClientName) : void 0;
+		const clientResolver = shouldUseClientPlugin ? driver.getResolver(pluginClientName) : null;
 		const clientFile = shouldUseClientPlugin ? clientResolver?.resolveFile({
 			name: node.operationId,
 			extname: ".ts",
@@ -342,8 +360,8 @@ const infiniteQueryGenerator = defineGenerator({
 		}, {
 			root,
 			output: clientPlugin?.options?.output ?? output,
-			group: clientPlugin?.options?.group
-		}) : void 0;
+			group: clientPlugin?.options?.group ?? void 0
+		}) : null;
 		const resolvedClientName = shouldUseClientPlugin ? clientResolver?.resolveName(node.operationId) ?? clientBaseName : clientBaseName;
 		return /* @__PURE__ */ jsxs(File, {
 			baseName: meta.file.baseName,
@@ -506,6 +524,11 @@ const infiniteQueryGenerator = defineGenerator({
 });
 //#endregion
 //#region src/generators/mutationGenerator.tsx
+/**
+* Built-in generator for `useMutation` hooks. Emits one `useFooMutation` hook
+* per POST/PUT/DELETE operation (configurable via `mutation.methods`) plus
+* the matching `fooMutationKey` / `fooMutationOptions` helpers.
+*/
 const mutationGenerator = defineGenerator({
 	name: "react-query-mutation",
 	renderer: jsxRendererSync,
@@ -532,7 +555,7 @@ const mutationGenerator = defineGenerator({
 			}, {
 				root,
 				output,
-				group
+				group: group ?? void 0
 			}),
 			fileTs: tsResolver.resolveFile({
 				name: node.operationId,
@@ -542,15 +565,15 @@ const mutationGenerator = defineGenerator({
 			}, {
 				root,
 				output: pluginTs.options?.output ?? output,
-				group: pluginTs.options?.group
+				group: pluginTs.options?.group ?? void 0
 			})
 		};
 		const importedTypeNames = resolveOperationTypeNames(node, tsResolver, {
 			paramsCasing,
 			order: "body-response-first"
 		});
-		const pluginZod = parser === "zod" ? driver.getPlugin(pluginZodName) : void 0;
-		const zodResolver = pluginZod ? driver.getResolver(pluginZodName) : void 0;
+		const pluginZod = parser === "zod" ? driver.getPlugin(pluginZodName) : null;
+		const zodResolver = pluginZod ? driver.getResolver(pluginZodName) : null;
 		const fileZod = zodResolver ? zodResolver.resolveFile({
 			name: node.operationId,
 			extname: ".ts",
@@ -559,12 +582,12 @@ const mutationGenerator = defineGenerator({
 		}, {
 			root,
 			output: pluginZod?.options?.output ?? output,
-			group: pluginZod?.options?.group
-		}) : void 0;
+			group: pluginZod?.options?.group ?? void 0
+		}) : null;
 		const zodSchemaNames = resolveZodSchemaNames(node, zodResolver);
 		const clientPlugin = driver.getPlugin(pluginClientName);
 		const shouldUseClientPlugin = clientPlugin?.name === pluginClientName && clientOptions.clientType !== "class";
-		const clientResolver = shouldUseClientPlugin ? driver.getResolver(pluginClientName) : void 0;
+		const clientResolver = shouldUseClientPlugin ? driver.getResolver(pluginClientName) : null;
 		const clientFile = shouldUseClientPlugin ? clientResolver?.resolveFile({
 			name: node.operationId,
 			extname: ".ts",
@@ -573,8 +596,8 @@ const mutationGenerator = defineGenerator({
 		}, {
 			root,
 			output: clientPlugin?.options?.output ?? output,
-			group: clientPlugin?.options?.group
-		}) : void 0;
+			group: clientPlugin?.options?.group ?? void 0
+		}) : null;
 		const resolvedClientName = shouldUseClientPlugin ? clientResolver?.resolveName(node.operationId) ?? clientName : clientName;
 		return /* @__PURE__ */ jsxs(File, {
 			baseName: meta.file.baseName,
@@ -723,6 +746,11 @@ const mutationGenerator = defineGenerator({
 });
 //#endregion
 //#region src/generators/queryGenerator.tsx
+/**
+* Built-in generator for `useQuery` hooks. Emits one `useFooQuery` hook per
+* GET operation (configurable via `query.methods`) plus the matching
+* `fooQueryKey` / `fooQueryOptions` helpers.
+*/
 const queryGenerator = defineGenerator({
 	name: "react-query",
 	renderer: jsxRendererSync,
@@ -750,7 +778,7 @@ const queryGenerator = defineGenerator({
 			}, {
 				root,
 				output,
-				group
+				group: group ?? void 0
 			}),
 			fileTs: tsResolver.resolveFile({
 				name: node.operationId,
@@ -760,7 +788,7 @@ const queryGenerator = defineGenerator({
 			}, {
 				root,
 				output: pluginTs.options?.output ?? output,
-				group: pluginTs.options?.group
+				group: pluginTs.options?.group ?? void 0
 			})
 		};
 		const importedTypeNames = resolveOperationTypeNames(node, tsResolver, {
@@ -768,8 +796,8 @@ const queryGenerator = defineGenerator({
 			exclude: [queryKeyTypeName],
 			order: "body-response-first"
 		});
-		const pluginZod = parser === "zod" ? driver.getPlugin(pluginZodName) : void 0;
-		const zodResolver = pluginZod ? driver.getResolver(pluginZodName) : void 0;
+		const pluginZod = parser === "zod" ? driver.getPlugin(pluginZodName) : null;
+		const zodResolver = pluginZod ? driver.getResolver(pluginZodName) : null;
 		const fileZod = zodResolver ? zodResolver.resolveFile({
 			name: node.operationId,
 			extname: ".ts",
@@ -778,12 +806,12 @@ const queryGenerator = defineGenerator({
 		}, {
 			root,
 			output: pluginZod?.options?.output ?? output,
-			group: pluginZod?.options?.group
-		}) : void 0;
+			group: pluginZod?.options?.group ?? void 0
+		}) : null;
 		const zodSchemaNames = resolveZodSchemaNames(node, zodResolver);
 		const clientPlugin = driver.getPlugin(pluginClientName);
 		const shouldUseClientPlugin = clientPlugin?.name === pluginClientName && clientOptions.clientType !== "class";
-		const clientResolver = shouldUseClientPlugin ? driver.getResolver(pluginClientName) : void 0;
+		const clientResolver = shouldUseClientPlugin ? driver.getResolver(pluginClientName) : null;
 		const clientFile = shouldUseClientPlugin ? clientResolver?.resolveFile({
 			name: node.operationId,
 			extname: ".ts",
@@ -792,8 +820,8 @@ const queryGenerator = defineGenerator({
 		}, {
 			root,
 			output: clientPlugin?.options?.output ?? output,
-			group: clientPlugin?.options?.group
-		}) : void 0;
+			group: clientPlugin?.options?.group ?? void 0
+		}) : null;
 		const resolvedClientName = shouldUseClientPlugin ? clientResolver?.resolveName(node.operationId) ?? clientName : clientName;
 		return /* @__PURE__ */ jsxs(File, {
 			baseName: meta.file.baseName,
@@ -946,6 +974,12 @@ const queryGenerator = defineGenerator({
 });
 //#endregion
 //#region src/generators/suspenseInfiniteQueryGenerator.tsx
+/**
+* Built-in generator for `useSuspenseInfiniteQuery` hooks. Enabled when both
+* `suspense` and `infinite` are configured. Combines suspense semantics with
+* cursor-based pagination — handlers throw promises while loading and pull
+* additional pages on demand.
+*/
 const suspenseInfiniteQueryGenerator = defineGenerator({
 	name: "react-suspense-infinite-query",
 	renderer: jsxRendererSync,
@@ -958,7 +992,7 @@ const suspenseInfiniteQueryGenerator = defineGenerator({
 		const isQuery = query === false || !!query && query.methods.some((method) => node.method.toLowerCase() === method.toLowerCase());
 		const isMutation = mutation !== false && !isQuery && difference(mutation ? mutation.methods : [], query ? query.methods : []).some((method) => node.method.toLowerCase() === method.toLowerCase());
 		const isSuspense = !!suspense;
-		const infiniteOptions = infinite && typeof infinite === "object" ? infinite : void 0;
+		const infiniteOptions = infinite && typeof infinite === "object" ? infinite : null;
 		if (!isQuery || isMutation || !isSuspense || !infiniteOptions) return null;
 		const normalizeKey = (key) => key.replace(/\?$/, "");
 		const queryParamKeys = getOperationParameters(node).query.map((p) => p.name);
@@ -980,7 +1014,7 @@ const suspenseInfiniteQueryGenerator = defineGenerator({
 			}, {
 				root,
 				output,
-				group
+				group: group ?? void 0
 			}),
 			fileTs: tsResolver.resolveFile({
 				name: node.operationId,
@@ -990,15 +1024,15 @@ const suspenseInfiniteQueryGenerator = defineGenerator({
 			}, {
 				root,
 				output: pluginTs.options?.output ?? output,
-				group: pluginTs.options?.group
+				group: pluginTs.options?.group ?? void 0
 			})
 		};
 		const importedTypeNames = resolveOperationTypeNames(node, tsResolver, {
 			paramsCasing,
 			order: "body-response-first"
 		});
-		const pluginZod = parser === "zod" ? driver.getPlugin(pluginZodName) : void 0;
-		const zodResolver = pluginZod ? driver.getResolver(pluginZodName) : void 0;
+		const pluginZod = parser === "zod" ? driver.getPlugin(pluginZodName) : null;
+		const zodResolver = pluginZod ? driver.getResolver(pluginZodName) : null;
 		const fileZod = zodResolver ? zodResolver.resolveFile({
 			name: node.operationId,
 			extname: ".ts",
@@ -1007,12 +1041,12 @@ const suspenseInfiniteQueryGenerator = defineGenerator({
 		}, {
 			root,
 			output: pluginZod?.options?.output ?? output,
-			group: pluginZod?.options?.group
-		}) : void 0;
+			group: pluginZod?.options?.group ?? void 0
+		}) : null;
 		const zodSchemaNames = resolveZodSchemaNames(node, zodResolver);
 		const clientPlugin = driver.getPlugin(pluginClientName);
 		const shouldUseClientPlugin = clientPlugin?.name === pluginClientName && clientOptions.clientType !== "class";
-		const clientResolver = shouldUseClientPlugin ? driver.getResolver(pluginClientName) : void 0;
+		const clientResolver = shouldUseClientPlugin ? driver.getResolver(pluginClientName) : null;
 		const clientFile = shouldUseClientPlugin ? clientResolver?.resolveFile({
 			name: node.operationId,
 			extname: ".ts",
@@ -1021,8 +1055,8 @@ const suspenseInfiniteQueryGenerator = defineGenerator({
 		}, {
 			root,
 			output: clientPlugin?.options?.output ?? output,
-			group: clientPlugin?.options?.group
-		}) : void 0;
+			group: clientPlugin?.options?.group ?? void 0
+		}) : null;
 		const resolvedClientName = shouldUseClientPlugin ? clientResolver?.resolveName(node.operationId) ?? clientBaseName : clientBaseName;
 		return /* @__PURE__ */ jsxs(File, {
 			baseName: meta.file.baseName,
@@ -1185,6 +1219,12 @@ const suspenseInfiniteQueryGenerator = defineGenerator({
 });
 //#endregion
 //#region src/generators/suspenseQueryGenerator.tsx
+/**
+* Built-in generator for `useSuspenseQuery` hooks. Enabled when
+* `pluginReactQuery({ suspense: {} })`. Emits one `useFooSuspenseQuery` hook
+* per query operation. Suspense queries throw promises while loading and
+* require a `<Suspense>` boundary in the React tree. TanStack Query v5+ only.
+*/
 const suspenseQueryGenerator = defineGenerator({
 	name: "react-suspense-query",
 	renderer: jsxRendererSync,
@@ -1212,7 +1252,7 @@ const suspenseQueryGenerator = defineGenerator({
 			}, {
 				root,
 				output,
-				group
+				group: group ?? void 0
 			}),
 			fileTs: tsResolver.resolveFile({
 				name: node.operationId,
@@ -1222,7 +1262,7 @@ const suspenseQueryGenerator = defineGenerator({
 			}, {
 				root,
 				output: pluginTs.options?.output ?? output,
-				group: pluginTs.options?.group
+				group: pluginTs.options?.group ?? void 0
 			})
 		};
 		const importedTypeNames = resolveOperationTypeNames(node, tsResolver, {
@@ -1230,8 +1270,8 @@ const suspenseQueryGenerator = defineGenerator({
 			exclude: [queryKeyTypeName],
 			order: "body-response-first"
 		});
-		const pluginZod = parser === "zod" ? driver.getPlugin(pluginZodName) : void 0;
-		const zodResolver = pluginZod ? driver.getResolver(pluginZodName) : void 0;
+		const pluginZod = parser === "zod" ? driver.getPlugin(pluginZodName) : null;
+		const zodResolver = pluginZod ? driver.getResolver(pluginZodName) : null;
 		const fileZod = zodResolver ? zodResolver.resolveFile({
 			name: node.operationId,
 			extname: ".ts",
@@ -1240,12 +1280,12 @@ const suspenseQueryGenerator = defineGenerator({
 		}, {
 			root,
 			output: pluginZod?.options?.output ?? output,
-			group: pluginZod?.options?.group
-		}) : void 0;
+			group: pluginZod?.options?.group ?? void 0
+		}) : null;
 		const zodSchemaNames = resolveZodSchemaNames(node, zodResolver);
 		const clientPlugin = driver.getPlugin(pluginClientName);
 		const shouldUseClientPlugin = clientPlugin?.name === pluginClientName && clientOptions.clientType !== "class";
-		const clientResolver = shouldUseClientPlugin ? driver.getResolver(pluginClientName) : void 0;
+		const clientResolver = shouldUseClientPlugin ? driver.getResolver(pluginClientName) : null;
 		const clientFile = shouldUseClientPlugin ? clientResolver?.resolveFile({
 			name: node.operationId,
 			extname: ".ts",
@@ -1254,8 +1294,8 @@ const suspenseQueryGenerator = defineGenerator({
 		}, {
 			root,
 			output: clientPlugin?.options?.output ?? output,
-			group: clientPlugin?.options?.group
-		}) : void 0;
+			group: clientPlugin?.options?.group ?? void 0
+		}) : null;
 		const resolvedClientName = shouldUseClientPlugin ? clientResolver?.resolveName(node.operationId) ?? clientName : clientName;
 		return /* @__PURE__ */ jsxs(File, {
 			baseName: meta.file.baseName,
@@ -1409,4 +1449,4 @@ const suspenseQueryGenerator = defineGenerator({
 //#endregion
 export { infiniteQueryGenerator as a, mutationGenerator as i, suspenseInfiniteQueryGenerator as n, hookOptionsGenerator as o, queryGenerator as r, customHookOptionsFileGenerator as s, suspenseQueryGenerator as t };
 
-//# sourceMappingURL=generators-BZ_sX2lp.js.map
+//# sourceMappingURL=generators-9srJC_zb.js.map