ds-sfcoe-ailabs/lib/common/utils/codeAnalysisUtils.d.ts

AI-powered code review tool with static analysis integration for comprehensive code quality assessment.

import { TableEntry } from './index.js';
/**
 * Utility class for analyzing code content and detecting patterns
 * Provides methods for JavaScript anti-pattern detection, test framework validation,
 * and general code analysis across different file types
 *
 * @example
 * ```typescript
 * // Analyze JavaScript content for anti-patterns
 * const entries = CodeAnalysisUtils.analyzeJavaScriptContent('app.js', jsContent, new Set());
 *
 * // Check for old test framework usage
 * const hasOldFramework = CodeAnalysisUtils.hasOldTestFramework(apexContent);
 *
 * // Extract class name from file path
 * const className = CodeAnalysisUtils.extractClassName('MyClass.cls');
 * ```
 */
export declare class CodeAnalysisUtils {
    /**
     * Check if content contains any JavaScript anti-patterns
     *
     * @param fileName - The name of the file being analyzed
     * @param content - The file content to analyze for JavaScript patterns
     * @param addedEntries - Set of already processed entry keys to avoid duplicates
     * @returns Array of table entries for JavaScript anti-patterns found
     * @example
     * ```typescript
     * const entries = CodeAnalysisUtils.analyzeJavaScriptContent('app.js', 'var x = 1;', new Set());
     * console.log(entries.length); // Number of anti-patterns found
     * ```
     */
    static analyzeJavaScriptContent(fileName: string, content: string, addedEntries: Set<string>): TableEntry[];
    /**
     * Check if file uses old test framework patterns
     *
     * @param content - The file content to analyze
     * @returns True if the file uses old test framework (no new framework patterns found)
     * @example
     * ```typescript
     * const hasOldFramework = CodeAnalysisUtils.hasOldTestFramework('Test.startTest();');
     * console.log(hasOldFramework); // true
     * ```
     */
    static hasOldTestFramework(content: string): boolean;
    /**
     * Check if content contains specific pattern
     *
     * @param content - The content to search in
     * @param pattern - The pattern to search for
     * @returns True if the pattern is found in the content
     * @example
     * ```typescript
     * const hasPattern = CodeAnalysisUtils.containsPattern('var x = 1;', 'var');
     * console.log(hasPattern); // true
     * ```
     */
    static containsPattern(content: string, pattern: string): boolean;
    /**
     * Extract class name from file path or content
     *
     * @param filePath - The file path to extract class name from
     * @returns The class name extracted from the file path (without extension)
     * @example
     * ```typescript
     * const className = CodeAnalysisUtils.extractClassName('/path/to/MyClass.cls');
     * console.log(className); // 'MyClass'
     * ```
     */
    static extractClassName(filePath: string): string;
    /**
     * Check if file is a test file based on filename or content
     *
     * @param filePath - The file path to check
     * @param content - Optional file content to check for test annotations
     * @returns True if the file is identified as a test file
     * @example
     * ```typescript
     * const isTest = CodeAnalysisUtils.isTestFile('MyTest.cls', '@isTest class MyTest {}');
     * console.log(isTest); // true
     * ```
     */
    static isTestFile(filePath: string, content?: string): boolean;
    /**
     * Create entry key for deduplication
     *
     * @param fileName - The name of the file
     * @param ruleId - The rule identifier
     * @param lineNumber - Optional line number where the issue occurs
     * @returns A unique key string for deduplication purposes
     * @example
     * ```typescript
     * const key1 = CodeAnalysisUtils.createEntryKey('MyClass.cls', 'no-var');
     * // Returns: 'MyClass.cls-no-var'
     *
     * const key2 = CodeAnalysisUtils.createEntryKey('MyClass.cls', 'no-var', 42);
     * // Returns: 'MyClass.cls-no-var-42'
     * ```
     */
    static createEntryKey(fileName: string, ruleId: string, lineNumber?: number): string;
}