JavaScript SDK

npm install @odento/sdk

# or with yarn
yarn add @odento/sdk

# or with pnpm
pnpm add @odento/sdk

import { Odento } from '@odento/sdk'

const odento = new Odento({
  keyId: process.env.ODENTO_API_KEY_ID,       // ok_live_...
  keySecret: process.env.ODENTO_API_KEY_SECRET, // os_...
})

// Optionally override the base URL (for testing/staging)
const odentoStaging = new Odento({
  keyId: process.env.ODENTO_API_KEY_ID,
  keySecret: process.env.ODENTO_API_KEY_SECRET,
  baseUrl: 'https://staging-api.odento.app',
})

import { Odento } from '@odento/sdk'

const odento = new Odento()

// Login — SDK stores tokens internally
await odento.auth.login({
  email: 'dr.sharma@dentalkare.in',
  password: 'your-secure-password',
})

// All subsequent calls use the stored access token
// The SDK automatically refreshes when the token expires

// List all patients with pagination
const result = await odento.patients.list({
  limit: 10,
  status: 'active',
})

console.log(result.items)
console.log(result.pagination.hasMore)

// Iterate through all pages
let cursor = result.pagination.nextCursor
while (result.pagination.hasMore) {
  const next = await odento.patients.list({ limit: 10, cursor })
  console.log(next.items)
  cursor = next.pagination.nextCursor
}

const patient = await odento.patients.create({
  first_name: 'Priya',
  last_name: 'Sharma',
  email: 'priya.sharma@example.com',
  phone: '+919876543210',
  date_of_birth: '1990-05-15',
  gender: 'female',
  address: {
    street: '12 MG Road',
    city: 'Bengaluru',
    state: 'Karnataka',
    postal_code: '560001',
    country: 'India',
  },
})

console.log(patient.id) // pat_5f8d3a2b1c9e4a7b

const appointment = await odento.appointments.create({
  patient_id: 'pat_5f8d3a2b1c9e4a7b',
  dentist_id: 'usr_abc123',
  start_time: '2025-01-22T10:00:00Z',
  end_time: '2025-01-22T11:00:00Z',
  type: 'consultation',
  location_id: 'loc_xyz789',
  notes: 'Routine checkup',
})

console.log(appointment.id) // apt_7a3b9c1d2e5f8a4b

// Create a webhook endpoint
const webhook = await odento.webhooks.create({
  url: 'https://myapp.com/webhooks/odento',
  events: ['appointment.created', 'invoice.paid'],
  description: 'Production webhook',
})

console.log(webhook.signingSecret) // whsec_... — store this!

import { OdentoError } from '@odento/sdk'

try {
  const patient = await odento.patients.create({
    first_name: 'Priya',
    // missing required fields...
  })
} catch (error) {
  if (error instanceof OdentoError) {
    console.log(error.code)    // 'VALIDATION_ERROR'
    console.log(error.message) // 'The request body contains invalid fields.'
    console.log(error.details)  // [{ field: 'email', message: 'Email is required.' }]

    if (error.code === 'RATE_LIMITED') {
      // SDK already retries automatically, but you can add custom logic
      console.log('Rate limited. Retry after:', error.retryAfter)
    }
  } else {
    throw error // re-throw unexpected errors
  }
}

// Browser — use JWT auth (token obtained from your backend)
import { Odento } from '@odento/sdk'

const odento = new Odento({
  accessToken: userAccessToken, // obtained from your backend
})