appclean 1.8.0

package/logo.svg

@@ -0,0 +1,60 @@
+<svg width="512" height="512" viewBox="0 0 512 512" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <!-- Background Circle -->
+  <circle cx="256" cy="256" r="256" fill="#1F2937"/>
+
+  <!-- Inner Circle -->
+  <circle cx="256" cy="256" r="240" fill="#111827"/>
+
+  <!-- Gradient Definition -->
+  <defs>
+    <linearGradient id="gradientBlue" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#3B82F6;stop-opacity:1" />
+      <stop offset="100%" style="stop-color:#1E40AF;stop-opacity:1" />
+    </linearGradient>
+    <linearGradient id="gradientGreen" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#10B981;stop-opacity:1" />
+      <stop offset="100%" style="stop-color:#059669;stop-opacity:1" />
+    </linearGradient>
+  </defs>
+
+  <!-- Main Trash/Cleanup Icon -->
+  <!-- Trash can body -->
+  <path d="M 150 180 L 362 180 L 380 200 L 132 200 Z" fill="url(#gradientBlue)" opacity="0.9"/>
+
+  <!-- Trash can top/lid -->
+  <rect x="160" y="160" width="192" height="25" rx="4" fill="url(#gradientBlue)" opacity="0.7"/>
+
+  <!-- Handle -->
+  <path d="M 220 160 Q 220 140 256 140 Q 292 140 292 160" stroke="url(#gradientBlue)" stroke-width="12" fill="none" stroke-linecap="round"/>
+
+  <!-- Trash can container -->
+  <rect x="140" y="200" width="232" height="160" rx="8" fill="url(#gradientBlue)" opacity="0.8"/>
+
+  <!-- Checkmark (clean/success) - overlaid on trash -->
+  <g transform="translate(256, 280)">
+    <!-- Checkmark circle background -->
+    <circle cx="0" cy="0" r="55" fill="url(#gradientGreen)" opacity="0.95"/>
+
+    <!-- White checkmark -->
+    <path d="M -20 0 L -5 15 L 25 -20" stroke="white" stroke-width="8" fill="none" stroke-linecap="round" stroke-linejoin="round"/>
+  </g>
+
+  <!-- Decorative elements - removed items -->
+  <!-- Floating particles representing cleanup -->
+  <circle cx="100" cy="150" r="8" fill="#3B82F6" opacity="0.6"/>
+  <circle cx="412" cy="160" r="6" fill="#10B981" opacity="0.6"/>
+  <circle cx="110" cy="350" r="7" fill="#10B981" opacity="0.5"/>
+  <circle cx="400" cy="360" r="5" fill="#3B82F6" opacity="0.5"/>
+
+  <!-- Floating lines (particles dissolving) -->
+  <line x1="95" y1="140" x2="70" y2="110" stroke="#3B82F6" stroke-width="2" opacity="0.4"/>
+  <line x1="420" y1="180" x2="450" y2="150" stroke="#10B981" stroke-width="2" opacity="0.4"/>
+  <line x1="105" y1="370" x2="75" y2="400" stroke="#10B981" stroke-width="2" opacity="0.4"/>
+  <line x1="410" y1="375" x2="445" y2="410" stroke="#3B82F6" stroke-width="2" opacity="0.4"/>
+
+  <!-- Text: APPCLEAN -->
+  <text x="256" y="440" font-family="Inter, -apple-system, system-ui, sans-serif" font-size="32" font-weight="700" text-anchor="middle" fill="white" letter-spacing="-0.5">AppClean</text>
+
+  <!-- Tagline -->
+  <text x="256" y="470" font-family="Inter, -apple-system, system-ui, sans-serif" font-size="12" text-anchor="middle" fill="#9CA3AF" letter-spacing="0.5">Clean • Safe • Smart</text>
+</svg>

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "appclean",
+  "version": "1.8.0",
+  "description": "A powerful CLI tool to intelligently find and safely uninstall applications from your system with all their artifacts",
+  "main": "dist/index.js",
+  "bin": {
+    "appclean": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/index.ts",
+    "start": "node dist/index.js",
+    "test": "jest",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "uninstaller",
+    "app-management",
+    "cli",
+    "cross-platform",
+    "npm",
+    "brew",
+    "package-manager",
+    "cleanup"
+  ],
+  "author": "Praveen Kothapally <dev@praveenkothapally.dev>",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "inquirer": "^8.2.6",
+    "ora": "^5.4.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@types/inquirer": "^8.2.10",
+    "typescript": "^5.3.3",
+    "ts-node": "^10.9.2",
+    "jest": "^29.7.0",
+    "@types/jest": "^29.5.11",
+    "ts-jest": "^29.1.1"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/praveenkay/AppClean.git"
+  },
+  "bugs": {
+    "url": "https://github.com/praveenkay/AppClean/issues"
+  },
+  "homepage": "https://github.com/praveenkay/AppClean#readme"
+}

package/setup-github.sh

@@ -0,0 +1,125 @@
+#!/bin/bash
+
+# AppClean GitHub Setup Script
+# This script automates the setup and deployment process
+
+set -e
+
+echo "╔════════════════════════════════════════════════════════════════╗"
+echo "║          AppClean - GitHub Setup Automation                   ║"
+echo "╚════════════════════════════════════════════════════════════════╝"
+echo ""
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Check prerequisites
+echo -e "${BLUE}[1/5]${NC} Checking prerequisites..."
+if ! command -v git &> /dev/null; then
+    echo -e "${RED}❌ Git is not installed${NC}"
+    exit 1
+fi
+
+if ! command -v npm &> /dev/null; then
+    echo -e "${RED}❌ npm is not installed${NC}"
+    exit 1
+fi
+
+if ! command -v node &> /dev/null; then
+    echo -e "${RED}❌ Node.js is not installed${NC}"
+    exit 1
+fi
+
+echo -e "${GREEN}✓ Git, npm, and Node.js found${NC}"
+echo ""
+
+# Get GitHub username
+echo -e "${BLUE}[2/5]${NC} Getting your GitHub username..."
+read -p "Enter your GitHub username: " GITHUB_USERNAME
+
+if [ -z "$GITHUB_USERNAME" ]; then
+    echo -e "${RED}❌ GitHub username is required${NC}"
+    exit 1
+fi
+
+echo -e "${GREEN}✓ GitHub username: $GITHUB_USERNAME${NC}"
+echo ""
+
+# Get email and name
+echo -e "${BLUE}[3/5]${NC} Getting your information..."
+read -p "Enter your name: " USER_NAME
+read -p "Enter your email: " USER_EMAIL
+
+if [ -z "$USER_NAME" ] || [ -z "$USER_EMAIL" ]; then
+    echo -e "${RED}❌ Name and email are required${NC}"
+    exit 1
+fi
+
+echo -e "${GREEN}✓ Name: $USER_NAME${NC}"
+echo -e "${GREEN}✓ Email: $USER_EMAIL${NC}"
+echo ""
+
+# Configure git
+echo -e "${BLUE}[4/5]${NC} Configuring Git..."
+git config user.name "$USER_NAME"
+git config user.email "$USER_EMAIL"
+
+# Update package.json
+sed -i '' "s|YOUR_USERNAME|$GITHUB_USERNAME|g" package.json
+sed -i '' "s|Your Name|$USER_NAME|g" package.json
+
+echo -e "${GREEN}✓ Git configured${NC}"
+echo -e "${GREEN}✓ package.json updated${NC}"
+echo ""
+
+# Setup git remote
+echo -e "${BLUE}[5/5]${NC} Setting up Git remote..."
+
+git remote rm origin 2>/dev/null || true
+git remote add origin "https://github.com/$GITHUB_USERNAME/appclean.git"
+
+# Rename master to main
+if git rev-parse --verify master &>/dev/null; then
+    git branch -m master main
+fi
+
+echo -e "${GREEN}✓ Git remote configured${NC}"
+echo ""
+
+# Summary
+echo "╔════════════════════════════════════════════════════════════════╗"
+echo -e "${GREEN}✓ Setup Complete!${NC}"
+echo "╚════════════════════════════════════════════════════════════════╝"
+echo ""
+
+echo -e "${YELLOW}Next Steps:${NC}"
+echo ""
+echo "1. Create GitHub repository:"
+echo "   👉 Visit: https://github.com/new"
+echo "   - Name: appclean"
+echo "   - Description: A powerful CLI tool to intelligently find and safely uninstall applications"
+echo "   - Public"
+echo ""
+echo "2. Push to GitHub:"
+echo "   ${BLUE}git push -u origin main${NC}"
+echo ""
+echo "3. Setup npm:"
+echo "   ${BLUE}npm login${NC}"
+echo ""
+echo "4. Publish to npm:"
+echo "   ${BLUE}git tag v1.0.0${NC}"
+echo "   ${BLUE}git push origin v1.0.0${NC}"
+echo "   ${BLUE}npm publish${NC}"
+echo ""
+echo -e "${YELLOW}Repository will be at:${NC}"
+echo "  📦 GitHub: https://github.com/$GITHUB_USERNAME/appclean"
+echo "  📝 npm: https://npmjs.com/package/appclean"
+echo ""
+echo -e "${YELLOW}For detailed instructions, see:${NC}"
+echo "  📖 SETUP_GITHUB.md"
+echo "  📖 QUICKSTART.md"
+echo ""

package/src/core/appUpdateChecker.ts

@@ -0,0 +1,220 @@
+/**
+ * App Update Checker
+ * Checks for available updates for installed applications
+ * v1.7.0 Feature
+ */
+
+import { execSync } from 'child_process';
+import { Logger } from '../utils/logger';
+import { InstalledApp } from '../types';
+
+export interface UpdateInfo {
+  appName: string;
+  currentVersion: string;
+  latestVersion: string;
+  hasUpdate: boolean;
+  releaseDate?: Date;
+  changelog?: string;
+  installCommand?: string;
+}
+
+export class AppUpdateChecker {
+  /**
+   * Check for updates for a specific app
+   */
+  async checkForUpdate(app: InstalledApp): Promise<UpdateInfo> {
+    Logger.info(`Checking for updates: ${app.name}...`);
+
+    const info: UpdateInfo = {
+      appName: app.name,
+      currentVersion: app.version,
+      latestVersion: app.version,
+      hasUpdate: false,
+    };
+
+    try {
+      switch (app.installMethod) {
+        case 'npm':
+          await this.checkNpmUpdate(info);
+          break;
+        case 'yarn':
+          await this.checkYarnUpdate(info);
+          break;
+        case 'pnpm':
+          await this.checkPnpmUpdate(info);
+          break;
+        case 'brew':
+          await this.checkBrewUpdate(info);
+          break;
+        case 'apt':
+          await this.checkAptUpdate(info);
+          break;
+        case 'yum':
+        case 'dnf':
+          await this.checkYumUpdate(info);
+          break;
+        default:
+          Logger.warn(`No update checker available for ${app.installMethod}`);
+      }
+    } catch (error) {
+      Logger.debug(`Update check failed for ${app.name}: ${(error as Error).message}`);
+    }
+
+    return info;
+  }
+
+  /**
+   * Check for updates for multiple apps
+   */
+  async checkForUpdates(apps: InstalledApp[]): Promise<UpdateInfo[]> {
+    const updates: UpdateInfo[] = [];
+
+    for (const app of apps) {
+      const update = await this.checkForUpdate(app);
+      updates.push(update);
+    }
+
+    return updates;
+  }
+
+  /**
+   * Check npm registry for updates
+   */
+  private async checkNpmUpdate(info: UpdateInfo): Promise<void> {
+    try {
+      const output = execSync(`npm view ${info.appName} version 2>/dev/null`).toString().trim();
+      if (output) {
+        info.latestVersion = output;
+        info.hasUpdate = this.compareVersions(info.currentVersion, output) < 0;
+        info.installCommand = `npm install -g ${info.appName}@latest`;
+      }
+    } catch {
+      // Package not found or network error
+    }
+  }
+
+  /**
+   * Check yarn registry for updates
+   */
+  private async checkYarnUpdate(info: UpdateInfo): Promise<void> {
+    try {
+      const output = execSync(`yarn info ${info.appName} version 2>/dev/null`).toString().trim();
+      if (output) {
+        info.latestVersion = output;
+        info.hasUpdate = this.compareVersions(info.currentVersion, output) < 0;
+        info.installCommand = `yarn global upgrade ${info.appName}`;
+      }
+    } catch {
+      // Package not found or network error
+    }
+  }
+
+  /**
+   * Check pnpm registry for updates
+   */
+  private async checkPnpmUpdate(info: UpdateInfo): Promise<void> {
+    try {
+      const output = execSync(`pnpm view ${info.appName} version 2>/dev/null`).toString().trim();
+      if (output) {
+        info.latestVersion = output;
+        info.hasUpdate = this.compareVersions(info.currentVersion, output) < 0;
+        info.installCommand = `pnpm add -g ${info.appName}@latest`;
+      }
+    } catch {
+      // Package not found or network error
+    }
+  }
+
+  /**
+   * Check homebrew for updates
+   */
+  private async checkBrewUpdate(info: UpdateInfo): Promise<void> {
+    try {
+      const output = execSync(`brew info ${info.appName} 2>/dev/null | grep "stable"`).toString();
+      const match = output.match(/(\d+\.\d+\.\d+)/);
+      if (match) {
+        info.latestVersion = match[1];
+        info.hasUpdate = this.compareVersions(info.currentVersion, match[1]) < 0;
+        info.installCommand = `brew upgrade ${info.appName}`;
+      }
+    } catch {
+      // Package not found or network error
+    }
+  }
+
+  /**
+   * Check apt for updates
+   */
+  private async checkAptUpdate(info: UpdateInfo): Promise<void> {
+    try {
+      const output = execSync(`apt-cache policy ${info.appName} 2>/dev/null`).toString();
+      const match = output.match(/Candidate: (\S+)/);
+      if (match) {
+        info.latestVersion = match[1];
+        info.hasUpdate = this.compareVersions(info.currentVersion, match[1]) < 0;
+        info.installCommand = `sudo apt update && sudo apt upgrade ${info.appName}`;
+      }
+    } catch {
+      // Package not found or network error
+    }
+  }
+
+  /**
+   * Check yum/dnf for updates
+   */
+  private async checkYumUpdate(info: UpdateInfo): Promise<void> {
+    try {
+      const output = execSync(`yum info ${info.appName} 2>/dev/null`).toString();
+      const match = output.match(/Version\s+:\s+(\S+)/);
+      if (match) {
+        info.latestVersion = match[1];
+        info.hasUpdate = this.compareVersions(info.currentVersion, match[1]) < 0;
+        info.installCommand = `sudo yum update ${info.appName}`;
+      }
+    } catch {
+      // Package not found or network error
+    }
+  }
+
+  /**
+   * Compare semantic versions
+   * Returns: -1 if v1 < v2, 0 if v1 == v2, 1 if v1 > v2
+   */
+  private compareVersions(v1: string, v2: string): number {
+    const parts1 = v1.split('.').map((p) => parseInt(p, 10));
+    const parts2 = v2.split('.').map((p) => parseInt(p, 10));
+
+    for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
+      const p1 = parts1[i] || 0;
+      const p2 = parts2[i] || 0;
+
+      if (p1 < p2) return -1;
+      if (p1 > p2) return 1;
+    }
+
+    return 0;
+  }
+
+  /**
+   * Get formatted update summary
+   */
+  getUpdateSummary(updates: UpdateInfo[]): string {
+    const available = updates.filter((u) => u.hasUpdate);
+
+    if (available.length === 0) {
+      return 'All applications are up to date!';
+    }
+
+    let summary = `Found ${available.length} update(s) available:\n\n`;
+    available.forEach((update) => {
+      summary += `📦 ${update.appName}\n`;
+      summary += `   Current: ${update.currentVersion} → Latest: ${update.latestVersion}\n`;
+      if (update.installCommand) {
+        summary += `   Install: ${update.installCommand}\n`;
+      }
+      summary += '\n';
+    });
+
+    return summary;
+  }
+}

package/src/core/detector.ts

@@ -0,0 +1,133 @@
+import { NpmManager } from '../managers/npmManager';
+import { BrewManager } from '../managers/brewManager';
+import { LinuxManager } from '../managers/linuxManager';
+import { CustomManager } from '../managers/customManager';
+import { isMacOS, isLinux } from '../utils/platform';
+import { InstalledApp, ArtifactPath, SearchOptions } from '../types';
+import { getFileSize } from '../utils/filesystem';
+
+export class Detector {
+  private npmManager: NpmManager;
+  private brewManager?: BrewManager;
+  private linuxManager?: LinuxManager;
+  private customManager: CustomManager;
+
+  constructor() {
+    this.npmManager = new NpmManager();
+    this.customManager = new CustomManager();
+
+    if (isMacOS()) {
+      this.brewManager = new BrewManager();
+    }
+
+    if (isLinux()) {
+      this.linuxManager = new LinuxManager();
+    }
+  }
+
+  async detectAllApps(): Promise<InstalledApp[]> {
+    const allApps: InstalledApp[] = [];
+
+    // npm packages
+    const npmApps = await this.npmManager.getInstalledPackages();
+    allApps.push(...npmApps);
+
+    // Homebrew packages (macOS only)
+    if (this.brewManager) {
+      const brewApps = await this.brewManager.getInstalledPackages();
+      allApps.push(...brewApps);
+    }
+
+    // Linux packages
+    if (this.linuxManager) {
+      const linuxApps = await this.linuxManager.getInstalledPackages();
+      allApps.push(...linuxApps);
+    }
+
+    // Custom binaries
+    const customApps = await this.customManager.findCustomInstalledApps();
+    allApps.push(...customApps);
+
+    // Remove duplicates by name
+    const seen = new Set<string>();
+    return allApps.filter((app) => {
+      if (seen.has(app.name)) return false;
+      seen.add(app.name);
+      return true;
+    });
+  }
+
+  async searchApps(options: SearchOptions): Promise<InstalledApp[]> {
+    const allApps = await this.detectAllApps();
+
+    let filtered = allApps;
+
+    // Filter by query
+    if (options.query) {
+      const query = options.query.toLowerCase();
+      filtered = filtered.filter((app) =>
+        app.name.toLowerCase().includes(query)
+      );
+    }
+
+    // Filter by install method
+    if (options.installMethod) {
+      filtered = filtered.filter((app) => app.installMethod === options.installMethod);
+    }
+
+    // Sort
+    switch (options.sortBy) {
+      case 'name':
+        filtered.sort((a, b) => a.name.localeCompare(b.name));
+        break;
+      case 'date':
+        filtered.sort(
+          (a, b) =>
+            (b.installedDate?.getTime() || 0) - (a.installedDate?.getTime() || 0)
+        );
+        break;
+      case 'size':
+        filtered.sort((a, b) => (b.size || 0) - (a.size || 0));
+        break;
+    }
+
+    return filtered;
+  }
+
+  async findArtifacts(appName: string, installMethod: string): Promise<ArtifactPath[]> {
+    const artifacts: ArtifactPath[] = [];
+
+    switch (installMethod) {
+      case 'npm':
+        artifacts.push(...(await this.npmManager.findArtifacts(appName)));
+        break;
+      case 'brew':
+        if (this.brewManager) {
+          artifacts.push(...(await this.brewManager.findArtifacts(appName)));
+        }
+        break;
+      case 'apt':
+      case 'yum':
+      case 'dnf':
+        if (this.linuxManager) {
+          artifacts.push(...(await this.linuxManager.findArtifacts(appName)));
+        }
+        break;
+      case 'custom':
+        artifacts.push(...(await this.customManager.findArtifacts(appName)));
+        break;
+    }
+
+    // Calculate sizes
+    for (const artifact of artifacts) {
+      artifact.size = getFileSize(artifact.path);
+    }
+
+    return artifacts;
+  }
+
+  async estimateSpaceFreed(appName: string, installMethod: string): Promise<number> {
+    const artifacts = await this.findArtifacts(appName, installMethod);
+    return artifacts.reduce((total, artifact) => total + artifact.size, 0);
+  }
+}