Repository navigation
Installation
Bahasa / Language: English · Bahasa Indonesia
- Node.js: 18+
- npm or yarn or pnpm: Latest
- TypeScript: 5.0+ (optional but recommended)
- Satu Sehat Account: OAuth2 client credentials from developer portal
npm install @ivanwilliammd/satusehat-integrationOr with yarn / pnpm:
yarn add @ivanwilliammd/satusehat-integration
pnpm add @ivanwilliammd/satusehat-integrationTypeScript types are bundled. If using an older version:
npm install --save-dev @types/node# Environment: DEV (development), STAGING, or PROD (production)
SATUSEHAT_ENV=DEV
# OAuth2 credentials from Satu Sehat Developer Portal
SATUSEHAT_CLIENT_ID=your_client_id_here
SATUSEHAT_CLIENT_SECRET=your_client_secret_here
# Your organization IHS number
SATUSEHAT_ORGANIZATION_ID=your_org_ihs_number_hereIn Node.js, use dotenv to load .env:
npm install dotenvimport 'dotenv/config';Or in package.json scripts:
{
"scripts": {
"start": "node --env-file=.env dist/index.js",
"dev": "ts-node --env-file=.env src/index.ts"
}
}Ensure tsconfig.json includes:
{
"compilerOptions": {
"target": "ES2022",
"module": "NodeNext",
"moduleResolution": "NodeNext",
"strict": true,
"esModuleInterop": true,
"skipLibCheck": true,
"outDir": "./dist",
"rootDir": "./src"
},
"include": ["src/**/*"],
"exclude": ["node_modules"]
}The package supports both ESM and CommonJS:
ESM ("type": "module" in package.json):
import { OAuth2Client, SSRequest } from 'satusehat-integration';CommonJS:
const { OAuth2Client, SSRequest } = require('satusehat-integration');| Variable | Required | Values | Description |
|---|---|---|---|
SATUSEHAT_ENV |
Yes |
DEV, STAGING, PROD
|
API environment |
SATUSEHAT_CLIENT_ID |
Yes | string | OAuth2 client ID |
SATUSEHAT_CLIENT_SECRET |
Yes | string | OAuth2 client secret |
SATUSEHAT_ORGANIZATION_ID |
Yes | IHS number | Your organization ID |
SATUSEHAT_FHIR_BASE_URL |
No | URL | Override FHIR base URL |
import 'dotenv/config';
import { OAuth2Client } from 'satusehat-integration';
async function main() {
const client = new OAuth2Client({
clientId: process.env.SATUSEHAT_CLIENT_ID!,
clientSecret: process.env.SATUSEHAT_CLIENT_SECRET!,
organizationId: process.env.SATUSEHAT_ORGANIZATION_ID!,
environment: (process.env.SATUSEHAT_ENV as 'DEV' | 'STAGING' | 'PROD') || 'DEV',
});
console.log('Organization ID:', client.organizationId);
console.log('FHIR Base URL:', client.fhirBaseUrl);
try {
const token = await client.getToken();
console.log('Token OK:', token ? 'yes' : 'no');
} catch (err) {
console.error('Token error:', err);
}
}
main();- Register at https://satusehat.kemkes.go.id/developer
- Create OAuth2 application (Web Application type)
- Generate client credentials
- Request scopes:
read:Patient,write:Patient,read:Encounter,write:Encounter, etc. - Register public key (required for JWT authentication)
- Whitelist your server IP in the developer portal
my-satusehat-app/
├── .env
├── package.json
├── tsconfig.json
├── src/
│ └── index.ts
└── dist/
The library uses these peer dependencies:
| Package | Required | Purpose |
|---|---|---|
node-fetch |
Only Node < 18 | HTTP client polyfill |
Optional dev dependencies for TypeScript projects:
| Package | Purpose |
|---|---|
typescript |
TypeScript compiler |
ts-node |
TypeScript REPL / dev runner |
dotenv |
.env file loading |
@types/node |
Node.js type definitions |
vitest or jest
|
Testing |
- Node.js: 18+
- npm, yarn, atau pnpm: versi terbaru
- TypeScript: 5.0+ (opsional, dianjurkan)
- Akun Satu Sehat: kredensial OAuth2 dari portal developer
npm install @ivanwilliammd/satusehat-integrationAtau lewat yarn / pnpm:
yarn add @ivanwilliammd/satusehat-integration
pnpm add @ivanwilliammd/satusehat-integrationTipe sudah dibundel di dalam paket. Untuk versi lama, pasang @types/node:
npm install --save-dev @types/node# Environment: DEV (pengembangan), STAGING, atau PROD (produksi)
SATUSEHAT_ENV=DEV
# Kredensial OAuth2 dari Satu Sehat Developer Portal
SATUSEHAT_CLIENT_ID=your_client_id_here
SATUSEHAT_CLIENT_SECRET=your_client_secret_here
# IHS number organisasi Anda
SATUSEHAT_ORGANIZATION_ID=your_org_ihs_number_hereDi Node.js, muat .env dengan dotenv:
npm install dotenvimport 'dotenv/config';Atau langsung di skrip package.json:
{
"scripts": {
"start": "node --env-file=.env dist/index.js",
"dev": "ts-node --env-file=.env src/index.ts"
}
}Pastikan tsconfig.json memuat:
{
"compilerOptions": {
"target": "ES2022",
"module": "NodeNext",
"moduleResolution": "NodeNext",
"strict": true,
"esModuleInterop": true,
"skipLibCheck": true,
"outDir": "./dist",
"rootDir": "./src"
},
"include": ["src/**/*"],
"exclude": ["node_modules"]
}Paket mendukung keduanya:
ESM ("type": "module" di package.json):
import { OAuth2Client, SSRequest } from 'satusehat-integration';CommonJS:
const { OAuth2Client, SSRequest } = require('satusehat-integration');| Variabel | Wajib | Nilai | Keterangan |
|---|---|---|---|
SATUSEHAT_ENV |
Ya |
DEV, STAGING, PROD
|
Lingkungan API |
SATUSEHAT_CLIENT_ID |
Ya | string | OAuth2 client ID |
SATUSEHAT_CLIENT_SECRET |
Ya | string | OAuth2 client secret |
SATUSEHAT_ORGANIZATION_ID |
Ya | IHS number | ID organisasi Anda |
SATUSEHAT_FHIR_BASE_URL |
Tidak | URL | Menimpa base URL FHIR |
import 'dotenv/config';
import { OAuth2Client } from 'satusehat-integration';
async function main() {
const client = new OAuth2Client({
clientId: process.env.SATUSEHAT_CLIENT_ID!,
clientSecret: process.env.SATUSEHAT_CLIENT_SECRET!,
organizationId: process.env.SATUSEHAT_ORGANIZATION_ID!,
environment: (process.env.SATUSEHAT_ENV as 'DEV' | 'STAGING' | 'PROD') || 'DEV',
});
console.log('Organization ID:', client.organizationId);
console.log('FHIR Base URL:', client.fhirBaseUrl);
try {
const token = await client.getToken();
console.log('Token OK:', token ? 'yes' : 'no');
} catch (err) {
console.error('Token error:', err);
}
}
main();- Daftar di https://satusehat.kemkes.go.id/developer
- Buat aplikasi OAuth2 (tipe Web Application)
- Buat kredensial client
- Minta scope:
read:Patient,write:Patient,read:Encounter,write:Encounter, dan seterusnya - Daftarkan public key (wajib untuk autentikasi JWT)
- Masukkan IP server Anda ke whitelist di portal
my-satusehat-app/
├── .env
├── package.json
├── tsconfig.json
├── src/
│ └── index.ts
└── dist/
Pustaka ini memakai peer dependency berikut:
| Paket | Wajib | Kegunaan |
|---|---|---|
node-fetch |
Hanya Node < 18 | Polyfill klien HTTP |
Dependensi dev opsional untuk proyek TypeScript:
| Paket | Kegunaan |
|---|---|
typescript |
Kompilator TypeScript |
ts-node |
REPL / runner pengembangan |
dotenv |
Memuat berkas .env
|
@types/node |
Definisi tipe Node.js |
vitest atau jest
|
Pengujian |