deepwork-node-watchdog 1.0.1 → 1.0.2

package/README.md

@@ -24,18 +24,45 @@ npm install deepwork-node-watchdog
 
 ## Uso como CLI
 
-### Iniciar el watchdog
+### Iniciar el watchdog con un archivo de lista negra
 
 ```bash
 deepwork-watchdog --blacklist /ruta/absoluta/a/blacklist.txt
 ```
 
+### Iniciar el watchdog con una lista de procesos separados por coma
+
+```bash
+deepwork-watchdog --blacklist discord,whatsapp,spotify
+```
+
+### Especificar intervalo de escaneo
+
+```bash
+deepwork-watchdog --blacklist discord,spotify --interval 5000
+```
+
 ### Listar procesos en ejecución
 
 ```bash
 deepwork-watchdog --list
 ```
 
+### Ver la versión
+
+```bash
+deepwork-watchdog --version
+```
+
+### Argumentos disponibles
+
+| Argumento      | Tipo      | Default | Descripción                                                                 |
+|----------------|-----------|---------|-----------------------------------------------------------------------------|
+| `--blacklist`  | `string`  | —       | Ruta absoluta a un archivo de lista negra, o nombres separados por coma     |
+| `--interval`   | `number`  | `3000`  | Intervalo entre escaneos en milisegundos                                    |
+| `--list`       | `boolean` | —       | Lista los procesos activos del sistema y termina                             |
+| `--version`    | `boolean` | —       | Muestra la versión del paquete y termina                                    |
+
 ### Archivo de lista negra (`blacklist.txt`)
 
 Cada línea es el nombre de un proceso a matar. Las líneas vacías y los comentarios (`#`) son ignorados. La extensión `.exe` es opcional.
@@ -52,13 +79,12 @@ spotify
 ## Uso como librería
 
 ```ts
-import { start, stop, isRunning, listProcesses } from 'deepwork-node-watchdog';
+import { start, stop, scan, isRunning, listProcesses } from 'deepwork-node-watchdog';
 
 // Iniciar el watchdog con una lista de procesos
 start({
   blacklist: ['discord', 'whatsapp', 'spotify'],
-  intervalMs: 5000,           // Intervalo de escaneo en ms (default: 3000)
-  logFile: 'watchdog.log',    // Opcional: archivo de log
+  intervalMs: 5000, // Intervalo de escaneo en ms (default: 3000)
 });
 
 // Detener el watchdog
@@ -67,41 +93,38 @@ stop();
 // Verificar si está corriendo
 console.log(isRunning()); // true | false
 
+// Escaneo único (sin loop)
+await scan(['discord', 'spotify']);
+
+// También acepta ruta a archivo de lista negra
+await scan('/ruta/absoluta/a/blacklist.txt');
+
 // Listar procesos activos
 const processes = await listProcesses();
 processes.forEach(p => console.log(`${p.name} (PID: ${p.pid})`));
 ```
 
-### También puedes usar un archivo de lista negra
-
-```ts
-start({
-  blacklistPath: '/ruta/absoluta/a/blacklist.txt',
-  intervalMs: 3000,
-});
-```
-
 ---
 
 ## API
 
 ### `start(options: WatchdogOptions): void`
 
-Inicia el watchdog. Si ya está corriendo, no hace nada.
+Inicia el watchdog en loop. Si ya está corriendo, no hace nada.
 
-| Opción          | Tipo       | Default          | Descripción                                      |
-|-----------------|------------|------------------|--------------------------------------------------|
-| `blacklist`     | `string[]` | —                | Lista de nombres de procesos a matar             |
-| `blacklistPath` | `string`   | —                | Ruta absoluta a un archivo de lista negra        |
-| `intervalMs`    | `number`   | `3000`           | Intervalo entre escaneos en milisegundos         |
-| `logFile`       | `string`   | —                | Ruta al archivo de log (opcional)                |
-
-> Se debe especificar `blacklist` o `blacklistPath`. Si no se especifica ninguno, el watchdog se inicia pero no hace nada.
+| Opción       | Tipo                  | Default | Descripción                                                       |
+|--------------|-----------------------|---------|-------------------------------------------------------------------|
+| `blacklist`  | `string \| string[]`  | —       | Ruta a un archivo de lista negra, o array de nombres de procesos  |
+| `intervalMs` | `number`              | `3000`  | Intervalo entre escaneos en milisegundos                          |
 
 ### `stop(): void`
 
 Detiene el watchdog y limpia el timer interno.
 
+### `scan(blacklist: string | string[]): Promise<void>`
+
+Ejecuta un escaneo único. Acepta un array de nombres de procesos o la ruta absoluta a un archivo de lista negra.
+
 ### `isRunning(): boolean`
 
 Retorna `true` si el watchdog está activo.
@@ -112,20 +135,6 @@ Retorna la lista de procesos activos en el sistema.
 
 ---
 
-## Configuración CLI (`watchdog.conf`)
-
-Cuando se usa como CLI, el watchdog lee un archivo `watchdog.conf` en el directorio de instalación:
-
-```ini
-# Intervalo entre escaneos (milisegundos)
-INTERVAL_MS=3000
-
-# Archivo de log (dejar vacío para desactivar)
-LOG_FILE=watchdog.log
-```
-
----
-
 ## Compatibilidad
 
 | Sistema operativo | Comando para listar | Comando para matar |
@@ -137,4 +146,4 @@ LOG_FILE=watchdog.log
 
 ## Licencia
 
-ISC — Kevin Javier Reyes
+ISC — Kevin Javier Reyes

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { WatchdogOptions } from "./watchdog.types";
+export declare function scan(blacklist: string[] | string): Promise<void>;
 export declare function start(options: WatchdogOptions): void;
 export declare function stop(): void;
 export declare function isRunning(): boolean;

package/dist/index.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.listProcesses = void 0;
+exports.scan = scan;
 exports.start = start;
 exports.stop = stop;
 exports.isRunning = isRunning;
@@ -15,22 +16,20 @@ let activeOptions = null;
 async function loop() {
     if (!running || !activeOptions)
         return;
-    const { blacklistPath, blacklist, intervalMs = 3000 } = activeOptions;
-    await watchdog_1.default.scan(blacklistPath ?? blacklist);
+    const { blacklist, intervalMs = 3000 } = activeOptions;
+    await watchdog_1.default.scan(blacklist);
     if (running) {
         timer = setTimeout(loop, intervalMs);
     }
 }
+async function scan(blacklist) {
+    return watchdog_1.default.scan(blacklist);
+}
 function start(options) {
     if (running)
         return;
     running = true;
     activeOptions = options;
-    if (!options.blacklistPath &&
-        (!options.blacklist || options.blacklist.length === 0)) {
-        (0, log_util_1.log)("No blacklist specified. Use options.blacklistPath or options.blacklist to set it.");
-        return;
-    }
     loop();
 }
 function stop() {

package/dist/main.js

@@ -15,7 +15,7 @@ const args = (0, args_lib_1.parseArgs)([
     {
         flag: "--blacklist",
         type: "string",
-        description: "Absolute path to blacklist file",
+        description: "Absolute path to blacklist file or a comma-separated list of process names",
     },
     {
         flag: "--list",
@@ -37,10 +37,11 @@ const args = (0, args_lib_1.parseArgs)([
 (0, log_util_1.log)("Process Watchdog started" +
     (args.blacklist ? ` with blacklist file: ${args.blacklist}` : ""));
 let running = true;
+let blacklistPathOrNames = null;
 let timer;
 function validateArgsRequirementsToScan() {
     if (!args.blacklist) {
-        (0, log_util_1.log)("No blacklist file specified. Use --blacklist <absolutePath> to set it.");
+        (0, log_util_1.log)("No blacklist file or process names specified. Use --blacklist <absolutePath> or a comma-separated list of process names to set it.");
         return false;
     }
     if (args.interval <= 0) {
@@ -56,19 +57,13 @@ async function loop() {
         return;
     }
     console.log("Scanning processes...");
-    await watchdog_1.default.scan(args.blacklist);
+    await watchdog_1.default.scan(blacklistPathOrNames);
     if (running) {
         timer = setTimeout(loop, args.interval);
     }
 }
 if (args.version) {
-    let pkg;
-    try {
-        pkg = require(path_1.default.resolve(__dirname, "../package.json"));
-    }
-    catch {
-        pkg = require(path_1.default.resolve(__dirname, "package.json"));
-    }
+    let pkg = require(path_1.default.resolve(__dirname, "../package.json"));
     console.log(`Process Watchdog version: ${pkg.version}`);
     process.exit(0);
 }
@@ -81,11 +76,17 @@ else if (args.list) {
     })();
 }
 else {
-    const blacklistAbsPath = path_1.default.isAbsolute(args.blacklist || "")
-        ? args.blacklist
-        : path_1.default.resolve(process.cwd(), args.blacklist || "");
-    args.blacklist = blacklistAbsPath;
-    console.log(`Using blacklist file: ${args.blacklist}`);
+    const blacklist = args.blacklist?.trim();
+    if (!blacklist) {
+        (0, log_util_1.log)("No blacklist file or process names specified. Use --blacklist <absolutePath> or a comma-separated list of process names to set it.");
+        process.exit(1);
+    }
+    blacklistPathOrNames = args.blacklist.includes(",")
+        ? args.blacklist.split(",").map((s) => s.trim())
+        : path_1.default.isAbsolute(args.blacklist || "")
+            ? args.blacklist
+            : path_1.default.resolve(process.cwd(), args.blacklist || "");
+    console.log(`Using blacklist file or names: ${blacklistPathOrNames}`);
     console.log(`Starting process scan loop with interval: ${args.interval}ms`);
     console.log("Press Ctrl+C to stop the watchdog.");
     loop();

package/dist/watchdog.types.d.ts

@@ -1,16 +1,4 @@
-export interface Config {
-    INTERVAL_MS: number;
-    LOG_FILE: string;
-}
-export interface Profile {
-    name: string;
-    path: string;
-    blacklistPath: string;
-    hasBlacklist: boolean;
-    processCount: number;
-}
 export interface WatchdogOptions {
-    blacklistPath?: string;
-    blacklist?: string[];
+    blacklist: string[] | string;
     intervalMs?: number;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepwork-node-watchdog",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "A Node.js watchdog for DeepWork.",
   "license": "ISC",
   "author": "Kevin Javier Reyes",
@@ -13,10 +13,12 @@
     "deepwork-watchdog": "dist/main.js"
   },
   "scripts": {
-    "start": "ts-node main.ts --blacklist blacklist.txt",
-    "dev": "ts-node-dev --respawn --transpile-only --ignore-watch node_modules main.ts --blacklist blacklist.txt",
-    "list": "ts-node main.ts --list",
-    "version": "ts-node main.ts --version",
+    "start": "ts-node src/main.ts --blacklist steam,epicgames,origin,ubisoft,riot,blizzard",
+    "list": "ts-node src/main.ts --list",
+    "version": "ts-node src/main.ts --version",
+    "start:dev": "ts-node-dev --respawn --transpile-only --ignore-watch node_modules src/main.ts --blacklist steam,epicgames,origin,ubisoft,riot,blizzard",
+    "list:dev": "ts-node-dev --respawn --transpile-only --ignore-watch node_modules src/main.ts --list",
+    "version:dev": "ts-node-dev --respawn --transpile-only --ignore-watch node_modules src/main.ts --version",
     "build": "tsc"
   },
   "devDependencies": {