@mindbill/react 0.9.2 → 0.9.4

package/README.md

@@ -56,6 +56,8 @@ This is the minimum safe browser integration. A permanent Partner API key must n
 
 `BillReviewForm` is the native, controlled review surface. Known bill values and payer documents remain explicit and editable before submission.
 
+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 { BillReviewForm } from "@mindbill/react";
 

package/dist/index.d.ts

@@ -67,9 +67,25 @@ type BillReviewPayer = {
     name: string;
     hasElectronic?: boolean;
     states?: string[];
+    confidence?: "high" | "medium" | "directory";
+    recommended?: boolean;
+    signals?: Array<{
+        kind: "name" | "claim_number";
+        state: "match" | "warning";
+        label: string;
+    }>;
 };
 type BillReviewFeatures = {
     authorizationNumber?: boolean;
+    serviceDateRange?: boolean;
+    wcabNumber?: boolean;
+    codingPresets?: boolean;
+};
+type BillReviewClaimPatternStatus = {
+    state: "match" | "warning" | "unknown";
+    label: string;
+    detail?: string;
+    suggestion?: string;
 };
 type BillReviewData = {
     bill: {
@@ -96,14 +112,21 @@ type BillReviewData = {
     };
     patient: {
         name: string;
+        firstName?: string;
+        middleName?: string;
+        lastName?: string;
         dob?: string;
     };
     injury: {
         claimNumber?: string;
         employer?: string;
         doi?: string;
+        injuryEndDate?: string;
+        cumulativeTrauma?: boolean;
+        adjNumber?: string;
         claimsAdminId?: string;
         claimsAdminName?: string;
+        claimPatternStatus?: BillReviewClaimPatternStatus;
     };
     options?: {
         billingProviders?: BillReviewBillingProvider[];
@@ -113,6 +136,20 @@ type BillReviewData = {
 };
 type BillReviewSaveInput = {
     claimsAdminId: string;
+    patientOverrides?: {
+        firstName: string;
+        middleName?: string;
+        lastName: string;
+        dob?: string;
+    };
+    injuryOverrides?: {
+        claimNumber?: string;
+        employer?: string;
+        doi?: string;
+        injuryEndDate?: string;
+        cumulativeTrauma?: boolean;
+        adjNumber?: string;
+    };
     dos: string;
     dosEnd?: string | null;
     authorizationNumber?: string | null;
@@ -137,7 +174,7 @@ type BillReviewFormProps = {
     onAddAttachment: (file: File, documentType: BillReviewDocumentType, description?: string) => Promise<void>;
     onRemoveAttachment: (attachmentId: string) => Promise<void>;
     onOpenAttachment?: (attachment: BillReviewAttachment) => void;
-    onSearchClaimsAdministrators?: (query: string) => Promise<BillReviewPayer[]>;
+    onSearchClaimsAdministrators?: (query: string, claimNumber?: string) => Promise<BillReviewPayer[]>;
     className?: string;
     style?: CSSProperties;
     appearance?: MindBillAppearance;
@@ -147,6 +184,16 @@ type BillReviewFormProps = {
 type BillReviewDraft = {
     claimsAdminId: string;
     claimsAdminName: string;
+    patientFirstName: string;
+    patientMiddleName: string;
+    patientLastName: string;
+    patientDob: string;
+    claimNumber: string;
+    employer: string;
+    doi: string;
+    injuryEndDate: string;
+    cumulativeTrauma: boolean;
+    adjNumber: string;
     dos: string;
     dosEnd: string;
     authorizationNumber: string;
@@ -307,7 +354,7 @@ type BillLifecycleClientOptions = {
 };
 type BillLifecycleClient = {
     getLifecycle: (signal?: AbortSignal) => Promise<BillLifecycleData>;
-    searchClaimsAdministrators: (query: string) => Promise<BillReviewPayer[]>;
+    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>;