@geekmidas/envkit 0.0.3 → 0.0.4

package/dist/{EnvironmentParser-Bz9IoLJs.cjs → EnvironmentParser-Bo2CCl_K.cjs}

@@ -1,35 +1,21 @@
-//#region rolldown:runtime
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __commonJS = (cb, mod) => function() {
-	return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-};
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-
-//#endregion
-const lodash_get = __toESM(require("lodash.get"));
-const lodash_set = __toESM(require("lodash.set"));
-const zod_v4 = __toESM(require("zod/v4"));
+const require_chunk = require('./chunk-CUT6urMc.cjs');
+const lodash_get = require_chunk.__toESM(require("lodash.get"));
+const lodash_set = require_chunk.__toESM(require("lodash.set"));
+const zod_v4 = require_chunk.__toESM(require("zod/v4"));
 
 //#region src/EnvironmentParser.ts
+/**
+* Parses and validates configuration objects against Zod schemas.
+* Handles nested configurations and aggregates validation errors.
+* 
+* @template TResponse - The shape of the configuration object
+*/
 var ConfigParser = class {
+	/**
+	* Creates a new ConfigParser instance.
+	* 
+	* @param config - The configuration object to parse
+	*/
 	constructor(config) {
 		this.config = config;
 	}
@@ -61,10 +47,42 @@ var ConfigParser = class {
 		return parsedConfig;
 	}
 };
+/**
+* Parses environment variables with type-safe validation using Zod schemas.
+* Provides a fluent API for defining environment variable schemas with automatic
+* error context enrichment.
+* 
+* @template T - The type of the configuration object (typically process.env)
+* 
+* @example
+* ```typescript
+* const config = new EnvironmentParser(process.env)
+*   .create((get) => ({
+*     port: get('PORT').string().transform(Number).default(3000),
+*     database: {
+*       url: get('DATABASE_URL').string().url()
+*     }
+*   }))
+*   .parse();
+* ```
+*/
 var EnvironmentParser = class {
+	/**
+	* Creates a new EnvironmentParser instance.
+	* 
+	* @param config - The configuration object to parse (typically process.env)
+	*/
 	constructor(config) {
 		this.config = config;
 	}
+	/**
+	* Wraps a Zod schema to intercept parse/safeParse calls and enrich error messages
+	* with environment variable context.
+	* 
+	* @param schema - The Zod schema to wrap
+	* @param name - The environment variable name for error context
+	* @returns A wrapped Zod schema with enhanced error reporting
+	*/
 	wrapSchema = (schema, name) => {
 		return new Proxy(schema, { get: (target, prop) => {
 			if (prop === "parse") return () => {
@@ -108,6 +126,13 @@ var EnvironmentParser = class {
 			return originalProp;
 		} });
 	};
+	/**
+	* Creates a proxied version of the Zod object that wraps all schema creators
+	* to provide enhanced error messages with environment variable context.
+	* 
+	* @param name - The environment variable name
+	* @returns A proxied Zod object with wrapped schema creators
+	*/
 	getZodGetter = (name) => {
 		return new Proxy({ ...zod_v4.z }, { get: (target, prop) => {
 			const value = target[prop];
@@ -127,10 +152,10 @@ var EnvironmentParser = class {
 		} });
 	};
 	/**
-	* Creates a new JordConfigParser object that can be used to parse the config object
+	* Creates a new ConfigParser object that can be used to parse the config object
 	*
 	* @param builder - A function that takes a getter function and returns a config object
-	* @returns A JordConfigParser object that can be used to parse the config object
+	* @returns A ConfigParser object that can be used to parse the config object
 	*/
 	create(builder) {
 		const config = builder(this.getZodGetter);
@@ -150,16 +175,4 @@ Object.defineProperty(exports, 'EnvironmentParser', {
   get: function () {
     return EnvironmentParser;
   }
-});
-Object.defineProperty(exports, '__commonJS', {
-  enumerable: true,
-  get: function () {
-    return __commonJS;
-  }
-});
-Object.defineProperty(exports, '__toESM', {
-  enumerable: true,
-  get: function () {
-    return __toESM;
-  }
 });

package/dist/{EnvironmentParser-Boj5EFmL.mjs → EnvironmentParser-jKrGMBhP.mjs}

@@ -3,7 +3,18 @@ import set from "lodash.set";
 import { z } from "zod/v4";
 
 //#region src/EnvironmentParser.ts
+/**
+* Parses and validates configuration objects against Zod schemas.
+* Handles nested configurations and aggregates validation errors.
+* 
+* @template TResponse - The shape of the configuration object
+*/
 var ConfigParser = class {
+	/**
+	* Creates a new ConfigParser instance.
+	* 
+	* @param config - The configuration object to parse
+	*/
 	constructor(config) {
 		this.config = config;
 	}
@@ -35,10 +46,42 @@ var ConfigParser = class {
 		return parsedConfig;
 	}
 };
+/**
+* Parses environment variables with type-safe validation using Zod schemas.
+* Provides a fluent API for defining environment variable schemas with automatic
+* error context enrichment.
+* 
+* @template T - The type of the configuration object (typically process.env)
+* 
+* @example
+* ```typescript
+* const config = new EnvironmentParser(process.env)
+*   .create((get) => ({
+*     port: get('PORT').string().transform(Number).default(3000),
+*     database: {
+*       url: get('DATABASE_URL').string().url()
+*     }
+*   }))
+*   .parse();
+* ```
+*/
 var EnvironmentParser = class {
+	/**
+	* Creates a new EnvironmentParser instance.
+	* 
+	* @param config - The configuration object to parse (typically process.env)
+	*/
 	constructor(config) {
 		this.config = config;
 	}
+	/**
+	* Wraps a Zod schema to intercept parse/safeParse calls and enrich error messages
+	* with environment variable context.
+	* 
+	* @param schema - The Zod schema to wrap
+	* @param name - The environment variable name for error context
+	* @returns A wrapped Zod schema with enhanced error reporting
+	*/
 	wrapSchema = (schema, name) => {
 		return new Proxy(schema, { get: (target, prop) => {
 			if (prop === "parse") return () => {
@@ -82,6 +125,13 @@ var EnvironmentParser = class {
 			return originalProp;
 		} });
 	};
+	/**
+	* Creates a proxied version of the Zod object that wraps all schema creators
+	* to provide enhanced error messages with environment variable context.
+	* 
+	* @param name - The environment variable name
+	* @returns A proxied Zod object with wrapped schema creators
+	*/
 	getZodGetter = (name) => {
 		return new Proxy({ ...z }, { get: (target, prop) => {
 			const value = target[prop];
@@ -101,10 +151,10 @@ var EnvironmentParser = class {
 		} });
 	};
 	/**
-	* Creates a new JordConfigParser object that can be used to parse the config object
+	* Creates a new ConfigParser object that can be used to parse the config object
 	*
 	* @param builder - A function that takes a getter function and returns a config object
-	* @returns A JordConfigParser object that can be used to parse the config object
+	* @returns A ConfigParser object that can be used to parse the config object
 	*/
 	create(builder) {
 		const config = builder(this.getZodGetter);

package/dist/EnvironmentParser.cjs

@@ -1,4 +1,4 @@
-const require_EnvironmentParser = require('./EnvironmentParser-Bz9IoLJs.cjs');
+const require_EnvironmentParser = require('./EnvironmentParser-Bo2CCl_K.cjs');
 
 exports.ConfigParser = require_EnvironmentParser.ConfigParser;
 exports.EnvironmentParser = require_EnvironmentParser.EnvironmentParser;

package/dist/EnvironmentParser.mjs

@@ -1,3 +1,3 @@
-import { ConfigParser, EnvironmentParser } from "./EnvironmentParser-Boj5EFmL.mjs";
+import { ConfigParser, EnvironmentParser } from "./EnvironmentParser-jKrGMBhP.mjs";
 
 export { ConfigParser, EnvironmentParser };

package/dist/__tests__/ConfigParser.spec.cjs

@@ -1,11 +1,12 @@
-const require_EnvironmentParser = require('../EnvironmentParser-Bz9IoLJs.cjs');
-const require_vi_bdSIJ99Y = require('../vi.bdSIJ99Y-CT9xbG7X.cjs');
-const zod_v4 = require_EnvironmentParser.__toESM(require("zod/v4"));
+const require_chunk = require('../chunk-CUT6urMc.cjs');
+const require_EnvironmentParser = require('../EnvironmentParser-Bo2CCl_K.cjs');
+const zod_v4 = require_chunk.__toESM(require("zod/v4"));
+const vitest = require_chunk.__toESM(require("vitest"));
 
 //#region src/__tests__/ConfigParser.spec.ts
-require_vi_bdSIJ99Y.describe("ConfigParser", () => {
-	require_vi_bdSIJ99Y.describe("Basic functionality", () => {
-		require_vi_bdSIJ99Y.it("should parse simple Zod schemas", () => {
+(0, vitest.describe)("ConfigParser", () => {
+	(0, vitest.describe)("Basic functionality", () => {
+		(0, vitest.it)("should parse simple Zod schemas", () => {
 			const config = {
 				name: zod_v4.z.string().default("Test"),
 				age: zod_v4.z.number().default(25),
@@ -13,25 +14,25 @@ require_vi_bdSIJ99Y.describe("ConfigParser", () => {
 			};
 			const parser = new require_EnvironmentParser.ConfigParser(config);
 			const result = parser.parse();
-			require_vi_bdSIJ99Y.globalExpect(result).toEqual({
+			(0, vitest.expect)(result).toEqual({
 				name: "Test",
 				age: 25,
 				active: true
 			});
 		});
-		require_vi_bdSIJ99Y.it("should handle optional values", () => {
+		(0, vitest.it)("should handle optional values", () => {
 			const config = {
 				required: zod_v4.z.string().default("value"),
 				optional: zod_v4.z.string().optional()
 			};
 			const parser = new require_EnvironmentParser.ConfigParser(config);
 			const result = parser.parse();
-			require_vi_bdSIJ99Y.globalExpect(result).toEqual({
+			(0, vitest.expect)(result).toEqual({
 				required: "value",
 				optional: void 0
 			});
 		});
-		require_vi_bdSIJ99Y.it("should validate and use provided default values", () => {
+		(0, vitest.it)("should validate and use provided default values", () => {
 			const config = {
 				port: zod_v4.z.number().default(3e3),
 				host: zod_v4.z.string().default("localhost"),
@@ -39,15 +40,15 @@ require_vi_bdSIJ99Y.describe("ConfigParser", () => {
 			};
 			const parser = new require_EnvironmentParser.ConfigParser(config);
 			const result = parser.parse();
-			require_vi_bdSIJ99Y.globalExpect(result).toEqual({
+			(0, vitest.expect)(result).toEqual({
 				port: 3e3,
 				host: "localhost",
 				debug: false
 			});
 		});
 	});
-	require_vi_bdSIJ99Y.describe("Nested objects", () => {
-		require_vi_bdSIJ99Y.it("should parse nested configuration objects", () => {
+	(0, vitest.describe)("Nested objects", () => {
+		(0, vitest.it)("should parse nested configuration objects", () => {
 			const config = {
 				database: {
 					host: zod_v4.z.string().default("localhost"),
@@ -61,7 +62,7 @@ require_vi_bdSIJ99Y.describe("ConfigParser", () => {
 			};
 			const parser = new require_EnvironmentParser.ConfigParser(config);
 			const result = parser.parse();
-			require_vi_bdSIJ99Y.globalExpect(result).toEqual({
+			(0, vitest.expect)(result).toEqual({
 				database: {
 					host: "localhost",
 					port: 5432,
@@ -73,7 +74,7 @@ require_vi_bdSIJ99Y.describe("ConfigParser", () => {
 				}
 			});
 		});
-		require_vi_bdSIJ99Y.it("should handle deeply nested objects", () => {
+		(0, vitest.it)("should handle deeply nested objects", () => {
 			const config = { app: {
 				name: zod_v4.z.string().default("MyApp"),
 				version: zod_v4.z.string().default("1.0.0"),
@@ -90,7 +91,7 @@ require_vi_bdSIJ99Y.describe("ConfigParser", () => {
 			} };
 			const parser = new require_EnvironmentParser.ConfigParser(config);
 			const result = parser.parse();
-			require_vi_bdSIJ99Y.globalExpect(result).toEqual({ app: {
+			(0, vitest.expect)(result).toEqual({ app: {
 				name: "MyApp",
 				version: "1.0.0",
 				features: {
@@ -105,7 +106,7 @@ require_vi_bdSIJ99Y.describe("ConfigParser", () => {
 				}
 			} });
 		});
-		require_vi_bdSIJ99Y.it("should handle mixed nested and flat configuration", () => {
+		(0, vitest.it)("should handle mixed nested and flat configuration", () => {
 			const config = {
 				appName: zod_v4.z.string().default("Test App"),
 				database: {
@@ -120,7 +121,7 @@ require_vi_bdSIJ99Y.describe("ConfigParser", () => {
 			};
 			const parser = new require_EnvironmentParser.ConfigParser(config);
 			const result = parser.parse();
-			require_vi_bdSIJ99Y.globalExpect(result).toEqual({
+			(0, vitest.expect)(result).toEqual({
 				appName: "Test App",
 				database: {
 					url: "postgres://localhost/test",
@@ -134,16 +135,16 @@ require_vi_bdSIJ99Y.describe("ConfigParser", () => {
 			});
 		});
 	});
-	require_vi_bdSIJ99Y.describe("Error handling", () => {
-		require_vi_bdSIJ99Y.it("should throw ZodError for schemas without defaults", () => {
+	(0, vitest.describe)("Error handling", () => {
+		(0, vitest.it)("should throw ZodError for schemas without defaults", () => {
 			const config = {
 				required: zod_v4.z.string(),
 				alsoRequired: zod_v4.z.number()
 			};
 			const parser = new require_EnvironmentParser.ConfigParser(config);
-			require_vi_bdSIJ99Y.globalExpect(() => parser.parse()).toThrow(zod_v4.z.ZodError);
+			(0, vitest.expect)(() => parser.parse()).toThrow(zod_v4.z.ZodError);
 		});
-		require_vi_bdSIJ99Y.it("should collect multiple validation errors", () => {
+		(0, vitest.it)("should collect multiple validation errors", () => {
 			const config = {
 				field1: zod_v4.z.string(),
 				field2: zod_v4.z.number(),
@@ -152,14 +153,14 @@ require_vi_bdSIJ99Y.describe("ConfigParser", () => {
 			const parser = new require_EnvironmentParser.ConfigParser(config);
 			try {
 				parser.parse();
-				require_vi_bdSIJ99Y.globalExpect(true).toBe(false);
+				(0, vitest.expect)(true).toBe(false);
 			} catch (error) {
-				require_vi_bdSIJ99Y.globalExpect(error).toBeInstanceOf(zod_v4.z.ZodError);
+				(0, vitest.expect)(error).toBeInstanceOf(zod_v4.z.ZodError);
 				const zodError = error;
-				require_vi_bdSIJ99Y.globalExpect(zodError.issues).toHaveLength(3);
+				(0, vitest.expect)(zodError.issues).toHaveLength(3);
 			}
 		});
-		require_vi_bdSIJ99Y.it("should include correct paths in nested validation errors", () => {
+		(0, vitest.it)("should include correct paths in nested validation errors", () => {
 			const config = {
 				database: {
 					host: zod_v4.z.string(),
@@ -170,31 +171,31 @@ require_vi_bdSIJ99Y.describe("ConfigParser", () => {
 			const parser = new require_EnvironmentParser.ConfigParser(config);
 			try {
 				parser.parse();
-				require_vi_bdSIJ99Y.globalExpect(true).toBe(false);
+				(0, vitest.expect)(true).toBe(false);
 			} catch (error) {
-				require_vi_bdSIJ99Y.globalExpect(error).toBeInstanceOf(zod_v4.z.ZodError);
+				(0, vitest.expect)(error).toBeInstanceOf(zod_v4.z.ZodError);
 				const zodError = error;
 				const paths = zodError.issues.map((err) => err.path.join("."));
-				require_vi_bdSIJ99Y.globalExpect(paths).toContain("database.host");
-				require_vi_bdSIJ99Y.globalExpect(paths).toContain("database.port");
-				require_vi_bdSIJ99Y.globalExpect(paths).toContain("api.key");
+				(0, vitest.expect)(paths).toContain("database.host");
+				(0, vitest.expect)(paths).toContain("database.port");
+				(0, vitest.expect)(paths).toContain("api.key");
 			}
 		});
-		require_vi_bdSIJ99Y.it("should use default values that pass validation", () => {
+		(0, vitest.it)("should use default values that pass validation", () => {
 			const config = {
 				port: zod_v4.z.number().min(1e3).max(65535).default(3e3),
 				email: zod_v4.z.string().email().default("admin@example.com")
 			};
 			const parser = new require_EnvironmentParser.ConfigParser(config);
 			const result = parser.parse();
-			require_vi_bdSIJ99Y.globalExpect(result).toEqual({
+			(0, vitest.expect)(result).toEqual({
 				port: 3e3,
 				email: "admin@example.com"
 			});
 		});
 	});
-	require_vi_bdSIJ99Y.describe("Type safety", () => {
-		require_vi_bdSIJ99Y.it("should infer correct types for simple configuration", () => {
+	(0, vitest.describe)("Type safety", () => {
+		(0, vitest.it)("should infer correct types for simple configuration", () => {
 			const config = {
 				name: zod_v4.z.string().default("test"),
 				count: zod_v4.z.number().default(42),
@@ -204,10 +205,10 @@ require_vi_bdSIJ99Y.describe("ConfigParser", () => {
 			const result = parser.parse();
 			const _typeCheck = true;
 			const _typeCheck2 = true;
-			require_vi_bdSIJ99Y.globalExpect(_typeCheck).toBe(true);
-			require_vi_bdSIJ99Y.globalExpect(_typeCheck2).toBe(true);
+			(0, vitest.expect)(_typeCheck).toBe(true);
+			(0, vitest.expect)(_typeCheck2).toBe(true);
 		});
-		require_vi_bdSIJ99Y.it("should infer correct types for nested configuration", () => {
+		(0, vitest.it)("should infer correct types for nested configuration", () => {
 			const config = {
 				database: {
 					host: zod_v4.z.string().default("localhost"),
@@ -219,10 +220,10 @@ require_vi_bdSIJ99Y.describe("ConfigParser", () => {
 			const result = parser.parse();
 			const _typeCheck = true;
 			const _typeCheck2 = true;
-			require_vi_bdSIJ99Y.globalExpect(_typeCheck).toBe(true);
-			require_vi_bdSIJ99Y.globalExpect(_typeCheck2).toBe(true);
+			(0, vitest.expect)(_typeCheck).toBe(true);
+			(0, vitest.expect)(_typeCheck2).toBe(true);
 		});
-		require_vi_bdSIJ99Y.it("should handle optional types correctly", () => {
+		(0, vitest.it)("should handle optional types correctly", () => {
 			const config = {
 				required: zod_v4.z.string().default("value"),
 				optional: zod_v4.z.string().optional(),
@@ -232,8 +233,8 @@ require_vi_bdSIJ99Y.describe("ConfigParser", () => {
 			const result = parser.parse();
 		});
 	});
-	require_vi_bdSIJ99Y.describe("Complex schemas", () => {
-		require_vi_bdSIJ99Y.it("should handle enum schemas", () => {
+	(0, vitest.describe)("Complex schemas", () => {
+		(0, vitest.it)("should handle enum schemas", () => {
 			const config = {
 				environment: zod_v4.z.enum([
 					"development",
@@ -249,36 +250,36 @@ require_vi_bdSIJ99Y.describe("ConfigParser", () => {
 			};
 			const parser = new require_EnvironmentParser.ConfigParser(config);
 			const result = parser.parse();
-			require_vi_bdSIJ99Y.globalExpect(result).toEqual({
+			(0, vitest.expect)(result).toEqual({
 				environment: "development",
 				logLevel: "info"
 			});
 		});
-		require_vi_bdSIJ99Y.it("should handle union schemas", () => {
+		(0, vitest.it)("should handle union schemas", () => {
 			const config = {
 				port: zod_v4.z.union([zod_v4.z.string(), zod_v4.z.number()]).default(3e3),
 				timeout: zod_v4.z.union([zod_v4.z.number(), zod_v4.z.null()]).default(null)
 			};
 			const parser = new require_EnvironmentParser.ConfigParser(config);
 			const result = parser.parse();
-			require_vi_bdSIJ99Y.globalExpect(result).toEqual({
+			(0, vitest.expect)(result).toEqual({
 				port: 3e3,
 				timeout: null
 			});
 		});
-		require_vi_bdSIJ99Y.it("should handle array schemas", () => {
+		(0, vitest.it)("should handle array schemas", () => {
 			const config = {
 				tags: zod_v4.z.array(zod_v4.z.string()).default(["tag1", "tag2"]),
 				ports: zod_v4.z.array(zod_v4.z.number()).default([3e3, 3001])
 			};
 			const parser = new require_EnvironmentParser.ConfigParser(config);
 			const result = parser.parse();
-			require_vi_bdSIJ99Y.globalExpect(result).toEqual({
+			(0, vitest.expect)(result).toEqual({
 				tags: ["tag1", "tag2"],
 				ports: [3e3, 3001]
 			});
 		});
-		require_vi_bdSIJ99Y.it("should handle record schemas", () => {
+		(0, vitest.it)("should handle record schemas", () => {
 			const config = {
 				metadata: zod_v4.z.record(zod_v4.z.string(), zod_v4.z.string()).default({
 					key1: "value1",
@@ -291,7 +292,7 @@ require_vi_bdSIJ99Y.describe("ConfigParser", () => {
 			};
 			const parser = new require_EnvironmentParser.ConfigParser(config);
 			const result = parser.parse();
-			require_vi_bdSIJ99Y.globalExpect(result).toEqual({
+			(0, vitest.expect)(result).toEqual({
 				metadata: {
 					key1: "value1",
 					key2: "value2"
@@ -302,7 +303,7 @@ require_vi_bdSIJ99Y.describe("ConfigParser", () => {
 				}
 			});
 		});
-		require_vi_bdSIJ99Y.it("should handle transformed schemas", () => {
+		(0, vitest.it)("should handle transformed schemas", () => {
 			const config = {
 				portString: zod_v4.z.string().transform(Number).default(8080),
 				booleanString: zod_v4.z.string().transform((v) => v === "true").default(false),
@@ -310,7 +311,7 @@ require_vi_bdSIJ99Y.describe("ConfigParser", () => {
 			};
 			const parser = new require_EnvironmentParser.ConfigParser(config);
 			const result = parser.parse();
-			require_vi_bdSIJ99Y.globalExpect(result).toEqual({
+			(0, vitest.expect)(result).toEqual({
 				portString: 8080,
 				booleanString: false,
 				jsonString: { key: "value" }