@kubb/plugin-fetch 5.0.0-beta.85 → 5.0.0-beta.86

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { t as __name } from "./rolldown-runtime-C0LytTxp.js";
-import { Exclude, Group, Include, Output, OutputOptions, Override, PluginFactoryOptions, Resolver, ast } from "kubb/kit";
+import { Exclude, Group, Include, Output, OutputOptions, Override, PluginFactoryOptions, Resolver, ResolverPatch, ast } from "kubb/kit";
 //#region ../../internals/client/src/types.d.ts
 /**
  * Validator applied to request and response bodies using schemas from `@kubb/plugin-zod`.
@@ -21,39 +21,28 @@ type ValidatorOptions = false | 'zod' | {
  */
 type Mode = 'tag' | 'flat';
 /**
- * The resolver shared by the client plugins. Functions and files use camelCase; URL helpers get
- * a `get<Operation>Url` name.
+ * The resolver shared by the client plugins. Inherits the built-in camelCase `name` and `file`;
+ * classes and tag groups use PascalCase (with a `Client` suffix for groups).
  */
 type ResolverClient = Resolver & {
-  /**
-   * Resolves the function name for a raw operation name.
-   *
-   * @example
-   * `resolver.resolveName('show pet by id') // -> 'showPetById'`
-   */
-  resolveName(this: ResolverClient, name: string): string;
-  /**
-   * Resolves the output file name for a generated client module.
-   */
-  resolvePathName(this: ResolverClient, name: string, type?: 'file' | 'function' | 'type' | 'const'): string;
   /**
    * Resolves the generated class name for class-based clients.
    */
-  resolveClassName(this: ResolverClient, name: string): string;
+  className(this: ResolverClient, name: string): string;
   /**
    * Resolves the generated class name for a tag-based client group. The default appends a
    * `Client` suffix (tag `pet` becomes `PetClient`) so the class never collides with the schema
    * model of the same name in the barrel.
    *
    * @example
-   * `resolver.resolveGroupName('pet') // -> 'PetClient'`
+   * `resolver.groupName('pet') // -> 'PetClient'`
    */
-  resolveGroupName(this: ResolverClient, name: string): string;
+  groupName(this: ResolverClient, name: string): string;
   /**
    * Resolves the property name a tag client is exposed under on the composed root SDK
    * (`new PetStore(config).pet`).
    */
-  resolveClientPropertyName(this: ResolverClient, name: string): string;
+  propertyName(this: ResolverClient, name: string): string;
 };
 /**
  * The shared options surface for the client plugins. Deliberately small: there is one
@@ -134,7 +123,7 @@ type Options = OutputOptions & {
   /**
    * Override how names and file paths are built. Methods you omit fall back to the default resolver.
    */
-  resolver?: Partial<ResolverClient> & ThisType<ResolverClient>;
+  resolver?: ResolverPatch<ResolverClient>;
   /**
    * Macros applied to each operation node before code is printed.
    */

package/dist/index.js

@@ -1,6 +1,6 @@
 import "./rolldown-runtime-C0LytTxp.js";
 import path from "node:path";
-import { ast, defineGenerator, definePlugin, defineResolver } from "kubb/kit";
+import { Resolver, ast, createResolver, defineGenerator, definePlugin } from "kubb/kit";
 import { File, Function, jsxRenderer } from "kubb/jsx";
 import { createFunctionParameter, createFunctionParameters, functionPrinter, pluginTsName } from "@kubb/plugin-ts";
 import { Fragment, jsx, jsxs } from "kubb/jsx/jsx-runtime";
@@ -45,31 +45,6 @@ function pascalCase(text, { prefix = "", suffix = "" } = {}) {
 	return toCamelOrPascal(`${prefix} ${text} ${suffix}`, true);
 }
 //#endregion
-//#region ../../internals/utils/src/fs.ts
-/**
-* Builds a nested file path from a dotted name. Splits on dots that precede a letter
-* (so version numbers embedded in operationIds like `v2025.0` stay intact), camelCases
-* every earlier segment, applies `caseLast` to the final segment, and joins with `/`.
-*
-* Empty segments are dropped before joining. They arise when the name starts with a dot
-* followed by a letter (e.g. `..Schema` splits into `['..', 'Schema']` and `'..'` cases to
-* an empty string). Without this a leading `/` would form, which `path.resolve` reads as an
-* absolute path, letting generated files escape the configured output directory.
-*
-* @example Nested path from a dotted name
-* `toFilePath('pet.petId') // 'pet/petId'`
-*
-* @example PascalCase the final segment
-* `toFilePath('pet.Pet', pascalCase) // 'pet/Pet'`
-*
-* @example Suffix applied to the final segment only
-* `toFilePath('tag.tag', (part) => camelCase(part, { suffix: 'schema' })) // 'tag/tagSchema'`
-*/
-function toFilePath(name, caseLast = camelCase) {
-	const parts = name.split(/\.(?=[a-zA-Z])/);
-	return parts.map((part, i) => i === parts.length - 1 ? caseLast(part) : camelCase(part)).filter(Boolean).join("/");
-}
-//#endregion
 //#region ../../internals/utils/src/reserved.ts
 /**
 * JavaScript and Java reserved words.
@@ -193,6 +168,23 @@ function ensureValidVarName(name) {
 	return `_${name}`;
 }
 //#endregion
+//#region ../../internals/utils/src/codegen.ts
+/**
+* Builds a JSDoc comment block from an array of lines. Returns `fallback` when there are no
+* comments.
+*
+* @example
+* ```ts
+* buildJSDoc(['@type string', '@example hello'])
+* // '/**\n   * @type string\n   * @example hello\n   *\/\n  '
+* ```
+*/
+function buildJSDoc(comments, options = {}) {
+	const { indent = "   * ", suffix = "\n  ", fallback = "  " } = options;
+	if (comments.length === 0) return fallback;
+	return `/**\n${comments.map((c) => `${indent}${c}`).join("\n")}\n   */${suffix}`;
+}
+//#endregion
 //#region ../../internals/utils/src/url.ts
 function transformParam(raw, casing) {
 	const param = isValidVarName(raw) ? raw : camelCase(raw);
@@ -373,13 +365,13 @@ function buildParamsRemapExpression({ source, mapping }) {
 //#region ../../internals/shared/src/operation.ts
 /**
 * Builds the `ResolverFileParams` every operation generator passes to
-* `resolver.resolveFile`: a file named `name`, tagged by the operation's first
+* `resolver.file`: a file named `name`, tagged by the operation's first
 * tag (or `'default'`), at the operation's path. Centralizes the entry object
 * that was repeated at dozens of call sites across the client and query plugins.
 *
 * @example
 * ```ts
-* resolver.resolveFile(operationFileEntry(node, node.operationId), { root, output, group })
+* resolver.file(operationFileEntry(node, node.operationId), { root, output, group })
 * ```
 */
 function operationFileEntry(node, name, extname = ".ts") {
@@ -602,7 +594,7 @@ function resolveResponseValidator(validator) {
 * `<operation>ResponseSchema` is used; error bodies are never zod-parsed.
 */
 function buildZodResponseParse(node, zodResolver) {
-	const name = zodResolver.resolveResponseName?.(node);
+	const name = zodResolver.response.response(node);
 	return name ? {
 		expression: name,
 		importNames: [name]
@@ -615,7 +607,7 @@ function buildZodResponseParse(node, zodResolver) {
 */
 function buildZodErrorParse(node, zodResolver) {
 	if (!node.responses.some((res) => !isSuccessStatusCode(res.statusCode) && res.content?.some((entry) => entry.schema))) return null;
-	const name = zodResolver.resolveErrorName?.(node);
+	const name = zodResolver.response.error?.(node);
 	return name ? {
 		expression: name,
 		importNames: [name]
@@ -732,7 +724,7 @@ function buildParamsRemap({ node }) {
 * `buildRequestResultGenerics({ node, tsResolver }) // 'AddPetResponses, ThrowOnError'`
 */
 function buildRequestResultGenerics({ node, tsResolver }) {
-	return `${tsResolver.resolveResponsesName(node)}, ThrowOnError`;
+	return `${tsResolver.response.responses(node)}, ThrowOnError`;
 }
 //#endregion
 //#region ../../internals/client/src/builders/returnStatement.ts
@@ -755,30 +747,30 @@ function buildReturnStatement({ node, tsResolver, callConfig }) {
 const declarationPrinter = functionPrinter({ mode: "declaration" });
 /**
 * Builds the grouped-options signature for one operation: a single `options` object whose `TData`
-* is the plugin-ts `<Name>RequestConfig` (carrying a literal `url`), and a `RequestResult` return type
+* is the plugin-ts `<Name>Options` (carrying a literal `url`), and a `RequestResult` return type
 * keyed to the plugin-ts per-status responses record. There are no positional arguments.
 *
-* The generated file imports `<Name>RequestConfig` and `<Name>Responses` and uses them directly, so no
+* The generated file imports `<Name>Options` and `<Name>Responses` and uses them directly, so no
 * per-operation input type has to be emitted.
 */
 function buildGroupedOptionsSignature({ node, tsResolver }) {
-	const requestConfigName = tsResolver.resolveRequestConfigName(node);
-	const responsesName = tsResolver.resolveResponsesName(node);
+	const optionsName = tsResolver.response.options(node);
+	const responsesName = tsResolver.response.responses(node);
 	const resultGenerics = buildRequestResultGenerics({
 		node,
 		tsResolver
 	});
 	const { isOptional } = getRequestGroupOptionality(node);
 	return {
-		dataTypeName: requestConfigName,
+		dataTypeName: optionsName,
 		paramsSignature: declarationPrinter.print(createFunctionParameters({ params: [createFunctionParameter({
 			name: "options",
-			type: `Options<${requestConfigName}, ThrowOnError>`,
+			type: `Options<${optionsName}, ThrowOnError>`,
 			...isOptional ? { default: "{}" } : {}
 		})] })) ?? "",
 		returnType: `Promise<RequestResult<${resultGenerics}>>`,
 		generics: ["ThrowOnError extends boolean = true"],
-		importedTypeNames: [requestConfigName, responsesName]
+		importedTypeNames: [optionsName, responsesName]
 	};
 }
 //#endregion
@@ -844,7 +836,7 @@ function buildStyles({ node }) {
 function buildValidatorHooks({ node, validator, zodResolver }) {
 	const importedZodNames = [];
 	const hasRequestBody = Boolean(node.requestBody?.content?.[0]?.schema);
-	const zodRequestName = zodResolver && resolveRequestValidator(validator) === "zod" && hasRequestBody ? zodResolver.resolveDataName?.(node) : null;
+	const zodRequestName = zodResolver && resolveRequestValidator(validator) === "zod" && hasRequestBody ? zodResolver.response.body(node) : null;
 	const request = zodRequestName ?? null;
 	if (zodRequestName) importedZodNames.push(zodRequestName);
 	const responseParse = zodResolver && resolveResponseValidator(validator) === "zod" ? buildZodResponseParse(node, zodResolver) : null;
@@ -904,7 +896,7 @@ function Operation({ name, node, tsResolver, zodResolver, validator, security, i
 		"...config",
 		...buildParamsRemap({ node })
 	].filter(Boolean).join(", ")} }`;
-	const eventType = `SuccessOf<${tsResolver.resolveResponsesName(node)}>`;
+	const eventType = `SuccessOf<${tsResolver.response.responses(node)}>`;
 	const returnType = eventStream ? `Promise<EventStreamResult<${eventType}>>` : signature.returnType;
 	const returnStatement = eventStream ? `return toEventStream<${eventType}>(request(${callConfig}))` : buildReturnStatement({
 		node,
@@ -982,7 +974,7 @@ function buildSdkMethod({ node, name, tsResolver, zodResolver, validator, securi
 		})
 	});
 	const generics = signature.generics.length ? `<${signature.generics.join(", ")}>` : "";
-	const jsdoc = ast.buildJSDoc(buildOperationComments(node, {
+	const jsdoc = buildJSDoc(buildOperationComments(node, {
 		link: "urlPath",
 		linkPosition: "beforeDeprecated",
 		splitLines: true
@@ -1052,15 +1044,15 @@ function SdkFacade({ name, isExportable = true, isIndexable = true, members, chi
 //#endregion
 //#region ../../internals/client/src/generators/sdkGenerator.tsx
 function resolveTypeImportNames(node, tsResolver) {
-	return [tsResolver.resolveRequestConfigName(node), tsResolver.resolveResponsesName(node)];
+	return [tsResolver.response.options(node), tsResolver.response.responses(node)];
 }
 function resolveZodImportNames(node, zodResolver, validator) {
 	const { query: queryParams } = getOperationParameters(node, { paramsCasing: "original" });
 	return [
-		resolveResponseValidator(validator) === "zod" ? zodResolver.resolveResponseName?.(node) : null,
+		resolveResponseValidator(validator) === "zod" ? zodResolver.response.response(node) : null,
 		resolveResponseValidator(validator) === "zod" ? buildZodErrorParse(node, zodResolver)?.expression ?? null : null,
-		resolveRequestValidator(validator) === "zod" && node.requestBody?.content?.[0]?.schema ? zodResolver.resolveDataName?.(node) : null,
-		resolveQueryParamsValidator(validator) === "zod" && queryParams.length > 0 ? zodResolver.resolveQueryParamsName?.(node, queryParams[0]) : null
+		resolveRequestValidator(validator) === "zod" && node.requestBody?.content?.[0]?.schema ? zodResolver.response.body(node) : null,
+		resolveQueryParamsValidator(validator) === "zod" && queryParams.length > 0 ? zodResolver.param.query(node, queryParams[0]) : null
 	].filter((n) => Boolean(n));
 }
 /**
@@ -1077,12 +1069,14 @@ function buildControllers(nodes, ctx) {
 	const zodResolver = pluginZod ? driver.getResolver(pluginZodName) : null;
 	const document = ctx.adapter.document;
 	function buildOperationData(node) {
-		const typeFile = tsResolver.resolveFile(operationFileEntry(node, node.operationId), {
+		const typeFile = tsResolver.file({
+			...operationFileEntry(node, node.operationId),
 			root,
 			output: tsPluginOptions?.output ?? output,
 			group: tsPluginOptions?.group
 		});
-		const zodFile = zodResolver && pluginZod?.options ? zodResolver.resolveFile(operationFileEntry(node, node.operationId), {
+		const zodFile = zodResolver && pluginZod?.options ? zodResolver.file({
+			...operationFileEntry(node, node.operationId),
 			root,
 			output: pluginZod.options?.output ?? output,
 			group: pluginZod.options?.group ?? void 0
@@ -1094,7 +1088,7 @@ function buildControllers(nodes, ctx) {
 		}) : void 0;
 		return {
 			node,
-			name: resolver.resolveName(node.operationId),
+			name: resolver.name(node.operationId),
 			tsResolver,
 			zodResolver,
 			typeFile,
@@ -1105,12 +1099,11 @@ function buildControllers(nodes, ctx) {
 	return nodes.reduce((acc, operationNode) => {
 		if (!ast.isHttpOperationNode(operationNode)) return acc;
 		const tag = operationNode.tags[0];
-		const name = tag ? group?.name?.({ group: camelCase(tag) }) ?? resolver.resolveGroupName(tag) : resolver.resolveClassName("ApiClient");
-		const file = resolver.resolveFile({
+		const name = tag ? group?.name?.({ group: camelCase(tag) }) ?? resolver.groupName(tag) : resolver.className("ApiClient");
+		const file = resolver.file({
 			name,
 			extname: ".ts",
-			tag
-		}, {
+			tag,
 			root,
 			output,
 			group: group ?? void 0
@@ -1164,7 +1157,7 @@ function createSdkGenerator() {
 			if (!ctx.driver.getPlugin(pluginTsName) || !sdk) return null;
 			const controllers = buildControllers(nodes, ctx);
 			const clientPath = path.resolve(root, ".kubb/client.ts");
-			const banner = (file) => resolver.resolveBanner(ctx.meta, {
+			const banner = (file) => resolver.default.banner(ctx.meta, {
 				output,
 				config,
 				file: {
@@ -1172,7 +1165,7 @@ function createSdkGenerator() {
 					baseName: file.baseName
 				}
 			});
-			const footer = (file) => resolver.resolveFooter(ctx.meta, {
+			const footer = (file) => resolver.default.footer(ctx.meta, {
 				output,
 				config,
 				file: {
@@ -1239,28 +1232,26 @@ function createSdkGenerator() {
 					]
 				}, file.path);
 			};
-			if (sdk.mode === "flat") return renderClassFile(resolver.resolveClassName(sdk.name ?? "sdk"), resolver.resolveFile({
+			if (sdk.mode === "flat") return renderClassFile(resolver.className(sdk.name ?? "sdk"), resolver.file({
 				name: sdk.name ?? "sdk",
-				extname: ".ts"
-			}, {
+				extname: ".ts",
 				root,
 				output,
 				group: group ?? void 0
 			}), controllers.flatMap((controller) => controller.operations));
 			const classFiles = controllers.map(({ name, file, operations: ops }) => renderClassFile(name, file, ops));
 			if (!sdk.name) return /* @__PURE__ */ jsx(Fragment, { children: classFiles });
-			const sdkFile = resolver.resolveFile({
+			const sdkFile = resolver.file({
 				name: sdk.name,
-				extname: ".ts"
-			}, {
+				extname: ".ts",
 				root,
 				output,
 				group: group ?? void 0
 			});
-			const facadeName = resolver.resolveClassName(sdk.name);
+			const facadeName = resolver.className(sdk.name);
 			const members = controllers.map(({ name, tag }) => ({
 				className: name,
-				propName: resolver.resolveClientPropertyName(tag ?? name)
+				propName: resolver.propertyName(tag ?? name)
 			}));
 			return /* @__PURE__ */ jsxs(Fragment, { children: [classFiles, /* @__PURE__ */ jsxs(File, {
 				baseName: sdkFile.baseName,
@@ -1300,38 +1291,27 @@ const defaultMacros = [ast.macroSimplifyUnion];
 //#endregion
 //#region ../../internals/client/src/resolver.ts
 /**
-* Default resolver shared by the client plugins. Functions and files use camelCase; classes and
-* tag groups use PascalCase.
+* Default resolver shared by the client plugins. Functions and files inherit the built-in camelCase
+* `name` and `file`; classes and tag groups use PascalCase.
 *
 * @example
 * ```ts
-* resolverClient.resolveName('show pet by id') // 'showPetById'
-* resolverClient.resolveGroupName('pet')       // 'PetClient'
+* resolverClient.name('show pet by id')  // 'showPetById'
+* resolverClient.groupName('pet')        // 'PetClient'
 * ```
 */
-const resolverClient = defineResolver(() => ({
-	name: "default",
+const resolverClient = createResolver({
 	pluginName: "plugin-contract-client",
-	default(name, type) {
-		if (type === "file") return toFilePath(name);
-		return ensureValidVarName(camelCase(name));
-	},
-	resolveName(name) {
-		return this.default(name, "function");
-	},
-	resolvePathName(name, type) {
-		return this.default(name, type);
-	},
-	resolveClassName(name) {
+	className(name) {
 		return ensureValidVarName(pascalCase(name));
 	},
-	resolveGroupName(name) {
+	groupName(name) {
 		return ensureValidVarName(pascalCase(`${name} Client`));
 	},
-	resolveClientPropertyName(name) {
+	propertyName(name) {
 		return ensureValidVarName(camelCase(name));
 	}
-}));
+});
 //#endregion
 //#region src/generators/clientGenerator.tsx
 /**
@@ -1352,25 +1332,28 @@ const clientGenerator = defineGenerator({
 		const pluginZod = resolveResponseValidator(validator) === "zod" || resolveRequestValidator(validator) === "zod" ? driver.getPlugin(pluginZodName) : null;
 		const zodResolver = pluginZod ? driver.getResolver(pluginZodName) : null;
 		const hasRequestBody = Boolean(node.requestBody?.content?.[0]?.schema);
-		const importedTypeNames = [tsResolver.resolveRequestConfigName(node), tsResolver.resolveResponsesName(node)];
+		const importedTypeNames = [tsResolver.response.options(node), tsResolver.response.responses(node)];
 		const importedZodNames = zodResolver ? [
-			resolveResponseValidator(validator) === "zod" ? zodResolver.resolveResponseName?.(node) : null,
+			resolveResponseValidator(validator) === "zod" ? zodResolver.response.response?.(node) : null,
 			resolveResponseValidator(validator) === "zod" ? buildZodErrorParse(node, zodResolver)?.expression ?? null : null,
-			resolveRequestValidator(validator) === "zod" && hasRequestBody ? zodResolver.resolveDataName?.(node) : null
+			resolveRequestValidator(validator) === "zod" && hasRequestBody ? zodResolver.response.body?.(node) : null
 		].filter((name) => Boolean(name)) : [];
 		const meta = {
-			name: resolver.resolveName(node.operationId),
-			file: resolver.resolveFile(operationFileEntry(node, node.operationId), {
+			name: resolver.name(node.operationId),
+			file: resolver.file({
+				...operationFileEntry(node, node.operationId),
 				root,
 				output,
 				group: group ?? void 0
 			}),
-			fileTs: tsResolver.resolveFile(operationFileEntry(node, node.operationId), {
+			fileTs: tsResolver.file({
+				...operationFileEntry(node, node.operationId),
 				root,
 				output: pluginTs.options?.output ?? output,
 				group: pluginTs.options?.group ?? void 0
 			}),
-			fileZod: zodResolver && pluginZod?.options ? zodResolver.resolveFile(operationFileEntry(node, node.operationId), {
+			fileZod: zodResolver && pluginZod?.options ? zodResolver.file({
+				...operationFileEntry(node, node.operationId),
 				root,
 				output: pluginZod.options.output ?? output,
 				group: pluginZod.options?.group ?? void 0
@@ -1387,7 +1370,7 @@ const clientGenerator = defineGenerator({
 			baseName: meta.file.baseName,
 			path: meta.file.path,
 			meta: meta.file.meta,
-			banner: resolver.resolveBanner(ctx.meta, {
+			banner: resolver.default.banner(ctx.meta, {
 				output,
 				config,
 				file: {
@@ -1395,7 +1378,7 @@ const clientGenerator = defineGenerator({
 					baseName: meta.file.baseName
 				}
 			}),
-			footer: resolver.resolveFooter(ctx.meta, {
+			footer: resolver.default.footer(ctx.meta, {
 				output,
 				config,
 				file: {
@@ -1499,10 +1482,7 @@ const pluginFetch = definePlugin((options) => {
 			mode: sdk.mode ?? "tag",
 			name: sdk.name
 		} : void 0,
-		resolver: userResolver ? {
-			...resolverClient,
-			...userResolver
-		} : resolverClient
+		resolver: userResolver ? Resolver.merge(resolverClient, userResolver) : resolverClient
 	};
 	const selectedGenerators = resolved.sdk ? [createSdkGenerator()] : [clientGenerator];
 	return {