@fhirust/sdk 0.2.0

package/dist/r4/practitioner.d.ts

@@ -0,0 +1,24 @@
+import type { Meta, Narrative, Identifier, HumanName, ContactPoint, Address, CodeableConcept, Reference, Period, Attachment } from "./common.js";
+export interface Practitioner {
+    resourceType: "Practitioner";
+    id?: string;
+    meta?: Meta;
+    text?: Narrative;
+    identifier?: Identifier[];
+    active?: boolean;
+    name?: HumanName[];
+    telecom?: ContactPoint[];
+    address?: Address[];
+    gender?: "male" | "female" | "other" | "unknown";
+    birthDate?: string;
+    photo?: Attachment[];
+    qualification?: PractitionerQualification[];
+    communication?: CodeableConcept[];
+}
+export interface PractitionerQualification {
+    identifier?: Identifier[];
+    code: CodeableConcept;
+    period?: Period;
+    issuer?: Reference;
+}
+//# sourceMappingURL=practitioner.d.ts.map

package/dist/r4/practitioner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"practitioner.d.ts","sourceRoot":"","sources":["../../src/r4/practitioner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,IAAI,EACJ,SAAS,EACT,UAAU,EACV,SAAS,EACT,YAAY,EACZ,OAAO,EACP,eAAe,EACf,SAAS,EACT,MAAM,EACN,UAAU,EACX,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,cAAc,CAAC;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,aAAa,CAAC,EAAE,yBAAyB,EAAE,CAAC;IAC5C,aAAa,CAAC,EAAE,eAAe,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC;IAC1B,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB"}

package/dist/r4/practitioner.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=practitioner.js.map

package/dist/r4/practitioner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"practitioner.js","sourceRoot":"","sources":["../../src/r4/practitioner.ts"],"names":[],"mappings":""}

package/dist/r4/procedure.d.ts

@@ -0,0 +1,42 @@
+import type { Meta, Narrative, Identifier, CodeableConcept, Reference, Period, Age, Range, Annotation } from "./common.js";
+export interface Procedure {
+    resourceType: "Procedure";
+    id?: string;
+    meta?: Meta;
+    text?: Narrative;
+    identifier?: Identifier[];
+    basedOn?: Reference[];
+    partOf?: Reference[];
+    status: "preparation" | "in-progress" | "not-done" | "on-hold" | "stopped" | "completed" | "entered-in-error" | "unknown";
+    statusReason?: CodeableConcept;
+    category?: CodeableConcept;
+    code?: CodeableConcept;
+    subject: Reference;
+    encounter?: Reference;
+    performedDateTime?: string;
+    performedPeriod?: Period;
+    performedString?: string;
+    performedAge?: Age;
+    performedRange?: Range;
+    recorder?: Reference;
+    asserter?: Reference;
+    performer?: ProcedurePerformer[];
+    location?: Reference;
+    reasonCode?: CodeableConcept[];
+    reasonReference?: Reference[];
+    bodySite?: CodeableConcept[];
+    outcome?: CodeableConcept;
+    report?: Reference[];
+    complication?: CodeableConcept[];
+    complicationDetail?: Reference[];
+    followUp?: CodeableConcept[];
+    note?: Annotation[];
+    usedReference?: Reference[];
+    usedCode?: CodeableConcept[];
+}
+export interface ProcedurePerformer {
+    function?: CodeableConcept;
+    actor: Reference;
+    onBehalfOf?: Reference;
+}
+//# sourceMappingURL=procedure.d.ts.map

package/dist/r4/procedure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedure.d.ts","sourceRoot":"","sources":["../../src/r4/procedure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,IAAI,EACJ,SAAS,EACT,UAAU,EACV,eAAe,EACf,SAAS,EACT,MAAM,EACN,GAAG,EACH,KAAK,EACL,UAAU,EACX,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,WAAW,CAAC;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,MAAM,EAAE,aAAa,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,kBAAkB,GAAG,SAAS,CAAC;IAC1H,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,SAAS,CAAC;IACnB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB,cAAc,CAAC,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAC/B,eAAe,CAAC,EAAE,SAAS,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;IACjC,kBAAkB,CAAC,EAAE,SAAS,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B,IAAI,CAAC,EAAE,UAAU,EAAE,CAAC;IACpB,aAAa,CAAC,EAAE,SAAS,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,CAAC,EAAE,SAAS,CAAC;CACxB"}

package/dist/r4/procedure.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=procedure.js.map

package/dist/r4/procedure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedure.js","sourceRoot":"","sources":["../../src/r4/procedure.ts"],"names":[],"mappings":""}

package/dist/types.d.ts

@@ -0,0 +1,99 @@
+/** Hook types supported by FHIRust */
+export type HookType = "before-create" | "after-create" | "before-read" | "after-read" | "before-update" | "after-update" | "before-delete" | "after-delete";
+/** FHIR resource type identifiers recognized by the WIT contract */
+export type WitResourceType = "patient" | "observation" | "encounter" | "condition" | "medication-request" | "practitioner" | "organization" | "other";
+/** Context passed to hook handlers */
+export interface HookContext {
+    requestId: string;
+    userId?: string;
+    timestamp: string;
+    operation: string;
+}
+/** WIT-level hook context (kebab-case field names from Component Model) */
+export interface WitHookContext {
+    "request-id": string;
+    "user-id"?: string;
+    timestamp: string;
+    operation: string;
+}
+/** WIT-level modified resource */
+export interface WitModifiedResource {
+    json: string;
+}
+/** WIT-level operation outcome */
+export interface WitOperationOutcome {
+    json: string;
+}
+/** WIT-level result encoding */
+export type WitResult = {
+    tag: "ok";
+    val: WitModifiedResource;
+} | {
+    tag: "err";
+    val: WitOperationOutcome;
+};
+/** WIT-level plugin metadata */
+export interface WitPluginMetadata {
+    name: string;
+    version: string;
+    hooks: [WitResourceType, HookType[]][];
+}
+/** FHIR OperationOutcome issue */
+export interface OperationOutcomeIssue {
+    severity: "fatal" | "error" | "warning" | "information";
+    code: string;
+    diagnostics?: string;
+    details?: {
+        text?: string;
+    };
+}
+/** FHIR OperationOutcome resource */
+export interface OperationOutcome {
+    resourceType: "OperationOutcome";
+    issue: OperationOutcomeIssue[];
+}
+/** FHIR Bundle */
+export interface Bundle<T = any> {
+    resourceType: "Bundle";
+    type: string;
+    total?: number;
+    entry?: BundleEntry<T>[];
+    link?: BundleLink[];
+}
+export interface BundleEntry<T = any> {
+    fullUrl?: string;
+    resource?: T;
+}
+export interface BundleLink {
+    relation: string;
+    url: string;
+}
+/** Handler for before-create / before-update hooks */
+export type BeforeHook<T = any> = (resource: T, ctx: HookContext) => T | Rejection | void;
+/** Handler for after-create / after-read / after-update hooks */
+export type AfterHook<T = any> = (resource: T, ctx: HookContext) => void;
+/** Handler for before-read hooks (no resource body yet) */
+export type BeforeReadHook = (params: {
+    resourceType: string;
+    id: string;
+}, ctx: HookContext) => void | Rejection;
+/** Handler for before-delete hooks */
+export type BeforeDeleteHook = (params: {
+    resourceType: string;
+    id: string;
+}, ctx: HookContext) => void | Rejection;
+/** Handler for after-delete hooks */
+export type AfterDeleteHook = (params: {
+    resourceType: string;
+    id: string;
+}, ctx: HookContext) => void;
+/** Rejection marker returned by reject() */
+export declare class Rejection {
+    readonly outcome: OperationOutcome;
+    constructor(outcome: OperationOutcome);
+}
+/** Convert a resource type name to WIT enum value */
+export declare function toWitResourceType(name: string): WitResourceType;
+/** Convert a WIT resource type back to a display name */
+export declare function fromWitResourceType(wit: WitResourceType): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,30 @@
+/** Rejection marker returned by reject() */
+export class Rejection {
+    outcome;
+    constructor(outcome) {
+        this.outcome = outcome;
+    }
+}
+/** Map of resource type name to WIT enum value */
+const RESOURCE_TYPE_MAP = {
+    Patient: "patient",
+    Observation: "observation",
+    Encounter: "encounter",
+    Condition: "condition",
+    MedicationRequest: "medication-request",
+    Practitioner: "practitioner",
+    Organization: "organization",
+};
+/** Convert a resource type name to WIT enum value */
+export function toWitResourceType(name) {
+    return RESOURCE_TYPE_MAP[name] ?? "other";
+}
+/** Convert a WIT resource type back to a display name */
+export function fromWitResourceType(wit) {
+    for (const [name, value] of Object.entries(RESOURCE_TYPE_MAP)) {
+        if (value === wit)
+            return name;
+    }
+    return wit;
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAqHA,4CAA4C;AAC5C,MAAM,OAAO,SAAS;IACX,OAAO,CAAmB;IAEnC,YAAY,OAAyB;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,kDAAkD;AAClD,MAAM,iBAAiB,GAAoC;IACzD,OAAO,EAAE,SAAS;IAClB,WAAW,EAAE,aAAa;IAC1B,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,WAAW;IACtB,iBAAiB,EAAE,oBAAoB;IACvC,YAAY,EAAE,cAAc;IAC5B,YAAY,EAAE,cAAc;CAC7B,CAAC;AAEF,qDAAqD;AACrD,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,iBAAiB,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC;AAC5C,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,mBAAmB,CAAC,GAAoB;IACtD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC9D,IAAI,KAAK,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;IACjC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@fhirust/sdk",
+  "version": "0.2.0",
+  "description": "TypeScript SDK for building FHIRust WASM plugins",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./r4": {
+      "types": "./dist/r4/index.d.ts",
+      "import": "./dist/r4/index.js"
+    }
+  },
+  "bin": {
+    "fhirust-sdk": "./dist/bin/cli.js"
+  },
+  "files": [
+    "dist/",
+    "wit/",
+    "templates/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "fhir",
+    "fhirust",
+    "wasm",
+    "plugin",
+    "healthcare",
+    "hl7"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "@bytecodealliance/componentize-js": ">=0.14.0"
+  },
+  "peerDependenciesMeta": {
+    "@bytecodealliance/componentize-js": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "@bytecodealliance/componentize-js": "^0.14.0",
+    "@types/node": "^25.2.2",
+    "typescript": "^5.5.0"
+  }
+}

package/wit/plugin.wit

@@ -0,0 +1,114 @@
+// FHIR Plugin Interface
+// Defines the contract between FHIRust and WASM plugins
+
+package fhirust:plugin@0.2.0;
+
+interface types {
+    // Hook types supported by FHIRust - symmetric set for all CRUD operations
+    enum hook-type {
+        before-create,
+        after-create,
+        before-read,
+        after-read,
+        before-update,
+        after-update,
+        before-delete,
+        after-delete,
+    }
+
+    // Common FHIR resource types
+    enum resource-type {
+        patient,
+        observation,
+        encounter,
+        condition,
+        medication-request,
+        practitioner,
+        organization,
+        other,  // Catch-all for extensibility
+    }
+
+    // Hook context passed to plugins
+    record hook-context {
+        request-id: string,
+        user-id: option<string>,
+        timestamp: string,  // ISO-8601 instant (e.g., "2024-01-15T10:00:00Z")
+        operation: string,
+    }
+
+    // Modified resource returned on success
+    record modified-resource {
+        json: string,
+    }
+
+    // OperationOutcome returned on validation failure
+    record operation-outcome {
+        json: string,
+    }
+
+    // Plugin metadata
+    record plugin-metadata {
+        name: string,
+        version: string,
+        hooks: list<tuple<resource-type, list<hook-type>>>,  // Use enum types
+    }
+
+    // HTTP response from host
+    record http-response {
+        status: u16,
+        headers: list<tuple<string, string>>,
+        body: string,
+    }
+}
+
+// Exported by plugin — called by host
+interface hooks {
+    use types.{hook-type, resource-type, hook-context, modified-resource, operation-outcome};
+
+    // Execute a hook - called by FHIRust
+    execute-hook: func(
+        hook-type: hook-type,
+        resource-type: resource-type,
+        resource-json: string,
+        context: hook-context
+    ) -> result<modified-resource, operation-outcome>;
+}
+
+// Exported by plugin — called by host at load time
+interface lifecycle {
+    use types.{plugin-metadata};
+
+    // Called by host at plugin load time
+    get-metadata: func() -> plugin-metadata;
+}
+
+// Imported by plugin — FHIR data access (calls repository directly)
+interface fhir {
+    use types.{operation-outcome};
+
+    read: func(resource-type: string, id: string) -> result<string, operation-outcome>;
+    search: func(resource-type: string, params: list<tuple<string, string>>) -> result<string, operation-outcome>;
+    create: func(resource-type: string, resource-json: string) -> result<string, operation-outcome>;
+    update: func(resource-type: string, id: string, resource-json: string) -> result<string, operation-outcome>;
+    delete: func(resource-type: string, id: string) -> result<bool, operation-outcome>;
+}
+
+// Imported by plugin — utilities
+interface utils {
+    log: func(level: string, message: string);
+    emit-event: func(event-type: string, payload: string);
+}
+
+// Imported by plugin — outbound HTTP
+interface http {
+    use types.{http-response};
+
+    fetch: func(
+        url: string,
+        method: string,
+        headers: list<tuple<string, string>>,
+        body: option<string>,
+        timeout-ms: u32,
+    ) -> result<http-response, string>;
+}
+

package/wit/world.wit

@@ -0,0 +1,12 @@
+package fhirust:plugin@0.2.0;
+
+world fhir-plugin {
+    // Host provides these to plugins
+    import fhir;
+    import utils;
+    import http;
+
+    // Plugins export these to host
+    export hooks;
+    export lifecycle;
+}