@dgpholdings/greatoak-shared 1.2.87 → 1.2.88

package/dist/__mocks__/sessions.mock.js

@@ -0,0 +1,394 @@
+"use strict";
+// shared/src/__mocks__/sessions.mock.ts
+/**
+ * Real workout-session records (verbatim shape as stored in CLIENT_WORKOUTS_TABLE),
+ * used to test the session loader's mapping and the constellation end-to-end
+ * against the real exercise catalog. clientId is rewired to MOCK_USER_ID.
+ *
+ * These reference real exercise IDs that exist in the production exercise
+ * snapshot, with real movement patterns (push_horizontal, squat, lunge, etc.).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mockStoredSessions = exports.mockSessionMixed = exports.mockSessionLegs = exports.mockSessionPush = void 0;
+const testIds_1 = require("./testIds");
+/** Upper/push + accessory session (bench-pattern, triceps, shoulders). */
+exports.mockSessionPush = {
+    pk: testIds_1.MOCK_CLIENT_PK,
+    sk: "SESSION#2026-05-19T09:05:38.286Z#PERSONAL",
+    clientId: testIds_1.MOCK_USER_ID,
+    createdAt: "2026-05-19T09:47:09.418Z",
+    expirationTime: 1794736029,
+    sessionId: "QKB0lDAN_2sB3RbumAZ1O",
+    userDuration: 2491,
+    sessionRecord: [
+        {
+            exerciseId: "2tprDDd4_BsnK6gbMVWTQ",
+            records: [
+                {
+                    auxWeightKg: "0",
+                    durationMmSs: "00:30",
+                    isDone: true,
+                    isStrictMode: false,
+                    type: "duration",
+                },
+            ],
+        },
+        {
+            exerciseId: "-SR_ogujWtdkH6EtCe2OQ",
+            records: [
+                {
+                    auxWeightKg: "0",
+                    isDone: true,
+                    isStrictMode: false,
+                    reps: "8",
+                    type: "reps-only",
+                },
+                {
+                    auxWeightKg: "0",
+                    isDone: true,
+                    isStrictMode: false,
+                    reps: "8",
+                    restDurationSecs: 90,
+                    type: "reps-only",
+                },
+                {
+                    auxWeightKg: "0",
+                    isDone: true,
+                    isStrictMode: false,
+                    reps: "6",
+                    type: "reps-only",
+                },
+            ],
+        },
+        {
+            exerciseId: "EA9B8p_H60pQPRBevjRj6",
+            records: [
+                {
+                    auxWeightKg: "0",
+                    isDone: true,
+                    isStrictMode: false,
+                    reps: "10",
+                    type: "reps-only",
+                },
+                {
+                    auxWeightKg: "0",
+                    isDone: true,
+                    isStrictMode: false,
+                    reps: "9",
+                    restDurationSecs: 90,
+                    type: "reps-only",
+                },
+                {
+                    auxWeightKg: "0",
+                    isDone: true,
+                    isStrictMode: false,
+                    reps: "8",
+                    restDurationSecs: 90,
+                    type: "reps-only",
+                },
+            ],
+        },
+        {
+            exerciseId: "5LyI0el3TUJta6xLYdoua",
+            records: [
+                {
+                    isDone: true,
+                    isStrictMode: false,
+                    kg: "20",
+                    reps: "10",
+                    type: "weight-reps",
+                },
+                {
+                    isDone: true,
+                    isStrictMode: false,
+                    kg: "20",
+                    reps: "9",
+                    restDurationSecs: 90,
+                    type: "weight-reps",
+                },
+                {
+                    isDone: true,
+                    isStrictMode: false,
+                    kg: "20",
+                    reps: "7",
+                    restDurationSecs: 90,
+                    type: "weight-reps",
+                },
+            ],
+        },
+        {
+            exerciseId: "RQCNQi0sw8icSqyhzytyS",
+            records: [
+                {
+                    isDone: true,
+                    isStrictMode: false,
+                    kg: "26",
+                    reps: "10",
+                    type: "weight-reps",
+                },
+                {
+                    isDone: true,
+                    isStrictMode: false,
+                    kg: "26",
+                    reps: "10",
+                    restDurationSecs: 60,
+                    type: "weight-reps",
+                },
+                {
+                    isDone: true,
+                    isStrictMode: false,
+                    kg: "26",
+                    reps: "8",
+                    restDurationSecs: 60,
+                    type: "weight-reps",
+                },
+            ],
+        },
+        {
+            exerciseId: "cICiD8ldTl3TVKl_SZV4y",
+            records: [
+                {
+                    isDone: true,
+                    isStrictMode: false,
+                    kg: "50",
+                    reps: "8",
+                    type: "weight-reps",
+                },
+                {
+                    isDone: true,
+                    isStrictMode: false,
+                    kg: "50",
+                    reps: "7",
+                    restDurationSecs: 60,
+                    type: "weight-reps",
+                },
+                {
+                    isDone: true,
+                    isStrictMode: false,
+                    kg: "45",
+                    reps: "7",
+                    restDurationSecs: 60,
+                    type: "weight-reps",
+                },
+            ],
+        },
+        {
+            exerciseId: "9W7Yon0FWh1Eqd52yjHV9",
+            records: [
+                {
+                    auxWeightKg: "0",
+                    durationMmSs: "01:13",
+                    isDone: true,
+                    isStrictMode: false,
+                    type: "duration",
+                },
+            ],
+        },
+    ],
+};
+/** Lower-body session (squat, lunge, plyo) — note several sets isDone:false. */
+exports.mockSessionLegs = {
+    pk: testIds_1.MOCK_CLIENT_PK,
+    sk: "SESSION#2026-04-29T07:47:53.111Z#PERSONAL",
+    clientId: testIds_1.MOCK_USER_ID,
+    createdAt: "2026-04-29T07:52:24.207Z",
+    expirationTime: 1793001144,
+    sessionId: "EASmO9MwSnNHKtCWseQzz",
+    userDuration: 271,
+    sessionRecord: [
+        {
+            exerciseId: "xNvol6-lFnHQUMCfxFMBD",
+            records: [
+                {
+                    auxWeightKg: "0",
+                    isDone: false,
+                    isStrictMode: false,
+                    reps: "15",
+                    type: "reps-only",
+                },
+                {
+                    auxWeightKg: "0",
+                    isDone: false,
+                    isStrictMode: false,
+                    reps: "15",
+                    type: "reps-only",
+                },
+                {
+                    auxWeightKg: "0",
+                    isDone: false,
+                    isStrictMode: false,
+                    reps: "15",
+                    type: "reps-only",
+                },
+            ],
+        },
+        {
+            exerciseId: "D3XVV-ypHfraYO52eH9ur",
+            records: [
+                {
+                    auxWeightKg: "0",
+                    isDone: true,
+                    isStrictMode: false,
+                    reps: "10",
+                    restDurationSecs: 60,
+                    type: "reps-only",
+                },
+                {
+                    auxWeightKg: "0",
+                    isDone: false,
+                    isStrictMode: false,
+                    reps: "10",
+                    restDurationSecs: 45,
+                    type: "reps-only",
+                },
+                {
+                    auxWeightKg: "0",
+                    isDone: false,
+                    isStrictMode: false,
+                    reps: "10",
+                    type: "reps-only",
+                },
+            ],
+        },
+        {
+            exerciseId: "cXExEzqEAF8YrFN2kAnIq",
+            records: [
+                {
+                    auxWeightKg: "0",
+                    isDone: true,
+                    isStrictMode: false,
+                    reps: "10",
+                    rir: "0",
+                    type: "reps-only",
+                },
+                {
+                    auxWeightKg: "0",
+                    isDone: true,
+                    isStrictMode: false,
+                    reps: "12",
+                    restDurationSecs: 30,
+                    rir: "0",
+                    type: "reps-only",
+                },
+                {
+                    auxWeightKg: "0",
+                    isDone: true,
+                    isStrictMode: false,
+                    reps: "12",
+                    rir: "0",
+                    type: "reps-only",
+                },
+            ],
+        },
+        {
+            exerciseId: "3CkW5o5VQbCodRFmByeMc",
+            records: [
+                {
+                    auxWeightKg: "0",
+                    isDone: true,
+                    isStrictMode: false,
+                    reps: "10",
+                    type: "reps-only",
+                },
+                {
+                    auxWeightKg: "0",
+                    isDone: false,
+                    isStrictMode: false,
+                    reps: "12",
+                    type: "reps-only",
+                },
+                {
+                    auxWeightKg: "0",
+                    isDone: false,
+                    isStrictMode: false,
+                    reps: "12",
+                    type: "reps-only",
+                },
+            ],
+        },
+    ],
+};
+/** Short mixed session (abs, cardio-machine, duration) — recent. */
+exports.mockSessionMixed = {
+    pk: testIds_1.MOCK_CLIENT_PK,
+    sk: "SESSION#2026-06-05T19:39:08.048Z#PERSONAL",
+    clientId: testIds_1.MOCK_USER_ID,
+    createdAt: "2026-06-05T19:40:04.918Z",
+    expirationTime: 1796240404,
+    sessionId: "HauSJHH0Eo3clVrSmR9z7",
+    userDuration: 56,
+    sessionRecord: [
+        {
+            exerciseId: "S7Edj-DnCvOgYNv_0SlzP",
+            records: [
+                {
+                    auxWeightKg: "0",
+                    isDone: true,
+                    isStrictMode: false,
+                    reps: "10",
+                    type: "reps-only",
+                },
+                {
+                    auxWeightKg: "0",
+                    isDone: true,
+                    isStrictMode: false,
+                    reps: "10",
+                    type: "reps-only",
+                },
+                {
+                    auxWeightKg: "0",
+                    isDone: true,
+                    isStrictMode: false,
+                    reps: "10",
+                    type: "reps-only",
+                },
+            ],
+        },
+        {
+            exerciseId: "_pz6syBDTeH36DFmg2VRy",
+            records: [
+                {
+                    distance: "2",
+                    durationMmSs: "15:00",
+                    isDone: true,
+                    isStrictMode: false,
+                    speed: "8",
+                    type: "cardio-machine",
+                },
+                {
+                    distance: "2",
+                    durationMmSs: "13:00",
+                    isDone: true,
+                    isStrictMode: false,
+                    speed: "8",
+                    type: "cardio-machine",
+                },
+            ],
+        },
+        {
+            exerciseId: "9W7Yon0FWh1Eqd52yjHV9",
+            records: [
+                {
+                    auxWeightKg: "0",
+                    durationMmSs: "00:00",
+                    isDone: true,
+                    isStrictMode: false,
+                    type: "duration",
+                },
+                {
+                    auxWeightKg: "0",
+                    durationMmSs: "00:00",
+                    isDone: true,
+                    isStrictMode: false,
+                    restDurationSecs: 10,
+                    type: "duration",
+                },
+            ],
+        },
+    ],
+};
+exports.mockStoredSessions = [
+    exports.mockSessionPush,
+    exports.mockSessionLegs,
+    exports.mockSessionMixed,
+];

package/dist/__mocks__/testIds.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Common identifiers for tests and fixtures. Keeping them here means a mock
+ * user, their session records, and any controller test all agree on the same
+ * id without magic strings scattered around.
+ */
+/** The canonical test user. Used as both userId and the CLIENT#<id> partition. */
+export declare const MOCK_USER_ID = "mock-user-123";
+/** The DynamoDB partition key for that user's workout sessions. */
+export declare const MOCK_CLIENT_PK = "CLIENT#mock-user-123";

package/dist/__mocks__/testIds.js

@@ -0,0 +1,13 @@
+"use strict";
+// shared/src/__mocks__/testIds.ts
+/**
+ * Common identifiers for tests and fixtures. Keeping them here means a mock
+ * user, their session records, and any controller test all agree on the same
+ * id without magic strings scattered around.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MOCK_CLIENT_PK = exports.MOCK_USER_ID = void 0;
+/** The canonical test user. Used as both userId and the CLIENT#<id> partition. */
+exports.MOCK_USER_ID = "mock-user-123";
+/** The DynamoDB partition key for that user's workout sessions. */
+exports.MOCK_CLIENT_PK = `CLIENT#${exports.MOCK_USER_ID}`;

package/dist/__mocks__/user.mock.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.mockUser = void 0;
+const testIds_1 = require("./testIds");
 exports.mockUser = {
     // TUserPreferences fields (flat in TUserMetric)
     preferredDurationMinutes: 45,
@@ -18,8 +19,9 @@ exports.mockUser = {
     appLanguage: "en",
     preferencesUpdatedAt: new Date("2023-01-01").toISOString(),
     femaleHealth: null, // Male user
+    constellationLevel: 1,
     // TUserMetric-specific fields
-    userId: "mock-user-123",
+    userId: testIds_1.MOCK_USER_ID,
     userCode: "MOCK123",
     userType: "regular",
     fullName: "Mock User",

package/dist/constants/goalJourney.d.ts

@@ -0,0 +1,108 @@
+import { TAiFitnessGoal } from "./AiExerciseVocabulary";
+import { QUICK_START_CLEAR_INTENTS } from "./quickStartIntents";
+export declare const USER_FITNESS_GOALS: readonly ["lose_weight", "build_muscle", "lean_and_toned", "glutes_and_legs", "get_stronger", "boost_endurance", "athletic_performance", "general_fitness", "posture_and_back", "stress_relief", "rehabilitation", "core_strength", "mobility_flexibility"];
+export type TUserFitnessGoal = (typeof USER_FITNESS_GOALS)[number];
+export type TSessionIntent = (typeof QUICK_START_CLEAR_INTENTS)[keyof typeof QUICK_START_CLEAR_INTENTS] | "rest";
+export declare const GOAL_SESSION_INTENTS: Record<TUserFitnessGoal, TWeeklyIntentTemplate>;
+export declare const GOAL_TO_AI_FITNESS_GOAL: Record<TUserFitnessGoal, TAiFitnessGoal>;
+export declare const TRAINING_PHASES: readonly [1, 2, 3, 4];
+export type TTrainingPhase = (typeof TRAINING_PHASES)[number];
+export type TPhaseDisplay = {
+    /** i18n key for the phase name — e.g. "goalPhase.foundation.name" */
+    nameKey: string;
+    /** English fallback for nameKey */
+    nameEn: string;
+    /** i18n key for the short subtitle — e.g. "goalPhase.foundation.subtitle" */
+    subtitleKey: string;
+    /** English fallback for subtitleKey */
+    subtitleEn: string;
+    /** i18n key for the longer purpose description shown in phase detail */
+    purposeKey: string;
+    /** English fallback for purposeKey */
+    purposeEn: string;
+    /** i18n key for the week range label — e.g. "goalPhase.foundation.duration" */
+    durationKey: string;
+    /** English fallback for durationKey */
+    durationEn: string;
+    /** Inclusive week range [startWeek, endWeek]. Phase 4 end is open (99). */
+    weekRange: [number, number];
+    /**
+     * Reference intensity as a percentage (0–100).
+     * For UI progress bars / intensity indicators only — not used in algorithm.
+     */
+    intensityPercent: number;
+};
+export declare const PHASE_DISPLAY: Record<TTrainingPhase, TPhaseDisplay>;
+export type TIntentDisplay = {
+    /** i18n key for the full label — e.g. "sessionIntent.push.label" */
+    labelKey: string;
+    /** English fallback for labelKey */
+    labelEn: string;
+    /**
+     * i18n key for the short label used in compact journey nodes.
+     * e.g. "sessionIntent.push.shortLabel"
+     */
+    shortLabelKey: string;
+    /** English fallback for shortLabelKey */
+    shortLabelEn: string;
+    /**
+     * Emoji for the session node icon.
+     * Not translated — emoji is universal.
+     */
+    emoji: string;
+};
+export declare const INTENT_DISPLAY: Record<TSessionIntent, TIntentDisplay>;
+export type TGoalDisplay = {
+    /** i18n key for the goal name — e.g. "userGoal.loseWeight.name" */
+    nameKey: string;
+    /** English fallback for nameKey */
+    nameEn: string;
+    /** i18n key for the short description shown on goal selection screen */
+    descriptionKey: string;
+    /** English fallback for descriptionKey */
+    descriptionEn: string;
+    /**
+     * i18n key for the motivational tagline shown on the goal journey screen.
+     * e.g. "userGoal.loseWeight.tagline"
+     */
+    taglineKey: string;
+    /** English fallback for taglineKey */
+    taglineEn: string;
+    /** Emoji representing the goal — universal, not translated */
+    emoji: string;
+    /**
+     * Goal category — used to group goals on the selection screen.
+     * Category label itself is also translated via categoryKey.
+     */
+    category: "appearance" | "performance" | "health" | "focused";
+};
+export declare const GOAL_DISPLAY: Record<TUserFitnessGoal, TGoalDisplay>;
+export type TGoalCategory = TGoalDisplay["category"];
+export type TGoalCategoryDisplay = {
+    labelKey: string;
+    labelEn: string;
+};
+export declare const GOAL_CATEGORY_DISPLAY: Record<TGoalCategory, TGoalCategoryDisplay>;
+/**
+ * Derive the current training phase from the week number since goal start.
+ * Week is 1-indexed (week 1 = first week on the program).
+ *
+ * @example
+ * derivePhase(1)  // → 1 (Foundation)
+ * derivePhase(3)  // → 2 (Momentum)
+ * derivePhase(7)  // → 3 (Push)
+ * derivePhase(10) // → 4 (Peak)
+ */
+export declare function derivePhase(weekNumber: number): TTrainingPhase;
+export declare const DAYS_PER_WEEK_OPTIONS: readonly [2, 3, 4, 5];
+export type TDaysPerWeek = (typeof DAYS_PER_WEEK_OPTIONS)[number];
+export type TDurationHint = "short" | "medium" | "long";
+export type TWeeklyIntentTemplate = [
+    TSessionIntent,
+    TSessionIntent,
+    TSessionIntent,
+    TSessionIntent,
+    TSessionIntent,
+    TSessionIntent,
+    TSessionIntent
+];