@efebia/one-env 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 one-env contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,296 @@
+# one-env
+
+Type-safe environment configuration management for Node.js applications with runtime validation and CLI tools.
+
+## Features
+
+- 🔒 **Type-safe** environment variables with full TypeScript support
+- ✅ **Runtime validation** using Zod schemas
+- 🛠️ **CLI tools** for generating, validating, and managing environment files
+- 🌍 **Multiple sources**: Load from YAML files or JSON environment variables
+- 🚀 **Production ready**: Validate AWS Secrets Manager configurations
+- 💡 **Developer friendly**: Autocomplete for all environment variables
+
+## Installation
+
+```bash
+# Using npm
+npm install one-env zod
+
+# Using yarn
+yarn add one-env zod
+
+# Using pnpm
+pnpm add one-env zod
+```
+
+Note: `zod` v4 is a peer dependency and must be installed separately.
+
+## Quick Start
+
+### 1. Define your environment schema
+
+```typescript
+// env-schema.ts
+import { z } from 'zod/v4';
+
+const EnvSchema = z.object({
+  // Application
+  port: z.coerce.number().positive().default(3000),
+  nodeEnv: z.enum(['development', 'production', 'test']).default('development'),
+  
+  // Database
+  databaseUrl: z.string().url().describe('PostgreSQL connection URL'),
+  
+  // API Keys
+  apiKey: z.string().min(32).describe('External API key'),
+  
+  // Feature flags
+  enableCache: z.boolean().default(true),
+  cacheTimeout: z.coerce.number().positive().optional().default(3600),
+});
+
+export default EnvSchema;
+```
+
+### 2. Use in your application
+
+```typescript
+// config.ts
+import { createEnvWithInit } from 'one-env';
+import EnvSchema from './env-schema';
+
+// Create env instance
+const env = createEnvWithInit(EnvSchema);
+
+// Initialize with YAML file
+env.init({ file: './env.local.yml' });
+
+// Or initialize with JSON from environment variable
+env.init({ env: 'APP_CONFIG' });
+
+// Use with full type safety
+export const config = {
+  port: env.get('port'),
+  database: env.get('databaseUrl'),
+  cache: {
+    enabled: env.get('enableCache'),
+    timeout: env.get('cacheTimeout'),
+  }
+};
+```
+
+### 3. Alternative: Immediate initialization
+
+```typescript
+import { createEnv } from 'one-env';
+import EnvSchema from './env-schema';
+
+// Initialize immediately
+const env = createEnv({ 
+  schema: EnvSchema, 
+  file: './env.local.yml' 
+});
+
+// Use directly
+const port = env.get('port');
+```
+
+## CLI Tools
+
+one-env includes powerful CLI tools for managing your environment configuration:
+
+### Generate environment file
+
+Create a new environment file with default values from your schema:
+
+```bash
+# Generate env.local.yml with defaults
+one-env generate -s ./env-schema.js
+
+# Generate with custom output
+one-env generate -s ./env-schema.js -o env.example.yml
+
+# Force overwrite existing file
+one-env generate -s ./env-schema.js --force
+```
+
+### Validate environment file
+
+Check if your environment file is valid:
+
+```bash
+# Validate env.local.yml
+one-env validate -s ./env-schema.js
+
+# Validate specific file
+one-env validate -s ./env-schema.js --file env.prod.yml
+
+# Output as JSON (for CI/CD)
+one-env validate -s ./env-schema.js --json
+```
+
+### Validate AWS Secrets
+
+Validate environment variables stored in AWS Secrets Manager:
+
+```bash
+# Validate AWS secrets
+one-env validate-aws -s ./env-schema.js --secret-name my-app/prod
+
+# With specific AWS profile
+one-env validate-aws -s ./env-schema.js --secret-name my-app/prod --profile production
+
+# With specific region
+one-env validate-aws -s ./env-schema.js --secret-name my-app/prod --region us-east-1
+```
+
+## API Reference
+
+### `createEnv(options)`
+
+Creates and immediately initializes an environment loader.
+
+```typescript
+const env = createEnv({
+  schema: ZodSchema,
+  file: './env.yml'    // or
+  env: 'CONFIG_JSON'   // for JSON from environment variable
+});
+```
+
+### `createEnvWithInit(schema)`
+
+Creates an environment loader with deferred initialization.
+
+```typescript
+const env = createEnvWithInit(schema);
+
+// Initialize later
+env.init({ file: './env.yml' });
+// or
+env.init({ env: 'CONFIG_JSON' });
+```
+
+### Methods
+
+#### `get(key)` / `get(...keys)`
+
+Get one or multiple environment values with type safety:
+
+```typescript
+// Single value
+const port = env.get('port'); // number
+
+// Multiple values
+const { port, nodeEnv } = env.get('port', 'nodeEnv');
+```
+
+#### `getOptional(key)` / `getOptional(...keys)`
+
+Get optional environment values:
+
+```typescript
+const timeout = env.getOptional('cacheTimeout'); // number | undefined
+```
+
+#### `getAll()`
+
+Get all validated environment variables:
+
+```typescript
+const config = env.getAll(); // Fully typed object
+```
+
+## Best Practices
+
+### 1. Schema Organization
+
+Keep your schema in a separate file for reusability:
+
+```typescript
+// env-schema.ts
+export default z.object({
+  // Group related variables
+  // Database
+  dbHost: z.string(),
+  dbPort: z.coerce.number(),
+  dbName: z.string(),
+  
+  // Add descriptions for documentation
+  apiKey: z.string().describe('API key for external service'),
+  
+  // Use defaults for development
+  logLevel: z.enum(['debug', 'info', 'warn', 'error']).default('info'),
+});
+```
+
+### 2. Environment-specific Files
+
+Use different files for different environments:
+
+```
+env.local.yml      # Local development (gitignored)
+env.test.yml       # Test environment
+env.example.yml    # Example file (committed)
+```
+
+### 3. CI/CD Integration
+
+```yaml
+# .github/workflows/validate.yml
+- name: Validate environment
+  run: |
+    npx one-env validate -s ./env-schema.js --json
+    
+- name: Validate production secrets
+  run: |
+    npx one-env validate-aws \
+      -s ./env-schema.js \
+      --secret-name prod/myapp \
+      --profile production
+```
+
+### 4. Type Exports
+
+Export types for use across your application:
+
+```typescript
+// config.ts
+import { createEnvWithInit } from 'one-env';
+import { z } from 'zod/v4';
+import EnvSchema from './env-schema';
+
+export type Config = z.infer<typeof EnvSchema>;
+
+const env = createEnvWithInit(EnvSchema);
+export default env;
+```
+
+## Error Handling
+
+one-env provides clear error messages for configuration issues:
+
+```
+Environment validation failed:
+  - port: Expected number, received string
+  - databaseUrl: Invalid URL
+  - apiKey: String must contain at least 32 characters
+```
+
+## Requirements
+
+- Node.js >= 18.0.0
+- Zod v4 (peer dependency)
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Support
+
+For bugs and feature requests, please [create an issue](https://github.com/yourusername/one-env/issues).

package/bin/one-env

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../lib/cli/env-tool.js';

package/lib/cli/commands/generate.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generate command implementation
+ * Creates new environment files with default values from schema
+ */
+import { GenerateOptions } from '../types.js';
+/**
+ * Handles the generate command
+ * @param options - Command options
+ */
+export declare function handleGenerateCommand(options: GenerateOptions): Promise<void>;
+//# sourceMappingURL=generate.d.ts.map

package/lib/cli/commands/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/generate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAK9C;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDnF"}

package/lib/cli/commands/generate.js

@@ -0,0 +1,57 @@
+/**
+ * Generate command implementation
+ * Creates new environment files with default values from schema
+ */
+import chalk from 'chalk';
+import { resolvePath, fileExists, writeFile, createYamlContent } from '../utils/file.js';
+import { printSuccess, printError, printStatus } from '../utils/formatting.js';
+import { loadSchema, extractSchemaDefaults, formatSchemaSource } from '../utils/schema-loader.js';
+/**
+ * Handles the generate command
+ * @param options - Command options
+ */
+export async function handleGenerateCommand(options) {
+    const outputPath = resolvePath(options.output);
+    try {
+        // Check if file exists and prompt for confirmation
+        if (fileExists(outputPath) && !options.force) {
+            console.log(chalk.yellow('Warning:') + ` File '${options.output}' already exists.`);
+            console.log('Use --force to overwrite, or specify a different output file.');
+            process.exit(1);
+        }
+        // Load schema dynamically
+        printStatus(`Loading schema from ${formatSchemaSource(options.schema)}...`, 'info');
+        const schema = await loadSchema(options.schema);
+        printStatus('Generating environment file from schema defaults...', 'info');
+        // Generate default values from schema
+        const envData = extractSchemaDefaults(schema);
+        // Create YAML content with proper formatting and comments
+        const yamlContent = createYamlContent(envData);
+        // Write to file
+        writeFile(outputPath, yamlContent);
+        // Show success message with details
+        const fieldCount = Object.keys(envData).length;
+        printSuccess('generated', {
+            'File': options.output,
+            'Location': outputPath,
+            'Fields generated': fieldCount,
+        });
+        // Show next steps
+        console.log(`\n${chalk.yellow('Next steps:')}`);
+        console.log(`1. Review and customize the generated values`);
+        console.log(`2. Update sensitive fields like API keys and secrets`);
+        console.log(`3. Validate with: ${chalk.cyan('yarn env:validate')}`);
+    }
+    catch (error) {
+        const tips = [];
+        if (error.code === 'ENOENT') {
+            tips.push("Make sure you're running this from the backend directory.");
+        }
+        else if (error.message.includes('permission')) {
+            tips.push('Check file permissions for the output directory.');
+        }
+        printError(error, tips);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=generate.js.map

package/lib/cli/commands/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../../src/cli/commands/generate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAElG;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAAwB;IAChE,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/C,IAAI,CAAC;QACD,mDAAmD;QACnD,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC3C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,UAAU,OAAO,CAAC,MAAM,mBAAmB,CAAC,CAAC;YACpF,OAAO,CAAC,GAAG,CAAC,+DAA+D,CAAC,CAAC;YAC7E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;QAED,0BAA0B;QAC1B,WAAW,CAAC,uBAAuB,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACpF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAEhD,WAAW,CAAC,qDAAqD,EAAE,MAAM,CAAC,CAAC;QAE3E,sCAAsC;QACtC,MAAM,OAAO,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAE9C,0DAA0D;QAC1D,MAAM,WAAW,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAE/C,gBAAgB;QAChB,SAAS,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QAEnC,oCAAoC;QACpC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QAC/C,YAAY,CAAC,WAAW,EAAE;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,UAAU,EAAE,UAAU;YACtB,kBAAkB,EAAE,UAAU;SACjC,CAAC,CAAC;QAEH,kBAAkB;QAClB,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;QACpE,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;IAExE,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QAClB,MAAM,IAAI,GAAa,EAAE,CAAC;QAE1B,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC1B,IAAI,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;QAC3E,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9C,IAAI,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QAClE,CAAC;QAED,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACL,CAAC"}

package/lib/cli/commands/validate-aws.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Validate AWS command implementation
+ * Validates AWS Secrets Manager secrets against the schema
+ */
+import { ValidateAwsOptions } from '../types.js';
+/**
+ * Handles the validate-aws command
+ * @param options - Command options
+ */
+export declare function handleValidateAwsCommand(options: ValidateAwsOptions): Promise<void>;
+//# sourceMappingURL=validate-aws.d.ts.map

package/lib/cli/commands/validate-aws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-aws.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/validate-aws.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAMjD;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwDzF"}

package/lib/cli/commands/validate-aws.js

@@ -0,0 +1,64 @@
+/**
+ * Validate AWS command implementation
+ * Validates AWS Secrets Manager secrets against the schema
+ */
+import chalk from 'chalk';
+import { createSecretsManagerClient, getSecretValue } from '../utils/aws.js';
+import { validateEnvData } from '../utils/validation.js';
+import { printValidationResults, formatJsonOutput, formatJsonError, printStatus } from '../utils/formatting.js';
+import { loadSchema, formatSchemaSource } from '../utils/schema-loader.js';
+/**
+ * Handles the validate-aws command
+ * @param options - Command options
+ */
+export async function handleValidateAwsCommand(options) {
+    // Configure AWS client
+    const client = createSecretsManagerClient(options.region, options.profile);
+    try {
+        // Load schema dynamically
+        if (!options.json) {
+            printStatus(`Loading schema from ${formatSchemaSource(options.schema)}...`, 'info');
+        }
+        const schema = await loadSchema(options.schema);
+        // Fetch secret from AWS
+        if (!options.json) {
+            printStatus(`Fetching secret '${options.secretName}' from AWS Secrets Manager...`, 'info');
+        }
+        const secretData = await getSecretValue(client, options.secretName);
+        // Validate against schema
+        const results = validateEnvData(secretData, schema, options.secretName, options.region);
+        if (options.json) {
+            // JSON output for automation
+            const jsonOutput = formatJsonOutput(results);
+            console.log(JSON.stringify(jsonOutput, null, 2));
+        }
+        else {
+            // Human-readable output
+            printValidationResults(results);
+        }
+        // Exit with appropriate code
+        process.exit(results.success ? 0 : 1);
+    }
+    catch (error) {
+        if (options.json) {
+            const jsonError = formatJsonError(error, 'aws_error', options.secretName, options.region);
+            console.log(JSON.stringify(jsonError, null, 2));
+        }
+        else {
+            const tips = [];
+            if (error.message.includes('not found')) {
+                tips.push('Check that the secret name and region are correct.');
+                tips.push('Ensure you have AWS credentials configured.');
+            }
+            else if (error.message.includes('credentials')) {
+                tips.push("Configure AWS credentials using 'aws configure' or environment variables.");
+            }
+            console.error(`\n${chalk.red.bold('Error:')} ${error.message}\n`);
+            tips.forEach(tip => {
+                console.log(`${chalk.yellow('Tip:')} ${tip}`);
+            });
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=validate-aws.js.map

package/lib/cli/commands/validate-aws.js.map

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

package/lib/cli/commands/validate.d.ts

@@ -0,0 +1,7 @@
+import { ValidateOptions } from '../types.js';
+/**
+ * Handles the validate command
+ * @param options - Command options
+ */
+export declare function handleValidateCommand(options: ValidateOptions): Promise<void>;
+//# sourceMappingURL=validate.d.ts.map

package/lib/cli/commands/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/validate.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAM9C;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDnF"}

package/lib/cli/commands/validate.js

@@ -0,0 +1,60 @@
+/**
+ * Validate command implementation
+ * Validates existing environment files against the schema
+ */
+import chalk from 'chalk';
+import { resolvePath, loadYamlFile } from '../utils/file.js';
+import { validateEnvData } from '../utils/validation.js';
+import { printValidationResults, formatJsonOutput, formatJsonError, printStatus } from '../utils/formatting.js';
+import { loadSchema, formatSchemaSource } from '../utils/schema-loader.js';
+/**
+ * Handles the validate command
+ * @param options - Command options
+ */
+export async function handleValidateCommand(options) {
+    try {
+        // Load schema dynamically
+        if (!options.json) {
+            printStatus(`Loading schema from ${formatSchemaSource(options.schema)}...`, 'info');
+        }
+        const schema = await loadSchema(options.schema);
+        // Load YAML file
+        if (!options.json) {
+            printStatus(`Loading environment file '${options.file}'...`, 'info');
+        }
+        const filePath = resolvePath(options.file);
+        const envData = loadYamlFile(filePath);
+        // Validate against schema
+        const results = validateEnvData(envData, schema, options.file);
+        if (options.json) {
+            // JSON output for automation
+            const jsonOutput = formatJsonOutput(results);
+            console.log(JSON.stringify(jsonOutput, null, 2));
+        }
+        else {
+            // Human-readable output
+            printValidationResults(results);
+        }
+        // Exit with appropriate code
+        process.exit(results.success ? 0 : 1);
+    }
+    catch (error) {
+        if (options.json) {
+            const jsonError = formatJsonError(error, 'file_error', options.file);
+            console.log(JSON.stringify(jsonError, null, 2));
+        }
+        else {
+            const tips = [];
+            if (error.message.includes('not found')) {
+                tips.push("Make sure you're running this from the backend directory.");
+                tips.push(`Current directory: ${process.cwd()}`);
+            }
+            console.error(`\n${chalk.red.bold('Error:')} ${error.message}\n`);
+            tips.forEach(tip => {
+                console.log(`${chalk.yellow('Tip:')} ${tip}`);
+            });
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=validate.js.map

package/lib/cli/commands/validate.js.map

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

package/lib/cli/env-tool.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * Environment Tool - Unified TypeScript CLI for Environment Management
+ *
+ * This unified tool provides comprehensive environment management capabilities:
+ * - generate: Creates new environment files with default values from schema
+ * - validate: Validates existing environment files against the schema
+ * - validate-aws: Validates AWS Secrets Manager secrets against the schema
+ */
+export {};
+//# sourceMappingURL=env-tool.d.ts.map

package/lib/cli/env-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-tool.d.ts","sourceRoot":"","sources":["../../src/cli/env-tool.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG"}

package/lib/cli/env-tool.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+/**
+ * Environment Tool - Unified TypeScript CLI for Environment Management
+ *
+ * This unified tool provides comprehensive environment management capabilities:
+ * - generate: Creates new environment files with default values from schema
+ * - validate: Validates existing environment files against the schema
+ * - validate-aws: Validates AWS Secrets Manager secrets against the schema
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { handleGenerateCommand } from './commands/generate.js';
+import { handleValidateCommand } from './commands/validate.js';
+import { handleValidateAwsCommand } from './commands/validate-aws.js';
+// ============================================================================
+// MAIN CLI SETUP
+// ============================================================================
+const program = new Command();
+program
+    .name('env-tool')
+    .description('Unified CLI for Environment Management')
+    .version('1.0.0');
+// Generate command
+program
+    .command('generate')
+    .description('Generate new environment file with default values from schema')
+    .requiredOption('-s, --schema <path>', 'Path to schema file (TypeScript or JavaScript)')
+    .option('-o, --output <file>', 'Output file name', 'env.local.yml')
+    .option('-f, --force', 'Overwrite existing file without confirmation', false)
+    .action(handleGenerateCommand);
+// Validate command
+program
+    .command('validate')
+    .description('Validate existing environment file against schema')
+    .requiredOption('-s, --schema <path>', 'Path to schema file (TypeScript or JavaScript)')
+    .option('--file <filename>', 'Path to the environment file', 'env.local.yml')
+    .option('--json', 'Output results in JSON format', false)
+    .action(handleValidateCommand);
+// Validate AWS command
+program
+    .command('validate-aws')
+    .description('Validate AWS Secrets Manager secrets against schema')
+    .requiredOption('-s, --schema <path>', 'Path to schema file (TypeScript or JavaScript)')
+    .option('--secret-name <name>', 'Name of the secret in AWS Secrets Manager', 'envs')
+    .option('--region <region>', 'AWS region', process.env['AWS_REGION'] || 'eu-west-1')
+    .option('--profile <profile>', 'AWS profile to use (optional)')
+    .option('--json', 'Output results in JSON format', false)
+    .action(handleValidateAwsCommand);
+// Check dependencies before running
+try {
+    await import('js-yaml');
+}
+catch (error) {
+    console.error(`\n${chalk.red('Error:')} js-yaml package is not installed.`);
+    console.error(`Run: ${chalk.cyan('yarn add js-yaml')}\n`);
+    process.exit(1);
+}
+// Run the CLI
+program.parse();
+//# sourceMappingURL=env-tool.js.map

package/lib/cli/env-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-tool.js","sourceRoot":"","sources":["../../src/cli/env-tool.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACF,IAAI,CAAC,UAAU,CAAC;KAChB,WAAW,CAAC,wCAAwC,CAAC;KACrD,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,mBAAmB;AACnB,OAAO;KACF,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,+DAA+D,CAAC;KAC5E,cAAc,CAAC,qBAAqB,EAAE,gDAAgD,CAAC;KACvF,MAAM,CAAC,qBAAqB,EAAE,kBAAkB,EAAE,eAAe,CAAC;KAClE,MAAM,CAAC,aAAa,EAAE,8CAA8C,EAAE,KAAK,CAAC;KAC5E,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAEnC,mBAAmB;AACnB,OAAO;KACF,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,mDAAmD,CAAC;KAChE,cAAc,CAAC,qBAAqB,EAAE,gDAAgD,CAAC;KACvF,MAAM,CAAC,mBAAmB,EAAE,8BAA8B,EAAE,eAAe,CAAC;KAC5E,MAAM,CAAC,QAAQ,EAAE,+BAA+B,EAAE,KAAK,CAAC;KACxD,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAEnC,uBAAuB;AACvB,OAAO;KACF,OAAO,CAAC,cAAc,CAAC;KACvB,WAAW,CAAC,qDAAqD,CAAC;KAClE,cAAc,CAAC,qBAAqB,EAAE,gDAAgD,CAAC;KACvF,MAAM,CAAC,sBAAsB,EAAE,2CAA2C,EAAE,MAAM,CAAC;KACnF,MAAM,CAAC,mBAAmB,EAAE,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,WAAW,CAAC;KACnF,MAAM,CAAC,qBAAqB,EAAE,+BAA+B,CAAC;KAC9D,MAAM,CAAC,QAAQ,EAAE,+BAA+B,EAAE,KAAK,CAAC;KACxD,MAAM,CAAC,wBAAwB,CAAC,CAAC;AAEtC,oCAAoC;AACpC,IAAI,CAAC;IACD,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;AAC5B,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACb,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,oCAAoC,CAAC,CAAC;IAC5E,OAAO,CAAC,KAAK,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;AAED,cAAc;AACd,OAAO,CAAC,KAAK,EAAE,CAAC"}