@mindbill/react 0.9.4 → 0.10.0

package/README.md

@@ -6,27 +6,25 @@ Native React billing components and connected lifecycle hooks. Install with:
 npm install @mindbill/react @mindbill/node
 ```
 
-## Connected status
+## Connected lifecycle
 
-`ConnectedBillStatus` owns the status API call, loading and error states, session renewal, one-minute polling, and focus refresh.
+`ConnectedBillLifecycle` is the default integration. It owns bill loading, payer lookup, editable review, attachments, submission, status refresh, EORs, payment posting, Second Bill Review, correction/resubmission, and close.
 
 ```tsx
-import { ConnectedBillStatus } from "@mindbill/react";
+import { ConnectedBillLifecycle } from "@mindbill/react";
 
-<ConnectedBillStatus
+<ConnectedBillLifecycle
   billId={billId}
+  sessionEndpoint="/api/mindbill/billing-session"
   appearance={{ accentColor: "#32a9d6", textColor: "#203743" }}
-  actions={[
-    { id: "eor", label: "View EOR", onClick: openEor },
-    { id: "payment", label: "Post payment", onClick: postPayment, primary: true },
-  ]}
+  onChanged={(lifecycle) => syncBillStatus(lifecycle.bill)}
 />
 ```
 
 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.
 
 ```ts
-// app/api/mindbill/status-session/route.ts
+// app/api/mindbill/billing-session/route.ts
 import { mindbill } from "@/lib/mindbill";
 
 export async function POST(request: Request) {
@@ -34,8 +32,8 @@ export async function POST(request: Request) {
   const { billId } = await request.json();
   await requireBillAccess(user, billId); // your existing authorization
 
-  const session = await mindbill.createEmbedSession({
-    component: "bill-timeline",
+  const session = await mindbill.createBrowserSession({
+    component: "bill-review",
     billId,
     allowedOrigin: new URL(request.url).origin,
     expiresIn: 900,
@@ -48,15 +46,29 @@ export async function POST(request: Request) {
 }
 ```
 
-Use `useBillStatus({ billId })` when you want to render your own UI. It returns `data`, `error`, `isLoading`, `isRefreshing`, and `refresh`. Use `createBillStatusClient` outside React.
+The component searches MindBill's claims-administrator directory with both payer text and the current claim number. It explains name and claim-pattern evidence, shows delivery availability, and only preselects a high-confidence exact name or alias match.
 
 This is the minimum safe browser integration. A permanent Partner API key must never enter frontend code. A completely serverless partner integration requires MindBill-hosted sign-in/SSO so MindBill can authenticate the end user itself.
 
-## Review and submit
+## Compact status
 
-`BillReviewForm` is the native, controlled review surface. Known bill values and payer documents remain explicit and editable before submission.
+Use `ConnectedBillStatus` when the partner page only needs a small status and aging surface. Add a second session route using the same server pattern and mint `component: "bill-timeline"`.
 
-When you use `ConnectedBillLifecycle`, payer selection is batteries-included: the component searches MindBill's claims-administrator directory, sends the current claim number for pattern matching, explains name and claim-number evidence, shows delivery availability, and only preselects a high-confidence exact name or alias match. For a controlled `BillReviewForm`, provide the same behavior with `onSearchClaimsAdministrators={(query, claimNumber) => ...}`; return `BillReviewPayer` records with optional `confidence`, `recommended`, and `signals` fields.
+```tsx
+import { ConnectedBillStatus } from "@mindbill/react";
+
+<ConnectedBillStatus
+  billId={billId}
+  sessionEndpoint="/api/mindbill/status-session"
+  appearance={{ accentColor: "#32a9d6", textColor: "#203743" }}
+/>
+```
+
+Use `useBillStatus({ billId })` when you want to render custom status UI. It returns `data`, `error`, `isLoading`, `isRefreshing`, and `refresh`. Use `createBillStatusClient` outside React.
+
+## Controlled escape hatch
+
+Use `BillReviewForm` only when your application intentionally owns the API calls and local review state. Known bill values and payer documents remain explicit and editable.
 
 ```tsx
 import { BillReviewForm } from "@mindbill/react";
@@ -72,6 +84,9 @@ import { BillReviewForm } from "@mindbill/react";
   onRemoveAttachment={(attachmentId) =>
     api.delete(`/billing/attachments/${attachmentId}`)
   }
+  onSearchClaimsAdministrators={(query, claimNumber) =>
+    api.searchPayers({ query, claimNumber })
+  }
 />
 ```
 
@@ -92,6 +107,6 @@ Use `BillStatusSummary` only when your application already owns status loading a
 />
 ```
 
-`HostedBillReview` and `HostedBillTimeline` remain available when a hosted flow is a better fit. Native and hosted UI paths use the same bill ID.
+`MindBillBillReview` and `MindBillBillTimeline` are available when a hosted flow is a better fit. Native and hosted UI paths use the same bill ID.
 
 Never send a Partner API key or long-lived credential to React/browser code.

package/dist/index.d.ts

@@ -4,7 +4,6 @@ import { CSSProperties, ReactElement, ReactNode } from 'react';
 
 type BillReviewDocumentType = "final_report" | "letter_of_attestation" | "proof_of_service" | "form_122" | "return_to_work_voucher" | "w9" | "medical_records" | "appeal" | "other";
 type BillReviewBillingProvider = {
-    id?: string;
     name: string;
     taxId: string;
     npi: string;
@@ -16,7 +15,6 @@ type BillReviewBillingProvider = {
     billingZip?: string;
 };
 type BillReviewClinician = {
-    id?: string;
     name: string;
     specialty: string;
     npi: string;
@@ -31,8 +29,6 @@ type BillReviewClinician = {
     active?: boolean;
 };
 type BillReviewLocation = {
-    id?: string;
-    billingProviderId?: string;
     name: string;
     nickname?: string;
     street: string;
@@ -95,10 +91,7 @@ type BillReviewData = {
         transmissionState?: string;
         dos: string;
         dosEnd?: string | null;
-        placeOfServiceId?: string;
         authorizationNumber?: string | null;
-        billingProviderId?: string;
-        renderingProviderId?: string;
         billingSnapshot?: {
             billingProvider?: BillReviewBillingProvider;
             renderingProvider?: BillReviewClinician;
@@ -128,11 +121,6 @@ type BillReviewData = {
         claimsAdminName?: string;
         claimPatternStatus?: BillReviewClaimPatternStatus;
     };
-    options?: {
-        billingProviders?: BillReviewBillingProvider[];
-        renderingProviders?: BillReviewClinician[];
-        locations?: BillReviewLocation[];
-    };
 };
 type BillReviewSaveInput = {
     claimsAdminId: string;
@@ -153,12 +141,9 @@ type BillReviewSaveInput = {
     dos: string;
     dosEnd?: string | null;
     authorizationNumber?: string | null;
-    billingProviderId?: string;
-    billingProvider?: Omit<BillReviewBillingProvider, "id">;
-    renderingProviderId?: string;
-    renderingProvider?: Omit<BillReviewClinician, "id">;
-    placeOfServiceId?: string;
-    placeOfService?: Omit<BillReviewLocation, "id">;
+    billingProvider?: BillReviewBillingProvider;
+    renderingProvider?: BillReviewClinician;
+    placeOfService?: BillReviewLocation;
     lineItems: Array<{
         id?: string;
         code: string;
@@ -425,13 +410,5 @@ type MindBillWidgetProps = {
 };
 declare function MindBillBillTimeline(props: MindBillWidgetProps): ReactElement;
 declare function MindBillBillReview(props: MindBillWidgetProps): ReactElement;
-declare function MindBillBillFromReport(props: MindBillWidgetProps): ReactElement;
-declare function MindBillCollections(props: MindBillWidgetProps): ReactElement;
-declare function MindBillOnboarding(props: MindBillWidgetProps): ReactElement;
-declare const HostedBillTimeline: typeof MindBillBillTimeline;
-declare const HostedBillReview: typeof MindBillBillReview;
-declare const HostedBillFromReport: typeof MindBillBillFromReport;
-declare const HostedCollections: typeof MindBillCollections;
-declare const HostedOnboarding: typeof MindBillOnboarding;
 
-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, HostedBillFromReport, HostedBillReview, HostedBillTimeline, HostedCollections, HostedOnboarding, MindBillBillFromReport, MindBillBillReview, MindBillBillTimeline, MindBillCollections, MindBillOnboarding, type MindBillWidgetProps, type PostBillPaymentInput, type SubmitSecondReviewInput, type UseBillLifecycleOptions, type UseBillLifecycleResult, type UseBillStatusOptions, type UseBillStatusResult, buildBillReviewSaveInput, createBillLifecycleClient, createBillStatusClient, useBillLifecycle, useBillStatus };
+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 MindBillWidgetProps, type PostBillPaymentInput, type SubmitSecondReviewInput, type UseBillLifecycleOptions, type UseBillLifecycleResult, type UseBillStatusOptions, type UseBillStatusResult, buildBillReviewSaveInput, createBillLifecycleClient, createBillStatusClient, useBillLifecycle, useBillStatus };

package/dist/index.js

@@ -66,11 +66,6 @@ var MODIFIER_CODES = {
   "97": ["ML201", "ML202", "ML203"],
   "98": ["ML201", "ML202", "ML203"]
 };
-function withoutId(value) {
-  const result = { ...value };
-  delete result.id;
-  return result;
-}
 function toDraft(data) {
   const snapshot = data.bill.billingSnapshot;
   const nameParts = data.patient.name.trim().split(/\s+/);
@@ -119,12 +114,9 @@ function buildBillReviewSaveInput(draft) {
     dos: draft.dos,
     dosEnd: draft.dosEnd || null,
     authorizationNumber: draft.authorizationNumber.trim() || null,
-    ...draft.billingProvider.id ? { billingProviderId: draft.billingProvider.id } : {},
-    billingProvider: withoutId(draft.billingProvider),
-    ...draft.clinician.id ? { renderingProviderId: draft.clinician.id } : {},
-    renderingProvider: withoutId(draft.clinician),
-    ...draft.location.id ? { placeOfServiceId: draft.location.id } : {},
-    placeOfService: withoutId(draft.location),
+    billingProvider: { ...draft.billingProvider },
+    renderingProvider: { ...draft.clinician },
+    placeOfService: { ...draft.location },
     lineItems: draft.lineItems.filter((line) => line.code.trim()).map(({ id, code, modifiers, units }) => ({
       ...id ? { id } : {},
       code: code.trim().toUpperCase(),
@@ -929,7 +921,7 @@ function createBillStatusClient({
   };
   const requestStatus = async (browserSession, signal) => {
     const baseUrl = (browserSession.apiBaseUrl ?? apiBaseUrl).replace(/\/$/, "");
-    return fetcher(`${baseUrl}/embed/api/bill-timeline`, {
+    return fetcher(`${baseUrl}/partner/v2/browser/status`, {
       headers: { authorization: `Bearer ${browserSession.token}` },
       signal
     });
@@ -1201,7 +1193,7 @@ function createBillLifecycleClient({
     return response;
   };
   const loadLifecycle = async (signal) => {
-    const response = await request("/embed/api/bill-lifecycle", {}, signal);
+    const response = await request("/partner/v2/browser/bill", {}, signal);
     if (!response.ok) {
       throw await responseError2(response, "Bill lifecycle could not be loaded.");
     }
@@ -1213,7 +1205,7 @@ function createBillLifecycleClient({
     if (query.trim()) params.set("q", query.trim());
     if (claimNumber?.trim()) params.set("claimNumber", claimNumber.trim());
     const response = await request(
-      `/embed/api/bill-review/payers?${params.toString()}`
+      `/partner/v2/browser/claims-administrators?${params.toString()}`
     );
     if (!response.ok) {
       throw await responseError2(
@@ -1264,7 +1256,7 @@ function createBillLifecycleClient({
   };
   const action = async (input, fallback) => {
     const response = await mutation(
-      "/embed/api/bill-lifecycle/actions",
+      "/partner/v2/browser/actions",
       {
         method: "POST",
         headers: { "content-type": "application/json" },
@@ -1277,7 +1269,7 @@ function createBillLifecycleClient({
   };
   const saveReview = async (input) => {
     await mutation(
-      "/embed/api/bill-review",
+      "/partner/v2/browser/bill",
       {
         method: "PATCH",
         headers: { "content-type": "application/json" },
@@ -1298,7 +1290,7 @@ function createBillLifecycleClient({
     async submitBill(input, route) {
       await saveReview(input);
       await mutation(
-        "/embed/api/bill-review/submit",
+        "/partner/v2/browser/submissions",
         {
           method: "POST",
           headers: { "content-type": "application/json" },
@@ -1314,7 +1306,7 @@ function createBillLifecycleClient({
       body.set("documentType", documentType);
       if (description) body.set("description", description);
       await mutation(
-        "/embed/api/bill-review/attachments",
+        "/partner/v2/browser/documents",
         { method: "POST", body },
         "Document could not be attached."
       );
@@ -1322,7 +1314,7 @@ function createBillLifecycleClient({
     },
     async removeAttachment(attachmentId) {
       await mutation(
-        `/embed/api/bill-review/attachments/${encodeURIComponent(attachmentId)}`,
+        `/partner/v2/browser/documents/${encodeURIComponent(attachmentId)}`,
         { method: "DELETE" },
         "Document could not be removed."
       );
@@ -1330,7 +1322,7 @@ function createBillLifecycleClient({
     },
     async getAttachment(attachmentId) {
       const response = await request(
-        `/embed/api/bill-review/attachments/${encodeURIComponent(attachmentId)}`
+        `/partner/v2/browser/documents/${encodeURIComponent(attachmentId)}`
       );
       if (!response.ok) {
         throw await responseError2(response, "Document could not be opened.");
@@ -1339,7 +1331,7 @@ function createBillLifecycleClient({
     },
     async getEor(documentId) {
       const response = await request(
-        `/embed/api/bill-lifecycle/eor/${encodeURIComponent(documentId)}`
+        `/partner/v2/browser/eors/${encodeURIComponent(documentId)}`
       );
       if (!response.ok) throw await responseError2(response, "EOR could not be opened.");
       return response.blob();
@@ -1361,7 +1353,7 @@ function createBillLifecycleClient({
     },
     async startCorrection() {
       const response = await mutation(
-        "/embed/api/bill-lifecycle/actions",
+        "/partner/v2/browser/actions",
         {
           method: "POST",
           headers: { "content-type": "application/json" },
@@ -1912,35 +1904,13 @@ function MindBillBillTimeline(props) {
 function MindBillBillReview(props) {
   return widget("mindbill-bill-review", props);
 }
-function MindBillBillFromReport(props) {
-  return widget("mindbill-bill-from-report", props);
-}
-function MindBillCollections(props) {
-  return widget("mindbill-collections", props);
-}
-function MindBillOnboarding(props) {
-  return widget("mindbill-onboarding", props);
-}
-var HostedBillTimeline = MindBillBillTimeline;
-var HostedBillReview = MindBillBillReview;
-var HostedBillFromReport = MindBillBillFromReport;
-var HostedCollections = MindBillCollections;
-var HostedOnboarding = MindBillOnboarding;
 export {
   BillReviewForm,
   BillStatusSummary,
   ConnectedBillLifecycle,
   ConnectedBillStatus,
-  HostedBillFromReport,
-  HostedBillReview,
-  HostedBillTimeline,
-  HostedCollections,
-  HostedOnboarding,
-  MindBillBillFromReport,
   MindBillBillReview,
   MindBillBillTimeline,
-  MindBillCollections,
-  MindBillOnboarding,
   buildBillReviewSaveInput,
   createBillLifecycleClient,
   createBillStatusClient,