@moccona/apicodegen 0.0.8 → 0.0.10

package/npm/index.cjs

@@ -263,7 +263,9 @@ var Base = class Base {
 	*/
 	static camelCase(text) {
 		text = text.trim();
-		return text.split("_").filter(Boolean).map((t, index) => index === 0 ? t : Base.capitalize(t)).join("");
+		const parts = text.split("_").filter(Boolean);
+		while (parts[0]?.match(/^\d/)) parts.shift();
+		return parts.map((t, index) => index === 0 ? t : Base.capitalize(t)).join("");
 	}
 	/**
 	* Converts a string to UpperCamelCase.
@@ -438,6 +440,250 @@ var Provider = class {
 	}
 };
 //#endregion
+//#region src/core/errors.ts
+/**
+* Error handling utilities for api-codegen
+*/
+const ErrorCodes = {
+	SPEC_NOT_FOUND: "E_SPEC_NOT_FOUND",
+	SPEC_FETCH_FAILED: "E_SPEC_FETCH_FAILED",
+	SPEC_PARSE_FAILED: "E_SPEC_PARSE_FAILED",
+	OUTPUT_DIR_MISSING: "E_OUTPUT_DIR_MISSING",
+	CONFIG_INVALID: "E_CONFIG_INVALID",
+	VALIDATION_FAILED: "E_VALIDATION_FAILED",
+	GENERATION_FAILED: "E_GENERATION_FAILED",
+	TYPE_CHECK_FAILED: "E_TYPE_CHECK_FAILED"
+};
+/**
+* Custom error class for api-codegen with rich context
+*/
+var ApicodegenError = class ApicodegenError extends Error {
+	code;
+	location;
+	line;
+	column;
+	path;
+	suggestions;
+	cause;
+	constructor(context) {
+		super(context.message);
+		this.name = "ApicodegenError";
+		this.code = context.code;
+		this.location = context.location;
+		this.line = context.line;
+		this.column = context.column;
+		this.path = context.path;
+		this.suggestions = context.suggestions || [];
+		this.cause = context.cause;
+		if (Error.captureStackTrace) Error.captureStackTrace(this, ApicodegenError);
+	}
+	/**
+	* Convert error to formatted string for CLI output
+	*/
+	toString(verbose = false) {
+		const lines = [];
+		lines.push(`\x1b[1;31mError [${this.code}]\x1b[0m ${this.message}`);
+		if (this.location) lines.push(`  \x1b[36m→ Location:\x1b[0m ${this.location}`);
+		if (this.path) lines.push(`  \x1b[36m→ Path:\x1b[0m ${this.path}`);
+		if (this.line !== void 0) {
+			let lineInfo = `  \x1b[36m→ Line:\x1b[0m ${this.line}`;
+			if (this.column !== void 0) lineInfo += `, Column: ${this.column}`;
+			lines.push(lineInfo);
+		}
+		if (this.suggestions.length > 0) for (const suggestion of this.suggestions) lines.push(`  \x1b[32m→ Suggestion:\x1b[0m ${suggestion}`);
+		if (verbose && this.cause) {
+			lines.push(`\n  \x1b[90mOriginal Error:\x1b[0m ${this.cause.message}`);
+			if (this.stack) {
+				const stackLines = this.stack.split("\n").slice(1).join("\n");
+				lines.push(`\x1b[90m${stackLines}\x1b[0m`);
+			}
+		}
+		return lines.join("\n");
+	}
+	/**
+	* Convert to JSON-serializable object
+	*/
+	toJSON() {
+		return {
+			name: this.name,
+			code: this.code,
+			message: this.message,
+			location: this.location,
+			line: this.line,
+			column: this.column,
+			path: this.path,
+			suggestions: this.suggestions,
+			cause: this.cause?.message
+		};
+	}
+};
+/**
+* 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)}`;
+}
+/**
+* Print error to console with formatting
+*/
+function printError(error, verbose = false, stream = process.stderr) {
+	stream.write(formatError(error, verbose));
+	stream.write("\n");
+}
+/**
+* Create error with common patterns
+*/
+const createErrors = {
+	specNotFound(path, cause) {
+		return new ApicodegenError({
+			code: ErrorCodes.SPEC_NOT_FOUND,
+			message: "OpenAPI spec file not found",
+			location: path,
+			suggestions: [
+				"Check if the file exists using 'ls -la'",
+				"Use --spec to provide the correct path",
+				"For remote specs, ensure the URL is accessible"
+			],
+			cause
+		});
+	},
+	specFetchFailed(url, statusCode, cause) {
+		const message = statusCode ? `Failed to fetch OpenAPI spec (HTTP ${statusCode})` : "Failed to fetch OpenAPI spec from URL";
+		return new ApicodegenError({
+			code: ErrorCodes.SPEC_FETCH_FAILED,
+			message,
+			location: url,
+			suggestions: [
+				"Check if the URL is accessible in a browser",
+				"Download the spec file locally and use the local path",
+				"Verify CORS settings if fetching from a different origin"
+			],
+			cause
+		});
+	},
+	specParseFailed(path, line, column, cause) {
+		return new ApicodegenError({
+			code: ErrorCodes.SPEC_PARSE_FAILED,
+			message: "Failed to parse OpenAPI spec (invalid JSON or YAML)",
+			location: path,
+			line,
+			column,
+			suggestions: [
+				"Validate JSON syntax using jsonlint.com",
+				"For YAML specs, ensure proper indentation",
+				"Check for trailing commas or unquoted special characters"
+			],
+			cause
+		});
+	},
+	outputDirMissing(path, cause) {
+		return new ApicodegenError({
+			code: ErrorCodes.OUTPUT_DIR_MISSING,
+			message: "Output directory does not exist",
+			location: path,
+			suggestions: ["Create the directory: mkdir -p $(dirname <output>)", "Check if the path is correct"],
+			cause
+		});
+	},
+	configInvalid(path, cause) {
+		return new ApicodegenError({
+			code: ErrorCodes.CONFIG_INVALID,
+			message: "Invalid configuration file",
+			location: path,
+			suggestions: ["Validate JSON syntax in the config file", "Check for required fields (spec, output)"],
+			cause
+		});
+	},
+	validationFailed(path, details, cause) {
+		return new ApicodegenError({
+			code: ErrorCodes.VALIDATION_FAILED,
+			message: "OpenAPI spec validation failed",
+			location: path,
+			path: details,
+			suggestions: [
+				"Check OpenAPI spec structure at the specified path",
+				"Ensure all required fields are present",
+				"Validate using swagger.io editor"
+			],
+			cause
+		});
+	},
+	generationFailed(cause) {
+		return new ApicodegenError({
+			code: ErrorCodes.GENERATION_FAILED,
+			message: "Code generation failed",
+			suggestions: [
+				"Check for unsupported OpenAPI features",
+				"Ensure spec follows OpenAPI 2.0, 3.0, or 3.1 specification",
+				"Use --verbose for more details"
+			],
+			cause
+		});
+	},
+	typeCheckFailed(path, _errors, cause) {
+		return new ApicodegenError({
+			code: ErrorCodes.TYPE_CHECK_FAILED,
+			message: "TypeScript type check failed",
+			location: path,
+			suggestions: [
+				"Review type errors above",
+				"Check for schema inconsistencies",
+				"Update generated types or fix source schema"
+			],
+			cause
+		});
+	},
+	missingRequiredField(field, context) {
+		return new ApicodegenError({
+			code: ErrorCodes.VALIDATION_FAILED,
+			message: `Missing required field: ${field}`,
+			path: context,
+			suggestions: [`Add the '${field}' field to your configuration`]
+		});
+	}
+};
+/**
+* Wrap unknown error in ApicodegenError if needed
+*/
+function wrapError(error, context) {
+	if (error instanceof ApicodegenError) return error;
+	if (error instanceof Error) return new ApicodegenError({
+		code: context?.code || ErrorCodes.GENERATION_FAILED,
+		message: context?.message || error.message,
+		location: context?.location,
+		suggestions: context?.suggestions,
+		cause: error
+	});
+	return new ApicodegenError({
+		code: context?.code || ErrorCodes.GENERATION_FAILED,
+		message: String(error),
+		suggestions: context?.suggestions
+	});
+}
+/**
+* Check if error is an ApicodegenError
+*/
+function isApicodegenError(error) {
+	return error instanceof ApicodegenError;
+}
+//#endregion
 //#region src/core/generator/index.ts
 var Generator = class Generator {
 	/**
@@ -453,10 +699,19 @@ var Generator = class Generator {
 		return (0, typescript.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 (0, node_fs_promises.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"]
+			});
 		}
 	}
 	/**
@@ -492,9 +747,12 @@ var Generator = class Generator {
 	static addComments(node, comments) {
 		if (!Array.isArray(comments) || comments.filter(Boolean).length === 0) return;
 		const formatComment = (comment) => {
-			return comment.tag ? ` @${comment.tag} ${comment.comment ?? ""}` : ` ${comment.comment}`;
+			if (comment.tag === "returns") return `* @returns {${comment.type}} ${comment.comment ?? ""}`;
+			if (comment.tag === "param") return comment.comment ? `* @param ${comment.paramName} - ${comment.comment}` : `* @param ${comment.paramName}`;
+			if (comment.tag) return `* @${comment.tag} ${comment.comment ?? ""}`;
+			return `* ${comment.comment}`;
 		};
-		const formattedComments = "*\n" + comments.map(formatComment).join("\n").trim() + "\n";
+		const formattedComments = comments.map(formatComment).join("\n").trim() + "\n";
 		(0, typescript.addSyntheticLeadingComment)(node, typescript.SyntaxKind.MultiLineCommentTrivia, formattedComments, true);
 	}
 	/**
@@ -511,6 +769,53 @@ var Generator = class Generator {
 		const nonArraySchema = schema;
 		return nonArraySchema.format === "blob" || nonArraySchema.format === "binary" || nonArraySchema.type === "file";
 	}
+	static schemaToTypeString(schema) {
+		if (schema.type === "array") {
+			const arraySchema = schema;
+			return arraySchema.items ? `${Generator.schemaToTypeString(arraySchema.items)}[]` : "unknown";
+		}
+		const singleSchema = schema;
+		if (schema.type === "string") return "string";
+		if (schema.type === "number" || schema.type === "integer") return "number";
+		if (schema.type === "boolean") return "boolean";
+		if (schema.type === "object" || schema.properties) return "object";
+		if (singleSchema.format === "binary" || singleSchema.type === "file") return "Blob";
+		if (singleSchema.format === "blob") return "Blob";
+		if (singleSchema.ref) return singleSchema.ref;
+		return "unknown";
+	}
+	static generateParamTags(parameters, requestBody) {
+		const tags = [];
+		for (const p of parameters) {
+			const paramName = Base.camelCase(Base.normalize(p.name));
+			let paramType = "unknown";
+			if (p.schema) paramType = Generator.schemaToTypeString(p.schema);
+			const isOptional = p.required === false;
+			tags.push({
+				tag: "param",
+				paramName,
+				type: `${paramType}${isOptional ? " | undefined" : ""}`,
+				comment: p.description ?? ""
+			});
+		}
+		if (requestBody?.schema && "properties" in requestBody.schema) {
+			const properties = requestBody.schema.properties;
+			const required = requestBody.schema.required;
+			const requiredArray = Array.isArray(required) ? required : [];
+			for (const [key, schema] of Object.entries(properties ?? {})) {
+				const paramName = `req.${key}`;
+				const paramType = Generator.schemaToTypeString(schema);
+				const isOptional = !requiredArray.includes(key);
+				tags.push({
+					tag: "param",
+					paramName,
+					type: `${paramType}${isOptional ? " | undefined" : ""}`,
+					comment: schema.description ?? ""
+				});
+			}
+		}
+		return tags;
+	}
 	static toRequestBodyTypeNode(schema) {
 		return typescript.factory.createParameterDeclaration(void 0, void 0, typescript.factory.createIdentifier("req"), void 0, Generator.toTypeNode(schema));
 	}
@@ -589,8 +894,8 @@ var Generator = class Generator {
 				typescript.factory.createIdentifier("file"),
 				typescript.factory.createPropertyAccessExpression(typescript.factory.createAsExpression(typescript.factory.createIdentifier("file"), typescript.factory.createTypeReferenceNode(typescript.factory.createIdentifier("File"), void 0)), typescript.factory.createIdentifier("name"))
 			]))])));
-			else if (schemaByKey.required) statements.push(typescript.factory.createExpressionStatement(typescript.factory.createCallExpression(typescript.factory.createPropertyAccessExpression(typescript.factory.createIdentifier("fd"), typescript.factory.createIdentifier("append")), void 0, [typescript.factory.createStringLiteral(key), schemaByKey.type === "string" ? typescript.factory.createElementAccessExpression(typescript.factory.createIdentifier("req"), typescript.factory.createStringLiteral(key)) : typescript.factory.createCallExpression(typescript.factory.createIdentifier("String"), void 0, [typescript.factory.createElementAccessExpression(typescript.factory.createIdentifier("req"), typescript.factory.createStringLiteral(key))])])));
-			else statements.push(typescript.factory.createExpressionStatement(typescript.factory.createBinaryExpression(typescript.factory.createElementAccessExpression(typescript.factory.createIdentifier("req"), typescript.factory.createStringLiteral(key)), typescript.factory.createToken(typescript.SyntaxKind.AmpersandAmpersandToken), typescript.factory.createCallExpression(typescript.factory.createPropertyAccessExpression(typescript.factory.createIdentifier("fd"), typescript.factory.createIdentifier("append")), void 0, [typescript.factory.createStringLiteral(key), schemaByKey.type === "string" ? typescript.factory.createElementAccessExpression(typescript.factory.createIdentifier("req"), typescript.factory.createStringLiteral(key)) : typescript.factory.createCallExpression(typescript.factory.createIdentifier("String"), void 0, [typescript.factory.createElementAccessExpression(typescript.factory.createIdentifier("req"), typescript.factory.createStringLiteral(key))])]))));
+			else if (schemaByKey.required) statements.push(typescript.factory.createExpressionStatement(typescript.factory.createCallExpression(typescript.factory.createPropertyAccessExpression(typescript.factory.createIdentifier("fd"), typescript.factory.createIdentifier("append")), void 0, [typescript.factory.createStringLiteral(key), schemaByKey.type === "string" || Generator.isBinarySchema(schemaByKey) || schemaByKey.isRef ? typescript.factory.createElementAccessExpression(typescript.factory.createIdentifier("req"), typescript.factory.createStringLiteral(key)) : schemaByKey.type === "array" || schemaByKey.type === "object" ? typescript.factory.createCallExpression(typescript.factory.createPropertyAccessExpression(typescript.factory.createIdentifier("JSON"), typescript.factory.createIdentifier("stringify")), void 0, [typescript.factory.createElementAccessExpression(typescript.factory.createIdentifier("req"), typescript.factory.createStringLiteral(key))]) : typescript.factory.createCallExpression(typescript.factory.createIdentifier("String"), void 0, [typescript.factory.createElementAccessExpression(typescript.factory.createIdentifier("req"), typescript.factory.createStringLiteral(key))])])));
+			else statements.push(typescript.factory.createExpressionStatement(typescript.factory.createBinaryExpression(typescript.factory.createElementAccessExpression(typescript.factory.createIdentifier("req"), typescript.factory.createStringLiteral(key)), typescript.factory.createToken(typescript.SyntaxKind.AmpersandAmpersandToken), typescript.factory.createCallExpression(typescript.factory.createPropertyAccessExpression(typescript.factory.createIdentifier("fd"), typescript.factory.createIdentifier("append")), void 0, [typescript.factory.createStringLiteral(key), schemaByKey.type === "string" || Generator.isBinarySchema(schemaByKey) || schemaByKey.isRef ? typescript.factory.createElementAccessExpression(typescript.factory.createIdentifier("req"), typescript.factory.createStringLiteral(key)) : schemaByKey.type === "array" || schemaByKey.type === "object" ? typescript.factory.createCallExpression(typescript.factory.createPropertyAccessExpression(typescript.factory.createIdentifier("JSON"), typescript.factory.createIdentifier("stringify")), void 0, [typescript.factory.createElementAccessExpression(typescript.factory.createIdentifier("req"), typescript.factory.createStringLiteral(key))]) : typescript.factory.createCallExpression(typescript.factory.createIdentifier("String"), void 0, [typescript.factory.createElementAccessExpression(typescript.factory.createIdentifier("req"), typescript.factory.createStringLiteral(key))])]))));
 		});
 		return statements;
 	}
@@ -602,7 +907,7 @@ var Generator = class Generator {
 		const parametersShouldNotPutInFormData = parameters.filter((p) => !parametersShouldPutInFormData.includes(p));
 		const isRequestBodyContainsBinary = requestBody?.schema && "properties" in requestBody.schema && Object.values(requestBody.schema?.properties ?? {}).some((p) => Generator.isBinarySchema(p));
 		const hasBinaryInParameters = parameters.some((p) => p?.schema && Generator.isBinarySchema(p.schema));
-		const shouldPutParametersOrBodyInFormData = isFormDataRequest || isRequestBodyBinary || hasBinaryInParameters || isRequestBodyContainsBinary || parametersShouldPutInFormData.length > 0;
+		const shouldPutParametersOrBodyInFormData = !!isFormDataRequest && (isRequestBodyBinary || hasBinaryInParameters || isRequestBodyContainsBinary || parametersShouldPutInFormData.length > 0);
 		return typescript.factory.createBlock([...shouldPutParametersOrBodyInFormData ? Generator.toFormDataStatement(parametersShouldPutInFormData, requestBody?.schema) : [], ...adapter.client(uri, method, parametersShouldNotPutInFormData, requestBody, response, adapter, shouldPutParametersOrBodyInFormData, shouldParseResponseToJSON)]);
 	}
 	static schemaToStatemets(parsedDoc, adaptor, options) {
@@ -629,10 +934,11 @@ var Generator = class Generator {
 				const shouldAddExtraMethodNameSuffix = requestBody.length > 1;
 				for (const req of requestBody) {
 					const statement = typescript.factory.createFunctionDeclaration([typescript.factory.createModifier(typescript.SyntaxKind.ExportKeyword), typescript.factory.createModifier(typescript.SyntaxKind.AsyncKeyword)], void 0, Base.pathToFnName(uri, method, operationId) + (shouldAddExtraMethodNameSuffix ? Base.capitalize(req.type.split("/")[1]) : ""), void 0, [...parameters.length > 0 ? Generator.toDeclarationNodes(parameters) : [], ...req?.schema ? [Generator.toRequestBodyTypeNode(req.schema)] : []].filter(Boolean), void 0, Generator.bodyBlock(options.baseURL + uri, method, parameters, req, responses[0], adaptor));
+					const mergedDescription = [description, summary].filter(Boolean).join(". ");
 					Generator.addComments(statement, [
-						description && { comment: description },
-						summary && { comment: summary },
-						deprecated && { tag: "deprecated" }
+						mergedDescription && { comment: mergedDescription },
+						deprecated && { tag: "deprecated" },
+						...Generator.generateParamTags(parameters, req)
 					].filter(Boolean));
 					statements.push(statement);
 				}
@@ -885,20 +1191,6 @@ async function loadConfig(options = {}) {
 	};
 }
 /**
-* Create CLI options from config for commander
-*/
-function configToCLIOptions(config) {
-	const options = {};
-	if (config.spec) options.spec = config.spec;
-	if (config.output) options.output = config.output;
-	if (config.adaptor) options.adaptor = config.adaptor;
-	if (config.baseURL) options.baseURL = config.baseURL;
-	if (config.verbose) options.verbose = config.verbose;
-	if (config.watch) options.watch = config.watch;
-	if (config.importClientSource) options.importClientSource = config.importClientSource;
-	return options;
-}
-/**
 * Convert resolved config to provider options format
 */
 function toProviderOptions(config) {
@@ -913,509 +1205,74 @@ function toProviderOptions(config) {
 	};
 }
 //#endregion
-//#region src/core/errors.ts
-/**
-* Error handling utilities for api-codegen
-*/
-const ErrorCodes = {
-	SPEC_NOT_FOUND: "E_SPEC_NOT_FOUND",
-	SPEC_FETCH_FAILED: "E_SPEC_FETCH_FAILED",
-	SPEC_PARSE_FAILED: "E_SPEC_PARSE_FAILED",
-	OUTPUT_DIR_MISSING: "E_OUTPUT_DIR_MISSING",
-	CONFIG_INVALID: "E_CONFIG_INVALID",
-	VALIDATION_FAILED: "E_VALIDATION_FAILED",
-	GENERATION_FAILED: "E_GENERATION_FAILED",
-	TYPE_CHECK_FAILED: "E_TYPE_CHECK_FAILED"
-};
-/**
-* Custom error class for api-codegen with rich context
-*/
-var ApicodegenError = class ApicodegenError extends Error {
-	code;
-	location;
-	line;
-	column;
-	path;
-	suggestions;
-	cause;
-	constructor(context) {
-		super(context.message);
-		this.name = "ApicodegenError";
-		this.code = context.code;
-		this.location = context.location;
-		this.line = context.line;
-		this.column = context.column;
-		this.path = context.path;
-		this.suggestions = context.suggestions || [];
-		this.cause = context.cause;
-		if (Error.captureStackTrace) Error.captureStackTrace(this, ApicodegenError);
-	}
-	/**
-	* Convert error to formatted string for CLI output
-	*/
-	toString(verbose = false) {
-		const lines = [];
-		lines.push(`\x1b[1;31mError [${this.code}]\x1b[0m ${this.message}`);
-		if (this.location) lines.push(`  \x1b[36m→ Location:\x1b[0m ${this.location}`);
-		if (this.path) lines.push(`  \x1b[36m→ Path:\x1b[0m ${this.path}`);
-		if (this.line !== void 0) {
-			let lineInfo = `  \x1b[36m→ Line:\x1b[0m ${this.line}`;
-			if (this.column !== void 0) lineInfo += `, Column: ${this.column}`;
-			lines.push(lineInfo);
-		}
-		if (this.suggestions.length > 0) for (const suggestion of this.suggestions) lines.push(`  \x1b[32m→ Suggestion:\x1b[0m ${suggestion}`);
-		if (verbose && this.cause) {
-			lines.push(`\n  \x1b[90mOriginal Error:\x1b[0m ${this.cause.message}`);
-			if (this.stack) {
-				const stackLines = this.stack.split("\n").slice(1).join("\n");
-				lines.push(`\x1b[90m${stackLines}\x1b[0m`);
-			}
-		}
-		return lines.join("\n");
-	}
-	/**
-	* Convert to JSON-serializable object
-	*/
-	toJSON() {
-		return {
-			name: this.name,
-			code: this.code,
-			message: this.message,
-			location: this.location,
-			line: this.line,
-			column: this.column,
-			path: this.path,
-			suggestions: this.suggestions,
-			cause: this.cause?.message
-		};
-	}
-};
-/**
-* 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)}`;
-}
-/**
-* Print error to console with formatting
-*/
-function printError(error, verbose = false, stream = process.stderr) {
-	stream.write(formatError(error, verbose));
-	stream.write("\n");
-}
-/**
-* Create error with common patterns
-*/
-const createErrors = {
-	specNotFound(path, cause) {
-		return new ApicodegenError({
-			code: ErrorCodes.SPEC_NOT_FOUND,
-			message: "OpenAPI spec file not found",
-			location: path,
-			suggestions: [
-				"Check if the file exists using 'ls -la'",
-				"Use --spec to provide the correct path",
-				"For remote specs, ensure the URL is accessible"
-			],
-			cause
-		});
-	},
-	specFetchFailed(url, statusCode, cause) {
-		const message = statusCode ? `Failed to fetch OpenAPI spec (HTTP ${statusCode})` : "Failed to fetch OpenAPI spec from URL";
-		return new ApicodegenError({
-			code: ErrorCodes.SPEC_FETCH_FAILED,
-			message,
-			location: url,
-			suggestions: [
-				"Check if the URL is accessible in a browser",
-				"Download the spec file locally and use the local path",
-				"Verify CORS settings if fetching from a different origin"
-			],
-			cause
-		});
-	},
-	specParseFailed(path, line, column, cause) {
-		return new ApicodegenError({
-			code: ErrorCodes.SPEC_PARSE_FAILED,
-			message: "Failed to parse OpenAPI spec (invalid JSON or YAML)",
-			location: path,
-			line,
-			column,
-			suggestions: [
-				"Validate JSON syntax using jsonlint.com",
-				"For YAML specs, ensure proper indentation",
-				"Check for trailing commas or unquoted special characters"
-			],
-			cause
-		});
-	},
-	outputDirMissing(path, cause) {
-		return new ApicodegenError({
-			code: ErrorCodes.OUTPUT_DIR_MISSING,
-			message: "Output directory does not exist",
-			location: path,
-			suggestions: ["Create the directory: mkdir -p $(dirname <output>)", "Check if the path is correct"],
-			cause
-		});
-	},
-	configInvalid(path, cause) {
-		return new ApicodegenError({
-			code: ErrorCodes.CONFIG_INVALID,
-			message: "Invalid configuration file",
-			location: path,
-			suggestions: ["Validate JSON syntax in the config file", "Check for required fields (spec, output)"],
-			cause
-		});
-	},
-	validationFailed(path, details, cause) {
-		return new ApicodegenError({
-			code: ErrorCodes.VALIDATION_FAILED,
-			message: "OpenAPI spec validation failed",
-			location: path,
-			path: details,
-			suggestions: [
-				"Check OpenAPI spec structure at the specified path",
-				"Ensure all required fields are present",
-				"Validate using swagger.io editor"
-			],
-			cause
-		});
-	},
-	generationFailed(cause) {
-		return new ApicodegenError({
-			code: ErrorCodes.GENERATION_FAILED,
-			message: "Code generation failed",
-			suggestions: [
-				"Check for unsupported OpenAPI features",
-				"Ensure spec follows OpenAPI 2.0, 3.0, or 3.1 specification",
-				"Use --verbose for more details"
-			],
-			cause
-		});
-	},
-	typeCheckFailed(path, _errors, cause) {
-		return new ApicodegenError({
-			code: ErrorCodes.TYPE_CHECK_FAILED,
-			message: "TypeScript type check failed",
-			location: path,
-			suggestions: [
-				"Review type errors above",
-				"Check for schema inconsistencies",
-				"Update generated types or fix source schema"
-			],
-			cause
-		});
-	},
-	missingRequiredField(field, context) {
-		return new ApicodegenError({
-			code: ErrorCodes.VALIDATION_FAILED,
-			message: `Missing required field: ${field}`,
-			path: context,
-			suggestions: [`Add the '${field}' field to your configuration`]
-		});
-	}
-};
-/**
-* Wrap unknown error in ApicodegenError if needed
-*/
-function wrapError(error, context) {
-	if (error instanceof ApicodegenError) return error;
-	if (error instanceof Error) return new ApicodegenError({
-		code: context?.code || ErrorCodes.GENERATION_FAILED,
-		message: context?.message || error.message,
-		location: context?.location,
-		suggestions: context?.suggestions,
-		cause: error
-	});
-	return new ApicodegenError({
-		code: context?.code || ErrorCodes.GENERATION_FAILED,
-		message: String(error),
-		suggestions: context?.suggestions
-	});
-}
-/**
-* Check if error is an ApicodegenError
-*/
-function isApicodegenError(error) {
-	return error instanceof ApicodegenError;
-}
-//#endregion
-//#region src/openapi/V2.ts
-var V2 = 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.upperCamelCase(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)];
-		}
-		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
-	*/
-	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
-		};
+//#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 = {
+	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/openapi/V3.ts
-var V3 = 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.
 	*/
@@ -1427,28 +1284,37 @@ var V3 = 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.capitalize(Base.ref2name(schema.$ref));
+			refName = this.formatRefName(Base.ref2name(schema.$ref));
 			if (reserveRef) return { type: upLevelSchemaKey + refName };
-			const resolvedSchema = this.doc.components?.schemas?.[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);
 	}
 	/**
-	* OpenAPI parameter to base parameter.
+	* Format a ref name for the schema's `type` field.
+	* V3 uses `capitalize`; V3_1 uses `upperCamelCase` (preserved for compat).
+	*/
+	formatRefName(name) {
+		return Base.capitalize(name);
+	}
+	/**
+	* 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"
@@ -1479,37 +1345,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
 		}));
 	}
 	/**
@@ -1520,89 +1387,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)) } : 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)
@@ -1619,15 +1495,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,
@@ -1659,241 +1536,246 @@ 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)) } : 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 = (0, _moccona_logger.createScopedLogger)("OpenAPI");
 let OpenAPIVersion = /* @__PURE__ */ function(OpenAPIVersion) {
@@ -1959,7 +1841,7 @@ async function codeGen(initOptions) {
 //#endregion
 //#region src/vite-plugin/index.ts
 const PLUGIN_NAME = "api-code-gen";
-const logger = (0, _moccona_logger.createScopedLogger)("api-code-gen");
+const pluginLogger = (0, _moccona_logger.createScopedLogger)("api-code-gen");
 /**
 * Run TypeScript type checking on generated file
 */
@@ -1988,7 +1870,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.info(`Generating ${name}...`);
 		const config = await loadConfig({
 			name,
 			cliOptions: {
@@ -2012,8 +1894,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 {
@@ -2054,45 +1936,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.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.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.item(`${name} → ${output} (${stats.endpoints} endpoints, ${stats.schemas} schemas) ${stats.duration}ms`, "green");
+				else logger.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.item(name, "red");
+					logger.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.item(name, "red");
+					logger.error(wrapped, true);
 				}
 			}
-			console.log(`\x1b[1m\x1b[36m${"─".repeat(50)}\x1b[0m`);
+			logger.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.summary({
+				succeeded: successCount,
+				failed: failCount,
+				endpoints: totalEndpoints,
+				schemas: totalSchemas,
+				duration: totalDuration
+			});
+			logger.divider();
 			return {};
 		}
 	};
@@ -2120,11 +2004,11 @@ exports.SchemaType = SchemaType;
 exports.SuccessHttpStatusCode = SuccessHttpStatusCode;
 exports.apiCodeGenPlugin = apiCodeGenPlugin;
 exports.codeGen = codeGen;
-exports.configToCLIOptions = configToCLIOptions;
 exports.createErrors = createErrors;
 exports.formatError = formatError;
 exports.isApicodegenError = isApicodegenError;
 exports.loadConfig = loadConfig;
+exports.logger = logger;
 exports.printError = printError;
 exports.toProviderOptions = toProviderOptions;
 exports.wrapError = wrapError;