dotenv-diff 2.2.5 → 2.2.7

package/dist/src/services/fileWalker.js

@@ -0,0 +1,238 @@
+import fs from 'fs/promises';
+import path from 'path';
+import fsSync from 'fs';
+import { DEFAULT_INCLUDE_EXTENSIONS, DEFAULT_EXCLUDE_PATTERNS, } from '../core/patterns.js';
+/**
+ * Recursively finds all files in the given directory matching the include patterns,
+ * while excluding files and directories that match the exclude patterns.
+ * @param rootDir The root directory to start searching from.
+ * @param opts Options for include, exclude patterns and files override.
+ * @returns A promise that resolves to an array of file paths.
+ */
+export async function findFiles(rootDir, opts) {
+    // If --files provided, keep existing replacement behavior
+    if (opts.files && opts.files.length > 0) {
+        return findFilesByPatterns(rootDir, opts.files);
+    }
+    const defaultPatterns = getDefaultPatterns();
+    const rawInclude = opts.include.length > 0
+        ? [...defaultPatterns, ...opts.include]
+        : defaultPatterns;
+    const includePatterns = rawInclude.flatMap(expandBraceSets);
+    const files = [];
+    const walked = new Set();
+    // Compute additional roots for include patterns that point outside cwd or are absolute
+    const extraRoots = new Set();
+    for (const p of includePatterns) {
+        const hasParentEscape = p.includes('..') || path.isAbsolute(p);
+        if (!hasParentEscape)
+            continue;
+        const dir = getPatternBaseDir(rootDir, p);
+        if (dir && !dir.startsWith(rootDir)) {
+            extraRoots.add(dir);
+        }
+    }
+    async function walk(startDir) {
+        // prevent duplicate subtree walks
+        const key = path.resolve(startDir);
+        if (walked.has(key))
+            return;
+        walked.add(key);
+        let entries;
+        try {
+            entries = await fs.readdir(startDir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const fullPath = path.join(startDir, entry.name);
+            const relativeToRoot = path.relative(rootDir, fullPath);
+            // Exclude checks should use path relative to *rootDir* (keeps existing semantics)
+            if (shouldExclude(entry.name, relativeToRoot, [
+                ...DEFAULT_EXCLUDE_PATTERNS,
+                ...opts.exclude,
+            ])) {
+                continue;
+            }
+            if (entry.isDirectory()) {
+                await walk(fullPath);
+            }
+            else if (entry.isFile() &&
+                shouldInclude(entry.name, relativeToRoot, includePatterns)) {
+                files.push(fullPath);
+            }
+        }
+    }
+    // Walk root first (current behavior)
+    await walk(rootDir);
+    // Walk any extra roots (e.g., ../../packages/…)
+    for (const r of extraRoots) {
+        await walk(r);
+    }
+    return files;
+}
+/**
+ * Expands brace sets in a glob pattern.
+ * @param pattern - The glob pattern to expand.
+ * @returns An array of expanded glob patterns.
+ */
+export function expandBraceSets(pattern) {
+    // Single-level brace expansion: **/*.{js,ts,svelte} -> [**/*.js, **/*.ts, **/*.svelte]
+    const m = pattern.match(/\{([^}]+)\}/);
+    if (!m || m[1] === undefined)
+        return [pattern];
+    const variants = m[1]
+        .split(',')
+        .map((p) => p.trim())
+        .filter(Boolean);
+    const prefix = pattern.slice(0, m.index);
+    const suffix = pattern.slice(m.index + m[0].length);
+    return variants.flatMap((v) => expandBraceSets(`${prefix}${v}${suffix}`));
+}
+/**
+ * Gets the base directory for a glob pattern.
+ * @param rootDir The root directory to resolve against.
+ * @param pattern The glob pattern to analyze.
+ * @returns The base directory for the pattern, or null if not found.
+ */
+export function getPatternBaseDir(rootDir, pattern) {
+    // Stop at first glob char — DO NOT include '/' here
+    const idx = pattern.search(/[*?\[\]{}]/); // <— removed '/'
+    const raw = idx === -1 ? pattern : pattern.slice(0, idx);
+    const base = path.isAbsolute(raw) ? raw : path.resolve(rootDir, raw);
+    try {
+        const st = fsSync.statSync(base);
+        if (st.isDirectory())
+            return base;
+        if (st.isFile())
+            return path.dirname(base);
+    }
+    catch {
+        const dir = path.dirname(base);
+        try {
+            const st2 = fsSync.statSync(dir);
+            if (st2.isDirectory())
+                return dir;
+        }
+        catch { }
+    }
+    return null;
+}
+/**
+ * Find files using the --files patterns (complete replacement mode)
+ * @param rootDir The root directory to search within.
+ * @param patterns The glob patterns to match files against.
+ * @returns A promise that resolves to an array of matching file paths.
+ */
+export async function findFilesByPatterns(rootDir, patterns) {
+    const expanded = patterns.flatMap(expandBraceSets);
+    const files = [];
+    async function walk(currentDir) {
+        let entries;
+        try {
+            entries = await fs.readdir(currentDir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const fullPath = path.join(currentDir, entry.name);
+            const relativePath = path.relative(rootDir, fullPath);
+            if (entry.isDirectory()) {
+                await walk(fullPath);
+            }
+            else if (entry.isFile() &&
+                shouldInclude(entry.name, relativePath, expanded)) {
+                files.push(fullPath);
+            }
+        }
+    }
+    await walk(rootDir);
+    return files;
+}
+/**
+ * Generate default patterns from extensions
+ * @returns An array of default glob patterns.
+ */
+export function getDefaultPatterns() {
+    return DEFAULT_INCLUDE_EXTENSIONS.map((ext) => `**/*${ext}`);
+}
+/**
+ * Check if a file should be included based on its name, path, and include patterns.
+ * @param fileName The name of the file.
+ * @param relativePath The relative path of the file.
+ * @param patterns The include patterns to match against.
+ * @returns True if the file should be included, false otherwise.
+ */
+export function shouldInclude(fileName, relativePath, patterns) {
+    // If no include patterns specified, use default extensions
+    if (!patterns.length) {
+        return DEFAULT_INCLUDE_EXTENSIONS.some((ext) => fileName.endsWith(ext));
+    }
+    return patterns.some((pattern) => {
+        if (pattern.startsWith('**')) {
+            // Handle **/*.ext patterns
+            const ext = pattern.substring(pattern.lastIndexOf('.'));
+            return fileName.endsWith(ext);
+        }
+        else if (pattern.includes('*')) {
+            // Simple glob pattern matching
+            return matchesGlobPattern(relativePath, pattern);
+        }
+        else {
+            // Exact match or extension
+            return relativePath.endsWith(pattern) || fileName.endsWith(pattern);
+        }
+    });
+}
+/**
+ * Checks if a file should be excluded based on its name, path, and exclude patterns.
+ * @param fileName The name of the file.
+ * @param relativePath The relative path of the file.
+ * @param patterns The exclude patterns to match against.
+ * @returns True if the file should be excluded, false otherwise.
+ */
+export function shouldExclude(fileName, relativePath, patterns) {
+    // Check if filename or any part of the path should be excluded
+    return patterns.some((pattern) => {
+        // Direct name match (like 'node_modules')
+        if (fileName === pattern)
+            return true;
+        // Path contains pattern
+        if (relativePath.includes(pattern))
+            return true;
+        // Pattern matching for extensions and wildcards
+        if (pattern.includes('*')) {
+            return matchesGlobPattern(relativePath, pattern);
+        }
+        // Special case for test files
+        if (pattern.includes('.test.') && fileName.includes('.test.'))
+            return true;
+        if (pattern.includes('.spec.') && fileName.includes('.spec.'))
+            return true;
+        return false;
+    });
+}
+/**
+ * Checks if a file path matches a glob pattern.
+ * A glob pattern is a string that may contain special characters like '*', '**', and '?' to represent wildcards and variable parts of the path.
+ * @param filePath The path of the file to check.
+ * @param pattern The glob pattern to match against.
+ * @returns True if the file path matches the pattern, false otherwise.
+ */
+export function matchesGlobPattern(filePath, pattern) {
+    const hasSep = /[\/\\]/.test(pattern);
+    const subject = hasSep ? filePath : path.basename(filePath);
+    const normalized = subject.replace(/\\/g, '/');
+    let normalizedPattern = pattern.replace(/\\/g, '/');
+    let regexPattern = normalizedPattern
+        .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+        .replace(/\*\*/g, '___DOUBLESTAR___')
+        .replace(/\*/g, '[^/]*')
+        .replace(/___DOUBLESTAR___/g, '.*')
+        .replace(/\?/g, '[^/]');
+    const re = new RegExp(`^${regexPattern}$`, 'i');
+    return re.test(normalized);
+}
+//# sourceMappingURL=fileWalker.js.map

package/dist/src/services/fileWalker.js.map

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

package/dist/src/services/scanOutputToConsole.d.ts

@@ -0,0 +1,12 @@
+import type { ScanUsageOptions, ScanResult } from '../config/types.js';
+/**
+ * Outputs the scan results to the console.
+ * @param scanResult - The result of the scan.
+ * @param opts - The scan options.
+ * @param comparedAgainst - The file being compared against.
+ * @returns An object indicating whether to exit with an error.
+ */
+export declare function outputToConsole(scanResult: ScanResult, opts: ScanUsageOptions, comparedAgainst: string): {
+    exitWithError: boolean;
+};
+//# sourceMappingURL=scanOutputToConsole.d.ts.map

package/dist/src/services/scanOutputToConsole.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanOutputToConsole.d.ts","sourceRoot":"","sources":["../../../src/services/scanOutputToConsole.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,UAAU,EAGX,MAAM,oBAAoB,CAAC;AAE5B;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,gBAAgB,EACtB,eAAe,EAAE,MAAM,GACtB;IAAE,aAAa,EAAE,OAAO,CAAA;CAAE,CA2P5B"}

package/dist/src/services/scanOutputToConsole.js

@@ -0,0 +1,166 @@
+import chalk from 'chalk';
+import { warnIfEnvNotIgnored, isEnvIgnoredByGit } from './git.js';
+/**
+ * Outputs the scan results to the console.
+ * @param scanResult - The result of the scan.
+ * @param opts - The scan options.
+ * @param comparedAgainst - The file being compared against.
+ * @returns An object indicating whether to exit with an error.
+ */
+export function outputToConsole(scanResult, opts, comparedAgainst) {
+    let exitWithError = false;
+    // Show what we're comparing against
+    if (comparedAgainst) {
+        console.log(chalk.magenta(`📋 Comparing codebase usage against: ${comparedAgainst}`));
+        console.log();
+    }
+    // Show stats if requested
+    if (opts.showStats) {
+        console.log(chalk.magenta('📊 Scan Statistics:'));
+        console.log(chalk.magenta.dim(`   Files scanned: ${scanResult.stats.filesScanned}`));
+        console.log(chalk.magenta.dim(`   Total usages found: ${scanResult.stats.totalUsages}`));
+        console.log(chalk.magenta.dim(`   Unique variables: ${scanResult.stats.uniqueVariables}`));
+        console.log();
+    }
+    // Always show found variables when not comparing or when no missing variables
+    if (scanResult.stats.uniqueVariables > 0) {
+        console.log(chalk.blue(`🌐 Found ${scanResult.stats.uniqueVariables} unique environment variables in use`));
+        console.log();
+        // List all variables found (if any)
+        if (scanResult.stats.uniqueVariables > 0) {
+            // Group by variable to get unique list
+            const variableUsages = scanResult.used.reduce((acc, usage) => {
+                if (!acc[usage.variable]) {
+                    acc[usage.variable] = [];
+                }
+                acc[usage.variable].push(usage);
+                return acc;
+            }, {});
+            // Display each unique variable
+            for (const [variable, usages] of Object.entries(variableUsages)) {
+                console.log(chalk.blue(`   ${variable}`));
+                // Show usage details if stats are enabled
+                if (opts.showStats) {
+                    const displayUsages = usages.slice(0, 2);
+                    displayUsages.forEach((usage) => {
+                        console.log(chalk.blue.dim(`     Used in: ${usage.file}:${usage.line} (${usage.pattern})`));
+                    });
+                    if (usages.length > 2) {
+                        console.log(chalk.gray(`     ... and ${usages.length - 2} more locations`));
+                    }
+                }
+            }
+            console.log();
+        }
+    }
+    // Missing variables (used in code but not in env file)
+    if (scanResult.missing.length > 0) {
+        exitWithError = true;
+        const fileType = comparedAgainst || 'environment file';
+        console.log(chalk.red(`❌ Missing in ${fileType}:`));
+        const grouped = scanResult.missing.reduce((acc, variable) => {
+            const usages = scanResult.used.filter((u) => u.variable === variable);
+            acc[variable] = usages;
+            return acc;
+        }, {});
+        for (const [variable, usages] of Object.entries(grouped)) {
+            console.log(chalk.red(`   - ${variable}`));
+            // Show first few usages
+            const maxShow = 3;
+            usages.slice(0, maxShow).forEach((usage) => {
+                console.log(chalk.red.dim(`     Used in: ${usage.file}:${usage.line} (${usage.pattern})`));
+            });
+            if (usages.length > maxShow) {
+                console.log(chalk.gray(`     ... and ${usages.length - maxShow} more locations`));
+            }
+        }
+        console.log();
+        // CI mode specific message
+        if (opts.isCiMode) {
+            console.log(chalk.red(`💥 Found ${scanResult.missing.length} missing environment variable(s).`));
+            console.log(chalk.red(`   Add these variables to ${comparedAgainst || 'your environment file'} to fix this error.`));
+            console.log();
+        }
+    }
+    // Unused variables (in env file but not used in code)
+    if (opts.showUnused && scanResult.unused.length > 0) {
+        const fileType = comparedAgainst || 'environment file';
+        console.log(chalk.yellow(`⚠️  Unused in codebase (defined in ${fileType}):`));
+        scanResult.unused.forEach((variable) => {
+            console.log(chalk.yellow(`   - ${variable}`));
+        });
+        console.log();
+    }
+    // Show duplicates if found - NOW AFTER UNUSED VARIABLES
+    if (scanResult.duplicates?.env && scanResult.duplicates.env.length > 0) {
+        console.log(chalk.yellow(`⚠️  Duplicate keys in ${comparedAgainst} (last occurrence wins):`));
+        scanResult.duplicates.env.forEach(({ key, count }) => console.log(chalk.yellow(`   - ${key} (${count} occurrences)`)));
+        console.log();
+    }
+    if (scanResult.duplicates?.example &&
+        scanResult.duplicates.example.length > 0) {
+        console.log(chalk.yellow('⚠️  Duplicate keys in example file (last occurrence wins):'));
+        scanResult.duplicates.example.forEach(({ key, count }) => console.log(chalk.yellow(`   - ${key} (${count} occurrences)`)));
+        console.log();
+    }
+    if (scanResult.secrets && scanResult.secrets.length > 0) {
+        console.log(chalk.yellow('🔒 Potential secrets detected in codebase:'));
+        const byFile = new Map();
+        for (const f of scanResult.secrets) {
+            if (!byFile.has(f.file))
+                byFile.set(f.file, []);
+            byFile.get(f.file).push(f);
+        }
+        for (const [file, findings] of byFile) {
+            console.log(chalk.bold(`  ${file}`));
+            for (const f of findings) {
+                console.log(chalk.yellow(`   - Line ${f.line}: ${f.message}\n     ${chalk.dim(f.snippet)}`));
+            }
+        }
+        console.log();
+    }
+    // Success message for env file comparison
+    if (comparedAgainst &&
+        scanResult.missing.length === 0 &&
+        scanResult.secrets.length > 0 &&
+        scanResult.used.length > 0) {
+        console.log(chalk.green(`✅ All used environment variables are defined in ${comparedAgainst}`));
+        if (opts.showUnused && scanResult.unused.length === 0) {
+            console.log(chalk.green('✅ No unused environment variables found'));
+        }
+        console.log();
+    }
+    let envNotIgnored = false;
+    if (!opts.json) {
+        warnIfEnvNotIgnored({ cwd: opts.cwd, envFile: '.env' });
+        const ignored = isEnvIgnoredByGit({ cwd: opts.cwd, envFile: '.env' });
+        if (ignored === false || ignored === null) {
+            envNotIgnored = true;
+        }
+    }
+    if (opts.strict) {
+        const hasWarnings = scanResult.unused.length > 0 ||
+            (scanResult.duplicates?.env?.length ?? 0) > 0 ||
+            (scanResult.duplicates?.example?.length ?? 0) > 0 ||
+            (scanResult.secrets?.length ?? 0) > 0 ||
+            envNotIgnored;
+        if (hasWarnings) {
+            exitWithError = true;
+            const warnings = [];
+            if (scanResult.unused.length > 0)
+                warnings.push('unused variables');
+            if ((scanResult.duplicates?.env?.length ?? 0) > 0)
+                warnings.push('duplicate keys in env');
+            if ((scanResult.duplicates?.example?.length ?? 0) > 0)
+                warnings.push('duplicate keys in example');
+            if ((scanResult.secrets?.length ?? 0) > 0)
+                warnings.push('potential secrets');
+            if (envNotIgnored)
+                warnings.push('.env not ignored by git');
+            console.log(chalk.red(`💥 Strict mode: Error on warnings → ${warnings.join(', ')}`));
+            console.log();
+        }
+    }
+    return { exitWithError };
+}
+//# sourceMappingURL=scanOutputToConsole.js.map

package/dist/src/services/scanOutputToConsole.js.map

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

package/dist/types/scanUsage.d.ts

@@ -0,0 +1,43 @@
+import { type SecretFinding } from '../src/core/secretDetectors';
+/**
+ * Represents a single usage of an environment variable in the codebase.
+ */
+export interface EnvUsage {
+    variable: string;
+    file: string;
+    line: number;
+    column: number;
+    pattern: 'process.env' | 'import.meta.env' | 'sveltekit' | 'deno' | 'next' | 'nuxt' | 'php';
+    context: string;
+}
+export interface ScanOptions {
+    cwd: string;
+    include: string[];
+    exclude: string[];
+    ignore: string[];
+    ignoreRegex: RegExp[];
+    files?: string[];
+    secrets?: boolean;
+}
+export interface ScanResult {
+    used: EnvUsage[];
+    missing: string[];
+    unused: string[];
+    stats: {
+        filesScanned: number;
+        totalUsages: number;
+        uniqueVariables: number;
+    };
+    secrets: SecretFinding[];
+    duplicates: {
+        env?: Array<{
+            key: string;
+            count: number;
+        }>;
+        example?: Array<{
+            key: string;
+            count: number;
+        }>;
+    };
+}
+//# sourceMappingURL=scanUsage.d.ts.map

package/dist/types/scanUsage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanUsage.d.ts","sourceRoot":"","sources":["../../types/scanUsage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EACH,aAAa,GACb,iBAAiB,GACjB,WAAW,GACX,MAAM,GACN,MAAM,GACN,MAAM,GACN,KAAK,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,UAAU,EAAE;QACV,GAAG,CAAC,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC5C,OAAO,CAAC,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACjD,CAAC;CACH"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dotenv-diff",
-  "version": "2.2.5",
+  "version": "2.2.7",
   "type": "module",
   "description": "Scan your codebase to find environment variables in use.",
   "bin": {
@@ -57,12 +57,12 @@
     "node": ">=20.0.0"
   },
   "dependencies": {
-    "chalk": "5.4.1",
+    "chalk": "5.6.2",
     "commander": "^14.0.0",
     "prompts": "^2.4.2"
   },
   "devDependencies": {
-    "@types/node": "^20.0.0",
+    "@types/node": "^24.5.2",
     "@typescript-eslint/eslint-plugin": "^8.39.0",
     "@typescript-eslint/parser": "^8.39.0",
     "eslint": "^9.32.0",