driftdetect-core 0.4.4 → 0.4.6

package/dist/language-intelligence/base-normalizer.js

@@ -0,0 +1,210 @@
+/**
+ * Base Language Normalizer
+ *
+ * Abstract base class for language-specific normalizers.
+ * Provides common functionality for semantic normalization.
+ */
+import { getFrameworkRegistry } from './framework-registry.js';
+/**
+ * Abstract base class for language normalizers
+ */
+export class BaseLanguageNormalizer {
+    /**
+     * Normalize an extraction result
+     */
+    normalize(source, filePath) {
+        // Get raw extraction from existing extractor
+        const raw = this.extractRaw(source, filePath);
+        // Detect frameworks in use
+        const detectedFrameworks = this.detectFrameworks(source);
+        // Normalize each function
+        const functions = raw.functions.map(fn => this.normalizeFunction(fn, detectedFrameworks));
+        // Determine file-level semantics
+        const fileSemantics = this.deriveFileSemantics(functions, detectedFrameworks);
+        return {
+            ...raw,
+            functions,
+            detectedFrameworks: detectedFrameworks.map(f => f.framework),
+            fileSemantics,
+        };
+    }
+    /**
+     * Normalize a single function
+     */
+    normalizeFunction(fn, frameworks) {
+        // Normalize all decorators
+        const normalizedDecorators = fn.decorators.map(d => this.normalizeDecorator(d, frameworks));
+        // Derive semantics from normalized decorators
+        const semantics = this.deriveFunctionSemantics(fn, normalizedDecorators, frameworks);
+        return {
+            ...fn,
+            normalizedDecorators,
+            semantics,
+        };
+    }
+    /**
+     * Normalize a single decorator string
+     */
+    normalizeDecorator(raw, frameworks) {
+        const registry = getFrameworkRegistry();
+        // Try to find a matching pattern
+        const match = registry.findDecoratorMapping(raw, frameworks);
+        if (match) {
+            const { mapping, framework } = match;
+            return {
+                raw,
+                name: this.extractDecoratorName(raw),
+                language: this.language,
+                framework: framework.framework,
+                semantic: {
+                    ...mapping.semantic,
+                    confidence: mapping.confidence ?? 1.0,
+                },
+                arguments: mapping.extractArgs(raw),
+            };
+        }
+        // No match - return with default/unknown semantics
+        return {
+            raw,
+            name: this.extractDecoratorName(raw),
+            language: this.language,
+            semantic: registry.getDefaultSemantics(),
+            arguments: this.extractGenericArguments(raw),
+        };
+    }
+    /**
+     * Detect which frameworks are in use
+     */
+    detectFrameworks(source) {
+        return getFrameworkRegistry().detectFrameworks(source, this.language);
+    }
+    /**
+     * Check if this normalizer can handle a file
+     */
+    canHandle(filePath) {
+        const ext = this.getExtension(filePath);
+        return this.extensions.includes(ext);
+    }
+    /**
+     * Extract decorator name from raw string
+     * Override in subclasses for language-specific syntax
+     */
+    extractDecoratorName(raw) {
+        // Default: strip common prefixes (@, #, [, etc.)
+        return raw
+            .replace(/^[@#\[]/, '')
+            .replace(/\]$/, '')
+            .replace(/\(.*$/, '')
+            .trim();
+    }
+    /**
+     * Extract generic arguments from decorator string
+     * Override in subclasses for language-specific parsing
+     */
+    extractGenericArguments(raw) {
+        const args = {};
+        // Try to extract path-like argument
+        const pathMatch = raw.match(/["']([^"']+)["']/);
+        if (pathMatch && pathMatch[1] !== undefined) {
+            args.path = pathMatch[1];
+        }
+        return args;
+    }
+    /**
+     * Get file extension
+     */
+    getExtension(filePath) {
+        const lastDot = filePath.lastIndexOf('.');
+        return lastDot >= 0 ? filePath.slice(lastDot) : '';
+    }
+    /**
+     * Derive function semantics from normalized decorators
+     */
+    deriveFunctionSemantics(fn, decorators, _frameworks) {
+        const isEntryPoint = decorators.some(d => d.semantic.isEntryPoint);
+        const isInjectable = decorators.some(d => d.semantic.isInjectable);
+        const isAuthHandler = decorators.some(d => d.semantic.category === 'auth');
+        const isTestCase = decorators.some(d => d.semantic.category === 'test');
+        const isDataAccessor = decorators.some(d => d.semantic.dataAccess !== undefined);
+        const requiresAuth = decorators.some(d => d.semantic.requiresAuth);
+        // Extract entry point details
+        let entryPoint = undefined;
+        if (isEntryPoint) {
+            const routingDecorator = decorators.find(d => d.semantic.category === 'routing');
+            if (routingDecorator) {
+                const path = routingDecorator.arguments.path;
+                const methods = routingDecorator.arguments.methods;
+                entryPoint = {
+                    type: 'http',
+                    ...(path !== undefined && { path }),
+                    ...(methods !== undefined && { methods }),
+                };
+            }
+        }
+        // Extract dependencies (from constructor params or DI decorators)
+        const dependencies = this.extractDependencies(fn, decorators);
+        // Extract auth requirements
+        let auth = undefined;
+        if (requiresAuth) {
+            const authDecorator = decorators.find(d => d.semantic.requiresAuth);
+            const roles = authDecorator?.arguments.roles;
+            auth = {
+                required: true,
+                ...(roles !== undefined && { roles }),
+            };
+        }
+        return {
+            isEntryPoint,
+            isDataAccessor,
+            isAuthHandler,
+            isTestCase,
+            isInjectable,
+            ...(entryPoint !== undefined && { entryPoint }),
+            dependencies,
+            dataAccess: [], // Populated by data access extractors
+            ...(auth !== undefined && { auth }),
+        };
+    }
+    /**
+     * Extract dependencies from function
+     * Override in subclasses for language-specific DI patterns
+     */
+    extractDependencies(_fn, _decorators) {
+        return [];
+    }
+    /**
+     * Derive file-level semantics
+     */
+    deriveFileSemantics(functions, frameworks) {
+        const hasEntryPoints = functions.some(f => f.semantics.isEntryPoint);
+        const hasInjectables = functions.some(f => f.semantics.isInjectable);
+        const hasDataAccessors = functions.some(f => f.semantics.isDataAccessor);
+        const hasTests = functions.some(f => f.semantics.isTestCase);
+        // Determine primary framework
+        const frameworkCounts = new Map();
+        for (const fn of functions) {
+            for (const d of fn.normalizedDecorators) {
+                if (d.framework) {
+                    frameworkCounts.set(d.framework, (frameworkCounts.get(d.framework) ?? 0) + 1);
+                }
+            }
+        }
+        let primaryFramework;
+        let maxCount = 0;
+        for (const [fw, count] of frameworkCounts) {
+            if (count > maxCount) {
+                maxCount = count;
+                primaryFramework = fw;
+            }
+        }
+        const resolvedPrimaryFramework = primaryFramework ?? frameworks[0]?.framework;
+        return {
+            isController: hasEntryPoints,
+            isService: hasInjectables && !hasEntryPoints,
+            isModel: hasDataAccessors && !hasEntryPoints && !hasInjectables,
+            isTestFile: hasTests,
+            ...(resolvedPrimaryFramework !== undefined && { primaryFramework: resolvedPrimaryFramework }),
+        };
+    }
+}
+//# sourceMappingURL=base-normalizer.js.map

package/dist/language-intelligence/base-normalizer.js.map

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

package/dist/language-intelligence/framework-registry.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Framework Registry
+ *
+ * Central registry for framework patterns. Manages loading, registration,
+ * and lookup of framework-specific decorator/annotation patterns.
+ */
+import type { CallGraphLanguage } from '../call-graph/types.js';
+import type { FrameworkPattern, DecoratorMapping, DecoratorSemantics } from './types.js';
+/**
+ * Framework Registry
+ *
+ * Singleton registry that holds all known framework patterns.
+ * Frameworks can be registered at startup or dynamically added.
+ */
+export declare class FrameworkRegistry {
+    private static instance;
+    /** All registered framework patterns */
+    private frameworks;
+    /** Index by language for fast lookup */
+    private byLanguage;
+    private constructor();
+    /**
+     * Get the singleton instance
+     */
+    static getInstance(): FrameworkRegistry;
+    /**
+     * Reset the registry (mainly for testing)
+     */
+    static reset(): void;
+    /**
+     * Register a framework pattern
+     */
+    register(pattern: FrameworkPattern): void;
+    /**
+     * Register multiple framework patterns
+     */
+    registerAll(patterns: FrameworkPattern[]): void;
+    /**
+     * Get a framework pattern by name
+     */
+    get(framework: string): FrameworkPattern | undefined;
+    /**
+     * Get all frameworks for a language
+     */
+    getForLanguage(language: CallGraphLanguage): FrameworkPattern[];
+    /**
+     * Get all registered frameworks
+     */
+    getAll(): FrameworkPattern[];
+    /**
+     * Check if a framework is registered
+     */
+    has(framework: string): boolean;
+    /**
+     * Detect frameworks from source code
+     *
+     * Checks detection patterns against the source to determine
+     * which frameworks are likely in use.
+     */
+    detectFrameworks(source: string, language: CallGraphLanguage): FrameworkPattern[];
+    /**
+     * Check if source matches a framework's detection patterns
+     */
+    private matchesDetectionPatterns;
+    /**
+     * Find matching decorator mapping for a raw decorator string
+     */
+    findDecoratorMapping(raw: string, frameworks: FrameworkPattern[]): {
+        mapping: DecoratorMapping;
+        framework: FrameworkPattern;
+    } | null;
+    /**
+     * Get default semantics for an unknown decorator
+     */
+    getDefaultSemantics(): DecoratorSemantics;
+}
+/**
+ * Get the global framework registry instance
+ */
+export declare function getFrameworkRegistry(): FrameworkRegistry;
+/**
+ * Register a framework pattern in the global registry
+ */
+export declare function registerFramework(pattern: FrameworkPattern): void;
+/**
+ * Register multiple framework patterns
+ */
+export declare function registerFrameworks(patterns: FrameworkPattern[]): void;
+//# sourceMappingURL=framework-registry.d.ts.map

package/dist/language-intelligence/framework-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-registry.d.ts","sourceRoot":"","sources":["../../src/language-intelligence/framework-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEzF;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAkC;IAEzD,wCAAwC;IACxC,OAAO,CAAC,UAAU,CAA4C;IAE9D,wCAAwC;IACxC,OAAO,CAAC,UAAU,CAAyD;IAE3E,OAAO;IAEP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,iBAAiB;IAOvC;;OAEG;IACH,MAAM,CAAC,KAAK,IAAI,IAAI;IAIpB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAazC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,IAAI;IAM/C;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAIpD;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,iBAAiB,GAAG,gBAAgB,EAAE;IAI/D;;OAEG;IACH,MAAM,IAAI,gBAAgB,EAAE;IAI5B;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI/B;;;;;OAKG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,gBAAgB,EAAE;IAajF;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAwBhC;;OAEG;IACH,oBAAoB,CAClB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,gBAAgB,EAAE,GAC7B;QAAE,OAAO,EAAE,gBAAgB,CAAC;QAAC,SAAS,EAAE,gBAAgB,CAAA;KAAE,GAAG,IAAI;IAWpE;;OAEG;IACH,mBAAmB,IAAI,kBAAkB;CAU1C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,CAExD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAEjE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAErE"}

package/dist/language-intelligence/framework-registry.js

@@ -0,0 +1,165 @@
+/**
+ * Framework Registry
+ *
+ * Central registry for framework patterns. Manages loading, registration,
+ * and lookup of framework-specific decorator/annotation patterns.
+ */
+/**
+ * Framework Registry
+ *
+ * Singleton registry that holds all known framework patterns.
+ * Frameworks can be registered at startup or dynamically added.
+ */
+export class FrameworkRegistry {
+    static instance = null;
+    /** All registered framework patterns */
+    frameworks = new Map();
+    /** Index by language for fast lookup */
+    byLanguage = new Map();
+    constructor() { }
+    /**
+     * Get the singleton instance
+     */
+    static getInstance() {
+        if (!FrameworkRegistry.instance) {
+            FrameworkRegistry.instance = new FrameworkRegistry();
+        }
+        return FrameworkRegistry.instance;
+    }
+    /**
+     * Reset the registry (mainly for testing)
+     */
+    static reset() {
+        FrameworkRegistry.instance = null;
+    }
+    /**
+     * Register a framework pattern
+     */
+    register(pattern) {
+        this.frameworks.set(pattern.framework, pattern);
+        // Update language index
+        for (const lang of pattern.languages) {
+            const existing = this.byLanguage.get(lang) ?? [];
+            if (!existing.find(f => f.framework === pattern.framework)) {
+                existing.push(pattern);
+                this.byLanguage.set(lang, existing);
+            }
+        }
+    }
+    /**
+     * Register multiple framework patterns
+     */
+    registerAll(patterns) {
+        for (const pattern of patterns) {
+            this.register(pattern);
+        }
+    }
+    /**
+     * Get a framework pattern by name
+     */
+    get(framework) {
+        return this.frameworks.get(framework);
+    }
+    /**
+     * Get all frameworks for a language
+     */
+    getForLanguage(language) {
+        return this.byLanguage.get(language) ?? [];
+    }
+    /**
+     * Get all registered frameworks
+     */
+    getAll() {
+        return Array.from(this.frameworks.values());
+    }
+    /**
+     * Check if a framework is registered
+     */
+    has(framework) {
+        return this.frameworks.has(framework);
+    }
+    /**
+     * Detect frameworks from source code
+     *
+     * Checks detection patterns against the source to determine
+     * which frameworks are likely in use.
+     */
+    detectFrameworks(source, language) {
+        const candidates = this.getForLanguage(language);
+        const detected = [];
+        for (const framework of candidates) {
+            if (this.matchesDetectionPatterns(source, framework)) {
+                detected.push(framework);
+            }
+        }
+        return detected;
+    }
+    /**
+     * Check if source matches a framework's detection patterns
+     */
+    matchesDetectionPatterns(source, framework) {
+        const { detectionPatterns } = framework;
+        // Check import patterns
+        if (detectionPatterns.imports?.length) {
+            for (const pattern of detectionPatterns.imports) {
+                if (pattern.test(source)) {
+                    return true;
+                }
+            }
+        }
+        // Check decorator patterns
+        if (detectionPatterns.decorators?.length) {
+            for (const pattern of detectionPatterns.decorators) {
+                if (pattern.test(source)) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+    /**
+     * Find matching decorator mapping for a raw decorator string
+     */
+    findDecoratorMapping(raw, frameworks) {
+        for (const framework of frameworks) {
+            for (const mapping of framework.decoratorMappings) {
+                if (mapping.pattern.test(raw)) {
+                    return { mapping, framework };
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * Get default semantics for an unknown decorator
+     */
+    getDefaultSemantics() {
+        return {
+            category: 'unknown',
+            intent: 'Unknown decorator',
+            isEntryPoint: false,
+            isInjectable: false,
+            requiresAuth: false,
+            confidence: 0,
+        };
+    }
+}
+/**
+ * Get the global framework registry instance
+ */
+export function getFrameworkRegistry() {
+    return FrameworkRegistry.getInstance();
+}
+/**
+ * Register a framework pattern in the global registry
+ */
+export function registerFramework(pattern) {
+    getFrameworkRegistry().register(pattern);
+}
+/**
+ * Register multiple framework patterns
+ */
+export function registerFrameworks(patterns) {
+    getFrameworkRegistry().registerAll(patterns);
+}
+//# sourceMappingURL=framework-registry.js.map

package/dist/language-intelligence/framework-registry.js.map

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

package/dist/language-intelligence/frameworks/aspnet.d.ts

@@ -0,0 +1,11 @@
+/**
+ * ASP.NET Core Framework Patterns
+ *
+ * Semantic mappings for ASP.NET Core attributes.
+ */
+import type { FrameworkPattern } from '../types.js';
+/**
+ * ASP.NET Core framework patterns
+ */
+export declare const ASPNET_PATTERNS: FrameworkPattern;
+//# sourceMappingURL=aspnet.d.ts.map

package/dist/language-intelligence/frameworks/aspnet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aspnet.d.ts","sourceRoot":"","sources":["../../../src/language-intelligence/frameworks/aspnet.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAkC,MAAM,aAAa,CAAC;AAgCpF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,gBA+S7B,CAAC"}