@singhaman21/cleansweep 1.0.0

package/dist/utils/logger.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * Logger utility for cleansweep
+ * Handles logging to console and log files with timestamps
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+const fs = __importStar(require("fs"));
+class Logger {
+    constructor(logFile, outputFormat = 'plain') {
+        this.logFile = logFile;
+        this.outputFormat = outputFormat;
+    }
+    /**
+     * Logs a message with timestamp to both console and log file (if specified)
+     * @param message - Message to log
+     * @param level - Log level (INFO, WARNING, ERROR)
+     */
+    log(message, level = 'INFO') {
+        const timestamp = new Date().toISOString().replace('T', ' ').slice(0, 19);
+        const formattedMessage = `[${timestamp}] [${level}] ${message}`;
+        // Print to console
+        if (this.outputFormat === 'json') {
+            const jsonMessage = JSON.stringify({
+                timestamp,
+                level,
+                message
+            });
+            console.log(jsonMessage);
+        }
+        else {
+            console.log(formattedMessage);
+        }
+        // Write to log file if specified
+        if (this.logFile) {
+            try {
+                fs.appendFileSync(this.logFile, formattedMessage + '\n');
+            }
+            catch (error) {
+                console.error(`Failed to write to log file: ${error}`);
+            }
+        }
+    }
+    /**
+     * Initializes the log file with header information
+     * @param config - Configuration object with all settings
+     */
+    initializeLogFile(config) {
+        if (!this.logFile)
+            return;
+        try {
+            const header = [
+                '==========================================',
+                `Deletion Log - ${new Date().toISOString().replace('T', ' ').slice(0, 19)}`,
+                '==========================================',
+                `Dry Run: ${config.dryRun}`,
+                `Interactive: ${config.interactive}`,
+                `Force: ${config.force}`,
+                ...(config.filesPattern ? [`Files Pattern: ${config.filesPattern}`] : []),
+                ...(config.foldersPattern ? [`Folders Pattern: ${config.foldersPattern}`] : []),
+                ...(config.typesPattern ? [`Types Pattern: ${config.typesPattern}`] : []),
+                ...(config.excludePatterns.length > 0
+                    ? [`Exclude Patterns: ${config.excludePatterns.join(', ')}`]
+                    : []),
+                ...(config.maxDepth ? [`Max Depth: ${config.maxDepth}`] : []),
+                '==========================================',
+                ''
+            ].join('\n');
+            fs.writeFileSync(this.logFile, header);
+        }
+        catch (error) {
+            console.error(`Failed to initialize log file: ${error}`);
+        }
+    }
+}
+exports.Logger = Logger;
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"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"}

package/dist/utils/prompts.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Interactive prompt utilities for cleansweep
+ * Handles user confirmation prompts
+ */
+/**
+ * Prompts the user for confirmation before deleting an item
+ * @param item - Path of the item to delete
+ * @param force - If true, always returns true without prompting
+ * @returns Promise that resolves to true if confirmed, false otherwise
+ */
+export declare function confirmDeletion(item: string, force?: boolean): Promise<boolean>;
+/**
+ * Prompts the user to proceed with deletion after preview
+ * @returns Promise that resolves to true if confirmed, false otherwise
+ */
+export declare function confirmProceed(): Promise<boolean>;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/utils/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/utils/prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CActF;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CASjD"}

package/dist/utils/prompts.js

@@ -0,0 +1,86 @@
+"use strict";
+/**
+ * Interactive prompt utilities for cleansweep
+ * Handles user confirmation prompts
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.confirmDeletion = confirmDeletion;
+exports.confirmProceed = confirmProceed;
+const readline = __importStar(require("readline"));
+/**
+ * Creates a readline interface for user input
+ */
+function createReadlineInterface() {
+    return readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+    });
+}
+/**
+ * Prompts the user for confirmation before deleting an item
+ * @param item - Path of the item to delete
+ * @param force - If true, always returns true without prompting
+ * @returns Promise that resolves to true if confirmed, false otherwise
+ */
+function confirmDeletion(item, force = false) {
+    return new Promise((resolve) => {
+        if (force) {
+            resolve(true);
+            return;
+        }
+        const rl = createReadlineInterface();
+        rl.question(`Delete '${item}'? [y/N]: `, (answer) => {
+            rl.close();
+            const response = answer.trim().toLowerCase();
+            resolve(response === 'y' || response === 'yes');
+        });
+    });
+}
+/**
+ * Prompts the user to proceed with deletion after preview
+ * @returns Promise that resolves to true if confirmed, false otherwise
+ */
+function confirmProceed() {
+    return new Promise((resolve) => {
+        const rl = createReadlineInterface();
+        rl.question('Proceed with deletion? [y/N]: ', (answer) => {
+            rl.close();
+            const response = answer.trim().toLowerCase();
+            resolve(response === 'y' || response === 'yes');
+        });
+    });
+}
+//# sourceMappingURL=prompts.js.map

package/dist/utils/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/utils/prompts.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoBH,0CAcC;AAMD,wCASC;AA/CD,mDAAqC;AAErC;;GAEG;AACH,SAAS,uBAAuB;IAC9B,OAAO,QAAQ,CAAC,eAAe,CAAC;QAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,IAAY,EAAE,QAAiB,KAAK;IAClE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,IAAI,CAAC,CAAC;YACd,OAAO;QACT,CAAC;QAED,MAAM,EAAE,GAAG,uBAAuB,EAAE,CAAC;QACrC,EAAE,CAAC,QAAQ,CAAC,WAAW,IAAI,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;YAClD,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC7C,OAAO,CAAC,QAAQ,KAAK,GAAG,IAAI,QAAQ,KAAK,KAAK,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,SAAgB,cAAc;IAC5B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,EAAE,GAAG,uBAAuB,EAAE,CAAC;QACrC,EAAE,CAAC,QAAQ,CAAC,gCAAgC,EAAE,CAAC,MAAM,EAAE,EAAE;YACvD,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC7C,OAAO,CAAC,QAAQ,KAAK,GAAG,IAAI,QAAQ,KAAK,KAAK,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@singhaman21/cleansweep",
+  "version": "1.0.0",
+  "description": "A powerful command-line tool for safely deleting files and folders with comprehensive safety features",
+  "main": "dist/index.js",
+  "bin": {
+    "cleansweep": "./dist/bin/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/bin/cli.js",
+    "dev": "ts-node src/bin/cli.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SinghAman21/cleansweep.git"
+  },
+  "keywords": [
+    "devtool",
+    "script",
+    "bash",
+    "delete",
+    "cleanup",
+    "files",
+    "folders",
+    "cli",
+    "typescript"
+  ],
+  "author": "SinghAman21",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/SinghAman21/cleansweep/issues"
+  },
+  "homepage": "https://github.com/SinghAman21/cleansweep#readme",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.3.3"
+  },
+  "dependencies": {
+    "commander": "^11.1.0",
+    "glob": "^10.3.10",
+    "readline": "^1.3.0"
+  }
+}

package/src/bin/cli.ts

@@ -0,0 +1,130 @@
+#!/usr/bin/env node
+
+/**
+ * cleansweep CLI Entry Point
+ * Command-line interface for the cleansweep deletion tool
+ */
+
+import { Command } from 'commander';
+import { Config } from '../types';
+import { Logger } from '../utils/logger';
+import { DeletionEngine } from '../core/deletionEngine';
+
+/**
+ * Main function to run the CLI
+ */
+async function main() {
+  const program = new Command();
+
+  program
+    .name('cleansweep')
+    .description('A powerful command-line tool for safely deleting files and folders')
+    .version('1.0.0')
+    .option('-fi, --files <pattern>', 'Specify file patterns to delete (e.g., "*.tmp", "*.log")')
+    .option('-fo, --folders <pattern>', 'Specify folder patterns to delete (e.g., "temp", "cache")')
+    .option('-ty, --types <pattern>', 'Specify multiple types of files/directories to delete')
+    .option('-ex, --exclude <pattern>', 'Exclude patterns or folders from deletion (can be used multiple times)', (val: string, prev: string[]) => {
+      prev.push(val);
+      return prev;
+    }, [] as string[])
+    .option('-d, --depth <number>', 'Limit the search depth in directory structure', parseInt)
+    .option('-dr, --dry-run', 'Simulate deletion without actually deleting anything', false)
+    .option('-in, --interactive', 'Prompt for confirmation before each deletion', false)
+    .option('-pr, --preview', 'Display list of items that will be deleted', false)
+    .option('-f, --force', 'Bypass safety checks and interactive warnings', false)
+    .option('-lg, --log <file>', 'Generate a log file with timestamps of deletions')
+    .option('-fm, --format <format>', 'Output format: plain, json (default: plain)', 'plain')
+    .addHelpText('after', `
+Examples:
+  npx cleansweep --files "*.tmp" --folders "temp" --exclude "important" --log deletion_log.txt --dry-run
+  npx cleansweep -fi "*.tmp" -fo "temp" -ex "important" -lg deletion_log.txt -dr
+  npx cleansweep --types "*.log" --depth 2 --interactive
+  npx cleansweep -ty "*.log" -d 2 -in
+  npx cleansweep --files "*.tmp" --preview
+  npx cleansweep -fi "*.tmp" -pr
+  npx cleansweep --folders "cache" --force --log cleanup.log
+  npx cleansweep -fo "cache" -f -lg cleanup.log
+    `);
+
+  program.parse(process.argv);
+  const options = program.opts();
+
+  // Build configuration
+  const config: Config = {
+    dryRun: options.dryRun || false,
+    interactive: options.interactive || false,
+    force: options.force || false,
+    preview: options.preview || false,
+    logFile: options.log,
+    outputFormat: options.format === 'json' ? 'json' : 'plain',
+    maxDepth: options.depth,
+    filesPattern: options.files,
+    foldersPattern: options.folders,
+    typesPattern: options.types,
+    excludePatterns: options.exclude || []
+  };
+
+  // Validate that at least one pattern is specified
+  if (!config.filesPattern && !config.foldersPattern && !config.typesPattern) {
+    console.error('Error: At least one of --files, --folders, or --types must be specified');
+    program.help();
+    process.exit(1);
+  }
+
+  // Validate output format
+  if (config.outputFormat !== 'plain' && config.outputFormat !== 'json') {
+    console.error("Error: --format must be 'plain' or 'json'");
+    process.exit(1);
+  }
+
+  // Validate depth if provided
+  if (config.maxDepth !== undefined && (isNaN(config.maxDepth) || config.maxDepth < 1)) {
+    console.error('Error: --depth must be a positive number');
+    process.exit(1);
+  }
+
+  // Initialize logger
+  const logger = new Logger(config.logFile, config.outputFormat);
+
+  // Initialize log file
+  logger.initializeLogFile({
+    dryRun: config.dryRun,
+    interactive: config.interactive,
+    force: config.force,
+    filesPattern: config.filesPattern,
+    foldersPattern: config.foldersPattern,
+    typesPattern: config.typesPattern,
+    excludePatterns: config.excludePatterns,
+    maxDepth: config.maxDepth
+  });
+
+  // Log start of operation
+  logger.log('Starting deletion operation...', 'INFO');
+
+  try {
+    // Create deletion engine
+    const engine = new DeletionEngine(config, logger);
+
+    // Collect items to delete
+    await engine.collectItemsToDelete();
+
+    // Process deletions
+    await engine.processDeletions();
+
+    // Print summary
+    engine.printSummary();
+
+    // Exit with appropriate code
+    process.exit(engine.getExitCode());
+  } catch (error) {
+    logger.log(`Error: ${error instanceof Error ? error.message : String(error)}`, 'ERROR');
+    process.exit(1);
+  }
+}
+
+// Run main function
+main().catch((error) => {
+  console.error('Fatal error:', error);
+  process.exit(1);
+});
+

package/src/core/deletionEngine.ts

@@ -0,0 +1,219 @@
+/**
+ * Deletion Engine for cleansweep
+ * Core logic for collecting and processing deletions
+ */
+
+import { Config, DeletionResult } from '../types';
+import { Logger } from '../utils/logger';
+import {
+  findFiles,
+  findDirectories,
+  findItems,
+  shouldExclude,
+  deleteItem,
+  isFile,
+  isDirectory
+} from '../utils/fileUtils';
+import { confirmDeletion, confirmProceed } from '../utils/prompts';
+
+export class DeletionEngine {
+  private config: Config;
+  private logger: Logger;
+  private itemsToDelete: string[] = [];
+  private deletedItems: string[] = [];
+  private failedDeletions: string[] = [];
+
+  constructor(config: Config, logger: Logger) {
+    this.config = config;
+    this.logger = logger;
+  }
+
+  /**
+   * Collects all items (files/folders) that match the specified patterns
+   * and stores them in the itemsToDelete array
+   */
+  async collectItemsToDelete(): Promise<void> {
+    this.itemsToDelete = [];
+    const allItems: string[] = [];
+
+    // Process file patterns
+    if (this.config.filesPattern) {
+      const files = await findFiles(
+        this.config.filesPattern,
+        this.config.maxDepth
+      );
+      allItems.push(...files);
+    }
+
+    // Process folder patterns
+    if (this.config.foldersPattern) {
+      const dirs = await findDirectories(
+        this.config.foldersPattern,
+        this.config.maxDepth
+      );
+      allItems.push(...dirs);
+    }
+
+    // Process types pattern (can match both files and directories)
+    if (this.config.typesPattern) {
+      const items = await findItems(
+        this.config.typesPattern,
+        this.config.maxDepth
+      );
+      allItems.push(...items);
+    }
+
+    // Filter out excluded items and remove duplicates
+    const uniqueItems = [...new Set(allItems)];
+    for (const item of uniqueItems) {
+      if (!shouldExclude(item, this.config.excludePatterns)) {
+        this.itemsToDelete.push(item);
+      }
+    }
+
+    // Sort for consistent output
+    this.itemsToDelete.sort();
+  }
+
+  /**
+   * Displays a preview of all items that will be deleted
+   */
+  displayPreview(): void {
+    if (this.itemsToDelete.length === 0) {
+      this.logger.log('No items found matching the specified patterns.', 'INFO');
+      return;
+    }
+
+    this.logger.log(
+      `Preview: Items that will be deleted (${this.itemsToDelete.length} items):`,
+      'INFO'
+    );
+
+    if (this.config.outputFormat === 'json') {
+      const items = this.itemsToDelete.map(path => ({ path }));
+      console.log(JSON.stringify({ items }, null, 2));
+    } else {
+      for (const item of this.itemsToDelete) {
+        console.log(`  - ${item}`);
+      }
+    }
+  }
+
+  /**
+   * Deletes a single item (file or directory) with appropriate logging
+   * @param item - Path of the item to delete
+   */
+  async deleteItem(item: string): Promise<void> {
+    // Skip if dry run
+    if (this.config.dryRun) {
+      this.logger.log(`Would delete: ${item}`, 'INFO');
+      this.deletedItems.push(item);
+      return;
+    }
+
+    // Interactive confirmation
+    if (this.config.interactive) {
+      const confirmed = await confirmDeletion(item, this.config.force);
+      if (!confirmed) {
+        this.logger.log(`Skipped: ${item}`, 'INFO');
+        return;
+      }
+    }
+
+    // Perform deletion
+    if (isDirectory(item)) {
+      if (deleteItem(item)) {
+        this.logger.log(`Deleted directory: ${item}`, 'INFO');
+        this.deletedItems.push(item);
+      } else {
+        this.logger.log(`Failed to delete directory: ${item}`, 'ERROR');
+        this.failedDeletions.push(item);
+      }
+    } else if (isFile(item)) {
+      if (deleteItem(item)) {
+        this.logger.log(`Deleted file: ${item}`, 'INFO');
+        this.deletedItems.push(item);
+      } else {
+        this.logger.log(`Failed to delete file: ${item}`, 'ERROR');
+        this.failedDeletions.push(item);
+      }
+    } else {
+      this.logger.log(`Item not found or already deleted: ${item}`, 'WARNING');
+    }
+  }
+
+  /**
+   * Processes all collected items for deletion based on the current mode
+   */
+  async processDeletions(): Promise<void> {
+    if (this.itemsToDelete.length === 0) {
+      this.logger.log('No items to delete.', 'INFO');
+      return;
+    }
+
+    // Show preview if requested
+    if (this.config.preview) {
+      this.displayPreview();
+      if (!this.config.dryRun && !this.config.force) {
+        const proceed = await confirmProceed();
+        if (!proceed) {
+          this.logger.log('Deletion cancelled by user.', 'INFO');
+          return;
+        }
+      }
+    }
+
+    // Process each item
+    for (const item of this.itemsToDelete) {
+      await this.deleteItem(item);
+    }
+  }
+
+  /**
+   * Gets the deletion summary
+   * @returns DeletionResult object with statistics
+   */
+  getSummary(): DeletionResult {
+    return {
+      totalItems: this.itemsToDelete.length,
+      deleted: this.deletedItems.length,
+      failed: this.failedDeletions.length,
+      dryRun: this.config.dryRun,
+      failedItems: this.failedDeletions.length > 0 ? this.failedDeletions : undefined
+    };
+  }
+
+  /**
+   * Prints a summary of the deletion operation
+   */
+  printSummary(): void {
+    const summary = this.getSummary();
+
+    if (this.config.outputFormat === 'json') {
+      console.log(JSON.stringify({ summary }, null, 2));
+    } else {
+      this.logger.log('=== Deletion Summary ===', 'INFO');
+      this.logger.log(`Total items found: ${summary.totalItems}`, 'INFO');
+      if (summary.dryRun) {
+        this.logger.log(`Items that would be deleted: ${summary.deleted}`, 'INFO');
+      } else {
+        this.logger.log(`Items successfully deleted: ${summary.deleted}`, 'INFO');
+      }
+      if (summary.failed > 0 && summary.failedItems) {
+        this.logger.log(`Failed deletions: ${summary.failed}`, 'ERROR');
+        for (const item of summary.failedItems) {
+          this.logger.log(`  - ${item}`, 'ERROR');
+        }
+      }
+    }
+  }
+
+  /**
+   * Gets the exit code based on deletion results
+   * @returns 0 for success, 1 for failures
+   */
+  getExitCode(): number {
+    return this.failedDeletions.length > 0 ? 1 : 0;
+  }
+}
+

package/src/types.ts

@@ -0,0 +1,30 @@
+/**
+ * Type definitions for cleansweep
+ */
+
+export type LogLevel = 'INFO' | 'WARNING' | 'ERROR';
+
+export type OutputFormat = 'plain' | 'json';
+
+export interface Config {
+  dryRun: boolean;
+  interactive: boolean;
+  force: boolean;
+  preview: boolean;
+  logFile?: string;
+  outputFormat: OutputFormat;
+  maxDepth?: number;
+  filesPattern?: string;
+  foldersPattern?: string;
+  typesPattern?: string;
+  excludePatterns: string[];
+}
+
+export interface DeletionResult {
+  totalItems: number;
+  deleted: number;
+  failed: number;
+  dryRun: boolean;
+  failedItems?: string[];
+}
+