@geekmidas/envkit 0.3.0 → 0.5.0

package/dist/formatter-fz8V7x6i.mjs

@@ -0,0 +1,113 @@
+import { z } from "zod/v4";
+
+//#region src/formatter.ts
+/**
+* ANSI color codes for terminal output.
+*/
+const colors = {
+	reset: "\x1B[0m",
+	red: "\x1B[31m",
+	yellow: "\x1B[33m",
+	cyan: "\x1B[36m",
+	dim: "\x1B[2m",
+	bold: "\x1B[1m"
+};
+/**
+* Formats a ZodError into a user-friendly string for development.
+*
+* @param error - The ZodError to format
+* @param options - Formatting options
+* @returns Formatted error message
+*
+* @example
+* ```typescript
+* try {
+*   config.parse();
+* } catch (error) {
+*   if (error instanceof ZodError) {
+*     console.error(formatParseError(error));
+*   }
+* }
+* ```
+*
+* Output:
+* ```
+* Environment Configuration Failed
+*
+* Missing Variables:
+*   DATABASE_URL - Required
+*   JWT_SECRET - Required
+*
+* Invalid Values:
+*   NODE_ENV = "invalid"
+*     Expected: "development" | "staging" | "production"
+* ```
+*/
+function formatParseError(error, options = {}) {
+	const useColors = options.colors ?? (process.stdout?.isTTY && process.env.NO_COLOR == null);
+	const c = useColors ? colors : {
+		reset: "",
+		red: "",
+		yellow: "",
+		cyan: "",
+		dim: "",
+		bold: ""
+	};
+	const missingVars = [];
+	const invalidVars = [];
+	for (const issue of error.issues) {
+		let envName = "";
+		if (issue.path.length > 0) envName = String(issue.path[0]);
+		else {
+			const match = issue.message.match(/Environment variable "([^"]+)"/);
+			if (match?.[1]) envName = match[1];
+		}
+		const received = "received" in issue ? issue.received : void 0;
+		const isMissing = issue.code === "invalid_type" && (received === "undefined" || received === "null");
+		if (isMissing) missingVars.push({
+			name: envName || "Unknown",
+			message: cleanMessage(issue.message)
+		});
+		else invalidVars.push({
+			name: envName || "Unknown",
+			value: received,
+			message: cleanMessage(issue.message)
+		});
+	}
+	const lines = [];
+	lines.push("");
+	lines.push(`${c.red}${c.bold}Environment Configuration Failed${c.reset}`);
+	lines.push("");
+	if (missingVars.length > 0) {
+		lines.push(`${c.yellow}Missing Variables:${c.reset}`);
+		for (const v of missingVars) lines.push(`  ${c.cyan}${v.name}${c.reset} ${c.dim}- Required${c.reset}`);
+		lines.push("");
+	}
+	if (invalidVars.length > 0) {
+		lines.push(`${c.yellow}Invalid Values:${c.reset}`);
+		for (const v of invalidVars) {
+			const valueStr = v.value !== void 0 ? ` = ${JSON.stringify(v.value)}` : "";
+			lines.push(`  ${c.cyan}${v.name}${c.reset}${valueStr}`);
+			lines.push(`    ${c.dim}${v.message}${c.reset}`);
+		}
+		lines.push("");
+	}
+	return lines.join("\n");
+}
+/**
+* Cleans up a Zod error message by removing redundant prefixes.
+*/
+function cleanMessage(message) {
+	return message.replace(/^Environment variable "[^"]+": /, "");
+}
+/**
+* Checks if the current environment is development.
+*/
+function isDevelopment() {
+	const nodeEnv = process.env.NODE_ENV?.toLowerCase();
+	return nodeEnv == null || nodeEnv === "development" || nodeEnv === "dev";
+}
+
+//#endregion
+export { formatParseError, isDevelopment };
+//# sourceMappingURL=formatter-fz8V7x6i.mjs.map

package/dist/formatter-fz8V7x6i.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter-fz8V7x6i.mjs","names":["error: z.ZodError","options: FormatOptions","missingVars: Array<{ name: string; message: string }>","invalidVars: Array<{ name: string; value: unknown; message: string }>","lines: string[]","message: string"],"sources":["../src/formatter.ts"],"sourcesContent":["import { z } from 'zod/v4';\n\n/**\n * Options for formatting parse errors.\n */\nexport interface FormatOptions {\n\t/** Whether to use colors in output. Defaults to auto-detect TTY. */\n\tcolors?: boolean;\n}\n\n/**\n * ANSI color codes for terminal output.\n */\nconst colors = {\n\treset: '\\x1b[0m',\n\tred: '\\x1b[31m',\n\tyellow: '\\x1b[33m',\n\tcyan: '\\x1b[36m',\n\tdim: '\\x1b[2m',\n\tbold: '\\x1b[1m',\n};\n\n/**\n * Formats a ZodError into a user-friendly string for development.\n *\n * @param error - The ZodError to format\n * @param options - Formatting options\n * @returns Formatted error message\n *\n * @example\n * ```typescript\n * try {\n *   config.parse();\n * } catch (error) {\n *   if (error instanceof ZodError) {\n *     console.error(formatParseError(error));\n *   }\n * }\n * ```\n *\n * Output:\n * ```\n * Environment Configuration Failed\n *\n * Missing Variables:\n *   DATABASE_URL - Required\n *   JWT_SECRET - Required\n *\n * Invalid Values:\n *   NODE_ENV = \"invalid\"\n *     Expected: \"development\" | \"staging\" | \"production\"\n * ```\n */\nexport function formatParseError(\n\terror: z.ZodError,\n\toptions: FormatOptions = {},\n): string {\n\tconst useColors =\n\t\toptions.colors ?? (process.stdout?.isTTY && process.env.NO_COLOR == null);\n\n\tconst c = useColors\n\t\t? colors\n\t\t: { reset: '', red: '', yellow: '', cyan: '', dim: '', bold: '' };\n\n\tconst missingVars: Array<{ name: string; message: string }> = [];\n\tconst invalidVars: Array<{ name: string; value: unknown; message: string }> =\n\t\t[];\n\n\tfor (const issue of error.issues) {\n\t\t// Extract environment variable name from path or message\n\t\tlet envName = '';\n\t\tif (issue.path.length > 0) {\n\t\t\tenvName = String(issue.path[0]);\n\t\t} else {\n\t\t\t// Try to extract from message like 'Environment variable \"NAME\": ...'\n\t\t\tconst match = issue.message.match(/Environment variable \"([^\"]+)\"/);\n\t\t\tif (match?.[1]) {\n\t\t\t\tenvName = match[1];\n\t\t\t}\n\t\t}\n\n\t\t// Determine if this is a missing or invalid value\n\t\t// Use type guard for received property\n\t\tconst received = 'received' in issue ? issue.received : undefined;\n\t\tconst isMissing =\n\t\t\tissue.code === 'invalid_type' &&\n\t\t\t(received === 'undefined' || received === 'null');\n\n\t\tif (isMissing) {\n\t\t\tmissingVars.push({\n\t\t\t\tname: envName || 'Unknown',\n\t\t\t\tmessage: cleanMessage(issue.message),\n\t\t\t});\n\t\t} else {\n\t\t\tinvalidVars.push({\n\t\t\t\tname: envName || 'Unknown',\n\t\t\t\tvalue: received,\n\t\t\t\tmessage: cleanMessage(issue.message),\n\t\t\t});\n\t\t}\n\t}\n\n\tconst lines: string[] = [];\n\n\tlines.push('');\n\tlines.push(\n\t\t`${c.red}${c.bold}Environment Configuration Failed${c.reset}`,\n\t);\n\tlines.push('');\n\n\tif (missingVars.length > 0) {\n\t\tlines.push(`${c.yellow}Missing Variables:${c.reset}`);\n\t\tfor (const v of missingVars) {\n\t\t\tlines.push(`  ${c.cyan}${v.name}${c.reset} ${c.dim}- Required${c.reset}`);\n\t\t}\n\t\tlines.push('');\n\t}\n\n\tif (invalidVars.length > 0) {\n\t\tlines.push(`${c.yellow}Invalid Values:${c.reset}`);\n\t\tfor (const v of invalidVars) {\n\t\t\tconst valueStr =\n\t\t\t\tv.value !== undefined ? ` = ${JSON.stringify(v.value)}` : '';\n\t\t\tlines.push(`  ${c.cyan}${v.name}${c.reset}${valueStr}`);\n\t\t\tlines.push(`    ${c.dim}${v.message}${c.reset}`);\n\t\t}\n\t\tlines.push('');\n\t}\n\n\treturn lines.join('\\n');\n}\n\n/**\n * Cleans up a Zod error message by removing redundant prefixes.\n */\nfunction cleanMessage(message: string): string {\n\t// Remove \"Environment variable \"NAME\": \" prefix if present\n\treturn message.replace(/^Environment variable \"[^\"]+\": /, '');\n}\n\n/**\n * Checks if the current environment is development.\n */\nexport function isDevelopment(): boolean {\n\tconst nodeEnv = process.env.NODE_ENV?.toLowerCase();\n\treturn nodeEnv == null || nodeEnv === 'development' || nodeEnv === 'dev';\n}\n"],"mappings":";;;;;;AAaA,MAAM,SAAS;CACd,OAAO;CACP,KAAK;CACL,QAAQ;CACR,MAAM;CACN,KAAK;CACL,MAAM;AACN;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCD,SAAgB,iBACfA,OACAC,UAAyB,CAAE,GAClB;CACT,MAAM,YACL,QAAQ,WAAW,QAAQ,QAAQ,SAAS,QAAQ,IAAI,YAAY;CAErE,MAAM,IAAI,YACP,SACA;EAAE,OAAO;EAAI,KAAK;EAAI,QAAQ;EAAI,MAAM;EAAI,KAAK;EAAI,MAAM;CAAI;CAElE,MAAMC,cAAwD,CAAE;CAChE,MAAMC,cACL,CAAE;AAEH,MAAK,MAAM,SAAS,MAAM,QAAQ;EAEjC,IAAI,UAAU;AACd,MAAI,MAAM,KAAK,SAAS,EACvB,WAAU,OAAO,MAAM,KAAK,GAAG;OACzB;GAEN,MAAM,QAAQ,MAAM,QAAQ,MAAM,iCAAiC;AACnE,OAAI,QAAQ,GACX,WAAU,MAAM;EAEjB;EAID,MAAM,WAAW,cAAc,QAAQ,MAAM;EAC7C,MAAM,YACL,MAAM,SAAS,mBACd,aAAa,eAAe,aAAa;AAE3C,MAAI,UACH,aAAY,KAAK;GAChB,MAAM,WAAW;GACjB,SAAS,aAAa,MAAM,QAAQ;EACpC,EAAC;MAEF,aAAY,KAAK;GAChB,MAAM,WAAW;GACjB,OAAO;GACP,SAAS,aAAa,MAAM,QAAQ;EACpC,EAAC;CAEH;CAED,MAAMC,QAAkB,CAAE;AAE1B,OAAM,KAAK,GAAG;AACd,OAAM,MACJ,EAAE,EAAE,IAAI,EAAE,EAAE,KAAK,kCAAkC,EAAE,MAAM,EAC5D;AACD,OAAM,KAAK,GAAG;AAEd,KAAI,YAAY,SAAS,GAAG;AAC3B,QAAM,MAAM,EAAE,EAAE,OAAO,oBAAoB,EAAE,MAAM,EAAE;AACrD,OAAK,MAAM,KAAK,YACf,OAAM,MAAM,IAAI,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,YAAY,EAAE,MAAM,EAAE;AAE1E,QAAM,KAAK,GAAG;CACd;AAED,KAAI,YAAY,SAAS,GAAG;AAC3B,QAAM,MAAM,EAAE,EAAE,OAAO,iBAAiB,EAAE,MAAM,EAAE;AAClD,OAAK,MAAM,KAAK,aAAa;GAC5B,MAAM,WACL,EAAE,oBAAuB,KAAK,KAAK,UAAU,EAAE,MAAM,CAAC,IAAI;AAC3D,SAAM,MAAM,IAAI,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE;AACvD,SAAM,MAAM,MAAM,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE;EAChD;AACD,QAAM,KAAK,GAAG;CACd;AAED,QAAO,MAAM,KAAK,KAAK;AACvB;;;;AAKD,SAAS,aAAaC,SAAyB;AAE9C,QAAO,QAAQ,QAAQ,mCAAmC,GAAG;AAC7D;;;;AAKD,SAAgB,gBAAyB;CACxC,MAAM,UAAU,QAAQ,IAAI,UAAU,aAAa;AACnD,QAAO,WAAW,QAAQ,YAAY,iBAAiB,YAAY;AACnE"}

package/dist/formatter-w8Tsccw4.cjs

@@ -0,0 +1,125 @@
+const require_chunk = require('./chunk-CUT6urMc.cjs');
+const zod_v4 = require_chunk.__toESM(require("zod/v4"));
+
+//#region src/formatter.ts
+/**
+* ANSI color codes for terminal output.
+*/
+const colors = {
+	reset: "\x1B[0m",
+	red: "\x1B[31m",
+	yellow: "\x1B[33m",
+	cyan: "\x1B[36m",
+	dim: "\x1B[2m",
+	bold: "\x1B[1m"
+};
+/**
+* Formats a ZodError into a user-friendly string for development.
+*
+* @param error - The ZodError to format
+* @param options - Formatting options
+* @returns Formatted error message
+*
+* @example
+* ```typescript
+* try {
+*   config.parse();
+* } catch (error) {
+*   if (error instanceof ZodError) {
+*     console.error(formatParseError(error));
+*   }
+* }
+* ```
+*
+* Output:
+* ```
+* Environment Configuration Failed
+*
+* Missing Variables:
+*   DATABASE_URL - Required
+*   JWT_SECRET - Required
+*
+* Invalid Values:
+*   NODE_ENV = "invalid"
+*     Expected: "development" | "staging" | "production"
+* ```
+*/
+function formatParseError(error, options = {}) {
+	const useColors = options.colors ?? (process.stdout?.isTTY && process.env.NO_COLOR == null);
+	const c = useColors ? colors : {
+		reset: "",
+		red: "",
+		yellow: "",
+		cyan: "",
+		dim: "",
+		bold: ""
+	};
+	const missingVars = [];
+	const invalidVars = [];
+	for (const issue of error.issues) {
+		let envName = "";
+		if (issue.path.length > 0) envName = String(issue.path[0]);
+		else {
+			const match = issue.message.match(/Environment variable "([^"]+)"/);
+			if (match?.[1]) envName = match[1];
+		}
+		const received = "received" in issue ? issue.received : void 0;
+		const isMissing = issue.code === "invalid_type" && (received === "undefined" || received === "null");
+		if (isMissing) missingVars.push({
+			name: envName || "Unknown",
+			message: cleanMessage(issue.message)
+		});
+		else invalidVars.push({
+			name: envName || "Unknown",
+			value: received,
+			message: cleanMessage(issue.message)
+		});
+	}
+	const lines = [];
+	lines.push("");
+	lines.push(`${c.red}${c.bold}Environment Configuration Failed${c.reset}`);
+	lines.push("");
+	if (missingVars.length > 0) {
+		lines.push(`${c.yellow}Missing Variables:${c.reset}`);
+		for (const v of missingVars) lines.push(`  ${c.cyan}${v.name}${c.reset} ${c.dim}- Required${c.reset}`);
+		lines.push("");
+	}
+	if (invalidVars.length > 0) {
+		lines.push(`${c.yellow}Invalid Values:${c.reset}`);
+		for (const v of invalidVars) {
+			const valueStr = v.value !== void 0 ? ` = ${JSON.stringify(v.value)}` : "";
+			lines.push(`  ${c.cyan}${v.name}${c.reset}${valueStr}`);
+			lines.push(`    ${c.dim}${v.message}${c.reset}`);
+		}
+		lines.push("");
+	}
+	return lines.join("\n");
+}
+/**
+* Cleans up a Zod error message by removing redundant prefixes.
+*/
+function cleanMessage(message) {
+	return message.replace(/^Environment variable "[^"]+": /, "");
+}
+/**
+* Checks if the current environment is development.
+*/
+function isDevelopment() {
+	const nodeEnv = process.env.NODE_ENV?.toLowerCase();
+	return nodeEnv == null || nodeEnv === "development" || nodeEnv === "dev";
+}
+
+//#endregion
+Object.defineProperty(exports, 'formatParseError', {
+  enumerable: true,
+  get: function () {
+    return formatParseError;
+  }
+});
+Object.defineProperty(exports, 'isDevelopment', {
+  enumerable: true,
+  get: function () {
+    return isDevelopment;
+  }
+});
+//# sourceMappingURL=formatter-w8Tsccw4.cjs.map

package/dist/formatter-w8Tsccw4.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter-w8Tsccw4.cjs","names":["error: z.ZodError","options: FormatOptions","missingVars: Array<{ name: string; message: string }>","invalidVars: Array<{ name: string; value: unknown; message: string }>","lines: string[]","message: string"],"sources":["../src/formatter.ts"],"sourcesContent":["import { z } from 'zod/v4';\n\n/**\n * Options for formatting parse errors.\n */\nexport interface FormatOptions {\n\t/** Whether to use colors in output. Defaults to auto-detect TTY. */\n\tcolors?: boolean;\n}\n\n/**\n * ANSI color codes for terminal output.\n */\nconst colors = {\n\treset: '\\x1b[0m',\n\tred: '\\x1b[31m',\n\tyellow: '\\x1b[33m',\n\tcyan: '\\x1b[36m',\n\tdim: '\\x1b[2m',\n\tbold: '\\x1b[1m',\n};\n\n/**\n * Formats a ZodError into a user-friendly string for development.\n *\n * @param error - The ZodError to format\n * @param options - Formatting options\n * @returns Formatted error message\n *\n * @example\n * ```typescript\n * try {\n *   config.parse();\n * } catch (error) {\n *   if (error instanceof ZodError) {\n *     console.error(formatParseError(error));\n *   }\n * }\n * ```\n *\n * Output:\n * ```\n * Environment Configuration Failed\n *\n * Missing Variables:\n *   DATABASE_URL - Required\n *   JWT_SECRET - Required\n *\n * Invalid Values:\n *   NODE_ENV = \"invalid\"\n *     Expected: \"development\" | \"staging\" | \"production\"\n * ```\n */\nexport function formatParseError(\n\terror: z.ZodError,\n\toptions: FormatOptions = {},\n): string {\n\tconst useColors =\n\t\toptions.colors ?? (process.stdout?.isTTY && process.env.NO_COLOR == null);\n\n\tconst c = useColors\n\t\t? colors\n\t\t: { reset: '', red: '', yellow: '', cyan: '', dim: '', bold: '' };\n\n\tconst missingVars: Array<{ name: string; message: string }> = [];\n\tconst invalidVars: Array<{ name: string; value: unknown; message: string }> =\n\t\t[];\n\n\tfor (const issue of error.issues) {\n\t\t// Extract environment variable name from path or message\n\t\tlet envName = '';\n\t\tif (issue.path.length > 0) {\n\t\t\tenvName = String(issue.path[0]);\n\t\t} else {\n\t\t\t// Try to extract from message like 'Environment variable \"NAME\": ...'\n\t\t\tconst match = issue.message.match(/Environment variable \"([^\"]+)\"/);\n\t\t\tif (match?.[1]) {\n\t\t\t\tenvName = match[1];\n\t\t\t}\n\t\t}\n\n\t\t// Determine if this is a missing or invalid value\n\t\t// Use type guard for received property\n\t\tconst received = 'received' in issue ? issue.received : undefined;\n\t\tconst isMissing =\n\t\t\tissue.code === 'invalid_type' &&\n\t\t\t(received === 'undefined' || received === 'null');\n\n\t\tif (isMissing) {\n\t\t\tmissingVars.push({\n\t\t\t\tname: envName || 'Unknown',\n\t\t\t\tmessage: cleanMessage(issue.message),\n\t\t\t});\n\t\t} else {\n\t\t\tinvalidVars.push({\n\t\t\t\tname: envName || 'Unknown',\n\t\t\t\tvalue: received,\n\t\t\t\tmessage: cleanMessage(issue.message),\n\t\t\t});\n\t\t}\n\t}\n\n\tconst lines: string[] = [];\n\n\tlines.push('');\n\tlines.push(\n\t\t`${c.red}${c.bold}Environment Configuration Failed${c.reset}`,\n\t);\n\tlines.push('');\n\n\tif (missingVars.length > 0) {\n\t\tlines.push(`${c.yellow}Missing Variables:${c.reset}`);\n\t\tfor (const v of missingVars) {\n\t\t\tlines.push(`  ${c.cyan}${v.name}${c.reset} ${c.dim}- Required${c.reset}`);\n\t\t}\n\t\tlines.push('');\n\t}\n\n\tif (invalidVars.length > 0) {\n\t\tlines.push(`${c.yellow}Invalid Values:${c.reset}`);\n\t\tfor (const v of invalidVars) {\n\t\t\tconst valueStr =\n\t\t\t\tv.value !== undefined ? ` = ${JSON.stringify(v.value)}` : '';\n\t\t\tlines.push(`  ${c.cyan}${v.name}${c.reset}${valueStr}`);\n\t\t\tlines.push(`    ${c.dim}${v.message}${c.reset}`);\n\t\t}\n\t\tlines.push('');\n\t}\n\n\treturn lines.join('\\n');\n}\n\n/**\n * Cleans up a Zod error message by removing redundant prefixes.\n */\nfunction cleanMessage(message: string): string {\n\t// Remove \"Environment variable \"NAME\": \" prefix if present\n\treturn message.replace(/^Environment variable \"[^\"]+\": /, '');\n}\n\n/**\n * Checks if the current environment is development.\n */\nexport function isDevelopment(): boolean {\n\tconst nodeEnv = process.env.NODE_ENV?.toLowerCase();\n\treturn nodeEnv == null || nodeEnv === 'development' || nodeEnv === 'dev';\n}\n"],"mappings":";;;;;;;AAaA,MAAM,SAAS;CACd,OAAO;CACP,KAAK;CACL,QAAQ;CACR,MAAM;CACN,KAAK;CACL,MAAM;AACN;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCD,SAAgB,iBACfA,OACAC,UAAyB,CAAE,GAClB;CACT,MAAM,YACL,QAAQ,WAAW,QAAQ,QAAQ,SAAS,QAAQ,IAAI,YAAY;CAErE,MAAM,IAAI,YACP,SACA;EAAE,OAAO;EAAI,KAAK;EAAI,QAAQ;EAAI,MAAM;EAAI,KAAK;EAAI,MAAM;CAAI;CAElE,MAAMC,cAAwD,CAAE;CAChE,MAAMC,cACL,CAAE;AAEH,MAAK,MAAM,SAAS,MAAM,QAAQ;EAEjC,IAAI,UAAU;AACd,MAAI,MAAM,KAAK,SAAS,EACvB,WAAU,OAAO,MAAM,KAAK,GAAG;OACzB;GAEN,MAAM,QAAQ,MAAM,QAAQ,MAAM,iCAAiC;AACnE,OAAI,QAAQ,GACX,WAAU,MAAM;EAEjB;EAID,MAAM,WAAW,cAAc,QAAQ,MAAM;EAC7C,MAAM,YACL,MAAM,SAAS,mBACd,aAAa,eAAe,aAAa;AAE3C,MAAI,UACH,aAAY,KAAK;GAChB,MAAM,WAAW;GACjB,SAAS,aAAa,MAAM,QAAQ;EACpC,EAAC;MAEF,aAAY,KAAK;GAChB,MAAM,WAAW;GACjB,OAAO;GACP,SAAS,aAAa,MAAM,QAAQ;EACpC,EAAC;CAEH;CAED,MAAMC,QAAkB,CAAE;AAE1B,OAAM,KAAK,GAAG;AACd,OAAM,MACJ,EAAE,EAAE,IAAI,EAAE,EAAE,KAAK,kCAAkC,EAAE,MAAM,EAC5D;AACD,OAAM,KAAK,GAAG;AAEd,KAAI,YAAY,SAAS,GAAG;AAC3B,QAAM,MAAM,EAAE,EAAE,OAAO,oBAAoB,EAAE,MAAM,EAAE;AACrD,OAAK,MAAM,KAAK,YACf,OAAM,MAAM,IAAI,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,YAAY,EAAE,MAAM,EAAE;AAE1E,QAAM,KAAK,GAAG;CACd;AAED,KAAI,YAAY,SAAS,GAAG;AAC3B,QAAM,MAAM,EAAE,EAAE,OAAO,iBAAiB,EAAE,MAAM,EAAE;AAClD,OAAK,MAAM,KAAK,aAAa;GAC5B,MAAM,WACL,EAAE,oBAAuB,KAAK,KAAK,UAAU,EAAE,MAAM,CAAC,IAAI;AAC3D,SAAM,MAAM,IAAI,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE;AACvD,SAAM,MAAM,MAAM,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE;EAChD;AACD,QAAM,KAAK,GAAG;CACd;AAED,QAAO,MAAM,KAAK,KAAK;AACvB;;;;AAKD,SAAS,aAAaC,SAAyB;AAE9C,QAAO,QAAQ,QAAQ,mCAAmC,GAAG;AAC7D;;;;AAKD,SAAgB,gBAAyB;CACxC,MAAM,UAAU,QAAQ,IAAI,UAAU,aAAa;AACnD,QAAO,WAAW,QAAQ,YAAY,iBAAiB,YAAY;AACnE"}

package/dist/formatter.cjs

@@ -0,0 +1,4 @@
+const require_formatter = require('./formatter-w8Tsccw4.cjs');
+
+exports.formatParseError = require_formatter.formatParseError;
+exports.isDevelopment = require_formatter.isDevelopment;

package/dist/formatter.d.cts

@@ -0,0 +1,2 @@
+import { FormatOptions, formatParseError, isDevelopment } from "./formatter-D85aIkpd.cjs";
+export { FormatOptions, formatParseError, isDevelopment };

package/dist/formatter.d.mts

@@ -0,0 +1,2 @@
+import { FormatOptions, formatParseError, isDevelopment } from "./formatter-Cox0NGxT.mjs";
+export { FormatOptions, formatParseError, isDevelopment };

package/dist/formatter.mjs

@@ -0,0 +1,3 @@
+import { formatParseError, isDevelopment } from "./formatter-fz8V7x6i.mjs";
+
+export { formatParseError, isDevelopment };

package/dist/index.cjs

@@ -1,7 +1,10 @@
 const require_EnvironmentBuilder = require('./EnvironmentBuilder-Djr1VsWM.cjs');
-const require_EnvironmentParser = require('./EnvironmentParser-Bt246UeP.cjs');
+const require_formatter = require('./formatter-w8Tsccw4.cjs');
+const require_EnvironmentParser = require('./EnvironmentParser-DlWHnhDY.cjs');
 
 exports.ConfigParser = require_EnvironmentParser.ConfigParser;
 exports.EnvironmentBuilder = require_EnvironmentBuilder.EnvironmentBuilder;
 exports.EnvironmentParser = require_EnvironmentParser.EnvironmentParser;
-exports.environmentCase = require_EnvironmentBuilder.environmentCase;
+exports.environmentCase = require_EnvironmentBuilder.environmentCase;
+exports.formatParseError = require_formatter.formatParseError;
+exports.isDevelopment = require_formatter.isDevelopment;

package/dist/index.d.cts

@@ -1,3 +1,4 @@
 import { EnvRecord, EnvValue, EnvironmentBuilder, EnvironmentBuilderOptions, EnvironmentResolver, InputValue, Resolvers, TypedInputValue, TypedResolvers, environmentCase } from "./EnvironmentBuilder-Xuf2Dd9u.cjs";
 import { ConfigParser, EnvironmentParser } from "./EnvironmentParser-DtOL86NU.cjs";
-export { ConfigParser, EnvRecord, EnvValue, EnvironmentBuilder, EnvironmentBuilderOptions, EnvironmentParser, EnvironmentResolver, InputValue, Resolvers, TypedInputValue, TypedResolvers, environmentCase };
+import { FormatOptions, formatParseError, isDevelopment } from "./formatter-D85aIkpd.cjs";
+export { ConfigParser, EnvRecord, EnvValue, EnvironmentBuilder, EnvironmentBuilderOptions, EnvironmentParser, EnvironmentResolver, FormatOptions, InputValue, Resolvers, TypedInputValue, TypedResolvers, environmentCase, formatParseError, isDevelopment };

package/dist/index.d.mts

@@ -1,3 +1,4 @@
-import { EnvRecord, EnvValue, EnvironmentBuilder, EnvironmentBuilderOptions, EnvironmentResolver, InputValue, Resolvers, TypedInputValue, TypedResolvers, environmentCase } from "./EnvironmentBuilder-DHfDXJUm.mjs";
-import { ConfigParser, EnvironmentParser } from "./EnvironmentParser-CY8TosTN.mjs";
-export { ConfigParser, EnvRecord, EnvValue, EnvironmentBuilder, EnvironmentBuilderOptions, EnvironmentParser, EnvironmentResolver, InputValue, Resolvers, TypedInputValue, TypedResolvers, environmentCase };
+import { EnvRecord, EnvValue, EnvironmentBuilder, EnvironmentBuilderOptions, EnvironmentResolver, InputValue, Resolvers, TypedInputValue, TypedResolvers, environmentCase } from "./EnvironmentBuilder-jF-b7WQg.mjs";
+import { ConfigParser, EnvironmentParser } from "./EnvironmentParser-CkLfmn4Y.mjs";
+import { FormatOptions, formatParseError, isDevelopment } from "./formatter-Cox0NGxT.mjs";
+export { ConfigParser, EnvRecord, EnvValue, EnvironmentBuilder, EnvironmentBuilderOptions, EnvironmentParser, EnvironmentResolver, FormatOptions, InputValue, Resolvers, TypedInputValue, TypedResolvers, environmentCase, formatParseError, isDevelopment };

package/dist/index.mjs

@@ -1,4 +1,5 @@
 import { EnvironmentBuilder, environmentCase } from "./EnvironmentBuilder-BSuHZm0y.mjs";
-import { ConfigParser, EnvironmentParser } from "./EnvironmentParser-c06agx31.mjs";
+import { formatParseError, isDevelopment } from "./formatter-fz8V7x6i.mjs";
+import { ConfigParser, EnvironmentParser } from "./EnvironmentParser-CBLsPUyQ.mjs";
 
-export { ConfigParser, EnvironmentBuilder, EnvironmentParser, environmentCase };
+export { ConfigParser, EnvironmentBuilder, EnvironmentParser, environmentCase, formatParseError, isDevelopment };

package/dist/sst.cjs

@@ -1,5 +1,5 @@
 const require_EnvironmentBuilder = require('./EnvironmentBuilder-Djr1VsWM.cjs');
-const require_SstEnvironmentBuilder = require('./SstEnvironmentBuilder-wFnN2M5O.cjs');
+const require_SstEnvironmentBuilder = require('./SstEnvironmentBuilder-jsnqgtcW.cjs');
 
 //#region src/sst.ts
 /**

package/dist/sst.d.mts

@@ -1,5 +1,5 @@
-import { EnvRecord, EnvValue, EnvironmentBuilderOptions, environmentCase } from "./EnvironmentBuilder-DHfDXJUm.mjs";
-import { ApiGatewayV2, Bucket, Function, Postgres, ResourceProcessor, ResourceType, Secret, SnsTopic, SstEnvironmentBuilder, SstResource, Vpc, sstResolvers } from "./SstEnvironmentBuilder-CjURMGjW.mjs";
+import { EnvRecord, EnvValue, EnvironmentBuilderOptions, environmentCase } from "./EnvironmentBuilder-jF-b7WQg.mjs";
+import { ApiGatewayV2, Bucket, Function, Postgres, ResourceProcessor, ResourceType, Secret, SnsTopic, SstEnvironmentBuilder, SstResource, Vpc, sstResolvers } from "./SstEnvironmentBuilder-BZngSQKQ.mjs";
 
 //#region src/sst.d.ts
 

package/dist/sst.mjs

@@ -1,5 +1,5 @@
 import { environmentCase } from "./EnvironmentBuilder-BSuHZm0y.mjs";
-import { ResourceType, SstEnvironmentBuilder, sstResolvers } from "./SstEnvironmentBuilder-BEBFSUYr.mjs";
+import { ResourceType, SstEnvironmentBuilder, sstResolvers } from "./SstEnvironmentBuilder-DVB7cJq4.mjs";
 
 //#region src/sst.ts
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekmidas/envkit",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "private": false,
   "type": "module",
   "exports": {

package/src/EnvironmentParser.ts

@@ -1,6 +1,7 @@
 import get from 'lodash.get';
 import set from 'lodash.set';
 import { z } from 'zod/v4';
+import { formatParseError, isDevelopment } from './formatter.js';
 
 /**
  * Parses and validates configuration objects against Zod schemas.
@@ -63,8 +64,12 @@ export class ConfigParser<TResponse extends EmptyObject> {
 		) as unknown as InferConfig<TResponse>;
 
 		if (errors.length > 0) {
-			// If there are errors, throw them
-			throw new z.ZodError(errors);
+			const zodError = new z.ZodError(errors);
+			// In development, log a formatted error message before throwing
+			if (isDevelopment()) {
+				console.error(formatParseError(zodError));
+			}
+			throw zodError;
 		}
 
 		return parsedConfig;

package/src/__tests__/formatter.spec.ts

@@ -0,0 +1,250 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { z } from 'zod/v4';
+import { formatParseError, isDevelopment } from '../formatter';
+
+// Helper to create test issues - casts through unknown because we're creating test fixtures
+// that may include properties like 'received' which vary by issue type
+function createIssue(issue: Record<string, unknown>): z.core.$ZodIssue {
+	return issue as unknown as z.core.$ZodIssue;
+}
+
+describe('formatParseError', () => {
+	it('should format missing variables', () => {
+		const error = new z.ZodError([
+			createIssue({
+				code: 'invalid_type',
+				expected: 'string',
+				received: 'undefined',
+				path: ['DATABASE_URL'],
+				message: 'Environment variable "DATABASE_URL": Required',
+			}),
+			createIssue({
+				code: 'invalid_type',
+				expected: 'string',
+				received: 'undefined',
+				path: ['JWT_SECRET'],
+				message: 'Environment variable "JWT_SECRET": Required',
+			}),
+		]);
+
+		const formatted = formatParseError(error, { colors: false });
+
+		expect(formatted).toContain('Environment Configuration Failed');
+		expect(formatted).toContain('Missing Variables:');
+		expect(formatted).toContain('DATABASE_URL');
+		expect(formatted).toContain('JWT_SECRET');
+		expect(formatted).toContain('Required');
+	});
+
+	it('should format invalid values', () => {
+		const error = new z.ZodError([
+			createIssue({
+				code: 'invalid_value',
+				values: ['development', 'staging', 'production'],
+				received: 'invalid',
+				path: ['NODE_ENV'],
+				message:
+					'Invalid enum value. Expected \'development\' | \'staging\' | \'production\', received \'invalid\'',
+			}),
+		]);
+
+		const formatted = formatParseError(error, { colors: false });
+
+		expect(formatted).toContain('Environment Configuration Failed');
+		expect(formatted).toContain('Invalid Values:');
+		expect(formatted).toContain('NODE_ENV');
+		expect(formatted).toContain('invalid');
+	});
+
+	it('should handle mixed missing and invalid values', () => {
+		const error = new z.ZodError([
+			createIssue({
+				code: 'invalid_type',
+				expected: 'string',
+				received: 'undefined',
+				path: ['DATABASE_URL'],
+				message: 'Environment variable "DATABASE_URL": Required',
+			}),
+			createIssue({
+				code: 'invalid_type',
+				expected: 'number',
+				received: 'string',
+				path: ['PORT'],
+				message: 'Expected number, received string',
+			}),
+		]);
+
+		const formatted = formatParseError(error, { colors: false });
+
+		expect(formatted).toContain('Missing Variables:');
+		expect(formatted).toContain('DATABASE_URL');
+		expect(formatted).toContain('Invalid Values:');
+		expect(formatted).toContain('PORT');
+	});
+
+	it('should clean message prefixes', () => {
+		const error = new z.ZodError([
+			createIssue({
+				code: 'invalid_type',
+				expected: 'number',
+				received: 'string',
+				path: ['PORT'],
+				message: 'Environment variable "PORT": Expected number, received string',
+			}),
+		]);
+
+		const formatted = formatParseError(error, { colors: false });
+
+		// Should not duplicate "Environment variable" in output
+		expect(formatted).not.toContain(
+			'Environment variable "PORT": Environment variable',
+		);
+		expect(formatted).toContain('Expected number, received string');
+	});
+
+	it('should extract env name from message when path is empty', () => {
+		const error = new z.ZodError([
+			createIssue({
+				code: 'invalid_type',
+				expected: 'string',
+				received: 'undefined',
+				path: [],
+				message: 'Environment variable "API_KEY": Required',
+			}),
+		]);
+
+		const formatted = formatParseError(error, { colors: false });
+
+		expect(formatted).toContain('API_KEY');
+	});
+
+	it('should handle colors option false', () => {
+		const error = new z.ZodError([
+			createIssue({
+				code: 'invalid_type',
+				expected: 'string',
+				received: 'undefined',
+				path: ['TEST'],
+				message: 'Required',
+			}),
+		]);
+
+		const formatted = formatParseError(error, { colors: false });
+
+		// Should not contain ANSI codes
+		expect(formatted).not.toContain('\x1b[');
+	});
+
+	it('should handle colors option true', () => {
+		const error = new z.ZodError([
+			createIssue({
+				code: 'invalid_type',
+				expected: 'string',
+				received: 'undefined',
+				path: ['TEST'],
+				message: 'Required',
+			}),
+		]);
+
+		const formatted = formatParseError(error, { colors: true });
+
+		// Should contain ANSI codes
+		expect(formatted).toContain('\x1b[');
+	});
+});
+
+describe('isDevelopment', () => {
+	const originalEnv = process.env.NODE_ENV;
+
+	afterEach(() => {
+		if (originalEnv === undefined) {
+			delete process.env.NODE_ENV;
+		} else {
+			process.env.NODE_ENV = originalEnv;
+		}
+	});
+
+	it('should return true when NODE_ENV is undefined', () => {
+		delete process.env.NODE_ENV;
+		expect(isDevelopment()).toBe(true);
+	});
+
+	it('should return true when NODE_ENV is development', () => {
+		process.env.NODE_ENV = 'development';
+		expect(isDevelopment()).toBe(true);
+	});
+
+	it('should return true when NODE_ENV is dev', () => {
+		process.env.NODE_ENV = 'dev';
+		expect(isDevelopment()).toBe(true);
+	});
+
+	it('should return true when NODE_ENV is DEVELOPMENT (case insensitive)', () => {
+		process.env.NODE_ENV = 'DEVELOPMENT';
+		expect(isDevelopment()).toBe(true);
+	});
+
+	it('should return false when NODE_ENV is production', () => {
+		process.env.NODE_ENV = 'production';
+		expect(isDevelopment()).toBe(false);
+	});
+
+	it('should return false when NODE_ENV is staging', () => {
+		process.env.NODE_ENV = 'staging';
+		expect(isDevelopment()).toBe(false);
+	});
+
+	it('should return false when NODE_ENV is test', () => {
+		process.env.NODE_ENV = 'test';
+		expect(isDevelopment()).toBe(false);
+	});
+});
+
+describe('ConfigParser with dev formatting', () => {
+	const originalEnv = process.env.NODE_ENV;
+
+	beforeEach(() => {
+		vi.spyOn(console, 'error').mockImplementation(() => {});
+	});
+
+	afterEach(() => {
+		vi.restoreAllMocks();
+		if (originalEnv === undefined) {
+			delete process.env.NODE_ENV;
+		} else {
+			process.env.NODE_ENV = originalEnv;
+		}
+	});
+
+	it('should log formatted error in development mode', async () => {
+		process.env.NODE_ENV = 'development';
+
+		const { EnvironmentParser } = await import('../EnvironmentParser');
+		const parser = new EnvironmentParser({});
+		const config = parser.create((get) => ({
+			dbUrl: get('DATABASE_URL').string(),
+		}));
+
+		expect(() => config.parse()).toThrow();
+		expect(console.error).toHaveBeenCalled();
+
+		const errorOutput = (console.error as any).mock.calls[0][0];
+		expect(errorOutput).toContain('Environment Configuration Failed');
+	});
+
+	it('should not log formatted error in production mode', async () => {
+		process.env.NODE_ENV = 'production';
+
+		// Need to reimport to pick up the new NODE_ENV
+		vi.resetModules();
+		const { EnvironmentParser } = await import('../EnvironmentParser');
+
+		const parser = new EnvironmentParser({});
+		const config = parser.create((get) => ({
+			dbUrl: get('DATABASE_URL').string(),
+		}));
+
+		expect(() => config.parse()).toThrow();
+		expect(console.error).not.toHaveBeenCalled();
+	});
+});