@ovok/core 0.3.4 → 0.3.6

package/README.md

@@ -14,6 +14,8 @@ 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
+- 🧩 Typed accounts, projects, localization, and patient-observation APIs
 
 ## Installation
 
@@ -40,6 +42,36 @@ 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.
+
+## Platform APIs
+
+The client includes typed methods for application-level account and project flows already served
+by Ovok: project switching and membership, project settings and feature flags, locales and
+localization, and the existing patient-observation read surface.
+
+```typescript
+const projects = await client.listAdministeredProjects();
+const settings = await client.getProjectSettings();
+const features = await client.getProjectFeatures();
+const locales = await client.getLocales();
+```
+
+All methods preserve the backend HTTP verbs and return the backend response shapes. Billing is
+not included until Ovok publishes a supported billing contract.
+
 ## Offline measurements
 
 Pass a durable Medplum storage adapter and opt in to queue measurements while offline:

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";
@@ -7,6 +8,7 @@ import * as aiMethods from "./chat/ai/methods";
 import * as observationMethods from "./observation/methods";
 import { GenerateObservationBodyParams } from "./observation/types/generate-observation-body/GenerateObservationBodyParams";
 import { OfflineMeasurementFlushOptions, OfflineMeasurementFlushResult, OfflineMeasurementQueueOptions } from "./offline";
+import * as platformMethods from "./platform/methods";
 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";
@@ -17,6 +19,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;
@@ -32,6 +35,10 @@ 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. */
@@ -48,7 +55,7 @@ export declare class OvokClient extends MedplumClient {
      */
     getSubscriptionManager(): SubscriptionManager;
 }
-type Methods = typeof authMethods & typeof observationMethods & typeof questionnaireResponseMethods & typeof aiMethods & typeof aiFhirMethods & typeof botMethods;
+type Methods = typeof authMethods & typeof observationMethods & typeof questionnaireResponseMethods & typeof aiMethods & typeof aiFhirMethods & typeof botMethods & typeof platformMethods;
 type Omitted<T> = Omit<T, "executeBot">;
 declare module "./ovok-client" {
     interface OvokClient extends Omitted<Methods> {

package/dist/client/ovok-client.js

@@ -36,6 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 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"));
@@ -44,6 +45,7 @@ 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 platformMethods = __importStar(require("./platform/methods"));
 const questionnaireResponseMethods = __importStar(require("./questionnaire-response/methods"));
 exports.MAX_CONDITIONAL_OBSERVATION_ENTRIES = 8;
 var observation_bundle_utils_2 = require("./observation/observation-bundle-utils");
@@ -64,6 +66,7 @@ class OvokClient extends core_1.MedplumClient {
         this.bindMethods(aiMethods);
         this.bindMethods(aiFhirMethods);
         this.bindMethods(botMethods);
+        this.bindMethods(platformMethods);
         this.clientStorage = config.storage;
         this.offlineQueueOptions = (_b = config.offlineQueue) !== null && _b !== void 0 ? _b : {};
     }
@@ -72,6 +75,14 @@ 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);

package/dist/client/platform/methods.d.ts

@@ -0,0 +1,41 @@
+import { OvokClient } from "../ovok-client";
+import { OvokAccount, OvokAdministeredProject, OvokCreateProject, OvokCreatedProject, OvokI18nDocument, OvokI18nValue, OvokInviteProjectMember, OvokLocalization, OvokLocalizationQuery, OvokLocalizationUpdate, OvokLocales, OvokPage, OvokPatientObservations, OvokProjectFeature, OvokProjectFeatures, OvokProjectMember, OvokProjectMemberResponse, OvokProjectSettings, OvokProjectSettingKey, OvokRemoveProjectMemberResponse, OvokUpdateProjectMember } from "./types";
+export declare function getAccounts(this: OvokClient): Promise<OvokAccount[]>;
+export declare function listAdministeredProjects(this: OvokClient, params?: {
+    page?: number;
+    count?: number;
+}): Promise<OvokPage<OvokAdministeredProject>>;
+export declare function createProject(this: OvokClient, body: OvokCreateProject): Promise<OvokCreatedProject>;
+export declare function bootstrapProject(this: OvokClient, body: OvokCreateProject): Promise<OvokCreatedProject>;
+export declare function getProjectTenantCode(this: OvokClient): Promise<{
+    tenantCode: string;
+}>;
+export declare function listProjectMembers(this: OvokClient, params?: {
+    accessPolicyId?: string;
+    profileId?: string;
+    userId?: string;
+    page?: number;
+    count?: number;
+}): Promise<OvokPage<OvokProjectMember>>;
+export declare function inviteProjectMember(this: OvokClient, body: OvokInviteProjectMember): Promise<OvokProjectMemberResponse>;
+export declare function updateProjectMember(this: OvokClient, membershipId: string, body: OvokUpdateProjectMember): Promise<OvokProjectMemberResponse>;
+export declare function removeProjectMember(this: OvokClient, membershipId: string): Promise<OvokRemoveProjectMemberResponse>;
+export declare function getProjectFeatures(this: OvokClient): Promise<OvokProjectFeatures>;
+export declare function updateProjectFeatures(this: OvokClient, features: OvokProjectFeature[]): Promise<OvokProjectFeatures>;
+export declare function getProjectSettings(this: OvokClient): Promise<OvokProjectSettings>;
+export declare function updateProjectSetting(this: OvokClient, key: OvokProjectSettingKey, enabled: boolean): Promise<OvokProjectSettings>;
+export declare function getLocales(this: OvokClient): Promise<OvokLocales>;
+export declare function updateLocales(this: OvokClient, locales: OvokLocales): Promise<OvokLocales>;
+export declare function listLocalizations(this: OvokClient, language: string, params?: OvokLocalizationQuery): Promise<{
+    total: number;
+    resources: OvokLocalization[];
+}>;
+export declare function getLocalization(this: OvokClient, language: string, key: string): Promise<OvokLocalization>;
+export declare function updateLocalization(this: OvokClient, language: string, key: string, body: OvokLocalizationUpdate): Promise<OvokLocalization>;
+export declare function deleteLocalization(this: OvokClient, language: string, key: string): Promise<void>;
+export declare function getI18nextDocument(this: OvokClient, language: string): Promise<OvokI18nDocument>;
+export declare function updateI18nextDocument(this: OvokClient, language: string, document: Record<string, OvokI18nValue>): Promise<void>;
+export declare function getPatientLastObservations(this: OvokClient, patientId: string, params: {
+    code: string;
+    max?: number;
+}): Promise<OvokPatientObservations>;

package/dist/client/platform/methods.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAccounts = getAccounts;
+exports.listAdministeredProjects = listAdministeredProjects;
+exports.createProject = createProject;
+exports.bootstrapProject = bootstrapProject;
+exports.getProjectTenantCode = getProjectTenantCode;
+exports.listProjectMembers = listProjectMembers;
+exports.inviteProjectMember = inviteProjectMember;
+exports.updateProjectMember = updateProjectMember;
+exports.removeProjectMember = removeProjectMember;
+exports.getProjectFeatures = getProjectFeatures;
+exports.updateProjectFeatures = updateProjectFeatures;
+exports.getProjectSettings = getProjectSettings;
+exports.updateProjectSetting = updateProjectSetting;
+exports.getLocales = getLocales;
+exports.updateLocales = updateLocales;
+exports.listLocalizations = listLocalizations;
+exports.getLocalization = getLocalization;
+exports.updateLocalization = updateLocalization;
+exports.deleteLocalization = deleteLocalization;
+exports.getI18nextDocument = getI18nextDocument;
+exports.updateI18nextDocument = updateI18nextDocument;
+exports.getPatientLastObservations = getPatientLastObservations;
+const query = (params) => {
+    const values = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+        if (value !== undefined) {
+            values.set(key, String(value));
+        }
+    }
+    const encoded = values.toString();
+    return encoded === "" ? "" : `?${encoded}`;
+};
+const segment = (value) => encodeURIComponent(value);
+async function getAccounts() {
+    return this.get("/accounts");
+}
+async function listAdministeredProjects(params = {}) {
+    return this.get(`/v1/projects${query(params)}`);
+}
+async function createProject(body) {
+    return this.post("/v1/projects", body);
+}
+async function bootstrapProject(body) {
+    return this.post("/v1/projects/bootstrap", body);
+}
+async function getProjectTenantCode() {
+    return this.get("/v1/projects/me/tenant-code");
+}
+async function listProjectMembers(params = {}) {
+    return this.get(`/v1/projects/me/members${query(params)}`);
+}
+async function inviteProjectMember(body) {
+    return this.post("/v1/projects/me/members", body);
+}
+async function updateProjectMember(membershipId, body) {
+    return (await this.patch(`/v1/projects/me/members/${segment(membershipId)}`, body));
+}
+async function removeProjectMember(membershipId) {
+    return (await this.delete(`/v1/projects/me/members/${segment(membershipId)}`));
+}
+async function getProjectFeatures() {
+    return this.get("/v1/projects/me/features");
+}
+async function updateProjectFeatures(features) {
+    const body = { features };
+    return (await this.patch("/v1/projects/me/features", body));
+}
+async function getProjectSettings() {
+    return this.get("/v1/project/settings");
+}
+async function updateProjectSetting(key, enabled) {
+    return (await this.put(`/v1/project/settings/${segment(key)}`, { enabled }));
+}
+async function getLocales() {
+    return this.get("/locales");
+}
+async function updateLocales(locales) {
+    return (await this.patch("/locales", locales));
+}
+async function listLocalizations(language, params = {}) {
+    return this.get(`/localization/${segment(language)}${query(params)}`);
+}
+async function getLocalization(language, key) {
+    return this.get(`/localization/${segment(language)}/${segment(key)}`);
+}
+async function updateLocalization(language, key, body) {
+    return (await this.put(`/localization/${segment(language)}/${segment(key)}`, body));
+}
+async function deleteLocalization(language, key) {
+    await this.delete(`/localization/${segment(language)}/${segment(key)}`);
+}
+async function getI18nextDocument(language) {
+    return this.get(`/localization/i18next/${segment(language)}`);
+}
+async function updateI18nextDocument(language, document) {
+    await this.patch(`/localization/i18next/${segment(language)}`, document);
+}
+async function getPatientLastObservations(patientId, params) {
+    return this.get(`/patient/${segment(patientId)}/observation${query(params)}`);
+}

package/dist/client/platform/types.d.ts

@@ -0,0 +1,114 @@
+import { Bundle, Observation } from "@medplum/fhirtypes";
+export type OvokPage<T> = {
+    total: number;
+    page: number;
+    count: number;
+    resources: T[];
+};
+export type OvokAccount = {
+    email: string;
+    name: string;
+};
+export type OvokAdministeredProject = {
+    projectId: string;
+    name: string | null;
+    tenantCode: string | null;
+    isMainProject: boolean | null;
+    parentProjectId: string | null;
+};
+export type OvokCreateProject = {
+    name: string;
+};
+export type OvokCreatedProject = {
+    projectId: string;
+    tenantCode: string;
+    name: string;
+};
+export type OvokProjectMemberReference = {
+    reference?: string;
+    display?: string;
+    [key: string]: unknown;
+};
+export type OvokProjectMember = {
+    membershipId: string;
+    userId?: string;
+    profile?: OvokProjectMemberReference;
+    accessPolicy?: OvokProjectMemberReference;
+    admin?: boolean;
+};
+export type OvokInviteProjectMember = {
+    email: string;
+    firstName: string | null;
+    lastName: string | null;
+    admin: boolean | null;
+};
+export type OvokUpdateProjectMember = {
+    admin: boolean | null;
+};
+export type OvokProjectMemberResponse = {
+    id: string;
+    email: string | null;
+    displayName: string | null;
+    firstName: string | null;
+    lastName: string | null;
+    admin: boolean;
+    profileType: "Practitioner" | "Patient" | "RelatedPerson" | null;
+    profileId: string | null;
+    pending: boolean;
+    invitedAt: string | null;
+};
+export type OvokRemoveProjectMemberResponse = {
+    success: true;
+};
+export declare const OVOK_PROJECT_FEATURE_VALUES: readonly ["ai", "aws-comprehend", "aws-textract", "bots", "cron", "email", "google-auth-required", "graphql-introspection", "websocket-subscriptions", "transaction-bundles", "validate-terminology"];
+export type OvokProjectFeature = (typeof OVOK_PROJECT_FEATURE_VALUES)[number];
+export type OvokProjectFeatures = {
+    features: string[];
+};
+export type OvokProjectFeaturesUpdate = {
+    features: OvokProjectFeature[];
+};
+export declare const OVOK_PROJECT_SETTING_KEYS: readonly ["CONTENT_ENABLED", "MAILING_ENABLED", "PATIENT_INVITATION_ENABLED", "PATIENT_REGISTRATION_ENABLED", "PATIENT_LOGIN_ENABLED", "PRACTITIONER_INVITATION_ENABLED", "PRACTITIONER_REGISTRATION_ENABLED", "PRACTITIONER_LOGIN_ENABLED", "IOT_ENABLED"];
+export type OvokProjectSettingKey = (typeof OVOK_PROJECT_SETTING_KEYS)[number];
+export type OvokProjectSettings = {
+    projectId: string;
+    settings: Record<OvokProjectSettingKey, boolean>;
+};
+export type OvokLocales = {
+    languages: string[];
+    defaultLanguage: string;
+};
+export type OvokLocalization = {
+    id?: string;
+    key: string;
+    language: string;
+    value: string;
+    author: {
+        reference: string;
+        display?: string;
+    };
+    date?: string;
+    projectId?: string;
+};
+export type OvokLocalizationQuery = {
+    _count?: number;
+    _offset?: number;
+    _sort?: string;
+    search?: string;
+};
+export type OvokLocalizationUpdate = {
+    value: string;
+};
+export type OvokI18nValue = string | {
+    [key: string]: OvokI18nValue;
+};
+export type OvokI18nDocument = {
+    key: string;
+    language: string;
+    [key: string]: unknown;
+};
+export type OvokPatientObservationQuery = {
+    code: string;
+    max?: number;
+};
+export type OvokPatientObservations = Bundle<Observation>;

package/dist/client/platform/types.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OVOK_PROJECT_SETTING_KEYS = exports.OVOK_PROJECT_FEATURE_VALUES = void 0;
+exports.OVOK_PROJECT_FEATURE_VALUES = [
+    "ai",
+    "aws-comprehend",
+    "aws-textract",
+    "bots",
+    "cron",
+    "email",
+    "google-auth-required",
+    "graphql-introspection",
+    "websocket-subscriptions",
+    "transaction-bundles",
+    "validate-terminology",
+];
+exports.OVOK_PROJECT_SETTING_KEYS = [
+    "CONTENT_ENABLED",
+    "MAILING_ENABLED",
+    "PATIENT_INVITATION_ENABLED",
+    "PATIENT_REGISTRATION_ENABLED",
+    "PATIENT_LOGIN_ENABLED",
+    "PRACTITIONER_INVITATION_ENABLED",
+    "PRACTITIONER_REGISTRATION_ENABLED",
+    "PRACTITIONER_LOGIN_ENABLED",
+    "IOT_ENABLED",
+];

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

@@ -0,0 +1,42 @@
+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;
+    } | {
+        method: "PATCH";
+        path: string;
+        group: string;
+    } | {
+        method: "PUT";
+        path: string;
+        group: string;
+    })[];
+};

package/dist/conformance/api-requirements.js

@@ -0,0 +1,60 @@
+"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" },
+        { method: "GET", path: "/accounts", group: "Accounts" },
+        { method: "GET", path: "/v1/projects", group: "Projects" },
+        { method: "POST", path: "/v1/projects", group: "Projects" },
+        { method: "POST", path: "/v1/projects/bootstrap", group: "Projects" },
+        { method: "GET", path: "/v1/projects/me/tenant-code", group: "Projects" },
+        { method: "GET", path: "/v1/projects/me/members", group: "Projects" },
+        { method: "POST", path: "/v1/projects/me/members", group: "Projects" },
+        { method: "PATCH", path: "/v1/projects/me/members/:membershipId", group: "Projects" },
+        { method: "DELETE", path: "/v1/projects/me/members/:membershipId", group: "Projects" },
+        { method: "GET", path: "/v1/projects/me/features", group: "Projects" },
+        { method: "PATCH", path: "/v1/projects/me/features", group: "Projects" },
+        { method: "GET", path: "/v1/project/settings", group: "Projects" },
+        { method: "PUT", path: "/v1/project/settings/:key", group: "Projects" },
+        { method: "GET", path: "/locales", group: "Localization" },
+        { method: "PATCH", path: "/locales", group: "Localization" },
+        { method: "GET", path: "/localization/:language", group: "Localization" },
+        { method: "GET", path: "/localization/:language/:key", group: "Localization" },
+        { method: "PUT", path: "/localization/:language/:key", group: "Localization" },
+        { method: "DELETE", path: "/localization/:language/:key", group: "Localization" },
+        { method: "GET", path: "/localization/i18next/:language", group: "Localization" },
+        { method: "PATCH", path: "/localization/i18next/:language", group: "Localization" },
+        { method: "GET", path: "/patient/:id/observation", group: "Patient" },
+    ],
+};

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.3",
+        version: "0.3.5",
     },
     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

@@ -933,3 +933,6 @@ 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";
+export * from "./client/platform/types";

package/dist/index.js

@@ -56,3 +56,6 @@ __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);
+__exportStar(require("./client/platform/types"), exports);

package/package.json

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