@mindbill/browser 0.47.0 → 0.49.0

package/dist/index.d.ts

@@ -1,157 +1,3 @@
-/** 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"> & {
-        id: string;
-        serviceCounty?: string;
-        physicianContext?: Omit<NonNullable<BillFeeQuoteInput["physicianContext"]>, "providerKind"> & {
-            providerKind: NonNullable<BillFeeQuoteInput["physicianContext"]>["providerKind"] | "clinical_social_worker";
-            telehealthModality?: "audio_video" | "audio_only";
-            cmsSpecialtyCode?: string;
-        };
-    }>;
-    completeDateOfServiceContext: boolean;
-    ordinaryMultipleSurgeryContext?: boolean;
-};
-type CaFeeCitation = {
-    id: string;
-    url: string;
-    sha256?: string;
-    effectiveFrom?: string;
-    effectiveThrough?: string;
-};
-type CaFeeCalculation = {
-    method: "rbrvs" | "therapy_mppr";
-    locality: string;
-    serviceZip?: string;
-    serviceCounty?: string;
-    setting: "facility" | "nonfacility";
-    units: number;
-    conversionFactor: string;
-    providerPercent: number;
-    baseMaximumCents?: number;
-    cmsIndicators?: Record<string, string>;
-    sourceFiles?: Array<{
-        kind: string;
-        filename: string;
-    }>;
-    components: Array<{
-        name: string;
-        rvu: string;
-        gpci: string;
-        payableUnits: number;
-    }>;
-    rounding: string;
-};
-type CaClaimEditFinding = {
-    type: string;
-    lineIds: string[];
-    message: string;
-    citationUrl: string;
-    column1?: string;
-    column2?: string;
-    modifierIndicator?: number;
-    code?: string;
-    limit?: number;
-    submittedUnits?: number;
-    adjudicationIndicator?: number;
-    scope?: "line" | "patient_provider_date";
-};
-type CaClaimFeeFinding = {
-    code: string;
-    lineIds: string[];
-    message: string;
-    citationUrl?: string;
-    edit?: CaClaimEditFinding;
-};
-type CaClaimLineQuote = ({
-    status: "priced";
-    amountCents: number;
-    scheduleMaximumCents: number;
-    basis: BillFeeQuoteBasis | "ca_ambulance";
-    notes: string[];
-    feeBreakdown?: {
-        method: string;
-        inputs: Array<{
-            label: string;
-            value: string;
-        }>;
-        steps: Array<{
-            label: string;
-            value: string;
-        }>;
-    };
-} | {
-    status: "requires_review" | "not_separately_payable";
-    reason: string;
-}) & {
-    provenance: CaFeeCitation[];
-    calculation?: CaFeeCalculation;
-};
-type CaClaimFeeQuoteResult = {
-    status: "priced" | "requires_review" | "not_separately_payable";
-    lines: Array<{
-        id: string;
-        input: CaClaimFeeQuoteInput["lines"][number];
-        quote: CaClaimLineQuote;
-        assessment: CaClaimFeeQuoteResult["status"];
-        findings: CaClaimFeeFinding[];
-        paymentAdjustment?: {
-            rule: "ca_multiple_surgery";
-            rank: number;
-            percent: 100 | 50;
-            unadjustedScheduleMaximumCents: number;
-            scheduleMaximumCents: number;
-            amountCents: number;
-            citationUrl: string;
-        };
-    }>;
-    totals: {
-        submittedChargeCents: number | null;
-        pricedSubtotalCents: number;
-        estimatedPayableCents: number | null;
-        scheduleMaximumCents: number | null;
-        reviewLineCount: number;
-    };
-    claimEdits: Array<{
-        dateOfService: string;
-        lineIds: string[];
-        status: "evaluated" | "requires_review" | "source_unavailable" | "not_applicable";
-        reason?: string;
-        findings: CaClaimEditFinding[];
-        provenance?: unknown;
-        supportedDateRange?: {
-            from: string;
-            through: string;
-        };
-        supportedDateIntervals?: Array<{
-            from: string;
-            through: string;
-        }>;
-    }>;
-    limitations: string[];
-};
-
-type RfaAuthorizationDestinationOption = {
-    method: "fax" | "email";
-    destination: string;
-    label: string;
-    phone?: string;
-};
-/** Accept fax numbers only, never telephone notes, email addresses, or extensions. */
-declare function normalizeRfaFax(value: string): string | null;
-/** Returns choices only. Selecting or transmitting a destination is a separate user action. */
-declare function rfaAuthorizationDestinations(directory: BillClaimsAdministratorDirectory | null): RfaAuthorizationDestinationOption[];
-declare function rfaAuthorizationGuidance(directory: BillClaimsAdministratorDirectory | null): string;
-
-type CorrectionDraft = {
-    correctBilling: boolean;
-    units: string;
-    modifiers: string;
-    charge: string;
-    chargeReviewed: boolean;
-};
-declare function parseSecondReviewCorrection(draft: CorrectionDraft): SecondReviewLineInput["correction"];
-
 type RfaReceiptInput = {
     channel: "fax" | "email" | "edi" | "portal" | "mail" | "manual";
     receivedAt: string;
@@ -213,6 +59,18 @@ type RfaSchedulingInput = {
     disposition: "no_appointment" | "canceled";
     reason: string;
 });
+type RfaTreatmentClosureInput = {
+    closed: boolean;
+    reason: string;
+    expectedVersion: number;
+};
+type RfaTreatmentClosure = {
+    closed: boolean;
+    reason: string;
+    version: number;
+    updatedAt: string;
+    updatedBy: string;
+};
 type RfaDecisionCorrectionInput = {
     itemId: string;
     expectedDecisionEventId: string;
@@ -293,6 +151,7 @@ type RfaLifecycleClient = {
     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[]>;
+    updateTreatmentClosure(id: string, itemId: string, input: RfaTreatmentClosureInput, idempotencyKey: string): Promise<RfaRecord>;
     correctDecision(id: string, input: RfaDecisionCorrectionInput, idempotencyKey: string): Promise<RfaRecord>;
     listHistory(id: string): Promise<RfaHistoryEvent[]>;
     addNote(id: string, text: string, idempotencyKey: string): Promise<RfaHistoryEvent>;
@@ -314,6 +173,168 @@ type RfaLifecycleClient = {
 /** Records clinical workflow evidence. These methods never send faxes or reconcile notification queues. */
 declare function createRfaLifecycleClient({ sessionEndpoint, getSession, apiBaseUrl, fetch: fetchOverride }?: OrganizationClientOptions): RfaLifecycleClient;
 
+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"> & {
+        id: string;
+        serviceCounty?: string;
+        physicianContext?: Omit<NonNullable<BillFeeQuoteInput["physicianContext"]>, "providerKind"> & {
+            providerKind: NonNullable<BillFeeQuoteInput["physicianContext"]>["providerKind"] | "clinical_social_worker";
+            telehealthModality?: "audio_video" | "audio_only";
+            cmsSpecialtyCode?: string;
+        };
+    }>;
+    completeDateOfServiceContext: boolean;
+    ordinaryMultipleSurgeryContext?: boolean;
+};
+type CaFeeCitation = {
+    id: string;
+    url: string;
+    sha256?: string;
+    effectiveFrom?: string;
+    effectiveThrough?: string;
+};
+type CaFeeCalculation = {
+    method: "rbrvs" | "therapy_mppr";
+    locality: string;
+    serviceZip?: string;
+    serviceCounty?: string;
+    setting: "facility" | "nonfacility";
+    units: number;
+    conversionFactor: string;
+    providerPercent: number;
+    baseMaximumCents?: number;
+    cmsIndicators?: Record<string, string>;
+    sourceFiles?: Array<{
+        kind: string;
+        filename: string;
+    }>;
+    components: Array<{
+        name: string;
+        rvu: string;
+        gpci: string;
+        payableUnits: number;
+    }>;
+    rounding: string;
+};
+type CaClaimEditFinding = {
+    type: string;
+    lineIds: string[];
+    message: string;
+    citationUrl: string;
+    column1?: string;
+    column2?: string;
+    modifierIndicator?: number;
+    code?: string;
+    limit?: number;
+    submittedUnits?: number;
+    adjudicationIndicator?: number;
+    scope?: "line" | "patient_provider_date";
+};
+type CaClaimFeeFinding = {
+    code: string;
+    lineIds: string[];
+    message: string;
+    citationUrl?: string;
+    edit?: CaClaimEditFinding;
+};
+type CaClaimLineQuote = ({
+    status: "priced";
+    amountCents: number;
+    scheduleMaximumCents: number;
+    basis: BillFeeQuoteBasis | "ca_ambulance";
+    notes: string[];
+    feeBreakdown?: {
+        method: string;
+        inputs: Array<{
+            label: string;
+            value: string;
+        }>;
+        steps: Array<{
+            label: string;
+            value: string;
+        }>;
+    };
+} | {
+    status: "requires_review" | "not_separately_payable";
+    reason: string;
+}) & {
+    provenance: CaFeeCitation[];
+    calculation?: CaFeeCalculation;
+};
+type CaClaimFeeQuoteResult = {
+    status: "priced" | "requires_review" | "not_separately_payable";
+    lines: Array<{
+        id: string;
+        input: CaClaimFeeQuoteInput["lines"][number];
+        quote: CaClaimLineQuote;
+        assessment: CaClaimFeeQuoteResult["status"];
+        findings: CaClaimFeeFinding[];
+        paymentAdjustment?: {
+            rule: "ca_multiple_surgery";
+            rank: number;
+            percent: 100 | 50;
+            unadjustedScheduleMaximumCents: number;
+            scheduleMaximumCents: number;
+            amountCents: number;
+            citationUrl: string;
+        };
+    }>;
+    totals: {
+        submittedChargeCents: number | null;
+        pricedSubtotalCents: number;
+        estimatedPayableCents: number | null;
+        scheduleMaximumCents: number | null;
+        reviewLineCount: number;
+    };
+    claimEdits: Array<{
+        dateOfService: string;
+        lineIds: string[];
+        status: "evaluated" | "requires_review" | "source_unavailable" | "not_applicable";
+        reason?: string;
+        findings: CaClaimEditFinding[];
+        provenance?: unknown;
+        supportedDateRange?: {
+            from: string;
+            through: string;
+        };
+        supportedDateIntervals?: Array<{
+            from: string;
+            through: string;
+        }>;
+    }>;
+    limitations: string[];
+};
+
+type RfaAuthorizationDestinationOption = {
+    method: "fax" | "email";
+    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;
+/** Returns choices only. Selecting or transmitting a destination is a separate user action. */
+declare function rfaAuthorizationDestinations(directory: BillClaimsAdministratorDirectory | null): RfaAuthorizationDestinationOption[];
+declare function rfaAuthorizationGuidance(directory: BillClaimsAdministratorDirectory | null): string;
+
+type CorrectionDraft = {
+    correctBilling: boolean;
+    units: string;
+    modifiers: string;
+    charge: string;
+    chargeReviewed: boolean;
+};
+declare function parseSecondReviewCorrection(draft: CorrectionDraft): SecondReviewLineInput["correction"];
+
 type ReportAutofillField = {
     key: string;
     value: string;
@@ -1931,6 +1952,7 @@ type RfaDeliveryPreviewInput = {
     documentIds: string[];
     channel: "fax" | "email" | "download";
     to?: string;
+    recipientName?: string;
     message?: string;
 };
 type RfaDeliveryPreview = {
@@ -1941,6 +1963,7 @@ type RfaDeliveryPreview = {
 type RfaSubmitInput = Omit<RfaDeliveryPreview, "contentRevision"> & {
     channel: "fax" | "email";
     to: string;
+    recipientName?: string;
     message?: string;
     nonBusinessDates?: string[];
 };
@@ -2001,6 +2024,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;
@@ -2045,6 +2070,7 @@ type RfaRecord = {
         units: number | null;
         authorizationNumber: string | null;
         decisionReason: string | null;
+        decisionClosure?: RfaTreatmentClosure | null;
         currentDecisionEventId?: string | null;
         currentResponseDocumentId?: string | null;
         currentImrDocumentId?: string | null;
@@ -2091,14 +2117,21 @@ type RfaRecord = {
         text?: string;
     }>;
 };
+type RfaAgingBucket = "0_5" | "6_14" | "15_30" | "31_plus";
+type RfaAgingSummary = {
+    byBucket: Record<RfaAgingBucket, number>;
+    byLifecycleStatus: Record<RfaLifecycleStatus, Record<RfaAgingBucket, number>>;
+};
 type RfaListQuery = {
+    agingBucket?: RfaAgingBucket;
     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;
@@ -2110,6 +2143,8 @@ type RfaListResult = {
     summary: {
         total: number;
         byStatus: Record<string, number>;
+        aging?: RfaAgingSummary;
+        byLifecycleStatus?: Partial<Record<RfaLifecycleStatus, number>>;
     };
 };
 type RfaSigningPreviewInput = {
@@ -2222,4 +2257,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 RfaInboundFax, type RfaInboundFaxMatch, 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 RfaAgingBucket, type RfaAgingSummary, 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 RfaTreatmentClosure, type RfaTreatmentClosureInput, 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 });
@@ -170,6 +170,12 @@ function createRfaLifecycleClient({ sessionEndpoint = "/api/mindbill/session", g
       if (!key.trim()) return Promise.reject(new Error("An idempotency key is required."));
       return readArray(path(id, `items/${encodeURIComponent(itemId)}/scheduling`), { method: "PATCH", headers: { "idempotency-key": key }, body: JSON.stringify(input) });
     },
+    updateTreatmentClosure: (id, itemId, input, key) => {
+      const reason = input.reason.trim();
+      if (!reason || reason.length > 2e3) return Promise.reject(new Error("Enter a reason of 1\u20132000 characters."));
+      if (!Number.isInteger(input.expectedVersion) || input.expectedVersion < 0) return Promise.reject(new Error("Refresh to load the current treatment version."));
+      return mutate(path(id, `items/${encodeURIComponent(itemId)}/closure`), { ...input, reason }, key, "PATCH");
+    },
     correctDecision: (id, input, key) => mutate(path(id, "decision-corrections"), input, key),
     listHistory: (id) => readArray(path(id, "events")),
     addNote: (id, text, key) => {
@@ -369,6 +375,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";
@@ -1326,6 +1358,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,
@@ -1340,6 +1373,7 @@ export {
   createRfaLifecycleClient,
   createRfaPacketsClient,
   defaultBillReviewPayerOption,
+  getRfaLifecycleStatus,
   normalizeRfaFax,
   organizationTaxIdWrite,
   parseSecondReviewCorrection,