devkill 0.12.2

package/lib/core/constants/profiles.constants.js

@@ -0,0 +1,138 @@
+export const DEFAULT_PROFILE = 'node';
+export const BASE_PROFILES = {
+    node: {
+        description: 'All the usual suspects related with the node/web/javascript dev toolchain: node_modules, caches, build artifacts, and assorted JavaScript junk. Safe to clean and your disk will thank you.',
+        targets: [
+            'node_modules',
+            '.npm',
+            '.pnpm-store',
+            '.next',
+            '.nuxt',
+            '.angular',
+            '.svelte-kit',
+            '.vite',
+            '.nx',
+            '.turbo',
+            '.parcel-cache',
+            '.rpt2_cache',
+            '.eslintcache',
+            '.esbuild',
+            '.cache',
+            '.rollup.cache',
+            'storybook-static',
+            'coverage',
+            '.nyc_output',
+            '.jest',
+            'gatsby_cache',
+            '.docusaurus',
+            '.swc',
+            '.stylelintcache',
+            'deno_cache',
+        ],
+    },
+    python: {
+        description: "The usual Python leftovers — caches, virtual environments, and test artifacts. Safe to clear once you've closed your IDE and virtualenvs.",
+        targets: [
+            '__pycache__',
+            '.pytest_cache',
+            '.mypy_cache',
+            '.ruff_cache',
+            '.tox',
+            '.nox',
+            '.pytype',
+            '.pyre',
+            'htmlcov',
+            '.venv',
+            'venv',
+        ],
+    },
+    'data-science': {
+        description: 'Jupyter checkpoints, virtualenvs, MLflow runs, and experiment outputs. Great for learning, terrible for disk space.',
+        targets: [
+            '.ipynb_checkpoints',
+            '__pycache__',
+            '.venv',
+            'venv',
+            'outputs',
+            '.dvc',
+            '.mlruns',
+        ],
+    },
+    java: {
+        description: 'Build outputs and Gradle junk.',
+        targets: ['target', '.gradle', 'out'],
+    },
+    android: {
+        description: "Native build caches and intermediate files from Android Studio. Deleting won't hurt, but expect a rebuild marathon next time.",
+        targets: ['.cxx', 'externalNativeBuild'],
+    },
+    swift: {
+        description: "Xcode's playground leftovers and Swift package builds. Heavy, harmless, and happy to go.",
+        targets: ['DerivedData', '.swiftpm'],
+    },
+    dotnet: {
+        description: "Compilation artifacts and Visual Studio cache folders. Disposable once you're done building or testing.",
+        targets: ['obj', 'TestResults', '.vs'],
+    },
+    rust: {
+        description: 'Cargo build targets. Huge, regenerable, and surprisingly clingy, your disk will appreciate the reset.',
+        targets: ['target'],
+    },
+    ruby: {
+        description: 'Bundler caches and dependency leftovers.',
+        targets: ['.bundle'],
+    },
+    elixir: {
+        description: 'Mix build folders, dependencies, and coverage reports. Easy to regenerate, safe to purge.',
+        targets: ['_build', 'deps', 'cover'],
+    },
+    haskell: {
+        description: "GHC and Stack build outputs. A collection of intermediate binaries you definitely don't need anymore.",
+        targets: ['dist-newstyle', '.stack-work'],
+    },
+    scala: {
+        description: 'Bloop, Metals, and build outputs from Scala projects.',
+        targets: ['.bloop', '.metals', 'target'],
+    },
+    cpp: {
+        description: 'CMake build directories and temporary artifacts. Rebuilds take time, but space is priceless.',
+        targets: ['CMakeFiles', 'cmake-build-debug', 'cmake-build-release'],
+    },
+    unity: {
+        description: "Unity's cache and build artifacts. Expect longer load times next launch but it can save tons of space on unused projects.",
+        targets: ['Library', 'Temp', 'Obj'],
+    },
+    unreal: {
+        description: 'Intermediate and binary build caches. Safe to clean. Unreal will (happily?) recompile.',
+        targets: ['Intermediate', 'DerivedDataCache', 'Binaries'],
+    },
+    godot: {
+        description: 'Editor caches and import data. Godot can recreate these in a blink.',
+        targets: ['.import', '.godot'],
+    },
+    infra: {
+        description: 'Leftovers from deployment tools like Serverless, Vercel, Netlify, and Terraform.',
+        targets: [
+            '.serverless',
+            '.vercel',
+            '.netlify',
+            '.terraform',
+            '.sass-cache',
+            '.cpcache',
+            'elm_stuff',
+            'nimcache',
+            'deno_cache',
+        ],
+    },
+};
+const ALL_TARGETS = [
+    ...new Set(Object.values(BASE_PROFILES).flatMap((profile) => profile.targets)),
+];
+export const DEFAULT_PROFILES = {
+    ...BASE_PROFILES,
+    all: {
+        targets: ALL_TARGETS,
+        description: 'Includes all targets listed above. Not recommended, as it mixes unrelated ecosystems and may remove context-specific data (a good recipe for chaos if used recklessly).',
+    },
+};
+//# sourceMappingURL=profiles.constants.js.map

package/lib/core/constants/profiles.constants.js.map

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

package/lib/core/devkill.d.ts

@@ -0,0 +1,25 @@
+import { type Observable } from 'rxjs';
+import type { DevkillInterface, IsValidRootFolderResult } from './interfaces/devkill.interface.js';
+import type { DeleteOptions, DeleteResult, GetNewestFileResult, GetSizeResult, ScanFoundFolder, ScanOptions } from './interfaces/folder.interface.js';
+import type { Services } from './interfaces/services.interface.js';
+import { LoggerService } from './services/logger.service.js';
+import type { LogEntry } from './interfaces/logger-service.interface.js';
+/**
+ * Main devkill class that implements the core directory scanning and cleanup functionality.
+ * Provides methods for recursive directory scanning, size calculation, file analysis,
+ * and safe deletion operations.
+ */
+export declare class Devkill implements DevkillInterface {
+    private readonly services;
+    constructor(customServices?: Partial<Services>);
+    private searchDuration;
+    startScan$(rootPath: string, options: ScanOptions): Observable<ScanFoundFolder>;
+    getSize$(path: string): Observable<GetSizeResult>;
+    getNewestFile$(path: string): Observable<GetNewestFileResult | null>;
+    delete$(path: string, options?: DeleteOptions): Observable<DeleteResult>;
+    getLogs$(): Observable<LogEntry[]>;
+    stopScan(): void;
+    isValidRootFolder(path: string): IsValidRootFolderResult;
+    getVersion(): string;
+    get logger(): LoggerService;
+}

package/lib/core/devkill.js

@@ -0,0 +1,129 @@
+import { from } from 'rxjs';
+import { catchError, filter, map, mergeMap, take, tap } from 'rxjs/operators';
+import { OSServiceMap } from '../constants/os-service-map.constants.js';
+import _dirname from '../dirname.js';
+import { ScanStatus } from './interfaces/search-status.model.js';
+import { FileWorkerService } from './services/files/index.js';
+import { LoggerService } from './services/logger.service.js';
+import { ProfilesService } from './services/profiles.service.js';
+import { StreamService } from './services/stream.service.js';
+import { ResultsService } from '../cli/services/results.service.js';
+import { getFileContent } from '../utils/get-file-content.js';
+/**
+ * Main devkill class that implements the core directory scanning and cleanup functionality.
+ * Provides methods for recursive directory scanning, size calculation, file analysis,
+ * and safe deletion operations.
+ */
+export class Devkill {
+    services;
+    constructor(customServices) {
+        const defaultServices = createDefaultServices(customServices?.searchStatus, customServices?.logger);
+        this.services = { ...defaultServices, ...customServices };
+        this.logger.info(process.argv.join(' '));
+        this.logger.info(`Devkill started! v${this.getVersion()}`);
+    }
+    searchDuration = 0;
+    startScan$(rootPath, options) {
+        const { fileService } = this.services;
+        this.logger.info(`Scan started in ${rootPath}`);
+        const startTime = Date.now();
+        return fileService.listDir(rootPath, options).pipe(catchError(() => {
+            throw new Error('Error while listing directories');
+        }), mergeMap((dataFolder) => from(splitData(dataFolder))), filter((path) => path !== ''), map((path) => {
+            if (options.performRiskAnalysis !== undefined &&
+                !options.performRiskAnalysis) {
+                return { path };
+            }
+            const riskAnalysis = fileService.isDangerous(path);
+            return {
+                path,
+                riskAnalysis,
+            };
+        }), tap((nodeFolder) => this.logger.info(`Folder found: ${String(nodeFolder.path)}`)), tap({
+            complete: () => {
+                this.searchDuration = (Date.now() - startTime) / 1000;
+                this.logger.info(`Search completed after ${this.searchDuration}s`);
+            },
+        }));
+    }
+    getSize$(path) {
+        const { fileService } = this.services;
+        this.logger.info(`Calculating folder size for ${String(path)}`);
+        return fileService.getFolderSize(path).pipe(take(1), map((size) => ({ size, unit: 'bytes' })), tap(({ size }) => this.logger.info(`Size of ${path}: ${size} bytes`)));
+    }
+    getNewestFile$(path) {
+        const { fileService } = this.services;
+        this.logger.info(`Calculating last mod. of ${path}`);
+        return from(fileService.getRecentModificationInDir(path)).pipe(tap((result) => {
+            if (!result) {
+                return;
+            }
+            this.logger.info(`Last mod. of ${path}: ${result.timestamp}`);
+        }));
+    }
+    delete$(path, options) {
+        const { fileService } = this.services;
+        this.logger.info(`Deleting ${String(path)} ${options?.dryRun ? '(dry run)' : ''}...`);
+        const deleteOperation = options?.dryRun
+            ? from(fileService.fakeDeleteDir())
+            : from(fileService.deleteDir(path));
+        return deleteOperation.pipe(map((result) => {
+            if (!result) {
+                this.logger.error(`Failed to delete ${String(path)}`);
+                return { path, success: false };
+            }
+            this.logger.info(`Deleted ${String(path)}: ${result}`);
+            return {
+                path,
+                success: result,
+            };
+        }));
+    }
+    getLogs$() {
+        return this.services.logger.getLog$();
+    }
+    stopScan() {
+        this.logger.info('Stopping scan...');
+        this.services.fileService.stopScan();
+    }
+    isValidRootFolder(path) {
+        return this.services.fileService.isValidRootFolder(path);
+    }
+    getVersion() {
+        const packageJson = `${_dirname}/../package.json`;
+        const packageData = JSON.parse(getFileContent(packageJson));
+        return packageData.version;
+    }
+    get logger() {
+        return this.services.logger;
+    }
+}
+function createDefaultServices(searchStatus, logger) {
+    const actualLogger = logger || new LoggerService();
+    const actualSearchStatus = searchStatus || new ScanStatus();
+    const fileWorkerService = new FileWorkerService(actualLogger, actualSearchStatus);
+    const streamService = new StreamService();
+    const resultsService = new ResultsService();
+    const profilesService = new ProfilesService();
+    const OSService = OSServiceMap[process.platform];
+    if (typeof OSService === 'undefined') {
+        throw new Error(`Unsupported platform: ${process.platform}. Cannot load OS service.`);
+    }
+    const fileService = new OSService(streamService, fileWorkerService);
+    return {
+        logger: actualLogger,
+        searchStatus: actualSearchStatus,
+        fileService,
+        fileWorkerService,
+        streamService,
+        resultsService,
+        profilesService,
+    };
+}
+function splitData(data, separator = '\n') {
+    if (data === '') {
+        return [];
+    }
+    return data.split(separator);
+}
+//# sourceMappingURL=devkill.js.map

package/lib/core/devkill.js.map

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

package/lib/core/index.d.ts

@@ -0,0 +1,4 @@
+export * from './devkill.js';
+export * from './interfaces/index.js';
+export * from './services/index.js';
+export * from './constants/index.js';

package/lib/core/index.js

@@ -0,0 +1,5 @@
+export * from './devkill.js';
+export * from './interfaces/index.js';
+export * from './services/index.js';
+export * from './constants/index.js';
+//# sourceMappingURL=index.js.map

package/lib/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}

package/lib/core/interfaces/devkill.interface.d.ts

@@ -0,0 +1,78 @@
+import type { LogEntry } from '@core/interfaces/logger-service.interface.js';
+import type { Observable } from 'rxjs';
+import type { DeleteOptions, DeleteResult, GetNewestFileResult, GetSizeOptions, GetSizeResult, ScanFoundFolder, ScanOptions } from './folder.interface.js';
+export type ProfileFilterType = 'base' | 'user' | 'all';
+/**
+ * Result of validating a root folder path.
+ */
+export interface IsValidRootFolderResult {
+    /** Whether the folder is valid as a root. */
+    isValid: boolean;
+    /** Reason for invalidity, if not valid. */
+    invalidReason?: string;
+}
+/**
+ * Devkill is a powerful search engine that allows you to scan the file system
+ * for specified directories. It also allows you to perform operations on them
+ * in order to clean them up.
+ */
+export interface DevkillInterface {
+    /**
+     * Starts the recursive search from the specified directory.
+     * @param rootPath Root directory to scan from.
+     * @param options Optional scan options.
+     * @returns Observable that emits the results that are found in real time.
+     */
+    startScan$(rootPath: string, options?: ScanOptions): Observable<ScanFoundFolder>;
+    /**
+     * Stops the current scan if any.
+     *
+     * Frees resources and terminates the observable returned by `startScan$`.
+     */
+    stopScan(): void;
+    /**
+     * Returns the total size of the contents of a directory.
+     * @param path Path to the directory.
+     * @param options Optional size options.
+     * @returns Observable that outputs a value with the result of the operation.
+     */
+    getSize$(path: string, options?: GetSizeOptions): Observable<GetSizeResult>;
+    /**
+     * Retrieves the most recently modified file (the one with the latest
+     * modification timestamp) within a given directory and its subdirectories,
+     * recursively.
+     * @param path Path to the directory.
+     * @returns Observable that outputs a value with the result of the
+     * operation. May return null if no files exist or the most recent file
+     * cannot be determined.
+     */
+    getNewestFile$(path: string): Observable<GetNewestFileResult | null>;
+    /**
+     * Deletes the specified directory. For security purposes, this directory
+     * must be contained within the `target` path defined when initiating the scan
+     * with `startScan$` or throw an exception.
+     * @param path Path to delete.
+     * @param options Optional delete options.
+     * @returns Observable emitting the delete result.
+     * @throws Error if the path is not within the target directory.
+     */
+    delete$(path: string, options?: DeleteOptions): Observable<DeleteResult>;
+    /**
+     * Gets the log stream generated by devkill.
+     * @returns Observable emitting an array of log entries.
+     */
+    getLogs$(): Observable<LogEntry[]>;
+    /**
+     * Checks if a given route has problems initiating a scan. Validates that the
+     * path belongs to a directory, that the directory exists and that there are
+     * no permissions issues.
+     * @param path Path to validate.
+     * @returns Result of validation.
+     */
+    isValidRootFolder(path: string): IsValidRootFolderResult;
+    /**
+     * Get the current version of devkill.
+     * @returns Version string defined in devkill's package.json.
+     */
+    getVersion(): string;
+}

package/lib/core/interfaces/devkill.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=devkill.interface.js.map

package/lib/core/interfaces/devkill.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devkill.interface.js","sourceRoot":"","sources":["../../../src/core/interfaces/devkill.interface.ts"],"names":[],"mappings":""}

package/lib/core/interfaces/devkillrc-config.interface.d.ts

@@ -0,0 +1,87 @@
+import type { PROFILE } from './profile.interface.js';
+/**
+ * Represents the structure of .devkillrc configuration file.
+ * All properties are optional as users may only override specific settings.
+ */
+export interface IDevkillrcConfig {
+    /**
+     * Absolute path from which the search will begin.
+     * @example "/home/user/my-projects/"
+     */
+    rootDir?: string;
+    /**
+     * Array of directory names to exclude from search.
+     * These directories and their subdirectories will be skipped.
+     * @example [".git", "important-project"]
+     */
+    exclude?: string[];
+    /**
+     * Default sort order for results.
+     * @default "none"
+     */
+    sortBy?: 'none' | 'size' | 'path' | 'age';
+    /**
+     * Unit for displaying folder sizes.
+     * - "auto": Sizes < 1024MB shown in MB, larger sizes in GB
+     * - "mb": Always show in megabytes
+     * - "gb": Always show in gigabytes
+     * @default "auto"
+     */
+    sizeUnit?: 'auto' | 'mb' | 'gb';
+    /**
+     * Exclude sensitive results.
+     * @default false
+     */
+    excludeSensitiveResults?: boolean;
+    /**
+     * Enable dry-run mode by default.
+     * When true, deletions are simulated (nothing is actually deleted).
+     * @default false
+     */
+    dryRun?: boolean;
+    /**
+     * Check for devkill updates on startup.
+     * @default true
+     */
+    checkUpdates?: boolean;
+    /**
+     * Profiles to use.
+     * @example ["node", "python"]
+     * @default ["node"]
+     */
+    defaultProfiles?: string[];
+    /**
+     * Custom profiles with specific target directories.
+     * Profile names can be used with the -p/--profiles flag.
+     * @example
+     * {
+     *   "webdev": {
+     *     "targets": ["node_modules", "dist", ".next"],
+     *     "description": "Web development artifacts"
+     *   },
+     *   "python": {
+     *     "targets": [".venv", "__pycache__"],
+     *     "description": "Python virtual environments and caches"
+     *   }
+     * }
+     */
+    profiles?: Record<string, PROFILE>;
+}
+/**
+ * Result of loading and parsing a .devkillrc configuration file.
+ */
+export interface IConfigLoadResult {
+    /**
+     * The parsed configuration, or null if loading failed.
+     */
+    config: IDevkillrcConfig | null;
+    /**
+     * Path to the configuration file that was loaded or attempted to load.
+     */
+    configPath: string;
+    /**
+     * Error message if loading or parsing failed.
+     */
+    error?: string;
+}
+export declare const VALID_DEVKILLRC_PROPERTIES: readonly ["rootDir", "exclude", "sortBy", "sizeUnit", "excludeSensitiveResults", "dryRun", "checkUpdates", "defaultProfiles", "profiles"];

package/lib/core/interfaces/devkillrc-config.interface.js

@@ -0,0 +1,12 @@
+export const VALID_DEVKILLRC_PROPERTIES = [
+    'rootDir',
+    'exclude',
+    'sortBy',
+    'sizeUnit',
+    'excludeSensitiveResults',
+    'dryRun',
+    'checkUpdates',
+    'defaultProfiles',
+    'profiles',
+];
+//# sourceMappingURL=devkillrc-config.interface.js.map

package/lib/core/interfaces/devkillrc-config.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devkillrc-config.interface.js","sourceRoot":"","sources":["../../../src/core/interfaces/devkillrc-config.interface.ts"],"names":[],"mappings":"AAmGA,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,SAAS;IACT,SAAS;IACT,QAAQ;IACR,UAAU;IACV,yBAAyB;IACzB,QAAQ;IACR,cAAc;IACd,iBAAiB;IACjB,UAAU;CAC4C,CAAC"}

package/lib/core/interfaces/file-service.interface.d.ts

@@ -0,0 +1,76 @@
+import type { Observable } from 'rxjs';
+import type { GetNewestFileResult, RiskAnalysis } from '../interfaces/index.js';
+import type { FileWorkerService } from '../services/files/files.worker.service.js';
+import type { IsValidRootFolderResult } from './devkill.interface.js';
+import type { ScanOptions } from './folder.interface.js';
+/**
+ * Core file system operations service for npkill.
+ * Provides methods for directory scanning, size calculation, deletion, and validation.
+ */
+export interface IFileService {
+    /** Worker service for handling file operations in background threads. */
+    fileWorkerService: FileWorkerService;
+    /**
+     * Calculates the total size of a directory.
+     * @param path Path to the directory to measure.
+     * @returns Observable emitting the size in bytes.
+     */
+    getFolderSize: (path: string) => Observable<number>;
+    /**
+     * Lists directories matching scan criteria.
+     * @param path Root path to start listing from.
+     * @param params Scan options for filtering and configuration.
+     * @returns Observable emitting found directory paths.
+     */
+    listDir: (path: string, params: ScanOptions) => Observable<string>;
+    /**
+     * Permanently deletes a directory and its contents.
+     * @param path Path to the directory to delete.
+     * @returns Promise resolving to true if deletion was successful.
+     */
+    deleteDir: (path: string) => Promise<boolean>;
+    /**
+     * Simulates directory deletion without actually removing files.
+     * @param _path Path to the directory that would be deleted.
+     * @returns Promise resolving to true (always succeeds for dry run).
+     */
+    fakeDeleteDir: (_path: string) => Promise<boolean>;
+    /**
+     * Validates whether a path is suitable as a scan root directory.
+     * @param path Path to validate.
+     * @returns Validation result with success status and error reason if invalid.
+     */
+    isValidRootFolder(path: string): IsValidRootFolderResult;
+    /**
+     * Analyzes a directory path for potential deletion risks.
+     * @param path Path to analyze for safety.
+     * @returns Risk analysis indicating if the path is dangerous to delete.
+     */
+    isDangerous: (path: string) => RiskAnalysis;
+    /**
+     * Finds the most recently modified file in a directory tree.
+     * @param path Root directory to search within.
+     * @returns Promise resolving to newest file info, or null if no files found.
+     */
+    getRecentModificationInDir: (path: string) => Promise<GetNewestFileResult | null>;
+    /**
+     * Retrieves file statistics for all files in a directory.
+     * @param dirname Directory to analyze.
+     * @returns Promise resolving to array of file statistics.
+     */
+    getFileStatsInDir: (dirname: string) => Promise<IFileStat[]>;
+    /**
+     * Stops any ongoing scan operations.
+     * Cancels workers and cleans up resources.
+     */
+    stopScan: () => void;
+}
+/**
+ * Statistical information about a file.
+ */
+export interface IFileStat {
+    /** Full path to the file. */
+    path: string;
+    /** Unix timestamp of the file's last modification. */
+    modificationTime: number;
+}

package/lib/core/interfaces/file-service.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=file-service.interface.js.map

package/lib/core/interfaces/file-service.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-service.interface.js","sourceRoot":"","sources":["../../../src/core/interfaces/file-service.interface.ts"],"names":[],"mappings":""}