Skip to content

Features

Ivan William Harsono edited this page Nov 17, 2026 · 2 revisions

Features (Node.js)

Bahasa / Language: English · Bahasa Indonesia


English

What the package contains, with the numbers measured from src/ rather than from a release note.

component count location
PayloadBuilders 141 src/builder/*.ts
Parsers 142 (141 resources + Bundle) src/parser/*Parser.ts
Data types 33 classes src/datatype/datatypes.ts
Terminology modules 25 src/terminology/
Queue modules 8 src/queue/
R5 builders 141 wrappers src/r5/builder/
Tests 1,268 src/**/*.test.ts

1. Typed data types

33 classes — Identifier, HumanName, CodeableConcept, Coding, Reference, Quantity, Period, Address, ContactPoint, Dosage, Timing, Money, Ratio, Range, … Each has typed setters and toJSON(), and drops empty values so a payload does not carry "" or null.

2. Fluent builders

One builder per resource, PayloadBuilder<Resource>, 141 in total. Setters return this; build() returns plain FHIR JSON. A builder never validates — the server decides, and SSValidationError reads the verdict.

3. Parsers

Every resource also has a parser, so a response can be read back with the same element names used to write it. Bundle has its own parser for transaction responses.

4. HTTP layer

  • SSRequest — FHIR client with OAuth2 token refresh on 401, Retry-After handling on 429, and exponential backoff on 5xx.
  • SSResponse — status, body, isSuccess(), getErrorMessages(), getResourceId().
  • BundleResponse — per-entry outcome of a transaction Bundle.
  • SSValidationError — rule numbers, affected paths, duplicate and date-time shortcuts.

5. Terminology

25 modules covering LOINC, ICD-10, ICD-9-CM, KFA, KPTL (base, modifier, room, mapping), CVX, UCUM, SNOMED CT, Kemkes clinical terminology, Indonesian region codes, occupation, family relationship, plus a TerminologyClient for the remote terminology service and SatusehatRules / SatusehatNonStandard for the SATUSEHAT rules and its non-standard identifiers and extensions.

6. Conformance guard

R4ElementGuard checks top-level elements against the official R4 definitions (src/data/r4_elements.json). It is opt-in (SATUSEHAT_STRICT_R4=1) because enabling it by default breaks callers that still use legacy setters.

7. Durable queue

Eight modules: SqliteQueue, Worker, Monitor, RateLimiter, ErrorClassifier, QueueResult, QueueInterface, QueueException. A send can be queued, retried with classification, and inspected.

8. R5 namespace

src/r5/builder/ holds 141 wrappers that extend their R4 builder unchanged. Using R5 means changing the use/import line. The layer is additive: no R5-only difference is coded yet, and the README says so instead of claiming otherwise.


Bahasa Indonesia

Isi paket ini, dengan angka yang diukur dari src/, bukan dari catatan rilis.

komponen jumlah lokasi
PayloadBuilder 141 src/builder/*.ts
Parser 142 (141 resource + Bundle) src/parser/*Parser.ts
Tipe data 33 kelas src/datatype/datatypes.ts
Modul terminologi 25 src/terminology/
Modul antrean 8 src/queue/
Builder R5 141 pembungkus src/r5/builder/
Uji 1.268 src/**/*.test.ts

1. Tipe data bertipe

33 kelas — Identifier, HumanName, CodeableConcept, Coding, Reference, Quantity, Period, Address, ContactPoint, Dosage, Timing, Money, Ratio, Range, dan seterusnya. Masing-masing punya setter bertipe dan toJSON(), serta membuang nilai kosong supaya payload tidak membawa "" atau null.

2. Builder fluent

Satu builder per resource, PayloadBuilder<Resource>, total 141. Setter mengembalikan this; build() menghasilkan JSON FHIR biasa. Builder tidak pernah memvalidasi — server yang memutuskan, dan SSValidationError membaca putusannya.

3. Parser

Setiap resource juga punya parser, jadi respons bisa dibaca kembali dengan nama elemen yang sama seperti saat menulisnya. Bundle punya parser sendiri untuk respons transaksi.

4. Lapisan HTTP

  • SSRequest — klien FHIR dengan penyegaran token OAuth2 pada 401, penanganan Retry-After pada 429, dan backoff eksponensial pada 5xx.
  • SSResponse — status, body, isSuccess(), getErrorMessages(), getResourceId().
  • BundleResponse — hasil per entri pada Bundle transaksi.
  • SSValidationError — nomor aturan, path terdampak, pintasan duplikat dan tanggal-waktu.

5. Terminologi

25 modul mencakup LOINC, ICD-10, ICD-9-CM, KFA, KPTL (base, modifier, kamar, pemetaan), CVX, UCUM, SNOMED CT, terminologi klinis Kemkes, kode wilayah Indonesia, okupasi, hubungan keluarga, ditambah TerminologyClient untuk layanan terminologi jarak jauh serta SatusehatRules / SatusehatNonStandard untuk aturan SATUSEHAT dan identifier/extension non-standarnya.

6. Penjaga konformansi

R4ElementGuard memeriksa elemen tingkat atas terhadap definisi R4 resmi (src/data/r4_elements.json). Sifatnya opt-in (SATUSEHAT_STRICT_R4=1) karena bila dinyalakan secara bawaan ia mematahkan pemanggil yang masih memakai setter lama.

7. Antrean tahan mati

Delapan modul: SqliteQueue, Worker, Monitor, RateLimiter, ErrorClassifier, QueueResult, QueueInterface, QueueException. Pengiriman bisa diantrekan, diulang berdasarkan penggolongan galat, dan diperiksa.

8. Namespace R5

src/r5/builder/ berisi 141 pembungkus yang mewarisi builder R4 tanpa perubahan. Memakai R5 berarti mengganti baris import. Lapisan ini aditif: belum ada perbedaan khusus R5 yang dikodekan, dan README mengatakan itu apa adanya.

Clone this wiki locally