@npm-zenwork/tax-remittance-ui 0.1.11 → 0.1.13

package/dist/api/bankAccounts.d.ts

@@ -1,5 +1,11 @@
 import { BankAccountResponse } from '../types/bankAccount';
 import { CreateBankAccountRequest, UpdateBankAccountRequest } from '../types/createBankAccount';
-export declare function getBankAccounts(entityId: number): Promise<BankAccountResponse[]>;
+import { PagedResult } from '../types/pagination';
+export interface GetBankAccountsQuery {
+    entityId: number;
+    pageNumber?: number;
+    pageSize?: number;
+}
+export declare function getBankAccounts({ entityId, pageNumber, pageSize, }: GetBankAccountsQuery): Promise<PagedResult<BankAccountResponse>>;
 export declare function createBankAccount(request: CreateBankAccountRequest): Promise<BankAccountResponse>;
 export declare function updateBankAccount(bankAccountDetailId: number, request: UpdateBankAccountRequest): Promise<BankAccountResponse>;

package/dist/api/entities.d.ts

@@ -1,11 +1,17 @@
 import { CreateEntityDetailsRequest, EntityDetailsResponse, UpdateEntityDetailsRequest } from '../types/entity';
+import { PagedResult } from '../types/pagination';
 interface CreateEntityDetailsResponse {
     entityId: number;
     userId: number | null;
     apiClientId: number | null;
     status: string;
 }
-export declare function getMyEntities(): Promise<EntityDetailsResponse[]>;
+export interface GetMyEntitiesQuery {
+    search?: string;
+    pageNumber?: number;
+    pageSize?: number;
+}
+export declare function getMyEntities({ search, pageNumber, pageSize, }?: GetMyEntitiesQuery): Promise<PagedResult<EntityDetailsResponse>>;
 export declare function createEntity(request: CreateEntityDetailsRequest): Promise<CreateEntityDetailsResponse>;
 export declare function updateEntity(entityId: number, request: UpdateEntityDetailsRequest): Promise<EntityDetailsResponse>;
 export {};

package/dist/api/federalPayments.d.ts

@@ -1,5 +1,21 @@
 import { CreateFederalPaymentRequest, FederalPaymentResponse, FederalTaxFormOption, FederalTaxTypeCodeOption, UpdateFederalPaymentRequest } from '../types/federalPayment';
-export declare function getFederalPayments(entityId: number): Promise<FederalPaymentResponse[]>;
+import { PagedResult } from '../types/pagination';
+import { PaymentStatus } from '../components/payments/paymentsTableConfig';
+export interface FederalPaymentStatusCounts {
+    drafts: number;
+    scheduled: number;
+    submitted: number;
+    rejected: number;
+    paid: number;
+}
+export interface GetFederalPaymentsQuery {
+    entityId: number;
+    status?: PaymentStatus | string;
+    pageNumber?: number;
+    pageSize?: number;
+}
+export declare function getFederalPayments({ entityId, status, pageNumber, pageSize, }: GetFederalPaymentsQuery): Promise<PagedResult<FederalPaymentResponse>>;
+export declare function getFederalPaymentStatusCounts(entityId: number): Promise<FederalPaymentStatusCounts>;
 export declare function getFederalPaymentById(federalPaymentId: number): Promise<FederalPaymentResponse>;
 export declare function getFederalFormTypes(entityId: number): Promise<FederalTaxFormOption[]>;
 export declare function getFederalTaxTypeCodes(formType: string): Promise<FederalTaxTypeCodeOption[]>;

package/dist/api/paymentTransactions.d.ts

@@ -1,2 +1,7 @@
 import { GovPayTransaction } from '../types/paymentHistory';
-export declare function getPaymentTransactions(): Promise<GovPayTransaction[]>;
+import { PagedResult } from '../types/pagination';
+export interface GetPaymentTransactionsQuery {
+    pageNumber?: number;
+    pageSize?: number;
+}
+export declare function getPaymentTransactions({ pageNumber, pageSize, }?: GetPaymentTransactionsQuery): Promise<PagedResult<GovPayTransaction>>;

package/dist/api/remittancePayments.d.ts

@@ -0,0 +1,30 @@
+import { PaymentStatus } from '../components/payments/paymentsTableConfig';
+import { PagedResult } from '../types/pagination';
+export type RemittancePaymentCategory = 'all' | 'federal' | 'state';
+export interface RemittancePaymentResponse {
+    id: number;
+    category: 'federal' | 'state';
+    referenceNumber: string | null;
+    jurisdiction: string;
+    taxPeriod: string;
+    amount: number;
+    paymentDate: string;
+    status: string | null;
+    reason: string | null;
+}
+export interface RemittancePaymentStatusCounts {
+    drafts: number;
+    scheduled: number;
+    submitted: number;
+    rejected: number;
+    paid: number;
+}
+export interface GetRemittancePaymentsQuery {
+    entityId: number;
+    status?: PaymentStatus | string;
+    category?: RemittancePaymentCategory;
+    pageNumber?: number;
+    pageSize?: number;
+}
+export declare function getRemittancePayments({ entityId, status, category, pageNumber, pageSize, }: GetRemittancePaymentsQuery): Promise<PagedResult<RemittancePaymentResponse>>;
+export declare function getRemittancePaymentStatusCounts(entityId: number, category?: RemittancePaymentCategory): Promise<RemittancePaymentStatusCounts>;

package/dist/api/statePayments.d.ts

@@ -1,8 +1,24 @@
 import { CreateStatePaymentRequest, StatePaymentFormMetadata, StatePaymentReasonOption, StatePaymentResponse, StatePaymentStateOption, UpdateStatePaymentRequest } from '../types/statePayment';
+import { PagedResult } from '../types/pagination';
+import { PaymentStatus } from '../components/payments/paymentsTableConfig';
+export interface StatePaymentStatusCounts {
+    drafts: number;
+    scheduled: number;
+    submitted: number;
+    rejected: number;
+    paid: number;
+}
+export interface GetStatePaymentsQuery {
+    entityId: number;
+    status?: PaymentStatus | string;
+    pageNumber?: number;
+    pageSize?: number;
+}
 export declare function getStatePaymentStates(signal?: AbortSignal): Promise<StatePaymentStateOption[]>;
 export declare function getStatePaymentReasons(entityId: number, state: string, signal?: AbortSignal): Promise<StatePaymentReasonOption[]>;
 export declare function getStatePaymentValidationMetadata(entityId: number, state: string, reason: string, signal?: AbortSignal): Promise<StatePaymentFormMetadata>;
-export declare function getStatePayments(entityId: number): Promise<StatePaymentResponse[]>;
+export declare function getStatePayments({ entityId, status, pageNumber, pageSize, }: GetStatePaymentsQuery): Promise<PagedResult<StatePaymentResponse>>;
+export declare function getStatePaymentStatusCounts(entityId: number): Promise<StatePaymentStatusCounts>;
 export declare function getStatePaymentById(statePaymentDetailId: number): Promise<StatePaymentResponse>;
 export declare function createStatePayment(request: CreateStatePaymentRequest): Promise<StatePaymentResponse>;
 export declare function updateStatePayment(statePaymentDetailId: number, request: UpdateStatePaymentRequest): Promise<StatePaymentResponse>;

package/dist/components/entities/EntityActionsMenu.d.ts

@@ -0,0 +1,7 @@
+import { EntityDetailsResponse } from '../../types/entity';
+interface EntityActionsMenuProps {
+    entity: EntityDetailsResponse;
+    onEdit: (entity: EntityDetailsResponse) => void;
+}
+export declare function EntityActionsMenu({ entity, onEdit }: EntityActionsMenuProps): import("react").JSX.Element;
+export {};

package/dist/components/entities/entityListUtils.d.ts

@@ -1,5 +1,13 @@
 import { EntityDetailsResponse } from '../../types/entity';
 export declare function formatEin(idNumber: string): string;
+export declare function formatSsn(idNumber: string): string;
+/** Format a stored 9-digit id for display: SSN for Individual, EIN otherwise. */
+export declare function formatIdNumber(idNumber: string, accountType: string): string;
+/**
+ * Format an id as the user types — strips non-digits, caps at 9 digits, and
+ * inserts dashes for the appropriate mask (SSN `XXX-XX-XXXX`, EIN `XX-XXXXXXX`).
+ */
+export declare function formatIdNumberInput(value: string, accountType: string): string;
 export declare function formatPhone(phoneNumber: string): string;
 export declare function formatJoinedDate(date: string): string;
 export declare function getJoinedYear(date: string): string;

package/dist/components/forms/StateSearchSelect.d.ts

@@ -0,0 +1,20 @@
+export interface StateOption {
+    code: string;
+    name: string;
+}
+interface StateSearchSelectProps {
+    label: string;
+    value: string;
+    onChange: (code: string) => void;
+    options: StateOption[];
+    required?: boolean;
+    disabled?: boolean;
+    error?: string;
+    placeholder?: string;
+}
+/**
+ * Searchable state dropdown — the same search-and-filter behavior as the state
+ * payment "Choose a State" picker, styled to sit inside a form as a field.
+ */
+export declare function StateSearchSelect({ label, value, onChange, options, required, disabled, error, placeholder, }: StateSearchSelectProps): import("react").JSX.Element;
+export {};

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

@@ -13,6 +13,18 @@ export interface RemittancePaymentRow {
     reason: string | null;
     tab: PaymentStatus;
 }
+export declare function formatTaxPeriod(taxPeriod: string): string;
+export declare function mapRemittancePaymentToRow(payment: {
+    id: number;
+    category: 'federal' | 'state';
+    referenceNumber: string | null;
+    jurisdiction: string;
+    taxPeriod: string;
+    amount: number;
+    paymentDate: string;
+    status: string | null;
+    reason: string | null;
+}): RemittancePaymentRow;
 export declare function mapFederalPaymentToRemittanceRow(payment: FederalPaymentResponse): RemittancePaymentRow;
 export declare function mapStatePaymentToRemittanceRow(payment: StatePaymentResponse): RemittancePaymentRow;
 export declare function filterRemittanceRows(rows: RemittancePaymentRow[], tab: PaymentStatus, paymentTypeFilter: string): RemittancePaymentRow[];

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

@@ -0,0 +1,47 @@
+/**
+ * Live input restrictions for the State ID field, derived from the backend
+ * validation-metadata regex (`stateId.pattern`). Mirrors the SSN/EIN entry
+ * restrictions on the entity form: strip characters that can never be valid,
+ * normalize case, and cap the length — without ever blocking a valid value.
+ *
+ * The catalog patterns only use digit runs (`\d{n}` / `\d{n,m}`), literal
+ * uppercase letters, letter classes (`[A-Z]`), and the separators `-`, ` `,
+ * and `/`. The helpers below understand exactly that subset.
+ */
+/**
+ * Sanitize a State ID as the user types: uppercase (validation uppercases
+ * anyway), then drop any character the selected state's format can't contain.
+ */
+export declare function sanitizeStateId(value: string, pattern: string | null | undefined): string;
+export type StateIdSlotKind = 'digit' | 'letter';
+export type StateIdMaskToken = {
+    type: 'slot';
+    kind: StateIdSlotKind;
+} | {
+    type: 'separator';
+    char: string;
+};
+/**
+ * Turn a linear metadata pattern into an ordered mask so separators (`-`, ` `,
+ * `/`) can be auto-inserted as the user types — e.g. `\d{2}-\d{7}` yields two
+ * digit slots, a `-`, then seven digit slots, so `121234567` displays as
+ * `12-1234567`.
+ *
+ * Returns `null` when the pattern isn't a single fixed layout — alternations
+ * (`(?:…|…)`) or variable runs (`{n,m}`) have no unambiguous mask, so the
+ * caller keeps the plain sanitize behavior instead.
+ */
+export declare function buildStateIdMask(pattern: string | null | undefined): StateIdMaskToken[] | null;
+/**
+ * Format a State ID against its mask as the user types: uppercase, keep only
+ * characters that fit each slot (in order), and auto-insert separators. A
+ * trailing separator isn't shown until the following slot has a character.
+ */
+export declare function formatStateId(value: string, tokens: StateIdMaskToken[]): string;
+/**
+ * Longest string the `pattern` can match — used as the input `maxLength` so the
+ * field can't accept more characters than any accepted format. Returns
+ * `undefined` when the pattern uses a construct these helpers don't model, so
+ * the caller simply omits the cap rather than risk blocking a valid value.
+ */
+export declare function maxStateIdLength(pattern: string | null | undefined): number | undefined;

package/dist/components/settings/PaymentHistorySection.d.ts

@@ -1,9 +1,5 @@
-import { PaymentHistoryResponse } from '../../types/paymentHistory';
 interface PaymentHistorySectionProps {
     entityId: number | null;
-    transactions?: PaymentHistoryResponse[];
-    isLoading?: boolean;
-    isError?: boolean;
 }
-export declare function PaymentHistorySection({ entityId, transactions, isLoading, isError, }: PaymentHistorySectionProps): import("react").JSX.Element;
+export declare function PaymentHistorySection({ entityId }: PaymentHistorySectionProps): import("react").JSX.Element;
 export {};

package/dist/components/ui/Pagination.d.ts

@@ -0,0 +1,11 @@
+export interface PaginationProps {
+    page: number;
+    pageSize: number;
+    totalCount: number;
+    onPageChange: (page: number) => void;
+    onPageSizeChange?: (pageSize: number) => void;
+    pageSizeOptions?: number[];
+    disabled?: boolean;
+    className?: string;
+}
+export declare function Pagination({ page, pageSize, totalCount, onPageChange, onPageSizeChange, pageSizeOptions, disabled, className, }: PaginationProps): import("react").JSX.Element | null;