@mindbill/react 0.8.0 → 0.9.0

package/dist/index.d.ts

@@ -227,6 +227,125 @@ 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;
+        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>;
+    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;
+    initialData?: BillLifecycleData | null;
+    onBillIdChange?: (billId: string, previousBillId: string) => void | Promise<void>;
+};
+type UseBillLifecycleResult = {
+    billId: string;
+    data: BillLifecycleData | null;
+    error: Error | null;
+    isLoading: boolean;
+    isRefreshing: boolean;
+    isMutating: boolean;
+    refresh: () => Promise<void>;
+    saveReview: BillLifecycleClient["saveReview"];
+    submitBill: BillLifecycleClient["submitBill"];
+    addAttachment: BillLifecycleClient["addAttachment"];
+    removeAttachment: BillLifecycleClient["removeAttachment"];
+    openAttachment: (attachment: BillReviewAttachment) => Promise<void>;
+    openEor: (document: BillEorDocument) => Promise<void>;
+    closeBill: BillLifecycleClient["closeBill"];
+    postPayment: BillLifecycleClient["postPayment"];
+    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?: MindBillAppearance;
+    className?: string;
+    style?: CSSProperties;
+    loadingFallback?: ReactNode;
+    errorFallback?: (error: Error, retry: () => Promise<void>) => ReactNode;
+    onChanged?: (data: BillLifecycleData) => void;
+};
+declare function ConnectedBillLifecycle({ appearance, className, style, loadingFallback, errorFallback, onChanged, ...options }: ConnectedBillLifecycleProps): ReactElement;
+
 type MindBillWidgetProps = {
     sessionToken: string;
     embedUrl: string;
@@ -247,4 +366,4 @@ declare const HostedBillFromReport: typeof MindBillBillFromReport;
 declare const HostedCollections: typeof MindBillCollections;
 declare const HostedOnboarding: typeof MindBillOnboarding;
 
-export { type BillReviewAttachment, type BillReviewBillingProvider, type BillReviewClinician, type BillReviewData, type BillReviewDocumentType, type BillReviewDraft, BillReviewForm, type BillReviewFormProps, type BillReviewLineItem, type BillReviewLocation, type BillReviewSaveInput, type BillStatusAction, type BillStatusClient, type BillStatusClientOptions, type BillStatusData, type BillStatusSession, type BillStatusSessionProvider, type BillStatusSessionRequest, BillStatusSummary, type BillStatusSummaryProps, type BillSubmissionRoute, ConnectedBillStatus, type ConnectedBillStatusProps, HostedBillFromReport, HostedBillReview, HostedBillTimeline, HostedCollections, HostedOnboarding, MindBillBillFromReport, MindBillBillReview, MindBillBillTimeline, MindBillCollections, MindBillOnboarding, type MindBillWidgetProps, type UseBillStatusOptions, type UseBillStatusResult, buildBillReviewSaveInput, createBillStatusClient, 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, BillReviewForm, type BillReviewFormProps, type BillReviewLineItem, type BillReviewLocation, 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 };