driftdetect-core 0.6.1 → 0.7.0

package/dist/constants/analysis/consistency-analyzer.js.map

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

package/dist/constants/analysis/dead-constant-detector.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Dead Constant Detector
+ *
+ * Detects constants that are defined but never used (dead code).
+ */
+import type { ConstantExtraction, EnumExtraction, DeadConstant, ConstantReference } from '../types.js';
+/**
+ * Configuration for dead constant detection
+ */
+export interface DeadConstantConfig {
+    /** Include test-only references as "used" */
+    countTestReferences: boolean;
+    /** Include deprecated constants */
+    includeDeprecated: boolean;
+    /** File patterns to exclude from analysis */
+    excludePatterns: string[];
+    /** Minimum confidence to report */
+    minConfidence: number;
+}
+/**
+ * Default dead constant config
+ */
+export declare const DEFAULT_DEAD_CONSTANT_CONFIG: DeadConstantConfig;
+/**
+ * Result of dead constant detection
+ */
+export interface DeadConstantResult {
+    /** Dead constants found */
+    deadConstants: DeadConstant[];
+    /** Total constants analyzed */
+    totalAnalyzed: number;
+    /** Detection time in ms */
+    detectionTimeMs: number;
+}
+/**
+ * Dead constant detector
+ */
+export declare class DeadConstantDetector {
+    private config;
+    constructor(config?: Partial<DeadConstantConfig>);
+    /**
+     * Detect dead constants
+     */
+    detect(constants: ConstantExtraction[], enums: EnumExtraction[], references: Map<string, ConstantReference[]>): DeadConstantResult;
+    /**
+     * Analyze a single constant for dead code
+     */
+    private analyzeConstant;
+    /**
+     * Analyze an enum for dead code
+     */
+    private analyzeEnum;
+    /**
+     * Filter references based on configuration
+     */
+    private filterReferences;
+    /**
+     * Check if a constant has deprecated annotation
+     */
+    private isDeprecated;
+    /**
+     * Check if an enum has deprecated annotation
+     */
+    private isEnumDeprecated;
+    /**
+     * Check if a file is a test file
+     */
+    private isTestFile;
+    /**
+     * Check if a file should be excluded
+     */
+    private shouldExcludeFile;
+}
+/**
+ * Quick check if a constant is potentially dead
+ * (for use during scanning without full reference analysis)
+ */
+export declare function isLikelyDead(constant: ConstantExtraction, fileContent: string): boolean;
+//# sourceMappingURL=dead-constant-detector.d.ts.map

package/dist/constants/analysis/dead-constant-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-constant-detector.d.ts","sourceRoot":"","sources":["../../../src/constants/analysis/dead-constant-detector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,mBAAmB,EAAE,OAAO,CAAC;IAC7B,mCAAmC;IACnC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,6CAA6C;IAC7C,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,kBAK1C,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,2BAA2B;IAC3B,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,2BAA2B;IAC3B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAqB;gBAEvB,MAAM,GAAE,OAAO,CAAC,kBAAkB,CAAM;IAIpD;;OAEG;IACH,MAAM,CACJ,SAAS,EAAE,kBAAkB,EAAE,EAC/B,KAAK,EAAE,cAAc,EAAE,EACvB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,GAC3C,kBAAkB;IAwCrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAwDvB;;OAEG;IACH,OAAO,CAAC,WAAW;IAuDnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAmBxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAiBpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAexB;;OAEG;IACH,OAAO,CAAC,UAAU;IAWlB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAQ1B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,kBAAkB,EAC5B,WAAW,EAAE,MAAM,GAClB,OAAO,CAOT"}

package/dist/constants/analysis/dead-constant-detector.js

@@ -0,0 +1,242 @@
+/**
+ * Dead Constant Detector
+ *
+ * Detects constants that are defined but never used (dead code).
+ */
+/**
+ * Default dead constant config
+ */
+export const DEFAULT_DEAD_CONSTANT_CONFIG = {
+    countTestReferences: false,
+    includeDeprecated: true,
+    excludePatterns: ['node_modules', 'dist', 'build', '.git'],
+    minConfidence: 0.7,
+};
+/**
+ * Dead constant detector
+ */
+export class DeadConstantDetector {
+    config;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_DEAD_CONSTANT_CONFIG, ...config };
+    }
+    /**
+     * Detect dead constants
+     */
+    detect(constants, enums, references) {
+        const startTime = performance.now();
+        const deadConstants = [];
+        // Check each constant
+        for (const constant of constants) {
+            // Skip excluded files
+            if (this.shouldExcludeFile(constant.file)) {
+                continue;
+            }
+            const result = this.analyzeConstant(constant, references);
+            if (result && result.confidence >= this.config.minConfidence) {
+                deadConstants.push(result);
+            }
+        }
+        // Check each enum
+        for (const enumDef of enums) {
+            // Skip excluded files
+            if (this.shouldExcludeFile(enumDef.file)) {
+                continue;
+            }
+            const result = this.analyzeEnum(enumDef, references);
+            if (result && result.confidence >= this.config.minConfidence) {
+                deadConstants.push(result);
+            }
+        }
+        // Sort by confidence (highest first)
+        deadConstants.sort((a, b) => b.confidence - a.confidence);
+        return {
+            deadConstants,
+            totalAnalyzed: constants.length + enums.length,
+            detectionTimeMs: performance.now() - startTime,
+        };
+    }
+    /**
+     * Analyze a single constant for dead code
+     */
+    analyzeConstant(constant, references) {
+        const refs = references.get(constant.id) || [];
+        // Check for deprecated annotation
+        if (this.isDeprecated(constant)) {
+            if (!this.config.includeDeprecated) {
+                return null;
+            }
+            return {
+                id: constant.id,
+                name: constant.name,
+                file: constant.file,
+                line: constant.line,
+                confidence: 0.9,
+                reason: 'deprecated_annotation',
+            };
+        }
+        // Filter references based on config
+        const effectiveRefs = this.filterReferences(refs, constant.file);
+        // No references at all
+        if (effectiveRefs.length === 0) {
+            // Check if it's exported - exported constants might be used externally
+            const confidence = constant.isExported ? 0.6 : 0.95;
+            return {
+                id: constant.id,
+                name: constant.name,
+                file: constant.file,
+                line: constant.line,
+                confidence,
+                reason: 'no_references',
+            };
+        }
+        // Only test references
+        if (!this.config.countTestReferences) {
+            const nonTestRefs = effectiveRefs.filter(r => !this.isTestFile(r.file));
+            if (nonTestRefs.length === 0 && effectiveRefs.length > 0) {
+                return {
+                    id: constant.id,
+                    name: constant.name,
+                    file: constant.file,
+                    line: constant.line,
+                    confidence: 0.8,
+                    reason: 'only_test_references',
+                };
+            }
+        }
+        return null;
+    }
+    /**
+     * Analyze an enum for dead code
+     */
+    analyzeEnum(enumDef, references) {
+        const refs = references.get(enumDef.id) || [];
+        // Check for deprecated annotation
+        if (this.isEnumDeprecated(enumDef)) {
+            if (!this.config.includeDeprecated) {
+                return null;
+            }
+            return {
+                id: enumDef.id,
+                name: enumDef.name,
+                file: enumDef.file,
+                line: enumDef.line,
+                confidence: 0.9,
+                reason: 'deprecated_annotation',
+            };
+        }
+        // Filter references
+        const effectiveRefs = this.filterReferences(refs, enumDef.file);
+        // No references
+        if (effectiveRefs.length === 0) {
+            const confidence = enumDef.isExported ? 0.6 : 0.95;
+            return {
+                id: enumDef.id,
+                name: enumDef.name,
+                file: enumDef.file,
+                line: enumDef.line,
+                confidence,
+                reason: 'no_references',
+            };
+        }
+        // Only test references
+        if (!this.config.countTestReferences) {
+            const nonTestRefs = effectiveRefs.filter(r => !this.isTestFile(r.file));
+            if (nonTestRefs.length === 0 && effectiveRefs.length > 0) {
+                return {
+                    id: enumDef.id,
+                    name: enumDef.name,
+                    file: enumDef.file,
+                    line: enumDef.line,
+                    confidence: 0.8,
+                    reason: 'only_test_references',
+                };
+            }
+        }
+        return null;
+    }
+    /**
+     * Filter references based on configuration
+     */
+    filterReferences(refs, definitionFile) {
+        return refs.filter(ref => {
+            // Exclude self-references (same file, same line)
+            if (ref.file === definitionFile) {
+                return false;
+            }
+            // Exclude references in excluded patterns
+            if (this.shouldExcludeFile(ref.file)) {
+                return false;
+            }
+            return true;
+        });
+    }
+    /**
+     * Check if a constant has deprecated annotation
+     */
+    isDeprecated(constant) {
+        // Check decorators
+        if (constant.decorators.some(d => d.toLowerCase().includes('deprecated') ||
+            d.toLowerCase().includes('obsolete'))) {
+            return true;
+        }
+        // Check doc comment
+        if (constant.docComment?.toLowerCase().includes('@deprecated')) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Check if an enum has deprecated annotation
+     */
+    isEnumDeprecated(enumDef) {
+        if (enumDef.decorators.some(d => d.toLowerCase().includes('deprecated') ||
+            d.toLowerCase().includes('obsolete'))) {
+            return true;
+        }
+        if (enumDef.docComment?.toLowerCase().includes('@deprecated')) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Check if a file is a test file
+     */
+    isTestFile(filePath) {
+        return (filePath.includes('.test.') ||
+            filePath.includes('.spec.') ||
+            filePath.includes('__tests__') ||
+            filePath.includes('__mocks__') ||
+            filePath.includes('/test/') ||
+            filePath.includes('/tests/'));
+    }
+    /**
+     * Check if a file should be excluded
+     */
+    shouldExcludeFile(filePath) {
+        for (const pattern of this.config.excludePatterns) {
+            if (filePath.includes(pattern)) {
+                return true;
+            }
+        }
+        return false;
+    }
+}
+/**
+ * Quick check if a constant is potentially dead
+ * (for use during scanning without full reference analysis)
+ */
+export function isLikelyDead(constant, fileContent) {
+    // Count occurrences of the constant name in the file
+    const pattern = new RegExp(`\\b${escapeRegex(constant.name)}\\b`, 'g');
+    const matches = fileContent.match(pattern);
+    // If only appears once (the definition), likely dead
+    return !matches || matches.length <= 1;
+}
+/**
+ * Escape special regex characters
+ */
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=dead-constant-detector.js.map

package/dist/constants/analysis/dead-constant-detector.js.map

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

package/dist/constants/analysis/magic-detector.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Magic Value Detector
+ *
+ * Detects hardcoded "magic" values (numbers and strings) that should
+ * be extracted into named constants.
+ */
+import type { MagicValue } from '../types.js';
+/**
+ * Configuration for magic value detection
+ */
+export interface MagicDetectorConfig {
+    /** Minimum occurrences to flag as magic */
+    minOccurrences: number;
+    /** Values to ignore (common acceptable values) */
+    ignoreValues: (string | number)[];
+    /** File patterns to ignore */
+    ignorePatterns: string[];
+    /** Include string literals */
+    includeStrings: boolean;
+    /** Include numeric literals */
+    includeNumbers: boolean;
+    /** Minimum string length to consider */
+    minStringLength: number;
+    /** Maximum string length to consider */
+    maxStringLength: number;
+}
+/**
+ * Default magic detector config
+ */
+export declare const DEFAULT_MAGIC_DETECTOR_CONFIG: MagicDetectorConfig;
+/**
+ * Result of magic value detection
+ */
+export interface MagicDetectionResult {
+    /** All magic values found */
+    magicValues: MagicValue[];
+    /** Total occurrences across all magic values */
+    totalOccurrences: number;
+    /** Files with magic values */
+    filesAffected: number;
+    /** Detection time in ms */
+    detectionTimeMs: number;
+}
+/**
+ * Magic value detector
+ */
+export declare class MagicValueDetector {
+    private config;
+    private ignoreSet;
+    constructor(config?: Partial<MagicDetectorConfig>);
+    /**
+     * Detect magic values in the given files
+     */
+    detect(files: Map<string, string>): MagicDetectionResult;
+    /**
+     * Extract literals from a file
+     */
+    private extractLiterals;
+    /**
+     * Extract string literals from a line
+     */
+    private extractStringLiterals;
+    /**
+     * Extract numeric literals from a line
+     */
+    private extractNumericLiterals;
+    /**
+     * Add an occurrence to the value map
+     */
+    private addOccurrence;
+    /**
+     * Check if a value should be ignored
+     */
+    private shouldIgnoreValue;
+    /**
+     * Build magic values from occurrence map
+     */
+    private buildMagicValues;
+    /**
+     * Suggest a constant name for a magic value
+     */
+    private suggestConstantName;
+    /**
+     * Suggest a category for a magic value
+     */
+    private suggestCategory;
+    /**
+     * Calculate severity based on occurrences and value type
+     */
+    private calculateSeverity;
+    /**
+     * Check if a line is a comment
+     */
+    private isCommentLine;
+    /**
+     * Check if a line is a constant definition
+     */
+    private isConstantDefinition;
+    /**
+     * Check if a file should be excluded
+     */
+    private shouldExcludeFile;
+    /**
+     * Infer language from file path
+     */
+    private inferLanguage;
+    /**
+     * Extract context snippet
+     */
+    private extractContext;
+    /**
+     * Find containing function
+     */
+    private findContainingFunction;
+}
+//# sourceMappingURL=magic-detector.d.ts.map

package/dist/constants/analysis/magic-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"magic-detector.d.ts","sourceRoot":"","sources":["../../../src/constants/analysis/magic-detector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,UAAU,EAKX,MAAM,aAAa,CAAC;AAGrB;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,cAAc,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,YAAY,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAClC,8BAA8B;IAC9B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,8BAA8B;IAC9B,cAAc,EAAE,OAAO,CAAC;IACxB,+BAA+B;IAC/B,cAAc,EAAE,OAAO,CAAC;IACxB,wCAAwC;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,eAAO,MAAM,6BAA6B,EAAE,mBAmB3C,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,6BAA6B;IAC7B,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,gDAAgD;IAChD,gBAAgB,EAAE,MAAM,CAAC;IACzB,8BAA8B;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,2BAA2B;IAC3B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,SAAS,CAAc;gBAEnB,MAAM,GAAE,OAAO,CAAC,mBAAmB,CAAM;IAKrD;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,oBAAoB;IAiCxD;;OAEG;IACH,OAAO,CAAC,eAAe;IAmCvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAmC7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA2B9B;;OAEG;IACH,OAAO,CAAC,aAAa;IA+BrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuDzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiCxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgC3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAuBvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAqBrB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA+B5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IASzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAWrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,OAAO,CAAC,sBAAsB;CAoB/B"}