@kubb/plugin-fetch 5.3.0-canary.20260907T104724 → 5.3.0

package/dist/index.cjs

@@ -476,23 +476,49 @@ function createGroupConfig(group) {
 function buildRequestResultGenerics({ node, types }) {
 	return `${types.response.responses(node)}, ThrowOnError`;
 }
+/**
+* Builds the full return type an operation's function signature uses: `Unwrappable<RequestResult>`
+* for the default `returnType: 'full'`, already a promise so no further wrapping is needed, or a
+* `Promise` of the runtime's `UnwrappedResult` when `returnType: 'data'` narrows a resolved call
+* down to the bare success body.
+*
+* @example
+* `buildResultType({ node, types, returnType: 'data' }) // 'Promise<UnwrappedResult<AddPetResponses, ThrowOnError>>'`
+*/
+function buildResultType({ node, types, returnType }) {
+	const generics = buildRequestResultGenerics({
+		node,
+		types
+	});
+	return returnType === "data" ? `Promise<UnwrappedResult<${generics}>>` : `Unwrappable<RequestResult<${generics}>>`;
+}
 //#endregion
 //#region ../../internals/client/src/builders/returnStatement.ts
 /**
-* Builds the return statement of a generated operation function. The runtime call already resolves
-* to `{ data, error, request, response }`. The generated code casts that result to the operation's
-* `RequestResult`, then wraps it with `withUnwrap`, so the caller can `await` it directly or call
-* `.unwrap()` for the bare success body.
+* Builds the return statement of a generated operation function. With the default
+* `returnType: 'full'` the runtime call already resolves to `{ data, error, request, response }`.
+* The generated code casts that result to the operation's `RequestResult`, then wraps it with
+* `withUnwrap`, so the caller can `await` it directly or call `.unwrap()` for the bare success
+* body. With `returnType: 'data'` it instead routes the call through the runtime's `unwrapResult`,
+* which narrows the resolved value down to the bare success body the same way `RequestResult`
+* already does, keeping the `throwOnError` default in one place instead of restating it per call.
 *
-* Cast first, wrap second. That order keeps `withUnwrap`'s generic inferred as `RequestResult`
-* instead of the runtime's own internal result type. Casting an `Unwrappable<A>` straight to
-* `Unwrappable<B>` does not work: the `.then` overload stays pinned to `A`, and `as` rejects that
-* two-generic swap even where `A` and `B` on their own would satisfy it.
+* Cast first, wrap second, for the `'full'` path. That order keeps `withUnwrap`'s generic inferred
+* as `RequestResult` instead of the runtime's own internal result type. Casting an `Unwrappable<A>`
+* straight to `Unwrappable<B>` does not work: the `.then` overload stays pinned to `A`, and `as`
+* rejects that two-generic swap even where `A` and `B` on their own would satisfy it.
 *
 * @example
 * `return withUnwrap(request({ method: 'POST', url: '/pet', ...config }) as Promise<RequestResult<AddPetResponses, ThrowOnError>>)`
+* @example
+* `return unwrapResult(request({ method: 'POST', url: '/pet', ...config }), config.throwOnError) as Promise<UnwrappedResult<AddPetResponses, ThrowOnError>>`
 */
-function buildReturnStatement({ node, types, callConfig }) {
+function buildReturnStatement({ node, types, callConfig, returnType }) {
+	if (returnType === "data") return `return unwrapResult(request(${callConfig}), config.throwOnError) as ${buildResultType({
+		node,
+		types,
+		returnType
+	})}`;
 	return `return withUnwrap(request(${callConfig}) as Promise<RequestResult<${buildRequestResultGenerics({
 		node,
 		types
@@ -578,7 +604,7 @@ const declarationPrinter = (0, _kubb_plugin_ts.functionPrinter)({ mode: "declara
 * per-operation input type has to be emitted. Both names come from `types`, which is `plugin-ts` or
 * `plugin-zod`'s inferred types (see `resolveOperationTypes`).
 */
-function buildGroupedOptionsSignature({ node, types }) {
+function buildGroupedOptionsSignature({ node, types, returnType }) {
 	const optionsName = types.response.options(node);
 	const { isOptional } = getRequestGroupOptionality(node);
 	return {
@@ -587,10 +613,11 @@ function buildGroupedOptionsSignature({ node, types }) {
 			type: `Options<${optionsName}, ThrowOnError>`,
 			...isOptional ? { default: "{}" } : {}
 		})] })) ?? "",
-		returnType: `Unwrappable<RequestResult<${buildRequestResultGenerics({
+		returnType: buildResultType({
 			node,
-			types
-		})}>>`,
+			types,
+			returnType
+		}),
 		generics: ["ThrowOnError extends boolean = true"]
 	};
 }
@@ -711,11 +738,12 @@ function buildCallConfig({ node, validator, zodResolver, security }) {
 * instance client, so one operation can be routed to a different environment without a new
 * instance.
 */
-function buildSdkMethod({ node, name, types, zodResolver, validator, security }) {
+function buildSdkMethod({ node, name, types, zodResolver, validator, security, returnType }) {
 	if (!kubb_kit.ast.isHttpOperationNode(node)) return "";
 	const signature = buildGroupedOptionsSignature({
 		node,
-		types
+		types,
+		returnType
 	});
 	const returnStatement = buildReturnStatement({
 		node,
@@ -725,7 +753,8 @@ function buildSdkMethod({ node, name, types, zodResolver, validator, security })
 			validator,
 			zodResolver,
 			security
-		})
+		}),
+		returnType
 	});
 	const generics = signature.generics.length ? `<${signature.generics.join(", ")}>` : "";
 	const jsdoc = buildJSDoc(buildOperationComments(node, {
@@ -801,11 +830,12 @@ function buildStyles({ node }) {
 * type, signature, and call config are built with the AST factory, and only the jsx-renderer emits
 * the source.
 */
-function Operation({ name, node, types, zodResolver, validator, security, isExportable = true, isIndexable = true }) {
+function Operation({ name, node, types, zodResolver, validator, returnType, security, isExportable = true, isIndexable = true }) {
 	if (!kubb_kit.ast.isHttpOperationNode(node)) return null;
 	const signature = buildGroupedOptionsSignature({
 		node,
-		types
+		types,
+		returnType
 	});
 	const validators = buildValidatorHooks({
 		node,
@@ -838,11 +868,12 @@ function Operation({ name, node, types, zodResolver, validator, security, isExpo
 		"...config"
 	].filter(Boolean).join(", ")} }`;
 	const eventType = `SuccessOf<${types.response.responses(node)}>`;
-	const returnType = eventStream ? `Promise<EventStreamResult<${eventType}>>` : signature.returnType;
+	const functionReturnType = eventStream ? `Promise<EventStreamResult<${eventType}>>` : signature.returnType;
 	const returnStatement = eventStream ? `return toEventStream<${eventType}>(request(${callConfig}))` : buildReturnStatement({
 		node,
 		types,
-		callConfig
+		callConfig,
+		returnType
 	});
 	return /* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx.File.Source, {
 		name,
@@ -853,7 +884,7 @@ function Operation({ name, node, types, zodResolver, validator, security, isExpo
 			export: isExportable,
 			generics: signature.generics,
 			params: signature.paramsSignature,
-			returnType,
+			returnType: functionReturnType,
 			JSDoc: { comments: buildOperationComments(node, {
 				link: "urlPath",
 				linkPosition: "beforeDeprecated",
@@ -875,14 +906,15 @@ function Operation({ name, node, types, zodResolver, validator, security, isExpo
 * instance: `const api = new PetClient({ baseURL }); api.getPetById(...)`. A per-call `client` option
 * still overrides the instance client for a one-off call.
 */
-function SdkClient({ name, isExportable = true, isIndexable = true, operations, validator, children }) {
+function SdkClient({ name, isExportable = true, isIndexable = true, operations, validator, returnType, children }) {
 	const methods = operations.map(({ node, name: methodName, types, zodResolver, security }) => buildSdkMethod({
 		node,
 		name: methodName,
 		types,
 		zodResolver,
 		validator,
-		security
+		security,
+		returnType
 	}));
 	const classCode = `export class ${name} {\n${[
 		"  private readonly client: ClientInstance",
@@ -962,7 +994,7 @@ function createClientGenerator(name) {
 		operation(node, ctx) {
 			if (!kubb_kit.ast.isHttpOperationNode(node)) return null;
 			const { config, driver, resolver, root } = ctx;
-			const { output, validator, group } = ctx.options;
+			const { output, validator, returnType, group } = ctx.options;
 			const types = resolveOperationTypes(driver);
 			if (!types) {
 				ctx.warn(MISSING_OPERATION_TYPES_WARNING);
@@ -1029,7 +1061,7 @@ function createClientGenerator(name) {
 				}),
 				children: [
 					/* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx.File.Import, {
-						name: eventStream ? ["client", "toEventStream"] : ["client", "withUnwrap"],
+						name: eventStream ? ["client", "toEventStream"] : ["client", returnType === "data" ? "unwrapResult" : "withUnwrap"],
 						root: meta.file.path,
 						path: clientPath
 					}),
@@ -1038,7 +1070,7 @@ function createClientGenerator(name) {
 							"Options",
 							"EventStreamResult",
 							"SuccessOf"
-						] : [
+						] : returnType === "data" ? ["Options", "UnwrappedResult"] : [
 							"Options",
 							"Unwrappable",
 							"RequestResult"
@@ -1064,6 +1096,7 @@ function createClientGenerator(name) {
 						types,
 						zodResolver,
 						validator,
+						returnType,
 						security
 					})
 				]
@@ -1204,7 +1237,7 @@ function createSdkGenerator() {
 		renderer: kubb_jsx.jsxRenderer,
 		operations(nodes, ctx) {
 			const { config, resolver, root } = ctx;
-			const { output, group, validator, sdk } = ctx.options;
+			const { output, group, validator, returnType, sdk } = ctx.options;
 			if (!sdk) return null;
 			const types = resolveOperationTypes(ctx.driver);
 			if (!types) {
@@ -1249,12 +1282,17 @@ function createSdkGenerator() {
 					footer: footer(file),
 					children: [
 						/* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx.File.Import, {
-							name: ["createClient", "withUnwrap"],
+							name: ["createClient", returnType === "data" ? "unwrapResult" : "withUnwrap"],
 							root: file.path,
 							path: clientPath
 						}),
 						/* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx.File.Import, {
-							name: [
+							name: returnType === "data" ? [
+								"ClientConfig",
+								"ClientInstance",
+								"Options",
+								"UnwrappedResult"
+							] : [
 								"ClientConfig",
 								"ClientInstance",
 								"Options",
@@ -1284,7 +1322,8 @@ function createSdkGenerator() {
 						/* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(SdkClient, {
 							name: className,
 							operations: ops,
-							validator
+							validator,
+							returnType
 						})
 					]
 				}, file.path);
@@ -1421,7 +1460,7 @@ const pluginFetch = (0, kubb_kit.definePlugin)((options) => {
 	const { output = {
 		path: "clients",
 		barrel: { type: "named" }
-	}, exclude = [], include, override = [], baseURL, validator = false, group, sdk, resolver: userResolver } = options;
+	}, exclude = [], include, override = [], baseURL, validator = false, returnType = "full", group, sdk, resolver: userResolver } = options;
 	const resolved = {
 		output,
 		exclude,
@@ -1430,6 +1469,7 @@ const pluginFetch = (0, kubb_kit.definePlugin)((options) => {
 		group: createGroupConfig(group),
 		baseURL,
 		validator,
+		returnType,
 		sdk: sdk ? {
 			mode: sdk.mode ?? "tag",
 			name: sdk.name