export interface Branch { num: number name: string phone: string } export interface Theme { infoNum: number themeNum: number name: string doing: number memo: string } export interface ThemeDetail { name: string imageUrl: string genre: string level: string playTime: string memo: string serverToday: string } export interface TimeSlot { num: number time: string available: boolean saleText: string } export interface PriceOption { person: number totalPrice: number } export interface ReservationSelection { branchNum: number themeNum: number themeInfoNum: number date: string timeNum: number timeLabel: string themeName: string } export interface ReservationRequest extends ReservationSelection { totalPrice: number person: number name: string phone: string captchaToken: string } export interface ReservationResult { success: boolean message: string reservationNum?: string confirmationUrl?: string transport?: ReservationTransport } export interface CaptchaResult { token: string solvedAtMs: number } export interface ReservationTransport { sentAtMs: number receivedAtMs: number rttMs: number httpStatus: number remoteIp: string reusedSocket: boolean protocol?: 'http/1.1' | 'h2' connectionId?: string observedServerDateMs?: number } export interface ClockSample { id: number sentAtMs: number receivedAtMs: number midpointMs: number serverDateMs: number rttMs: number offsetEstimateMs: number offsetMinMs: number offsetMaxMs: number remoteIp: string reusedSocket: boolean protocol?: 'http/1.1' | 'h2' connectionId?: string accepted: boolean rejectionReason?: string } export interface ClockCalibrationSettings { transportMode: 'http1' | 'http2' enabled: boolean autoApply: boolean scanWindowMs: number probeIntervalMs: number initialBoundarySpacingSec: number requiredBoundaryCount: number historySize: number maxBoundarySpreadMs: number maxProbeRttMs: number maintenanceIntervalSec: number sampleWindowSize: number } export const CLOCK_CALIBRATION_DEFAULTS: ClockCalibrationSettings = { transportMode: 'http1', enabled: true, autoApply: true, scanWindowMs: 250, probeIntervalMs: 50, initialBoundarySpacingSec: 2, requiredBoundaryCount: 5, historySize: 12, maxBoundarySpreadMs: 120, maxProbeRttMs: 350, maintenanceIntervalSec: 15, sampleWindowSize: 240, } export interface ClockEstimate { monitoring: boolean observedAtMs: number estimatedServerTimeMs: number offsetMs: number driftPpm: number minRttMs: number p50RttMs: number p95RttMs: number oneWayMs: number uncertaintyMs: number sampleAgeMs: number acceptedSamples: number rawOffsetMs: number boundaryCount: number boundaryOffsetMs?: number boundaryUncertaintyMs?: number boundarySpreadMs?: number recommendedCorrectionMs: number calibrationReady: boolean calibrationApplied: boolean calibrationSettings: ClockCalibrationSettings remoteIp: string protocol?: 'http/1.1' | 'h2' connectionId?: string connectionReused?: boolean quality: 'good' | 'fair' | 'poor' | 'unavailable' warning?: string samples: ClockSample[] } export interface TimingTestRequest { targetServerTimeMs: number userOffsetMs: number } export interface TimingTestResult { targetServerTimeMs: number plannedSendAtMs: number actualSendAtMs: number estimatedArrivalServerMs: number arrivalErrorMs: number schedulerJitterMs: number rttMs: number uncertaintyMs: number remoteIp: string reusedSocket: boolean protocol?: 'http/1.1' | 'h2' connectionId?: string } export interface AutoReservationConfig { request: ReservationRequest targetServerTimeMs: number userOffsetMs: number captchaPastedAtMs: number } export interface AutoReservationSnapshot { branchNum: number themeNum: number themeInfoNum: number date: string timeNum: number timeLabel: string themeName: string totalPrice: number person: number } export interface AutoReservationTimeline { plannedSendAtMs?: number actualSendAtMs?: number estimatedArrivalServerMs?: number arrivalErrorMs?: number rttMs?: number httpStatus?: number remoteIp?: string reusedSocket?: boolean protocol?: 'http/1.1' | 'h2' connectionId?: string } export interface AutoReservationState { status: 'idle' | 'armed' | 'firing' | 'succeeded' | 'failed' | 'cancelled' targetServerTimeMs?: number userOffsetMs?: number armedAtMs?: number captchaPastedAtMs?: number tokenStatus: 'empty' | 'ready' | 'consumed' | 'expired' snapshot?: AutoReservationSnapshot warning?: string message?: string result?: ReservationResult timeline?: AutoReservationTimeline } export interface SalvoAttemptInput { offsetMs: number captchaToken: string captchaSolvedAtMs: number } export interface AutoSalvoConfig { baseRequest: Omit targetServerTimeMs: number userOffsetMs: number attempts: SalvoAttemptInput[] stopOnSuccess: boolean } export interface AutoSalvoAttempt { index: number offsetMs: number effectiveTargetServerMs: number plannedSendAtMs?: number actualSendAtMs?: number arrivalErrorMs?: number rttMs?: number httpStatus?: number serverDateMs?: number status: 'pending' | 'firing' | 'succeeded' | 'failed' | 'skipped' message?: string reservationNum?: string } export interface AutoSalvoState { status: 'idle' | 'armed' | 'firing' | 'succeeded' | 'failed' | 'cancelled' targetServerTimeMs?: number userOffsetMs?: number armedAtMs?: number stopOnSuccess: boolean snapshot?: AutoReservationSnapshot attempts: AutoSalvoAttempt[] succeededIndex?: number warning?: string message?: string result?: ReservationResult } export interface ReservationApi { getBranches(): Promise getThemes(branchNum: number): Promise getThemeDetail(themeInfoNum: number): Promise getTimes(selection: Pick): Promise prepare(selection: ReservationSelection): Promise openCaptcha(selection: ReservationSelection): Promise submit(request: ReservationRequest): Promise startClockMonitor(): Promise stopClockMonitor(): Promise getClockState(): Promise configureClock(settings: ClockCalibrationSettings): Promise subscribeClock(listener: (estimate: ClockEstimate) => void): () => void runTimingTest(request: TimingTestRequest): Promise armAutoReservation(config: AutoReservationConfig): Promise disarmAutoReservation(): Promise getAutoReservationState(): Promise subscribeAutoState(listener: (state: AutoReservationState) => void): () => void armAutoSalvo(config: AutoSalvoConfig): Promise disarmAutoSalvo(): Promise getAutoSalvoState(): Promise subscribeAutoSalvo(listener: (state: AutoSalvoState) => void): () => void }