@gnpdev/rpa-tools 1.0.12 → 1.0.14

package/README.md

@@ -23,6 +23,8 @@ Crea un archivo en tu proyecto (ej. `src/lib/rpa.js`) para inicializar y exporta
 // src/lib/rpa.js
 import { createRpaTools } from '@gnpdev/rpa-tools';
 import { Pool } from 'pg';
+import * as dotenv from 'dotenv';
+dotenv.config();
 
 // 1. Configura tu pool de base de datos (usualmente ya lo tienes)
 const pool = new Pool({
@@ -47,7 +49,14 @@ export const rpa = await createRpaTools({
   }
 })
 
+// 3. Exporta el objeto Logger
 export const logger = rpa.logger;
+
+// 4. Genera el objeto de estado para cambio de Paso a paso
+export const state = {
+  currentStep: 'Inicio'
+};
+
 ```
 
 ## Uso en la Aplicación
@@ -104,7 +113,7 @@ Captura el estado completo del bot cuando ocurre una excepción: Screenshot (.we
 
 ```javascript
 import { chromium } from 'playwright';
-import { rpa, logger } from './lib/rpa.js';
+import { rpa, logger, state } from './lib/rpa.js';
 
 const browser = await chromium.launch({ headless: true });
 const context = await browser.newContext();
@@ -118,16 +127,15 @@ const page    = await context.newPage();
     snapshots:   true,
   });
 
-let currentStep = 'Inicio';
 
 try {
   // Lógica de tu bot...
   await page.goto('https://example.com');
   
-  currentStep = 'Login';
+  state.currentStep = 'Login';
   await login(page);
 
-  currentStep = 'Procesar Datos';
+  state.currentStep = 'Procesar Datos';
   await page.click('#boton-inexistente');
 } catch (err) {
   // Captura automática de evidencia
@@ -135,7 +143,7 @@ try {
     page,
     context,
     err,
-    step: currentStep 
+    step: state.currentStep 
   });
 
   logger.error({ errorId, step: currentStep }, 'Fallo crítico capturado');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gnpdev/rpa-tools",
-  "version": "1.0.12",
+  "version": "1.0.14",
   "description": "Libreria para logs y screenshot de bots",
   "author": "Sergio Antonio Trujillo del Valle",
   "main": "src/index.js",

package/src/index.d.ts

@@ -57,6 +57,22 @@ export interface RpaTools {
    */
   watchDebugFlag: (page: Page, pollMs?: number) => void;
 
+  /**
+   * Recupera credenciales de una aplicación desde la base de datos.
+   * @param nombre - Nombre de la aplicación (ej. 'Portal CRM')
+   */
+  getCredentials: (nombre: string) => Promise<{ usuario: string; password: string; idUsuario: string } | null>;
+
+  /**
+   * Captura screenshot, trace y registra error en base de datos.
+   */
+  captureError: (params: {
+    page: Page;
+    context: any;
+    err: Error;
+    step?: string;
+  }) => Promise<{ errorId: number | null; screenshotKey: string | null; traceKey: string | null }>;
+
   /** Detiene todos los intervalos. Llamar siempre al cerrar el bot. */
   destroy: () => void;
 }
@@ -64,12 +80,5 @@ export interface RpaTools {
 // ── Export principal ─────────────────────────────────────────────────────────
 /**
  * Inicializa la librería rpa-tools.
- * Crea el cliente MinIO, verifica el bucket y retorna
- * el logger y el watcher listos para usar.
- *
- * @example
- * const rpa = await createRpaTools({ botId: 'bot-001', db: pool });
- * rpa.watchDebugFlag(page);
- * rpa.logger.info('Bot iniciado');
  */
-export function createRpaTools(options: RpaToolsOptions): Promise<RpaTools>;
+export function createRpaTools(options: RpaToolsOptions): Promise<RpaTools>;