@geekmidas/envkit 0.0.2 → 0.0.4

package/src/sst.ts

@@ -0,0 +1,221 @@
+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.
+ * 
+ * @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.
+ * 
+ * @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, ... }
+ * })
+ */
+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;
+}
+
+/**
+ * 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
+ */
+export type ResourceProcessor<K extends Resource> = (
+  name: string,
+  value: K,
+) => Record<string, string | number>;

package/dist/EnvironmentParser-Dd6TbwJC.mjs

@@ -1,99 +0,0 @@
-import get from "lodash.get";
-import set from "lodash.set";
-import { z } from "zod/v4";
-
-//#region src/EnvironmentParser.ts
-var ConfigParser = class {
-	constructor(config) {
-		this.config = config;
-	}
-	/**
-	* Parses the config object and validates it against the Zod schemas
-	* @returns The parsed config object
-	*/
-	parse() {
-		const errors = [];
-		const parseDeep = (config, path = []) => {
-			const result = {};
-			if (config && typeof config !== "object") return config;
-			for (const key in config) {
-				const schema = config[key];
-				const currentPath = [...path, key];
-				if (schema instanceof z.ZodType) {
-					const parsed = schema.safeParse(void 0);
-					if (parsed.success) set(result, key, parsed.data);
-					else errors.push(...parsed.error.issues.map((issue) => ({
-						...issue,
-						path: [...currentPath, ...issue.path]
-					})));
-				} else if (schema) set(result, key, parseDeep(schema, currentPath));
-			}
-			return result;
-		};
-		const parsedConfig = parseDeep(this.config);
-		if (errors.length > 0) throw new z.ZodError(errors);
-		return parsedConfig;
-	}
-};
-var EnvironmentParser = class {
-	constructor(config) {
-		this.config = config;
-	}
-	getZodGetter = (name) => {
-		return new Proxy({ ...z }, { get: (target, prop) => {
-			const func = target[prop];
-			if (typeof func === "function") return (...args) => {
-				const schema = func(...args);
-				const originalParse = schema.parse;
-				const originalSafeParse = schema.safeParse;
-				schema.parse = () => {
-					const value = get(this.config, name);
-					try {
-						return originalParse.call(schema, value);
-					} catch (error) {
-						if (error instanceof z.ZodError) {
-							const modifiedIssues = error.issues.map((issue) => ({
-								...issue,
-								message: `Environment variable "${name}": ${issue.message}`,
-								path: [name, ...issue.path]
-							}));
-							throw new z.ZodError(modifiedIssues);
-						}
-						throw error;
-					}
-				};
-				schema.safeParse = () => {
-					const value = get(this.config, name);
-					const result = originalSafeParse.call(schema, value);
-					if (!result.success) {
-						const modifiedIssues = result.error.issues.map((issue) => ({
-							...issue,
-							message: `Environment variable "${name}": ${issue.message}`,
-							path: [name, ...issue.path]
-						}));
-						return {
-							success: false,
-							error: new z.ZodError(modifiedIssues)
-						};
-					}
-					return result;
-				};
-				return schema;
-			};
-			return func;
-		} });
-	};
-	/**
-	* Creates a new JordConfigParser 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
-	*/
-	create(builder) {
-		const config = builder(this.getZodGetter);
-		return new ConfigParser(config);
-	}
-};
-
-//#endregion
-export { ConfigParser, EnvironmentParser };

package/dist/EnvironmentParser-nZnZXM_Y.cjs

@@ -1,133 +0,0 @@
-//#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 __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"));
-
-//#region src/EnvironmentParser.ts
-var ConfigParser = class {
-	constructor(config) {
-		this.config = config;
-	}
-	/**
-	* Parses the config object and validates it against the Zod schemas
-	* @returns The parsed config object
-	*/
-	parse() {
-		const errors = [];
-		const parseDeep = (config, path = []) => {
-			const result = {};
-			if (config && typeof config !== "object") return config;
-			for (const key in config) {
-				const schema = config[key];
-				const currentPath = [...path, key];
-				if (schema instanceof zod_v4.z.ZodType) {
-					const parsed = schema.safeParse(void 0);
-					if (parsed.success) (0, lodash_set.default)(result, key, parsed.data);
-					else errors.push(...parsed.error.issues.map((issue) => ({
-						...issue,
-						path: [...currentPath, ...issue.path]
-					})));
-				} else if (schema) (0, lodash_set.default)(result, key, parseDeep(schema, currentPath));
-			}
-			return result;
-		};
-		const parsedConfig = parseDeep(this.config);
-		if (errors.length > 0) throw new zod_v4.z.ZodError(errors);
-		return parsedConfig;
-	}
-};
-var EnvironmentParser = class {
-	constructor(config) {
-		this.config = config;
-	}
-	getZodGetter = (name) => {
-		return new Proxy({ ...zod_v4.z }, { get: (target, prop) => {
-			const func = target[prop];
-			if (typeof func === "function") return (...args) => {
-				const schema = func(...args);
-				const originalParse = schema.parse;
-				const originalSafeParse = schema.safeParse;
-				schema.parse = () => {
-					const value = (0, lodash_get.default)(this.config, name);
-					try {
-						return originalParse.call(schema, value);
-					} catch (error) {
-						if (error instanceof zod_v4.z.ZodError) {
-							const modifiedIssues = error.issues.map((issue) => ({
-								...issue,
-								message: `Environment variable "${name}": ${issue.message}`,
-								path: [name, ...issue.path]
-							}));
-							throw new zod_v4.z.ZodError(modifiedIssues);
-						}
-						throw error;
-					}
-				};
-				schema.safeParse = () => {
-					const value = (0, lodash_get.default)(this.config, name);
-					const result = originalSafeParse.call(schema, value);
-					if (!result.success) {
-						const modifiedIssues = result.error.issues.map((issue) => ({
-							...issue,
-							message: `Environment variable "${name}": ${issue.message}`,
-							path: [name, ...issue.path]
-						}));
-						return {
-							success: false,
-							error: new zod_v4.z.ZodError(modifiedIssues)
-						};
-					}
-					return result;
-				};
-				return schema;
-			};
-			return func;
-		} });
-	};
-	/**
-	* Creates a new JordConfigParser 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
-	*/
-	create(builder) {
-		const config = builder(this.getZodGetter);
-		return new ConfigParser(config);
-	}
-};
-
-//#endregion
-Object.defineProperty(exports, 'ConfigParser', {
-  enumerable: true,
-  get: function () {
-    return ConfigParser;
-  }
-});
-Object.defineProperty(exports, 'EnvironmentParser', {
-  enumerable: true,
-  get: function () {
-    return EnvironmentParser;
-  }
-});