hono-takibi 0.9.99993 → 0.9.99994

package/README.md

@@ -486,6 +486,11 @@ export default defineConfig({
 
   mock: {
     output: './src/mock.ts',
+    useExamples: true,
+    locale: 'en',
+    delay: false,
+    arrayMin: 1,
+    arrayMax: 10,
   },
 
   docs: {

package/dist/config/index.d.ts

@@ -280,6 +280,14 @@ declare const ConfigSchema: z.ZodReadonly<z.ZodObject<{
   }, z.core.$strip>>>;
   mock: z.ZodExactOptional<z.ZodReadonly<z.ZodObject<{
     output: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    useExamples: z.ZodExactOptional<z.ZodBoolean>;
+    locale: z.ZodExactOptional<z.ZodString>;
+    delay: z.ZodExactOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<false>, z.ZodReadonly<z.ZodObject<{
+      min: z.ZodNumber;
+      max: z.ZodNumber;
+    }, z.core.$strip>>]>>;
+    arrayMin: z.ZodExactOptional<z.ZodNumber>;
+    arrayMax: z.ZodExactOptional<z.ZodNumber>;
   }, z.core.$strip>>>;
   docs: z.ZodExactOptional<z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
     output: z.ZodTemplateLiteral<`${string}.md`>;
@@ -565,6 +573,14 @@ declare function parseConfig(config: unknown): {
     }>;
     mock?: Readonly<{
       output: string;
+      useExamples?: boolean;
+      locale?: string;
+      delay?: number | false | Readonly<{
+        min: number;
+        max: number;
+      }>;
+      arrayMin?: number;
+      arrayMax?: number;
     }>;
     docs?: Readonly<{
       output: `${string}.md`;
@@ -852,6 +868,14 @@ declare function readConfig(): Promise<{
     }>;
     mock?: Readonly<{
       output: string;
+      useExamples?: boolean;
+      locale?: string;
+      delay?: number | false | Readonly<{
+        min: number;
+        max: number;
+      }>;
+      arrayMin?: number;
+      arrayMax?: number;
     }>;
     docs?: Readonly<{
       output: `${string}.md`;
@@ -1136,6 +1160,14 @@ declare function defineConfig(config: z.input<typeof ConfigSchema>): Readonly<{
   }>;
   mock?: Readonly<{
     output: string;
+    useExamples?: boolean;
+    locale?: string;
+    delay?: number | false | Readonly<{
+      min: number;
+      max: number;
+    }>;
+    arrayMin?: number;
+    arrayMax?: number;
   }>;
   docs?: Readonly<{
     output: `${string}.md`;

package/dist/config/index.js

@@ -148,7 +148,21 @@ const ConfigSchema = z.object({
 			"bun"
 		]).default("vitest").exactOptional()
 	}).readonly().exactOptional(),
-	mock: z.object({ output: FileOutputSchema }).readonly().exactOptional(),
+	mock: z.object({
+		output: FileOutputSchema,
+		useExamples: z.boolean().exactOptional(),
+		locale: z.string().regex(/^[A-Za-z_]{1,40}$/, { error: "Invalid faker locale. Use a code like 'ja', 'en', or 'zh_CN'." }).exactOptional(),
+		delay: z.union([
+			z.number().int().nonnegative().max(6e4),
+			z.literal(false),
+			z.object({
+				min: z.number().int().nonnegative().max(6e4),
+				max: z.number().int().nonnegative().max(6e4)
+			}).readonly().refine((v) => v.min <= v.max, { message: "delay.min must be <= delay.max. Swap the values or remove one." })
+		]).exactOptional(),
+		arrayMin: z.number().int().nonnegative().max(1e3).exactOptional(),
+		arrayMax: z.number().int().nonnegative().max(1e3).exactOptional()
+	}).readonly().refine((v) => v.arrayMin === void 0 || v.arrayMax === void 0 || v.arrayMin <= v.arrayMax, { message: "arrayMin must be <= arrayMax. Swap the values or remove one." }).exactOptional(),
 	docs: z.discriminatedUnion("curl", [z.object({
 		output: z.templateLiteral([z.string().min(1), z.enum([".md"])], { error: "must be .md file" }),
 		curl: z.literal(true),

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { readConfig } from "./config/index.js";
 import { r as setFormatOptions } from "./emit-CFR63U4L.js";
-import { n as parseOpenAPI, r as takibi, t as makeJob } from "./shared-DC4zuL9A.js";
+import { n as parseOpenAPI, r as takibi, t as makeJob } from "./shared-n3ZMLfl9.js";
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";
 //#region src/cli/index.ts

package/dist/{shared-DC4zuL9A.js → shared-n3ZMLfl9.js}

@@ -514,7 +514,7 @@ const FORMAT_TO_FAKER = {
 	gender: "faker.person.gender()",
 	bic: "faker.finance.bic()",
 	iban: "faker.finance.iban()",
-	binary: "new Blob([faker.string.alphanumeric(100)])",
+	binary: "new File([faker.string.alphanumeric(100)], faker.system.fileName())",
 	byte: "btoa(faker.string.alphanumeric(10))",
 	int32: "faker.number.int({ min: -2147483648, max: 2147483647 })",
 	int64: "faker.number.bigInt({ min: 0n, max: 9007199254740991n })",
@@ -615,7 +615,9 @@ function schemaToFaker(schema, propertyName, options = {}) {
 	if (schema.type === "array" && schema.items) {
 		const itemSchema = Array.isArray(schema.items) ? schema.items[0] : schema.items;
 		if (!itemSchema) return "[]";
-		return `Array.from({ length: faker.number.int({ min: 1, max: 5 }) }, () => (${schemaToFaker(itemSchema, void 0, options)}))`;
+		const itemFaker = schemaToFaker(itemSchema, void 0, options);
+		const min = schema.minItems ?? options.arrayMin ?? 1;
+		return `Array.from({ length: faker.number.int({ min: ${min}, max: ${schema.maxItems ?? options.arrayMax ?? Math.max(min, 10)} }) }, () => (${itemFaker}))`;
 	}
 	const renderProps = (properties, required) => {
 		const requiredSet = new Set(required || []);
@@ -655,7 +657,8 @@ function schemaToFaker(schema, propertyName, options = {}) {
 	if (schema.type && typeof schema.type === "string" && TYPE_TO_FAKER[schema.type]) {
 		if (schema.type === "string") {
 			if (schema.pattern) return `faker.helpers.fromRegExp(/${escapeRegexLiteral(schema.pattern)}/)`;
-			return `faker.string.alpha({ length: { min: ${schema.minLength ?? 5}, max: ${schema.maxLength ?? 20} } })`;
+			const min = schema.minLength ?? 5;
+			return `faker.string.alpha({ length: { min: ${min}, max: ${schema.maxLength ?? Math.max(min, 20)} } })`;
 		}
 		if (schema.type === "integer" || schema.type === "number") return numericFaker(schema, numericRange(schema, schema.type === "integer"));
 		return TYPE_TO_FAKER[schema.type];
@@ -759,8 +762,11 @@ function schemaClosure(roots, schemas) {
 	}
 	return used;
 }
-function makeMockFunction(name, schema, schemas, isCircular) {
-	const mockBody = schemaToFaker(schema, void 0, { schemas });
+function makeMockFunction(name, schema, schemas, isCircular, fakerOptions) {
+	const mockBody = schemaToFaker(schema, void 0, {
+		schemas,
+		...fakerOptions
+	});
 	const returnType = isCircular ? ": any" : "";
 	const sanitized = name.replace(/\./g, "");
 	const schemaConst = toIdentifierPascalCase(ensureSuffix(name, "Schema"));
@@ -896,64 +902,34 @@ function extractMediaExample(media, components) {
 	}
 	return "value" in first ? first.value : void 0;
 }
-const PAGE_PARAM_NAMES = [
-	"page",
-	"pageNumber",
-	"page_number"
-];
-const OFFSET_PARAM_NAMES = ["offset", "skip"];
-const ROWS_PARAM_NAMES = [
-	"rows",
-	"limit",
-	"perPage",
-	"per_page",
-	"pageSize",
-	"page_size",
-	"size",
-	"take"
-];
-function detectPagination(operation) {
-	if (operation["x-pagination"] !== true) return void 0;
-	const queryParams = (operation.parameters ?? []).filter((p) => "in" in p && p.in === "query");
-	const rows = queryParams.find((p) => ROWS_PARAM_NAMES.includes(p.name));
-	if (!rows) return void 0;
-	const pageParam = queryParams.find((p) => PAGE_PARAM_NAMES.includes(p.name));
-	const offsetParam = pageParam ? void 0 : queryParams.find((p) => OFFSET_PARAM_NAMES.includes(p.name));
-	const cursor = pageParam ?? offsetParam;
-	if (!cursor) return void 0;
-	const defaultRows = typeof rows.schema?.default === "number" ? rows.schema.default : 20;
-	return {
-		rowsParam: rows.name,
-		cursorParam: cursor.name,
-		offsetStyle: offsetParam !== void 0,
-		defaultRows
-	};
-}
 function makeHandlerBody(args) {
-	const { statusCode, jsonSchema, textSchema, schemas, allRefs, exampleValue, exampleCast, pagination } = args;
+	const { statusCode, jsonSchema, textSchema, schemas, fakerOptions, allRefs, exampleValue, exampleCast } = args;
 	if (exampleValue !== void 0) {
 		const cast = exampleCast ? ` as z.infer<typeof ${exampleCast}>` : "";
 		return `return c.json(${JSON.stringify(exampleValue)}${cast}, ${statusCode})`;
 	}
-	if (pagination && jsonSchema?.type === "array" && jsonSchema.items) {
-		collectRefs(jsonSchema, allRefs);
-		const itemFaker = schemaToFaker(Array.isArray(jsonSchema.items) ? jsonSchema.items[0] : jsonSchema.items, void 0, { schemas });
-		const startExpr = pagination.offsetStyle ? `const start = query.${pagination.cursorParam} ?? 0` : `const page = query.${pagination.cursorParam} ?? 1\nconst start = (page - 1) * rows`;
-		return `const query = c.req.valid('query')
-const rows = query.${pagination.rowsParam} ?? ${pagination.defaultRows}
-${startExpr}
-const items = Array.from({ length: ${pagination.totalConst} }, () => (${itemFaker}))
-return c.json(items.slice(start, start + rows), ${statusCode})`;
-	}
 	if (jsonSchema) {
 		collectRefs(jsonSchema, allRefs);
-		return `return c.json(${schemaToFaker(jsonSchema, void 0, { schemas })}, ${statusCode})`;
+		return `return c.json(${schemaToFaker(jsonSchema, void 0, {
+			schemas,
+			...fakerOptions
+		})}, ${statusCode})`;
 	}
-	if (textSchema) return `return c.text(${schemaToFaker(textSchema, void 0, { schemas })}, ${statusCode})`;
+	if (textSchema) return `return c.text(${schemaToFaker(textSchema, void 0, {
+		schemas,
+		...fakerOptions
+	})}, ${statusCode})`;
 	if (statusCode === 204) return `return new Response(null, { status: 204 })`;
 	return `return c.body(null, ${statusCode})`;
 }
+function delayMiddlewareCode(delay) {
+	const ms = typeof delay === "number" ? `${delay}` : typeof delay === "object" && delay !== null ? `faker.number.int({ min: ${delay.min}, max: ${delay.max} })` : void 0;
+	if (ms === void 0) return "";
+	return `\n\napp.use(async (_c, next) => {\n  await new Promise((resolve) => setTimeout(resolve, ${ms}))\n  await next()\n})`;
+}
 function makeMock(openapi, basePath, options = {}) {
+	const { useExamples: useExamplesOption, locale, delay, readonly: readonlyOption, ...fakerOptions } = options;
+	const useExamples = useExamplesOption ?? true;
 	const filteredOpenapi = filterToJsonContentTypes(openapi);
 	const paths = filteredOpenapi.paths;
 	const schemas = openapi.components?.schemas ?? {};
@@ -972,24 +948,17 @@ function makeMock(openapi, basePath, options = {}) {
 		const textMedia = successResponse?.content?.["text/plain"];
 		const jsonSchema = jsonMedia && isMediaWithSchema(jsonMedia) ? jsonMedia.schema : void 0;
 		const textSchema = textMedia && isMediaWithSchema(textMedia) ? textMedia.schema : void 0;
-		const exampleValue = jsonMedia ? extractMediaExample(jsonMedia, openapi.components) : void 0;
-		const exampleCast = exampleValue !== void 0 && jsonSchema?.$ref ? toIdentifierPascalCase(ensureSuffix(jsonSchema.$ref.split("/").at(-1) ?? "", "Schema")) : void 0;
-		const pag = detectPagination(operation);
-		const pagination = pag && exampleValue === void 0 && jsonSchema?.type === "array" && jsonSchema.items ? {
-			totalConst: `${routeId}Total`,
-			...pag
-		} : void 0;
+		const exampleValue = useExamples && jsonMedia ? extractMediaExample(jsonMedia, openapi.components) : void 0;
 		const handlerBody = makeHandlerBody({
 			statusCode,
 			jsonSchema,
 			textSchema,
 			schemas,
+			fakerOptions,
 			allRefs,
 			exampleValue,
-			exampleCast,
-			pagination
+			exampleCast: exampleValue !== void 0 && jsonSchema?.$ref ? toIdentifierPascalCase(ensureSuffix(jsonSchema.$ref.split("/").at(-1) ?? "", "Schema")) : void 0
 		});
-		const paginationDecl = pagination ? `const ${pagination.totalConst} = faker.number.int({ min: 0, max: ${Math.min(pagination.defaultRows * 3, 3e3)} })` : "";
 		const authCheck = makeAuthCheck(security, operation.responses?.[String(401)] !== void 0);
 		const handler = `const ${routeId}RouteHandler: RouteHandler<typeof ${routeId}Route> = async (${handlerBody.includes("c.") || authCheck !== "" ? "c" : "_c"}) => {${authCheck}${handlerBody}}`;
 		return [{
@@ -999,18 +968,16 @@ function makeMock(openapi, basePath, options = {}) {
 				path: p,
 				requiresAuth
 			},
-			handler,
-			paginationDecl
+			handler
 		}];
 	}));
 	const routeMetas = processed.map(({ entry }) => entry);
 	const handlers = processed.map(({ handler }) => handler);
-	const paginationDecls = processed.flatMap(({ paginationDecl }) => paginationDecl.length > 0 ? [paginationDecl] : []);
 	const allDeps = /* @__PURE__ */ new Set();
 	for (const ref of allRefs) collectAllDependencies(ref, schemas, allDeps);
 	const sortedRefs = topologicalSort(allDeps, schemas);
 	const circularSchemas = detectCircularSchemas$1(schemas);
-	const mockFunctions = sortedRefs.filter((refName) => schemas[refName]).map((refName) => makeMockFunction(refName, schemas[refName], schemas, circularSchemas.has(refName)));
+	const mockFunctions = sortedRefs.filter((refName) => schemas[refName]).map((refName) => makeMockFunction(refName, schemas[refName], schemas, circularSchemas.has(refName), fakerOptions));
 	const rootRefs = collectSchemaRefs$1(filteredOpenapi.paths, /* @__PURE__ */ new Set());
 	if (openapi.components) {
 		collectSchemaRefs$1(openapi.components.responses, rootRefs);
@@ -1042,14 +1009,16 @@ function makeMock(openapi, basePath, options = {}) {
 		exportPathItems: false,
 		exportMediaTypes: false,
 		exportMediaTypesTypes: false,
-		...options.readonly !== void 0 ? { readonly: options.readonly } : {}
+		...readonlyOption !== void 0 ? { readonly: readonlyOption } : {}
 	}) : "";
-	const routes = routeCode(filteredOpenapi, options.readonly);
+	const routes = routeCode(filteredOpenapi, readonlyOption);
 	const appSetup = routeMetas.map(({ routeId }) => `.openapi(${routeId}Route, ${routeId}RouteHandler)`).join("");
 	const handlersJoined = handlers.join("\n\n");
+	const needsCookieImport = handlersJoined.includes("getCookie(c,");
 	const imports = `import { OpenAPIHono, createRoute, z, type RouteHandler } from '@hono/zod-openapi'
-import { faker } from '@faker-js/faker'${handlersJoined.includes("getCookie(c,") ? `\nimport { getCookie } from 'hono/cookie'` : ""}`;
-	const appCode = `const app = new OpenAPIHono()${basePath !== "/" ? `.basePath('${basePath}')` : ""}
+${locale ? `import { faker } from '@faker-js/faker/locale/${locale}'` : `import { faker } from '@faker-js/faker'`}${needsCookieImport ? `\nimport { getCookie } from 'hono/cookie'` : ""}`;
+	const delayMiddleware = delayMiddlewareCode(delay);
+	const appCode = `const app = new OpenAPIHono()${basePath !== "/" ? `.basePath('${basePath}')` : ""}${delayMiddleware}
 
 export const api = app${appSetup}
 
@@ -1059,15 +1028,14 @@ export default app`;
 		components,
 		routes,
 		mockFunctions.join("\n\n"),
-		paginationDecls.join("\n"),
 		handlersJoined,
 		appCode
 	].filter((s) => s.length > 0).join("\n\n");
 }
 //#endregion
 //#region src/core/mock/index.ts
-async function mock(openAPI, output, basePath, readonly) {
-	const emitResult = await emit(makeMock(openAPI, basePath, readonly !== void 0 ? { readonly } : {}), path.dirname(output), output);
+async function mock(openAPI, output, basePath, options = {}) {
+	const emitResult = await emit(makeMock(openAPI, basePath, options), path.dirname(output), output);
 	if (!emitResult.ok) return {
 		ok: false,
 		error: emitResult.error
@@ -2912,7 +2880,10 @@ function makeJob(openAPI, config) {
 			name: "mock",
 			output: config.mock.output,
 			split: false,
-			run: (output) => mock(openAPI, output, config.basePath, config.readonly)
+			run: (output) => mock(openAPI, output, config.basePath, {
+				...config.mock,
+				...config.readonly !== void 0 ? { readonly: config.readonly } : {}
+			})
 		} : void 0,
 		config.docs ? {
 			name: "docs",

package/dist/vite-plugin/index.js

@@ -1,7 +1,7 @@
 import { parseConfig } from "../config/index.js";
 import { r as setFormatOptions } from "../emit-CFR63U4L.js";
 import { f as isRecord } from "../guard-zvkMUVYD.js";
-import { n as parseOpenAPI, t as makeJob } from "../shared-DC4zuL9A.js";
+import { n as parseOpenAPI, t as makeJob } from "../shared-n3ZMLfl9.js";
 import path from "node:path";
 import fsp from "node:fs/promises";
 //#region src/vite-plugin/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hono-takibi",
-  "version": "0.9.99993",
+  "version": "0.9.99994",
   "description": "Hono Takibi is a code generator from OpenAPI to @hono/zod-openapi",
   "keywords": [
     "hono",