@nexus-ioc/graph-analyzer 0.1.0

package/dist/utils/validator.js

@@ -0,0 +1,252 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Validator = void 0;
+const tslib_1 = require("tslib");
+const node_child_process_1 = require("node:child_process");
+const fs = tslib_1.__importStar(require("node:fs"));
+const path = tslib_1.__importStar(require("node:path"));
+class Validator {
+    /**
+     * Validate that a file exists
+     */
+    static validateFileExists(filePath) {
+        const absolutePath = path.resolve(filePath);
+        if (!fs.existsSync(absolutePath)) {
+            return {
+                type: "FILE_NOT_FOUND",
+                message: `File not found: ${absolutePath}`,
+                suggestions: [
+                    "Check if the file path is correct",
+                    "Make sure you're in the project root directory",
+                    "Use an absolute path or relative path from current directory",
+                    `Current directory: ${process.cwd()}`,
+                ],
+                details: `Looking for: ${absolutePath}`,
+            };
+        }
+        return null;
+    }
+    /**
+     * Validate that a file has a valid TypeScript extension
+     */
+    static validateTypeScriptFile(filePath) {
+        const ext = path.extname(filePath).toLowerCase();
+        const validExtensions = [".ts", ".tsx"];
+        if (!validExtensions.includes(ext)) {
+            return {
+                type: "INVALID_FILE_EXTENSION",
+                message: `Invalid file extension: ${ext}`,
+                suggestions: [
+                    "Entry file must be a TypeScript file (.ts or .tsx)",
+                    `Provided file: ${filePath}`,
+                    "Example: graph-analyzer src/main.ts",
+                ],
+            };
+        }
+        return null;
+    }
+    /**
+     * Validate that a file is readable
+     */
+    static validateFileReadable(filePath) {
+        const absolutePath = path.resolve(filePath);
+        try {
+            fs.accessSync(absolutePath, fs.constants.R_OK);
+            return null;
+        }
+        catch (error) {
+            return {
+                type: "FILE_NOT_READABLE",
+                message: `Cannot read file: ${absolutePath}`,
+                suggestions: [
+                    "Check file permissions",
+                    "Make sure you have read access to the file",
+                    "Try running with appropriate permissions",
+                ],
+                details: error.message,
+            };
+        }
+    }
+    /**
+     * Validate that tsconfig.json exists if specified
+     */
+    static validateTsConfig(tsConfigPath) {
+        if (!tsConfigPath) {
+            return null; // Optional, so no error if not provided
+        }
+        const absolutePath = path.resolve(tsConfigPath);
+        if (!fs.existsSync(absolutePath)) {
+            return {
+                type: "TSCONFIG_NOT_FOUND",
+                message: `TypeScript configuration file not found: ${absolutePath}`,
+                suggestions: [
+                    "Check if tsconfig.json exists in your project",
+                    "Verify the path to tsconfig.json is correct",
+                    "Create a tsconfig.json file if it doesn't exist",
+                    "Omit the -c flag to auto-detect tsconfig.json",
+                ],
+                details: `Looking for: ${absolutePath}`,
+            };
+        }
+        // Validate it's a valid JSON file
+        try {
+            const content = fs.readFileSync(absolutePath, "utf8");
+            JSON.parse(content);
+            return null;
+        }
+        catch (error) {
+            return {
+                type: "INVALID_TSCONFIG",
+                message: `Invalid TypeScript configuration file: ${absolutePath}`,
+                suggestions: [
+                    "Check that tsconfig.json is valid JSON",
+                    "Fix any syntax errors in the file",
+                    "Validate your tsconfig.json using a JSON validator",
+                ],
+                details: error.message,
+            };
+        }
+    }
+    /**
+     * Check if Graphviz is installed (required for PNG generation)
+     */
+    static validateGraphvizInstalled(format) {
+        // Only check if PNG output is requested
+        if (format !== "png" && format !== "both" && format !== undefined) {
+            return null;
+        }
+        try {
+            const result = (0, node_child_process_1.spawnSync)("dot", ["-V"], {
+                stdio: "pipe",
+                encoding: "utf8",
+            });
+            // Graphviz returns version info on stderr
+            if (result.error || (!result.stdout && !result.stderr)) {
+                return {
+                    type: "GRAPHVIZ_NOT_FOUND",
+                    message: "Graphviz is not installed or not in PATH",
+                    suggestions: [
+                        "Install Graphviz to generate PNG visualizations",
+                        "",
+                        "Installation instructions:",
+                        "  • macOS: brew install graphviz",
+                        "  • Ubuntu/Debian: sudo apt-get install graphviz",
+                        "  • Windows: choco install graphviz",
+                        "  • Or download from: https://graphviz.org/download/",
+                        "",
+                        "Alternatively, use JSON or HTML format instead:",
+                        "  graph-analyzer -f json src/main.ts",
+                        "  graph-analyzer -f html src/main.ts",
+                    ],
+                };
+            }
+            return null;
+        }
+        catch (_error) {
+            return {
+                type: "GRAPHVIZ_NOT_FOUND",
+                message: "Graphviz is not installed or not in PATH",
+                suggestions: [
+                    "Install Graphviz to generate PNG visualizations",
+                    "",
+                    "Installation instructions:",
+                    "  • macOS: brew install graphviz",
+                    "  • Ubuntu/Debian: sudo apt-get install graphviz",
+                    "  • Windows: choco install graphviz",
+                    "  • Or download from: https://graphviz.org/download/",
+                    "",
+                    "Alternatively, use JSON or HTML format instead:",
+                    "  graph-analyzer -f json src/main.ts",
+                    "  graph-analyzer -f html src/main.ts",
+                ],
+            };
+        }
+    }
+    /**
+     * Validate entry file comprehensively
+     */
+    static validateEntryFile(filePath) {
+        // Check if file exists
+        const existsError = Validator.validateFileExists(filePath);
+        if (existsError)
+            return existsError;
+        // Check if it's a TypeScript file
+        const tsError = Validator.validateTypeScriptFile(filePath);
+        if (tsError)
+            return tsError;
+        // Check if file is readable
+        const readableError = Validator.validateFileReadable(filePath);
+        if (readableError)
+            return readableError;
+        return null;
+    }
+    /**
+     * Validate output directory is writable
+     */
+    static validateOutputDirectory(outputPath) {
+        const dir = path.dirname(path.resolve(outputPath));
+        // Check if directory exists
+        if (!fs.existsSync(dir)) {
+            try {
+                fs.mkdirSync(dir, { recursive: true });
+                return null;
+            }
+            catch (error) {
+                return {
+                    type: "OUTPUT_DIR_NOT_WRITABLE",
+                    message: `Cannot create output directory: ${dir}`,
+                    suggestions: [
+                        "Check that you have write permissions",
+                        "Verify the parent directory exists",
+                        "Try using a different output path",
+                    ],
+                    details: error.message,
+                };
+            }
+        }
+        // Check if directory is writable
+        try {
+            fs.accessSync(dir, fs.constants.W_OK);
+            return null;
+        }
+        catch (error) {
+            return {
+                type: "OUTPUT_DIR_NOT_WRITABLE",
+                message: `Output directory is not writable: ${dir}`,
+                suggestions: [
+                    "Check directory permissions",
+                    "Make sure you have write access to the directory",
+                    "Try running with appropriate permissions",
+                    "Use a different output directory",
+                ],
+                details: error.message,
+            };
+        }
+    }
+    /**
+     * Run all pre-flight validations
+     */
+    static runPreflightChecks(options) {
+        // Validate entry file
+        const entryError = Validator.validateEntryFile(options.entryFile);
+        if (entryError)
+            return entryError;
+        // Validate tsconfig if provided
+        const tsConfigError = Validator.validateTsConfig(options.tsConfig);
+        if (tsConfigError)
+            return tsConfigError;
+        // Validate Graphviz for PNG generation
+        const graphvizError = Validator.validateGraphvizInstalled(options.format);
+        if (graphvizError)
+            return graphvizError;
+        // Validate output directory if provided
+        if (options.output) {
+            const outputError = Validator.validateOutputDirectory(options.output);
+            if (outputError)
+                return outputError;
+        }
+        return null;
+    }
+}
+exports.Validator = Validator;
+//# sourceMappingURL=validator.js.map

package/dist/utils/validator.js.map

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

package/dist/visualize/generator.d.ts

@@ -0,0 +1,26 @@
+type ModuleInfo = {
+    name: string;
+    imports: string[];
+    exports: string[];
+    isGlobal: boolean;
+    providers: any[];
+    dependencies: string[];
+};
+type ModulesData = {
+    [key: string]: ModuleInfo;
+};
+export declare class GraphGenerator {
+    private readonly json;
+    private readonly outputPath;
+    constructor(json: ModulesData, outputPath: string);
+    private typeColors;
+    /**
+     * Escape special characters for DOT format
+     * Escapes quotes, backslashes, and newlines to prevent injection
+     */
+    private escapeDotString;
+    private generateDotGraph;
+    scan(): void;
+    protected ensureDirectoryExists(filePath: string): void;
+}
+export {};

package/dist/visualize/generator.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphGenerator = void 0;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+class GraphGenerator {
+    constructor(json, outputPath) {
+        this.json = json;
+        this.outputPath = outputPath;
+        this.typeColors = {
+            Class: "lightblue",
+            UseValue: "lightgreen",
+            UseFactory: "lightcoral",
+            UseClass: "lightyellow",
+        };
+    }
+    /**
+     * Escape special characters for DOT format
+     * Escapes quotes, backslashes, and newlines to prevent injection
+     */
+    escapeDotString(str) {
+        return str
+            .replace(/\\/g, "\\\\") // Escape backslashes first
+            .replace(/"/g, '\\"') // Escape quotes
+            .replace(/\n/g, "\\n") // Escape newlines
+            .replace(/\r/g, "\\r"); // Escape carriage returns
+    }
+    generateDotGraph() {
+        let dot = "digraph G {\n";
+        dot += "    node [shape=box];\n"; // Set node shape
+        dot += "    rankdir=LR;\n"; // Set horizontal graph direction
+        for (const [moduleName, moduleInfo] of Object.entries(this.json)) {
+            const escapedModuleName = this.escapeDotString(moduleName);
+            dot += `    "${escapedModuleName}" [label="${escapedModuleName}", style=filled, fillcolor="lightgray"];\n`;
+            if (moduleInfo.providers && moduleInfo.providers.length > 0) {
+                moduleInfo.providers.forEach((provider, index) => {
+                    const providerName = `${escapedModuleName}_Provider${index}`;
+                    const escapedToken = this.escapeDotString(provider.token);
+                    const escapedType = this.escapeDotString(provider.type);
+                    const providerLabel = `"${escapedToken} (${escapedType})"`;
+                    const color = this.typeColors[provider.type] || "white";
+                    dot += `    "${providerName}" [label=${providerLabel}, style=filled, fillcolor="${color}"];\n`;
+                    dot += `    "${escapedModuleName}" -> "${providerName}";\n`;
+                });
+            }
+            for (const imp of moduleInfo.imports) {
+                const escapedImp = this.escapeDotString(imp);
+                dot += `    "${escapedModuleName}" -> "${escapedImp}";\n`;
+            }
+        }
+        dot += "}\n";
+        return dot;
+    }
+    scan() {
+        const dotGraph = this.generateDotGraph();
+        this.ensureDirectoryExists(this.outputPath);
+        const dotProcess = (0, node_child_process_1.spawnSync)("dot", ["-Tpng", "-o", this.outputPath], {
+            input: dotGraph,
+            encoding: "utf-8",
+        });
+        if (dotProcess.error) {
+            console.error("Error running dot command:", dotProcess.error);
+        }
+        else {
+            console.log(`Graph visualized as ${this.outputPath}`);
+        }
+    }
+    ensureDirectoryExists(filePath) {
+        const dir = (0, node_path_1.dirname)(filePath);
+        (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+    }
+}
+exports.GraphGenerator = GraphGenerator;
+//# sourceMappingURL=generator.js.map

package/dist/visualize/generator.js.map

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

package/dist/visualize/graph-analyzer.d.ts

@@ -0,0 +1,126 @@
+import type { GraphOutput } from "../interfaces/graph-output.interface";
+import type { ParseEntryFile } from "../parser/parse-entry-file";
+import type { ParseNsModule } from "../parser/parse-ns-module";
+import { type HtmlGeneratorOptions } from "./html-generator";
+/**
+ * Options for configuring GraphAnalyzer output
+ */
+export interface GraphAnalyzerOptions {
+    /** Output format: 'json', 'png', 'html', or 'both' (default: 'both') */
+    outputFormat?: "json" | "png" | "html" | "both";
+    /** Output file path (used when format is not 'both') */
+    outputPath?: string;
+    /** JSON output file path (default: './graph.json') */
+    jsonOutputPath?: string;
+    /** PNG output file path (default: './graph.png') */
+    pngOutputPath?: string;
+    /** HTML output file path (default: './graph.html') */
+    htmlOutputPath?: string;
+    /** HTML generator options */
+    htmlOptions?: HtmlGeneratorOptions;
+    /** Enable circular dependency detection (default: false) */
+    checkCircular?: boolean;
+    /** Enable unused provider detection (default: false) */
+    checkUnused?: boolean;
+    /** Enable module depth analysis (default: false) */
+    checkDepth?: boolean;
+    /** Threshold for identifying deep modules (default: 5) */
+    deepModuleThreshold?: number;
+    /** Enable provider scope analysis (default: false) */
+    checkScope?: boolean;
+}
+/**
+ * Main analyzer class for dependency injection graphs
+ *
+ * Analyzes Nexus IoC dependency graphs and generates JSON and/or PNG outputs.
+ *
+ * @example
+ * ```typescript
+ * const analyzer = new GraphAnalyzer(modulesGraph, 'src/main.ts', {
+ *   outputFormat: 'json',
+ *   jsonOutputPath: './output/graph.json'
+ * });
+ *
+ * const output = analyzer.parse();
+ * console.log(`Found ${output.metadata.totalProviders} providers`);
+ * ```
+ */
+export declare class GraphAnalyzer {
+    private readonly graph;
+    private readonly entryPoint;
+    private readonly options;
+    /**
+     * Create a new GraphAnalyzer instance
+     *
+     * @param graph - Map of module names to parsed modules
+     * @param entryPoint - Path to application entry point file
+     * @param options - Configuration options for output generation
+     */
+    constructor(graph: Map<string, ParseNsModule | ParseEntryFile>, entryPoint: string, options?: GraphAnalyzerOptions);
+    /**
+     * Parse the dependency graph and generate output based on configured format
+     *
+     * @returns GraphOutput object if format is 'json', 'html', or 'both', void if format is 'png'
+     *
+     * @example
+     * ```typescript
+     * // Generate JSON only
+     * const output = analyzer.parse();
+     *
+     * // Generate PNG only
+     * analyzer.parse(); // Returns void
+     *
+     * // Generate HTML only
+     * analyzer.parse(); // Returns void
+     *
+     * // Generate both JSON and PNG
+     * const output = analyzer.parse(); // Returns GraphOutput and creates PNG
+     * ```
+     */
+    parse(): GraphOutput | undefined;
+    /**
+     * Generate JSON output of the dependency graph
+     *
+     * Creates a structured JSON representation of all modules, providers, and dependencies.
+     * Optionally writes the output to a file if jsonOutputPath or outputPath is configured.
+     *
+     * @returns GraphOutput object containing modules, providers, and metadata
+     *
+     * @example
+     * ```typescript
+     * const output = analyzer.generateJson();
+     * console.log(`Total modules: ${output.metadata.totalModules}`);
+     * console.log(`Total providers: ${output.metadata.totalProviders}`);
+     * ```
+     */
+    generateJson(): GraphOutput;
+    /**
+     * Generate PNG visualization of the dependency graph using Graphviz
+     *
+     * Creates a visual graph representation showing modules as nodes and dependencies as edges.
+     * Requires Graphviz to be installed on the system.
+     *
+     * @throws Error if Graphviz is not installed or graph generation fails
+     *
+     * @example
+     * ```typescript
+     * analyzer.generatePng();
+     * // Creates graph.png in the configured output path
+     * ```
+     */
+    generatePng(): void;
+    /**
+     * Generate interactive HTML visualization of the dependency graph
+     *
+     * Creates an interactive HTML page with a graph visualization using Cytoscape.js.
+     * The HTML includes zoom/pan controls, node details, search functionality, and
+     * clickable file paths that open in your IDE.
+     *
+     * @example
+     * ```typescript
+     * analyzer.generateHtml();
+     * // Creates graph.html in the configured output path
+     * ```
+     */
+    generateHtml(): void;
+}