@dgpholdings/greatoak-shared 1.2.68 → 1.2.70

package/dist/constants/AiExerciseVocabulary.d.ts

@@ -1,6 +1,5 @@
 export declare const AI_FITNESS_GOALS: readonly ["strength", "hypertrophy", "fat_loss", "endurance", "mobility", "rehabilitation", "sport_performance", "general_fitness", "core_strength"];
 export type TAiFitnessGoal = (typeof AI_FITNESS_GOALS)[number];
-export declare const AI_FITNESS_GOAL_LABELS: Record<TAiFitnessGoal, string>;
 export declare const AI_EQUIPMENT_TYPES: readonly ["none", "dumbbell", "barbell", "resistance_band", "cable_machine", "standard_machine", "suspension_trainer", "pull_up_bar", "bench", "kettlebell", "niche_machine", "exercise_ball", "ez_bar", "cardio_machine", "smith_machine", "weight_plate", "jump_rope", "battle_ropes", "medicine_ball", "ab_wheel", "plyo_box", "parallel_bars"];
 export type TAiEquipmentType = (typeof AI_EQUIPMENT_TYPES)[number];
 export declare const AI_HOME_EQUIPMENT: TAiEquipmentType[];
@@ -13,7 +12,7 @@ export declare const AI_CORE_PATTERNS: TAiMovementPattern[];
 export declare const AI_WORKOUT_PLACEMENTS: readonly ["primary_compound", "secondary_compound", "accessory", "finisher", "warmup", "cooldown"];
 export type TAiWorkoutPlacement = (typeof AI_WORKOUT_PLACEMENTS)[number];
 export declare const AI_SESSION_ORDER: TAiWorkoutPlacement[];
-export declare const AI_DIFFICULTY_LEVELS: readonly ["beginner", "intermediate", "advanced", "expert"];
+declare const AI_DIFFICULTY_LEVELS: readonly ["beginner", "intermediate", "advanced", "expert"];
 export type TAiDifficultyLevel = (typeof AI_DIFFICULTY_LEVELS)[number];
 export declare const AI_FITNESS_LEVELS: readonly ["beginner", "intermediate", "advanced"];
 export type TAiFitnessLevel = (typeof AI_FITNESS_LEVELS)[number];
@@ -28,14 +27,11 @@ export declare const AI_MET_THRESHOLDS: {
 };
 export declare const AI_BODY_AREAS: readonly ["lower back", "upper back", "shoulders", "neck", "elbows", "wrists", "hips", "hip flexors", "knees", "ankles", "hamstrings", "achilles tendon", "forearms", "groin", "calf muscles", "chest", "core"];
 export type TAiBodyArea = (typeof AI_BODY_AREAS)[number];
-export declare const AI_BODY_AREA_LABELS: Record<TAiBodyArea, string>;
 export declare const AI_BODY_ISSUE_TYPES: readonly ["general_soreness", "joint_pain", "old_injury", "diagnosed_condition"];
 export type TAiBodyIssueType = (typeof AI_BODY_ISSUE_TYPES)[number];
-export declare const AI_BODY_ISSUE_LABELS: Record<TAiBodyIssueType, string>;
 export declare const AI_POPULAR_THRESHOLD = 75;
 export declare const AI_INJURY_SEVERITY: readonly ["mild", "moderate", "severe", "acute_broken"];
 export type TAiInjurySeverity = (typeof AI_INJURY_SEVERITY)[number];
-export declare const AI_INJURY_SEVERITY_LABELS: Record<TAiInjurySeverity, string>;
 export declare const AI_INJURY_DURATION: readonly ["1_5_days", "1_4_weeks", "1_3_months", "3_6_months", "6_plus_months"];
 export type TAiInjuryDuration = (typeof AI_INJURY_DURATION)[number];
 export declare const AI_INJURY_DURATION_LABELS: Record<TAiInjuryDuration, string>;
@@ -61,8 +57,8 @@ export interface TAiUserProfile {
     onboardingCompletedAt: string;
     onboardingVersion: string;
 }
-export declare const AI_SLEEP_QUALITY_OPTIONS: readonly ["good", "disturbed", "poor"];
-export type TAiSleepQuality = (typeof AI_SLEEP_QUALITY_OPTIONS)[number];
-export declare const AI_SLEEP_QUALITY_LABELS: Record<TAiSleepQuality, string>;
+export declare const AI_ENERGY_LEVEL_OPTIONS: readonly ["fresh", "normal", "tired", "exhausted"];
+export type TAiEnergyLevel = (typeof AI_ENERGY_LEVEL_OPTIONS)[number];
 export declare const AI_INTENT_CHIPS: readonly ["leg-day", "upper-body", "full-body", "push-day", "pull-day", "cardio-focused", "back-and-biceps", "chest-and-triceps", "legs-and-glutes", "core-and-abs", "mobility-and-flexibility", "Surprise me"];
 export type TAiIntentChip = (typeof AI_INTENT_CHIPS)[number];
+export {};

package/dist/constants/AiExerciseVocabulary.js

@@ -7,8 +7,7 @@
 // Verified against 701 active exercises from exercises-v2_3_PURE.json
 // Do not add values here without also ensuring they exist in the data.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AI_INTENT_CHIPS = exports.AI_SLEEP_QUALITY_LABELS = exports.AI_SLEEP_QUALITY_OPTIONS = exports.AI_INJURY_DURATION_LABELS = exports.AI_INJURY_DURATION = exports.AI_INJURY_SEVERITY_LABELS = exports.AI_INJURY_SEVERITY = exports.AI_POPULAR_THRESHOLD = exports.AI_BODY_ISSUE_LABELS = exports.AI_BODY_ISSUE_TYPES = exports.AI_BODY_AREA_LABELS = exports.AI_BODY_AREAS = exports.AI_MET_THRESHOLDS = exports.AI_SLEEP_TO_MAX_CNS = exports.AI_INTENSITY_LEVELS = exports.AI_DIFFICULTY_FILTER = exports.AI_FITNESS_LEVELS = exports.AI_DIFFICULTY_LEVELS = exports.AI_SESSION_ORDER = exports.AI_WORKOUT_PLACEMENTS = exports.AI_CORE_PATTERNS = exports.AI_LEG_PATTERNS = exports.AI_PULL_PATTERNS = exports.AI_PUSH_PATTERNS = exports.AI_MOVEMENT_PATTERNS = exports.AI_HOME_EQUIPMENT = exports.AI_EQUIPMENT_TYPES = exports.AI_FITNESS_GOAL_LABELS = exports.AI_FITNESS_GOALS = void 0;
-// ── FITNESS GOALS ────────────────────────────────────────────────────────────
+exports.AI_INTENT_CHIPS = exports.AI_ENERGY_LEVEL_OPTIONS = exports.AI_INJURY_DURATION_LABELS = exports.AI_INJURY_DURATION = exports.AI_INJURY_SEVERITY = exports.AI_POPULAR_THRESHOLD = exports.AI_BODY_ISSUE_TYPES = exports.AI_BODY_AREAS = exports.AI_MET_THRESHOLDS = exports.AI_SLEEP_TO_MAX_CNS = exports.AI_INTENSITY_LEVELS = exports.AI_DIFFICULTY_FILTER = exports.AI_FITNESS_LEVELS = exports.AI_SESSION_ORDER = exports.AI_WORKOUT_PLACEMENTS = exports.AI_CORE_PATTERNS = exports.AI_LEG_PATTERNS = exports.AI_PULL_PATTERNS = exports.AI_PUSH_PATTERNS = exports.AI_MOVEMENT_PATTERNS = exports.AI_HOME_EQUIPMENT = exports.AI_EQUIPMENT_TYPES = exports.AI_FITNESS_GOALS = void 0;
 exports.AI_FITNESS_GOALS = [
     "strength",
     "hypertrophy",
@@ -20,18 +19,6 @@ exports.AI_FITNESS_GOALS = [
     "general_fitness",
     "core_strength",
 ];
-exports.AI_FITNESS_GOAL_LABELS = {
-    strength: "Get stronger",
-    hypertrophy: "Build muscle",
-    fat_loss: "Lose fat",
-    endurance: "Improve endurance",
-    mobility: "Improve flexibility & mobility",
-    rehabilitation: "Recover from injury",
-    sport_performance: "Sport performance",
-    general_fitness: "General fitness",
-    core_strength: "Build core strength",
-};
-// ── EQUIPMENT TYPES ──────────────────────────────────────────────────────────
 exports.AI_EQUIPMENT_TYPES = [
     "none",
     "dumbbell",
@@ -66,7 +53,6 @@ exports.AI_HOME_EQUIPMENT = [
     "exercise_ball",
     "jump_rope",
 ];
-// ── MOVEMENT PATTERNS ────────────────────────────────────────────────────────
 exports.AI_MOVEMENT_PATTERNS = [
     "push_horizontal",
     "push_vertical",
@@ -101,7 +87,6 @@ exports.AI_CORE_PATTERNS = [
     "core_stability",
     "rotation",
 ];
-// ── WORKOUT PLACEMENT ────────────────────────────────────────────────────────
 exports.AI_WORKOUT_PLACEMENTS = [
     "primary_compound",
     "secondary_compound",
@@ -118,8 +103,7 @@ exports.AI_SESSION_ORDER = [
     "finisher",
     "cooldown",
 ];
-// ── DIFFICULTY LEVELS ────────────────────────────────────────────────────────
-exports.AI_DIFFICULTY_LEVELS = [
+const AI_DIFFICULTY_LEVELS = [
     "beginner",
     "intermediate",
     "advanced",
@@ -135,20 +119,17 @@ exports.AI_DIFFICULTY_FILTER = {
     intermediate: ["beginner", "intermediate"],
     advanced: ["beginner", "intermediate", "advanced", "expert"],
 };
-// ── INTENSITY LEVELS ─────────────────────────────────────────────────────────
 exports.AI_INTENSITY_LEVELS = ["low", "moderate", "high"];
 exports.AI_SLEEP_TO_MAX_CNS = {
     good: "high",
     disturbed: "moderate",
     poor: "low",
 };
-// ── MET VALUES ───────────────────────────────────────────────────────────────
 exports.AI_MET_THRESHOLDS = {
     low: 3,
     moderate: 6,
     high: 6,
 };
-// ── BODY AREAS ───────────────────────────────────────────────────────────────
 exports.AI_BODY_AREAS = [
     "lower back",
     "upper back",
@@ -168,54 +149,19 @@ exports.AI_BODY_AREAS = [
     "chest",
     "core",
 ];
-exports.AI_BODY_AREA_LABELS = {
-    "lower back": "Lower back",
-    "upper back": "Upper back",
-    shoulders: "Shoulder",
-    neck: "Neck",
-    elbows: "Elbow",
-    wrists: "Wrist",
-    hips: "Hip",
-    "hip flexors": "Hip flexor",
-    knees: "Knee",
-    ankles: "Ankle",
-    hamstrings: "Hamstring",
-    "achilles tendon": "Achilles / calf",
-    forearms: "Forearm",
-    groin: "Groin",
-    "calf muscles": "Calf",
-    chest: "Chest",
-    core: "Core / abdomen",
-};
-// ── BODY ISSUE TYPES ─────────────────────────────────────────────────────────
 exports.AI_BODY_ISSUE_TYPES = [
     "general_soreness",
     "joint_pain",
     "old_injury",
     "diagnosed_condition",
 ];
-exports.AI_BODY_ISSUE_LABELS = {
-    general_soreness: "General soreness or tightness",
-    joint_pain: "Joint pain or clicking",
-    old_injury: "Old / healed injury (just to note)",
-    diagnosed_condition: "Doctor-diagnosed condition",
-};
-// ── POPULARITY ───────────────────────────────────────────────────────────────
 exports.AI_POPULAR_THRESHOLD = 75;
-// ── INJURY SEVERITY / INTENSITY ────────────────────────────────────────────────
 exports.AI_INJURY_SEVERITY = [
     "mild",
     "moderate",
     "severe",
     "acute_broken",
 ];
-exports.AI_INJURY_SEVERITY_LABELS = {
-    mild: "Mild (Discomfort / Tightness)",
-    moderate: "Moderate (Painful but manageable)",
-    severe: "Severe (Sharp pain / Limited mobility)",
-    acute_broken: "Acute / Broken (Recent trauma or surgery)",
-};
-// ── INJURY DURATION / AGE ────────────────────────────────────────────────────
 exports.AI_INJURY_DURATION = [
     "1_5_days",
     "1_4_weeks",
@@ -230,14 +176,12 @@ exports.AI_INJURY_DURATION_LABELS = {
     "3_6_months": "3-6 months",
     "6_plus_months": "6+ months (Chronic / Permanent)",
 };
-// ── SLEEP QUALITY ────────────────────────────────────────────────────────────
-exports.AI_SLEEP_QUALITY_OPTIONS = ["good", "disturbed", "poor"];
-exports.AI_SLEEP_QUALITY_LABELS = {
-    good: "Slept well",
-    disturbed: "Lightly disturbed",
-    poor: "Poor sleep",
-};
-// ── USER INTENT CHIPS ────────────────────────────────────────────────────────
+exports.AI_ENERGY_LEVEL_OPTIONS = [
+    "fresh",
+    "normal",
+    "tired",
+    "exhausted",
+];
 exports.AI_INTENT_CHIPS = [
     "leg-day",
     "upper-body",

package/dist/types/TApiAiQuickStartWorkout.d.ts

@@ -1,15 +1,15 @@
-import { TAiIntentChip, TAiSleepQuality } from "../constants/AiExerciseVocabulary";
+import { TAiEnergyLevel, TAiUserInjury } from "../constants/AiExerciseVocabulary";
 import { TTemplate } from "./TApiTemplateData";
 export type TApiAiQuickStartWorkoutReq = {
     /**
      * What the user wants to focus on today.
-     * e.g., "Leg day", "Upper body", "Surprise me"
+     * e.g., "Leg day", "Upper body", "I want 80% back 20% bicep" or "אני רוצה ליבה חזקה"
      */
-    intentChip: TAiIntentChip;
+    intentText: string;
     /**
-     * How the user slept last night. Used by the AI to modulate volume and intensity.
+     * How the user feels right now. Used by the AI to modulate volume and intensity.
      */
-    sleepQuality: TAiSleepQuality;
+    energyLevel: TAiEnergyLevel;
     /**
      * Optional: How much time the user has for the workout.
      * Helps the AI determine the number of exercises and sets.
@@ -20,7 +20,31 @@ export type TApiAiQuickStartWorkoutReq = {
      * Crucial for correctly fetching "yesterday's" workout history from DynamoDB.
      */
     timezone: string;
-    workoutTime: string;
+    /**
+     * Whether the user intends to work out at home or at the gym today.
+     */
+    workoutLocation: "home" | "gym";
+    /**
+     * The general time of day the user is working out.
+     * Can influence warm-up duration and intensity (e.g., morning stiffness vs. evening fatigue, Afternoon: (Peak Performance)).
+     */
+    workoutTime: "morning" | "afternoon" | "evening" | "night";
+};
+export type TAiEnrichedContext = {
+    qdrantFilters: {
+        must: Record<string, any>[];
+        mustNot: Record<string, any>[];
+    };
+    aiContext: {
+        age: number;
+        gender: string;
+        fitnessLevel: string;
+        energyLevel: string;
+        fatigueMap: Record<string, any>;
+        activeInjuries: TAiUserInjury[];
+        avoidedAreas: string[];
+        yesterdaysExercises: string[];
+    };
 };
 export type TApiAiQuickStartWorkoutRes = {
     status: 200;
@@ -32,6 +56,11 @@ export type TApiAiQuickStartWorkoutRes = {
     plan: Extract<TTemplate, {
         type: "ai-generated";
     }>;
+    /**
+     * Debug / Transparency information indicating exactly what filters
+     * and context variables the backend fed into the semantic search and LLM.
+     */
+    enrichedContext: TAiEnrichedContext;
 } | {
     status: 400 | 403 | 500;
     state: "failed" | "unauthorized";

package/dist/types/TApiAuth.d.ts

@@ -1,5 +1,5 @@
-import type { TAiFitnessGoal } from "../constants/AiExerciseVocabulary";
-import { TAuthType, TGender, TProfessionalCategory, TUserMetric, TUserType, TActivityLevel } from "./TApiUser";
+import type { TAiFitnessGoal, TAiBodyArea } from "../constants/AiExerciseVocabulary";
+import { TAuthType, TGender, TProfessionalCategory, TUserMetric, TUserType, TActivityLevel, TInjuryInfo } from "./TApiUser";
 export type TOnboardingData = {
     userWeightKg: number;
     dob: Date;
@@ -9,7 +9,9 @@ export type TOnboardingData = {
     bodyFatPercentage: number;
     fitnessGoals: TAiFitnessGoal[];
     fitnessLevel: TActivityLevel;
-    gdprEssential: boolean;
+    avoidBodyAreas?: TAiBodyArea[];
+    injuryInfo?: TInjuryInfo;
+    gdprEssential?: boolean;
     gdprAnalytics: boolean;
     gdprMarketing: boolean;
     userCode: string;

package/package.json

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