@mindbill/react 0.12.0 → 0.13.0

package/README.md

@@ -37,7 +37,7 @@ Choose a complete preset, then override only the tokens your design system owns.
 />
 ```
 
-Available presets are `mindbill`, `qme-companion`, and `orange-bright`. Preset names describe visual styles rather than customer or partner brands. Supported overrides include accent, accent text, background, surface, input background, text, muted text, border, font, panel radius, control radius, shadow, danger, success, and warning colors.
+Available presets are `mindbill`, `qme-companion`, `orange-bright`, and `clinical-blue`. Preset names describe visual styles rather than customer or partner brands. Supported overrides include accent, accent text, background, surface, input background, text, muted text, border, font, panel radius, control radius, shadow, danger, success, and warning colors.
 
 Add one authenticated route to your app. It verifies that the signed-in user may access the bill, then mints an exact-origin, bill-scoped token. The Partner API key stays on the server.
 

package/dist/index.d.ts

@@ -1,8 +1,10 @@
 import { MindBillAppearance, MindBillEventDetail, MindBillErrorDetail } from '@mindbill/embed';
 export { MindBillAppearance, MindBillErrorDetail, MindBillEventDetail } from '@mindbill/embed';
 import { CSSProperties, ReactElement, ReactNode } from 'react';
+import { BillLifecycleClientOptions, BillLifecycleData, BillLifecycleClient, BillEorDocument } from '@mindbill/browser';
+export { BillEorDocument, BillLifecycleAction, BillLifecycleActionId, BillLifecycleClient, BillLifecycleClientOptions, BillLifecycleData, BillLifecycleSession, BillLifecycleSessionProvider, BillLifecycleSessionRequest, CloseBillInput, PostBillPaymentInput, SubmitSecondReviewInput, createBillLifecycleClient } from '@mindbill/browser';
 
-type MindBillThemePreset = "mindbill" | "qme-companion" | "orange-bright";
+type MindBillThemePreset = "mindbill" | "qme-companion" | "orange-bright" | "clinical-blue";
 type MindBillReactAppearance = MindBillAppearance & {
     /** A complete starting point. Individual tokens below always win. */
     preset?: MindBillThemePreset;
@@ -65,6 +67,23 @@ declare const mindBillThemePresets: {
         readonly warningColor: "#9a5b13";
         readonly fontFamily: "Inter, ui-sans-serif, system-ui, sans-serif";
     };
+    readonly "clinical-blue": {
+        readonly accentColor: "#1677ff";
+        readonly accentTextColor: "#ffffff";
+        readonly backgroundColor: "#f5f7fa";
+        readonly surfaceColor: "#ffffff";
+        readonly inputBackgroundColor: "#ffffff";
+        readonly textColor: "#1f2d3d";
+        readonly mutedColor: "#66788a";
+        readonly borderColor: "#d9e2ec";
+        readonly borderRadius: "8px";
+        readonly controlRadius: "6px";
+        readonly shadow: "0 2px 8px rgba(31,45,61,.06)";
+        readonly dangerColor: "#d4380d";
+        readonly successColor: "#389e0d";
+        readonly warningColor: "#d48806";
+        readonly fontFamily: "Inter, -apple-system, BlinkMacSystemFont, Segoe UI, sans-serif";
+    };
 };
 declare function resolveMindBillAppearance(appearance: MindBillReactAppearance | undefined): MindBillReactAppearance;
 declare function mindBillAppearanceStyle(appearance: MindBillReactAppearance | undefined, style?: CSSProperties): CSSProperties;
@@ -341,87 +360,6 @@ type ConnectedBillStatusProps = UseBillStatusOptions & {
 };
 declare function ConnectedBillStatus({ actions, appearance, className, style, loadingFallback, errorFallback, ...options }: ConnectedBillStatusProps): ReactElement | null;
 
-type BillLifecycleActionId = "edit_and_submit" | "correct_and_resubmit" | "second_review" | "independent_bill_review" | "view_eor" | "post_payment" | "close";
-type BillLifecycleAction = {
-    id: BillLifecycleActionId;
-    label: string;
-    enabled: boolean;
-    primary?: boolean;
-    reason?: string;
-};
-type BillEorDocument = {
-    id: string;
-    filename: string;
-    description: string | null;
-    addedAt: string;
-    contentUrl: string;
-};
-type BillLifecycleData = BillReviewData & {
-    lifecycle: {
-        state: string;
-        nativeStatus: string;
-        submittedAt?: string | null;
-        agingDays?: number | null;
-        updatedAt?: string | null;
-        actions: BillLifecycleAction[];
-    };
-    eors: BillEorDocument[];
-};
-type BillLifecycleSession = {
-    token: string;
-    expiresAt?: string;
-    apiBaseUrl?: string;
-};
-type BillLifecycleSessionRequest = {
-    billId: string;
-    component: "bill-review";
-    signal: AbortSignal;
-};
-type BillLifecycleSessionProvider = (request: BillLifecycleSessionRequest) => Promise<BillLifecycleSession>;
-type CloseBillInput = {
-    reason: string;
-};
-type PostBillPaymentInput = {
-    amount: number;
-    method: "check" | "eft";
-    checkNumber?: string;
-    depositDate: string;
-    note?: string;
-};
-type SubmitSecondReviewInput = {
-    reason: string;
-    payerClaimControlNumber: string;
-    disputedAmount: number | undefined;
-    attachmentIds: string[];
-    route: BillSubmissionRoute;
-};
-type BillLifecycleClientOptions = {
-    billId: string;
-    /** Same-origin server route that mints a short-lived, bill-scoped session. */
-    sessionEndpoint?: string | undefined;
-    /** Advanced escape hatch for a custom session exchange. */
-    getSession?: BillLifecycleSessionProvider | undefined;
-    apiBaseUrl?: string | undefined;
-    fetch?: typeof globalThis.fetch | undefined;
-};
-type BillLifecycleClient = {
-    getLifecycle: (signal?: AbortSignal) => Promise<BillLifecycleData>;
-    searchClaimsAdministrators: (query: string, claimNumber?: string) => Promise<BillReviewPayer[]>;
-    saveReview: (input: BillReviewSaveInput) => Promise<BillLifecycleData>;
-    submitBill: (input: BillReviewSaveInput, route: BillSubmissionRoute) => Promise<BillLifecycleData>;
-    addAttachment: (file: File, documentType: BillReviewDocumentType, description?: string) => Promise<BillLifecycleData>;
-    removeAttachment: (attachmentId: string) => Promise<BillLifecycleData>;
-    getAttachment: (attachmentId: string) => Promise<Blob>;
-    getEor: (documentId: string) => Promise<Blob>;
-    closeBill: (input: CloseBillInput) => Promise<BillLifecycleData>;
-    postPayment: (input: PostBillPaymentInput) => Promise<BillLifecycleData>;
-    submitSecondReview: (input: SubmitSecondReviewInput) => Promise<BillLifecycleData>;
-    startCorrection: () => Promise<{
-        replacementBillId: string;
-        data: BillLifecycleData;
-    }>;
-    clearSession: () => void;
-};
 type UseBillLifecycleOptions = BillLifecycleClientOptions & {
     refreshInterval?: number;
     enabled?: boolean;
@@ -448,12 +386,6 @@ type UseBillLifecycleResult = {
     submitSecondReview: BillLifecycleClient["submitSecondReview"];
     startCorrection: () => Promise<BillLifecycleData>;
 };
-/**
- * Browser-safe client for the complete bill lifecycle. The only long-lived
- * secret remains on the partner server; this client uses a short-lived,
- * origin-bound session scoped to one bill.
- */
-declare function createBillLifecycleClient({ billId, sessionEndpoint, getSession, apiBaseUrl, fetch: fetchOverride, }: BillLifecycleClientOptions): BillLifecycleClient;
 declare function useBillLifecycle({ billId: providedBillId, sessionEndpoint, getSession, apiBaseUrl, refreshInterval, enabled, initialData, onBillIdChange, fetch: fetchOverride, }: UseBillLifecycleOptions): UseBillLifecycleResult;
 type ConnectedBillLifecycleProps = UseBillLifecycleOptions & {
     appearance?: MindBillReactAppearance;
@@ -478,4 +410,4 @@ type MindBillWidgetProps = {
 declare function MindBillBillTimeline(props: MindBillWidgetProps): ReactElement;
 declare function MindBillBillReview(props: MindBillWidgetProps): ReactElement;
 
-export { type BillEorDocument, type BillLifecycleAction, type BillLifecycleActionId, type BillLifecycleClient, type BillLifecycleClientOptions, type BillLifecycleData, type BillLifecycleSession, type BillLifecycleSessionProvider, type BillLifecycleSessionRequest, type BillReviewAttachment, type BillReviewBillingProvider, type BillReviewClinician, type BillReviewData, type BillReviewDocumentType, type BillReviewDraft, type BillReviewFeatures, BillReviewForm, type BillReviewFormProps, type BillReviewLineItem, type BillReviewLocation, type BillReviewPayer, type BillReviewSaveInput, type BillStatusAction, type BillStatusClient, type BillStatusClientOptions, type BillStatusData, type BillStatusSession, type BillStatusSessionProvider, type BillStatusSessionRequest, BillStatusSummary, type BillStatusSummaryProps, type BillSubmissionRoute, type CloseBillInput, ConnectedBillLifecycle, type ConnectedBillLifecycleProps, ConnectedBillStatus, type ConnectedBillStatusProps, MindBillBillReview, MindBillBillTimeline, type MindBillReactAppearance, type MindBillThemePreset, type MindBillWidgetProps, type PostBillPaymentInput, type SubmitSecondReviewInput, type UseBillLifecycleOptions, type UseBillLifecycleResult, type UseBillStatusOptions, type UseBillStatusResult, buildBillReviewSaveInput, createBillLifecycleClient, createBillStatusClient, mindBillAppearanceStyle, mindBillThemePresets, resolveMindBillAppearance, useBillLifecycle, useBillStatus };
+export { type BillReviewAttachment, type BillReviewBillingProvider, type BillReviewClinician, type BillReviewData, type BillReviewDocumentType, type BillReviewDraft, type BillReviewFeatures, BillReviewForm, type BillReviewFormProps, type BillReviewLineItem, type BillReviewLocation, type BillReviewPayer, type BillReviewSaveInput, type BillStatusAction, type BillStatusClient, type BillStatusClientOptions, type BillStatusData, type BillStatusSession, type BillStatusSessionProvider, type BillStatusSessionRequest, BillStatusSummary, type BillStatusSummaryProps, type BillSubmissionRoute, ConnectedBillLifecycle, type ConnectedBillLifecycleProps, ConnectedBillStatus, type ConnectedBillStatusProps, MindBillBillReview, MindBillBillTimeline, type MindBillReactAppearance, type MindBillThemePreset, type MindBillWidgetProps, type UseBillLifecycleOptions, type UseBillLifecycleResult, type UseBillStatusOptions, type UseBillStatusResult, buildBillReviewSaveInput, createBillStatusClient, mindBillAppearanceStyle, mindBillThemePresets, resolveMindBillAppearance, useBillLifecycle, useBillStatus };

package/dist/index.js

@@ -55,6 +55,23 @@ var mindBillThemePresets = {
     successColor: "#16794f",
     warningColor: "#9a5b13",
     fontFamily: "Inter, ui-sans-serif, system-ui, sans-serif"
+  },
+  "clinical-blue": {
+    accentColor: "#1677ff",
+    accentTextColor: "#ffffff",
+    backgroundColor: "#f5f7fa",
+    surfaceColor: "#ffffff",
+    inputBackgroundColor: "#ffffff",
+    textColor: "#1f2d3d",
+    mutedColor: "#66788a",
+    borderColor: "#d9e2ec",
+    borderRadius: "8px",
+    controlRadius: "6px",
+    shadow: "0 2px 8px rgba(31,45,61,.06)",
+    dangerColor: "#d4380d",
+    successColor: "#389e0d",
+    warningColor: "#d48806",
+    fontFamily: "Inter, -apple-system, BlinkMacSystemFont, Segoe UI, sans-serif"
   }
 };
 function resolveMindBillAppearance(appearance) {
@@ -1170,294 +1187,14 @@ import {
   useRef as useRef3,
   useState as useState3
 } from "react";
+import {
+  DEFAULT_API_BASE_URL as DEFAULT_API_BASE_URL2,
+  DEFAULT_SESSION_ENDPOINT as DEFAULT_SESSION_ENDPOINT2,
+  createBillLifecycleClient
+} from "@mindbill/browser";
+import { createBillLifecycleClient as createBillLifecycleClient2 } from "@mindbill/browser";
 import { Fragment as Fragment2, jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
-var DEFAULT_API_BASE_URL2 = "https://app.mindbill.org";
-var DEFAULT_SESSION_ENDPOINT2 = "/api/mindbill/bill-session";
 var DEFAULT_REFRESH_INTERVAL2 = 6e4;
-async function responseError2(response, fallback) {
-  const body = await response.json().catch(() => null);
-  const detail = body && typeof body === "object" ? body.detail ?? body.message ?? body.error : null;
-  return new Error(typeof detail === "string" ? detail : fallback);
-}
-function isSessionFresh2(session) {
-  if (!session) return false;
-  if (!session.expiresAt) return true;
-  const expiresAt = new Date(session.expiresAt).getTime();
-  return Number.isFinite(expiresAt) && expiresAt > Date.now() + 3e4;
-}
-function normalizeSession2(value) {
-  if (!value || typeof value !== "object") {
-    throw new Error("The billing session endpoint returned an invalid response.");
-  }
-  const candidate = value;
-  const nested = candidate.session ?? candidate.data;
-  const session = nested && typeof nested === "object" ? nested : candidate;
-  if (typeof session.token !== "string" || session.token.length < 8) {
-    throw new Error(
-      "The billing session endpoint did not return a browser session token."
-    );
-  }
-  return {
-    token: session.token,
-    ...typeof session.expiresAt === "string" ? { expiresAt: session.expiresAt } : {},
-    ...typeof session.apiBaseUrl === "string" ? { apiBaseUrl: session.apiBaseUrl } : {}
-  };
-}
-function normalizeLifecycle(value) {
-  if (!value || typeof value !== "object") {
-    throw new Error("The billing service returned an invalid bill lifecycle.");
-  }
-  const data = value;
-  if (!data.bill || !data.patient || !data.injury || !data.lifecycle || !Array.isArray(data.lifecycle.actions) || !Array.isArray(data.eors)) {
-    throw new Error("The billing service returned an invalid bill lifecycle.");
-  }
-  return data;
-}
-function idempotencyKey() {
-  if (typeof globalThis.crypto?.randomUUID === "function") {
-    return globalThis.crypto.randomUUID();
-  }
-  return `mb-${Date.now()}-${Math.random().toString(36).slice(2)}`;
-}
-function createBillLifecycleClient({
-  billId,
-  sessionEndpoint = DEFAULT_SESSION_ENDPOINT2,
-  getSession,
-  apiBaseUrl = DEFAULT_API_BASE_URL2,
-  fetch: fetchOverride
-}) {
-  const fetcher = fetchOverride ?? globalThis.fetch;
-  if (typeof fetcher !== "function") {
-    throw new Error("A Fetch API implementation is required.");
-  }
-  let session = null;
-  let sessionRequest = null;
-  const mintSession = async (signal, force = false) => {
-    if (!force && isSessionFresh2(session)) return session;
-    if (!force && sessionRequest) return sessionRequest;
-    const pending = getSession ? getSession({ billId, component: "bill-review", signal }) : fetcher(sessionEndpoint, {
-      method: "POST",
-      credentials: "same-origin",
-      headers: { "content-type": "application/json" },
-      body: JSON.stringify({ billId, component: "bill-review" }),
-      signal
-    }).then(async (response) => {
-      if (!response.ok) {
-        throw await responseError2(
-          response,
-          "The billing session could not be created."
-        );
-      }
-      return response.json();
-    });
-    const request2 = Promise.resolve(pending).then(normalizeSession2).then((nextSession) => {
-      session = nextSession;
-      return nextSession;
-    }).finally(() => {
-      if (sessionRequest === request2) sessionRequest = null;
-    });
-    sessionRequest = request2;
-    return request2;
-  };
-  const request = async (path, init = {}, providedSignal) => {
-    const controller = providedSignal ? null : new AbortController();
-    const signal = providedSignal ?? controller?.signal;
-    if (!signal) throw new Error("An AbortSignal could not be created.");
-    let browserSession = await mintSession(signal);
-    const perform = (current) => {
-      const base = (current.apiBaseUrl ?? apiBaseUrl).replace(/\/$/, "");
-      const headers = new Headers(init.headers);
-      headers.set("authorization", `Bearer ${current.token}`);
-      return fetcher(`${base}${path}`, { ...init, headers, signal });
-    };
-    let response = await perform(browserSession);
-    if (response.status === 401) {
-      session = null;
-      browserSession = await mintSession(signal, true);
-      response = await perform(browserSession);
-    }
-    return response;
-  };
-  const loadLifecycle = async (signal) => {
-    const response = await request("/partner/v2/browser/bill", {}, signal);
-    if (!response.ok) {
-      throw await responseError2(response, "Bill lifecycle could not be loaded.");
-    }
-    const body = await response.json();
-    return normalizeLifecycle(body.data);
-  };
-  const searchClaimsAdministrators = async (query, claimNumber) => {
-    const params = new URLSearchParams();
-    if (query.trim()) params.set("q", query.trim());
-    if (claimNumber?.trim()) params.set("claimNumber", claimNumber.trim());
-    const response = await request(
-      `/partner/v2/browser/claims-administrators?${params.toString()}`
-    );
-    if (!response.ok) {
-      throw await responseError2(
-        response,
-        "Claims administrator search is unavailable."
-      );
-    }
-    const body = await response.json();
-    if (!Array.isArray(body.results)) {
-      throw new Error("Claims administrator search returned an invalid response.");
-    }
-    return body.results.flatMap((value) => {
-      if (!value || typeof value !== "object") return [];
-      const payer = value;
-      if (typeof payer.id !== "string" || typeof payer.name !== "string") {
-        return [];
-      }
-      return [{
-        id: payer.id,
-        name: payer.name,
-        ...typeof payer.hasElectronic === "boolean" ? { hasElectronic: payer.hasElectronic } : {},
-        ...Array.isArray(payer.states) ? { states: payer.states.filter((state) => typeof state === "string") } : {},
-        ...["high", "medium", "directory"].includes(payer.confidence ?? "") ? {
-          confidence: payer.confidence
-        } : {},
-        ...typeof payer.recommended === "boolean" ? { recommended: payer.recommended } : {},
-        ...Array.isArray(payer.signals) ? {
-          signals: payer.signals.flatMap((signal) => {
-            if (!signal || typeof signal !== "object") return [];
-            const candidate = signal;
-            if (!["name", "claim_number"].includes(String(candidate.kind)) || !["match", "warning"].includes(String(candidate.state)) || typeof candidate.label !== "string") return [];
-            return [{
-              kind: candidate.kind,
-              state: candidate.state,
-              label: candidate.label
-            }];
-          })
-        } : {}
-      }];
-    });
-  };
-  const mutation = async (path, init, fallback) => {
-    const headers = new Headers(init.headers);
-    headers.set("idempotency-key", idempotencyKey());
-    const response = await request(path, { ...init, headers });
-    if (!response.ok) throw await responseError2(response, fallback);
-    return response;
-  };
-  const action = async (input, fallback) => {
-    const response = await mutation(
-      "/partner/v2/browser/actions",
-      {
-        method: "POST",
-        headers: { "content-type": "application/json" },
-        body: JSON.stringify(input)
-      },
-      fallback
-    );
-    const body = await response.json();
-    return normalizeLifecycle(body.data);
-  };
-  const saveReview = async (input) => {
-    await mutation(
-      "/partner/v2/browser/bill",
-      {
-        method: "PATCH",
-        headers: { "content-type": "application/json" },
-        body: JSON.stringify(input)
-      },
-      "Bill changes could not be saved."
-    );
-    return loadLifecycle();
-  };
-  return {
-    clearSession() {
-      session = null;
-      sessionRequest = null;
-    },
-    getLifecycle: loadLifecycle,
-    searchClaimsAdministrators,
-    saveReview,
-    async submitBill(input, route) {
-      await saveReview(input);
-      await mutation(
-        "/partner/v2/browser/submissions",
-        {
-          method: "POST",
-          headers: { "content-type": "application/json" },
-          body: JSON.stringify({ route })
-        },
-        "Bill could not be submitted."
-      );
-      return loadLifecycle();
-    },
-    async addAttachment(file, documentType, description) {
-      const body = new FormData();
-      body.set("file", file);
-      body.set("documentType", documentType);
-      if (description) body.set("description", description);
-      await mutation(
-        "/partner/v2/browser/documents",
-        { method: "POST", body },
-        "Document could not be attached."
-      );
-      return loadLifecycle();
-    },
-    async removeAttachment(attachmentId) {
-      await mutation(
-        `/partner/v2/browser/documents/${encodeURIComponent(attachmentId)}`,
-        { method: "DELETE" },
-        "Document could not be removed."
-      );
-      return loadLifecycle();
-    },
-    async getAttachment(attachmentId) {
-      const response = await request(
-        `/partner/v2/browser/documents/${encodeURIComponent(attachmentId)}`
-      );
-      if (!response.ok) {
-        throw await responseError2(response, "Document could not be opened.");
-      }
-      return response.blob();
-    },
-    async getEor(documentId) {
-      const response = await request(
-        `/partner/v2/browser/eors/${encodeURIComponent(documentId)}`
-      );
-      if (!response.ok) throw await responseError2(response, "EOR could not be opened.");
-      return response.blob();
-    },
-    closeBill(input) {
-      return action({ action: "close", ...input }, "Bill could not be closed.");
-    },
-    postPayment(input) {
-      return action(
-        { action: "post_payment", ...input, checkNumber: input.checkNumber ?? "" },
-        "Payment could not be posted."
-      );
-    },
-    submitSecondReview(input) {
-      return action(
-        { action: "second_review", ...input },
-        "Second Review could not be submitted."
-      );
-    },
-    async startCorrection() {
-      const response = await mutation(
-        "/partner/v2/browser/actions",
-        {
-          method: "POST",
-          headers: { "content-type": "application/json" },
-          body: JSON.stringify({ action: "start_correction" })
-        },
-        "Correction draft could not be created."
-      );
-      const body = await response.json();
-      if (typeof body.replacementBillId !== "string") {
-        throw new Error("The billing service did not return the correction bill ID.");
-      }
-      return {
-        replacementBillId: body.replacementBillId,
-        data: normalizeLifecycle(body.data)
-      };
-    }
-  };
-}
 function openPdf(blob, filename) {
   const url = URL.createObjectURL(blob);
   const link = document.createElement("a");
@@ -2003,7 +1740,7 @@ export {
   MindBillBillReview,
   MindBillBillTimeline,
   buildBillReviewSaveInput,
-  createBillLifecycleClient,
+  createBillLifecycleClient2 as createBillLifecycleClient,
   createBillStatusClient,
   mindBillAppearanceStyle,
   mindBillThemePresets,