@kubb/plugin-react-query 5.4.0-canary.20261014T071450 → 5.5.0-canary.20261014T114558

package/dist/index.cjs

@@ -357,7 +357,7 @@ var compatibility = {
 };
 //#endregion
 //#region package.json
-var version = "5.4.0-canary.20261014T071450";
+var version = "5.5.0-canary.20261014T114558";
 //#endregion
 //#region ../../internals/client/src/resolveClient.ts
 /**
@@ -365,23 +365,30 @@ var version = "5.4.0-canary.20261014T071450";
 * operation, shared so the selection rules and diagnostics stay in one place.
 *
 * Every client runtime lives in a dedicated client plugin, so a consumer always calls a registered
-* contract client plugin (plugin-fetch or plugin-axios) and never emits its own inline client:
+* contract client plugin (plugin-fetch, plugin-axios, or plugin-client) and never emits its own
+* inline client:
 *
 * - `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, 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.
+* The `client` string selects explicitly (`'fetch'` / `'axios'` / `'client'`); when it is unset a
+* lone registered contract client plugin is picked up automatically.
 */
 const pluginFetchName = "plugin-fetch";
 const pluginAxiosName = "plugin-axios";
+const pluginClientName = "plugin-client";
 const selectorToPlugin = {
 	fetch: pluginFetchName,
-	axios: pluginAxiosName
+	axios: pluginAxiosName,
+	client: pluginClientName
 };
-const contractPlugins = [pluginFetchName, pluginAxiosName];
+const contractPlugins = [
+	pluginFetchName,
+	pluginAxiosName,
+	pluginClientName
+];
 /**
 * Applies the `client` resolution rules. See the module comment for the strategy shape.
 *
@@ -400,7 +407,7 @@ const contractPlugins = [pluginFetchName, pluginAxiosName];
 function resolveClient(options) {
 	const { client, pluginNames } = options;
 	const has = (name) => pluginNames.includes(name);
-	if (client === "fetch" || client === "axios") {
+	if (client === "fetch" || client === "axios" || client === "client") {
 		const pluginName = selectorToPlugin[client];
 		if (!has(pluginName)) return {
 			kind: "error",
@@ -413,7 +420,7 @@ function resolveClient(options) {
 	}
 	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.`
+		message: `Option \`client\` is ${typeof client === "string" ? `'${client}'` : String(client)}, but it must be one of 'fetch', 'axios', 'client'. Drop \`client\` to use the registered client plugin.`
 	};
 	const registered = contractPlugins.filter(has);
 	if (registered.length === 1) return {
@@ -422,11 +429,11 @@ function resolveClient(options) {
 	};
 	if (registered.length > 1) return {
 		kind: "error",
-		message: `Multiple client plugins are registered (${registered.map((name) => `\`@kubb/${name}\``).join(", ")}). Set \`client: 'fetch' | 'axios'\` to choose which client the hooks call, or register a single client plugin.`
+		message: `Multiple client plugins are registered (${registered.map((name) => `\`@kubb/${name}\``).join(", ")}). Set \`client: 'fetch' | 'axios' | 'client'\` to choose which client the hooks call, or register a single client plugin.`
 	};
 	return {
 		kind: "error",
-		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."
+		message: "No client plugin is registered. Add `@kubb/plugin-axios`, `@kubb/plugin-fetch`, or `@kubb/plugin-client` to `plugins` so the generated code has an HTTP client to call."
 	};
 }
 /**
@@ -445,13 +452,21 @@ function resolveContractClient(options) {
 }
 //#endregion
 //#region ../../internals/client/src/resolveClientOperation.ts
+function isRelativeImport(importPath) {
+	return importPath.startsWith(".");
+}
+function resolveImportPath(options) {
+	const { importPath, operationFile } = options;
+	return isRelativeImport(importPath) ? node_path.default.resolve(node_path.default.dirname(operationFile), importPath) : importPath;
+}
 /**
 * Resolves the contract client `<op>` a consumer (query hook, MCP handler) imports, by looking up
 * the registered contract client plugin's resolver and output. Works for any contract client plugin
-* (plugin-fetch or plugin-axios). Returns `null` when no contract plugin is in play (the inline
+* (plugin-fetch, plugin-axios, or plugin-client). Returns `null` when no contract plugin is in play (the inline
 * path), or when the client plugin's `exclude` / `include` leaves this operation out, since it then
-* emits no `<op>` to import. The plugin injects `.kubb/client.ts` at the global output root, the
-* same path consumers read `RequestConfig` / `ResponseErrorConfig` from.
+* emits no `<op>` to import. plugin-fetch / plugin-axios inject `.kubb/client.ts` at the global
+* output root, the same path consumers read `RequestConfig` / `ResponseErrorConfig` from.
+* With plugin-client they come from the user's `importPath` module instead.
 *
 * 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
@@ -482,10 +497,15 @@ function resolveClientOperation(options) {
 			output: operationOptions.output ?? output,
 			group: operationOptions.group ?? void 0
 		});
+		const { importPath } = operationOptions;
 		return {
 			name: resolver.name(node.operationId),
 			path: file.path,
-			clientPath: node_path.default.resolve(root, ".kubb/client.ts"),
+			clientPath: importPath === void 0 ? node_path.default.resolve(root, ".kubb/client.ts") : resolveImportPath({
+				importPath,
+				operationFile: file.path
+			}),
+			clientPathIsFile: importPath === void 0 || isRelativeImport(importPath),
 			returnType: operationOptions.returnType ?? "full"
 		};
 	});
@@ -600,7 +620,8 @@ function buildClientCall(node, options) {
 * success body. `returnType` mirrors the registered client plugin's own `returnType` option: with
 * `'data'` the call already resolves to the bare body, so it is returned directly; with `'full'`
 * (the default) the call carries `unwrap()`, so the body calls it instead of destructuring `data`
-* off the full result by hand.
+* off the full result by hand. With `'plain'` (plugin-client) the call resolves to the user's
+* `RequestResult`, so the body awaits it and reads `data`.
 *
 * @example
 * ```ts
@@ -611,6 +632,7 @@ function buildClientCall(node, options) {
 function buildCallResultBody(call, options = {}) {
 	const { returnType = "full" } = options;
 	if (returnType === "data") return `return await ${call}`;
+	if (returnType === "plain") return `return (await ${call}).data`;
 	return `return ${call}.unwrap()`;
 }
 /**
@@ -655,13 +677,14 @@ function resolvePageParamType(node, { resolver, initialPageParam, queryParam })
 }
 /**
 * 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`.
+* object merges over `methods: ['GET', 'QUERY']` and the plugin's runtime `importPath`. QUERY
+* (RFC 10008) is a safe, idempotent read that carries its input in the body, so it is a query too.
 */
 function resolveQueryConfig(query, options) {
 	if (query === false) return false;
 	return {
 		importPath: options.importPath,
-		methods: ["GET"],
+		methods: ["GET", "QUERY"],
 		...query
 	};
 }
@@ -974,7 +997,7 @@ const queryKeyTransformer = ({ node, variant }) => {
 	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] : [])");
+	if (node.requestBody?.content?.[0]?.schema) result.push("...(body !== undefined ? [body] : [])");
 	return result;
 };
 function QueryKey({ name, node, tsResolver, typeName, transformer, variant = "query" }) {
@@ -1690,7 +1713,7 @@ const infiniteQueryGenerator = (0, kubb_kit.defineGenerator)({
 				}),
 				/* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx.File.Import, {
 					name: ["RequestConfig", "ResponseErrorConfig"],
-					root: meta.file.path,
+					root: contractOp.clientPathIsFile ? meta.file.path : void 0,
 					path: contractOp.clientPath,
 					isTypeOnly: true
 				}),
@@ -1854,7 +1877,7 @@ const mutationGenerator = (0, kubb_kit.defineGenerator)({
 				}),
 				/* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx.File.Import, {
 					name: ["RequestConfig", "ResponseErrorConfig"],
-					root: meta.file.path,
+					root: contractOp.clientPathIsFile ? meta.file.path : void 0,
 					path: contractOp.clientPath,
 					isTypeOnly: true
 				}),
@@ -1917,7 +1940,7 @@ const mutationGenerator = (0, kubb_kit.defineGenerator)({
 //#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
+* GET and QUERY operation (configurable via `query.methods`) plus the matching
 * `fooQueryKey` / `fooQueryOptions` helpers.
 */
 const queryGenerator = (0, kubb_kit.defineGenerator)({
@@ -2003,7 +2026,7 @@ const queryGenerator = (0, kubb_kit.defineGenerator)({
 				}),
 				/* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx.File.Import, {
 					name: ["RequestConfig", "ResponseErrorConfig"],
-					root: meta.file.path,
+					root: contractOp.clientPathIsFile ? meta.file.path : void 0,
 					path: contractOp.clientPath,
 					isTypeOnly: true
 				}),
@@ -2170,7 +2193,7 @@ const suspenseInfiniteQueryGenerator = (0, kubb_kit.defineGenerator)({
 				}),
 				/* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx.File.Import, {
 					name: ["RequestConfig", "ResponseErrorConfig"],
-					root: meta.file.path,
+					root: contractOp.clientPathIsFile ? meta.file.path : void 0,
 					path: contractOp.clientPath,
 					isTypeOnly: true
 				}),
@@ -2339,7 +2362,7 @@ const suspenseQueryGenerator = (0, kubb_kit.defineGenerator)({
 				}),
 				/* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx.File.Import, {
 					name: ["RequestConfig", "ResponseErrorConfig"],
-					root: meta.file.path,
+					root: contractOp.clientPathIsFile ? meta.file.path : void 0,
 					path: contractOp.clientPath,
 					isTypeOnly: true
 				}),