npm - appclean - Versions diffs - 1.8.0 - Mend

appclean 1.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (154) hide show

package/.github/workflows/publish.yml +41 -0
package/.github/workflows/test.yml +37 -0
package/ACTION_CHECKLIST.md +342 -0
package/APPCLEAN_SUMMARY.md +309 -0
package/CHANGELOG.md +205 -0
package/CODE_OF_CONDUCT.md +49 -0
package/CODE_REVIEW_REPORT.md +447 -0
package/COMMUNITY_POSTS.md +307 -0
package/CONTRIBUTING.md +121 -0
package/DEPLOYMENT_GUIDE.md +345 -0
package/DEPLOYMENT_STATUS.md +182 -0
package/EXECUTIVE_REPORT.md +393 -0
package/GITHUB_OPTIMIZATION.md +383 -0
package/INDEX.md +165 -0
package/LICENSE +21 -0
package/MARKETING_SUMMARY.md +352 -0
package/NPM_PACKAGE_OPTIMIZATION.md +281 -0
package/NPM_PUBLISH.md +116 -0
package/PROJECT_SUMMARY.txt +249 -0
package/QUICKSTART.md +219 -0
package/README.md +548 -0
package/SECURITY.md +104 -0
package/SETUP_GITHUB.md +237 -0
package/TESTING_SUMMARY.md +379 -0
package/dist/core/appUpdateChecker.d.ts +23 -0
package/dist/core/appUpdateChecker.d.ts.map +1 -0
package/dist/core/appUpdateChecker.js +159 -0
package/dist/core/appUpdateChecker.js.map +1 -0
package/dist/core/detector.d.ts +13 -0
package/dist/core/detector.d.ts.map +1 -0
package/dist/core/detector.js +99 -0
package/dist/core/detector.js.map +1 -0
package/dist/core/duplicateFileFinder.d.ts +14 -0
package/dist/core/duplicateFileFinder.d.ts.map +1 -0
package/dist/core/duplicateFileFinder.js +80 -0
package/dist/core/duplicateFileFinder.js.map +1 -0
package/dist/core/orphanedDependencyDetector.d.ts +19 -0
package/dist/core/orphanedDependencyDetector.d.ts.map +1 -0
package/dist/core/orphanedDependencyDetector.js +148 -0
package/dist/core/orphanedDependencyDetector.js.map +1 -0
package/dist/core/performanceOptimizer.d.ts +37 -0
package/dist/core/performanceOptimizer.d.ts.map +1 -0
package/dist/core/performanceOptimizer.js +128 -0
package/dist/core/performanceOptimizer.js.map +1 -0
package/dist/core/permissionHandler.d.ts +9 -0
package/dist/core/permissionHandler.d.ts.map +1 -0
package/dist/core/permissionHandler.js +89 -0
package/dist/core/permissionHandler.js.map +1 -0
package/dist/core/pluginSystem.d.ts +39 -0
package/dist/core/pluginSystem.d.ts.map +1 -0
package/dist/core/pluginSystem.js +120 -0
package/dist/core/pluginSystem.js.map +1 -0
package/dist/core/removalRecorder.d.ts +32 -0
package/dist/core/removalRecorder.d.ts.map +1 -0
package/dist/core/removalRecorder.js +79 -0
package/dist/core/removalRecorder.js.map +1 -0
package/dist/core/remover.d.ts +15 -0
package/dist/core/remover.d.ts.map +1 -0
package/dist/core/remover.js +225 -0
package/dist/core/remover.js.map +1 -0
package/dist/core/reportGenerator.d.ts +9 -0
package/dist/core/reportGenerator.d.ts.map +1 -0
package/dist/core/reportGenerator.js +328 -0
package/dist/core/reportGenerator.js.map +1 -0
package/dist/core/scheduledCleanup.d.ts +38 -0
package/dist/core/scheduledCleanup.d.ts.map +1 -0
package/dist/core/scheduledCleanup.js +127 -0
package/dist/core/scheduledCleanup.js.map +1 -0
package/dist/core/serviceFileDetector.d.ts +18 -0
package/dist/core/serviceFileDetector.d.ts.map +1 -0
package/dist/core/serviceFileDetector.js +136 -0
package/dist/core/serviceFileDetector.js.map +1 -0
package/dist/core/verificationModule.d.ts +14 -0
package/dist/core/verificationModule.d.ts.map +1 -0
package/dist/core/verificationModule.js +102 -0
package/dist/core/verificationModule.js.map +1 -0
package/dist/index.d.ts +3 -0
package/dist/index.d.ts.map +1 -0
package/dist/index.js +333 -0
package/dist/index.js.map +1 -0
package/dist/managers/brewManager.d.ts +10 -0
package/dist/managers/brewManager.d.ts.map +1 -0
package/dist/managers/brewManager.js +130 -0
package/dist/managers/brewManager.js.map +1 -0
package/dist/managers/customManager.d.ts +8 -0
package/dist/managers/customManager.d.ts.map +1 -0
package/dist/managers/customManager.js +139 -0
package/dist/managers/customManager.js.map +1 -0
package/dist/managers/linuxManager.d.ts +10 -0
package/dist/managers/linuxManager.d.ts.map +1 -0
package/dist/managers/linuxManager.js +191 -0
package/dist/managers/linuxManager.js.map +1 -0
package/dist/managers/npmManager.d.ts +10 -0
package/dist/managers/npmManager.d.ts.map +1 -0
package/dist/managers/npmManager.js +119 -0
package/dist/managers/npmManager.js.map +1 -0
package/dist/types/index.d.ts +44 -0
package/dist/types/index.d.ts.map +1 -0
package/dist/types/index.js +3 -0
package/dist/types/index.js.map +1 -0
package/dist/ui/guiServer.d.ts +10 -0
package/dist/ui/guiServer.d.ts.map +1 -0
package/dist/ui/guiServer.js +134 -0
package/dist/ui/guiServer.js.map +1 -0
package/dist/ui/menu.d.ts +6 -0
package/dist/ui/menu.d.ts.map +1 -0
package/dist/ui/menu.js +93 -0
package/dist/ui/menu.js.map +1 -0
package/dist/ui/prompts.d.ts +13 -0
package/dist/ui/prompts.d.ts.map +1 -0
package/dist/ui/prompts.js +161 -0
package/dist/ui/prompts.js.map +1 -0
package/dist/utils/filesystem.d.ts +13 -0
package/dist/utils/filesystem.d.ts.map +1 -0
package/dist/utils/filesystem.js +152 -0
package/dist/utils/filesystem.js.map +1 -0
package/dist/utils/logger.d.ts +12 -0
package/dist/utils/logger.d.ts.map +1 -0
package/dist/utils/logger.js +49 -0
package/dist/utils/logger.js.map +1 -0
package/dist/utils/platform.d.ts +9 -0
package/dist/utils/platform.d.ts.map +1 -0
package/dist/utils/platform.js +75 -0
package/dist/utils/platform.js.map +1 -0
package/jest.config.js +20 -0
package/logo.svg +60 -0
package/package.json +55 -0
package/setup-github.sh +125 -0
package/src/core/appUpdateChecker.ts +220 -0
package/src/core/detector.ts +133 -0
package/src/core/duplicateFileFinder.ts +113 -0
package/src/core/orphanedDependencyDetector.ts +195 -0
package/src/core/performanceOptimizer.ts +209 -0
package/src/core/permissionHandler.ts +121 -0
package/src/core/pluginSystem.ts +194 -0
package/src/core/removalRecorder.ts +146 -0
package/src/core/remover.ts +280 -0
package/src/core/reportGenerator.ts +354 -0
package/src/core/scheduledCleanup.ts +204 -0
package/src/core/serviceFileDetector.ts +181 -0
package/src/core/verificationModule.ts +140 -0
package/src/index.ts +449 -0
package/src/managers/brewManager.ts +149 -0
package/src/managers/customManager.ts +167 -0
package/src/managers/linuxManager.ts +210 -0
package/src/managers/npmManager.ts +137 -0
package/src/types/index.ts +59 -0
package/src/ui/guiServer.ts +155 -0
package/src/ui/menu.ts +100 -0
package/src/ui/prompts.ts +177 -0
package/src/utils/filesystem.ts +145 -0
package/src/utils/logger.ts +48 -0
package/src/utils/platform.ts +75 -0
package/tsconfig.json +20 -0

package/src/ui/guiServer.ts ADDED Viewed

@@ -0,0 +1,155 @@
+/**
+ * GUI Server for AppClean
+ * Provides web-based GUI interface for macOS, Linux, and Windows
+ * v1.2.0 Feature
+ */
+import { createServer } from 'http';
+import { Logger } from '../utils/logger';
+export class GUIServer {
+  private port: number = 3000;
+  private server: any;
+  constructor(port: number = 3000) {
+    this.port = port;
+  }
+  /**
+   * Start GUI server
+   */
+  async start(): Promise<void> {
+    Logger.info(`Starting AppClean GUI server on port ${this.port}...`);
+    this.server = createServer((req, res) => {
+      if (req.url === '/') {
+        res.writeHead(200, { 'Content-Type': 'text/html' });
+        res.end(this.getIndexHTML());
+      } else if (req.url?.startsWith('/api/')) {
+        this.handleAPIRequest(req, res);
+      } else {
+        res.writeHead(404, { 'Content-Type': 'text/plain' });
+        res.end('Not Found');
+      }
+    });
+    this.server.listen(this.port, () => {
+      Logger.success(`GUI server running at http://localhost:${this.port}`);
+    });
+  }
+  /**
+   * Stop GUI server
+   */
+  async stop(): Promise<void> {
+    if (this.server) {
+      this.server.close();
+      Logger.info('GUI server stopped');
+    }
+  }
+  /**
+   * Handle API requests
+   */
+  private handleAPIRequest(req: any, res: any): void {
+    // API endpoints for GUI
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ message: 'API endpoint' }));
+  }
+  /**
+   * Get index HTML for GUI
+   */
+  private getIndexHTML(): string {
+    return `
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>AppClean GUI - v1.2.0</title>
+  <style>
+    * {
+      margin: 0;
+      padding: 0;
+      box-sizing: border-box;
+    }
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+      background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+      min-height: 100vh;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      padding: 20px;
+    }
+    .container {
+      background: white;
+      border-radius: 12px;
+      box-shadow: 0 20px 60px rgba(0,0,0,0.3);
+      max-width: 800px;
+      width: 100%;
+      padding: 40px;
+    }
+    h1 {
+      color: #333;
+      margin-bottom: 10px;
+    }
+    .version {
+      color: #666;
+      font-size: 14px;
+      margin-bottom: 30px;
+    }
+    .feature-badge {
+      display: inline-block;
+      background: #667eea;
+      color: white;
+      padding: 8px 16px;
+      border-radius: 20px;
+      font-size: 12px;
+      font-weight: 600;
+      margin-bottom: 20px;
+    }
+    p {
+      color: #666;
+      line-height: 1.6;
+      margin-bottom: 20px;
+    }
+    .coming-soon {
+      background: #f0f4ff;
+      border-left: 4px solid #667eea;
+      padding: 20px;
+      border-radius: 4px;
+      margin-top: 30px;
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <h1>🎨 AppClean GUI</h1>
+    <p class="version">v1.2.0 - GUI Application Feature</p>
+    <span class="feature-badge">Coming Soon</span>
+    <p>
+      A beautiful, intuitive graphical user interface for AppClean, bringing the power of
+      intelligent app removal to users who prefer a visual interface.
+    </p>
+    <div class="coming-soon">
+      <h3>🚀 Features Coming in v1.2.0</h3>
+      <ul style="margin-left: 20px; margin-top: 10px;">
+        <li>✨ Modern, responsive GUI design</li>
+        <li>🖥️ Cross-platform support (macOS, Linux, Windows)</li>
+        <li>🔍 Visual app search and discovery</li>
+        <li>📊 Beautiful artifact visualization</li>
+        <li>🗑️ Drag-and-drop app removal</li>
+        <li>📈 Real-time removal progress</li>
+        <li>📋 Interactive report viewer</li>
+      </ul>
+    </div>
+  </div>
+</body>
+</html>
+    `;
+  }
+}

package/src/ui/menu.ts ADDED Viewed

@@ -0,0 +1,100 @@
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+export type MainMenuAction =
+  | 'search'
+  | 'browse'
+  | 'list-all'
+  | 'help'
+  | 'exit';
+export async function showMainMenu(): Promise<MainMenuAction> {
+  const { action } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'action',
+      message: 'What would you like to do?',
+      choices: [
+        { name: '🔍  Search for an app', value: 'search' },
+        { name: '📋 List all installed apps', value: 'list-all' },
+        { name: '❓ Help', value: 'help' },
+        { name: '❌ Exit', value: 'exit' },
+      ],
+    },
+  ]);
+  return action;
+}
+export async function showAppMenu(): Promise<'remove' | 'details' | 'back'> {
+  const { action } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'action',
+      message: 'What would you like to do?',
+      choices: [
+        { name: '📊 View details and artifacts', value: 'details' },
+        { name: '🗑️  Remove this app', value: 'remove' },
+        { name: '⬅️  Back to search', value: 'back' },
+      ],
+    },
+  ]);
+  return action;
+}
+export function showHeader(): void {
+  console.clear();
+  console.log(
+    chalk.cyan(`
+╔═══════════════════════════════════════════════════════════╗
+║                                                           ║
+║            ${chalk.bold('AppClean - App Uninstaller')}                  ║
+║          Remove apps and all their artifacts             ║
+║                                                           ║
+╚═══════════════════════════════════════════════════════════╝
+  `)
+  );
+}
+export function showHelp(): void {
+  console.log(
+    chalk.cyan(`
+${chalk.bold('AppClean - Help')}
+${chalk.bold('Features:')}
+  • Search and find all installed applications
+  • Identify installation method (npm, brew, apt, custom, etc)
+  • Locate all related files, configs, and caches
+  • Safely remove apps with dry-run preview
+  • Create backups before deletion
+  • Cross-platform support (macOS, Linux, Windows)
+${chalk.bold('Commands:')}
+  appclean                    Start interactive mode
+  appclean search <name>      Search for an app
+  appclean remove <name>      Remove an app
+  appclean list               List all apps
+  appclean analyze <name>     Show app artifacts
+${chalk.bold('Options:')}
+  --dry-run                   Preview without deleting
+  --backup                    Create backup before removal
+  --help                      Show this help message
+  --version                   Show version
+${chalk.bold('Examples:')}
+  appclean search nodejs      Search for nodejs
+  appclean remove myapp --dry-run    Preview removal
+  appclean list | grep npm    Find npm-installed apps
+${chalk.bold('Safety:')}
+  • Always previews what will be deleted
+  • Use --dry-run first to see what will happen
+  • Use --backup to create backups before deletion
+  • Double confirmation before actual removal
+${chalk.bold('Website:')} https://github.com/YOUR_USERNAME/appclean
+  `)
+  );
+}

package/src/ui/prompts.ts ADDED Viewed

@@ -0,0 +1,177 @@
+import inquirer from 'inquirer';
+import { InstalledApp, ArtifactPath } from '../types';
+import { Logger, formatBytes } from '../utils/logger';
+import chalk from 'chalk';
+export async function promptSearchQuery(): Promise<string> {
+  const { query } = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'query',
+      message: 'Search for an app (partial name):',
+      default: '',
+    },
+  ]);
+  return query;
+}
+export async function promptSelectApp(apps: InstalledApp[]): Promise<InstalledApp | null> {
+  if (apps.length === 0) {
+    Logger.warn('No apps found');
+    return null;
+  }
+  const choices = apps.map((app) => ({
+    name: `${app.name} (${app.installMethod}) - v${app.version}`,
+    value: app,
+  }));
+  const { app } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'app',
+      message: 'Select an app to remove:',
+      choices: [
+        ...choices,
+        new inquirer.Separator(),
+        { name: 'Cancel', value: null },
+      ],
+      pageSize: 10,
+    },
+  ]);
+  return app;
+}
+export async function promptConfirmRemoval(appName: string): Promise<boolean> {
+  const { confirmed } = await inquirer.prompt([
+    {
+      type: 'confirm',
+      name: 'confirmed',
+      message: chalk.yellow(`Are you sure you want to remove ${appName}?`),
+      default: false,
+    },
+  ]);
+  return confirmed;
+}
+export async function promptRemovalOptions(): Promise<{
+  dryRun: boolean;
+  createBackup: boolean;
+}> {
+  const { options } = await inquirer.prompt([
+    {
+      type: 'checkbox',
+      name: 'options',
+      message: 'Removal options:',
+      choices: [
+        {
+          name: 'Dry run (preview without removing)',
+          value: 'dryRun',
+          checked: true,
+        },
+        {
+          name: 'Create backup before removal',
+          value: 'backup',
+          checked: false,
+        },
+      ],
+    },
+  ]);
+  return {
+    dryRun: options.includes('dryRun'),
+    createBackup: options.includes('backup'),
+  };
+}
+export async function promptInstallMethodFilter(): Promise<string | null> {
+  const { method } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'method',
+      message: 'Filter by installation method:',
+      choices: [
+        { name: 'All', value: null },
+        { name: 'npm', value: 'npm' },
+        { name: 'yarn', value: 'yarn' },
+        { name: 'pnpm', value: 'pnpm' },
+        { name: 'Homebrew', value: 'brew' },
+        { name: 'apt', value: 'apt' },
+        { name: 'yum', value: 'yum' },
+        { name: 'dnf', value: 'dnf' },
+        { name: 'Custom', value: 'custom' },
+      ],
+    },
+  ]);
+  return method;
+}
+export async function promptSortBy(): Promise<'name' | 'date' | 'size'> {
+  const { sortBy } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'sortBy',
+      message: 'Sort results by:',
+      choices: [
+        { name: 'Name', value: 'name' },
+        { name: 'Installation Date', value: 'date' },
+        { name: 'Size', value: 'size' },
+      ],
+    },
+  ]);
+  return sortBy;
+}
+export function displayAppDetails(app: InstalledApp, artifacts: ArtifactPath[]): void {
+  Logger.space();
+  Logger.info(`App: ${chalk.cyan(app.name)}`);
+  Logger.info(`Method: ${chalk.yellow(app.installMethod)}`);
+  Logger.info(`Version: ${app.version}`);
+  Logger.info(`Location: ${app.mainPath}`);
+  Logger.space();
+  Logger.info('Associated files and directories:');
+  Logger.space();
+  let totalSize = 0;
+  for (const artifact of artifacts) {
+    const size = artifact.size || 0;
+    totalSize += size;
+    const icon =
+      artifact.type === 'binary'
+        ? '⚙️'
+        : artifact.type === 'config'
+          ? '⚙️'
+          : artifact.type === 'cache'
+            ? '📦'
+            : '📁';
+    console.log(
+      `  ${icon} [${artifact.type.padEnd(7)}] ${formatBytes(size).padEnd(10)} ${artifact.path}`
+    );
+  }
+  Logger.space();
+  Logger.info(`Total space to be freed: ${chalk.green(formatBytes(totalSize))}`);
+  Logger.space();
+}
+export async function promptFinalConfirmation(appName: string): Promise<boolean> {
+  const { confirmed } = await inquirer.prompt([
+    {
+      type: 'confirm',
+      name: 'confirmed',
+      message: chalk.red(
+        `This action cannot be undone. Remove ${appName} and all its files?`
+      ),
+      default: false,
+    },
+  ]);
+  return confirmed;
+}

package/src/utils/filesystem.ts ADDED Viewed

@@ -0,0 +1,145 @@
+import fs from 'fs';
+import path from 'path';
+export function getFileSize(filePath: string): number {
+  try {
+    const stats = fs.statSync(filePath);
+    if (stats.isDirectory()) {
+      return getDirectorySize(filePath);
+    }
+    return stats.size;
+  } catch {
+    return 0;
+  }
+}
+export function getDirectorySize(dirPath: string): number {
+  try {
+    let size = 0;
+    const files = fs.readdirSync(dirPath, { withFileTypes: true });
+    for (const file of files) {
+      const fullPath = path.join(dirPath, file.name);
+      if (file.isDirectory()) {
+        size += getDirectorySize(fullPath);
+      } else {
+        const stats = fs.statSync(fullPath);
+        size += stats.size;
+      }
+    }
+    return size;
+  } catch {
+    return 0;
+  }
+}
+export function pathExists(filePath: string): boolean {
+  return fs.existsSync(filePath);
+}
+export function isDirectory(filePath: string): boolean {
+  try {
+    return fs.statSync(filePath).isDirectory();
+  } catch {
+    return false;
+  }
+}
+export function isFile(filePath: string): boolean {
+  try {
+    return fs.statSync(filePath).isFile();
+  } catch {
+    return false;
+  }
+}
+export function listDirectory(dirPath: string): string[] {
+  try {
+    return fs.readdirSync(dirPath);
+  } catch {
+    return [];
+  }
+}
+export function listDirectoryDeep(
+  dirPath: string,
+  maxDepth: number = 5,
+  currentDepth: number = 0
+): string[] {
+  const files: string[] = [];
+  if (currentDepth >= maxDepth) return files;
+  try {
+    const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = path.join(dirPath, entry.name);
+      try {
+        // Skip symlinks and permission issues
+        if (entry.isSymbolicLink()) continue;
+        files.push(fullPath);
+        if (entry.isDirectory() && currentDepth < maxDepth - 1) {
+          files.push(...listDirectoryDeep(fullPath, maxDepth, currentDepth + 1));
+        }
+      } catch {
+        // Skip entries that can't be accessed
+        continue;
+      }
+    }
+  } catch {
+    return files;
+  }
+  return files;
+}
+export function deleteFile(filePath: string): boolean {
+  try {
+    fs.unlinkSync(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+export function deleteDirectory(dirPath: string): boolean {
+  try {
+    fs.rmSync(dirPath, { recursive: true, force: true });
+    return true;
+  } catch {
+    return false;
+  }
+}
+export function readFile(filePath: string): string | null {
+  try {
+    return fs.readFileSync(filePath, 'utf-8');
+  } catch {
+    return null;
+  }
+}
+export function writeFile(filePath: string, content: string): boolean {
+  try {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(filePath, content, 'utf-8');
+    return true;
+  } catch {
+    return false;
+  }
+}
+export function getModificationTime(filePath: string): Date | null {
+  try {
+    return fs.statSync(filePath).mtime;
+  } catch {
+    return null;
+  }
+}

package/src/utils/logger.ts ADDED Viewed

@@ -0,0 +1,48 @@
+import chalk from 'chalk';
+export class Logger {
+  static info(message: string): void {
+    console.log(chalk.blue('ℹ'), message);
+  }
+  static success(message: string): void {
+    console.log(chalk.green('✓'), message);
+  }
+  static warn(message: string): void {
+    console.log(chalk.yellow('⚠'), message);
+  }
+  static error(message: string): void {
+    console.log(chalk.red('✗'), message);
+  }
+  static debug(message: string): void {
+    if (process.env.DEBUG) {
+      console.log(chalk.gray('🐛'), message);
+    }
+  }
+  static table(data: any[]): void {
+    console.table(data);
+  }
+  static space(): void {
+    console.log('');
+  }
+}
+export function formatBytes(bytes: number): string {
+  if (bytes === 0) return '0 B';
+  const k = 1024;
+  const sizes = ['B', '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 function formatDate(date: Date | undefined): string {
+  if (!date) return 'Unknown';
+  return date.toLocaleDateString() + ' ' + date.toLocaleTimeString();
+}

package/src/utils/platform.ts ADDED Viewed

@@ -0,0 +1,75 @@
+import os from 'os';
+import { Platform } from '../types';
+export function getPlatform(): Platform {
+  return (os.platform() as Platform);
+}
+export function isMacOS(): boolean {
+  return getPlatform() === 'darwin';
+}
+export function isLinux(): boolean {
+  return getPlatform() === 'linux';
+}
+export function isWindows(): boolean {
+  return getPlatform() === 'win32';
+}
+export function getHomeDir(): string {
+  return os.homedir();
+}
+export function getConfigDir(): string {
+  const platform = getPlatform();
+  const home = getHomeDir();
+  switch (platform) {
+    case 'darwin':
+      return home;
+    case 'linux':
+      return home;
+    case 'win32':
+      return process.env.APPDATA || home;
+    default:
+      return home;
+  }
+}
+export function getCommonPaths(subpath: string): string[] {
+  const platform = getPlatform();
+  const home = getHomeDir();
+  const paths: string[] = [];
+  switch (platform) {
+    case 'darwin':
+      paths.push(`${home}/.config/${subpath}`);
+      paths.push(`${home}/Library/Application Support/${subpath}`);
+      paths.push(`${home}/Library/Preferences/${subpath}`);
+      paths.push(`${home}/Library/Caches/${subpath}`);
+      paths.push(`${home}/Library/Logs/${subpath}`);
+      paths.push(`${home}/.${subpath}`);
+      break;
+    case 'linux':
+      paths.push(`${home}/.config/${subpath}`);
+      paths.push(`${home}/.local/share/${subpath}`);
+      paths.push(`${home}/.cache/${subpath}`);
+      paths.push(`${home}/.${subpath}`);
+      paths.push(`/var/log/${subpath}`);
+      paths.push(`/usr/local/etc/${subpath}`);
+      paths.push(`/etc/${subpath}`);
+      break;
+    case 'win32':
+      const appData = process.env.APPDATA || `${home}\\AppData\\Roaming`;
+      const localAppData = process.env.LOCALAPPDATA || `${home}\\AppData\\Local`;
+      paths.push(`${appData}\\${subpath}`);
+      paths.push(`${localAppData}\\${subpath}`);
+      paths.push(`${home}\\.${subpath}`);
+      break;
+  }
+  return paths;
+}