@geekmidas/envkit 0.0.4 → 0.0.6

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

@@ -7,13 +7,13 @@ const zod_v4 = require_chunk.__toESM(require("zod/v4"));
 /**
 * 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) {
@@ -51,9 +51,9 @@ var ConfigParser = class {
 * 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)
@@ -69,7 +69,7 @@ var ConfigParser = class {
 var EnvironmentParser = class {
 	/**
 	* Creates a new EnvironmentParser instance.
-	* 
+	*
 	* @param config - The configuration object to parse (typically process.env)
 	*/
 	constructor(config) {
@@ -78,7 +78,7 @@ var EnvironmentParser = class {
 	/**
 	* 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
@@ -129,7 +129,7 @@ var EnvironmentParser = class {
 	/**
 	* 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
 	*/

package/dist/EnvironmentParser-C-arQEHQ.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-jKrGMBhP.mjs → EnvironmentParser-CQUOGqc0.mjs}

@@ -6,13 +6,13 @@ import { z } from "zod/v4";
 /**
 * 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) {
@@ -50,9 +50,9 @@ var ConfigParser = class {
 * 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)
@@ -68,7 +68,7 @@ var ConfigParser = class {
 var EnvironmentParser = class {
 	/**
 	* Creates a new EnvironmentParser instance.
-	* 
+	*
 	* @param config - The configuration object to parse (typically process.env)
 	*/
 	constructor(config) {
@@ -77,7 +77,7 @@ var EnvironmentParser = class {
 	/**
 	* 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
@@ -128,7 +128,7 @@ var EnvironmentParser = class {
 	/**
 	* 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
 	*/

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-Bo2CCl_K.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-C-arQEHQ.mjs";
+export { ConfigParser, EmptyObject, EnvFetcher, EnvironmentBuilder, EnvironmentParser, InferConfig };

package/dist/EnvironmentParser.mjs

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

package/dist/__tests__/ConfigParser.spec.cjs

@@ -1,5 +1,5 @@
 const require_chunk = require('../chunk-CUT6urMc.cjs');
-const require_EnvironmentParser = require('../EnvironmentParser-Bo2CCl_K.cjs');
+const require_EnvironmentParser = require('../EnvironmentParser-BDPDLv6i.cjs');
 const zod_v4 = require_chunk.__toESM(require("zod/v4"));
 const vitest = require_chunk.__toESM(require("vitest"));
 

package/dist/__tests__/ConfigParser.spec.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/__tests__/ConfigParser.spec.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/__tests__/ConfigParser.spec.mjs

@@ -1,4 +1,4 @@
-import { ConfigParser } from "../EnvironmentParser-jKrGMBhP.mjs";
+import { ConfigParser } from "../EnvironmentParser-CQUOGqc0.mjs";
 import { z } from "zod/v4";
 import { describe, expect, it } from "vitest";
 

package/dist/__tests__/EnvironmentParser.spec.cjs

@@ -1,5 +1,5 @@
 const require_chunk = require('../chunk-CUT6urMc.cjs');
-const require_EnvironmentParser = require('../EnvironmentParser-Bo2CCl_K.cjs');
+const require_EnvironmentParser = require('../EnvironmentParser-BDPDLv6i.cjs');
 const zod_v4 = require_chunk.__toESM(require("zod/v4"));
 const vitest = require_chunk.__toESM(require("vitest"));
 

package/dist/__tests__/EnvironmentParser.spec.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/__tests__/EnvironmentParser.spec.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/__tests__/EnvironmentParser.spec.mjs

@@ -1,4 +1,4 @@
-import { EnvironmentParser } from "../EnvironmentParser-jKrGMBhP.mjs";
+import { EnvironmentParser } from "../EnvironmentParser-CQUOGqc0.mjs";
 import { z } from "zod/v4";
 import { describe, expect, it } from "vitest";