@dgpholdings/greatoak-shared 1.2.90 → 1.2.92

package/dist/constants/AiExerciseVocabulary.d.ts

@@ -47,6 +47,20 @@ export interface TAiUserInjury {
 }
 export declare const AI_ENERGY_LEVEL_OPTIONS: readonly ["fresh", "normal", "tired", "exhausted"];
 export type TAiEnergyLevel = (typeof AI_ENERGY_LEVEL_OPTIONS)[number];
+/**
+ * HARDCODED_INTENTS - Single source of truth for workout intent types.
+ *
+ * Used by:
+ * - Frontend: IntentInput chip values
+ * - Backend: Intent classification, exercise selection
+ * - Shared: TSessionIntent type derivation
+ *
+ * When adding new intents:
+ * 1. Add here
+ * 2. Add mapping in goldenExercise/constants.ts WORKOUT_TYPE_GROUPS
+ * 3. Add warmup/cooldown mappings if needed
+ * 4. Add INTENT_DISPLAY entry in goalJourney.ts (optional, for UI)
+ */
 export declare const HARDCODED_INTENTS: readonly ["push", "pull", "legs", "core", "upper", "lower", "arms", "back", "full-body", "cardio", "strength", "mobility", "fatburn", "unstructured"];
 export type TWorkoutIntent = (typeof HARDCODED_INTENTS)[number];
 export {};

package/dist/constants/AiExerciseVocabulary.js

@@ -212,6 +212,20 @@ exports.AI_ENERGY_LEVEL_OPTIONS = [
     "tired",
     "exhausted",
 ];
+/**
+ * HARDCODED_INTENTS - Single source of truth for workout intent types.
+ *
+ * Used by:
+ * - Frontend: IntentInput chip values
+ * - Backend: Intent classification, exercise selection
+ * - Shared: TSessionIntent type derivation
+ *
+ * When adding new intents:
+ * 1. Add here
+ * 2. Add mapping in goldenExercise/constants.ts WORKOUT_TYPE_GROUPS
+ * 3. Add warmup/cooldown mappings if needed
+ * 4. Add INTENT_DISPLAY entry in goalJourney.ts (optional, for UI)
+ */
 exports.HARDCODED_INTENTS = [
     "push",
     "pull",

package/dist/constants/__tests__/workoutIntents.test.d.ts

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

package/dist/constants/__tests__/workoutIntents.test.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// shared/src/constants/__tests__/workoutIntents.test.ts
+const vitest_1 = require("vitest");
+const AiExerciseVocabulary_1 = require("../AiExerciseVocabulary");
+(0, vitest_1.describe)("HARDCODED_INTENTS - Workout Intent Constants", () => {
+    (0, vitest_1.it)("should export all expected workout intents", () => {
+        const expectedIntents = [
+            "push",
+            "pull",
+            "legs",
+            "core",
+            "upper",
+            "lower",
+            "arms",
+            "back",
+            "full-body",
+            "cardio",
+            "strength",
+            "mobility",
+            "fatburn",
+            "unstructured",
+        ];
+        (0, vitest_1.expect)(AiExerciseVocabulary_1.HARDCODED_INTENTS).toEqual(expectedIntents);
+    });
+    (0, vitest_1.it)("should have 14 total intents", () => {
+        (0, vitest_1.expect)(AiExerciseVocabulary_1.HARDCODED_INTENTS).toHaveLength(14);
+    });
+    (0, vitest_1.it)("should not have duplicate values", () => {
+        const uniqueIntents = [...new Set(AiExerciseVocabulary_1.HARDCODED_INTENTS)];
+        (0, vitest_1.expect)(uniqueIntents).toHaveLength(AiExerciseVocabulary_1.HARDCODED_INTENTS.length);
+    });
+    (0, vitest_1.it)("should only contain lowercase strings with hyphens", () => {
+        AiExerciseVocabulary_1.HARDCODED_INTENTS.forEach((intent) => {
+            (0, vitest_1.expect)(intent).toMatch(/^[a-z-]+$/);
+        });
+    });
+    (0, vitest_1.it)("should have TWorkoutIntent type that matches array values", () => {
+        // Type test - this will fail at compile time if types diverge
+        const testIntent = "push";
+        (0, vitest_1.expect)(AiExerciseVocabulary_1.HARDCODED_INTENTS).toContain(testIntent);
+        // @ts-expect-error - "invalid" is not a valid TWorkoutIntent
+        const invalidIntent = "invalid";
+    });
+    (0, vitest_1.it)("should include user-selectable intents", () => {
+        const userSelectableIntents = [
+            "push",
+            "pull",
+            "legs",
+            "core",
+            "upper",
+            "lower",
+            "full-body",
+            "cardio",
+            "strength",
+            "mobility",
+            "fatburn",
+        ];
+        userSelectableIntents.forEach((intent) => {
+            (0, vitest_1.expect)(AiExerciseVocabulary_1.HARDCODED_INTENTS).toContain(intent);
+        });
+    });
+    (0, vitest_1.it)("should include backend-only intents", () => {
+        const backendOnlyIntents = ["arms", "back", "unstructured"];
+        backendOnlyIntents.forEach((intent) => {
+            (0, vitest_1.expect)(AiExerciseVocabulary_1.HARDCODED_INTENTS).toContain(intent);
+        });
+    });
+    (0, vitest_1.it)("should maintain stable order for backward compatibility", () => {
+        // First few intents should remain in this order for compatibility
+        (0, vitest_1.expect)(AiExerciseVocabulary_1.HARDCODED_INTENTS[0]).toBe("push");
+        (0, vitest_1.expect)(AiExerciseVocabulary_1.HARDCODED_INTENTS[1]).toBe("pull");
+        (0, vitest_1.expect)(AiExerciseVocabulary_1.HARDCODED_INTENTS[2]).toBe("legs");
+        (0, vitest_1.expect)(AiExerciseVocabulary_1.HARDCODED_INTENTS[3]).toBe("core");
+    });
+});

package/dist/constants/goalJourney.d.ts

@@ -1,8 +1,7 @@
-import { TAiFitnessGoal } from "./AiExerciseVocabulary";
-import { QUICK_START_CLEAR_INTENTS } from "./quickStartIntents";
+import { TAiFitnessGoal, TWorkoutIntent } from "./AiExerciseVocabulary";
 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 type TSessionIntent = TWorkoutIntent | "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];
@@ -51,7 +50,7 @@ export type TIntentDisplay = {
      */
     emoji: string;
 };
-export declare const INTENT_DISPLAY: Record<TSessionIntent, TIntentDisplay>;
+export declare const INTENT_DISPLAY: Partial<Record<TSessionIntent, TIntentDisplay>>;
 export type TGoalDisplay = {
     /** i18n key for the goal name — e.g. "userGoal.loseWeight.name" */
     nameKey: string;

package/dist/constants/index.d.ts

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

package/dist/constants/index.js

@@ -16,5 +16,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 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/TApiClientProgress.d.ts

@@ -1,4 +1,6 @@
+import { TWorkoutIntent } from "../constants/AiExerciseVocabulary";
 import { TRecord } from "./commonTypes";
+import { TTemplate } from "./TApiTemplateData";
 export type TClientData = {
     clientId: string;
     trainerPlanId: string;
@@ -14,7 +16,9 @@ export type TClientSessionData = {
     records: TRecord[];
 };
 export type TApiClientProgressSaveReq = {
-    planId?: string;
+    planId: string | undefined;
+    planType: TTemplate["type"];
+    intentId: Omit<TWorkoutIntent, "unstructured"> | undefined;
     sessionRecord: TClientSessionData[];
     sessionStartTimestamp: string;
 };

package/dist/types/TApiTemplateData.d.ts

@@ -1,3 +1,4 @@
+import { TWorkoutIntent } from "../constants";
 import { TTemplateExercise } from "./commonTypes";
 import { TProPlan } from "./TApiProPlan";
 export type TTemplateDb = TTemplate & {
@@ -13,6 +14,7 @@ export type TAiPlanContext = {
     protectedAreas: string[];
     intendedIntensity: "recovery" | "light" | "moderate" | "vigorous" | "max_effort";
     adaptationNote?: string;
+    intentId: TWorkoutIntent;
 };
 export type TTemplate = {
     name: string;

package/package.json

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