@efebia/one-env 1.0.0

package/lib/cli/utils/validation.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Core validation utilities for the environment CLI tool
+ */
+import { z } from 'zod/v4';
+import { ValidationResult, ValidationStatistics, FormattedIssue } from '../types.js';
+/**
+ * Validates environment data against the schema
+ * @param envData - Environment data to validate
+ * @param schema - Zod schema to validate against
+ * @param source - Source identifier (filename or secret name)
+ * @param location - Optional location (e.g., AWS region)
+ * @returns Validation result with statistics
+ */
+export declare function validateEnvData(envData: any, schema: z.ZodSchema<any>, source: string, location?: string): ValidationResult;
+/**
+ * Calculates validation statistics
+ * @param envData - Environment data being validated
+ * @param schema - Zod schema being used
+ * @param validationResult - Result from Zod validation
+ * @returns Validation statistics
+ */
+export declare function calculateValidationStatistics(envData: any, schema: z.ZodSchema<any>, validationResult: {
+    success: boolean;
+    error?: z.ZodError;
+}): ValidationStatistics;
+/**
+ * Formats Zod validation errors
+ * @param zodError - Zod error object
+ * @param envData - Original environment data
+ * @returns Formatted issues array
+ */
+export declare function formatZodError(zodError: z.ZodError, envData: any): FormattedIssue[];
+/**
+ * Formats a value for display, with sensitive field masking
+ * @param path - Field path
+ * @param value - Value to format
+ * @returns Formatted string
+ */
+export declare function formatValue(value: any): string;
+//# sourceMappingURL=validation.d.ts.map

package/lib/cli/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAErF;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC3B,OAAO,EAAE,GAAG,EACZ,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EACxB,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,GAClB,gBAAgB,CAiBlB;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CACzC,OAAO,EAAE,GAAG,EACZ,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EACxB,gBAAgB,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAA;CAAE,GAC3D,oBAAoB,CAmCtB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,GAAG,cAAc,EAAE,CAanF;AAYD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CAU9C"}

package/lib/cli/utils/validation.js

@@ -0,0 +1,116 @@
+/**
+ * Core validation utilities for the environment CLI tool
+ */
+/**
+ * Validates environment data against the schema
+ * @param envData - Environment data to validate
+ * @param schema - Zod schema to validate against
+ * @param source - Source identifier (filename or secret name)
+ * @param location - Optional location (e.g., AWS region)
+ * @returns Validation result with statistics
+ */
+export function validateEnvData(envData, schema, source, location) {
+    const validationResult = schema.safeParse(envData);
+    const statistics = calculateValidationStatistics(envData, schema, validationResult);
+    return {
+        success: validationResult.success,
+        source,
+        location,
+        validFields: statistics.validFields,
+        invalidFields: statistics.invalidFields,
+        missingFields: statistics.missingFields,
+        allMissingFields: statistics.allMissingFields,
+        data: validationResult.success ? validationResult.data : null,
+        error: validationResult.success ? undefined : {
+            formattedIssues: formatZodError(validationResult.error, envData)
+        },
+    };
+}
+/**
+ * Calculates validation statistics
+ * @param envData - Environment data being validated
+ * @param schema - Zod schema being used
+ * @param validationResult - Result from Zod validation
+ * @returns Validation statistics
+ */
+export function calculateValidationStatistics(envData, schema, validationResult) {
+    const schemaShape = schema.shape;
+    const totalFields = Object.keys(schemaShape).length;
+    const providedFields = Object.keys(envData || {}).length;
+    // Find all missing REQUIRED fields (not provided at all)
+    const requiredFields = Object.keys(schemaShape).filter(fieldName => {
+        const fieldSchema = schemaShape[fieldName];
+        const def = fieldSchema?._def;
+        // Check if field is optional, nullable, or has a default value
+        const isOptional = def?.typeName === 'ZodOptional' || def?.typeName === 'ZodNullable';
+        const hasDefault = def?.defaultValue !== undefined;
+        return !(isOptional || hasDefault);
+    });
+    const providedFieldNames = Object.keys(envData || {});
+    const allMissingFields = requiredFields.filter(field => !providedFieldNames.includes(field));
+    const missingFields = allMissingFields.length;
+    // Count validation errors that are NOT due to missing fields
+    const invalidButPresentFields = validationResult.success || !validationResult.error ? 0 :
+        validationResult.error.issues.filter((issue) => {
+            const fieldName = issue.path[0];
+            return fieldName && providedFieldNames.includes(String(fieldName));
+        }).length;
+    const validFieldsCount = validationResult.success ? totalFields : providedFields - invalidButPresentFields;
+    return {
+        totalFields,
+        providedFields,
+        validFields: validFieldsCount,
+        invalidFields: invalidButPresentFields,
+        missingFields,
+        allMissingFields,
+    };
+}
+/**
+ * Formats Zod validation errors
+ * @param zodError - Zod error object
+ * @param envData - Original environment data
+ * @returns Formatted issues array
+ */
+export function formatZodError(zodError, envData) {
+    return zodError.issues.map((issue) => {
+        const field = issue.path.join('.');
+        const actualValue = field && envData ? getNestedValue(envData, field) : undefined;
+        return {
+            path: field || 'root',
+            message: issue.message,
+            code: issue.code,
+            actualValue: actualValue !== undefined ? formatValue(actualValue) : undefined,
+            expectedType: issue.expected,
+        };
+    });
+}
+/**
+ * Gets a nested value from an object using dot notation
+ * @param obj - Object to get value from
+ * @param path - Dot-separated path
+ * @returns Value at path or undefined
+ */
+function getNestedValue(obj, path) {
+    return path.split('.').reduce((current, key) => current?.[key], obj);
+}
+/**
+ * Formats a value for display, with sensitive field masking
+ * @param path - Field path
+ * @param value - Value to format
+ * @returns Formatted string
+ */
+export function formatValue(value) {
+    // Format different value types
+    if (value === null)
+        return 'null';
+    if (value === undefined)
+        return 'undefined';
+    if (typeof value === 'string')
+        return `"${value}"`;
+    if (typeof value === 'number')
+        return value.toString();
+    if (typeof value === 'boolean')
+        return value.toString();
+    return String(value);
+}
+//# sourceMappingURL=validation.js.map

package/lib/cli/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/cli/utils/validation.ts"],"names":[],"mappings":"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"}

package/lib/env-loader.d.ts

@@ -0,0 +1,97 @@
+import { z } from 'zod/v4';
+/**
+ * Modern Environment Loader with fluent API and full type safety
+ *
+ * Usage:
+ * ```typescript
+ * import { createEnv } from '@root/libs/env';
+ * import MySchema from './schema';
+ *
+ * // Create typed env instance
+ * const env = createEnv({ schema: MySchema, file: "env.local.yml" });
+ *
+ * // OR with JSON from process.env
+ * const env = createEnv({ schema: MySchema, env: "envs" });
+ *
+ * // Use with full type safety and autocomplete
+ * const port = env.get("port"); // Typed!
+ * const { optional_key } = env.getOptional("optional_key");
+ * ```
+ */
+export declare class EnvLoader<TSchema extends z.ZodSchema<any>> {
+    private envData;
+    private schema;
+    private validatedEnv;
+    private initialized;
+    /**
+     * Initialize the environment loader
+     * @param options Either { schema, file } for YAML or { schema, env } for JSON
+     */
+    init(options: {
+        schema: TSchema;
+        file: string;
+    } | {
+        schema: TSchema;
+        env: string;
+    }): void;
+    /**
+     * Load environment data from file or process.env
+     */
+    private loadEnvironmentData;
+    /**
+     * Validate environment variables against the schema
+     */
+    private validateEnvironment;
+    /**
+     * Get required environment variable(s) with type safety
+     */
+    get<K extends keyof z.infer<TSchema>>(key: K): z.infer<TSchema>[K];
+    get<K extends keyof z.infer<TSchema>>(...keys: K[]): Pick<z.infer<TSchema>, K>;
+    /**
+     * Get optional environment variable(s) with type safety
+     */
+    getOptional<K extends keyof z.infer<TSchema>>(key: K): z.infer<TSchema>[K] | undefined;
+    getOptional<K extends keyof z.infer<TSchema>>(...keys: K[]): {
+        [P in K]: z.infer<TSchema>[P] | undefined;
+    };
+    /**
+     * Get all validated environment variables
+     */
+    getAll(): z.infer<TSchema>;
+}
+/**
+ * Creates a typed environment loader instance
+ * @param options Configuration options with schema and file/env source
+ * @returns Typed EnvLoader instance with full type safety and autocomplete
+ */
+export declare function createEnv<TSchema extends z.ZodSchema<any>>(options: {
+    schema: TSchema;
+    file: string;
+} | {
+    schema: TSchema;
+    env: string;
+}): EnvLoader<TSchema>;
+/**
+ * Interface for the enhanced env object with init method
+ */
+export interface EnvWithInit<TSchema extends z.ZodSchema<any>> {
+    init(options: {
+        file: string;
+    } | {
+        env: string;
+    }): void;
+    get<K extends keyof z.infer<TSchema>>(key: K): z.infer<TSchema>[K];
+    get<K extends keyof z.infer<TSchema>>(...keys: K[]): Pick<z.infer<TSchema>, K>;
+    getOptional<K extends keyof z.infer<TSchema>>(key: K): z.infer<TSchema>[K] | undefined;
+    getOptional<K extends keyof z.infer<TSchema>>(...keys: K[]): Partial<Pick<z.infer<TSchema>, K>>;
+    getAll(): z.infer<TSchema>;
+}
+/**
+ * Creates an enhanced environment loader with init() method
+ * This provides a cleaner API: env.init({ file: './env.yml' }) followed by env.get('key')
+ *
+ * @param schema The Zod schema for environment validation
+ * @returns Enhanced env object with init, get, getOptional, and getAll methods
+ */
+export declare function createEnvWithInit<TSchema extends z.ZodSchema<any>>(schema: TSchema): EnvWithInit<TSchema>;
+//# sourceMappingURL=env-loader.d.ts.map

package/lib/env-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-loader.d.ts","sourceRoot":"","sources":["../src/env-loader.ts"],"names":[],"mappings":"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"}

package/lib/env-loader.js

@@ -0,0 +1,199 @@
+import { z } from 'zod/v4';
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import yaml from 'js-yaml';
+/**
+ * Modern Environment Loader with fluent API and full type safety
+ *
+ * Usage:
+ * ```typescript
+ * import { createEnv } from '@root/libs/env';
+ * import MySchema from './schema';
+ *
+ * // Create typed env instance
+ * const env = createEnv({ schema: MySchema, file: "env.local.yml" });
+ *
+ * // OR with JSON from process.env
+ * const env = createEnv({ schema: MySchema, env: "envs" });
+ *
+ * // Use with full type safety and autocomplete
+ * const port = env.get("port"); // Typed!
+ * const { optional_key } = env.getOptional("optional_key");
+ * ```
+ */
+export class EnvLoader {
+    envData = {};
+    schema = null;
+    validatedEnv = null;
+    initialized = false;
+    /**
+     * Initialize the environment loader
+     * @param options Either { schema, file } for YAML or { schema, env } for JSON
+     */
+    init(options) {
+        if (this.initialized) {
+            // Already initialized, skip re-initialization
+            return;
+        }
+        this.schema = options.schema;
+        // Load environment data based on options
+        this.loadEnvironmentData(options);
+        // Validate immediately
+        this.validateEnvironment();
+        this.initialized = true;
+    }
+    /**
+     * Load environment data from file or process.env
+     */
+    loadEnvironmentData(options) {
+        if ('file' in options) {
+            // For file mode, read YAML directly and parse
+            try {
+                const envContent = readFileSync(options.file, { encoding: 'utf-8' });
+                this.envData = yaml.load(envContent);
+            }
+            catch (error) {
+                const absolutePath = resolve(options.file);
+                const errorMessage = [
+                    'Failed to read environment file:',
+                    `  Provided path: '${options.file}'`,
+                    `  Resolved to: '${absolutePath}'`,
+                    `  Current directory: '${process.cwd()}'`,
+                    `  Error: ${error}`
+                ].join('\n');
+                throw new Error(errorMessage);
+            }
+        }
+        else {
+            // For env mode, read from process.env with JSON parsing
+            const envVar = process.env[options.env];
+            if (envVar) {
+                try {
+                    this.envData = JSON.parse(envVar);
+                }
+                catch (error) {
+                    throw new Error(`Failed to parse environment JSON from '${options.env}': ${error}`);
+                }
+            }
+            else {
+                throw new Error(`Environment variable '${options.env}' not found`);
+            }
+        }
+    }
+    /**
+     * Validate environment variables against the schema
+     */
+    validateEnvironment() {
+        if (!this.schema) {
+            throw new Error('Environment not initialized. Call env.init() first.');
+        }
+        try {
+            // Validate against schema
+            this.validatedEnv = this.schema.parse(this.envData);
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                console.error('Environment validation failed:');
+                error.issues.forEach((err) => {
+                    console.error(`  - ${err.path.join('.')}: ${err.message}`);
+                });
+                throw new Error('Invalid environment configuration. See errors above.');
+            }
+            throw error;
+        }
+    }
+    get(...keys) {
+        if (!this.initialized || !this.validatedEnv) {
+            throw new Error('Environment not initialized. Call env.init() first.');
+        }
+        // Single key case
+        if (keys.length === 1) {
+            return this.validatedEnv[keys[0]];
+        }
+        // Multiple keys case - return object
+        const result = {};
+        for (const key of keys) {
+            result[key] = this.validatedEnv[key];
+        }
+        return result;
+    }
+    getOptional(...keys) {
+        if (!this.initialized || !this.validatedEnv) {
+            throw new Error('Environment not initialized. Call env.init() first.');
+        }
+        // Single key case
+        if (keys.length === 1) {
+            return this.validatedEnv[keys[0]];
+        }
+        // Multiple keys case - return object
+        const result = {};
+        for (const key of keys) {
+            result[key] = this.validatedEnv[key];
+        }
+        return result;
+    }
+    /**
+     * Get all validated environment variables
+     */
+    getAll() {
+        if (!this.validatedEnv) {
+            throw new Error('Environment not initialized. Call env.init() first.');
+        }
+        return this.validatedEnv;
+    }
+}
+// Global instance storage for singleton behavior
+let globalInstance = null;
+/**
+ * Creates a typed environment loader instance
+ * @param options Configuration options with schema and file/env source
+ * @returns Typed EnvLoader instance with full type safety and autocomplete
+ */
+export function createEnv(options) {
+    // Use existing instance if available (singleton pattern)
+    if (globalInstance) {
+        return globalInstance;
+    }
+    // Create new instance
+    const loader = new EnvLoader();
+    loader.init(options);
+    // Store as global singleton
+    globalInstance = loader;
+    return loader;
+}
+/**
+ * Creates an enhanced environment loader with init() method
+ * This provides a cleaner API: env.init({ file: './env.yml' }) followed by env.get('key')
+ *
+ * @param schema The Zod schema for environment validation
+ * @returns Enhanced env object with init, get, getOptional, and getAll methods
+ */
+export function createEnvWithInit(schema) {
+    let instance = null;
+    return {
+        init(options) {
+            if (!instance) {
+                instance = createEnv({ schema, ...options });
+            }
+        },
+        get(...keys) {
+            if (!instance) {
+                throw new Error('Environment not initialized. Call env.init() first.');
+            }
+            return instance.get(...keys);
+        },
+        getOptional(...keys) {
+            if (!instance) {
+                throw new Error('Environment not initialized. Call env.init() first.');
+            }
+            return instance.getOptional(...keys);
+        },
+        getAll() {
+            if (!instance) {
+                throw new Error('Environment not initialized. Call env.init() first.');
+            }
+            return instance.getAll();
+        }
+    };
+}
+//# sourceMappingURL=env-loader.js.map

package/lib/env-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-loader.js","sourceRoot":"","sources":["../src/env-loader.ts"],"names":[],"mappings":"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"}

package/lib/index.d.ts

@@ -0,0 +1,2 @@
+export { createEnv, createEnvWithInit } from './env-loader.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/lib/index.js

@@ -0,0 +1,3 @@
+// Minimal exports - only what users need
+export { createEnv, createEnvWithInit } from './env-loader.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@efebia/one-env",
+  "version": "1.0.0",
+  "description": "Type-safe environment configuration with validation and CLI tools",
+  "keywords": [
+    "env",
+    "environment",
+    "config",
+    "validation",
+    "zod",
+    "cli",
+    "typescript"
+  ],
+  "author": {
+    "name": "Calogero Mandracchia",
+    "email": "calogero@efebia.com",
+    "url": "https://github.com/CalogeroMandracchia"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "bin": "bin/one-env",
+  "files": [
+    "lib",
+    "bin"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "yarn build"
+  },
+  "dependencies": {
+    "@aws-sdk/client-secrets-manager": "^3.812.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "js-yaml": "^4.1.0"
+  },
+  "peerDependencies": {
+    "zod": "^4.0.5"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.8.3",
+    "zod": "^4.0.5"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/efebia/be-libs.git",
+    "directory": "packages/one-env"
+  }
+}