appclean 1.8.0 → 2.0.0

package/src/utils/upgrade.ts

@@ -0,0 +1,143 @@
+import { execSync } from 'child_process';
+import { Logger } from './logger.js';
+
+export interface VersionInfo {
+  current: string;
+  latest: string;
+  isUpdateAvailable: boolean;
+}
+
+export class UpgradeManager {
+  private readonly packageName = 'appclean';
+  private readonly currentVersion = '1.9.0';
+
+  /**
+   * Get version information from npm registry
+   */
+  async getVersionInfo(): Promise<VersionInfo> {
+    try {
+      // Fetch latest version from npm registry
+      const output = execSync(
+        `npm view ${this.packageName} version --json`,
+        { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }
+      ).trim();
+
+      const latestVersion = output.replace(/"/g, '');
+      const isUpdateAvailable = this.compareVersions(
+        this.currentVersion,
+        latestVersion
+      );
+
+      return {
+        current: this.currentVersion,
+        latest: latestVersion,
+        isUpdateAvailable,
+      };
+    } catch (error) {
+      Logger.debug(
+        'Failed to check npm registry: ' + (error as Error).message
+      );
+      return {
+        current: this.currentVersion,
+        latest: this.currentVersion,
+        isUpdateAvailable: false,
+      };
+    }
+  }
+
+  /**
+   * Compare two semantic versions
+   * Returns true if currentVersion < latestVersion
+   */
+  private compareVersions(current: string, latest: string): boolean {
+    const currentParts = current.split('.').map(Number);
+    const latestParts = latest.split('.').map(Number);
+
+    for (let i = 0; i < 3; i++) {
+      const curr = currentParts[i] || 0;
+      const lat = latestParts[i] || 0;
+
+      if (lat > curr) return true;
+      if (lat < curr) return false;
+    }
+
+    return false;
+  }
+
+  /**
+   * Perform upgrade to latest version
+   */
+  async upgrade(): Promise<{ success: boolean; message: string }> {
+    try {
+      Logger.info('Checking for updates...');
+
+      const versionInfo = await this.getVersionInfo();
+
+      if (!versionInfo.isUpdateAvailable) {
+        return {
+          success: true,
+          message: `AppClean is already up to date (v${versionInfo.current})`,
+        };
+      }
+
+      Logger.info(
+        `Upgrading from v${versionInfo.current} to v${versionInfo.latest}...`
+      );
+
+      // Install latest version globally
+      execSync(`npm install -g ${this.packageName}@latest`, {
+        stdio: 'inherit',
+      });
+
+      return {
+        success: true,
+        message: `Successfully upgraded to v${versionInfo.latest}`,
+      };
+    } catch (error) {
+      const errorMsg = (error as Error).message;
+      return {
+        success: false,
+        message: `Upgrade failed: ${errorMsg}`,
+      };
+    }
+  }
+
+  /**
+   * Get current version
+   */
+  getCurrentVersion(): string {
+    return this.currentVersion;
+  }
+
+  /**
+   * Check if update is available without upgrading
+   */
+  async checkForUpdates(): Promise<VersionInfo> {
+    return this.getVersionInfo();
+  }
+
+  /**
+   * Uninstall AppClean from the system
+   */
+  async uninstall(): Promise<{ success: boolean; message: string }> {
+    try {
+      Logger.info('Uninstalling AppClean...');
+
+      // Uninstall global npm package
+      execSync(`npm uninstall -g ${this.packageName}`, {
+        stdio: 'inherit',
+      });
+
+      return {
+        success: true,
+        message: `AppClean has been successfully uninstalled from your system.`,
+      };
+    } catch (error) {
+      const errorMsg = (error as Error).message;
+      return {
+        success: false,
+        message: `Uninstall failed: ${errorMsg}`,
+      };
+    }
+  }
+}

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