@buenojs/bueno 0.8.4 → 0.8.6

package/src/cli/utils/strings.ts

@@ -9,7 +9,7 @@
  */
 export function camelCase(str: string): string {
 	return str
-		.replace(/[-_\s]+(.)?/g, (_, c) => (c ? c.toUpperCase() : ''))
+		.replace(/[-_\s]+(.)?/g, (_, c) => (c ? c.toUpperCase() : ""))
 		.replace(/^(.)/, (c) => c.toLowerCase());
 }
 
@@ -18,7 +18,7 @@ export function camelCase(str: string): string {
  */
 export function pascalCase(str: string): string {
 	return str
-		.replace(/[-_\s]+(.)?/g, (_, c) => (c ? c.toUpperCase() : ''))
+		.replace(/[-_\s]+(.)?/g, (_, c) => (c ? c.toUpperCase() : ""))
 		.replace(/^(.)/, (c) => c.toUpperCase());
 }
 
@@ -27,8 +27,8 @@ export function pascalCase(str: string): string {
  */
 export function kebabCase(str: string): string {
 	return str
-		.replace(/([a-z])([A-Z])/g, '$1-$2')
-		.replace(/[-_\s]+/g, '-')
+		.replace(/([a-z])([A-Z])/g, "$1-$2")
+		.replace(/[-_\s]+/g, "-")
 		.toLowerCase();
 }
 
@@ -37,8 +37,8 @@ export function kebabCase(str: string): string {
  */
 export function snakeCase(str: string): string {
 	return str
-		.replace(/([a-z])([A-Z])/g, '$1_$2')
-		.replace(/[-\s]+/g, '_')
+		.replace(/([a-z])([A-Z])/g, "$1_$2")
+		.replace(/[-\s]+/g, "_")
 		.toLowerCase();
 }
 
@@ -67,31 +67,45 @@ export function capitalize(str: string): string {
  * Pluralize a word (simple implementation)
  */
 export function pluralize(word: string): string {
-	if (word.endsWith('y') && !['ay', 'ey', 'iy', 'oy', 'uy'].some((e) => word.endsWith(e))) {
-		return word.slice(0, -1) + 'ies';
+	if (
+		word.endsWith("y") &&
+		!["ay", "ey", "iy", "oy", "uy"].some((e) => word.endsWith(e))
+	) {
+		return word.slice(0, -1) + "ies";
 	}
-	if (word.endsWith('s') || word.endsWith('x') || word.endsWith('z') || word.endsWith('ch') || word.endsWith('sh')) {
-		return word + 'es';
+	if (
+		word.endsWith("s") ||
+		word.endsWith("x") ||
+		word.endsWith("z") ||
+		word.endsWith("ch") ||
+		word.endsWith("sh")
+	) {
+		return word + "es";
 	}
-	return word + 's';
+	return word + "s";
 }
 
 /**
  * Singularize a word (simple implementation)
  */
 export function singularize(word: string): string {
-	if (word.endsWith('ies')) {
-		return word.slice(0, -3) + 'y';
+	if (word.endsWith("ies")) {
+		return word.slice(0, -3) + "y";
 	}
-	if (word.endsWith('es')) {
+	if (word.endsWith("es")) {
 		// Check for s, x, z, ch, sh endings
 		const withoutEs = word.slice(0, -2);
-		if (withoutEs.endsWith('s') || withoutEs.endsWith('x') || withoutEs.endsWith('z') ||
-			withoutEs.endsWith('ch') || withoutEs.endsWith('sh')) {
+		if (
+			withoutEs.endsWith("s") ||
+			withoutEs.endsWith("x") ||
+			withoutEs.endsWith("z") ||
+			withoutEs.endsWith("ch") ||
+			withoutEs.endsWith("sh")
+		) {
 			return withoutEs;
 		}
 	}
-	if (word.endsWith('s') && !word.endsWith('ss')) {
+	if (word.endsWith("s") && !word.endsWith("ss")) {
 		return word.slice(0, -1);
 	}
 	return word;
@@ -116,13 +130,13 @@ export function isValidFileName(str: string): boolean {
  */
 export function truncate(str: string, maxLength: number): string {
 	if (str.length <= maxLength) return str;
-	return str.slice(0, maxLength - 3) + '...';
+	return str.slice(0, maxLength - 3) + "...";
 }
 
 /**
  * Pad string to center
  */
-export function padCenter(str: string, length: number, char = ' '): string {
+export function padCenter(str: string, length: number, char = " "): string {
 	const padding = length - str.length;
 	if (padding <= 0) return str;
 	const left = Math.floor(padding / 2);
@@ -134,7 +148,7 @@ export function padCenter(str: string, length: number, char = ' '): string {
  * Remove file extension
  */
 export function removeExtension(filename: string): string {
-	const lastDot = filename.lastIndexOf('.');
+	const lastDot = filename.lastIndexOf(".");
 	if (lastDot === -1 || lastDot === 0) return filename;
 	return filename.slice(0, lastDot);
 }
@@ -143,8 +157,8 @@ export function removeExtension(filename: string): string {
  * Get file extension
  */
 export function getExtension(filename: string): string {
-	const lastDot = filename.lastIndexOf('.');
-	if (lastDot === -1 || lastDot === 0) return '';
+	const lastDot = filename.lastIndexOf(".");
+	if (lastDot === -1 || lastDot === 0) return "";
 	return filename.slice(lastDot + 1);
 }
 
@@ -152,8 +166,8 @@ export function getExtension(filename: string): string {
  * Generate a unique ID
  */
 export function generateId(length = 8): string {
-	const chars = 'abcdefghijklmnopqrstuvwxyz0123456789';
-	let result = '';
+	const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
+	let result = "";
 	for (let i = 0; i < length; i++) {
 		result += chars.charAt(Math.floor(Math.random() * chars.length));
 	}
@@ -164,25 +178,25 @@ export function generateId(length = 8): string {
  * Escape string for use in template literals
  */
 export function escapeTemplateString(str: string): string {
-	return str.replace(/[`\\$]/g, '\\$&');
+	return str.replace(/[`\\$]/g, "\\$&");
 }
 
 /**
  * Escape string for use in regular expressions
  */
 export function escapeRegExp(str: string): string {
-	return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+	return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 
 /**
  * Indent a multiline string
  */
 export function indent(str: string, spaces = 2): string {
-	const indentation = ' '.repeat(spaces);
+	const indentation = " ".repeat(spaces);
 	return str
-		.split('\n')
+		.split("\n")
 		.map((line) => (line.trim() ? indentation + line : line))
-		.join('\n');
+		.join("\n");
 }
 
 /**
@@ -190,8 +204,8 @@ export function indent(str: string, spaces = 2): string {
  */
 export function stripLines(str: string): string {
 	return str
-		.split('\n')
+		.split("\n")
 		.map((line) => line.trim())
-		.join('\n')
-		.replace(/\n{3,}/g, '\n\n');
-}
+		.join("\n")
+		.replace(/\n{3,}/g, "\n\n");
+}

package/src/cli/utils/version.ts

@@ -4,8 +4,8 @@
  * Gets the current version of @buenojs/bueno from package.json
  */
 
-import { readFileSync } from 'fs';
-import { join } from 'path';
+import { readFileSync } from "fs";
+import { join } from "path";
 
 let cachedVersion: string | null = null;
 
@@ -20,14 +20,20 @@ export function getBuenoVersion(): string {
 
 	try {
 		// Try to read from the package.json in the bueno package
-		const packageJsonPath = join(import.meta.dir, '..', '..', '..', 'package.json');
-		const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+		const packageJsonPath = join(
+			import.meta.dir,
+			"..",
+			"..",
+			"..",
+			"package.json",
+		);
+		const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
 		cachedVersion = `^${packageJson.version}`;
 		return cachedVersion;
 	} catch {
 		// Fallback to a default version if package.json can't be read
-		console.warn('Could not read version from package.json, using default');
-		return '^0.8.0';
+		console.warn("Could not read version from package.json, using default");
+		return "^0.8.0";
 	}
 }
 
@@ -36,6 +42,6 @@ export function getBuenoVersion(): string {
  */
 export function getBuenoDependency(): Record<string, string> {
 	return {
-		'@buenojs/bueno': getBuenoVersion(),
+		"@buenojs/bueno": getBuenoVersion(),
 	};
-}
+}

package/src/config/env-validation.ts

@@ -0,0 +1,100 @@
+/**
+ * Environment variable validation for Bueno Framework
+ */
+
+import type { ValidationResult } from "../validation";
+import { validateEnvSync } from "../validation";
+import { envSchema } from "../validation/schemas";
+
+/**
+ * Validate environment variables against the Bueno schema
+ *
+ * @param envVars - Environment variables to validate
+ * @returns Validation result with transformed values or error details
+ */
+export function validateEnvVars(
+	envVars: Record<string, string>,
+): ValidationResult {
+	return validateEnvSync(envSchema, envVars);
+}
+
+/**
+ * Validate and load environment variables from .env files
+ *
+ * @param options - Options for loading and validating environment variables
+ * @returns Validation result with transformed values or error details
+ */
+export async function validateAndLoadEnv(options?: {
+	/** Custom list of env files to load */
+	files?: string[];
+	/** Whether to also load NODE_ENV-specific file */
+	loadNodeEnv?: boolean;
+	/** Base directory for env files */
+	cwd?: string;
+	/** Whether to merge with existing Bun.env */
+	mergeWithProcess?: boolean;
+}): Promise<ValidationResult> {
+	try {
+		// Load environment variables from files
+		const { loadEnvFiles } = await import("./env");
+		const rawEnvVars = await loadEnvFiles(options);
+
+		// Validate the environment variables
+		return validateEnvVars(rawEnvVars);
+	} catch (error) {
+		return {
+			success: false,
+			issues: [
+				{
+					message: `Failed to load and validate environment variables: ${error instanceof Error ? error.message : "Unknown error"}`,
+				},
+			],
+		};
+	}
+}
+
+/**
+ * Get validation error messages as a single string
+ *
+ * @param result - Validation result
+ * @returns Formatted error message or null if valid
+ */
+export function getValidationErrorMessage(
+	result: ValidationResult,
+): string | null {
+	if (result.success) {
+		return null;
+	}
+
+	return result.issues.map((issue) => issue.message).join("\n");
+}
+
+/**
+ * Check if required environment variables are set
+ *
+ * @param envVars - Environment variables to check
+ * @returns True if all required variables are present and valid
+ */
+export function hasRequiredEnvVars(envVars: Record<string, string>): boolean {
+	const result = validateEnvVars(envVars);
+	return result.success;
+}
+
+/**
+ * Get missing required environment variables
+ *
+ * @param envVars - Environment variables to check
+ * @returns Array of missing required variable names
+ */
+export function getMissingEnvVars(envVars: Record<string, string>): string[] {
+	const result = validateEnvVars(envVars);
+	if (result.success) {
+		return [];
+	}
+
+	return result.issues
+		.filter((issue) =>
+			issue.message.includes("This environment variable is required"),
+		)
+		.map((issue) => issue.path?.[0] || "unknown");
+}

package/src/config/env.ts

@@ -2,9 +2,9 @@
  * Environment variable handling for Bueno Framework
  */
 
+import { setNestedValue } from "./merge";
 import type { BuenoConfig, DeepPartial, EnvMapping } from "./types";
 import { ENV_MAPPINGS } from "./types";
-import { setNestedValue } from "./merge";
 
 /**
  * Environment variable source information
@@ -168,6 +168,113 @@ export async function loadEnvFiles(options?: {
 	return result;
 }
 
+// ============= Environment Variable Validation =============
+
+/**
+ * Validate environment variables before loading
+ *
+ * @param envVars - Environment variables to validate
+ * @returns Validation result with transformed values or error details
+ */
+export async function validateEnvVars(
+	envVars: Record<string, string>,
+): Promise<ValidationResult> {
+	try {
+		const { validateEnvVars } = await import("./env-validation");
+		return validateEnvVars(envVars);
+	} catch (error) {
+		return {
+			success: false,
+			issues: [
+				{
+					message: `Failed to validate environment variables: ${error instanceof Error ? error.message : "Unknown error"}`,
+				},
+			],
+		};
+	}
+}
+
+/**
+ * Load and validate environment variables with detailed error reporting
+ *
+ * @param options - Options for loading and validating environment variables
+ * @returns Loaded environment data with validation result
+ */
+export async function loadAndValidateEnv(options?: {
+	/** Custom list of env files to load */
+	files?: string[];
+	/** Whether to also load NODE_ENV-specific file */
+	loadNodeEnv?: boolean;
+	/** Base directory for env files */
+	cwd?: string;
+	/** Whether to merge with existing Bun.env */
+	mergeWithProcess?: boolean;
+	/** Custom environment variable mappings */
+	mappings?: EnvMapping[];
+}): Promise<{ loaded: LoadedEnv; valid: boolean; errors?: string }> {
+	try {
+		// Load environment variables from files
+		const fileVars = await loadEnvFiles(options);
+
+		// Validate the environment variables
+		const validationResult = await validateEnvVars(fileVars);
+
+		// Merge with Bun.env if requested
+		const raw: Record<string, string> =
+			options?.mergeWithProcess !== false
+				? {
+						...fileVars,
+						...Object.fromEntries(
+							Object.entries(Bun.env).filter(([, v]) => v !== undefined) as [
+								string,
+								string,
+							][],
+						),
+					}
+				: fileVars;
+
+		// Transform to config
+		const config = envToConfig(raw, options?.mappings);
+
+		// Track sources
+		const sources = new Map<string, EnvSourceInfo>();
+		for (const [name, value] of Object.entries(raw)) {
+			sources.set(name, {
+				name,
+				value,
+				source: fileVars[name] !== undefined ? ".env file" : "process",
+			});
+		}
+
+		// Set loaded vars to Bun.env
+		for (const [key, value] of Object.entries(fileVars)) {
+			if (Bun.env[key] === undefined) {
+				Bun.env[key] = value;
+			}
+		}
+
+		const loaded: LoadedEnv = { raw, config, sources };
+
+		if (!validationResult.success) {
+			return {
+				loaded,
+				valid: false,
+				errors: validationResult.issues
+					.map((issue) => issue.message)
+					.join("\n"),
+			};
+		}
+
+		return { loaded, valid: true };
+	} catch (error) {
+		return {
+			loaded: { raw: {}, config: {}, sources: new Map() },
+			valid: false,
+			errors: `Failed to load and validate environment variables: ${error instanceof Error ? error.message : "Unknown error"}`,
+		};
+	}
+}
+
 /**
  * Get environment variable value from Bun.env
  */
@@ -233,36 +340,18 @@ export async function loadEnv(options?: {
 	/** Custom environment variable mappings */
 	mappings?: EnvMapping[];
 }): Promise<LoadedEnv> {
-	// Load from .env files
-	const fileVars = await loadEnvFiles(options);
-
-	// Merge with Bun.env if requested
-	const raw: Record<string, string> =
-		options?.mergeWithProcess !== false
-			? { ...fileVars, ...Object.fromEntries(Object.entries(Bun.env).filter(([, v]) => v !== undefined) as [string, string][]) }
-			: fileVars;
-
-	// Transform to config
-	const config = envToConfig(raw, options?.mappings);
-
-	// Track sources
-	const sources = new Map<string, EnvSourceInfo>();
-	for (const [name, value] of Object.entries(raw)) {
-		sources.set(name, {
-			name,
-			value,
-			source: fileVars[name] !== undefined ? ".env file" : "process",
-		});
+	// Load and validate environment variables
+	const result = await loadAndValidateEnv(options);
+
+	if (!result.valid) {
+		console.error("Environment variable validation failed:");
+		console.error(result.errors);
+		throw new Error(
+			"Environment variable validation failed. Check the error messages above.",
+		);
 	}
 
-	// Set loaded vars to Bun.env
-	for (const [key, value] of Object.entries(fileVars)) {
-		if (Bun.env[key] === undefined) {
-			Bun.env[key] = value;
-		}
-	}
-
-	return { raw, config, sources };
+	return result.loaded;
 }
 
 /**
@@ -324,7 +413,7 @@ export function parseEnvBoolean(value: string): boolean {
  * Parse a number environment variable
  */
 export function parseEnvNumber(value: string): number {
-	const num = parseInt(value, 10);
+	const num = Number.parseInt(value, 10);
 	if (isNaN(num)) {
 		throw new Error(`Invalid number: ${value}`);
 	}
@@ -351,22 +440,58 @@ export function parseEnvArray(value: string): string[] {
 export const envConfigMapping: EnvConfigMapping[] = [
 	{ envVar: "BUENO_PORT", configKey: "server.port", transform: parseEnvNumber },
 	{ envVar: "BUENO_HOST", configKey: "server.host" },
-	{ envVar: "BUENO_DEV", configKey: "server.development", transform: parseEnvBoolean },
+	{
+		envVar: "BUENO_DEV",
+		configKey: "server.development",
+		transform: parseEnvBoolean,
+	},
 	{ envVar: "DATABASE_URL", configKey: "database.url" },
-	{ envVar: "DATABASE_POOL_SIZE", configKey: "database.poolSize", transform: parseEnvNumber },
+	{
+		envVar: "DATABASE_POOL_SIZE",
+		configKey: "database.poolSize",
+		transform: parseEnvNumber,
+	},
 	{ envVar: "REDIS_URL", configKey: "cache.url" },
 	{ envVar: "CACHE_DRIVER", configKey: "cache.driver" },
 	{ envVar: "CACHE_TTL", configKey: "cache.ttl", transform: parseEnvNumber },
 	{ envVar: "LOG_LEVEL", configKey: "logger.level" },
-	{ envVar: "LOG_PRETTY", configKey: "logger.pretty", transform: parseEnvBoolean },
-	{ envVar: "HEALTH_ENABLED", configKey: "health.enabled", transform: parseEnvBoolean },
-	{ envVar: "METRICS_ENABLED", configKey: "metrics.enabled", transform: parseEnvBoolean },
-	{ envVar: "TELEMETRY_ENABLED", configKey: "telemetry.enabled", transform: parseEnvBoolean },
+	{
+		envVar: "LOG_PRETTY",
+		configKey: "logger.pretty",
+		transform: parseEnvBoolean,
+	},
+	{
+		envVar: "HEALTH_ENABLED",
+		configKey: "health.enabled",
+		transform: parseEnvBoolean,
+	},
+	{
+		envVar: "METRICS_ENABLED",
+		configKey: "metrics.enabled",
+		transform: parseEnvBoolean,
+	},
+	{
+		envVar: "TELEMETRY_ENABLED",
+		configKey: "telemetry.enabled",
+		transform: parseEnvBoolean,
+	},
 	{ envVar: "TELEMETRY_SERVICE_NAME", configKey: "telemetry.serviceName" },
 	{ envVar: "TELEMETRY_ENDPOINT", configKey: "telemetry.endpoint" },
-	{ envVar: "FRONTEND_DEV_SERVER", configKey: "frontend.devServer", transform: parseEnvBoolean },
-	{ envVar: "FRONTEND_HMR", configKey: "frontend.hmr", transform: parseEnvBoolean },
-	{ envVar: "FRONTEND_PORT", configKey: "frontend.port", transform: parseEnvNumber },
+	{
+		envVar: "FRONTEND_DEV_SERVER",
+		configKey: "frontend.devServer",
+		transform: parseEnvBoolean,
+	},
+	{
+		envVar: "FRONTEND_HMR",
+		configKey: "frontend.hmr",
+		transform: parseEnvBoolean,
+	},
+	{
+		envVar: "FRONTEND_PORT",
+		configKey: "frontend.port",
+		transform: parseEnvNumber,
+	},
 ];
 
 /**
@@ -396,7 +521,10 @@ export function getEnvConfig(
 /**
  * Get an environment variable value
  */
-export function getEnvValue(key: string, defaultValue?: string): string | undefined {
+export function getEnvValue(
+	key: string,
+	defaultValue?: string,
+): string | undefined {
 	return Bun.env[key] ?? defaultValue;
 }
 
@@ -405,4 +533,4 @@ export function getEnvValue(key: string, defaultValue?: string): string | undefi
  */
 export function setEnvValue(key: string, value: string): void {
 	Bun.env[key] = value;
-}
+}