@nexus-ioc/graph-analyzer 0.1.0

package/dist/config/config-loader.js

@@ -0,0 +1,205 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfigFile = loadConfigFile;
+exports.findConfigFile = findConfigFile;
+exports.loadConfig = loadConfig;
+exports.generateConfigFile = generateConfigFile;
+const tslib_1 = require("tslib");
+const fs = tslib_1.__importStar(require("node:fs"));
+const path = tslib_1.__importStar(require("node:path"));
+const config_schema_1 = require("./config-schema");
+/**
+ * Configuration file names to search for (in order of priority)
+ */
+const CONFIG_FILE_NAMES = [
+    ".graph-analyzer.json",
+    "graph-analyzer.config.json",
+    "graph-analyzer.config.js",
+];
+/**
+ * Loads configuration from a file
+ * @param configPath - Path to configuration file
+ * @returns Parsed configuration object
+ * @throws Error if file cannot be read or parsed
+ */
+function loadConfigFile(configPath) {
+    if (!fs.existsSync(configPath)) {
+        throw new Error(`Configuration file not found: ${configPath}`);
+    }
+    const ext = path.extname(configPath);
+    try {
+        if (ext === ".json") {
+            return loadJsonConfig(configPath);
+        }
+        if (ext === ".js") {
+            return loadJsConfig(configPath);
+        }
+        throw new Error(`Unsupported configuration file format: ${ext}. Use .json or .js`);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new Error(`Failed to load configuration: ${error.message}`);
+        }
+        throw error;
+    }
+}
+/**
+ * Loads JSON configuration file
+ */
+function loadJsonConfig(configPath) {
+    const content = fs.readFileSync(configPath, "utf8");
+    const config = JSON.parse(content);
+    const errors = (0, config_schema_1.validateConfig)(config);
+    if (errors.length > 0) {
+        throw new Error(`Invalid configuration:\n${errors.map((e) => `  - ${e}`).join("\n")}`);
+    }
+    return config;
+}
+/**
+ * Loads JavaScript configuration file
+ */
+function loadJsConfig(configPath) {
+    // Clear require cache to allow reloading
+    delete require.cache[path.resolve(configPath)];
+    // biome-ignore lint/security/noGlobalEval: Configuration files need to be evaluated
+    const config = require(path.resolve(configPath));
+    // Handle both module.exports and default export
+    const actualConfig = config.default || config;
+    const errors = (0, config_schema_1.validateConfig)(actualConfig);
+    if (errors.length > 0) {
+        throw new Error(`Invalid configuration:\n${errors.map((e) => `  - ${e}`).join("\n")}`);
+    }
+    return actualConfig;
+}
+/**
+ * Searches for a configuration file in the current directory and parent directories
+ * @param startDir - Directory to start searching from
+ * @returns Path to configuration file or null if not found
+ */
+function findConfigFile(startDir = process.cwd()) {
+    let currentDir = path.resolve(startDir);
+    while (true) {
+        // Check each config file name in order
+        for (const fileName of CONFIG_FILE_NAMES) {
+            const configPath = path.join(currentDir, fileName);
+            if (fs.existsSync(configPath)) {
+                return configPath;
+            }
+        }
+        // Move to parent directory
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir) {
+            // Reached root directory
+            break;
+        }
+        currentDir = parentDir;
+    }
+    return null;
+}
+/**
+ * Loads configuration from file or returns empty config if not found
+ * @param configPath - Optional explicit path to config file
+ * @param searchDir - Directory to start searching for config file
+ * @returns Configuration object
+ */
+function loadConfig(configPath, searchDir) {
+    // If explicit path provided, use it
+    if (configPath) {
+        return loadConfigFile(configPath);
+    }
+    // Otherwise search for config file
+    const foundPath = findConfigFile(searchDir);
+    if (foundPath) {
+        return loadConfigFile(foundPath);
+    }
+    // No config file found, return empty config
+    return {};
+}
+/**
+ * Generates a default configuration file
+ * @param outputPath - Path where to write the config file
+ * @param format - Format of the config file (json or js)
+ */
+function generateConfigFile(outputPath, format = "json") {
+    const dir = path.dirname(outputPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    if (format === "json") {
+        const config = {
+            $schema: "Configuration for @nexus-ioc/graph-analyzer - see https://github.com/Isqanderm/ioc/tree/main/packages/graph-analyzer",
+            entryFile: "src/main.ts",
+            tsConfig: "./tsconfig.json",
+            output: "./graph",
+            format: "both",
+            ideProtocol: "vscode",
+            darkTheme: false,
+            verbose: false,
+            quiet: false,
+        };
+        fs.writeFileSync(outputPath, JSON.stringify(config, null, 2), "utf8");
+    }
+    else {
+        const jsContent = `/**
+ * Configuration for @nexus-ioc/graph-analyzer
+ * @see https://github.com/Isqanderm/ioc/tree/main/packages/graph-analyzer
+ */
+module.exports = {
+  /**
+   * Path to the entry point file
+   * @type {string}
+   */
+  entryFile: 'src/main.ts',
+
+  /**
+   * Path to tsconfig.json
+   * @type {string}
+   */
+  tsConfig: './tsconfig.json',
+
+  /**
+   * Output file path (extension will be added based on format)
+   * @type {string}
+   */
+  output: './graph',
+
+  /**
+   * Output format: 'json', 'png', 'html', or 'both'
+   * @type {'json' | 'png' | 'html' | 'both'}
+   * @default 'both'
+   */
+  format: 'both',
+
+  /**
+   * IDE protocol for clickable links in HTML output
+   * @type {'vscode' | 'webstorm' | 'idea'}
+   * @default 'vscode'
+   */
+  ideProtocol: 'vscode',
+
+  /**
+   * Use dark theme for HTML output
+   * @type {boolean}
+   * @default false
+   */
+  darkTheme: false,
+
+  /**
+   * Show detailed progress information
+   * @type {boolean}
+   * @default false
+   */
+  verbose: false,
+
+  /**
+   * Suppress all output except errors
+   * @type {boolean}
+   * @default false
+   */
+  quiet: false,
+};
+`;
+        fs.writeFileSync(outputPath, jsContent, "utf8");
+    }
+}
+//# sourceMappingURL=config-loader.js.map

package/dist/config/config-loader.js.map

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

package/dist/config/config-schema.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Configuration schema for graph-analyzer
+ */
+export interface GraphAnalyzerConfig {
+    /**
+     * Path to the entry point file
+     */
+    entryFile?: string;
+    /**
+     * Path to tsconfig.json
+     */
+    tsConfig?: string;
+    /**
+     * Output file path
+     */
+    output?: string;
+    /**
+     * Output format: json, png, html, or both
+     * @default "both"
+     */
+    format?: "json" | "png" | "html" | "both";
+    /**
+     * IDE protocol for clickable links in HTML output
+     * @default "vscode"
+     */
+    ideProtocol?: "vscode" | "webstorm" | "idea";
+    /**
+     * Use dark theme for HTML output
+     * @default false
+     */
+    darkTheme?: boolean;
+    /**
+     * Show detailed progress information
+     * @default false
+     */
+    verbose?: boolean;
+    /**
+     * Suppress all output except errors
+     * @default false
+     */
+    quiet?: boolean;
+    /**
+     * Detect circular dependencies in modules and providers
+     * @default false
+     */
+    checkCircular?: boolean;
+    /**
+     * Detect providers that are registered but never injected
+     * @default false
+     */
+    checkUnused?: boolean;
+    /**
+     * Analyze module hierarchy depth and complexity metrics
+     * @default false
+     */
+    checkDepth?: boolean;
+    /**
+     * Threshold for identifying deep modules
+     * @default 5
+     */
+    deepModuleThreshold?: number;
+    /**
+     * Analyze provider scopes and detect scope mismatches
+     * @default false
+     */
+    checkScope?: boolean;
+}
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_CONFIG: Partial<GraphAnalyzerConfig>;
+/**
+ * Validates a configuration object
+ * @param config - Configuration to validate
+ * @returns Array of validation errors (empty if valid)
+ */
+export declare function validateConfig(config: unknown): string[];
+/**
+ * Merges multiple configuration objects with priority (later configs override earlier ones)
+ * @param configs - Configuration objects to merge
+ * @returns Merged configuration
+ */
+export declare function mergeConfigs(...configs: Array<Partial<GraphAnalyzerConfig>>): Partial<GraphAnalyzerConfig>;

package/dist/config/config-schema.js

@@ -0,0 +1,97 @@
+"use strict";
+/**
+ * Configuration schema for graph-analyzer
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONFIG = void 0;
+exports.validateConfig = validateConfig;
+exports.mergeConfigs = mergeConfigs;
+/**
+ * Default configuration values
+ */
+exports.DEFAULT_CONFIG = {
+    format: "both",
+    ideProtocol: "vscode",
+    darkTheme: false,
+    verbose: false,
+    quiet: false,
+    checkCircular: false,
+    checkUnused: false,
+    checkDepth: false,
+    deepModuleThreshold: 5,
+    checkScope: false,
+};
+/**
+ * Validates a configuration object
+ * @param config - Configuration to validate
+ * @returns Array of validation errors (empty if valid)
+ */
+function validateConfig(config) {
+    const errors = [];
+    if (typeof config !== "object" || config === null) {
+        errors.push("Configuration must be an object");
+        return errors;
+    }
+    const cfg = config;
+    // Validate format
+    if (cfg.format !== undefined) {
+        const validFormats = ["json", "png", "html", "both"];
+        if (!validFormats.includes(cfg.format)) {
+            errors.push(`Invalid format: ${cfg.format}. Must be one of: ${validFormats.join(", ")}`);
+        }
+    }
+    // Validate ideProtocol
+    if (cfg.ideProtocol !== undefined) {
+        const validProtocols = ["vscode", "webstorm", "idea"];
+        if (!validProtocols.includes(cfg.ideProtocol)) {
+            errors.push(`Invalid ideProtocol: ${cfg.ideProtocol}. Must be one of: ${validProtocols.join(", ")}`);
+        }
+    }
+    // Validate boolean fields
+    const booleanFields = [
+        "darkTheme",
+        "verbose",
+        "quiet",
+        "checkCircular",
+        "checkUnused",
+        "checkDepth",
+        "checkScope",
+    ];
+    for (const field of booleanFields) {
+        if (cfg[field] !== undefined && typeof cfg[field] !== "boolean") {
+            errors.push(`${field} must be a boolean`);
+        }
+    }
+    // Validate number fields
+    if (cfg.deepModuleThreshold !== undefined &&
+        (typeof cfg.deepModuleThreshold !== "number" || cfg.deepModuleThreshold < 1)) {
+        errors.push("deepModuleThreshold must be a positive number");
+    }
+    // Validate string fields
+    const stringFields = ["entryFile", "tsConfig", "output"];
+    for (const field of stringFields) {
+        if (cfg[field] !== undefined && typeof cfg[field] !== "string") {
+            errors.push(`${field} must be a string`);
+        }
+    }
+    return errors;
+}
+/**
+ * Merges multiple configuration objects with priority (later configs override earlier ones)
+ * @param configs - Configuration objects to merge
+ * @returns Merged configuration
+ */
+function mergeConfigs(...configs) {
+    const merged = {};
+    for (const config of configs) {
+        for (const key in config) {
+            const value = config[key];
+            if (value !== undefined) {
+                // biome-ignore lint/suspicious/noExplicitAny: Dynamic config merging
+                merged[key] = value;
+            }
+        }
+    }
+    return merged;
+}
+//# sourceMappingURL=config-schema.js.map

package/dist/config/config-schema.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @packageDocumentation
+ * Nexus IoC Graph Analyzer - Static analysis tool for dependency injection graphs
+ *
+ * This package provides tools to analyze and visualize Nexus IoC dependency injection graphs
+ * without executing code. It uses TypeScript's AST to extract metadata about modules, providers,
+ * and their dependencies.
+ *
+ * @example
+ * ```typescript
+ * import { GraphAnalyzer, ParseEntryFile, ParseTsConfig } from 'graph-analyzer';
+ *
+ * // Parse entry file
+ * const tsConfig = new ParseTsConfig(configContent, basePath);
+ * const entryFile = new ParseEntryFile(sourceFile, 'src/main.ts', tsConfig);
+ * entryFile.parse();
+ *
+ * // Build graph and analyze
+ * const graph = new Map();
+ * graph.set('entry', entryFile);
+ *
+ * const analyzer = new GraphAnalyzer(graph, 'src/main.ts', {
+ *   outputFormat: 'json'
+ * });
+ *
+ * const output = analyzer.parse();
+ * ```
+ */
+export type { GraphMetadata, GraphOutput, ModuleInfo, ProviderInfo, } from "./interfaces/graph-output.interface";
+export type { ProvidersInterface } from "./interfaces/providers.interface";
+export type { Dependency } from "./parser/dependency-extractor";
+export { DependencyExtractor } from "./parser/dependency-extractor";
+export { ParseEntryFile } from "./parser/parse-entry-file";
+export { ParseNsModule } from "./parser/parse-ns-module";
+export { ParseTsConfig } from "./parser/parse-ts-config";
+export { GraphGenerator } from "./visualize/generator";
+export type { GraphAnalyzerOptions } from "./visualize/graph-analyzer";
+export { GraphAnalyzer } from "./visualize/graph-analyzer";
+export type { HtmlGeneratorOptions } from "./visualize/html-generator";
+export { HtmlGenerator } from "./visualize/html-generator";
+export { JsonFormatter } from "./visualize/json-formatter";

package/dist/index.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * @packageDocumentation
+ * Nexus IoC Graph Analyzer - Static analysis tool for dependency injection graphs
+ *
+ * This package provides tools to analyze and visualize Nexus IoC dependency injection graphs
+ * without executing code. It uses TypeScript's AST to extract metadata about modules, providers,
+ * and their dependencies.
+ *
+ * @example
+ * ```typescript
+ * import { GraphAnalyzer, ParseEntryFile, ParseTsConfig } from 'graph-analyzer';
+ *
+ * // Parse entry file
+ * const tsConfig = new ParseTsConfig(configContent, basePath);
+ * const entryFile = new ParseEntryFile(sourceFile, 'src/main.ts', tsConfig);
+ * entryFile.parse();
+ *
+ * // Build graph and analyze
+ * const graph = new Map();
+ * graph.set('entry', entryFile);
+ *
+ * const analyzer = new GraphAnalyzer(graph, 'src/main.ts', {
+ *   outputFormat: 'json'
+ * });
+ *
+ * const output = analyzer.parse();
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonFormatter = exports.HtmlGenerator = exports.GraphAnalyzer = exports.GraphGenerator = exports.ParseTsConfig = exports.ParseNsModule = exports.ParseEntryFile = exports.DependencyExtractor = void 0;
+var dependency_extractor_1 = require("./parser/dependency-extractor");
+Object.defineProperty(exports, "DependencyExtractor", { enumerable: true, get: function () { return dependency_extractor_1.DependencyExtractor; } });
+// Parser exports
+var parse_entry_file_1 = require("./parser/parse-entry-file");
+Object.defineProperty(exports, "ParseEntryFile", { enumerable: true, get: function () { return parse_entry_file_1.ParseEntryFile; } });
+var parse_ns_module_1 = require("./parser/parse-ns-module");
+Object.defineProperty(exports, "ParseNsModule", { enumerable: true, get: function () { return parse_ns_module_1.ParseNsModule; } });
+var parse_ts_config_1 = require("./parser/parse-ts-config");
+Object.defineProperty(exports, "ParseTsConfig", { enumerable: true, get: function () { return parse_ts_config_1.ParseTsConfig; } });
+var generator_1 = require("./visualize/generator");
+Object.defineProperty(exports, "GraphGenerator", { enumerable: true, get: function () { return generator_1.GraphGenerator; } });
+// Main exports for programmatic use
+var graph_analyzer_1 = require("./visualize/graph-analyzer");
+Object.defineProperty(exports, "GraphAnalyzer", { enumerable: true, get: function () { return graph_analyzer_1.GraphAnalyzer; } });
+var html_generator_1 = require("./visualize/html-generator");
+Object.defineProperty(exports, "HtmlGenerator", { enumerable: true, get: function () { return html_generator_1.HtmlGenerator; } });
+var json_formatter_1 = require("./visualize/json-formatter");
+Object.defineProperty(exports, "JsonFormatter", { enumerable: true, get: function () { return json_formatter_1.JsonFormatter; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;;AAWH,sEAAoE;AAA3D,2HAAA,mBAAmB,OAAA;AAC5B,iBAAiB;AACjB,8DAA2D;AAAlD,kHAAA,cAAc,OAAA;AACvB,4DAAyD;AAAhD,gHAAA,aAAa,OAAA;AACtB,4DAAyD;AAAhD,gHAAA,aAAa,OAAA;AACtB,mDAAuD;AAA9C,2GAAA,cAAc,OAAA;AAEvB,oCAAoC;AACpC,6DAA2D;AAAlD,+GAAA,aAAa,OAAA;AAEtB,6DAA2D;AAAlD,+GAAA,aAAa,OAAA;AACtB,6DAA2D;AAAlD,+GAAA,aAAa,OAAA"}

package/dist/interfaces/graph-output.interface.d.ts

@@ -0,0 +1,126 @@
+import type { CircularDependency } from "../analyzer/circular-dependency-detector";
+import type { DepthLevel, ModuleDepthInfo } from "../analyzer/module-depth-analyzer";
+import type { ProviderScopeInfo, ScopeMismatch } from "../analyzer/provider-scope-analyzer";
+import type { UnusedProvider } from "../analyzer/unused-provider-detector";
+import type { Dependency } from "../parser/dependency-extractor";
+/**
+ * Complete dependency graph output format
+ *
+ * This is the main output structure returned by the graph analyzer.
+ * It contains all information about modules, providers, and their dependencies.
+ */
+export interface GraphOutput {
+    /** Array of all modules in the dependency graph */
+    modules: ModuleInfo[];
+    /** Array of all providers across all modules */
+    providers: ProviderInfo[];
+    /** Metadata about the analysis run */
+    metadata: GraphMetadata;
+    /** Analysis results (optional, only included when analysis is enabled) */
+    analysis?: GraphAnalysis;
+}
+/**
+ * Analysis results for the dependency graph
+ *
+ * Contains results from various analysis features like circular dependency detection,
+ * unused provider detection, module depth analysis, and provider scope analysis.
+ */
+export interface GraphAnalysis {
+    /** Circular dependency analysis results */
+    circularDependencies?: CircularDependency[];
+    /** Unused provider analysis results */
+    unusedProviders?: UnusedProvider[];
+    /** Module depth analysis results */
+    depthAnalysis?: {
+        /** Maximum depth in the module hierarchy */
+        maxDepth: number;
+        /** Average depth across all modules */
+        averageDepth: number;
+        /** Total number of modules analyzed */
+        totalModules: number;
+        /** Modules at each depth level */
+        depthLevels: DepthLevel[];
+        /** Detailed information for each module */
+        moduleDetails: ModuleDepthInfo[];
+        /** Modules with excessive depth (potential code smell) */
+        deepModules: ModuleDepthInfo[];
+        /** Threshold used for identifying deep modules */
+        deepModuleThreshold: number;
+    };
+    /** Provider scope analysis results */
+    scopeAnalysis?: {
+        /** Total number of providers analyzed */
+        totalProviders: number;
+        /** Number of singleton providers */
+        singletonProviders: number;
+        /** Number of request-scoped providers */
+        requestProviders: number;
+        /** Scope mismatches detected */
+        scopeMismatches: ScopeMismatch[];
+        /** All provider scope information */
+        providerScopes: ProviderScopeInfo[];
+    };
+}
+/**
+ * Metadata about the dependency graph analysis
+ *
+ * Contains information about when and how the analysis was performed,
+ * along with summary statistics.
+ */
+export interface GraphMetadata {
+    /** Path to the application entry point file */
+    entryPoint: string;
+    /** Name of the root module */
+    rootModule: string;
+    /** ISO timestamp of when the analysis was performed */
+    analyzedAt: string;
+    /** Version of the graph analyzer */
+    version: string;
+    /** Total number of modules in the graph */
+    totalModules: number;
+    /** Total number of providers across all modules */
+    totalProviders: number;
+}
+/**
+ * Information about a single module in the dependency graph
+ *
+ * Represents a Nexus IoC module decorated with @NsModule.
+ */
+export interface ModuleInfo {
+    /** Module name (class name) */
+    name: string;
+    /** File path where the module is defined */
+    path: string;
+    /** Names of modules imported by this module */
+    imports: string[];
+    /** Tokens of providers exported by this module */
+    exports: string[];
+    /** Tokens of providers registered in this module */
+    providers: string[];
+    /** Whether this module is marked as global */
+    isGlobal: boolean;
+}
+/**
+ * Information about a single provider in the dependency graph
+ *
+ * Represents a provider registered in a Nexus IoC module.
+ * Can be a class, value, factory, or class-based provider.
+ */
+export interface ProviderInfo {
+    /** Provider token (identifier used for injection) */
+    token: string;
+    /** Type of provider */
+    type: "Class" | "UseValue" | "UseFactory" | "UseClass";
+    /** Name of the module that registers this provider */
+    module: string;
+    /** Lifecycle scope of the provider (only for class providers) */
+    scope?: "Singleton" | "Request" | "Transient";
+    /** Dependencies required by this provider */
+    dependencies: Dependency[];
+    /** Static value (only for UseValue providers) */
+    value?: string;
+    /** Factory function name (only for UseFactory providers) */
+    factory?: string;
+    /** Implementation class name (only for UseClass providers) */
+    useClass?: string;
+}

package/dist/interfaces/graph-output.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=graph-output.interface.js.map

package/dist/interfaces/graph-output.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-output.interface.js","sourceRoot":"","sources":["../../src/interfaces/graph-output.interface.ts"],"names":[],"mappings":""}

package/dist/interfaces/providers.interface.d.ts

@@ -0,0 +1,10 @@
+import type { Dependency } from "../parser/dependency-extractor";
+export interface ProvidersInterface {
+    parse(): this;
+    token: string | null;
+    value?: string | null;
+    scope?: string | null;
+    inject?: string[];
+    type: string;
+    dependencies?: Dependency[];
+}

package/dist/interfaces/providers.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=providers.interface.js.map

package/dist/interfaces/providers.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.interface.js","sourceRoot":"","sources":["../../src/interfaces/providers.interface.ts"],"names":[],"mappings":""}