@npm-zenwork/tax-remittance-ui 0.1.2 → 0.1.4

package/dist/api/bankAccounts.d.ts

@@ -1,4 +1,5 @@
 import { BankAccountResponse } from '../types/bankAccount';
-import { CreateBankAccountRequest } from '../types/createBankAccount';
+import { CreateBankAccountRequest, UpdateBankAccountRequest } from '../types/createBankAccount';
 export declare function getBankAccounts(entityId: number): Promise<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,4 +1,4 @@
-import { CreateEntityDetailsRequest, EntityDetailsResponse } from '../types/entity';
+import { CreateEntityDetailsRequest, EntityDetailsResponse, UpdateEntityDetailsRequest } from '../types/entity';
 interface CreateEntityDetailsResponse {
     entityId: number;
     userId: number | null;
@@ -7,4 +7,5 @@ interface CreateEntityDetailsResponse {
 }
 export declare function getMyEntities(): Promise<EntityDetailsResponse[]>;
 export declare function createEntity(request: CreateEntityDetailsRequest): Promise<CreateEntityDetailsResponse>;
+export declare function updateEntity(entityId: number, request: UpdateEntityDetailsRequest): Promise<EntityDetailsResponse>;
 export {};

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

@@ -0,0 +1,12 @@
+interface FederalAmountInputProps {
+    value: string;
+    onChange: (value: string) => void;
+    onBlur?: () => void;
+    name?: string;
+    disabled?: boolean;
+    readOnly?: boolean;
+    placeholder?: string;
+    hasError?: boolean;
+}
+export declare function FederalAmountInput({ value, onChange, onBlur, name, disabled, readOnly, placeholder, hasError, }: FederalAmountInputProps): import("react").JSX.Element;
+export {};

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

@@ -3,15 +3,17 @@ interface PaymentFieldLabelProps {
     label: string;
     required?: boolean;
     htmlFor?: string;
+    info?: string;
 }
-export declare function PaymentFieldLabel({ label, required, htmlFor }: PaymentFieldLabelProps): import("react").JSX.Element;
+export declare function PaymentFieldLabel({ label, required, htmlFor, info }: PaymentFieldLabelProps): import("react").JSX.Element;
 interface PaymentFieldProps {
     label: string;
     required?: boolean;
     error?: string;
+    info?: string;
     children: ReactNode;
 }
-export declare function PaymentField({ label, required, error, children }: PaymentFieldProps): import("react").JSX.Element;
+export declare function PaymentField({ label, required, error, info, children }: PaymentFieldProps): import("react").JSX.Element;
 export declare function paymentInputClass(hasError?: boolean, readOnly?: boolean): string;
 export declare function paymentSelectClass(hasError?: boolean): string;
 declare function ChevronDownIcon({ className }: {

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

@@ -3,6 +3,7 @@ interface PaymentFormSectionProps {
     title: string;
     children: ReactNode;
     isFirst?: boolean;
+    headerAction?: ReactNode;
 }
-export declare function PaymentFormSection({ title, children, isFirst }: PaymentFormSectionProps): import("react").JSX.Element;
+export declare function PaymentFormSection({ title, children, isFirst, headerAction, }: PaymentFormSectionProps): import("react").JSX.Element;
 export {};

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

@@ -6,6 +6,8 @@ interface SignatureFieldGroupProps {
     title: UseFormRegisterReturn;
     date: UseFormRegisterReturn;
     signatureValue: string;
+    dateValue?: string;
+    dateReadOnly?: boolean;
     errors?: {
         signature?: string;
         title?: string;
@@ -13,5 +15,5 @@ interface SignatureFieldGroupProps {
     };
     signatureCaption?: string;
 }
-export declare function SignatureFieldGroup({ label, required, signature, title, date, signatureValue, errors, signatureCaption, }: SignatureFieldGroupProps): import("react").JSX.Element;
+export declare function SignatureFieldGroup({ label, required, signature, title, date, signatureValue, dateValue, dateReadOnly, errors, signatureCaption, }: SignatureFieldGroupProps): import("react").JSX.Element;
 export {};

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

@@ -1,3 +1,4 @@
 export declare const disclosureAuthorizationAgreementOne = "I hereby authorize the contact person listed in item 5 on this form, and the financial institution(s) listed in items 9-11 on this form, to process EFTPS payments and to receive confidential information for enrollment purposes, to answer inquiries regarding my account, and to resolve any issues that may arise. This authorization includes passwords, payment instructions, taxpayer names, and identifying numbers.";
 export declare const disclosureAuthorizationAgreementTwo = "By completing the financial institution information in items 9-11 on this form, I authorize the designated Financial Agents of the U.S. Treasury to initiate EFTPS debit entries to my financial institution account for federal tax payments. All debits will be made in accordance with U.S. Treasury regulations. This authorization remains in effect until written notification of termination is received and the Financial Agent has had a reasonable opportunity to act on it.";
 export declare const authorityToExecuteAgreement = "Under penalties of perjury, I certify that I have the authority to sign this authorization on behalf of the taxpayer. If I am a corporate officer, partner, guardian, executor, receiver, administrator, trustee, or other party, I certify that I have the authority to execute this authorization on behalf of the taxpayer. If I am a tax practitioner, I certify that Form 2848 or Form 8655 is on file with the IRS.";
+export declare const agiTaxYearOptions: string[];

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

@@ -11,7 +11,10 @@ export declare const SUBCATEGORY_CODE_LABELS: {
     readonly tier1: "Tier 1(FICA)";
     readonly tier2: "Tier 2 (Industry)";
 };
-export declare const AMOUNT_FIELD_ERROR_MESSAGE = "Payment amount must be a number greater than 0, can include up to 2 decimal places, and must not exceed 100,000,000.";
+export declare const AMOUNT_FIELD_VALIDATION: {
+    readonly regex: RegExp;
+    readonly errorMessage: "Payment amount must be a number greater than 0, can include up to 2 decimal places, and must not exceed 100,000,000 (one hundred million).";
+};
 export declare function isSubcategoryFieldsActive(taxFormType: string, taxTypeCode: string): boolean;
 export declare function isCt1SubcategoryFieldsActive(taxFormType: string, taxTypeCode: string): boolean;
 export declare function is941Or944SubcategoryMode(taxFormType: string, taxTypeCode: string): boolean;
@@ -21,6 +24,7 @@ export declare function getSubcategoryCodeLabels(taxFormType: string): {
     code3: string;
 };
 export declare function isValidAmountField(value: string): boolean;
+export declare function sanitizeFederalAmountInput(raw: string): string;
 export declare function parseAmountField(value: string): number | null;
 export declare function sumSubcategoryAmounts(amount1: string, amount2: string, amount3: string, includeAmount3: boolean): number;
 export declare function amountsEqual(left: number, right: number): boolean;

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

@@ -1,3 +1,5 @@
 export declare const authorizationTaxForms: readonly ["720", "940", "941", "943", "944", "945", "990-PF", "990-T", "1041", "1042", "1120", "CT-1", "Other"];
+export type AuthorizationTaxForm = (typeof authorizationTaxForms)[number];
+export declare function resolveAuthorizedTaxForm(taxFormType: string): AuthorizationTaxForm;
 export declare const authorizationAgreementLead = "I understand that this agreement does not relieve me, as the taxpayer, of the responsibility to ensure that all tax returns are filed and that all deposits and payments are made and that I may enroll in the Electronic Federal Tax Payment System (EFTPS) to view deposits and payments made on my behalf.";
 export declare const authorizationAgreementBody = "I further understand that this agreement does not authorize the reporting agent to sign any tax returns, to otherwise act as a legal representative of the taxpayer, or to represent the taxpayer before the IRS. I also understand that the reporting agent is not responsible for any penalties or interest that may be assessed against the taxpayer. I authorize the reporting agent to complete Form 8655, Reporting Agent Authorization, and to make deposits and payments on my behalf for the tax return(s) indicated above. I also authorize the reporting agent to receive confidential information and to perform acts as specified on Form 2848, Power of Attorney and Declaration of Representative, or Form 8821, Tax Information Authorization, as applicable.";

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

@@ -5,6 +5,9 @@ export declare function parseDateString(value: string): Date | null;
 export declare function getMinSettlementDate(reference?: Date): string;
 /** Latest selectable date: one year from today (Tax1099). */
 export declare function getMaxSettlementDate(reference?: Date): string;
+/** Latest selectable date of birth for a minimum age (inclusive). */
+export declare function getMaxDateOfBirth(minimumAge?: number, reference?: Date): string;
+export declare function isAtLeastAge(value: string, minimumAge: number, reference?: Date): boolean;
 export declare function isWeekday(date: Date): boolean;
 export declare function isSettlementDateSelectable(date: Date, reference?: Date): boolean;
 export declare function isValidSettlementDate(value: string, reference?: Date): boolean;

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

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+declare const taxAccountSchema: z.ZodObject<{
+    state: z.ZodString;
+    city: z.ZodString;
+    zipCode: z.ZodString;
+    address1: z.ZodString;
+    address2: z.ZodOptional<z.ZodString>;
+    virginiaTaxAccountId: z.ZodOptional<z.ZodString>;
+    virginiaWithholdingAccountingId: z.ZodOptional<z.ZodString>;
+    unemploymentTaxAccountId: z.ZodOptional<z.ZodString>;
+    virginiaDepartmentOfTaxationClientNumber: z.ZodOptional<z.ZodString>;
+    businessLocationCode: z.ZodOptional<z.ZodString>;
+    franchiseTaxAccount: z.ZodOptional<z.ZodString>;
+    transientOccupancyTaxAccountId: z.ZodOptional<z.ZodString>;
+    certificateOfAuthorityNumber: z.ZodOptional<z.ZodString>;
+    licensedProfessionalEmployerEntityNumber: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type TaxAccountFormValues = z.infer<typeof taxAccountSchema>;
+interface AddTaxAccountFormProps {
+    onCancel: () => void;
+    onSuccess?: (values: TaxAccountFormValues) => void;
+}
+export declare function AddTaxAccountForm({ onCancel, onSuccess }: AddTaxAccountFormProps): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,8 @@
+import { BankAccountResponse } from '../../types/bankAccount';
+interface BankAccountActionsMenuProps {
+    account: BankAccountResponse;
+    entityId: number;
+    onEdit: (account: BankAccountResponse) => void;
+}
+export declare function BankAccountActionsMenu({ account, entityId, onEdit }: BankAccountActionsMenuProps): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,8 @@
+import { BankAccountResponse } from '../../types/bankAccount';
+interface EditBankAccountModalProps {
+    open: boolean;
+    account: BankAccountResponse | null;
+    onClose: () => void;
+}
+export declare function EditBankAccountModal({ open, account, onClose }: EditBankAccountModalProps): import('react').ReactPortal | null;
+export {};

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

@@ -0,0 +1,8 @@
+import { EntityDetailsResponse } from '../../types/entity';
+interface EditEntityModalProps {
+    open: boolean;
+    entity: EntityDetailsResponse;
+    onClose: () => void;
+}
+export declare function EditEntityModal({ open, entity, onClose }: EditEntityModalProps): import('react').ReactPortal | null;
+export {};

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

@@ -0,0 +1,6 @@
+import { EntityDetailsResponse } from '../../types/entity';
+interface EntityDetailsSectionProps {
+    entity: EntityDetailsResponse | null;
+}
+export declare function EntityDetailsSection({ entity }: EntityDetailsSectionProps): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,44 @@
+export declare const virginiaCities: readonly ["Alexandria", "Arlington", "Chesapeake", "Hampton", "Lynchburg", "Newport News", "Norfolk", "Richmond", "Roanoke", "Virginia Beach"];
+export declare const taxAccountStates: {
+    code: string;
+    name: string;
+}[];
+export declare const virginiaSpecificFields: readonly [{
+    readonly name: "virginiaTaxAccountId";
+    readonly label: "Virginia Tax Account ID";
+    readonly required: true;
+}, {
+    readonly name: "virginiaWithholdingAccountingId";
+    readonly label: "Virginia Withholding Accounting ID";
+    readonly required: true;
+}, {
+    readonly name: "unemploymentTaxAccountId";
+    readonly label: "Unemployment Tax Account ID";
+    readonly required: true;
+}, {
+    readonly name: "virginiaDepartmentOfTaxationClientNumber";
+    readonly label: "Virginia Department of Taxation Client Number";
+    readonly required: true;
+}, {
+    readonly name: "businessLocationCode";
+    readonly label: "Business Location Code";
+    readonly required: true;
+}, {
+    readonly name: "franchiseTaxAccount";
+    readonly label: "Franchise Tax Account";
+    readonly required: true;
+}, {
+    readonly name: "transientOccupancyTaxAccountId";
+    readonly label: "Transient Occupancy Tax Account ID";
+    readonly required: false;
+}, {
+    readonly name: "certificateOfAuthorityNumber";
+    readonly label: "Certificate of Authority Number (Foreign Entities)";
+    readonly required: false;
+}];
+export declare const virginiaFullWidthFields: readonly [{
+    readonly name: "licensedProfessionalEmployerEntityNumber";
+    readonly label: "Licensed Professional Employer (POE) Entity Number";
+    readonly required: false;
+}];
+export type VirginiaSpecificFieldName = (typeof virginiaSpecificFields)[number]['name'] | (typeof virginiaFullWidthFields)[number]['name'];

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

@@ -0,0 +1,10 @@
+import { ReactNode } from 'react';
+interface ToastContextValue {
+    showSuccess: (title: string, message: string) => void;
+    showError: (title: string, message: string) => void;
+}
+export declare function ToastProvider({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useToast(): ToastContextValue;
+export {};

package/dist/embedded/EmbeddedContext.d.ts

@@ -1,5 +1,6 @@
 import { ReactNode } from 'react';
 import { EntityDetailsResponse } from '../types/entity';
+export type PaymentType = 'federal' | 'state';
 interface EmbeddedContextValue {
     entities: EntityDetailsResponse[];
     isLoading: boolean;
@@ -7,11 +8,13 @@ interface EmbeddedContextValue {
     selectedEntity: EntityDetailsResponse | null;
     setSelectedEntityId: (id: number) => void;
     refetchEntities: () => Promise<void>;
+    enabledPayments: PaymentType[];
 }
 interface EmbeddedContextProviderProps {
     onOrganizationCreated?: (org: EntityDetailsResponse) => void;
+    enabledPayments?: PaymentType[];
     children: ReactNode;
 }
-export declare function EmbeddedContextProvider({ onOrganizationCreated, children, }: EmbeddedContextProviderProps): import("react").JSX.Element;
+export declare function EmbeddedContextProvider({ onOrganizationCreated, enabledPayments, children, }: EmbeddedContextProviderProps): import("react").JSX.Element;
 export declare function useEmbeddedContext(): EmbeddedContextValue;
 export {};

package/dist/embedded/EmbeddedWidgetBase.d.ts

@@ -1,4 +1,5 @@
 import { MutableRefObject, ReactNode } from 'react';
+import { PaymentType } from './EmbeddedContext';
 import { TaxRemittanceTheme } from './ThemeProvider';
 import { EmbeddedRouteKey } from './TaxRemittanceEmbedded';
 import { EntityDetailsResponse } from '../types/entity';
@@ -13,6 +14,8 @@ export interface EmbeddedWidgetBaseProps {
     onNavigate?: (routeKey: EmbeddedRouteKey, pathname: string) => 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. */
+    enabledPayments?: PaymentType[];
     /** The <Routes> subtree specific to this widget. */
     children: ReactNode;
 }
@@ -26,4 +29,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, children, }: EmbeddedWidgetBaseProps): import("react").JSX.Element;
+export declare function EmbeddedWidgetBase({ appKey, accessToken, apiBaseUrl, theme, onSessionExpired, onOrganizationCreated, onNavigate, navigateFnRef, selectEntityFnRef, enabledPayments, children, }: EmbeddedWidgetBaseProps): import("react").JSX.Element;

package/dist/embedded/pages/EmbeddedEntityListPage.d.ts

@@ -0,0 +1 @@
+export declare function EmbeddedEntityListPage(): import("react").JSX.Element;