@npm-zenwork/tax-remittance-ui 0.1.8 → 0.1.10

package/dist/api/client.d.ts

@@ -1,6 +1,7 @@
 type RequestOptions = Omit<RequestInit, 'body'> & {
     body?: unknown;
     auth?: boolean;
+    responseType?: 'json' | 'blob' | 'text';
 };
 export declare function apiRequest<T>(path: string, options?: RequestOptions): Promise<T>;
 export declare function apiData<T>(path: string, options?: RequestOptions): Promise<T>;

package/dist/api/paymentPdf.d.ts

@@ -0,0 +1,4 @@
+export declare function fetchFederalPaymentPdf(federalPaymentId: number): Promise<Blob>;
+export declare function fetchStatePaymentPdf(statePaymentDetailId: number): Promise<Blob>;
+export declare function fetchFederalPaymentPdfHtml(federalPaymentId: number): Promise<string>;
+export declare function fetchStatePaymentPdfHtml(statePaymentDetailId: number): Promise<string>;

package/dist/api/paymentTransactions.d.ts

@@ -0,0 +1,2 @@
+import { GovPayTransaction } from '../types/paymentHistory';
+export declare function getPaymentTransactions(): Promise<GovPayTransaction[]>;

package/dist/components/payments/PaymentRowActions.d.ts

@@ -2,10 +2,12 @@ import { PaymentActionType } from './paymentsTableConfig';
 interface PaymentRowActionsProps {
     actionType: PaymentActionType;
     onView?: () => void;
+    onViewPdf?: () => void;
     onEdit?: () => void;
     onSubmit?: () => void;
     isSubmitting?: boolean;
+    isViewPdfLoading?: boolean;
 }
 /** Row actions per tab — used when payment list API is wired. */
-export declare function PaymentRowActions({ actionType, onView, onEdit, onSubmit, isSubmitting, }: PaymentRowActionsProps): import("react").JSX.Element;
+export declare function PaymentRowActions({ actionType, onView, onViewPdf, onEdit, onSubmit, isSubmitting, isViewPdfLoading, }: PaymentRowActionsProps): import("react").JSX.Element;
 export {};

package/dist/components/pdf/PaymentPdfModal.d.ts

@@ -0,0 +1,12 @@
+interface PaymentPdfModalProps {
+    open: boolean;
+    title: string;
+    html: string | null;
+    isLoading?: boolean;
+    error?: string | null;
+    downloadFileName?: string;
+    onDownload?: () => Promise<Blob>;
+    onClose: () => void;
+}
+export declare function PaymentPdfModal({ open, title, html, isLoading, error, downloadFileName, onDownload, onClose, }: PaymentPdfModalProps): import("react").JSX.Element | null;
+export {};

package/dist/embedded/EmbeddedContext.d.ts

@@ -1,5 +1,6 @@
 import { ReactNode } from 'react';
 import { EntityDetailsResponse } from '../types/entity';
+import { PaymentRequiredInfo } from './TaxRemittanceEmbedded';
 export type PaymentType = 'federal' | 'state';
 interface EmbeddedContextValue {
     entities: EntityDetailsResponse[];
@@ -9,12 +10,14 @@ interface EmbeddedContextValue {
     setSelectedEntityId: (id: number) => void;
     refetchEntities: () => Promise<void>;
     enabledPayments: PaymentType[];
+    onPaymentRequired?: (info: PaymentRequiredInfo) => void;
 }
 interface EmbeddedContextProviderProps {
     onOrganizationCreated?: (org: EntityDetailsResponse) => void;
     enabledPayments?: PaymentType[];
+    onPaymentRequired?: (info: PaymentRequiredInfo) => void;
     children: ReactNode;
 }
-export declare function EmbeddedContextProvider({ onOrganizationCreated, enabledPayments, children, }: EmbeddedContextProviderProps): import("react").JSX.Element;
+export declare function EmbeddedContextProvider({ onOrganizationCreated, enabledPayments, onPaymentRequired, children, }: EmbeddedContextProviderProps): import("react").JSX.Element;
 export declare function useEmbeddedContext(): EmbeddedContextValue;
 export {};

package/dist/embedded/EmbeddedWidgetBase.d.ts

@@ -1,7 +1,7 @@
 import { MutableRefObject, ReactNode } from 'react';
 import { PaymentType } from './EmbeddedContext';
 import { TaxRemittanceTheme } from './ThemeProvider';
-import { EmbeddedRouteKey } from './TaxRemittanceEmbedded';
+import { EmbeddedRouteKey, PaymentRequiredInfo } from './TaxRemittanceEmbedded';
 import { EntityDetailsResponse } from '../types/entity';
 export type { TaxRemittanceTheme };
 export interface EmbeddedWidgetBaseProps {
@@ -12,6 +12,7 @@ export interface EmbeddedWidgetBaseProps {
     onSessionExpired?: () => void;
     onOrganizationCreated?: (org: EntityDetailsResponse) => void;
     onNavigate?: (routeKey: EmbeddedRouteKey, pathname: string) => void;
+    onPaymentRequired?: (info: PaymentRequiredInfo) => void;
     navigateFnRef: MutableRefObject<((path: string) => void) | null>;
     selectEntityFnRef: MutableRefObject<((id: number) => void) | null>;
     /** Payment types this widget instance supports. Controls which dashboard action cards appear. */
@@ -29,4 +30,4 @@ export interface EmbeddedWidgetBaseProps {
  *
  * Children should be a <Routes> element with the widget-specific route tree.
  */
-export declare function EmbeddedWidgetBase({ appKey, accessToken, apiBaseUrl, theme, onSessionExpired, onOrganizationCreated, onNavigate, navigateFnRef, selectEntityFnRef, enabledPayments, children, }: EmbeddedWidgetBaseProps): import("react").JSX.Element;
+export declare function EmbeddedWidgetBase({ appKey, accessToken, apiBaseUrl, theme, onSessionExpired, onOrganizationCreated, onNavigate, onPaymentRequired, navigateFnRef, selectEntityFnRef, enabledPayments, children, }: EmbeddedWidgetBaseProps): import("react").JSX.Element;

package/dist/embedded/TaxRemittanceEmbedded.d.ts

@@ -1,6 +1,20 @@
 import { TaxRemittanceTheme } from './EmbeddedWidgetBase';
 import { EntityDetailsResponse } from '../types/entity';
 export type { TaxRemittanceTheme };
+/**
+ * Payload emitted via `onPaymentRequired` when the backend returns a 402.
+ * Contains enough information for the host to render a payment UI.
+ */
+export interface PaymentRequiredInfo {
+    paymentType: 'federal' | 'state';
+    paymentId: number;
+    expectedAmount: string;
+    currency: string;
+    federalRecordCount: number;
+    stateRecordCount: number;
+    feePerFederal: string | null;
+    feePerState: string | null;
+}
 /**
  * The top-level section the widget is currently showing.
  * Returned by `onNavigate` so the host can highlight the correct sidebar item.
@@ -19,6 +33,11 @@ export interface TaxRemittanceEmbeddedHandle {
     navigate: (path: string) => void;
     /** Switch the active entity context inside the widget. */
     selectEntity: (id: number) => void;
+    /**
+     * Call this after the host completes payment (Stripe charge succeeded + schedule-after-payment called).
+     * Invalidates the payment list so the widget refreshes from Scheduled status.
+     */
+    notifyPaymentComplete: (paymentId: number) => void;
 }
 export interface TaxRemittanceEmbeddedProps {
     /**
@@ -51,6 +70,12 @@ export interface TaxRemittanceEmbeddedProps {
      * Use this to keep the host app's sidebar selection in sync with the widget.
      */
     onNavigate?: (routeKey: EmbeddedRouteKey, pathname: string) => void;
+    /**
+     * Called when the backend returns 402 Payment Required for a submission.
+     * The host should show a payment UI and call `widgetRef.current?.notifyPaymentComplete(paymentId)`
+     * after the payment succeeds and schedule-after-payment has been called.
+     */
+    onPaymentRequired?: (info: PaymentRequiredInfo) => void;
 }
 /**
  * Full embedded widget — all sections (dashboard, payments, tax forms, settings).
@@ -59,4 +84,5 @@ export interface TaxRemittanceEmbeddedProps {
  *   - FederalPaymentWidget — federal payments + dashboard + settings
  *   - StatePaymentWidget   — state payments + dashboard + settings
  */
+export declare const PAYMENT_COMPLETE_EVENT = "tax-remittance:payment-complete";
 export declare const TaxRemittanceEmbedded: import('react').ForwardRefExoticComponent<TaxRemittanceEmbeddedProps & import('react').RefAttributes<TaxRemittanceEmbeddedHandle>>;