@runnerpro/backend 1.35.0 → 1.35.1

package/lib/cjs/mediaProcessing/audio.js

@@ -123,7 +123,8 @@ const reconocer = (params) => __awaiter(void 0, void 0, void 0, function* () {
 });
 /**
  * Cadena completa sobre un audio ya medido: guarda de silencio → motores → guarda de densidad →
- * corrección → una línea de log por audio (motor, duración, dB, confianza, caracteres, latencia).
+ * corrección → una línea de log por audio (motor, duración, dB, confianza, caracteres, latencia y
+ * en qué acabó la corrección).
  *
  * @param params - Audio original, WAV opcional, medidas y contexto
  * @returns Transcripción o marcador
@@ -172,11 +173,14 @@ const transcribirMedido = (params) => __awaiter(void 0, void 0, void 0, function
         registrar({ motor, resultado: 'densidad imposible', chars: text.length });
         return MARCADOR_NO_TRANSCRITO;
     }
-    const { texto, sustituciones } = yield (0, correccionTranscripcion_1.corregirTranscripcion)(text, params.contexto);
+    const { texto, sustituciones, estado } = yield (0, correccionTranscripcion_1.corregirTranscripcion)(text, params.contexto);
     registrar({
         motor,
         conf: confidence,
         chars: texto.length,
+        // ⭐ `correccion` separa «el modelo no vio nada que corregir» de «no contestó»: con solo el
+        // contador, un LITE caído se leería igual que un audio limpio (0/0) y no se notaría nunca
+        correccion: estado,
         sustituciones: `${sustituciones.filter((sustitucion) => sustitucion.aceptada).length}/${sustituciones.length}`,
     });
     return recortado && wav ? `${texto} (Solo se transcribieron los primeros ${Math.round(TRANSCRIPTION_MAX_SECONDS / 60)} minutos.)` : texto;

package/lib/cjs/mediaProcessing/correccionTranscripcion.js

@@ -243,7 +243,7 @@ Devuelve SOLO la transcripción corregida, sin comentarios.`;
  * Pide al modelo LITE una propuesta de corrección; si no llega a tiempo, devuelve null
  *
  * @param prompt - Prompt de corrección
- * @returns Texto propuesto, o null
+ * @returns Texto propuesto (null si no llegó nada) y si fue por agotarse el tiempo
  */
 const pedirPropuesta = (prompt) => __awaiter(void 0, void 0, void 0, function* () {
     const llamada = (0, index_1.generateText)({
@@ -252,8 +252,8 @@ const pedirPropuesta = (prompt) => __awaiter(void 0, void 0, void 0, function* (
         // ⭐ Sin registro en LLM CACHE: una transcripción no vale como clave y engorda la tabla
         log: false,
         providerOptions: { openai: { reasoningEffort: 'low' } },
-    }).then((resultado) => ((resultado === null || resultado === void 0 ? void 0 : resultado.text) || '').trim());
-    const timeout = new Promise((resolve) => setTimeout(() => resolve(null), CORRECCION_TIMEOUT_MS));
+    }).then((resultado) => ({ propuesta: ((resultado === null || resultado === void 0 ? void 0 : resultado.text) || '').trim(), agotado: false }));
+    const timeout = new Promise((resolve) => setTimeout(() => resolve({ propuesta: null, agotado: true }), CORRECCION_TIMEOUT_MS));
     return Promise.race([llamada, timeout]);
 });
 /**
@@ -263,22 +263,30 @@ const pedirPropuesta = (prompt) => __awaiter(void 0, void 0, void 0, function* (
  *
  * @param texto - Transcripción tal como sale del reconocedor
  * @param contexto - Nombres y últimos mensajes del chat
- * @returns Texto corregido y la lista de sustituciones propuestas con su veredicto
+ * @returns Texto corregido, las sustituciones propuestas con su veredicto y en qué acabó la capa
  *
  * @example
  * ```typescript
- * const { texto, sustituciones } = await corregirTranscripcion('Hoy he hecho Farley con el garam', { nombres: ['Ana', 'Rubén'] });
- * // texto: 'Hoy he hecho fartlek con el Garmin'
+ * const { texto, estado } = await corregirTranscripcion('Hoy he hecho Farley con el garam', { nombres: ['Ana', 'Rubén'] });
+ * // texto: 'Hoy he hecho fartlek con el Garmin', estado: 'aplicada'
  * ```
  */
 const corregirTranscripcion = (texto, contexto) => __awaiter(void 0, void 0, void 0, function* () {
-    const sinCambios = { texto, sustituciones: [] };
+    const sinCorregir = (estado) => ({ texto, sustituciones: [], estado });
     if (!texto || texto.length < CORRECCION_MIN_CARACTERES || process.env.TRANSCRIPCION_CORRECCION === 'off')
-        return sinCambios;
+        return sinCorregir('omitida');
     try {
-        const propuesta = yield pedirPropuesta(promptCorreccion(texto, contexto || {}));
-        if (!propuesta || normalizar(propuesta) === normalizar(texto))
-            return sinCambios;
+        const { propuesta, agotado } = yield pedirPropuesta(promptCorreccion(texto, contexto || {}));
+        // ⚠️ El timeout se avisa: es la única forma de enterarse de que el LITE dejó de contestar
+        if (agotado) {
+            // eslint-disable-next-line no-console
+            console.error(`[corregirTranscripcion] El modelo no contestó en ${CORRECCION_TIMEOUT_MS} ms: se guarda sin corregir`);
+            return sinCorregir('timeout');
+        }
+        if (!propuesta)
+            return sinCorregir('sin propuesta');
+        if (normalizar(propuesta) === normalizar(texto))
+            return sinCorregir('sin cambios');
         const nombres = ((contexto === null || contexto === void 0 ? void 0 : contexto.nombres) || []).filter(Boolean);
         const canonicas = new Map();
         for (const entrada of [...GLOSARIO_RUNNING, ...nombres]) {
@@ -302,12 +310,16 @@ const corregirTranscripcion = (texto, contexto) => __awaiter(void 0, void 0, voi
             if (aceptada)
                 aceptadas.push(tramo);
         }
-        return { texto: aceptadas.length ? aplicar(texto, aceptadas, canonicas) : texto, sustituciones };
+        return {
+            texto: aceptadas.length ? aplicar(texto, aceptadas, canonicas) : texto,
+            sustituciones,
+            estado: aceptadas.length ? 'aplicada' : 'rechazada',
+        };
     }
     catch (error) {
         // eslint-disable-next-line no-console
         console.error('[corregirTranscripcion] Se guarda sin corregir:', (error === null || error === void 0 ? void 0 : error.message) || error);
-        return sinCambios;
+        return sinCorregir('error');
     }
 });
 exports.corregirTranscripcion = corregirTranscripcion;

package/lib/cjs/types/mediaProcessing/audio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../../../src/mediaProcessing/audio.ts"],"names":[],"mappings":";AAKA,OAAO,EAA2C,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAG3G,QAAA,MAAM,yBAAyB,MAAM,CAAC;AAItC,QAAA,MAAM,0BAA0B,KAAK,CAAC;AAKtC,QAAA,MAAM,gBAAgB,gCAAgC,CAAC;AACvD,QAAA,MAAM,sBAAsB,0BAA0B,CAAC;AACvD,QAAA,MAAM,gBAAgB,sCAAsC,CAAC;AAC7D,QAAA,MAAM,gBAAgB,UAA+D,CAAC;AAMtF;;;;;;GAMG;AACH,QAAA,MAAM,eAAe,eAAgB,MAAM,aAAa,MAAM,KAAG,QAAQ;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAuBtG,CAAC;AAgJL;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,QAAA,MAAM,eAAe,eAAsB,MAAM,YAAY,MAAM,aAAa,MAAM,aAAa,qBAAqB,GAAG,IAAI,KAAG,QAAQ,MAAM,CAG/I,CAAC;AAEF;;;;;;;GAOG;AACH,QAAA,MAAM,gBAAgB,cAAqB,MAAM,aAAa,qBAAqB,GAAG,IAAI,KAAG,QAAQ,MAAM,CAK1G,CAAC;AAEF,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,EAChB,yBAAyB,EACzB,0BAA0B,GAC3B,CAAC;AACF,YAAY,EAAE,qBAAqB,EAAE,CAAC"}
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../../../src/mediaProcessing/audio.ts"],"names":[],"mappings":";AAKA,OAAO,EAA2C,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAG3G,QAAA,MAAM,yBAAyB,MAAM,CAAC;AAItC,QAAA,MAAM,0BAA0B,KAAK,CAAC;AAKtC,QAAA,MAAM,gBAAgB,gCAAgC,CAAC;AACvD,QAAA,MAAM,sBAAsB,0BAA0B,CAAC;AACvD,QAAA,MAAM,gBAAgB,sCAAsC,CAAC;AAC7D,QAAA,MAAM,gBAAgB,UAA+D,CAAC;AAMtF;;;;;;GAMG;AACH,QAAA,MAAM,eAAe,eAAgB,MAAM,aAAa,MAAM,KAAG,QAAQ;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAuBtG,CAAC;AAoJL;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,QAAA,MAAM,eAAe,eAAsB,MAAM,YAAY,MAAM,aAAa,MAAM,aAAa,qBAAqB,GAAG,IAAI,KAAG,QAAQ,MAAM,CAG/I,CAAC;AAEF;;;;;;;GAOG;AACH,QAAA,MAAM,gBAAgB,cAAqB,MAAM,aAAa,qBAAqB,GAAG,IAAI,KAAG,QAAQ,MAAM,CAK1G,CAAC;AAEF,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,EAChB,yBAAyB,EACzB,0BAA0B,GAC3B,CAAC;AACF,YAAY,EAAE,qBAAqB,EAAE,CAAC"}

package/lib/cjs/types/mediaProcessing/correccionTranscripcion.d.ts

@@ -18,6 +18,20 @@ type Sustitucion = {
     a: string;
     aceptada: boolean;
 };
+/**
+ * En qué acabó la capa de corrección. Va en la línea de log de cada audio para poder distinguir
+ * «el modelo no vio nada que corregir» de «el modelo no llegó a tiempo»: sin esto, una caída
+ * silenciosa del LITE dejaría la corrección apagada de hecho y el log seguiría diciendo 0/0.
+ *
+ * - `omitida`: texto demasiado corto o TRANSCRIPCION_CORRECCION=off; no se llamó al modelo
+ * - `timeout`: el modelo no contestó en CORRECCION_TIMEOUT_MS
+ * - `error`: la llamada falló
+ * - `sin propuesta`: contestó vacío
+ * - `sin cambios`: propuso exactamente el mismo texto
+ * - `rechazada`: propuso cambios y el filtro determinista los tumbó todos
+ * - `aplicada`: al menos una sustitución pasó el filtro
+ */
+type EstadoCorreccion = 'omitida' | 'timeout' | 'error' | 'sin propuesta' | 'sin cambios' | 'rechazada' | 'aplicada';
 /**
  * Normaliza para comparar: minúsculas, sin acentos, solo letras, dígitos y espacios
  *
@@ -32,18 +46,19 @@ declare const normalizar: (texto: string) => string;
  *
  * @param texto - Transcripción tal como sale del reconocedor
  * @param contexto - Nombres y últimos mensajes del chat
- * @returns Texto corregido y la lista de sustituciones propuestas con su veredicto
+ * @returns Texto corregido, las sustituciones propuestas con su veredicto y en qué acabó la capa
  *
  * @example
  * ```typescript
- * const { texto, sustituciones } = await corregirTranscripcion('Hoy he hecho Farley con el garam', { nombres: ['Ana', 'Rubén'] });
- * // texto: 'Hoy he hecho fartlek con el Garmin'
+ * const { texto, estado } = await corregirTranscripcion('Hoy he hecho Farley con el garam', { nombres: ['Ana', 'Rubén'] });
+ * // texto: 'Hoy he hecho fartlek con el Garmin', estado: 'aplicada'
  * ```
  */
 declare const corregirTranscripcion: (texto: string, contexto?: ContextoTranscripcion | null) => Promise<{
     texto: string;
     sustituciones: Sustitucion[];
+    estado: EstadoCorreccion;
 }>;
 export { corregirTranscripcion, GLOSARIO_RUNNING, normalizar };
-export type { ContextoTranscripcion, MensajePrevio, Sustitucion };
+export type { ContextoTranscripcion, EstadoCorreccion, MensajePrevio, Sustitucion };
 //# sourceMappingURL=correccionTranscripcion.d.ts.map

package/lib/cjs/types/mediaProcessing/correccionTranscripcion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"correccionTranscripcion.d.ts","sourceRoot":"","sources":["../../../../src/mediaProcessing/correccionTranscripcion.ts"],"names":[],"mappings":"AAWA,QAAA,MAAM,gBAAgB,EAAE,MAAM,EAqD7B,CAAC;AAWF,KAAK,aAAa,GAAG;IAAE,KAAK,EAAE,SAAS,GAAG,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAExE,KAAK,qBAAqB,GAAG;IAC3B,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,+FAA+F;IAC/F,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,iEAAiE;IACjE,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;CAC3B,CAAC;AAEF,KAAK,WAAW,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAIhE;;;;;GAKG;AACH,QAAA,MAAM,UAAU,UAAW,MAAM,KAAG,MAOzB,CAAC;AAiKZ;;;;;;;;;;;;;;GAcG;AACH,QAAA,MAAM,qBAAqB,UAAiB,MAAM,aAAa,qBAAqB,GAAG,IAAI;WAAoB,MAAM;mBAAiB,WAAW,EAAE;EAqClJ,CAAC;AAEF,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,UAAU,EAAE,CAAC;AAC/D,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"correccionTranscripcion.d.ts","sourceRoot":"","sources":["../../../../src/mediaProcessing/correccionTranscripcion.ts"],"names":[],"mappings":"AAWA,QAAA,MAAM,gBAAgB,EAAE,MAAM,EAqD7B,CAAC;AAWF,KAAK,aAAa,GAAG;IAAE,KAAK,EAAE,SAAS,GAAG,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAExE,KAAK,qBAAqB,GAAG;IAC3B,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,+FAA+F;IAC/F,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,iEAAiE;IACjE,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;CAC3B,CAAC;AAEF,KAAK,WAAW,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAEhE;;;;;;;;;;;;GAYG;AACH,KAAK,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,eAAe,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,CAAC;AAIrH;;;;;GAKG;AACH,QAAA,MAAM,UAAU,UAAW,MAAM,KAAG,MAOzB,CAAC;AAmKZ;;;;;;;;;;;;;;GAcG;AACH,QAAA,MAAM,qBAAqB,UAClB,MAAM,aACF,qBAAqB,GAAG,IAAI;WACrB,MAAM;mBAAiB,WAAW,EAAE;YAAU,gBAAgB;EAgDjF,CAAC;AAEF,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,UAAU,EAAE,CAAC;AAC/D,YAAY,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runnerpro/backend",
-  "version": "1.35.0",
+  "version": "1.35.1",
   "description": "A collection of common backend functions",
   "exports": {
     ".": "./lib/cjs/index.js"