@geekmidas/envkit 0.0.7 → 0.1.0

package/src/index.ts

@@ -1 +1,13 @@
-export { EnvironmentParser } from './EnvironmentParser';
+export { EnvironmentParser, ConfigParser } from './EnvironmentParser';
+export {
+  EnvironmentBuilder,
+  environmentCase,
+  type EnvRecord,
+  type EnvValue,
+  type EnvironmentResolver,
+  type Resolvers,
+  type EnvironmentBuilderOptions,
+  type InputValue,
+  type TypedInputValue,
+  type TypedResolvers,
+} from './EnvironmentBuilder';

package/src/sst.ts

@@ -1,114 +1,38 @@
-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'
- */
-export function environmentCase(name: string) {
-  return snakecase(name)
-    .toUpperCase()
-    .replace(/_\d+/g, (r) => {
-      return r.replace('_', '');
-    });
-}
-
-/**
- * Enumeration of supported SST (Serverless Stack Toolkit) resource types.
- * Used to identify and process different AWS and SST resources.
- */
-export 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',
-}
-
-/**
- * Processes a Secret resource into environment variables.
- *
- * @param name - The resource name
- * @param value - The Secret resource
- * @returns Object with environment variable mappings
- */
-const secret = (name: string, value: Secret) => ({
-  [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
- */
-const postgres = (key: string, value: Postgres) => {
-  const prefix = `${environmentCase(key)}`;
-  return {
-    [`${prefix}_NAME`]: value.database,
-    [`${prefix}_HOST`]: value.host,
-    [`${prefix}_PASSWORD`]: value.password,
-    [`${prefix}_PORT`]: value.port,
-    [`${prefix}_USERNAME`]: value.username,
-  };
-};
-
-/**
- * Processes a Bucket resource into environment variables.
- *
- * @param name - The resource name
- * @param value - The Bucket resource
- * @returns Object with bucket name environment variable
- */
-const bucket = (name: string, value: Bucket) => {
-  const prefix = `${environmentCase(name)}`;
-  return {
-    [`${prefix}_NAME`]: value.name,
-  };
-};
-
-/**
- * No-operation processor for resources that don't require environment variables.
+// Re-export everything from SstEnvironmentBuilder
+export {
+  SstEnvironmentBuilder,
+  sstResolvers,
+  ResourceType,
+  type ApiGatewayV2,
+  type Postgres,
+  type Function,
+  type Bucket,
+  type Vpc,
+  type Secret,
+  type SnsTopic,
+  type SstResource,
+  type ResourceProcessor,
+} from './SstEnvironmentBuilder';
+
+// Re-export environmentCase from EnvironmentBuilder
+export { environmentCase } from './EnvironmentBuilder';
+
+// Re-export types from EnvironmentBuilder
+export type {
+  EnvRecord,
+  EnvValue,
+  EnvironmentBuilderOptions,
+} from './EnvironmentBuilder';
+
+// Import for deprecated function
+import {
+  SstEnvironmentBuilder,
+  type SstResource,
+} from './SstEnvironmentBuilder';
+
+/**
+ * @deprecated Use `new SstEnvironmentBuilder(record).build()` instead.
  *
- * @param name - The resource name (unused)
- * @param value - The resource value (unused)
- * @returns Empty object
- */
-const noop = (name: string, value: any) => ({});
-
-/**
- * Map of resource types to their corresponding processor functions.
- * Each processor converts resource data into environment variables.
- */
-const processors: Record<ResourceType, ResourceProcessor<any>> = {
-  [ResourceType.ApiGatewayV2]: noop,
-  [ResourceType.Function]: noop,
-  [ResourceType.Vpc]: noop,
-  [ResourceType.Secret]: secret,
-  [ResourceType.Postgres]: postgres,
-  [ResourceType.Bucket]: bucket,
-
-  [ResourceType.SSTSecret]: secret,
-  [ResourceType.SSTBucket]: bucket,
-  [ResourceType.SSTFunction]: noop,
-  [ResourceType.SSTPostgres]: postgres,
-  [ResourceType.SSTApiGatewayV2]: noop,
-};
-
-/**
  * Normalizes SST resources and plain strings into environment variables.
  * Processes resources based on their type and converts names to environment case.
  *
@@ -116,106 +40,20 @@ const processors: Record<ResourceType, ResourceProcessor<any>> = {
  * @returns Normalized environment variables object
  *
  * @example
- * normalizeResourceEnv({
- *   apiUrl: 'https://api.example.com',
- *   database: { type: ResourceType.Postgres, ... }
- * })
+ * // Old usage (deprecated):
+ * normalizeResourceEnv({ database: postgresResource })
+ *
+ * // New usage:
+ * new SstEnvironmentBuilder({ database: postgresResource }).build()
  */
 export function normalizeResourceEnv(
-  record: Record<string, Resource | string>,
-): Record<string, string> {
-  const env: Record<string, string> = {};
-  for (const [k, value] of Object.entries(record)) {
-    if (typeof value === 'string') {
-      env[environmentCase(k)] = value;
-      continue;
-    }
-
-    const processor = processors[value.type];
-    if (processor) {
-      Object.assign(env, processor(k, value));
-    } else {
-      console.warn(`No processor found for resource type: `, { value });
-    }
-  }
-
-  return env;
+  record: Record<string, SstResource | string>,
+): Record<string, string | number | boolean | Record<string, unknown>> {
+  return new SstEnvironmentBuilder(record).build();
 }
 
+// Keep Resource type as deprecated alias for backwards compatibility
 /**
- * AWS API Gateway V2 resource type.
- * Represents an HTTP/WebSocket API.
- */
-export type ApiGatewayV2 = {
-  type: ResourceType.ApiGatewayV2;
-  url: string;
-};
-
-/**
- * PostgreSQL database resource type.
- * Contains all connection details needed to connect to the database.
- */
-export type Postgres = {
-  database: string;
-  host: string;
-  password: string;
-  port: number;
-  type: ResourceType.Postgres;
-  username: string;
-};
-
-/**
- * AWS Lambda Function resource type.
- */
-export type Function = {
-  name: string;
-  type: ResourceType.Function;
-};
-
-/**
- * AWS S3 Bucket resource type.
- */
-export type Bucket = {
-  name: string;
-  type: ResourceType.Bucket;
-};
-
-/**
- * AWS VPC (Virtual Private Cloud) resource type.
- */
-export type Vpc = {
-  bastion: string;
-  type: ResourceType.Vpc;
-};
-
-/**
- * Secret resource type for storing sensitive values.
- */
-export type Secret = {
-  type: ResourceType.Secret;
-  value: string;
-};
-
-/**
- * Union type of all supported SST resource types.
- */
-export 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
+ * @deprecated Use `SstResource` instead.
  */
-export type ResourceProcessor<K extends Resource> = (
-  name: string,
-  value: K,
-) => Record<string, string | number>;
+export type Resource = SstResource;

package/dist/__tests__/ConfigParser.spec.cjs

@@ -1,323 +0,0 @@
-const require_chunk = require('../chunk-CUT6urMc.cjs');
-const require_EnvironmentParser = require('../EnvironmentParser-BDPDLv6i.cjs');
-const zod_v4 = require_chunk.__toESM(require("zod/v4"));
-const vitest = require_chunk.__toESM(require("vitest"));
-
-//#region src/__tests__/ConfigParser.spec.ts
-(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),
-				active: zod_v4.z.boolean().default(true)
-			};
-			const parser = new require_EnvironmentParser.ConfigParser(config);
-			const result = parser.parse();
-			(0, vitest.expect)(result).toEqual({
-				name: "Test",
-				age: 25,
-				active: true
-			});
-		});
-		(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();
-			(0, vitest.expect)(result).toEqual({
-				required: "value",
-				optional: void 0
-			});
-		});
-		(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"),
-				debug: zod_v4.z.boolean().default(false)
-			};
-			const parser = new require_EnvironmentParser.ConfigParser(config);
-			const result = parser.parse();
-			(0, vitest.expect)(result).toEqual({
-				port: 3e3,
-				host: "localhost",
-				debug: false
-			});
-		});
-	});
-	(0, vitest.describe)("Nested objects", () => {
-		(0, vitest.it)("should parse nested configuration objects", () => {
-			const config = {
-				database: {
-					host: zod_v4.z.string().default("localhost"),
-					port: zod_v4.z.number().default(5432),
-					ssl: zod_v4.z.boolean().default(false)
-				},
-				api: {
-					key: zod_v4.z.string().default("default-key"),
-					timeout: zod_v4.z.number().default(5e3)
-				}
-			};
-			const parser = new require_EnvironmentParser.ConfigParser(config);
-			const result = parser.parse();
-			(0, vitest.expect)(result).toEqual({
-				database: {
-					host: "localhost",
-					port: 5432,
-					ssl: false
-				},
-				api: {
-					key: "default-key",
-					timeout: 5e3
-				}
-			});
-		});
-		(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"),
-				features: {
-					auth: {
-						enabled: zod_v4.z.boolean().default(true),
-						provider: zod_v4.z.string().default("local")
-					},
-					cache: {
-						enabled: zod_v4.z.boolean().default(false),
-						ttl: zod_v4.z.number().default(3600)
-					}
-				}
-			} };
-			const parser = new require_EnvironmentParser.ConfigParser(config);
-			const result = parser.parse();
-			(0, vitest.expect)(result).toEqual({ app: {
-				name: "MyApp",
-				version: "1.0.0",
-				features: {
-					auth: {
-						enabled: true,
-						provider: "local"
-					},
-					cache: {
-						enabled: false,
-						ttl: 3600
-					}
-				}
-			} });
-		});
-		(0, vitest.it)("should handle mixed nested and flat configuration", () => {
-			const config = {
-				appName: zod_v4.z.string().default("Test App"),
-				database: {
-					url: zod_v4.z.string().default("postgres://localhost/test"),
-					poolSize: zod_v4.z.number().default(10)
-				},
-				port: zod_v4.z.number().default(3e3),
-				features: { logging: {
-					level: zod_v4.z.string().default("info"),
-					pretty: zod_v4.z.boolean().default(true)
-				} }
-			};
-			const parser = new require_EnvironmentParser.ConfigParser(config);
-			const result = parser.parse();
-			(0, vitest.expect)(result).toEqual({
-				appName: "Test App",
-				database: {
-					url: "postgres://localhost/test",
-					poolSize: 10
-				},
-				port: 3e3,
-				features: { logging: {
-					level: "info",
-					pretty: true
-				} }
-			});
-		});
-	});
-	(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);
-			(0, vitest.expect)(() => parser.parse()).toThrow(zod_v4.z.ZodError);
-		});
-		(0, vitest.it)("should collect multiple validation errors", () => {
-			const config = {
-				field1: zod_v4.z.string(),
-				field2: zod_v4.z.number(),
-				field3: zod_v4.z.boolean()
-			};
-			const parser = new require_EnvironmentParser.ConfigParser(config);
-			try {
-				parser.parse();
-				(0, vitest.expect)(true).toBe(false);
-			} catch (error) {
-				(0, vitest.expect)(error).toBeInstanceOf(zod_v4.z.ZodError);
-				const zodError = error;
-				(0, vitest.expect)(zodError.issues).toHaveLength(3);
-			}
-		});
-		(0, vitest.it)("should include correct paths in nested validation errors", () => {
-			const config = {
-				database: {
-					host: zod_v4.z.string(),
-					port: zod_v4.z.number()
-				},
-				api: { key: zod_v4.z.string() }
-			};
-			const parser = new require_EnvironmentParser.ConfigParser(config);
-			try {
-				parser.parse();
-				(0, vitest.expect)(true).toBe(false);
-			} catch (error) {
-				(0, vitest.expect)(error).toBeInstanceOf(zod_v4.z.ZodError);
-				const zodError = error;
-				const paths = zodError.issues.map((err) => err.path.join("."));
-				(0, vitest.expect)(paths).toContain("database.host");
-				(0, vitest.expect)(paths).toContain("database.port");
-				(0, vitest.expect)(paths).toContain("api.key");
-			}
-		});
-		(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();
-			(0, vitest.expect)(result).toEqual({
-				port: 3e3,
-				email: "admin@example.com"
-			});
-		});
-	});
-	(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),
-				enabled: zod_v4.z.boolean().default(true)
-			};
-			const parser = new require_EnvironmentParser.ConfigParser(config);
-			const result = parser.parse();
-			const _typeCheck = true;
-			const _typeCheck2 = true;
-			(0, vitest.expect)(_typeCheck).toBe(true);
-			(0, vitest.expect)(_typeCheck2).toBe(true);
-		});
-		(0, vitest.it)("should infer correct types for nested configuration", () => {
-			const config = {
-				database: {
-					host: zod_v4.z.string().default("localhost"),
-					port: zod_v4.z.number().default(5432)
-				},
-				features: { auth: zod_v4.z.boolean().default(true) }
-			};
-			const parser = new require_EnvironmentParser.ConfigParser(config);
-			const result = parser.parse();
-			const _typeCheck = true;
-			const _typeCheck2 = true;
-			(0, vitest.expect)(_typeCheck).toBe(true);
-			(0, vitest.expect)(_typeCheck2).toBe(true);
-		});
-		(0, vitest.it)("should handle optional types correctly", () => {
-			const config = {
-				required: zod_v4.z.string().default("value"),
-				optional: zod_v4.z.string().optional(),
-				nullable: zod_v4.z.string().nullable().default(null)
-			};
-			const parser = new require_EnvironmentParser.ConfigParser(config);
-			const result = parser.parse();
-		});
-	});
-	(0, vitest.describe)("Complex schemas", () => {
-		(0, vitest.it)("should handle enum schemas", () => {
-			const config = {
-				environment: zod_v4.z.enum([
-					"development",
-					"staging",
-					"production"
-				]).default("development"),
-				logLevel: zod_v4.z.enum([
-					"debug",
-					"info",
-					"warn",
-					"error"
-				]).default("info")
-			};
-			const parser = new require_EnvironmentParser.ConfigParser(config);
-			const result = parser.parse();
-			(0, vitest.expect)(result).toEqual({
-				environment: "development",
-				logLevel: "info"
-			});
-		});
-		(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();
-			(0, vitest.expect)(result).toEqual({
-				port: 3e3,
-				timeout: null
-			});
-		});
-		(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();
-			(0, vitest.expect)(result).toEqual({
-				tags: ["tag1", "tag2"],
-				ports: [3e3, 3001]
-			});
-		});
-		(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",
-					key2: "value2"
-				}),
-				counters: zod_v4.z.record(zod_v4.z.string(), zod_v4.z.number()).default({
-					count1: 1,
-					count2: 2
-				})
-			};
-			const parser = new require_EnvironmentParser.ConfigParser(config);
-			const result = parser.parse();
-			(0, vitest.expect)(result).toEqual({
-				metadata: {
-					key1: "value1",
-					key2: "value2"
-				},
-				counters: {
-					count1: 1,
-					count2: 2
-				}
-			});
-		});
-		(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),
-				jsonString: zod_v4.z.string().transform((v) => JSON.parse(v)).default({ key: "value" })
-			};
-			const parser = new require_EnvironmentParser.ConfigParser(config);
-			const result = parser.parse();
-			(0, vitest.expect)(result).toEqual({
-				portString: 8080,
-				booleanString: false,
-				jsonString: { key: "value" }
-			});
-		});
-	});
-});
-
-//#endregion

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

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

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

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