@e-n-v/env 0.0.2 → 0.0.5

package/dist/src-Cjo2XA4n.cjs

@@ -0,0 +1,138 @@
+const require_src = require('./src-meUnCASg.cjs');
+const require_src$1 = require('./src-XjL5cyPG.cjs');
+
+//#region ../parse/src/errors/EnvParseError.ts
+/**
+* Error thrown when parsing environment variables fails.
+* Collects all issues so callers can inspect them without relying on subclasses.
+*/
+var EnvParseError = class EnvParseError extends Error {
+	issues;
+	partial;
+	constructor(params) {
+		const { issues, partial } = params;
+		super(EnvParseError.formatMessage(issues));
+		this.name = "EnvParseError";
+		this.issues = Object.freeze([...issues]);
+		this.partial = partial ?? {};
+	}
+	/** Number of issues encountered while parsing. */
+	get issueCount() {
+		return this.issues.length;
+	}
+	/** Keys that were missing but required. */
+	get missing() {
+		return this.issues.filter((issue) => issue.type === "missing").map((issue) => issue.key);
+	}
+	/** Keys that were present but invalid. */
+	get invalid() {
+		return this.issues.filter((issue) => issue.type === "invalid").map((issue) => issue.key);
+	}
+	/**
+	* Get all issue messages as a numbered list for easy logging.
+	*/
+	formatIssues() {
+		return this.issues.map((issue, index) => `${index + 1}. ${issue.message}`).join("\n");
+	}
+	static formatMessage(issues) {
+		if (issues.length === 0) return "Environment validation failed with no details.";
+		return [`Environment validation failed with ${issues.length} issue${issues.length === 1 ? "" : "s"}:`, ...issues.map((issue) => {
+			if (issue.type === "missing") return `- ${issue.key}: ${issue.message}`;
+			return `- ${issue.key}: ${issue.message}`;
+		})].join("\n");
+	}
+};
+
+//#endregion
+//#region ../parse/src/parse.ts
+/**
+* Parse and validate environment variables from a source object
+* Does NOT mutate process.env
+*/
+function parse(source, modelOrOptions) {
+	let resolvedSchemas;
+	let preprocessConfig;
+	if (modelOrOptions instanceof require_src$1.EnvModel) {
+		const model = modelOrOptions;
+		resolvedSchemas = model.schemas;
+		preprocessConfig = model.preprocess;
+	} else {
+		const options = modelOrOptions;
+		resolvedSchemas = require_src$1.resolveSchemas(options.schemas);
+		const config = options.preprocess;
+		if (config === false) preprocessConfig = {
+			string: false,
+			number: false,
+			boolean: false,
+			enum: false
+		};
+		else if (config === true || config === void 0) preprocessConfig = {};
+		else preprocessConfig = { ...config };
+	}
+	const result = {};
+	const issues = [];
+	for (const [key, schema$1] of Object.entries(resolvedSchemas)) {
+		const rawValue = source[key];
+		if (rawValue === void 0 || rawValue.trim() === "") {
+			if (schema$1.default !== void 0) {
+				result[key] = schema$1.default;
+				continue;
+			}
+			if (schema$1.required) {
+				issues.push({
+					type: "missing",
+					key,
+					message: `Required environment variable "${key}" is missing`
+				});
+				result[key] = void 0;
+				continue;
+			}
+			result[key] = void 0;
+			continue;
+		}
+		const preprocessor = require_src.resolvePreprocessor(schema$1.type, preprocessConfig);
+		const preprocessedValue = preprocessor ? preprocessor(rawValue) : rawValue;
+		const stringValue = typeof preprocessedValue === "string" ? preprocessedValue : String(preprocessedValue);
+		try {
+			const processedValue = schema$1.process(stringValue);
+			if (processedValue === void 0) if (schema$1.default !== void 0) result[key] = schema$1.default;
+			else if (schema$1.required) {
+				issues.push({
+					type: "missing",
+					key,
+					message: `Required environment variable "${key}" is missing`
+				});
+				result[key] = void 0;
+			} else result[key] = void 0;
+			else result[key] = processedValue;
+		} catch (error) {
+			const message = `Environment variable "${key}" validation failed: ${error instanceof Error ? error.message : String(error)}`;
+			issues.push({
+				type: "invalid",
+				key,
+				value: rawValue,
+				message
+			});
+			result[key] = void 0;
+		}
+	}
+	if (issues.length > 0) throw new EnvParseError({
+		issues,
+		partial: { ...result }
+	});
+	return result;
+}
+
+//#endregion
+Object.defineProperty(exports, 'EnvParseError', {
+  enumerable: true,
+  get: function () {
+    return EnvParseError;
+  }
+});
+Object.defineProperty(exports, 'parse', {
+  enumerable: true,
+  get: function () {
+    return parse;
+  }
+});