A compiled language
for APIs and services.

route GET "/search/doctors" public -> DoctorListResponse {
  query {
    q: String?  specialty: String?  city: String?  country: String?
    page: Int = 1  per_page: Int = 20
    sort: String = "rating"  direction: String = "desc"
    scope: String = "active"
  }
 
  handler {
    let key = "doctor-search:" + json.stringify({
      q: query.q, city: query.city, page: query.page
    })
 
    if cache.exists(key) {
      return cache.get_as("DoctorListResponse", key)
    }
 
    let result = Doctor.search(
      q: query.q, city: query.city,
      page: query.page, per_page: query.per_page,
      sort: query.sort, direction: query.direction,
      scope: query.scope
    )
    cache.set(key, result, ttl_seconds: 120)
    emit DoctorSearchCached { cache_key: key, scope: query.scope }
    return result
  }
}

event SlotReminderQueued {
  slot_id: UUID
  trigger: String
}
 
job send_slot_reminder(payload: Json) -> Void {
  logs.info("slot reminder job", { job_name: "send_slot_reminder", payload: payload })
  audit.record("send_slot_reminder", "AppointmentSlot", "scheduled", payload)
}
 
schedule "*/15 * * * *" run send_slot_reminder
 
route POST "/slots/{id}/notify"
  protect StaffAuth roles [scheduler] idempotent -> Json
{
  params { id: UUID }
  handler {
    let job_id = jobs.enqueue("send_slot_reminder", { slot_id: params.id }, delay_seconds: 5)
    emit SlotReminderQueued { slot_id: params.id, trigger: "manual" }
    return { job_id: job_id }
  }
}