@sunsteel/contracts 0.42.0 → 0.44.0

package/dist/index.cjs

@@ -29,6 +29,9 @@ __export(index_exports, {
   COMEBACK_WINDOW_DAYS: () => COMEBACK_WINDOW_DAYS,
   EXERCISE_EQUIPMENT: () => EXERCISE_EQUIPMENT,
   EXERCISE_MECHANICS: () => EXERCISE_MECHANICS,
+  FEATURED_PROFILE_ITEMS_MAX: () => FEATURED_PROFILE_ITEMS_MAX,
+  FEATURED_PROFILE_ITEM_KINDS: () => FEATURED_PROFILE_ITEM_KINDS,
+  FEATURED_PROFILE_REFERENCE_MAX_LENGTH: () => FEATURED_PROFILE_REFERENCE_MAX_LENGTH,
   FOLLOW_SUGGESTIONS_DEFAULT_LIMIT: () => FOLLOW_SUGGESTIONS_DEFAULT_LIMIT,
   FOLLOW_SUGGESTIONS_MAX_LIMIT: () => FOLLOW_SUGGESTIONS_MAX_LIMIT,
   FOLLOW_SUGGESTION_REASONS: () => FOLLOW_SUGGESTION_REASONS,
@@ -37,6 +40,10 @@ __export(index_exports, {
   MEASURABLE_GOAL_TYPES: () => MEASURABLE_GOAL_TYPES,
   MOVEMENT_PATTERNS: () => MOVEMENT_PATTERNS,
   MUSCLE_GROUPS: () => MUSCLE_GROUPS,
+  NOTIFICATIONS_LIST_LIMIT: () => NOTIFICATIONS_LIST_LIMIT,
+  NOTIFICATIONS_LOOKBACK_DAYS: () => NOTIFICATIONS_LOOKBACK_DAYS,
+  NOTIFICATIONS_RETENTION_DAYS: () => NOTIFICATIONS_RETENTION_DAYS,
+  NOTIFICATION_KINDS: () => NOTIFICATION_KINDS,
   PLATEAU_MIN_DAYS_SINCE_BEST: () => PLATEAU_MIN_DAYS_SINCE_BEST,
   PLATEAU_MIN_SESSIONS: () => PLATEAU_MIN_SESSIONS,
   PLATEAU_MIN_SESSIONS_MAX: () => PLATEAU_MIN_SESSIONS_MAX,
@@ -196,6 +203,13 @@ var PREFERRED_TRAINING_STYLE_VALUES = [
   "BODY_PART_SPLIT",
   "CIRCUIT"
 ];
+var FEATURED_PROFILE_ITEM_KINDS = [
+  "RECORD",
+  "ACHIEVEMENT",
+  "RANK"
+];
+var FEATURED_PROFILE_ITEMS_MAX = 6;
+var FEATURED_PROFILE_REFERENCE_MAX_LENGTH = 100;
 var RELATIONSHIP_LIST_KINDS = [
   "followers",
   "following",
@@ -438,6 +452,16 @@ var PLATEAU_MIN_DAYS_SINCE_BEST = 21;
 var PLATEAU_RECENT_DAYS = 21;
 var PLATEAU_MIN_SESSIONS_MIN = 3;
 var PLATEAU_MIN_SESSIONS_MAX = 8;
+
+// src/notifications.ts
+var NOTIFICATION_KINDS = [
+  "ACHIEVEMENT",
+  "SESSION_PROGRESS",
+  "NEW_FOLLOWER"
+];
+var NOTIFICATIONS_LOOKBACK_DAYS = 30;
+var NOTIFICATIONS_RETENTION_DAYS = 90;
+var NOTIFICATIONS_LIST_LIMIT = 50;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ACHIEVEMENT_CATEGORIES,
@@ -449,6 +473,9 @@ var PLATEAU_MIN_SESSIONS_MAX = 8;
   COMEBACK_WINDOW_DAYS,
   EXERCISE_EQUIPMENT,
   EXERCISE_MECHANICS,
+  FEATURED_PROFILE_ITEMS_MAX,
+  FEATURED_PROFILE_ITEM_KINDS,
+  FEATURED_PROFILE_REFERENCE_MAX_LENGTH,
   FOLLOW_SUGGESTIONS_DEFAULT_LIMIT,
   FOLLOW_SUGGESTIONS_MAX_LIMIT,
   FOLLOW_SUGGESTION_REASONS,
@@ -457,6 +484,10 @@ var PLATEAU_MIN_SESSIONS_MAX = 8;
   MEASURABLE_GOAL_TYPES,
   MOVEMENT_PATTERNS,
   MUSCLE_GROUPS,
+  NOTIFICATIONS_LIST_LIMIT,
+  NOTIFICATIONS_LOOKBACK_DAYS,
+  NOTIFICATIONS_RETENTION_DAYS,
+  NOTIFICATION_KINDS,
   PLATEAU_MIN_DAYS_SINCE_BEST,
   PLATEAU_MIN_SESSIONS,
   PLATEAU_MIN_SESSIONS_MAX,

package/dist/index.d.cts

@@ -677,6 +677,141 @@ interface PlateausResponse {
     plateaus: ExercisePlateau[];
 }
 
+declare const ACHIEVEMENT_CATEGORIES: readonly ["SESSIONS", "SETS", "VOLUME_KG", "RECORDS", "STREAK_DAYS"];
+type AchievementCategory = (typeof ACHIEVEMENT_CATEGORIES)[number];
+interface AchievementDefinition {
+    id: string;
+    category: AchievementCategory;
+    threshold: number;
+    title: string;
+    description: string;
+}
+/** Stable milestone catalog shared by the writer and every presentation. */
+declare const ACHIEVEMENT_DEFINITIONS: readonly AchievementDefinition[];
+interface AchievementUnlockedEventPayload extends AchievementDefinition {
+    schemaVersion: 1;
+    backfilled: boolean;
+}
+interface StreakMilestoneEventPayload {
+    schemaVersion: 1;
+    achievementId: string;
+    streakDays: number;
+    backfilled: boolean;
+}
+interface EarnedAchievement extends AchievementDefinition {
+    eventId: string;
+    unlockedAt: IsoDateString;
+    sourceSessionId: string | null;
+    /** True when existing verified history was recognized after ACH-01 shipped. */
+    backfilled: boolean;
+}
+interface RenaissanceRankDefinition {
+    id: 'INITIATE' | 'APPRENTICE' | 'ARTISAN' | 'MAESTRO' | 'VIRTUOSO' | 'LAUREATE';
+    title: string;
+    description: string;
+    minimumSessions: number;
+    minimumActiveWeeks: number;
+}
+/**
+ * Stable rank ladder. Both requirements are intentionally based on attendance:
+ * completed sessions reward participation, while distinct active weeks reward
+ * consistency without encouraging consecutive-day training.
+ */
+declare const RENAISSANCE_RANK_DEFINITIONS: readonly [{
+    readonly id: "INITIATE";
+    readonly title: "Initiate";
+    readonly description: "Your place in the training ledger begins here.";
+    readonly minimumSessions: 0;
+    readonly minimumActiveWeeks: 0;
+}, {
+    readonly id: "APPRENTICE";
+    readonly title: "Apprentice";
+    readonly description: "Learning the craft through regular practice.";
+    readonly minimumSessions: 5;
+    readonly minimumActiveWeeks: 3;
+}, {
+    readonly id: "ARTISAN";
+    readonly title: "Artisan";
+    readonly description: "Building a dependable training practice.";
+    readonly minimumSessions: 15;
+    readonly minimumActiveWeeks: 8;
+}, {
+    readonly id: "MAESTRO";
+    readonly title: "Maestro";
+    readonly description: "Sustaining purposeful work across many weeks.";
+    readonly minimumSessions: 30;
+    readonly minimumActiveWeeks: 16;
+}, {
+    readonly id: "VIRTUOSO";
+    readonly title: "Virtuoso";
+    readonly description: "Showing enduring discipline through repeated seasons.";
+    readonly minimumSessions: 60;
+    readonly minimumActiveWeeks: 32;
+}, {
+    readonly id: "LAUREATE";
+    readonly title: "Laureate";
+    readonly description: "A lasting training practice recorded in the ledger.";
+    readonly minimumSessions: 100;
+    readonly minimumActiveWeeks: 52;
+}];
+interface RenaissanceRankProgress {
+    currentRank: RenaissanceRankDefinition;
+    nextRank: RenaissanceRankDefinition | null;
+    completedSessions: number;
+    activeWeeks: number;
+    sessionsRemaining: number;
+    activeWeeksRemaining: number;
+}
+/**
+ * Current verified total and the next fixed catalog milestone for one category.
+ * A null next milestone means the category's finite catalog is complete.
+ */
+interface AchievementCategoryProgress {
+    category: AchievementCategory;
+    currentValue: number;
+    nextMilestone: AchievementDefinition | null;
+    remaining: number;
+}
+/**
+ * ACH-05 recognises a return only after the athlete has rebuilt a small,
+ * recovery-compatible pattern. The break is counted as full local calendar
+ * days without a completed session; repeated sessions on one date count once.
+ */
+declare const COMEBACK_MIN_INACTIVE_DAYS = 14;
+declare const COMEBACK_REQUIRED_ACTIVE_DAYS = 3;
+declare const COMEBACK_WINDOW_DAYS = 14;
+declare const COMEBACK_SESSION_LOOKBACK = 500;
+declare const COMEBACK_RECOGNITION_LIMIT = 20;
+interface ComebackRecognition {
+    id: string;
+    inactiveDays: number;
+    returnedAt: IsoDateString;
+    recognizedAt: IsoDateString;
+    sourceSessionId: string;
+    activeDays: number;
+    /** Inclusive local-calendar span from the return through recognition. */
+    windowDays: number;
+}
+interface ComebackRecognitionSummary {
+    minimumInactiveDays: number;
+    requiredActiveDays: number;
+    windowDays: number;
+    /** Most recent first, capped by COMEBACK_RECOGNITION_LIMIT. */
+    recognitions: ComebackRecognition[];
+    /** True when older completed-session events fell outside the bounded scan. */
+    historyTruncated: boolean;
+}
+/** Stable successful response of GET /achievements. */
+interface AchievementsResponse {
+    analyticsReady: boolean;
+    earnedCount: number;
+    availableCount: number;
+    achievements: EarnedAchievement[];
+    rank: RenaissanceRankProgress | null;
+    milestoneProgress: AchievementCategoryProgress[];
+    comeback: ComebackRecognitionSummary | null;
+}
+
 declare const USERNAME_MIN_LENGTH = 3;
 declare const USERNAME_MAX_LENGTH = 30;
 declare const USERNAME_PATTERN_SOURCE = "^[a-z0-9][a-z0-9_-]{1,28}[a-z0-9]$";
@@ -744,6 +879,40 @@ interface PublicBodyMetrics {
     weightKg?: number | null;
     heightCm?: number | null;
 }
+declare const FEATURED_PROFILE_ITEM_KINDS: readonly ["RECORD", "ACHIEVEMENT", "RANK"];
+type FeaturedProfileItemKind = (typeof FEATURED_PROFILE_ITEM_KINDS)[number];
+declare const FEATURED_PROFILE_ITEMS_MAX = 6;
+declare const FEATURED_PROFILE_REFERENCE_MAX_LENGTH = 100;
+/** Owner-supplied selection. Array order becomes the public display order. */
+interface FeaturedProfileSelectionInput {
+    kind: FeaturedProfileItemKind;
+    referenceId: string;
+}
+/** Stored selection returned to its owner, ordered by `position`. */
+interface FeaturedProfileSelection extends FeaturedProfileSelectionInput {
+    position: number;
+}
+interface FeaturedProfileSelectionsResponse {
+    items: FeaturedProfileSelection[];
+}
+interface ReplaceFeaturedProfileItemsRequest {
+    items: FeaturedProfileSelectionInput[];
+}
+type FeaturedProfileItemBase = FeaturedProfileSelection;
+interface FeaturedProfileRecordItem extends FeaturedProfileItemBase {
+    kind: 'RECORD';
+    record: PersonalRecordEntry;
+}
+interface FeaturedProfileAchievementItem extends FeaturedProfileItemBase {
+    kind: 'ACHIEVEMENT';
+    achievement: EarnedAchievement;
+}
+interface FeaturedProfileRankItem extends FeaturedProfileItemBase {
+    kind: 'RANK';
+    rank: RenaissanceRankDefinition;
+}
+/** Privacy-filtered, currently valid selections in owner-defined order. */
+type FeaturedProfileItem = FeaturedProfileRecordItem | FeaturedProfileAchievementItem | FeaturedProfileRankItem;
 interface UserProfile {
     timeZone?: string | null;
     id: string;
@@ -784,6 +953,7 @@ interface PublicUserProfile {
     viewerAccess: ProfileViewerAccess;
     trainingSummary?: PublicTrainingSummary;
     personalRecords?: PersonalRecordEntry[];
+    featuredItems: FeaturedProfileItem[];
     bodyMetrics?: PublicBodyMetrics;
 }
 interface UpdateProfileRequest {
@@ -1002,141 +1172,6 @@ interface PersonalGoalsResponse {
     goals: PersonalGoalProgress[];
 }
 
-declare const ACHIEVEMENT_CATEGORIES: readonly ["SESSIONS", "SETS", "VOLUME_KG", "RECORDS", "STREAK_DAYS"];
-type AchievementCategory = (typeof ACHIEVEMENT_CATEGORIES)[number];
-interface AchievementDefinition {
-    id: string;
-    category: AchievementCategory;
-    threshold: number;
-    title: string;
-    description: string;
-}
-/** Stable milestone catalog shared by the writer and every presentation. */
-declare const ACHIEVEMENT_DEFINITIONS: readonly AchievementDefinition[];
-interface AchievementUnlockedEventPayload extends AchievementDefinition {
-    schemaVersion: 1;
-    backfilled: boolean;
-}
-interface StreakMilestoneEventPayload {
-    schemaVersion: 1;
-    achievementId: string;
-    streakDays: number;
-    backfilled: boolean;
-}
-interface EarnedAchievement extends AchievementDefinition {
-    eventId: string;
-    unlockedAt: IsoDateString;
-    sourceSessionId: string | null;
-    /** True when existing verified history was recognized after ACH-01 shipped. */
-    backfilled: boolean;
-}
-interface RenaissanceRankDefinition {
-    id: 'INITIATE' | 'APPRENTICE' | 'ARTISAN' | 'MAESTRO' | 'VIRTUOSO' | 'LAUREATE';
-    title: string;
-    description: string;
-    minimumSessions: number;
-    minimumActiveWeeks: number;
-}
-/**
- * Stable rank ladder. Both requirements are intentionally based on attendance:
- * completed sessions reward participation, while distinct active weeks reward
- * consistency without encouraging consecutive-day training.
- */
-declare const RENAISSANCE_RANK_DEFINITIONS: readonly [{
-    readonly id: "INITIATE";
-    readonly title: "Initiate";
-    readonly description: "Your place in the training ledger begins here.";
-    readonly minimumSessions: 0;
-    readonly minimumActiveWeeks: 0;
-}, {
-    readonly id: "APPRENTICE";
-    readonly title: "Apprentice";
-    readonly description: "Learning the craft through regular practice.";
-    readonly minimumSessions: 5;
-    readonly minimumActiveWeeks: 3;
-}, {
-    readonly id: "ARTISAN";
-    readonly title: "Artisan";
-    readonly description: "Building a dependable training practice.";
-    readonly minimumSessions: 15;
-    readonly minimumActiveWeeks: 8;
-}, {
-    readonly id: "MAESTRO";
-    readonly title: "Maestro";
-    readonly description: "Sustaining purposeful work across many weeks.";
-    readonly minimumSessions: 30;
-    readonly minimumActiveWeeks: 16;
-}, {
-    readonly id: "VIRTUOSO";
-    readonly title: "Virtuoso";
-    readonly description: "Showing enduring discipline through repeated seasons.";
-    readonly minimumSessions: 60;
-    readonly minimumActiveWeeks: 32;
-}, {
-    readonly id: "LAUREATE";
-    readonly title: "Laureate";
-    readonly description: "A lasting training practice recorded in the ledger.";
-    readonly minimumSessions: 100;
-    readonly minimumActiveWeeks: 52;
-}];
-interface RenaissanceRankProgress {
-    currentRank: RenaissanceRankDefinition;
-    nextRank: RenaissanceRankDefinition | null;
-    completedSessions: number;
-    activeWeeks: number;
-    sessionsRemaining: number;
-    activeWeeksRemaining: number;
-}
-/**
- * Current verified total and the next fixed catalog milestone for one category.
- * A null next milestone means the category's finite catalog is complete.
- */
-interface AchievementCategoryProgress {
-    category: AchievementCategory;
-    currentValue: number;
-    nextMilestone: AchievementDefinition | null;
-    remaining: number;
-}
-/**
- * ACH-05 recognises a return only after the athlete has rebuilt a small,
- * recovery-compatible pattern. The break is counted as full local calendar
- * days without a completed session; repeated sessions on one date count once.
- */
-declare const COMEBACK_MIN_INACTIVE_DAYS = 14;
-declare const COMEBACK_REQUIRED_ACTIVE_DAYS = 3;
-declare const COMEBACK_WINDOW_DAYS = 14;
-declare const COMEBACK_SESSION_LOOKBACK = 500;
-declare const COMEBACK_RECOGNITION_LIMIT = 20;
-interface ComebackRecognition {
-    id: string;
-    inactiveDays: number;
-    returnedAt: IsoDateString;
-    recognizedAt: IsoDateString;
-    sourceSessionId: string;
-    activeDays: number;
-    /** Inclusive local-calendar span from the return through recognition. */
-    windowDays: number;
-}
-interface ComebackRecognitionSummary {
-    minimumInactiveDays: number;
-    requiredActiveDays: number;
-    windowDays: number;
-    /** Most recent first, capped by COMEBACK_RECOGNITION_LIMIT. */
-    recognitions: ComebackRecognition[];
-    /** True when older completed-session events fell outside the bounded scan. */
-    historyTruncated: boolean;
-}
-/** Stable successful response of GET /achievements. */
-interface AchievementsResponse {
-    analyticsReady: boolean;
-    earnedCount: number;
-    availableCount: number;
-    achievements: EarnedAchievement[];
-    rank: RenaissanceRankProgress | null;
-    milestoneProgress: AchievementCategoryProgress[];
-    comeback: ComebackRecognitionSummary | null;
-}
-
 /**
  * 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
@@ -1376,4 +1411,71 @@ interface SkipOccurrenceRequest {
     date: CalendarDate;
 }
 
-export { ACHIEVEMENT_CATEGORIES, ACHIEVEMENT_DEFINITIONS, type AchievementCategory, type AchievementCategoryProgress, type AchievementDefinition, type AchievementUnlockedEventPayload, type AchievementsResponse, type Brand, COMEBACK_MIN_INACTIVE_DAYS, COMEBACK_RECOGNITION_LIMIT, COMEBACK_REQUIRED_ACTIVE_DAYS, COMEBACK_SESSION_LOOKBACK, COMEBACK_WINDOW_DAYS, type CalendarDate, type ComebackRecognition, type ComebackRecognitionSummary, type CreateRoutineDayInput, type CreateRoutineExerciseInput, type CreateRoutineRequest, type CreateRoutineVersionRequest, 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 MoveOccurrenceRequest, 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, ROUTINE_VERSIONS_MAX, ROUTINE_VERSION_KINDS, ROUTINE_VERSION_NAME_MAX, type RecentActivityEntry, type RelationshipListKind, type RelationshipListQuery, type RelationshipListResponse, type RelationshipMember, type RenaissanceRankDefinition, type RenaissanceRankProgress, type RepType, type ReplaceMeasurableGoalsRequest, type ReplaceTrainingLocationsRequest, type RestoreRoutineVersionResponse, type Routine, type RoutineDay, type RoutineDayId, type RoutineExercise, type RoutineId, type RoutineScheduleMode, type RoutineSet, type RoutineVersion, type RoutineVersionDay, type RoutineVersionExercise, type RoutineVersionKind, type RoutineVersionSetup, type RoutineVersionsResponse, SCHEDULE_MOVE_MAX_DAYS, SCHEDULE_OVERRIDES_MAX_RANGE_DAYS, SCHEDULE_OVERRIDE_KINDS, SCHEDULE_SKIP_PAST_DAYS, SESSION_SHARE_DEFAULT_FIELDS, SESSION_SHARE_FIELDS, SESSION_SHARE_MAX_ACTIVE_LINKS, SEXES, STARRED_EXERCISES_MAX, type ScheduleOverride, type ScheduleOverrideKind, type ScheduleOverridesQuery, type ScheduleOverridesResponse, 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 SkipOccurrenceRequest, 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 };
+/**
+ * What a stored notification announces. Each one is gathered from a record
+ * that already exists: an achievement earned live (never one recognized from
+ * history), a finished session that set records or changed loads, and a new
+ * follower.
+ */
+declare const NOTIFICATION_KINDS: readonly ["ACHIEVEMENT", "SESSION_PROGRESS", "NEW_FOLLOWER"];
+type NotificationKind = (typeof NOTIFICATION_KINDS)[number];
+/** Sources older than this many days are never gathered. */
+declare const NOTIFICATIONS_LOOKBACK_DAYS = 30;
+/** Notifications are kept this many days, then removed. */
+declare const NOTIFICATIONS_RETENTION_DAYS = 90;
+/** The list returns at most this many, newest first. */
+declare const NOTIFICATIONS_LIST_LIMIT = 50;
+interface NotificationBase {
+    id: string;
+    /** When the announced thing happened, not when it was gathered. */
+    createdAt: IsoDateString;
+    readAt: IsoDateString | null;
+}
+interface AchievementNotification extends NotificationBase {
+    kind: 'ACHIEVEMENT';
+    achievement: {
+        id: string;
+        title: string;
+        description: string;
+    };
+}
+interface SessionProgressNotification extends NotificationBase {
+    kind: 'SESSION_PROGRESS';
+    session: {
+        id: string;
+        routineName: string;
+        dayName: string | null;
+        /** Exercises with a new personal record in the session. */
+        recordCount: number;
+        /** Exercises whose next prescription the session changed. */
+        progressionCount: number;
+    };
+}
+interface NewFollowerNotification extends NotificationBase {
+    kind: 'NEW_FOLLOWER';
+    actor: {
+        id: string;
+        username: string;
+        name: string;
+        lastName: string | null;
+        avatarUrl: string | null;
+        /** Whether the recipient follows them back now. */
+        isFollowedByMe: boolean;
+    };
+}
+/** Named to stay clear of the DOM's `Notification`. */
+type AppNotification = AchievementNotification | SessionProgressNotification | NewFollowerNotification;
+/** GET /notifications */
+interface NotificationsResponse {
+    notifications: AppNotification[];
+    unreadCount: number;
+}
+/** POST /notifications/read. Without ids, every notification is marked read. */
+interface MarkNotificationsReadRequest {
+    ids?: string[];
+}
+interface MarkNotificationsReadResponse {
+    unreadCount: number;
+}
+
+export { ACHIEVEMENT_CATEGORIES, ACHIEVEMENT_DEFINITIONS, type AchievementCategory, type AchievementCategoryProgress, type AchievementDefinition, type AchievementNotification, type AchievementUnlockedEventPayload, type AchievementsResponse, type AppNotification, type Brand, COMEBACK_MIN_INACTIVE_DAYS, COMEBACK_RECOGNITION_LIMIT, COMEBACK_REQUIRED_ACTIVE_DAYS, COMEBACK_SESSION_LOOKBACK, COMEBACK_WINDOW_DAYS, type CalendarDate, type ComebackRecognition, type ComebackRecognitionSummary, type CreateRoutineDayInput, type CreateRoutineExerciseInput, type CreateRoutineRequest, type CreateRoutineVersionRequest, 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, FEATURED_PROFILE_ITEMS_MAX, FEATURED_PROFILE_ITEM_KINDS, FEATURED_PROFILE_REFERENCE_MAX_LENGTH, FOLLOW_SUGGESTIONS_DEFAULT_LIMIT, FOLLOW_SUGGESTIONS_MAX_LIMIT, FOLLOW_SUGGESTION_REASONS, type FeaturedProfileAchievementItem, type FeaturedProfileItem, type FeaturedProfileItemKind, type FeaturedProfileRankItem, type FeaturedProfileRecordItem, type FeaturedProfileSelection, type FeaturedProfileSelectionInput, type FeaturedProfileSelectionsResponse, 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 MarkNotificationsReadRequest, type MarkNotificationsReadResponse, type MeasurableGoal, type MeasurableGoalDirection, type MeasurableGoalExercise, type MeasurableGoalInput, type MeasurableGoalType, type MoveOccurrenceRequest, type MovementPattern, type MuscleGroup, type MuscleGroupHeatmapQuery, type MuscleGroupHeatmapResponse, type MuscleGroupHeatmapValue, type MuscleGroupHeatmapWeek, type MuscleVolumeTrendSeries, NOTIFICATIONS_LIST_LIMIT, NOTIFICATIONS_LOOKBACK_DAYS, NOTIFICATIONS_RETENTION_DAYS, NOTIFICATION_KINDS, type NewFollowerNotification, type NotificationKind, type NotificationsResponse, 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, ROUTINE_VERSIONS_MAX, ROUTINE_VERSION_KINDS, ROUTINE_VERSION_NAME_MAX, type RecentActivityEntry, type RelationshipListKind, type RelationshipListQuery, type RelationshipListResponse, type RelationshipMember, type RenaissanceRankDefinition, type RenaissanceRankProgress, type RepType, type ReplaceFeaturedProfileItemsRequest, type ReplaceMeasurableGoalsRequest, type ReplaceTrainingLocationsRequest, type RestoreRoutineVersionResponse, type Routine, type RoutineDay, type RoutineDayId, type RoutineExercise, type RoutineId, type RoutineScheduleMode, type RoutineSet, type RoutineVersion, type RoutineVersionDay, type RoutineVersionExercise, type RoutineVersionKind, type RoutineVersionSetup, type RoutineVersionsResponse, SCHEDULE_MOVE_MAX_DAYS, SCHEDULE_OVERRIDES_MAX_RANGE_DAYS, SCHEDULE_OVERRIDE_KINDS, SCHEDULE_SKIP_PAST_DAYS, SESSION_SHARE_DEFAULT_FIELDS, SESSION_SHARE_FIELDS, SESSION_SHARE_MAX_ACTIVE_LINKS, SEXES, STARRED_EXERCISES_MAX, type ScheduleOverride, type ScheduleOverrideKind, type ScheduleOverridesQuery, type ScheduleOverridesResponse, type SessionComparisonExercise, type SessionComparisonQuery, type SessionComparisonResponse, type SessionComparisonRoutineDay, type SessionComparisonSession, type SessionComparisonSet, type SessionExerciseSubstitution, type SessionProgressNotification, type SessionRecapRecord, type SessionShare, type SessionShareField, type SessionShareListResponse, type SetAccountTimeZoneRequest, type SetLog, type Sex, type SharedSessionOwner, type SharedSessionRecap, type SkipOccurrenceRequest, 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

@@ -677,6 +677,141 @@ interface PlateausResponse {
     plateaus: ExercisePlateau[];
 }
 
+declare const ACHIEVEMENT_CATEGORIES: readonly ["SESSIONS", "SETS", "VOLUME_KG", "RECORDS", "STREAK_DAYS"];
+type AchievementCategory = (typeof ACHIEVEMENT_CATEGORIES)[number];
+interface AchievementDefinition {
+    id: string;
+    category: AchievementCategory;
+    threshold: number;
+    title: string;
+    description: string;
+}
+/** Stable milestone catalog shared by the writer and every presentation. */
+declare const ACHIEVEMENT_DEFINITIONS: readonly AchievementDefinition[];
+interface AchievementUnlockedEventPayload extends AchievementDefinition {
+    schemaVersion: 1;
+    backfilled: boolean;
+}
+interface StreakMilestoneEventPayload {
+    schemaVersion: 1;
+    achievementId: string;
+    streakDays: number;
+    backfilled: boolean;
+}
+interface EarnedAchievement extends AchievementDefinition {
+    eventId: string;
+    unlockedAt: IsoDateString;
+    sourceSessionId: string | null;
+    /** True when existing verified history was recognized after ACH-01 shipped. */
+    backfilled: boolean;
+}
+interface RenaissanceRankDefinition {
+    id: 'INITIATE' | 'APPRENTICE' | 'ARTISAN' | 'MAESTRO' | 'VIRTUOSO' | 'LAUREATE';
+    title: string;
+    description: string;
+    minimumSessions: number;
+    minimumActiveWeeks: number;
+}
+/**
+ * Stable rank ladder. Both requirements are intentionally based on attendance:
+ * completed sessions reward participation, while distinct active weeks reward
+ * consistency without encouraging consecutive-day training.
+ */
+declare const RENAISSANCE_RANK_DEFINITIONS: readonly [{
+    readonly id: "INITIATE";
+    readonly title: "Initiate";
+    readonly description: "Your place in the training ledger begins here.";
+    readonly minimumSessions: 0;
+    readonly minimumActiveWeeks: 0;
+}, {
+    readonly id: "APPRENTICE";
+    readonly title: "Apprentice";
+    readonly description: "Learning the craft through regular practice.";
+    readonly minimumSessions: 5;
+    readonly minimumActiveWeeks: 3;
+}, {
+    readonly id: "ARTISAN";
+    readonly title: "Artisan";
+    readonly description: "Building a dependable training practice.";
+    readonly minimumSessions: 15;
+    readonly minimumActiveWeeks: 8;
+}, {
+    readonly id: "MAESTRO";
+    readonly title: "Maestro";
+    readonly description: "Sustaining purposeful work across many weeks.";
+    readonly minimumSessions: 30;
+    readonly minimumActiveWeeks: 16;
+}, {
+    readonly id: "VIRTUOSO";
+    readonly title: "Virtuoso";
+    readonly description: "Showing enduring discipline through repeated seasons.";
+    readonly minimumSessions: 60;
+    readonly minimumActiveWeeks: 32;
+}, {
+    readonly id: "LAUREATE";
+    readonly title: "Laureate";
+    readonly description: "A lasting training practice recorded in the ledger.";
+    readonly minimumSessions: 100;
+    readonly minimumActiveWeeks: 52;
+}];
+interface RenaissanceRankProgress {
+    currentRank: RenaissanceRankDefinition;
+    nextRank: RenaissanceRankDefinition | null;
+    completedSessions: number;
+    activeWeeks: number;
+    sessionsRemaining: number;
+    activeWeeksRemaining: number;
+}
+/**
+ * Current verified total and the next fixed catalog milestone for one category.
+ * A null next milestone means the category's finite catalog is complete.
+ */
+interface AchievementCategoryProgress {
+    category: AchievementCategory;
+    currentValue: number;
+    nextMilestone: AchievementDefinition | null;
+    remaining: number;
+}
+/**
+ * ACH-05 recognises a return only after the athlete has rebuilt a small,
+ * recovery-compatible pattern. The break is counted as full local calendar
+ * days without a completed session; repeated sessions on one date count once.
+ */
+declare const COMEBACK_MIN_INACTIVE_DAYS = 14;
+declare const COMEBACK_REQUIRED_ACTIVE_DAYS = 3;
+declare const COMEBACK_WINDOW_DAYS = 14;
+declare const COMEBACK_SESSION_LOOKBACK = 500;
+declare const COMEBACK_RECOGNITION_LIMIT = 20;
+interface ComebackRecognition {
+    id: string;
+    inactiveDays: number;
+    returnedAt: IsoDateString;
+    recognizedAt: IsoDateString;
+    sourceSessionId: string;
+    activeDays: number;
+    /** Inclusive local-calendar span from the return through recognition. */
+    windowDays: number;
+}
+interface ComebackRecognitionSummary {
+    minimumInactiveDays: number;
+    requiredActiveDays: number;
+    windowDays: number;
+    /** Most recent first, capped by COMEBACK_RECOGNITION_LIMIT. */
+    recognitions: ComebackRecognition[];
+    /** True when older completed-session events fell outside the bounded scan. */
+    historyTruncated: boolean;
+}
+/** Stable successful response of GET /achievements. */
+interface AchievementsResponse {
+    analyticsReady: boolean;
+    earnedCount: number;
+    availableCount: number;
+    achievements: EarnedAchievement[];
+    rank: RenaissanceRankProgress | null;
+    milestoneProgress: AchievementCategoryProgress[];
+    comeback: ComebackRecognitionSummary | null;
+}
+
 declare const USERNAME_MIN_LENGTH = 3;
 declare const USERNAME_MAX_LENGTH = 30;
 declare const USERNAME_PATTERN_SOURCE = "^[a-z0-9][a-z0-9_-]{1,28}[a-z0-9]$";
@@ -744,6 +879,40 @@ interface PublicBodyMetrics {
     weightKg?: number | null;
     heightCm?: number | null;
 }
+declare const FEATURED_PROFILE_ITEM_KINDS: readonly ["RECORD", "ACHIEVEMENT", "RANK"];
+type FeaturedProfileItemKind = (typeof FEATURED_PROFILE_ITEM_KINDS)[number];
+declare const FEATURED_PROFILE_ITEMS_MAX = 6;
+declare const FEATURED_PROFILE_REFERENCE_MAX_LENGTH = 100;
+/** Owner-supplied selection. Array order becomes the public display order. */
+interface FeaturedProfileSelectionInput {
+    kind: FeaturedProfileItemKind;
+    referenceId: string;
+}
+/** Stored selection returned to its owner, ordered by `position`. */
+interface FeaturedProfileSelection extends FeaturedProfileSelectionInput {
+    position: number;
+}
+interface FeaturedProfileSelectionsResponse {
+    items: FeaturedProfileSelection[];
+}
+interface ReplaceFeaturedProfileItemsRequest {
+    items: FeaturedProfileSelectionInput[];
+}
+type FeaturedProfileItemBase = FeaturedProfileSelection;
+interface FeaturedProfileRecordItem extends FeaturedProfileItemBase {
+    kind: 'RECORD';
+    record: PersonalRecordEntry;
+}
+interface FeaturedProfileAchievementItem extends FeaturedProfileItemBase {
+    kind: 'ACHIEVEMENT';
+    achievement: EarnedAchievement;
+}
+interface FeaturedProfileRankItem extends FeaturedProfileItemBase {
+    kind: 'RANK';
+    rank: RenaissanceRankDefinition;
+}
+/** Privacy-filtered, currently valid selections in owner-defined order. */
+type FeaturedProfileItem = FeaturedProfileRecordItem | FeaturedProfileAchievementItem | FeaturedProfileRankItem;
 interface UserProfile {
     timeZone?: string | null;
     id: string;
@@ -784,6 +953,7 @@ interface PublicUserProfile {
     viewerAccess: ProfileViewerAccess;
     trainingSummary?: PublicTrainingSummary;
     personalRecords?: PersonalRecordEntry[];
+    featuredItems: FeaturedProfileItem[];
     bodyMetrics?: PublicBodyMetrics;
 }
 interface UpdateProfileRequest {
@@ -1002,141 +1172,6 @@ interface PersonalGoalsResponse {
     goals: PersonalGoalProgress[];
 }
 
-declare const ACHIEVEMENT_CATEGORIES: readonly ["SESSIONS", "SETS", "VOLUME_KG", "RECORDS", "STREAK_DAYS"];
-type AchievementCategory = (typeof ACHIEVEMENT_CATEGORIES)[number];
-interface AchievementDefinition {
-    id: string;
-    category: AchievementCategory;
-    threshold: number;
-    title: string;
-    description: string;
-}
-/** Stable milestone catalog shared by the writer and every presentation. */
-declare const ACHIEVEMENT_DEFINITIONS: readonly AchievementDefinition[];
-interface AchievementUnlockedEventPayload extends AchievementDefinition {
-    schemaVersion: 1;
-    backfilled: boolean;
-}
-interface StreakMilestoneEventPayload {
-    schemaVersion: 1;
-    achievementId: string;
-    streakDays: number;
-    backfilled: boolean;
-}
-interface EarnedAchievement extends AchievementDefinition {
-    eventId: string;
-    unlockedAt: IsoDateString;
-    sourceSessionId: string | null;
-    /** True when existing verified history was recognized after ACH-01 shipped. */
-    backfilled: boolean;
-}
-interface RenaissanceRankDefinition {
-    id: 'INITIATE' | 'APPRENTICE' | 'ARTISAN' | 'MAESTRO' | 'VIRTUOSO' | 'LAUREATE';
-    title: string;
-    description: string;
-    minimumSessions: number;
-    minimumActiveWeeks: number;
-}
-/**
- * Stable rank ladder. Both requirements are intentionally based on attendance:
- * completed sessions reward participation, while distinct active weeks reward
- * consistency without encouraging consecutive-day training.
- */
-declare const RENAISSANCE_RANK_DEFINITIONS: readonly [{
-    readonly id: "INITIATE";
-    readonly title: "Initiate";
-    readonly description: "Your place in the training ledger begins here.";
-    readonly minimumSessions: 0;
-    readonly minimumActiveWeeks: 0;
-}, {
-    readonly id: "APPRENTICE";
-    readonly title: "Apprentice";
-    readonly description: "Learning the craft through regular practice.";
-    readonly minimumSessions: 5;
-    readonly minimumActiveWeeks: 3;
-}, {
-    readonly id: "ARTISAN";
-    readonly title: "Artisan";
-    readonly description: "Building a dependable training practice.";
-    readonly minimumSessions: 15;
-    readonly minimumActiveWeeks: 8;
-}, {
-    readonly id: "MAESTRO";
-    readonly title: "Maestro";
-    readonly description: "Sustaining purposeful work across many weeks.";
-    readonly minimumSessions: 30;
-    readonly minimumActiveWeeks: 16;
-}, {
-    readonly id: "VIRTUOSO";
-    readonly title: "Virtuoso";
-    readonly description: "Showing enduring discipline through repeated seasons.";
-    readonly minimumSessions: 60;
-    readonly minimumActiveWeeks: 32;
-}, {
-    readonly id: "LAUREATE";
-    readonly title: "Laureate";
-    readonly description: "A lasting training practice recorded in the ledger.";
-    readonly minimumSessions: 100;
-    readonly minimumActiveWeeks: 52;
-}];
-interface RenaissanceRankProgress {
-    currentRank: RenaissanceRankDefinition;
-    nextRank: RenaissanceRankDefinition | null;
-    completedSessions: number;
-    activeWeeks: number;
-    sessionsRemaining: number;
-    activeWeeksRemaining: number;
-}
-/**
- * Current verified total and the next fixed catalog milestone for one category.
- * A null next milestone means the category's finite catalog is complete.
- */
-interface AchievementCategoryProgress {
-    category: AchievementCategory;
-    currentValue: number;
-    nextMilestone: AchievementDefinition | null;
-    remaining: number;
-}
-/**
- * ACH-05 recognises a return only after the athlete has rebuilt a small,
- * recovery-compatible pattern. The break is counted as full local calendar
- * days without a completed session; repeated sessions on one date count once.
- */
-declare const COMEBACK_MIN_INACTIVE_DAYS = 14;
-declare const COMEBACK_REQUIRED_ACTIVE_DAYS = 3;
-declare const COMEBACK_WINDOW_DAYS = 14;
-declare const COMEBACK_SESSION_LOOKBACK = 500;
-declare const COMEBACK_RECOGNITION_LIMIT = 20;
-interface ComebackRecognition {
-    id: string;
-    inactiveDays: number;
-    returnedAt: IsoDateString;
-    recognizedAt: IsoDateString;
-    sourceSessionId: string;
-    activeDays: number;
-    /** Inclusive local-calendar span from the return through recognition. */
-    windowDays: number;
-}
-interface ComebackRecognitionSummary {
-    minimumInactiveDays: number;
-    requiredActiveDays: number;
-    windowDays: number;
-    /** Most recent first, capped by COMEBACK_RECOGNITION_LIMIT. */
-    recognitions: ComebackRecognition[];
-    /** True when older completed-session events fell outside the bounded scan. */
-    historyTruncated: boolean;
-}
-/** Stable successful response of GET /achievements. */
-interface AchievementsResponse {
-    analyticsReady: boolean;
-    earnedCount: number;
-    availableCount: number;
-    achievements: EarnedAchievement[];
-    rank: RenaissanceRankProgress | null;
-    milestoneProgress: AchievementCategoryProgress[];
-    comeback: ComebackRecognitionSummary | null;
-}
-
 /**
  * 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
@@ -1376,4 +1411,71 @@ interface SkipOccurrenceRequest {
     date: CalendarDate;
 }
 
-export { ACHIEVEMENT_CATEGORIES, ACHIEVEMENT_DEFINITIONS, type AchievementCategory, type AchievementCategoryProgress, type AchievementDefinition, type AchievementUnlockedEventPayload, type AchievementsResponse, type Brand, COMEBACK_MIN_INACTIVE_DAYS, COMEBACK_RECOGNITION_LIMIT, COMEBACK_REQUIRED_ACTIVE_DAYS, COMEBACK_SESSION_LOOKBACK, COMEBACK_WINDOW_DAYS, type CalendarDate, type ComebackRecognition, type ComebackRecognitionSummary, type CreateRoutineDayInput, type CreateRoutineExerciseInput, type CreateRoutineRequest, type CreateRoutineVersionRequest, 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 MoveOccurrenceRequest, 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, ROUTINE_VERSIONS_MAX, ROUTINE_VERSION_KINDS, ROUTINE_VERSION_NAME_MAX, type RecentActivityEntry, type RelationshipListKind, type RelationshipListQuery, type RelationshipListResponse, type RelationshipMember, type RenaissanceRankDefinition, type RenaissanceRankProgress, type RepType, type ReplaceMeasurableGoalsRequest, type ReplaceTrainingLocationsRequest, type RestoreRoutineVersionResponse, type Routine, type RoutineDay, type RoutineDayId, type RoutineExercise, type RoutineId, type RoutineScheduleMode, type RoutineSet, type RoutineVersion, type RoutineVersionDay, type RoutineVersionExercise, type RoutineVersionKind, type RoutineVersionSetup, type RoutineVersionsResponse, SCHEDULE_MOVE_MAX_DAYS, SCHEDULE_OVERRIDES_MAX_RANGE_DAYS, SCHEDULE_OVERRIDE_KINDS, SCHEDULE_SKIP_PAST_DAYS, SESSION_SHARE_DEFAULT_FIELDS, SESSION_SHARE_FIELDS, SESSION_SHARE_MAX_ACTIVE_LINKS, SEXES, STARRED_EXERCISES_MAX, type ScheduleOverride, type ScheduleOverrideKind, type ScheduleOverridesQuery, type ScheduleOverridesResponse, 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 SkipOccurrenceRequest, 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 };
+/**
+ * What a stored notification announces. Each one is gathered from a record
+ * that already exists: an achievement earned live (never one recognized from
+ * history), a finished session that set records or changed loads, and a new
+ * follower.
+ */
+declare const NOTIFICATION_KINDS: readonly ["ACHIEVEMENT", "SESSION_PROGRESS", "NEW_FOLLOWER"];
+type NotificationKind = (typeof NOTIFICATION_KINDS)[number];
+/** Sources older than this many days are never gathered. */
+declare const NOTIFICATIONS_LOOKBACK_DAYS = 30;
+/** Notifications are kept this many days, then removed. */
+declare const NOTIFICATIONS_RETENTION_DAYS = 90;
+/** The list returns at most this many, newest first. */
+declare const NOTIFICATIONS_LIST_LIMIT = 50;
+interface NotificationBase {
+    id: string;
+    /** When the announced thing happened, not when it was gathered. */
+    createdAt: IsoDateString;
+    readAt: IsoDateString | null;
+}
+interface AchievementNotification extends NotificationBase {
+    kind: 'ACHIEVEMENT';
+    achievement: {
+        id: string;
+        title: string;
+        description: string;
+    };
+}
+interface SessionProgressNotification extends NotificationBase {
+    kind: 'SESSION_PROGRESS';
+    session: {
+        id: string;
+        routineName: string;
+        dayName: string | null;
+        /** Exercises with a new personal record in the session. */
+        recordCount: number;
+        /** Exercises whose next prescription the session changed. */
+        progressionCount: number;
+    };
+}
+interface NewFollowerNotification extends NotificationBase {
+    kind: 'NEW_FOLLOWER';
+    actor: {
+        id: string;
+        username: string;
+        name: string;
+        lastName: string | null;
+        avatarUrl: string | null;
+        /** Whether the recipient follows them back now. */
+        isFollowedByMe: boolean;
+    };
+}
+/** Named to stay clear of the DOM's `Notification`. */
+type AppNotification = AchievementNotification | SessionProgressNotification | NewFollowerNotification;
+/** GET /notifications */
+interface NotificationsResponse {
+    notifications: AppNotification[];
+    unreadCount: number;
+}
+/** POST /notifications/read. Without ids, every notification is marked read. */
+interface MarkNotificationsReadRequest {
+    ids?: string[];
+}
+interface MarkNotificationsReadResponse {
+    unreadCount: number;
+}
+
+export { ACHIEVEMENT_CATEGORIES, ACHIEVEMENT_DEFINITIONS, type AchievementCategory, type AchievementCategoryProgress, type AchievementDefinition, type AchievementNotification, type AchievementUnlockedEventPayload, type AchievementsResponse, type AppNotification, type Brand, COMEBACK_MIN_INACTIVE_DAYS, COMEBACK_RECOGNITION_LIMIT, COMEBACK_REQUIRED_ACTIVE_DAYS, COMEBACK_SESSION_LOOKBACK, COMEBACK_WINDOW_DAYS, type CalendarDate, type ComebackRecognition, type ComebackRecognitionSummary, type CreateRoutineDayInput, type CreateRoutineExerciseInput, type CreateRoutineRequest, type CreateRoutineVersionRequest, 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, FEATURED_PROFILE_ITEMS_MAX, FEATURED_PROFILE_ITEM_KINDS, FEATURED_PROFILE_REFERENCE_MAX_LENGTH, FOLLOW_SUGGESTIONS_DEFAULT_LIMIT, FOLLOW_SUGGESTIONS_MAX_LIMIT, FOLLOW_SUGGESTION_REASONS, type FeaturedProfileAchievementItem, type FeaturedProfileItem, type FeaturedProfileItemKind, type FeaturedProfileRankItem, type FeaturedProfileRecordItem, type FeaturedProfileSelection, type FeaturedProfileSelectionInput, type FeaturedProfileSelectionsResponse, 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 MarkNotificationsReadRequest, type MarkNotificationsReadResponse, type MeasurableGoal, type MeasurableGoalDirection, type MeasurableGoalExercise, type MeasurableGoalInput, type MeasurableGoalType, type MoveOccurrenceRequest, type MovementPattern, type MuscleGroup, type MuscleGroupHeatmapQuery, type MuscleGroupHeatmapResponse, type MuscleGroupHeatmapValue, type MuscleGroupHeatmapWeek, type MuscleVolumeTrendSeries, NOTIFICATIONS_LIST_LIMIT, NOTIFICATIONS_LOOKBACK_DAYS, NOTIFICATIONS_RETENTION_DAYS, NOTIFICATION_KINDS, type NewFollowerNotification, type NotificationKind, type NotificationsResponse, 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, ROUTINE_VERSIONS_MAX, ROUTINE_VERSION_KINDS, ROUTINE_VERSION_NAME_MAX, type RecentActivityEntry, type RelationshipListKind, type RelationshipListQuery, type RelationshipListResponse, type RelationshipMember, type RenaissanceRankDefinition, type RenaissanceRankProgress, type RepType, type ReplaceFeaturedProfileItemsRequest, type ReplaceMeasurableGoalsRequest, type ReplaceTrainingLocationsRequest, type RestoreRoutineVersionResponse, type Routine, type RoutineDay, type RoutineDayId, type RoutineExercise, type RoutineId, type RoutineScheduleMode, type RoutineSet, type RoutineVersion, type RoutineVersionDay, type RoutineVersionExercise, type RoutineVersionKind, type RoutineVersionSetup, type RoutineVersionsResponse, SCHEDULE_MOVE_MAX_DAYS, SCHEDULE_OVERRIDES_MAX_RANGE_DAYS, SCHEDULE_OVERRIDE_KINDS, SCHEDULE_SKIP_PAST_DAYS, SESSION_SHARE_DEFAULT_FIELDS, SESSION_SHARE_FIELDS, SESSION_SHARE_MAX_ACTIVE_LINKS, SEXES, STARRED_EXERCISES_MAX, type ScheduleOverride, type ScheduleOverrideKind, type ScheduleOverridesQuery, type ScheduleOverridesResponse, type SessionComparisonExercise, type SessionComparisonQuery, type SessionComparisonResponse, type SessionComparisonRoutineDay, type SessionComparisonSession, type SessionComparisonSet, type SessionExerciseSubstitution, type SessionProgressNotification, type SessionRecapRecord, type SessionShare, type SessionShareField, type SessionShareListResponse, type SetAccountTimeZoneRequest, type SetLog, type Sex, type SharedSessionOwner, type SharedSessionRecap, type SkipOccurrenceRequest, 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

@@ -108,6 +108,13 @@ var PREFERRED_TRAINING_STYLE_VALUES = [
   "BODY_PART_SPLIT",
   "CIRCUIT"
 ];
+var FEATURED_PROFILE_ITEM_KINDS = [
+  "RECORD",
+  "ACHIEVEMENT",
+  "RANK"
+];
+var FEATURED_PROFILE_ITEMS_MAX = 6;
+var FEATURED_PROFILE_REFERENCE_MAX_LENGTH = 100;
 var RELATIONSHIP_LIST_KINDS = [
   "followers",
   "following",
@@ -350,6 +357,16 @@ var PLATEAU_MIN_DAYS_SINCE_BEST = 21;
 var PLATEAU_RECENT_DAYS = 21;
 var PLATEAU_MIN_SESSIONS_MIN = 3;
 var PLATEAU_MIN_SESSIONS_MAX = 8;
+
+// src/notifications.ts
+var NOTIFICATION_KINDS = [
+  "ACHIEVEMENT",
+  "SESSION_PROGRESS",
+  "NEW_FOLLOWER"
+];
+var NOTIFICATIONS_LOOKBACK_DAYS = 30;
+var NOTIFICATIONS_RETENTION_DAYS = 90;
+var NOTIFICATIONS_LIST_LIMIT = 50;
 export {
   ACHIEVEMENT_CATEGORIES,
   ACHIEVEMENT_DEFINITIONS,
@@ -360,6 +377,9 @@ export {
   COMEBACK_WINDOW_DAYS,
   EXERCISE_EQUIPMENT,
   EXERCISE_MECHANICS,
+  FEATURED_PROFILE_ITEMS_MAX,
+  FEATURED_PROFILE_ITEM_KINDS,
+  FEATURED_PROFILE_REFERENCE_MAX_LENGTH,
   FOLLOW_SUGGESTIONS_DEFAULT_LIMIT,
   FOLLOW_SUGGESTIONS_MAX_LIMIT,
   FOLLOW_SUGGESTION_REASONS,
@@ -368,6 +388,10 @@ export {
   MEASURABLE_GOAL_TYPES,
   MOVEMENT_PATTERNS,
   MUSCLE_GROUPS,
+  NOTIFICATIONS_LIST_LIMIT,
+  NOTIFICATIONS_LOOKBACK_DAYS,
+  NOTIFICATIONS_RETENTION_DAYS,
+  NOTIFICATION_KINDS,
   PLATEAU_MIN_DAYS_SINCE_BEST,
   PLATEAU_MIN_SESSIONS,
   PLATEAU_MIN_SESSIONS_MAX,

package/package.json

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