driftdetect-core 0.4.0 → 0.4.2

package/dist/call-graph/analysis/graph-builder.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Call Graph Builder
+ *
+ * Builds the complete call graph from extracted file information.
+ * Handles function registration, call resolution, and graph construction.
+ */
+import type { CallGraph, FileExtractionResult } from '../types.js';
+import type { DataAccessPoint } from '../../boundaries/types.js';
+/**
+ * Options for building the call graph
+ */
+export interface GraphBuilderOptions {
+    /** Project root directory */
+    projectRoot: string;
+    /** Whether to include unresolved calls */
+    includeUnresolved?: boolean;
+    /** Minimum confidence for resolution */
+    minConfidence?: number;
+}
+/**
+ * Call Graph Builder
+ */
+export declare class GraphBuilder {
+    private functions;
+    private classes;
+    private imports;
+    private pendingCalls;
+    private dataAccessPoints;
+    private options;
+    constructor(options: GraphBuilderOptions);
+    /**
+     * Add extraction results from a file
+     */
+    addFile(extraction: FileExtractionResult): void;
+    /**
+     * Add data access points for a file
+     */
+    addDataAccess(file: string, accessPoints: DataAccessPoint[]): void;
+    /**
+     * Build the complete call graph
+     */
+    build(): CallGraph;
+    /**
+     * Create a FunctionNode from extraction
+     */
+    private createFunctionNode;
+    /**
+     * Store calls for later resolution
+     */
+    private storePendingCalls;
+    /**
+     * Find the function containing a given line
+     * Includes parameter default values (which are before the body)
+     */
+    private findContainingFunction;
+    /**
+     * Resolve all pending calls
+     */
+    private resolveAllCalls;
+    /**
+     * Resolve a call to its target function(s)
+     */
+    private resolveCall;
+    /**
+     * Resolve Dependency Injection patterns
+     * Handles: FastAPI Depends(), Flask inject, Spring @Autowired, etc.
+     */
+    private resolveDependencyInjection;
+    /**
+     * Find a local function in the same file
+     * Prioritizes nested functions within the caller's scope
+     */
+    private findLocalFunction;
+    /**
+     * Find method by receiver type
+     */
+    private findMethodByReceiver;
+    /**
+     * Try to resolve a receiver to a class name
+     */
+    private resolveReceiverType;
+    /**
+     * Check if a class exists
+     */
+    private classExists;
+    /**
+     * Find an imported function
+     */
+    private findImportedFunction;
+    /**
+     * Find functions by name (fuzzy match)
+     */
+    private findByName;
+    /**
+     * Create a CallSite from extraction and resolution
+     */
+    private createCallSite;
+    /**
+     * Associate data access points with functions
+     */
+    private associateDataAccess;
+    /**
+     * Find function at a specific line
+     */
+    private findFunctionAtLine;
+    /**
+     * Identify entry points (exported functions, API handlers, main)
+     *
+     * Entry points are functions that can be called from outside the codebase:
+     * - Exported module functions
+     * - API route handlers (detected by decorators/attributes)
+     * - Main/entry functions
+     * - Controller methods in web frameworks
+     */
+    private identifyEntryPoints;
+    /**
+     * Check if a function is an API route handler based on decorators/attributes
+     */
+    private isApiRouteHandler;
+    /**
+     * Check if a function is a controller method (for frameworks without decorators)
+     *
+     * This handles:
+     * - PHP Laravel controllers (public methods in classes extending Controller)
+     * - Ruby Rails controllers
+     * - Other MVC frameworks
+     */
+    private isControllerMethod;
+    /**
+     * Identify functions with direct data access
+     */
+    private identifyDataAccessors;
+    /**
+     * Calculate graph statistics
+     */
+    private calculateStats;
+    /**
+     * Generate a unique function ID
+     */
+    private generateFunctionId;
+}
+//# sourceMappingURL=graph-builder.d.ts.map

package/dist/call-graph/analysis/graph-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-builder.d.ts","sourceRoot":"","sources":["../../../src/call-graph/analysis/graph-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,SAAS,EAGT,oBAAoB,EAOrB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,OAAO,CAA2C;IAC1D,OAAO,CAAC,OAAO,CAA8C;IAC7D,OAAO,CAAC,YAAY,CAAgG;IACpH,OAAO,CAAC,gBAAgB,CAA6C;IACrE,OAAO,CAAC,OAAO,CAAsB;gBAEzB,OAAO,EAAE,mBAAmB;IAQxC;;OAEG;IACH,OAAO,CAAC,UAAU,EAAE,oBAAoB,GAAG,IAAI;IAsB/C;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,GAAG,IAAI;IAIlE;;OAEG;IACH,KAAK,IAAI,SAAS;IA2BlB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA6B1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsBzB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAyB9B;;OAEG;IACH,OAAO,CAAC,eAAe;IA2BvB;;OAEG;IACH,OAAO,CAAC,WAAW;IAkEnB;;;OAGG;IACH,OAAO,CAAC,0BAA0B;IA2DlC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IA0DzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA+B5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAuB3B;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAsB5B;;OAEG;IACH,OAAO,CAAC,UAAU;IAYlB;;OAEG;IACH,OAAO,CAAC,cAAc;IAsBtB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAY3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;;;;;;;OAQG;IACH,OAAO,CAAC,mBAAmB;IA+B3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsCzB;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;IAyC1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;OAEG;IACH,OAAO,CAAC,cAAc;IAgCtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAG3B"}