driftdetect-core 0.4.5 → 0.5.0

package/dist/wrappers/clustering/exclusions.js

@@ -0,0 +1,318 @@
+/**
+ * Wrapper Exclusion Rules
+ *
+ * Filters out false positives from wrapper detection.
+ * Excludes simple utilities, direct framework usage, and other non-patterns.
+ */
+// =============================================================================
+// Exclusion Rules
+// =============================================================================
+/**
+ * Built-in exclusion rules
+ */
+export const EXCLUSION_RULES = [
+    // 1. Test utilities - not real patterns
+    {
+        id: 'test-utilities',
+        name: 'Test Utilities',
+        description: 'Exclude test helper functions and mocks',
+        applies: (w) => {
+            const testPatterns = [
+                /^mock/i,
+                /^stub/i,
+                /^fake/i,
+                /^spy/i,
+                /^render.*test/i,
+                /^setup.*test/i,
+                /^create.*mock/i,
+                /test.*helper/i,
+                /test.*util/i,
+                /__test__/,
+                /\.test\./,
+                /\.spec\./,
+            ];
+            return testPatterns.some((p) => p.test(w.name) || p.test(w.file));
+        },
+    },
+    // 2. Generated code - not human patterns
+    {
+        id: 'generated-code',
+        name: 'Generated Code',
+        description: 'Exclude auto-generated files',
+        applies: (w) => {
+            const generatedPatterns = [
+                /\.generated\./,
+                /\.g\./,
+                /\.auto\./,
+                /__generated__/,
+                /node_modules/,
+                /dist\//,
+                /build\//,
+                /\.d\.ts$/,
+            ];
+            return generatedPatterns.some((p) => p.test(w.file));
+        },
+    },
+    // 3. Single-use wrappers - not patterns
+    {
+        id: 'single-use',
+        name: 'Single Use',
+        description: 'Exclude wrappers used only once (not a pattern)',
+        applies: (w) => w.calledBy.length === 0,
+    },
+    // 4. Trivial wrappers - just re-exports
+    {
+        id: 'trivial-wrapper',
+        name: 'Trivial Wrapper',
+        description: 'Exclude wrappers that just re-export primitives',
+        applies: (w) => {
+            // If wrapper has only 1 primitive and no additional logic indicators
+            if (w.primitiveSignature.length !== 1)
+                return false;
+            if (w.isFactory || w.isHigherOrder || w.isDecorator)
+                return false;
+            // Check if name is just the primitive name with minor variation
+            const primName = w.primitiveSignature[0]?.toLowerCase() || '';
+            const wrapperName = w.name.toLowerCase();
+            return (wrapperName === primName ||
+                wrapperName === `my${primName}` ||
+                wrapperName === `custom${primName}` ||
+                wrapperName === `${primName}wrapper`);
+        },
+    },
+    // 5. Internal/private functions
+    {
+        id: 'internal-functions',
+        name: 'Internal Functions',
+        description: 'Exclude internal/private helper functions',
+        applies: (w) => {
+            const internalPatterns = [
+                /^_/,
+                /^__/,
+                /^internal/i,
+                /^private/i,
+                /^helper$/i,
+                /^util$/i,
+            ];
+            return internalPatterns.some((p) => p.test(w.name));
+        },
+    },
+    // 6. Lifecycle methods - framework-specific, not custom patterns
+    {
+        id: 'lifecycle-methods',
+        name: 'Lifecycle Methods',
+        description: 'Exclude framework lifecycle methods',
+        applies: (w) => {
+            const lifecyclePatterns = [
+                // React
+                /^componentDid/,
+                /^componentWill/,
+                /^shouldComponent/,
+                /^getDerived/,
+                /^getSnapshot/,
+                // Vue
+                /^on(Mounted|Updated|Unmounted|BeforeMount|BeforeUpdate|BeforeUnmount)/,
+                // Angular
+                /^ngOn/,
+                /^ngAfter/,
+                /^ngDo/,
+                // General
+                /^constructor$/,
+                /^init$/i,
+                /^destroy$/i,
+                /^dispose$/i,
+            ];
+            return lifecyclePatterns.some((p) => p.test(w.name));
+        },
+    },
+    // 7. Event handlers that just call primitives
+    {
+        id: 'simple-handlers',
+        name: 'Simple Event Handlers',
+        description: 'Exclude simple event handlers',
+        applies: (w) => {
+            const handlerPatterns = [
+                /^on[A-Z][a-z]+$/,
+                /^handle[A-Z][a-z]+$/,
+            ];
+            // Only exclude if it's a simple handler (depth 1, single primitive)
+            return (handlerPatterns.some((p) => p.test(w.name)) &&
+                w.depth === 1 &&
+                w.primitiveSignature.length === 1);
+        },
+    },
+];
+// =============================================================================
+// Exclusion Functions
+// =============================================================================
+/**
+ * Apply exclusion rules to wrappers
+ */
+export function applyExclusions(wrappers, rules = EXCLUSION_RULES) {
+    const excluded = [];
+    const included = [];
+    const reasons = new Map();
+    for (const wrapper of wrappers) {
+        let isExcluded = false;
+        let excludeReason = '';
+        for (const rule of rules) {
+            if (rule.applies(wrapper)) {
+                isExcluded = true;
+                excludeReason = rule.name;
+                break;
+            }
+        }
+        if (isExcluded) {
+            excluded.push(wrapper);
+            reasons.set(wrapper.qualifiedName, excludeReason);
+        }
+        else {
+            included.push(wrapper);
+        }
+    }
+    return { excluded, included, reasons };
+}
+/**
+ * Apply exclusions to clusters
+ */
+export function applyClusterExclusions(clusters, minClusterSize = 2, minConfidence = 0.3) {
+    return clusters.filter((cluster) => {
+        // Exclude clusters that are too small after exclusions
+        if (cluster.wrappers.length < minClusterSize)
+            return false;
+        // Exclude low-confidence clusters
+        if (cluster.confidence < minConfidence)
+            return false;
+        // Exclude clusters with only test files
+        const nonTestFiles = cluster.wrappers.filter((w) => !isTestFile(w.file));
+        if (nonTestFiles.length === 0)
+            return false;
+        return true;
+    });
+}
+/**
+ * Check if file is a test file
+ */
+function isTestFile(filePath) {
+    const testPatterns = [
+        /\.test\.[jt]sx?$/,
+        /\.spec\.[jt]sx?$/,
+        /_test\.(py|go|java|cs|php)$/,
+        /Test\.(java|cs)$/,
+        /Tests?\//,
+        /__tests__\//,
+        /test_.*\.py$/,
+    ];
+    return testPatterns.some((pattern) => pattern.test(filePath));
+}
+// =============================================================================
+// Language-Specific Exclusions
+// =============================================================================
+/**
+ * Get language-specific exclusion rules
+ */
+export function getLanguageExclusions(language) {
+    const baseRules = [...EXCLUSION_RULES];
+    switch (language) {
+        case 'typescript':
+            return [
+                ...baseRules,
+                {
+                    id: 'react-internal',
+                    name: 'React Internals',
+                    description: 'Exclude React internal patterns',
+                    applies: (w) => /^__REACT_/.test(w.name),
+                },
+            ];
+        case 'python':
+            return [
+                ...baseRules,
+                {
+                    id: 'dunder-methods',
+                    name: 'Dunder Methods',
+                    description: 'Exclude Python dunder methods',
+                    applies: (w) => /^__.*__$/.test(w.name),
+                },
+                {
+                    id: 'pytest-fixtures',
+                    name: 'Pytest Fixtures',
+                    description: 'Exclude pytest fixture functions (detected by naming)',
+                    applies: (w) => /^fixture_/.test(w.name) || /_fixture$/.test(w.name),
+                },
+            ];
+        case 'java':
+            return [
+                ...baseRules,
+                {
+                    id: 'spring-config',
+                    name: 'Spring Configuration',
+                    description: 'Exclude Spring configuration methods',
+                    applies: (w) => /^(configure|init|destroy|afterPropertiesSet)$/i.test(w.name) ||
+                        /Config(uration)?$/.test(w.file),
+                },
+            ];
+        case 'csharp':
+            return [
+                ...baseRules,
+                {
+                    id: 'aspnet-config',
+                    name: 'ASP.NET Configuration',
+                    description: 'Exclude ASP.NET configuration methods',
+                    applies: (w) => /^Configure(Services|App)?$/.test(w.name) ||
+                        /^Add[A-Z]/.test(w.name),
+                },
+            ];
+        case 'php':
+            return [
+                ...baseRules,
+                {
+                    id: 'laravel-magic',
+                    name: 'Laravel Magic Methods',
+                    description: 'Exclude Laravel magic methods',
+                    applies: (w) => /^(boot|register|handle)$/.test(w.name) ||
+                        /^scope[A-Z]/.test(w.name),
+                },
+            ];
+        default:
+            return baseRules;
+    }
+}
+// =============================================================================
+// Custom Rule Builder
+// =============================================================================
+/**
+ * Create a custom exclusion rule
+ */
+export function createExclusionRule(id, name, description, predicate) {
+    return {
+        id,
+        name,
+        description,
+        applies: predicate,
+    };
+}
+/**
+ * Create a name-based exclusion rule
+ */
+export function excludeByName(id, name, patterns) {
+    const regexPatterns = patterns.map((p) => typeof p === 'string' ? new RegExp(p, 'i') : p);
+    return {
+        id,
+        name,
+        description: `Exclude wrappers matching: ${patterns.join(', ')}`,
+        applies: (w) => regexPatterns.some((p) => p.test(w.name)),
+    };
+}
+/**
+ * Create a file-based exclusion rule
+ */
+export function excludeByFile(id, name, patterns) {
+    const regexPatterns = patterns.map((p) => typeof p === 'string' ? new RegExp(p, 'i') : p);
+    return {
+        id,
+        name,
+        description: `Exclude files matching: ${patterns.join(', ')}`,
+        applies: (w) => regexPatterns.some((p) => p.test(w.file)),
+    };
+}
+//# sourceMappingURL=exclusions.js.map

package/dist/wrappers/clustering/exclusions.js.map

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

package/dist/wrappers/clustering/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Wrapper Clustering Module
+ */
+export * from './clusterer.js';
+export * from './exclusions.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/wrappers/clustering/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/wrappers/clustering/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC"}

package/dist/wrappers/clustering/index.js

@@ -0,0 +1,6 @@
+/**
+ * Wrapper Clustering Module
+ */
+export * from './clusterer.js';
+export * from './exclusions.js';
+//# sourceMappingURL=index.js.map

package/dist/wrappers/clustering/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/wrappers/clustering/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC"}

package/dist/wrappers/detection/detector.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Wrapper Detection
+ *
+ * Detects functions that wrap framework primitives (direct and transitive).
+ */
+import type { DetectedPrimitive, WrapperFunction, SupportedLanguage } from '../types.js';
+export interface FunctionInfo {
+    name: string;
+    qualifiedName: string;
+    file: string;
+    startLine: number;
+    endLine: number;
+    language: SupportedLanguage;
+    isAsync: boolean;
+    returnType?: string | undefined;
+    parameters?: ParameterInfo[] | undefined;
+    decorators?: string[] | undefined;
+    calls: CallInfo[];
+}
+export interface ParameterInfo {
+    name: string;
+    type?: string | undefined;
+    defaultValue?: string | undefined;
+}
+export interface CallInfo {
+    calleeName: string;
+    calleeQualifiedName?: string;
+    line: number;
+    isCallback?: boolean;
+}
+export interface DetectionContext {
+    functions: FunctionInfo[];
+    primitives: DetectedPrimitive[];
+    language: SupportedLanguage;
+}
+export interface DetectionOptions {
+    maxDepth?: number | undefined;
+    includeTestFiles?: boolean | undefined;
+    minUsageCount?: number | undefined;
+}
+/**
+ * Detect all wrapper functions in the codebase
+ */
+export declare function detectWrappers(context: DetectionContext, options?: DetectionOptions): WrapperFunction[];
+/**
+ * Get wrappers by depth
+ */
+export declare function getWrappersByDepth(wrappers: WrapperFunction[]): Map<number, WrapperFunction[]>;
+/**
+ * Get wrappers that wrap a specific primitive
+ */
+export declare function getWrappersForPrimitive(wrappers: WrapperFunction[], primitiveName: string): WrapperFunction[];
+/**
+ * Get the wrapper call chain (from wrapper to primitives)
+ */
+export declare function getWrapperCallChain(wrapper: WrapperFunction, allWrappers: WrapperFunction[]): string[][];
+/**
+ * Calculate wrapper statistics
+ */
+export declare function calculateWrapperStats(wrappers: WrapperFunction[]): {
+    totalWrappers: number;
+    avgDepth: number;
+    maxDepth: number;
+    factoryCount: number;
+    higherOrderCount: number;
+    decoratorCount: number;
+    asyncCount: number;
+};
+//# sourceMappingURL=detector.d.ts.map

package/dist/wrappers/detection/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../../src/wrappers/detection/detector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAMrB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,UAAU,CAAC,EAAE,aAAa,EAAE,GAAG,SAAS,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAClC,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,QAAQ,EAAE,iBAAiB,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAkBD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,gBAAgB,EACzB,OAAO,GAAE,gBAAqB,GAC7B,eAAe,EAAE,CAmGnB;AA8ID;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAS9F;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,eAAe,EAAE,EAC3B,aAAa,EAAE,MAAM,GACpB,eAAe,EAAE,CAMnB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,eAAe,EACxB,WAAW,EAAE,eAAe,EAAE,GAC7B,MAAM,EAAE,EAAE,CAyBZ;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG;IAClE,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB,CAwBA"}