@geekmidas/envkit 0.0.4 → 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-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-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-BD6NmvPR.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";
 

package/dist/index.cjs

@@ -1,3 +1,3 @@
-const require_EnvironmentParser = require('./EnvironmentParser-Bo2CCl_K.cjs');
+const require_EnvironmentParser = require('./EnvironmentParser-BDPDLv6i.cjs');
 
 exports.EnvironmentParser = require_EnvironmentParser.EnvironmentParser;

package/dist/index.d.cts

@@ -0,0 +1,2 @@
+import { EnvironmentParser } from "./EnvironmentParser-X4h2Vp4r.cjs";
+export { EnvironmentParser };

package/dist/index.d.mts

@@ -0,0 +1,2 @@
+import { EnvironmentParser } from "./EnvironmentParser-BD6NmvPR.mjs";
+export { EnvironmentParser };

package/dist/index.mjs

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

package/dist/sst.cjs

@@ -5,10 +5,10 @@ const lodash_snakecase = require_chunk.__toESM(require("lodash.snakecase"));
 /**
 * Converts a string to environment variable case format (UPPER_SNAKE_CASE).
 * Numbers following underscores are preserved without the underscore.
-* 
+*
 * @param name - The string to convert
 * @returns The converted string in environment variable format
-* 
+*
 * @example
 * environmentCase('myVariable') // 'MY_VARIABLE'
 * environmentCase('api_v2') // 'APIV2'
@@ -38,7 +38,7 @@ let ResourceType = /* @__PURE__ */ function(ResourceType$1) {
 }({});
 /**
 * Processes a Secret resource into environment variables.
-* 
+*
 * @param name - The resource name
 * @param value - The Secret resource
 * @returns Object with environment variable mappings
@@ -47,7 +47,7 @@ const secret = (name, value) => ({ [environmentCase(name)]: value.value });
 /**
 * Processes a Postgres database resource into environment variables.
 * Creates multiple environment variables for database connection details.
-* 
+*
 * @param key - The resource key
 * @param value - The Postgres resource
 * @returns Object with database connection environment variables
@@ -64,7 +64,7 @@ const postgres = (key, value) => {
 };
 /**
 * Processes a Bucket resource into environment variables.
-* 
+*
 * @param name - The resource name
 * @param value - The Bucket resource
 * @returns Object with bucket name environment variable
@@ -75,7 +75,7 @@ const bucket = (name, value) => {
 };
 /**
 * No-operation processor for resources that don't require environment variables.
-* 
+*
 * @param name - The resource name (unused)
 * @param value - The resource value (unused)
 * @returns Empty object
@@ -101,10 +101,10 @@ const processors = {
 /**
 * Normalizes SST resources and plain strings into environment variables.
 * Processes resources based on their type and converts names to environment case.
-* 
+*
 * @param record - Object containing resources and/or string values
 * @returns Normalized environment variables object
-* 
+*
 * @example
 * normalizeResourceEnv({
 *   apiUrl: 'https://api.example.com',

package/dist/sst.d.cts

@@ -0,0 +1,107 @@
+//#region src/sst.d.ts
+/**
+ * Converts a string to environment variable case format (UPPER_SNAKE_CASE).
+ * Numbers following underscores are preserved without the underscore.
+ *
+ * @param name - The string to convert
+ * @returns The converted string in environment variable format
+ *
+ * @example
+ * environmentCase('myVariable') // 'MY_VARIABLE'
+ * environmentCase('api_v2') // 'APIV2'
+ */
+declare function environmentCase(name: string): string;
+/**
+ * Enumeration of supported SST (Serverless Stack Toolkit) resource types.
+ * Used to identify and process different AWS and SST resources.
+ */
+declare enum ResourceType {
+  ApiGatewayV2 = "sst.aws.ApiGatewayV2",
+  Postgres = "sst.aws.Postgres",
+  Function = "sst.aws.Function",
+  Bucket = "sst.aws.Bucket",
+  Vpc = "sst.aws.Vpc",
+  Secret = "sst.sst.Secret",
+  SSTSecret = "sst:sst:Secret",
+  SSTFunction = "sst:sst:Function",
+  SSTApiGatewayV2 = "sst:aws:ApiGatewayV2",
+  SSTPostgres = "sst:aws:Postgres",
+  SSTBucket = "sst:aws:Bucket",
+}
+/**
+ * Normalizes SST resources and plain strings into environment variables.
+ * Processes resources based on their type and converts names to environment case.
+ *
+ * @param record - Object containing resources and/or string values
+ * @returns Normalized environment variables object
+ *
+ * @example
+ * normalizeResourceEnv({
+ *   apiUrl: 'https://api.example.com',
+ *   database: { type: ResourceType.Postgres, ... }
+ * })
+ */
+declare function normalizeResourceEnv(record: Record<string, Resource | string>): Record<string, string>;
+/**
+ * AWS API Gateway V2 resource type.
+ * Represents an HTTP/WebSocket API.
+ */
+type ApiGatewayV2 = {
+  type: ResourceType.ApiGatewayV2;
+  url: string;
+};
+/**
+ * PostgreSQL database resource type.
+ * Contains all connection details needed to connect to the database.
+ */
+type Postgres = {
+  database: string;
+  host: string;
+  password: string;
+  port: number;
+  type: ResourceType.Postgres;
+  username: string;
+};
+/**
+ * AWS Lambda Function resource type.
+ */
+type Function = {
+  name: string;
+  type: ResourceType.Function;
+};
+/**
+ * AWS S3 Bucket resource type.
+ */
+type Bucket = {
+  name: string;
+  type: ResourceType.Bucket;
+};
+/**
+ * AWS VPC (Virtual Private Cloud) resource type.
+ */
+type Vpc = {
+  bastion: string;
+  type: ResourceType.Vpc;
+};
+/**
+ * Secret resource type for storing sensitive values.
+ */
+type Secret = {
+  type: ResourceType.Secret;
+  value: string;
+};
+/**
+ * Union type of all supported SST resource types.
+ */
+type Resource = ApiGatewayV2 | Postgres | Function | Bucket | Vpc | Secret;
+/**
+ * Function type for processing a specific resource type into environment variables.
+ *
+ * @template K - The specific resource type
+ * @param name - The resource name
+ * @param value - The resource value
+ * @returns Object mapping environment variable names to values
+ */
+type ResourceProcessor<K extends Resource> = (name: string, value: K) => Record<string, string | number>;
+//#endregion
+export { ApiGatewayV2, Bucket, Function, Postgres, Resource, ResourceProcessor, ResourceType, Secret, Vpc, environmentCase, normalizeResourceEnv };

package/dist/sst.d.mts

@@ -0,0 +1,107 @@
+//#region src/sst.d.ts
+/**
+ * Converts a string to environment variable case format (UPPER_SNAKE_CASE).
+ * Numbers following underscores are preserved without the underscore.
+ *
+ * @param name - The string to convert
+ * @returns The converted string in environment variable format
+ *
+ * @example
+ * environmentCase('myVariable') // 'MY_VARIABLE'
+ * environmentCase('api_v2') // 'APIV2'
+ */
+declare function environmentCase(name: string): string;
+/**
+ * Enumeration of supported SST (Serverless Stack Toolkit) resource types.
+ * Used to identify and process different AWS and SST resources.
+ */
+declare enum ResourceType {
+  ApiGatewayV2 = "sst.aws.ApiGatewayV2",
+  Postgres = "sst.aws.Postgres",
+  Function = "sst.aws.Function",
+  Bucket = "sst.aws.Bucket",
+  Vpc = "sst.aws.Vpc",
+  Secret = "sst.sst.Secret",
+  SSTSecret = "sst:sst:Secret",
+  SSTFunction = "sst:sst:Function",
+  SSTApiGatewayV2 = "sst:aws:ApiGatewayV2",
+  SSTPostgres = "sst:aws:Postgres",
+  SSTBucket = "sst:aws:Bucket",
+}
+/**
+ * Normalizes SST resources and plain strings into environment variables.
+ * Processes resources based on their type and converts names to environment case.
+ *
+ * @param record - Object containing resources and/or string values
+ * @returns Normalized environment variables object
+ *
+ * @example
+ * normalizeResourceEnv({
+ *   apiUrl: 'https://api.example.com',
+ *   database: { type: ResourceType.Postgres, ... }
+ * })
+ */
+declare function normalizeResourceEnv(record: Record<string, Resource | string>): Record<string, string>;
+/**
+ * AWS API Gateway V2 resource type.
+ * Represents an HTTP/WebSocket API.
+ */
+type ApiGatewayV2 = {
+  type: ResourceType.ApiGatewayV2;
+  url: string;
+};
+/**
+ * PostgreSQL database resource type.
+ * Contains all connection details needed to connect to the database.
+ */
+type Postgres = {
+  database: string;
+  host: string;
+  password: string;
+  port: number;
+  type: ResourceType.Postgres;
+  username: string;
+};
+/**
+ * AWS Lambda Function resource type.
+ */
+type Function = {
+  name: string;
+  type: ResourceType.Function;
+};
+/**
+ * AWS S3 Bucket resource type.
+ */
+type Bucket = {
+  name: string;
+  type: ResourceType.Bucket;
+};
+/**
+ * AWS VPC (Virtual Private Cloud) resource type.
+ */
+type Vpc = {
+  bastion: string;
+  type: ResourceType.Vpc;
+};
+/**
+ * Secret resource type for storing sensitive values.
+ */
+type Secret = {
+  type: ResourceType.Secret;
+  value: string;
+};
+/**
+ * Union type of all supported SST resource types.
+ */
+type Resource = ApiGatewayV2 | Postgres | Function | Bucket | Vpc | Secret;
+/**
+ * Function type for processing a specific resource type into environment variables.
+ *
+ * @template K - The specific resource type
+ * @param name - The resource name
+ * @param value - The resource value
+ * @returns Object mapping environment variable names to values
+ */
+type ResourceProcessor<K extends Resource> = (name: string, value: K) => Record<string, string | number>;
+//#endregion
+export { ApiGatewayV2, Bucket, Function, Postgres, Resource, ResourceProcessor, ResourceType, Secret, Vpc, environmentCase, normalizeResourceEnv };

package/dist/sst.mjs

@@ -4,10 +4,10 @@ import snakecase from "lodash.snakecase";
 /**
 * Converts a string to environment variable case format (UPPER_SNAKE_CASE).
 * Numbers following underscores are preserved without the underscore.
-* 
+*
 * @param name - The string to convert
 * @returns The converted string in environment variable format
-* 
+*
 * @example
 * environmentCase('myVariable') // 'MY_VARIABLE'
 * environmentCase('api_v2') // 'APIV2'
@@ -37,7 +37,7 @@ let ResourceType = /* @__PURE__ */ function(ResourceType$1) {
 }({});
 /**
 * Processes a Secret resource into environment variables.
-* 
+*
 * @param name - The resource name
 * @param value - The Secret resource
 * @returns Object with environment variable mappings
@@ -46,7 +46,7 @@ const secret = (name, value) => ({ [environmentCase(name)]: value.value });
 /**
 * Processes a Postgres database resource into environment variables.
 * Creates multiple environment variables for database connection details.
-* 
+*
 * @param key - The resource key
 * @param value - The Postgres resource
 * @returns Object with database connection environment variables
@@ -63,7 +63,7 @@ const postgres = (key, value) => {
 };
 /**
 * Processes a Bucket resource into environment variables.
-* 
+*
 * @param name - The resource name
 * @param value - The Bucket resource
 * @returns Object with bucket name environment variable
@@ -74,7 +74,7 @@ const bucket = (name, value) => {
 };
 /**
 * No-operation processor for resources that don't require environment variables.
-* 
+*
 * @param name - The resource name (unused)
 * @param value - The resource value (unused)
 * @returns Empty object
@@ -100,10 +100,10 @@ const processors = {
 /**
 * Normalizes SST resources and plain strings into environment variables.
 * Processes resources based on their type and converts names to environment case.
-* 
+*
 * @param record - Object containing resources and/or string values
 * @returns Normalized environment variables object
-* 
+*
 * @example
 * normalizeResourceEnv({
 *   apiUrl: 'https://api.example.com',

package/package.json

@@ -1,18 +1,18 @@
 {
   "name": "@geekmidas/envkit",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "private": false,
   "type": "module",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
-      "require": "./dist/index.cjs",
-      "types": "./src/index.ts"
+      "require": "./dist/index.cjs"
     },
     "./sst": {
+      "types": "./dist/sst.d.ts",
       "import": "./dist/sst.mjs",
-      "require": "./dist/sst.cjs",
-      "types": "./src/sst.ts"
+      "require": "./dist/sst.cjs"
     }
   },
   "publishConfig": {

package/src/EnvironmentParser.ts

@@ -5,13 +5,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
  */
 export class ConfigParser<TResponse extends EmptyObject> {
   /**
    * Creates a new ConfigParser instance.
-   * 
+   *
    * @param config - The configuration object to parse
    */
   constructor(private readonly config: TResponse) {}
@@ -71,9 +71,9 @@ export class ConfigParser<TResponse extends EmptyObject> {
  * 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)
@@ -89,7 +89,7 @@ export class ConfigParser<TResponse extends EmptyObject> {
 export class EnvironmentParser<T extends EmptyObject> {
   /**
    * Creates a new EnvironmentParser instance.
-   * 
+   *
    * @param config - The configuration object to parse (typically process.env)
    */
   constructor(private readonly config: T) {}
@@ -97,7 +97,7 @@ export class EnvironmentParser<T extends EmptyObject> {
   /**
    * 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
@@ -172,7 +172,7 @@ export class EnvironmentParser<T extends EmptyObject> {
   /**
    * 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
    */
@@ -234,7 +234,7 @@ export class EnvironmentParser<T extends EmptyObject> {
 /**
  * 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
  */
 export type InferConfig<T extends EmptyObject> = {
@@ -248,7 +248,7 @@ export type InferConfig<T extends EmptyObject> = {
 /**
  * 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
@@ -260,7 +260,7 @@ export type EnvFetcher<TPath extends string = string> = (
 /**
  * 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

package/src/sst.ts

@@ -3,10 +3,10 @@ import snakecase from 'lodash.snakecase';
 /**
  * Converts a string to environment variable case format (UPPER_SNAKE_CASE).
  * Numbers following underscores are preserved without the underscore.
- * 
+ *
  * @param name - The string to convert
  * @returns The converted string in environment variable format
- * 
+ *
  * @example
  * environmentCase('myVariable') // 'MY_VARIABLE'
  * environmentCase('api_v2') // 'APIV2'
@@ -39,7 +39,7 @@ export enum ResourceType {
 
 /**
  * Processes a Secret resource into environment variables.
- * 
+ *
  * @param name - The resource name
  * @param value - The Secret resource
  * @returns Object with environment variable mappings
@@ -50,7 +50,7 @@ const secret = (name: string, value: Secret) => ({
 /**
  * Processes a Postgres database resource into environment variables.
  * Creates multiple environment variables for database connection details.
- * 
+ *
  * @param key - The resource key
  * @param value - The Postgres resource
  * @returns Object with database connection environment variables
@@ -68,7 +68,7 @@ const postgres = (key: string, value: Postgres) => {
 
 /**
  * Processes a Bucket resource into environment variables.
- * 
+ *
  * @param name - The resource name
  * @param value - The Bucket resource
  * @returns Object with bucket name environment variable
@@ -82,7 +82,7 @@ const bucket = (name: string, value: Bucket) => {
 
 /**
  * No-operation processor for resources that don't require environment variables.
- * 
+ *
  * @param name - The resource name (unused)
  * @param value - The resource value (unused)
  * @returns Empty object
@@ -111,10 +111,10 @@ const processors: Record<ResourceType, ResourceProcessor<any>> = {
 /**
  * Normalizes SST resources and plain strings into environment variables.
  * Processes resources based on their type and converts names to environment case.
- * 
+ *
  * @param record - Object containing resources and/or string values
  * @returns Normalized environment variables object
- * 
+ *
  * @example
  * normalizeResourceEnv({
  *   apiUrl: 'https://api.example.com',
@@ -209,7 +209,7 @@ export type Resource =
 
 /**
  * Function type for processing a specific resource type into environment variables.
- * 
+ *
  * @template K - The specific resource type
  * @param name - The resource name
  * @param value - The resource value