appclean 1.9.0 → 2.0.2

package/src/ui/server/services/removalService.ts

@@ -0,0 +1,138 @@
+/**
+ * RemovalService - Wraps Remover to provide safe app removal
+ */
+
+import { Remover } from '../../../core/remover.js';
+import { Detector } from '../../../core/detector.js';
+import { Logger } from '../../../utils/logger.js';
+
+export interface RemovalOptions {
+  dryRun?: boolean;
+  createBackup?: boolean;
+}
+
+export interface RemovalResult {
+  success: boolean;
+  appName: string;
+  removedFiles: number;
+  freedSpace: number;
+  backupPath?: string;
+  errors?: string[];
+}
+
+export class RemovalService {
+  private remover: Remover;
+  private detector: Detector;
+  private sessionRemovals: RemovalResult[] = [];
+
+  constructor() {
+    this.remover = new Remover();
+    this.detector = new Detector();
+  }
+
+  /**
+   * Execute app removal
+   */
+  async removeApp(appName: string, options: RemovalOptions = {}): Promise<RemovalResult> {
+    try {
+      // Find the app
+      const allApps = await this.detector.searchApps({ query: appName });
+      const app = allApps.find((a) => a.name.toLowerCase() === appName.toLowerCase());
+
+      if (!app) {
+        throw new Error(`App "${appName}" not found`);
+      }
+
+      // Find artifacts
+      const artifacts = await this.detector.findArtifacts(app.name, app.installMethod);
+
+      if (artifacts.length === 0) {
+        return {
+          success: true,
+          appName: app.name,
+          removedFiles: 0,
+          freedSpace: 0,
+        };
+      }
+
+      // Calculate freed space
+      const freedSpace = artifacts.reduce((sum, a) => sum + (a.size || 0), 0);
+
+      // Handle dry-run
+      if (options.dryRun) {
+        Logger.info(`[DRY RUN] Would remove ${artifacts.length} artifacts (${this.formatBytes(freedSpace)}) for ${appName}`);
+        return {
+          success: true,
+          appName: app.name,
+          removedFiles: artifacts.length,
+          freedSpace,
+        };
+      }
+
+      // Create backup if requested
+      let backupPath: string | undefined;
+      if (options.createBackup) {
+        try {
+          backupPath = await this.remover.createBackup(app.name, artifacts);
+          Logger.info(`Created backup at: ${backupPath}`);
+        } catch (error) {
+          Logger.warn(`Failed to create backup: ${(error as Error).message}`);
+        }
+      }
+
+      // Remove artifacts using Remover class
+      const removalResult = await this.remover.removeArtifacts(artifacts, { dryRun: false });
+
+      const result: RemovalResult = {
+        success: removalResult.failed === 0,
+        appName: app.name,
+        removedFiles: removalResult.success,
+        freedSpace,
+      };
+
+      if (backupPath) {
+        result.backupPath = backupPath;
+      }
+
+      if (removalResult.errors.length > 0) {
+        result.errors = removalResult.errors;
+      }
+
+      // Track removal for dashboard
+      this.sessionRemovals.push(result);
+
+      Logger.success(`Successfully removed ${app.name} (freed ${this.formatBytes(freedSpace)})`);
+      return result;
+    } catch (error) {
+      throw new Error(`Removal failed: ${(error as Error).message}`);
+    }
+  }
+
+  /**
+   * Get session removals for dashboard
+   */
+  getSessionRemovals(): RemovalResult[] {
+    return this.sessionRemovals;
+  }
+
+  /**
+   * Clear session removals
+   */
+  clearSessionRemovals(): void {
+    this.sessionRemovals = [];
+  }
+
+  /**
+   * Format bytes to human readable
+   */
+  private formatBytes(bytes: number): string {
+    if (bytes === 0) return '0 Bytes';
+    const k = 1024;
+    const sizes = ['Bytes', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];
+  }
+}
+
+// Export singleton
+export const removalService = new RemovalService();

package/src/utils/upgrade.ts

@@ -1,5 +1,8 @@
 import { execSync } from 'child_process';
-import { Logger } from './logger';
+import { Logger } from './logger.js';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
 
 export interface VersionInfo {
   current: string;
@@ -9,7 +12,21 @@ export interface VersionInfo {
 
 export class UpgradeManager {
   private readonly packageName = 'appclean';
-  private readonly currentVersion = '1.9.0';
+  private currentVersion: string;
+
+  constructor() {
+    // Dynamically read version from package.json
+    try {
+      const __filename = fileURLToPath(import.meta.url);
+      const __dirname = dirname(__filename);
+      const packagePath = join(__dirname, '../../package.json');
+      const packageData = JSON.parse(readFileSync(packagePath, 'utf-8'));
+      this.currentVersion = packageData.version || '2.0.0';
+    } catch (error) {
+      Logger.debug('Failed to read version from package.json, using fallback');
+      this.currentVersion = '2.0.0';
+    }
+  }
 
   /**
    * Get version information from npm registry

package/tsconfig.json

@@ -1,10 +1,11 @@
 {
   "compilerOptions": {
     "target": "ES2020",
-    "module": "commonjs",
-    "lib": ["ES2020"],
+    "module": "ES2020",
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
     "outDir": "./dist",
     "rootDir": "./src",
+    "moduleResolution": "node",
     "strict": true,
     "esModuleInterop": true,
     "skipLibCheck": true,

package/INDEX.md

@@ -1,165 +0,0 @@
-# 📑 AppClean Documentation Index
-
-Welcome to AppClean! This index helps you navigate all documentation and resources.
-
-## 🚀 Getting Started (Start Here!)
-
-### For New Users
-1. **[QUICKSTART.md](QUICKSTART.md)** - Quick start guide and 3-step deployment
-2. **[SETUP_GITHUB.md](SETUP_GITHUB.md)** - Detailed GitHub & npm setup instructions
-3. **[README.md](README.md)** - Full user documentation with examples
-
-### For Developers
-1. **[CONTRIBUTING.md](CONTRIBUTING.md)** - Developer guidelines and workflow
-2. **[DEPLOYMENT_GUIDE.md](DEPLOYMENT_GUIDE.md)** - Full deployment checklist
-3. **[APPCLEAN_SUMMARY.md](APPCLEAN_SUMMARY.md)** - Complete technical summary
-
-## 📚 Documentation by Purpose
-
-### Installation & Setup
-| File | Purpose |
-|------|---------|
-| [QUICKSTART.md](QUICKSTART.md) | Quick start overview |
-| [SETUP_GITHUB.md](SETUP_GITHUB.md) | GitHub & npm deployment |
-| [setup-github.sh](setup-github.sh) | Automated setup script |
-
-### User Documentation
-| File | Purpose |
-|------|---------|
-| [README.md](README.md) | Features, installation, usage, examples |
-| [PROJECT_SUMMARY.txt](PROJECT_SUMMARY.txt) | Project overview |
-| [APPCLEAN_SUMMARY.md](APPCLEAN_SUMMARY.md) | Detailed summary |
-
-### Developer Resources
-| File | Purpose |
-|------|---------|
-| [CONTRIBUTING.md](CONTRIBUTING.md) | How to contribute |
-| [DEPLOYMENT_GUIDE.md](DEPLOYMENT_GUIDE.md) | Deployment steps & checklist |
-| [CHANGELOG.md](CHANGELOG.md) | Version history & roadmap |
-
-### Code & Configuration
-| File | Purpose |
-|------|---------|
-| [package.json](package.json) | Project metadata & dependencies |
-| [tsconfig.json](tsconfig.json) | TypeScript configuration |
-| [jest.config.js](jest.config.js) | Test configuration |
-| [.gitignore](.gitignore) | Git ignore rules |
-
-### GitHub Actions
-| File | Purpose |
-|------|---------|
-| [.github/workflows/test.yml](.github/workflows/test.yml) | Automated testing |
-| [.github/workflows/publish.yml](.github/workflows/publish.yml) | npm publishing |
-
-### License
-| File | Purpose |
-|------|---------|
-| [LICENSE](LICENSE) | MIT License |
-
-## 🔍 Quick Navigation
-
-### I want to...
-
-**Deploy to GitHub**
-→ Read [SETUP_GITHUB.md](SETUP_GITHUB.md)
-
-**Publish to npm**
-→ Read [SETUP_GITHUB.md](SETUP_GITHUB.md) (Section: "Setup npm Publishing")
-
-**Contribute code**
-→ Read [CONTRIBUTING.md](CONTRIBUTING.md)
-
-**Understand the project**
-→ Read [README.md](README.md) then [APPCLEAN_SUMMARY.md](APPCLEAN_SUMMARY.md)
-
-**Get started quickly**
-→ Read [QUICKSTART.md](QUICKSTART.md)
-
-**Set up development environment**
-→ Read [CONTRIBUTING.md](CONTRIBUTING.md) (Section: "Development Setup")
-
-## 📊 Project Structure
-
-```
-appclean/
-├── src/                          # Source code (13 files)
-│   ├── index.ts                 # Main CLI entry point
-│   ├── core/
-│   │   ├── detector.ts          # App detection engine
-│   │   └── remover.ts           # Safe removal engine
-│   ├── managers/
-│   │   ├── npmManager.ts        # npm/yarn/pnpm
-│   │   ├── brewManager.ts       # Homebrew
-│   │   ├── linuxManager.ts      # apt/yum/dnf
-│   │   └── customManager.ts     # Custom installers
-│   ├── ui/
-│   │   ├── menu.ts              # Interactive menus
-│   │   └── prompts.ts           # User prompts
-│   ├── types/
-│   │   └── index.ts             # TypeScript types
-│   └── utils/
-│       ├── platform.ts          # Platform detection
-│       ├── filesystem.ts        # File operations
-│       └── logger.ts            # Logging
-├── .github/workflows/           # CI/CD workflows
-├── Configuration files          # 4 config files
-├── Documentation files          # 8+ guides
-└── LICENSE                      # MIT License
-```
-
-## 🎯 Deployment Checklist
-
-- [ ] Read [QUICKSTART.md](QUICKSTART.md)
-- [ ] Review [SETUP_GITHUB.md](SETUP_GITHUB.md)
-- [ ] Create GitHub repository
-- [ ] Update package.json with your info
-- [ ] Push code to GitHub
-- [ ] Create npm account
-- [ ] Publish to npm registry
-- [ ] Update GitHub repository topics
-- [ ] Add GitHub Actions secret (NPM_TOKEN)
-
-See [DEPLOYMENT_GUIDE.md](DEPLOYMENT_GUIDE.md) for detailed checklist.
-
-## 📖 Recommended Reading Order
-
-1. **First Time?** → [QUICKSTART.md](QUICKSTART.md)
-2. **Ready to Deploy?** → [SETUP_GITHUB.md](SETUP_GITHUB.md)
-3. **Want to Understand More?** → [README.md](README.md)
-4. **Contributing Code?** → [CONTRIBUTING.md](CONTRIBUTING.md)
-5. **Need Details?** → [APPCLEAN_SUMMARY.md](APPCLEAN_SUMMARY.md)
-6. **Managing Project?** → [DEPLOYMENT_GUIDE.md](DEPLOYMENT_GUIDE.md)
-
-## 🔗 External Links
-
-- **GitHub**: https://github.com/new (Create repository)
-- **npm**: https://www.npmjs.com/signup (Create account)
-- **TypeScript**: https://www.typescriptlang.org/docs/
-- **Node.js**: https://nodejs.org/
-
-## 📞 Support & Questions
-
-- **Bug Reports**: GitHub Issues
-- **Questions**: GitHub Discussions
-- **Documentation**: Check files in this directory
-- **Help**: See [CONTRIBUTING.md](CONTRIBUTING.md) for development help
-
-## ✨ Key Features
-
-🔍 **Smart Detection** - Finds apps from 8+ installation methods
-📊 **Deep Analysis** - Locates all related files and artifacts
-🛡️ **Safe Removal** - Dry-run preview and backup support
-🎨 **Beautiful UI** - Interactive menus with colors and animations
-🚀 **Cross-Platform** - Works on macOS, Linux, Windows
-
-## 🌟 You're All Set!
-
-Your AppClean project is production-ready.
-
-**Next Step:** Open [SETUP_GITHUB.md](SETUP_GITHUB.md) to begin deployment!
-
----
-
-**Last Updated:** 2024-01-20
-**License:** MIT
-**Status:** ✅ Ready for Production