brackt/app/lib/draft-timer.ts
Chris Parsons 7a8ea60e77
Add draft clock UI, Fischer increment timer logic, and security fixes (#19)
- Add prominent clock badge to tab bar (lights up on your turn) with
  correct Fischer increment chess-clock model: bank starts at initialTime,
  += incrementTime after each pick, other teams' banks untouched
- Extract pure timer helpers to app/lib/draft-timer.ts and add 29 unit
  tests covering formatClockTime, calculateTimeAfterPick, getTimerColorClass,
  and full snake-draft lifecycle regression scenarios
- Fix make-pick.ts: add status !== 'draft' and draftPaused server guards
- Fix draft-utils.ts: replace (global as any).__socketIO with getSocketIO(),
  fix timeUsed to store actual timeRemaining at pick moment (not always 120),
  add null timer warning, move timer fetch before pick insert
- Fix draft.start.ts: batch timer inserts, guard against empty draftSlots
- Fix DraftGridSection: memoize currentTeamId, widen teamTimers type to
  Record<string, number | undefined>
- Fix duplicate animate-pulse (getTimerColorClass already includes it)
- Clamp negative seconds in formatClockTime to guard against timer drift

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-21 16:51:12 -08:00

59 lines
2.1 KiB
TypeScript

/**
* Pure utility functions for the draft clock/timer system.
* Extracted here to be independently testable and shared across
* route handlers and UI components.
*
* Clock model (chess-clock / Fischer increment):
* - Draft start: every team receives `initialTime` as their bank.
* - While on the clock: the active team's bank counts down each second.
* - After a pick is made: the picker's bank += `incrementTime`.
* - Between turns: all other teams' banks are left untouched.
*/
/**
* Formats a seconds value for display.
* undefined → "--:--"
* < 3600 s → "m:ss"
* >= 3600 s → "h:mm:ss"
*/
export function formatClockTime(seconds: number | undefined): string {
if (seconds === undefined) return "--:--";
const clamped = Math.max(0, seconds); // guard against negative values from timer drift
const h = Math.floor(clamped / 3600);
const m = Math.floor((clamped % 3600) / 60);
const s = clamped % 60;
if (h > 0)
return `${h}:${String(m).padStart(2, "0")}:${String(s).padStart(2, "0")}`;
return `${m}:${String(s).padStart(2, "0")}`;
}
/**
* Returns a team's new bank time after they complete a pick.
* The increment is the post-pick reward (chess clock model).
*
* @param bankTime Current remaining seconds in the team's bank
* @param incrementTime Bonus seconds awarded after each pick
*/
export function calculateTimeAfterPick(
bankTime: number,
incrementTime: number
): number {
return bankTime + incrementTime;
}
/**
* Returns the Tailwind colour class(es) for a timer value.
*
* > 60 s → green (plenty of time)
* > 30 s → amber (getting tight)
* > 10 s → coral (urgent)
* ≤ 10 s → coral + animate-pulse (critical)
* undefined → muted (clock not running)
*/
export function getTimerColorClass(seconds: number | undefined): string {
if (seconds === undefined) return "text-muted-foreground";
if (seconds > 60) return "text-emerald-400";
if (seconds > 30) return "text-amber-accent";
if (seconds > 10) return "text-coral-accent";
return "text-coral-accent animate-pulse";
}