devkill 0.12.2

package/lib/core/services/files/files.worker.service.d.ts

@@ -0,0 +1,90 @@
+import { type MessagePort } from 'node:worker_threads';
+import { Subject } from 'rxjs';
+import { EVENTS } from '../../../constants/workers.constants.js';
+import type { ScanOptions } from '../../index.js';
+import type { ScanStatus } from '../../interfaces/search-status.model.js';
+import type { LoggerService } from '../logger.service.js';
+export type WorkerStatus = 'stopped' | 'scanning' | 'dead' | 'finished';
+export interface WorkerScanOptions extends ScanOptions {
+    rootPath: string;
+}
+export type WorkerMessage = {
+    type: typeof EVENTS.scanResult;
+    value: {
+        results: Array<{
+            path: string;
+            isTarget: boolean;
+        }>;
+        workerId: number;
+        pending: number;
+    };
+} | {
+    type: typeof EVENTS.GetSizeResult;
+    value: {
+        results: {
+            path: string;
+            size: number;
+        };
+        workerId: number;
+        pending: number;
+    };
+} | {
+    type: typeof EVENTS.explore | typeof EVENTS.getFolderSize;
+    value: {
+        path: string;
+    };
+} | {
+    type: typeof EVENTS.exploreConfig;
+    value: WorkerScanOptions;
+} | {
+    type: typeof EVENTS.startup;
+    value: {
+        channel: MessagePort;
+        id: number;
+    };
+} | {
+    type: typeof EVENTS.alive;
+    value?: undefined;
+} | {
+    type: typeof EVENTS.stop;
+    value?: undefined;
+} | {
+    type: typeof EVENTS.error;
+    value: {
+        error: Error;
+    };
+};
+export interface WorkerStats {
+    pendingSearchTasks: number;
+    completedSearchTasks: number;
+    procs: number;
+}
+export declare class FileWorkerService {
+    private readonly logger;
+    private readonly searchStatus;
+    private index;
+    private workers;
+    private workersPendingJobs;
+    private getSizePendings;
+    private pendingJobs;
+    private totalJobs;
+    private tunnels;
+    private shouldStop;
+    private readonly SIZE_TIMEOUT_MS;
+    constructor(logger: LoggerService, searchStatus: ScanStatus);
+    startScan(stream$: Subject<string>, params: WorkerScanOptions): Promise<void>;
+    getFolderSize(stream$: Subject<number>, path: string): void;
+    stopScan(): void;
+    private listenEvents;
+    private newWorkerMessage;
+    /** Jobs are distributed following the round-robin algorithm. */
+    private addJob;
+    private checkJobComplete;
+    private instantiateWorkers;
+    private setWorkerConfig;
+    private killWorkers;
+    private getPendingJobs;
+    private updateStats;
+    private getWorkerPath;
+    private getOptimalNumberOfWorkers;
+}

package/lib/core/services/files/files.worker.service.js

@@ -0,0 +1,216 @@
+import os from 'node:os';
+import { dirname, extname } from 'node:path';
+import { MessageChannel, Worker } from 'node:worker_threads';
+import { Subject } from 'rxjs';
+import { EVENTS, MAX_WORKERS } from '../../../constants/workers.constants.js';
+export class FileWorkerService {
+    logger;
+    searchStatus;
+    index = 0;
+    workers = [];
+    workersPendingJobs = [];
+    getSizePendings = [];
+    pendingJobs = 0;
+    totalJobs = 0;
+    tunnels = [];
+    shouldStop = false;
+    SIZE_TIMEOUT_MS = 60000; // 1 minute timeout per folder
+    constructor(logger, searchStatus) {
+        this.logger = logger;
+        this.searchStatus = searchStatus;
+    }
+    async startScan(stream$, params) {
+        await this.killWorkers();
+        this.totalJobs = 0;
+        this.pendingJobs = 0;
+        this.index = 0;
+        this.workersPendingJobs = [];
+        this.shouldStop = false;
+        this.instantiateWorkers(this.getOptimalNumberOfWorkers());
+        this.listenEvents(stream$);
+        this.setWorkerConfig(params);
+        // Manually add the first job.
+        this.addJob({ job: EVENTS.explore, value: { path: params.rootPath } });
+    }
+    getFolderSize(stream$, path) {
+        if (this.workers.length === 0) {
+            this.instantiateWorkers(this.getOptimalNumberOfWorkers());
+            this.listenEvents(new Subject());
+            this.setWorkerConfig({ rootPath: path });
+        }
+        const timeoutId = setTimeout(() => {
+            const index = this.getSizePendings.findIndex((p) => p.path === path);
+            if (index !== -1) {
+                this.logger.error(`Timeout calculating size for: ${path} (${this.SIZE_TIMEOUT_MS}ms)`);
+                const pending = this.getSizePendings[index];
+                pending.stream$.error(new Error(`Timeout calculating size for ${path}`));
+                this.getSizePendings.splice(index, 1);
+            }
+        }, this.SIZE_TIMEOUT_MS);
+        this.getSizePendings.push({ path, stream$, timeoutId });
+        this.addJob({ job: EVENTS.getFolderSize, value: { path } });
+    }
+    stopScan() {
+        this.logger.info('Stopping scan...');
+        this.shouldStop = true;
+        this.searchStatus.workerStatus = 'stopped';
+        this.tunnels.forEach((tunnel) => {
+            tunnel.postMessage({
+                type: EVENTS.stop,
+                value: undefined,
+            });
+        });
+        void this.killWorkers();
+    }
+    listenEvents(stream$) {
+        this.tunnels.forEach((tunnel) => {
+            tunnel.on('message', (data) => {
+                this.newWorkerMessage(data, stream$);
+            });
+            this.workers.forEach((worker, index) => {
+                worker.on('exit', () => {
+                    this.logger.info(`Worker ${index} exited.`);
+                });
+                worker.on('error', (error) => {
+                    // Respawn worker.
+                    throw error;
+                });
+            });
+        });
+    }
+    newWorkerMessage(message, stream$) {
+        const { type, value } = message;
+        if (type === EVENTS.scanResult) {
+            const results = value.results;
+            const workerId = value.workerId;
+            this.workersPendingJobs[workerId] = value.pending;
+            results.forEach((result) => {
+                const { path, isTarget } = result;
+                if (isTarget) {
+                    stream$.next(path);
+                }
+                else if (!this.shouldStop) {
+                    this.addJob({
+                        job: EVENTS.explore,
+                        value: { path },
+                    });
+                }
+            });
+            this.pendingJobs = this.getPendingJobs();
+            this.checkJobComplete(stream$);
+        }
+        if (type === EVENTS.GetSizeResult) {
+            const result = value.results;
+            const workerId = value.workerId;
+            this.workersPendingJobs[workerId] = value.pending;
+            const index = this.getSizePendings.findIndex((pending) => pending.path === result.path);
+            if (index !== -1) {
+                const pending = this.getSizePendings[index];
+                if (pending.timeoutId) {
+                    clearTimeout(pending.timeoutId);
+                }
+                pending.stream$.next(result.size);
+                pending.stream$.complete();
+                this.getSizePendings.splice(index, 1);
+            }
+            this.pendingJobs = this.getPendingJobs();
+            this.checkJobComplete(stream$);
+        }
+        if (type === EVENTS.alive) {
+            this.searchStatus.workerStatus = 'scanning';
+        }
+        if (type === EVENTS.error) {
+            this.logger.error(`Worker error: ${value.error.message}`);
+        }
+    }
+    /** Jobs are distributed following the round-robin algorithm. */
+    addJob(job) {
+        if (this.shouldStop) {
+            return;
+        }
+        const tunnel = this.tunnels[this.index];
+        const message = { type: job.job, value: job.value };
+        tunnel.postMessage(message);
+        this.workersPendingJobs[this.index]++;
+        this.totalJobs++;
+        this.pendingJobs++;
+        this.index = this.index >= this.workers.length - 1 ? 0 : this.index + 1;
+    }
+    checkJobComplete(stream$) {
+        this.updateStats();
+        const isCompleted = this.getPendingJobs() === 0;
+        if (isCompleted) {
+            this.searchStatus.workerStatus = 'finished';
+            stream$.complete();
+            void this.killWorkers();
+        }
+    }
+    instantiateWorkers(amount) {
+        this.logger.info(`Instantiating ${amount} workers..`);
+        const workerPath = this.getWorkerPath();
+        // When running TypeScript source directly (dev/strip mode), workers need
+        // tsx's loader so that .js imports resolve to .ts files inside the worker.
+        const execArgv = workerPath.pathname.endsWith('.ts')
+            ? ['--import', 'tsx/esm']
+            : undefined;
+        for (let i = 0; i < amount; i++) {
+            const { port1, port2 } = new MessageChannel();
+            const worker = new Worker(workerPath, { execArgv });
+            this.tunnels.push(port1);
+            worker.postMessage({ type: EVENTS.startup, value: { channel: port2, id: i } }, [port2]);
+            this.workers.push(worker);
+            this.logger.info(`Worker ${i} instantiated.`);
+        }
+    }
+    setWorkerConfig(params) {
+        this.tunnels.forEach((tunnel) => tunnel.postMessage({
+            type: EVENTS.exploreConfig,
+            value: params,
+        }));
+    }
+    async killWorkers() {
+        this.getSizePendings.forEach((pending) => {
+            if (pending.timeoutId) {
+                clearTimeout(pending.timeoutId);
+            }
+            if (!pending.stream$.closed) {
+                pending.stream$.error(new Error('Workers terminated before completion'));
+            }
+        });
+        this.getSizePendings = [];
+        for (let i = 0; i < this.workers.length; i++) {
+            this.workers[i].removeAllListeners();
+            this.tunnels[i].removeAllListeners();
+            await this.workers[i]
+                .terminate()
+                .catch((error) => this.logger.error(error));
+        }
+        this.workers = [];
+        this.tunnels = [];
+    }
+    getPendingJobs() {
+        return this.workersPendingJobs.reduce((acc, x) => x + acc, 0);
+    }
+    updateStats() {
+        this.searchStatus.pendingSearchTasks = this.pendingJobs;
+        this.searchStatus.completedSearchTasks = this.totalJobs;
+        this.searchStatus.workersJobs = this.workersPendingJobs;
+    }
+    getWorkerPath() {
+        const actualFilePath = import.meta.url;
+        const dirPath = dirname(actualFilePath);
+        // Extension = .ts if is not transpiled.
+        // Extension = .js if is a build
+        const extension = extname(actualFilePath);
+        const workerName = 'files.worker';
+        return new URL(`${dirPath}/${workerName}${extension}`);
+    }
+    getOptimalNumberOfWorkers() {
+        const cores = os.cpus().length;
+        // TODO calculate amount of RAM available and take it
+        // as part on the ecuation.
+        const numWorkers = cores > MAX_WORKERS ? MAX_WORKERS : cores - 1;
+        return numWorkers < 1 ? 1 : numWorkers;
+    }
+}
+//# sourceMappingURL=files.worker.service.js.map

package/lib/core/services/files/files.worker.service.js.map

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

package/lib/core/services/files/index.d.ts

@@ -0,0 +1,4 @@
+export * from './files.service.js';
+export * from './files.worker.service.js';
+export * from './unix-files.service.js';
+export * from './windows-files.service.js';

package/lib/core/services/files/index.js

@@ -0,0 +1,5 @@
+export * from './files.service.js';
+export * from './files.worker.service.js';
+export * from './unix-files.service.js';
+export * from './windows-files.service.js';
+//# sourceMappingURL=index.js.map

package/lib/core/services/files/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/services/files/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC"}

package/lib/core/services/files/unix-files.service.d.ts

@@ -0,0 +1,9 @@
+import type { StreamService } from '../stream.service.js';
+import { FileService } from './files.service.js';
+import type { FileWorkerService } from './files.worker.service.js';
+export declare class UnixFilesService extends FileService {
+    protected streamService: StreamService;
+    fileWorkerService: FileWorkerService;
+    constructor(streamService: StreamService, fileWorkerService: FileWorkerService);
+    deleteDir(path: string): Promise<boolean>;
+}

package/lib/core/services/files/unix-files.service.js

@@ -0,0 +1,28 @@
+import { exec } from 'node:child_process';
+import { FileService } from './files.service.js';
+export class UnixFilesService extends FileService {
+    streamService;
+    fileWorkerService;
+    constructor(streamService, fileWorkerService) {
+        super(fileWorkerService);
+        this.streamService = streamService;
+        this.fileWorkerService = fileWorkerService;
+    }
+    async deleteDir(path) {
+        return new Promise((resolve, reject) => {
+            const command = `rm -rf "${path}"`;
+            exec(command, (error, stdout, stderr) => {
+                if (error !== null) {
+                    reject(error);
+                    return;
+                }
+                if (stderr !== '') {
+                    reject(stderr);
+                    return;
+                }
+                resolve(true);
+            });
+        });
+    }
+}
+//# sourceMappingURL=unix-files.service.js.map

package/lib/core/services/files/unix-files.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unix-files.service.js","sourceRoot":"","sources":["../../../../src/core/services/files/unix-files.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAK1C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,MAAM,OAAO,gBAAiB,SAAQ,WAAW;IAEnC;IACM;IAFlB,YACY,aAA4B,EACtB,iBAAoC;QAEpD,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAHf,kBAAa,GAAb,aAAa,CAAe;QACtB,sBAAiB,GAAjB,iBAAiB,CAAmB;IAGtD,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAY;QAC1B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,OAAO,GAAG,WAAW,IAAI,GAAG,CAAC;YACnC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;gBACtC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBACnB,MAAM,CAAC,KAAK,CAAC,CAAC;oBACd,OAAO;gBACT,CAAC;gBACD,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;oBAClB,MAAM,CAAC,MAAM,CAAC,CAAC;oBACf,OAAO;gBACT,CAAC;gBACD,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/lib/core/services/files/windows-files.service.d.ts

@@ -0,0 +1,9 @@
+import type { StreamService } from '../stream.service.js';
+import { FileService } from './files.service.js';
+import type { FileWorkerService } from './files.worker.service.js';
+export declare class WindowsFilesService extends FileService {
+    private readonly streamService;
+    fileWorkerService: FileWorkerService;
+    constructor(streamService: StreamService, fileWorkerService: FileWorkerService);
+    deleteDir(path: string): Promise<boolean>;
+}

package/lib/core/services/files/windows-files.service.js

@@ -0,0 +1,16 @@
+import { rm } from 'node:fs/promises';
+import { FileService } from './files.service.js';
+export class WindowsFilesService extends FileService {
+    streamService;
+    fileWorkerService;
+    constructor(streamService, fileWorkerService) {
+        super(fileWorkerService);
+        this.streamService = streamService;
+        this.fileWorkerService = fileWorkerService;
+    }
+    async deleteDir(path) {
+        await rm(path, { recursive: true, force: true });
+        return true;
+    }
+}
+//# sourceMappingURL=windows-files.service.js.map

package/lib/core/services/files/windows-files.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows-files.service.js","sourceRoot":"","sources":["../../../../src/core/services/files/windows-files.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAItC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAE/B;IACD;IAFlB,YACmB,aAA4B,EAC7B,iBAAoC;QAEpD,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAHR,kBAAa,GAAb,aAAa,CAAe;QAC7B,sBAAiB,GAAjB,iBAAiB,CAAmB;IAGtD,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAY;QAC1B,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/lib/core/services/index.d.ts

@@ -0,0 +1,5 @@
+export * from './logger.service.js';
+export * from './stream.service.js';
+export * from './config.service.js';
+export * from './profiles.service.js';
+export * from './files/index.js';

package/lib/core/services/index.js

@@ -0,0 +1,6 @@
+export * from './logger.service.js';
+export * from './stream.service.js';
+export * from './config.service.js';
+export * from './profiles.service.js';
+export * from './files/index.js';
+//# sourceMappingURL=index.js.map

package/lib/core/services/index.js.map

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

package/lib/core/services/logger.service.d.ts

@@ -0,0 +1,22 @@
+import type { ILoggerService, LogEntry } from '@core/interfaces/logger-service.interface.js';
+import { type Observable } from 'rxjs';
+/**
+ * Implementation of the logging service for npkill.
+ * Manages application logs with different severity levels and provides
+ * reactive streams for log observation and file output capabilities.
+ */
+export declare class LoggerService implements ILoggerService {
+    private log;
+    private logSubject;
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    get(type?: 'all' | 'info' | 'warn' | 'error'): LogEntry[];
+    getLog$(): Observable<LogEntry[]>;
+    getLogByType$(type?: 'all' | 'info' | 'warn' | 'error'): Observable<LogEntry[]>;
+    saveToFile(path: string): void;
+    getSuggestLogFilePath(): string;
+    private rotateLogFile;
+    private addToLog;
+    private getTimestamp;
+}

package/lib/core/services/logger.service.js

@@ -0,0 +1,84 @@
+import { existsSync, renameSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { basename, dirname, join } from 'node:path';
+import { BehaviorSubject } from 'rxjs';
+import { map } from 'rxjs/operators';
+const LATEST_TAG = 'latest';
+const OLD_TAG = 'old';
+/**
+ * Implementation of the logging service for npkill.
+ * Manages application logs with different severity levels and provides
+ * reactive streams for log observation and file output capabilities.
+ */
+export class LoggerService {
+    log = [];
+    logSubject = new BehaviorSubject([]);
+    info(message) {
+        this.addToLog({
+            type: 'info',
+            timestamp: this.getTimestamp(),
+            message,
+        });
+    }
+    warn(message) {
+        this.addToLog({
+            type: 'warn',
+            timestamp: this.getTimestamp(),
+            message,
+        });
+    }
+    error(message) {
+        this.addToLog({
+            type: 'error',
+            timestamp: this.getTimestamp(),
+            message,
+        });
+    }
+    get(type = 'all') {
+        if (type === 'all') {
+            return this.log;
+        }
+        return this.log.filter((entry) => entry.type === type);
+    }
+    getLog$() {
+        return this.logSubject.asObservable();
+    }
+    getLogByType$(type = 'all') {
+        return this.logSubject
+            .asObservable()
+            .pipe(map((entries) => type === 'all'
+            ? entries
+            : entries.filter((entry) => entry.type === type)));
+    }
+    saveToFile(path) {
+        const convertTime = (timestamp) => timestamp;
+        const content = this.log.reduce((log, actual) => {
+            const line = `[${convertTime(actual.timestamp)}](${actual.type}) ${actual.message}\n`;
+            return log + line;
+        }, '');
+        this.rotateLogFile(path);
+        writeFileSync(path, content);
+    }
+    getSuggestLogFilePath() {
+        const filename = `devkill-${LATEST_TAG}.log`;
+        return join(tmpdir(), filename);
+    }
+    rotateLogFile(newLogPath) {
+        if (!existsSync(newLogPath)) {
+            return; // Rotation is not necessary
+        }
+        const basePath = dirname(newLogPath);
+        const logName = basename(newLogPath);
+        const oldLogName = logName.replace(LATEST_TAG, OLD_TAG);
+        const oldLogPath = join(basePath, oldLogName);
+        renameSync(newLogPath, oldLogPath);
+    }
+    addToLog(entry) {
+        this.log = [...this.log, entry];
+        this.logSubject.next(this.log);
+    }
+    getTimestamp() {
+        return new Date().getTime();
+    }
+}
+//# sourceMappingURL=logger.service.js.map

package/lib/core/services/logger.service.js.map

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

package/lib/core/services/profiles.service.d.ts

@@ -0,0 +1,54 @@
+import type { PROFILE } from '../interfaces/profile.interface.js';
+export type ProfileFilterType = 'base' | 'user' | 'all';
+/**
+ * Service responsible for managing profiles.
+ * Handles profile registration, retrieval, and target resolution.
+ */
+export declare class ProfilesService {
+    private userDefinedProfiles;
+    /**
+     * Sets user-defined profiles loaded from .npkillrc configuration.
+     * @param profiles Record of user-defined profile configurations
+     */
+    setUserDefinedProfiles(profiles: Record<string, PROFILE>): void;
+    /**
+     * Gets profiles based on the specified filter type.
+     * @param filterType Type of profiles to retrieve:
+     *   - 'base': Only built-in profiles
+     *   - 'user': Only user-defined profiles from .npkillrc
+     *   - 'all': Both base and user-defined (user profiles override base)
+     * @returns Record of profiles matching the filter
+     */
+    getProfiles(filterType?: ProfileFilterType): Record<string, PROFILE>;
+    /**
+     * Gets a specific profile by name.
+     * Searches user-defined profiles first, then base profiles.
+     * @param name Name of the profile to retrieve
+     * @returns The profile if found, undefined otherwise
+     */
+    getProfileByName(name: string): PROFILE | undefined;
+    /**
+     * Checks if a profile with the given name exists.
+     * @param name Name of the profile to check
+     * @returns true if the profile exists, false otherwise
+     */
+    hasProfile(name: string): boolean;
+    /**
+     * Gets the targets from multiple profiles by their names.
+     * Combines targets from all specified profiles, removing duplicates.
+     * @param profileNames Array of profile names to get targets from
+     * @returns Array of unique target directory names
+     */
+    getTargetsFromProfiles(profileNames: string[]): string[];
+    /**
+     * Validates an array of profile names.
+     * @param profileNames Array of profile names to validate
+     * @returns Array of invalid profile names (profiles that don't exist)
+     */
+    getInvalidProfileNames(profileNames: string[]): string[];
+    /**
+     * Gets the default profile name.
+     * @returns Name of the default profile
+     */
+    getDefaultProfileName(): string;
+}