@devlas/dte-sii 2.5.0

package/utils/rut.js

@@ -0,0 +1,169 @@
+// Copyright (c) 2026 Devlas SpA — https://devlas.cl
+// Licencia MIT. Ver archivo LICENSE para mas detalles.
+/**
+ * Utilidades de RUT
+ * 
+ * Funciones para manipulación y validación de RUT chileno
+ * 
+ * @module dte-sii/utils/rut
+ */
+
+// ============================================
+// FORMATEO
+// ============================================
+
+/**
+ * Formatear RUT chileno (quitar puntos, mayúsculas)
+ * 
+ * @param {string} rut - RUT a formatear (ej: "12.345.678-K")
+ * @returns {string} - RUT formateado (ej: "12345678-K")
+ */
+function formatRut(rut) {
+  if (!rut) return '';
+  return rut.replace(/\./g, '').toUpperCase();
+}
+
+/**
+ * Limpiar RUT (solo números y K)
+ * 
+ * @param {string} rut - RUT con cualquier formato
+ * @returns {string} - RUT limpio (ej: "12345678K")
+ */
+function cleanRut(rut) {
+  if (!rut) return '';
+  return rut.replace(/[^0-9kK]/g, '').toUpperCase();
+}
+
+/**
+ * Separar RUT en número y dígito verificador
+ * 
+ * @param {string} rut - RUT en cualquier formato
+ * @returns {{ numero: string, dv: string }}
+ */
+function splitRut(rut) {
+  const cleaned = cleanRut(rut);
+  if (cleaned.length < 2) {
+    return { numero: cleaned, dv: '' };
+  }
+  return {
+    numero: cleaned.slice(0, -1),
+    dv: cleaned.slice(-1),
+  };
+}
+
+/**
+ * Formatear RUT con puntos y guión
+ * 
+ * @param {string} rut - RUT sin formato
+ * @returns {string} - RUT formateado (ej: "12.345.678-K")
+ */
+function formatRutWithDots(rut) {
+  const { numero, dv } = splitRut(rut);
+  if (!numero) return '';
+
+  // Agregar puntos cada 3 dígitos desde la derecha
+  const formatted = numero.replace(/\B(?=(\d{3})+(?!\d))/g, '.');
+  return `${formatted}-${dv}`;
+}
+
+/**
+ * Formatear RUT para uso en SII (solo con guión)
+ * 
+ * @param {string} rut - RUT en cualquier formato
+ * @returns {string} - RUT formateado (ej: "12345678-K")
+ */
+function formatRutSii(rut) {
+  const { numero, dv } = splitRut(rut);
+  if (!numero) return '';
+  return `${numero}-${dv}`;
+}
+
+// ============================================
+// VALIDACIÓN
+// ============================================
+
+/**
+ * Calcular dígito verificador de RUT
+ * 
+ * @param {string|number} rutSinDV - RUT sin dígito verificador
+ * @returns {string} - Dígito verificador (0-9 o K)
+ */
+function calcularDV(rutSinDV) {
+  const rut = parseInt(String(rutSinDV).replace(/\D/g, ''), 10);
+  if (isNaN(rut) || rut <= 0) return '';
+
+  let suma = 0;
+  let multiplicador = 2;
+  const rutStr = rut.toString();
+
+  for (let i = rutStr.length - 1; i >= 0; i--) {
+    suma += parseInt(rutStr[i]) * multiplicador;
+    multiplicador = multiplicador === 7 ? 2 : multiplicador + 1;
+  }
+
+  const resto = suma % 11;
+  const dv = 11 - resto;
+
+  if (dv === 11) return '0';
+  if (dv === 10) return 'K';
+  return dv.toString();
+}
+
+/**
+ * Validar RUT chileno
+ * 
+ * @param {string} rut - RUT a validar
+ * @returns {boolean} - true si el RUT es válido
+ */
+function validarRut(rut) {
+  const { numero, dv } = splitRut(rut);
+  if (!numero || numero.length < 7 || numero.length > 8) return false;
+  if (!dv) return false;
+
+  const dvCalculado = calcularDV(numero);
+  return dvCalculado === dv.toUpperCase();
+}
+
+/**
+ * Validar RUT y retornar formateado si es válido
+ * 
+ * @param {string} rut - RUT a validar
+ * @returns {{ valid: boolean, rut: string|null, error?: string }}
+ */
+function validateAndFormatRut(rut) {
+  if (!rut || typeof rut !== 'string') {
+    return { valid: false, rut: null, error: 'RUT no proporcionado' };
+  }
+
+  const { numero, dv } = splitRut(rut);
+
+  if (!numero || numero.length < 7) {
+    return { valid: false, rut: null, error: 'RUT muy corto' };
+  }
+
+  if (numero.length > 8) {
+    return { valid: false, rut: null, error: 'RUT muy largo' };
+  }
+
+  const dvCalculado = calcularDV(numero);
+  if (dvCalculado !== dv.toUpperCase()) {
+    return { valid: false, rut: null, error: 'Dígito verificador inválido' };
+  }
+
+  return { valid: true, rut: formatRutSii(rut) };
+}
+
+// ============================================
+// EXPORTS
+// ============================================
+
+module.exports = {
+  formatRut,
+  cleanRut,
+  splitRut,
+  formatRutWithDots,
+  formatRutSii,
+  calcularDV,
+  validarRut,
+  validateAndFormatRut,
+};

package/utils/sanitize.js

@@ -0,0 +1,124 @@
+// Copyright (c) 2026 Devlas SpA — https://devlas.cl
+// Licencia MIT. Ver archivo LICENSE para mas detalles.
+/**
+ * Utilidades de Sanitización
+ * 
+ * Funciones para sanitizar y formatear texto para DTEs del SII
+ * 
+ * @module dte-sii/utils/sanitize
+ */
+
+// ============================================
+// SANITIZACIÓN DE TEXTO
+// ============================================
+
+/**
+ * Sanitizar texto para DTE SII
+ * Elimina caracteres que causan problemas de firma XML
+ * 
+ * @param {string} text - Texto a sanitizar
+ * @returns {string} - Texto sanitizado
+ */
+function sanitizeSiiText(text) {
+  if (text === undefined || text === null) return '';
+  return String(text)
+    .replace(/[''´`]/g, '')     // Eliminar apóstrofes
+    .replace(/[""]/g, '')       // Eliminar comillas tipográficas
+    .replace(/"/g, '')          // Eliminar comillas dobles ASCII
+    .trim();
+}
+
+/**
+ * Truncar texto a longitud máxima (preservando palabras completas si es posible)
+ * 
+ * @param {string} text - Texto a truncar
+ * @param {number} maxLen - Longitud máxima
+ * @param {boolean} [preserveWords=false] - Si preservar palabras completas
+ * @returns {string}
+ */
+function truncateText(text, maxLen, preserveWords = false) {
+  const sanitized = sanitizeSiiText(text);
+  if (sanitized.length <= maxLen) return sanitized;
+
+  if (preserveWords) {
+    const truncated = sanitized.substring(0, maxLen);
+    const lastSpace = truncated.lastIndexOf(' ');
+    if (lastSpace > maxLen * 0.7) {
+      return truncated.substring(0, lastSpace).trim();
+    }
+  }
+
+  return sanitized.substring(0, maxLen);
+}
+
+/**
+ * Sanitizar giro para receptor (máximo 40 caracteres)
+ * 
+ * @param {string} giro - Giro del receptor
+ * @returns {string}
+ */
+function sanitizeGiroRecep(giro) {
+  return truncateText(giro, 40);
+}
+
+/**
+ * Sanitizar razón social (máximo 100 caracteres)
+ * 
+ * @param {string} razonSocial - Razón social
+ * @returns {string}
+ */
+function sanitizeRazonSocial(razonSocial) {
+  return truncateText(razonSocial, 100);
+}
+
+/**
+ * Sanitizar nombre de ítem (máximo 80 caracteres)
+ * 
+ * @param {string} nombre - Nombre del ítem
+ * @returns {string}
+ */
+function sanitizeNombreItem(nombre) {
+  return truncateText(nombre, 80);
+}
+
+/**
+ * Sanitizar descripción de ítem (máximo 1000 caracteres)
+ * 
+ * @param {string} descripcion - Descripción del ítem
+ * @returns {string}
+ */
+function sanitizeDescripcionItem(descripcion) {
+  return truncateText(descripcion, 1000);
+}
+
+/**
+ * Crear segmento seguro para nombres de archivo/directorio
+ * 
+ * @param {*} value - Valor a convertir
+ * @param {string} [fallback='sin-valor'] - Valor por defecto
+ * @returns {string}
+ */
+function safeSegment(value, fallback = 'sin-valor') {
+  const raw = value === undefined || value === null ? '' : String(value);
+  const cleaned = raw
+    .replace(/\./g, '')
+    .replace(/[^a-zA-Z0-9._-]/g, '-')
+    .replace(/-+/g, '-')
+    .replace(/^-|-$/g, '')
+    .slice(0, 80);
+  return cleaned || fallback;
+}
+
+// ============================================
+// EXPORTS
+// ============================================
+
+module.exports = {
+  sanitizeSiiText,
+  truncateText,
+  sanitizeGiroRecep,
+  sanitizeRazonSocial,
+  sanitizeNombreItem,
+  sanitizeDescripcionItem,
+  safeSegment,
+};

package/utils/tokenCache.js

@@ -0,0 +1,214 @@
+// Copyright (c) 2026 Devlas SpA — https://devlas.cl
+// Licencia MIT. Ver archivo LICENSE para mas detalles.
+/**
+ * Token Cache
+ * 
+ * Cache de tokens SII para evitar solicitudes innecesarias
+ * Los tokens tienen validez de ~60 minutos
+ * 
+ * @module dte-sii/utils/tokenCache
+ */
+
+const { getConfigSection } = require('./config');
+
+// ============================================
+// ALMACENAMIENTO EN MEMORIA
+// ============================================
+
+/**
+ * Estructura del cache:
+ * {
+ *   'certificacion:rest:78206276-K': { token: 'xxx', expiresAt: Date },
+ *   'produccion:soap:78206276-K': { token: 'yyy', expiresAt: Date },
+ * }
+ */
+const tokenStore = new Map();
+
+// ============================================
+// FUNCIONES PRINCIPALES
+// ============================================
+
+/**
+ * Generar clave única para el cache
+ * @param {string} ambiente - 'certificacion' o 'produccion'
+ * @param {string} tipo - 'rest' o 'soap'
+ * @param {string} rutEmisor - RUT del emisor
+ * @returns {string} Clave del cache
+ */
+function generateCacheKey(ambiente, tipo, rutEmisor) {
+  return `${ambiente}:${tipo}:${rutEmisor}`;
+}
+
+/**
+ * Obtener token del cache si existe y no ha expirado
+ * @param {string} ambiente - 'certificacion' o 'produccion'
+ * @param {string} tipo - 'rest' o 'soap'
+ * @param {string} rutEmisor - RUT del emisor
+ * @returns {string|null} Token cacheado o null
+ */
+function getCachedToken(ambiente, tipo, rutEmisor) {
+  const config = getConfigSection('tokenCache');
+  
+  if (!config?.enabled) {
+    return null;
+  }
+  
+  const key = generateCacheKey(ambiente, tipo, rutEmisor);
+  const cached = tokenStore.get(key);
+  
+  if (!cached) {
+    return null;
+  }
+  
+  // Verificar expiración
+  if (Date.now() >= cached.expiresAt) {
+    tokenStore.delete(key);
+    return null;
+  }
+  
+  return cached.token;
+}
+
+/**
+ * Guardar token en cache
+ * @param {string} ambiente - 'certificacion' o 'produccion'
+ * @param {string} tipo - 'rest' o 'soap'
+ * @param {string} rutEmisor - RUT del emisor
+ * @param {string} token - Token a cachear
+ * @param {number} [ttlMinutes] - TTL personalizado (opcional)
+ */
+function setCachedToken(ambiente, tipo, rutEmisor, token, ttlMinutes) {
+  const config = getConfigSection('tokenCache');
+  
+  if (!config?.enabled) {
+    return;
+  }
+  
+  const ttl = ttlMinutes ?? config.ttlMinutes ?? 55;
+  const expiresAt = Date.now() + (ttl * 60 * 1000);
+  
+  const key = generateCacheKey(ambiente, tipo, rutEmisor);
+  tokenStore.set(key, {
+    token,
+    expiresAt,
+    createdAt: Date.now(),
+    ambiente,
+    tipo,
+    rutEmisor,
+  });
+}
+
+/**
+ * Invalidar token específico
+ * @param {string} ambiente - 'certificacion' o 'produccion'
+ * @param {string} tipo - 'rest' o 'soap'
+ * @param {string} rutEmisor - RUT del emisor
+ */
+function invalidateToken(ambiente, tipo, rutEmisor) {
+  const key = generateCacheKey(ambiente, tipo, rutEmisor);
+  tokenStore.delete(key);
+}
+
+/**
+ * Invalidar todos los tokens de un ambiente
+ * @param {string} ambiente - 'certificacion' o 'produccion'
+ */
+function invalidateAmbiente(ambiente) {
+  for (const key of tokenStore.keys()) {
+    if (key.startsWith(`${ambiente}:`)) {
+      tokenStore.delete(key);
+    }
+  }
+}
+
+/**
+ * Invalidar todos los tokens de un emisor
+ * @param {string} rutEmisor - RUT del emisor
+ */
+function invalidateEmisor(rutEmisor) {
+  for (const key of tokenStore.keys()) {
+    if (key.endsWith(`:${rutEmisor}`)) {
+      tokenStore.delete(key);
+    }
+  }
+}
+
+/**
+ * Limpiar todo el cache
+ */
+function clearTokenCache() {
+  tokenStore.clear();
+}
+
+/**
+ * Obtener estadísticas del cache
+ * @returns {Object} Estadísticas
+ */
+function getTokenCacheStats() {
+  const now = Date.now();
+  let active = 0;
+  let expired = 0;
+  
+  for (const [key, value] of tokenStore.entries()) {
+    if (now >= value.expiresAt) {
+      expired++;
+    } else {
+      active++;
+    }
+  }
+  
+  return {
+    total: tokenStore.size,
+    active,
+    expired,
+    entries: Array.from(tokenStore.entries()).map(([key, value]) => ({
+      key,
+      ambiente: value.ambiente,
+      tipo: value.tipo,
+      rutEmisor: value.rutEmisor,
+      createdAt: new Date(value.createdAt).toISOString(),
+      expiresAt: new Date(value.expiresAt).toISOString(),
+      isExpired: now >= value.expiresAt,
+      remainingMinutes: Math.max(0, Math.round((value.expiresAt - now) / 60000)),
+    })),
+  };
+}
+
+/**
+ * Limpiar tokens expirados (limpieza manual)
+ * @returns {number} Número de tokens eliminados
+ */
+function pruneExpiredTokens() {
+  const now = Date.now();
+  let pruned = 0;
+  
+  for (const [key, value] of tokenStore.entries()) {
+    if (now >= value.expiresAt) {
+      tokenStore.delete(key);
+      pruned++;
+    }
+  }
+  
+  return pruned;
+}
+
+// ============================================
+// EXPORTS
+// ============================================
+
+module.exports = {
+  // Operaciones principales
+  getCachedToken,
+  setCachedToken,
+  
+  // Invalidación
+  invalidateToken,
+  invalidateAmbiente,
+  invalidateEmisor,
+  clearTokenCache,
+  
+  // Utilidades
+  getTokenCacheStats,
+  pruneExpiredTokens,
+  generateCacheKey,
+};