@monodog/utils 1.0.0

package/helpers.d.ts

@@ -0,0 +1,87 @@
+export interface PackageInfo {
+    name: string;
+    version: string;
+    type: string;
+    path: string;
+    dependencies: Record<string, string>;
+    devDependencies: Record<string, string>;
+    peerDependencies: Record<string, string>;
+    scripts: Record<string, string>;
+    maintainers: string[];
+    description?: string;
+    license?: string;
+    repository?: Record<string, string>;
+}
+export interface DependencyInfo {
+    name: string;
+    version: string;
+    type: 'dependency' | 'devDependency' | 'peerDependency';
+    latest?: string;
+    status?: 'up-to-date' | 'outdated' | 'major-update' | 'unknown';
+    outdated?: boolean;
+}
+export interface PackageHealth {
+    buildStatus: 'success' | 'failed' | 'running' | 'unknown';
+    testCoverage: number;
+    lintStatus: 'pass' | 'fail' | 'unknown';
+    securityAudit: 'pass' | 'fail' | 'unknown';
+    overallScore: number;
+}
+export interface MonorepoStats {
+    totalPackages: number;
+    apps: number;
+    libraries: number;
+    tools: number;
+    healthyPackages: number;
+    warningPackages: number;
+    errorPackages: number;
+    outdatedDependencies: number;
+    totalDependencies: number;
+}
+/**
+ * Scans the monorepo and returns information about all packages
+ */
+declare function scanMonorepo(rootDir: string): PackageInfo[];
+/**
+ * Analyzes dependencies and determines their status
+ */
+/**
+ * Calculates package health score based on various metrics
+ */
+declare function calculatePackageHealth(buildStatus: PackageHealth['buildStatus'], testCoverage: number, lintStatus: PackageHealth['lintStatus'], securityAudit: PackageHealth['securityAudit']): PackageHealth;
+/**
+ * Generates comprehensive monorepo statistics
+ */
+declare function generateMonorepoStats(packages: PackageInfo[]): MonorepoStats;
+/**
+ * Finds circular dependencies in the monorepo
+ */
+declare function findCircularDependencies(packages: PackageInfo[]): string[][];
+/**
+ * Generates a dependency graph for visualization
+ */
+declare function generateDependencyGraph(packages: PackageInfo[]): {
+    nodes: {
+        label: string;
+        type: string;
+        version: string;
+        dependencies: number;
+    }[];
+    edges: {
+        from: string;
+        to: string;
+        type: string;
+    }[];
+};
+/**
+ * Checks if a package has outdated dependencies
+ */
+declare function checkOutdatedDependencies(packageInfo: PackageInfo): DependencyInfo[];
+/**
+ * Gets package size information
+ */
+declare function getPackageSize(packagePath: string): {
+    size: number;
+    files: number;
+};
+export { scanMonorepo, generateMonorepoStats, findCircularDependencies, generateDependencyGraph, checkOutdatedDependencies, getPackageSize, calculatePackageHealth, };

package/helpers.js

@@ -0,0 +1,333 @@
+// import { Package } from '@prisma/client';
+import * as fs from 'fs';
+import path from 'path';
+/**
+ * Scans the monorepo and returns information about all packages
+ */
+function scanMonorepo(rootDir) {
+    const packages = [];
+    console.log('rootDir', rootDir);
+    // Scan packages directory
+    const packagesDir = path.join(rootDir, 'packages');
+    if (fs.existsSync(packagesDir)) {
+        const packageDirs = fs
+            .readdirSync(packagesDir, { withFileTypes: true })
+            .filter(dirent => dirent.isDirectory())
+            .map(dirent => dirent.name);
+        for (const packageName of packageDirs) {
+            const packagePath = path.join(packagesDir, packageName);
+            const packageInfo = parsePackageInfo(packagePath, packageName);
+            if (packageInfo) {
+                packages.push(packageInfo);
+            }
+        }
+    }
+    // Scan apps directory
+    const appsDir = path.join(rootDir, 'apps');
+    if (fs.existsSync(appsDir)) {
+        const appDirs = fs
+            .readdirSync(appsDir, { withFileTypes: true })
+            .filter(dirent => dirent.isDirectory())
+            .map(dirent => dirent.name);
+        for (const appName of appDirs) {
+            const appPath = path.join(appsDir, appName);
+            const appInfo = parsePackageInfo(appPath, appName, 'app');
+            if (appInfo) {
+                packages.push(appInfo);
+            }
+        }
+    }
+    // Scan libs directory
+    const libsDir = path.join(rootDir, 'libs');
+    if (fs.existsSync(libsDir)) {
+        const libDirs = fs
+            .readdirSync(libsDir, { withFileTypes: true })
+            .filter(dirent => dirent.isDirectory())
+            .map(dirent => dirent.name);
+        for (const libName of libDirs) {
+            const libPath = path.join(libsDir, libName);
+            const libInfo = parsePackageInfo(libPath, libName, 'lib');
+            if (libInfo) {
+                packages.push(libInfo);
+            }
+        }
+    }
+    return packages;
+}
+/*** Parses package.json and determines package type */
+function parsePackageInfo(packagePath, packageName, forcedType) {
+    const packageJsonPath = path.join(packagePath, 'package.json');
+    if (!fs.existsSync(packageJsonPath)) {
+        return null;
+    }
+    try {
+        const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+        // Determine package type
+        let packageType = 'lib';
+        if (forcedType) {
+            packageType = forcedType;
+        }
+        else if (packageJson.scripts && packageJson.scripts.start) {
+            packageType = 'app';
+        }
+        else if (packageJson.keywords && packageJson.keywords.includes('tool')) {
+            packageType = 'tool';
+        }
+        return {
+            name: packageJson.name || packageName,
+            version: packageJson.version || '0.0.0',
+            type: packageType,
+            path: packagePath,
+            dependencies: packageJson.dependencies || {},
+            devDependencies: packageJson.devDependencies || {},
+            peerDependencies: packageJson.peerDependencies || {},
+            scripts: packageJson.scripts || {},
+            maintainers: packageJson.maintainers || [],
+            description: packageJson.description,
+            license: packageJson.license,
+            repository: packageJson.repository || {},
+        };
+    }
+    catch (error) {
+        console.error(`Error parsing package.json for ${packageName}:`, error);
+        return null;
+    }
+}
+/**
+ * Analyzes dependencies and determines their status
+ */
+// function analyzeDependencies(
+//   dependencies: Record<string, string>,
+//   type: 'production' | 'development' = 'production'
+// ): DependencyInfo[] {
+//   return Object.entries(dependencies).map(([name, version]) => ({
+//     name,
+//     currentVersion: version,
+//     status: 'unknown', // Would be determined by npm registry check
+//     type,
+//   }));
+// }
+/**
+ * Calculates package health score based on various metrics
+ */
+function calculatePackageHealth(buildStatus, testCoverage, lintStatus, securityAudit) {
+    let score = 0;
+    // Build status (30 points)
+    switch (buildStatus) {
+        case 'success':
+            score += 30;
+            break;
+        case 'running':
+            score += 15;
+            break;
+        case 'failed':
+            score += 0;
+            break;
+        default:
+            score += 10;
+    }
+    // Test coverage (25 points)
+    score += Math.min(25, (testCoverage / 100) * 25);
+    // Lint status (25 points)
+    switch (lintStatus) {
+        case 'pass':
+            score += 25;
+            break;
+        case 'fail':
+            score += 0;
+            break;
+        default:
+            score += 10;
+    }
+    // Security audit (20 points)
+    switch (securityAudit) {
+        case 'pass':
+            score += 20;
+            break;
+        case 'fail':
+            score += 0;
+            break;
+        default:
+            score += 10;
+    }
+    return {
+        buildStatus,
+        testCoverage,
+        lintStatus,
+        securityAudit,
+        overallScore: Math.round(score),
+    };
+}
+/**
+ * Generates comprehensive monorepo statistics
+ */
+function generateMonorepoStats(packages) {
+    const stats = {
+        totalPackages: packages.length,
+        apps: packages.filter(p => p.type === 'app').length,
+        libraries: packages.filter(p => p.type === 'lib').length,
+        tools: packages.filter(p => p.type === 'tool').length,
+        healthyPackages: 0,
+        warningPackages: 0,
+        errorPackages: 0,
+        outdatedDependencies: 0,
+        totalDependencies: 0,
+    };
+    // Calculate dependency counts
+    packages.forEach(pkg => {
+        stats.totalDependencies += Object.keys(pkg.dependencies).length;
+        stats.totalDependencies += Object.keys(pkg.devDependencies).length;
+        stats.totalDependencies += Object.keys(pkg.peerDependencies ?? {}).length;
+    });
+    return stats;
+}
+/**
+ * Finds circular dependencies in the monorepo
+ */
+function findCircularDependencies(packages) {
+    const graph = new Map();
+    const visited = new Set();
+    const recursionStack = new Set();
+    const circularDeps = [];
+    // Build dependency graph
+    packages.forEach(pkg => {
+        graph.set(pkg.name, Object.keys(pkg.dependencies));
+    });
+    function dfs(node, path) {
+        if (recursionStack.has(node)) {
+            const cycleStart = path.indexOf(node);
+            circularDeps.push(path.slice(cycleStart));
+            return;
+        }
+        if (visited.has(node)) {
+            return;
+        }
+        visited.add(node);
+        recursionStack.add(node);
+        path.push(node);
+        const dependencies = graph.get(node) || [];
+        for (const dep of dependencies) {
+            if (graph.has(dep)) {
+                dfs(dep, [...path]);
+            }
+        }
+        recursionStack.delete(node);
+    }
+    for (const node of graph.keys()) {
+        if (!visited.has(node)) {
+            dfs(node, []);
+        }
+    }
+    return circularDeps;
+}
+/**
+ * Generates a dependency graph for visualization
+ */
+function generateDependencyGraph(packages) {
+    const nodes = packages.map(pkg => ({
+        // id: pkg.name,
+        label: pkg.name,
+        type: pkg.type,
+        version: pkg.version,
+        dependencies: Object.keys(pkg.dependencies).length,
+    }));
+    const edges = [];
+    packages.forEach(pkg => {
+        Object.keys(pkg.dependencies).forEach(depName => {
+            // Only include internal dependencies
+            if (packages.some(p => p.name === depName)) {
+                edges.push({
+                    from: pkg.name,
+                    to: depName,
+                    type: 'internal',
+                });
+            }
+        });
+    });
+    return { nodes, edges };
+}
+/**
+ * Checks if a package has outdated dependencies
+ */
+function checkOutdatedDependencies(packageInfo) {
+    const outdated = [];
+    // This would typically involve checking against npm registry
+    // For now, we'll simulate with some basic checks
+    Object.entries(packageInfo.dependencies).forEach(([name, version]) => {
+        if (version.startsWith('^') || version.startsWith('~')) {
+            // Could be outdated, would need registry check
+            outdated.push({
+                name,
+                version: version,
+                status: 'unknown',
+                type: 'dependency',
+            });
+        }
+    });
+    return outdated;
+}
+/**
+ * Formats version numbers for comparison
+ */
+// function parseVersion(version: string): number[] {
+//   return version
+//     .replace(/^[^0-9]*/, '')
+//     .split('.')
+//     .map(Number);
+// }
+/**
+ * Compares two version strings
+ */
+// function compareVersions(v1: string, v2: string): number {
+//   const parsed1 = parseVersion(v1);
+//   const parsed2 = parseVersion(v2);
+//   for (let i = 0; i < Math.max(parsed1.length, parsed2.length); i++) {
+//     const num1 = parsed1[i] || 0;
+//     const num2 = parsed2[i] || 0;
+//     if (num1 > num2) return 1;
+//     if (num1 < num2) return -1;
+//   }
+//   return 0;
+// }
+/**
+ * Gets package size information
+ */
+function getPackageSize(packagePath) {
+    try {
+        let totalSize = 0;
+        let fileCount = 0;
+        const calculateSize = (dirPath) => {
+            const items = fs.readdirSync(dirPath, { withFileTypes: true });
+            for (const item of items) {
+                const fullPath = path.join(dirPath, item.name);
+                if (item.isDirectory()) {
+                    // Skip node_modules and other build artifacts
+                    if (!['node_modules', 'dist', 'build', '.git'].includes(item.name)) {
+                        calculateSize(fullPath);
+                    }
+                }
+                else {
+                    try {
+                        const stats = fs.statSync(fullPath);
+                        totalSize += stats.size;
+                        fileCount++;
+                    }
+                    catch (error) {
+                        // Skip files we can't read
+                    }
+                }
+            }
+        };
+        calculateSize(packagePath);
+        return {
+            size: totalSize,
+            files: fileCount,
+        };
+    }
+    catch (error) {
+        return { size: 0, files: 0 };
+    }
+}
+export { scanMonorepo, generateMonorepoStats, findCircularDependencies, generateDependencyGraph, checkOutdatedDependencies, getPackageSize, 
+// analyzeDependencies,
+calculatePackageHealth, };

package/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["helpers.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAobE,oCAAY;AACZ,sDAAqB;AACrB,4DAAwB;AACxB,0DAAuB;AACvB,8DAAyB;AACzB,wCAAc;AAEd,wDAAsB;AA3bxB,4CAA4C;AAC5C,uCAAyB;AACzB,gDAAwB;AAmDxB;;GAEG;AACH,SAAS,YAAY,CAAC,OAAe;IACnC,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAChC,0BAA0B;IAC1B,MAAM,WAAW,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACnD,IAAI,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/B,MAAM,WAAW,GAAG,EAAE;aACnB,WAAW,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aACjD,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;aACtC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAE9B,KAAK,MAAM,WAAW,IAAI,WAAW,EAAE,CAAC;YACtC,MAAM,WAAW,GAAG,cAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;YACxD,MAAM,WAAW,GAAG,gBAAgB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;YAC/D,IAAI,WAAW,EAAE,CAAC;gBAChB,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,MAAM,OAAO,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3C,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,EAAE;aACf,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aAC7C,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;aACtC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAE9B,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;YAC1D,IAAI,OAAO,EAAE,CAAC;gBACZ,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,MAAM,OAAO,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3C,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,EAAE;aACf,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aAC7C,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;aACtC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAE9B,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;YAC1D,IAAI,OAAO,EAAE,CAAC;gBACZ,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,uDAAuD;AACvD,SAAS,gBAAgB,CACvB,WAAmB,EACnB,WAAmB,EACnB,UAAmC;IAEnC,MAAM,eAAe,GAAG,cAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAE/D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC;QAEzE,yBAAyB;QACzB,IAAI,WAAW,GAA2B,KAAK,CAAC;QAChD,IAAI,UAAU,EAAE,CAAC;YACf,WAAW,GAAG,UAAU,CAAC;QAC3B,CAAC;aAAM,IAAI,WAAW,CAAC,OAAO,IAAI,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC5D,WAAW,GAAG,KAAK,CAAC;QACtB,CAAC;aAAM,IAAI,WAAW,CAAC,QAAQ,IAAI,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACzE,WAAW,GAAG,MAAM,CAAC;QACvB,CAAC;QAED,OAAO;YACL,IAAI,EAAE,WAAW,CAAC,IAAI,IAAI,WAAW;YACrC,OAAO,EAAE,WAAW,CAAC,OAAO,IAAI,OAAO;YACvC,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,WAAW;YACjB,YAAY,EAAE,WAAW,CAAC,YAAY,IAAI,EAAE;YAC5C,eAAe,EAAE,WAAW,CAAC,eAAe,IAAI,EAAE;YAClD,gBAAgB,EAAE,WAAW,CAAC,gBAAgB,IAAI,EAAE;YACpD,OAAO,EAAE,WAAW,CAAC,OAAO,IAAI,EAAE;YAClC,WAAW,EAAE,WAAW,CAAC,WAAW,IAAI,EAAE;YAC1C,WAAW,EAAE,WAAW,CAAC,WAAW;YACpC,OAAO,EAAE,WAAW,CAAC,OAAO;YAC5B,UAAU,EAAE,WAAW,CAAC,UAAU,IAAI,EAAE;SACzC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,kCAAkC,WAAW,GAAG,EAAE,KAAK,CAAC,CAAC;QACvE,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,gCAAgC;AAChC,0CAA0C;AAC1C,sDAAsD;AACtD,wBAAwB;AACxB,oEAAoE;AACpE,YAAY;AACZ,+BAA+B;AAC/B,sEAAsE;AACtE,YAAY;AACZ,SAAS;AACT,IAAI;AAEJ;;GAEG;AACH,SAAS,sBAAsB,CAC7B,WAAyC,EACzC,YAAoB,EACpB,UAAuC,EACvC,aAA6C;IAE7C,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,2BAA2B;IAC3B,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,SAAS;YACZ,KAAK,IAAI,EAAE,CAAC;YACZ,MAAM;QACR,KAAK,SAAS;YACZ,KAAK,IAAI,EAAE,CAAC;YACZ,MAAM;QACR,KAAK,QAAQ;YACX,KAAK,IAAI,CAAC,CAAC;YACX,MAAM;QACR;YACE,KAAK,IAAI,EAAE,CAAC;IAChB,CAAC;IAED,4BAA4B;IAC5B,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,YAAY,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;IAEjD,0BAA0B;IAC1B,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,MAAM;YACT,KAAK,IAAI,EAAE,CAAC;YACZ,MAAM;QACR,KAAK,MAAM;YACT,KAAK,IAAI,CAAC,CAAC;YACX,MAAM;QACR;YACE,KAAK,IAAI,EAAE,CAAC;IAChB,CAAC;IAED,6BAA6B;IAC7B,QAAQ,aAAa,EAAE,CAAC;QACtB,KAAK,MAAM;YACT,KAAK,IAAI,EAAE,CAAC;YACZ,MAAM;QACR,KAAK,MAAM;YACT,KAAK,IAAI,CAAC,CAAC;YACX,MAAM;QACR;YACE,KAAK,IAAI,EAAE,CAAC;IAChB,CAAC;IAED,OAAO;QACL,WAAW;QACX,YAAY;QACZ,UAAU;QACV,aAAa;QACb,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;KAChC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAAC,QAAuB;IACpD,MAAM,KAAK,GAAkB;QAC3B,aAAa,EAAE,QAAQ,CAAC,MAAM;QAC9B,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,MAAM;QACnD,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,MAAM;QACxD,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,MAAM;QACrD,eAAe,EAAE,CAAC;QAClB,eAAe,EAAE,CAAC;QAClB,aAAa,EAAE,CAAC;QAChB,oBAAoB,EAAE,CAAC;QACvB,iBAAiB,EAAE,CAAC;KACrB,CAAC;IAEF,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;QACrB,KAAK,CAAC,iBAAiB,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC;QAChE,KAAK,CAAC,iBAAiB,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC;QACnE,KAAK,CAAC,iBAAiB,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,wBAAwB,CAAC,QAAuB;IACvD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC1C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,MAAM,YAAY,GAAe,EAAE,CAAC;IAEpC,yBAAyB;IACzB,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;QACrB,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,SAAS,GAAG,CAAC,IAAY,EAAE,IAAc;QACvC,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACtC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;YAC1C,OAAO;QACT,CAAC;QAED,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEhB,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC3C,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;YAC/B,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnB,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QAED,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QAChC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,SAAS,uBAAuB,CAAC,QAAuB;IACtD,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjC,gBAAgB;QAChB,KAAK,EAAE,GAAG,CAAC,IAAI;QACf,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,MAAM;KACnD,CAAC,CAAC,CAAC;IAEJ,MAAM,KAAK,GAAsD,EAAE,CAAC;IAEpE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;QACrB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;YAC9C,qCAAqC;YACrC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,EAAE,CAAC;gBAC3C,KAAK,CAAC,IAAI,CAAC;oBACT,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,EAAE,EAAE,OAAO;oBACX,IAAI,EAAE,UAAU;iBACjB,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAS,yBAAyB,CAAC,WAAwB;IACzD,MAAM,QAAQ,GAAqB,EAAE,CAAC;IAEtC,6DAA6D;IAC7D,iDAAiD;IACjD,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE;QACnE,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACvD,+CAA+C;YAC/C,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI;gBACJ,OAAO,EAAE,OAAO;gBAChB,MAAM,EAAE,SAAS;gBACjB,IAAI,EAAE,YAAY;aACnB,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,qDAAqD;AACrD,mBAAmB;AACnB,+BAA+B;AAC/B,kBAAkB;AAClB,oBAAoB;AACpB,IAAI;AAEJ;;GAEG;AACH,6DAA6D;AAC7D,sCAAsC;AACtC,sCAAsC;AAEtC,yEAAyE;AACzE,oCAAoC;AACpC,oCAAoC;AAEpC,iCAAiC;AACjC,kCAAkC;AAClC,MAAM;AAEN,cAAc;AACd,IAAI;AAEJ;;GAEG;AACH,SAAS,cAAc,CAAC,WAAmB;IAIzC,IAAI,CAAC;QACH,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,SAAS,GAAG,CAAC,CAAC;QAElB,MAAM,aAAa,GAAG,CAAC,OAAe,EAAQ,EAAE;YAC9C,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAE/D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBAE/C,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;oBACvB,8CAA8C;oBAC9C,IAAI,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;wBACnE,aAAa,CAAC,QAAQ,CAAC,CAAC;oBAC1B,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC;wBACH,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;wBACpC,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC;wBACxB,SAAS,EAAE,CAAC;oBACd,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,2BAA2B;oBAC7B,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC,CAAA;QAED,aAAa,CAAC,WAAW,CAAC,CAAC;QAE3B,OAAO;YACL,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,SAAS;SACjB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAC/B,CAAC;AACH,CAAC"}

package/helpers.ts

@@ -0,0 +1,445 @@
+// import { Package } from '@prisma/client';
+import * as fs from 'fs';
+import path from 'path';
+
+export interface PackageInfo {
+  name: string;
+  version: string;
+  type: string; //'app' | 'lib' | 'tool';
+  path: string;
+  dependencies: Record<string, string>;
+  devDependencies: Record<string, string>;
+  peerDependencies: Record<string, string>;
+  scripts: Record<string, string>;
+  maintainers: string[];
+  description?: string;
+  license?: string;
+  repository?: Record<string, string>;
+}
+
+export interface DependencyInfo {
+  // name: string;
+  // currentVersion: string;
+  // latestVersion?: string;
+  // status: 'up-to-date' | 'outdated' | 'major-update' | 'unknown';
+  // type: 'production' | 'development';
+  name: string;
+  version: string;
+  type: 'dependency' | 'devDependency' | 'peerDependency';
+  latest?: string;
+  status?: 'up-to-date' | 'outdated' | 'major-update' | 'unknown';
+  outdated?: boolean;
+}
+
+export interface PackageHealth {
+  buildStatus: 'success' | 'failed' | 'running' | 'unknown';
+  testCoverage: number;
+  lintStatus: 'pass' | 'fail' | 'unknown';
+  securityAudit: 'pass' | 'fail' | 'unknown';
+  overallScore: number;
+}
+
+export interface MonorepoStats {
+  totalPackages: number;
+  apps: number;
+  libraries: number;
+  tools: number;
+  healthyPackages: number;
+  warningPackages: number;
+  errorPackages: number;
+  outdatedDependencies: number;
+  totalDependencies: number;
+}
+
+/**
+ * Scans the monorepo and returns information about all packages
+ */
+function scanMonorepo(rootDir: string): PackageInfo[] {
+  const packages: PackageInfo[] = [];
+  console.log('rootDir', rootDir);
+  // Scan packages directory
+  const packagesDir = path.join(rootDir, 'packages');
+  if (fs.existsSync(packagesDir)) {
+    const packageDirs = fs
+      .readdirSync(packagesDir, { withFileTypes: true })
+      .filter(dirent => dirent.isDirectory())
+      .map(dirent => dirent.name);
+
+    for (const packageName of packageDirs) {
+      const packagePath = path.join(packagesDir, packageName);
+      const packageInfo = parsePackageInfo(packagePath, packageName);
+      if (packageInfo) {
+        packages.push(packageInfo);
+      }
+    }
+  }
+
+  // Scan apps directory
+  const appsDir = path.join(rootDir, 'apps');
+  if (fs.existsSync(appsDir)) {
+    const appDirs = fs
+      .readdirSync(appsDir, { withFileTypes: true })
+      .filter(dirent => dirent.isDirectory())
+      .map(dirent => dirent.name);
+
+    for (const appName of appDirs) {
+      const appPath = path.join(appsDir, appName);
+      const appInfo = parsePackageInfo(appPath, appName, 'app');
+      if (appInfo) {
+        packages.push(appInfo);
+      }
+    }
+  }
+
+  // Scan libs directory
+  const libsDir = path.join(rootDir, 'libs');
+  if (fs.existsSync(libsDir)) {
+    const libDirs = fs
+      .readdirSync(libsDir, { withFileTypes: true })
+      .filter(dirent => dirent.isDirectory())
+      .map(dirent => dirent.name);
+
+    for (const libName of libDirs) {
+      const libPath = path.join(libsDir, libName);
+      const libInfo = parsePackageInfo(libPath, libName, 'lib');
+      if (libInfo) {
+        packages.push(libInfo);
+      }
+    }
+  }
+
+  return packages;
+}
+
+/*** Parses package.json and determines package type */
+function parsePackageInfo(
+  packagePath: string,
+  packageName: string,
+  forcedType?: 'app' | 'lib' | 'tool'
+): PackageInfo | null {
+  const packageJsonPath = path.join(packagePath, 'package.json');
+
+  if (!fs.existsSync(packageJsonPath)) {
+    return null;
+  }
+
+  try {
+    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+
+    // Determine package type
+    let packageType: 'app' | 'lib' | 'tool' = 'lib';
+    if (forcedType) {
+      packageType = forcedType;
+    } else if (packageJson.scripts && packageJson.scripts.start) {
+      packageType = 'app';
+    } else if (packageJson.keywords && packageJson.keywords.includes('tool')) {
+      packageType = 'tool';
+    }
+
+    return {
+      name: packageJson.name || packageName,
+      version: packageJson.version || '0.0.0',
+      type: packageType,
+      path: packagePath,
+      dependencies: packageJson.dependencies || {},
+      devDependencies: packageJson.devDependencies || {},
+      peerDependencies: packageJson.peerDependencies || {},
+      scripts: packageJson.scripts || {},
+      maintainers: packageJson.maintainers || [],
+      description: packageJson.description,
+      license: packageJson.license,
+      repository: packageJson.repository || {},
+    };
+  } catch (error) {
+    console.error(`Error parsing package.json for ${packageName}:`, error);
+    return null;
+  }
+}
+
+/**
+ * Analyzes dependencies and determines their status
+ */
+// function analyzeDependencies(
+//   dependencies: Record<string, string>,
+//   type: 'production' | 'development' = 'production'
+// ): DependencyInfo[] {
+//   return Object.entries(dependencies).map(([name, version]) => ({
+//     name,
+//     currentVersion: version,
+//     status: 'unknown', // Would be determined by npm registry check
+//     type,
+//   }));
+// }
+
+/**
+ * Calculates package health score based on various metrics
+ */
+function calculatePackageHealth(
+  buildStatus: PackageHealth['buildStatus'],
+  testCoverage: number,
+  lintStatus: PackageHealth['lintStatus'],
+  securityAudit: PackageHealth['securityAudit']
+): PackageHealth {
+  let score = 0;
+
+  // Build status (30 points)
+  switch (buildStatus) {
+    case 'success':
+      score += 30;
+      break;
+    case 'running':
+      score += 15;
+      break;
+    case 'failed':
+      score += 0;
+      break;
+    default:
+      score += 10;
+  }
+
+  // Test coverage (25 points)
+  score += Math.min(25, (testCoverage / 100) * 25);
+
+  // Lint status (25 points)
+  switch (lintStatus) {
+    case 'pass':
+      score += 25;
+      break;
+    case 'fail':
+      score += 0;
+      break;
+    default:
+      score += 10;
+  }
+
+  // Security audit (20 points)
+  switch (securityAudit) {
+    case 'pass':
+      score += 20;
+      break;
+    case 'fail':
+      score += 0;
+      break;
+    default:
+      score += 10;
+  }
+
+  return {
+    buildStatus,
+    testCoverage,
+    lintStatus,
+    securityAudit,
+    overallScore: Math.round(score),
+  };
+}
+
+/**
+ * Generates comprehensive monorepo statistics
+ */
+function generateMonorepoStats(packages: PackageInfo[]): MonorepoStats {
+  const stats: MonorepoStats = {
+    totalPackages: packages.length,
+    apps: packages.filter(p => p.type === 'app').length,
+    libraries: packages.filter(p => p.type === 'lib').length,
+    tools: packages.filter(p => p.type === 'tool').length,
+    healthyPackages: 0,
+    warningPackages: 0,
+    errorPackages: 0,
+    outdatedDependencies: 0,
+    totalDependencies: 0,
+  };
+
+  // Calculate dependency counts
+  packages.forEach(pkg => {
+    stats.totalDependencies += Object.keys(pkg.dependencies).length;
+    stats.totalDependencies += Object.keys(pkg.devDependencies).length;
+    stats.totalDependencies += Object.keys(pkg.peerDependencies ?? {}).length;
+  });
+
+  return stats;
+}
+
+/**
+ * Finds circular dependencies in the monorepo
+ */
+function findCircularDependencies(packages: PackageInfo[]): string[][] {
+  const graph = new Map<string, string[]>();
+  const visited = new Set<string>();
+  const recursionStack = new Set<string>();
+  const circularDeps: string[][] = [];
+
+  // Build dependency graph
+  packages.forEach(pkg => {
+    graph.set(pkg.name, Object.keys(pkg.dependencies));
+  });
+
+  function dfs(node: string, path: string[]): void {
+    if (recursionStack.has(node)) {
+      const cycleStart = path.indexOf(node);
+      circularDeps.push(path.slice(cycleStart));
+      return;
+    }
+
+    if (visited.has(node)) {
+      return;
+    }
+
+    visited.add(node);
+    recursionStack.add(node);
+    path.push(node);
+
+    const dependencies = graph.get(node) || [];
+    for (const dep of dependencies) {
+      if (graph.has(dep)) {
+        dfs(dep, [...path]);
+      }
+    }
+
+    recursionStack.delete(node);
+  }
+
+  for (const node of graph.keys()) {
+    if (!visited.has(node)) {
+      dfs(node, []);
+    }
+  }
+
+  return circularDeps;
+}
+
+/**
+ * Generates a dependency graph for visualization
+ */
+function generateDependencyGraph(packages: PackageInfo[]) {
+  const nodes = packages.map(pkg => ({
+    // id: pkg.name,
+    label: pkg.name,
+    type: pkg.type,
+    version: pkg.version,
+    dependencies: Object.keys(pkg.dependencies).length,
+  }));
+
+  const edges: Array<{ from: string; to: string; type: string }> = [];
+
+  packages.forEach(pkg => {
+    Object.keys(pkg.dependencies).forEach(depName => {
+      // Only include internal dependencies
+      if (packages.some(p => p.name === depName)) {
+        edges.push({
+          from: pkg.name,
+          to: depName,
+          type: 'internal',
+        });
+      }
+    });
+  });
+
+  return { nodes, edges };
+}
+
+/**
+ * Checks if a package has outdated dependencies
+ */
+function checkOutdatedDependencies(packageInfo: PackageInfo): DependencyInfo[] {
+  const outdated: DependencyInfo[] = [];
+
+  // This would typically involve checking against npm registry
+  // For now, we'll simulate with some basic checks
+  Object.entries(packageInfo.dependencies).forEach(([name, version]) => {
+    if (version.startsWith('^') || version.startsWith('~')) {
+      // Could be outdated, would need registry check
+      outdated.push({
+        name,
+        version: version,
+        status: 'unknown',
+        type: 'dependency',
+      });
+    }
+  });
+
+  return outdated;
+}
+
+/**
+ * Formats version numbers for comparison
+ */
+// function parseVersion(version: string): number[] {
+//   return version
+//     .replace(/^[^0-9]*/, '')
+//     .split('.')
+//     .map(Number);
+// }
+
+/**
+ * Compares two version strings
+ */
+// function compareVersions(v1: string, v2: string): number {
+//   const parsed1 = parseVersion(v1);
+//   const parsed2 = parseVersion(v2);
+
+//   for (let i = 0; i < Math.max(parsed1.length, parsed2.length); i++) {
+//     const num1 = parsed1[i] || 0;
+//     const num2 = parsed2[i] || 0;
+
+//     if (num1 > num2) return 1;
+//     if (num1 < num2) return -1;
+//   }
+
+//   return 0;
+// }
+
+/**
+ * Gets package size information
+ */
+function getPackageSize(packagePath: string): {
+  size: number;
+  files: number;
+} {
+  try {
+    let totalSize = 0;
+    let fileCount = 0;
+
+    const calculateSize = (dirPath: string): void => {
+      const items = fs.readdirSync(dirPath, { withFileTypes: true });
+
+      for (const item of items) {
+        const fullPath = path.join(dirPath, item.name);
+
+        if (item.isDirectory()) {
+          // Skip node_modules and other build artifacts
+          if (!['node_modules', 'dist', 'build', '.git'].includes(item.name)) {
+            calculateSize(fullPath);
+          }
+        } else {
+          try {
+            const stats = fs.statSync(fullPath);
+            totalSize += stats.size;
+            fileCount++;
+          } catch (error) {
+            // Skip files we can't read
+          }
+        }
+      }
+    }
+
+    calculateSize(packagePath);
+
+    return {
+      size: totalSize,
+      files: fileCount,
+    };
+  } catch (error) {
+    return { size: 0, files: 0 };
+  }
+}
+
+export {
+  scanMonorepo,
+  generateMonorepoStats,
+  findCircularDependencies,
+  generateDependencyGraph,
+  checkOutdatedDependencies,
+  getPackageSize,
+  // analyzeDependencies,
+  calculatePackageHealth,
+};

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@monodog/utils",
+  "version": "1.0.0",
+  "description": "Shared utility functions for monodog monorepo dashboard",
+  "main": "dist/index.js",
+  "type": "module",
+  "types": "dist/index.d.ts",
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc --build",
+    "test": "jest",
+    "clean": "rm -rf dist node_modules/.cache"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.2.2"
+  }
+}

package/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  // Extends the shared Node configuration for server/utility environments
+  "extends": "@lakinmindfire/tsconfig/node.json",
+
+  "compilerOptions": {
+    // Output compilation results to the 'dist' directory
+    "outDir": "dist",
+    "declaration": true,
+    "sourceMap": true,
+    "esModuleInterop": true,
+    "module": "CommonJS",
+    "moduleResolution": "node",
+    "verbatimModuleSyntax": false,
+    "downlevelIteration": true,
+  },
+
+  // Include all TypeScript files in the 'src' folder
+  "include": ["index.ts", "helpers.ts"],
+
+  // Exclude node_modules and the output directory
+  "exclude": ["node_modules", "dist", "**/*.test.ts"]
+}