@dgpholdings/greatoak-shared 1.2.87 → 1.2.89

package/dist/constants/goalJourney.js

@@ -0,0 +1,443 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DAYS_PER_WEEK_OPTIONS = exports.GOAL_CATEGORY_DISPLAY = exports.GOAL_DISPLAY = exports.INTENT_DISPLAY = exports.PHASE_DISPLAY = exports.TRAINING_PHASES = exports.GOAL_TO_AI_FITNESS_GOAL = exports.GOAL_SESSION_INTENTS = exports.USER_FITNESS_GOALS = void 0;
+exports.derivePhase = derivePhase;
+exports.USER_FITNESS_GOALS = [
+    // Appearance
+    "lose_weight",
+    "build_muscle",
+    "lean_and_toned",
+    "glutes_and_legs",
+    // Performance
+    "get_stronger",
+    "boost_endurance",
+    "athletic_performance",
+    // Health
+    "general_fitness",
+    "posture_and_back",
+    "stress_relief",
+    "rehabilitation",
+    // Focused
+    "core_strength",
+    "mobility_flexibility",
+];
+// The canonical weekly template per goal (7 slots, Mon→Sun)
+// Phase-aware structures live in the app layer, not shared
+// This is the "default" / Phase 2-3 reference structure
+exports.GOAL_SESSION_INTENTS = {
+    lose_weight: [
+        "cardio",
+        "full-body",
+        "rest",
+        "cardio",
+        "full-body",
+        "cardio",
+        "rest",
+    ],
+    build_muscle: ["push", "pull", "legs", "rest", "upper", "lower", "rest"],
+    lean_and_toned: [
+        "full-body",
+        "cardio",
+        "full-body",
+        "rest",
+        "full-body",
+        "cardio",
+        "rest",
+    ],
+    glutes_and_legs: ["legs", "upper", "legs", "rest", "legs", "cardio", "rest"],
+    get_stronger: ["push", "pull", "legs", "rest", "push", "pull", "rest"],
+    boost_endurance: [
+        "cardio",
+        "legs",
+        "cardio",
+        "upper",
+        "cardio",
+        "full-body",
+        "rest",
+    ],
+    athletic_performance: [
+        "legs",
+        "upper",
+        "cardio",
+        "core",
+        "full-body",
+        "rest",
+        "rest",
+    ],
+    general_fitness: [
+        "full-body",
+        "rest",
+        "full-body",
+        "cardio",
+        "full-body",
+        "rest",
+        "rest",
+    ],
+    posture_and_back: [
+        "pull",
+        "core",
+        "mobility",
+        "pull",
+        "core",
+        "mobility",
+        "rest",
+    ],
+    stress_relief: [
+        "cardio",
+        "mobility",
+        "full-body",
+        "rest",
+        "cardio",
+        "mobility",
+        "rest",
+    ],
+    rehabilitation: [
+        "mobility",
+        "core",
+        "mobility",
+        "rest",
+        "mobility",
+        "core",
+        "rest",
+    ],
+    core_strength: ["core", "pull", "legs", "core", "push", "rest", "rest"],
+    mobility_flexibility: [
+        "mobility",
+        "full-body",
+        "mobility",
+        "rest",
+        "mobility",
+        "full-body",
+        "rest",
+    ],
+};
+exports.GOAL_TO_AI_FITNESS_GOAL = {
+    lose_weight: "fat_loss",
+    build_muscle: "hypertrophy",
+    lean_and_toned: "fat_loss",
+    glutes_and_legs: "hypertrophy",
+    get_stronger: "strength",
+    boost_endurance: "endurance",
+    athletic_performance: "sport_performance",
+    general_fitness: "general_fitness",
+    posture_and_back: "strength",
+    stress_relief: "general_fitness",
+    rehabilitation: "rehabilitation",
+    core_strength: "core_strength",
+    mobility_flexibility: "mobility",
+};
+exports.TRAINING_PHASES = [1, 2, 3, 4];
+exports.PHASE_DISPLAY = {
+    1: {
+        nameKey: "goalPhase.foundation.name",
+        nameEn: "Foundation",
+        subtitleKey: "goalPhase.foundation.subtitle",
+        subtitleEn: "Build the base",
+        purposeKey: "goalPhase.foundation.purpose",
+        purposeEn: "Preparing your joints, learning movement patterns, and building the work capacity for what's ahead. Every great physique starts here — don't skip it.",
+        durationKey: "goalPhase.foundation.duration",
+        durationEn: "Weeks 1–2",
+        weekRange: [1, 2],
+        intensityPercent: 40,
+    },
+    2: {
+        nameKey: "goalPhase.momentum.name",
+        nameEn: "Momentum",
+        subtitleKey: "goalPhase.momentum.subtitle",
+        subtitleEn: "Volume builds here",
+        purposeKey: "goalPhase.momentum.purpose",
+        purposeEn: "Your body has adapted. Now we increase the work. Splits begin, sessions get more specific. This is where the habit locks in.",
+        durationKey: "goalPhase.momentum.duration",
+        durationEn: "Weeks 3–5",
+        weekRange: [3, 5],
+        intensityPercent: 60,
+    },
+    3: {
+        nameKey: "goalPhase.push.name",
+        nameEn: "Push",
+        subtitleKey: "goalPhase.push.subtitle",
+        subtitleEn: "This is where change happens",
+        purposeKey: "goalPhase.push.purpose",
+        purposeEn: "Goal-specific intensity. Your muscles are conditioned — now we challenge them. Expect to feel this one.",
+        durationKey: "goalPhase.push.duration",
+        durationEn: "Weeks 6–8",
+        weekRange: [6, 8],
+        intensityPercent: 80,
+    },
+    4: {
+        nameKey: "goalPhase.peak.name",
+        nameEn: "Peak",
+        subtitleKey: "goalPhase.peak.subtitle",
+        subtitleEn: "Maximum output",
+        purposeKey: "goalPhase.peak.purpose",
+        purposeEn: "Highest specificity to your goal. You have earned this — now execute. A deload is built into the final week.",
+        durationKey: "goalPhase.peak.duration",
+        durationEn: "Weeks 9+",
+        weekRange: [9, 99],
+        intensityPercent: 95,
+    },
+};
+exports.INTENT_DISPLAY = {
+    push: {
+        labelKey: "sessionIntent.push.label",
+        labelEn: "Push Day",
+        shortLabelKey: "sessionIntent.push.shortLabel",
+        shortLabelEn: "Push",
+        emoji: "💪",
+    },
+    pull: {
+        labelKey: "sessionIntent.pull.label",
+        labelEn: "Pull Day",
+        shortLabelKey: "sessionIntent.pull.shortLabel",
+        shortLabelEn: "Pull",
+        emoji: "🔗",
+    },
+    legs: {
+        labelKey: "sessionIntent.legs.label",
+        labelEn: "Leg Day",
+        shortLabelKey: "sessionIntent.legs.shortLabel",
+        shortLabelEn: "Legs",
+        emoji: "🦵",
+    },
+    lower: {
+        labelKey: "sessionIntent.lower.label",
+        labelEn: "Lower Body",
+        shortLabelKey: "sessionIntent.lower.shortLabel",
+        shortLabelEn: "Lower",
+        emoji: "🦵",
+    },
+    upper: {
+        labelKey: "sessionIntent.upper.label",
+        labelEn: "Upper Body",
+        shortLabelKey: "sessionIntent.upper.shortLabel",
+        shortLabelEn: "Upper",
+        emoji: "💪",
+    },
+    core: {
+        labelKey: "sessionIntent.core.label",
+        labelEn: "Core & Abs",
+        shortLabelKey: "sessionIntent.core.shortLabel",
+        shortLabelEn: "Core",
+        emoji: "⚡",
+    },
+    cardio: {
+        labelKey: "sessionIntent.cardio.label",
+        labelEn: "Cardio",
+        shortLabelKey: "sessionIntent.cardio.shortLabel",
+        shortLabelEn: "Cardio",
+        emoji: "🏃",
+    },
+    strength: {
+        labelKey: "sessionIntent.strength.label",
+        labelEn: "Strength",
+        shortLabelKey: "sessionIntent.strength.shortLabel",
+        shortLabelEn: "Strength",
+        emoji: "🏋️",
+    },
+    fatburn: {
+        labelKey: "sessionIntent.fatburn.label",
+        labelEn: "Fat Burn",
+        shortLabelKey: "sessionIntent.fatburn.shortLabel",
+        shortLabelEn: "Burn",
+        emoji: "🔥",
+    },
+    mobility: {
+        labelKey: "sessionIntent.mobility.label",
+        labelEn: "Mobility",
+        shortLabelKey: "sessionIntent.mobility.shortLabel",
+        shortLabelEn: "Mobility",
+        emoji: "🧘",
+    },
+    "full-body": {
+        labelKey: "sessionIntent.fullBody.label",
+        labelEn: "Full Body",
+        shortLabelKey: "sessionIntent.fullBody.shortLabel",
+        shortLabelEn: "Full",
+        emoji: "⭐",
+    },
+    rest: {
+        labelKey: "sessionIntent.rest.label",
+        labelEn: "Rest Day",
+        shortLabelKey: "sessionIntent.rest.shortLabel",
+        shortLabelEn: "Rest",
+        emoji: "😴",
+    },
+};
+exports.GOAL_DISPLAY = {
+    // ── Appearance ────────────────────────────────────────────────────────────
+    lose_weight: {
+        nameKey: "userGoal.loseWeight.name",
+        nameEn: "Lose Weight",
+        descriptionKey: "userGoal.loseWeight.description",
+        descriptionEn: "Burn fat and drop weight through cardio and full-body training.",
+        taglineKey: "userGoal.loseWeight.tagline",
+        taglineEn: "Every session burns, every week counts.",
+        emoji: "🔥",
+        category: "appearance",
+    },
+    build_muscle: {
+        nameKey: "userGoal.buildMuscle.name",
+        nameEn: "Build Muscle",
+        descriptionKey: "userGoal.buildMuscle.description",
+        descriptionEn: "Add size and strength with structured push, pull, and leg splits.",
+        taglineKey: "userGoal.buildMuscle.tagline",
+        taglineEn: "Progressive overload. Every rep builds the next.",
+        emoji: "💪",
+        category: "appearance",
+    },
+    lean_and_toned: {
+        nameKey: "userGoal.leanAndToned.name",
+        nameEn: "Get Lean & Toned",
+        descriptionKey: "userGoal.leanAndToned.description",
+        descriptionEn: "Burn fat while preserving muscle for a lean, defined look.",
+        taglineKey: "userGoal.leanAndToned.tagline",
+        taglineEn: "Defined. Lean. Confident.",
+        emoji: "✨",
+        category: "appearance",
+    },
+    glutes_and_legs: {
+        nameKey: "userGoal.glutesAndLegs.name",
+        nameEn: "Grow Glutes & Legs",
+        descriptionKey: "userGoal.glutesAndLegs.description",
+        descriptionEn: "Build powerful glutes and legs with targeted lower-body training.",
+        taglineKey: "userGoal.glutesAndLegs.tagline",
+        taglineEn: "Strong legs carry everything.",
+        emoji: "🦵",
+        category: "appearance",
+    },
+    // ── Performance ───────────────────────────────────────────────────────────
+    get_stronger: {
+        nameKey: "userGoal.getStronger.name",
+        nameEn: "Get Stronger",
+        descriptionKey: "userGoal.getStronger.description",
+        descriptionEn: "Build real-world strength through compound lifts and progressive overload.",
+        taglineKey: "userGoal.getStronger.tagline",
+        taglineEn: "Lift more. Be more.",
+        emoji: "🏋️",
+        category: "performance",
+    },
+    boost_endurance: {
+        nameKey: "userGoal.boostEndurance.name",
+        nameEn: "Build Endurance",
+        descriptionKey: "userGoal.boostEndurance.description",
+        descriptionEn: "Increase stamina and cardiovascular capacity through progressive cardio and leg work.",
+        taglineKey: "userGoal.boostEndurance.tagline",
+        taglineEn: "Go further. Last longer.",
+        emoji: "🏃",
+        category: "performance",
+    },
+    athletic_performance: {
+        nameKey: "userGoal.athleticPerformance.name",
+        nameEn: "Athletic Performance",
+        descriptionKey: "userGoal.athleticPerformance.description",
+        descriptionEn: "Train like an athlete — explosive power, speed, agility, and conditioning.",
+        taglineKey: "userGoal.athleticPerformance.tagline",
+        taglineEn: "Train hard. Perform harder.",
+        emoji: "⚡",
+        category: "performance",
+    },
+    // ── Health ────────────────────────────────────────────────────────────────
+    general_fitness: {
+        nameKey: "userGoal.generalFitness.name",
+        nameEn: "Stay Active & Healthy",
+        descriptionKey: "userGoal.generalFitness.description",
+        descriptionEn: "A balanced mix of strength, cardio, and mobility for a healthy, active lifestyle.",
+        taglineKey: "userGoal.generalFitness.tagline",
+        taglineEn: "Move well. Feel well. Live well.",
+        emoji: "🌟",
+        category: "health",
+    },
+    posture_and_back: {
+        nameKey: "userGoal.postureAndBack.name",
+        nameEn: "Fix Posture & Back",
+        descriptionKey: "userGoal.postureAndBack.description",
+        descriptionEn: "Strengthen the posterior chain and core to fix posture and eliminate back pain.",
+        taglineKey: "userGoal.postureAndBack.tagline",
+        taglineEn: "Stand tall. Move pain-free.",
+        emoji: "🧍",
+        category: "health",
+    },
+    stress_relief: {
+        nameKey: "userGoal.stressRelief.name",
+        nameEn: "Reduce Stress",
+        descriptionKey: "userGoal.stressRelief.description",
+        descriptionEn: "Use movement to reset your mind — cardio endorphins and mobility to decompress.",
+        taglineKey: "userGoal.stressRelief.tagline",
+        taglineEn: "Move it out. Breathe it out.",
+        emoji: "🧘",
+        category: "health",
+    },
+    rehabilitation: {
+        nameKey: "userGoal.rehabilitation.name",
+        nameEn: "Recover from Injury",
+        descriptionKey: "userGoal.rehabilitation.description",
+        descriptionEn: "Gentle, progressive sessions to rebuild strength and movement after injury.",
+        taglineKey: "userGoal.rehabilitation.tagline",
+        taglineEn: "Slow and steady. Built to last.",
+        emoji: "🩹",
+        category: "health",
+    },
+    // ── Focused ───────────────────────────────────────────────────────────────
+    core_strength: {
+        nameKey: "userGoal.coreStrength.name",
+        nameEn: "Build a Strong Core",
+        descriptionKey: "userGoal.coreStrength.description",
+        descriptionEn: "Develop deep core stability and strength — the foundation of every movement.",
+        taglineKey: "userGoal.coreStrength.tagline",
+        taglineEn: "Strong core. Strong everything.",
+        emoji: "🎯",
+        category: "focused",
+    },
+    mobility_flexibility: {
+        nameKey: "userGoal.mobilityFlexibility.name",
+        nameEn: "Improve Flexibility",
+        descriptionKey: "userGoal.mobilityFlexibility.description",
+        descriptionEn: "Increase range of motion and joint health through consistent mobility work.",
+        taglineKey: "userGoal.mobilityFlexibility.tagline",
+        taglineEn: "Move freely. Age well.",
+        emoji: "🌀",
+        category: "focused",
+    },
+};
+exports.GOAL_CATEGORY_DISPLAY = {
+    appearance: {
+        labelKey: "goalCategory.appearance.label",
+        labelEn: "Appearance",
+    },
+    performance: {
+        labelKey: "goalCategory.performance.label",
+        labelEn: "Performance",
+    },
+    health: {
+        labelKey: "goalCategory.health.label",
+        labelEn: "Health & Wellbeing",
+    },
+    focused: {
+        labelKey: "goalCategory.focused.label",
+        labelEn: "Focused Training",
+    },
+};
+// ---------------------------------------------------------------------------
+// derivePhase — pure helper
+// Shared between Lambda and client — lives here so neither duplicates it
+// ---------------------------------------------------------------------------
+/**
+ * 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)
+ */
+function derivePhase(weekNumber) {
+    if (weekNumber <= 2)
+        return 1;
+    if (weekNumber <= 5)
+        return 2;
+    if (weekNumber <= 8)
+        return 3;
+    return 4;
+}
+exports.DAYS_PER_WEEK_OPTIONS = [2, 3, 4, 5];

package/dist/constants/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./BodyCategories";
 export * from "./AiExerciseVocabulary";
 export * from "./quickStartIntents";
+export * from "./goalJourney";

package/dist/constants/index.js

@@ -17,3 +17,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./BodyCategories"), exports);
 __exportStar(require("./AiExerciseVocabulary"), exports);
 __exportStar(require("./quickStartIntents"), exports);
+__exportStar(require("./goalJourney"), exports);

package/dist/types/TApiUser.d.ts

@@ -1,4 +1,5 @@
 import type { TAiFitnessGoal, TAiUserInjury } from "../constants/AiExerciseVocabulary";
+import { TConstellationUserLevel } from "../utils";
 import { TGdprData } from "./commonTypes";
 import { TUserPreferences } from "./TUserPreferences";
 export type TAuthType = "email" | "apple" | "anonymous" | "token";
@@ -37,11 +38,12 @@ export type TUserMetric = TUserPreferences & {
     subscriptionStore: TAppStore;
     subscriptionLastUpdatedAt: number;
     gdpr: TGdprData;
+    constellationLevel: TConstellationUserLevel;
     createdAt: Date;
     updatedAt?: Date;
 };
-export type TApiUserUpdateReq = Omit<TUserMetric, "userId" | "subscriptionStatus" | "subscriptionType" | "subscriptionTier" | "subscriptionExpiresAt" | "subscriptionStartedAt" | "subscriptionWillRenew" | "subscriptionStore" | "subscriptionLastUpdatedAt" | "createdAt" | "gdpr"> & {
-    gdpr: Pick<TGdprData, "dataSharing">;
+export type TApiUserUpdateReq = Partial<Omit<TUserMetric, "userId" | "subscriptionStatus" | "subscriptionType" | "subscriptionTier" | "subscriptionExpiresAt" | "subscriptionStartedAt" | "subscriptionWillRenew" | "subscriptionStore" | "subscriptionLastUpdatedAt" | "createdAt" | "gdpr">> & {
+    gdpr?: Pick<TGdprData, "dataSharing">;
 };
 export type TApiUserUpdateRes = {
     status: 400 | 500;

package/dist/utils/adoptionEngine/scaleProPlan.util.js

@@ -40,7 +40,7 @@ const getAdjustedBMIThreshold = (baseThreshold, activityLevel) => {
  * Reduces volume or duration by roughly 30%.
  */
 const applyFallbackScalingToRecord = (record) => {
-    const scaledRecord = Object.assign({}, record);
+    const scaledRecord = { ...record };
     const SCALE_FACTOR = 0.7;
     // Scale reps
     if (scaledRecord.type === "reps-only" || scaledRecord.type === "weight-reps") {
@@ -119,7 +119,7 @@ const scaleProPlan = (masterPlan, userMetric, exercisesDictionary) => {
                         newRecords = newRecords.map((record) => {
                             if (record.type === "weight-reps") {
                                 isModified = true;
-                                return Object.assign(Object.assign({}, record), { kg: suggestedLoadKg.toString() });
+                                return { ...record, kg: suggestedLoadKg.toString() };
                             }
                             // Guard against applying load to a falsy "0" aux weight
                             if (record.type === "reps-only" ||
@@ -128,7 +128,7 @@ const scaleProPlan = (masterPlan, userMetric, exercisesDictionary) => {
                                 const currentAux = parseFloat(record.auxWeightKg || "0");
                                 if (!isNaN(currentAux) && currentAux > 0) {
                                     isModified = true;
-                                    return Object.assign(Object.assign({}, record), { auxWeightKg: suggestedLoadKg.toString() });
+                                    return { ...record, auxWeightKg: suggestedLoadKg.toString() };
                                 }
                             }
                             return record;
@@ -136,7 +136,12 @@ const scaleProPlan = (masterPlan, userMetric, exercisesDictionary) => {
                     }
                 }
                 // Return the tailored template exercise
-                return Object.assign(Object.assign({}, templateExercise), { exerciseId: newExerciseId, initialRecords: newRecords, isAutoScaled: isModified || undefined });
+                return {
+                    ...templateExercise,
+                    exerciseId: newExerciseId,
+                    initialRecords: newRecords,
+                    isAutoScaled: isModified || undefined,
+                };
             });
         });
     });

package/dist/utils/constellation/computeNormalisedLoad.test.d.ts

@@ -0,0 +1 @@
+export {};