@dgpholdings/greatoak-shared 1.2.69 → 1.2.71

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, TAiUserInjury } 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.
@@ -39,13 +39,16 @@ export type TAiEnrichedContext = {
         age: number;
         gender: string;
         fitnessLevel: string;
-        sleepQuality: string;
+        energyLevel: string;
         fatigueMap: Record<string, any>;
         activeInjuries: TAiUserInjury[];
         avoidedAreas: string[];
         yesterdaysExercises: string[];
     };
 };
+/**
+ * @deprecated This api will be deprecated since Sync api is being replaced with async polling-api which uses TApiJobStatusRes.
+ */
 export type TApiAiQuickStartWorkoutRes = {
     status: 200;
     state: "success";
@@ -66,3 +69,72 @@ export type TApiAiQuickStartWorkoutRes = {
     state: "failed" | "unauthorized";
     message: string;
 };
+/**
+ * Job Status: Where is this job in the pipeline?
+ * - pending: Just created, waiting in queue
+ * - processing: Worker picked it up, working on it
+ * - success: Done! Plan is ready
+ * - failed: Something went wrong
+ */
+export type TJobState = "pending" | "processing" | "success" | "failed" | "timeout";
+/**
+ * Job Record: Stored in DynamoDB
+ * This is what we write to the database when a job is created
+ */
+export interface TQuickStartJob {
+    jobId: string;
+    userId: string;
+    state: TJobState;
+    requestPayload: TApiAiQuickStartWorkoutReq;
+    plan?: Extract<TTemplate, {
+        type: "ai-generated";
+    }>;
+    enrichedContext?: TAiEnrichedContext;
+    errorMessage?: string;
+    createdAt: string;
+    startedAt?: string;
+    completedAt?: string;
+    ttl: number;
+}
+/**
+ * API Response for Job Creation
+ * What we return when someone calls POST /plans/quickstart/jobs-initiate
+ */
+export type TApiCreateJobReq = TApiAiQuickStartWorkoutReq;
+export type TApiCreateJobRes = {
+    jobId: string;
+    state: "pending";
+    message: string;
+    status: 200;
+} | {
+    status: 500;
+    message: string;
+};
+export type TApiJobStatusReq = {
+    jobId: string;
+};
+export type TApiJobStatusRes = {
+    jobId: string;
+    state: TJobState;
+    plan?: Extract<TTemplate, {
+        type: "ai-generated";
+    }>;
+    enrichedContext?: TAiEnrichedContext;
+    errorMessage?: string;
+    createdAt: string;
+    completedAt?: string;
+    status: 200;
+} | {
+    status: 500;
+    message: string;
+};
+/**
+ * Async Quick Start Architecture
+ *
+ * Flow:
+ * 1. Client → POST /plans/quickstart/jobs → TApiCreateJobRes { jobId }
+ * 2. SQS worker processes job in background
+ * 3. Client → GET /plans/quickstart/jobs/{jobId} → TApiJobStatusRes { plan? }
+ *
+ * This replaces the deprecated sync endpoint to avoid API Gateway 29s timeout.
+ */

package/dist/types/TApiAiQuickStartWorkout.js

@@ -1,2 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Async Quick Start Architecture
+ *
+ * Flow:
+ * 1. Client → POST /plans/quickstart/jobs → TApiCreateJobRes { jobId }
+ * 2. SQS worker processes job in background
+ * 3. Client → GET /plans/quickstart/jobs/{jobId} → TApiJobStatusRes { plan? }
+ *
+ * This replaces the deprecated sync endpoint to avoid API Gateway 29s timeout.
+ */

package/package.json

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