hevy-shared 1.0.917 → 1.0.918

package/built/adminPermissions.d.ts

@@ -1,4 +1,4 @@
 import { Lookup } from './typeUtils';
-export declare const AdminPermissions: readonly ["become_user", "ip_blacklists", "featured_users", "feature_flags", "hevy_trainer", "user_account_management", "import_strong_csv", "community_management", "user_app_logs", "backend_maintenance"];
+export declare const AdminPermissions: readonly ["become_user", "ip_blacklists", "featured_users", "feature_flags", "hevy_trainer", "user_account_management", "import_strong_csv", "community_management", "user_app_logs"];
 export type AdminPermission = Lookup<typeof AdminPermissions>;
 export declare const isAdminPermission: (permission?: any) => permission is AdminPermission;

package/built/adminPermissions.js

@@ -11,7 +11,6 @@ exports.AdminPermissions = [
     'import_strong_csv',
     'community_management',
     'user_app_logs',
-    'backend_maintenance',
 ];
 const isAdminPermission = (permission) => {
     if (!permission || typeof permission !== 'string') {

package/built/hevyTrainer.d.ts

@@ -1,16 +1,26 @@
-import { WeeklyTrainingFrequency, TrainingGoal, TrainingLevel, Equipment, SimplifiedMuscleGroup, MuscleGroup, LibraryExercise, ExerciseCategory } from '.';
+import { WeeklyTrainingFrequency, TrainingGoal, TrainingLevel, SimplifiedMuscleGroup, MuscleGroup, LibraryExercise, ExerciseCategory, GranularEquipment, HevyTrainerProgramEquipment } from '.';
 export type HevyTrainerExerciseCategory = typeof hevyTrainerExerciseCategories[number];
 export type HevyTrainerRoutineName = typeof routineNames[number];
-export type HevyTrainerProgramEquipment = Extract<Equipment, 'barbell' | 'dumbbell' | 'machine'>;
-export declare const hevyTrainerExerciseCategories: readonly ["compound", "isolation"];
-export type WorkoutDurationMinutes = typeof workoutDurationOptions[number];
 export declare const workoutDurationOptions: readonly [40, 60, 80];
+export type WorkoutDurationMinutes = typeof workoutDurationOptions[number];
+export declare const trainerGymTypes: readonly ["home_gym", "garage_gym", "commercial_gym", "full_gym"];
+export type TrainerGymType = typeof trainerGymTypes[number];
+export declare const granularEquipmentDefaults: {
+    [key in TrainerGymType]: GranularEquipment[];
+};
+export declare const trainerEquipmentToGranularEquipments: (equipments: HevyTrainerProgramEquipment[]) => GranularEquipment[];
+/**
+ * Converts granular equipment values back to the old HevyTrainerProgramEquipment
+ * types for backwards compatibility with old mobile clients.
+ */
+export declare const granularEquipmentsToTrainerEquipments: (granularEquipments: GranularEquipment[]) => HevyTrainerProgramEquipment[];
+export declare const hevyTrainerExerciseCategories: readonly ["compound", "isolation"];
 export declare const defaultDurationPerFrequency: Record<WeeklyTrainingFrequency, WorkoutDurationMinutes>;
 export declare const routineNames: readonly ["full_body_1", "full_body_2_a", "full_body_2_b", "full_body_3_a", "full_body_3_b", "full_body_3_c", "upper_1_a", "lower_1_a", "upper_1_b", "lower_1_b", "push_1", "pull_1", "legs_1", "upper_2", "lower_2", "push_2_a", "pull_2_a", "legs_2_a", "push_2_b", "pull_2_b", "legs_2_b"];
 export type exerciseId = string;
 export interface ExerciseSelectionCriteria {
     exerciseCategory: HevyTrainerExerciseCategory | 'all';
-    equipments: HevyTrainerProgramEquipment[];
+    equipments: GranularEquipment[];
     routineBarbellExerciseCount: number;
     level: TrainingLevel;
     goal: TrainingGoal;
@@ -32,7 +42,7 @@ export interface ProgramGenerationParams<T extends HevyTrainerLibraryExercise> {
     selectedDays: WeeklyTrainingFrequency;
     selectedGoal: TrainingGoal;
     selectedLevel: TrainingLevel;
-    selectedEquipments: HevyTrainerProgramEquipment[];
+    selectedEquipments: GranularEquipment[];
     selectedWorkoutDurationMinutes?: WorkoutDurationMinutes;
     exerciseStore: T[];
     focusMuscle?: SimplifiedMuscleGroup;
@@ -137,6 +147,13 @@ export declare const normalizeExerciseCategory: (exercise: {
     is_custom: boolean;
     category?: ExerciseCategory;
 }) => HevyTrainerExerciseCategory;
+/**
+ * Checks if an exercise is compatible with the user's selected granular equipments
+ *
+ * - If the exercise has no granular equipments, it is compatible no matter what the user has selected
+ * - Otherwise, the exercise is only allowed if the user has all the granular equipments
+ */
+export declare const isEquipmentCompatible: (exercise: HevyTrainerLibraryExercise, userSelectedGranularEquipments: GranularEquipment[]) => boolean;
 /**
  * Sorts exercises by priority for each muscle group based on the provided priorities
  * and adds any remaining exercises from the store that weren't in the priorities.
@@ -150,7 +167,7 @@ export declare const getPrioritySortedExercises: <T extends HevyTrainerLibraryEx
  * Selects the best exercise for a given prescription using a multi-pass strategy
  */
 export declare const pickExerciseForPrescription: <T extends HevyTrainerLibraryExercise>(params: ExerciseSelectionParams<T>) => T | undefined;
-export type HevyTrainerLibraryExercise = Pick<LibraryExercise, 'id' | 'title' | 'priority' | 'muscle_group' | 'other_muscles' | 'exercise_type' | 'equipment_category' | 'category' | 'level' | 'goal'>;
+export type HevyTrainerLibraryExercise = Pick<LibraryExercise, 'id' | 'title' | 'priority' | 'muscle_group' | 'other_muscles' | 'exercise_type' | 'equipment_category' | 'category' | 'level' | 'goal' | 'granular_equipments'>;
 export interface ExercisePrescriptionError {
     type: 'exercise_not_found';
     prescription: ExercisePrescription;
@@ -158,7 +175,7 @@ export interface ExercisePrescriptionError {
     context: {
         goal: TrainingGoal;
         level: TrainingLevel;
-        equipments: HevyTrainerProgramEquipment[];
+        equipments: GranularEquipment[];
         focusMuscle?: SimplifiedMuscleGroup;
     };
 }

package/built/hevyTrainer.js

@@ -1,10 +1,146 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateProgram = exports.pickExerciseForPrescription = exports.getPrioritySortedExercises = exports.normalizeExerciseCategory = exports.getTrainerRestTimerSeconds = exports.getTrainerRepRange = exports.getTrainerSetCount = exports.programSplits = exports.frequencyMap = exports.routineNames = exports.defaultDurationPerFrequency = exports.workoutDurationOptions = exports.hevyTrainerExerciseCategories = void 0;
+exports.generateProgram = exports.pickExerciseForPrescription = exports.getPrioritySortedExercises = exports.isEquipmentCompatible = exports.normalizeExerciseCategory = exports.getTrainerRestTimerSeconds = exports.getTrainerRepRange = exports.getTrainerSetCount = exports.programSplits = exports.frequencyMap = exports.routineNames = exports.defaultDurationPerFrequency = exports.hevyTrainerExerciseCategories = exports.granularEquipmentsToTrainerEquipments = exports.trainerEquipmentToGranularEquipments = exports.granularEquipmentDefaults = exports.trainerGymTypes = exports.workoutDurationOptions = void 0;
 const _1 = require(".");
 const MAX_BARBELL_EXERCISES_PER_ROUTINE = 2;
-exports.hevyTrainerExerciseCategories = ['compound', 'isolation'];
 exports.workoutDurationOptions = [40, 60, 80];
+exports.trainerGymTypes = [
+    'home_gym',
+    'garage_gym',
+    'commercial_gym',
+    'full_gym',
+];
+exports.granularEquipmentDefaults = {
+    home_gym: ['dumbbell', 'pullup_bar', 'adjustable_bench'],
+    garage_gym: [
+        'dumbbell',
+        'kettlebell',
+        'barbell',
+        'plate',
+        'pullup_bar',
+        'dip_bar',
+        'squat_rack',
+        'adjustable_bench',
+        'spinning',
+    ],
+    commercial_gym: [
+        'dumbbell',
+        'barbell',
+        'plate',
+        'ez_bar',
+        'pullup_bar',
+        'dip_bar',
+        'squat_rack',
+        'adjustable_bench',
+        'single_cable_machine',
+        'lat_pulldown_cable',
+        'leg_press_machine',
+        'smith_machine',
+        'stack_machines',
+        'treadmill',
+        'elliptical_trainer',
+        'spinning',
+    ],
+    // All equipment is available in a full gym
+    full_gym: [
+        'barbell',
+        'dumbbell',
+        'kettlebell',
+        'plate',
+        'medicine_ball',
+        'ez_bar',
+        'landmine',
+        'trap_bar',
+        'pullup_bar',
+        'dip_bar',
+        'squat_rack',
+        'flat_bench',
+        'adjustable_bench',
+        'dual_cable_machine',
+        'single_cable_machine',
+        'lat_pulldown_cable',
+        'leg_press_machine',
+        'smith_machine',
+        't_bar',
+        'plate_machines',
+        'stack_machines',
+        'treadmill',
+        'elliptical_trainer',
+        'rowing_machine',
+        'spinning',
+        'stair_machine',
+        'air_bike',
+        'suspension_band',
+        'battle_rope',
+        'rings',
+        'jump_rope',
+    ],
+};
+const trainerEquipmentToGranularEquipmentsMap = {
+    barbell: [
+        'adjustable_bench',
+        'barbell',
+        'ez_bar',
+        'flat_bench',
+        'landmine',
+        'plate',
+        'squat_rack',
+        't_bar',
+    ],
+    dumbbell: ['adjustable_bench', 'dumbbell', 'flat_bench'],
+    machine: [
+        'adjustable_bench',
+        'dip_bar',
+        'dual_cable_machine',
+        'flat_bench',
+        'lat_pulldown_cable',
+        'leg_press_machine',
+        'plate',
+        'plate_machines',
+        'pullup_bar',
+        'single_cable_machine',
+        'smith_machine',
+        'stack_machines',
+    ],
+};
+const trainerEquipmentToGranularEquipments = (equipments) => {
+    const granularEquipments = [];
+    equipments.forEach((equipment) => {
+        granularEquipments.push(...trainerEquipmentToGranularEquipmentsMap[equipment]);
+    });
+    return Array.from(new Set(granularEquipments));
+};
+exports.trainerEquipmentToGranularEquipments = trainerEquipmentToGranularEquipments;
+const MACHINE_SPECIFIC_GRANULAR_EQUIPMENTS = [
+    'smith_machine',
+    'leg_press_machine',
+    'dual_cable_machine',
+    'single_cable_machine',
+    'lat_pulldown_cable',
+    'plate_machines',
+    'stack_machines',
+    'dip_bar',
+    'pullup_bar',
+];
+/**
+ * Converts granular equipment values back to the old HevyTrainerProgramEquipment
+ * types for backwards compatibility with old mobile clients.
+ */
+const granularEquipmentsToTrainerEquipments = (granularEquipments) => {
+    const result = [];
+    if (granularEquipments.includes('barbell')) {
+        result.push('barbell');
+    }
+    if (granularEquipments.includes('dumbbell')) {
+        result.push('dumbbell');
+    }
+    if (granularEquipments.some((eq) => MACHINE_SPECIFIC_GRANULAR_EQUIPMENTS.includes(eq))) {
+        result.push('machine');
+    }
+    return result;
+};
+exports.granularEquipmentsToTrainerEquipments = granularEquipmentsToTrainerEquipments;
+exports.hevyTrainerExerciseCategories = ['compound', 'isolation'];
 // These are the values that Philip decided for the default duration per frequency
 exports.defaultDurationPerFrequency = {
     1: 80,
@@ -120,19 +256,28 @@ const isFocusMuscleExtraExerciseAllowed = (templateName, focusMuscle) => {
     }
 };
 /**
- * Checks if an exercise is compatible with the user's equipments
+ * Checks if an exercise is compatible with the user's selected granular equipments
  *
- * - We enable plate exercises where users have barbell as an equipment
- * - None and other equipment categories are also always allowed
- * - Otherwise, the exercise is only allowed if the user has that equipment
+ * - If the exercise has no granular equipments, it is compatible no matter what the user has selected
+ * - Otherwise, the exercise is only allowed if the user has all the granular equipments
  */
-const isEquipmentCompatible = (exercise, allowedEquipments) => {
-    return (allowedEquipments.includes(exercise.equipment_category) ||
-        exercise.equipment_category === 'none' ||
-        exercise.equipment_category === 'other' ||
-        (exercise.equipment_category === 'plate' &&
-            allowedEquipments.includes('barbell')));
+const isEquipmentCompatible = (exercise, userSelectedGranularEquipments) => {
+    if (!exercise.granular_equipments ||
+        exercise.granular_equipments.length === 0) {
+        return true;
+    }
+    const allowedEquipments = [...userSelectedGranularEquipments];
+    // Special case: adjustable bench can substitute for flat bench
+    if (userSelectedGranularEquipments.includes('adjustable_bench')) {
+        allowedEquipments.push('flat_bench');
+    }
+    // Special case: dual cable machine can substitute for single cable machine
+    if (userSelectedGranularEquipments.includes('dual_cable_machine')) {
+        allowedEquipments.push('single_cable_machine');
+    }
+    return exercise.granular_equipments.every((granularEquipment) => allowedEquipments.includes(granularEquipment));
 };
+exports.isEquipmentCompatible = isEquipmentCompatible;
 /**
  * Checks if the routine barbell exercise limit is exceeded
  *
@@ -232,7 +377,7 @@ const isExerciseMatch = (exercise, criteria) => {
             criteria.exerciseCategory === 'compound');
     const levelMatch = (_b = (_a = exercise.level) === null || _a === void 0 ? void 0 : _a.includes(criteria.level)) !== null && _b !== void 0 ? _b : false;
     const goalMatch = (_d = (_c = exercise.goal) === null || _c === void 0 ? void 0 : _c.includes(criteria.goal)) !== null && _d !== void 0 ? _d : false;
-    const equipmentMatch = isEquipmentCompatible(exercise, criteria.equipments);
+    const equipmentMatch = (0, exports.isEquipmentCompatible)(exercise, criteria.equipments);
     const barbellLimitOk = !isBarbellLimitExceeded(exercise, criteria.routineBarbellExerciseCount, criteria.equipments);
     return (categoryMatch && levelMatch && goalMatch && equipmentMatch && barbellLimitOk);
 };
@@ -243,7 +388,7 @@ const isAlternativeIsolationExerciseMatch = (exercise, criteria) => {
     var _a, _b;
     const isIsolationCategory = criteria.exerciseCategory === 'isolation';
     const isAlternativeExercise = isolationExerciseAlternatives[criteria.muscleGroup].includes(exercise.id);
-    const equipmentMatch = isEquipmentCompatible(exercise, criteria.equipments);
+    const equipmentMatch = (0, exports.isEquipmentCompatible)(exercise, criteria.equipments);
     const levelMatch = (_b = (_a = exercise.level) === null || _a === void 0 ? void 0 : _a.includes(criteria.level)) !== null && _b !== void 0 ? _b : false;
     return (isIsolationCategory && isAlternativeExercise && equipmentMatch && levelMatch);
 };

package/built/index.d.ts

@@ -647,6 +647,9 @@ export type TrainingLevel = Lookup<typeof trainingLevels>;
 export type ExerciseCategory = Lookup<typeof exerciseCategories>;
 export type HevyTrainerProgramEquipment = Extract<Equipment, 'barbell' | 'dumbbell' | 'machine'>;
 export declare const hevyTrainerProgramEquipments: readonly ["barbell", "dumbbell", "machine"];
+export declare const granularEquipments: readonly ["barbell", "dumbbell", "kettlebell", "plate", "medicine_ball", "ez_bar", "landmine", "trap_bar", "pullup_bar", "dip_bar", "squat_rack", "flat_bench", "adjustable_bench", "dual_cable_machine", "single_cable_machine", "lat_pulldown_cable", "leg_press_machine", "smith_machine", "t_bar", "plate_machines", "stack_machines", "treadmill", "elliptical_trainer", "rowing_machine", "spinning", "stair_machine", "air_bike", "suspension_band", "resistance_band", "battle_rope", "rings", "jump_rope"];
+export type GranularEquipment = Lookup<typeof granularEquipments>;
+export declare const isGranularEquipment: (x: string) => x is GranularEquipment;
 export declare const weeklyTrainingFrequencies: readonly [1, 2, 3, 4, 5, 6];
 export type WeeklyTrainingFrequency = Lookup<typeof weeklyTrainingFrequencies>;
 /**
@@ -698,6 +701,7 @@ export interface LibraryExercise extends BaseExerciseTemplate {
     goal: TrainingGoal[] | undefined;
     level: TrainingLevel[] | undefined;
     category: ExerciseCategory | undefined;
+    granular_equipments: GranularEquipment[] | undefined;
     url_female?: string;
     thumbnail_url_female?: string;
 }
@@ -1251,7 +1255,7 @@ export interface HevyTrainerProgram {
     title: string;
     level: TrainingLevel;
     goal: TrainingGoal;
-    equipments: HevyTrainerProgramEquipment[];
+    equipments: GranularEquipment[];
     weekly_frequency: WeeklyTrainingFrequency;
     routines: HevyTrainerRoutine[];
     focus_muscle?: SimplifiedMuscleGroup;
@@ -1263,7 +1267,7 @@ export interface PostHevyTrainerProgramRequestBody {
         title: string;
         level: TrainingLevel;
         goal: TrainingGoal;
-        equipments: HevyTrainerProgramEquipment[];
+        equipments: GranularEquipment[];
         weekly_frequency: WeeklyTrainingFrequency;
         focus_muscle?: SimplifiedMuscleGroup;
         routines: RoutineUpdate[];
@@ -1272,6 +1276,55 @@ export interface PostHevyTrainerProgramRequestBody {
     };
 }
 export interface UpdateHevyTrainerProgramRequestBody {
+    program: {
+        programId: string;
+        title: string;
+        level: TrainingLevel;
+        goal: TrainingGoal;
+        equipments: GranularEquipment[];
+        weekly_frequency: WeeklyTrainingFrequency;
+        focus_muscle?: SimplifiedMuscleGroup;
+        next_workout_index?: number;
+        workout_duration_minutes?: WorkoutDurationMinutes;
+        routines: {
+            id: string;
+            title: string;
+            notes: string | null;
+            exercises: RoutineUpdateExercise[];
+        }[];
+    };
+}
+/** @deprecated Use HevyTrainerProgram instead */
+export interface HevyTrainerProgramOld {
+    id: string;
+    created_at: string;
+    updated_at: string;
+    title: string;
+    level: TrainingLevel;
+    goal: TrainingGoal;
+    equipments: HevyTrainerProgramEquipment[];
+    weekly_frequency: WeeklyTrainingFrequency;
+    routines: HevyTrainerRoutine[];
+    focus_muscle?: SimplifiedMuscleGroup;
+    next_workout_index: number;
+    workout_duration_minutes?: WorkoutDurationMinutes;
+}
+/** @deprecated Use PostHevyTrainerProgramRequestBody instead */
+export interface PostHevyTrainerProgramOldRequestBody {
+    program: {
+        title: string;
+        level: TrainingLevel;
+        goal: TrainingGoal;
+        equipments: HevyTrainerProgramEquipment[];
+        weekly_frequency: WeeklyTrainingFrequency;
+        focus_muscle?: SimplifiedMuscleGroup;
+        routines: RoutineUpdate[];
+        next_workout_index?: number;
+        workout_duration_minutes?: WorkoutDurationMinutes;
+    };
+}
+/** @deprecated Use UpdateHevyTrainerProgramRequestBody instead */
+export interface UpdateHevyTrainerProgramOldRequestBody {
     program: {
         programId: string;
         title: string;

package/built/index.js

@@ -14,8 +14,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isHevyTrainerRoutine = exports.isWorkoutBiometrics = exports.isHeartRateSamples = exports.isPublicWorkout = exports.isSetType = exports.isRPE = exports.validRpeValues = exports.isSetPersonalRecordType = exports.supportedInstructionsLanguages = exports.weeklyTrainingFrequencies = exports.hevyTrainerProgramEquipments = exports.exerciseCategories = exports.trainingLevels = exports.trainingGoals = exports.isCustomExerciseType = exports.customExericseTypes = exports.isExerciseType = exports.exerciseTypes = exports.isExerciseRepType = exports.exerciseRepTypes = exports.isEquipmentFilter = exports.equipmentFilters = exports.isEquipment = exports.equipments = exports.simplifiedMuscleGroupToMuscleGroups = exports.isMuscleGroupFilter = exports.muscleGroupFilters = exports.isMuscleGroup = exports.muscleGroups = exports.isSimplifiedMuscleGroup = exports.simplifiedMuscleGroups = exports.miscellaneousMuscles = exports.chestMuscles = exports.backMuscles = exports.legMuscles = exports.armMuscles = exports.shoulderMuscles = exports.coreMuscles = exports.DefaultClientConfiguration = exports.parseClientAuthTokenResponse = exports.isCoachRole = exports.isErrorResponse = exports.isLivePRVolumeOption = exports.isTimerVolumeOption = exports.isWeekday = exports.orderedWeekdays = exports.isBodyMeasurementUnit = exports.isDistanceUnitShort = exports.isDistanceUnit = exports.isWeightUnit = void 0;
-exports.isOAuthScope = exports.supportedScopes = exports.isSuggestedUserSource = exports.isValidUserWorkoutMetricsType = exports.isBodyMeasurementKey = exports.measurementsList = void 0;
+exports.isHeartRateSamples = exports.isPublicWorkout = exports.isSetType = exports.isRPE = exports.validRpeValues = exports.isSetPersonalRecordType = exports.supportedInstructionsLanguages = exports.weeklyTrainingFrequencies = exports.isGranularEquipment = exports.granularEquipments = exports.hevyTrainerProgramEquipments = exports.exerciseCategories = exports.trainingLevels = exports.trainingGoals = exports.isCustomExerciseType = exports.customExericseTypes = exports.isExerciseType = exports.exerciseTypes = exports.isExerciseRepType = exports.exerciseRepTypes = exports.isEquipmentFilter = exports.equipmentFilters = exports.isEquipment = exports.equipments = exports.simplifiedMuscleGroupToMuscleGroups = exports.isMuscleGroupFilter = exports.muscleGroupFilters = exports.isMuscleGroup = exports.muscleGroups = exports.isSimplifiedMuscleGroup = exports.simplifiedMuscleGroups = exports.miscellaneousMuscles = exports.chestMuscles = exports.backMuscles = exports.legMuscles = exports.armMuscles = exports.shoulderMuscles = exports.coreMuscles = exports.DefaultClientConfiguration = exports.parseClientAuthTokenResponse = exports.isCoachRole = exports.isErrorResponse = exports.isLivePRVolumeOption = exports.isTimerVolumeOption = exports.isWeekday = exports.orderedWeekdays = exports.isBodyMeasurementUnit = exports.isDistanceUnitShort = exports.isDistanceUnit = exports.isWeightUnit = void 0;
+exports.isOAuthScope = exports.supportedScopes = exports.isSuggestedUserSource = exports.isValidUserWorkoutMetricsType = exports.isBodyMeasurementKey = exports.measurementsList = exports.isHevyTrainerRoutine = exports.isWorkoutBiometrics = void 0;
 const typeUtils_1 = require("./typeUtils");
 __exportStar(require("./constants"), exports);
 __exportStar(require("./utils"), exports);
@@ -232,6 +232,42 @@ exports.hevyTrainerProgramEquipments = [
     'dumbbell',
     'machine',
 ];
+exports.granularEquipments = [
+    'barbell',
+    'dumbbell',
+    'kettlebell',
+    'plate',
+    'medicine_ball',
+    'ez_bar',
+    'landmine',
+    'trap_bar',
+    'pullup_bar',
+    'dip_bar',
+    'squat_rack',
+    'flat_bench',
+    'adjustable_bench',
+    'dual_cable_machine',
+    'single_cable_machine',
+    'lat_pulldown_cable',
+    'leg_press_machine',
+    'smith_machine',
+    't_bar',
+    'plate_machines',
+    'stack_machines',
+    'treadmill',
+    'elliptical_trainer',
+    'rowing_machine',
+    'spinning',
+    'stair_machine',
+    'air_bike',
+    'suspension_band',
+    'resistance_band',
+    'battle_rope',
+    'rings',
+    'jump_rope',
+];
+const isGranularEquipment = (x) => (0, typeUtils_1.isInArray)(x, exports.granularEquipments);
+exports.isGranularEquipment = isGranularEquipment;
 exports.weeklyTrainingFrequencies = [1, 2, 3, 4, 5, 6];
 exports.supportedInstructionsLanguages = [
     'en',

package/built/tests/hevyTrainer.test.d.ts

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

package/built/tests/hevyTrainer.test.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const hevyTrainer_1 = require("../hevyTrainer");
+const sortGranular = (arr) => [...arr].sort();
+describe('trainerEquipmentToGranularEquipments', () => {
+    it('returns empty array when no equipments are provided', () => {
+        expect((0, hevyTrainer_1.trainerEquipmentToGranularEquipments)([])).toEqual([]);
+    });
+    it('returns expected granular equipments for barbell only', () => {
+        const result = (0, hevyTrainer_1.trainerEquipmentToGranularEquipments)(['barbell']);
+        expect(sortGranular(result)).toEqual(sortGranular([
+            'adjustable_bench',
+            'barbell',
+            'ez_bar',
+            'flat_bench',
+            'landmine',
+            'plate',
+            'squat_rack',
+            't_bar',
+        ]));
+    });
+    it('returns expected granular equipments for dumbbell only', () => {
+        const result = (0, hevyTrainer_1.trainerEquipmentToGranularEquipments)(['dumbbell']);
+        expect(sortGranular(result)).toEqual(sortGranular(['adjustable_bench', 'dumbbell', 'flat_bench']));
+    });
+    it('returns expected granular equipments for machine only', () => {
+        const result = (0, hevyTrainer_1.trainerEquipmentToGranularEquipments)(['machine']);
+        expect(sortGranular(result)).toEqual(sortGranular([
+            'adjustable_bench',
+            'dip_bar',
+            'dual_cable_machine',
+            'flat_bench',
+            'lat_pulldown_cable',
+            'leg_press_machine',
+            'plate',
+            'plate_machines',
+            'pullup_bar',
+            'single_cable_machine',
+            'smith_machine',
+            'stack_machines',
+        ]));
+    });
+    it('returns deduped union for multiple equipments', () => {
+        const equipments = ['barbell', 'dumbbell'];
+        const result = (0, hevyTrainer_1.trainerEquipmentToGranularEquipments)(equipments);
+        const barbellOnly = (0, hevyTrainer_1.trainerEquipmentToGranularEquipments)(['barbell']);
+        const dumbbellOnly = (0, hevyTrainer_1.trainerEquipmentToGranularEquipments)(['dumbbell']);
+        const combined = sortGranular(Array.from(new Set([...barbellOnly, ...dumbbellOnly])));
+        expect(sortGranular(result)).toEqual(combined);
+    });
+});
+const createExercise = (granularEquipments) => ({
+    id: 'test-exercise',
+    title: 'Test Exercise',
+    granular_equipments: granularEquipments,
+});
+describe('isEquipmentCompatible', () => {
+    it('returns true when exercise has no granular equipments', () => {
+        const exercise = createExercise(undefined);
+        expect((0, hevyTrainer_1.isEquipmentCompatible)(exercise, ['barbell'])).toBe(true);
+    });
+    it('returns true when exercise has empty granular equipments', () => {
+        const exercise = createExercise([]);
+        expect((0, hevyTrainer_1.isEquipmentCompatible)(exercise, ['barbell'])).toBe(true);
+    });
+    it('returns true when user has all required equipments', () => {
+        const exercise = createExercise(['barbell', 'squat_rack']);
+        expect((0, hevyTrainer_1.isEquipmentCompatible)(exercise, ['barbell', 'squat_rack'])).toBe(true);
+    });
+    it('returns false when user is missing required equipment', () => {
+        const exercise = createExercise(['barbell', 'squat_rack']);
+        expect((0, hevyTrainer_1.isEquipmentCompatible)(exercise, ['barbell'])).toBe(false);
+    });
+    it('returns true when user has more equipment than required', () => {
+        const exercise = createExercise(['barbell']);
+        expect((0, hevyTrainer_1.isEquipmentCompatible)(exercise, ['barbell', 'squat_rack', 'dumbbell'])).toBe(true);
+    });
+    describe('special case: adjustable_bench / flat_bench substitution', () => {
+        it('allows adjustable_bench to substitute for flat_bench when exercise requires flat_bench', () => {
+            const exercise = createExercise(['flat_bench']);
+            expect((0, hevyTrainer_1.isEquipmentCompatible)(exercise, ['adjustable_bench'])).toBe(true);
+        });
+        it('does NOT allow flat_bench to substitute for adjustable_bench when exercise requires adjustable_bench', () => {
+            const exercise = createExercise(['adjustable_bench']);
+            expect((0, hevyTrainer_1.isEquipmentCompatible)(exercise, ['flat_bench'])).toBe(false);
+        });
+    });
+    describe('special case: dual_cable_machine / single_cable_machine substitution', () => {
+        it('allows dual_cable_machine to substitute for single_cable_machine when exercise requires single_cable_machine', () => {
+            const exercise = createExercise(['single_cable_machine']);
+            expect((0, hevyTrainer_1.isEquipmentCompatible)(exercise, ['dual_cable_machine'])).toBe(true);
+        });
+        it('does NOT allow single_cable_machine to substitute for dual_cable_machine when exercise requires dual_cable_machine', () => {
+            const exercise = createExercise(['dual_cable_machine']);
+            expect((0, hevyTrainer_1.isEquipmentCompatible)(exercise, ['single_cable_machine'])).toBe(false);
+        });
+    });
+});
+const __1 = require("..");
+describe('hevyTrainer gym types and defaults', () => {
+    it('defines granular equipment defaults for every trainer gym type', () => {
+        __1.trainerGymTypes.forEach((gymType) => {
+            const defaults = __1.granularEquipmentDefaults[gymType];
+            expect(Array.isArray(defaults)).toBe(true);
+            expect(defaults.length).toBeGreaterThan(0);
+        });
+    });
+    it('granular equipment defaults only contain granular equipment values', () => {
+        Object.keys(__1.granularEquipmentDefaults).forEach((gymType) => {
+            const defaults = __1.granularEquipmentDefaults[gymType];
+            defaults.forEach((equipment) => {
+                // Type assertion ensures the mapping stays within the GranularEquipment union.
+                const typed = equipment;
+                expect(typeof typed).toBe('string');
+            });
+        });
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hevy-shared",
-  "version": "1.0.917",
+  "version": "1.0.918",
   "description": "",
   "main": "built/index.js",
   "types": "built/index.d.ts",