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

package/dist/index.cjs

@@ -71,31 +71,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.
@@ -196,7 +171,7 @@ const reservedWords = /* @__PURE__ */ new Set([
 */
 function isValidVarName(name) {
 	if (!name || reservedWords.has(name)) return false;
-	return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name);
+	return isIdentifier(name);
 }
 /**
 * Returns `name` when it's a syntactically valid JavaScript variable name,
@@ -218,6 +193,39 @@ function ensureValidVarName(name) {
 	if (!name || isValidVarName(name)) return name;
 	return `_${name}`;
 }
+/**
+* Returns `true` when `name` is syntactically a valid identifier, ignoring reserved words.
+*
+* Reserved words and globals (`class`, `name`, `Date`, …) are valid as bare object-literal keys
+* even though they are not valid variable names, so use this (not {@link isValidVarName}) when
+* deciding whether an object key needs quoting.
+*
+* @example
+* ```ts
+* isIdentifier('name')   // true
+* isIdentifier('x-total')// false
+* ```
+*/
+function isIdentifier(name) {
+	return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(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) {
@@ -399,13 +407,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") {
@@ -422,8 +430,11 @@ function getOperationLink(node, link) {
 	if (link === "urlPath") return node.path ? `{@link ${Url.toPath(node.path)}}` : null;
 	return node.path ? `{@link ${node.path.replaceAll("{", ":").replaceAll("}", "")}}` : null;
 }
-function getContentTypeInfo(node) {
-	const contentTypes = node.requestBody?.content?.map((e) => e.contentType) ?? [];
+/**
+* Derives the shared `ContentTypeInfo` shape from a list of content types, tracking whether several
+* are present and the union, default, and form-data flags the client uses to pick one.
+*/
+function buildContentTypeInfo(contentTypes) {
 	const isMultipleContentTypes = contentTypes.length > 1;
 	return {
 		contentTypes,
@@ -433,20 +444,15 @@ function getContentTypeInfo(node) {
 		hasFormData: contentTypes.some((ct) => ct === "multipart/form-data")
 	};
 }
+function getContentTypeInfo(node) {
+	return buildContentTypeInfo(node.requestBody?.content?.map((e) => e.contentType) ?? []);
+}
 /**
 * The request-body counterpart for the primary success response: the content types it documents and
 * whether several are present, so the client can let a caller pick which one to accept.
 */
 function getResponseContentTypeInfo(node) {
-	const contentTypes = getPrimarySuccessResponse(node)?.content?.map((e) => e.contentType) ?? [];
-	const isMultipleContentTypes = contentTypes.length > 1;
-	return {
-		contentTypes,
-		isMultipleContentTypes,
-		contentTypeUnion: isMultipleContentTypes ? contentTypes.map((ct) => JSON.stringify(ct)).join(" | ") : "",
-		defaultContentType: contentTypes[0] ?? "application/json",
-		hasFormData: contentTypes.some((ct) => ct === "multipart/form-data")
-	};
+	return buildContentTypeInfo(getPrimarySuccessResponse(node)?.content?.map((e) => e.contentType) ?? []);
 }
 /**
 * Reads the single base content type of an operation's primary success response, lowercased and
@@ -628,7 +634,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]
@@ -641,7 +647,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]
@@ -758,7 +764,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
@@ -781,30 +787,30 @@ function buildReturnStatement({ node, tsResolver, callConfig }) {
 const declarationPrinter = (0, _kubb_plugin_ts.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((0, _kubb_plugin_ts.createFunctionParameters)({ params: [(0, _kubb_plugin_ts.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
@@ -870,7 +876,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;
@@ -930,7 +936,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,
@@ -1008,7 +1014,7 @@ function buildSdkMethod({ node, name, tsResolver, zodResolver, validator, securi
 		})
 	});
 	const generics = signature.generics.length ? `<${signature.generics.join(", ")}>` : "";
-	const jsdoc = kubb_kit.ast.buildJSDoc(buildOperationComments(node, {
+	const jsdoc = buildJSDoc(buildOperationComments(node, {
 		link: "urlPath",
 		linkPosition: "beforeDeprecated",
 		splitLines: true
@@ -1078,15 +1084,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));
 }
 /**
@@ -1103,12 +1109,14 @@ function buildControllers(nodes, ctx) {
 	const zodResolver = pluginZod ? driver.getResolver(_kubb_plugin_zod.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
@@ -1120,7 +1128,7 @@ function buildControllers(nodes, ctx) {
 		}) : void 0;
 		return {
 			node,
-			name: resolver.resolveName(node.operationId),
+			name: resolver.name(node.operationId),
 			tsResolver,
 			zodResolver,
 			typeFile,
@@ -1131,12 +1139,11 @@ function buildControllers(nodes, ctx) {
 	return nodes.reduce((acc, operationNode) => {
 		if (!kubb_kit.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
@@ -1190,7 +1197,7 @@ function createSdkGenerator() {
 			if (!ctx.driver.getPlugin(_kubb_plugin_ts.pluginTsName) || !sdk) return null;
 			const controllers = buildControllers(nodes, ctx);
 			const clientPath = node_path.default.resolve(root, ".kubb/client.ts");
-			const banner = (file) => resolver.resolveBanner(ctx.meta, {
+			const banner = (file) => resolver.default.banner(ctx.meta, {
 				output,
 				config,
 				file: {
@@ -1198,7 +1205,7 @@ function createSdkGenerator() {
 					baseName: file.baseName
 				}
 			});
-			const footer = (file) => resolver.resolveFooter(ctx.meta, {
+			const footer = (file) => resolver.default.footer(ctx.meta, {
 				output,
 				config,
 				file: {
@@ -1265,28 +1272,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__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx_jsx_runtime.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__ */ (0, kubb_jsx_jsx_runtime.jsxs)(kubb_jsx_jsx_runtime.Fragment, { children: [classFiles, /* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsxs)(kubb_jsx.File, {
 				baseName: sdkFile.baseName,
@@ -1326,38 +1331,27 @@ const defaultMacros = [kubb_kit.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 = (0, kubb_kit.defineResolver)(() => ({
-	name: "default",
+const resolverClient = (0, kubb_kit.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
 /**
@@ -1378,25 +1372,28 @@ const clientGenerator = (0, kubb_kit.defineGenerator)({
 		const pluginZod = resolveResponseValidator(validator) === "zod" || resolveRequestValidator(validator) === "zod" ? driver.getPlugin(_kubb_plugin_zod.pluginZodName) : null;
 		const zodResolver = pluginZod ? driver.getResolver(_kubb_plugin_zod.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
@@ -1413,7 +1410,7 @@ const clientGenerator = (0, kubb_kit.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: {
@@ -1421,7 +1418,7 @@ const clientGenerator = (0, kubb_kit.defineGenerator)({
 					baseName: meta.file.baseName
 				}
 			}),
-			footer: resolver.resolveFooter(ctx.meta, {
+			footer: resolver.default.footer(ctx.meta, {
 				output,
 				config,
 				file: {
@@ -1525,10 +1522,7 @@ const pluginFetch = (0, kubb_kit.definePlugin)((options) => {
 			mode: sdk.mode ?? "tag",
 			name: sdk.name
 		} : void 0,
-		resolver: userResolver ? {
-			...resolverClient,
-			...userResolver
-		} : resolverClient
+		resolver: userResolver ? kubb_kit.Resolver.merge(resolverClient, userResolver) : resolverClient
 	};
 	const selectedGenerators = resolved.sdk ? [createSdkGenerator()] : [clientGenerator];
 	return {