Base Implementation

.changeset/README.md

@@ -0,0 +1,8 @@
+# Changesets
+
+Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
+with multi-package repos, or single-package repos to help you version and publish your code. You can
+find the full documentation for it [in our repository](https://github.com/changesets/changesets)
+
+We have a quick list of common questions to get you started engaging with this project in
+[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)

.changeset/brown-buses-cheat.md

@@ -0,0 +1,5 @@
+---
+"@ssecd/ihs": patch
+---
+
+Initial release

.changeset/config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.0.0/schema.json",
+  "changelog": "@changesets/cli/changelog",
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "restricted",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

.env.example

@@ -1,3 +1,10 @@
 IHS_ORGANIZATION_ID=
 IHS_CLIENT_SECRET=
 IHS_SECRET_KEY=
+IHS_KYC_PEM_FILE=
+
+TEST_AGENT_NIK=
+TEST_AGENT_NAME=
+TEST_PATIENT_NIK=
+TEST_PATEINT_NAME=
+TEST_PATIENT_ID=

.gitignore

@@ -4,3 +4,4 @@ node_modules
 .env
 .env.*
 !.env.example
+*.pem

README.md

@@ -1,3 +1,239 @@
-# IHS
+Indonesia Health Service API Helpers
 
-Work in Progress Indonesia Health Service API Helpers
+- ✅ FHIR API
+- ✅ Patient Consent API
+- ✅ KYC API
+- ✅ Automatic authentication and token invalidation
+- ✅ TypeSafe and Autocomplete-Enabled API
+
+## Instalasi
+
+Instalasi paket dapat dilakukan dengan perintah berikut:
+
+```bash
+npm install @ssecd/ihs
+```
+
+Untuk dukungan _type safe_ pada API FHIR, perlu menambahkan development dependensi `@types/fhir` dengan perintah:
+
+```bash
+npm install --save-dev @types/fhir
+```
+
+Instalasi juga dapat dilakukan menggunakan `PNPM` atau `YARN`
+
+## Penggunaan
+
+### Inisialisasi
+
+Penggunaan paket ini sangatlah sederhana, cukup menginisialisasi global instansi pada sebuah modul atau file seperti berikut:
+
+```ts
+// file: ihs.ts atau ihs.js
+import IHS from '@ssecd/ihs';
+
+const ihs = new IHS();
+
+export default ihs;
+```
+
+Secara default konfigurasi seperti **Client Secret** atau **Secret Key** akan dibaca melalui environment variable namun konfigurasi juga dapat diatur pada constructor class seperti berikut:
+
+```ts
+const ihs = new IHS({
+	clientSecret: '<client secret dari platform SatuSehat>',
+	kycPemFile: `/home/user/kyc-publickey.pem`
+	// dan seterusnya
+});
+```
+
+Selain menggunakan objek, konfigurasi juga dapat diatur menggunakan fungsi, misalnya pada kasus membaca atau mendapatkan konfigurasi dari database:
+
+```ts
+const ihs = new IHS(async () => {
+	const config = await sql`select * from config`;
+	return {
+		clientSecret: config.clientSecret
+		// dan seterusnya ...
+	};
+});
+```
+
+Perlu diperhatikan bahwa fungsi config pada constructor parameter tersebut hanya akan dipanggil satu kali. Bila terjadi perubahan konfigurasi harap memanggil fungsi `invalidateConfig()` pada instansi IHS untuk memperbaharui atau menerapkan perubahan konfigurasi.
+
+```ts
+await ihs.invalidateConfig();
+```
+
+Konfigurasi lengkapnya dapat dilihat di bagian [Konfigurasi](#konfigurasi).
+
+### Autentikasi
+
+Proses autentikasi dan re-autentikasi dilakukan secara otomatis pada saat melakukan request di masing-masing API. Autentikasi terjadi hanya ketika tidak terdapat token atau token sudah kedaluwarsa.
+
+Meski demikian, autentikasi juga dapat dilakukan secara manual jika sewaktu-waktu memerlukan informasi dari response autentikasi melalui instansi `IHS` dengan memanggil method `auth()` dengan kembalian berupa type `AuthDetail` yang berisi informasi autentikasi termasuk nilai `access_token`, `expires_in`, `issued_at` dan lainnya sesuai dengan spesifikasi IHS.
+
+```ts
+import ihs from './path/to/ihs.js';
+
+const detail: AuthDetail = await ihs.auth();
+```
+
+### Patient Consent API
+
+Pada Patient Consent, terdapat dua buah method yang di-definisikan sesuai dengan spesifikasi IHS yakni method untuk mendapatkan informasi consent pasien:
+
+```ts
+const result = await ihs.consent.get('P02478375538');
+
+if (result.resourceType === 'Consent') {
+	console.info(result); // Consent resource
+} else {
+	console.error(result); // OperationOutcome resource
+}
+```
+
+dan method untuk memperbarui informasi consent pasien:
+
+```ts
+const result = await ihs.consent.update({
+	patientId: 'P02478375538',
+	action: 'OPTIN',
+	agent: 'Nama Agen'
+});
+
+if (result.resourceType === 'Consent') {
+	console.info(result); // Consent resource
+} else {
+	console.error(result); // OperationOutcome resource
+}
+```
+
+Setiap method pada Patient Consent API ini memiliki nilai kembalian FHIR resource `Consent` jika request sukses dan `OperationOutcome` jika request gagal.
+
+### FHIR API
+
+Pada API ini, implementasi-nya sangat sederhana dan mengutamakan fleksibilitas yakni dengan hanya mengembalikan `Response` object sehingga response sepenuhnya di-_handle_ pengguna.
+
+```ts
+const response: Response = await ihs.fhir(`/Patient`, {
+	searchParams: [
+		['identifier', 'https://fhir.kemkes.go.id/id/nik|9271060312000001'],
+		['gender', 'male']
+	]
+});
+
+if (response.ok) {
+	const patientBundle = await response.json();
+	console.info(patientBundle); // Bundle<Patient>
+}
+```
+
+### KYC API
+
+Pada API ini, terdapat dua buah method yakni method untuk melakukan proses Generate URL Validasi di mana URL digunakan untuk melakukan verifikasi akun SatuSehat melalui SatuSehat Mobile:
+
+```ts
+const result = await ihs.kyc.generateValidationUrl({
+	name: 'Nama Agen',
+	nik: 'NIK Agen'
+});
+
+if ('error' in result.data) {
+	console.error(result.data.error); // Request error message
+} else {
+	console.info(result.data);
+	/*
+	{
+		agent_name: string;
+		agent_nik: string;
+		token: string;
+		url: string;
+	}
+	*/
+}
+```
+
+dan method untuk melakukan proses Generate Kode Verifikasi di mana nilai tersebut akan muncul di SatuSehat Mobile (SSM) dan digunakan oleh pasien untuk proses validasi:
+
+```ts
+const result = await ihs.kyc.generateVerificationCode({
+	nik: 'NIK Pasien',
+	name: 'Nama Pasien'
+});
+
+if ('error' in result.data) {
+	console.error(result.data.error); // Request error message
+} else {
+	console.info(result.data);
+	/*
+	{
+		nik: string;
+		name: string;
+		ihs_number: string;
+		challenge_code: string;
+		created_timestamp: string;
+		expired_timestamp: string;
+	}
+	*/
+}
+```
+
+Setiap method pada API ini memiliki parameter dan nilai kembalian yang di-definisikan sesuai dengan spesifikasi IHS pada Playbook.
+
+Proses enkripsi dan dekripsi pesan dilakukan dengan menggunakan algoritma `aes-256-gcm` sedangkan untuk proses enkripsi dan dekripsi _symmetric key_ menggunakan metode RSA dengan `RSA_PKCS1_OAEP_PADDING` padding dan `sha256` hash. Semua proses tersebut sudah dilakukan secara internal sesuai dengan spesifikasi IHS pada Playbook.
+
+Proses kriptografi pada API ini memerlukan file _server key_ atau _public key_ dengan format `.pem`. File _public key_ ini dapat disesuaikan lokasinya dengan mengatur `kycPemFile` pada config instance atau class `IHS` yang secara default bernama `publickey.dev.pem` pada mode `development` atau `publickey.pem` pada mode `production` dan berada di _working directory_ atau folder di mana API dijalankan.
+
+## Konfigurasi
+
+Konfigurasi mengikuti interface berikut:
+
+```ts
+interface IHSConfig {
+	/**
+	 * Client secret dari Akses Kode API di Platform SatuSehat
+	 *
+	 * @default process.env.IHS_CLIENT_SECRET
+	 */
+	clientSecret: string;
+
+	/**
+	 * Secret key dari Akses Kode API di Platform SatuSehat
+	 *
+	 * @default process.env.IHS_SECRET_KEY
+	 */
+	secretKey: string;
+
+	/**
+	 * Mode environment API antara `development` ata `production`
+	 *
+	 * @default process.env.NODE_ENV || 'development'
+	 */
+	mode: Mode;
+
+	/**
+	 * Path atau lokasi public key KYC dari SatuSehat. Dapat
+	 * menggunakan absolute atau relative path. Secara default
+	 * akan membaca nilai environment variable IHS_KYC_PEM_FILE
+	 * atau `publickey.dev.pem` pada mode `development` dan
+	 * `publickey.pem` pada mode `production`
+	 *
+	 * @default process.env.IHS_KYC_PEM_FILE
+	 */
+	kycPemFile: string;
+}
+```
+
+## Kontribusi
+
+Kontribusi sangat dipersilakan dan dapat dilakukan dengan berbagai cara seperti melaporkan masalah, membuat permintaan atau menambahkan fitur melalui PR, atau sekedar memperbaiki kesalahan ketikan.
+
+## Lisensi
+
+[MIT](./LICENSE)
+
+## Lainnya
+
+- [Pemecahan Masalah](https://github.com/ssecd/ihs/issues?q=is%3Aissue)
+- [Laporkan Bug](https://github.com/ssecd/ihs/issues/new)

package.json

@@ -15,10 +15,11 @@
 	"type": "module",
 	"scripts": {
 		"test": "vitest",
-		"build": "tsc",
+		"build": "rollup -c",
 		"lint": "prettier --check . && eslint .",
 		"format": "prettier --write .",
-		"release": "changeset publish"
+		"release": "changeset publish",
+		"prepublishOnly": "dts-buddy"
 	},
 	"keywords": [
 		"ihs",
@@ -33,26 +34,33 @@
 		"url": "https://github.com/mustofa-id"
 	},
 	"license": "MIT",
+	"module": "./dist/ihs.js",
+	"types": "./dist/ihs.d.ts",
 	"files": [
+		"src",
 		"dist"
 	],
-	"module": "./dist/index.js",
-	"types": "./dist/index.d.ts",
 	"exports": {
-		"types": "./dist/index.d.ts",
-		"import": "./dist/index.js"
+		".": {
+			"types": "./dist/ihs.d.ts",
+			"import": "./src/ihs.js"
+		}
 	},
 	"devDependencies": {
 		"@changesets/cli": "^2.27.1",
-		"@types/node": "^20.10.5",
-		"@typescript-eslint/eslint-plugin": "^6.15.0",
-		"@typescript-eslint/parser": "^6.15.0",
+		"@rollup/plugin-typescript": "^11.1.5",
+		"@types/node": "^20.10.8",
+		"@typescript-eslint/eslint-plugin": "^6.18.1",
+		"@typescript-eslint/parser": "^6.18.1",
 		"dotenv": "^16.3.1",
+		"dts-buddy": "^0.4.3",
 		"eslint": "^8.56.0",
 		"eslint-config-prettier": "^9.1.0",
 		"prettier": "^3.1.1",
+		"rollup": "^4.9.4",
+		"tslib": "^2.6.2",
 		"typescript": "^5.3.3",
-		"vitest": "^1.1.0"
+		"vitest": "^1.1.3"
 	},
 	"peerDependencies": {
 		"@types/fhir": "^0.0.40"