@sunsteel/contracts 0.18.0 → 0.20.0

package/dist/index.d.cts

@@ -304,6 +304,85 @@ interface ExerciseStrengthTrendResponse {
     points: ExerciseStrengthTrendPoint[];
     truncated: boolean;
 }
+interface ExercisePerformanceHistoryQuery {
+    exerciseId?: string;
+    from?: string;
+    to?: string;
+    cursor?: string;
+    limit?: number;
+}
+interface ExercisePerformanceSummary {
+    exerciseId: string;
+    exerciseName: string;
+    lastPerformedAt: string;
+    hasStrengthTrend: boolean;
+}
+interface ExercisePerformanceSet {
+    routineExerciseId: string;
+    setNumber: number;
+    reps: number;
+    weightKg?: number | null;
+    rpe?: number | null;
+}
+interface ExercisePerformancePrescriptionSet {
+    setNumber: number;
+    repType: RepType;
+    reps?: number | null;
+    minReps?: number | null;
+    maxReps?: number | null;
+    weightKg?: number | null;
+    rir?: number | null;
+}
+interface ExercisePerformancePrescription {
+    routineExerciseId: string;
+    restSeconds?: number | null;
+    note?: string | null;
+    progressionScheme: ProgressionScheme;
+    minWeightIncrementKg: number;
+    sets: ExercisePerformancePrescriptionSet[];
+}
+interface ExercisePerformanceSession {
+    sessionId: string;
+    status: Extract<WorkoutSessionStatus, 'COMPLETED' | 'ABORTED'>;
+    routineName: string;
+    dayName?: string | null;
+    startedAt: string;
+    endedAt: string;
+    durationSec?: number | null;
+    sessionNotes?: string | null;
+    sets: ExercisePerformanceSet[];
+    prescriptions: ExercisePerformancePrescription[];
+    progressionChanges: ProgressionChange[];
+}
+/** Stable successful response of GET /workouts/progress/performance. */
+interface ExercisePerformanceHistoryResponse {
+    exercises: ExercisePerformanceSummary[];
+    selectedExercise: ExercisePerformanceSummary | null;
+    items: ExercisePerformanceSession[];
+    nextCursor?: string;
+}
+interface MuscleGroupHeatmapQuery {
+    timeZone: string;
+    /** Number of Monday-based calendar weeks to return, including this week. */
+    weeks?: number;
+}
+interface MuscleGroupHeatmapValue {
+    muscle: MuscleGroup;
+    /** Completed-set equivalents: primary muscles count 1, secondary count 0.5. */
+    weightedSets: number;
+}
+interface MuscleGroupHeatmapWeek {
+    weekStart: string;
+    isCurrentWeek: boolean;
+    totalWeightedSets: number;
+    muscles: MuscleGroupHeatmapValue[];
+}
+/** Stable successful response of GET /workouts/progress/muscles. */
+interface MuscleGroupHeatmapResponse {
+    timeZone: string;
+    weeks: MuscleGroupHeatmapWeek[];
+    peakWeightedSets: number;
+}
 /** Immutable prescription captured before any sets or progression. */
 interface WorkoutSessionSnapshotV1 {
     schemaVersion: 1;
@@ -584,4 +663,4 @@ interface CreateRoutineRequest {
 }
 type UpdateRoutineRequest = Partial<CreateRoutineRequest>;
 
-export { type Brand, type CreateRoutineDayInput, type CreateRoutineExerciseInput, type CreateRoutineRequest, type EarnedPersonalRecord, type Exercise, type ExerciseId, type ExerciseStrengthSummary, type ExerciseStrengthTrendPoint, type ExerciseStrengthTrendQuery, type ExerciseStrengthTrendResponse, type FinishStatus, type FinishWorkoutRequest, type FinishWorkoutResponse, type IsoDateString, type ListSessionsParams, MUSCLE_GROUPS, type MuscleGroup, PREFERRED_TRAINING_STYLE_VALUES, PROFILE_BIO_MAX_LENGTH, PROFILE_FAVORITE_EXERCISES_MAX, PROFILE_LOCATION_MAX_LENGTH, PROFILE_TRAINING_DISCIPLINES_MAX, PROFILE_TRAINING_GOALS_MAX, PROFILE_VISIBILITY_VALUES, PROGRESSION_SCHEMES, type PaginatedResponse, type PersonalRecordEntry, type PersonalRecordKind, type PlatePairInventory, type PreferredTrainingStyle, type PreviousPerformanceResponse, type PreviousSessionRecap, type PreviousSetPerformance, type ProfileDiscoverySettings, type ProfileFavoriteExercise, type ProfilePrivacySettings, type ProfileViewerAccess, type ProfileVisibility, type ProgressionChange, type ProgressionRule, type ProgressionScheme, type ProgressionSetChange, type PublicBodyMetrics, type PublicTrainingSummary, type PublicUserProfile, REP_TYPES, RESERVED_USERNAMES, type RecentActivityEntry, type RepType, type ReplaceTrainingLocationsRequest, type Routine, type RoutineDay, type RoutineDayId, type RoutineExercise, type RoutineId, type RoutineSet, SEXES, type SessionRecapRecord, type SetAccountTimeZoneRequest, type SetLog, type Sex, type StartWorkoutRequest, type StartWorkoutResponse, type SupabaseAuthResponse, type SupabaseAuthUser, type SupabaseMigrationResponse, TRAINING_DISCIPLINE_VALUES, TRAINING_EVENT_TYPES, TRAINING_EXPERIENCE_LEVEL_VALUES, TRAINING_GOAL_VALUES, type TrainingDiscipline, type TrainingEventType, type TrainingExperienceLevel, type TrainingGoal, type TrainingIdentity, type TrainingLocationPreference, type TrainingLocationPreferenceInput, USERNAME_MAX_LENGTH, USERNAME_MIN_LENGTH, USERNAME_PATTERN_SOURCE, type UpdateProfileDiscoveryRequest, type UpdateProfilePrivacyRequest, type UpdateProfileRequest, type UpdateRoutineRequest, type UpsertSetLogRequest, type UpsertSetLogResponse, type UserId, type UserProfile, type UserSearchResponse, WEIGHT_UNITS, WORKOUT_SESSION_STATUSES, type WeightUnit, type WorkoutAnalyticsStatus, type WorkoutProgressQuery, type WorkoutProgressResponse, type WorkoutSession, type WorkoutSessionId, type WorkoutSessionListResponse, type WorkoutSessionRecap, type WorkoutSessionSnapshotV1, type WorkoutSessionStatus, type WorkoutSessionSummary, type WorkoutStatsQuery, type WorkoutStatsResponse };
+export { type Brand, type CreateRoutineDayInput, type CreateRoutineExerciseInput, type CreateRoutineRequest, type EarnedPersonalRecord, type Exercise, type ExerciseId, type ExercisePerformanceHistoryQuery, type ExercisePerformanceHistoryResponse, type ExercisePerformancePrescription, type ExercisePerformancePrescriptionSet, type ExercisePerformanceSession, type ExercisePerformanceSet, type ExercisePerformanceSummary, type ExerciseStrengthSummary, type ExerciseStrengthTrendPoint, type ExerciseStrengthTrendQuery, type ExerciseStrengthTrendResponse, type FinishStatus, type FinishWorkoutRequest, type FinishWorkoutResponse, type IsoDateString, type ListSessionsParams, MUSCLE_GROUPS, type MuscleGroup, type MuscleGroupHeatmapQuery, type MuscleGroupHeatmapResponse, type MuscleGroupHeatmapValue, type MuscleGroupHeatmapWeek, PREFERRED_TRAINING_STYLE_VALUES, PROFILE_BIO_MAX_LENGTH, PROFILE_FAVORITE_EXERCISES_MAX, PROFILE_LOCATION_MAX_LENGTH, PROFILE_TRAINING_DISCIPLINES_MAX, PROFILE_TRAINING_GOALS_MAX, PROFILE_VISIBILITY_VALUES, PROGRESSION_SCHEMES, type PaginatedResponse, type PersonalRecordEntry, type PersonalRecordKind, type PlatePairInventory, type PreferredTrainingStyle, type PreviousPerformanceResponse, type PreviousSessionRecap, type PreviousSetPerformance, type ProfileDiscoverySettings, type ProfileFavoriteExercise, type ProfilePrivacySettings, type ProfileViewerAccess, type ProfileVisibility, type ProgressionChange, type ProgressionRule, type ProgressionScheme, type ProgressionSetChange, type PublicBodyMetrics, type PublicTrainingSummary, type PublicUserProfile, REP_TYPES, RESERVED_USERNAMES, type RecentActivityEntry, type RepType, type ReplaceTrainingLocationsRequest, type Routine, type RoutineDay, type RoutineDayId, type RoutineExercise, type RoutineId, type RoutineSet, SEXES, type SessionRecapRecord, type SetAccountTimeZoneRequest, type SetLog, type Sex, type StartWorkoutRequest, type StartWorkoutResponse, type SupabaseAuthResponse, type SupabaseAuthUser, type SupabaseMigrationResponse, TRAINING_DISCIPLINE_VALUES, TRAINING_EVENT_TYPES, TRAINING_EXPERIENCE_LEVEL_VALUES, TRAINING_GOAL_VALUES, type TrainingDiscipline, type TrainingEventType, type TrainingExperienceLevel, type TrainingGoal, type TrainingIdentity, type TrainingLocationPreference, type TrainingLocationPreferenceInput, USERNAME_MAX_LENGTH, USERNAME_MIN_LENGTH, USERNAME_PATTERN_SOURCE, type UpdateProfileDiscoveryRequest, type UpdateProfilePrivacyRequest, type UpdateProfileRequest, type UpdateRoutineRequest, type UpsertSetLogRequest, type UpsertSetLogResponse, type UserId, type UserProfile, type UserSearchResponse, WEIGHT_UNITS, WORKOUT_SESSION_STATUSES, type WeightUnit, type WorkoutAnalyticsStatus, type WorkoutProgressQuery, type WorkoutProgressResponse, type WorkoutSession, type WorkoutSessionId, type WorkoutSessionListResponse, type WorkoutSessionRecap, type WorkoutSessionSnapshotV1, type WorkoutSessionStatus, type WorkoutSessionSummary, type WorkoutStatsQuery, type WorkoutStatsResponse };

package/dist/index.d.ts

@@ -304,6 +304,85 @@ interface ExerciseStrengthTrendResponse {
     points: ExerciseStrengthTrendPoint[];
     truncated: boolean;
 }
+interface ExercisePerformanceHistoryQuery {
+    exerciseId?: string;
+    from?: string;
+    to?: string;
+    cursor?: string;
+    limit?: number;
+}
+interface ExercisePerformanceSummary {
+    exerciseId: string;
+    exerciseName: string;
+    lastPerformedAt: string;
+    hasStrengthTrend: boolean;
+}
+interface ExercisePerformanceSet {
+    routineExerciseId: string;
+    setNumber: number;
+    reps: number;
+    weightKg?: number | null;
+    rpe?: number | null;
+}
+interface ExercisePerformancePrescriptionSet {
+    setNumber: number;
+    repType: RepType;
+    reps?: number | null;
+    minReps?: number | null;
+    maxReps?: number | null;
+    weightKg?: number | null;
+    rir?: number | null;
+}
+interface ExercisePerformancePrescription {
+    routineExerciseId: string;
+    restSeconds?: number | null;
+    note?: string | null;
+    progressionScheme: ProgressionScheme;
+    minWeightIncrementKg: number;
+    sets: ExercisePerformancePrescriptionSet[];
+}
+interface ExercisePerformanceSession {
+    sessionId: string;
+    status: Extract<WorkoutSessionStatus, 'COMPLETED' | 'ABORTED'>;
+    routineName: string;
+    dayName?: string | null;
+    startedAt: string;
+    endedAt: string;
+    durationSec?: number | null;
+    sessionNotes?: string | null;
+    sets: ExercisePerformanceSet[];
+    prescriptions: ExercisePerformancePrescription[];
+    progressionChanges: ProgressionChange[];
+}
+/** Stable successful response of GET /workouts/progress/performance. */
+interface ExercisePerformanceHistoryResponse {
+    exercises: ExercisePerformanceSummary[];
+    selectedExercise: ExercisePerformanceSummary | null;
+    items: ExercisePerformanceSession[];
+    nextCursor?: string;
+}
+interface MuscleGroupHeatmapQuery {
+    timeZone: string;
+    /** Number of Monday-based calendar weeks to return, including this week. */
+    weeks?: number;
+}
+interface MuscleGroupHeatmapValue {
+    muscle: MuscleGroup;
+    /** Completed-set equivalents: primary muscles count 1, secondary count 0.5. */
+    weightedSets: number;
+}
+interface MuscleGroupHeatmapWeek {
+    weekStart: string;
+    isCurrentWeek: boolean;
+    totalWeightedSets: number;
+    muscles: MuscleGroupHeatmapValue[];
+}
+/** Stable successful response of GET /workouts/progress/muscles. */
+interface MuscleGroupHeatmapResponse {
+    timeZone: string;
+    weeks: MuscleGroupHeatmapWeek[];
+    peakWeightedSets: number;
+}
 /** Immutable prescription captured before any sets or progression. */
 interface WorkoutSessionSnapshotV1 {
     schemaVersion: 1;
@@ -584,4 +663,4 @@ interface CreateRoutineRequest {
 }
 type UpdateRoutineRequest = Partial<CreateRoutineRequest>;
 
-export { type Brand, type CreateRoutineDayInput, type CreateRoutineExerciseInput, type CreateRoutineRequest, type EarnedPersonalRecord, type Exercise, type ExerciseId, type ExerciseStrengthSummary, type ExerciseStrengthTrendPoint, type ExerciseStrengthTrendQuery, type ExerciseStrengthTrendResponse, type FinishStatus, type FinishWorkoutRequest, type FinishWorkoutResponse, type IsoDateString, type ListSessionsParams, MUSCLE_GROUPS, type MuscleGroup, PREFERRED_TRAINING_STYLE_VALUES, PROFILE_BIO_MAX_LENGTH, PROFILE_FAVORITE_EXERCISES_MAX, PROFILE_LOCATION_MAX_LENGTH, PROFILE_TRAINING_DISCIPLINES_MAX, PROFILE_TRAINING_GOALS_MAX, PROFILE_VISIBILITY_VALUES, PROGRESSION_SCHEMES, type PaginatedResponse, type PersonalRecordEntry, type PersonalRecordKind, type PlatePairInventory, type PreferredTrainingStyle, type PreviousPerformanceResponse, type PreviousSessionRecap, type PreviousSetPerformance, type ProfileDiscoverySettings, type ProfileFavoriteExercise, type ProfilePrivacySettings, type ProfileViewerAccess, type ProfileVisibility, type ProgressionChange, type ProgressionRule, type ProgressionScheme, type ProgressionSetChange, type PublicBodyMetrics, type PublicTrainingSummary, type PublicUserProfile, REP_TYPES, RESERVED_USERNAMES, type RecentActivityEntry, type RepType, type ReplaceTrainingLocationsRequest, type Routine, type RoutineDay, type RoutineDayId, type RoutineExercise, type RoutineId, type RoutineSet, SEXES, type SessionRecapRecord, type SetAccountTimeZoneRequest, type SetLog, type Sex, type StartWorkoutRequest, type StartWorkoutResponse, type SupabaseAuthResponse, type SupabaseAuthUser, type SupabaseMigrationResponse, TRAINING_DISCIPLINE_VALUES, TRAINING_EVENT_TYPES, TRAINING_EXPERIENCE_LEVEL_VALUES, TRAINING_GOAL_VALUES, type TrainingDiscipline, type TrainingEventType, type TrainingExperienceLevel, type TrainingGoal, type TrainingIdentity, type TrainingLocationPreference, type TrainingLocationPreferenceInput, USERNAME_MAX_LENGTH, USERNAME_MIN_LENGTH, USERNAME_PATTERN_SOURCE, type UpdateProfileDiscoveryRequest, type UpdateProfilePrivacyRequest, type UpdateProfileRequest, type UpdateRoutineRequest, type UpsertSetLogRequest, type UpsertSetLogResponse, type UserId, type UserProfile, type UserSearchResponse, WEIGHT_UNITS, WORKOUT_SESSION_STATUSES, type WeightUnit, type WorkoutAnalyticsStatus, type WorkoutProgressQuery, type WorkoutProgressResponse, type WorkoutSession, type WorkoutSessionId, type WorkoutSessionListResponse, type WorkoutSessionRecap, type WorkoutSessionSnapshotV1, type WorkoutSessionStatus, type WorkoutSessionSummary, type WorkoutStatsQuery, type WorkoutStatsResponse };
+export { type Brand, type CreateRoutineDayInput, type CreateRoutineExerciseInput, type CreateRoutineRequest, type EarnedPersonalRecord, type Exercise, type ExerciseId, type ExercisePerformanceHistoryQuery, type ExercisePerformanceHistoryResponse, type ExercisePerformancePrescription, type ExercisePerformancePrescriptionSet, type ExercisePerformanceSession, type ExercisePerformanceSet, type ExercisePerformanceSummary, type ExerciseStrengthSummary, type ExerciseStrengthTrendPoint, type ExerciseStrengthTrendQuery, type ExerciseStrengthTrendResponse, type FinishStatus, type FinishWorkoutRequest, type FinishWorkoutResponse, type IsoDateString, type ListSessionsParams, MUSCLE_GROUPS, type MuscleGroup, type MuscleGroupHeatmapQuery, type MuscleGroupHeatmapResponse, type MuscleGroupHeatmapValue, type MuscleGroupHeatmapWeek, PREFERRED_TRAINING_STYLE_VALUES, PROFILE_BIO_MAX_LENGTH, PROFILE_FAVORITE_EXERCISES_MAX, PROFILE_LOCATION_MAX_LENGTH, PROFILE_TRAINING_DISCIPLINES_MAX, PROFILE_TRAINING_GOALS_MAX, PROFILE_VISIBILITY_VALUES, PROGRESSION_SCHEMES, type PaginatedResponse, type PersonalRecordEntry, type PersonalRecordKind, type PlatePairInventory, type PreferredTrainingStyle, type PreviousPerformanceResponse, type PreviousSessionRecap, type PreviousSetPerformance, type ProfileDiscoverySettings, type ProfileFavoriteExercise, type ProfilePrivacySettings, type ProfileViewerAccess, type ProfileVisibility, type ProgressionChange, type ProgressionRule, type ProgressionScheme, type ProgressionSetChange, type PublicBodyMetrics, type PublicTrainingSummary, type PublicUserProfile, REP_TYPES, RESERVED_USERNAMES, type RecentActivityEntry, type RepType, type ReplaceTrainingLocationsRequest, type Routine, type RoutineDay, type RoutineDayId, type RoutineExercise, type RoutineId, type RoutineSet, SEXES, type SessionRecapRecord, type SetAccountTimeZoneRequest, type SetLog, type Sex, type StartWorkoutRequest, type StartWorkoutResponse, type SupabaseAuthResponse, type SupabaseAuthUser, type SupabaseMigrationResponse, TRAINING_DISCIPLINE_VALUES, TRAINING_EVENT_TYPES, TRAINING_EXPERIENCE_LEVEL_VALUES, TRAINING_GOAL_VALUES, type TrainingDiscipline, type TrainingEventType, type TrainingExperienceLevel, type TrainingGoal, type TrainingIdentity, type TrainingLocationPreference, type TrainingLocationPreferenceInput, USERNAME_MAX_LENGTH, USERNAME_MIN_LENGTH, USERNAME_PATTERN_SOURCE, type UpdateProfileDiscoveryRequest, type UpdateProfilePrivacyRequest, type UpdateProfileRequest, type UpdateRoutineRequest, type UpsertSetLogRequest, type UpsertSetLogResponse, type UserId, type UserProfile, type UserSearchResponse, WEIGHT_UNITS, WORKOUT_SESSION_STATUSES, type WeightUnit, type WorkoutAnalyticsStatus, type WorkoutProgressQuery, type WorkoutProgressResponse, type WorkoutSession, type WorkoutSessionId, type WorkoutSessionListResponse, type WorkoutSessionRecap, type WorkoutSessionSnapshotV1, type WorkoutSessionStatus, type WorkoutSessionSummary, type WorkoutStatsQuery, type WorkoutStatsResponse };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sunsteel/contracts",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ezee969/sunsteel-contracts.git"