const { data: appt } = await clinik.appointments.create({
  status: 'booked',
  patientId: 'pt_abc123',
  practitionerId: 'prac_def456',
  start: '2025-02-01T14:00:00Z',
  end: '2025-02-01T14:30:00Z',
  minutesDuration: 30,
  appointmentType: 'followup',
  serviceType: 'Cardiology consultation',
  serviceCategory: 'specialist',
  specialty: 'Cardiology',
  reasonCode: 'Blood pressure follow-up',
  priority: 0,
  description: 'Follow-up visit for hypertension management',
  patientInstruction: 'Please bring your home BP log',
});

const { data } = await clinik.appointments.create({
  status: 'proposed',
  patientId: 'pt_abc123',
  practitionerId: 'prac_def456',
  basedOnId: 'sr_referral789',
  serviceType: 'Orthopedic consultation',
  description: 'Referral follow-up for knee pain',
  // ...
});

const { data } = await clinik.appointments.create({
  status: 'proposed',
  patientId: 'pt_abc123',
  practitionerId: 'prac_def456',
  requestedPeriod: [
    { start: '2025-02-03T09:00:00Z', end: '2025-02-03T12:00:00Z' },
    { start: '2025-02-04T14:00:00Z', end: '2025-02-04T17:00:00Z' },
  ],
  description: 'Patient prefers morning or afternoon slots',
  // ...
});

const { data } = await clinik.appointments.create({
  status: 'booked',
  patientId: 'pt_abc123',
  practitionerId: 'prac_def456',
  start: '2025-02-01T14:00:00Z',
  end: '2025-02-01T14:30:00Z',
  created: '2025-01-20T08:30:00Z', // when the booking was made
  // ...
});

proposed → pending → booked → checked-in → arrived → fulfilled
                                                    ↘ cancelled / noshow

// Check in a patient
await clinik.appointments.update('appt_xyz789', {
  status: 'checked-in',
});

// Cancel with reason
await clinik.appointments.update('appt_xyz789', {
  status: 'cancelled',
  cancelationReason: 'Patient requested reschedule',
});

// Reschedule with updated service details
await clinik.appointments.update('appt_xyz789', {
  start: '2025-02-03T10:00:00Z',
  end: '2025-02-03T10:30:00Z',
  appointmentType: 'followup',
  serviceType: 'General checkup',
  specialty: 'Family Medicine',
  reasonCode: 'Annual wellness visit',
  priority: 0,
  comment: 'Rescheduled from Feb 1 per patient request',
});

// Upcoming appointments for a patient
const { data: upcoming } = await clinik.appointments.search({
  patientId: 'pt_abc123',
  status: 'booked',
  dateFrom: new Date().toISOString().split('T')[0],
  sort: 'date',
  count: 10,
});

// All appointments for a practitioner today
const today = new Date().toISOString().split('T')[0];
const { data: schedule } = await clinik.appointments.search({
  dateFrom: today,
  dateTo: today,
  sort: 'date',
});