@ssolis-ti/mcp-compra-agil 1.0.3 → 2.3.0

package/dist/utils/redact.js

@@ -0,0 +1,100 @@
+/**
+ * Redacción de secretos: punto único de estrangulamiento.
+ *
+ * POR QUÉ EXISTE
+ * El ticket de acceso viaja en la query string del endpoint legado
+ * (/servicios/.../OrdenCompra.json). Se verificó empíricamente que algunos
+ * errores de `fetch` incluyen la URL completa en su mensaje:
+ *
+ *   TypeError: Failed to parse URL from http://host/x?ticket=SECRETO
+ *
+ * Ese texto termina en la respuesta de la tool → contexto del LLM →
+ * transcripción, logs y capturas de pantalla. Auditar caso por caso cada
+ * `String(error)` es una batalla perdida: siempre aparecerá una ruta nueva.
+ *
+ * En vez de eso, TODO string que sale del proceso pasa por `redact()`.
+ * Aunque surja un camino de error imprevisto, el secreto no se escapa.
+ *
+ * Se aplica en tres puntos: el logger, el error-handler y los catch de tools.
+ */
+const MARCA = '[REDACTED]';
+/** Longitud mínima para registrar un secreto: evita redactar palabras comunes. */
+const LARGO_MINIMO = 8;
+const secretos = new Set();
+/**
+ * Registra un valor secreto para que sea removido de toda salida.
+ * Idempotente y seguro de llamar con undefined.
+ */
+export function registrarSecreto(valor) {
+    if (!valor)
+        return;
+    const v = valor.trim();
+    // Un secreto muy corto redactaría texto legítimo por coincidencia.
+    if (v.length < LARGO_MINIMO)
+        return;
+    secretos.add(v);
+    // La misma credencial puede aparecer URL-encodeada dentro de una URL.
+    const encoded = encodeURIComponent(v);
+    if (encoded !== v)
+        secretos.add(encoded);
+}
+/** Solo para tests: limpia los secretos registrados. */
+export function _resetSecretos() {
+    secretos.clear();
+}
+/** Cantidad de secretos registrados (diagnóstico). */
+export function secretosRegistrados() {
+    return secretos.size;
+}
+/**
+ * Elimina cualquier secreto conocido de un texto.
+ *
+ * Defensa en dos capas:
+ * 1. Coincidencia exacta de los secretos registrados.
+ * 2. Patrón `ticket=<valor>` en query strings — cubre el caso en que el
+ *    secreto no alcanzó a registrarse (ej. error durante el arranque).
+ */
+export function redact(texto) {
+    if (!texto)
+        return texto;
+    let out = texto;
+    for (const s of secretos) {
+        if (out.includes(s)) {
+            out = out.split(s).join(MARCA);
+        }
+    }
+    // Capa 2: cualquier ticket= en una URL, esté o no registrado.
+    out = out.replace(/([?&]ticket=)[^&\s"'<>)\]]+/gi, `$1${MARCA}`);
+    // Capa 2b: header/JSON con forma "ticket": "valor"
+    out = out.replace(/(["']?ticket["']?\s*[:=]\s*["'])([^"']+)(["'])/gi, `$1${MARCA}$3`);
+    return out;
+}
+/**
+ * Convierte cualquier valor lanzado en un string seguro para mostrar.
+ * Reemplaza el patrón `String(error)` usado en los catch de las tools.
+ */
+export function safeError(error) {
+    let base;
+    if (error instanceof Error) {
+        // El `cause` de undici puede traer detalle útil (y potencialmente la URL).
+        const cause = error.cause;
+        base = cause ? `${error.message} (${String(cause)})` : error.message;
+    }
+    else {
+        base = String(error);
+    }
+    return redact(base);
+}
+/**
+ * Enmascara una credencial para mostrarla como referencia sin revelarla.
+ * Ej: "abcd1234-ef56-7890" → "••••7890"
+ */
+export function pista(valor) {
+    if (!valor)
+        return '(no configurado)';
+    const v = valor.trim();
+    if (v.length <= 4)
+        return '••••';
+    return `••••${v.slice(-4)}`;
+}
+//# sourceMappingURL=redact.js.map

package/dist/utils/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../../src/utils/redact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,KAAK,GAAG,YAAY,CAAC;AAE3B,kFAAkF;AAClF,MAAM,YAAY,GAAG,CAAC,CAAC;AAEvB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;AAEnC;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAgC;IAC/D,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACvB,mEAAmE;IACnE,IAAI,CAAC,CAAC,MAAM,GAAG,YAAY;QAAE,OAAO;IAEpC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAEhB,sEAAsE;IACtE,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;IACtC,IAAI,OAAO,KAAK,CAAC;QAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,cAAc;IAC5B,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,mBAAmB;IACjC,OAAO,QAAQ,CAAC,IAAI,CAAC;AACvB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,IAAI,GAAG,GAAG,KAAK,CAAC;IAEhB,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YACpB,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,8DAA8D;IAC9D,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,+BAA+B,EAAE,KAAK,KAAK,EAAE,CAAC,CAAC;IACjE,mDAAmD;IACnD,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,kDAAkD,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC;IAEtF,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,IAAI,IAAY,CAAC;IACjB,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,2EAA2E;QAC3E,MAAM,KAAK,GAAI,KAAqC,CAAC,KAAK,CAAC;QAC3D,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,KAAK,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;IACvE,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAC,KAAgC;IACpD,IAAI,CAAC,KAAK;QAAE,OAAO,kBAAkB,CAAC;IACtC,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACvB,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IACjC,OAAO,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9B,CAAC"}

package/package.json

@@ -1,53 +1,55 @@
-{
-  "name": "@ssolis-ti/mcp-compra-agil",
-  "version": "1.0.3",
-  "description": "Servidor MCP para la API Compra Ágil v2 de Mercado Público (Chile)",
-  "type": "module",
-  "bin": {
-    "mcp-compra-agil": "dist/index.js"
-  },
-  "files": [
-    "dist"
-  ],
-  "author": "ssolis-ti",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/ssolis-ti/compra-agil-mcp.git"
-  },
-  "bugs": {
-    "url": "https://github.com/ssolis-ti/compra-agil-mcp/issues"
-  },
-  "homepage": "https://github.com/ssolis-ti/compra-agil-mcp#readme",
-  "scripts": {
-    "build": "tsc",
-    "start": "node dist/index.js",
-    "dev": "tsx watch src/index.ts",
-    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js",
-    "monitor": "node dist/services/monitor.js",
-    "prepublishOnly": "npm run build"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.0",
-    "pdf-parse": "^2.4.5",
-    "zod": "^3.24.0"
-  },
-  "devDependencies": {
-    "@types/node": "^22.0.0",
-    "@types/pdf-parse": "^1.1.5",
-    "tsx": "^4.19.0",
-    "typescript": "^5.7.0"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "compra-agil",
-    "mercado-publico",
-    "chile",
-    "gobierno",
-    "licitaciones"
-  ],
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "@ssolis-ti/mcp-compra-agil",
+  "version": "2.3.0",
+  "description": "Servidor MCP para la API Compra Ágil v2 de Mercado Público (Chile)",
+  "type": "module",
+  "bin": {
+    "mcp-compra-agil": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "author": "ssolis-ti",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ssolis-ti/compra-agil-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ssolis-ti/compra-agil-mcp/issues"
+  },
+  "homepage": "https://github.com/ssolis-ti/compra-agil-mcp#readme",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx watch src/index.ts",
+    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js",
+    "monitor": "node dist/services/monitor.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "pdf-parse": "^2.4.5",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.2.7"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "compra-agil",
+    "mercado-publico",
+    "chile",
+    "gobierno",
+    "licitaciones"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}