@mindbill/browser 0.46.0 → 0.48.0

package/dist/index.d.ts

@@ -1,3 +1,9 @@
+type RfaLifecycleStatus = "incomplete" | "sent" | "failed" | "received" | "closed" | "canceled";
+declare const RFA_LIFECYCLE_LABELS: Readonly<Record<RfaLifecycleStatus, string>>;
+type LifecycleRecord = Pick<RfaRecord, "status"> & Partial<Pick<RfaRecord, "lifecycleStatus" | "submittedAt" | "receivedAt" | "transmissions">>;
+/** Prefer the API lifecycle. Older responses are derived from the current submission's evidence. */
+declare function getRfaLifecycleStatus(rfa: LifecycleRecord): RfaLifecycleStatus;
+
 /** One patient's complete services for one provider/group. Dates are service dates, not publication dates. */
 type CaClaimFeeQuoteInput = {
     lines: Array<Omit<BillFeeQuoteInput, "billingProviderId" | "payerId" | "physicianContext"> & {
@@ -136,6 +142,8 @@ type RfaAuthorizationDestinationOption = {
     destination: string;
     label: string;
     phone?: string;
+    /** Recipient attention line, retained on the reviewed delivery cover. */
+    recipientName?: string;
 };
 /** Accept fax numbers only, never telephone notes, email addresses, or extensions. */
 declare function normalizeRfaFax(value: string): string | null;
@@ -257,11 +265,40 @@ type RfaFollowUpUpdate = {
         allDecisionsRecordedConfirmed: true;
     };
 };
+type RfaInboundFax = {
+    id: string;
+    receivedAt: string;
+    fromFax: string | null;
+    fromName: string | null;
+    pages: number | null;
+    ocrStatus: string | null;
+    matchedRfaId: string | null;
+    documentId: string | null;
+    previewUrl: string;
+    suggestedRfaIds: string[];
+};
+type RfaInboundFaxMatch = {
+    faxId: string;
+    rfaId: string;
+    documentId: string;
+    alreadyAttached: boolean;
+};
 type RfaFollowUpList = {
     data: RfaFollowUp[];
     nextCursor: string | null;
 };
 type RfaLifecycleClient = {
+    listInboundFaxes(query?: {
+        includeMatched?: boolean;
+        cursor?: string;
+        limit?: number;
+    }): Promise<{
+        data: RfaInboundFax[];
+        hasMore: boolean;
+        nextCursor: string | null;
+    }>;
+    getInboundFaxContent(faxId: string): Promise<Blob>;
+    matchInboundFax(faxId: string, rfaId: string, idempotencyKey: string): Promise<RfaInboundFaxMatch>;
     listScheduling(id: string): Promise<RfaScheduling[]>;
     updateScheduling(id: string, itemId: string, input: RfaSchedulingInput, idempotencyKey: string): Promise<RfaScheduling[]>;
     correctDecision(id: string, input: RfaDecisionCorrectionInput, idempotencyKey: string): Promise<RfaRecord>;
@@ -272,6 +309,8 @@ type RfaLifecycleClient = {
     recordInformationResponse(id: string, requestId: string, input: RfaInformationResponseInput, idempotencyKey: string): Promise<RfaRecord>;
     recordDecisions(id: string, input: RfaDecisionsInput, idempotencyKey: string): Promise<RfaRecord>;
     listFollowUps(query?: {
+        patientId?: string;
+        renderingProviderId?: string;
         claimId?: string;
         includeResolved?: boolean;
         limit?: number;
@@ -1900,6 +1939,7 @@ type RfaDeliveryPreviewInput = {
     documentIds: string[];
     channel: "fax" | "email" | "download";
     to?: string;
+    recipientName?: string;
     message?: string;
 };
 type RfaDeliveryPreview = {
@@ -1910,6 +1950,7 @@ type RfaDeliveryPreview = {
 type RfaSubmitInput = Omit<RfaDeliveryPreview, "contentRevision"> & {
     channel: "fax" | "email";
     to: string;
+    recipientName?: string;
     message?: string;
     nonBusinessDates?: string[];
 };
@@ -1970,6 +2011,8 @@ type RfaRecord = {
     providerName: string;
     claimNumber: string | null;
     status: string;
+    /** Delivery/review lifecycle, separate from the clinical status and item outcomes. */
+    lifecycleStatus?: RfaLifecycleStatus;
     requestType?: RfaCreateDraftInput["requestType"];
     writtenConfirmation?: boolean;
     requestingPractice?: RfaContact | null;
@@ -2063,11 +2106,12 @@ type RfaRecord = {
 type RfaListQuery = {
     patientId?: string;
     search?: string;
-    sortBy?: "createdAt" | "employeeName" | "providerName" | "submittedAt" | "status";
+    sortBy?: "createdAt" | "employeeName" | "providerName" | "submittedAt" | "status" | "lifecycleStatus";
     sortDirection?: "asc" | "desc";
     claimId?: string;
     renderingProviderId?: string;
     status?: string;
+    lifecycleStatus?: RfaLifecycleStatus;
     createdFrom?: string;
     createdTo?: string;
     limit?: number;
@@ -2079,6 +2123,7 @@ type RfaListResult = {
     summary: {
         total: number;
         byStatus: Record<string, number>;
+        byLifecycleStatus?: Partial<Record<RfaLifecycleStatus, number>>;
     };
 };
 type RfaSigningPreviewInput = {
@@ -2191,4 +2236,4 @@ type RfaClient = {
 /** Uses short-lived browser credentials. Never pass a partner API key. */
 declare function createRfaClient({ sessionEndpoint, getSession, apiBaseUrl, fetch: fetchOverride }?: OrganizationClientOptions): RfaClient;
 
-export { type AddBillNoteInput, BILL_FEE_QUOTE_BASES, BILL_TASKS_AGING_BUCKETS, type BillActivityRecord, type BillActorInput, type BillAttemptSummary, type BillClaimsAdministratorAuthorizationStatus, type BillClaimsAdministratorContact, type BillClaimsAdministratorDirectory, type BillClaimsAdministratorMailingAddress, type BillClaimsAdministratorPattern, type BillClaimsAdministratorPayer, type BillClaimsAdministratorSource, type BillCourtesyCopyInput, type BillCourtesyCopyPreview, type BillCourtesyCopyResult, type BillDeliveryOption, type BillDeliveryOptions, type BillDeliveryPreviewInput, type BillDiagnosisCode, type BillEorDocument, type BillFeeContext, type BillFeeQuote, type BillFeeQuoteBasis, type BillFeeQuoteInput, type BillFeeSource, type BillFormData, type BillFormValue, type BillHistoryEntry, type BillLifecycleAction, type BillLifecycleActionId, type BillLifecycleClient, type BillLifecycleClientOptions, type BillLifecycleData, type BillLifecycleDelivery, type BillLifecycleSession, type BillLifecycleSessionProvider, type BillLifecycleSessionRequest, type BillLineFeeBreakdown, type BillLineFormData, type BillPaymentRecord, type BillPostalPlace, type BillProcedureCodePage, type BillProcedureCodeSearchInput, type BillReferenceClient, type BillReferenceClientOptions, type BillRejection, type BillRejectionIssue, type BillRemittanceSummary, type BillReviewAttachment, type BillReviewBillingProvider, type BillReviewClaimPatternStatus, type BillReviewClinician, type BillReviewData, type BillReviewDocumentType, type BillReviewFeatures, type BillReviewLineItem, type BillReviewLocation, type BillReviewPayer, type BillReviewPayerListInput, type BillReviewPayerOption, type BillReviewPayerPage, type BillReviewPayerSuggestion, type BillReviewSaveInput, type BillSubmissionClient, type BillSubmissionClientOptions, type BillSubmissionDetail, type BillSubmissionRoute, type BillTasksAgingBucket, type BillTasksDashboardData, type BillTasksDashboardItem, type BillTasksDashboardRow, type BillTasksDashboardSection, type BillTasksDashboardSectionInput, type BillTasksDashboardTone, type BillTeamNote, type BilledDrug, type BrowserBillAddress, type BrowserBillCreateInput, type BrowserBillSubmissionDocument, type BrowserBillSubmissionInput, type BrowserBillSubmissionResult, type BrowserSubmittedBill, type CaAnesthesiaContext, type CaAnesthesiaEvent, type CaAnesthesiaInterval, type CaAnesthesiaOptionalParticipation, type CaAnesthesiaParticipation, type CaClaimEditFinding, type CaClaimFeeFinding, type CaClaimFeeQuoteInput, type CaClaimFeeQuoteResult, type CaClaimLineQuote, type CaFeeCalculation, type CaFeeCitation, type CaMedicalDirection, type CaMedicalDirectionCase, type CaMonitoredAnesthesiaCare, type CaPadbContext, type CaProfessionalComponentContext, type CaTechnicalComponentContext, type CaTherapyContext, type ClaimForm, type CloseBillInput, type CorrectionDraft, DEFAULT_API_BASE_URL, DEFAULT_SESSION_ENDPOINT, type HistoricalBillReviewData, type OrganizationBillingProviderInput, type OrganizationChecklistItem, type OrganizationClaimsAdministrator, type OrganizationClaimsAdministratorInput, type OrganizationClient, type OrganizationClientOptions, type OrganizationLocationInput, type OrganizationPracticeIdentity, type OrganizationProfileData, type OrganizationRenderingProviderInput, type OrganizationTeam, type OrganizationTeamMember, type OrganizationTeamRole, type PostBillPaymentInput, REPORT_BILL_STATUS_OPTIONS, type ReopenBillInput, type ReportAutofillClient, type ReportAutofillField, type ReportAutofillMatch, type ReportAutofillResult, type ReportBillStatusActionInput, type ReportBillStatusContacts, type ReportBillStatusId, type ReportBillStatusInput, type ReportBillStatusOption, type ResubmitBillInput, type RfaAuthorizationDestinationOption, type RfaClient, type RfaContact, type RfaCreateDraftInput, type RfaCreationClaim, type RfaCreationContext, type RfaCreationContextQuery, type RfaCreationProvider, type RfaDecisionCorrectionInput, type RfaDecisionsInput, type RfaDeliveryPreview, type RfaDeliveryPreviewInput, type RfaDraftActionsClient, type RfaFaxInput, type RfaFollowUp, type RfaFollowUpList, type RfaFollowUpUpdate, type RfaForwardInput, type RfaForwardResult, type RfaHistoryEvent, type RfaInformationRequestInput, type RfaInformationResponseInput, type RfaLifecycleClient, type RfaListQuery, type RfaListResult, type RfaPacketHistory, type RfaPacketTransmission, type RfaPacketsClient, type RfaProvisionClaimInput, type RfaProvisionClaimResult, type RfaReceiptInput, type RfaRecord, type RfaSavedPacket, type RfaScheduling, type RfaSchedulingInput, type RfaSignInput, type RfaSigningPreview, type RfaSigningPreviewInput, type RfaSubmitInput, type RfaTreatmentDecisionInput, type RfaUpdateDraftInput, type RfaUploadDocumentInput, SECOND_REVIEW_REASON_TEMPLATE, SECOND_REVIEW_WINDOW_DAYS, type SandboxSimulationScenario, type SecondReviewDeadline, type SecondReviewLineInput, type SendDuplicateBillInput, type SimulateSandboxBillInput, type SubmitBillInput, type SubmitNewBillInput, type SubmitSecondReviewInput, billTasksAgingBucketIndex, buildBillTasksDashboard, createBillLifecycleClient, createBillReferenceClient, createBillSubmissionClient, createOrganizationClient, createReportAutofillClient, createRfaClient, createRfaDraftActionsClient, createRfaLifecycleClient, createRfaPacketsClient, defaultBillReviewPayerOption, normalizeRfaFax, organizationTaxIdWrite, parseSecondReviewCorrection, reportBillStatusContacts, rfaAuthorizationDestinations, rfaAuthorizationGuidance, sanitizeBillReviewSaveInput, secondReviewDeadline };
+export { type AddBillNoteInput, BILL_FEE_QUOTE_BASES, BILL_TASKS_AGING_BUCKETS, type BillActivityRecord, type BillActorInput, type BillAttemptSummary, type BillClaimsAdministratorAuthorizationStatus, type BillClaimsAdministratorContact, type BillClaimsAdministratorDirectory, type BillClaimsAdministratorMailingAddress, type BillClaimsAdministratorPattern, type BillClaimsAdministratorPayer, type BillClaimsAdministratorSource, type BillCourtesyCopyInput, type BillCourtesyCopyPreview, type BillCourtesyCopyResult, type BillDeliveryOption, type BillDeliveryOptions, type BillDeliveryPreviewInput, type BillDiagnosisCode, type BillEorDocument, type BillFeeContext, type BillFeeQuote, type BillFeeQuoteBasis, type BillFeeQuoteInput, type BillFeeSource, type BillFormData, type BillFormValue, type BillHistoryEntry, type BillLifecycleAction, type BillLifecycleActionId, type BillLifecycleClient, type BillLifecycleClientOptions, type BillLifecycleData, type BillLifecycleDelivery, type BillLifecycleSession, type BillLifecycleSessionProvider, type BillLifecycleSessionRequest, type BillLineFeeBreakdown, type BillLineFormData, type BillPaymentRecord, type BillPostalPlace, type BillProcedureCodePage, type BillProcedureCodeSearchInput, type BillReferenceClient, type BillReferenceClientOptions, type BillRejection, type BillRejectionIssue, type BillRemittanceSummary, type BillReviewAttachment, type BillReviewBillingProvider, type BillReviewClaimPatternStatus, type BillReviewClinician, type BillReviewData, type BillReviewDocumentType, type BillReviewFeatures, type BillReviewLineItem, type BillReviewLocation, type BillReviewPayer, type BillReviewPayerListInput, type BillReviewPayerOption, type BillReviewPayerPage, type BillReviewPayerSuggestion, type BillReviewSaveInput, type BillSubmissionClient, type BillSubmissionClientOptions, type BillSubmissionDetail, type BillSubmissionRoute, type BillTasksAgingBucket, type BillTasksDashboardData, type BillTasksDashboardItem, type BillTasksDashboardRow, type BillTasksDashboardSection, type BillTasksDashboardSectionInput, type BillTasksDashboardTone, type BillTeamNote, type BilledDrug, type BrowserBillAddress, type BrowserBillCreateInput, type BrowserBillSubmissionDocument, type BrowserBillSubmissionInput, type BrowserBillSubmissionResult, type BrowserSubmittedBill, type CaAnesthesiaContext, type CaAnesthesiaEvent, type CaAnesthesiaInterval, type CaAnesthesiaOptionalParticipation, type CaAnesthesiaParticipation, type CaClaimEditFinding, type CaClaimFeeFinding, type CaClaimFeeQuoteInput, type CaClaimFeeQuoteResult, type CaClaimLineQuote, type CaFeeCalculation, type CaFeeCitation, type CaMedicalDirection, type CaMedicalDirectionCase, type CaMonitoredAnesthesiaCare, type CaPadbContext, type CaProfessionalComponentContext, type CaTechnicalComponentContext, type CaTherapyContext, type ClaimForm, type CloseBillInput, type CorrectionDraft, DEFAULT_API_BASE_URL, DEFAULT_SESSION_ENDPOINT, type HistoricalBillReviewData, type OrganizationBillingProviderInput, type OrganizationChecklistItem, type OrganizationClaimsAdministrator, type OrganizationClaimsAdministratorInput, type OrganizationClient, type OrganizationClientOptions, type OrganizationLocationInput, type OrganizationPracticeIdentity, type OrganizationProfileData, type OrganizationRenderingProviderInput, type OrganizationTeam, type OrganizationTeamMember, type OrganizationTeamRole, type PostBillPaymentInput, REPORT_BILL_STATUS_OPTIONS, RFA_LIFECYCLE_LABELS, type ReopenBillInput, type ReportAutofillClient, type ReportAutofillField, type ReportAutofillMatch, type ReportAutofillResult, type ReportBillStatusActionInput, type ReportBillStatusContacts, type ReportBillStatusId, type ReportBillStatusInput, type ReportBillStatusOption, type ResubmitBillInput, type RfaAuthorizationDestinationOption, type RfaClient, type RfaContact, type RfaCreateDraftInput, type RfaCreationClaim, type RfaCreationContext, type RfaCreationContextQuery, type RfaCreationProvider, type RfaDecisionCorrectionInput, type RfaDecisionsInput, type RfaDeliveryPreview, type RfaDeliveryPreviewInput, type RfaDraftActionsClient, type RfaFaxInput, type RfaFollowUp, type RfaFollowUpList, type RfaFollowUpUpdate, type RfaForwardInput, type RfaForwardResult, type RfaHistoryEvent, type RfaInboundFax, type RfaInboundFaxMatch, type RfaInformationRequestInput, type RfaInformationResponseInput, type RfaLifecycleClient, type RfaLifecycleStatus, type RfaListQuery, type RfaListResult, type RfaPacketHistory, type RfaPacketTransmission, type RfaPacketsClient, type RfaProvisionClaimInput, type RfaProvisionClaimResult, type RfaReceiptInput, type RfaRecord, type RfaSavedPacket, type RfaScheduling, type RfaSchedulingInput, type RfaSignInput, type RfaSigningPreview, type RfaSigningPreviewInput, type RfaSubmitInput, type RfaTreatmentDecisionInput, type RfaUpdateDraftInput, type RfaUploadDocumentInput, SECOND_REVIEW_REASON_TEMPLATE, SECOND_REVIEW_WINDOW_DAYS, type SandboxSimulationScenario, type SecondReviewDeadline, type SecondReviewLineInput, type SendDuplicateBillInput, type SimulateSandboxBillInput, type SubmitBillInput, type SubmitNewBillInput, type SubmitSecondReviewInput, billTasksAgingBucketIndex, buildBillTasksDashboard, createBillLifecycleClient, createBillReferenceClient, createBillSubmissionClient, createOrganizationClient, createReportAutofillClient, createRfaClient, createRfaDraftActionsClient, createRfaLifecycleClient, createRfaPacketsClient, defaultBillReviewPayerOption, getRfaLifecycleStatus, normalizeRfaFax, organizationTaxIdWrite, parseSecondReviewCorrection, reportBillStatusContacts, rfaAuthorizationDestinations, rfaAuthorizationGuidance, sanitizeBillReviewSaveInput, secondReviewDeadline };

package/dist/index.js

@@ -49,7 +49,7 @@ function normalizeRfaFax(value) {
 function rfaAuthorizationDestinations(directory) {
   if (!directory || ["adjuster_specific_required", "daisybill_unverified", "profile_not_published"].includes(directory.authorizationStatus ?? "")) return [];
   return (directory.authorization ?? []).flatMap((contact) => {
-    const common = { label: contact.location || contact.name || "Authorization department", ...contact.phone ? { phone: contact.phone } : {} };
+    const common = { label: contact.location || contact.name || "Authorization department", ...contact.name ? { recipientName: contact.name } : {}, ...contact.phone ? { phone: contact.phone } : {} };
     const options = [];
     const fax = contact.fax ? normalizeRfaFax(contact.fax) : null;
     if (fax && contact.method !== "email") options.push({ ...common, method: "fax", destination: fax });
@@ -124,7 +124,7 @@ function createRfaLifecycleClient({ sessionEndpoint = "/api/mindbill/session", g
     });
     return pending;
   };
-  const request = async (path2, init = {}) => {
+  const responseFor = async (path2, init = {}) => {
     const perform = (active) => {
       const headers = new Headers(init.headers);
       headers.set("authorization", `Bearer ${active.token}`);
@@ -134,8 +134,9 @@ function createRfaLifecycleClient({ sessionEndpoint = "/api/mindbill/session", g
     let response = await perform(await mint());
     if (response.status === 401) response = await perform(await mint(true));
     if (!response.ok) throw await failure(response);
-    return response.json();
+    return response;
   };
+  const request = async (path2, init = {}) => (await responseFor(path2, init)).json();
   const mutate = async (path2, input, key, method = "POST") => {
     if (!key.trim()) throw new Error("An idempotency key is required.");
     const result = await request(path2, { method, headers: { "idempotency-key": key }, body: JSON.stringify(input) });
@@ -149,6 +150,21 @@ function createRfaLifecycleClient({ sessionEndpoint = "/api/mindbill/session", g
     return result.data;
   };
   return {
+    listInboundFaxes: async (query = {}) => {
+      const params = new URLSearchParams();
+      for (const [key, value] of Object.entries(query)) if (value !== void 0) params.set(key, String(value));
+      const result = await request(`rfa-inbound-faxes${params.size ? `?${params}` : ""}`);
+      if (!Array.isArray(result.data) || typeof result.hasMore !== "boolean" || result.nextCursor !== null && typeof result.nextCursor !== "string" || result.hasMore && !result.nextCursor) throw new Error("The inbound fax response was invalid.");
+      return result;
+    },
+    getInboundFaxContent: async (faxId) => (await responseFor(`rfa-inbound-faxes/${encodeURIComponent(faxId)}/content`)).blob(),
+    matchInboundFax: async (faxId, rfaId, key) => {
+      if (!key.trim()) throw new Error("An idempotency key is required.");
+      if (!rfaId.trim()) throw new Error("Choose an authorization request.");
+      const result = await request(`rfa-inbound-faxes/${encodeURIComponent(faxId)}/match`, { method: "POST", headers: { "idempotency-key": key }, body: JSON.stringify({ rfaId }) });
+      if (!result.data?.documentId || result.data.faxId !== faxId || result.data.rfaId !== rfaId) throw new Error("The fax match response was invalid.");
+      return result.data;
+    },
     listScheduling: (id) => readArray(path(id, "scheduling")),
     updateScheduling: (id, itemId, input, key) => {
       if (!key.trim()) return Promise.reject(new Error("An idempotency key is required."));
@@ -353,6 +369,32 @@ function createRfaPacketsClient({ sessionEndpoint = "/api/mindbill/session", get
   };
 }
 
+// src/rfa-status.ts
+var RFA_LIFECYCLE_LABELS = {
+  incomplete: "Incomplete",
+  sent: "Sent",
+  failed: "Failed",
+  received: "Received",
+  closed: "Closed",
+  canceled: "Canceled"
+};
+var timestamp = (value) => value ? Date.parse(value) || 0 : 0;
+function getRfaLifecycleStatus(rfa) {
+  if (rfa.lifecycleStatus && Object.hasOwn(RFA_LIFECYCLE_LABELS, rfa.lifecycleStatus)) return rfa.lifecycleStatus;
+  if (rfa.status === "canceled") return "canceled";
+  if (["closed", "approved", "modified", "denied", "mixed"].includes(rfa.status)) return "closed";
+  const submissions = (rfa.transmissions ?? []).filter((value) => !value.purpose || value.purpose === "submission");
+  const latest = submissions.filter((value) => value.direction === "outbound").sort((a, b) => timestamp(b.occurredAt) - timestamp(a.occurredAt) || b.id.localeCompare(a.id))[0];
+  if (latest) {
+    const received = latest.receivedAt || submissions.some((value) => value.direction === "inbound" && value.status === "received" && timestamp(value.receivedAt ?? value.occurredAt) >= timestamp(latest.occurredAt));
+    if (received) return "received";
+    return latest.status === "failed" ? "failed" : "sent";
+  }
+  if (rfa.receivedAt || ["received", "under_review", "information_requested"].includes(rfa.status)) return "received";
+  if (rfa.submittedAt || rfa.status === "submitted") return "sent";
+  return "incomplete";
+}
+
 // src/index.ts
 var DEFAULT_API_BASE_URL = "https://app.mindbill.org";
 var DEFAULT_SESSION_ENDPOINT = "/api/mindbill/session";
@@ -1310,6 +1352,7 @@ export {
   DEFAULT_API_BASE_URL,
   DEFAULT_SESSION_ENDPOINT,
   REPORT_BILL_STATUS_OPTIONS,
+  RFA_LIFECYCLE_LABELS,
   SECOND_REVIEW_REASON_TEMPLATE,
   SECOND_REVIEW_WINDOW_DAYS,
   billTasksAgingBucketIndex,
@@ -1324,6 +1367,7 @@ export {
   createRfaLifecycleClient,
   createRfaPacketsClient,
   defaultBillReviewPayerOption,
+  getRfaLifecycleStatus,
   normalizeRfaFax,
   organizationTaxIdWrite,
   parseSecondReviewCorrection,