@kubb/plugin-swr 5.0.0-beta.94 → 5.0.0-beta.98

package/dist/index.cjs

@@ -28,10 +28,10 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-let kubb_kit = require("kubb/kit");
-let _kubb_plugin_ts = require("@kubb/plugin-ts");
 let node_path = require("node:path");
 node_path = __toESM(node_path, 1);
+let kubb_kit = require("kubb/kit");
+let _kubb_plugin_ts = require("@kubb/plugin-ts");
 let kubb_jsx = require("kubb/jsx");
 let kubb_jsx_jsx_runtime = require("kubb/jsx/jsx-runtime");
 //#region ../../internals/utils/src/casing.ts
@@ -60,6 +60,16 @@ function toCamelOrPascal(text, pascal) {
 function camelCase(text, { prefix = "", suffix = "" } = {}) {
 	return toCamelOrPascal(`${prefix} ${text} ${suffix}`, false);
 }
+/**
+* Uppercases only the first character of `text`, leaving the rest untouched.
+* Unlike {@link pascalCase} it never re-splits word boundaries or strips characters.
+*
+* @example
+* `capitalize('getPetById') // 'GetPetById'`
+*/
+function capitalize(text) {
+	return `${text.charAt(0).toUpperCase()}${text.slice(1)}`;
+}
 //#endregion
 //#region ../../internals/utils/src/reserved.ts
 /**
@@ -609,6 +619,20 @@ function resolveClient(options) {
 		message: "No client plugin is registered. Add `@kubb/plugin-axios` or `@kubb/plugin-fetch` to `plugins` so the generated code has an HTTP client to call."
 	};
 }
+/**
+* Resolves the contract client during a consumer plugin's setup hook. Extracts the plugin names
+* from the raw `plugins` config, applies {@link resolveClient}, and throws the diagnostic on a
+* misconfiguration so every consumer fails fast with the same message.
+*/
+function resolveContractClient(options) {
+	const { client, plugins = [] } = options;
+	const resolved = resolveClient({
+		client,
+		pluginNames: plugins.map((plugin) => plugin.name).filter((name) => Boolean(name))
+	});
+	if (resolved.kind === "error") throw new Error(resolved.message);
+	return resolved;
+}
 //#endregion
 //#region ../../internals/client/src/resolveClientOperation.ts
 /**
@@ -636,34 +660,6 @@ function resolveClientOperation(options) {
 	};
 }
 //#endregion
-//#region ../../internals/tanstack-query/src/components/MutationKey.tsx
-const declarationPrinter$4 = (0, _kubb_plugin_ts.functionPrinter)({ mode: "declaration" });
-const mutationKeyTransformer = ({ node }) => {
-	if (!node.path) return [];
-	return [`{ url: '${Url.toPath(node.path)}' }`];
-};
-function MutationKey$1({ name, node, transformer }) {
-	const paramsNode = (0, _kubb_plugin_ts.createFunctionParameters)({ params: [] });
-	const paramsSignature = declarationPrinter$4.print(paramsNode) ?? "";
-	const keys = (transformer ?? mutationKeyTransformer)({
-		node,
-		casing: "camelcase"
-	});
-	return /* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx.File.Source, {
-		name,
-		isExportable: true,
-		isIndexable: true,
-		children: /* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx.Function.Arrow, {
-			name,
-			export: true,
-			params: paramsSignature,
-			singleLine: true,
-			children: `[${keys.join(", ")}] as const`
-		})
-	});
-}
-__name(MutationKey$1, "MutationKey");
-//#endregion
 //#region ../../internals/tanstack-query/src/utils.ts
 /**
 * The grouped request options, ordered for both the destructured signature and the
@@ -744,6 +740,9 @@ function buildQueryOptionsParams(node, options) {
 * shorthand alongside the spread `config`, with `throwOnError: true` pinned last so a caller's config
 * can't flip the query's error semantics. Queries thread the TanStack `signal`; mutations omit it.
 *
+* When `unwrapName` is set, each request group is passed as an explicit member unwrapped through it,
+* used by vue-query to resolve refs and getters with `toValue(...)` at call time.
+*
 * @example
 * ```ts
 * buildClientCall(node, { clientName: 'getPetById', signal: true })
@@ -751,16 +750,46 @@ function buildQueryOptionsParams(node, options) {
 * ```
 */
 function buildClientCall(node, options) {
-	const { clientName, signal = false } = options;
+	const { clientName, signal = false, unwrapName } = options;
 	const { groups } = getRequestGroupOptionality(node);
 	return `${clientName}({ ${[
 		"...config",
-		...requestGroupOrder.filter((key) => groups[key]),
+		...requestGroupOrder.filter((key) => groups[key]).map((name) => unwrapName ? `${name}: ${unwrapName(name)}` : name),
 		signal ? "signal: config.signal ?? signal" : null,
 		"throwOnError: true"
 	].filter((part) => part !== null).join(", ")} })`;
 }
 /**
+* Applies the shared query defaults during plugin setup: `false` disables query generation, and an
+* object merges over `methods: ['GET']` and the plugin's runtime `importPath`.
+*/
+function resolveQueryConfig(query, options) {
+	if (query === false) return false;
+	return {
+		importPath: options.importPath,
+		methods: ["GET"],
+		...query
+	};
+}
+/**
+* Applies the shared mutation defaults during plugin setup: `false` disables mutation generation,
+* and an object merges over `methods: ['POST', 'PUT', 'PATCH', 'DELETE']` and the plugin's runtime
+* `importPath`.
+*/
+function resolveMutationConfig(mutation, options) {
+	if (mutation === false) return false;
+	return {
+		importPath: options.importPath,
+		methods: [
+			"POST",
+			"PUT",
+			"PATCH",
+			"DELETE"
+		],
+		...mutation
+	};
+}
+/**
 * Build QueryKey params as the grouped `{ path, query, body }` object (NO headers, NO config),
 * typed from the operation's `Options` minus `url`. The query key transformer reads the
 * grouped `path`/`query`/`body` bindings.
@@ -778,6 +807,87 @@ function buildQueryKeyParams(node, options) {
 	return (0, _kubb_plugin_ts.createFunctionParameters)({ params: groupedParam ? [groupedParam] : [] });
 }
 //#endregion
+//#region ../../internals/tanstack-query/src/components/MutationKey.tsx
+const declarationPrinter$4 = (0, _kubb_plugin_ts.functionPrinter)({ mode: "declaration" });
+const mutationKeyTransformer = ({ node }) => {
+	if (!node.path) return [];
+	return [`{ url: '${Url.toPath(node.path)}' }`];
+};
+function MutationKey$1({ name, node, transformer }) {
+	const paramsNode = (0, _kubb_plugin_ts.createFunctionParameters)({ params: [] });
+	const paramsSignature = declarationPrinter$4.print(paramsNode) ?? "";
+	const keys = (transformer ?? mutationKeyTransformer)({
+		node,
+		casing: "camelcase"
+	});
+	return /* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx.File.Source, {
+		name,
+		isExportable: true,
+		isIndexable: true,
+		children: /* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx.Function.Arrow, {
+			name,
+			export: true,
+			params: paramsSignature,
+			singleLine: true,
+			children: `[${keys.join(", ")}] as const`
+		})
+	});
+}
+__name(MutationKey$1, "MutationKey");
+//#endregion
+//#region ../../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.
+*
+* @example
+* ```ts
+* createResolver<PluginReactQuery>({
+*   query: createQueryResolver(),
+*   suspenseQuery: createQueryResolver('Suspense'),
+* })
+* ```
+*/
+function createQueryResolver(variant = "") {
+	return {
+		name(node) {
+			return `use${capitalize(this.name(node.operationId))}${variant}`;
+		},
+		optionsName(node) {
+			return `${this.name(node.operationId)}${variant}QueryOptions`;
+		},
+		keyName(node) {
+			return `${this.name(node.operationId)}${variant}QueryKey`;
+		},
+		keyTypeName(node) {
+			return `${capitalize(this.name(node.operationId))}${variant}QueryKey`;
+		},
+		clientName(node) {
+			return `${this.name(node.operationId)}${variant}`;
+		}
+	};
+}
+/**
+* Builds the shared mutation namespace. Spread the result into
+* `createResolver` and add plugin-specific methods (`optionsName`,
+* `typeName`, `argTypeName`) next to it.
+*
+* @example
+* ```ts
+* createResolver<PluginSwr>({ mutation: { ...createMutationResolver(), argTypeName(node) {...} } })
+* ```
+*/
+function createMutationResolver() {
+	return {
+		name(node) {
+			return `use${capitalize(this.name(node.operationId))}`;
+		},
+		keyName(node) {
+			return `${this.name(node.operationId)}MutationKey`;
+		}
+	};
+}
+//#endregion
 //#region ../../internals/tanstack-query/src/components/QueryKey.tsx
 const declarationPrinter$3 = (0, _kubb_plugin_ts.functionPrinter)({ mode: "declaration" });
 const queryKeyTransformer = ({ node }) => {
@@ -1267,9 +1377,6 @@ const queryGenerator = (0, kubb_kit.defineGenerator)({
 });
 //#endregion
 //#region src/resolvers/resolverSwr.ts
-function capitalize(name) {
-	return `${name.charAt(0).toUpperCase()}${name.slice(1)}`;
-}
 /**
 * Default resolver used by `@kubb/plugin-swr`. Decides the names and file paths for every generated
 * SWR hook (`useFoo`, `useFooMutation`) and its companion helpers (`fooQueryKey`, `fooQueryOptions`,
@@ -1288,30 +1395,9 @@ function capitalize(name) {
 */
 const resolverSwr = (0, kubb_kit.createResolver)({
 	pluginName: "plugin-swr",
-	query: {
-		name(node) {
-			return `use${capitalize(this.name(node.operationId))}`;
-		},
-		optionsName(node) {
-			return `${this.name(node.operationId)}QueryOptions`;
-		},
-		keyName(node) {
-			return `${this.name(node.operationId)}QueryKey`;
-		},
-		keyTypeName(node) {
-			return `${capitalize(this.name(node.operationId))}QueryKey`;
-		},
-		clientName(node) {
-			return this.name(node.operationId);
-		}
-	},
+	query: createQueryResolver(),
 	mutation: {
-		name(node) {
-			return `use${capitalize(this.name(node.operationId))}`;
-		},
-		keyName(node) {
-			return `${this.name(node.operationId)}MutationKey`;
-		},
+		...createMutationResolver(),
 		keyTypeName(node) {
 			return `${capitalize(this.name(node.operationId))}MutationKey`;
 		},
@@ -1361,35 +1447,16 @@ const pluginSwr = (0, kubb_kit.definePlugin)((options) => {
 		dependencies: [_kubb_plugin_ts.pluginTsName],
 		hooks: { "kubb:plugin:setup"(ctx) {
 			const resolver = userResolver ? kubb_kit.Resolver.merge(resolverSwr, userResolver) : resolverSwr;
-			const resolvedClient = resolveClient({
-				client,
-				pluginNames: (ctx.config.plugins ?? []).map((p) => p.name).filter((name) => Boolean(name))
-			});
-			if (resolvedClient.kind === "error") throw new Error(resolvedClient.message);
-			const resolvedClientDescriptor = {
-				kind: "contract",
-				pluginName: resolvedClient.pluginName
-			};
 			ctx.setOptions({
 				output,
-				client: resolvedClientDescriptor,
+				client: resolveContractClient({
+					client,
+					plugins: ctx.config.plugins
+				}),
 				queryKey,
-				query: query === false ? false : {
-					importPath: "swr",
-					methods: ["GET"],
-					...query
-				},
+				query: resolveQueryConfig(query, { importPath: "swr" }),
 				mutationKey,
-				mutation: mutation === false ? false : {
-					importPath: "swr/mutation",
-					methods: [
-						"POST",
-						"PUT",
-						"PATCH",
-						"DELETE"
-					],
-					...mutation
-				},
+				mutation: resolveMutationConfig(mutation, { importPath: "swr/mutation" }),
 				group: groupConfig,
 				exclude,
 				include,
@@ -1406,5 +1473,6 @@ const pluginSwr = (0, kubb_kit.definePlugin)((options) => {
 exports.default = pluginSwr;
 exports.pluginSwr = pluginSwr;
 exports.pluginSwrName = pluginSwrName;
+exports.resolverSwr = resolverSwr;
 
 //# sourceMappingURL=index.cjs.map