@aneuhold/core-ts-db-lib 4.0.4 → 4.1.1

package/lib/services/workout/Session/WorkoutSessionService.ts

@@ -0,0 +1,136 @@
+import type { UUID } from 'crypto';
+import type { CalibrationExercisePair } from '../../../documents/workout/WorkoutExerciseCalibration.js';
+import type { WorkoutSession } from '../../../documents/workout/WorkoutSession.js';
+import { WorkoutSessionSchema } from '../../../documents/workout/WorkoutSession.js';
+import { WorkoutSessionExerciseSchema } from '../../../documents/workout/WorkoutSessionExercise.js';
+import type WorkoutMesocyclePlanContext from '../Mesocycle/WorkoutMesocyclePlanContext.js';
+import WorkoutSetService from '../Set/WorkoutSetService.js';
+import WorkoutSFRService from '../util/SFR/WorkoutSFRService.js';
+
+/**
+ * A service for handling operations related to {@link WorkoutSession}s.
+ *
+ * SCOPE: Session-level operations (calculating totals, managing session generation)
+ *
+ * RESPONSIBILITIES:
+ * - Calculate session-level RSM/Fatigue totals
+ * - Generate workout sessions with exercises and sets
+ *
+ * RELATED SERVICES:
+ * - {@link WorkoutVolumePlanningService} - Provides set count plans for session generation
+ * - {@link WorkoutSetService} - Generates individual sets within sessions
+ * - {@link WorkoutSFRService} - Underlying calculations for RSM/Fatigue
+ */
+export default class WorkoutSessionService {
+  /**
+   * Calculates the total Raw Stimulus Magnitude for a session.
+   */
+  static getRsmTotal(session: WorkoutSession): number | null {
+    return WorkoutSFRService.getRsmTotal(session.rsm);
+  }
+
+  /**
+   * Calculates the total fatigue score for a session.
+   */
+  static getFatigueTotal(session: WorkoutSession): number | null {
+    return WorkoutSFRService.getFatigueTotal(session.fatigue);
+  }
+
+  /**
+   * Calculates the Stimulus to Fatigue Ratio (SFR) for a session.
+   */
+  static getSFR(session: WorkoutSession): number | null {
+    return WorkoutSFRService.getSFR(session.rsm, session.fatigue);
+  }
+
+  /**
+   * Generates a session and its associated exercises and sets.
+   */
+  static generateSession({
+    context,
+    microcycleIndex,
+    sessionIndex,
+    sessionStartDate,
+    sessionExerciseList,
+    targetRir,
+    isDeloadMicrocycle,
+    setPlan
+  }: {
+    context: WorkoutMesocyclePlanContext;
+    microcycleIndex: number;
+    sessionIndex: number;
+    sessionStartDate: Date;
+    sessionExerciseList: CalibrationExercisePair[];
+    targetRir: number;
+    isDeloadMicrocycle: boolean;
+    setPlan: { exerciseIdToSetCount: Map<UUID, number>; recoveryExerciseIds: Set<UUID> };
+  }): void {
+    const mesocycle = context.mesocycle;
+    const microcycle = context.microcyclesInOrder[microcycleIndex];
+
+    const resolvedSetPlan = setPlan;
+
+    // Create session
+    const session = WorkoutSessionSchema.parse({
+      userId: mesocycle.userId,
+      workoutMicrocycleId: microcycle._id,
+      title: `Microcycle ${microcycleIndex + 1} - Session ${sessionIndex + 1}`,
+      startTime: sessionStartDate
+    });
+
+    // Create session exercise groupings and associated sets
+    for (let exerciseIndex = 0; exerciseIndex < sessionExerciseList.length; exerciseIndex++) {
+      const { calibration, exercise } = sessionExerciseList[exerciseIndex];
+
+      const setCountFromPlan = resolvedSetPlan.exerciseIdToSetCount.get(exercise._id);
+      if (setCountFromPlan == null) {
+        throw new Error(
+          `No set plan found for exercise ${exercise._id}, ${exercise.exerciseName} in microcycle ${microcycleIndex}`
+        );
+      }
+
+      // Get equipment for weight calculations
+      const equipment = context.equipmentMap.get(exercise.workoutEquipmentTypeId);
+      if (!equipment) {
+        throw new Error(
+          `Equipment type not found for exercise ${exercise._id}, ${exercise.exerciseName}`
+        );
+      }
+      if (!equipment.weightOptions || equipment.weightOptions.length === 0) {
+        throw new Error(
+          `No weight options defined for equipment type ${equipment._id}, ${equipment.title}`
+        );
+      }
+
+      const sessionExercise = WorkoutSessionExerciseSchema.parse({
+        userId: mesocycle.userId,
+        workoutSessionId: session._id,
+        workoutExerciseId: exercise._id,
+        isRecoveryExercise: resolvedSetPlan.recoveryExerciseIds.has(exercise._id)
+      });
+
+      WorkoutSetService.generateSetsForSessionExercise({
+        context,
+        exercise,
+        calibration,
+        session,
+        sessionExercise,
+        microcycleIndex,
+        sessionIndex,
+        setCount: setCountFromPlan,
+        targetRir,
+        isDeloadMicrocycle
+      });
+
+      const setsForThisExercise = context.setsToCreate.slice(-setCountFromPlan);
+
+      sessionExercise.setOrder.push(...setsForThisExercise.map((s) => s._id));
+      session.sessionExerciseOrder.push(sessionExercise._id);
+      context.addSessionExercise(sessionExercise);
+    }
+
+    // Add session to microcycle's session order and context
+    microcycle.sessionOrder.push(session._id);
+    context.addSession(session);
+  }
+}

package/lib/services/workout/SessionExercise/WorkoutSessionExerciseService.d.ts

@@ -0,0 +1,45 @@
+import type { WorkoutSessionExercise } from '../../../documents/workout/WorkoutSessionExercise.js';
+/**
+ * A service for handling operations related to {@link WorkoutSessionExercise}s.
+ */
+export default class WorkoutSessionExerciseService {
+    /**
+     * Calculates the total Raw Stimulus Magnitude for a specific exercise within a session.
+     *
+     * @param sessionExercise The workout session exercise.
+     */
+    static getRsmTotal(sessionExercise: WorkoutSessionExercise): number | null;
+    /**
+     * Calculates the total fatigue score for a specific exercise within a session.
+     *
+     * @param sessionExercise The workout session exercise.
+     */
+    static getFatigueTotal(sessionExercise: WorkoutSessionExercise): number | null;
+    /**
+     * Calculates the Stimulus to Fatigue Ratio (SFR) for a specific exercise.
+     *
+     * @param sessionExercise The workout session exercise.
+     */
+    static getSFR(sessionExercise: WorkoutSessionExercise): number | null;
+    /**
+     * Uses the soreness/performance table from the workout model notes to recommend whether to add
+     * sets next microcycle or employ recovery sessions.
+     *
+     * Interpretation:
+     * - Returns `-1` when recovery sessions should be employed.
+     * - Returns `0` when no sets should be added.
+     * - Returns a non-negative integer when sets should be added.
+     * - Returns `null` when insufficient data is available.
+     *
+     * The table is:
+     *
+     * | Soreness Score ↓ \ Performance Score → | 0 | 1 | 2 | 3 |
+       |---|---|---|---|---|
+       | **0** | Add 1–3 sets | Add 0–2 sets | Do not add sets | Employ recovery sessions (see Fatigue Management) |
+       | **1** | Add 1–2 sets | Add 0–1 sets | Do not add sets | Employ recovery sessions (see Fatigue Management) |
+       | **2** | Do not add sets | Do not add sets | Do not add sets | Employ recovery sessions (see Fatigue Management) |
+       | **3** | Do not add sets | Do not add sets | Do not add sets | Employ recovery sessions (see Fatigue Management) |
+     */
+    static getRecommendedSetAdditionsOrRecovery(workoutSessionExercise: WorkoutSessionExercise): number | null;
+}
+//# sourceMappingURL=WorkoutSessionExerciseService.d.ts.map

package/lib/services/workout/SessionExercise/WorkoutSessionExerciseService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkoutSessionExerciseService.d.ts","sourceRoot":"","sources":["../../../../src/services/workout/SessionExercise/WorkoutSessionExerciseService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sDAAsD,CAAC;AAGnG;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,6BAA6B;IAChD;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAAC,eAAe,EAAE,sBAAsB,GAAG,MAAM,GAAG,IAAI;IAI1E;;;;OAIG;IACH,MAAM,CAAC,eAAe,CAAC,eAAe,EAAE,sBAAsB,GAAG,MAAM,GAAG,IAAI;IAI9E;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,sBAAsB,GAAG,MAAM,GAAG,IAAI;IAIrE;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,oCAAoC,CACzC,sBAAsB,EAAE,sBAAsB,GAC7C,MAAM,GAAG,IAAI;CAqBjB"}

package/lib/services/workout/SessionExercise/WorkoutSessionExerciseService.js

@@ -0,0 +1,69 @@
+import WorkoutSFRService from '../util/SFR/WorkoutSFRService.js';
+/**
+ * A service for handling operations related to {@link WorkoutSessionExercise}s.
+ */
+export default class WorkoutSessionExerciseService {
+    /**
+     * Calculates the total Raw Stimulus Magnitude for a specific exercise within a session.
+     *
+     * @param sessionExercise The workout session exercise.
+     */
+    static getRsmTotal(sessionExercise) {
+        return WorkoutSFRService.getRsmTotal(sessionExercise.rsm);
+    }
+    /**
+     * Calculates the total fatigue score for a specific exercise within a session.
+     *
+     * @param sessionExercise The workout session exercise.
+     */
+    static getFatigueTotal(sessionExercise) {
+        return WorkoutSFRService.getFatigueTotal(sessionExercise.fatigue);
+    }
+    /**
+     * Calculates the Stimulus to Fatigue Ratio (SFR) for a specific exercise.
+     *
+     * @param sessionExercise The workout session exercise.
+     */
+    static getSFR(sessionExercise) {
+        return WorkoutSFRService.getSFR(sessionExercise.rsm, sessionExercise.fatigue);
+    }
+    /**
+     * Uses the soreness/performance table from the workout model notes to recommend whether to add
+     * sets next microcycle or employ recovery sessions.
+     *
+     * Interpretation:
+     * - Returns `-1` when recovery sessions should be employed.
+     * - Returns `0` when no sets should be added.
+     * - Returns a non-negative integer when sets should be added.
+     * - Returns `null` when insufficient data is available.
+     *
+     * The table is:
+     *
+     * | Soreness Score ↓ \ Performance Score → | 0 | 1 | 2 | 3 |
+       |---|---|---|---|---|
+       | **0** | Add 1–3 sets | Add 0–2 sets | Do not add sets | Employ recovery sessions (see Fatigue Management) |
+       | **1** | Add 1–2 sets | Add 0–1 sets | Do not add sets | Employ recovery sessions (see Fatigue Management) |
+       | **2** | Do not add sets | Do not add sets | Do not add sets | Employ recovery sessions (see Fatigue Management) |
+       | **3** | Do not add sets | Do not add sets | Do not add sets | Employ recovery sessions (see Fatigue Management) |
+     */
+    static getRecommendedSetAdditionsOrRecovery(workoutSessionExercise) {
+        const { performanceScore, sorenessScore } = workoutSessionExercise;
+        if (sorenessScore == null || performanceScore == null) {
+            return null;
+        }
+        // Table mapping (sorenessScore rows, performanceScore columns).
+        // Values are representative set additions (midpoint of table ranges), or -1 for recovery.
+        const table = [
+            // Soreness 0: [Add 1-3, Add 0-2, Do not add, Recovery]
+            [2, 1, 0, -1],
+            // Soreness 1: [Add 1-2, Add 0-1, Do not add, Recovery]
+            [1, 0, 0, -1],
+            // Soreness 2: [Do not add, Do not add, Do not add, Recovery]
+            [0, 0, 0, -1],
+            // Soreness 3: [Do not add, Do not add, Do not add, Recovery]
+            [0, 0, 0, -1]
+        ];
+        return table[sorenessScore]?.[performanceScore] ?? null;
+    }
+}
+//# sourceMappingURL=WorkoutSessionExerciseService.js.map

package/lib/services/workout/SessionExercise/WorkoutSessionExerciseService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkoutSessionExerciseService.js","sourceRoot":"","sources":["../../../../src/services/workout/SessionExercise/WorkoutSessionExerciseService.ts"],"names":[],"mappings":"AACA,OAAO,iBAAiB,MAAM,kCAAkC,CAAC;AAEjE;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,6BAA6B;IAChD;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAAC,eAAuC;QACxD,OAAO,iBAAiB,CAAC,WAAW,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IAC5D,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,eAAe,CAAC,eAAuC;QAC5D,OAAO,iBAAiB,CAAC,eAAe,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IACpE,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,eAAuC;QACnD,OAAO,iBAAiB,CAAC,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IAChF,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,oCAAoC,CACzC,sBAA8C;QAE9C,MAAM,EAAE,gBAAgB,EAAE,aAAa,EAAE,GAAG,sBAAsB,CAAC;QACnE,IAAI,aAAa,IAAI,IAAI,IAAI,gBAAgB,IAAI,IAAI,EAAE,CAAC;YACtD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,gEAAgE;QAChE,0FAA0F;QAC1F,MAAM,KAAK,GAAe;YACxB,uDAAuD;YACvD,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YACb,uDAAuD;YACvD,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YACb,6DAA6D;YAC7D,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YACb,6DAA6D;YAC7D,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;SACd,CAAC;QAEF,OAAO,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC,gBAAgB,CAAC,IAAI,IAAI,CAAC;IAC1D,CAAC;CACF"}

package/lib/services/workout/SessionExercise/WorkoutSessionExerciseService.ts

@@ -0,0 +1,77 @@
+import type { WorkoutSessionExercise } from '../../../documents/workout/WorkoutSessionExercise.js';
+import WorkoutSFRService from '../util/SFR/WorkoutSFRService.js';
+
+/**
+ * A service for handling operations related to {@link WorkoutSessionExercise}s.
+ */
+export default class WorkoutSessionExerciseService {
+  /**
+   * Calculates the total Raw Stimulus Magnitude for a specific exercise within a session.
+   *
+   * @param sessionExercise The workout session exercise.
+   */
+  static getRsmTotal(sessionExercise: WorkoutSessionExercise): number | null {
+    return WorkoutSFRService.getRsmTotal(sessionExercise.rsm);
+  }
+
+  /**
+   * Calculates the total fatigue score for a specific exercise within a session.
+   *
+   * @param sessionExercise The workout session exercise.
+   */
+  static getFatigueTotal(sessionExercise: WorkoutSessionExercise): number | null {
+    return WorkoutSFRService.getFatigueTotal(sessionExercise.fatigue);
+  }
+
+  /**
+   * Calculates the Stimulus to Fatigue Ratio (SFR) for a specific exercise.
+   *
+   * @param sessionExercise The workout session exercise.
+   */
+  static getSFR(sessionExercise: WorkoutSessionExercise): number | null {
+    return WorkoutSFRService.getSFR(sessionExercise.rsm, sessionExercise.fatigue);
+  }
+
+  /**
+   * Uses the soreness/performance table from the workout model notes to recommend whether to add
+   * sets next microcycle or employ recovery sessions.
+   *
+   * Interpretation:
+   * - Returns `-1` when recovery sessions should be employed.
+   * - Returns `0` when no sets should be added.
+   * - Returns a non-negative integer when sets should be added.
+   * - Returns `null` when insufficient data is available.
+   * 
+   * The table is:
+   * 
+   * | Soreness Score ↓ \ Performance Score → | 0 | 1 | 2 | 3 |
+     |---|---|---|---|---|
+     | **0** | Add 1–3 sets | Add 0–2 sets | Do not add sets | Employ recovery sessions (see Fatigue Management) |
+     | **1** | Add 1–2 sets | Add 0–1 sets | Do not add sets | Employ recovery sessions (see Fatigue Management) |
+     | **2** | Do not add sets | Do not add sets | Do not add sets | Employ recovery sessions (see Fatigue Management) |
+     | **3** | Do not add sets | Do not add sets | Do not add sets | Employ recovery sessions (see Fatigue Management) |
+   */
+  static getRecommendedSetAdditionsOrRecovery(
+    workoutSessionExercise: WorkoutSessionExercise
+  ): number | null {
+    const { performanceScore, sorenessScore } = workoutSessionExercise;
+    if (sorenessScore == null || performanceScore == null) {
+      return null;
+    }
+
+    // Table mapping (sorenessScore rows, performanceScore columns).
+    // Values are representative set additions (midpoint of table ranges), or -1 for recovery.
+    const table: number[][] = [
+      // Soreness 0: [Add 1-3, Add 0-2, Do not add, Recovery]
+      [2, 1, 0, -1],
+      // Soreness 1: [Add 1-2, Add 0-1, Do not add, Recovery]
+      [1, 0, 0, -1],
+      // Soreness 2: [Do not add, Do not add, Do not add, Recovery]
+      [0, 0, 0, -1],
+      // Soreness 3: [Do not add, Do not add, Do not add, Recovery]
+      [0, 0, 0, -1]
+    ];
+
+    return table[sorenessScore]?.[performanceScore] ?? null;
+  }
+}

package/lib/services/workout/Set/WorkoutSetService.d.ts

@@ -0,0 +1,36 @@
+import type { WorkoutExercise } from '../../../documents/workout/WorkoutExercise.js';
+import type { WorkoutExerciseCalibration } from '../../../documents/workout/WorkoutExerciseCalibration.js';
+import type { WorkoutSession } from '../../../documents/workout/WorkoutSession.js';
+import type { WorkoutSessionExercise } from '../../../documents/workout/WorkoutSessionExercise.js';
+import type WorkoutMesocyclePlanContext from '../Mesocycle/WorkoutMesocyclePlanContext.js';
+export default class WorkoutSetService {
+    /**
+     * Generates a list of workout sets for a given session exercise based on progression logic.
+     *
+     * This handles the "micro" decisions of load selection:
+     * - Calculating the initial target weight/reps based on microcycle progression.
+     * - Handling intra-session fatigue (dropping reps/weight across sets).
+     * - Applying Deload phase modifications (cutting volume/intensity).
+     */
+    static generateSetsForSessionExercise({ context, exercise, calibration, session, sessionExercise, microcycleIndex, sessionIndex, setCount, targetRir, isDeloadMicrocycle }: {
+        context: WorkoutMesocyclePlanContext;
+        exercise: WorkoutExercise;
+        calibration: WorkoutExerciseCalibration;
+        session: WorkoutSession;
+        sessionExercise: WorkoutSessionExercise;
+        microcycleIndex: number;
+        sessionIndex: number;
+        setCount: number;
+        targetRir: number;
+        isDeloadMicrocycle: boolean;
+    }): void;
+    /**
+     * Generates the planned reps and weight for a specific set within a session exercise, only
+     * taking into account simple -2 reps drop per set logic, and deload modifications.
+     *
+     * This needs to be checked with the source material to see if it needs to be adjusted based
+     * on actual reps performed in previous sets.
+     */
+    private static generateSetRepsAndWeight;
+}
+//# sourceMappingURL=WorkoutSetService.d.ts.map

package/lib/services/workout/Set/WorkoutSetService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkoutSetService.d.ts","sourceRoot":"","sources":["../../../../src/services/workout/Set/WorkoutSetService.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,eAAe,EAChB,MAAM,+CAA+C,CAAC;AACvD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,0DAA0D,CAAC;AAC3G,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AACnF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sDAAsD,CAAC;AAInG,OAAO,KAAK,2BAA2B,MAAM,6CAA6C,CAAC;AAE3F,MAAM,CAAC,OAAO,OAAO,iBAAiB;IACpC;;;;;;;OAOG;IACH,MAAM,CAAC,8BAA8B,CAAC,EACpC,OAAO,EACP,QAAQ,EACR,WAAW,EACX,OAAO,EACP,eAAe,EACf,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,kBAAkB,EACnB,EAAE;QACD,OAAO,EAAE,2BAA2B,CAAC;QACrC,QAAQ,EAAE,eAAe,CAAC;QAC1B,WAAW,EAAE,0BAA0B,CAAC;QACxC,OAAO,EAAE,cAAc,CAAC;QACxB,eAAe,EAAE,sBAAsB,CAAC;QACxC,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,kBAAkB,EAAE,OAAO,CAAC;KAC7B,GAAG,IAAI;IAoDR;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,wBAAwB;CAiDxC"}

package/lib/services/workout/Set/WorkoutSetService.js

@@ -0,0 +1,90 @@
+import { WorkoutSetSchema } from '../../../documents/workout/WorkoutSet.js';
+import WorkoutEquipmentTypeService from '../EquipmentType/WorkoutEquipmentTypeService.js';
+import WorkoutExerciseService from '../Exercise/WorkoutExerciseService.js';
+export default class WorkoutSetService {
+    /**
+     * Generates a list of workout sets for a given session exercise based on progression logic.
+     *
+     * This handles the "micro" decisions of load selection:
+     * - Calculating the initial target weight/reps based on microcycle progression.
+     * - Handling intra-session fatigue (dropping reps/weight across sets).
+     * - Applying Deload phase modifications (cutting volume/intensity).
+     */
+    static generateSetsForSessionExercise({ context, exercise, calibration, session, sessionExercise, microcycleIndex, sessionIndex, setCount, targetRir, isDeloadMicrocycle }) {
+        const equipment = context.equipmentMap.get(exercise.workoutEquipmentTypeId);
+        if (!equipment) {
+            throw new Error(`Equipment type not found for exercise ${exercise._id}, ${exercise.exerciseName}`);
+        }
+        const sets = [];
+        // Calculate progressed targets for the first set
+        const { targetWeight: firstSetWeight, targetReps: firstSetReps } = WorkoutExerciseService.calculateTargetRepsAndWeightForFirstSet({
+            exercise,
+            calibration,
+            equipment,
+            microcycleIndex,
+            firstMicrocycleRir: context.FIRST_MICROCYCLE_RIR
+        });
+        for (let setIndex = 0; setIndex < setCount; setIndex++) {
+            const { plannedReps, plannedWeight } = this.generateSetRepsAndWeight(
+            // If there is a previous set, base off that, otherwise use first set targets
+            sets[setIndex - 1]?.plannedReps || firstSetReps, sets[setIndex - 1]?.plannedWeight || firstSetWeight, setIndex, exercise.repRange, equipment, {
+                isDeloadMicrocycle,
+                sessionIndex,
+                plannedSessionCountPerMicrocycle: context.mesocycle.plannedSessionCountPerMicrocycle
+            });
+            const workoutSet = WorkoutSetSchema.parse({
+                userId: exercise.userId,
+                workoutExerciseId: exercise._id,
+                workoutSessionId: session._id,
+                workoutSessionExerciseId: sessionExercise._id,
+                plannedReps,
+                plannedWeight,
+                plannedRir: targetRir,
+                exerciseProperties: calibration.exerciseProperties
+            });
+            sets.push(workoutSet);
+        }
+        context.setsToCreate.push(...sets);
+    }
+    /**
+     * Generates the planned reps and weight for a specific set within a session exercise, only
+     * taking into account simple -2 reps drop per set logic, and deload modifications.
+     *
+     * This needs to be checked with the source material to see if it needs to be adjusted based
+     * on actual reps performed in previous sets.
+     */
+    static generateSetRepsAndWeight(firstSetOrPreviousSetReps, firstSetOrPreviousSetWeight, setIndex, repRange, equipment, deloadInfo) {
+        const repRangeValues = WorkoutExerciseService.getRepRangeValues(repRange);
+        let currentReps = firstSetOrPreviousSetReps;
+        let currentWeight = firstSetOrPreviousSetWeight;
+        // Ideally, drop 2 reps per set within the session (19 -> 17 -> 15, etc.)
+        // But if that would go below the min reps, keep it at min reps.
+        if (firstSetOrPreviousSetReps - 2 < repRangeValues.min && setIndex > 0) {
+            // Reduce weight by 2% using the same technique as progression
+            const twoPercentDecrease = currentWeight / 1.02;
+            const reducedWeight = WorkoutEquipmentTypeService.findNearestWeight(equipment, twoPercentDecrease, 'down');
+            if (reducedWeight !== null) {
+                currentWeight = reducedWeight;
+            }
+            else if (firstSetOrPreviousSetReps - 2 > 5) {
+                // If we can't reduce weight, but we can reduce reps without going too low,
+                // then do that.
+                currentReps = firstSetOrPreviousSetReps - 2;
+            }
+        }
+        else if (setIndex > 0) {
+            currentReps = firstSetOrPreviousSetReps - 2;
+        }
+        // Apply deload modifications, but only if the set is the first in the session
+        if (deloadInfo.isDeloadMicrocycle && setIndex === 0) {
+            currentReps = Math.floor(firstSetOrPreviousSetReps / 2);
+            // First half of deload microcycle: same weight, half reps/sets
+            // Second half: half weight too
+            if (deloadInfo.sessionIndex >= Math.floor(deloadInfo.plannedSessionCountPerMicrocycle / 2)) {
+                currentWeight = Math.floor(currentWeight / 2);
+            }
+        }
+        return { plannedReps: currentReps, plannedWeight: currentWeight };
+    }
+}
+//# sourceMappingURL=WorkoutSetService.js.map

package/lib/services/workout/Set/WorkoutSetService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkoutSetService.js","sourceRoot":"","sources":["../../../../src/services/workout/Set/WorkoutSetService.ts"],"names":[],"mappings":"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"}

package/lib/services/workout/Set/WorkoutSetService.ts

@@ -0,0 +1,153 @@
+import type { WorkoutEquipmentType } from '../../../documents/workout/WorkoutEquipmentType.js';
+import type {
+  ExerciseRepRange,
+  WorkoutExercise
+} from '../../../documents/workout/WorkoutExercise.js';
+import type { WorkoutExerciseCalibration } from '../../../documents/workout/WorkoutExerciseCalibration.js';
+import type { WorkoutSession } from '../../../documents/workout/WorkoutSession.js';
+import type { WorkoutSessionExercise } from '../../../documents/workout/WorkoutSessionExercise.js';
+import { WorkoutSetSchema, type WorkoutSet } from '../../../documents/workout/WorkoutSet.js';
+import WorkoutEquipmentTypeService from '../EquipmentType/WorkoutEquipmentTypeService.js';
+import WorkoutExerciseService from '../Exercise/WorkoutExerciseService.js';
+import type WorkoutMesocyclePlanContext from '../Mesocycle/WorkoutMesocyclePlanContext.js';
+
+export default class WorkoutSetService {
+  /**
+   * Generates a list of workout sets for a given session exercise based on progression logic.
+   *
+   * This handles the "micro" decisions of load selection:
+   * - Calculating the initial target weight/reps based on microcycle progression.
+   * - Handling intra-session fatigue (dropping reps/weight across sets).
+   * - Applying Deload phase modifications (cutting volume/intensity).
+   */
+  static generateSetsForSessionExercise({
+    context,
+    exercise,
+    calibration,
+    session,
+    sessionExercise,
+    microcycleIndex,
+    sessionIndex,
+    setCount,
+    targetRir,
+    isDeloadMicrocycle
+  }: {
+    context: WorkoutMesocyclePlanContext;
+    exercise: WorkoutExercise;
+    calibration: WorkoutExerciseCalibration;
+    session: WorkoutSession;
+    sessionExercise: WorkoutSessionExercise;
+    microcycleIndex: number;
+    sessionIndex: number;
+    setCount: number;
+    targetRir: number;
+    isDeloadMicrocycle: boolean;
+  }): void {
+    const equipment = context.equipmentMap.get(exercise.workoutEquipmentTypeId);
+    if (!equipment) {
+      throw new Error(
+        `Equipment type not found for exercise ${exercise._id}, ${exercise.exerciseName}`
+      );
+    }
+
+    const sets: WorkoutSet[] = [];
+
+    // Calculate progressed targets for the first set
+    const { targetWeight: firstSetWeight, targetReps: firstSetReps } =
+      WorkoutExerciseService.calculateTargetRepsAndWeightForFirstSet({
+        exercise,
+        calibration,
+        equipment,
+        microcycleIndex,
+        firstMicrocycleRir: context.FIRST_MICROCYCLE_RIR
+      });
+
+    for (let setIndex = 0; setIndex < setCount; setIndex++) {
+      const { plannedReps, plannedWeight } = this.generateSetRepsAndWeight(
+        // If there is a previous set, base off that, otherwise use first set targets
+        sets[setIndex - 1]?.plannedReps || firstSetReps,
+        sets[setIndex - 1]?.plannedWeight || firstSetWeight,
+        setIndex,
+        exercise.repRange,
+        equipment,
+        {
+          isDeloadMicrocycle,
+          sessionIndex,
+          plannedSessionCountPerMicrocycle: context.mesocycle.plannedSessionCountPerMicrocycle
+        }
+      );
+
+      const workoutSet = WorkoutSetSchema.parse({
+        userId: exercise.userId,
+        workoutExerciseId: exercise._id,
+        workoutSessionId: session._id,
+        workoutSessionExerciseId: sessionExercise._id,
+        plannedReps,
+        plannedWeight,
+        plannedRir: targetRir,
+        exerciseProperties: calibration.exerciseProperties
+      });
+
+      sets.push(workoutSet);
+    }
+
+    context.setsToCreate.push(...sets);
+  }
+
+  /**
+   * Generates the planned reps and weight for a specific set within a session exercise, only
+   * taking into account simple -2 reps drop per set logic, and deload modifications.
+   *
+   * This needs to be checked with the source material to see if it needs to be adjusted based
+   * on actual reps performed in previous sets.
+   */
+  private static generateSetRepsAndWeight(
+    firstSetOrPreviousSetReps: number,
+    firstSetOrPreviousSetWeight: number,
+    setIndex: number,
+    repRange: ExerciseRepRange,
+    equipment: WorkoutEquipmentType,
+    deloadInfo: {
+      isDeloadMicrocycle: boolean;
+      sessionIndex: number;
+      plannedSessionCountPerMicrocycle: number;
+    }
+  ) {
+    const repRangeValues = WorkoutExerciseService.getRepRangeValues(repRange);
+    let currentReps = firstSetOrPreviousSetReps;
+    let currentWeight = firstSetOrPreviousSetWeight;
+
+    // Ideally, drop 2 reps per set within the session (19 -> 17 -> 15, etc.)
+    // But if that would go below the min reps, keep it at min reps.
+    if (firstSetOrPreviousSetReps - 2 < repRangeValues.min && setIndex > 0) {
+      // Reduce weight by 2% using the same technique as progression
+      const twoPercentDecrease = currentWeight / 1.02;
+      const reducedWeight = WorkoutEquipmentTypeService.findNearestWeight(
+        equipment,
+        twoPercentDecrease,
+        'down'
+      );
+      if (reducedWeight !== null) {
+        currentWeight = reducedWeight;
+      } else if (firstSetOrPreviousSetReps - 2 > 5) {
+        // If we can't reduce weight, but we can reduce reps without going too low,
+        // then do that.
+        currentReps = firstSetOrPreviousSetReps - 2;
+      }
+    } else if (setIndex > 0) {
+      currentReps = firstSetOrPreviousSetReps - 2;
+    }
+
+    // Apply deload modifications, but only if the set is the first in the session
+    if (deloadInfo.isDeloadMicrocycle && setIndex === 0) {
+      currentReps = Math.floor(firstSetOrPreviousSetReps / 2);
+      // First half of deload microcycle: same weight, half reps/sets
+      // Second half: half weight too
+      if (deloadInfo.sessionIndex >= Math.floor(deloadInfo.plannedSessionCountPerMicrocycle / 2)) {
+        currentWeight = Math.floor(currentWeight / 2);
+      }
+    }
+
+    return { plannedReps: currentReps, plannedWeight: currentWeight };
+  }
+}

package/lib/services/workout/util/SFR/WorkoutSFRService.d.ts

@@ -0,0 +1,29 @@
+import type { Fatigue } from '../../../../embedded-types/workout/Fatigue.js';
+import type { RSM } from '../../../../embedded-types/workout/Rsm.js';
+/**
+ * A service for handling Stimulus to Fatigue Ratio (SFR) calculations.
+ *
+ * This service works with any object that has RSM and Fatigue data.
+ */
+export default class WorkoutSFRService {
+    /**
+     * Calculates the total Raw Stimulus Magnitude.
+     *
+     * @param rsm The RSM data.
+     */
+    static getRsmTotal(rsm: RSM | null | undefined): number | null;
+    /**
+     * Calculates the total fatigue score.
+     *
+     * @param fatigue The fatigue data.
+     */
+    static getFatigueTotal(fatigue: Fatigue | null | undefined): number | null;
+    /**
+     * Calculates the Stimulus to Fatigue Ratio (SFR).
+     *
+     * @param rsm The RSM data.
+     * @param fatigue The fatigue data.
+     */
+    static getSFR(rsm: RSM | null | undefined, fatigue: Fatigue | null | undefined): number | null;
+}
+//# sourceMappingURL=WorkoutSFRService.d.ts.map

package/lib/services/workout/util/SFR/WorkoutSFRService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkoutSFRService.d.ts","sourceRoot":"","sources":["../../../../../src/services/workout/util/SFR/WorkoutSFRService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+CAA+C,CAAC;AAC7E,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,2CAA2C,CAAC;AAErE;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,iBAAiB;IACpC;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI;IAO9D;;;;OAIG;IACH,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI;IAc1E;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI;CAc/F"}