@runnerpro/backend 1.20.5 → 1.21.0

package/lib/cjs/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.runWithCostTracking = exports.createBedrockModelFromString = exports.createGoogleModelFromString = exports.createGoogleModel = exports.generateText = exports.generateObject = exports.reprocessRecentMedia = exports.processMediaFile = exports.describeImage = exports.transcribeAudio = exports.updateSenderView = exports.saveResponseTime = exports.saveWorkoutAplication = exports.getPlanificacionPrueba7dias = exports.sendWorkoutToWatch = exports.getDefaultWorkoutImage = exports.generateShareMap = exports.reduceSizeImage = exports.getLetter = exports.getNumberByLetter = exports.appendSheet = exports.writeSheet = exports.findCellByValue = exports.readSheet = exports.NOTION_DATABASES_ID = exports.notionEditPage = exports.notionAddPage = exports.notionGetDatabase = exports.notionGetUsers = exports.getCountNotificaciones = exports.chatExposed = exports.chatApi = exports.chat = exports.getExerciseTranslatedDescription = exports.useTranslation = exports.LANGUAGES = exports.translate = exports.CHANNEL_SLACK = exports.notifySlack = exports.fetchIA = exports.err = exports.sendMail = exports.pool = exports.toPgArray = exports.batchQuery = exports.longRunningQuery = exports.queryWithClient = exports.query = exports.sleep = exports.sendNotification = void 0;
-exports.calculateCost = exports.MODEL_PRICING = exports.AISTUDIO_PREFIX = exports.BEDROCK_CLAUDE_HAIKU = exports.BEDROCK_CLAUDE_SONNET_4 = exports.BEDROCK_CLAUDE_SONNET_4_5 = exports.BEDROCK_CLAUDE_OPUS_4_1 = exports.BEDROCK_CLAUDE_OPUS_4_5 = exports.BEDROCK_CLAUDE_SONNET = exports.BEDROCK_CLAUDE_OPUS = exports.FALLBACK_MODELS = exports.PRODUCTION_MODELS = exports.GOOGLE_MODELS = exports.AI_MODELS = exports.MODEL_TIER = exports.runWithModels = void 0;
+exports.createGoogleModel = exports.generateText = exports.generateObject = exports.reprocessRecentMedia = exports.processMediaFile = exports.describeImage = exports.transcribeAudio = exports.updateSenderView = exports.saveResponseTime = exports.getZone = exports.saveDoneStructuraWorkout = exports.saveWorkoutLaps = exports.saveWorkoutAplication = exports.getPlanificacionPrueba7dias = exports.sendWorkoutToWatch = exports.getDefaultWorkoutImage = exports.generateShareMap = exports.reduceSizeImage = exports.getLetter = exports.getNumberByLetter = exports.appendSheet = exports.writeSheet = exports.findCellByValue = exports.readSheet = exports.NOTION_DATABASES_ID = exports.notionEditPage = exports.notionAddPage = exports.notionGetDatabase = exports.notionGetUsers = exports.getCountNotificaciones = exports.chatExposed = exports.chatApi = exports.chat = exports.getExerciseTranslatedDescription = exports.useTranslation = exports.LANGUAGES = exports.translate = exports.CHANNEL_SLACK = exports.notifySlack = exports.fetchIA = exports.err = exports.sendMail = exports.pool = exports.toPgArray = exports.batchQuery = exports.longRunningQuery = exports.queryWithClient = exports.query = exports.sleep = exports.sendNotification = void 0;
+exports.calculateCost = exports.MODEL_PRICING = exports.AISTUDIO_PREFIX = exports.BEDROCK_CLAUDE_HAIKU = exports.BEDROCK_CLAUDE_SONNET_4 = exports.BEDROCK_CLAUDE_SONNET_4_5 = exports.BEDROCK_CLAUDE_OPUS_4_1 = exports.BEDROCK_CLAUDE_OPUS_4_5 = exports.BEDROCK_CLAUDE_SONNET = exports.BEDROCK_CLAUDE_OPUS = exports.FALLBACK_MODELS = exports.PRODUCTION_MODELS = exports.GOOGLE_MODELS = exports.AI_MODELS = exports.MODEL_TIER = exports.runWithModels = exports.runWithCostTracking = exports.createBedrockModelFromString = exports.createGoogleModelFromString = void 0;
 const sendNotification_1 = require("./sendNotification");
 Object.defineProperty(exports, "sendNotification", { enumerable: true, get: function () { return sendNotification_1.sendNotification; } });
 const sleep_1 = require("./sleep");
@@ -57,6 +57,12 @@ const planificacionPrueba7dias_1 = require("./workout/planificacionPrueba7dias")
 Object.defineProperty(exports, "getPlanificacionPrueba7dias", { enumerable: true, get: function () { return planificacionPrueba7dias_1.getPlanificacionPrueba7dias; } });
 const saveWorkoutAplication_1 = require("./workout/saveWorkoutAplication");
 Object.defineProperty(exports, "saveWorkoutAplication", { enumerable: true, get: function () { return saveWorkoutAplication_1.saveWorkoutAplication; } });
+const saveWorkoutLaps_1 = require("./workout/saveWorkoutLaps");
+Object.defineProperty(exports, "saveWorkoutLaps", { enumerable: true, get: function () { return saveWorkoutLaps_1.saveWorkoutLaps; } });
+const estructuraWorkout_1 = require("./workout/estructuraWorkout");
+Object.defineProperty(exports, "saveDoneStructuraWorkout", { enumerable: true, get: function () { return estructuraWorkout_1.saveDoneStructuraWorkout; } });
+const paceZone_1 = require("./workout/paceZone");
+Object.defineProperty(exports, "getZone", { enumerable: true, get: function () { return paceZone_1.getZone; } });
 const saveResponseTime_1 = require("./chat/saveResponseTime");
 Object.defineProperty(exports, "saveResponseTime", { enumerable: true, get: function () { return saveResponseTime_1.saveResponseTime; } });
 const conversation_1 = require("./chat/api/conversation");

package/lib/cjs/types/index.d.ts

@@ -15,9 +15,12 @@ import { getDefaultWorkoutImage } from './image/getDefaultWorkoutImage';
 import { sendWorkoutToWatch } from './workout/sendToWatch';
 import { getPlanificacionPrueba7dias } from './workout/planificacionPrueba7dias';
 import { saveWorkoutAplication } from './workout/saveWorkoutAplication';
+import { saveWorkoutLaps } from './workout/saveWorkoutLaps';
+import { saveDoneStructuraWorkout } from './workout/estructuraWorkout';
+import { getZone } from './workout/paceZone';
 import { saveResponseTime } from './chat/saveResponseTime';
 import { updateSenderView } from './chat/api/conversation';
 import { transcribeAudio, describeImage, processMediaFile, reprocessRecentMedia } from './mediaProcessing';
 import { generateObject, generateText, createGoogleModel, createGoogleModelFromString, createBedrockModelFromString, runWithCostTracking, runWithModels, MODEL_TIER, AI_MODELS, GOOGLE_MODELS, PRODUCTION_MODELS, FALLBACK_MODELS, BEDROCK_CLAUDE_OPUS, BEDROCK_CLAUDE_SONNET, BEDROCK_CLAUDE_OPUS_4_5, BEDROCK_CLAUDE_OPUS_4_1, BEDROCK_CLAUDE_SONNET_4_5, BEDROCK_CLAUDE_SONNET_4, BEDROCK_CLAUDE_HAIKU, AISTUDIO_PREFIX, MODEL_PRICING, calculateCost } from './prompt';
-export { sendNotification, sleep, query, queryWithClient, longRunningQuery, batchQuery, toPgArray, pool, sendMail, err, fetchIA, notifySlack, CHANNEL_SLACK, translate, LANGUAGES, useTranslation, getExerciseTranslatedDescription, chat, chatApi, chatExposed, getCountNotificaciones, notionGetUsers, notionGetDatabase, notionAddPage, notionEditPage, NOTION_DATABASES_ID, readSheet, findCellByValue, writeSheet, appendSheet, getNumberByLetter, getLetter, reduceSizeImage, generateShareMap, getDefaultWorkoutImage, sendWorkoutToWatch, getPlanificacionPrueba7dias, saveWorkoutAplication, saveResponseTime, updateSenderView, transcribeAudio, describeImage, processMediaFile, reprocessRecentMedia, generateObject, generateText, createGoogleModel, createGoogleModelFromString, createBedrockModelFromString, runWithCostTracking, runWithModels, MODEL_TIER, AI_MODELS, GOOGLE_MODELS, PRODUCTION_MODELS, FALLBACK_MODELS, BEDROCK_CLAUDE_OPUS, BEDROCK_CLAUDE_SONNET, BEDROCK_CLAUDE_OPUS_4_5, BEDROCK_CLAUDE_OPUS_4_1, BEDROCK_CLAUDE_SONNET_4_5, BEDROCK_CLAUDE_SONNET_4, BEDROCK_CLAUDE_HAIKU, AISTUDIO_PREFIX, MODEL_PRICING, calculateCost, };
+export { sendNotification, sleep, query, queryWithClient, longRunningQuery, batchQuery, toPgArray, pool, sendMail, err, fetchIA, notifySlack, CHANNEL_SLACK, translate, LANGUAGES, useTranslation, getExerciseTranslatedDescription, chat, chatApi, chatExposed, getCountNotificaciones, notionGetUsers, notionGetDatabase, notionAddPage, notionEditPage, NOTION_DATABASES_ID, readSheet, findCellByValue, writeSheet, appendSheet, getNumberByLetter, getLetter, reduceSizeImage, generateShareMap, getDefaultWorkoutImage, sendWorkoutToWatch, getPlanificacionPrueba7dias, saveWorkoutAplication, saveWorkoutLaps, saveDoneStructuraWorkout, getZone, saveResponseTime, updateSenderView, transcribeAudio, describeImage, processMediaFile, reprocessRecentMedia, generateObject, generateText, createGoogleModel, createGoogleModelFromString, createBedrockModelFromString, runWithCostTracking, runWithModels, MODEL_TIER, AI_MODELS, GOOGLE_MODELS, PRODUCTION_MODELS, FALLBACK_MODELS, BEDROCK_CLAUDE_OPUS, BEDROCK_CLAUDE_SONNET, BEDROCK_CLAUDE_OPUS_4_5, BEDROCK_CLAUDE_OPUS_4_1, BEDROCK_CLAUDE_SONNET_4_5, BEDROCK_CLAUDE_SONNET_4, BEDROCK_CLAUDE_HAIKU, AISTUDIO_PREFIX, MODEL_PRICING, calculateCost, };
 //# sourceMappingURL=index.d.ts.map

package/lib/cjs/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC7F,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,gCAAgC,EAAE,MAAM,eAAe,CAAC;AACvG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,QAAQ,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACjH,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAClH,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC3G,OAAO,EACL,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,2BAA2B,EAC3B,4BAA4B,EAC5B,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,aAAa,EACd,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,gBAAgB,EAChB,KAAK,EACL,KAAK,EACL,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,SAAS,EACT,IAAI,EACJ,QAAQ,EACR,GAAG,EACH,OAAO,EACP,WAAW,EACX,aAAa,EACb,SAAS,EACT,SAAS,EACT,cAAc,EACd,gCAAgC,EAChC,IAAI,EACJ,OAAO,EACP,WAAW,EACX,sBAAsB,EACtB,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,SAAS,EACT,eAAe,EACf,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,2BAA2B,EAC3B,qBAAqB,EACrB,eAAe,EACf,wBAAwB,EACxB,OAAO,EACP,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,2BAA2B,EAC3B,4BAA4B,EAC5B,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,aAAa,GACd,CAAC"}

package/lib/cjs/types/workout/estructuraWorkout.d.ts

@@ -1,4 +1,21 @@
 declare const getStructuraWorkout: (workout: any, estructura: any) => any;
-declare const saveDoneStructuraWorkout: (idWorkout: any, estructura: any, workoutType: any) => Promise<void>;
+/**
+ * CANÓNICA — guarda los valores reales por serie en WORKOUT STRUCTURE.
+ *
+ * Promovida desde `third-party-backend/src/utils/functions/estructuraWorkout.js`
+ * (implementación de referencia) para reemplazar las 4 copias divergentes
+ * (Strava/Garmin/Apple/lib). Firma unificada `(idWorkout)`, autosuficiente:
+ * lee de BD WORKOUT LAP, WORKOUT STREAM, WORKOUT y WORKOUT STRUCTURE.
+ *
+ * Invariante de no-degradación: `hasWatchData` se evalúa leyendo WORKOUT LAP /
+ * WORKOUT STREAM de la BD (no de quién invoca). Por tanto, una vez que un
+ * workout tiene laps, cualquier recálculo posterior — incluido el de una fuente
+ * sin laps que mergee después (p.ej. Apple) — vuelve a entrar en `...Watch` y
+ * NUNCA degrada la estructura real a planificada. Comportamiento monótono:
+ * "copia primero (Copy), verdad cuando lleguen los laps (Watch)".
+ *
+ * @param {number|string} idWorkout
+ */
+declare const saveDoneStructuraWorkout: (idWorkout: any) => Promise<void>;
 export { getStructuraWorkout, saveDoneStructuraWorkout };
 //# sourceMappingURL=estructuraWorkout.d.ts.map

package/lib/cjs/types/workout/estructuraWorkout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"estructuraWorkout.d.ts","sourceRoot":"","sources":["../../../../src/workout/estructuraWorkout.ts"],"names":[],"mappings":"AAuCA,QAAA,MAAM,mBAAmB,wCAiCxB,CAAC;AAEF,QAAA,MAAM,wBAAwB,sEAkC7B,CAAC;AAGF,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,CAAC"}
+{"version":3,"file":"estructuraWorkout.d.ts","sourceRoot":"","sources":["../../../../src/workout/estructuraWorkout.ts"],"names":[],"mappings":"AAuCA,QAAA,MAAM,mBAAmB,YAAa,GAAG,cAAc,GAAG,QAiCzD,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,QAAA,MAAM,wBAAwB,cAAqB,GAAG,kBAkBrD,CAAC;AAuOF,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,CAAC"}

package/lib/cjs/types/workout/paceZone.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Cálculo de la zona de ritmo (1-6) de un workout a partir de su pace y de
+ * las pace zones del cliente. Portado de
+ * `Cliente-backend/src/utils/functions/aplicaciones/appleHealth.js` para
+ * centralizar la lógica en la lib (Fase 1 del plan de dedup cross-proveedor).
+ *
+ * `zones` viene de un SELECT de las columnas "PACE ZONE 1".."PACE ZONE 6"
+ * de la tabla CLIENTE; el helper `query` las cameliza a paceZone1..paceZone6.
+ *
+ * @param {{ duration: number|null, distance: number|null, zones: any }} input
+ * @returns {number} zona 1-6 (1 si no hay datos suficientes)
+ */
+declare const getZone: ({ duration, distance, zones }: {
+    duration: any;
+    distance: any;
+    zones: any;
+}) => number;
+export { getZone };
+//# sourceMappingURL=paceZone.d.ts.map

package/lib/cjs/types/workout/paceZone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paceZone.d.ts","sourceRoot":"","sources":["../../../../src/workout/paceZone.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,QAAA,MAAM,OAAO;cAA+C,GAAG;cAAY,GAAG;WAAS,GAAG;MAAK,MAkB9F,CAAC;AAEF,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/lib/cjs/types/workout/saveWorkoutAplication.d.ts

@@ -1,17 +1,13 @@
-declare const saveWorkoutAplication: ({ date, type, title, description, distance, duration, power, desnivel, polyline, idCliente, aplicationType, aplicationId, queryConditionExist }: {
-    date: any;
-    type: any;
-    title: any;
-    description: any;
-    distance: any;
-    duration: any;
-    power: any;
-    desnivel: any;
-    polyline: any;
-    idCliente: any;
-    aplicationType: any;
-    aplicationId: any;
-    queryConditionExist: any;
-}, data: any) => Promise<any>;
+/**
+ * @param opts {{
+ *   date, type, title, description, distance, duration, power, desnivel, polyline,
+ *   idCliente, aplicationType, aplicationId,
+ *   queryConditionExist?,   // LEGACY string SQL — deprecated, fallback
+ *   tiposEquivalentes?,     // string[] de TYPEs equivalentes
+ *   calories?, heartrate?, streams?
+ * }}
+ * @returns {Promise<number|null>} idWorkout (o null si no se pudo crear) — firma intacta
+ */
+declare const saveWorkoutAplication: (opts: any, _data?: any) => Promise<number | null>;
 export { saveWorkoutAplication };
 //# sourceMappingURL=saveWorkoutAplication.d.ts.map

package/lib/cjs/types/workout/saveWorkoutAplication.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"saveWorkoutAplication.d.ts","sourceRoot":"","sources":["../../../../src/workout/saveWorkoutAplication.ts"],"names":[],"mappings":"AAUA,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;6BAwD1B,CAAC;AA8CF,OAAO,EAAE,qBAAqB,EAAE,CAAC"}
+{"version":3,"file":"saveWorkoutAplication.d.ts","sourceRoot":"","sources":["../../../../src/workout/saveWorkoutAplication.ts"],"names":[],"mappings":"AAsPA;;;;;;;;;GASG;AACH,QAAA,MAAM,qBAAqB,SACnB,GAAG,UAED,GAAG,KACV,QAAQ,MAAM,GAAG,IAAI,CAmDvB,CAAC;AA+DF,OAAO,EAAE,qBAAqB,EAAE,CAAC"}

package/lib/cjs/types/workout/saveWorkoutLaps.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Persistencia centralizada de WORKOUT LAP (Fase 1 plan dedup cross-proveedor).
+ *
+ * `laps` viene ya normalizado por el adaptador del proveedor:
+ *   [{ index: number, durationStartLap: number }]
+ *
+ * Política de merge cross-proveedor (coherente con `mergeStreams`):
+ * gana el conjunto con MÁS laps. Tras persistir, re-dispara
+ * `saveDoneStructuraWorkout(idWorkout)` para recalcular la estructura real
+ * ahora que ya hay laps en BD (rama `...Watch`).
+ *
+ * Es función pública aparte (no entra en la firma de `saveWorkoutAplication`)
+ * porque Garmin entrega los laps en el webhook `/files`, desacoplado del
+ * `/details` que crea el workout.
+ *
+ * NOTA (// TODO): no se persiste la fuente que escribió los laps, así que el
+ * desempate por prioridad de fuente con igual nº de laps no es posible sin
+ * estado extra; se usa estrictamente "más laps gana" (empate → se conserva lo
+ * existente, sin churn). El parámetro `aplicationType` se acepta para futura
+ * trazabilidad y coherencia de firma con el resto de la lib.
+ *
+ * @param {number|string} idWorkout
+ * @param {{index:number,durationStartLap:number}[]} laps
+ * @param {number} aplicationType  TIPO_APLICACION.* (reservado para trazabilidad)
+ */
+declare const saveWorkoutLaps: (idWorkout: any, laps: any[], aplicationType?: any) => Promise<void>;
+export { saveWorkoutLaps };
+//# sourceMappingURL=saveWorkoutLaps.d.ts.map

package/lib/cjs/types/workout/saveWorkoutLaps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"saveWorkoutLaps.d.ts","sourceRoot":"","sources":["../../../../src/workout/saveWorkoutLaps.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,QAAA,MAAM,eAAe,cAAqB,GAAG,QAAQ,GAAG,EAAE,mBAAmB,GAAG,KAAG,QAAQ,IAAI,CAuB9F,CAAC;AAEF,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/lib/cjs/workout/estructuraWorkout.js

@@ -11,6 +11,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.saveDoneStructuraWorkout = exports.getStructuraWorkout = void 0;
 const db_1 = require("../db");
+const sendMail_1 = require("../sendMail");
 const common_1 = require("@runnerpro/common");
 const calculateZone = (values) => {
     const percentage = Number(values.pacePercentage);
@@ -67,38 +68,245 @@ const getStructuraWorkout = (workout, estructura) => {
     }
 };
 exports.getStructuraWorkout = getStructuraWorkout;
-const saveDoneStructuraWorkout = (idWorkout, estructura, workoutType) => __awaiter(void 0, void 0, void 0, function* () {
-    const estructuraBBDD = yield (0, db_1.query)('SELECT * FROM [WORKOUT STRUCTURE] WHERE [ID WORKOUT] = ? ORDER BY [INDEX]', [idWorkout]);
-    let i = 0;
-    for (const row of estructuraBBDD) {
+/**
+ * CANÓNICA — guarda los valores reales por serie en WORKOUT STRUCTURE.
+ *
+ * Promovida desde `third-party-backend/src/utils/functions/estructuraWorkout.js`
+ * (implementación de referencia) para reemplazar las 4 copias divergentes
+ * (Strava/Garmin/Apple/lib). Firma unificada `(idWorkout)`, autosuficiente:
+ * lee de BD WORKOUT LAP, WORKOUT STREAM, WORKOUT y WORKOUT STRUCTURE.
+ *
+ * Invariante de no-degradación: `hasWatchData` se evalúa leyendo WORKOUT LAP /
+ * WORKOUT STREAM de la BD (no de quién invoca). Por tanto, una vez que un
+ * workout tiene laps, cualquier recálculo posterior — incluido el de una fuente
+ * sin laps que mergee después (p.ej. Apple) — vuelve a entrar en `...Watch` y
+ * NUNCA degrada la estructura real a planificada. Comportamiento monótono:
+ * "copia primero (Copy), verdad cuando lleguen los laps (Watch)".
+ *
+ * @param {number|string} idWorkout
+ */
+const saveDoneStructuraWorkout = (idWorkout) => __awaiter(void 0, void 0, void 0, function* () {
+    const [laps, streamData, [workout], estructura] = yield Promise.all([
+        (0, db_1.query)('SELECT * FROM "WORKOUT LAP" WHERE "ID WORKOUT" = ? ORDER BY "INDEX"', [idWorkout]),
+        (0, db_1.query)('SELECT * FROM "WORKOUT STREAM" WHERE "ID WORKOUT" = ?', [idWorkout]),
+        (0, db_1.query)('SELECT "DURATION", "ID CLIENTE", "TYPE" FROM "WORKOUT" WHERE "ID" = ?', [idWorkout]),
+        (0, db_1.query)('SELECT * FROM "WORKOUT STRUCTURE" WHERE "ID WORKOUT" = ? ORDER BY "INDEX"', [idWorkout]),
+    ]);
+    // Workout sin estructura (no es entrenamiento por series) → nada que hacer.
+    if (!estructura || estructura.length === 0 || !workout)
+        return;
+    const hasWatchData = laps.length > 0 && streamData.length > 0;
+    if (hasWatchData) {
+        yield saveDoneStructuraWorkoutWatch(idWorkout, streamData, laps, workout, estructura);
+    }
+    else {
+        yield saveDoneStructuraWorkoutCopy(idWorkout, workout, estructura);
+    }
+});
+exports.saveDoneStructuraWorkout = saveDoneStructuraWorkout;
+const saveDoneStructuraWorkoutWatch = (idWorkout, streamData, laps, workout, estructura) => __awaiter(void 0, void 0, void 0, function* () {
+    const streams = {};
+    streamData.forEach((item) => {
+        try {
+            streams[item.metricType] = typeof item.data === 'string' ? JSON.parse(item.data) : item.data;
+        }
+        catch (error) {
+            streams[item.metricType] = item.data;
+        }
+    });
+    const numPasos = estructura.length;
+    const numLaps = laps.length;
+    if (numPasos !== numLaps && numPasos !== numLaps + 1) {
+        return (0, sendMail_1.sendMail)({
+            title: 'Estructura workout: laps no coinciden con pasos',
+            subject: 'Dedup cross-proveedor - Error saving steps structure workout',
+            body: JSON.stringify({ idWorkout, laps, estructura }),
+            to: ['david.jimenez@runnerpro.app'],
+        });
+    }
+    for (let i = 0; i < estructura.length; i++) {
+        const row = estructura[i];
         let distance = 0;
         let duration = 0;
         let distancePlanned = 0;
         let durationPlanned = 0;
-        const pace = estructura ? estructura[i].valueMetric2 : row.valueMetric2;
+        let fcMedia = null;
+        const pacePlanned = row.valueMetric2;
+        if (Number(row.typeMetric1) === 1) {
+            distancePlanned = row.valueMetric1;
+            durationPlanned = (0, common_1.getWorkoutParamsByType)(workout.type).calculateDuration({ distance: row.valueMetric1, pace: pacePlanned });
+        }
+        else {
+            durationPlanned = row.valueMetric1;
+            if (Number(row.type) === 3) {
+                distancePlanned = null;
+            }
+            else {
+                distancePlanned = (0, common_1.getWorkoutParamsByType)(workout.type).calculateDistance({ duration: row.valueMetric1, pace: pacePlanned, decimals: 2 });
+            }
+        }
+        let lapIndex = null;
+        if (numPasos === numLaps + 1) {
+            if (i < numLaps)
+                lapIndex = i;
+        }
+        else {
+            lapIndex = i;
+        }
+        if (lapIndex !== null && lapIndex >= 0 && lapIndex < laps.length) {
+            const currentLap = laps[lapIndex];
+            const nextLap = laps[lapIndex + 1];
+            if (nextLap) {
+                duration = nextLap.durationStartLap - currentLap.durationStartLap;
+            }
+            else {
+                duration = workout.duration - currentLap.durationStartLap;
+            }
+            if (Number(row.typeMetric1) === 2 && Math.abs(duration - Number(durationPlanned)) < 10) {
+                duration = Number(durationPlanned);
+            }
+            const timeStream = streams.time || [];
+            const distanceStream = streams.distance || [];
+            if (timeStream.length > 0 && distanceStream.length > 0) {
+                const startTime = currentLap.durationStartLap;
+                const endTime = nextLap ? nextLap.durationStartLap : workout.duration;
+                let startIndex = 0;
+                let endIndex = timeStream.length - 1;
+                for (let j = 0; j < timeStream.length; j++) {
+                    if (timeStream[j] >= startTime && startIndex === 0)
+                        startIndex = j;
+                    if (timeStream[j] >= endTime) {
+                        endIndex = j;
+                        break;
+                    }
+                }
+                const startDistance = distanceStream[startIndex] || 0;
+                const endDistance = distanceStream[endIndex] || 0;
+                distance = Math.round(Math.max(0, endDistance - startDistance));
+                if (Number(row.typeMetric1) === 1 && Math.abs(distance - Number(distancePlanned)) < 20) {
+                    distance = Number(distancePlanned);
+                }
+            }
+            const heartrateStream = streams.heartrate || [];
+            if (heartrateStream.length > 0) {
+                const startTime = currentLap.durationStartLap;
+                const endTime = nextLap ? nextLap.durationStartLap : workout.duration;
+                let startIndex = 0;
+                let endIndex = timeStream.length - 1;
+                for (let j = 0; j < timeStream.length; j++) {
+                    if (timeStream[j] >= startTime && startIndex === 0)
+                        startIndex = j;
+                    if (timeStream[j] >= endTime) {
+                        endIndex = j;
+                        break;
+                    }
+                }
+                const heartrateValues = heartrateStream
+                    .slice(startIndex, endIndex + 1)
+                    .filter((hr) => hr !== null && hr !== undefined && !isNaN(hr));
+                if (heartrateValues.length > 0) {
+                    const sum = heartrateValues.reduce((acc, hr) => acc + Number(hr), 0);
+                    fcMedia = Math.round(sum / heartrateValues.length);
+                }
+            }
+        }
+        else if (numPasos === numLaps + 1 && i === numLaps) {
+            const lastLap = laps[laps.length - 1];
+            duration = workout.duration - lastLap.durationStartLap;
+            if (Number(row.typeMetric1) === 2 && Math.abs(duration - Number(durationPlanned)) < 10) {
+                duration = Number(durationPlanned);
+            }
+            const timeStream = streams.time || [];
+            const distanceStream = streams.distance || [];
+            if (timeStream.length > 0 && distanceStream.length > 0) {
+                const startTime = lastLap.durationStartLap;
+                const endTime = workout.duration;
+                let startIndex = 0;
+                let endIndex = timeStream.length - 1;
+                for (let j = 0; j < timeStream.length; j++) {
+                    if (timeStream[j] >= startTime && startIndex === 0)
+                        startIndex = j;
+                    if (timeStream[j] >= endTime) {
+                        endIndex = j;
+                        break;
+                    }
+                }
+                const startDistance = distanceStream[startIndex] || 0;
+                const endDistance = distanceStream[endIndex] || 0;
+                distance = Math.round(Math.max(0, endDistance - startDistance));
+                if (Number(row.typeMetric1) === 1 && Math.abs(distance - Number(distancePlanned)) < 20) {
+                    distance = Number(distancePlanned);
+                }
+            }
+            const heartrateStream = streams.heartrate || [];
+            if (heartrateStream.length > 0) {
+                const startTime = lastLap.durationStartLap;
+                const endTime = workout.duration;
+                const timeStreamForHR = streams.time || [];
+                let startIndex = 0;
+                let endIndex = timeStreamForHR.length - 1;
+                for (let j = 0; j < timeStreamForHR.length; j++) {
+                    if (timeStreamForHR[j] >= startTime && startIndex === 0)
+                        startIndex = j;
+                    if (timeStreamForHR[j] >= endTime) {
+                        endIndex = j;
+                        break;
+                    }
+                }
+                const heartrateValues = heartrateStream
+                    .slice(startIndex, endIndex + 1)
+                    .filter((hr) => hr !== null && hr !== undefined && !isNaN(hr));
+                if (heartrateValues.length > 0) {
+                    const sum = heartrateValues.reduce((acc, hr) => acc + Number(hr), 0);
+                    fcMedia = Math.round(sum / heartrateValues.length);
+                }
+            }
+        }
+        else {
+            const pace = row.valueMetric2;
+            if (Number(row.typeMetric1) === 1) {
+                distance = row.valueMetric1;
+                duration = (0, common_1.getWorkoutParamsByType)(workout.type).calculateDuration({ distance: row.valueMetric1, pace });
+            }
+            else {
+                duration = row.valueMetric1;
+                if (Number(row.type) === 3) {
+                    distance = null;
+                }
+                else {
+                    distance = (0, common_1.getWorkoutParamsByType)(workout.type).calculateDistance({ duration: row.valueMetric1, pace, decimals: 2 });
+                }
+            }
+        }
+        yield (0, db_1.query)('UPDATE "WORKOUT STRUCTURE" SET "DISTANCE PLANNED" = ?, "DISTANCE" = ?, "DURATION PLANNED" = ?, "DURATION" = ?, "FC MEDIA" = ?, "DESNIVEL" = ? WHERE "INDEX" = ? AND "ID WORKOUT" = ?', [distancePlanned, distance, durationPlanned, duration, fcMedia, row.desnivelPlanned, row.index, idWorkout]);
+    }
+});
+const saveDoneStructuraWorkoutCopy = (idWorkout, workout, estructura) => __awaiter(void 0, void 0, void 0, function* () {
+    for (const row of estructura) {
+        let distance = 0;
+        let duration = 0;
+        let distancePlanned = 0;
+        let durationPlanned = 0;
+        const pace = row.valueMetric2;
         const pacePlanned = row.valueMetric2;
         if (Number(row.typeMetric1) === 1) {
             distancePlanned = row.valueMetric1;
             distance = row.valueMetric1;
-            durationPlanned = (0, common_1.getWorkoutParamsByType)(workoutType).calculateDuration({ distance: row.valueMetric1, pace: pacePlanned });
-            duration = (0, common_1.getWorkoutParamsByType)(workoutType).calculateDuration({ distance: row.valueMetric1, pace });
+            durationPlanned = (0, common_1.getWorkoutParamsByType)(workout.type).calculateDuration({ distance: row.valueMetric1, pace: pacePlanned });
+            duration = (0, common_1.getWorkoutParamsByType)(workout.type).calculateDuration({ distance: row.valueMetric1, pace });
         }
         else {
             durationPlanned = row.valueMetric1;
             duration = row.valueMetric1;
             if (Number(row.type) === 3) {
-                // @ts-ignore
                 distancePlanned = null;
-                // @ts-ignore
                 distance = null;
             }
             else {
-                distancePlanned = (0, common_1.getWorkoutParamsByType)(workoutType).calculateDistance({ duration: row.valueMetric1, pace: pacePlanned, decimals: 2 });
-                distance = (0, common_1.getWorkoutParamsByType)(workoutType).calculateDistance({ duration: row.valueMetric1, pace, decimals: 2 });
+                distancePlanned = (0, common_1.getWorkoutParamsByType)(workout.type).calculateDistance({ duration: row.valueMetric1, pace: pacePlanned, decimals: 2 });
+                distance = (0, common_1.getWorkoutParamsByType)(workout.type).calculateDistance({ duration: row.valueMetric1, pace, decimals: 2 });
             }
         }
-        i++;
-        yield (0, db_1.query)('UPDATE [WORKOUT STRUCTURE] SET [DISTANCE PLANNED] = ?, [DISTANCE] = ?, [DURATION PLANNED] = ?, [DURATION] = ?, [DESNIVEL] = ? WHERE [INDEX] = ? AND [ID WORKOUT] = ?', [distancePlanned, distance, durationPlanned, duration, row.desnivelPlanned, row.index, idWorkout]);
+        yield (0, db_1.query)('UPDATE "WORKOUT STRUCTURE" SET "DISTANCE PLANNED" = ?, "DISTANCE" = ?, "DURATION PLANNED" = ?, "DURATION" = ?, "FC MEDIA" = ?, "DESNIVEL" = ? WHERE "INDEX" = ? AND "ID WORKOUT" = ?', [distancePlanned, distance, durationPlanned, duration, null, row.desnivelPlanned, row.index, idWorkout]);
     }
 });
-exports.saveDoneStructuraWorkout = saveDoneStructuraWorkout;

package/lib/cjs/workout/paceZone.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getZone = void 0;
+/**
+ * Cálculo de la zona de ritmo (1-6) de un workout a partir de su pace y de
+ * las pace zones del cliente. Portado de
+ * `Cliente-backend/src/utils/functions/aplicaciones/appleHealth.js` para
+ * centralizar la lógica en la lib (Fase 1 del plan de dedup cross-proveedor).
+ *
+ * `zones` viene de un SELECT de las columnas "PACE ZONE 1".."PACE ZONE 6"
+ * de la tabla CLIENTE; el helper `query` las cameliza a paceZone1..paceZone6.
+ *
+ * @param {{ duration: number|null, distance: number|null, zones: any }} input
+ * @returns {number} zona 1-6 (1 si no hay datos suficientes)
+ */
+const getZone = ({ duration, distance, zones }) => {
+    if (!distance || !duration || !zones)
+        return 1;
+    const pace = Number(duration) / (Number(distance) / 1000); // s/km
+    let closestZone = 1;
+    let minDifference = Infinity;
+    for (let i = 1; i <= 6; i += 1) {
+        const zonePace = zones[`paceZone${i}`];
+        if (zonePace !== null && zonePace !== undefined && !Number.isNaN(Number(zonePace))) {
+            const diff = Math.abs(pace - Number(zonePace));
+            if (diff < minDifference) {
+                minDifference = diff;
+                closestZone = i;
+            }
+        }
+    }
+    return closestZone;
+};
+exports.getZone = getZone;

package/lib/cjs/workout/saveWorkoutAplication.js

@@ -22,49 +22,294 @@ const generateShareMap_1 = require("../image/generateShareMap");
 const getDefaultWorkoutImage_1 = require("../image/getDefaultWorkoutImage");
 const moment_1 = __importDefault(require("moment"));
 const estructuraWorkout_1 = require("./estructuraWorkout");
-const saveWorkoutAplication = ({ date, type, title, description, distance, duration, power, desnivel, polyline, idCliente, aplicationType, aplicationId, queryConditionExist }, data) => __awaiter(void 0, void 0, void 0, function* () {
-    const [exist] = yield (0, db_1.query)(`
-    SELECT [ID], [TYPE] 
-    FROM [WORKOUT] 
-    WHERE 
-        ([ID CLIENTE] = ? AND [DATE] = ? AND ${queryConditionExist} AND [DONE] = FALSE AND [SHOW CLIENT] = TRUE) 
-            OR 
-        ([ID APLICATION] = ? AND [TIPO APLICATION] = ?)
-    `, [idCliente, (0, moment_1.default)(date).format('YYYY-MM-DD'), aplicationId, aplicationType]);
-    let idWorkout;
-    if (!exist) {
-        const { title: titleNoTranslate, description: descriptionNoTranslate, titlePreferredLanguage, descriptionPreferredLanguage, } = yield (0, titleDescriptionTranslated_1.getTitleDescriptionTranslated)(idCliente, title, description);
-        [{ id: idWorkout }] = yield (0, db_1.query)(`
-        INSERT INTO [WORKOUT] ([ID CLIENTE], [DATE], [TITLE], [DESCRIPTION], [TITLE PREFERRED LANGUAGE], [DESCRIPTION PREFERRED LANGUAGE], [TYPE], [DONE], [SHOW CLIENT]) 
-        VALUES (?, ?, ?, ?, ?, ?, ?, TRUE, TRUE) RETURNING [ID]
-    `, [
-            idCliente,
-            (0, moment_1.default)(date).format('YYYY-MM-DD'),
-            titleNoTranslate,
-            descriptionNoTranslate,
-            titlePreferredLanguage,
-            descriptionPreferredLanguage,
-            type,
-        ]);
+const paceZone_1 = require("./paceZone");
+// =============================================================================
+// Prioridad de fuentes (Fase 1 plan dedup cross-proveedor)
+// Mayor = más fiable. No se mete en @runnerpro/common para no propagar una
+// constante de esta feature a todos los consumidores de la lib.
+// =============================================================================
+const APLICACION_PRIORITY = { 2: 3 /*GARMIN*/, 1: 2 /*STRAVA*/, 5: 1 /*APPLE_HEALTH*/ };
+const prioridadFuente = (t) => { var _a; return (_a = APLICACION_PRIORITY[Number(t)]) !== null && _a !== void 0 ? _a : 0; };
+// Grupo de tipos equivalentes para el advisory lock: serializa sólo las
+// ingestas que PODRÍAN matchear entre sí (CORRER/TRAIL/COMPETICION colisionan).
+const bucketTipo = (type) => {
+    if (['CORRER', 'TRAIL', 'COMPETICION'].includes(String(type)))
+        return 'CORRER_GROUP';
+    return String(type || 'UNKNOWN');
+};
+// Hash determinista string → int32 (clave de pg_advisory_xact_lock).
+const hashInt = (s) => {
+    let h = 0;
+    for (let i = 0; i < s.length; i++) {
+        h = (Math.imul(h, 31) + s.charCodeAt(i)) | 0;
+    }
+    return h;
+};
+// Predicado de tipo parametrizado (resuelve el Unknown queryConditionExist).
+// Sin interpolación de SQL crudo salvo el fallback legacy deprecated.
+const predicadoTipo = (opts) => {
+    if (Array.isArray(opts.tiposEquivalentes) && opts.tiposEquivalentes.length > 0) {
+        return { sql: '"TYPE" IN (?)', params: [opts.tiposEquivalentes] };
+    }
+    if (opts.queryConditionExist) {
+        // LEGACY deprecated: string SQL ya interpolado por el adaptador. Se elimina
+        // cuando los 4 repos migren a `tiposEquivalentes` (cierre Fase 4).
+        return { sql: opts.queryConditionExist, params: [] };
+    }
+    return { sql: '"TYPE" = ?', params: [opts.type] };
+};
+// =============================================================================
+// Helper de transacción (la lib no exporta uno; replica el patrón de
+// Cliente-backend/src/utils/functions/workoutAlternatives.js adaptado al
+// cliente pg de la lib, reusando la misma conversión de placeholders que
+// `db.getParseQuery` para mantener la convención `[ ]`/`?`/arrays).
+// =============================================================================
+function parseTx(queryText, values) {
+    queryText = queryText.split('[').join('"').split(']').join('"');
+    const splitted = queryText.split('?');
+    let count = 1;
+    return splitted.reduce((acc, chunk, i) => {
+        if (!(values[i] instanceof Array)) {
+            const text = `${acc}${chunk}${i + 1 === splitted.length ? '' : `$${count}`}`;
+            count++;
+            return text;
+        }
+        const aux = [];
+        values[i].forEach(() => {
+            aux.push(`$${count}`);
+            count++;
+        });
+        return `${acc}${chunk}${i + 1 === splitted.length ? '' : aux.join(',')}`;
+    }, '');
+}
+function camelize(str) {
+    return str
+        .toLowerCase()
+        .replace(/(?:^\w|[A-Z]|\b\w)/g, (word, index) => (index === 0 ? word.toLowerCase() : word.toUpperCase()))
+        .replace(/\s+/g, '');
+}
+function camelizeRow(row) {
+    const aux = {};
+    Object.keys(row).forEach((key) => {
+        aux[camelize(key)] = row[key];
+    });
+    return aux;
+}
+const withTx = (fn) => __awaiter(void 0, void 0, void 0, function* () {
+    const client = yield db_1.pool.connect();
+    try {
+        yield client.query('BEGIN');
+        const q = (text, values = []) => __awaiter(void 0, void 0, void 0, function* () {
+            const parsed = parseTx(text, values);
+            const result = yield client.query({ text: parsed, values: values.flat() });
+            return (result.rows || []).map(camelizeRow);
+        });
+        const res = yield fn(q);
+        yield client.query('COMMIT');
+        return res;
+    }
+    catch (error) {
+        try {
+            yield client.query('ROLLBACK');
+        }
+        catch (_) {
+            // Ignoramos el error de rollback: relanzamos el original.
+        }
+        throw error;
+    }
+    finally {
+        client.release();
+    }
+});
+// =============================================================================
+// Merge campo a campo
+// =============================================================================
+const resolverEscalar = (actual, nuevo, prioActual, prioNueva) => {
+    if (nuevo === null || nuevo === undefined)
+        return actual !== null && actual !== void 0 ? actual : null;
+    if (actual === null || actual === undefined)
+        return nuevo;
+    if (prioNueva >= prioActual)
+        return nuevo;
+    return actual;
+};
+const similar = (a, b, tol) => {
+    const an = a === null || a === undefined;
+    const bn = b === null || b === undefined;
+    if (an && bn)
+        return true;
+    if (an !== bn)
+        return false;
+    const na = Number(a);
+    const nb = Number(b);
+    if (na <= 0 || nb <= 0)
+        return na === nb;
+    return Math.abs(na - nb) / Math.max(na, nb) <= tol;
+};
+const buscarWorkoutSimilar = (q, opts, dateStr, pt) => __awaiter(void 0, void 0, void 0, function* () {
+    const rows = yield q(`SELECT "ID", "DURATION", "DISTANCE", "TIPO APLICATION"
+       FROM "WORKOUT"
+      WHERE "ID CLIENTE" = ? AND "DATE" = ? AND ${pt.sql}
+        AND "DONE" = TRUE AND "TIPO APLICATION" IS NOT NULL AND "TIPO APLICATION" <> ?`, [opts.idCliente, dateStr, ...pt.params, opts.aplicationType]);
+    const cand = rows.filter((r) => similar(r.duration, opts.duration, 0.1) && similar(r.distance, opts.distance, 0.1));
+    cand.sort((a, b) => prioridadFuente(b.tipoAplication) - prioridadFuente(a.tipoAplication));
+    return cand[0] || null;
+});
+const mergeStreams = (q, idWorkout, nuevos) => __awaiter(void 0, void 0, void 0, function* () {
+    if (!nuevos || typeof nuevos !== 'object')
+        return;
+    const ex = yield q('SELECT "METRIC TYPE", "DATA" FROM "WORKOUT STREAM" WHERE "ID WORKOUT" = ?', [idWorkout]);
+    const lenByType = {};
+    ex.forEach((r) => {
+        try {
+            const d = typeof r.data === 'string' ? JSON.parse(r.data) : r.data;
+            lenByType[r.metricType] = Array.isArray(d) ? d.length : 0;
+        }
+        catch (_) {
+            lenByType[r.metricType] = 0;
+        }
+    });
+    for (const key of Object.keys(nuevos)) {
+        const arr = nuevos[key];
+        if (!Array.isArray(arr) || arr.length === 0)
+            continue;
+        if (arr.length > (lenByType[key] || 0)) {
+            // Borrado SELECTIVO por METRIC TYPE — nunca DELETE global (destruiría
+            // streams aportados por otra fuente).
+            yield q('DELETE FROM "WORKOUT STREAM" WHERE "ID WORKOUT" = ? AND "METRIC TYPE" = ?', [idWorkout, key]);
+            yield q('INSERT INTO "WORKOUT STREAM" ("ID WORKOUT", "METRIC TYPE", "DATA") VALUES (?, ?, ?)', [
+                idWorkout,
+                key,
+                JSON.stringify(arr),
+            ]);
+        }
+    }
+});
+const registrarFuente = (q, idWorkout, tipo, idApp) => __awaiter(void 0, void 0, void 0, function* () {
+    yield q(`INSERT INTO "WORKOUT SOURCES" ("ID WORKOUT", "TIPO APLICATION", "ID APLICATION")
+     VALUES (?, ?, ?)
+     ON CONFLICT ("ID WORKOUT", "TIPO APLICATION")
+     DO UPDATE SET "ID APLICATION" = EXCLUDED."ID APLICATION", "INGESTED AT" = NOW()`, [idWorkout, String(tipo), idApp !== null && idApp !== undefined ? String(idApp) : null]);
+});
+const aplicarMerge = (q, idWorkout, opts, esFilaNueva) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b;
+    const [row] = yield q(`SELECT "DISTANCE", "DURATION", "POTENCIA", "DESNIVEL", "CALORIES", "FC MEDIA",
+            "ZONE", "POLYLINE", "TIPO APLICATION", "ID APLICATION"
+       FROM "WORKOUT" WHERE "ID" = ? FOR UPDATE`, [idWorkout]);
+    const prioNueva = prioridadFuente(opts.aplicationType);
+    const prioActual = esFilaNueva ? -1 : prioridadFuente(row === null || row === void 0 ? void 0 : row.tipoAplication);
+    const distance = resolverEscalar(row === null || row === void 0 ? void 0 : row.distance, opts.distance, prioActual, prioNueva);
+    const duration = resolverEscalar(row === null || row === void 0 ? void 0 : row.duration, opts.duration, prioActual, prioNueva);
+    const potencia = resolverEscalar(row === null || row === void 0 ? void 0 : row.potencia, opts.power, prioActual, prioNueva);
+    const desnivel = resolverEscalar(row === null || row === void 0 ? void 0 : row.desnivel, opts.desnivel, prioActual, prioNueva);
+    const calories = resolverEscalar(row === null || row === void 0 ? void 0 : row.calories, (_a = opts.calories) !== null && _a !== void 0 ? _a : null, prioActual, prioNueva);
+    const fcMedia = resolverEscalar(row === null || row === void 0 ? void 0 : row.fcMedia, (_b = opts.heartrate) !== null && _b !== void 0 ? _b : null, prioActual, prioNueva);
+    const [cli] = yield q(`SELECT "PACE ZONE 1", "PACE ZONE 2", "PACE ZONE 3", "PACE ZONE 4", "PACE ZONE 5", "PACE ZONE 6"
+       FROM "CLIENTE" WHERE "ID" = ?`, [opts.idCliente]);
+    const zone = (0, paceZone_1.getZone)({ duration, distance, zones: cli });
+    // POLYLINE: la primera fuente que la puso manda; nunca se pisa.
+    const polyline = row && row.polyline ? row.polyline : getPolyline(opts.polyline);
+    // TIPO/ID APLICATION: sólo se setean en INSERT o si la fila no tenía fuente;
+    // nunca se reemplazan (la primera fuente se queda).
+    let tipoFinal;
+    let idFinal;
+    if (esFilaNueva || !(row === null || row === void 0 ? void 0 : row.tipoAplication)) {
+        tipoFinal = opts.aplicationType;
+        idFinal = opts.aplicationId;
     }
     else {
-        idWorkout = exist.id;
-        yield (0, estructuraWorkout_1.saveDoneStructuraWorkout)(exist.id, null, exist.type);
+        tipoFinal = row.tipoAplication;
+        idFinal = row.idAplication;
     }
-    yield (0, db_1.query)(`
-    UPDATE [WORKOUT] SET [DISTANCE] = ?, [DURATION] = ?, [POTENCIA] = ?, [DESNIVEL] = ?, [POLYLINE] = ?, [TIPO APLICATION] = ?, [ID APLICATION] = ?, [DONE] = TRUE, [RAW] = ?
-    WHERE [ID] = ?
-    `, [distance, duration, power, desnivel, getPolyline(polyline), aplicationType, aplicationId, JSON.stringify(data), idWorkout]);
-    yield saveMap(idWorkout, polyline);
-    saveShareWorkoutImage(idWorkout, type);
+    const feelingsAsked = (0, moment_1.default)(opts.date).format('YYYY-MM-DD') !== (0, moment_1.default)().format('YYYY-MM-DD');
+    yield q(`UPDATE "WORKOUT" SET
+       "DISTANCE" = ?, "DURATION" = ?, "POTENCIA" = ?, "DESNIVEL" = ?, "CALORIES" = ?,
+       "FC MEDIA" = ?, "ZONE" = ?, "POLYLINE" = ?, "TIPO APLICATION" = ?, "ID APLICATION" = ?,
+       "FEELINGS ASKED" = ?, "DONE" = TRUE
+     WHERE "ID" = ?`, [distance, duration, potencia, desnivel, calories, fcMedia, zone, polyline, tipoFinal, idFinal, feelingsAsked, idWorkout]);
+    yield mergeStreams(q, idWorkout, opts.streams);
+});
+// =============================================================================
+// Orquestación principal
+// =============================================================================
+/**
+ * @param opts {{
+ *   date, type, title, description, distance, duration, power, desnivel, polyline,
+ *   idCliente, aplicationType, aplicationId,
+ *   queryConditionExist?,   // LEGACY string SQL — deprecated, fallback
+ *   tiposEquivalentes?,     // string[] de TYPEs equivalentes
+ *   calories?, heartrate?, streams?
+ * }}
+ * @returns {Promise<number|null>} idWorkout (o null si no se pudo crear) — firma intacta
+ */
+const saveWorkoutAplication = (opts, 
+// eslint-disable-next-line no-unused-vars, @typescript-eslint/no-unused-vars
+_data) => __awaiter(void 0, void 0, void 0, function* () {
+    const dateStr = (0, moment_1.default)(opts.date).format('YYYY-MM-DD');
+    const pt = predicadoTipo(opts);
+    const idWorkout = yield withTx((q) => __awaiter(void 0, void 0, void 0, function* () {
+        // Lock anti-carrera: serializa ingestas del mismo cliente/día/bucket-tipo
+        // (Strava-webhook y Garmin-push pueden entrar casi a la vez).
+        yield q('SELECT pg_advisory_xact_lock(?)', [hashInt(`${opts.idCliente}|${dateStr}|${bucketTipo(opts.type)}`)]);
+        // 1) dedup intra-proveedor / completar planificado (comportamiento actual común).
+        const [exist] = yield q(`SELECT "ID", "TYPE" FROM "WORKOUT"
+        WHERE ("ID CLIENTE" = ? AND "DATE" = ? AND ${pt.sql} AND "DONE" = FALSE AND "SHOW CLIENT" = TRUE)
+           OR ("ID APLICATION" = ? AND "TIPO APLICATION" = ?)
+        LIMIT 1`, [opts.idCliente, dateStr, ...pt.params, opts.aplicationId, opts.aplicationType]);
+        if (exist) {
+            yield aplicarMerge(q, exist.id, opts, false);
+            yield registrarFuente(q, exist.id, opts.aplicationType, opts.aplicationId);
+            return exist.id;
+        }
+        // 2) dedup CROSS-proveedor.
+        const sim = yield buscarWorkoutSimilar(q, opts, dateStr, pt);
+        if (sim) {
+            yield aplicarMerge(q, sim.id, opts, false);
+            yield registrarFuente(q, sim.id, opts.aplicationType, opts.aplicationId);
+            return sim.id;
+        }
+        // 3) INSERT nuevo (comportamiento actual).
+        const { title: titleNoTranslate, description: descriptionNoTranslate, titlePreferredLanguage, descriptionPreferredLanguage } = yield (0, titleDescriptionTranslated_1.getTitleDescriptionTranslated)(opts.idCliente, opts.title, opts.description);
+        const inserted = yield q(`INSERT INTO "WORKOUT"
+         ("ID CLIENTE", "DATE", "TITLE", "DESCRIPTION", "TITLE PREFERRED LANGUAGE", "DESCRIPTION PREFERRED LANGUAGE", "TYPE", "DONE", "SHOW CLIENT")
+       VALUES (?, ?, ?, ?, ?, ?, ?, TRUE, TRUE) RETURNING "ID"`, [opts.idCliente, dateStr, titleNoTranslate, descriptionNoTranslate, titlePreferredLanguage, descriptionPreferredLanguage, opts.type]);
+        if (!inserted || !inserted[0])
+            return null;
+        const id = inserted[0].id;
+        yield aplicarMerge(q, id, opts, true);
+        yield registrarFuente(q, id, opts.aplicationType, opts.aplicationId);
+        return id;
+    }));
+    if (!idWorkout)
+        return null;
+    yield postHooks(idWorkout, opts);
     return idWorkout;
 });
 exports.saveWorkoutAplication = saveWorkoutAplication;
+// postHooks SIEMPRE (fuera de la tx, en los 3 caminos). saveDoneStructuraWorkout
+// es idempotente: cae en ...Copy si aún no hay laps (p.ej. Apple, o Garmin
+// antes de /files) y en ...Watch cuando ya hay laps+streams.
+const postHooks = (idWorkout, opts) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        yield saveMap(idWorkout, opts.polyline);
+    }
+    catch (_) {
+        // Un fallo de Mapbox no debe romper la ingesta (estado ya persistido).
+    }
+    saveShareWorkoutImage(idWorkout, opts.type);
+    yield (0, estructuraWorkout_1.saveDoneStructuraWorkout)(idWorkout);
+});
+// getPolyline ampliado: acepta string ya-encoded (Apple `polylineEncoded`) o el
+// objeto `activity` con map.polyline/summary_polyline (Strava/Garmin).
 const getPolyline = (activity) => {
-    var _a, _b;
+    var _a;
+    if (!activity)
+        return null;
+    if (typeof activity === 'string')
+        return activity; // ya-encoded
     if (!((_a = activity === null || activity === void 0 ? void 0 : activity.map) === null || _a === void 0 ? void 0 : _a.polyline))
         return null;
-    const polyline = ((_b = activity.map) === null || _b === void 0 ? void 0 : _b.polyline.length) > 5000 ? activity.map.summary_polyline : activity.map.polyline;
+    const polyline = activity.map.polyline.length > 5000 ? activity.map.summary_polyline : activity.map.polyline;
     return encodeURIComponent(polyline);
 };
 const saveMap = (idWorkout, polyline) => __awaiter(void 0, void 0, void 0, function* () {
@@ -73,13 +318,15 @@ const saveMap = (idWorkout, polyline) => __awaiter(void 0, void 0, void 0, funct
     // @ts-ignore
     const serviceKey = path_1.default.join(process.cwd(), process.env.FIREBASE_STORAGE_CREDENTIALS);
     const storage = new storage_1.Storage({ keyFilename: serviceKey });
-    const encodedPolyline = encodeURIComponent(polyline);
+    const encodedPolyline = encodeURIComponent(typeof polyline === 'string' ? polyline : getPolyline(polyline) || '');
+    if (!encodedPolyline)
+        return;
     const result = yield axios_1.default.get(`https://api.mapbox.com/styles/v1/david-runnerpro/clqwrghcj013401qr5cch6z45/static/path-3+ea5b1b-100(${encodedPolyline})/auto/1080x1080?access_token=pk.eyJ1IjoiZGF2aWQtcnVubmVycHJvIiwiYSI6ImNscXdrZW56YTA0MTQybWxmNWx2b3Z6NjYifQ.g3vCR3HDRobLyr_4WFAeJA&logo=false`, { responseType: 'arraybuffer' });
     const imageBuffer = Buffer.from(result.data, 'binary');
     // @ts-ignore
     yield storage.bucket(process.env.CLOUD_STORAGE_BUCKET_PUBLIC).file(`Workout/${idWorkout}`).save(imageBuffer);
     const urlMap = `https://storage.googleapis.com/${process.env.CLOUD_STORAGE_BUCKET_PUBLIC}/Workout/${idWorkout}`;
-    yield (0, db_1.query)('UPDATE [WORKOUT] SET [HAVE MAP IMAGE] = TRUE, [PHOTO URL] = ? WHERE [ID] = ?', [urlMap, idWorkout]);
+    yield (0, db_1.query)('UPDATE "WORKOUT" SET "HAVE MAP IMAGE" = TRUE, "PHOTO URL" = ? WHERE "ID" = ?', [urlMap, idWorkout]);
 });
 const saveShareWorkoutImage = (id, type) => __awaiter(void 0, void 0, void 0, function* () {
     // @ts-ignore
@@ -97,5 +344,5 @@ const saveShareWorkoutImage = (id, type) => __awaiter(void 0, void 0, void 0, fu
     // @ts-ignore
     yield storage.bucket(process.env.CLOUD_STORAGE_BUCKET_PUBLIC).file(`Workout/${id}-share`).save(shareMap);
     const urlShare = `https://storage.googleapis.com/${process.env.CLOUD_STORAGE_BUCKET_PUBLIC}/Workout/${id}-share`;
-    yield (0, db_1.query)('UPDATE [WORKOUT] SET [PHOTO URL SHARE] = ? WHERE [ID] = ?', [urlShare, id]);
+    yield (0, db_1.query)('UPDATE "WORKOUT" SET "PHOTO URL SHARE" = ? WHERE "ID" = ?', [urlShare, id]);
 });

package/lib/cjs/workout/saveWorkoutLaps.js

@@ -0,0 +1,58 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.saveWorkoutLaps = void 0;
+const db_1 = require("../db");
+const estructuraWorkout_1 = require("./estructuraWorkout");
+/**
+ * Persistencia centralizada de WORKOUT LAP (Fase 1 plan dedup cross-proveedor).
+ *
+ * `laps` viene ya normalizado por el adaptador del proveedor:
+ *   [{ index: number, durationStartLap: number }]
+ *
+ * Política de merge cross-proveedor (coherente con `mergeStreams`):
+ * gana el conjunto con MÁS laps. Tras persistir, re-dispara
+ * `saveDoneStructuraWorkout(idWorkout)` para recalcular la estructura real
+ * ahora que ya hay laps en BD (rama `...Watch`).
+ *
+ * Es función pública aparte (no entra en la firma de `saveWorkoutAplication`)
+ * porque Garmin entrega los laps en el webhook `/files`, desacoplado del
+ * `/details` que crea el workout.
+ *
+ * NOTA (// TODO): no se persiste la fuente que escribió los laps, así que el
+ * desempate por prioridad de fuente con igual nº de laps no es posible sin
+ * estado extra; se usa estrictamente "más laps gana" (empate → se conserva lo
+ * existente, sin churn). El parámetro `aplicationType` se acepta para futura
+ * trazabilidad y coherencia de firma con el resto de la lib.
+ *
+ * @param {number|string} idWorkout
+ * @param {{index:number,durationStartLap:number}[]} laps
+ * @param {number} aplicationType  TIPO_APLICACION.* (reservado para trazabilidad)
+ */
+const saveWorkoutLaps = (idWorkout, laps, aplicationType) => __awaiter(void 0, void 0, void 0, function* () {
+    if (!idWorkout)
+        return;
+    const nuevos = Array.isArray(laps)
+        ? laps.filter((l) => l && l.index !== null && l.index !== undefined && l.durationStartLap !== null && l.durationStartLap !== undefined)
+        : [];
+    const [countRow] = yield (0, db_1.query)('SELECT COUNT(*)::int AS "N" FROM "WORKOUT LAP" WHERE "ID WORKOUT" = ?', [idWorkout]);
+    const existentes = Number((countRow === null || countRow === void 0 ? void 0 : countRow.n) || 0);
+    if (nuevos.length > existentes) {
+        yield (0, db_1.query)('DELETE FROM "WORKOUT LAP" WHERE "ID WORKOUT" = ?', [idWorkout]);
+        for (const lap of nuevos) {
+            yield (0, db_1.query)('INSERT INTO "WORKOUT LAP" ("ID WORKOUT", "INDEX", "DURATION START LAP") VALUES (?, ?, ?)', [idWorkout, lap.index, lap.durationStartLap]);
+        }
+    }
+    // si nuevos.length <= existentes: se conserva el conjunto existente (más detalle gana)
+    // Re-dispara el recálculo de la estructura real ahora que hay laps en BD.
+    yield (0, estructuraWorkout_1.saveDoneStructuraWorkout)(idWorkout);
+});
+exports.saveWorkoutLaps = saveWorkoutLaps;

package/package.json

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