@kubb/plugin-faker 5.0.0-beta.99 → 5.0.1

package/dist/index.d.ts

@@ -229,11 +229,10 @@ type Props = {
   typeName: string;
   node: ast.SchemaNode;
   printer: ast.Printer<PrinterFakerFactory>;
-  seed?: PluginFaker['options']['seed'];
   description?: string;
   canOverride: boolean;
 };
-declare function Faker({ node, description, name, typeName, printer, seed, canOverride }: Props): KubbReactNode;
+declare function Faker({ node, description, name, typeName, printer, canOverride }: Props): KubbReactNode;
 //#endregion
 //#region src/generators/fakerGenerator.d.ts
 /**

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";
@@ -561,7 +561,7 @@ const SCALAR_TYPES = /* @__PURE__ */ new Set([
 	"enum"
 ]);
 const declarationPrinter = functionPrinter({ mode: "declaration" });
-function Faker({ node, description, name, typeName, printer, seed, canOverride }) {
+function Faker({ node, description, name, typeName, printer, canOverride }) {
 	const fakerText = printer.print(node) ?? "undefined";
 	const isArray = node.type === "array";
 	const isObject = OBJECT_TYPES.has(node.type);
@@ -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
 		})] });
@@ -588,24 +589,23 @@ function Faker({ node, description, name, typeName, printer, seed, canOverride }
 			name,
 			isExportable: true,
 			isIndexable: true,
-			children: /* @__PURE__ */ jsxs(Function, {
+			children: /* @__PURE__ */ jsx(Function, {
 				export: true,
 				name,
 				JSDoc: { comments: description ? [`@description ${jsStringEscape(description)}`] : [] },
 				params: canOverride ? paramsSignature : void 0,
 				returnType: returnType ?? void 0,
-				children: [seed ? /* @__PURE__ */ jsxs(Fragment, { children: [`faker.seed(${JSON.stringify(seed)})`, /* @__PURE__ */ jsx("br", {})] }) : void 0, `return ${returnExpression}`]
+				children: `return ${returnExpression}`
 			})
 		});
 	}
 	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
 	})) ? `{
-  ${seedCode}const defaultFakeData = ${fakerText}
+  const defaultFakeData = ${fakerText}
   if (data) {
     for (const [key, value] of Object.entries(data)) {
       Object.defineProperty(defaultFakeData, key, { value, configurable: true, writable: true, enumerable: true })
@@ -613,7 +613,7 @@ function Faker({ node, description, name, typeName, printer, seed, canOverride }
   }
   return defaultFakeData as Omit<typeof defaultFakeData, keyof TData> & TData
 }` : `{
-  ${seedCode}const defaultFakeData = ${fakerText}
+  const defaultFakeData = ${fakerText}
   return {
     ...defaultFakeData,
     ...(data || {}),
@@ -647,6 +647,45 @@ function dedupeParams(params) {
 //#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`).
 */
@@ -694,16 +733,24 @@ function resolveContentTypeVariants(entries, baseName) {
 		};
 	});
 }
+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) {
-	return {
-		path: dedupeParams(node.parameters.filter((param) => param.in === "path").map((param) => isValidVarName(param.name) ? param : {
-			...param,
-			name: camelCase(param.name)
-		})),
+	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
@@ -835,6 +882,18 @@ function mapSchemaItems(node, transform) {
 }
 //#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",
@@ -852,6 +911,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} })`;
@@ -951,6 +1014,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(),
@@ -1027,7 +1091,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 }`;
@@ -1158,13 +1222,16 @@ const fakerGenerator = defineGenerator({
 					imp.path,
 					imp.name
 				].join("-"))),
+				seed ? /* @__PURE__ */ jsx(File.Source, {
+					name: "faker-seed",
+					children: `faker.seed(${JSON.stringify(seed)})`
+				}) : void 0,
 				/* @__PURE__ */ jsx(Faker, {
 					name: meta.name,
 					typeName: typeReference.typeName,
 					description: node.description,
 					node,
 					printer: printerInstance,
-					seed,
 					canOverride
 				})
 			]
@@ -1256,14 +1323,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) {
@@ -1322,7 +1388,6 @@ const fakerGenerator = defineGenerator({
 						...printerInstance,
 						print: () => rewrittenFakerText
 					},
-					seed,
 					canOverride
 				})
 			] });
@@ -1363,6 +1428,10 @@ const fakerGenerator = defineGenerator({
 					path: dateParser,
 					name: dateParser
 				}),
+				seed ? /* @__PURE__ */ jsx(File.Source, {
+					name: "faker-seed",
+					children: `faker.seed(${JSON.stringify(seed)})`
+				}) : void 0,
 				paramGroups.map((group) => renderEntry(group)),
 				responseUnits.map((unit) => renderEntry({
 					schema: unit.schema,