/** Practice, XP and streak payloads (technical-plan 4.8, stage 1). */

/** "none": before the learner joined. */
export type DayStatus = "done" | "frozen" | "today" | "missed" | "future" | "none"

export interface StreakDayDto {
  /** Tehran day, Y-m-d */
  date: string
  status: DayStatus
}

export interface XpSummaryDto {
  today: number
  week: number
  total: number
  goal: number
  level: number
  level_xp: number
  into_level: number
}

export interface StreakStateDto {
  current: number
  best: number
  freezes: number
  practised_today: boolean
  freeze_used_today: boolean
  today: string
  /** Tehran hour 0–23, and hours left today. */
  hour: number
  hours_left: number
  /** Saturday → Friday of this week. */
  week: StreakDayDto[]
  /** 35 days ending this Friday. */
  calendar: StreakDayDto[]
  xp: XpSummaryDto
}

/** GET /v1/streak/month: one Jalali month of the calendar. */
export interface StreakMonthDto {
  /** "1405-08" */
  month: string
  title: string
  /** 0 = Saturday … 6 = Friday: empty cells before day 1. */
  first_weekday: number
  previous: string | null
  /** null for this month (no looking ahead). */
  next: string | null
  practised_days: number
  days: { date: string; day: number; count: number; status: DayStatus }[]
}

export interface PracticeExerciseDto {
  category: string
  title: string
  text: string
  minutes: number
}

/** GET /v1/streak */
export interface StreakResponseDto extends StreakStateDto {
  exercises: PracticeExerciseDto[]
  minutes: number[]
}

export interface PracticeLogDto {
  id: number
  title: string
  minutes: number
  note: string | null
  is_public: boolean
  category: { key: string; title: string } | null
  photo: string | null
  date: string
  created_at: string
}

/** POST /v1/practice */
export interface PracticeLoggedDto {
  log: PracticeLogDto
  /** 0 when the day's XP cap was reached. */
  xp_awarded: number
  /** The day's first practice: the streak grew. */
  streak_extended: boolean
  streak: StreakStateDto
}
