@saulwade/swl-ses 1.4.1 → 1.5.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,
+};