@dgpholdings/greatoak-shared 1.1.19 → 1.1.21

package/dist/utils/scoring.utils.d.ts

@@ -1,16 +1,19 @@
-export type TRecordType = "weight-reps" | "duration" | "body-weight";
-export interface TUserProfile {
+import { TRefinedRecord } from "./record.utils";
+type TUserProfile = {
     age?: number;
     gender?: "male" | "female" | "non-binary" | "unspecified";
     weightKg?: number;
-}
-export interface TRecordInput {
-    isDone: boolean;
-    kg?: number;
-    reps?: number;
-    durationSecs?: string;
-    rpe?: number;
-    rir?: number;
-    auxWeightKg?: number;
-}
-export declare function computeScoreFromRecord(record: TRecordInput, recordType: TRecordType, userProfile?: TUserProfile): number;
+};
+/**
+ * The score represents the training stimulus or workload stress generated by a specific set of exercise inputs.
+ * in short: Training Stress Score (TSS)
+ * We can use the score for:
+    1.Tracking session intensity or set difficulty over time
+    2. Deciding muscle recovery readiness
+    3. Creating training summaries, like:
+        - Daily workload
+        - Volume comparisons
+        - Weekly fatigue trends
+ */
+export declare const computeScoreFromRecord: (record: TRefinedRecord, userProfile?: TUserProfile) => number;
+export {};

package/dist/utils/scoring.utils.js

@@ -1,9 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.computeScoreFromRecord = computeScoreFromRecord;
+exports.computeScoreFromRecord = void 0;
 const time_util_1 = require("./time.util");
-function computeScoreFromRecord(record, recordType, userProfile) {
-    var _a, _b, _c, _d, _e, _f, _g, _h;
+/**
+ * The score represents the training stimulus or workload stress generated by a specific set of exercise inputs.
+ * in short: Training Stress Score (TSS)
+ * We can use the score for:
+    1.Tracking session intensity or set difficulty over time
+    2. Deciding muscle recovery readiness
+    3. Creating training summaries, like:
+        - Daily workload
+        - Volume comparisons
+        - Weekly fatigue trends
+ */
+const computeScoreFromRecord = (record, userProfile) => {
+    var _a, _b, _c, _d, _e, _f;
     if (!record.isDone)
         return 0;
     // Determine load and effortFactor from record based on type
@@ -19,22 +30,20 @@ function computeScoreFromRecord(record, recordType, userProfile) {
         effortFactor = 10 - rir; // lower RIR means more effort
     }
     // Step 2: Determine load
-    switch (recordType) {
+    switch (record.type) {
         case "weight-reps": {
-            const kg = (_c = record.kg) !== null && _c !== void 0 ? _c : 0;
-            const reps = (_d = record.reps) !== null && _d !== void 0 ? _d : 0;
-            load = kg * reps;
+            load = record.kg * record.reps;
             break;
         }
         case "duration": {
-            const durationSecs = (0, time_util_1.mmssToSecs)((_e = record.durationSecs) !== null && _e !== void 0 ? _e : "00:00");
-            const auxWeight = (_f = record.auxWeightKg) !== null && _f !== void 0 ? _f : 0;
+            const durationSecs = (0, time_util_1.mmssToSecs)((_c = record.durationSecs) !== null && _c !== void 0 ? _c : "00:00");
+            const auxWeight = (_d = record.auxWeightKg) !== null && _d !== void 0 ? _d : 0;
             load = auxWeight > 0 ? auxWeight * durationSecs : durationSecs;
             break;
         }
-        case "body-weight": {
-            const reps = (_g = record.reps) !== null && _g !== void 0 ? _g : 0;
-            const auxWeight = (_h = record.auxWeightKg) !== null && _h !== void 0 ? _h : 0;
+        case "reps-only": {
+            const reps = (_e = record.reps) !== null && _e !== void 0 ? _e : 0;
+            const auxWeight = (_f = record.auxWeightKg) !== null && _f !== void 0 ? _f : 0;
             load = auxWeight > 0 ? auxWeight * reps : reps;
             break;
         }
@@ -42,8 +51,9 @@ function computeScoreFromRecord(record, recordType, userProfile) {
             return 0;
     }
     return computeFinalScore(load, effortFactor, userProfile);
-}
-function computeFinalScore(load, effortFactor, userProfile) {
+};
+exports.computeScoreFromRecord = computeScoreFromRecord;
+const computeFinalScore = (load, effortFactor, userProfile) => {
     const base = Math.log10(1 + Math.max(0, load));
     const effortBoost = 1 + Math.min(effortFactor, 10) * 0.05;
     // Optional scaling
@@ -57,4 +67,4 @@ function computeFinalScore(load, effortFactor, userProfile) {
         adjustment *= normalizedWeight / userProfile.weightKg;
     }
     return base * effortBoost * adjustment;
-}
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dgpholdings/greatoak-shared",
-  "version": "1.1.19",
+  "version": "1.1.21",
   "description": "Shared TypeScript types and utilities for @dgpholdings projects",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",