@dgpholdings/greatoak-shared 1.2.77 → 1.2.81

package/dist/__mocks__/user.mock.js

@@ -3,10 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.mockUser = void 0;
 exports.mockUser = {
     // TUserPreferences fields (flat in TUserMetric)
-    trainingLocation: "gym",
     preferredDurationMinutes: 45,
     fitnessGoals: ["hypertrophy"],
-    preferredEquipment: ["weights"],
+    preferredEquipment: ["dumbbell", "barbell"],
     preferCompoundMovements: true,
     includeWarmup: "ai_decide",
     includeCooldown: "ai_decide",

package/dist/constants/AiExerciseVocabulary.d.ts

@@ -3,6 +3,9 @@ export type TAiFitnessGoal = (typeof AI_FITNESS_GOALS)[number];
 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[];
+export declare const AI_QUICKSTART_EQUIPMENT_GROUPS_LIST: readonly ["gym_machines", "gym_equipment", "home_equipment", "no_equipment"];
+export type TQuickStartEquipmentGroupExplicit = (typeof AI_QUICKSTART_EQUIPMENT_GROUPS_LIST)[number];
+export declare const AI_QUICKSTART_EQUIPMENT_GROUPS: Record<TQuickStartEquipmentGroupExplicit, TAiEquipmentType[]>;
 export declare const AI_MOVEMENT_PATTERNS: readonly ["push_horizontal", "push_vertical", "pull_horizontal", "pull_vertical", "squat", "hinge", "lunge", "rotation", "carry", "isolation", "plyo", "cardio", "mobility", "balance", "core_stability"];
 export type TAiMovementPattern = (typeof AI_MOVEMENT_PATTERNS)[number];
 export declare const AI_PUSH_PATTERNS: TAiMovementPattern[];

package/dist/constants/AiExerciseVocabulary.js

@@ -7,7 +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_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_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_QUICKSTART_EQUIPMENT_GROUPS = exports.AI_QUICKSTART_EQUIPMENT_GROUPS_LIST = exports.AI_HOME_EQUIPMENT = exports.AI_EQUIPMENT_TYPES = exports.AI_FITNESS_GOALS = void 0;
 exports.AI_FITNESS_GOALS = [
     "strength",
     "hypertrophy",
@@ -53,6 +53,36 @@ exports.AI_HOME_EQUIPMENT = [
     "exercise_ball",
     "jump_rope",
 ];
+// Quick Start equipment groups
+// Coarse buckets exposed in the Quick Start UI. Each maps to a set of
+// TAiEquipmentType values that match Qdrant payload `equipment.primary`.
+// "preferences" is modelled separately as the discriminated alternative
+// (defer to user's saved preferredEquipment), so it is NOT in this map.
+exports.AI_QUICKSTART_EQUIPMENT_GROUPS_LIST = [
+    "gym_machines",
+    "gym_equipment",
+    "home_equipment",
+    "no_equipment",
+];
+exports.AI_QUICKSTART_EQUIPMENT_GROUPS = {
+    gym_machines: [
+        "cable_machine",
+        "standard_machine",
+        "smith_machine",
+        "niche_machine",
+        "cardio_machine",
+    ],
+    gym_equipment: [
+        "barbell",
+        "ez_bar",
+        "dumbbell",
+        "kettlebell",
+        "weight_plate",
+        "bench",
+    ],
+    home_equipment: ["dumbbell", "kettlebell", "resistance_band", "bench"],
+    no_equipment: ["none"],
+};
 exports.AI_MOVEMENT_PATTERNS = [
     "push_horizontal",
     "push_vertical",

package/dist/types/TApiAiQuickStartWorkout.d.ts

@@ -1,4 +1,4 @@
-import { TAiEnergyLevel, TAiUserInjury } from "../constants/AiExerciseVocabulary";
+import { TAiEnergyLevel, TAiUserInjury, TQuickStartEquipmentGroupExplicit } from "../constants/AiExerciseVocabulary";
 import { TTemplate } from "./TApiTemplateData";
 export type TApiAiQuickStartWorkoutReq = {
     /**
@@ -13,6 +13,7 @@ export type TApiAiQuickStartWorkoutReq = {
     /**
      * Optional: How much time the user has for the workout.
      * Helps the AI determine the number of exercises and sets.
+     * If not provided, defaults to user's saved preferredDurationMinutes preference.
      */
     availableTimeMinutes?: number;
     /**
@@ -20,15 +21,53 @@ export type TApiAiQuickStartWorkoutReq = {
      * Crucial for correctly fetching "yesterday's" workout history from DynamoDB.
      */
     timezone: 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";
+    /**
+     * Optional: Female health context override for this specific workout.
+     * Indicates if the user is on their period today, which helps the AI:
+     * - Adjust workout intensity and volume appropriately
+     * - Include more stretching and mobility work
+     * - Avoid high-impact movements if needed
+     * - Consider energy levels more conservatively
+     *
+     * If provided, this overrides the user's saved femaleHealth.isOnPeriod preference for this workout only.
+     * If not provided, the worker will use the value from the user's profile.
+     *
+     * Note: This is a session-level override. The createJobController will optionally sync this
+     * value back to the user's profile asynchronously (fire-and-forget) to keep preferences in sync,
+     * but the job creation and processing are not dependent on this sync succeeding.
+     */
+    isOnPeriod?: boolean;
+    /**
+     * Equipment selection for this workout session.
+     *
+     * Two mutually-exclusive modes (enforced by the discriminated union):
+     *
+     * 1. `{ type: "preferences" }`
+     *    Defer to the user's saved `preferredEquipment` on their profile.
+     *    Default selection in the frontend.
+     *
+     * 2. `{ type: "groups", groups: [...] }`
+     *    Explicit session-level override. Each group maps to a set of
+     *    `TAiEquipmentType` values via `AI_QUICKSTART_EQUIPMENT_GROUPS`.
+     *    Multi-select; the backend takes the union of all groups' equipment.
+     *    Must contain at least one group (enforced at API edge).
+     *
+     * Empty-result policy: if the resolved equipment set is empty (e.g. user
+     * picked "preferences" but profile has no preferredEquipment yet), the
+     * backend treats it as "no equipment filter" — i.e. all candidates eligible.
+     */
+    equipmentSelectionOverride: TQuickStartEquipmentSelection;
+};
+export type TQuickStartEquipmentSelection = {
+    type: "preferences";
+} | {
+    type: "groups";
+    groups: TQuickStartEquipmentGroupExplicit[];
 };
 export type TAiEnrichedContext = {
     qdrantFilters: {
@@ -47,6 +86,8 @@ export type TAiEnrichedContext = {
         activeInjuries: TAiUserInjury[];
         avoidedAreas: string[];
         yesterdaysExercises: string[];
+        isOnPeriod?: boolean;
+        availableTimeMinutes?: number;
     };
 };
 /**

package/dist/types/TApiAuth.d.ts

@@ -33,7 +33,6 @@ export type TOnboardingData = {
 export type TApiSignupAnonymousReq = Omit<TOnboardingData, "userCode"> & {
     model: string;
     deviceUniqueId: string;
-    trainingLocation?: TStablePreferences["trainingLocation"];
     preferredDurationMinutes?: TStablePreferences["preferredDurationMinutes"];
     preferredEquipment?: TStablePreferences["preferredEquipment"];
     preferCompoundMovements?: TStablePreferences["preferCompoundMovements"];

package/dist/types/TUserPreferences.d.ts

@@ -1,15 +1,12 @@
-import { TAiFitnessGoal } from "../constants";
+import { TAiEquipmentType, TAiFitnessGoal } from "../constants";
 import { TBodyPart } from "./TApiExercise";
-export type TTrainingLocation = "gym" | "home" | "both";
 export type TPreferredDuration = 20 | 30 | 45 | 60 | 90 | 120;
 export type TAIDecision = "yes" | "no" | "ai_decide";
 export type TWarmupStyle = "dynamic_stretching" | "light_cardio";
-export type TPreferredEquipment = "machines" | "weights" | "free_hand";
 export type TStablePreferences = {
-    trainingLocation: TTrainingLocation;
     preferredDurationMinutes: TPreferredDuration;
     fitnessGoals: TAiFitnessGoal[];
-    preferredEquipment: TPreferredEquipment[];
+    preferredEquipment: TAiEquipmentType[];
     preferCompoundMovements: boolean;
     includeWarmup: TAIDecision;
     includeCooldown: TAIDecision;

package/dist/utils/time.util.js

@@ -25,15 +25,7 @@ const getDaysAndHoursDifference = ({ oldDate, newDate, }) => {
 };
 exports.getDaysAndHoursDifference = getDaysAndHoursDifference;
 const isUserAllowedToUpdate = ({ createdAt, updatedAt }) => {
-    const now = new Date();
-    const sinceLastUpdated = (0, exports.getDaysAndHoursDifference)({
-        oldDate: updatedAt,
-        newDate: now,
-    });
-    const diffUserCreationAndLastUpdate = (0, exports.getDaysAndHoursDifference)({
-        oldDate: createdAt,
-        newDate: updatedAt,
-    });
-    return diffUserCreationAndLastUpdate.hours <= 1 || sinceLastUpdated.hours > 8;
+    // Time restriction removed - users can always update their profile
+    return true;
 };
 exports.isUserAllowedToUpdate = isUserAllowedToUpdate;

package/package.json

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