npm install @clinikapi/sdk

import { Clinik } from '@clinikapi/sdk';

const clinik = new Clinik(process.env.CLINIKAPI_SECRET_KEY!);

async function main() {
  // Create a patient
  const { data: patient, meta } = await clinik.patients.create({
    firstName: 'Jane',
    lastName: 'Doe',
    email: '[email protected]',
    gender: 'female',
    birthDate: '1990-03-15',
    address: {
      line: ['123 Main St'],
      city: 'Austin',
      state: 'TX',
      postalCode: '78701',
      country: 'US',
    },
  });

  console.log('Patient ID:', patient.id);
  console.log('Request ID:', meta.requestId);
  console.log('Rate limit remaining:', meta.rateLimitRemaining);

  // Read the patient back with related resources
  const { data: full } = await clinik.patients.read(patient.id!, {
    include: ['Encounter', 'Observation'],
  });

  console.log('Encounters:', full.encounters.length);
  console.log('Observations:', full.observations.length);

  // Search patients
  const { data: results } = await clinik.patients.search({
    name: 'Doe',
    count: 10,
  });

  console.log('Found:', results.data.length, 'patients');
}

main();

interface ApiResponse<T> {
  data: T;          // The resource or result
  meta: {
    requestId: string;           // For support tickets
    timestamp: string;           // ISO 8601
    status: number;              // HTTP status
    rateLimitTotal?: number;     // Requests allowed per window
    rateLimitRemaining?: number; // Requests left
    rateLimitReset?: number;     // Seconds until reset
  };
}