@ovok/core 0.3.3 → 0.3.5

package/README.md

@@ -14,6 +14,7 @@ Core TypeScript SDK for healthcare applications. Provides authentication, AI-FHI
 - 🤖 Bot execution framework
 - 📋 Questionnaire responses
 - 📥 Opt-in durable offline measurement queue with idempotent retries
+- 🧭 Runtime discovery of the backend FHIR and public API capabilities
 
 ## Installation
 
@@ -40,6 +41,20 @@ const client = new OvokClient({
 
 Full documentation and examples available at **[sdk.ovok.com](https://sdk.ovok.com/)**
 
+## Backend capability discovery
+
+`@ovok/core` can read the capability statement composed by `../ovok-core` and expose the
+non-FHIR public routes published in Ovok's `ovok-public-api` extension:
+
+```typescript
+const statement = await client.getCapabilityStatement();
+const publicEndpoints = await client.getPublicApiEndpoints();
+```
+
+The exported `OVOK_CORE_REQUIREMENTS` describes the FHIR operations used by the SDK, while
+`OVOK_CORE_API_REQUIREMENTS` describes its ordinary HTTP dependencies. Billing is intentionally
+not part of this SDK contract yet.
+
 ## Offline measurements
 
 Pass a durable Medplum storage adapter and opt in to queue measurements while offline:
@@ -103,3 +118,17 @@ if ("nextStep" in result && result.nextStep === "mfa") {
   const authenticated = await result.verify(oneTimeCode);
 }
 ```
+
+## Large measurements
+
+`saveMeasurement` and `saveObservations` use conditional creates for idempotent saves. Medplum
+limits a serializable transaction with conditional operations to eight entries, so the SDK keeps
+the first observation in a transaction and sends additional observations in a FHIR batch request.
+This supports measurements such as urine strips and long ECG recordings without changing retry
+behavior. The first observation should remain first when supplying observations manually.
+
+The offline queue applies the same split when it flushes a measurement. A partial retry is safe:
+the first conditional create finds the existing observation and the batch only creates missing
+members. Applications building their own bundles can use the exported
+`MAX_CONDITIONAL_OBSERVATION_ENTRIES` limit. See [FHIR batch requests](https://www.medplum.com/docs/fhir-datastore/fhir-batch-requests)
+for the transaction and batch semantics.

package/dist/client/auth/methods/index.d.ts

@@ -6,6 +6,7 @@ export * from "./requestDeleteUser";
 export * from "./googleLogin";
 export * from "./appleLogin";
 export * from "./resetPassword";
+export * from "./setPasswordFromReset";
 export * from "./logout";
 export * from "./getSessions";
 export * from "./revokeSessions";

package/dist/client/auth/methods/index.js

@@ -22,6 +22,7 @@ __exportStar(require("./requestDeleteUser"), exports);
 __exportStar(require("./googleLogin"), exports);
 __exportStar(require("./appleLogin"), exports);
 __exportStar(require("./resetPassword"), exports);
+__exportStar(require("./setPasswordFromReset"), exports);
 __exportStar(require("./logout"), exports);
 __exportStar(require("./getSessions"), exports);
 __exportStar(require("./revokeSessions"), exports);

package/dist/client/auth/methods/setPasswordFromReset.d.ts

@@ -0,0 +1,4 @@
+import { OperationOutcome } from "@medplum/fhirtypes";
+import { OvokClient } from "../../ovok-client";
+import { CompletePasswordResetBody } from "../types/CompletePasswordResetBody";
+export declare function setPasswordFromReset(this: OvokClient, body: CompletePasswordResetBody): Promise<OperationOutcome>;

package/dist/client/auth/methods/setPasswordFromReset.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setPasswordFromReset = setPasswordFromReset;
+async function setPasswordFromReset(body) {
+    return this.post("v2/auth/reset-password/process", body, "application/json");
+}

package/dist/client/auth/types/CompletePasswordResetBody.d.ts

@@ -0,0 +1,5 @@
+export interface CompletePasswordResetBody {
+    id: string;
+    secret: string;
+    password: string;
+}

package/dist/client/auth/types/CompletePasswordResetBody.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/client/observation/methods/generateObservationBodiesByMeasurement.js

@@ -19,6 +19,12 @@ async function generateObservationBodiesByMeasurement(params) {
     const observationService = creator_1.ObservationServiceCreator.getInstance().getService(measurementTypeKey);
     const deviceObject = (0, getDeviceObject_1.getDeviceObject)(device);
     const observationFragments = (_a = observationService.generateObservationFragments) === null || _a === void 0 ? void 0 : _a.call(observationService, measurement);
+    const applyEffectiveDateTime = (observation) => params.effectiveDateTime && !observation.effectivePeriod
+        ? {
+            ...observation,
+            effectiveDateTime: params.effectiveDateTime.toISOString(),
+        }
+        : observation;
     if (observationFragments) {
         return observationFragments
             .map((fragment) => ({
@@ -32,7 +38,8 @@ async function generateObservationBodiesByMeasurement(params) {
             code: fragment.code,
             ...(fragment.additionalProperties || {}),
         }))
-            .filter(hasObservationValue);
+            .filter(hasObservationValue)
+            .map(applyEffectiveDateTime);
     }
     const observationCodes = observationService.getObservationCodes();
     const values = observationService.generateValues(measurement);
@@ -48,7 +55,7 @@ async function generateObservationBodiesByMeasurement(params) {
         code,
         ...(additionalProperties[index] || {}),
     }));
-    return observationBodies.filter(hasObservationValue);
+    return observationBodies.filter(hasObservationValue).map(applyEffectiveDateTime);
 }
 const hasObservationValue = (observation) => {
     var _a, _b, _c, _d, _e;

package/dist/client/observation/observation-bundle-utils.d.ts

@@ -0,0 +1,6 @@
+import { Bundle, BundleEntry, Observation } from "@medplum/fhirtypes";
+export declare const MAX_OBSERVATION_BUNDLE_BYTES = 900000;
+export declare const MAX_CONDITIONAL_OBSERVATION_ENTRIES = 8;
+export declare const linkObservationMembers: (observations: Observation[]) => Observation[];
+export declare const splitObservationBundleEntries: (bundle: Bundle) => BundleEntry[][] | undefined;
+export declare const executeObservationBundle: (bundle: Bundle, executeBatch: (bundle: Bundle) => Promise<Bundle>) => Promise<Bundle>;

package/dist/client/observation/observation-bundle-utils.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeObservationBundle = exports.splitObservationBundleEntries = exports.linkObservationMembers = exports.MAX_CONDITIONAL_OBSERVATION_ENTRIES = exports.MAX_OBSERVATION_BUNDLE_BYTES = void 0;
+const offline_1 = require("../offline");
+exports.MAX_OBSERVATION_BUNDLE_BYTES = 900000;
+exports.MAX_CONDITIONAL_OBSERVATION_ENTRIES = 8;
+const linkObservationMembers = (observations) => {
+    const main = observations[0];
+    if (!main) {
+        return observations;
+    }
+    const mainReference = `urn:uuid:${(0, offline_1.stableMeasurementId)(main)}`;
+    return observations.map((observation, index) => {
+        var _a;
+        return index === 0
+            ? observation
+            : {
+                ...observation,
+                hasMember: [
+                    ...((_a = observation.hasMember) !== null && _a !== void 0 ? _a : []),
+                    { reference: mainReference },
+                ],
+            };
+    });
+};
+exports.linkObservationMembers = linkObservationMembers;
+const splitObservationBundleEntries = (bundle) => {
+    var _a;
+    const entries = (_a = bundle.entry) !== null && _a !== void 0 ? _a : [];
+    if (entries.length <= 1 || JSON.stringify(bundle).length <= exports.MAX_OBSERVATION_BUNDLE_BYTES) {
+        return undefined;
+    }
+    const chunks = [];
+    let chunk = [];
+    for (const entry of entries) {
+        const candidate = [...chunk, entry];
+        if (chunk.length > 0 &&
+            JSON.stringify({ ...bundle, entry: candidate }).length > exports.MAX_OBSERVATION_BUNDLE_BYTES) {
+            chunks.push(chunk);
+            chunk = [entry];
+        }
+        else {
+            chunk = candidate;
+        }
+    }
+    if (chunk.length > 0) {
+        chunks.push(chunk);
+    }
+    return chunks;
+};
+exports.splitObservationBundleEntries = splitObservationBundleEntries;
+const executeObservationBundle = async (bundle, executeBatch) => {
+    var _a, _b, _c, _d;
+    const entries = (_a = bundle.entry) !== null && _a !== void 0 ? _a : [];
+    if (bundle.type === "transaction" &&
+        entries.length > exports.MAX_CONDITIONAL_OBSERVATION_ENTRIES) {
+        const transactionResponse = await (0, exports.executeObservationBundle)({ ...bundle, entry: entries.slice(0, 1) }, executeBatch);
+        const batchResponse = await (0, exports.executeObservationBundle)({ ...bundle, type: "batch", entry: entries.slice(1) }, executeBatch);
+        return {
+            resourceType: "Bundle",
+            type: "batch-response",
+            entry: [
+                ...((_b = transactionResponse.entry) !== null && _b !== void 0 ? _b : []),
+                ...((_c = batchResponse.entry) !== null && _c !== void 0 ? _c : []),
+            ],
+        };
+    }
+    const chunks = (0, exports.splitObservationBundleEntries)(bundle);
+    if (chunks) {
+        const responses = [];
+        for (const entry of chunks) {
+            responses.push(await (0, exports.executeObservationBundle)({ ...bundle, entry }, executeBatch));
+        }
+        return {
+            resourceType: "Bundle",
+            type: "batch-response",
+            entry: responses.flatMap((response) => { var _a; return (_a = response.entry) !== null && _a !== void 0 ? _a : []; }),
+        };
+    }
+    const response = await executeBatch(bundle);
+    if ((_d = response.entry) === null || _d === void 0 ? void 0 : _d.some((entry) => {
+        var _a, _b;
+        const status = (_b = (_a = entry.response) === null || _a === void 0 ? void 0 : _a.status) !== null && _b !== void 0 ? _b : "";
+        return status.startsWith("4") || status.startsWith("5");
+    })) {
+        throw response;
+    }
+    return response;
+};
+exports.executeObservationBundle = executeObservationBundle;

package/dist/client/observation/types/generate-observation-body/GenerateObservationBodyParams.d.ts

@@ -2,6 +2,7 @@ import { Measurement } from "../../../../types";
 import { MeasurementDevice } from "../measurement/MeasurementDevice";
 export type GenerateObservationBodyParams = {
     device?: MeasurementDevice;
+    effectiveDateTime?: Date;
     patientId?: string;
     measurement: Measurement;
 };

package/dist/client/observation/types/measurement/MeasurementDevice.d.ts

@@ -2,6 +2,8 @@ export type MeasurementDevice = {
     name: string;
     localName: string;
     manufacturerData: string;
+    manufacturerName?: string;
+    model?: string;
     sn: string;
     id: string;
     /**

package/dist/client/observation/utils/getDeviceObject.js

@@ -4,6 +4,8 @@ exports.getDeviceObject = void 0;
 const EXTENSION_BASE_URL = "http://ovok.com/fhir/StructureDefinition";
 const LOCAL_NAME_URL = `${EXTENSION_BASE_URL}/device-local-name`;
 const MANUFACTURER_DATA_URL = `${EXTENSION_BASE_URL}/device-manufacturer-data`;
+const MANUFACTURER_NAME_URL = `${EXTENSION_BASE_URL}/device-manufacturer-name`;
+const MODEL_URL = `${EXTENSION_BASE_URL}/device-model`;
 const SERIAL_NUMBER_URL = `${EXTENSION_BASE_URL}/device-serial-number`;
 const BATTERY_PERCENTAGE_URL = `${EXTENSION_BASE_URL}/device-battery-percentage`;
 /**
@@ -21,6 +23,12 @@ const getBatteryExtension = (batteryPercentage) => {
         },
     ];
 };
+const getOptionalStringExtension = (url, value) => {
+    if (!value) {
+        return [];
+    }
+    return [{ url, valueString: value }];
+};
 const getDeviceObject = (measurementDevice) => {
     var _a, _b;
     if (!measurementDevice) {
@@ -44,6 +52,8 @@ const getDeviceObject = (measurementDevice) => {
                 url: MANUFACTURER_DATA_URL,
                 valueString: measurementDevice.manufacturerData || "no-manufacturer-data",
             },
+            ...getOptionalStringExtension(MANUFACTURER_NAME_URL, measurementDevice.manufacturerName),
+            ...getOptionalStringExtension(MODEL_URL, measurementDevice.model),
             {
                 url: SERIAL_NUMBER_URL,
                 valueString: measurementDevice.sn || "no-serial-number",

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

@@ -1,5 +1,6 @@
 import { IClientStorage, MedplumClient, MedplumClientOptions, SubscriptionManager } from "@medplum/core";
-import { Bundle, Observation } from "@medplum/fhirtypes";
+import { Bundle, CapabilityStatement, Observation } from "@medplum/fhirtypes";
+import { OvokPublicApiEndpoint } from "../conformance/capability";
 import * as aiFhirMethods from "./ai-fhir/methods";
 import * as authMethods from "./auth/methods";
 import * as botMethods from "./bot/methods";
@@ -8,6 +9,8 @@ import * as observationMethods from "./observation/methods";
 import { GenerateObservationBodyParams } from "./observation/types/generate-observation-body/GenerateObservationBodyParams";
 import { OfflineMeasurementFlushOptions, OfflineMeasurementFlushResult, OfflineMeasurementQueueOptions } from "./offline";
 import * as questionnaireResponseMethods from "./questionnaire-response/methods";
+export declare const MAX_CONDITIONAL_OBSERVATION_ENTRIES = 8;
+export { MAX_OBSERVATION_BUNDLE_BYTES } from "./observation/observation-bundle-utils";
 export type SaveObservationsResult = {
     status: "saved";
     response: Bundle;
@@ -15,6 +18,7 @@ export type SaveObservationsResult = {
     status: "queued";
     queueId: string;
 };
+export type OvokFhirVersion = "R4" | "R5";
 export declare class OvokClient extends MedplumClient {
     protected socialLoginClientId: string;
     clientStorage: IClientStorage | undefined;
@@ -30,12 +34,17 @@ export declare class OvokClient extends MedplumClient {
     });
     /** Saves a measurement immediately, or durably queues it when the opt-in queue is enabled. */
     saveMeasurement(params: GenerateObservationBodyParams): Promise<SaveObservationsResult>;
+    /** Reads Ovok's composed FHIR and public-route capability statement. */
+    getCapabilityStatement(version?: OvokFhirVersion): Promise<CapabilityStatement>;
+    /** Returns the non-FHIR public routes published by the backend statement. */
+    getPublicApiEndpoints(version?: OvokFhirVersion): Promise<OvokPublicApiEndpoint[]>;
     /** Saves observations with conditional creates so a retry cannot create a duplicate. */
     saveObservations(observations: Observation[]): Promise<SaveObservationsResult>;
     /** Flushes measurements queued while offline. Call this on connectivity/app-resume events. */
     flushOfflineMeasurementQueue(options?: OfflineMeasurementFlushOptions): Promise<OfflineMeasurementFlushResult>;
     private getOfflineMeasurementQueue;
     private executeConditionalObservationCreates;
+    private executeObservationBundle;
     private bindMethods;
     /**
      * Gets the `SubscriptionManager` for WebSocket subscriptions.
@@ -53,4 +62,3 @@ declare module "./ovok-client" {
         clientStorage: IClientStorage | undefined;
     }
 }
-export {};

package/dist/client/ovok-client.js

@@ -33,17 +33,22 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OvokClient = void 0;
+exports.OvokClient = exports.MAX_OBSERVATION_BUNDLE_BYTES = exports.MAX_CONDITIONAL_OBSERVATION_ENTRIES = void 0;
 /* eslint-disable @typescript-eslint/no-unsafe-function-type */ // TODO: fix this whenever find time
 const core_1 = require("@medplum/core");
+const capability_1 = require("../conformance/capability");
 const aiFhirMethods = __importStar(require("./ai-fhir/methods"));
 const authMethods = __importStar(require("./auth/methods"));
 const botMethods = __importStar(require("./bot/methods"));
 const aiMethods = __importStar(require("./chat/ai/methods"));
 const rate_limit_error_1 = require("./errors/rate-limit-error");
 const observationMethods = __importStar(require("./observation/methods"));
+const observation_bundle_utils_1 = require("./observation/observation-bundle-utils");
 const offline_1 = require("./offline");
 const questionnaireResponseMethods = __importStar(require("./questionnaire-response/methods"));
+exports.MAX_CONDITIONAL_OBSERVATION_ENTRIES = 8;
+var observation_bundle_utils_2 = require("./observation/observation-bundle-utils");
+Object.defineProperty(exports, "MAX_OBSERVATION_BUNDLE_BYTES", { enumerable: true, get: function () { return observation_bundle_utils_2.MAX_OBSERVATION_BUNDLE_BYTES; } });
 class OvokClient extends core_1.MedplumClient {
     /**
      * @param config - The configuration for the client.
@@ -68,17 +73,26 @@ class OvokClient extends core_1.MedplumClient {
         const observations = await this.generateObservationBodiesByMeasurement(params);
         return this.saveObservations(observations);
     }
+    /** Reads Ovok's composed FHIR and public-route capability statement. */
+    async getCapabilityStatement(version = "R4") {
+        return this.get(`/fhir/${version}/metadata`);
+    }
+    /** Returns the non-FHIR public routes published by the backend statement. */
+    async getPublicApiEndpoints(version = "R4") {
+        return (0, capability_1.getOvokPublicApiEndpoints)(await this.getCapabilityStatement(version));
+    }
     /** Saves observations with conditional creates so a retry cannot create a duplicate. */
     async saveObservations(observations) {
+        const linkedObservations = (0, observation_bundle_utils_1.linkObservationMembers)(observations);
         const queue = this.getOfflineMeasurementQueue();
         if (queue) {
-            const { id, flush } = await queue.enqueueAndFlush(observations);
+            const { id, flush } = await queue.enqueueAndFlush(linkedObservations);
             const response = flush.responses[id];
             return response
                 ? { status: "saved", response }
                 : { status: "queued", queueId: id };
         }
-        const response = await this.executeConditionalObservationCreates(observations);
+        const response = await this.executeConditionalObservationCreates(linkedObservations);
         return { status: "saved", response };
     }
     /** Flushes measurements queued while offline. Call this on connectivity/app-resume events. */
@@ -103,25 +117,19 @@ class OvokClient extends core_1.MedplumClient {
         if (!this.clientStorage) {
             throw new Error("Offline measurement queue requires a durable client storage adapter.");
         }
-        (_a = this.offlineMeasurementQueue) !== null && _a !== void 0 ? _a : (this.offlineMeasurementQueue = new offline_1.OfflineMeasurementQueue(this.clientStorage, (bundle) => this.executeBatch(bundle), this.offlineQueueOptions));
+        (_a = this.offlineMeasurementQueue) !== null && _a !== void 0 ? _a : (this.offlineMeasurementQueue = new offline_1.OfflineMeasurementQueue(this.clientStorage, (bundle) => this.executeObservationBundle(bundle), this.offlineQueueOptions));
         return this.offlineMeasurementQueue;
     }
     async executeConditionalObservationCreates(observations) {
-        var _a;
         const entries = observations.map(offline_1.entryForObservation);
-        const bundle = await this.executeBatch({
+        return this.executeObservationBundle({
             resourceType: "Bundle",
             type: "transaction",
             entry: entries,
         });
-        if ((_a = bundle.entry) === null || _a === void 0 ? void 0 : _a.some((entry) => {
-            var _a, _b;
-            const status = (_b = (_a = entry.response) === null || _a === void 0 ? void 0 : _a.status) !== null && _b !== void 0 ? _b : "";
-            return status.startsWith("4") || status.startsWith("5");
-        })) {
-            throw bundle;
-        }
-        return bundle;
+    }
+    async executeObservationBundle(bundle) {
+        return (0, observation_bundle_utils_1.executeObservationBundle)(bundle, (request) => this.executeBatch(request));
     }
     bindMethods(methods) {
         for (const [name, method] of Object.entries(methods)) {

package/dist/conformance/api-requirements.d.ts

@@ -0,0 +1,34 @@
+export type OvokHttpMethod = "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+export type OvokApiRequirement = {
+    method: OvokHttpMethod;
+    path: string;
+    group: string;
+};
+/**
+ * The non-FHIR HTTP routes used by @ovok/core itself.
+ *
+ * This is deliberately separate from OVOK_CORE_REQUIREMENTS: a FHIR
+ * CapabilityStatement cannot describe ordinary auth, AI, or bot routes.
+ * Billing is intentionally absent until Ovok has a supported billing SDK
+ * contract.
+ */
+export declare const OVOK_CORE_API_REQUIREMENTS: {
+    readonly capability: {
+        readonly method: "GET";
+        readonly path: "/fhir/{version}/metadata";
+        readonly group: "FHIR";
+    };
+    readonly nonFhir: ({
+        method: "POST";
+        path: string;
+        group: string;
+    } | {
+        method: "GET";
+        path: string;
+        group: string;
+    } | {
+        method: "DELETE";
+        path: string;
+        group: string;
+    })[];
+};

package/dist/conformance/api-requirements.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OVOK_CORE_API_REQUIREMENTS = void 0;
+/**
+ * The non-FHIR HTTP routes used by @ovok/core itself.
+ *
+ * This is deliberately separate from OVOK_CORE_REQUIREMENTS: a FHIR
+ * CapabilityStatement cannot describe ordinary auth, AI, or bot routes.
+ * Billing is intentionally absent until Ovok has a supported billing SDK
+ * contract.
+ */
+exports.OVOK_CORE_API_REQUIREMENTS = {
+    capability: {
+        method: "GET",
+        path: "/fhir/{version}/metadata",
+        group: "FHIR",
+    },
+    nonFhir: [
+        { method: "POST", path: "/auth/tenant/Patient/login/start", group: "Auth" },
+        { method: "POST", path: "/auth/tenant/Practitioner/login/start", group: "Auth" },
+        { method: "POST", path: "/auth/tenant/Patient/login/token", group: "Auth" },
+        { method: "POST", path: "/auth/tenant/Practitioner/login/token", group: "Auth" },
+        { method: "POST", path: "/auth/tenant/Practitioner/login/mfa", group: "Auth" },
+        { method: "POST", path: "/auth/tenant/Patient/register", group: "Auth" },
+        { method: "POST", path: "/auth/external/google", group: "Auth" },
+        { method: "POST", path: "/auth/external/apple", group: "Auth" },
+        { method: "POST", path: "/auth/change-password", group: "Auth" },
+        { method: "POST", path: "/v2/auth/reset-password", group: "Auth" },
+        { method: "POST", path: "/v2/auth/reset-password/process", group: "Auth" },
+        { method: "GET", path: "/auth/session", group: "Auth" },
+        { method: "DELETE", path: "/auth/session/current", group: "Auth" },
+        { method: "DELETE", path: "/auth/session/:option", group: "Auth" },
+        { method: "DELETE", path: "/auth/delete", group: "Auth" },
+        { method: "POST", path: "/ai/session", group: "AI" },
+        { method: "POST", path: "/ai/fhir/search", group: "AI" },
+        { method: "POST", path: "/bots", group: "Bots" },
+    ],
+};

package/dist/conformance/capability-requirements.js

@@ -43,12 +43,12 @@ exports.OVOK_CORE_REQUIREMENTS = {
      * report change where there is none. Bump it with `software.version` when
      * the declared surface actually moves.
      */
-    date: "2026-09-19",
+    date: "2026-09-26",
     kind: "requirements",
     description: "The FHIR surface a server must provide for the @ovok/core client library's own methods to function.",
     software: {
         name: "@ovok/core",
-        version: "0.3.2",
+        version: "0.3.4",
     },
     fhirVersion: "4.0.1",
     format: ["json"],

package/dist/conformance/capability.d.ts

@@ -0,0 +1,15 @@
+import { CapabilityStatement } from "@medplum/fhirtypes";
+/** The extension used by ovok-core to publish non-FHIR public routes. */
+export declare const OVOK_PUBLIC_API_EXTENSION = "https://fhir.ovok.com/fhir/StructureDefinition/ovok-public-api";
+export type OvokPublicApiEndpoint = {
+    method: string;
+    path: string;
+    group: string;
+};
+/**
+ * Reads the public non-FHIR route catalog emitted by ../ovok-core.
+ *
+ * FHIR clients can ignore this extension safely. React applications can use
+ * it to feature-detect the rest of the Ovok API without hard-coding routes.
+ */
+export declare const getOvokPublicApiEndpoints: (statement: CapabilityStatement) => OvokPublicApiEndpoint[];

package/dist/conformance/capability.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getOvokPublicApiEndpoints = exports.OVOK_PUBLIC_API_EXTENSION = void 0;
+/** The extension used by ovok-core to publish non-FHIR public routes. */
+exports.OVOK_PUBLIC_API_EXTENSION = "https://fhir.ovok.com/fhir/StructureDefinition/ovok-public-api";
+const ENDPOINT_EXTENSION = "endpoint";
+const stringValue = (extension) => { var _a; return (_a = extension.valueCode) !== null && _a !== void 0 ? _a : extension.valueString; };
+/**
+ * Reads the public non-FHIR route catalog emitted by ../ovok-core.
+ *
+ * FHIR clients can ignore this extension safely. React applications can use
+ * it to feature-detect the rest of the Ovok API without hard-coding routes.
+ */
+const getOvokPublicApiEndpoints = (statement) => {
+    var _a, _b;
+    const publicApi = (_a = statement.extension) === null || _a === void 0 ? void 0 : _a.find((extension) => extension.url === exports.OVOK_PUBLIC_API_EXTENSION);
+    return ((_b = publicApi === null || publicApi === void 0 ? void 0 : publicApi.extension) !== null && _b !== void 0 ? _b : []).flatMap((endpoint) => {
+        var _a, _b, _c;
+        if (endpoint.url !== ENDPOINT_EXTENSION) {
+            return [];
+        }
+        const method = (_a = endpoint.extension) === null || _a === void 0 ? void 0 : _a.find((extension) => extension.url === "method");
+        const path = (_b = endpoint.extension) === null || _b === void 0 ? void 0 : _b.find((extension) => extension.url === "path");
+        const group = (_c = endpoint.extension) === null || _c === void 0 ? void 0 : _c.find((extension) => extension.url === "group");
+        const methodValue = method === undefined ? undefined : stringValue(method);
+        const pathValue = path === undefined ? undefined : stringValue(path);
+        const groupValue = group === undefined ? undefined : stringValue(group);
+        if (methodValue === undefined || pathValue === undefined || groupValue === undefined) {
+            return [];
+        }
+        return [
+            {
+                method: methodValue.toUpperCase(),
+                path: pathValue,
+                group: groupValue,
+            },
+        ];
+    });
+};
+exports.getOvokPublicApiEndpoints = getOvokPublicApiEndpoints;

package/dist/index.d.ts

@@ -924,6 +924,7 @@ declare const Medplum: {
 export { Medplum };
 export { OvokClient } from "./client/ovok-client";
 export * from "./client/errors/rate-limit-error";
+export { MAX_CONDITIONAL_OBSERVATION_ENTRIES, MAX_OBSERVATION_BUNDLE_BYTES, } from "./client/ovok-client";
 export type { SaveObservationsResult } from "./client/ovok-client";
 export * from "./client/offline";
 export * from "./hooks";
@@ -932,3 +933,5 @@ export * from "./client/observation/services";
 export * from "./client/observation/methods";
 export { saveMeasurement } from "./client/observation/methods/saveMeasurement";
 export * from "./conformance/capability-requirements";
+export * from "./conformance/api-requirements";
+export * from "./conformance/capability";

package/dist/index.js

@@ -36,7 +36,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.saveMeasurement = exports.OvokClient = exports.Medplum = void 0;
+exports.saveMeasurement = exports.MAX_OBSERVATION_BUNDLE_BYTES = exports.MAX_CONDITIONAL_OBSERVATION_ENTRIES = exports.OvokClient = exports.Medplum = void 0;
 const MedplumCore = __importStar(require("@medplum/core"));
 __exportStar(require("./types"), exports);
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
@@ -45,6 +45,9 @@ exports.Medplum = Medplum;
 var ovok_client_1 = require("./client/ovok-client");
 Object.defineProperty(exports, "OvokClient", { enumerable: true, get: function () { return ovok_client_1.OvokClient; } });
 __exportStar(require("./client/errors/rate-limit-error"), exports);
+var ovok_client_2 = require("./client/ovok-client");
+Object.defineProperty(exports, "MAX_CONDITIONAL_OBSERVATION_ENTRIES", { enumerable: true, get: function () { return ovok_client_2.MAX_CONDITIONAL_OBSERVATION_ENTRIES; } });
+Object.defineProperty(exports, "MAX_OBSERVATION_BUNDLE_BYTES", { enumerable: true, get: function () { return ovok_client_2.MAX_OBSERVATION_BUNDLE_BYTES; } });
 __exportStar(require("./client/offline"), exports);
 __exportStar(require("./hooks"), exports);
 __exportStar(require("./utils"), exports);
@@ -53,3 +56,5 @@ __exportStar(require("./client/observation/methods"), exports);
 var saveMeasurement_1 = require("./client/observation/methods/saveMeasurement");
 Object.defineProperty(exports, "saveMeasurement", { enumerable: true, get: function () { return saveMeasurement_1.saveMeasurement; } });
 __exportStar(require("./conformance/capability-requirements"), exports);
+__exportStar(require("./conformance/api-requirements"), exports);
+__exportStar(require("./conformance/capability"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ovok/core",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "private": false,
   "main": "dist/index.js",
   "types": "dist/index.d.ts",