Two integration modes.

Use @polaris/fhir-de directly against your own Aidbox installation, or build on the full Polaris platform. Both modes use the same resource builders and extension constants.

import {
  buildPatient,
  createFhirDeClient,
  FhirDeHttpError,
  KBV_PR_FOR_PatientProfile,
} from '@polaris/fhir-de'
import type { FhirTransport } from '@polaris/fhir-de'

// Implement the FhirTransport SPI with your HTTP client
const baseUrl = 'https://aidbox.example.com/fhir'

const transport: FhirTransport = {
  async request(method, path, init) {
    const normalizedPath = path.startsWith('/') ? path : `/${path}`
    const url = new URL(`${baseUrl.replace(/\\/$/, '')}${normalizedPath}`)

    if (init?.query) {
      for (const [key, value] of Object.entries(init.query)) {
        const values = Array.isArray(value) ? value : [value]
        for (const item of values) url.searchParams.append(key, item)
      }
    }

    const res = await fetch(url, {
      method,
      headers: {
        'Content-Type': 'application/fhir+json',
        Accept: 'application/fhir+json',
        'Authorization': `Bearer ${process.env.AIDBOX_TOKEN}`,
        ...init?.headers,
      },
      body: init?.body == null ? undefined : JSON.stringify(init.body),
    })

    const body = res.status === 204 ? null : await res.json().catch(() => null)
    if (!res.ok) throw new FhirDeHttpError(res.status, body)
    return body
  },
}

// Create a client
const client = createFhirDeClient({
  baseUrl,
  transport,
})

// Get a profile-scoped resource client
const patients = client.forProfile(KBV_PR_FOR_PatientProfile, 'Patient')

// Typed CRUD operations
const patient = await patients.read('pat-001')      // returns null on 404
const results = await patients.search({ family: 'Müller' })

const draft = buildPatient({
  id: 'pat-002',
  firstName: 'Anna',
  lastName: 'Müller',
  birthDate: '1985-04-12',
})

const created = await patients.createResource(draft)
await patients.update('pat-002', { ...draft, id: 'pat-002' })
await patients.delete('pat-001')                    // treats 404 as success