@dgpholdings/greatoak-shared 1.1.20 → 1.1.22

package/dist/types/TApiExercise.d.ts

@@ -38,7 +38,7 @@ export type TExercise = {
     primaryMuscles: TBodyPartKeys;
     secondaryMuscles: TBodyPartKeys;
     trainingTypes: TTrainingType[];
-    isCompoundExercise: boolean;
+    avgSetDurationInSecs?: number;
     difficultyLevel: number;
     hypertrophyLevel: number;
     strengthGainLevel: number;

package/dist/types/TApiExerciseRecord.d.ts

@@ -29,11 +29,11 @@ export type TRecordBodyWeight = Extract<TRecord, {
 }>;
 export type TRecordConfig = {
     enableAuxWeight?: boolean;
-    enableRestTime?: boolean;
     enableRir?: boolean;
     enableRpe?: boolean;
     enableSetNote?: boolean;
     enableExerciseNote?: boolean;
+    enableRestTime?: boolean;
 };
 export type TApiExerciseRecordUpdateReq = {
     templateId: string;
@@ -42,6 +42,7 @@ export type TApiExerciseRecordUpdateReq = {
         exerciseId: string;
         config: TRecordConfig;
         exerciseNote: string;
+        restTimeSecs?: number;
         record: TRecord[];
     }[];
 };

package/dist/types/TApiTemplateData.d.ts

@@ -40,6 +40,7 @@ export type TApiTemplateUpdateRes = {
 export type TExerciseLatestRecord = {
     recordDate: Date;
     exerciseNote?: string;
+    restTimeSecs?: number;
     score: number;
     records: {
         kg?: Extract<TRecord, {

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

@@ -1,16 +1,19 @@
-import { TRecord } from "../types";
-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 const computeScoreFromRecord: (record: TRecordInput, recordType: TRecord["type"], 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

@@ -2,8 +2,19 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.computeScoreFromRecord = void 0;
 const time_util_1 = require("./time.util");
-const 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 @@ const 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 "reps-only": {
-            const reps = (_g = record.reps) !== null && _g !== void 0 ? _g : 0;
-            const auxWeight = (_h = record.auxWeightKg) !== null && _h !== void 0 ? _h : 0;
+            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;
         }

package/package.json

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