@digitalmedika/satusehat 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Digital Medika
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,135 @@
+# @digitalmedika/satusehat
+
+Type-safe TypeScript SDK untuk SATUSEHAT API.
+
+SDK ini dirancang untuk:
+
+- validasi request dan response dengan runtime schema
+- type inference end-to-end di TypeScript
+- OAuth2 client credentials
+- token cache in-memory atau file-based
+- ergonomi SDK yang cocok untuk backend service dan internal tooling
+
+## Helpers
+
+Helper builder yang saat ini tersedia:
+
+- `createCompleteBloodCountPanelBuilder`
+- `createLaboratoryPanelBuilder`
+- `createOrganizationBuilder`
+- `createServiceRequestSpecimenObservationBuilder`
+
+## Installation
+
+```bash
+bun add @digitalmedika/satusehat
+```
+
+Untuk development library ini sendiri:
+
+```bash
+bun install
+```
+
+## Quick Start
+
+```ts
+import { createSatuSehatClientFromEnv } from "@digitalmedika/satusehat";
+
+const client = createSatuSehatClientFromEnv();
+
+const patient = await client.patient.search({
+  identifier: "https://fhir.kemkes.go.id/id/nik|9271060312000001",
+});
+```
+
+## Environment Variables
+
+Salin template dari [.env.example](./.env.example).
+
+Variable utama:
+
+- `SATUSEHAT_ENV`
+- `SATUSEHAT_BASE_URL`
+- `SATUSEHAT_AUTH_BASE_URL`
+- `SATUSEHAT_CLIENT_ID`
+- `SATUSEHAT_CLIENT_SECRET`
+- `SATUSEHAT_TOKEN_CACHE_FILE`
+
+## Available Resources
+
+Saat ini resource yang sudah tersedia:
+
+- `condition`
+- `diagnosticReport`
+- `encounter`
+- `observation`
+- `procedure`
+- `medication`
+- `medicationRequest`
+- `serviceRequest`
+- `specimen`
+- `patient`
+- `organization`
+- `location`
+- `practitioner`
+- `practitionerRole`
+
+## Token Handling
+
+Secara default SDK mendukung:
+
+- token provider berbasis OAuth2 client credentials
+- cache token in-memory
+- file-based token store opsional untuk local testing/internal tools
+- refresh otomatis saat token expired atau mendekati expired
+- retry sekali saat menerima `401` jika token bisa di-invalidasi
+
+## Development
+
+```bash
+bun run typecheck
+bun test
+bun run build
+```
+
+Smoke test ke SATUSEHAT live:
+
+```bash
+bun run smoke:live
+```
+
+Untuk environment `sandbox`, smoke test akan memakai dummy patient resmi SATUSEHAT bila parameter test belum diisi.
+
+## Documentation
+
+- [Getting Started](./docs/getting-started.md)
+- [Authentication](./docs/authentication.md)
+- [Errors](./docs/errors.md)
+- [Condition](./docs/resources/condition.md)
+- [DiagnosticReport](./docs/resources/diagnostic-report.md)
+- [Patient](./docs/resources/patient.md)
+- [Encounter](./docs/resources/encounter.md)
+- [Procedure](./docs/resources/procedure.md)
+- [Observation](./docs/resources/observation.md)
+- [Medication](./docs/resources/medication.md)
+- [MedicationRequest](./docs/resources/medication-request.md)
+- [ServiceRequest](./docs/resources/service-request.md)
+- [Specimen](./docs/resources/specimen.md)
+- [ServiceRequest -> Specimen -> Observation Builder](./docs/helpers/service-request-specimen-observation-builder.md)
+- [Laboratory Panel Builder](./docs/helpers/laboratory-panel-builder.md)
+- [CBC Panel Builder](./docs/helpers/cbc-panel-builder.md)
+- [Organization](./docs/resources/organization.md)
+- [Location](./docs/resources/location.md)
+- [Practitioner](./docs/resources/practitioner.md)
+- [PractitionerRole](./docs/resources/practitioner-role.md)
+- [Planning](./docs/planning.md)
+
+## Premium Support
+
+Untuk premium support dan implementasi, hubungi:
+
+- Email: [info@digitalmedika.co.id](mailto:info@digitalmedika.co.id)
+- WhatsApp: [Digital Medika](https://wa.me/qr/F37IBV5GECN7K1)
+
+![QR WhatsApp Digital Medika](docs/assets/premium-support-whatsapp-qr.jpeg)

package/dist/builders/cbc-panel-builder.d.ts

@@ -0,0 +1,18 @@
+import { type LaboratoryPanelBuilder } from "./laboratory-panel-builder";
+import type { ObservationCreateInput, ObservationQuantity } from "../schemas/observation";
+import type { Reference } from "../schemas/common";
+import type { DiagnosticReportCreateInput } from "../schemas/diagnostic-report";
+import type { ServiceRequestCreateInput } from "../schemas/service-request";
+import type { SpecimenCreateInput } from "../schemas/specimen";
+export type CompleteBloodCountObservationKey = "wbc" | "rbc" | "hemoglobin" | "hematocrit" | "mcv" | "mch" | "mchc" | "platelets" | "rdw" | "pdw" | "mpv";
+export interface CompleteBloodCountPanelBuilderInput {
+    subject: Reference;
+    encounter: Reference;
+    serviceRequest?: Partial<Omit<ServiceRequestCreateInput, "resourceType" | "subject" | "encounter" | "status" | "intent" | "code">>;
+    specimen?: Partial<Omit<SpecimenCreateInput, "resourceType" | "subject" | "status" | "type">>;
+    diagnosticReport?: Partial<Omit<DiagnosticReportCreateInput, "resourceType" | "subject" | "encounter" | "status" | "code">>;
+    observationDefaults?: Partial<Omit<ObservationCreateInput, "resourceType" | "subject" | "encounter" | "status" | "code">>;
+    results?: Partial<Record<CompleteBloodCountObservationKey, number | ObservationQuantity>>;
+    includeOptionalObservations?: boolean;
+}
+export declare function createCompleteBloodCountPanelBuilder(input: CompleteBloodCountPanelBuilderInput): LaboratoryPanelBuilder;

package/dist/builders/laboratory-panel-builder.d.ts

@@ -0,0 +1,72 @@
+import type { DiagnosticReportCreateInput } from "../schemas/diagnostic-report";
+import type { ObservationCreateInput, ObservationNote, ObservationQuantity } from "../schemas/observation";
+import type { Reference } from "../schemas/common";
+import type { ServiceRequestCreateInput, ServiceRequestNote } from "../schemas/service-request";
+import type { SpecimenCollection, SpecimenContainer, SpecimenCreateInput, SpecimenNote } from "../schemas/specimen";
+export interface LaboratoryPanelBuilderInput {
+    subject: Reference;
+    encounter: Reference;
+    serviceRequest: Pick<ServiceRequestCreateInput, "status" | "intent" | "code"> & Partial<Omit<ServiceRequestCreateInput, "resourceType" | "subject" | "encounter">>;
+    specimen: Pick<SpecimenCreateInput, "status" | "type"> & Partial<Omit<SpecimenCreateInput, "resourceType" | "subject">>;
+    diagnosticReport: Pick<DiagnosticReportCreateInput, "status" | "code"> & Partial<Omit<DiagnosticReportCreateInput, "resourceType" | "subject" | "encounter">>;
+    observationDefaults?: Partial<Omit<ObservationCreateInput, "resourceType" | "subject" | "encounter" | "status" | "code">>;
+}
+export type LaboratoryPanelObservationInput = Pick<ObservationCreateInput, "status" | "code"> & Partial<Omit<ObservationCreateInput, "resourceType" | "subject" | "encounter" | "status" | "code">>;
+export interface LaboratoryPanelObservationEntry {
+    key: string;
+    body: ObservationCreateInput;
+}
+export interface LaboratoryPanelServiceRequestLinks {
+    serviceRequestId?: string;
+    serviceRequestReference?: Reference;
+}
+export interface LaboratoryPanelObservationLinks extends LaboratoryPanelServiceRequestLinks {
+    specimenId?: string;
+    specimenReference?: Reference;
+}
+export interface LaboratoryPanelDiagnosticReportLinks extends LaboratoryPanelServiceRequestLinks {
+    specimenId?: string;
+    specimenIds?: string[];
+    specimenReference?: Reference;
+    specimenReferences?: Reference[];
+    resultIds?: string[];
+    resultReferences?: Reference[];
+}
+type ServiceRequestMutableInput = Partial<Omit<ServiceRequestCreateInput, "resourceType" | "subject" | "encounter">>;
+type SpecimenMutableInput = Partial<Omit<SpecimenCreateInput, "resourceType" | "subject">>;
+type DiagnosticReportMutableInput = Partial<Omit<DiagnosticReportCreateInput, "resourceType" | "subject" | "encounter">>;
+type ObservationDefaultsInput = Partial<Omit<ObservationCreateInput, "resourceType" | "subject" | "encounter" | "status" | "code">>;
+type ObservationMutableInput = Partial<Omit<ObservationCreateInput, "resourceType" | "subject" | "encounter">>;
+export declare class LaboratoryPanelBuilder {
+    private serviceRequestDraft;
+    private specimenDraft;
+    private diagnosticReportDraft;
+    private observationDefaults;
+    private observationDrafts;
+    constructor(input: LaboratoryPanelBuilderInput);
+    setSubject(subject: Reference): this;
+    setEncounter(encounter: Reference): this;
+    mergeServiceRequest(input: ServiceRequestMutableInput): this;
+    mergeSpecimen(input: SpecimenMutableInput): this;
+    mergeDiagnosticReport(input: DiagnosticReportMutableInput): this;
+    setObservationDefaults(input: ObservationDefaultsInput): this;
+    addObservation(key: string, input: LaboratoryPanelObservationInput): this;
+    mergeObservation(key: string, input: ObservationMutableInput): this;
+    setObservationValueQuantity(key: string, valueQuantity: ObservationQuantity): this;
+    addObservationNote(key: string, note: ObservationNote): this;
+    addServiceRequestNote(note: ServiceRequestNote): this;
+    addSpecimenNote(note: SpecimenNote): this;
+    setSpecimenCollection(collection: SpecimenCollection): this;
+    addSpecimenContainer(container: SpecimenContainer): this;
+    listObservationKeys(): string[];
+    buildServiceRequest(): ServiceRequestCreateInput;
+    buildSpecimen(links?: LaboratoryPanelServiceRequestLinks): SpecimenCreateInput;
+    buildObservation(key: string, links?: LaboratoryPanelObservationLinks): ObservationCreateInput;
+    buildObservationEntries(links?: LaboratoryPanelObservationLinks): LaboratoryPanelObservationEntry[];
+    buildObservations(links?: LaboratoryPanelObservationLinks): ObservationCreateInput[];
+    buildDiagnosticReport(links?: LaboratoryPanelDiagnosticReportLinks): DiagnosticReportCreateInput;
+    private createObservationDraft;
+    private requireObservationDraft;
+}
+export declare function createLaboratoryPanelBuilder(input: LaboratoryPanelBuilderInput): LaboratoryPanelBuilder;
+export {};

package/dist/builders/organization-builder.d.ts

@@ -0,0 +1,23 @@
+import type { OrganizationAddress, OrganizationContact, OrganizationCreateInput, OrganizationIdentifier, OrganizationReference, OrganizationTelecom, OrganizationType } from "../schemas/organization";
+export interface OrganizationBuilderRequiredInput {
+    active: boolean;
+    identifier: OrganizationIdentifier;
+    name: string;
+    type: OrganizationType;
+}
+export declare class OrganizationBuilder {
+    private draft;
+    constructor(input: OrganizationBuilderRequiredInput);
+    addAddress(address: OrganizationAddress): this;
+    addAlias(alias: string): this;
+    addContact(contact: OrganizationContact): this;
+    addEndpoint(endpoint: OrganizationReference): this;
+    addIdentifier(identifier: OrganizationIdentifier): this;
+    addTelecom(telecom: OrganizationTelecom): this;
+    addType(type: OrganizationType): this;
+    setPartOf(partOf: OrganizationReference): this;
+    setActive(active: boolean): this;
+    setName(name: string): this;
+    build(): OrganizationCreateInput;
+}
+export declare function createOrganizationBuilder(input: OrganizationBuilderRequiredInput): OrganizationBuilder;

package/dist/builders/service-request-specimen-observation-builder.d.ts

@@ -0,0 +1,62 @@
+import type { DiagnosticReportCreateInput } from "../schemas/diagnostic-report";
+import type { ObservationCreateInput, ObservationNote, ObservationQuantity } from "../schemas/observation";
+import type { Reference } from "../schemas/common";
+import type { ServiceRequestCreateInput, ServiceRequestNote } from "../schemas/service-request";
+import type { SpecimenCollection, SpecimenContainer, SpecimenCreateInput, SpecimenNote } from "../schemas/specimen";
+export interface ServiceRequestSpecimenObservationBuilderInput {
+    subject: Reference;
+    encounter: Reference;
+    serviceRequest: Pick<ServiceRequestCreateInput, "status" | "intent" | "code"> & Partial<Omit<ServiceRequestCreateInput, "resourceType" | "subject" | "encounter">>;
+    specimen: Pick<SpecimenCreateInput, "status" | "type"> & Partial<Omit<SpecimenCreateInput, "resourceType" | "subject">>;
+    observation: Pick<ObservationCreateInput, "status" | "code"> & Partial<Omit<ObservationCreateInput, "resourceType" | "subject" | "encounter">>;
+    diagnosticReport?: Pick<DiagnosticReportCreateInput, "status" | "code"> & Partial<Omit<DiagnosticReportCreateInput, "resourceType" | "subject" | "encounter">>;
+}
+export interface ServiceRequestBuildLinks {
+    serviceRequestId?: string;
+    serviceRequestReference?: Reference;
+}
+export interface ObservationBuildLinks extends ServiceRequestBuildLinks {
+    specimenId?: string;
+    specimenReference?: Reference;
+}
+export interface DiagnosticReportBuildLinks extends ServiceRequestBuildLinks {
+    specimenId?: string;
+    specimenIds?: string[];
+    specimenReference?: Reference;
+    specimenReferences?: Reference[];
+    resultId?: string;
+    resultIds?: string[];
+    resultReference?: Reference;
+    resultReferences?: Reference[];
+}
+type ServiceRequestMutableInput = Partial<Omit<ServiceRequestCreateInput, "resourceType" | "subject" | "encounter">>;
+type SpecimenMutableInput = Partial<Omit<SpecimenCreateInput, "resourceType" | "subject">>;
+type ObservationMutableInput = Partial<Omit<ObservationCreateInput, "resourceType" | "subject" | "encounter">>;
+type DiagnosticReportMutableInput = Partial<Omit<DiagnosticReportCreateInput, "resourceType" | "subject" | "encounter">>;
+export declare class ServiceRequestSpecimenObservationBuilder {
+    private serviceRequestDraft;
+    private specimenDraft;
+    private observationDraft;
+    private diagnosticReportDraft?;
+    constructor(input: ServiceRequestSpecimenObservationBuilderInput);
+    setSubject(subject: Reference): this;
+    setEncounter(encounter: Reference): this;
+    mergeServiceRequest(input: ServiceRequestMutableInput): this;
+    mergeSpecimen(input: SpecimenMutableInput): this;
+    mergeObservation(input: ObservationMutableInput): this;
+    setDiagnosticReport(input: Pick<DiagnosticReportCreateInput, "status" | "code"> & Partial<Omit<DiagnosticReportCreateInput, "resourceType" | "subject" | "encounter">>): this;
+    mergeDiagnosticReport(input: DiagnosticReportMutableInput): this;
+    addServiceRequestNote(note: ServiceRequestNote): this;
+    addSpecimenNote(note: SpecimenNote): this;
+    addObservationNote(note: ObservationNote): this;
+    setSpecimenCollection(collection: SpecimenCollection): this;
+    addSpecimenContainer(container: SpecimenContainer): this;
+    setObservationValueQuantity(valueQuantity: ObservationQuantity): this;
+    buildServiceRequest(): ServiceRequestCreateInput;
+    buildSpecimen(links?: ServiceRequestBuildLinks): SpecimenCreateInput;
+    buildObservation(links?: ObservationBuildLinks): ObservationCreateInput;
+    buildDiagnosticReport(links?: DiagnosticReportBuildLinks): DiagnosticReportCreateInput;
+    private requireDiagnosticReportDraft;
+}
+export declare function createServiceRequestSpecimenObservationBuilder(input: ServiceRequestSpecimenObservationBuilderInput): ServiceRequestSpecimenObservationBuilder;
+export {};

package/dist/client/auth.d.ts

@@ -0,0 +1,11 @@
+import { type FetchLike, type MaybePromise, type OAuthClientCredentials, type TokenStore } from "../core/types";
+export interface ClientCredentialsTokenProviderOptions extends OAuthClientCredentials {
+    authBaseUrl: string;
+    fetch?: FetchLike;
+    headers?: HeadersInit;
+    tokenStore?: TokenStore;
+    tokenExpiryWindowMs?: number;
+    now?: () => number;
+}
+export declare function createClientCredentialsTokenProvider(options: ClientCredentialsTokenProviderOptions): () => Promise<string>;
+export declare function resolveAccessToken(accessToken?: string | (() => MaybePromise<string>)): Promise<string | undefined>;

package/dist/client/create-client.d.ts

@@ -0,0 +1,5 @@
+import { type SatuSehatClient, type SatuSehatClientConfig, type SatuSehatEnvironment, type SatuSehatEnvSource } from "../core/types";
+export declare function createSatuSehatClient(config?: SatuSehatClientConfig): SatuSehatClient;
+export declare function createSatuSehatClientFromEnv(env?: SatuSehatEnvSource, overrides?: Omit<SatuSehatClientConfig, "environment" | "baseUrl" | "authBaseUrl" | "credentials">): SatuSehatClient;
+export declare function resolveSatuSehatBaseUrl(environment: SatuSehatEnvironment): string;
+export declare function resolveSatuSehatAuthBaseUrl(environment: SatuSehatEnvironment): string;

package/dist/client/token-store.d.ts

@@ -0,0 +1,7 @@
+import type { StoredAccessToken, TokenExpiryCheckOptions, TokenStore } from "../core/types";
+export interface FileTokenStoreOptions {
+    filePath: string;
+}
+export declare function createMemoryTokenStore(initialToken?: StoredAccessToken): TokenStore;
+export declare function createFileTokenStore(options: FileTokenStoreOptions): TokenStore;
+export declare function isAccessTokenExpired(token: Pick<StoredAccessToken, "expiresAt">, options?: TokenExpiryCheckOptions): boolean;

package/dist/client/transport.d.ts

@@ -0,0 +1,28 @@
+import { type ZodTypeAny } from "zod";
+import { type AccessTokenProvider, type FetchLike } from "../core/types";
+export interface TransportOptions {
+    baseUrl: string;
+    accessToken?: AccessTokenProvider;
+    invalidateAccessToken?: () => Promise<void>;
+    retryOnUnauthorized?: boolean;
+    defaultHeaders?: HeadersInit;
+    fetch?: FetchLike;
+    validateResponse?: boolean;
+}
+export interface RequestOptions<TQuerySchema extends ZodTypeAny | undefined, TBodySchema extends ZodTypeAny | undefined, TResponseSchema extends ZodTypeAny> {
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    path: string;
+    query?: unknown;
+    querySchema?: TQuerySchema;
+    body?: unknown;
+    bodySchema?: TBodySchema;
+    headers?: HeadersInit;
+    signal?: AbortSignal;
+    responseSchema: TResponseSchema;
+}
+export interface Transport {
+    request<TQuerySchema extends ZodTypeAny | undefined, TBodySchema extends ZodTypeAny | undefined, TResponseSchema extends ZodTypeAny>(options: RequestOptions<TQuerySchema, TBodySchema, TResponseSchema>): Promise<InferSchema<TResponseSchema>>;
+}
+type InferSchema<TSchema extends ZodTypeAny> = TSchema["_output"];
+export declare function createTransport(options: TransportOptions): Transport;
+export {};

package/dist/core/errors.d.ts

@@ -0,0 +1,25 @@
+import type { ZodIssue } from "zod";
+export declare class SatuSehatError extends Error {
+    readonly cause?: unknown;
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class SatuSehatConfigError extends SatuSehatError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class SatuSehatValidationError extends SatuSehatError {
+    readonly issues: ZodIssue[];
+    constructor(message: string, issues: ZodIssue[], options?: {
+        cause?: unknown;
+    });
+}
+export declare class SatuSehatApiError extends SatuSehatError {
+    readonly status: number;
+    readonly response: unknown;
+    constructor(message: string, status: number, response: unknown, options?: {
+        cause?: unknown;
+    });
+}