@geekmidas/envkit 0.0.3 → 0.0.5

package/dist/EnvironmentParser-BD6NmvPR.d.mts

@@ -0,0 +1,108 @@
+import { z } from "zod/v4";
+
+//#region src/EnvironmentParser.d.ts
+
+/**
+ * Parses and validates configuration objects against Zod schemas.
+ * Handles nested configurations and aggregates validation errors.
+ *
+ * @template TResponse - The shape of the configuration object
+ */
+declare class ConfigParser<TResponse extends EmptyObject> {
+  private readonly config;
+  /**
+   * Creates a new ConfigParser instance.
+   *
+   * @param config - The configuration object to parse
+   */
+  constructor(config: TResponse);
+  /**
+   * Parses the config object and validates it against the Zod schemas
+   * @returns The parsed config object
+   */
+  parse(): InferConfig<TResponse>;
+}
+/**
+ * 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();
+ * ```
+ */
+declare class EnvironmentParser<T extends EmptyObject> {
+  private readonly config;
+  /**
+   * Creates a new EnvironmentParser instance.
+   *
+   * @param config - The configuration object to parse (typically process.env)
+   */
+  constructor(config: T);
+  /**
+   * 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
+   */
+  private wrapSchema;
+  /**
+   * 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
+   */
+  private getZodGetter;
+  /**
+   * 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 ConfigParser object that can be used to parse the config object
+   */
+  create<TReturn extends EmptyObject>(builder: (get: EnvFetcher) => TReturn): ConfigParser<TReturn>;
+}
+/**
+ * Infers the TypeScript type of a configuration object based on its Zod schemas.
+ * Recursively processes nested objects and extracts types from Zod schemas.
+ *
+ * @template T - The configuration object type
+ */
+type InferConfig<T extends EmptyObject> = { [K in keyof T]: T[K] extends z.ZodSchema ? z.infer<T[K]> : T[K] extends Record<string, unknown> ? InferConfig<T[K]> : T[K] };
+/**
+ * Function type for fetching environment variables with Zod validation.
+ * Returns a Zod object scoped to a specific environment variable.
+ *
+ * @template TPath - The environment variable path type
+ * @param name - The environment variable name
+ * @returns A Zod object for defining the schema
+ */
+type EnvFetcher<TPath extends string = string> = (name: TPath) => typeof z;
+/**
+ * Function type for building environment configuration objects.
+ * Takes an EnvFetcher and returns a configuration object with Zod schemas.
+ *
+ * @template TResponse - The response configuration object type
+ * @param get - The environment variable fetcher function
+ * @returns The configuration object with Zod schemas
+ */
+type EnvironmentBuilder<TResponse extends EmptyObject> = (get: EnvFetcher) => TResponse;
+/**
+ * Type alias for a generic object with unknown values.
+ * Used as a constraint for configuration objects.
+ */
+type EmptyObject = Record<string | number | symbol, unknown>;
+//#endregion
+export { ConfigParser, EmptyObject, EnvFetcher, EnvironmentBuilder, EnvironmentParser, InferConfig };

package/dist/{EnvironmentParser-Bz9IoLJs.cjs → EnvironmentParser-BDPDLv6i.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-CQUOGqc0.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-X4h2Vp4r.d.cts

@@ -0,0 +1,108 @@
+import { z } from "zod/v4";
+
+//#region src/EnvironmentParser.d.ts
+
+/**
+ * Parses and validates configuration objects against Zod schemas.
+ * Handles nested configurations and aggregates validation errors.
+ *
+ * @template TResponse - The shape of the configuration object
+ */
+declare class ConfigParser<TResponse extends EmptyObject> {
+  private readonly config;
+  /**
+   * Creates a new ConfigParser instance.
+   *
+   * @param config - The configuration object to parse
+   */
+  constructor(config: TResponse);
+  /**
+   * Parses the config object and validates it against the Zod schemas
+   * @returns The parsed config object
+   */
+  parse(): InferConfig<TResponse>;
+}
+/**
+ * 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();
+ * ```
+ */
+declare class EnvironmentParser<T extends EmptyObject> {
+  private readonly config;
+  /**
+   * Creates a new EnvironmentParser instance.
+   *
+   * @param config - The configuration object to parse (typically process.env)
+   */
+  constructor(config: T);
+  /**
+   * 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
+   */
+  private wrapSchema;
+  /**
+   * 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
+   */
+  private getZodGetter;
+  /**
+   * 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 ConfigParser object that can be used to parse the config object
+   */
+  create<TReturn extends EmptyObject>(builder: (get: EnvFetcher) => TReturn): ConfigParser<TReturn>;
+}
+/**
+ * Infers the TypeScript type of a configuration object based on its Zod schemas.
+ * Recursively processes nested objects and extracts types from Zod schemas.
+ *
+ * @template T - The configuration object type
+ */
+type InferConfig<T extends EmptyObject> = { [K in keyof T]: T[K] extends z.ZodSchema ? z.infer<T[K]> : T[K] extends Record<string, unknown> ? InferConfig<T[K]> : T[K] };
+/**
+ * Function type for fetching environment variables with Zod validation.
+ * Returns a Zod object scoped to a specific environment variable.
+ *
+ * @template TPath - The environment variable path type
+ * @param name - The environment variable name
+ * @returns A Zod object for defining the schema
+ */
+type EnvFetcher<TPath extends string = string> = (name: TPath) => typeof z;
+/**
+ * Function type for building environment configuration objects.
+ * Takes an EnvFetcher and returns a configuration object with Zod schemas.
+ *
+ * @template TResponse - The response configuration object type
+ * @param get - The environment variable fetcher function
+ * @returns The configuration object with Zod schemas
+ */
+type EnvironmentBuilder<TResponse extends EmptyObject> = (get: EnvFetcher) => TResponse;
+/**
+ * Type alias for a generic object with unknown values.
+ * Used as a constraint for configuration objects.
+ */
+type EmptyObject = Record<string | number | symbol, unknown>;
+//#endregion
+export { ConfigParser, EmptyObject, EnvFetcher, EnvironmentBuilder, EnvironmentParser, InferConfig };

package/dist/EnvironmentParser.cjs

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

package/dist/EnvironmentParser.d.cts

@@ -0,0 +1,2 @@
+import { ConfigParser, EmptyObject, EnvFetcher, EnvironmentBuilder, EnvironmentParser, InferConfig } from "./EnvironmentParser-X4h2Vp4r.cjs";
+export { ConfigParser, EmptyObject, EnvFetcher, EnvironmentBuilder, EnvironmentParser, InferConfig };

package/dist/EnvironmentParser.d.mts

@@ -0,0 +1,2 @@
+import { ConfigParser, EmptyObject, EnvFetcher, EnvironmentBuilder, EnvironmentParser, InferConfig } from "./EnvironmentParser-BD6NmvPR.mjs";
+export { ConfigParser, EmptyObject, EnvFetcher, EnvironmentBuilder, EnvironmentParser, InferConfig };

package/dist/EnvironmentParser.mjs

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