Tham chiếu API

Pomodoro

Điều khiển bộ hẹn giờ Pomodoro tích hợp: đọc cài đặt, kiểm tra tiến độ hôm nay, và bắt đầu/tạm dừng/dừng phiên hiện tại.

Định nghĩa kiểu

bash
type PomodoroSettings {
  workDuration: Int!          # minutes
  shortBreak: Int!            # minutes
  longBreak: Int!             # minutes
  roundsBeforeLongBreak: Int!
  autoStartBreaks: Boolean!
  autoStartWork: Boolean!
}

type PomodoroToday {
  date: String!               # ISO date (YYYY-MM-DD)
  completedCount: Int!        # completed work rounds today
  currentRound: Int!
  timeLeft: Int!              # seconds remaining in the current phase
  totalTime: Int!             # seconds elapsed in the current phase
  isRunning: Boolean!
  isPause: Boolean!
  state: PomodoroState!       # WORK | SHORT_BREAK | LONG_BREAK | PAUSED
}

enum PomodoroState {
  WORK
  SHORT_BREAK
  LONG_BREAK
  PAUSED
}

Thao tác

query

pomodoroSettings

Lấy cài đặt Pomodoro đã lưu (thời lượng, cờ tự động bắt đầu, vòng).

bash
query GetPomodoroSettings {
  pomodoroSettings {
    workDuration shortBreak longBreak roundsBeforeLongBreak
    autoStartBreaks autoStartWork
  }
}
query

pomodoroToday

Lấy thông tin thời gian chạy của hôm nay: vòng đã hoàn thành, giai đoạn hiện tại, thời gian còn lại, và trạng thái chạy.

bash
query GetPomodoroToday {
  pomodoroToday {
    date completedCount currentRound timeLeft totalTime isRunning isPause state
  }
}
mutation

startPomodoro

Bắt đầu bộ hẹn giờ Pomodoro. Truyền timeLeft (giây) để tiếp tục từ trạng thái tạm dừng, hoặc 0 cho bắt đầu mới.

bash
mutation StartPomodoro($timeLeft: Int!) {
  startPomodoro(timeLeft: $timeLeft)
}
mutation

pausePomodoro

Tạm dừng bộ hẹn giờ Pomodoro đang chạy.

bash
mutation PausePomodoro {
  pausePomodoro
}
mutation

stopPomodoro

Dừng bộ hẹn giờ Pomodoro và đặt lại vòng hiện tại.

bash
mutation StopPomodoro {
  stopPomodoro
}