@saulwade/swl-ses 1.3.7 → 1.4.0

package/hooks/lib/toon-compressor.js

@@ -1,245 +1,245 @@
-'use strict';
-
-/**
- * TOON Compressor — Compresión de schemas y documentos estructurados.
- *
- * Patrón adoptado de CC Workflow Studio (generate-toon-schema.ts).
- * Reduce el tamaño de JSON schemas y documentos estructurados ~20-25%
- * eliminando redundancia sin perder información semántica.
- *
- * Técnicas aplicadas:
- *   1. Eliminar whitespace y formateo innecesario
- *   2. Abreviar claves repetitivas con diccionario
- *   3. Colapsar descripciones a una línea
- *   4. Eliminar campos opcionales con valor default
- *   5. Usar notación compacta para tipos simples
- *
- * Zero dependencias externas.
- *
- * Uso:
- *   const { comprimirSchema, descomprimirSchema, comprimirTexto } = require('./lib/toon-compressor');
- *   const compacto = comprimirSchema(schemaJSON);
- *   console.log(`Reducción: ${compacto.reduccionPorcentaje}%`);
- *
- * @module hooks/lib/toon-compressor
- */
-
-// ---------------------------------------------------------------------------
-// Diccionario de abreviaciones para claves JSON Schema
-// ---------------------------------------------------------------------------
-
-/**
- * Mapeo de claves largas a abreviaciones cortas.
- * Solo para claves que aparecen ≥3 veces en un schema típico.
- */
-const ABREVIACIONES = {
-  description: 'desc',
-  properties: 'props',
-  required: 'req',
-  additionalProperties: 'addl',
-  type: 't',
-  items: 'it',
-  default: 'def',
-  enum: 'en',
-  maxLength: 'maxL',
-  minLength: 'minL',
-  minimum: 'min',
-  maximum: 'max',
-  pattern: 'pat',
-  oneOf: '1of',
-  anyOf: 'aof',
-  allOf: 'allof',
-};
-
-/** Mapeo inverso para descompresión. */
-const ABREVIACIONES_INV = Object.fromEntries(
-  Object.entries(ABREVIACIONES).map(([k, v]) => [v, k])
-);
-
-// ---------------------------------------------------------------------------
-// Funciones core
-// ---------------------------------------------------------------------------
-
-/**
- * Comprime un objeto JSON Schema reemplazando claves por abreviaciones.
- *
- * @param {object} obj - Objeto a comprimir (se clona internamente)
- * @returns {object} Objeto con claves abreviadas
- */
-function _abreviarClaves(obj) {
-  if (Array.isArray(obj)) {
-    return obj.map(_abreviarClaves);
-  }
-  if (obj !== null && typeof obj === 'object') {
-    const resultado = {};
-    for (const [clave, valor] of Object.entries(obj)) {
-      const claveCorta = ABREVIACIONES[clave] || clave;
-      resultado[claveCorta] = _abreviarClaves(valor);
-    }
-    return resultado;
-  }
-  return obj;
-}
-
-/**
- * Descomprime un objeto con claves abreviadas a sus nombres originales.
- *
- * @param {object} obj - Objeto con claves abreviadas
- * @returns {object} Objeto con claves originales
- */
-function _expandirClaves(obj) {
-  if (Array.isArray(obj)) {
-    return obj.map(_expandirClaves);
-  }
-  if (obj !== null && typeof obj === 'object') {
-    const resultado = {};
-    for (const [clave, valor] of Object.entries(obj)) {
-      const claveLarga = ABREVIACIONES_INV[clave] || clave;
-      resultado[claveLarga] = _expandirClaves(valor);
-    }
-    return resultado;
-  }
-  return obj;
-}
-
-/**
- * Elimina campos opcionales con valor default conocido.
- *
- * @param {object} obj - Schema JSON
- * @returns {object} Schema sin defaults redundantes
- */
-function _eliminarDefaults(obj) {
-  if (Array.isArray(obj)) {
-    return obj.map(_eliminarDefaults);
-  }
-  if (obj !== null && typeof obj === 'object') {
-    const resultado = {};
-    for (const [clave, valor] of Object.entries(obj)) {
-      // Eliminar additionalProperties: true (es el default)
-      if (clave === 'additionalProperties' && valor === true) continue;
-      // Eliminar required: [] (vacío = sin requeridos)
-      if (clave === 'required' && Array.isArray(valor) && valor.length === 0) continue;
-      // Eliminar description vacía
-      if (clave === 'description' && valor === '') continue;
-      resultado[clave] = _eliminarDefaults(valor);
-    }
-    return resultado;
-  }
-  return obj;
-}
-
-/**
- * Colapsa descripciones multi-línea a una sola línea.
- *
- * @param {object} obj
- * @returns {object}
- */
-function _colapsarDescripciones(obj) {
-  if (Array.isArray(obj)) {
-    return obj.map(_colapsarDescripciones);
-  }
-  if (obj !== null && typeof obj === 'object') {
-    const resultado = {};
-    for (const [clave, valor] of Object.entries(obj)) {
-      if (clave === 'description' && typeof valor === 'string') {
-        resultado[clave] = valor.replace(/\s+/g, ' ').trim();
-      } else {
-        resultado[clave] = _colapsarDescripciones(valor);
-      }
-    }
-    return resultado;
-  }
-  return obj;
-}
-
-// ---------------------------------------------------------------------------
-// API pública
-// ---------------------------------------------------------------------------
-
-/**
- * Comprime un JSON Schema aplicando todas las técnicas de reducción.
- *
- * @param {object|string} schema - JSON Schema (objeto o string JSON)
- * @returns {{ comprimido: string, original: number, reducido: number, reduccionPorcentaje: number }}
- */
-function comprimirSchema(schema) {
-  const obj = typeof schema === 'string' ? JSON.parse(schema) : schema;
-  const original = JSON.stringify(obj);
-
-  let procesado = _eliminarDefaults(obj);
-  procesado = _colapsarDescripciones(procesado);
-  procesado = _abreviarClaves(procesado);
-
-  const comprimido = JSON.stringify(procesado);
-
-  const tamOriginal = original.length;
-  const tamReducido = comprimido.length;
-  const reduccion = ((tamOriginal - tamReducido) / tamOriginal) * 100;
-
-  return {
-    comprimido,
-    original: tamOriginal,
-    reducido: tamReducido,
-    reduccionPorcentaje: Math.round(reduccion * 10) / 10,
-  };
-}
-
-/**
- * Descomprime un JSON Schema con claves abreviadas.
- *
- * @param {string|object} comprimido - Schema comprimido
- * @returns {object} Schema original con claves expandidas
- */
-function descomprimirSchema(comprimido) {
-  const obj = typeof comprimido === 'string' ? JSON.parse(comprimido) : comprimido;
-  return _expandirClaves(obj);
-}
-
-/**
- * Comprime texto Markdown eliminando redundancia para reducir tokens.
- *
- * Técnicas:
- *   - Colapsar múltiples líneas vacías a una
- *   - Eliminar trailing whitespace
- *   - Comprimir tablas (eliminar padding)
- *   - Eliminar comentarios HTML
- *
- * @param {string} texto - Texto Markdown
- * @returns {{ comprimido: string, original: number, reducido: number, reduccionPorcentaje: number }}
- */
-function comprimirTexto(texto) {
-  const original = texto.length;
-
-  let resultado = texto;
-  // Colapsar 3+ líneas vacías a 2
-  resultado = resultado.replace(/\n{3,}/g, '\n\n');
-  // Eliminar trailing whitespace
-  resultado = resultado.replace(/[ \t]+$/gm, '');
-  // Eliminar comentarios HTML
-  resultado = resultado.replace(/<!--[\s\S]*?-->/g, '');
-  // Comprimir padding en tablas (múltiples espacios → uno)
-  resultado = resultado.replace(/\|[ \t]{2,}/g, '| ');
-  resultado = resultado.replace(/[ \t]{2,}\|/g, ' |');
-
-  const reducido = resultado.length;
-  const reduccion = ((original - reducido) / original) * 100;
-
-  return {
-    comprimido: resultado,
-    original,
-    reducido,
-    reduccionPorcentaje: Math.round(reduccion * 10) / 10,
-  };
-}
-
-// ---------------------------------------------------------------------------
-// Exports
-// ---------------------------------------------------------------------------
-
-module.exports = {
-  comprimirSchema,
-  descomprimirSchema,
-  comprimirTexto,
-  // Exponer diccionario para tests
-  ABREVIACIONES,
-};
+'use strict';
+
+/**
+ * TOON Compressor — Compresión de schemas y documentos estructurados.
+ *
+ * Patrón adoptado de CC Workflow Studio (generate-toon-schema.ts).
+ * Reduce el tamaño de JSON schemas y documentos estructurados ~20-25%
+ * eliminando redundancia sin perder información semántica.
+ *
+ * Técnicas aplicadas:
+ *   1. Eliminar whitespace y formateo innecesario
+ *   2. Abreviar claves repetitivas con diccionario
+ *   3. Colapsar descripciones a una línea
+ *   4. Eliminar campos opcionales con valor default
+ *   5. Usar notación compacta para tipos simples
+ *
+ * Zero dependencias externas.
+ *
+ * Uso:
+ *   const { comprimirSchema, descomprimirSchema, comprimirTexto } = require('./lib/toon-compressor');
+ *   const compacto = comprimirSchema(schemaJSON);
+ *   console.log(`Reducción: ${compacto.reduccionPorcentaje}%`);
+ *
+ * @module hooks/lib/toon-compressor
+ */
+
+// ---------------------------------------------------------------------------
+// Diccionario de abreviaciones para claves JSON Schema
+// ---------------------------------------------------------------------------
+
+/**
+ * Mapeo de claves largas a abreviaciones cortas.
+ * Solo para claves que aparecen ≥3 veces en un schema típico.
+ */
+const ABREVIACIONES = {
+  description: 'desc',
+  properties: 'props',
+  required: 'req',
+  additionalProperties: 'addl',
+  type: 't',
+  items: 'it',
+  default: 'def',
+  enum: 'en',
+  maxLength: 'maxL',
+  minLength: 'minL',
+  minimum: 'min',
+  maximum: 'max',
+  pattern: 'pat',
+  oneOf: '1of',
+  anyOf: 'aof',
+  allOf: 'allof',
+};
+
+/** Mapeo inverso para descompresión. */
+const ABREVIACIONES_INV = Object.fromEntries(
+  Object.entries(ABREVIACIONES).map(([k, v]) => [v, k])
+);
+
+// ---------------------------------------------------------------------------
+// Funciones core
+// ---------------------------------------------------------------------------
+
+/**
+ * Comprime un objeto JSON Schema reemplazando claves por abreviaciones.
+ *
+ * @param {object} obj - Objeto a comprimir (se clona internamente)
+ * @returns {object} Objeto con claves abreviadas
+ */
+function _abreviarClaves(obj) {
+  if (Array.isArray(obj)) {
+    return obj.map(_abreviarClaves);
+  }
+  if (obj !== null && typeof obj === 'object') {
+    const resultado = {};
+    for (const [clave, valor] of Object.entries(obj)) {
+      const claveCorta = ABREVIACIONES[clave] || clave;
+      resultado[claveCorta] = _abreviarClaves(valor);
+    }
+    return resultado;
+  }
+  return obj;
+}
+
+/**
+ * Descomprime un objeto con claves abreviadas a sus nombres originales.
+ *
+ * @param {object} obj - Objeto con claves abreviadas
+ * @returns {object} Objeto con claves originales
+ */
+function _expandirClaves(obj) {
+  if (Array.isArray(obj)) {
+    return obj.map(_expandirClaves);
+  }
+  if (obj !== null && typeof obj === 'object') {
+    const resultado = {};
+    for (const [clave, valor] of Object.entries(obj)) {
+      const claveLarga = ABREVIACIONES_INV[clave] || clave;
+      resultado[claveLarga] = _expandirClaves(valor);
+    }
+    return resultado;
+  }
+  return obj;
+}
+
+/**
+ * Elimina campos opcionales con valor default conocido.
+ *
+ * @param {object} obj - Schema JSON
+ * @returns {object} Schema sin defaults redundantes
+ */
+function _eliminarDefaults(obj) {
+  if (Array.isArray(obj)) {
+    return obj.map(_eliminarDefaults);
+  }
+  if (obj !== null && typeof obj === 'object') {
+    const resultado = {};
+    for (const [clave, valor] of Object.entries(obj)) {
+      // Eliminar additionalProperties: true (es el default)
+      if (clave === 'additionalProperties' && valor === true) continue;
+      // Eliminar required: [] (vacío = sin requeridos)
+      if (clave === 'required' && Array.isArray(valor) && valor.length === 0) continue;
+      // Eliminar description vacía
+      if (clave === 'description' && valor === '') continue;
+      resultado[clave] = _eliminarDefaults(valor);
+    }
+    return resultado;
+  }
+  return obj;
+}
+
+/**
+ * Colapsa descripciones multi-línea a una sola línea.
+ *
+ * @param {object} obj
+ * @returns {object}
+ */
+function _colapsarDescripciones(obj) {
+  if (Array.isArray(obj)) {
+    return obj.map(_colapsarDescripciones);
+  }
+  if (obj !== null && typeof obj === 'object') {
+    const resultado = {};
+    for (const [clave, valor] of Object.entries(obj)) {
+      if (clave === 'description' && typeof valor === 'string') {
+        resultado[clave] = valor.replace(/\s+/g, ' ').trim();
+      } else {
+        resultado[clave] = _colapsarDescripciones(valor);
+      }
+    }
+    return resultado;
+  }
+  return obj;
+}
+
+// ---------------------------------------------------------------------------
+// API pública
+// ---------------------------------------------------------------------------
+
+/**
+ * Comprime un JSON Schema aplicando todas las técnicas de reducción.
+ *
+ * @param {object|string} schema - JSON Schema (objeto o string JSON)
+ * @returns {{ comprimido: string, original: number, reducido: number, reduccionPorcentaje: number }}
+ */
+function comprimirSchema(schema) {
+  const obj = typeof schema === 'string' ? JSON.parse(schema) : schema;
+  const original = JSON.stringify(obj);
+
+  let procesado = _eliminarDefaults(obj);
+  procesado = _colapsarDescripciones(procesado);
+  procesado = _abreviarClaves(procesado);
+
+  const comprimido = JSON.stringify(procesado);
+
+  const tamOriginal = original.length;
+  const tamReducido = comprimido.length;
+  const reduccion = ((tamOriginal - tamReducido) / tamOriginal) * 100;
+
+  return {
+    comprimido,
+    original: tamOriginal,
+    reducido: tamReducido,
+    reduccionPorcentaje: Math.round(reduccion * 10) / 10,
+  };
+}
+
+/**
+ * Descomprime un JSON Schema con claves abreviadas.
+ *
+ * @param {string|object} comprimido - Schema comprimido
+ * @returns {object} Schema original con claves expandidas
+ */
+function descomprimirSchema(comprimido) {
+  const obj = typeof comprimido === 'string' ? JSON.parse(comprimido) : comprimido;
+  return _expandirClaves(obj);
+}
+
+/**
+ * Comprime texto Markdown eliminando redundancia para reducir tokens.
+ *
+ * Técnicas:
+ *   - Colapsar múltiples líneas vacías a una
+ *   - Eliminar trailing whitespace
+ *   - Comprimir tablas (eliminar padding)
+ *   - Eliminar comentarios HTML
+ *
+ * @param {string} texto - Texto Markdown
+ * @returns {{ comprimido: string, original: number, reducido: number, reduccionPorcentaje: number }}
+ */
+function comprimirTexto(texto) {
+  const original = texto.length;
+
+  let resultado = texto;
+  // Colapsar 3+ líneas vacías a 2
+  resultado = resultado.replace(/\n{3,}/g, '\n\n');
+  // Eliminar trailing whitespace
+  resultado = resultado.replace(/[ \t]+$/gm, '');
+  // Eliminar comentarios HTML
+  resultado = resultado.replace(/<!--[\s\S]*?-->/g, '');
+  // Comprimir padding en tablas (múltiples espacios → uno)
+  resultado = resultado.replace(/\|[ \t]{2,}/g, '| ');
+  resultado = resultado.replace(/[ \t]{2,}\|/g, ' |');
+
+  const reducido = resultado.length;
+  const reduccion = ((original - reducido) / original) * 100;
+
+  return {
+    comprimido: resultado,
+    original,
+    reducido,
+    reduccionPorcentaje: Math.round(reduccion * 10) / 10,
+  };
+}
+
+// ---------------------------------------------------------------------------
+// Exports
+// ---------------------------------------------------------------------------
+
+module.exports = {
+  comprimirSchema,
+  descomprimirSchema,
+  comprimirTexto,
+  // Exponer diccionario para tests
+  ABREVIACIONES,
+};

package/hooks/lib/webhook-dedup.js

@@ -0,0 +1,184 @@
+'use strict';
+
+/**
+ * webhook-dedup.js — Ledger JSONL append-only para idempotencia de webhooks.
+ *
+ * GitHub y otros proveedores reentregan el mismo webhook si el receptor no
+ * responde 2xx rápido. Para evitar reprocesar el mismo evento varias veces,
+ * mantenemos un ledger de `event-id` aceptados con timestamp.
+ *
+ * Estrategia:
+ *   - Ledger en JSONL append-only (zero-deps; sin SQLite).
+ *   - Cache en memoria (Set) construido al primer acceso desde el archivo.
+ *   - Ventana de retención configurable (default 7 días) — entradas más
+ *     viejas se ignoran al construir cache y se mueven a archive con
+ *     `rotar()`.
+ *   - Líneas corruptas (JSON inválido) se descartan silenciosamente al
+ *     leer; no rompen el sistema.
+ *
+ * Origen: patrón derivado de `webhook_events` table de
+ * `temp/claude-code-telegram-main/` (SQLite) adaptado a JSONL siguiendo la
+ * convención SWL (CLAUDE.md: "JSONL para alta frecuencia").
+ *
+ * Zero-deps.
+ *
+ * @module hooks/lib/webhook-dedup
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const VENTANA_DEDUP_MS_DEFAULT = 7 * 24 * 60 * 60 * 1000;  // 7 días
+
+class WebhookDedup {
+  /**
+   * @param {object} opciones
+   * @param {string} opciones.rutaLedger Ruta absoluta o relativa al CWD del ledger JSONL.
+   * @param {number} [opciones.ventanaMs=7d] Ventana de retención en ms.
+   */
+  constructor({ rutaLedger, ventanaMs = VENTANA_DEDUP_MS_DEFAULT } = {}) {
+    if (!rutaLedger || typeof rutaLedger !== 'string') {
+      throw new Error('webhook-dedup: rutaLedger es requerida');
+    }
+    if (!Number.isFinite(ventanaMs) || ventanaMs <= 0) {
+      throw new Error('webhook-dedup: ventanaMs debe ser número positivo');
+    }
+    this.rutaLedger = rutaLedger;
+    this.ventanaMs = ventanaMs;
+    this._cache = null;  // Set<eventId>, lazy load
+  }
+
+  /**
+   * ¿El eventId ya fue procesado dentro de la ventana?
+   * @param {string} eventId
+   * @param {number} [ahora=Date.now()]
+   * @returns {boolean}
+   */
+  yaVisto(eventId, ahora) {
+    if (typeof ahora !== 'number') ahora = Date.now();
+    if (!eventId || typeof eventId !== 'string') return false;
+    this._asegurarCache(ahora);
+    return this._cache.has(eventId);
+  }
+
+  /**
+   * Registra un nuevo evento. Si ya estaba, retorna false sin escribir.
+   * @param {string} eventId
+   * @param {string} provider Nombre del proveedor (github, generic, etc.).
+   * @param {number} [ahora=Date.now()]
+   * @returns {boolean} true si se registró; false si ya estaba.
+   */
+  registrar(eventId, provider, ahora) {
+    if (typeof ahora !== 'number') ahora = Date.now();
+    if (!eventId || typeof eventId !== 'string') return false;
+    if (!provider || typeof provider !== 'string') return false;
+    if (this.yaVisto(eventId, ahora)) return false;
+
+    const entrada = {
+      event_id: eventId,
+      provider,
+      ts: new Date(ahora).toISOString(),
+    };
+    fs.mkdirSync(path.dirname(this.rutaLedger), { recursive: true });
+    fs.appendFileSync(this.rutaLedger, JSON.stringify(entrada) + '\n', 'utf8');
+    this._cache.add(eventId);
+    return true;
+  }
+
+  /**
+   * Mueve entradas más viejas que la ventana al directorio archive.
+   * Reescribe el ledger sólo con entradas dentro de ventana.
+   *
+   * Idempotente: llamar dos veces seguidas no duplica el archivo de archive
+   * (la segunda llamada no encuentra entradas viejas).
+   *
+   * @param {number} [ahora=Date.now()]
+   * @returns {{rotadas: number, conservadas: number}}
+   */
+  rotar(ahora) {
+    if (typeof ahora !== 'number') ahora = Date.now();
+    if (!fs.existsSync(this.rutaLedger)) {
+      return { rotadas: 0, conservadas: 0 };
+    }
+
+    const contenido = fs.readFileSync(this.rutaLedger, 'utf8');
+    const lineas = contenido.split('\n');
+    const limite = ahora - this.ventanaMs;
+
+    const archivar = [];
+    const conservar = [];
+
+    for (const linea of lineas) {
+      const trimmed = linea.trim();
+      if (!trimmed) continue;
+      try {
+        const entrada = JSON.parse(trimmed);
+        const ts = Date.parse(entrada.ts);
+        if (!Number.isFinite(ts)) continue;  // ts inválido, descartar
+        if (ts < limite) {
+          archivar.push(trimmed);
+        } else {
+          conservar.push(trimmed);
+        }
+      } catch (_) {
+        // línea corrupta, descartar
+      }
+    }
+
+    if (archivar.length > 0) {
+      const fechaArchivo = new Date(ahora).toISOString().slice(0, 10);
+      const dirArchive = path.join(path.dirname(this.rutaLedger), 'webhook-events-archive');
+      const archivoArchive = path.join(dirArchive, `events-${fechaArchivo}.jsonl`);
+      fs.mkdirSync(dirArchive, { recursive: true });
+      fs.appendFileSync(archivoArchive, archivar.join('\n') + '\n', 'utf8');
+    }
+
+    const nuevoContenido = conservar.length > 0 ? conservar.join('\n') + '\n' : '';
+    fs.writeFileSync(this.rutaLedger, nuevoContenido, 'utf8');
+    this._cache = null;  // invalidar cache
+
+    return { rotadas: archivar.length, conservadas: conservar.length };
+  }
+
+  /**
+   * Tamaño actual del cache (para tests).
+   * @returns {number}
+   */
+  tamanoCache() {
+    return this._cache ? this._cache.size : 0;
+  }
+
+  /**
+   * Carga el cache desde el archivo si aún no está cargado.
+   * Entradas fuera de ventana se ignoran.
+   * @param {number} ahora
+   */
+  _asegurarCache(ahora) {
+    if (this._cache !== null) return;
+    this._cache = new Set();
+    if (!fs.existsSync(this.rutaLedger)) return;
+
+    const contenido = fs.readFileSync(this.rutaLedger, 'utf8');
+    const limite = ahora - this.ventanaMs;
+
+    for (const linea of contenido.split('\n')) {
+      const trimmed = linea.trim();
+      if (!trimmed) continue;
+      try {
+        const entrada = JSON.parse(trimmed);
+        const ts = Date.parse(entrada.ts);
+        if (!Number.isFinite(ts)) continue;
+        if (ts >= limite) {
+          this._cache.add(entrada.event_id);
+        }
+      } catch (_) {
+        // línea corrupta, ignorar
+      }
+    }
+  }
+}
+
+module.exports = {
+  WebhookDedup,
+  VENTANA_DEDUP_MS_DEFAULT,
+};