vaulter 0.2.0

package/dist/index.js

@@ -0,0 +1,33 @@
+/**
+ * Vaulter - Multi-backend environment variable and secrets manager
+ *
+ * Main library exports for programmatic usage
+ */
+// Client
+export { VaulterClient, createClient } from './client.js';
+export { ENVIRONMENTS, ENVIRONMENT_NAMES, EXPORT_FORMATS, DEFAULT_SECRET_PATTERNS } from './types.js';
+// Config utilities
+export { loadConfig, findConfigDir, getProjectName, configExists, loadEncryptionKey, createDefaultConfig } from './lib/config-loader.js';
+/**
+ * Resolve backend URLs from config
+ * Supports both single `url` and multiple `urls` with fallback
+ */
+export function resolveBackendUrls(config) {
+    if (!config.backend) {
+        return [];
+    }
+    // If urls array is provided, use it
+    if (config.backend.urls && config.backend.urls.length > 0) {
+        return config.backend.urls.filter(url => url && url.trim() !== '');
+    }
+    // Otherwise use single url
+    if (config.backend.url && config.backend.url.trim() !== '') {
+        return [config.backend.url];
+    }
+    return [];
+}
+// Env parser
+export { parseEnvFile, parseEnvString, serializeEnv, hasStdinData, parseEnvFromStdin } from './lib/env-parser.js';
+// Loader (dotenv integration)
+export { loader, parse } from './loader.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,SAAS;AACT,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAazD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AAErG,mBAAmB;AACnB,OAAO,EACL,UAAU,EACV,aAAa,EACb,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,wBAAwB,CAAA;AAK/B;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAqB;IACtD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,EAAE,CAAA;IACX,CAAC;IAED,oCAAoC;IACpC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IACpE,CAAC;IAED,2BAA2B;IAC3B,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3D,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAC7B,CAAC;IAED,OAAO,EAAE,CAAA;AACX,CAAC;AAED,aAAa;AACb,OAAO,EACL,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,iBAAiB,EAClB,MAAM,qBAAqB,CAAA;AAE5B,8BAA8B;AAC9B,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA"}

package/dist/lib/batch-runner.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Batch Runner
+ *
+ * Execute operations across multiple services in a monorepo
+ */
+import type { ServiceInfo } from './monorepo.js';
+import type { Environment } from '../types.js';
+export interface BatchOperation<T> {
+    service: ServiceInfo;
+    environment: Environment;
+    result?: T;
+    error?: Error;
+    duration: number;
+}
+export interface BatchResult<T> {
+    total: number;
+    successful: number;
+    failed: number;
+    operations: BatchOperation<T>[];
+}
+export type OperationFn<T> = (service: ServiceInfo, environment: Environment) => Promise<T>;
+/**
+ * Run an operation across multiple services
+ */
+export declare function runBatch<T>(services: ServiceInfo[], environment: Environment, operation: OperationFn<T>, options?: {
+    concurrency?: number;
+    stopOnError?: boolean;
+    verbose?: boolean;
+    onProgress?: (completed: number, total: number, current: ServiceInfo) => void;
+}): Promise<BatchResult<T>>;
+/**
+ * Format batch result for display
+ */
+export declare function formatBatchResult<T>(result: BatchResult<T>, formatItem?: (op: BatchOperation<T>) => string): string;
+/**
+ * Format batch result as JSON
+ */
+export declare function formatBatchResultJson<T>(result: BatchResult<T>): object;
+//# sourceMappingURL=batch-runner.d.ts.map

package/dist/lib/batch-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-runner.d.ts","sourceRoot":"","sources":["../../src/lib/batch-runner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,OAAO,EAAE,WAAW,CAAA;IACpB,WAAW,EAAE,WAAW,CAAA;IACxB,MAAM,CAAC,EAAE,CAAC,CAAA;IACV,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAA;CAChC;AAED,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAC3B,OAAO,EAAE,WAAW,EACpB,WAAW,EAAE,WAAW,KACrB,OAAO,CAAC,CAAC,CAAC,CAAA;AAEf;;GAEG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,QAAQ,EAAE,WAAW,EAAE,EACvB,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,EACzB,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,KAAK,IAAI,CAAA;CACzE,GACL,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CA6EzB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EACtB,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,MAAM,GAC7C,MAAM,CA4BR;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,CAevE"}

package/dist/lib/batch-runner.js

@@ -0,0 +1,117 @@
+/**
+ * Batch Runner
+ *
+ * Execute operations across multiple services in a monorepo
+ */
+import pLimit from 'p-limit';
+/**
+ * Run an operation across multiple services
+ */
+export async function runBatch(services, environment, operation, options = {}) {
+    const { concurrency = 1, stopOnError = false, verbose = false, onProgress } = options;
+    const operations = [];
+    let successful = 0;
+    let failed = 0;
+    const runOperation = async (service, index) => {
+        if (onProgress) {
+            onProgress(index, services.length, service);
+        }
+        const startTime = Date.now();
+        try {
+            const result = await operation(service, environment);
+            const duration = Date.now() - startTime;
+            operations.push({
+                service,
+                environment,
+                result,
+                duration
+            });
+            successful++;
+        }
+        catch (err) {
+            const duration = Date.now() - startTime;
+            operations.push({
+                service,
+                environment,
+                error: err instanceof Error ? err : new Error(String(err)),
+                duration
+            });
+            failed++;
+        }
+    };
+    if (concurrency <= 1) {
+        for (let i = 0; i < services.length; i++) {
+            await runOperation(services[i], i);
+            if (stopOnError && failed > 0) {
+                break;
+            }
+        }
+    }
+    else {
+        const limit = pLimit(concurrency);
+        let hasError = false;
+        await Promise.all(services.map((service, index) => limit(async () => {
+            if (stopOnError && hasError) {
+                return;
+            }
+            await runOperation(service, index);
+            if (stopOnError && failed > 0) {
+                hasError = true;
+            }
+        })));
+    }
+    return {
+        total: services.length,
+        successful,
+        failed,
+        operations
+    };
+}
+/**
+ * Format batch result for display
+ */
+export function formatBatchResult(result, formatItem) {
+    const lines = [];
+    lines.push('');
+    lines.push(`Batch Operation Summary:`);
+    lines.push(`  Total:      ${result.total}`);
+    lines.push(`  Successful: ${result.successful}`);
+    lines.push(`  Failed:     ${result.failed}`);
+    lines.push('');
+    if (result.failed > 0) {
+        lines.push('Failures:');
+        for (const op of result.operations) {
+            if (op.error) {
+                lines.push(`  ✗ ${op.service.name}: ${op.error.message}`);
+            }
+        }
+        lines.push('');
+    }
+    if (formatItem) {
+        lines.push('Details:');
+        for (const op of result.operations) {
+            lines.push(`  ${formatItem(op)}`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Format batch result as JSON
+ */
+export function formatBatchResultJson(result) {
+    return {
+        total: result.total,
+        successful: result.successful,
+        failed: result.failed,
+        operations: result.operations.map(op => ({
+            service: op.service.name,
+            path: op.service.path,
+            environment: op.environment,
+            success: !op.error,
+            error: op.error?.message,
+            duration: op.duration,
+            result: op.result
+        }))
+    };
+}
+//# sourceMappingURL=batch-runner.js.map

package/dist/lib/batch-runner.js.map

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

package/dist/lib/config-loader.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Vaulter Config Loader
+ *
+ * Loads and merges configuration from .vaulter/config.yaml files
+ * with support for inheritance via "extends" field.
+ */
+import type { VaulterConfig, Environment } from '../types.js';
+/**
+ * Default configuration
+ */
+export declare const DEFAULT_CONFIG: VaulterConfig;
+/**
+ * Find the .vaulter directory by searching up from the current directory
+ */
+export declare function findConfigDir(startDir?: string): string | null;
+/**
+ * Load configuration from the nearest .vaulter/config.yaml
+ * Also merges config.local.yaml if it exists (for secrets/overrides)
+ */
+export declare function loadConfig(startDir?: string): VaulterConfig;
+/**
+ * Get the project name from config or directory name
+ */
+export declare function getProjectName(config: VaulterConfig, startDir?: string): string;
+/**
+ * Get the environments directory path
+ */
+export declare function getEnvironmentsDir(configDir: string): string;
+/**
+ * Get the path to an environment file
+ */
+export declare function getEnvFilePath(configDir: string, environment: Environment): string;
+/**
+ * Check if a config directory exists
+ */
+export declare function configExists(startDir?: string): boolean;
+/**
+ * Get the encryption key from configured sources
+ */
+export declare function loadEncryptionKey(config: VaulterConfig): Promise<string | null>;
+/**
+ * Create a default config file
+ */
+export declare function createDefaultConfig(configDir: string, project: string, options?: Partial<VaulterConfig>): void;
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/lib/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/lib/config-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AA2D7D;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,aAuB5B,CAAA;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAuB7E;AAyFD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa,CAoB3D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ/E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,MAAM,CAElF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkCrF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM,GACnC,IAAI,CA+FN"}

package/dist/lib/config-loader.js

@@ -0,0 +1,357 @@
+/**
+ * Vaulter Config Loader
+ *
+ * Loads and merges configuration from .vaulter/config.yaml files
+ * with support for inheritance via "extends" field.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { loadKeyFromS3 } from './s3-key-loader.js';
+const CONFIG_DIR = '.vaulter';
+const CONFIG_FILE = 'config.yaml';
+const CONFIG_LOCAL_FILE = 'config.local.yaml';
+const MAX_SEARCH_DEPTH = 5;
+const MAX_EXTENDS_DEPTH = 10;
+/**
+ * Expand environment variables in a string
+ * Supports: ${VAR}, ${VAR:-default}, $VAR
+ */
+function expandEnvVars(str) {
+    if (typeof str !== 'string')
+        return str;
+    // Handle ${VAR:-default} syntax
+    str = str.replace(/\$\{([^}:]+):-([^}]*)\}/g, (_, varName, defaultValue) => {
+        return process.env[varName] || defaultValue;
+    });
+    // Handle ${VAR} syntax
+    str = str.replace(/\$\{([^}]+)\}/g, (_, varName) => {
+        return process.env[varName] || '';
+    });
+    // Handle $VAR syntax (word boundary)
+    str = str.replace(/\$([A-Z_][A-Z0-9_]*)/gi, (_, varName) => {
+        return process.env[varName] || '';
+    });
+    return str;
+}
+/**
+ * Recursively expand env vars in an object
+ */
+function expandEnvVarsInObject(obj) {
+    if (obj === null || obj === undefined)
+        return obj;
+    if (typeof obj === 'string') {
+        return expandEnvVars(obj);
+    }
+    if (Array.isArray(obj)) {
+        return obj.map(item => expandEnvVarsInObject(item));
+    }
+    if (typeof obj === 'object') {
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            result[key] = expandEnvVarsInObject(value);
+        }
+        return result;
+    }
+    return obj;
+}
+/**
+ * Default configuration
+ */
+export const DEFAULT_CONFIG = {
+    version: '1',
+    project: '',
+    environments: ['dev', 'stg', 'prd', 'sbx', 'dr'],
+    default_environment: 'dev',
+    sync: {
+        conflict: 'local'
+    },
+    security: {
+        paranoid: false,
+        confirm_production: true,
+        auto_encrypt: {
+            patterns: [
+                '*_KEY',
+                '*_SECRET',
+                '*_TOKEN',
+                '*_PASSWORD',
+                '*_CREDENTIAL',
+                'DATABASE_URL',
+                'REDIS_URL'
+            ]
+        }
+    }
+};
+/**
+ * Find the .vaulter directory by searching up from the current directory
+ */
+export function findConfigDir(startDir = process.cwd()) {
+    let currentDir = path.resolve(startDir);
+    let depth = 0;
+    while (depth < MAX_SEARCH_DEPTH) {
+        const configDir = path.join(currentDir, CONFIG_DIR);
+        const configFile = path.join(configDir, CONFIG_FILE);
+        if (fs.existsSync(configFile)) {
+            return configDir;
+        }
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir) {
+            // Reached root
+            break;
+        }
+        currentDir = parentDir;
+        depth++;
+    }
+    return null;
+}
+/**
+ * Load a single config file
+ */
+function loadConfigFile(configPath, required = true) {
+    if (!fs.existsSync(configPath)) {
+        if (required) {
+            throw new Error(`Config file not found: ${configPath}`);
+        }
+        return {};
+    }
+    const content = fs.readFileSync(configPath, 'utf-8');
+    const parsed = parseYaml(content);
+    // Expand environment variables in all string values
+    return expandEnvVarsInObject(parsed || {});
+}
+/**
+ * Deep merge two config objects
+ */
+function deepMerge(target, source) {
+    const result = { ...target };
+    for (const key of Object.keys(source)) {
+        const sourceValue = source[key];
+        const targetValue = result[key];
+        if (sourceValue !== null &&
+            sourceValue !== undefined &&
+            typeof sourceValue === 'object' &&
+            !Array.isArray(sourceValue) &&
+            targetValue !== null &&
+            targetValue !== undefined &&
+            typeof targetValue === 'object' &&
+            !Array.isArray(targetValue)) {
+            // Deep merge objects
+            result[key] = deepMerge(targetValue, sourceValue);
+        }
+        else if (sourceValue !== undefined) {
+            // Override with source value
+            result[key] = sourceValue;
+        }
+    }
+    return result;
+}
+/**
+ * Load config with inheritance support
+ */
+function loadConfigWithExtends(configPath, visited = new Set(), depth = 0) {
+    if (depth > MAX_EXTENDS_DEPTH) {
+        throw new Error(`Config inheritance depth exceeded (max ${MAX_EXTENDS_DEPTH})`);
+    }
+    const absolutePath = path.resolve(configPath);
+    if (visited.has(absolutePath)) {
+        throw new Error(`Circular config inheritance detected: ${absolutePath}`);
+    }
+    visited.add(absolutePath);
+    const config = loadConfigFile(absolutePath);
+    // Handle extends
+    if (config.extends) {
+        const extendsPath = path.resolve(path.dirname(absolutePath), config.extends);
+        const parentConfig = loadConfigWithExtends(extendsPath, visited, depth + 1);
+        // Remove extends from config before merging
+        const { extends: _, ...configWithoutExtends } = config;
+        // Merge: parent <- current
+        return deepMerge(parentConfig, configWithoutExtends);
+    }
+    // No extends, merge with defaults
+    return deepMerge(DEFAULT_CONFIG, config);
+}
+/**
+ * Load configuration from the nearest .vaulter/config.yaml
+ * Also merges config.local.yaml if it exists (for secrets/overrides)
+ */
+export function loadConfig(startDir) {
+    const configDir = findConfigDir(startDir);
+    if (!configDir) {
+        // No config found, return defaults with empty project
+        return { ...DEFAULT_CONFIG };
+    }
+    const configPath = path.join(configDir, CONFIG_FILE);
+    let config = loadConfigWithExtends(configPath);
+    // Load and merge local config (for secrets that shouldn't be committed)
+    const localConfigPath = path.join(configDir, CONFIG_LOCAL_FILE);
+    const localConfig = loadConfigFile(localConfigPath, false);
+    if (Object.keys(localConfig).length > 0) {
+        config = deepMerge(config, localConfig);
+    }
+    return config;
+}
+/**
+ * Get the project name from config or directory name
+ */
+export function getProjectName(config, startDir) {
+    if (config.project) {
+        return config.project;
+    }
+    // Fallback to directory name
+    const dir = startDir || process.cwd();
+    return path.basename(dir);
+}
+/**
+ * Get the environments directory path
+ */
+export function getEnvironmentsDir(configDir) {
+    return path.join(configDir, 'environments');
+}
+/**
+ * Get the path to an environment file
+ */
+export function getEnvFilePath(configDir, environment) {
+    return path.join(getEnvironmentsDir(configDir), `${environment}.env`);
+}
+/**
+ * Check if a config directory exists
+ */
+export function configExists(startDir) {
+    return findConfigDir(startDir) !== null;
+}
+/**
+ * Get the encryption key from configured sources
+ */
+export async function loadEncryptionKey(config) {
+    const keySources = config.encryption?.key_source || [];
+    for (const source of keySources) {
+        if ('env' in source) {
+            // Environment variable
+            const value = process.env[source.env];
+            if (value)
+                return value;
+        }
+        else if ('file' in source) {
+            // Local file
+            const filePath = path.resolve(source.file);
+            if (fs.existsSync(filePath)) {
+                return fs.readFileSync(filePath, 'utf-8').trim();
+            }
+        }
+        else if ('s3' in source) {
+            // S3 remote key
+            try {
+                const key = await loadKeyFromS3(source.s3);
+                if (key)
+                    return key;
+            }
+            catch (err) {
+                // Log error but continue to next source
+                if (process.env.VAULTER_VERBOSE) {
+                    console.warn(`Failed to load key from S3: ${err.message}`);
+                }
+            }
+        }
+    }
+    // Fallback to VAULTER_KEY environment variable
+    if (process.env.VAULTER_KEY) {
+        return process.env.VAULTER_KEY;
+    }
+    return null;
+}
+/**
+ * Create a default config file
+ */
+export function createDefaultConfig(configDir, project, options = {}) {
+    const config = {
+        version: '1',
+        project,
+        ...options
+    };
+    // Ensure directory exists
+    if (!fs.existsSync(configDir)) {
+        fs.mkdirSync(configDir, { recursive: true });
+    }
+    // Create environments directory
+    const envDir = getEnvironmentsDir(configDir);
+    if (!fs.existsSync(envDir)) {
+        fs.mkdirSync(envDir, { recursive: true });
+    }
+    // Write config file
+    const configPath = path.join(configDir, CONFIG_FILE);
+    const yamlContent = `# Vaulter Configuration
+# https://github.com/forattini-dev/vaulter
+
+version: "1"
+
+# Project identification
+project: ${project}
+# service: optional-service-name
+
+# Backend configuration
+# SECURITY: Use environment variables for credentials!
+# Supports: \${VAR}, \${VAR:-default}, $VAR
+backend:
+  # AWS S3 (uses AWS credential chain - no creds in URL)
+  # url: s3://bucket/envs?region=us-east-1
+
+  # AWS S3 with specific profile (from ~/.aws/credentials)
+  # url: s3://bucket/envs?region=us-east-1&profile=\${AWS_PROFILE:-default}
+
+  # S3 with explicit credentials from env vars
+  # url: s3://\${AWS_ACCESS_KEY_ID}:\${AWS_SECRET_ACCESS_KEY}@bucket/envs?region=us-east-1
+
+  # Or use a single env var for the whole URL
+  # url: \${VAULTER_BACKEND_URL}
+
+  # MinIO / S3-compatible
+  # url: http://\${MINIO_ACCESS_KEY}:\${MINIO_SECRET_KEY}@localhost:9000/envs
+
+  # Local filesystem (development)
+  url: file://${process.env.HOME}/.vaulter/store
+
+  # In-memory (testing)
+  # url: memory://test
+
+# Encryption settings
+encryption:
+  key_source:
+    - env: VAULTER_KEY        # 1. Try environment variable first
+    - file: .vaulter/.key     # 2. Then local file (gitignored)
+    # - s3: s3://secure-bucket/keys/vaulter.key  # 3. Remote key
+
+# Available environments
+environments:
+  - dev
+  - stg
+  - prd
+  - sbx
+  - dr
+
+# Default environment
+default_environment: dev
+
+# Sync behavior
+sync:
+  conflict: local  # local | remote | prompt | error
+
+# Security settings
+security:
+  confirm_production: true
+  auto_encrypt:
+    patterns:
+      - "*_KEY"
+      - "*_SECRET"
+      - "*_TOKEN"
+      - "*_PASSWORD"
+      - "DATABASE_URL"
+
+# TIP: For credentials, create .vaulter/config.local.yaml (gitignored)
+# and put sensitive overrides there:
+#
+#   backend:
+#     url: s3://real-key:real-secret@bucket/envs
+`;
+    fs.writeFileSync(configPath, yamlContent);
+}
+//# sourceMappingURL=config-loader.js.map

package/dist/lib/config-loader.js.map

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

package/dist/lib/env-parser.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Vaulter - .env File Parser
+ *
+ * Robust parser for .env files with support for:
+ * - Single, double, and backtick quotes
+ * - Escape sequences in double quotes
+ * - Variable expansion (${VAR} and $VAR)
+ * - Multiline values
+ * - Comments
+ */
+export interface ParsedEnv {
+    [key: string]: string;
+}
+export interface ParseOptions {
+    expand?: boolean;
+    env?: Record<string, string>;
+}
+/**
+ * Parse a .env file from path
+ */
+export declare function parseEnvFile(filePath: string, options?: ParseOptions): ParsedEnv;
+/**
+ * Parse a .env string
+ */
+export declare function parseEnvString(content: string, options?: ParseOptions): ParsedEnv;
+/**
+ * Serialize a ParsedEnv object to .env format
+ */
+export declare function serializeEnv(env: ParsedEnv): string;
+/**
+ * Read stdin as .env content
+ */
+export declare function parseEnvFromStdin(options?: ParseOptions): Promise<ParsedEnv>;
+/**
+ * Check if stdin has data (is piped)
+ */
+export declare function hasStdinData(): boolean;
+//# sourceMappingURL=env-parser.d.ts.map

package/dist/lib/env-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-parser.d.ts","sourceRoot":"","sources":["../../src/lib/env-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,WAAW,SAAS;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC7B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,SAAS,CAGpF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,SAAS,CA0DrF;AAsLD;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CA6BnD;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,SAAS,CAAC,CAkBtF;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC"}