@kubb/plugin-faker 5.0.0-beta.98 → 5.0.0

package/dist/index.js

@@ -1,6 +1,6 @@
 import "./rolldown-runtime-C0LytTxp.js";
 import { posix } from "node:path";
-import { Resolver, ast, createResolver, defineGenerator, definePlugin } from "kubb/kit";
+import { Resolver, ast, containsCircularRef, createResolver, defineGenerator, definePlugin } from "kubb/kit";
 import { buildParams, createFunctionParameter, createFunctionParameters, functionPrinter, pluginTsName } from "@kubb/plugin-ts";
 import { File, Function, jsxRenderer } from "kubb/jsx";
 import { Fragment, jsx, jsxs } from "kubb/jsx/jsx-runtime";
@@ -576,8 +576,9 @@ function Faker({ node, description, name, typeName, printer, seed, canOverride }
 	})();
 	const { dataType, returnType: resolvedReturnType } = resolveFakerTypeUsage(node, typeName, canOverride);
 	if (!useGenericOverride) {
+		const dataParamName = /\bdata\b/.test(fakerTextWithOverride) ? "data" : "_data";
 		const params = createFunctionParameters({ params: [createFunctionParameter({
-			name: /\bdata\b/.test(fakerTextWithOverride) ? "data" : "_data",
+			name: dataParamName,
 			type: dataType,
 			optional: true
 		})] });
@@ -601,7 +602,7 @@ function Faker({ node, description, name, typeName, printer, seed, canOverride }
 	const functionSignature = `${description ? `/**\n   * @description ${jsStringEscape(description)}\n   */\n  ` : ""}export function ${name}<TData extends Partial<${typeName}> = object>(data?: TData)`;
 	const seedCode = seed ? `faker.seed(${JSON.stringify(seed)})\n  ` : "";
 	const { cyclicSchemas, schemaName } = printer.options;
-	const functionBody = node.type === "object" && !!cyclicSchemas && (node.properties ?? []).some((p) => ast.containsCircularRef(p.schema, {
+	const functionBody = node.type === "object" && !!cyclicSchemas && (node.properties ?? []).some((p) => containsCircularRef(p.schema, {
 		circularSchemas: cyclicSchemas,
 		excludeName: schemaName
 	})) ? `{
@@ -628,45 +629,64 @@ function Faker({ node, description, name, typeName, printer, seed, canOverride }
 }
 //#endregion
 //#region ../../internals/shared/src/params.ts
-const caseParamsCache = /* @__PURE__ */ new WeakMap();
 /**
-* Applies camelCase to parameter names and returns a new array without mutating the input.
+* Drops parameters that share the same name, keeping the first.
 *
-* Run it before handing parameters to schema builders so output property keys get the right casing
-* while `OperationNode.parameters` stays intact for other consumers. When `casing` is unset, the
-* original array is returned unchanged. Results are cached per input array.
+* A malformed spec can declare the same parameter name twice within one `in` location. Both would
+* resolve to the same output property, so emitting both would yield an object type with a duplicate
+* member, which TypeScript rejects. This is a defensive guard against that case, not a casing guard:
+* parameter names flow through unchanged, so no two distinct names ever collide here anymore.
 */
-function caseParams(params, casing) {
-	if (!casing) return params;
-	const cached = caseParamsCache.get(params);
-	if (cached) return cached;
-	const result = params.map((param) => ({
-		...param,
-		name: camelCase(param.name)
-	}));
-	caseParamsCache.set(params, result);
-	return result;
-}
-/**
-* Drops parameters that collapse to the same property identity once camelCased, keeping the first.
-*
-* Some specs declare the same parameter twice under different casings (for example AWS S3 lists both
-* `max-uploads` and `MaxUploads`). Both resolve to one output property, so emitting both would yield
-* an object type with a duplicate member, which TypeScript rejects. De-duplicate by the camelCased
-* identity so the resulting group is collision-free regardless of the names each caller carries.
-*/
-function dedupeByCasedName(params) {
+function dedupeParams(params) {
 	const seen = /* @__PURE__ */ new Set();
 	return params.filter((param) => {
-		const key = camelCase(param.name);
-		if (seen.has(key)) return false;
-		seen.add(key);
+		if (seen.has(param.name)) return false;
+		seen.add(param.name);
 		return true;
 	});
 }
 //#endregion
 //#region ../../internals/shared/src/operation.ts
 /**
+* Builds the `ResolverFileParams` every operation generator passes to
+* `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.file(operationFileEntry(node, node.operationId), { root, output, group })
+* ```
+*/
+function operationFileEntry(node, name, extname = ".ts") {
+	return {
+		name,
+		extname,
+		tag: node.tags[0] ?? "default",
+		path: node.path
+	};
+}
+/**
+* Resolves a dependency plugin's generated file for `node.operationId`, cached in `cache` (the
+* current node's `ctx.cache`) under the resolver's own plugin name. Several dependents reading the
+* same dependency for the same operation in one pass (a query plugin's several hook generators, the
+* MCP handler, ...) share one computed name and path instead of each calling `resolver.file` again.
+*
+* @example Cache `plugin-ts`'s file for the current operation
+* ```ts
+* const fileTs = resolveDependencyOperationFile({ cache: ctx.cache, node, resolver: tsResolver, root, output })
+* ```
+*/
+function resolveDependencyOperationFile(options) {
+	const { cache, node, resolver, root, output, group } = options;
+	return cache.ensureItem(`${resolver.pluginName}:operationFile`, () => resolver.file({
+		...operationFileEntry(node, node.operationId),
+		root,
+		output,
+		group: group ?? void 0
+	}));
+}
+/**
 * Maps a content type to the PascalCase suffix used to name per-content-type variants
 * (e.g. `application/json` → `Json`, `application/xml` → `Xml`, `multipart/form-data` → `FormData`).
 */
@@ -714,14 +734,24 @@ function resolveContentTypeVariants(entries, baseName) {
 		};
 	});
 }
-function getOperationParameters(node, options = {}) {
-	const params = caseParams(node.parameters, options.paramsCasing === "original" ? void 0 : "camelcase");
-	return {
-		path: dedupeByCasedName(params.filter((param) => param.in === "path")),
-		query: dedupeByCasedName(params.filter((param) => param.in === "query")),
-		header: dedupeByCasedName(params.filter((param) => param.in === "header")),
-		cookie: dedupeByCasedName(params.filter((param) => param.in === "cookie"))
+const operationParameterGroupsByNode = /* @__PURE__ */ new WeakMap();
+/**
+* Groups an operation's parameters by location (`path`/`query`/`header`/`cookie`), deduping each
+* group by name. Every plugin generator visiting the same `OperationNode` shares one AST instance
+* (see `KubbDriver`), so the result is cached per node to avoid re-filtering and re-deduping the
+* same parameters once per plugin.
+*/
+function getOperationParameters(node) {
+	const cached = operationParameterGroupsByNode.get(node);
+	if (cached) return cached;
+	const groups = {
+		path: dedupeParams(node.parameters.filter((param) => param.in === "path")),
+		query: dedupeParams(node.parameters.filter((param) => param.in === "query")),
+		header: dedupeParams(node.parameters.filter((param) => param.in === "header")),
+		cookie: dedupeParams(node.parameters.filter((param) => param.in === "cookie"))
 	};
+	operationParameterGroupsByNode.set(node, groups);
+	return groups;
 }
 //#endregion
 //#region ../../internals/shared/src/resolver.ts
@@ -830,7 +860,41 @@ function createGroupConfig(group) {
 	};
 }
 //#endregion
+//#region ../../internals/shared/src/schemaTraversal.ts
+/**
+* Maps each member of a union or intersection schema to its transformed output, pairing every
+* result with the original member.
+*/
+function mapSchemaMembers(node, transform) {
+	return (node.members ?? []).map((schema) => ({
+		schema,
+		output: transform(schema)
+	}));
+}
+/**
+* Maps each item of an array or tuple schema to its transformed output, pairing every result with
+* the original item.
+*/
+function mapSchemaItems(node, transform) {
+	return (node.items ?? []).map((schema) => ({
+		schema,
+		output: transform(schema)
+	}));
+}
+//#endregion
 //#region src/printers/printerFaker.ts
+/**
+* Formats that put a whole number inside a `type: 'string'` schema, the way ProtoJSON encodes
+* 64-bit integers, so the mock has to be digits rather than letters.
+*
+* @see https://protobuf.dev/programming-guides/json/#int64-strings
+*/
+const integerFormats = /* @__PURE__ */ new Set([
+	"int32",
+	"int64",
+	"uint64"
+]);
+const maxInt32 = 2147483647;
 const fakerKeywordMapper = {
 	any: () => "undefined",
 	unknown: () => "undefined",
@@ -848,6 +912,10 @@ const fakerKeywordMapper = {
 		return "faker.number.int()";
 	},
 	bigint: () => "faker.number.bigInt()",
+	integerString: (format) => {
+		if (format === "int32") return `faker.number.int({ max: ${maxInt32} }).toString()`;
+		return "faker.number.bigInt().toString()";
+	},
 	string: (min, max) => {
 		if (max !== void 0 && min !== void 0) return `faker.string.alpha({ length: { min: ${min}, max: ${max} } })`;
 		if (max !== void 0) return `faker.string.alpha({ length: ${max} })`;
@@ -947,6 +1015,7 @@ const printerFaker = ast.createPrinter((options) => {
 			null: () => fakerKeywordMapper.null(),
 			string(node) {
 				if (node.pattern) return fakerKeywordMapper.matches(node.pattern, this.options.regexGenerator);
+				if (node.format && integerFormats.has(node.format)) return fakerKeywordMapper.integerString(node.format);
 				return fakerKeywordMapper.string(node.min, node.max);
 			},
 			email: () => fakerKeywordMapper.email(),
@@ -981,7 +1050,7 @@ const printerFaker = ast.createPrinter((options) => {
 			union(node) {
 				const { discriminatorPropertyName } = node;
 				const baseTypeName = this.options.typeName;
-				const items = ast.mapSchemaMembers(node, (member) => {
+				const items = mapSchemaMembers(node, (member) => {
 					const value = discriminatorPropertyName ? getDiscriminatorValue(member, discriminatorPropertyName) : void 0;
 					if (baseTypeName && value !== void 0) {
 						const typeName = `Extract<NonNullable<${baseTypeName}>, { ${JSON.stringify(discriminatorPropertyName)}: ${parseEnumValue(value)} }>`;
@@ -999,11 +1068,11 @@ const printerFaker = ast.createPrinter((options) => {
 				return fakerKeywordMapper.union(items);
 			},
 			intersection(node) {
-				const items = ast.mapSchemaMembers(node, (member) => printNested(member, { nestedInObject: true })).map(({ output }) => output).filter((item) => Boolean(item) && item !== "undefined");
+				const items = mapSchemaMembers(node, (member) => printNested(member, { nestedInObject: true })).map(({ output }) => output).filter((item) => Boolean(item) && item !== "undefined");
 				return fakerKeywordMapper.and(items);
 			},
 			array(node) {
-				const items = ast.mapSchemaItems(node, (member) => printNested(member, {
+				const items = mapSchemaItems(node, (member) => printNested(member, {
 					typeName: this.options.typeName ? `NonNullable<${this.options.typeName}>[number]` : void 0,
 					nestedInObject: true
 				})).map(({ output }) => output).filter((item) => Boolean(item));
@@ -1023,7 +1092,7 @@ const printerFaker = ast.createPrinter((options) => {
 						typeName: this.options.typeName ? indexedTypeName(this.options.typeName, property.name, this.options.nestedInUnion) : void 0,
 						nestedInObject: true
 					}) ?? "undefined";
-					if (cyclicSchemas && ast.containsCircularRef(property.schema, {
+					if (cyclicSchemas && containsCircularRef(property.schema, {
 						circularSchemas: cyclicSchemas,
 						excludeName: this.options.schemaName
 					})) return `get ${objectKey(property.name)}() { const _value = ${value}; Object.defineProperty(this, ${JSON.stringify(property.name)}, { value: _value, configurable: true, writable: true, enumerable: true }); return _value }`;
@@ -1172,11 +1241,7 @@ const fakerGenerator = defineGenerator({
 		const pluginTs = ctx.driver.getPlugin(pluginTsName);
 		if (!pluginTs) return;
 		const tsResolver = ctx.driver.getResolver(pluginTsName);
-		const params = caseParams(node.parameters, "camelcase");
-		const { path: pathParams, query: queryParams, header: headerParams } = getOperationParameters({
-			...node,
-			parameters: params
-		}, { paramsCasing: "original" });
+		const { path: pathParams, query: queryParams, header: headerParams } = getOperationParameters(node);
 		const paramGroups = [
 			{
 				params: pathParams,
@@ -1256,14 +1321,13 @@ const fakerGenerator = defineGenerator({
 				output,
 				group: group ?? void 0
 			}),
-			typeFile: tsResolver.file({
-				name: node.operationId,
-				extname: ".ts",
-				tag: node.tags[0] ?? "default",
-				path: node.path,
+			typeFile: resolveDependencyOperationFile({
+				cache: ctx.cache,
+				node,
+				resolver: tsResolver,
 				root,
 				output: pluginTs.options?.output ?? output,
-				group: pluginTs.options?.group ?? void 0
+				group: pluginTs.options?.group
 			})
 		};
 		function resolveMockImports(schema) {