@nahisaho/musubix-security 1.8.0 → 1.8.1

package/dist/remediation/auto-fixer.d.ts

@@ -0,0 +1,179 @@
+/**
+ * @fileoverview Auto-Fixer for Security Vulnerabilities
+ * @module @nahisaho/musubix-security/remediation/auto-fixer
+ *
+ * Provides automated fix generation and application for detected vulnerabilities.
+ */
+import type { Vulnerability, Fix, FixStrategy } from '../types/index.js';
+/**
+ * Fix template for a vulnerability type
+ */
+export interface FixTemplate {
+    /** Template ID */
+    id: string;
+    /** Vulnerability types this template applies to */
+    vulnerabilityTypes: string[];
+    /** Rule patterns to match */
+    rulePatterns: string[];
+    /** Fix strategy */
+    strategy: FixStrategy;
+    /** Template code transformations */
+    transformations: CodeTransformation[];
+    /** Required imports */
+    imports: ImportSpec[];
+    /** Confidence score for this template */
+    confidence: number;
+    /** Whether fix might break functionality */
+    breakingChange: boolean;
+    /** Description */
+    description: string;
+}
+/**
+ * Code transformation specification
+ */
+export interface CodeTransformation {
+    /** Transformation type */
+    type: 'replace' | 'wrap' | 'insert_before' | 'insert_after' | 'delete';
+    /** Pattern to match (regex) */
+    pattern?: string;
+    /** Replacement template (can use $1, $2 etc for captured groups) */
+    replacement?: string;
+    /** Wrapper template (for wrap type) */
+    wrapper?: {
+        before: string;
+        after: string;
+    };
+    /** Content to insert */
+    content?: string;
+}
+/**
+ * Import specification
+ */
+export interface ImportSpec {
+    /** Module name */
+    module: string;
+    /** Named imports */
+    namedImports?: string[];
+    /** Default import name */
+    defaultImport?: string;
+    /** Is type import */
+    isTypeOnly?: boolean;
+}
+/**
+ * Fix application result
+ */
+export interface FixApplicationResult {
+    /** Whether fix was applied */
+    applied: boolean;
+    /** Fix that was applied */
+    fix: Fix;
+    /** Files modified */
+    modifiedFiles: string[];
+    /** Backup created */
+    backupPath?: string;
+    /** Error if failed */
+    error?: string;
+    /** Warnings */
+    warnings: string[];
+}
+/**
+ * Fix generation options
+ */
+export interface FixGenerationOptions {
+    /** Maximum fixes to generate per vulnerability */
+    maxFixes?: number;
+    /** Minimum confidence threshold */
+    minConfidence?: number;
+    /** Include breaking changes */
+    includeBreakingChanges?: boolean;
+    /** Preferred strategies */
+    preferredStrategies?: FixStrategy[];
+    /** Custom templates */
+    customTemplates?: FixTemplate[];
+}
+/**
+ * Auto-fixer options
+ */
+export interface AutoFixerOptions {
+    /** Create backups before applying fixes */
+    createBackups?: boolean;
+    /** Backup directory */
+    backupDir?: string;
+    /** Dry run mode (don't actually modify files) */
+    dryRun?: boolean;
+    /** Validate fixes after applying */
+    validateAfterApply?: boolean;
+    /** Custom fix templates */
+    templates?: FixTemplate[];
+}
+/**
+ * AutoFixer for generating and applying security fixes
+ *
+ * @example
+ * ```typescript
+ * const fixer = createAutoFixer({ dryRun: true });
+ * const fixes = fixer.generateFixes(vulnerability);
+ * const result = await fixer.applyFix(fixes[0], fileContent);
+ * ```
+ */
+export declare class AutoFixer {
+    private templates;
+    private options;
+    constructor(options?: AutoFixerOptions);
+    /**
+     * Generate fixes for a vulnerability
+     */
+    generateFixes(vulnerability: Vulnerability, options?: FixGenerationOptions): Fix[];
+    /**
+     * Generate fix for multiple vulnerabilities
+     */
+    generateBatchFixes(vulnerabilities: Vulnerability[], options?: FixGenerationOptions): Map<string, Fix[]>;
+    /**
+     * Apply a fix to file content
+     */
+    applyFix(fix: Fix, fileContent: string): FixApplicationResult;
+    /**
+     * Get available fix strategies for a vulnerability type
+     */
+    getAvailableStrategies(vulnerabilityType: string): FixStrategy[];
+    /**
+     * Get fix template by ID
+     */
+    getTemplate(templateId: string): FixTemplate | undefined;
+    /**
+     * Register custom fix template
+     */
+    registerTemplate(template: FixTemplate): void;
+    /**
+     * Validate a fix before applying
+     */
+    validateFix(fix: Fix): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Preview fix without applying
+     */
+    previewFix(fix: Fix, fileContent: string): string;
+    private findMatchingTemplates;
+    private sortTemplates;
+    private generateFixFromTemplate;
+    private createEditFromTransformation;
+    private applyReplacement;
+    private applyEdit;
+    private addImports;
+    private getModifiedContent;
+}
+/**
+ * Create an auto-fixer instance
+ */
+export declare function createAutoFixer(options?: AutoFixerOptions): AutoFixer;
+/**
+ * Get all built-in fix templates
+ */
+export declare function getBuiltInTemplates(): FixTemplate[];
+/**
+ * Create a custom fix template
+ */
+export declare function createFixTemplate(config: Omit<FixTemplate, 'id'>): FixTemplate;
+//# sourceMappingURL=auto-fixer.d.ts.map

package/dist/remediation/auto-fixer.d.ts.map

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