@aneuhold/core-ts-db-lib 4.1.11 → 4.1.13

package/lib/services/workout/Exercise/WorkoutExerciseService.js

@@ -1,6 +1,7 @@
 import { ExerciseProgressionType, ExerciseRepRange } from '../../../documents/workout/WorkoutExercise.js';
 import WorkoutEquipmentTypeService from '../EquipmentType/WorkoutEquipmentTypeService.js';
 import WorkoutExerciseCalibrationService from '../ExerciseCalibration/WorkoutExerciseCalibrationService.js';
+import WorkoutSessionExerciseService from '../SessionExercise/WorkoutSessionExerciseService.js';
 import WorkoutSFRService from '../util/SFR/WorkoutSFRService.js';
 /**
  * A service for handling operations related to {@link WorkoutExercise}s.
@@ -41,6 +42,10 @@ export default class WorkoutExerciseService {
      * This method applies either rep-based or load-based progression depending on the exercise's
      * preferred progression type, then rounds the weight to available equipment options.
      *
+     * When a `previousFirstSet` is provided, autoregulation adjusts progression based on the
+     * surplus between planned and actual performance. Without it, the calibration-based formula
+     * is used as a baseline.
+     *
      * Rep progression: The weight is calculated based on reps at microcycle 0, and reps increase
      * by 2 per microcycle to reach max reps at the final accumulation microcycle (ideally),
      * or drop back down and increase weight by 2%.
@@ -49,7 +54,7 @@ export default class WorkoutExerciseService {
      * If weight can't be increased, adds 2 reps instead.
      */
     static calculateTargetRepsAndWeightForFirstSet(params) {
-        const { exercise, calibration, equipment, microcycleIndex, firstMicrocycleRir } = params;
+        const { exercise, calibration, equipment, microcycleIndex, firstMicrocycleRir, previousFirstSet } = params;
         // Validate equipment has weight options
         if (!equipment.weightOptions || equipment.weightOptions.length === 0) {
             throw new Error(`No weight options defined for equipment type ${equipment._id}, ${equipment.title}`);
@@ -57,6 +62,134 @@ export default class WorkoutExerciseService {
         // Get rep range for this exercise
         const repRange = this.getRepRangeValues(exercise.repRange);
         const repRangeMidpoint = Math.floor((repRange.min + repRange.max) / 2);
+        // If we have a previous set with complete data, use autoregulation
+        if (previousFirstSet && this.hasCompleteAutoRegulationData(previousFirstSet)) {
+            return this.calculateAutoRegulatedTargets({
+                exercise,
+                equipment,
+                previousFirstSet,
+                repRange
+            });
+        }
+        // Calibration-based formula (no previous set available)
+        return this.calculateCalibrationBasedTargets({
+            exercise,
+            calibration,
+            equipment,
+            microcycleIndex,
+            firstMicrocycleRir,
+            repRange,
+            repRangeMidpoint
+        });
+    }
+    /**
+     * Calculates targets using auto-regulation based on actual performance from a previous set.
+     */
+    static calculateAutoRegulatedTargets(params) {
+        const { exercise, equipment, previousFirstSet, repRange } = params;
+        const surplus = WorkoutSessionExerciseService.calculateSetSurplus(previousFirstSet.actualReps, previousFirstSet.plannedReps, previousFirstSet.rir, previousFirstSet.plannedRir);
+        if (exercise.preferredProgressionType === ExerciseProgressionType.Rep) {
+            return this.calculateAutoRegulatedRepTargets(previousFirstSet, surplus, repRange, equipment);
+        }
+        return this.calculateAutoRegulatedLoadTargets(previousFirstSet, surplus, repRange, equipment);
+    }
+    /**
+     * Auto-regulated rep progression. Weight stays the same, reps adjust based on surplus.
+     *
+     * | Surplus | Action |
+     * |---:|---|
+     * | >= 3 | Accelerate: actualReps + 2 (progress from actual, not planned) |
+     * | 0 to 2 | Normal: plannedReps + 2 |
+     * | -1 to -2 | Hold: plannedReps (don't add reps) |
+     * | <= -3 | Regress: actualReps (use actual as new baseline) |
+     */
+    static calculateAutoRegulatedRepTargets(previousSet, surplus, repRange, equipment) {
+        let targetReps;
+        let targetWeight = previousSet.plannedWeight;
+        if (surplus >= 3) {
+            targetReps = previousSet.actualReps + 2;
+        }
+        else if (surplus >= 0) {
+            targetReps = previousSet.plannedReps + 2;
+        }
+        else if (surplus >= -2) {
+            targetReps = previousSet.plannedReps;
+        }
+        else {
+            targetReps = previousSet.actualReps;
+        }
+        // Clamp to rep range floor (never target below min, even if actual was 0)
+        targetReps = Math.max(targetReps, repRange.min);
+        // Handle rep range ceiling: if target exceeds max, reset and bump weight
+        if (targetReps > repRange.max) {
+            targetReps = repRange.max;
+            const nextWeight = this.findNextTwoPercentWeight(targetWeight, equipment);
+            if (nextWeight !== null) {
+                targetWeight = nextWeight;
+            }
+        }
+        // Round weight to equipment
+        const roundedWeight = WorkoutEquipmentTypeService.findNearestWeight(equipment, targetWeight, 'prefer-down');
+        if (roundedWeight !== null) {
+            targetWeight = roundedWeight;
+        }
+        return { targetWeight, targetReps };
+    }
+    /**
+     * Auto-regulated load progression. Reps stay at rep range max, weight adjusts based on surplus.
+     *
+     * | Surplus | Action |
+     * |---:|---|
+     * | >= 2 | Accelerate: increase weight by ~4% |
+     * | 0 to 1 | Normal: increase weight by 2% |
+     * | -1 to -2 | Hold weight (no increase) |
+     * | <= -3 | Reduce weight by minimum equipment increment |
+     */
+    static calculateAutoRegulatedLoadTargets(previousSet, surplus, repRange, equipment) {
+        const targetReps = repRange.max;
+        let targetWeight = previousSet.plannedWeight;
+        if (surplus >= 2) {
+            // Accelerate: increase by ~4%
+            const fourPercentIncrease = targetWeight * 1.04;
+            const nextWeight = WorkoutEquipmentTypeService.findNearestWeight(equipment, fourPercentIncrease, 'up');
+            if (nextWeight !== null) {
+                targetWeight = nextWeight;
+            }
+        }
+        else if (surplus >= 0) {
+            // Normal: increase by 2%
+            const nextWeight = this.findNextTwoPercentWeight(targetWeight, equipment);
+            if (nextWeight !== null) {
+                targetWeight = nextWeight;
+            }
+        }
+        else if (surplus >= -2) {
+            // Hold weight - no change
+        }
+        else {
+            // Reduce by minimum equipment increment
+            const reducedWeight = WorkoutEquipmentTypeService.findNearestWeight(equipment, targetWeight - 0.01, 'down');
+            if (reducedWeight !== null) {
+                targetWeight = reducedWeight;
+            }
+        }
+        return { targetWeight, targetReps };
+    }
+    /**
+     * Checks whether a set has all the data needed for autoregulation calculations.
+     */
+    static hasCompleteAutoRegulationData(set) {
+        return (set.actualReps != null &&
+            set.plannedReps != null &&
+            set.rir != null &&
+            set.plannedRir != null &&
+            set.plannedWeight != null);
+    }
+    /**
+     * Calculates targets using the calibration-based formula (original behavior).
+     */
+    static calculateCalibrationBasedTargets(params) {
+        const { exercise, calibration, equipment, microcycleIndex, firstMicrocycleRir, repRange, repRangeMidpoint } = params;
         // For rep progression, calculate weight based on reps at microcycle 0
         // For load progression, use max reps
         let baseRepsForWeight;

package/lib/services/workout/Exercise/WorkoutExerciseService.js.map

@@ -1 +1 @@
-{"version":3,"file":"WorkoutExerciseService.js","sourceRoot":"","sources":["../../../../src/services/workout/Exercise/WorkoutExerciseService.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,+CAA+C,CAAC;AAEvD,OAAO,2BAA2B,MAAM,iDAAiD,CAAC;AAC1F,OAAO,iCAAiC,MAAM,6DAA6D,CAAC;AAC5G,OAAO,iBAAiB,MAAM,kCAAkC,CAAC;AAEjE;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,sBAAsB;IACzC;;;;;;;;OAQG;IACH,MAAM,CAAC,iBAAiB,CAAC,QAA0B;QACjD,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,gBAAgB,CAAC,KAAK;gBACzB,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;YAC7B,KAAK,gBAAgB,CAAC,MAAM;gBAC1B,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;YAC9B,KAAK,gBAAgB,CAAC,KAAK;gBACzB,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;QAChC,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,eAAe,CAAC,QAAyB;QAC9C,OAAO,iBAAiB,CAAC,eAAe,CAAC,QAAQ,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,uCAAuC,CAAC,MAM9C;QACC,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAAC;QAEzF,wCAAwC;QACxC,IAAI,CAAC,SAAS,CAAC,aAAa,IAAI,SAAS,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrE,MAAM,IAAI,KAAK,CACb,gDAAgD,SAAS,CAAC,GAAG,KAAK,SAAS,CAAC,KAAK,EAAE,CACpF,CAAC;QACJ,CAAC;QAED,kCAAkC;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC3D,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAEvE,sEAAsE;QACtE,qCAAqC;QACrC,IAAI,iBAAyB,CAAC;QAC9B,IAAI,QAAQ,CAAC,wBAAwB,KAAK,uBAAuB,CAAC,GAAG,EAAE,CAAC;YACtE,iBAAiB,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,gEAAgE;YAChE,iBAAiB,GAAG,QAAQ,CAAC,GAAG,CAAC;QACnC,CAAC;QAED,wBAAwB;QACxB,IAAI,YAAY,GAAG,iCAAiC,CAAC,eAAe,CAClE,WAAW,EACX,iBAAiB,CAClB,CAAC;QAEF,sDAAsD;QACtD,MAAM,aAAa,GAAG,2BAA2B,CAAC,iBAAiB,CACjE,SAAS,EACT,YAAY,EACZ,aAAa,CACd,CAAC;QACF,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CACb,wDAAwD,SAAS,CAAC,GAAG,KAAK,SAAS,CAAC,KAAK,EAAE,CAC5F,CAAC;QACJ,CAAC;QACD,YAAY,GAAG,aAAa,CAAC;QAE7B,kDAAkD;QAClD,IAAI,UAAkB,CAAC;QACvB,IAAI,QAAQ,CAAC,wBAAwB,KAAK,uBAAuB,CAAC,GAAG,EAAE,CAAC;YACtE,gEAAgE;YAChE,IAAI,sBAAsB,GAAG,CAAC,CAAC;YAC/B,UAAU,GAAG,gBAAgB,CAAC;YAE9B,OAAO,sBAAsB,GAAG,eAAe,EAAE,CAAC;gBAChD,UAAU,IAAI,CAAC,CAAC;gBAChB,IAAI,UAAU,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC;oBAC9B,iDAAiD;oBACjD,QAAQ,QAAQ,CAAC,QAAQ,EAAE,CAAC;wBAC1B,KAAK,gBAAgB,CAAC,KAAK;4BACzB,UAAU,GAAG,UAAU,GAAG,CAAC,CAAC;4BAC5B,MAAM;wBACR,KAAK,gBAAgB,CAAC,MAAM;4BAC1B,UAAU,GAAG,UAAU,GAAG,CAAC,CAAC;4BAC5B,MAAM;wBACR,KAAK,gBAAgB,CAAC,KAAK;4BACzB,UAAU,GAAG,UAAU,GAAG,CAAC,CAAC;4BAC5B,MAAM;oBACV,CAAC;oBACD,MAAM,UAAU,GAAG,IAAI,CAAC,wBAAwB,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;oBAC1E,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;wBACxB,YAAY,GAAG,UAAU,CAAC;oBAC5B,CAAC;gBACH,CAAC;gBACD,sBAAsB,EAAE,CAAC;YAC3B,CAAC;QACH,CAAC;aAAM,CAAC;YACN,sCAAsC;YACtC,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC;QAC5B,CAAC;QAED,sDAAsD;QACtD,IAAI,QAAQ,CAAC,wBAAwB,KAAK,uBAAuB,CAAC,IAAI,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;YAC9F,MAAM,UAAU,GAAG,IAAI,CAAC,wBAAwB,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;YAC1E,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;gBACxB,YAAY,GAAG,UAAU,CAAC;YAC5B,CAAC;iBAAM,CAAC;gBACN,4CAA4C;gBAC5C,UAAU,GAAG,UAAU,GAAG,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;IACtC,CAAC;IAEO,MAAM,CAAC,wBAAwB,CACrC,aAAqB,EACrB,SAA+B;QAE/B,iCAAiC;QACjC,MAAM,kBAAkB,GAAG,aAAa,GAAG,IAAI,CAAC;QAEhD,6FAA6F;QAC7F,0FAA0F;QAC1F,MAAM,UAAU,GAAG,2BAA2B,CAAC,iBAAiB,CAC9D,SAAS,EACT,kBAAkB,EAClB,IAAI,CACL,CAAC;QACF,OAAO,UAAU,CAAC;IACpB,CAAC;CACF"}
+{"version":3,"file":"WorkoutExerciseService.js","sourceRoot":"","sources":["../../../../src/services/workout/Exercise/WorkoutExerciseService.ts"],"names":[],"mappings":"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"}

package/lib/services/workout/Exercise/WorkoutExerciseService.ts

@@ -5,8 +5,10 @@ import {
   ExerciseRepRange
 } from '../../../documents/workout/WorkoutExercise.js';
 import type { WorkoutExerciseCalibration } from '../../../documents/workout/WorkoutExerciseCalibration.js';
+import type { CompletedWorkoutSet, WorkoutSet } from '../../../documents/workout/WorkoutSet.js';
 import WorkoutEquipmentTypeService from '../EquipmentType/WorkoutEquipmentTypeService.js';
 import WorkoutExerciseCalibrationService from '../ExerciseCalibration/WorkoutExerciseCalibrationService.js';
+import WorkoutSessionExerciseService from '../SessionExercise/WorkoutSessionExerciseService.js';
 import WorkoutSFRService from '../util/SFR/WorkoutSFRService.js';
 
 /**
@@ -50,6 +52,10 @@ export default class WorkoutExerciseService {
    * This method applies either rep-based or load-based progression depending on the exercise's
    * preferred progression type, then rounds the weight to available equipment options.
    *
+   * When a `previousFirstSet` is provided, autoregulation adjusts progression based on the
+   * surplus between planned and actual performance. Without it, the calibration-based formula
+   * is used as a baseline.
+   *
    * Rep progression: The weight is calculated based on reps at microcycle 0, and reps increase
    * by 2 per microcycle to reach max reps at the final accumulation microcycle (ideally),
    * or drop back down and increase weight by 2%.
@@ -63,8 +69,16 @@ export default class WorkoutExerciseService {
     equipment: WorkoutEquipmentType;
     microcycleIndex: number;
     firstMicrocycleRir: number;
+    previousFirstSet?: WorkoutSet;
   }): { targetWeight: number; targetReps: number } {
-    const { exercise, calibration, equipment, microcycleIndex, firstMicrocycleRir } = params;
+    const {
+      exercise,
+      calibration,
+      equipment,
+      microcycleIndex,
+      firstMicrocycleRir,
+      previousFirstSet
+    } = params;
 
     // Validate equipment has weight options
     if (!equipment.weightOptions || equipment.weightOptions.length === 0) {
@@ -77,6 +91,195 @@ export default class WorkoutExerciseService {
     const repRange = this.getRepRangeValues(exercise.repRange);
     const repRangeMidpoint = Math.floor((repRange.min + repRange.max) / 2);
 
+    // If we have a previous set with complete data, use autoregulation
+    if (previousFirstSet && this.hasCompleteAutoRegulationData(previousFirstSet)) {
+      return this.calculateAutoRegulatedTargets({
+        exercise,
+        equipment,
+        previousFirstSet,
+        repRange
+      });
+    }
+
+    // Calibration-based formula (no previous set available)
+    return this.calculateCalibrationBasedTargets({
+      exercise,
+      calibration,
+      equipment,
+      microcycleIndex,
+      firstMicrocycleRir,
+      repRange,
+      repRangeMidpoint
+    });
+  }
+
+  /**
+   * Calculates targets using auto-regulation based on actual performance from a previous set.
+   */
+  private static calculateAutoRegulatedTargets(params: {
+    exercise: WorkoutExercise;
+    equipment: WorkoutEquipmentType;
+    previousFirstSet: CompletedWorkoutSet;
+    repRange: { min: number; max: number };
+  }): { targetWeight: number; targetReps: number } {
+    const { exercise, equipment, previousFirstSet, repRange } = params;
+
+    const surplus = WorkoutSessionExerciseService.calculateSetSurplus(
+      previousFirstSet.actualReps,
+      previousFirstSet.plannedReps,
+      previousFirstSet.rir,
+      previousFirstSet.plannedRir
+    );
+
+    if (exercise.preferredProgressionType === ExerciseProgressionType.Rep) {
+      return this.calculateAutoRegulatedRepTargets(previousFirstSet, surplus, repRange, equipment);
+    }
+
+    return this.calculateAutoRegulatedLoadTargets(previousFirstSet, surplus, repRange, equipment);
+  }
+
+  /**
+   * Auto-regulated rep progression. Weight stays the same, reps adjust based on surplus.
+   *
+   * | Surplus | Action |
+   * |---:|---|
+   * | >= 3 | Accelerate: actualReps + 2 (progress from actual, not planned) |
+   * | 0 to 2 | Normal: plannedReps + 2 |
+   * | -1 to -2 | Hold: plannedReps (don't add reps) |
+   * | <= -3 | Regress: actualReps (use actual as new baseline) |
+   */
+  private static calculateAutoRegulatedRepTargets(
+    previousSet: CompletedWorkoutSet,
+    surplus: number,
+    repRange: { min: number; max: number },
+    equipment: WorkoutEquipmentType
+  ): { targetWeight: number; targetReps: number } {
+    let targetReps: number;
+    let targetWeight = previousSet.plannedWeight;
+
+    if (surplus >= 3) {
+      targetReps = previousSet.actualReps + 2;
+    } else if (surplus >= 0) {
+      targetReps = previousSet.plannedReps + 2;
+    } else if (surplus >= -2) {
+      targetReps = previousSet.plannedReps;
+    } else {
+      targetReps = previousSet.actualReps;
+    }
+
+    // Clamp to rep range floor (never target below min, even if actual was 0)
+    targetReps = Math.max(targetReps, repRange.min);
+
+    // Handle rep range ceiling: if target exceeds max, reset and bump weight
+    if (targetReps > repRange.max) {
+      targetReps = repRange.max;
+      const nextWeight = this.findNextTwoPercentWeight(targetWeight, equipment);
+      if (nextWeight !== null) {
+        targetWeight = nextWeight;
+      }
+    }
+
+    // Round weight to equipment
+    const roundedWeight = WorkoutEquipmentTypeService.findNearestWeight(
+      equipment,
+      targetWeight,
+      'prefer-down'
+    );
+    if (roundedWeight !== null) {
+      targetWeight = roundedWeight;
+    }
+
+    return { targetWeight, targetReps };
+  }
+
+  /**
+   * Auto-regulated load progression. Reps stay at rep range max, weight adjusts based on surplus.
+   *
+   * | Surplus | Action |
+   * |---:|---|
+   * | >= 2 | Accelerate: increase weight by ~4% |
+   * | 0 to 1 | Normal: increase weight by 2% |
+   * | -1 to -2 | Hold weight (no increase) |
+   * | <= -3 | Reduce weight by minimum equipment increment |
+   */
+  private static calculateAutoRegulatedLoadTargets(
+    previousSet: CompletedWorkoutSet,
+    surplus: number,
+    repRange: { min: number; max: number },
+    equipment: WorkoutEquipmentType
+  ): { targetWeight: number; targetReps: number } {
+    const targetReps = repRange.max;
+    let targetWeight = previousSet.plannedWeight;
+
+    if (surplus >= 2) {
+      // Accelerate: increase by ~4%
+      const fourPercentIncrease = targetWeight * 1.04;
+      const nextWeight = WorkoutEquipmentTypeService.findNearestWeight(
+        equipment,
+        fourPercentIncrease,
+        'up'
+      );
+      if (nextWeight !== null) {
+        targetWeight = nextWeight;
+      }
+    } else if (surplus >= 0) {
+      // Normal: increase by 2%
+      const nextWeight = this.findNextTwoPercentWeight(targetWeight, equipment);
+      if (nextWeight !== null) {
+        targetWeight = nextWeight;
+      }
+    } else if (surplus >= -2) {
+      // Hold weight - no change
+    } else {
+      // Reduce by minimum equipment increment
+      const reducedWeight = WorkoutEquipmentTypeService.findNearestWeight(
+        equipment,
+        targetWeight - 0.01,
+        'down'
+      );
+      if (reducedWeight !== null) {
+        targetWeight = reducedWeight;
+      }
+    }
+
+    return { targetWeight, targetReps };
+  }
+
+  /**
+   * Checks whether a set has all the data needed for autoregulation calculations.
+   */
+  private static hasCompleteAutoRegulationData(set: WorkoutSet): set is CompletedWorkoutSet {
+    return (
+      set.actualReps != null &&
+      set.plannedReps != null &&
+      set.rir != null &&
+      set.plannedRir != null &&
+      set.plannedWeight != null
+    );
+  }
+
+  /**
+   * Calculates targets using the calibration-based formula (original behavior).
+   */
+  private static calculateCalibrationBasedTargets(params: {
+    exercise: WorkoutExercise;
+    calibration: WorkoutExerciseCalibration;
+    equipment: WorkoutEquipmentType;
+    microcycleIndex: number;
+    firstMicrocycleRir: number;
+    repRange: { min: number; max: number };
+    repRangeMidpoint: number;
+  }): { targetWeight: number; targetReps: number } {
+    const {
+      exercise,
+      calibration,
+      equipment,
+      microcycleIndex,
+      firstMicrocycleRir,
+      repRange,
+      repRangeMidpoint
+    } = params;
+
     // For rep progression, calculate weight based on reps at microcycle 0
     // For load progression, use max reps
     let baseRepsForWeight: number;

package/lib/services/workout/ExerciseCalibration/WorkoutExerciseCalibrationService.d.ts

@@ -1,3 +1,5 @@
+import type { UUID } from 'crypto';
+import type { WorkoutExerciseCTO } from '../../../ctos/workout/WorkoutExerciseCTO.js';
 import type { WorkoutExerciseCalibration } from '../../../documents/workout/WorkoutExerciseCalibration.js';
 /**
  * A service for handling operations related to {@link WorkoutExerciseCalibration}s.
@@ -18,6 +20,21 @@ export default class WorkoutExerciseCalibrationService {
      * @param reps The number of reps performed.
      */
     static get1RMRaw(weight: number, reps: number): number;
+    /**
+     * Returns the NASM 1RM formula as a MongoDB aggregation expression.
+     * This is the MongoDB-equivalent of {@link get1RMRaw} and must be kept
+     * in sync with it.
+     *
+     * @param weightField The MongoDB field reference for weight (e.g. `'$weight'`).
+     * @param repsField The MongoDB field reference for reps (e.g. `'$reps'`).
+     */
+    static get1RMMongoExpr(weightField: string, repsField: string): {
+        $add: (string | {
+            $divide: (number | {
+                $multiply: string[];
+            })[];
+        })[];
+    };
     /**
      * Calculates the target weight for a set based on target reps and 1RM.
      *
@@ -28,12 +45,41 @@ export default class WorkoutExerciseCalibrationService {
      * @param targetReps The target number of reps.
      */
     static getTargetWeight(calibration: WorkoutExerciseCalibration, targetReps: number): number;
+    /**
+     * Calculates the target weight from a raw 1RM value and a target rep count.
+     *
+     * This applies the same targetPercentage formula as {@link getTargetWeight}
+     * but accepts a pre-computed 1RM instead of a calibration document. Useful
+     * when the effective 1RM is derived from multiple sources (calibrations and
+     * actual sets).
+     *
+     * Returns the calculated weight without rounding. Consumer can use
+     * WorkoutEquipmentTypeService.findNearestWeight() to round if needed.
+     *
+     * @param effective1RM The effective 1 Rep Max value.
+     * @param targetReps The target number of reps.
+     */
+    static getTargetWeightFrom1RM(effective1RM: number, targetReps: number): number;
+    /**
+     * Generates auto-calibrations from exercise CTOs whose best set 1RM exceeds
+     * their best calibration 1RM.
+     *
+     * The CTO already provides `bestCalibration` and `bestSet` per exercise, so
+     * this method just compares those two pre-computed values and creates new
+     * calibrations where the set wins.
+     *
+     * @param exerciseCTOs The exercise CTOs to evaluate.
+     * @param userId The user ID for the new calibrations.
+     * @param dateRecorded The date to use as dateRecorded for new calibrations.
+     */
+    static generateAutoCalibrations(exerciseCTOs: WorkoutExerciseCTO[], userId: UUID, dateRecorded: Date): WorkoutExerciseCalibration[];
     /**
      * Calculates the target percentage of 1RM for a given target rep count.
      *
-     * Uses the formula: targetPercentage = 30 + ((targetReps - 5) * 2.2)
+     * Uses the formula: targetPercentage = 85 - ((targetReps - 5) * 2.2)
      *
-     * This ensures training stays within the 30%-85% 1RM range (30 reps to 5 reps).
+     * This ensures training stays within the 85%-30% 1RM range (5 reps to 30 reps).
+     * Higher rep counts produce lower percentages of 1RM.
      *
      * @param targetReps The target number of reps.
      */

package/lib/services/workout/ExerciseCalibration/WorkoutExerciseCalibrationService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WorkoutExerciseCalibrationService.d.ts","sourceRoot":"","sources":["../../../../src/services/workout/ExerciseCalibration/WorkoutExerciseCalibrationService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,0DAA0D,CAAC;AAE3G;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,iCAAiC;IACpD;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,0BAA0B,GAAG,MAAM;IAI9D;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAItD;;;;;;;;OAQG;IACH,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,0BAA0B,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAM3F;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;CAGnC"}
+{"version":3,"file":"WorkoutExerciseCalibrationService.d.ts","sourceRoot":"","sources":["../../../../src/services/workout/ExerciseCalibration/WorkoutExerciseCalibrationService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AACtF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,0DAA0D,CAAC;AAM3G;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,iCAAiC;IACpD;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,0BAA0B,GAAG,MAAM;IAI9D;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAItD;;;;;;;OAOG;IACH,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;;;;;;;IAM7D;;;;;;;;OAQG;IACH,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,0BAA0B,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAK3F;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,sBAAsB,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAK/E;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,wBAAwB,CAC7B,YAAY,EAAE,kBAAkB,EAAE,EAClC,MAAM,EAAE,IAAI,EACZ,YAAY,EAAE,IAAI,GACjB,0BAA0B,EAAE;IA4B/B;;;;;;;;;OASG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;CAGnC"}

package/lib/services/workout/ExerciseCalibration/WorkoutExerciseCalibrationService.js

@@ -1,3 +1,6 @@
+import { WorkoutExerciseCalibrationSchema } from '../../../documents/workout/WorkoutExerciseCalibration.js';
+/** Divisor used in the NASM 1RM formula: 1RM = (weight × reps / 30.48) + weight */
+const NASM_1RM_DIVISOR = 30.48;
 /**
  * A service for handling operations related to {@link WorkoutExerciseCalibration}s.
  */
@@ -19,7 +22,20 @@ export default class WorkoutExerciseCalibrationService {
      * @param reps The number of reps performed.
      */
     static get1RMRaw(weight, reps) {
-        return (weight * reps) / 30.48 + weight;
+        return (weight * reps) / NASM_1RM_DIVISOR + weight;
+    }
+    /**
+     * Returns the NASM 1RM formula as a MongoDB aggregation expression.
+     * This is the MongoDB-equivalent of {@link get1RMRaw} and must be kept
+     * in sync with it.
+     *
+     * @param weightField The MongoDB field reference for weight (e.g. `'$weight'`).
+     * @param repsField The MongoDB field reference for reps (e.g. `'$reps'`).
+     */
+    static get1RMMongoExpr(weightField, repsField) {
+        return {
+            $add: [{ $divide: [{ $multiply: [weightField, repsField] }, NASM_1RM_DIVISOR] }, weightField]
+        };
     }
     /**
      * Calculates the target weight for a set based on target reps and 1RM.
@@ -32,20 +48,72 @@ export default class WorkoutExerciseCalibrationService {
      */
     static getTargetWeight(calibration, targetReps) {
         const oneRepMax = this.get1RM(calibration);
+        return this.getTargetWeightFrom1RM(oneRepMax, targetReps);
+    }
+    /**
+     * Calculates the target weight from a raw 1RM value and a target rep count.
+     *
+     * This applies the same targetPercentage formula as {@link getTargetWeight}
+     * but accepts a pre-computed 1RM instead of a calibration document. Useful
+     * when the effective 1RM is derived from multiple sources (calibrations and
+     * actual sets).
+     *
+     * Returns the calculated weight without rounding. Consumer can use
+     * WorkoutEquipmentTypeService.findNearestWeight() to round if needed.
+     *
+     * @param effective1RM The effective 1 Rep Max value.
+     * @param targetReps The target number of reps.
+     */
+    static getTargetWeightFrom1RM(effective1RM, targetReps) {
         const targetPercentage = this.getTargetPercentage(targetReps);
-        return (targetPercentage / 100) * oneRepMax;
+        return (targetPercentage / 100) * effective1RM;
+    }
+    /**
+     * Generates auto-calibrations from exercise CTOs whose best set 1RM exceeds
+     * their best calibration 1RM.
+     *
+     * The CTO already provides `bestCalibration` and `bestSet` per exercise, so
+     * this method just compares those two pre-computed values and creates new
+     * calibrations where the set wins.
+     *
+     * @param exerciseCTOs The exercise CTOs to evaluate.
+     * @param userId The user ID for the new calibrations.
+     * @param dateRecorded The date to use as dateRecorded for new calibrations.
+     */
+    static generateAutoCalibrations(exerciseCTOs, userId, dateRecorded) {
+        const newCalibrations = [];
+        for (const cto of exerciseCTOs) {
+            const { bestSet, bestCalibration } = cto;
+            if (!bestSet?.actualWeight || !bestSet.actualReps || bestSet.actualReps <= 0)
+                continue;
+            const set1RM = this.get1RMRaw(bestSet.actualWeight, bestSet.actualReps);
+            const cal1RM = bestCalibration ? this.get1RM(bestCalibration) : 0;
+            if (set1RM > cal1RM) {
+                newCalibrations.push(WorkoutExerciseCalibrationSchema.parse({
+                    userId,
+                    workoutExerciseId: cto._id,
+                    weight: bestSet.actualWeight,
+                    reps: bestSet.actualReps,
+                    exerciseProperties: bestSet.exerciseProperties,
+                    dateRecorded,
+                    associatedWorkoutSetId: bestSet._id
+                }));
+            }
+        }
+        return newCalibrations;
     }
     /**
      * Calculates the target percentage of 1RM for a given target rep count.
      *
-     * Uses the formula: targetPercentage = 30 + ((targetReps - 5) * 2.2)
+     * Uses the formula: targetPercentage = 85 - ((targetReps - 5) * 2.2)
      *
-     * This ensures training stays within the 30%-85% 1RM range (30 reps to 5 reps).
+     * This ensures training stays within the 85%-30% 1RM range (5 reps to 30 reps).
+     * Higher rep counts produce lower percentages of 1RM.
      *
      * @param targetReps The target number of reps.
      */
     static getTargetPercentage(targetReps) {
-        return 30 + (targetReps - 5) * 2.2;
+        return 85 - (targetReps - 5) * 2.2;
     }
 }
 //# sourceMappingURL=WorkoutExerciseCalibrationService.js.map

package/lib/services/workout/ExerciseCalibration/WorkoutExerciseCalibrationService.js.map

@@ -1 +1 @@
-{"version":3,"file":"WorkoutExerciseCalibrationService.js","sourceRoot":"","sources":["../../../../src/services/workout/ExerciseCalibration/WorkoutExerciseCalibrationService.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,iCAAiC;IACpD;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,WAAuC;QACnD,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,MAAc,EAAE,IAAY;QAC3C,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,KAAK,GAAG,MAAM,CAAC;IAC1C,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,eAAe,CAAC,WAAuC,EAAE,UAAkB;QAChF,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,gBAAgB,GAAG,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC;QAC9D,OAAO,CAAC,gBAAgB,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC;IAC9C,CAAC;IAED;;;;;;;;OAQG;IACK,MAAM,CAAC,mBAAmB,CAAC,UAAkB;QACnD,OAAO,EAAE,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;IACrC,CAAC;CACF"}
+{"version":3,"file":"WorkoutExerciseCalibrationService.js","sourceRoot":"","sources":["../../../../src/services/workout/ExerciseCalibration/WorkoutExerciseCalibrationService.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gCAAgC,EAAE,MAAM,0DAA0D,CAAC;AAE5G,mFAAmF;AACnF,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAE/B;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,iCAAiC;IACpD;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,WAAuC;QACnD,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,MAAc,EAAE,IAAY;QAC3C,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,gBAAgB,GAAG,MAAM,CAAC;IACrD,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,eAAe,CAAC,WAAmB,EAAE,SAAiB;QAC3D,OAAO;YACL,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,EAAE,gBAAgB,CAAC,EAAE,EAAE,WAAW,CAAC;SAC9F,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,eAAe,CAAC,WAAuC,EAAE,UAAkB;QAChF,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC,sBAAsB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,sBAAsB,CAAC,YAAoB,EAAE,UAAkB;QACpE,MAAM,gBAAgB,GAAG,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC;QAC9D,OAAO,CAAC,gBAAgB,GAAG,GAAG,CAAC,GAAG,YAAY,CAAC;IACjD,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,wBAAwB,CAC7B,YAAkC,EAClC,MAAY,EACZ,YAAkB;QAElB,MAAM,eAAe,GAAiC,EAAE,CAAC;QAEzD,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;YAC/B,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,GAAG,CAAC;YACzC,IAAI,CAAC,OAAO,EAAE,YAAY,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,IAAI,CAAC;gBAAE,SAAS;YAEvF,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;YACxE,MAAM,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAElE,IAAI,MAAM,GAAG,MAAM,EAAE,CAAC;gBACpB,eAAe,CAAC,IAAI,CAClB,gCAAgC,CAAC,KAAK,CAAC;oBACrC,MAAM;oBACN,iBAAiB,EAAE,GAAG,CAAC,GAAG;oBAC1B,MAAM,EAAE,OAAO,CAAC,YAAY;oBAC5B,IAAI,EAAE,OAAO,CAAC,UAAU;oBACxB,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;oBAC9C,YAAY;oBACZ,sBAAsB,EAAE,OAAO,CAAC,GAAG;iBACpC,CAAC,CACH,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,eAAe,CAAC;IACzB,CAAC;IAED;;;;;;;;;OASG;IACK,MAAM,CAAC,mBAAmB,CAAC,UAAkB;QACnD,OAAO,EAAE,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;IACrC,CAAC;CACF"}