@ovok/core 0.4.10 → 0.4.12

package/README.md

@@ -305,12 +305,45 @@ PDF export. These routes require the backend's bearer session and Slim permissio
 const residents = await client.listSlimPatients({ residentState: "active" });
 const devices = await client.listSlimDevices({ active: true });
 const telemetry = await client.getSlimDeviceTelemetry(deviceId);
-const alerts = await client.listSlimMedicalNotifications({ count: 25 });
+const alerts = await client.listSlimMedicalNotifications({ limit: 25, codes: ["8867-4"] });
+const alarms = await client.listSlimAlarms({ status: "active", sort: "newest" });
 ```
 
 Slim is intentionally represented as typed application APIs rather than changing the FHIR
 observation save/offline behavior used by native integrations.
 
+Use the separate `/oob`, `/alarms`, and `/medical` feeds instead of the deprecated mixed
+`listSlimNotifications` endpoint. The medical React hook reads every cursor page; it stops only
+when `nextCursor` is `null`. Feed `noteCount` is nullable: `null` means the count is unknown, not
+zero. Notification notes are practitioner-authored and do not acknowledge or otherwise change an
+alert. After a note mutation, mounted note and alert-feed hooks reload their data.
+
+Writes can return `OvokApiError`, which keeps the HTTP status, machine code, validation field errors,
+and any missing-baseline details. In particular, reload the affected record before retrying a 409;
+do not automatically replay a stale assignment. A 409 `signals_project_migrating` should be shown
+as a temporary home-migration conflict, not retried in a loop. Threshold writes can return 422
+validation errors or 424 when the baseline has not been collected. Hooks never replay a write with
+a stale body; transient 503 transport retries, when enabled by Medplum, do not clear the session.
+The unconfirmed-limit list and repush routes require project-admin access; a 403 remains an error.
+
+`getLegalConsent()` returns the signed-in practitioner's own terms status. If
+`needsLegalConsentReacceptance(response.legal)` is true, show the current terms before continuing.
+
+```ts
+if (needsLegalConsentReacceptance(legalConsent.legal)) {
+  // Show the current terms and request acceptance.
+}
+
+try {
+  await client.updateSlimPatientThresholdV2(patientId, body);
+} catch (error) {
+  if (isOvokApiError(error) && error.status === 424) {
+    console.info(error.missing);
+  }
+  throw error;
+}
+```
+
 ## Application APIs
 
 The client also exposes typed application APIs for consent signatures, document upload credentials,

package/dist/client/change-history/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./methods";
+export * from "./types";

package/dist/client/change-history/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+__exportStar(require("./methods"), exports);
+__exportStar(require("./types"), exports);

package/dist/client/change-history/methods.d.ts

@@ -0,0 +1,4 @@
+import { OvokClient } from "../ovok-client";
+import { ChangeHistoryPage, ChangeHistoryQuery } from "./types";
+export declare function serializeChangeHistoryQuery(params?: ChangeHistoryQuery): string;
+export declare function listChangeHistory(this: OvokClient, params?: ChangeHistoryQuery): Promise<ChangeHistoryPage>;

package/dist/client/change-history/methods.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeChangeHistoryQuery = serializeChangeHistoryQuery;
+exports.listChangeHistory = listChangeHistory;
+function serializeChangeHistoryQuery(params = {}) {
+    const search = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+        if (value === undefined) {
+            continue;
+        }
+        if (key === "types" && Array.isArray(value)) {
+            for (const type of value) {
+                search.append("types[]", type);
+            }
+        }
+        else {
+            search.set(key, String(value));
+        }
+    }
+    const encoded = search.toString();
+    return encoded ? `?${encoded}` : "";
+}
+function listChangeHistory(params = {}) {
+    return this.get(`/v1/slim/change-history${serializeChangeHistoryQuery(params)}`);
+}

package/dist/client/change-history/types.d.ts

@@ -0,0 +1,34 @@
+export type ChangeHistoryKey = "deviceCreated" | "deviceDeleted" | "deviceProjectChanged" | "deviceLocationChanged" | "deviceZoneChanged" | "deviceRenamed" | "locationCreated" | "locationDeleted" | "locationRenamed" | "locationZoneChanged" | "locationFloorChanged" | "locationRoomChanged" | "locationBedChanged" | "zoneCreated" | "zoneDeleted" | "zoneRenamed";
+export type ChangeHistoryRow = {
+    id: string;
+    type: string;
+    user: Record<string, unknown> | null;
+    residentId: string | null;
+    deviceId: string | null;
+    locationId?: string | null;
+    zoneId?: string | null;
+    time: string;
+    details: {
+        key: ChangeHistoryKey | (string & {});
+        values: Record<string, unknown>;
+    };
+};
+export type ChangeHistoryQuery = {
+    page?: number;
+    count?: number;
+    types?: readonly string[];
+    scope?: string;
+    userId?: string;
+    residentId?: string;
+    deviceId?: string;
+    locationId?: string;
+    zoneId?: string;
+    startDate?: string;
+    endDate?: string;
+};
+export type ChangeHistoryPage = {
+    total: number;
+    page: number;
+    count: number;
+    resources: ChangeHistoryRow[];
+};

package/dist/client/change-history/types.js

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

package/dist/client/consent/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./methods";
+export * from "./types";

package/dist/client/consent/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+__exportStar(require("./methods"), exports);
+__exportStar(require("./types"), exports);

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

@@ -0,0 +1,6 @@
+import { OvokClient } from "../ovok-client";
+import { LegalConsentResponse, MedicalConsentResponse } from "./types";
+export declare function getLegalConsent(this: OvokClient): Promise<LegalConsentResponse>;
+export declare function setLegalConsent(this: OvokClient, accepted: boolean): Promise<LegalConsentResponse>;
+export declare function getMedicalConsent(this: OvokClient): Promise<MedicalConsentResponse>;
+export declare function setMedicalConsent(this: OvokClient, accepted: boolean): Promise<MedicalConsentResponse>;

package/dist/client/consent/methods.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLegalConsent = getLegalConsent;
+exports.setLegalConsent = setLegalConsent;
+exports.getMedicalConsent = getMedicalConsent;
+exports.setMedicalConsent = setMedicalConsent;
+function getLegalConsent() {
+    return this.get("/v1/me/consent/legal");
+}
+function setLegalConsent(accepted) {
+    const body = { termsAndConditionsConsent: accepted };
+    return this.post("/v1/me/consent/legal", body);
+}
+function getMedicalConsent() {
+    return this.get("/v1/me/consent/medical");
+}
+function setMedicalConsent(accepted) {
+    const body = { medicalSettingsNotificationsConsent: accepted };
+    return this.post("/v1/me/consent/medical", body);
+}

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

@@ -0,0 +1,26 @@
+export type LegalConsentRecord = {
+    consentId: string;
+    status: "active" | "revoked";
+    termsUrl?: string | null;
+    termsUpdatedAt?: string | null;
+    acceptedAt?: string | null;
+    revokedAt?: string | null;
+    revokedReason?: "tos-updated" | "withdrawn" | null;
+};
+export type LegalConsentResponse = {
+    legal: LegalConsentRecord | null;
+};
+export type MedicalConsentRecord = {
+    consentId: string;
+    acceptedAt: string | null;
+};
+export type MedicalConsentResponse = {
+    medical: MedicalConsentRecord | null;
+};
+export type LegalConsentUpdate = {
+    termsAndConditionsConsent: boolean;
+};
+export type MedicalConsentUpdate = {
+    medicalSettingsNotificationsConsent: boolean;
+};
+export declare function needsLegalConsentReacceptance(legal: LegalConsentRecord | null | undefined): boolean;

package/dist/client/consent/types.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.needsLegalConsentReacceptance = needsLegalConsentReacceptance;
+function needsLegalConsentReacceptance(legal) {
+    return legal == null ||
+        (legal.status === "revoked" && legal.revokedReason === "tos-updated");
+}

package/dist/client/errors/ovok-error-utils.d.ts

@@ -0,0 +1,10 @@
+import { ValidationError } from "../../types/ValidationError";
+export declare const asRecord: (value: unknown) => Record<string, unknown> | undefined;
+export declare function readMessage(payload: Record<string, unknown> | undefined, error: unknown): string;
+export declare function readFieldErrors(payload: Record<string, unknown> | undefined): ValidationError[];
+export declare function codeValue(value: unknown): string | undefined;
+export declare function codeFromOutcome(value: unknown): string | undefined;
+export declare function statusFromOutcome(value: unknown): number | undefined;
+export declare function numberValue(value: unknown): number | undefined;
+export declare function stringValue(value: unknown): string | undefined;
+export declare function parseJson(value: unknown): unknown;

package/dist/client/errors/ovok-error-utils.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asRecord = void 0;
+exports.readMessage = readMessage;
+exports.readFieldErrors = readFieldErrors;
+exports.codeValue = codeValue;
+exports.codeFromOutcome = codeFromOutcome;
+exports.statusFromOutcome = statusFromOutcome;
+exports.numberValue = numberValue;
+exports.stringValue = stringValue;
+exports.parseJson = parseJson;
+const asRecord = (value) => value && typeof value === "object" ? value : undefined;
+exports.asRecord = asRecord;
+function readMessage(payload, error) {
+    var _a, _b, _c;
+    const nestedMessage = stringValue((_a = (0, exports.asRecord)(payload === null || payload === void 0 ? void 0 : payload.error)) === null || _a === void 0 ? void 0 : _a.message);
+    const message = (_c = (_b = stringValue(payload === null || payload === void 0 ? void 0 : payload.message)) !== null && _b !== void 0 ? _b : nestedMessage) !== null && _c !== void 0 ? _c : payload === null || payload === void 0 ? void 0 : payload.message;
+    if (typeof message === "string" && message.length > 0) {
+        return message;
+    }
+    if (Array.isArray(message)) {
+        const messages = message
+            .map((entry) => { var _a; return stringValue((_a = (0, exports.asRecord)(entry)) === null || _a === void 0 ? void 0 : _a.message); })
+            .filter((entry) => entry !== undefined);
+        if (messages.length > 0) {
+            return messages.join("; ");
+        }
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return typeof error === "string" ? error : String(error);
+}
+function readFieldErrors(payload) {
+    const messageErrors = Array.isArray(payload === null || payload === void 0 ? void 0 : payload.message) ? payload.message : [];
+    const nested = (0, exports.asRecord)(payload === null || payload === void 0 ? void 0 : payload.error);
+    const rawErrors = Array.isArray(nested === null || nested === void 0 ? void 0 : nested.errors)
+        ? nested.errors
+        : Array.isArray(payload === null || payload === void 0 ? void 0 : payload.errors)
+            ? payload.errors
+            : messageErrors;
+    const envelopeErrors = rawErrors.flatMap((value) => {
+        const record = (0, exports.asRecord)(value);
+        if (!record || typeof record.message !== "string") {
+            return [];
+        }
+        const path = Array.isArray(record.path)
+            ? record.path.map((segment) => String(segment))
+            : [];
+        return [{
+                ...(stringValue(record.code) ? { code: stringValue(record.code) } : {}),
+                message: record.message,
+                path,
+                ...(stringValue(record.validation)
+                    ? { validation: stringValue(record.validation) }
+                    : {}),
+            }];
+    });
+    const outcome = Array.isArray(payload === null || payload === void 0 ? void 0 : payload.issue) ? payload.issue : [];
+    const nestedEnvelopeErrors = outcome.flatMap((value) => {
+        var _a;
+        const details = (0, exports.asRecord)((_a = (0, exports.asRecord)(value)) === null || _a === void 0 ? void 0 : _a.details);
+        const nested = (0, exports.asRecord)(parseJson(details === null || details === void 0 ? void 0 : details.text));
+        return nested ? readFieldErrors(nested) : [];
+    });
+    const outcomeErrors = outcome.flatMap((value) => {
+        var _a;
+        const issue = (0, exports.asRecord)(value);
+        const details = (0, exports.asRecord)(issue === null || issue === void 0 ? void 0 : issue.details);
+        const message = (_a = stringValue(details === null || details === void 0 ? void 0 : details.text)) !== null && _a !== void 0 ? _a : stringValue(issue === null || issue === void 0 ? void 0 : issue.diagnostics);
+        if ((issue === null || issue === void 0 ? void 0 : issue.severity) !== "error" || !message) {
+            return [];
+        }
+        const expressions = Array.isArray(issue.expression)
+            ? issue.expression
+            : Array.isArray(issue.location)
+                ? issue.location
+                : [];
+        const path = expressions.flatMap((expression) => typeof expression === "string" ? expression.split(".").filter(Boolean) : []);
+        return [{
+                ...(stringValue(issue.code) ? { code: stringValue(issue.code) } : {}),
+                message,
+                path,
+            }];
+    });
+    return [...envelopeErrors, ...nestedEnvelopeErrors, ...outcomeErrors];
+}
+function codeValue(value) {
+    return typeof value === "string" && /^[a-z][a-z0-9_]+$/.test(value)
+        ? value
+        : undefined;
+}
+function codeFromOutcome(value) {
+    var _a, _b;
+    const outcome = (0, exports.asRecord)(value);
+    const issues = Array.isArray(outcome === null || outcome === void 0 ? void 0 : outcome.issue) ? outcome.issue : [];
+    for (const issue of issues) {
+        const record = (0, exports.asRecord)(issue);
+        const details = (0, exports.asRecord)(record === null || record === void 0 ? void 0 : record.details);
+        const coding = Array.isArray(details === null || details === void 0 ? void 0 : details.coding) ? details.coding : [];
+        for (const entry of coding) {
+            const code = codeValue((_a = (0, exports.asRecord)(entry)) === null || _a === void 0 ? void 0 : _a.code);
+            if (code === null || code === void 0 ? void 0 : code.startsWith("signals_")) {
+                return code;
+            }
+        }
+        const diagnostic = (0, exports.asRecord)(parseJson(record === null || record === void 0 ? void 0 : record.diagnostics));
+        const code = (_b = codeValue(diagnostic === null || diagnostic === void 0 ? void 0 : diagnostic.error)) !== null && _b !== void 0 ? _b : codeValue(diagnostic === null || diagnostic === void 0 ? void 0 : diagnostic.code);
+        if (code) {
+            return code;
+        }
+    }
+    return undefined;
+}
+function statusFromOutcome(value) {
+    var _a, _b;
+    const outcome = (0, exports.asRecord)(value);
+    const issues = Array.isArray(outcome === null || outcome === void 0 ? void 0 : outcome.issue) ? outcome.issue : [];
+    const statusByIssue = {
+        conflict: 409,
+        forbidden: 403,
+        "not-found": 404,
+        "too-many-requests": 429,
+        throttled: 429,
+    };
+    for (const issue of issues) {
+        const status = statusByIssue[String((_b = (_a = (0, exports.asRecord)(issue)) === null || _a === void 0 ? void 0 : _a.code) !== null && _b !== void 0 ? _b : "")];
+        if (status) {
+            return status;
+        }
+    }
+    return undefined;
+}
+function numberValue(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function stringValue(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function parseJson(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    try {
+        return JSON.parse(value);
+    }
+    catch (_a) {
+        return undefined;
+    }
+}

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

@@ -1,4 +1,5 @@
 import { ValidationError } from "../../types/ValidationError";
+export { asRecord, readFieldErrors, readMessage } from "./ovok-error-utils";
 export type ParsedOvokError = {
     message: string;
     fieldErrors: ValidationError[];
@@ -6,8 +7,23 @@ export type ParsedOvokError = {
 export type OvokErrorDetails = ParsedOvokError & {
     status: number | undefined;
     code: string | undefined;
+    missing: string[];
 };
 /** Reads the error details Medplum preserves from Ovok's non-FHIR responses. */
 export declare const readOvokError: (error: unknown) => OvokErrorDetails;
+/** A typed HTTP error for Ovok API responses whose status carries application meaning. */
+export declare class OvokApiError extends Error {
+    readonly status: number;
+    readonly code: string | undefined;
+    readonly fieldErrors: ValidationError[];
+    readonly missing: string[];
+    readonly cause: unknown;
+    constructor(details: OvokErrorDetails, cause: unknown);
+}
+export declare function isOvokApiError(error: unknown): error is OvokApiError;
+/** Types the status-bearing write failures without changing auth or rate-limit handling. */
+export declare function mapOvokApiError(error: unknown, options?: {
+    includeAccessErrors?: boolean;
+}): unknown;
 /** Normalizes Ovok's Nest and FHIR error envelopes without exposing transport details. */
 export declare const parseOvokError: (error: unknown) => ParsedOvokError;

package/dist/client/errors/ovok-error.js

@@ -1,6 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseOvokError = exports.readOvokError = void 0;
+exports.parseOvokError = exports.OvokApiError = exports.readOvokError = exports.readMessage = exports.readFieldErrors = exports.asRecord = void 0;
+exports.isOvokApiError = isOvokApiError;
+exports.mapOvokApiError = mapOvokApiError;
+const ovok_error_utils_1 = require("./ovok-error-utils");
+var ovok_error_utils_2 = require("./ovok-error-utils");
+Object.defineProperty(exports, "asRecord", { enumerable: true, get: function () { return ovok_error_utils_2.asRecord; } });
+Object.defineProperty(exports, "readFieldErrors", { enumerable: true, get: function () { return ovok_error_utils_2.readFieldErrors; } });
+Object.defineProperty(exports, "readMessage", { enumerable: true, get: function () { return ovok_error_utils_2.readMessage; } });
 const STATUS_BY_BARE_CODE = {
     INVALID_SETTING_VALUE: 422,
     APP_URL_NOT_ALLOWED: 400,
@@ -17,17 +24,25 @@ const HTTP_REASON_PHRASES = new Set([
     "internal server error",
     "service unavailable",
 ]);
-const asRecord = (value) => value && typeof value === "object" ? value : undefined;
 /** Reads the error details Medplum preserves from Ovok's non-FHIR responses. */
 const readOvokError = (error) => {
     var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t;
-    const root = asRecord(error);
-    const response = asRecord(root === null || root === void 0 ? void 0 : root.response);
+    if (error instanceof OvokApiError) {
+        return {
+            status: error.status,
+            code: error.code,
+            message: error.message,
+            fieldErrors: error.fieldErrors,
+            missing: error.missing,
+        };
+    }
+    const root = (0, ovok_error_utils_1.asRecord)(error);
+    const response = (0, ovok_error_utils_1.asRecord)(root === null || root === void 0 ? void 0 : root.response);
     const messagePayload = error instanceof Error
-        ? parseJson(error.message)
-        : parseJson(error);
-    const payload = (_f = (_e = (_d = (_c = (_b = (_a = asRecord(messagePayload)) !== null && _a !== void 0 ? _a : asRecord(root === null || root === void 0 ? void 0 : root.body)) !== null && _b !== void 0 ? _b : asRecord(root === null || root === void 0 ? void 0 : root.data)) !== null && _c !== void 0 ? _c : asRecord(response === null || response === void 0 ? void 0 : response.data)) !== null && _d !== void 0 ? _d : asRecord(response === null || response === void 0 ? void 0 : response.body)) !== null && _e !== void 0 ? _e : asRecord(root === null || root === void 0 ? void 0 : root.outcome)) !== null && _f !== void 0 ? _f : root;
-    const nestedError = asRecord(payload === null || payload === void 0 ? void 0 : payload.error);
+        ? (0, ovok_error_utils_1.parseJson)(error.message)
+        : (0, ovok_error_utils_1.parseJson)(error);
+    const payload = (_f = (_e = (_d = (_c = (_b = (_a = (0, ovok_error_utils_1.asRecord)(messagePayload)) !== null && _a !== void 0 ? _a : (0, ovok_error_utils_1.asRecord)(root === null || root === void 0 ? void 0 : root.body)) !== null && _b !== void 0 ? _b : (0, ovok_error_utils_1.asRecord)(root === null || root === void 0 ? void 0 : root.data)) !== null && _c !== void 0 ? _c : (0, ovok_error_utils_1.asRecord)(response === null || response === void 0 ? void 0 : response.data)) !== null && _d !== void 0 ? _d : (0, ovok_error_utils_1.asRecord)(response === null || response === void 0 ? void 0 : response.body)) !== null && _e !== void 0 ? _e : (0, ovok_error_utils_1.asRecord)(root === null || root === void 0 ? void 0 : root.outcome)) !== null && _f !== void 0 ? _f : root;
+    const nestedError = (0, ovok_error_utils_1.asRecord)(payload === null || payload === void 0 ? void 0 : payload.error);
     const bareMessage = typeof error === "string"
         ? error
         : error instanceof Error
@@ -37,130 +52,60 @@ const readOvokError = (error) => {
         && !HTTP_REASON_PHRASES.has(bareMessage.toLowerCase())
         ? bareMessage
         : undefined;
-    const code = (_k = (_j = (_h = (_g = stringValue(payload === null || payload === void 0 ? void 0 : payload.code)) !== null && _g !== void 0 ? _g : stringValue(nestedError === null || nestedError === void 0 ? void 0 : nestedError.code)) !== null && _h !== void 0 ? _h : codeValue(payload === null || payload === void 0 ? void 0 : payload.error)) !== null && _j !== void 0 ? _j : bareCode) !== null && _k !== void 0 ? _k : codeFromOutcome((_l = payload === null || payload === void 0 ? void 0 : payload.outcome) !== null && _l !== void 0 ? _l : payload);
-    const status = (_t = (_r = (_q = (_p = (_o = (_m = numberValue(root === null || root === void 0 ? void 0 : root.status)) !== null && _m !== void 0 ? _m : numberValue(root === null || root === void 0 ? void 0 : root.statusCode)) !== null && _o !== void 0 ? _o : numberValue(response === null || response === void 0 ? void 0 : response.status)) !== null && _p !== void 0 ? _p : numberValue(payload === null || payload === void 0 ? void 0 : payload.status)) !== null && _q !== void 0 ? _q : numberValue(payload === null || payload === void 0 ? void 0 : payload.statusCode)) !== null && _r !== void 0 ? _r : statusFromOutcome((_s = payload === null || payload === void 0 ? void 0 : payload.outcome) !== null && _s !== void 0 ? _s : payload)) !== null && _t !== void 0 ? _t : (code ? STATUS_BY_BARE_CODE[code] : undefined);
-    const fieldErrors = readFieldErrors(payload);
+    const code = (_k = (_j = (_h = (_g = (0, ovok_error_utils_1.stringValue)(payload === null || payload === void 0 ? void 0 : payload.code)) !== null && _g !== void 0 ? _g : (0, ovok_error_utils_1.stringValue)(nestedError === null || nestedError === void 0 ? void 0 : nestedError.code)) !== null && _h !== void 0 ? _h : (0, ovok_error_utils_1.codeValue)(payload === null || payload === void 0 ? void 0 : payload.error)) !== null && _j !== void 0 ? _j : bareCode) !== null && _k !== void 0 ? _k : (0, ovok_error_utils_1.codeFromOutcome)((_l = payload === null || payload === void 0 ? void 0 : payload.outcome) !== null && _l !== void 0 ? _l : payload);
+    const status = (_t = (_r = (_q = (_p = (_o = (_m = (0, ovok_error_utils_1.numberValue)(root === null || root === void 0 ? void 0 : root.status)) !== null && _m !== void 0 ? _m : (0, ovok_error_utils_1.numberValue)(root === null || root === void 0 ? void 0 : root.statusCode)) !== null && _o !== void 0 ? _o : (0, ovok_error_utils_1.numberValue)(response === null || response === void 0 ? void 0 : response.status)) !== null && _p !== void 0 ? _p : (0, ovok_error_utils_1.numberValue)(payload === null || payload === void 0 ? void 0 : payload.status)) !== null && _q !== void 0 ? _q : (0, ovok_error_utils_1.numberValue)(payload === null || payload === void 0 ? void 0 : payload.statusCode)) !== null && _r !== void 0 ? _r : (0, ovok_error_utils_1.statusFromOutcome)((_s = payload === null || payload === void 0 ? void 0 : payload.outcome) !== null && _s !== void 0 ? _s : payload)) !== null && _t !== void 0 ? _t : (code ? STATUS_BY_BARE_CODE[code] : undefined);
+    const fieldErrors = (0, ovok_error_utils_1.readFieldErrors)(payload);
+    const missing = Array.isArray(payload === null || payload === void 0 ? void 0 : payload.missing)
+        ? payload.missing.filter((entry) => typeof entry === "string")
+        : [];
     return {
         status,
         code,
-        message: readMessage(payload, error),
+        message: (0, ovok_error_utils_1.readMessage)(payload, error),
         fieldErrors,
+        missing,
     };
 };
 exports.readOvokError = readOvokError;
+/** A typed HTTP error for Ovok API responses whose status carries application meaning. */
+class OvokApiError extends Error {
+    constructor(details, cause) {
+        var _a;
+        super(details.message);
+        this.name = "OvokApiError";
+        this.status = (_a = details.status) !== null && _a !== void 0 ? _a : 0;
+        this.code = details.code;
+        this.fieldErrors = details.fieldErrors;
+        this.missing = details.missing;
+        Object.defineProperty(this, "cause", {
+            configurable: true,
+            enumerable: false,
+            value: cause,
+            writable: false,
+        });
+    }
+}
+exports.OvokApiError = OvokApiError;
+function isOvokApiError(error) {
+    return error instanceof OvokApiError;
+}
+/** Types the status-bearing write failures without changing auth or rate-limit handling. */
+function mapOvokApiError(error, options = {}) {
+    var _a;
+    if (isOvokApiError(error)) {
+        return error;
+    }
+    const details = (0, exports.readOvokError)(error);
+    const typedStatuses = options.includeAccessErrors
+        ? [403, 404, 409, 422, 424, 503]
+        : [409, 422, 424, 503];
+    return typedStatuses.includes((_a = details.status) !== null && _a !== void 0 ? _a : 0)
+        ? new OvokApiError(details, error)
+        : error;
+}
 /** Normalizes Ovok's Nest and FHIR error envelopes without exposing transport details. */
 const parseOvokError = (error) => {
     const { message, fieldErrors } = (0, exports.readOvokError)(error);
     return { message, fieldErrors };
 };
 exports.parseOvokError = parseOvokError;
-function readMessage(payload, error) {
-    var _a, _b, _c;
-    const nestedMessage = stringValue((_a = asRecord(payload === null || payload === void 0 ? void 0 : payload.error)) === null || _a === void 0 ? void 0 : _a.message);
-    const message = (_c = (_b = stringValue(payload === null || payload === void 0 ? void 0 : payload.message)) !== null && _b !== void 0 ? _b : nestedMessage) !== null && _c !== void 0 ? _c : payload === null || payload === void 0 ? void 0 : payload.message;
-    if (typeof message === "string" && message.length > 0) {
-        return message;
-    }
-    if (Array.isArray(message)) {
-        const messages = message
-            .map((entry) => { var _a; return stringValue((_a = asRecord(entry)) === null || _a === void 0 ? void 0 : _a.message); })
-            .filter((entry) => entry !== undefined);
-        if (messages.length > 0) {
-            return messages.join("; ");
-        }
-    }
-    if (error instanceof Error) {
-        return error.message;
-    }
-    return typeof error === "string" ? error : String(error);
-}
-function readFieldErrors(payload) {
-    const messageErrors = Array.isArray(payload === null || payload === void 0 ? void 0 : payload.message) ? payload.message : [];
-    const nested = asRecord(payload === null || payload === void 0 ? void 0 : payload.error);
-    const rawErrors = Array.isArray(nested === null || nested === void 0 ? void 0 : nested.errors)
-        ? nested.errors
-        : Array.isArray(payload === null || payload === void 0 ? void 0 : payload.errors)
-            ? payload.errors
-            : messageErrors;
-    return rawErrors.flatMap((value) => {
-        const record = asRecord(value);
-        if (!record || typeof record.message !== "string") {
-            return [];
-        }
-        const path = Array.isArray(record.path)
-            ? record.path.map((segment) => String(segment))
-            : [];
-        return [{
-                ...(stringValue(record.code) ? { code: stringValue(record.code) } : {}),
-                message: record.message,
-                path,
-                ...(stringValue(record.validation)
-                    ? { validation: stringValue(record.validation) }
-                    : {}),
-            }];
-    });
-}
-function codeValue(value) {
-    return typeof value === "string" && /^[a-z][a-z0-9_]+$/.test(value)
-        ? value
-        : undefined;
-}
-function codeFromOutcome(value) {
-    var _a, _b;
-    const outcome = asRecord(value);
-    const issues = Array.isArray(outcome === null || outcome === void 0 ? void 0 : outcome.issue) ? outcome.issue : [];
-    for (const issue of issues) {
-        const record = asRecord(issue);
-        const details = asRecord(record === null || record === void 0 ? void 0 : record.details);
-        const coding = Array.isArray(details === null || details === void 0 ? void 0 : details.coding) ? details.coding : [];
-        for (const entry of coding) {
-            const code = codeValue((_a = asRecord(entry)) === null || _a === void 0 ? void 0 : _a.code);
-            if (code === null || code === void 0 ? void 0 : code.startsWith("signals_")) {
-                return code;
-            }
-        }
-        const diagnostics = parseJson(record === null || record === void 0 ? void 0 : record.diagnostics);
-        const diagnostic = asRecord(diagnostics);
-        const code = (_b = codeValue(diagnostic === null || diagnostic === void 0 ? void 0 : diagnostic.error)) !== null && _b !== void 0 ? _b : codeValue(diagnostic === null || diagnostic === void 0 ? void 0 : diagnostic.code);
-        if (code) {
-            return code;
-        }
-    }
-    return undefined;
-}
-function statusFromOutcome(value) {
-    var _a, _b;
-    const outcome = asRecord(value);
-    const issues = Array.isArray(outcome === null || outcome === void 0 ? void 0 : outcome.issue) ? outcome.issue : [];
-    const statusByIssue = {
-        conflict: 409,
-        forbidden: 403,
-        "not-found": 404,
-        "too-many-requests": 429,
-        throttled: 429,
-    };
-    for (const issue of issues) {
-        const status = statusByIssue[String((_b = (_a = asRecord(issue)) === null || _a === void 0 ? void 0 : _a.code) !== null && _b !== void 0 ? _b : "")];
-        if (status) {
-            return status;
-        }
-    }
-    return undefined;
-}
-function numberValue(value) {
-    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
-}
-function stringValue(value) {
-    return typeof value === "string" && value.length > 0 ? value : undefined;
-}
-function parseJson(value) {
-    if (typeof value !== "string") {
-        return undefined;
-    }
-    try {
-        return JSON.parse(value);
-    }
-    catch (_a) {
-        return undefined;
-    }
-}

package/dist/client/notifications/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./methods";
+export * from "./types";