@moccona/apicodegen 0.0.9 → 0.0.10

package/npm/vite/index.mjs

@@ -240,29 +240,6 @@ var ApicodegenError = class ApicodegenError extends Error {
 	}
 };
 /**
-* ANSI color codes for terminal output
-*/
-const Colors = {
-	reset: "\x1B[0m",
-	bold: "\x1B[1m",
-	red: "\x1B[31m",
-	green: "\x1B[32m",
-	yellow: "\x1B[33m",
-	blue: "\x1B[34m",
-	cyan: "\x1B[36m",
-	gray: "\x1B[90m",
-	brightRed: "\x1B[91m",
-	brightGreen: "\x1B[92m"
-};
-/**
-* Format error for CLI output
-*/
-function formatError(error, verbose = false) {
-	if (error instanceof ApicodegenError) return error.toString(verbose);
-	if (error instanceof Error) return `${Colors.red}${Colors.bold}Error${Colors.reset}: ${error.message}${verbose && error.stack ? `\n\n${Colors.gray}${error.stack}${Colors.reset}` : ""}`;
-	return `${Colors.red}${Colors.bold}Error${Colors.reset}: ${String(error)}`;
-}
-/**
 * Create error with common patterns
 */
 const createErrors = {
@@ -399,6 +376,68 @@ function isApicodegenError(error) {
 	return error instanceof ApicodegenError;
 }
 //#endregion
+//#region src/core/logger.ts
+const cyan = (s) => `\x1b[36m${s}\x1b[0m`;
+const green = (s) => `\x1b[32m${s}\x1b[0m`;
+const red = (s) => `\x1b[31m${s}\x1b[0m`;
+const blue = (s) => `\x1b[34m${s}\x1b[0m`;
+const yellow = (s) => `\x1b[33m${s}\x1b[0m`;
+const magenta = (s) => `\x1b[35m${s}\x1b[0m`;
+const gray = (s) => `\x1b[90m${s}\x1b[0m`;
+const bold = (s) => `\x1b[1m${s}\x1b[0m`;
+const logger$1 = {
+	success(msg) {
+		console.log(`${green("✓")} ${msg}`);
+	},
+	error(err, verbose = false) {
+		if (isApicodegenError(err)) console.error(`${red("✗")} ${err.toString(verbose)}`);
+		else if (err instanceof Error) {
+			const msg = `Error: ${err.message}`;
+			console.error(`${red("✗")} ${msg}${verbose && err.stack ? `\n${gray(err.stack)}` : ""}`);
+		} else console.error(`${red("✗")} ${String(err)}`);
+	},
+	info(msg) {
+		console.log(`${blue("ℹ")} ${msg}`);
+	},
+	warn(msg) {
+		console.log(`${yellow("⚠")} ${msg}`);
+	},
+	loading(msg) {
+		console.log(`${yellow("🔄")} ${msg}`);
+	},
+	watching(msg) {
+		console.log(`${magenta("⟳")} ${msg}`);
+	},
+	fileChange(filePath) {
+		console.log(`${yellow("↓")} ${filePath}`);
+	},
+	fileAdd(filePath) {
+		console.log(`${green("+")} ${filePath}`);
+	},
+	shutdown() {
+		console.log(`\n${gray("👋 Shutting down...")}`);
+	},
+	divider(width = 50) {
+		console.log(`${bold(cyan("─".repeat(width)))}`);
+	},
+	heading(text, mode, width = 50) {
+		console.log(`${bold(cyan("─".repeat(width)))}`);
+		console.log(`${bold(cyan(text))}`);
+		console.log(`${gray("Mode:")} ${mode || "unknown"}`);
+		console.log(`${bold(cyan("─".repeat(width)))}`);
+	},
+	item(label, color = "green") {
+		const icon = color === "green" ? "✓" : color === "red" ? "✗" : "⚠";
+		console.log(`${color === "green" ? green(icon) : color === "red" ? red(icon) : yellow(icon)} ${label}`);
+	},
+	summary(stats) {
+		const { succeeded, failed, endpoints, schemas, duration } = stats;
+		const label = `API Code Gen - Complete (${succeeded} succeeded${failed > 0 ? `, ${failed} failed` : ""}, ${endpoints} endpoints, ${schemas} schemas, ${duration}ms)`;
+		if (failed === 0) console.log(`${green("✓")} ${label}`);
+		else console.log(`${yellow("⚠")} ${label}`);
+	}
+};
+//#endregion
 //#region src/core/base/Adaptor.ts
 /**
 * Base adapter for tool
@@ -764,10 +803,19 @@ var Generator = class Generator {
 		return createPrinter().printFile(sourceFile);
 	}
 	static async write(code, filepath) {
+		const { mkdir } = await import("node:fs/promises");
+		const { dirname } = await import("node:path");
 		try {
+			await mkdir(dirname(filepath), { recursive: true });
 			await writeFile(filepath, code);
 		} catch (error) {
-			console.error(error);
+			throw new ApicodegenError({
+				code: ErrorCodes.OUTPUT_DIR_MISSING,
+				message: "Failed to write generated code to output file",
+				location: filepath,
+				cause: error instanceof Error ? error : new Error(String(error)),
+				suggestions: ["Verify the output directory path is writable", "Check that the parent directory exists or can be created"]
+			});
 		}
 	}
 	/**
@@ -1104,12 +1152,12 @@ var FetchAdapter = class extends Adapter {
 	}
 };
 //#endregion
-//#region src/openapi/V2.ts
-var V2 = class {
-	doc;
-	constructor(doc) {
-		this.doc = doc;
-	}
+//#region src/openapi/VersionedProvider.ts
+/**
+* Abstract base class. Subclasses implement the four container accessors
+* and a version tag. The shared logic lives here.
+*/
+var VersionedProvider = class {
 	/**
 	* Resolves a path $ref to the actual path object.
 	*/
@@ -1121,281 +1169,37 @@ var V2 = class {
 	* Is array schema.
 	*/
 	isOpenAPIArraySchema(schema) {
-		return typeof schema === "object" && schema.type === "array";
+		return typeof schema === "object" && schema !== null && schema.type === "array";
 	}
 	/**
-	* OpenAPI schema to base schema.
+	* OpenAPI schema to base schema. Override for version-specific quirks
+	* (V3_1 throws on missing ref; V3 returns `{ type: 'unknown' }`).
 	*/
 	getSchemaByRef(schema, reserveRef = false, enums = [], upLevelSchemaKey = "") {
 		let refName = "";
 		if (Base.isRef(schema)) {
-			refName = Base.upperCamelCase(Base.ref2name(schema.$ref));
+			refName = this.formatRefName(Base.ref2name(schema.$ref));
 			if (reserveRef) return { type: upLevelSchemaKey + refName };
-			if (!this.doc.definitions) this.doc.definitions = {};
-			schema = this.doc.definitions[Base.ref2name(schema.$ref, this.doc)];
+			const resolvedSchema = this.getSchemaContainer()?.[Base.ref2name(schema.$ref, this.doc)];
+			if (!resolvedSchema) return { type: "unknown" };
+			schema = resolvedSchema;
 		}
 		return this.toBaseSchema(schema, enums, "", upLevelSchemaKey + refName);
 	}
 	/**
-	* Transform all OpenAPI schema to Base Schema
-	*/
-	toBaseSchema(schema, enums = [], schemaKey = "", upLevelSchemaKey = "") {
-		if (!schema) return { type: "unknown" };
-		if (Base.isRef(schema)) return this.getSchemaByRef(schema, true);
-		if (this.isOpenAPIArraySchema(schema)) {
-			const { type, description, items, required } = schema;
-			return {
-				type,
-				required: !!required,
-				description,
-				items: this.toBaseSchema(items, enums, schemaKey, upLevelSchemaKey)
-			};
-		} else {
-			const { required = [], allOf, anyOf, description, enum: enum_, format, oneOf, properties = {} } = schema;
-			let { type } = schema;
-			if (enum_ && type !== "boolean") {
-				const enumObject = {
-					name: Base.upperCamelCase(Base.normalize(upLevelSchemaKey)) + Base.upperCamelCase(Base.normalize(schemaKey)),
-					enum: [...new Set(enum_)]
-				};
-				const sameObject = Base.findSameSchema(enumObject, enums);
-				if (!sameObject && Base.isValidEnumType(schema)) enums.push(enumObject);
-				return {
-					type: sameObject ? sameObject.name : Base.isBooleanEnum(schema) ? "boolean" : enumObject.name,
-					required,
-					description
-				};
-			}
-			if (type === void 0 && Object.keys(properties).length > 0) type = "object";
-			return {
-				type,
-				required,
-				description,
-				enum: enum_,
-				format,
-				allOf: allOf?.map((s) => Base.isRef(s) ? {
-					...s,
-					ref: s.$ref,
-					type: Base.capitalize(Base.ref2name(s.$ref, this.doc))
-				} : this.toBaseSchema(s, enums)),
-				anyOf: anyOf?.map((s) => Base.isRef(s) ? {
-					...s,
-					ref: s.$ref,
-					type: Base.capitalize(Base.ref2name(s.$ref, this.doc))
-				} : this.toBaseSchema(s, enums)),
-				oneOf: oneOf?.map((s) => Base.isRef(s) ? {
-					...s,
-					ref: s.$ref,
-					type: Base.capitalize(Base.ref2name(s.$ref, this.doc))
-				} : this.toBaseSchema(s, enums)),
-				properties: Object.keys(properties).reduce((acc, p) => {
-					const propSchema = properties[p];
-					return {
-						...acc,
-						[p]: Base.isRef(propSchema) ? { type: Base.capitalize(Base.ref2name(propSchema.$ref, this.doc)) } : this.toBaseSchema(propSchema, enums, p, upLevelSchemaKey)
-					};
-				}, {})
-			};
-		}
-	}
-	/**
-	* OpenAPI parameter to base parameter.
-	*/
-	getParameterByRef(parameter, enums = [], upLevelSchemaKey = "") {
-		if (Base.isRef(parameter)) {
-			const refName = Base.ref2name(parameter.$ref, this.doc);
-			const resolved = this.doc.parameters?.[refName];
-			if (!resolved) throw new Error(`Parameter reference not found: ${parameter.$ref}`);
-			parameter = resolved;
-		}
-		const p = parameter;
-		const { name, required, description, type, items, enum: enum_, properties, schema } = p;
-		if (enum_) {
-			const type = Base.upperCamelCase(Base.normalize(upLevelSchemaKey)) + Base.upperCamelCase(Base.normalize(name));
-			const enumSchema = {
-				name: type,
-				enum: [...new Set(enum_)]
-			};
-			const sameEnum = Base.findSameSchema(enumSchema, enums);
-			if (!sameEnum && Base.isValidEnumType({
-				type,
-				enum: enum_
-			})) enums.push(enumSchema);
-			return {
-				name,
-				required,
-				description,
-				in: p.in,
-				schema: { type: sameEnum?.name ?? type }
-			};
-		}
-		if (items) return {
-			name,
-			required,
-			description,
-			in: p.in,
-			schema: {
-				type,
-				items
-			}
-		};
-		if (schema && Base.isRef(schema)) return {
-			name,
-			required,
-			description,
-			in: p.in,
-			schema: { type: Base.capitalize(Base.ref2name(schema.$ref)) }
-		};
-		return {
-			name,
-			required,
-			description,
-			in: p.in,
-			schema: {
-				type,
-				properties
-			}
-		};
-	}
-	/**
-	* OpenAPI schema to base response
+	* Format a ref name for the schema's `type` field.
+	* V3 uses `capitalize`; V3_1 uses `upperCamelCase` (preserved for compat).
 	*/
-	getResponseByRef(schema) {
-		if (Base.isRef(schema)) schema = this.doc.responses[Base.ref2name(schema.$ref, this.doc)];
-		const { schema: responseSchema } = schema;
-		return [{
-			type: "application/json",
-			schema: responseSchema && this.getSchemaByRef(responseSchema, true)
-		}];
-	}
-	init() {
-		const { definitions = {}, responses = {}, paths = {} } = this.doc;
-		const enums = [];
-		const definitions_ = Object.keys(definitions).reduce((acc, key) => {
-			const schema = definitions[key];
-			return {
-				...acc,
-				[key]: this.getSchemaByRef(schema, false, enums, key)
-			};
-		}, {});
-		const responses_ = Object.keys(responses).reduce((acc, key) => {
-			const response = responses[key];
-			return {
-				...acc,
-				[key]: this.getResponseByRef(response)
-			};
-		}, {});
-		const apis = Object.keys(paths).reduce((acc, path) => {
-			let pathObject = paths[path] ?? {};
-			if (pathObject.$ref) {
-				const resolved = this.resolvePathRef(pathObject.$ref);
-				if (resolved) pathObject = resolved;
-			}
-			const { parameters = [] } = pathObject;
-			const methodApis = [];
-			Object.values(HttpMethods).forEach((method) => {
-				const methodObject = pathObject[method];
-				if (methodObject) {
-					const { deprecated, operationId, summary: summary_, description: description_, responses = {} } = methodObject;
-					const { parameters: parameters_ = [] } = methodObject;
-					const baseParameters = [...parameters, ...parameters_].map((parameter) => this.getParameterByRef(parameter, enums));
-					const uniqueParameterName = [...new Set(baseParameters.map((p) => p.name))];
-					if (Object.keys(responses).length === 0) Object.assign(responses, { 200: { description: "Successful response" } });
-					const inBody = baseParameters.filter((p) => p.in === "body" || p.in === "formData");
-					const notInBody = baseParameters.filter((p) => p.in !== "body" && p.in !== "formData");
-					const httpCodes = Object.keys(responses);
-					for (const code of httpCodes) if (code in responses) {
-						const response = responses[code];
-						const responseSchema = this.getResponseByRef(response);
-						const inBodyOnlyHasBody = inBody && inBody.length === 1 && inBody[0].in === "body" && inBody[0].name === "body";
-						methodApis.push({
-							method,
-							operationId,
-							summary: summary_,
-							deprecated,
-							description: description_,
-							parameters: uniqueParameterName.map((name) => notInBody.find((p) => p.name === name)).filter(Boolean),
-							responses: responseSchema,
-							requestBody: inBody.length > 0 ? inBodyOnlyHasBody ? [{
-								type: "application/json",
-								schema: inBody[0].schema
-							}] : [{
-								type: "application/json",
-								schema: {
-									type: "object",
-									properties: inBody.reduce((a, p) => {
-										return {
-											...a,
-											[p.name]: {
-												type: p.schema?.type ?? "unknown",
-												required: p.schema?.required,
-												items: p.schema?.items,
-												description: p.schema?.description
-											}
-										};
-									}, {})
-								}
-							}] : void 0
-						});
-						break;
-					}
-				}
-			});
-			return {
-				...acc,
-				[path]: methodApis
-			};
-		}, {});
-		return {
-			enums: Base.uniqueEnums(enums),
-			schemas: definitions_,
-			responses: responses_,
-			parameters: {},
-			requestBodies: {},
-			apis
-		};
-	}
-};
-//#endregion
-//#region src/openapi/V3.ts
-var V3 = class {
-	doc;
-	constructor(doc) {
-		this.doc = doc;
-	}
-	/**
-	* Resolves a path $ref to the actual path object.
-	*/
-	resolvePathRef($ref) {
-		const refName = Base.ref2name($ref, this.doc);
-		return this.doc.paths?.[refName];
-	}
-	/**
-	* Is array schema.
-	*/
-	isOpenAPIArraySchema(schema) {
-		return typeof schema === "object" && schema.type === "array";
-	}
-	/**
-	* OpenAPI schema to base schema.
-	*/
-	getSchemaByRef(schema, reserveRef = false, enums = [], upLevelSchemaKey = "") {
-		let refName = "";
-		if (Base.isRef(schema)) {
-			refName = Base.capitalize(Base.ref2name(schema.$ref));
-			if (reserveRef) return { type: upLevelSchemaKey + refName };
-			const resolvedSchema = this.doc.components?.schemas?.[Base.ref2name(schema.$ref, this.doc)];
-			if (!resolvedSchema) return { type: "unknown" };
-			schema = resolvedSchema;
-		}
-		return this.toBaseSchema(schema, enums, "", upLevelSchemaKey + refName);
+	formatRefName(name) {
+		return Base.capitalize(name);
 	}
 	/**
-	* OpenAPI parameter to base parameter.
+	* OpenAPI parameter to base parameter. Override in V2 — its parameter
+	* shape is structurally different (top-level `items`/`properties`/`enum`).
 	*/
 	getParameterByRef(schema, enums = [], upLevelSchemaKey = "") {
 		if (Base.isRef(schema)) {
-			const resolvedSchema = this.doc.components?.parameters?.[Base.ref2name(schema.$ref, this.doc)];
+			const resolvedSchema = this.getParameterContainer()?.[Base.ref2name(schema.$ref, this.doc)];
 			if (!resolvedSchema) return {
 				name: "unknown",
 				in: "query"
@@ -1426,37 +1230,38 @@ var V3 = class {
 			description,
 			deprecated,
 			in: schema.in,
-			schema: schema.schema && this.getSchemaByRef(schema.schema, false, enums, upLevelSchemaKey + Base.capitalize(name))
+			schema: schema.schema ? this.getSchemaByRef(schema.schema, false, enums, upLevelSchemaKey + Base.capitalize(name)) : void 0
 		};
 	}
 	/**
-	* OpenAPI schema to base response
+	* OpenAPI schema to base response. Override in V2 (its response shape
+	* lacks the `content` wrapper).
 	*/
 	getResponseByRef(schema) {
 		if (Base.isRef(schema)) {
-			const resolvedSchema = this.doc.components?.responses?.[Base.ref2name(schema.$ref, this.doc)];
+			const resolvedSchema = this.getResponseContainer()?.[Base.ref2name(schema.$ref, this.doc)];
 			if (!resolvedSchema) return [];
 			schema = resolvedSchema;
 		}
 		const { content = {} } = schema;
 		return Object.keys(content).map((c) => ({
 			type: c,
-			schema: content[c].schema && this.getSchemaByRef(content[c].schema, true)
+			schema: content[c].schema ? this.getSchemaByRef(content[c].schema, true) : void 0
 		}));
 	}
 	/**
-	* OpenAPI schema to requestBody.
+	* OpenAPI schema to requestBody. V2 has no requestBody concept.
 	*/
 	getRequestBodyByRef(schema, enums = []) {
 		if (Base.isRef(schema)) {
-			const resolvedSchema = this.doc.components?.requestBodies?.[Base.ref2name(schema.$ref, this.doc)];
+			const resolvedSchema = this.getRequestBodyContainer()?.[Base.ref2name(schema.$ref, this.doc)];
 			if (!resolvedSchema) return [];
 			schema = resolvedSchema;
 		}
 		const { content = {} } = schema;
 		return Object.keys(content).map((c) => ({
 			type: c,
-			schema: content[c].schema && this.getSchemaByRef(content[c].schema, false, enums)
+			schema: content[c].schema ? this.getSchemaByRef(content[c].schema, false, enums) : void 0
 		}));
 	}
 	/**
@@ -1467,92 +1272,98 @@ var V3 = class {
 		if (Base.isRef(schema)) return this.getSchemaByRef(schema, true);
 		if (this.isOpenAPIArraySchema(schema)) {
 			const { type, description, items, required } = schema;
+			const itemsSchema = items ? this.toBaseSchema(items, enums, schemaKey, upLevelSchemaKey) : { type: "unknown" };
 			return {
 				type,
 				required: !!required,
 				description,
-				items: this.toBaseSchema(items, enums, schemaKey, upLevelSchemaKey)
+				items: itemsSchema
 			};
-		} else {
-			const { required = [], allOf, anyOf, description, deprecated, enum: enum_, format, oneOf, properties = {} } = schema;
-			let { type } = schema;
-			if (enum_ && type !== "boolean") {
-				const enumObject = {
-					name: Base.upperCamelCase(Base.normalize(upLevelSchemaKey)) + Base.upperCamelCase(Base.normalize(schemaKey)),
-					enum: [...new Set(enum_)]
-				};
-				const sameObject = Base.findSameSchema(enumObject, enums);
-				if (!sameObject && Base.isValidEnumType(schema)) enums.push(enumObject);
-				return {
-					type: sameObject ? sameObject.name : Base.isBooleanEnum(schema) ? "boolean" : enumObject.name,
-					required,
-					description,
-					deprecated
-				};
-			}
-			if (type === void 0 && Object.keys(properties).length > 0) type = "object";
+		}
+		const { required = [], allOf, anyOf, description, deprecated, enum: enum_, format, oneOf, properties = {} } = schema;
+		let { type } = schema;
+		if (enum_ && type !== "boolean") {
+			const enumObject = {
+				name: Base.upperCamelCase(Base.normalize(upLevelSchemaKey)) + Base.upperCamelCase(Base.normalize(schemaKey)),
+				enum: [...new Set(enum_)]
+			};
+			const sameObject = Base.findSameSchema(enumObject, enums);
+			if (!sameObject && Base.isValidEnumType(schema)) enums.push(enumObject);
 			return {
-				type,
+				type: sameObject ? sameObject.name : Base.isBooleanEnum(schema) ? "boolean" : enumObject.name,
 				required,
 				description,
-				deprecated,
-				enum: enum_,
-				format,
-				allOf: allOf?.map((s) => Base.isRef(s) ? {
-					...s,
-					ref: s.$ref,
-					type: Base.capitalize(Base.ref2name(s.$ref, this.doc))
-				} : this.toBaseSchema(s, enums)),
-				anyOf: anyOf?.map((s) => Base.isRef(s) ? {
-					...s,
-					ref: s.$ref,
-					type: Base.capitalize(Base.ref2name(s.$ref, this.doc))
-				} : this.toBaseSchema(s, enums)),
-				oneOf: oneOf?.map((s) => Base.isRef(s) ? {
-					...s,
-					ref: s.$ref,
-					type: Base.capitalize(Base.ref2name(s.$ref, this.doc))
-				} : this.toBaseSchema(s, enums)),
-				properties: Object.keys(properties).reduce((acc, p) => {
-					const propSchema = properties[p];
-					return {
-						...acc,
-						[p]: Base.isRef(propSchema) ? {
-							type: Base.capitalize(Base.ref2name(propSchema.$ref, this.doc)),
-							isRef: true
-						} : this.toBaseSchema(propSchema, enums, p, upLevelSchemaKey)
-					};
-				}, {})
+				deprecated
 			};
 		}
+		if (type === void 0 && Object.keys(properties).length > 0) type = "object";
+		return {
+			type,
+			required,
+			description,
+			deprecated,
+			enum: enum_,
+			format,
+			allOf: allOf?.map((s) => Base.isRef(s) ? {
+				...s,
+				ref: s.$ref,
+				type: Base.capitalize(Base.ref2name(s.$ref, this.doc))
+			} : this.toBaseSchema(s, enums)),
+			anyOf: anyOf?.map((s) => Base.isRef(s) ? {
+				...s,
+				ref: s.$ref,
+				type: Base.capitalize(Base.ref2name(s.$ref, this.doc))
+			} : this.toBaseSchema(s, enums)),
+			oneOf: oneOf?.map((s) => Base.isRef(s) ? {
+				...s,
+				ref: s.$ref,
+				type: Base.capitalize(Base.ref2name(s.$ref, this.doc))
+			} : this.toBaseSchema(s, enums)),
+			properties: Object.keys(properties).reduce((acc, p) => {
+				const propSchema = properties[p];
+				return {
+					...acc,
+					[p]: Base.isRef(propSchema) ? {
+						type: Base.capitalize(Base.ref2name(propSchema.$ref, this.doc)),
+						isRef: true
+					} : this.toBaseSchema(propSchema, enums, p, upLevelSchemaKey)
+				};
+			}, {})
+		};
 	}
+	/**
+	* Run the parsing pipeline and return a ProviderInitResult.
+	*/
 	init() {
-		const { components = {}, paths = {} } = this.doc;
+		const { paths = {} } = this.doc;
 		const enums = [];
-		const { requestBodies = {}, responses = {}, parameters = {}, schemas = {} } = components;
-		const schemas_ = Object.keys(schemas).reduce((acc, key) => {
-			const schema = schemas[key];
+		const schemaContainer = this.getSchemaContainer() ?? {};
+		const parameterContainer = this.getParameterContainer() ?? {};
+		const responseContainer = this.getResponseContainer() ?? {};
+		const requestBodyContainer = this.getRequestBodyContainer() ?? {};
+		const schemas_ = Object.keys(schemaContainer).reduce((acc, key) => {
+			const schema = schemaContainer[key];
 			return {
 				...acc,
 				[key]: this.getSchemaByRef(schema, false, enums, key)
 			};
 		}, {});
-		const parameters_ = Object.keys(parameters).reduce((acc, key) => {
-			const parameter = parameters[key];
+		const parameters_ = Object.keys(parameterContainer).reduce((acc, key) => {
+			const parameter = parameterContainer[key];
 			return {
 				...acc,
 				[key]: this.getParameterByRef(parameter, enums, key)
 			};
 		}, {});
-		const responses_ = Object.keys(responses).reduce((acc, key) => {
-			const response = responses[key];
+		const responses_ = Object.keys(responseContainer).reduce((acc, key) => {
+			const response = responseContainer[key];
 			return {
 				...acc,
 				[key]: this.getResponseByRef(response)
 			};
 		}, {});
-		const requestBodies_ = Object.keys(requestBodies).reduce((acc, key) => {
-			const requestBody = requestBodies[key];
+		const requestBodies_ = Object.keys(requestBodyContainer).reduce((acc, key) => {
+			const requestBody = requestBodyContainer[key];
 			return {
 				...acc,
 				[key]: this.getRequestBodyByRef(requestBody, enums)
@@ -1569,15 +1380,16 @@ var V3 = class {
 			Object.values(HttpMethods).forEach((method) => {
 				const methodObject = pathObject[method];
 				if (methodObject) {
-					const { deprecated, operationId, responses = {}, summary: summary_, description: description_, requestBody = { content: {} } } = methodObject;
+					const { deprecated, operationId, responses, summary: summary_, description: description_, requestBody = { content: {} } } = methodObject;
+					const responsesClone = responses ? { ...responses } : {};
 					const { parameters: parameters_ = [] } = methodObject;
 					const baseParameters = [...parameters, ...parameters_].map((parameter) => this.getParameterByRef(parameter, enums));
 					const baseRequestBody = this.getRequestBodyByRef(requestBody, enums);
 					const uniqueParameterName = [...new Set(baseParameters.map((p) => p.name))];
-					if (Object.keys(responses).length === 0) Object.assign(responses, { 200: { description: "Successful response" } });
-					const httpCodes = Object.keys(responses);
-					for (const code of httpCodes) if (code in responses) {
-						const response = responses[code];
+					if (Object.keys(responsesClone).length === 0) responsesClone[200] = { description: "Successful response" };
+					const httpCodes = Object.keys(responsesClone);
+					for (const code of httpCodes) if (code in responsesClone) {
+						const response = responsesClone[code];
 						const responseSchema = this.getResponseByRef(response);
 						methodApis.push({
 							method,
@@ -1609,246 +1421,248 @@ var V3 = class {
 	}
 };
 //#endregion
-//#region src/openapi/V3_1.ts
-var V3_1 = class {
+//#region src/openapi/V2.ts
+var V2 = class extends VersionedProvider {
 	doc;
+	version = "v2";
 	constructor(doc) {
+		super();
 		this.doc = doc;
 	}
-	/**
-	* Resolves a path $ref to the actual path object.
-	*/
-	resolvePathRef($ref) {
-		const refName = Base.ref2name($ref, this.doc);
-		return this.doc.paths?.[refName];
+	getSchemaContainer() {
+		return this.doc.definitions;
 	}
-	/**
-	* Is array schema.
-	*/
-	isOpenAPIArraySchema(schema) {
-		return typeof schema === "object" && schema.type === "array";
+	getParameterContainer() {
+		return this.doc.parameters;
 	}
-	/**
-	* OpenAPI schema to base schema.
-	*/
-	getSchemaByRef(schema, reserveRef = false, enums = [], upLevelSchemaKey = "") {
-		let refName = "";
-		if (Base.isRef(schema)) {
-			refName = Base.upperCamelCase(Base.ref2name(schema.$ref));
-			if (reserveRef) return { type: upLevelSchemaKey + refName };
-			if (!this.doc.components) this.doc.components = { schemas: {} };
-			const resolvedSchema = this.doc.components.schemas?.[Base.ref2name(schema.$ref, this.doc)];
-			if (!resolvedSchema) throw new Error(`Schema reference not found: ${refName}`);
-			schema = resolvedSchema;
-		}
-		return this.toBaseSchema(schema, enums, "", upLevelSchemaKey + refName);
+	getResponseContainer() {
+		return this.doc.responses;
 	}
+	getRequestBodyContainer() {}
 	/**
-	* OpenAPI parameter to base parameter.
+	* V2 parameter shape differs from V3: top-level `items`/`properties`/`enum`
+	* rather than nested under `schema`. Override accordingly.
 	*/
-	getParameterByRef(schema, enums = [], upLevelSchemaKey = "") {
-		if (Base.isRef(schema)) schema = this.doc.components?.parameters?.[Base.ref2name(schema.$ref, this.doc)];
-		const { name, required, deprecated, description, schema: parameterSchema } = schema;
-		if (parameterSchema && !Base.isRef(parameterSchema) && parameterSchema.enum) {
-			const type = Base.upperCamelCase(Base.normalize(upLevelSchemaKey)) + Base.upperCamelCase(Base.normalize(name));
+	getParameterByRef(parameter, enums = [], upLevelSchemaKey = "") {
+		if (Base.isRef(parameter)) {
+			const refName = Base.ref2name(parameter.$ref, this.doc);
+			const resolved = this.doc.parameters?.[refName];
+			if (!resolved) throw new Error(`Parameter reference not found: ${parameter.$ref}`);
+			parameter = resolved;
+		}
+		const p = parameter;
+		const { name, required, description, type, items, enum: enum_, properties, schema } = p;
+		if (enum_) {
+			const enumType = Base.upperCamelCase(Base.normalize(upLevelSchemaKey)) + Base.upperCamelCase(Base.normalize(name));
 			const enumSchema = {
-				name: type,
-				enum: [...new Set(parameterSchema.enum)]
+				name: enumType,
+				enum: [...new Set(enum_)]
 			};
 			const sameEnum = Base.findSameSchema(enumSchema, enums);
-			if (!sameEnum && Base.isValidEnumType(parameterSchema)) enums.push(enumSchema);
+			if (!sameEnum && Base.isValidEnumType({
+				type: enumType,
+				enum: enum_
+			})) enums.push(enumSchema);
 			return {
 				name,
 				required,
 				description,
-				deprecated,
-				in: schema.in,
-				schema: { type: sameEnum?.name ?? type }
+				in: p.in,
+				schema: { type: sameEnum?.name ?? enumType }
 			};
 		}
+		if (items) return {
+			name,
+			required,
+			description,
+			in: p.in,
+			schema: {
+				type,
+				items
+			}
+		};
+		if (schema && Base.isRef(schema)) return {
+			name,
+			required,
+			description,
+			in: p.in,
+			schema: { type: Base.capitalize(Base.ref2name(schema.$ref)) }
+		};
 		return {
 			name,
 			required,
 			description,
-			deprecated,
-			in: schema.in,
-			schema: schema.schema && this.getSchemaByRef(schema.schema, false, enums, upLevelSchemaKey + Base.capitalize(name))
+			in: p.in,
+			schema: {
+				type,
+				properties
+			}
 		};
 	}
 	/**
-	* OpenAPI schema to base response
+	* V2 response shape: a `schema` field directly, not `content`. V2 always
+	* emits JSON.
 	*/
 	getResponseByRef(schema) {
-		if (Base.isRef(schema)) schema = this.doc.components?.responses?.[Base.ref2name(schema.$ref, this.doc)];
-		const { content = {} } = schema;
-		return Object.keys(content).map((c) => ({
-			type: c,
-			schema: content[c].schema && this.getSchemaByRef(content[c].schema, true)
-		}));
-	}
-	/**
-	* OpenAPI schema to requestBody.
-	*/
-	getRequestBodyByRef(schema, enums = []) {
-		if (Base.isRef(schema)) schema = this.doc.components?.requestBodies?.[Base.ref2name(schema.$ref, this.doc)];
-		const { content = {} } = schema;
-		return Object.keys(content).map((c) => ({
-			type: c,
-			schema: content[c].schema && this.getSchemaByRef(content[c].schema, true, enums)
-		}));
+		if (Base.isRef(schema)) schema = this.doc.responses[Base.ref2name(schema.$ref, this.doc)];
+		const { schema: responseSchema } = schema;
+		return [{
+			type: "application/json",
+			schema: responseSchema ? this.getSchemaByRef(responseSchema, true) : void 0
+		}];
 	}
 	/**
-	* Transform all OpenAPI schema to Base Schema
+	* V2 has no `requestBody` concept; parameters with `in: body` or
+	* `in: formData` are split out and turned into a synthetic requestBody
+	* here. A single body param named `body` is used directly; otherwise
+	* the body / formData params are wrapped in a synthetic object.
 	*/
-	toBaseSchema(schema, enums = [], schemaKey = "", upLevelSchemaKey = "") {
-		if (!schema) return { type: "unknown" };
-		if (Base.isRef(schema)) return this.getSchemaByRef(schema, true);
-		if (this.isOpenAPIArraySchema(schema)) {
-			const { type, description, items, required } = schema;
-			return {
-				type,
-				required: !!required,
-				description,
-				items: this.toBaseSchema(items, enums, schemaKey, upLevelSchemaKey)
-			};
-		} else {
-			const { required = [], allOf, anyOf, description, deprecated, enum: enum_, format, oneOf, properties = {} } = schema;
-			let { type } = schema;
-			if (enum_ && type !== "boolean") {
-				const enumObject = {
-					name: Base.upperCamelCase(Base.normalize(upLevelSchemaKey)) + Base.upperCamelCase(Base.normalize(schemaKey)),
-					enum: [...new Set(enum_)]
-				};
-				const sameObject = Base.findSameSchema(enumObject, enums);
-				if (!sameObject && Base.isValidEnumType(schema)) enums.push(enumObject);
-				return {
-					type: sameObject ? sameObject.name : Base.isBooleanEnum(schema) ? "boolean" : enumObject.name,
-					required,
-					description,
-					deprecated
-				};
-			}
-			if (type === void 0 && Object.keys(properties).length > 0) type = "object";
-			return {
-				type,
-				required,
-				description,
-				deprecated,
-				enum: enum_,
-				format,
-				allOf: allOf?.map((s) => Base.isRef(s) ? {
-					...s,
-					ref: s.$ref,
-					type: Base.capitalize(Base.ref2name(s.$ref, this.doc))
-				} : this.toBaseSchema(s, enums)),
-				anyOf: anyOf?.map((s) => Base.isRef(s) ? {
-					...s,
-					ref: s.$ref,
-					type: Base.capitalize(Base.ref2name(s.$ref, this.doc))
-				} : this.toBaseSchema(s, enums)),
-				oneOf: oneOf?.map((s) => Base.isRef(s) ? {
-					...s,
-					ref: s.$ref,
-					type: Base.capitalize(Base.ref2name(s.$ref, this.doc))
-				} : this.toBaseSchema(s, enums)),
-				properties: Object.keys(properties).reduce((acc, p) => {
-					const propSchema = properties[p];
-					return {
-						...acc,
-						[p]: Base.isRef(propSchema) ? {
-							type: Base.capitalize(Base.ref2name(propSchema.$ref, this.doc)),
-							isRef: true
-						} : this.toBaseSchema(propSchema, enums, p, upLevelSchemaKey)
-					};
-				}, {})
-			};
-		}
-	}
 	init() {
-		const { components = {}, paths = {} } = this.doc;
+		const { paths = {} } = this.doc;
 		const enums = [];
-		const { requestBodies = {}, responses = {}, parameters = {}, schemas = {} } = components;
-		const schemas_ = Object.keys(schemas).reduce((acc, key) => {
-			const schema = schemas[key];
+		const schemaContainer = this.getSchemaContainer() ?? {};
+		const parameterContainer = this.getParameterContainer() ?? {};
+		const responseContainer = this.getResponseContainer() ?? {};
+		const schemas_ = Object.keys(schemaContainer).reduce((acc, key) => {
+			const schema = schemaContainer[key];
 			return {
 				...acc,
 				[key]: this.getSchemaByRef(schema, false, enums, key)
 			};
 		}, {});
-		const parameters_ = Object.keys(parameters).reduce((acc, key) => {
-			const parameter = parameters[key];
+		const parameters_ = Object.keys(parameterContainer).reduce((acc, key) => {
+			const parameter = parameterContainer[key];
 			return {
 				...acc,
 				[key]: this.getParameterByRef(parameter, enums, key)
 			};
 		}, {});
-		const responses_ = Object.keys(responses).reduce((acc, key) => {
-			const response = responses[key];
+		const responses_ = Object.keys(responseContainer).reduce((acc, key) => {
+			const response = responseContainer[key];
 			return {
 				...acc,
 				[key]: this.getResponseByRef(response)
 			};
 		}, {});
-		const requestBodies_ = Object.keys(requestBodies).reduce((acc, key) => {
-			const requestBody = requestBodies[key];
-			return {
-				...acc,
-				[key]: this.getRequestBodyByRef(requestBody, enums)
-			};
-		}, {});
-		const apis = Object.keys(paths).reduce((acc, path) => {
+		const apis = {};
+		for (const path of Object.keys(paths)) {
 			let pathObject = paths[path] ?? {};
 			if (pathObject.$ref) {
 				const resolved = this.resolvePathRef(pathObject.$ref);
 				if (resolved) pathObject = resolved;
 			}
-			const { parameters = [], description, summary } = pathObject;
+			const { parameters = [] } = pathObject;
 			const methodApis = [];
 			Object.values(HttpMethods).forEach((method) => {
 				const methodObject = pathObject[method];
-				if (methodObject) {
-					const { deprecated, operationId, summary: summary_, description: description_, responses = {}, requestBody = { content: {} } } = methodObject;
-					const { parameters: parameters_ = [] } = methodObject;
-					const baseParameters = [...parameters, ...parameters_].map((parameter) => this.getParameterByRef(parameter, enums));
-					const baseRequestBody = this.getRequestBodyByRef(requestBody, enums);
-					const uniqueParameterName = [...new Set(baseParameters.map((p) => p.name))];
-					if (Object.keys(responses).length === 0) Object.assign(responses, { 200: { description: "Successful response" } });
-					const httpCodes = Object.keys(responses);
-					for (const code of httpCodes) if (code in responses) {
-						const response = responses[code];
-						const responseSchema = this.getResponseByRef(response);
-						methodApis.push({
-							method,
-							operationId,
-							summary: summary_ ?? summary,
-							description: description_ ?? description,
-							deprecated,
-							parameters: uniqueParameterName.map((name) => baseParameters.find((p) => p.name === name)).filter((p) => p !== void 0),
-							responses: responseSchema,
-							requestBody: baseRequestBody
-						});
-						break;
-					}
+				if (!methodObject) return;
+				const { deprecated, operationId, summary: summary_, description: description_, responses } = methodObject;
+				const { parameters: parameters_ = [] } = methodObject;
+				const baseParameters = [...parameters, ...parameters_].map((p) => this.getParameterByRef(p, enums));
+				const uniqueParameterName = [...new Set(baseParameters.map((p) => p.name))];
+				const responsesClone = responses ? { ...responses } : {};
+				if (Object.keys(responsesClone).length === 0) responsesClone[200] = { description: "Successful response" };
+				const inBody = baseParameters.filter((p) => p.in === "body" || p.in === "formData");
+				const notInBody = baseParameters.filter((p) => p.in !== "body" && p.in !== "formData");
+				const httpCodes = Object.keys(responsesClone);
+				for (const code of httpCodes) if (code in responsesClone) {
+					const response = responsesClone[code];
+					const responseSchema = this.getResponseByRef(response);
+					const inBodyOnlyHasBody = inBody.length === 1 && inBody[0].in === "body" && inBody[0].name === "body";
+					methodApis.push({
+						method,
+						operationId,
+						summary: summary_,
+						deprecated,
+						description: description_,
+						parameters: uniqueParameterName.map((name) => notInBody.find((p) => p.name === name)).filter((p) => p !== void 0),
+						responses: responseSchema,
+						requestBody: inBody.length > 0 ? inBodyOnlyHasBody ? [{
+							type: "application/json",
+							schema: inBody[0].schema
+						}] : [{
+							type: "application/json",
+							schema: {
+								type: "object",
+								properties: inBody.reduce((a, p) => {
+									return {
+										...a,
+										[p.name]: {
+											type: p.schema?.type ?? "unknown",
+											required: p.schema?.required,
+											items: p.schema?.items,
+											description: p.schema?.description
+										}
+									};
+								}, {})
+							}
+						}] : void 0
+					});
+					break;
 				}
 			});
-			return {
-				...acc,
-				[path]: methodApis
-			};
-		}, {});
+			apis[path] = methodApis;
+		}
 		return {
 			enums: Base.uniqueEnums(enums),
 			schemas: schemas_,
 			responses: responses_,
 			parameters: parameters_,
-			requestBodies: requestBodies_,
+			requestBodies: {},
 			apis
 		};
 	}
 };
 //#endregion
+//#region src/openapi/V3.ts
+var V3 = class extends VersionedProvider {
+	doc;
+	version = "v3";
+	constructor(doc) {
+		super();
+		this.doc = doc;
+	}
+	getSchemaContainer() {
+		return this.doc.components?.schemas;
+	}
+	getParameterContainer() {
+		return this.doc.components?.parameters;
+	}
+	getResponseContainer() {
+		return this.doc.components?.responses;
+	}
+	getRequestBodyContainer() {
+		return this.doc.components?.requestBodies;
+	}
+};
+//#endregion
+//#region src/openapi/V3_1.ts
+var V3_1 = class extends VersionedProvider {
+	doc;
+	version = "v3_1";
+	constructor(doc) {
+		super();
+		this.doc = doc;
+	}
+	formatRefName(name) {
+		return Base.upperCamelCase(name);
+	}
+	getSchemaContainer() {
+		return this.doc.components?.schemas;
+	}
+	getParameterContainer() {
+		return this.doc.components?.parameters;
+	}
+	getResponseContainer() {
+		return this.doc.components?.responses;
+	}
+	getRequestBodyContainer() {
+		return this.doc.components?.requestBodies;
+	}
+};
+//#endregion
 //#region src/openapi/index.ts
-const logger$1 = createScopedLogger("OpenAPI");
+const logger = createScopedLogger("OpenAPI");
 function getDocVersion(doc) {
 	switch ((doc.openapi || doc.swagger).slice(0, 3)) {
 		case "3.1": return "v3_1";
@@ -1860,7 +1674,7 @@ function getDocVersion(doc) {
 var OpenAPIProvider = class extends Provider {
 	parse(doc) {
 		const version = getDocVersion(doc);
-		logger$1.debug(`openapi version ${version}`);
+		logger.debug(`openapi version ${version}`);
 		switch (version) {
 			case "v2": return new V2(doc).init();
 			case "v3": return new V3(doc).init();
@@ -1878,9 +1692,9 @@ function getAdaptor(type) {
 async function codeGen(initOptions) {
 	const startTime = Date.now();
 	const { verbose } = initOptions;
-	if (verbose) logger$1.setLevel("debug");
-	else logger$1.setLevel("info");
-	logger$1.info(`Fetch document from ${initOptions.docURL}`);
+	if (verbose) logger.setLevel("debug");
+	else logger.setLevel("info");
+	logger.info(`Fetch document from ${initOptions.docURL}`);
 	const { enums, schemas, parameters, responses, requestBodies, apis } = new OpenAPIProvider(initOptions, await Base.fetchDoc(initOptions.docURL, initOptions.requestOptions));
 	const adaptor = getAdaptor(initOptions.adaptor ?? "fetch");
 	const code = await Generator.genCode({
@@ -1905,7 +1719,7 @@ async function codeGen(initOptions) {
 //#endregion
 //#region src/vite-plugin/index.ts
 const PLUGIN_NAME = "api-code-gen";
-const logger = createScopedLogger("api-code-gen");
+const pluginLogger = createScopedLogger("api-code-gen");
 /**
 * Run TypeScript type checking on generated file
 */
@@ -1934,7 +1748,7 @@ async function validateSpecPath(specPath) {
 async function generateForOption(option) {
 	const { name, typeCheck = true, verbose, ...restOptions } = option;
 	try {
-		console.log(`\x1b[36m├─\x1b[0m ${name}`);
+		logger$1.info(`Generating ${name}...`);
 		const config = await loadConfig({
 			name,
 			cliOptions: {
@@ -1958,8 +1772,8 @@ async function generateForOption(option) {
 		if (typeCheck && config.output) {
 			const typeErrors = await runTypeCheck(config.output);
 			if (typeErrors.length > 0) {
-				logger.warn(`Type check failed for ${config.output}`);
-				if (verbose) for (const error of typeErrors) logger.warn(`  ${error}`);
+				pluginLogger.warn(`Type check failed for ${config.output}`);
+				if (verbose) for (const error of typeErrors) pluginLogger.warn(`  ${error}`);
 			}
 		}
 		return {
@@ -2000,45 +1814,47 @@ async function generateForOption(option) {
 */
 function apiCodeGenPlugin(options) {
 	if (!Array.isArray(options) || options.length === 0) {
-		logger.warn("No API configurations provided to apiCodeGenPlugin");
+		pluginLogger.warn("No API configurations provided to apiCodeGenPlugin");
 		return { name: PLUGIN_NAME };
 	}
 	return {
 		name: PLUGIN_NAME,
 		async config(_config, env) {
-			console.log(`\x1b[1m\x1b[36m${"─".repeat(50)}\x1b[0m`);
-			console.log(`\x1b[1m\x1b[36mAPI Code Gen\x1b[0m`);
-			console.log(`\x1b[90mMode:\x1b[0m ${env?.command || "unknown"}`);
-			console.log(`\x1b[1m\x1b[36m${"─".repeat(50)}\x1b[0m`);
+			logger$1.heading("API Code Gen", env?.command);
 			const results = await Promise.all(options.map(generateForOption));
 			const successCount = results.filter((r) => r.success).length;
 			const failCount = options.length - successCount;
-			console.log(`\x1b[1m\x1b[36m${"─".repeat(50)}\x1b[0m`);
+			logger$1.divider();
 			for (const result of results) if (result.success) {
 				const { name, output, stats } = result;
-				if (stats) console.log(`\x1b[32m✓\x1b[0m ${name} → ${output} (${stats.endpoints} endpoints, ${stats.schemas} schemas) ${stats.duration}ms`);
-				else console.log(`\x1b[32m✓\x1b[0m ${name} → ${output || "N/A"}`);
+				if (stats) logger$1.item(`${name} → ${output} (${stats.endpoints} endpoints, ${stats.schemas} schemas) ${stats.duration}ms`, "green");
+				else logger$1.item(`${name} → ${output || "N/A"}`, "green");
 			} else {
 				const { name, error } = result;
 				if (isApicodegenError(error)) {
-					console.log(`\x1b[31m✗\x1b[0m ${name}`);
-					console.log(`\x1b[90m${formatError(error, true)}\x1b[0m`);
+					logger$1.item(name, "red");
+					logger$1.error(error, true);
 				} else {
 					const wrapped = wrapError(error, {
-						code: "E_GENERATION_FAILED",
+						code: ErrorCodes.GENERATION_FAILED,
 						message: `Failed to generate API "${name}"`
 					});
-					console.log(`\x1b[31m✗\x1b[0m ${name}`);
-					console.log(`\x1b[90m${formatError(wrapped, true)}\x1b[0m`);
+					logger$1.item(name, "red");
+					logger$1.error(wrapped, true);
 				}
 			}
-			console.log(`\x1b[1m\x1b[36m${"─".repeat(50)}\x1b[0m`);
+			logger$1.divider();
 			const totalDuration = results.reduce((sum, r) => sum + (r.stats?.duration || 0), 0);
 			const totalEndpoints = results.reduce((sum, r) => sum + (r.stats?.endpoints || 0), 0);
 			const totalSchemas = results.reduce((sum, r) => sum + (r.stats?.schemas || 0), 0);
-			if (failCount === 0) console.log(`\x1b[32m✓\x1b[0m API Code Gen - Complete (\x1b[90m${successCount}/${options.length} succeeded\x1b[0m, ${totalEndpoints} endpoints, ${totalSchemas} schemas, ${totalDuration}ms\x1b[0m)`);
-			else console.log(`\x1b[33m⚠\x1b[0m API Code Gen - Complete (\x1b[90m${successCount} succeeded, ${failCount} failed\x1b[0m, ${totalEndpoints} endpoints, ${totalSchemas} schemas, ${totalDuration}ms\x1b[0m)`);
-			console.log(`\x1b[1m\x1b[36m${"─".repeat(50)}\x1b[0m`);
+			logger$1.summary({
+				succeeded: successCount,
+				failed: failCount,
+				endpoints: totalEndpoints,
+				schemas: totalSchemas,
+				duration: totalDuration
+			});
+			logger$1.divider();
 			return {};
 		}
 	};