@sunsteel/contracts 0.34.0 → 0.36.0

package/dist/index.cjs

@@ -34,6 +34,8 @@ __export(index_exports, {
   MUSCLE_GROUPS: () => MUSCLE_GROUPS,
   PLATEAU_MIN_DAYS_SINCE_BEST: () => PLATEAU_MIN_DAYS_SINCE_BEST,
   PLATEAU_MIN_SESSIONS: () => PLATEAU_MIN_SESSIONS,
+  PLATEAU_MIN_SESSIONS_MAX: () => PLATEAU_MIN_SESSIONS_MAX,
+  PLATEAU_MIN_SESSIONS_MIN: () => PLATEAU_MIN_SESSIONS_MIN,
   PLATEAU_RECENT_DAYS: () => PLATEAU_RECENT_DAYS,
   PLATEAU_WINDOW_DAYS: () => PLATEAU_WINDOW_DAYS,
   PREFERRED_TRAINING_STYLE_VALUES: () => PREFERRED_TRAINING_STYLE_VALUES,
@@ -51,6 +53,9 @@ __export(index_exports, {
   RENAISSANCE_RANK_DEFINITIONS: () => RENAISSANCE_RANK_DEFINITIONS,
   REP_TYPES: () => REP_TYPES,
   RESERVED_USERNAMES: () => RESERVED_USERNAMES,
+  ROUTINE_DAYS_MAX: () => ROUTINE_DAYS_MAX,
+  ROUTINE_DAY_NAME_MAX: () => ROUTINE_DAY_NAME_MAX,
+  ROUTINE_SCHEDULE_MODES: () => ROUTINE_SCHEDULE_MODES,
   SESSION_SHARE_DEFAULT_FIELDS: () => SESSION_SHARE_DEFAULT_FIELDS,
   SESSION_SHARE_FIELDS: () => SESSION_SHARE_FIELDS,
   SESSION_SHARE_MAX_ACTIVE_LINKS: () => SESSION_SHARE_MAX_ACTIVE_LINKS,
@@ -64,7 +69,8 @@ __export(index_exports, {
   USERNAME_MIN_LENGTH: () => USERNAME_MIN_LENGTH,
   USERNAME_PATTERN_SOURCE: () => USERNAME_PATTERN_SOURCE,
   WEIGHT_UNITS: () => WEIGHT_UNITS,
-  WORKOUT_SESSION_STATUSES: () => WORKOUT_SESSION_STATUSES
+  WORKOUT_SESSION_STATUSES: () => WORKOUT_SESSION_STATUSES,
+  routineDayLabel: () => routineDayLabel
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -346,6 +352,31 @@ var RENAISSANCE_RANK_DEFINITIONS = [
   }
 ];
 
+// src/routine.ts
+var ROUTINE_SCHEDULE_MODES = ["WEEKLY", "ROTATION"];
+var ROUTINE_DAYS_MAX = 7;
+var ROUTINE_DAY_NAME_MAX = 40;
+var WEEKDAY_NAMES = [
+  "Sunday",
+  "Monday",
+  "Tuesday",
+  "Wednesday",
+  "Thursday",
+  "Friday",
+  "Saturday"
+];
+function routineDayLabel(day) {
+  const name = day.name?.trim();
+  if (name) return name;
+  if (typeof day.dayOfWeek === "number") {
+    return WEEKDAY_NAMES[day.dayOfWeek] ?? "";
+  }
+  if (typeof day.order === "number" && day.order >= 0 && day.order < 26) {
+    return `Day ${String.fromCharCode(65 + day.order)}`;
+  }
+  return "";
+}
+
 // src/workout.ts
 var SESSION_SHARE_FIELDS = [
   "duration",
@@ -379,6 +410,8 @@ var PLATEAU_WINDOW_DAYS = 56;
 var PLATEAU_MIN_SESSIONS = 4;
 var PLATEAU_MIN_DAYS_SINCE_BEST = 21;
 var PLATEAU_RECENT_DAYS = 21;
+var PLATEAU_MIN_SESSIONS_MIN = 3;
+var PLATEAU_MIN_SESSIONS_MAX = 8;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ACHIEVEMENT_CATEGORIES,
@@ -395,6 +428,8 @@ var PLATEAU_RECENT_DAYS = 21;
   MUSCLE_GROUPS,
   PLATEAU_MIN_DAYS_SINCE_BEST,
   PLATEAU_MIN_SESSIONS,
+  PLATEAU_MIN_SESSIONS_MAX,
+  PLATEAU_MIN_SESSIONS_MIN,
   PLATEAU_RECENT_DAYS,
   PLATEAU_WINDOW_DAYS,
   PREFERRED_TRAINING_STYLE_VALUES,
@@ -412,6 +447,9 @@ var PLATEAU_RECENT_DAYS = 21;
   RENAISSANCE_RANK_DEFINITIONS,
   REP_TYPES,
   RESERVED_USERNAMES,
+  ROUTINE_DAYS_MAX,
+  ROUTINE_DAY_NAME_MAX,
+  ROUTINE_SCHEDULE_MODES,
   SESSION_SHARE_DEFAULT_FIELDS,
   SESSION_SHARE_FIELDS,
   SESSION_SHARE_MAX_ACTIVE_LINKS,
@@ -425,5 +463,6 @@ var PLATEAU_RECENT_DAYS = 21;
   USERNAME_MIN_LENGTH,
   USERNAME_PATTERN_SOURCE,
   WEIGHT_UNITS,
-  WORKOUT_SESSION_STATUSES
+  WORKOUT_SESSION_STATUSES,
+  routineDayLabel
 });

package/dist/index.d.cts

@@ -66,7 +66,8 @@ interface WorkoutSession {
         id: string;
         name?: string | null;
         order?: number;
-        dayOfWeek?: number;
+        /** Null on a ROTATION routine day (ROUT-11). */
+        dayOfWeek?: number | null;
         exercises: Array<{
             id: string;
             order: number;
@@ -616,9 +617,10 @@ interface WorkoutAnalyticsStatus {
 }
 /**
  * Thresholds behind every plateau. A lift is flagged only when all hold: at
- * least `PLATEAU_MIN_SESSIONS` terminal sessions with completed loaded sets
- * of it since its current best (the session that set the best excluded, and
- * counting only inside the look-back window), the best is at least
+ * least the account's minimum sessions (`PLATEAU_MIN_SESSIONS` by default)
+ * of terminal sessions with completed loaded sets of it since its current
+ * best (the session that set the best excluded, and counting only inside the
+ * look-back window), the best is at least
  * `PLATEAU_MIN_DAYS_SINCE_BEST` days old, and the lift was trained within the
  * last `PLATEAU_RECENT_DAYS` days. They describe numbers, never a cause.
  */
@@ -626,6 +628,16 @@ declare const PLATEAU_WINDOW_DAYS = 56;
 declare const PLATEAU_MIN_SESSIONS = 4;
 declare const PLATEAU_MIN_DAYS_SINCE_BEST = 21;
 declare const PLATEAU_RECENT_DAYS = 21;
+/**
+ * PREF-05: each account chooses its minimum sessions within these bounds;
+ * `PLATEAU_MIN_SESSIONS` is the default. The other thresholds stay fixed.
+ */
+declare const PLATEAU_MIN_SESSIONS_MIN = 3;
+declare const PLATEAU_MIN_SESSIONS_MAX = 8;
+/** Body and response of PUT /users/preferences/plateaus. */
+interface PlateauPreferences {
+    minSessions: number;
+}
 interface PlateauSet {
     weightKg: number;
     reps: number;
@@ -654,6 +666,7 @@ interface PlateausResponse {
     asOf: IsoDateString;
     thresholds: {
         windowDays: number;
+        /** The account's PREF-05 choice, within the bounds above. */
         minSessions: number;
         minDaysSinceBest: number;
         recentDays: number;
@@ -1094,6 +1107,26 @@ interface AchievementsResponse {
     milestoneProgress: AchievementCategoryProgress[];
 }
 
+/**
+ * ROUT-11: a WEEKLY routine ties each day to a weekday; a ROTATION routine
+ * runs its days in `order`, each after the last completed one, whatever the
+ * weekday.
+ */
+declare const ROUTINE_SCHEDULE_MODES: readonly ["WEEKLY", "ROTATION"];
+type RoutineScheduleMode = (typeof ROUTINE_SCHEDULE_MODES)[number];
+/** At most seven days in either mode. */
+declare const ROUTINE_DAYS_MAX = 7;
+declare const ROUTINE_DAY_NAME_MAX = 40;
+/**
+ * How a routine day is named everywhere, including history snapshots taken
+ * before ROUT-11: its own name, else its weekday, else its rotation letter
+ * ("Day A" for order 0).
+ */
+declare function routineDayLabel(day: {
+    name?: string | null;
+    dayOfWeek?: number | null;
+    order?: number | null;
+}): string;
 interface RoutineSet {
     setNumber: number;
     repType: RepType;
@@ -1129,12 +1162,18 @@ interface CreateRoutineExerciseInput {
 }
 interface RoutineDay {
     id: string;
-    dayOfWeek: number;
+    /** 0=Sun..6=Sat on a WEEKLY routine; null on a ROTATION routine. */
+    dayOfWeek: number | null;
+    /** Optional label such as "Push" or "Upper A" (see `routineDayLabel`). */
+    name: string | null;
+    /** Rotation sequence, 0-based; also the display order. */
     order: number;
     exercises: RoutineExercise[];
 }
 interface CreateRoutineDayInput {
-    dayOfWeek: number;
+    /** Required and unique on a WEEKLY routine; omitted or null on a ROTATION. */
+    dayOfWeek?: number | null;
+    name?: string | null;
     order?: number;
     exercises: CreateRoutineExerciseInput[];
 }
@@ -1146,6 +1185,12 @@ interface Routine {
     isPeriodized: boolean;
     isFavorite: boolean;
     isCompleted: boolean;
+    scheduleMode: RoutineScheduleMode;
+    /**
+     * ROTATION only: the day after the one of the last completed session (an
+     * aborted session does not advance it), or the first day before any.
+     */
+    nextRotationDayId: string | null;
     days: RoutineDay[];
     createdAt: IsoDateString;
     updatedAt: IsoDateString;
@@ -1154,8 +1199,10 @@ interface CreateRoutineRequest {
     name: string;
     description?: string;
     isPeriodized: boolean;
+    /** Defaults to WEEKLY. Changing it on update requires `days`. */
+    scheduleMode?: RoutineScheduleMode;
     days: CreateRoutineDayInput[];
 }
 type UpdateRoutineRequest = Partial<CreateRoutineRequest>;
 
-export { ACHIEVEMENT_CATEGORIES, ACHIEVEMENT_DEFINITIONS, type AchievementCategory, type AchievementCategoryProgress, type AchievementDefinition, type AchievementUnlockedEventPayload, type AchievementsResponse, type Brand, type CreateRoutineDayInput, type CreateRoutineExerciseInput, type CreateRoutineRequest, type CreateSessionShareRequest, EXERCISE_EQUIPMENT, EXERCISE_MECHANICS, type EarnedAchievement, type EarnedPersonalRecord, type Exercise, type ExerciseEquipment, type ExerciseId, type ExerciseMechanic, type ExercisePerformanceHistoryQuery, type ExercisePerformanceHistoryResponse, type ExercisePerformancePrescription, type ExercisePerformancePrescriptionSet, type ExercisePerformanceSession, type ExercisePerformanceSet, type ExercisePerformanceSummary, type ExercisePlateau, type ExerciseStrengthSummary, type ExerciseStrengthTrendPoint, type ExerciseStrengthTrendQuery, type ExerciseStrengthTrendResponse, FOLLOW_SUGGESTIONS_DEFAULT_LIMIT, FOLLOW_SUGGESTIONS_MAX_LIMIT, FOLLOW_SUGGESTION_REASONS, type FinishStatus, type FinishWorkoutRequest, type FinishWorkoutResponse, type FollowSuggestion, type FollowSuggestionReason, type FollowSuggestionsResponse, type IsoDateString, type ListSessionsParams, MEASURABLE_GOALS_MAX, MEASURABLE_GOAL_DIRECTIONS, MEASURABLE_GOAL_TYPES, MOVEMENT_PATTERNS, MUSCLE_GROUPS, type MeasurableGoal, type MeasurableGoalDirection, type MeasurableGoalExercise, type MeasurableGoalInput, type MeasurableGoalType, type MovementPattern, type MuscleGroup, type MuscleGroupHeatmapQuery, type MuscleGroupHeatmapResponse, type MuscleGroupHeatmapValue, type MuscleGroupHeatmapWeek, type MuscleVolumeTrendSeries, PLATEAU_MIN_DAYS_SINCE_BEST, PLATEAU_MIN_SESSIONS, PLATEAU_RECENT_DAYS, PLATEAU_WINDOW_DAYS, 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, PROGRESS_TIMELINE_EVENT_TYPES, type PaginatedResponse, type PersonalGoalProgress, type PersonalGoalsResponse, type PersonalRecordEntry, type PersonalRecordKind, type PlatePairInventory, type PlateauSet, type PlateausResponse, type PreferredTrainingStyle, type PreviousPerformanceResponse, type PreviousSessionRecap, type PreviousSetPerformance, type ProfileDiscoverySettings, type ProfileFavoriteExercise, type ProfilePrivacySettings, type ProfileViewerAccess, type ProfileVisibility, type ProgressTimelineEventType, type ProgressTimelineItem, type ProgressTimelinePersonalRecordItem, type ProgressTimelineProgressionItem, type ProgressTimelineQuery, type ProgressTimelineRecordPerformance, type ProgressTimelineRecordReason, type ProgressTimelineResponse, type ProgressTimelineSessionContext, type ProgressionChange, type ProgressionRule, type ProgressionScheme, type ProgressionSetChange, type PublicBodyMetrics, type PublicTrainingSummary, type PublicUserProfile, RELATIONSHIP_LIST_DEFAULT_LIMIT, RELATIONSHIP_LIST_KINDS, RELATIONSHIP_LIST_MAX_LIMIT, RENAISSANCE_RANK_DEFINITIONS, REP_TYPES, RESERVED_USERNAMES, type RecentActivityEntry, type RelationshipListKind, type RelationshipListQuery, type RelationshipListResponse, type RelationshipMember, type RenaissanceRankDefinition, type RenaissanceRankProgress, type RepType, type ReplaceMeasurableGoalsRequest, type ReplaceTrainingLocationsRequest, type Routine, type RoutineDay, type RoutineDayId, type RoutineExercise, type RoutineId, type RoutineSet, SESSION_SHARE_DEFAULT_FIELDS, SESSION_SHARE_FIELDS, SESSION_SHARE_MAX_ACTIVE_LINKS, SEXES, STARRED_EXERCISES_MAX, type SessionComparisonExercise, type SessionComparisonQuery, type SessionComparisonResponse, type SessionComparisonRoutineDay, type SessionComparisonSession, type SessionComparisonSet, type SessionExerciseSubstitution, type SessionRecapRecord, type SessionShare, type SessionShareField, type SessionShareListResponse, type SetAccountTimeZoneRequest, type SetLog, type Sex, type SharedSessionOwner, type SharedSessionRecap, type StarredExercise, type StarredExercisesResponse, type StartWorkoutRequest, type StartWorkoutResponse, type StreakMilestoneEventPayload, type SubstituteSessionExerciseRequest, type SubstituteSessionExerciseResponse, 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, type VolumeTrendPoint, type VolumeTrendQuery, type VolumeTrendResponse, type VolumeTrendSeries, 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 { ACHIEVEMENT_CATEGORIES, ACHIEVEMENT_DEFINITIONS, type AchievementCategory, type AchievementCategoryProgress, type AchievementDefinition, type AchievementUnlockedEventPayload, type AchievementsResponse, type Brand, type CreateRoutineDayInput, type CreateRoutineExerciseInput, type CreateRoutineRequest, type CreateSessionShareRequest, EXERCISE_EQUIPMENT, EXERCISE_MECHANICS, type EarnedAchievement, type EarnedPersonalRecord, type Exercise, type ExerciseEquipment, type ExerciseId, type ExerciseMechanic, type ExercisePerformanceHistoryQuery, type ExercisePerformanceHistoryResponse, type ExercisePerformancePrescription, type ExercisePerformancePrescriptionSet, type ExercisePerformanceSession, type ExercisePerformanceSet, type ExercisePerformanceSummary, type ExercisePlateau, type ExerciseStrengthSummary, type ExerciseStrengthTrendPoint, type ExerciseStrengthTrendQuery, type ExerciseStrengthTrendResponse, FOLLOW_SUGGESTIONS_DEFAULT_LIMIT, FOLLOW_SUGGESTIONS_MAX_LIMIT, FOLLOW_SUGGESTION_REASONS, type FinishStatus, type FinishWorkoutRequest, type FinishWorkoutResponse, type FollowSuggestion, type FollowSuggestionReason, type FollowSuggestionsResponse, type IsoDateString, type ListSessionsParams, MEASURABLE_GOALS_MAX, MEASURABLE_GOAL_DIRECTIONS, MEASURABLE_GOAL_TYPES, MOVEMENT_PATTERNS, MUSCLE_GROUPS, type MeasurableGoal, type MeasurableGoalDirection, type MeasurableGoalExercise, type MeasurableGoalInput, type MeasurableGoalType, type MovementPattern, type MuscleGroup, type MuscleGroupHeatmapQuery, type MuscleGroupHeatmapResponse, type MuscleGroupHeatmapValue, type MuscleGroupHeatmapWeek, type MuscleVolumeTrendSeries, PLATEAU_MIN_DAYS_SINCE_BEST, PLATEAU_MIN_SESSIONS, PLATEAU_MIN_SESSIONS_MAX, PLATEAU_MIN_SESSIONS_MIN, PLATEAU_RECENT_DAYS, PLATEAU_WINDOW_DAYS, 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, PROGRESS_TIMELINE_EVENT_TYPES, type PaginatedResponse, type PersonalGoalProgress, type PersonalGoalsResponse, type PersonalRecordEntry, type PersonalRecordKind, type PlatePairInventory, type PlateauPreferences, type PlateauSet, type PlateausResponse, type PreferredTrainingStyle, type PreviousPerformanceResponse, type PreviousSessionRecap, type PreviousSetPerformance, type ProfileDiscoverySettings, type ProfileFavoriteExercise, type ProfilePrivacySettings, type ProfileViewerAccess, type ProfileVisibility, type ProgressTimelineEventType, type ProgressTimelineItem, type ProgressTimelinePersonalRecordItem, type ProgressTimelineProgressionItem, type ProgressTimelineQuery, type ProgressTimelineRecordPerformance, type ProgressTimelineRecordReason, type ProgressTimelineResponse, type ProgressTimelineSessionContext, type ProgressionChange, type ProgressionRule, type ProgressionScheme, type ProgressionSetChange, type PublicBodyMetrics, type PublicTrainingSummary, type PublicUserProfile, RELATIONSHIP_LIST_DEFAULT_LIMIT, RELATIONSHIP_LIST_KINDS, RELATIONSHIP_LIST_MAX_LIMIT, RENAISSANCE_RANK_DEFINITIONS, REP_TYPES, RESERVED_USERNAMES, ROUTINE_DAYS_MAX, ROUTINE_DAY_NAME_MAX, ROUTINE_SCHEDULE_MODES, type RecentActivityEntry, type RelationshipListKind, type RelationshipListQuery, type RelationshipListResponse, type RelationshipMember, type RenaissanceRankDefinition, type RenaissanceRankProgress, type RepType, type ReplaceMeasurableGoalsRequest, type ReplaceTrainingLocationsRequest, type Routine, type RoutineDay, type RoutineDayId, type RoutineExercise, type RoutineId, type RoutineScheduleMode, type RoutineSet, SESSION_SHARE_DEFAULT_FIELDS, SESSION_SHARE_FIELDS, SESSION_SHARE_MAX_ACTIVE_LINKS, SEXES, STARRED_EXERCISES_MAX, type SessionComparisonExercise, type SessionComparisonQuery, type SessionComparisonResponse, type SessionComparisonRoutineDay, type SessionComparisonSession, type SessionComparisonSet, type SessionExerciseSubstitution, type SessionRecapRecord, type SessionShare, type SessionShareField, type SessionShareListResponse, type SetAccountTimeZoneRequest, type SetLog, type Sex, type SharedSessionOwner, type SharedSessionRecap, type StarredExercise, type StarredExercisesResponse, type StartWorkoutRequest, type StartWorkoutResponse, type StreakMilestoneEventPayload, type SubstituteSessionExerciseRequest, type SubstituteSessionExerciseResponse, 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, type VolumeTrendPoint, type VolumeTrendQuery, type VolumeTrendResponse, type VolumeTrendSeries, 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, routineDayLabel };

package/dist/index.d.ts

@@ -66,7 +66,8 @@ interface WorkoutSession {
         id: string;
         name?: string | null;
         order?: number;
-        dayOfWeek?: number;
+        /** Null on a ROTATION routine day (ROUT-11). */
+        dayOfWeek?: number | null;
         exercises: Array<{
             id: string;
             order: number;
@@ -616,9 +617,10 @@ interface WorkoutAnalyticsStatus {
 }
 /**
  * Thresholds behind every plateau. A lift is flagged only when all hold: at
- * least `PLATEAU_MIN_SESSIONS` terminal sessions with completed loaded sets
- * of it since its current best (the session that set the best excluded, and
- * counting only inside the look-back window), the best is at least
+ * least the account's minimum sessions (`PLATEAU_MIN_SESSIONS` by default)
+ * of terminal sessions with completed loaded sets of it since its current
+ * best (the session that set the best excluded, and counting only inside the
+ * look-back window), the best is at least
  * `PLATEAU_MIN_DAYS_SINCE_BEST` days old, and the lift was trained within the
  * last `PLATEAU_RECENT_DAYS` days. They describe numbers, never a cause.
  */
@@ -626,6 +628,16 @@ declare const PLATEAU_WINDOW_DAYS = 56;
 declare const PLATEAU_MIN_SESSIONS = 4;
 declare const PLATEAU_MIN_DAYS_SINCE_BEST = 21;
 declare const PLATEAU_RECENT_DAYS = 21;
+/**
+ * PREF-05: each account chooses its minimum sessions within these bounds;
+ * `PLATEAU_MIN_SESSIONS` is the default. The other thresholds stay fixed.
+ */
+declare const PLATEAU_MIN_SESSIONS_MIN = 3;
+declare const PLATEAU_MIN_SESSIONS_MAX = 8;
+/** Body and response of PUT /users/preferences/plateaus. */
+interface PlateauPreferences {
+    minSessions: number;
+}
 interface PlateauSet {
     weightKg: number;
     reps: number;
@@ -654,6 +666,7 @@ interface PlateausResponse {
     asOf: IsoDateString;
     thresholds: {
         windowDays: number;
+        /** The account's PREF-05 choice, within the bounds above. */
         minSessions: number;
         minDaysSinceBest: number;
         recentDays: number;
@@ -1094,6 +1107,26 @@ interface AchievementsResponse {
     milestoneProgress: AchievementCategoryProgress[];
 }
 
+/**
+ * ROUT-11: a WEEKLY routine ties each day to a weekday; a ROTATION routine
+ * runs its days in `order`, each after the last completed one, whatever the
+ * weekday.
+ */
+declare const ROUTINE_SCHEDULE_MODES: readonly ["WEEKLY", "ROTATION"];
+type RoutineScheduleMode = (typeof ROUTINE_SCHEDULE_MODES)[number];
+/** At most seven days in either mode. */
+declare const ROUTINE_DAYS_MAX = 7;
+declare const ROUTINE_DAY_NAME_MAX = 40;
+/**
+ * How a routine day is named everywhere, including history snapshots taken
+ * before ROUT-11: its own name, else its weekday, else its rotation letter
+ * ("Day A" for order 0).
+ */
+declare function routineDayLabel(day: {
+    name?: string | null;
+    dayOfWeek?: number | null;
+    order?: number | null;
+}): string;
 interface RoutineSet {
     setNumber: number;
     repType: RepType;
@@ -1129,12 +1162,18 @@ interface CreateRoutineExerciseInput {
 }
 interface RoutineDay {
     id: string;
-    dayOfWeek: number;
+    /** 0=Sun..6=Sat on a WEEKLY routine; null on a ROTATION routine. */
+    dayOfWeek: number | null;
+    /** Optional label such as "Push" or "Upper A" (see `routineDayLabel`). */
+    name: string | null;
+    /** Rotation sequence, 0-based; also the display order. */
     order: number;
     exercises: RoutineExercise[];
 }
 interface CreateRoutineDayInput {
-    dayOfWeek: number;
+    /** Required and unique on a WEEKLY routine; omitted or null on a ROTATION. */
+    dayOfWeek?: number | null;
+    name?: string | null;
     order?: number;
     exercises: CreateRoutineExerciseInput[];
 }
@@ -1146,6 +1185,12 @@ interface Routine {
     isPeriodized: boolean;
     isFavorite: boolean;
     isCompleted: boolean;
+    scheduleMode: RoutineScheduleMode;
+    /**
+     * ROTATION only: the day after the one of the last completed session (an
+     * aborted session does not advance it), or the first day before any.
+     */
+    nextRotationDayId: string | null;
     days: RoutineDay[];
     createdAt: IsoDateString;
     updatedAt: IsoDateString;
@@ -1154,8 +1199,10 @@ interface CreateRoutineRequest {
     name: string;
     description?: string;
     isPeriodized: boolean;
+    /** Defaults to WEEKLY. Changing it on update requires `days`. */
+    scheduleMode?: RoutineScheduleMode;
     days: CreateRoutineDayInput[];
 }
 type UpdateRoutineRequest = Partial<CreateRoutineRequest>;
 
-export { ACHIEVEMENT_CATEGORIES, ACHIEVEMENT_DEFINITIONS, type AchievementCategory, type AchievementCategoryProgress, type AchievementDefinition, type AchievementUnlockedEventPayload, type AchievementsResponse, type Brand, type CreateRoutineDayInput, type CreateRoutineExerciseInput, type CreateRoutineRequest, type CreateSessionShareRequest, EXERCISE_EQUIPMENT, EXERCISE_MECHANICS, type EarnedAchievement, type EarnedPersonalRecord, type Exercise, type ExerciseEquipment, type ExerciseId, type ExerciseMechanic, type ExercisePerformanceHistoryQuery, type ExercisePerformanceHistoryResponse, type ExercisePerformancePrescription, type ExercisePerformancePrescriptionSet, type ExercisePerformanceSession, type ExercisePerformanceSet, type ExercisePerformanceSummary, type ExercisePlateau, type ExerciseStrengthSummary, type ExerciseStrengthTrendPoint, type ExerciseStrengthTrendQuery, type ExerciseStrengthTrendResponse, FOLLOW_SUGGESTIONS_DEFAULT_LIMIT, FOLLOW_SUGGESTIONS_MAX_LIMIT, FOLLOW_SUGGESTION_REASONS, type FinishStatus, type FinishWorkoutRequest, type FinishWorkoutResponse, type FollowSuggestion, type FollowSuggestionReason, type FollowSuggestionsResponse, type IsoDateString, type ListSessionsParams, MEASURABLE_GOALS_MAX, MEASURABLE_GOAL_DIRECTIONS, MEASURABLE_GOAL_TYPES, MOVEMENT_PATTERNS, MUSCLE_GROUPS, type MeasurableGoal, type MeasurableGoalDirection, type MeasurableGoalExercise, type MeasurableGoalInput, type MeasurableGoalType, type MovementPattern, type MuscleGroup, type MuscleGroupHeatmapQuery, type MuscleGroupHeatmapResponse, type MuscleGroupHeatmapValue, type MuscleGroupHeatmapWeek, type MuscleVolumeTrendSeries, PLATEAU_MIN_DAYS_SINCE_BEST, PLATEAU_MIN_SESSIONS, PLATEAU_RECENT_DAYS, PLATEAU_WINDOW_DAYS, 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, PROGRESS_TIMELINE_EVENT_TYPES, type PaginatedResponse, type PersonalGoalProgress, type PersonalGoalsResponse, type PersonalRecordEntry, type PersonalRecordKind, type PlatePairInventory, type PlateauSet, type PlateausResponse, type PreferredTrainingStyle, type PreviousPerformanceResponse, type PreviousSessionRecap, type PreviousSetPerformance, type ProfileDiscoverySettings, type ProfileFavoriteExercise, type ProfilePrivacySettings, type ProfileViewerAccess, type ProfileVisibility, type ProgressTimelineEventType, type ProgressTimelineItem, type ProgressTimelinePersonalRecordItem, type ProgressTimelineProgressionItem, type ProgressTimelineQuery, type ProgressTimelineRecordPerformance, type ProgressTimelineRecordReason, type ProgressTimelineResponse, type ProgressTimelineSessionContext, type ProgressionChange, type ProgressionRule, type ProgressionScheme, type ProgressionSetChange, type PublicBodyMetrics, type PublicTrainingSummary, type PublicUserProfile, RELATIONSHIP_LIST_DEFAULT_LIMIT, RELATIONSHIP_LIST_KINDS, RELATIONSHIP_LIST_MAX_LIMIT, RENAISSANCE_RANK_DEFINITIONS, REP_TYPES, RESERVED_USERNAMES, type RecentActivityEntry, type RelationshipListKind, type RelationshipListQuery, type RelationshipListResponse, type RelationshipMember, type RenaissanceRankDefinition, type RenaissanceRankProgress, type RepType, type ReplaceMeasurableGoalsRequest, type ReplaceTrainingLocationsRequest, type Routine, type RoutineDay, type RoutineDayId, type RoutineExercise, type RoutineId, type RoutineSet, SESSION_SHARE_DEFAULT_FIELDS, SESSION_SHARE_FIELDS, SESSION_SHARE_MAX_ACTIVE_LINKS, SEXES, STARRED_EXERCISES_MAX, type SessionComparisonExercise, type SessionComparisonQuery, type SessionComparisonResponse, type SessionComparisonRoutineDay, type SessionComparisonSession, type SessionComparisonSet, type SessionExerciseSubstitution, type SessionRecapRecord, type SessionShare, type SessionShareField, type SessionShareListResponse, type SetAccountTimeZoneRequest, type SetLog, type Sex, type SharedSessionOwner, type SharedSessionRecap, type StarredExercise, type StarredExercisesResponse, type StartWorkoutRequest, type StartWorkoutResponse, type StreakMilestoneEventPayload, type SubstituteSessionExerciseRequest, type SubstituteSessionExerciseResponse, 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, type VolumeTrendPoint, type VolumeTrendQuery, type VolumeTrendResponse, type VolumeTrendSeries, 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 { ACHIEVEMENT_CATEGORIES, ACHIEVEMENT_DEFINITIONS, type AchievementCategory, type AchievementCategoryProgress, type AchievementDefinition, type AchievementUnlockedEventPayload, type AchievementsResponse, type Brand, type CreateRoutineDayInput, type CreateRoutineExerciseInput, type CreateRoutineRequest, type CreateSessionShareRequest, EXERCISE_EQUIPMENT, EXERCISE_MECHANICS, type EarnedAchievement, type EarnedPersonalRecord, type Exercise, type ExerciseEquipment, type ExerciseId, type ExerciseMechanic, type ExercisePerformanceHistoryQuery, type ExercisePerformanceHistoryResponse, type ExercisePerformancePrescription, type ExercisePerformancePrescriptionSet, type ExercisePerformanceSession, type ExercisePerformanceSet, type ExercisePerformanceSummary, type ExercisePlateau, type ExerciseStrengthSummary, type ExerciseStrengthTrendPoint, type ExerciseStrengthTrendQuery, type ExerciseStrengthTrendResponse, FOLLOW_SUGGESTIONS_DEFAULT_LIMIT, FOLLOW_SUGGESTIONS_MAX_LIMIT, FOLLOW_SUGGESTION_REASONS, type FinishStatus, type FinishWorkoutRequest, type FinishWorkoutResponse, type FollowSuggestion, type FollowSuggestionReason, type FollowSuggestionsResponse, type IsoDateString, type ListSessionsParams, MEASURABLE_GOALS_MAX, MEASURABLE_GOAL_DIRECTIONS, MEASURABLE_GOAL_TYPES, MOVEMENT_PATTERNS, MUSCLE_GROUPS, type MeasurableGoal, type MeasurableGoalDirection, type MeasurableGoalExercise, type MeasurableGoalInput, type MeasurableGoalType, type MovementPattern, type MuscleGroup, type MuscleGroupHeatmapQuery, type MuscleGroupHeatmapResponse, type MuscleGroupHeatmapValue, type MuscleGroupHeatmapWeek, type MuscleVolumeTrendSeries, PLATEAU_MIN_DAYS_SINCE_BEST, PLATEAU_MIN_SESSIONS, PLATEAU_MIN_SESSIONS_MAX, PLATEAU_MIN_SESSIONS_MIN, PLATEAU_RECENT_DAYS, PLATEAU_WINDOW_DAYS, 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, PROGRESS_TIMELINE_EVENT_TYPES, type PaginatedResponse, type PersonalGoalProgress, type PersonalGoalsResponse, type PersonalRecordEntry, type PersonalRecordKind, type PlatePairInventory, type PlateauPreferences, type PlateauSet, type PlateausResponse, type PreferredTrainingStyle, type PreviousPerformanceResponse, type PreviousSessionRecap, type PreviousSetPerformance, type ProfileDiscoverySettings, type ProfileFavoriteExercise, type ProfilePrivacySettings, type ProfileViewerAccess, type ProfileVisibility, type ProgressTimelineEventType, type ProgressTimelineItem, type ProgressTimelinePersonalRecordItem, type ProgressTimelineProgressionItem, type ProgressTimelineQuery, type ProgressTimelineRecordPerformance, type ProgressTimelineRecordReason, type ProgressTimelineResponse, type ProgressTimelineSessionContext, type ProgressionChange, type ProgressionRule, type ProgressionScheme, type ProgressionSetChange, type PublicBodyMetrics, type PublicTrainingSummary, type PublicUserProfile, RELATIONSHIP_LIST_DEFAULT_LIMIT, RELATIONSHIP_LIST_KINDS, RELATIONSHIP_LIST_MAX_LIMIT, RENAISSANCE_RANK_DEFINITIONS, REP_TYPES, RESERVED_USERNAMES, ROUTINE_DAYS_MAX, ROUTINE_DAY_NAME_MAX, ROUTINE_SCHEDULE_MODES, type RecentActivityEntry, type RelationshipListKind, type RelationshipListQuery, type RelationshipListResponse, type RelationshipMember, type RenaissanceRankDefinition, type RenaissanceRankProgress, type RepType, type ReplaceMeasurableGoalsRequest, type ReplaceTrainingLocationsRequest, type Routine, type RoutineDay, type RoutineDayId, type RoutineExercise, type RoutineId, type RoutineScheduleMode, type RoutineSet, SESSION_SHARE_DEFAULT_FIELDS, SESSION_SHARE_FIELDS, SESSION_SHARE_MAX_ACTIVE_LINKS, SEXES, STARRED_EXERCISES_MAX, type SessionComparisonExercise, type SessionComparisonQuery, type SessionComparisonResponse, type SessionComparisonRoutineDay, type SessionComparisonSession, type SessionComparisonSet, type SessionExerciseSubstitution, type SessionRecapRecord, type SessionShare, type SessionShareField, type SessionShareListResponse, type SetAccountTimeZoneRequest, type SetLog, type Sex, type SharedSessionOwner, type SharedSessionRecap, type StarredExercise, type StarredExercisesResponse, type StartWorkoutRequest, type StartWorkoutResponse, type StreakMilestoneEventPayload, type SubstituteSessionExerciseRequest, type SubstituteSessionExerciseResponse, 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, type VolumeTrendPoint, type VolumeTrendQuery, type VolumeTrendResponse, type VolumeTrendSeries, 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, routineDayLabel };

package/dist/index.js

@@ -276,6 +276,31 @@ var RENAISSANCE_RANK_DEFINITIONS = [
   }
 ];
 
+// src/routine.ts
+var ROUTINE_SCHEDULE_MODES = ["WEEKLY", "ROTATION"];
+var ROUTINE_DAYS_MAX = 7;
+var ROUTINE_DAY_NAME_MAX = 40;
+var WEEKDAY_NAMES = [
+  "Sunday",
+  "Monday",
+  "Tuesday",
+  "Wednesday",
+  "Thursday",
+  "Friday",
+  "Saturday"
+];
+function routineDayLabel(day) {
+  const name = day.name?.trim();
+  if (name) return name;
+  if (typeof day.dayOfWeek === "number") {
+    return WEEKDAY_NAMES[day.dayOfWeek] ?? "";
+  }
+  if (typeof day.order === "number" && day.order >= 0 && day.order < 26) {
+    return `Day ${String.fromCharCode(65 + day.order)}`;
+  }
+  return "";
+}
+
 // src/workout.ts
 var SESSION_SHARE_FIELDS = [
   "duration",
@@ -309,6 +334,8 @@ var PLATEAU_WINDOW_DAYS = 56;
 var PLATEAU_MIN_SESSIONS = 4;
 var PLATEAU_MIN_DAYS_SINCE_BEST = 21;
 var PLATEAU_RECENT_DAYS = 21;
+var PLATEAU_MIN_SESSIONS_MIN = 3;
+var PLATEAU_MIN_SESSIONS_MAX = 8;
 export {
   ACHIEVEMENT_CATEGORIES,
   ACHIEVEMENT_DEFINITIONS,
@@ -324,6 +351,8 @@ export {
   MUSCLE_GROUPS,
   PLATEAU_MIN_DAYS_SINCE_BEST,
   PLATEAU_MIN_SESSIONS,
+  PLATEAU_MIN_SESSIONS_MAX,
+  PLATEAU_MIN_SESSIONS_MIN,
   PLATEAU_RECENT_DAYS,
   PLATEAU_WINDOW_DAYS,
   PREFERRED_TRAINING_STYLE_VALUES,
@@ -341,6 +370,9 @@ export {
   RENAISSANCE_RANK_DEFINITIONS,
   REP_TYPES,
   RESERVED_USERNAMES,
+  ROUTINE_DAYS_MAX,
+  ROUTINE_DAY_NAME_MAX,
+  ROUTINE_SCHEDULE_MODES,
   SESSION_SHARE_DEFAULT_FIELDS,
   SESSION_SHARE_FIELDS,
   SESSION_SHARE_MAX_ACTIVE_LINKS,
@@ -354,5 +386,6 @@ export {
   USERNAME_MIN_LENGTH,
   USERNAME_PATTERN_SOURCE,
   WEIGHT_UNITS,
-  WORKOUT_SESSION_STATUSES
+  WORKOUT_SESSION_STATUSES,
+  routineDayLabel
 };

package/package.json

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