@gusto/embedded-react-sdk 0.51.2 → 0.52.0

package/dist/models/external.d.ts

@@ -20,8 +20,8 @@ export type { Compensation } from '@gusto/embedded-api/models/components/compens
 export { PaymentUnit } from '@gusto/embedded-api/models/components/compensation';
 /** `ContractorPaymentMethod1` entity from the Gusto Embedded API. */
 export { ContractorPaymentMethod1 } from '@gusto/embedded-api/models/components/contractor';
-export type { Address, Contractor, ContractorMemberPortalInvitationStatus, UpcomingEmployment, } from '@gusto/embedded-api/models/components/contractor';
-export { ContractorOnboardingStatus1, ContractorStatus, ContractorType, WageType, } from '@gusto/embedded-api/models/components/contractor';
+export type { Address, Contractor, MemberPortalInvitationStatus, UpcomingEmployment, } from '@gusto/embedded-api/models/components/contractor';
+export { ContractorStatus, ContractorType, ContractorWageType, OnboardingStatus, } from '@gusto/embedded-api/models/components/contractor';
 /** `ContractorAddress` entity from the Gusto Embedded API. */
 export type { ContractorAddress } from '@gusto/embedded-api/models/components/contractoraddress';
 /** `ContractorBankAccount` entity from the Gusto Embedded API. */
@@ -32,13 +32,13 @@ export { ContractorCreateRequestBodyType, ContractorCreateRequestBodyWageType, }
 export type { ContractorPaymentForGroup } from '@gusto/embedded-api/models/components/contractorpaymentforgroup';
 export { ContractorPaymentForGroupPaymentMethod, ContractorPaymentForGroupStatus, ContractorPaymentForGroupWageType, } from '@gusto/embedded-api/models/components/contractorpaymentforgroup';
 export type { ContractorPaymentForGroupPreview } from '@gusto/embedded-api/models/components/contractorpaymentforgrouppreview';
-export { ContractorPaymentForGroupPreviewPaymentMethod, ContractorPaymentForGroupPreviewStatus, ContractorPaymentForGroupPreviewWageType, } from '@gusto/embedded-api/models/components/contractorpaymentforgrouppreview';
+export { ContractorPaymentForGroupPreviewPaymentMethod, ContractorPaymentForGroupPreviewStatus, WageType, } from '@gusto/embedded-api/models/components/contractorpaymentforgrouppreview';
 /** `ContractorPaymentGroupTotals` entity from the Gusto Embedded API. */
 export type { ContractorPaymentGroupTotals } from '@gusto/embedded-api/models/components/contractorpaymentgroup';
 export type { ContractorPaymentGroup } from '@gusto/embedded-api/models/components/contractorpaymentgroup';
 export { ContractorPaymentGroupStatus } from '@gusto/embedded-api/models/components/contractorpaymentgroup';
-/** `ContractorPaymentGroupPreviewTotals` entity from the Gusto Embedded API. */
-export type { ContractorPaymentGroupPreviewTotals } from '@gusto/embedded-api/models/components/contractorpaymentgrouppreview';
+/** `Totals` entity from the Gusto Embedded API. */
+export type { Totals } from '@gusto/embedded-api/models/components/contractorpaymentgrouppreview';
 export type { ContractorPaymentGroupPreview } from '@gusto/embedded-api/models/components/contractorpaymentgrouppreview';
 export { ContractorPaymentGroupPreviewStatus } from '@gusto/embedded-api/models/components/contractorpaymentgrouppreview';
 /** `ContractorPaymentGroupWithBlockersTotals` entity from the Gusto Embedded API. */
@@ -53,9 +53,9 @@ export { ContractorPaymentMethodSplitBy } from '@gusto/embedded-api/models/compo
 export { ContractorPaymentMethodType } from '@gusto/embedded-api/models/components/contractorpaymentmethod';
 /** `ContractorPaymentReceipt` entity from the Gusto Embedded API. */
 export type { ContractorPaymentReceipt } from '@gusto/embedded-api/models/components/contractorpaymentreceipt';
-/** `ContractorPayments` entity from the Gusto Embedded API. */
-export type { ContractorPayments } from '@gusto/embedded-api/models/components/contractorpaymentreceipt';
-export type { ContractorPaymentReceiptLicensee, ContractorPaymentReceiptTotals, } from '@gusto/embedded-api/models/components/contractorpaymentreceipt';
+/** `ContractorPaymentReceiptContractorPayments` entity from the Gusto Embedded API. */
+export type { ContractorPaymentReceiptContractorPayments } from '@gusto/embedded-api/models/components/contractorpaymentreceipt';
+export type { ContractorPaymentReceiptTotals, Licensee, } from '@gusto/embedded-api/models/components/contractorpaymentreceipt';
 export { ContractorPaymentReceiptPaymentMethod } from '@gusto/embedded-api/models/components/contractorpaymentreceipt';
 export type { ContractorUpdateRequestBody } from '@gusto/embedded-api/models/components/contractorupdaterequestbody';
 export { ContractorUpdateRequestBodyType, ContractorUpdateRequestBodyWageType, } from '@gusto/embedded-api/models/components/contractorupdaterequestbody';
@@ -66,7 +66,7 @@ export type { Document } from '@gusto/embedded-api/models/components/document';
 export type { Fields } from '@gusto/embedded-api/models/components/document';
 /** `Pages` entity from the Gusto Embedded API. */
 export type { Pages } from '@gusto/embedded-api/models/components/document';
-export { RecipientType } from '@gusto/embedded-api/models/components/document';
+export { DocumentRecipientType } from '@gusto/embedded-api/models/components/document';
 /** `DocumentSigned` entity from the Gusto Embedded API. */
 export type { DocumentSigned } from '@gusto/embedded-api/models/components/documentsigned';
 /** `DocumentSignedFields` entity from the Gusto Embedded API. */
@@ -74,11 +74,11 @@ export type { DocumentSignedFields } from '@gusto/embedded-api/models/components
 /** `DocumentSignedPages` entity from the Gusto Embedded API. */
 export type { DocumentSignedPages } from '@gusto/embedded-api/models/components/documentsigned';
 export { DocumentSignedRecipientType } from '@gusto/embedded-api/models/components/documentsigned';
-/** `EmployeeCurrentEmploymentStatus` entity from the Gusto Embedded API. */
-export { EmployeeCurrentEmploymentStatus } from '@gusto/embedded-api/models/components/employee';
+/** `CurrentEmploymentStatus` entity from the Gusto Embedded API. */
+export { CurrentEmploymentStatus } from '@gusto/embedded-api/models/components/employee';
 /** `EmployeeOnboardingStatus1` entity from the Gusto Embedded API. */
 export { EmployeeOnboardingStatus1 } from '@gusto/embedded-api/models/components/employee';
-export type { Employee, EmployeeMemberPortalInvitationStatus, EmployeeOnboardingDocumentsConfig, } from '@gusto/embedded-api/models/components/employee';
+export type { Employee, EmployeeMemberPortalInvitationStatus, OnboardingDocumentsConfig, } from '@gusto/embedded-api/models/components/employee';
 export { EmployeePaymentMethod1, EmployeeStatus, } from '@gusto/embedded-api/models/components/employee';
 /** `EmployeeAddress` entity from the Gusto Embedded API. */
 export type { EmployeeAddress } from '@gusto/embedded-api/models/components/employeeaddress';
@@ -89,9 +89,12 @@ export type { EmployeeCustomField } from '@gusto/embedded-api/models/components/
 export type { EmployeeFederalTax } from '@gusto/embedded-api/models/components/employeefederaltax';
 export type { EmployeeFederalTaxPre2020 } from '@gusto/embedded-api/models/components/employeefederaltaxpre2020';
 export type { EmployeeFederalTaxRev2020 } from '@gusto/embedded-api/models/components/employeefederaltaxrev2020';
+/** `Blockers` entity from the Gusto Embedded API. */
+export type { Blockers } from '@gusto/embedded-api/models/components/employeeonboardingstatus';
 /** `EmployeeOnboardingStatusOnboardingStep` entity from the Gusto Embedded API. */
 export type { EmployeeOnboardingStatusOnboardingStep } from '@gusto/embedded-api/models/components/employeeonboardingstatus';
 export type { EmployeeOnboardingStatus } from '@gusto/embedded-api/models/components/employeeonboardingstatus';
+export { EmployeeOnboardingStatusCategory, Field, } from '@gusto/embedded-api/models/components/employeeonboardingstatus';
 /** `EmployeePaymentMethod` entity from the Gusto Embedded API. */
 export type { EmployeePaymentMethod } from '@gusto/embedded-api/models/components/employeepaymentmethod';
 /** `EmployeePaymentMethodSplitBy` entity from the Gusto Embedded API. */
@@ -111,8 +114,8 @@ export type { Questions } from '@gusto/embedded-api/models/components/employeest
 export type { States } from '@gusto/embedded-api/models/components/employeestatetaxesrequest';
 /** `EmployeeStateTaxInputQuestionFormat` entity from the Gusto Embedded API. */
 export type { EmployeeStateTaxInputQuestionFormat } from '@gusto/embedded-api/models/components/employeestatetaxinputquestionformat';
-/** `Options` entity from the Gusto Embedded API. */
-export type { Options } from '@gusto/embedded-api/models/components/employeestatetaxinputquestionformat';
+/** `EmployeeStateTaxInputQuestionFormatOptions` entity from the Gusto Embedded API. */
+export type { EmployeeStateTaxInputQuestionFormatOptions } from '@gusto/embedded-api/models/components/employeestatetaxinputquestionformat';
 /** `EmployeeStateTaxQuestion` entity from the Gusto Embedded API. */
 export type { EmployeeStateTaxQuestion } from '@gusto/embedded-api/models/components/employeestatetaxquestion';
 /** `EmployeeWorkAddress` entity from the Gusto Embedded API. */
@@ -179,34 +182,6 @@ export { PaymentSpeed } from '@gusto/embedded-api/models/components/paymentconfi
 export type { PaymentMethodBankAccount } from '@gusto/embedded-api/models/components/paymentmethodbankaccount';
 export type { PayPeriod, PayPeriodPayroll } from '@gusto/embedded-api/models/components/payperiod';
 export { PayrollType } from '@gusto/embedded-api/models/components/payperiod';
-/** `EmployeeCompensations` entity from the Gusto Embedded API. */
-export type { EmployeeCompensations } from '@gusto/embedded-api/models/components/payroll';
-/** `OffCycleReasonType` entity from the Gusto Embedded API. */
-export { OffCycleReasonType } from '@gusto/embedded-api/models/components/payroll';
-/** `Payroll` entity from the Gusto Embedded API. */
-export type { Payroll } from '@gusto/embedded-api/models/components/payroll';
-/** `PayrollShow` entity from the Gusto Embedded API. */
-export type { PayrollShow } from '@gusto/embedded-api/models/components/payroll';
-/** `PayrollShowBenefits` entity from the Gusto Embedded API. */
-export type { PayrollShowBenefits } from '@gusto/embedded-api/models/components/payroll';
-/** `PayrollShowDeductions` entity from the Gusto Embedded API. */
-export type { PayrollShowDeductions } from '@gusto/embedded-api/models/components/payroll';
-/** `PayrollShowFixedCompensations` entity from the Gusto Embedded API. */
-export type { PayrollShowFixedCompensations } from '@gusto/embedded-api/models/components/payroll';
-/** `PayrollShowHourlyCompensations` entity from the Gusto Embedded API. */
-export type { PayrollShowHourlyCompensations } from '@gusto/embedded-api/models/components/payroll';
-/** `PayrollShowPaidTimeOff` entity from the Gusto Embedded API. */
-export type { PayrollShowPaidTimeOff } from '@gusto/embedded-api/models/components/payroll';
-/** `PayrollShowPaymentMethod` entity from the Gusto Embedded API. */
-export { PayrollShowPaymentMethod } from '@gusto/embedded-api/models/components/payroll';
-/** `PayrollShowReimbursements` entity from the Gusto Embedded API. */
-export type { PayrollShowReimbursements } from '@gusto/embedded-api/models/components/payroll';
-/** `PayrollShowTaxes` entity from the Gusto Embedded API. */
-export type { PayrollShowTaxes } from '@gusto/embedded-api/models/components/payroll';
-/** `PayrollWithholdingPayPeriodType` entity from the Gusto Embedded API. */
-export { PayrollWithholdingPayPeriodType } from '@gusto/embedded-api/models/components/payroll';
-export type { PayrollPrepared } from '@gusto/embedded-api/models/components/payroll';
-export { PayrollShowAmountType } from '@gusto/embedded-api/models/components/payroll';
 /** `PayrollCompanyTaxesType` entity from the Gusto Embedded API. */
 export type { PayrollCompanyTaxesType } from '@gusto/embedded-api/models/components/payrollcompanytaxestype';
 /** `PayrollCreditBlockerTypeUnblockOptions` entity from the Gusto Embedded API. */
@@ -227,19 +202,22 @@ export type { PayrollCreditBlockerUnblockOptionWaitForReverseWireMetadata } from
 export type { PayrollCreditBlockerUnblockOptionWaitForReverseWire } from '@gusto/embedded-api/models/components/payrollcreditblockerunblockoptionwaitforreversewire';
 /** `Deductions` entity from the Gusto Embedded API. */
 export type { Deductions } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype';
+/** `FixedCompensations` entity from the Gusto Embedded API. */
+export type { FixedCompensations } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype';
+/** `HourlyCompensations` entity from the Gusto Embedded API. */
+export type { HourlyCompensations } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype';
 /** `PayrollEmployeeCompensationsType` entity from the Gusto Embedded API. */
 export type { PayrollEmployeeCompensationsType } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype';
-/** `PayrollEmployeeCompensationsTypeFixedCompensations` entity from the Gusto Embedded API. */
-export type { PayrollEmployeeCompensationsTypeFixedCompensations } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype';
-/** `PayrollEmployeeCompensationsTypeHourlyCompensations` entity from the Gusto Embedded API. */
-export type { PayrollEmployeeCompensationsTypeHourlyCompensations } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype';
 /** `PayrollEmployeeCompensationsTypePaidTimeOff` entity from the Gusto Embedded API. */
 export type { PayrollEmployeeCompensationsTypePaidTimeOff } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype';
 /** `PayrollEmployeeCompensationsTypePaymentMethod` entity from the Gusto Embedded API. */
 export { PayrollEmployeeCompensationsTypePaymentMethod } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype';
-/** `PayrollEmployeeCompensationsTypeReimbursements` entity from the Gusto Embedded API. */
-export type { PayrollEmployeeCompensationsTypeReimbursements } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype';
-export { AmountType } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype';
+/** `Reimbursements` entity from the Gusto Embedded API. */
+export type { Reimbursements } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype';
+/** `State` entity from the Gusto Embedded API. */
+export type { State } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype';
+export type { CustomWithholdings, Federal, } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype';
+export { AmountType, OverrideType, PayrollEmployeeCompensationsTypeAmountType, PayrollEmployeeCompensationsTypeCustomWithholdingsAmountType, PayrollEmployeeCompensationsTypeOverrideType, } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype';
 /** `PayrollFixedCompensationTypesType` entity from the Gusto Embedded API. */
 export type { PayrollFixedCompensationTypesType } from '@gusto/embedded-api/models/components/payrollfixedcompensationtypestype';
 export type { PayrollPaymentSpeedChangedType } from '@gusto/embedded-api/models/components/payrollpaymentspeedchangedtype';
@@ -255,8 +233,38 @@ export type { PayrollReceipt } from '@gusto/embedded-api/models/components/payro
 export type { PayrollReceiptEmployeeCompensations } from '@gusto/embedded-api/models/components/payrollreceipt';
 /** `Taxes` entity from the Gusto Embedded API. */
 export type { Taxes } from '@gusto/embedded-api/models/components/payrollreceipt';
-export type { Licensee, Totals } from '@gusto/embedded-api/models/components/payrollreceipt';
+export type { PayrollReceiptLicensee, PayrollReceiptTotals, } from '@gusto/embedded-api/models/components/payrollreceipt';
 export { PayrollReceiptPaymentMethod } from '@gusto/embedded-api/models/components/payrollreceipt';
+/** `EmployeeCompensations` entity from the Gusto Embedded API. */
+export type { EmployeeCompensations } from '@gusto/embedded-api/models/components/payrollshow';
+/** `OffCycleReasonType` entity from the Gusto Embedded API. */
+export { OffCycleReasonType } from '@gusto/embedded-api/models/components/payrollshow';
+/** `Payroll` entity from the Gusto Embedded API. */
+export type { Payroll } from '@gusto/embedded-api/models/components/payrollshow';
+/** `PayrollShow` entity from the Gusto Embedded API. */
+export type { PayrollShow } from '@gusto/embedded-api/models/components/payrollshow';
+/** `PayrollShowBenefits` entity from the Gusto Embedded API. */
+export type { PayrollShowBenefits } from '@gusto/embedded-api/models/components/payrollshow';
+/** `PayrollShowDeductions` entity from the Gusto Embedded API. */
+export type { PayrollShowDeductions } from '@gusto/embedded-api/models/components/payrollshow';
+/** `PayrollShowFixedCompensations` entity from the Gusto Embedded API. */
+export type { PayrollShowFixedCompensations } from '@gusto/embedded-api/models/components/payrollshow';
+/** `PayrollShowHourlyCompensations` entity from the Gusto Embedded API. */
+export type { PayrollShowHourlyCompensations } from '@gusto/embedded-api/models/components/payrollshow';
+/** `PayrollShowPaidTimeOff` entity from the Gusto Embedded API. */
+export type { PayrollShowPaidTimeOff } from '@gusto/embedded-api/models/components/payrollshow';
+/** `PayrollShowPaymentMethod` entity from the Gusto Embedded API. */
+export { PayrollShowPaymentMethod } from '@gusto/embedded-api/models/components/payrollshow';
+/** `PayrollShowReimbursements` entity from the Gusto Embedded API. */
+export type { PayrollShowReimbursements } from '@gusto/embedded-api/models/components/payrollshow';
+/** `PayrollShowState` entity from the Gusto Embedded API. */
+export type { PayrollShowState } from '@gusto/embedded-api/models/components/payrollshow';
+/** `PayrollShowTaxes` entity from the Gusto Embedded API. */
+export type { PayrollShowTaxes } from '@gusto/embedded-api/models/components/payrollshow';
+/** `PayrollWithholdingPayPeriodType` entity from the Gusto Embedded API. */
+export { PayrollWithholdingPayPeriodType } from '@gusto/embedded-api/models/components/payrollshow';
+export type { PayrollPrepared, PayrollShowCustomWithholdings, PayrollShowFederal, } from '@gusto/embedded-api/models/components/payrollshow';
+export { PayrollShowAmountType, PayrollShowEmployeeCompensationsAmountType, PayrollShowEmployeeCompensationsCustomWithholdingsAmountType, PayrollShowEmployeeCompensationsOverrideType, PayrollShowOverrideType, } from '@gusto/embedded-api/models/components/payrollshow';
 /** `UnblockOptions` entity from the Gusto Embedded API. */
 export type { UnblockOptions } from '@gusto/embedded-api/models/components/payrollsubmissionblockertype';
 export type { PayrollSubmissionBlockerType } from '@gusto/embedded-api/models/components/payrollsubmissionblockertype';
@@ -270,29 +278,31 @@ export type { PayrollUpdateEmployeeCompensations } from '@gusto/embedded-api/mod
 export type { PayrollUpdatePaidTimeOff } from '@gusto/embedded-api/models/components/payrollupdate';
 /** `PayrollUpdateReimbursements` entity from the Gusto Embedded API. */
 export type { PayrollUpdateReimbursements } from '@gusto/embedded-api/models/components/payrollupdate';
-export type { PayrollUpdateDeductions, PayrollUpdateFixedCompensations, PayrollUpdateHourlyCompensations, } from '@gusto/embedded-api/models/components/payrollupdate';
-export { PayrollUpdateAmountType, PayrollUpdatePaymentMethod, } from '@gusto/embedded-api/models/components/payrollupdate';
+/** `PayrollUpdateState` entity from the Gusto Embedded API. */
+export type { PayrollUpdateState } from '@gusto/embedded-api/models/components/payrollupdate';
+export type { PayrollUpdateCustomWithholdings, PayrollUpdateDeductions, PayrollUpdateFederal, PayrollUpdateFixedCompensations, PayrollUpdateHourlyCompensations, } from '@gusto/embedded-api/models/components/payrollupdate';
+export { PayrollUpdateAmountType, PayrollUpdateEmployeeCompensationsAmountType, PayrollUpdateEmployeeCompensationsCustomWithholdingsAmountType, PayrollUpdateEmployeeCompensationsOverrideType, PayrollUpdateOverrideType, PayrollUpdatePaymentMethod, } from '@gusto/embedded-api/models/components/payrollupdate';
 export type { PayScheduleAutoPayrollEnablementBlocker, PayScheduleAutoPayrollEnablementBlockerMetadata, } from '@gusto/embedded-api/models/components/payscheduleautopayrollenablementblocker';
 export { PayScheduleFrequency } from '@gusto/embedded-api/models/components/payschedulefrequency';
 export type { PaySchedulePreviewPayPeriod } from '@gusto/embedded-api/models/components/payschedulepreviewpayperiod';
 export type { PayScheduleShow } from '@gusto/embedded-api/models/components/payscheduleshow';
 export type { RecoveryCase } from '@gusto/embedded-api/models/components/recoverycase';
 export { RecoveryCaseStatus } from '@gusto/embedded-api/models/components/recoverycase';
-/** `HomeAddress` entity from the Gusto Embedded API. */
-export type { HomeAddress } from '@gusto/embedded-api/models/components/signatory';
 /** `IdentityVerificationStatus` entity from the Gusto Embedded API. */
 export { IdentityVerificationStatus } from '@gusto/embedded-api/models/components/signatory';
+/** `SignatoryHomeAddress` entity from the Gusto Embedded API. */
+export type { SignatoryHomeAddress } from '@gusto/embedded-api/models/components/signatory';
 export type { Signatory } from '@gusto/embedded-api/models/components/signatory';
 /** `ApplicableIf` entity from the Gusto Embedded API. */
 export type { ApplicableIf } from '@gusto/embedded-api/models/components/taxrequirement';
 /** `TaxRequirement` entity from the Gusto Embedded API. */
 export type { TaxRequirement } from '@gusto/embedded-api/models/components/taxrequirement';
+/** `Options` entity from the Gusto Embedded API. */
+export type { Options } from '@gusto/embedded-api/models/components/taxrequirementmetadata';
 /** `TaxRequirementMetadata` entity from the Gusto Embedded API. */
 export type { TaxRequirementMetadata } from '@gusto/embedded-api/models/components/taxrequirementmetadata';
-/** `TaxRequirementMetadataOptions` entity from the Gusto Embedded API. */
-export type { TaxRequirementMetadataOptions } from '@gusto/embedded-api/models/components/taxrequirementmetadata';
 export type { Validation } from '@gusto/embedded-api/models/components/taxrequirementmetadata';
-export { RateType, TaxRequirementMetadataType, TaxRequirementMetadataValidationType, } from '@gusto/embedded-api/models/components/taxrequirementmetadata';
+export { RateType, TaxRequirementMetadataType, Type, } from '@gusto/embedded-api/models/components/taxrequirementmetadata';
 /** `TaxRequirementSet` entity from the Gusto Embedded API. */
 export type { TaxRequirementSet } from '@gusto/embedded-api/models/components/taxrequirementset';
 /** `TaxRequirementsState` entity from the Gusto Embedded API. */

package/dist/partner-hook-utils/composeErrorHandler.d.ts

@@ -1,7 +1,13 @@
 import { UseQueryResult } from '@tanstack/react-query';
 import { HookErrorHandling } from './types';
 import { SDKError } from '../types/sdkError';
-type QueryWithRefetch = Pick<UseQueryResult, 'error' | 'refetch'>;
+/**
+ * The subset of a TanStack Query result — its `error` and `refetch` — that
+ * {@link composeErrorHandler} reads from an additional query passed as a source.
+ *
+ * @public
+ */
+export type QueryWithRefetch = Pick<UseQueryResult, 'error' | 'refetch'>;
 /**
  * Submit-side error state to merge into a composed {@link HookErrorHandling}.
  *
@@ -32,7 +38,7 @@ export type MixedErrorSource = QueryWithRefetch | {
  * Merges multiple error sources into a single {@link HookErrorHandling}.
  *
  * @remarks
- * Accepts any mix of `@gusto/embedded-api-v-2026-02-01` React Query results and SDK hook
+ * Accepts any mix of `@gusto/embedded-api-v-2026-06-15` React Query results and SDK hook
  * results that already expose an `errorHandling` object (including the value returned by
  * {@link composeSubmitHandler}). Query errors are normalized to `SDKError`, nested hook
  * errors are flattened in, and an optional submit-state argument adds a submit error to
@@ -54,7 +60,7 @@ export type MixedErrorSource = QueryWithRefetch | {
  * @example
  * ```tsx
  * import { composeErrorHandler, useEmployeeDetailsForm } from '@gusto/embedded-react-sdk'
- * import { useEmployeeFormsList } from '@gusto/embedded-api-v-2026-02-01/react-query/employeeFormsList'
+ * import { useEmployeeFormsList } from '@gusto/embedded-api-v-2026-06-15/react-query/employeeFormsList'
  *
  * function EmployeeProfileView({ companyId, employeeId }: { companyId: string; employeeId: string }) {
  *   const employeeDetails = useEmployeeDetailsForm({ companyId, employeeId })
@@ -78,4 +84,3 @@ export type MixedErrorSource = QueryWithRefetch | {
  * ```
  */
 export declare function composeErrorHandler(sources: MixedErrorSource[], submitState?: SubmitStateForErrorHandling): HookErrorHandling;
-export {};

package/dist/partner-hook-utils/composeErrorHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"composeErrorHandler.js","sources":["../../src/partner-hook-utils/composeErrorHandler.ts"],"sourcesContent":["import type { UseQueryResult } from '@tanstack/react-query'\nimport { collectErrors } from './collectErrors'\nimport type { HookErrorHandling } from './types'\nimport type { SDKError } from '@/types/sdkError'\n\ntype QueryWithRefetch = Pick<UseQueryResult, 'error' | 'refetch'>\n\n/**\n * Submit-side error state to merge into a composed {@link HookErrorHandling}.\n *\n * @remarks\n * Pass to {@link composeErrorHandler} when a screen has its own submit state outside of\n * any SDK form hook, so submit errors appear in the same error surface as query errors\n * and can be cleared together with `clearSubmitError`.\n *\n * @public\n */\nexport type SubmitStateForErrorHandling = {\n  /** The current submit error, or `null` when cleared. */\n  submitError: SDKError | null\n  /** Sets or clears the submit error. */\n  setSubmitError: (error: SDKError | null) => void\n}\n\n/**\n * Accepted input shape for {@link composeErrorHandler}: either a React Query result\n * (anything with `error` and `refetch`) or another SDK hook result that exposes\n * an `errorHandling` object.\n *\n * @public\n */\nexport type MixedErrorSource = QueryWithRefetch | { errorHandling: HookErrorHandling }\n\nfunction isHookResultWithErrorHandling(\n  source: MixedErrorSource,\n): source is { errorHandling: HookErrorHandling } {\n  return 'errorHandling' in source\n}\n\n/**\n * Merges multiple error sources into a single {@link HookErrorHandling}.\n *\n * @remarks\n * Accepts any mix of `@gusto/embedded-api-v-2026-02-01` React Query results and SDK hook\n * results that already expose an `errorHandling` object (including the value returned by\n * {@link composeSubmitHandler}). Query errors are normalized to `SDKError`, nested hook\n * errors are flattened in, and an optional submit-state argument adds a submit error to\n * the same list.\n *\n * The returned `retryQueries` refetches every failed query and delegates into each nested\n * hook so their retries fire too. `clearSubmitError` clears the optional submit state and\n * delegates into each nested hook.\n *\n * Pairs with {@link composeSubmitHandler} by name only — this composes error state and\n * recovery, not a submit callback.\n *\n * @param sources - Error sources to merge. Each entry is either a React Query result or\n *   an object with an `errorHandling` property.\n * @param submitState - Optional screen-level submit state to fold into the result.\n * @returns A single `HookErrorHandling` covering every source.\n * @public\n *\n * @example\n * ```tsx\n * import { composeErrorHandler, useEmployeeDetailsForm } from '@gusto/embedded-react-sdk'\n * import { useEmployeeFormsList } from '@gusto/embedded-api-v-2026-02-01/react-query/employeeFormsList'\n *\n * function EmployeeProfileView({ companyId, employeeId }: { companyId: string; employeeId: string }) {\n *   const employeeDetails = useEmployeeDetailsForm({ companyId, employeeId })\n *   const formsListQuery = useEmployeeFormsList({ employeeId })\n *\n *   const errorHandling = composeErrorHandler([employeeDetails, formsListQuery])\n *\n *   if (errorHandling.errors.length > 0) {\n *     return (\n *       <div role=\"alert\">\n *         {errorHandling.errors.map((error, i) => (\n *           <p key={i}>{error.message}</p>\n *         ))}\n *         <button onClick={errorHandling.retryQueries}>Retry</button>\n *       </div>\n *     )\n *   }\n *\n *   return null\n * }\n * ```\n */\nexport function composeErrorHandler(\n  sources: MixedErrorSource[],\n  submitState?: SubmitStateForErrorHandling,\n): HookErrorHandling {\n  const queries: QueryWithRefetch[] = []\n  const errorHandlingsFromNestedHooks: HookErrorHandling[] = []\n\n  for (const source of sources) {\n    if (isHookResultWithErrorHandling(source)) {\n      errorHandlingsFromNestedHooks.push(source.errorHandling)\n    } else {\n      queries.push(source)\n    }\n  }\n\n  const nestedErrors = errorHandlingsFromNestedHooks.flatMap(handling => handling.errors)\n\n  let errors: SDKError[]\n  if (errorHandlingsFromNestedHooks.length === 0) {\n    errors = collectErrors(queries, submitState?.submitError ?? null)\n  } else {\n    const standaloneQueryErrors = collectErrors(queries, null)\n    errors = [...nestedErrors, ...standaloneQueryErrors]\n    if (submitState?.submitError) {\n      errors.push(submitState.submitError)\n    }\n  }\n\n  const retryQueries = () => {\n    for (const handling of errorHandlingsFromNestedHooks) {\n      handling.retryQueries()\n    }\n    queries.filter(q => q.error != null).forEach(q => void q.refetch())\n  }\n\n  const clearSubmitError = () => {\n    for (const handling of errorHandlingsFromNestedHooks) {\n      handling.clearSubmitError()\n    }\n    submitState?.setSubmitError(null)\n  }\n\n  return { errors, retryQueries, clearSubmitError }\n}\n"],"names":["isHookResultWithErrorHandling","source","composeErrorHandler","sources","submitState","queries","errorHandlingsFromNestedHooks","nestedErrors","handling","errors","collectErrors","standaloneQueryErrors","q"],"mappings":";AAiCA,SAASA,EACPC,GACgD;AAChD,SAAO,mBAAmBA;AAC5B;AAmDO,SAASC,EACdC,GACAC,GACmB;AACnB,QAAMC,IAA8B,CAAA,GAC9BC,IAAqD,CAAA;AAE3D,aAAWL,KAAUE;AACnB,IAAIH,EAA8BC,CAAM,IACtCK,EAA8B,KAAKL,EAAO,aAAa,IAEvDI,EAAQ,KAAKJ,CAAM;AAIvB,QAAMM,IAAeD,EAA8B,QAAQ,CAAAE,MAAYA,EAAS,MAAM;AAEtF,MAAIC;AACJ,MAAIH,EAA8B,WAAW;AAC3C,IAAAG,IAASC,EAAcL,GAASD,GAAa,eAAe,IAAI;AAAA,OAC3D;AACL,UAAMO,IAAwBD,EAAcL,GAAS,IAAI;AACzD,IAAAI,IAAS,CAAC,GAAGF,GAAc,GAAGI,CAAqB,GAC/CP,GAAa,eACfK,EAAO,KAAKL,EAAY,WAAW;AAAA,EAEvC;AAgBA,SAAO,EAAE,QAAAK,GAAQ,cAdI,MAAM;AACzB,eAAWD,KAAYF;AACrB,MAAAE,EAAS,aAAA;AAEX,IAAAH,EAAQ,OAAO,CAAAO,MAAKA,EAAE,SAAS,IAAI,EAAE,QAAQ,CAAAA,MAAA;AAAK,MAAKA,EAAE,QAAA;AAAA,KAAS;AAAA,EACpE,GAS+B,kBAPN,MAAM;AAC7B,eAAWJ,KAAYF;AACrB,MAAAE,EAAS,iBAAA;AAEX,IAAAJ,GAAa,eAAe,IAAI;AAAA,EAClC,EAE+B;AACjC;"}
+{"version":3,"file":"composeErrorHandler.js","sources":["../../src/partner-hook-utils/composeErrorHandler.ts"],"sourcesContent":["import type { UseQueryResult } from '@tanstack/react-query'\nimport { collectErrors } from './collectErrors'\nimport type { HookErrorHandling } from './types'\nimport type { SDKError } from '@/types/sdkError'\n\n/**\n * The subset of a TanStack Query result — its `error` and `refetch` — that\n * {@link composeErrorHandler} reads from an additional query passed as a source.\n *\n * @public\n */\nexport type QueryWithRefetch = Pick<UseQueryResult, 'error' | 'refetch'>\n\n/**\n * Submit-side error state to merge into a composed {@link HookErrorHandling}.\n *\n * @remarks\n * Pass to {@link composeErrorHandler} when a screen has its own submit state outside of\n * any SDK form hook, so submit errors appear in the same error surface as query errors\n * and can be cleared together with `clearSubmitError`.\n *\n * @public\n */\nexport type SubmitStateForErrorHandling = {\n  /** The current submit error, or `null` when cleared. */\n  submitError: SDKError | null\n  /** Sets or clears the submit error. */\n  setSubmitError: (error: SDKError | null) => void\n}\n\n/**\n * Accepted input shape for {@link composeErrorHandler}: either a React Query result\n * (anything with `error` and `refetch`) or another SDK hook result that exposes\n * an `errorHandling` object.\n *\n * @public\n */\nexport type MixedErrorSource = QueryWithRefetch | { errorHandling: HookErrorHandling }\n\nfunction isHookResultWithErrorHandling(\n  source: MixedErrorSource,\n): source is { errorHandling: HookErrorHandling } {\n  return 'errorHandling' in source\n}\n\n/**\n * Merges multiple error sources into a single {@link HookErrorHandling}.\n *\n * @remarks\n * Accepts any mix of `@gusto/embedded-api-v-2026-06-15` React Query results and SDK hook\n * results that already expose an `errorHandling` object (including the value returned by\n * {@link composeSubmitHandler}). Query errors are normalized to `SDKError`, nested hook\n * errors are flattened in, and an optional submit-state argument adds a submit error to\n * the same list.\n *\n * The returned `retryQueries` refetches every failed query and delegates into each nested\n * hook so their retries fire too. `clearSubmitError` clears the optional submit state and\n * delegates into each nested hook.\n *\n * Pairs with {@link composeSubmitHandler} by name only — this composes error state and\n * recovery, not a submit callback.\n *\n * @param sources - Error sources to merge. Each entry is either a React Query result or\n *   an object with an `errorHandling` property.\n * @param submitState - Optional screen-level submit state to fold into the result.\n * @returns A single `HookErrorHandling` covering every source.\n * @public\n *\n * @example\n * ```tsx\n * import { composeErrorHandler, useEmployeeDetailsForm } from '@gusto/embedded-react-sdk'\n * import { useEmployeeFormsList } from '@gusto/embedded-api-v-2026-06-15/react-query/employeeFormsList'\n *\n * function EmployeeProfileView({ companyId, employeeId }: { companyId: string; employeeId: string }) {\n *   const employeeDetails = useEmployeeDetailsForm({ companyId, employeeId })\n *   const formsListQuery = useEmployeeFormsList({ employeeId })\n *\n *   const errorHandling = composeErrorHandler([employeeDetails, formsListQuery])\n *\n *   if (errorHandling.errors.length > 0) {\n *     return (\n *       <div role=\"alert\">\n *         {errorHandling.errors.map((error, i) => (\n *           <p key={i}>{error.message}</p>\n *         ))}\n *         <button onClick={errorHandling.retryQueries}>Retry</button>\n *       </div>\n *     )\n *   }\n *\n *   return null\n * }\n * ```\n */\nexport function composeErrorHandler(\n  sources: MixedErrorSource[],\n  submitState?: SubmitStateForErrorHandling,\n): HookErrorHandling {\n  const queries: QueryWithRefetch[] = []\n  const errorHandlingsFromNestedHooks: HookErrorHandling[] = []\n\n  for (const source of sources) {\n    if (isHookResultWithErrorHandling(source)) {\n      errorHandlingsFromNestedHooks.push(source.errorHandling)\n    } else {\n      queries.push(source)\n    }\n  }\n\n  const nestedErrors = errorHandlingsFromNestedHooks.flatMap(handling => handling.errors)\n\n  let errors: SDKError[]\n  if (errorHandlingsFromNestedHooks.length === 0) {\n    errors = collectErrors(queries, submitState?.submitError ?? null)\n  } else {\n    const standaloneQueryErrors = collectErrors(queries, null)\n    errors = [...nestedErrors, ...standaloneQueryErrors]\n    if (submitState?.submitError) {\n      errors.push(submitState.submitError)\n    }\n  }\n\n  const retryQueries = () => {\n    for (const handling of errorHandlingsFromNestedHooks) {\n      handling.retryQueries()\n    }\n    queries.filter(q => q.error != null).forEach(q => void q.refetch())\n  }\n\n  const clearSubmitError = () => {\n    for (const handling of errorHandlingsFromNestedHooks) {\n      handling.clearSubmitError()\n    }\n    submitState?.setSubmitError(null)\n  }\n\n  return { errors, retryQueries, clearSubmitError }\n}\n"],"names":["isHookResultWithErrorHandling","source","composeErrorHandler","sources","submitState","queries","errorHandlingsFromNestedHooks","nestedErrors","handling","errors","collectErrors","standaloneQueryErrors","q"],"mappings":";AAuCA,SAASA,EACPC,GACgD;AAChD,SAAO,mBAAmBA;AAC5B;AAmDO,SAASC,EACdC,GACAC,GACmB;AACnB,QAAMC,IAA8B,CAAA,GAC9BC,IAAqD,CAAA;AAE3D,aAAWL,KAAUE;AACnB,IAAIH,EAA8BC,CAAM,IACtCK,EAA8B,KAAKL,EAAO,aAAa,IAEvDI,EAAQ,KAAKJ,CAAM;AAIvB,QAAMM,IAAeD,EAA8B,QAAQ,CAAAE,MAAYA,EAAS,MAAM;AAEtF,MAAIC;AACJ,MAAIH,EAA8B,WAAW;AAC3C,IAAAG,IAASC,EAAcL,GAASD,GAAa,eAAe,IAAI;AAAA,OAC3D;AACL,UAAMO,IAAwBD,EAAcL,GAAS,IAAI;AACzD,IAAAI,IAAS,CAAC,GAAGF,GAAc,GAAGI,CAAqB,GAC/CP,GAAa,eACfK,EAAO,KAAKL,EAAY,WAAW;AAAA,EAEvC;AAgBA,SAAO,EAAE,QAAAK,GAAQ,cAdI,MAAM;AACzB,eAAWD,KAAYF;AACrB,MAAAE,EAAS,aAAA;AAEX,IAAAH,EAAQ,OAAO,CAAAO,MAAKA,EAAE,SAAS,IAAI,EAAE,QAAQ,CAAAA,MAAA;AAAK,MAAKA,EAAE,QAAA;AAAA,KAAS;AAAA,EACpE,GAS+B,kBAPN,MAAM;AAC7B,eAAWJ,KAAYF;AACrB,MAAAE,EAAS,iBAAA;AAEX,IAAAJ,GAAa,eAAe,IAAI;AAAA,EAClC,EAE+B;AACjC;"}

package/dist/partner-hook-utils/form/SDKFormProvider.d.ts

@@ -2,9 +2,17 @@ import { ReactNode } from 'react';
 import { FieldValues } from 'react-hook-form';
 import { FieldMetadata, FieldMetadataWithOptions, HookFormInternals } from '../types';
 import { SDKError } from '../../types/sdkError';
-interface SDKFormProviderProps<TFormData extends FieldValues = FieldValues, TFieldsMetadata extends {
+/**
+ * Props for {@link SDKFormProvider}.
+ *
+ * @typeParam TFormData - Shape of the form values managed by the wrapped form hook.
+ * @typeParam TFieldsMetadata - The form hook's field-metadata map.
+ * @public
+ */
+export interface SDKFormProviderProps<TFormData extends FieldValues = FieldValues, TFieldsMetadata extends {
     [K in keyof TFieldsMetadata]: FieldMetadata | FieldMetadataWithOptions;
 } = Record<string, FieldMetadata | FieldMetadataWithOptions>> {
+    /** The form hook result whose fields, metadata, and errors are shared with descendant field components. */
     formHookResult: {
         errorHandling: {
             errors: SDKError[];
@@ -14,6 +22,7 @@ interface SDKFormProviderProps<TFormData extends FieldValues = FieldValues, TFie
             hookFormInternals: HookFormInternals<TFormData>;
         };
     };
+    /** Field components (or any content) that consume the provided form context. */
     children: ReactNode;
 }
 /**
@@ -47,4 +56,3 @@ interface SDKFormProviderProps<TFormData extends FieldValues = FieldValues, TFie
 export declare function SDKFormProvider<TFormData extends FieldValues = FieldValues, TFieldsMetadata extends {
     [K in keyof TFieldsMetadata]: FieldMetadata | FieldMetadataWithOptions;
 } = Record<string, FieldMetadata | FieldMetadataWithOptions>>({ formHookResult, children }: SDKFormProviderProps<TFormData, TFieldsMetadata>): import("react").JSX.Element;
-export {};

package/dist/partner-hook-utils/form/SDKFormProvider.js

@@ -20,7 +20,13 @@ function F(o, t) {
 }
 function M({ formHookResult: o, children: t }) {
   const { errorHandling: e, form: r } = o, i = e.errors.flatMap((s) => s.fieldErrors);
-  return F(i, r), /* @__PURE__ */ n(l, { metadata: r.fieldsMetadata, errors: e.errors, children: /* @__PURE__ */ n(f, { registry: r.hookFormInternals._fieldElementRegistry, children: /* @__PURE__ */ n(d, { ...r.hookFormInternals.formMethods, children: t }) }) });
+  return F(i, r), /* @__PURE__ */ n(l, { metadata: r.fieldsMetadata, errors: e.errors, children: /* @__PURE__ */ n(
+    f,
+    {
+      registry: r.hookFormInternals._fieldElementRegistry,
+      children: /* @__PURE__ */ n(d, { ...r.hookFormInternals.formMethods, children: t })
+    }
+  ) });
 }
 export {
   M as SDKFormProvider

package/dist/partner-hook-utils/form/SDKFormProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"SDKFormProvider.js","sources":["../../../src/partner-hook-utils/form/SDKFormProvider.tsx"],"sourcesContent":["import { type ReactNode, useEffect } from 'react'\nimport type { FieldPath, FieldValues } from 'react-hook-form'\nimport { FormProvider } from 'react-hook-form'\nimport type { FieldMetadata, FieldMetadataWithOptions, HookFormInternals } from '../types'\nimport { FormFieldsMetadataProvider } from './FormFieldsMetadataProvider'\nimport { FieldElementRegistryProvider } from '@/components/Common/Fields/hooks/FieldElementRegistryProvider'\nimport { normalizeErrorKeyForForm } from '@/helpers/formattedStrings'\nimport type { SDKError, SDKFieldError } from '@/types/sdkError'\n\nfunction useSyncFieldErrors<\n  TFormData extends FieldValues,\n  TFieldsMetadata extends {\n    [K in keyof TFieldsMetadata]: FieldMetadata | FieldMetadataWithOptions\n  },\n>(\n  fieldErrors: SDKFieldError[],\n  form: {\n    fieldsMetadata: TFieldsMetadata\n    hookFormInternals: HookFormInternals<TFormData>\n  },\n) {\n  const { fieldsMetadata } = form\n  const { setError } = form.hookFormInternals.formMethods\n\n  useEffect(() => {\n    if (!fieldErrors.length) return\n    const knownFields = new Set(Object.keys(fieldsMetadata))\n    for (const fieldError of fieldErrors) {\n      const normalizedField = normalizeErrorKeyForForm(fieldError.field)\n      if (knownFields.has(normalizedField)) {\n        setError(normalizedField as FieldPath<TFormData>, {\n          type: 'custom',\n          message: fieldError.message,\n        })\n      }\n    }\n  }, [fieldErrors, setError, fieldsMetadata])\n}\n\ninterface SDKFormProviderProps<\n  TFormData extends FieldValues = FieldValues,\n  TFieldsMetadata extends {\n    [K in keyof TFieldsMetadata]: FieldMetadata | FieldMetadataWithOptions\n  } = Record<string, FieldMetadata | FieldMetadataWithOptions>,\n> {\n  formHookResult: {\n    errorHandling: { errors: SDKError[] }\n    form: {\n      fieldsMetadata: TFieldsMetadata\n      hookFormInternals: HookFormInternals<TFormData>\n    }\n  }\n  children: ReactNode\n}\n\n/**\n * Provides form context to field components so they can read metadata, control,\n * and error state without an explicit `formHookResult` prop on each field.\n * Server-side field errors are automatically synced onto their corresponding fields.\n *\n * @public\n *\n * @example\n * ```tsx\n * const formHookResult = useEmployeeDetailsForm({ employeeId })\n * const { Fields } = formHookResult.form\n *\n * // SDKFormProvider supplies context only — wire up submission and render the\n * // <form> element yourself.\n * const handleSubmit = () =>\n *   formHookResult.actions.onSubmit({ onEmployeeUpdated: (emp) => { ... } })\n *\n * return (\n *   <SDKFormProvider formHookResult={formHookResult}>\n *     <form onSubmit={handleSubmit}>\n *       <Fields.FirstName label=\"First name\" />\n *       <Fields.LastName label=\"Last name\" />\n *       <button type=\"submit\">Save</button>\n *     </form>\n *   </SDKFormProvider>\n * )\n * ```\n */\nexport function SDKFormProvider<\n  TFormData extends FieldValues = FieldValues,\n  TFieldsMetadata extends {\n    [K in keyof TFieldsMetadata]: FieldMetadata | FieldMetadataWithOptions\n  } = Record<string, FieldMetadata | FieldMetadataWithOptions>,\n>({ formHookResult, children }: SDKFormProviderProps<TFormData, TFieldsMetadata>) {\n  const { errorHandling, form } = formHookResult\n  const allFieldErrors = errorHandling.errors.flatMap(e => e.fieldErrors)\n  useSyncFieldErrors(allFieldErrors, form)\n\n  return (\n    <FormFieldsMetadataProvider metadata={form.fieldsMetadata} errors={errorHandling.errors}>\n      <FieldElementRegistryProvider registry={form.hookFormInternals._fieldElementRegistry}>\n        <FormProvider {...form.hookFormInternals.formMethods}>{children}</FormProvider>\n      </FieldElementRegistryProvider>\n    </FormFieldsMetadataProvider>\n  )\n}\n"],"names":["useSyncFieldErrors","fieldErrors","form","fieldsMetadata","setError","useEffect","knownFields","fieldError","normalizedField","normalizeErrorKeyForForm","SDKFormProvider","formHookResult","children","errorHandling","allFieldErrors","e","jsx","FormFieldsMetadataProvider","FieldElementRegistryProvider","FormProvider"],"mappings":";;;;;;AASA,SAASA,EAMPC,GACAC,GAIA;AACA,QAAM,EAAE,gBAAAC,MAAmBD,GACrB,EAAE,UAAAE,EAAA,IAAaF,EAAK,kBAAkB;AAE5C,EAAAG,EAAU,MAAM;AACd,QAAI,CAACJ,EAAY,OAAQ;AACzB,UAAMK,IAAc,IAAI,IAAI,OAAO,KAAKH,CAAc,CAAC;AACvD,eAAWI,KAAcN,GAAa;AACpC,YAAMO,IAAkBC,EAAyBF,EAAW,KAAK;AACjE,MAAID,EAAY,IAAIE,CAAe,KACjCJ,EAASI,GAAyC;AAAA,QAChD,MAAM;AAAA,QACN,SAASD,EAAW;AAAA,MAAA,CACrB;AAAA,IAEL;AAAA,EACF,GAAG,CAACN,GAAaG,GAAUD,CAAc,CAAC;AAC5C;AA8CO,SAASO,EAKd,EAAE,gBAAAC,GAAgB,UAAAC,KAA8D;AAChF,QAAM,EAAE,eAAAC,GAAe,MAAAX,EAAA,IAASS,GAC1BG,IAAiBD,EAAc,OAAO,QAAQ,CAAAE,MAAKA,EAAE,WAAW;AACtE,SAAAf,EAAmBc,GAAgBZ,CAAI,GAGrC,gBAAAc,EAACC,KAA2B,UAAUf,EAAK,gBAAgB,QAAQW,EAAc,QAC/E,UAAA,gBAAAG,EAACE,GAAA,EAA6B,UAAUhB,EAAK,kBAAkB,uBAC7D,4BAACiB,GAAA,EAAc,GAAGjB,EAAK,kBAAkB,aAAc,UAAAU,EAAA,CAAS,EAAA,CAClE,EAAA,CACF;AAEJ;"}
+{"version":3,"file":"SDKFormProvider.js","sources":["../../../src/partner-hook-utils/form/SDKFormProvider.tsx"],"sourcesContent":["import { type ReactNode, useEffect } from 'react'\nimport type { FieldPath, FieldValues } from 'react-hook-form'\nimport { FormProvider } from 'react-hook-form'\nimport type { FieldMetadata, FieldMetadataWithOptions, HookFormInternals } from '../types'\nimport { FormFieldsMetadataProvider } from './FormFieldsMetadataProvider'\nimport { FieldElementRegistryProvider } from '@/components/Common/Fields/hooks/FieldElementRegistryProvider'\nimport type { FieldElementRegistry } from '@/components/Common/Fields/hooks/fieldElementRegistry'\nimport { normalizeErrorKeyForForm } from '@/helpers/formattedStrings'\nimport type { SDKError, SDKFieldError } from '@/types/sdkError'\n\nfunction useSyncFieldErrors<\n  TFormData extends FieldValues,\n  TFieldsMetadata extends {\n    [K in keyof TFieldsMetadata]: FieldMetadata | FieldMetadataWithOptions\n  },\n>(\n  fieldErrors: SDKFieldError[],\n  form: {\n    fieldsMetadata: TFieldsMetadata\n    hookFormInternals: HookFormInternals<TFormData>\n  },\n) {\n  const { fieldsMetadata } = form\n  const { setError } = form.hookFormInternals.formMethods\n\n  useEffect(() => {\n    if (!fieldErrors.length) return\n    const knownFields = new Set(Object.keys(fieldsMetadata))\n    for (const fieldError of fieldErrors) {\n      const normalizedField = normalizeErrorKeyForForm(fieldError.field)\n      if (knownFields.has(normalizedField)) {\n        setError(normalizedField as FieldPath<TFormData>, {\n          type: 'custom',\n          message: fieldError.message,\n        })\n      }\n    }\n  }, [fieldErrors, setError, fieldsMetadata])\n}\n\n/**\n * Props for {@link SDKFormProvider}.\n *\n * @typeParam TFormData - Shape of the form values managed by the wrapped form hook.\n * @typeParam TFieldsMetadata - The form hook's field-metadata map.\n * @public\n */\nexport interface SDKFormProviderProps<\n  TFormData extends FieldValues = FieldValues,\n  TFieldsMetadata extends {\n    [K in keyof TFieldsMetadata]: FieldMetadata | FieldMetadataWithOptions\n  } = Record<string, FieldMetadata | FieldMetadataWithOptions>,\n> {\n  /** The form hook result whose fields, metadata, and errors are shared with descendant field components. */\n  formHookResult: {\n    errorHandling: { errors: SDKError[] }\n    form: {\n      fieldsMetadata: TFieldsMetadata\n      hookFormInternals: HookFormInternals<TFormData>\n    }\n  }\n  /** Field components (or any content) that consume the provided form context. */\n  children: ReactNode\n}\n\n/**\n * Provides form context to field components so they can read metadata, control,\n * and error state without an explicit `formHookResult` prop on each field.\n * Server-side field errors are automatically synced onto their corresponding fields.\n *\n * @public\n *\n * @example\n * ```tsx\n * const formHookResult = useEmployeeDetailsForm({ employeeId })\n * const { Fields } = formHookResult.form\n *\n * // SDKFormProvider supplies context only — wire up submission and render the\n * // <form> element yourself.\n * const handleSubmit = () =>\n *   formHookResult.actions.onSubmit({ onEmployeeUpdated: (emp) => { ... } })\n *\n * return (\n *   <SDKFormProvider formHookResult={formHookResult}>\n *     <form onSubmit={handleSubmit}>\n *       <Fields.FirstName label=\"First name\" />\n *       <Fields.LastName label=\"Last name\" />\n *       <button type=\"submit\">Save</button>\n *     </form>\n *   </SDKFormProvider>\n * )\n * ```\n */\nexport function SDKFormProvider<\n  TFormData extends FieldValues = FieldValues,\n  TFieldsMetadata extends {\n    [K in keyof TFieldsMetadata]: FieldMetadata | FieldMetadataWithOptions\n  } = Record<string, FieldMetadata | FieldMetadataWithOptions>,\n>({ formHookResult, children }: SDKFormProviderProps<TFormData, TFieldsMetadata>) {\n  const { errorHandling, form } = formHookResult\n  const allFieldErrors = errorHandling.errors.flatMap(e => e.fieldErrors)\n  useSyncFieldErrors(allFieldErrors, form)\n\n  return (\n    <FormFieldsMetadataProvider metadata={form.fieldsMetadata} errors={errorHandling.errors}>\n      <FieldElementRegistryProvider\n        registry={form.hookFormInternals._fieldElementRegistry as FieldElementRegistry | undefined}\n      >\n        <FormProvider {...form.hookFormInternals.formMethods}>{children}</FormProvider>\n      </FieldElementRegistryProvider>\n    </FormFieldsMetadataProvider>\n  )\n}\n"],"names":["useSyncFieldErrors","fieldErrors","form","fieldsMetadata","setError","useEffect","knownFields","fieldError","normalizedField","normalizeErrorKeyForForm","SDKFormProvider","formHookResult","children","errorHandling","allFieldErrors","e","FormFieldsMetadataProvider","jsx","FieldElementRegistryProvider","FormProvider"],"mappings":";;;;;;AAUA,SAASA,EAMPC,GACAC,GAIA;AACA,QAAM,EAAE,gBAAAC,MAAmBD,GACrB,EAAE,UAAAE,EAAA,IAAaF,EAAK,kBAAkB;AAE5C,EAAAG,EAAU,MAAM;AACd,QAAI,CAACJ,EAAY,OAAQ;AACzB,UAAMK,IAAc,IAAI,IAAI,OAAO,KAAKH,CAAc,CAAC;AACvD,eAAWI,KAAcN,GAAa;AACpC,YAAMO,IAAkBC,EAAyBF,EAAW,KAAK;AACjE,MAAID,EAAY,IAAIE,CAAe,KACjCJ,EAASI,GAAyC;AAAA,QAChD,MAAM;AAAA,QACN,SAASD,EAAW;AAAA,MAAA,CACrB;AAAA,IAEL;AAAA,EACF,GAAG,CAACN,GAAaG,GAAUD,CAAc,CAAC;AAC5C;AAuDO,SAASO,EAKd,EAAE,gBAAAC,GAAgB,UAAAC,KAA8D;AAChF,QAAM,EAAE,eAAAC,GAAe,MAAAX,EAAA,IAASS,GAC1BG,IAAiBD,EAAc,OAAO,QAAQ,CAAAE,MAAKA,EAAE,WAAW;AACtE,SAAAf,EAAmBc,GAAgBZ,CAAI,qBAGpCc,GAAA,EAA2B,UAAUd,EAAK,gBAAgB,QAAQW,EAAc,QAC/E,UAAA,gBAAAI;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,UAAUhB,EAAK,kBAAkB;AAAA,MAEjC,4BAACiB,GAAA,EAAc,GAAGjB,EAAK,kBAAkB,aAAc,UAAAU,EAAA,CAAS;AAAA,IAAA;AAAA,EAAA,GAEpE;AAEJ;"}

package/dist/partner-hook-utils/form/composeSubmitHandler.d.ts

@@ -10,8 +10,11 @@ import { HookErrorHandling, HookFormInternals } from '../types';
  * allowing hooks with specific form data generics to be passed without casts.
  * `_fieldElementRegistry` is reused directly since its type doesn't depend on
  * the form's generic.
+ *
+ * @public
  */
-interface ComposableFormHookResult {
+export interface ComposableFormHookResult {
+    /** The form surface: the react-hook-form internals used to validate and focus fields. */
     form: {
         hookFormInternals: Pick<HookFormInternals, '_fieldElementRegistry'> & {
             formMethods: {
@@ -23,6 +26,7 @@ interface ComposableFormHookResult {
             };
         };
     };
+    /** The error-handling surface aggregated across the composed forms. */
     errorHandling: HookErrorHandling;
 }
 /**
@@ -35,7 +39,7 @@ interface ComposableFormHookResult {
  *   but no `errorHandling` (fields surface their own inline errors via react-hook-form).
  *
  * @typeParam T - The shape of the form values when a raw `UseFormReturn` is passed.
- * @internal
+ * @public
  */
 export type ComposeSubmitInput<T extends FieldValues = FieldValues> = ComposableFormHookResult | UseFormReturn<T>;
 /**
@@ -68,7 +72,7 @@ export interface ComposeSubmitHandlerResult {
  *
  * The returned `errorHandling` is the same shape every SDK hook returns, so the whole result
  * can be passed back into {@link composeErrorHandler} when you need to add extra
- * `@gusto/embedded-api-v-2026-02-01` queries or screen-level submit state.
+ * `@gusto/embedded-api-v-2026-06-15` queries or screen-level submit state.
  *
  * @typeParam TForms - Tuple of form value shapes, one per slot of `forms`.
  * @param forms - Form hook results and/or raw `UseFormReturn` instances to coordinate.
@@ -95,4 +99,3 @@ export interface ComposeSubmitHandlerResult {
 export declare function composeSubmitHandler<TForms extends readonly FieldValues[]>(forms: readonly [...{
     [K in keyof TForms]: ComposeSubmitInput<TForms[K]>;
 }], onAllValid: () => Promise<void>): ComposeSubmitHandlerResult;
-export {};

package/dist/partner-hook-utils/form/composeSubmitHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"composeSubmitHandler.js","sources":["../../../src/partner-hook-utils/form/composeSubmitHandler.ts"],"sourcesContent":["import type { SyntheticEvent } from 'react'\nimport type { FieldValues, UseFormReturn } from 'react-hook-form'\nimport { composeErrorHandler } from '../composeErrorHandler'\nimport type { HookErrorHandling, HookFormInternals } from '../types'\n\n/**\n * Minimal shape required for a form hook result to participate in `composeSubmitHandler`.\n * Any hook returning `BaseFormHookReady` satisfies this interface.\n *\n * `formMethods` is declared with method-call syntax (rather than reused from\n * `HookFormInternals`) so TypeScript applies bivariant parameter checking,\n * allowing hooks with specific form data generics to be passed without casts.\n * `_fieldElementRegistry` is reused directly since its type doesn't depend on\n * the form's generic.\n */\ninterface ComposableFormHookResult {\n  form: {\n    hookFormInternals: Pick<HookFormInternals, '_fieldElementRegistry'> & {\n      formMethods: {\n        handleSubmit(\n          onValid: () => void,\n          onInvalid?: (errors: Record<string, unknown>) => void,\n        ): () => Promise<void>\n        setFocus(name: string): void\n        formState: { errors: Record<string, unknown> }\n      }\n    }\n  }\n  errorHandling: HookErrorHandling\n}\n\n/**\n * Accepted input for a single slot of `composeSubmitHandler`'s `forms` array.\n *\n * @remarks\n * - SDK form hook results (anything matching `ComposableFormHookResult`) are composed directly.\n * - A raw `react-hook-form` `UseFormReturn<T>` is supported for screen-local auxiliary forms\n *   that don't warrant a dedicated SDK hook. Raw forms contribute validation/focus behavior\n *   but no `errorHandling` (fields surface their own inline errors via react-hook-form).\n *\n * @typeParam T - The shape of the form values when a raw `UseFormReturn` is passed.\n * @internal\n */\nexport type ComposeSubmitInput<T extends FieldValues = FieldValues> =\n  ComposableFormHookResult | UseFormReturn<T>\n\ninterface FormValidationResult {\n  input: ComposeSubmitInput\n  formMethods: FormMethods\n  valid: boolean\n  errors: Record<string, unknown>\n}\n\n/**\n * Result returned by {@link composeSubmitHandler}: a single submit handler that\n * coordinates validation across the composed forms, and aggregated error state.\n *\n * @public\n */\nexport interface ComposeSubmitHandlerResult {\n  /** Submit handler to pass to a form's `onSubmit`. Validates all composed forms before calling `onAllValid`. */\n  handleSubmit: (e: SyntheticEvent) => Promise<void>\n  /** Aggregated error state across all composed SDK form hooks. Pass to {@link composeErrorHandler} for screen-level error surfaces. */\n  errorHandling: HookErrorHandling\n}\n\ntype FormMethods = ComposableFormHookResult['form']['hookFormInternals']['formMethods']\n\nfunction isRawUseForm<T extends FieldValues>(\n  input: ComposeSubmitInput<T>,\n): input is UseFormReturn<T> {\n  return 'handleSubmit' in input && typeof input.handleSubmit === 'function'\n}\n\nfunction extractFormMethods<T extends FieldValues>(input: ComposeSubmitInput<T>): FormMethods {\n  if (isRawUseForm(input)) return input as unknown as FormMethods\n  return input.form.hookFormInternals.formMethods\n}\n\n/**\n * Picks the visually first invalid field across all composed forms using live\n * `getBoundingClientRect()` positions, then focuses its DOM element. Falls back\n * to array-order (first form's first error) when no element can be resolved —\n * raw `UseFormReturn` inputs have no registry, and forms rendered without\n * `SDKFormProvider` or a HookField wrapper won't have their fields registered\n * either, so we let react-hook-form's `setFocus` attempt it instead.\n *\n * Consumes `results` (captured from each form's `onInvalid` callback) rather\n * than reading `formState.errors` — the latter is a proxy that returns `{}`\n * when accessed outside a component subscription.\n */\nfunction focusFirstInvalidAcrossForms(results: FormValidationResult[]): void {\n  type Candidate = {\n    formMethods: FormMethods\n    name: string\n    element: HTMLElement\n  }\n  const candidates: Candidate[] = []\n  for (const { input, formMethods, errors } of results) {\n    if (isRawUseForm(input)) continue\n    const registry = input.form.hookFormInternals._fieldElementRegistry\n    if (!registry) continue\n    for (const name of Object.keys(errors)) {\n      const element = registry.get(name)\n      if (element) {\n        candidates.push({ formMethods, name, element })\n      }\n    }\n  }\n\n  if (candidates.length > 0) {\n    candidates.sort((a, b) => {\n      const ar = a.element.getBoundingClientRect()\n      const br = b.element.getBoundingClientRect()\n      return ar.top - br.top || ar.left - br.left\n    })\n    const winner = candidates[0]!\n    // Focus the DOM element directly. Bypasses react-hook-form's `setFocus`,\n    // which depends on `_fields[name]._f.ref` and isn't reliably populated\n    // when fields are rendered through libraries like react-aria-components.\n    winner.element.focus()\n    return\n  }\n\n  for (const { formMethods, errors } of results) {\n    const firstErrorField = Object.keys(errors)[0]\n    if (firstErrorField) {\n      formMethods.setFocus(firstErrorField)\n      return\n    }\n  }\n}\n\n/**\n * Coordinates validation and submission across multiple form hooks on the same page.\n *\n * @remarks\n * Validates all forms simultaneously via `handleSubmit()`, then focuses the visually first\n * invalid field across all forms (sorted by `getBoundingClientRect()`). Only calls\n * `onAllValid` when every form passes.\n *\n * Uses `handleSubmit` rather than `trigger` so that react-hook-form sets\n * `formState.isSubmitted = true`, which enables `reValidateMode` (default: `onChange`).\n * Without this, errors set by manual `trigger()` calls would never clear as the user types.\n *\n * Each hook passed to `forms` should be initialized with `shouldFocusError: false` so that\n * react-hook-form's built-in per-form focus is disabled and `composeSubmitHandler` can manage\n * cross-form focus instead.\n *\n * The returned `errorHandling` is the same shape every SDK hook returns, so the whole result\n * can be passed back into {@link composeErrorHandler} when you need to add extra\n * `@gusto/embedded-api-v-2026-02-01` queries or screen-level submit state.\n *\n * @typeParam TForms - Tuple of form value shapes, one per slot of `forms`.\n * @param forms - Form hook results and/or raw `UseFormReturn` instances to coordinate.\n * @param onAllValid - Async callback invoked once every form has passed validation.\n * @returns A {@link ComposeSubmitHandlerResult} with a unified `handleSubmit` and aggregated `errorHandling`.\n * @public\n *\n * @example\n * ```tsx\n * const detailsForm = useEmployeeDetailsForm({ employeeId, shouldFocusError: false })\n * const addressForm = useHomeAddressForm({ employeeId, shouldFocusError: false })\n *\n * const { handleSubmit, errorHandling } = composeSubmitHandler(\n *   [detailsForm, addressForm],\n *   async () => {\n *     await detailsForm.actions.onSubmit()\n *     await addressForm.actions.onSubmit()\n *   },\n * )\n *\n * return <form onSubmit={handleSubmit}>...</form>\n * ```\n */\nexport function composeSubmitHandler<TForms extends readonly FieldValues[]>(\n  forms: readonly [...{ [K in keyof TForms]: ComposeSubmitInput<TForms[K]> }],\n  onAllValid: () => Promise<void>,\n): ComposeSubmitHandlerResult {\n  const errorSources = forms.filter((form): form is ComposableFormHookResult => !isRawUseForm(form))\n\n  const handleSubmit = async (e: SyntheticEvent) => {\n    e.preventDefault()\n\n    const validationResults = await Promise.all(\n      forms.map(\n        input =>\n          new Promise<FormValidationResult>(resolve => {\n            const formMethods = extractFormMethods(input)\n            void formMethods.handleSubmit(\n              () => {\n                resolve({ input, formMethods, valid: true, errors: {} })\n              },\n              errors => {\n                resolve({ input, formMethods, valid: false, errors })\n              },\n            )()\n          }),\n      ),\n    )\n\n    const allValid = validationResults.every(r => r.valid)\n\n    if (!allValid) {\n      focusFirstInvalidAcrossForms(validationResults)\n      return\n    }\n\n    await onAllValid()\n  }\n\n  const errorHandling = composeErrorHandler(errorSources)\n\n  return { handleSubmit, errorHandling }\n}\n"],"names":["isRawUseForm","input","extractFormMethods","focusFirstInvalidAcrossForms","results","candidates","formMethods","errors","registry","name","element","a","b","ar","br","firstErrorField","composeSubmitHandler","forms","onAllValid","errorSources","form","handleSubmit","e","validationResults","resolve","r","errorHandling","composeErrorHandler"],"mappings":";AAoEA,SAASA,EACPC,GAC2B;AAC3B,SAAO,kBAAkBA,KAAS,OAAOA,EAAM,gBAAiB;AAClE;AAEA,SAASC,EAA0CD,GAA2C;AAC5F,SAAID,EAAaC,CAAK,IAAUA,IACzBA,EAAM,KAAK,kBAAkB;AACtC;AAcA,SAASE,EAA6BC,GAAuC;AAM3E,QAAMC,IAA0B,CAAA;AAChC,aAAW,EAAE,OAAAJ,GAAO,aAAAK,GAAa,QAAAC,EAAA,KAAYH,GAAS;AACpD,QAAIJ,EAAaC,CAAK,EAAG;AACzB,UAAMO,IAAWP,EAAM,KAAK,kBAAkB;AAC9C,QAAKO;AACL,iBAAWC,KAAQ,OAAO,KAAKF,CAAM,GAAG;AACtC,cAAMG,IAAUF,EAAS,IAAIC,CAAI;AACjC,QAAIC,KACFL,EAAW,KAAK,EAAE,aAAAC,GAAa,MAAAG,GAAM,SAAAC,GAAS;AAAA,MAElD;AAAA,EACF;AAEA,MAAIL,EAAW,SAAS,GAAG;AACzB,IAAAA,EAAW,KAAK,CAACM,GAAGC,MAAM;AACxB,YAAMC,IAAKF,EAAE,QAAQ,sBAAA,GACfG,IAAKF,EAAE,QAAQ,sBAAA;AACrB,aAAOC,EAAG,MAAMC,EAAG,OAAOD,EAAG,OAAOC,EAAG;AAAA,IACzC,CAAC,GACcT,EAAW,CAAC,EAIpB,QAAQ,MAAA;AACf;AAAA,EACF;AAEA,aAAW,EAAE,aAAAC,GAAa,QAAAC,EAAA,KAAYH,GAAS;AAC7C,UAAMW,IAAkB,OAAO,KAAKR,CAAM,EAAE,CAAC;AAC7C,QAAIQ,GAAiB;AACnB,MAAAT,EAAY,SAASS,CAAe;AACpC;AAAA,IACF;AAAA,EACF;AACF;AA4CO,SAASC,EACdC,GACAC,GAC4B;AAC5B,QAAMC,IAAeF,EAAM,OAAO,CAACG,MAA2C,CAACpB,EAAaoB,CAAI,CAAC,GAE3FC,IAAe,OAAOC,MAAsB;AAChD,IAAAA,EAAE,eAAA;AAEF,UAAMC,IAAoB,MAAM,QAAQ;AAAA,MACtCN,EAAM;AAAA,QACJ,CAAAhB,MACE,IAAI,QAA8B,CAAAuB,MAAW;AAC3C,gBAAMlB,IAAcJ,EAAmBD,CAAK;AAC5C,UAAKK,EAAY;AAAA,YACf,MAAM;AACJ,cAAAkB,EAAQ,EAAE,OAAAvB,GAAO,aAAAK,GAAa,OAAO,IAAM,QAAQ,CAAA,GAAI;AAAA,YACzD;AAAA,YACA,CAAAC,MAAU;AACR,cAAAiB,EAAQ,EAAE,OAAAvB,GAAO,aAAAK,GAAa,OAAO,IAAO,QAAAC,GAAQ;AAAA,YACtD;AAAA,UAAA,EACF;AAAA,QACF,CAAC;AAAA,MAAA;AAAA,IACL;AAKF,QAAI,CAFagB,EAAkB,MAAM,CAAAE,MAAKA,EAAE,KAAK,GAEtC;AACb,MAAAtB,EAA6BoB,CAAiB;AAC9C;AAAA,IACF;AAEA,UAAML,EAAA;AAAA,EACR,GAEMQ,IAAgBC,EAAoBR,CAAY;AAEtD,SAAO,EAAE,cAAAE,GAAc,eAAAK,EAAA;AACzB;"}
+{"version":3,"file":"composeSubmitHandler.js","sources":["../../../src/partner-hook-utils/form/composeSubmitHandler.ts"],"sourcesContent":["import type { SyntheticEvent } from 'react'\nimport type { FieldValues, UseFormReturn } from 'react-hook-form'\nimport { composeErrorHandler } from '../composeErrorHandler'\nimport type { HookErrorHandling, HookFormInternals } from '../types'\nimport type { FieldElementRegistry } from '@/components/Common/Fields/hooks/fieldElementRegistry'\n\n/**\n * Minimal shape required for a form hook result to participate in `composeSubmitHandler`.\n * Any hook returning `BaseFormHookReady` satisfies this interface.\n *\n * `formMethods` is declared with method-call syntax (rather than reused from\n * `HookFormInternals`) so TypeScript applies bivariant parameter checking,\n * allowing hooks with specific form data generics to be passed without casts.\n * `_fieldElementRegistry` is reused directly since its type doesn't depend on\n * the form's generic.\n *\n * @public\n */\nexport interface ComposableFormHookResult {\n  /** The form surface: the react-hook-form internals used to validate and focus fields. */\n  form: {\n    hookFormInternals: Pick<HookFormInternals, '_fieldElementRegistry'> & {\n      formMethods: {\n        handleSubmit(\n          onValid: () => void,\n          onInvalid?: (errors: Record<string, unknown>) => void,\n        ): () => Promise<void>\n        setFocus(name: string): void\n        formState: { errors: Record<string, unknown> }\n      }\n    }\n  }\n  /** The error-handling surface aggregated across the composed forms. */\n  errorHandling: HookErrorHandling\n}\n\n/**\n * Accepted input for a single slot of `composeSubmitHandler`'s `forms` array.\n *\n * @remarks\n * - SDK form hook results (anything matching `ComposableFormHookResult`) are composed directly.\n * - A raw `react-hook-form` `UseFormReturn<T>` is supported for screen-local auxiliary forms\n *   that don't warrant a dedicated SDK hook. Raw forms contribute validation/focus behavior\n *   but no `errorHandling` (fields surface their own inline errors via react-hook-form).\n *\n * @typeParam T - The shape of the form values when a raw `UseFormReturn` is passed.\n * @public\n */\nexport type ComposeSubmitInput<T extends FieldValues = FieldValues> =\n  ComposableFormHookResult | UseFormReturn<T>\n\ninterface FormValidationResult {\n  input: ComposeSubmitInput\n  formMethods: FormMethods\n  valid: boolean\n  errors: Record<string, unknown>\n}\n\n/**\n * Result returned by {@link composeSubmitHandler}: a single submit handler that\n * coordinates validation across the composed forms, and aggregated error state.\n *\n * @public\n */\nexport interface ComposeSubmitHandlerResult {\n  /** Submit handler to pass to a form's `onSubmit`. Validates all composed forms before calling `onAllValid`. */\n  handleSubmit: (e: SyntheticEvent) => Promise<void>\n  /** Aggregated error state across all composed SDK form hooks. Pass to {@link composeErrorHandler} for screen-level error surfaces. */\n  errorHandling: HookErrorHandling\n}\n\ntype FormMethods = ComposableFormHookResult['form']['hookFormInternals']['formMethods']\n\nfunction isRawUseForm<T extends FieldValues>(\n  input: ComposeSubmitInput<T>,\n): input is UseFormReturn<T> {\n  return 'handleSubmit' in input && typeof input.handleSubmit === 'function'\n}\n\nfunction extractFormMethods<T extends FieldValues>(input: ComposeSubmitInput<T>): FormMethods {\n  if (isRawUseForm(input)) return input as unknown as FormMethods\n  return input.form.hookFormInternals.formMethods\n}\n\n/**\n * Picks the visually first invalid field across all composed forms using live\n * `getBoundingClientRect()` positions, then focuses its DOM element. Falls back\n * to array-order (first form's first error) when no element can be resolved —\n * raw `UseFormReturn` inputs have no registry, and forms rendered without\n * `SDKFormProvider` or a HookField wrapper won't have their fields registered\n * either, so we let react-hook-form's `setFocus` attempt it instead.\n *\n * Consumes `results` (captured from each form's `onInvalid` callback) rather\n * than reading `formState.errors` — the latter is a proxy that returns `{}`\n * when accessed outside a component subscription.\n */\nfunction focusFirstInvalidAcrossForms(results: FormValidationResult[]): void {\n  type Candidate = {\n    formMethods: FormMethods\n    name: string\n    element: HTMLElement\n  }\n  const candidates: Candidate[] = []\n  for (const { input, formMethods, errors } of results) {\n    if (isRawUseForm(input)) continue\n    const registry = input.form.hookFormInternals._fieldElementRegistry as\n      FieldElementRegistry | undefined\n    if (!registry) continue\n    for (const name of Object.keys(errors)) {\n      const element = registry.get(name)\n      if (element) {\n        candidates.push({ formMethods, name, element })\n      }\n    }\n  }\n\n  if (candidates.length > 0) {\n    candidates.sort((a, b) => {\n      const ar = a.element.getBoundingClientRect()\n      const br = b.element.getBoundingClientRect()\n      return ar.top - br.top || ar.left - br.left\n    })\n    const winner = candidates[0]!\n    // Focus the DOM element directly. Bypasses react-hook-form's `setFocus`,\n    // which depends on `_fields[name]._f.ref` and isn't reliably populated\n    // when fields are rendered through libraries like react-aria-components.\n    winner.element.focus()\n    return\n  }\n\n  for (const { formMethods, errors } of results) {\n    const firstErrorField = Object.keys(errors)[0]\n    if (firstErrorField) {\n      formMethods.setFocus(firstErrorField)\n      return\n    }\n  }\n}\n\n/**\n * Coordinates validation and submission across multiple form hooks on the same page.\n *\n * @remarks\n * Validates all forms simultaneously via `handleSubmit()`, then focuses the visually first\n * invalid field across all forms (sorted by `getBoundingClientRect()`). Only calls\n * `onAllValid` when every form passes.\n *\n * Uses `handleSubmit` rather than `trigger` so that react-hook-form sets\n * `formState.isSubmitted = true`, which enables `reValidateMode` (default: `onChange`).\n * Without this, errors set by manual `trigger()` calls would never clear as the user types.\n *\n * Each hook passed to `forms` should be initialized with `shouldFocusError: false` so that\n * react-hook-form's built-in per-form focus is disabled and `composeSubmitHandler` can manage\n * cross-form focus instead.\n *\n * The returned `errorHandling` is the same shape every SDK hook returns, so the whole result\n * can be passed back into {@link composeErrorHandler} when you need to add extra\n * `@gusto/embedded-api-v-2026-06-15` queries or screen-level submit state.\n *\n * @typeParam TForms - Tuple of form value shapes, one per slot of `forms`.\n * @param forms - Form hook results and/or raw `UseFormReturn` instances to coordinate.\n * @param onAllValid - Async callback invoked once every form has passed validation.\n * @returns A {@link ComposeSubmitHandlerResult} with a unified `handleSubmit` and aggregated `errorHandling`.\n * @public\n *\n * @example\n * ```tsx\n * const detailsForm = useEmployeeDetailsForm({ employeeId, shouldFocusError: false })\n * const addressForm = useHomeAddressForm({ employeeId, shouldFocusError: false })\n *\n * const { handleSubmit, errorHandling } = composeSubmitHandler(\n *   [detailsForm, addressForm],\n *   async () => {\n *     await detailsForm.actions.onSubmit()\n *     await addressForm.actions.onSubmit()\n *   },\n * )\n *\n * return <form onSubmit={handleSubmit}>...</form>\n * ```\n */\nexport function composeSubmitHandler<TForms extends readonly FieldValues[]>(\n  forms: readonly [...{ [K in keyof TForms]: ComposeSubmitInput<TForms[K]> }],\n  onAllValid: () => Promise<void>,\n): ComposeSubmitHandlerResult {\n  const errorSources = forms.filter((form): form is ComposableFormHookResult => !isRawUseForm(form))\n\n  const handleSubmit = async (e: SyntheticEvent) => {\n    e.preventDefault()\n\n    const validationResults = await Promise.all(\n      forms.map(\n        input =>\n          new Promise<FormValidationResult>(resolve => {\n            const formMethods = extractFormMethods(input)\n            void formMethods.handleSubmit(\n              () => {\n                resolve({ input, formMethods, valid: true, errors: {} })\n              },\n              errors => {\n                resolve({ input, formMethods, valid: false, errors })\n              },\n            )()\n          }),\n      ),\n    )\n\n    const allValid = validationResults.every(r => r.valid)\n\n    if (!allValid) {\n      focusFirstInvalidAcrossForms(validationResults)\n      return\n    }\n\n    await onAllValid()\n  }\n\n  const errorHandling = composeErrorHandler(errorSources)\n\n  return { handleSubmit, errorHandling }\n}\n"],"names":["isRawUseForm","input","extractFormMethods","focusFirstInvalidAcrossForms","results","candidates","formMethods","errors","registry","name","element","a","b","ar","br","firstErrorField","composeSubmitHandler","forms","onAllValid","errorSources","form","handleSubmit","e","validationResults","resolve","r","errorHandling","composeErrorHandler"],"mappings":";AAyEA,SAASA,EACPC,GAC2B;AAC3B,SAAO,kBAAkBA,KAAS,OAAOA,EAAM,gBAAiB;AAClE;AAEA,SAASC,EAA0CD,GAA2C;AAC5F,SAAID,EAAaC,CAAK,IAAUA,IACzBA,EAAM,KAAK,kBAAkB;AACtC;AAcA,SAASE,EAA6BC,GAAuC;AAM3E,QAAMC,IAA0B,CAAA;AAChC,aAAW,EAAE,OAAAJ,GAAO,aAAAK,GAAa,QAAAC,EAAA,KAAYH,GAAS;AACpD,QAAIJ,EAAaC,CAAK,EAAG;AACzB,UAAMO,IAAWP,EAAM,KAAK,kBAAkB;AAE9C,QAAKO;AACL,iBAAWC,KAAQ,OAAO,KAAKF,CAAM,GAAG;AACtC,cAAMG,IAAUF,EAAS,IAAIC,CAAI;AACjC,QAAIC,KACFL,EAAW,KAAK,EAAE,aAAAC,GAAa,MAAAG,GAAM,SAAAC,GAAS;AAAA,MAElD;AAAA,EACF;AAEA,MAAIL,EAAW,SAAS,GAAG;AACzB,IAAAA,EAAW,KAAK,CAACM,GAAGC,MAAM;AACxB,YAAMC,IAAKF,EAAE,QAAQ,sBAAA,GACfG,IAAKF,EAAE,QAAQ,sBAAA;AACrB,aAAOC,EAAG,MAAMC,EAAG,OAAOD,EAAG,OAAOC,EAAG;AAAA,IACzC,CAAC,GACcT,EAAW,CAAC,EAIpB,QAAQ,MAAA;AACf;AAAA,EACF;AAEA,aAAW,EAAE,aAAAC,GAAa,QAAAC,EAAA,KAAYH,GAAS;AAC7C,UAAMW,IAAkB,OAAO,KAAKR,CAAM,EAAE,CAAC;AAC7C,QAAIQ,GAAiB;AACnB,MAAAT,EAAY,SAASS,CAAe;AACpC;AAAA,IACF;AAAA,EACF;AACF;AA4CO,SAASC,EACdC,GACAC,GAC4B;AAC5B,QAAMC,IAAeF,EAAM,OAAO,CAACG,MAA2C,CAACpB,EAAaoB,CAAI,CAAC,GAE3FC,IAAe,OAAOC,MAAsB;AAChD,IAAAA,EAAE,eAAA;AAEF,UAAMC,IAAoB,MAAM,QAAQ;AAAA,MACtCN,EAAM;AAAA,QACJ,CAAAhB,MACE,IAAI,QAA8B,CAAAuB,MAAW;AAC3C,gBAAMlB,IAAcJ,EAAmBD,CAAK;AAC5C,UAAKK,EAAY;AAAA,YACf,MAAM;AACJ,cAAAkB,EAAQ,EAAE,OAAAvB,GAAO,aAAAK,GAAa,OAAO,IAAM,QAAQ,CAAA,GAAI;AAAA,YACzD;AAAA,YACA,CAAAC,MAAU;AACR,cAAAiB,EAAQ,EAAE,OAAAvB,GAAO,aAAAK,GAAa,OAAO,IAAO,QAAAC,GAAQ;AAAA,YACtD;AAAA,UAAA,EACF;AAAA,QACF,CAAC;AAAA,MAAA;AAAA,IACL;AAKF,QAAI,CAFagB,EAAkB,MAAM,CAAAE,MAAKA,EAAE,KAAK,GAEtC;AACb,MAAAtB,EAA6BoB,CAAiB;AAC9C;AAAA,IACF;AAEA,UAAML,EAAA;AAAA,EACR,GAEMQ,IAAgBC,EAAoBR,CAAY;AAEtD,SAAO,EAAE,cAAAE,GAAc,eAAAK,EAAA;AACzB;"}

package/dist/partner-hook-utils/form/fields/index.d.ts

@@ -1,3 +1,4 @@
+export type { InputProps } from '../../../components/Common/UI/Input/InputTypes';
 export { TextInputHookField, type TextInputHookFieldProps } from './TextInputHookField';
 export { SelectHookField, type SelectHookFieldProps } from './SelectHookField';
 export { CheckboxHookField, type CheckboxHookFieldProps } from './CheckboxHookField';

package/dist/partner-hook-utils/form/index.d.ts

@@ -1,6 +1,6 @@
 export type { FieldMetadata, FieldMetadataWithOptions, FieldsMetadata, ValidationMessages, BaseFieldProps, HookFieldProps, } from '../types';
 export type { FormFieldsMetadataContextValue } from './FormFieldsMetadataContext';
 export { FormFieldsMetadataProvider } from './FormFieldsMetadataProvider';
-export { SDKFormProvider } from './SDKFormProvider';
-export { composeSubmitHandler } from './composeSubmitHandler';
-export { TextInputHookField, type TextInputHookFieldProps, SelectHookField, type SelectHookFieldProps, CheckboxHookField, type CheckboxHookFieldProps, NumberInputHookField, type NumberInputHookFieldProps, DatePickerHookField, type DatePickerHookFieldProps, RadioGroupHookField, type RadioGroupHookFieldProps, type SharedFieldLayoutProps, type SharedHorizontalFieldLayoutProps, type TextInputProps, type SelectProps, type SelectOption, type CheckboxProps, type NumberInputProps, type DatePickerProps, type RadioGroupProps, type RadioGroupOption, SwitchHookField, type SwitchHookFieldProps, type SwitchProps, } from './fields';
+export { SDKFormProvider, type SDKFormProviderProps } from './SDKFormProvider';
+export { composeSubmitHandler, type ComposeSubmitInput, type ComposeSubmitHandlerResult, type ComposableFormHookResult, } from './composeSubmitHandler';
+export { type InputProps, TextInputHookField, type TextInputHookFieldProps, SelectHookField, type SelectHookFieldProps, CheckboxHookField, type CheckboxHookFieldProps, NumberInputHookField, type NumberInputHookFieldProps, DatePickerHookField, type DatePickerHookFieldProps, RadioGroupHookField, type RadioGroupHookFieldProps, type SharedFieldLayoutProps, type SharedHorizontalFieldLayoutProps, type TextInputProps, type SelectProps, type SelectOption, type CheckboxProps, type NumberInputProps, type DatePickerProps, type RadioGroupProps, type RadioGroupOption, SwitchHookField, type SwitchHookFieldProps, type SwitchProps, } from './fields';

package/dist/partner-hook-utils/form/useHookFieldResolution.js.map

@@ -1 +1 @@
-{"version":3,"file":"useHookFieldResolution.js","sources":["../../../src/partner-hook-utils/form/useHookFieldResolution.ts"],"sourcesContent":["import type { Control } from 'react-hook-form'\nimport { useFormState } from 'react-hook-form'\nimport type { FieldsMetadata, ValidationMessages, FormHookResult } from '../types'\nimport { useFormFieldsMetadataContext } from './FormFieldsMetadataContext'\nimport { resolveFieldError } from './resolveFieldError'\nimport type { FieldElementRegistry } from '@/components/Common/Fields/hooks/fieldElementRegistry'\n\ninterface HookFieldResolution {\n  metadata: FieldsMetadata\n  control: Control | undefined\n  errorMessage: string | undefined\n  fieldElementRegistry: FieldElementRegistry | undefined\n}\n\n/**\n * Resolves all data a HookField needs from either a `formHookResult` prop or the standard context providers (FormProvider + FormFieldsMetadataProvider).\n *\n * @remarks\n * When `formHookResult` is provided, metadata/errors/control/registry are read\n * from the prop — no context providers required. When absent, falls back to\n * the existing context-based path.\n *\n * Uses `useFormState` to establish a proper RHF subscription for error updates.\n * When `control` is provided (prop path), useFormState subscribes directly via\n * the control object. When absent (context path), it falls back to useFormContext\n * internally. The `name` parameter scopes the subscription to this field.\n *\n * `fieldElementRegistry` is forwarded so HookFields in the prop-based path can\n * self-publish the registry via `withFieldElementRegistry`. In the\n * `SDKFormProvider` path the wrap is a no-op (no registry on the prop) and the\n * outer provider's registry remains in scope.\n *\n * @typeParam TErrorCode - Required error codes the field can produce.\n * @typeParam TOptionalErrorCode - Optional error codes that only apply in some configurations.\n * @param name - Form-field name to resolve metadata, errors, and control for.\n * @param formHookResult - Form hook result passed via the `formHookResult` prop, or `undefined` to read from context.\n * @param validationMessages - Map of error codes to display strings, forwarded to error resolution.\n * @returns The metadata entry, RHF `control`, resolved error message, and field element registry for this field.\n * @internal\n */\nexport function useHookFieldResolution<\n  TErrorCode extends string,\n  TOptionalErrorCode extends string = never,\n>(\n  name: string,\n  formHookResult: FormHookResult | undefined,\n  validationMessages?: ValidationMessages<TErrorCode, TOptionalErrorCode>,\n): HookFieldResolution {\n  const metadataContext = useFormFieldsMetadataContext()\n\n  const metadata = formHookResult?.form.fieldsMetadata ?? metadataContext?.metadata ?? {}\n\n  const control = formHookResult?.form.hookFormInternals.formMethods.control as Control | undefined\n\n  const { errors: formErrors } = useFormState({ control, name })\n\n  const sdkErrors = formHookResult\n    ? formHookResult.errorHandling.errors\n    : (metadataContext?.errors ?? [])\n\n  const errorMessage = resolveFieldError(name, formErrors, sdkErrors, validationMessages)\n\n  const fieldElementRegistry = formHookResult?.form.hookFormInternals._fieldElementRegistry\n\n  return { metadata, control, errorMessage, fieldElementRegistry }\n}\n"],"names":["useHookFieldResolution","name","formHookResult","validationMessages","metadataContext","useFormFieldsMetadataContext","metadata","control","formErrors","useFormState","sdkErrors","errorMessage","resolveFieldError","fieldElementRegistry"],"mappings":";;;AAwCO,SAASA,EAIdC,GACAC,GACAC,GACqB;AACrB,QAAMC,IAAkBC,EAAA,GAElBC,IAAWJ,GAAgB,KAAK,kBAAkBE,GAAiB,YAAY,CAAA,GAE/EG,IAAUL,GAAgB,KAAK,kBAAkB,YAAY,SAE7D,EAAE,QAAQM,EAAA,IAAeC,EAAa,EAAE,SAAAF,GAAS,MAAAN,GAAM,GAEvDS,IAAYR,IACdA,EAAe,cAAc,SAC5BE,GAAiB,UAAU,CAAA,GAE1BO,IAAeC,EAAkBX,GAAMO,GAAYE,GAAWP,CAAkB,GAEhFU,IAAuBX,GAAgB,KAAK,kBAAkB;AAEpE,SAAO,EAAE,UAAAI,GAAU,SAAAC,GAAS,cAAAI,GAAc,sBAAAE,EAAA;AAC5C;"}
+{"version":3,"file":"useHookFieldResolution.js","sources":["../../../src/partner-hook-utils/form/useHookFieldResolution.ts"],"sourcesContent":["import type { Control } from 'react-hook-form'\nimport { useFormState } from 'react-hook-form'\nimport type { FieldsMetadata, ValidationMessages, FormHookResult } from '../types'\nimport { useFormFieldsMetadataContext } from './FormFieldsMetadataContext'\nimport { resolveFieldError } from './resolveFieldError'\nimport type { FieldElementRegistry } from '@/components/Common/Fields/hooks/fieldElementRegistry'\n\ninterface HookFieldResolution {\n  metadata: FieldsMetadata\n  control: Control | undefined\n  errorMessage: string | undefined\n  fieldElementRegistry: FieldElementRegistry | undefined\n}\n\n/**\n * Resolves all data a HookField needs from either a `formHookResult` prop or the standard context providers (FormProvider + FormFieldsMetadataProvider).\n *\n * @remarks\n * When `formHookResult` is provided, metadata/errors/control/registry are read\n * from the prop — no context providers required. When absent, falls back to\n * the existing context-based path.\n *\n * Uses `useFormState` to establish a proper RHF subscription for error updates.\n * When `control` is provided (prop path), useFormState subscribes directly via\n * the control object. When absent (context path), it falls back to useFormContext\n * internally. The `name` parameter scopes the subscription to this field.\n *\n * `fieldElementRegistry` is forwarded so HookFields in the prop-based path can\n * self-publish the registry via `withFieldElementRegistry`. In the\n * `SDKFormProvider` path the wrap is a no-op (no registry on the prop) and the\n * outer provider's registry remains in scope.\n *\n * @typeParam TErrorCode - Required error codes the field can produce.\n * @typeParam TOptionalErrorCode - Optional error codes that only apply in some configurations.\n * @param name - Form-field name to resolve metadata, errors, and control for.\n * @param formHookResult - Form hook result passed via the `formHookResult` prop, or `undefined` to read from context.\n * @param validationMessages - Map of error codes to display strings, forwarded to error resolution.\n * @returns The metadata entry, RHF `control`, resolved error message, and field element registry for this field.\n * @internal\n */\nexport function useHookFieldResolution<\n  TErrorCode extends string,\n  TOptionalErrorCode extends string = never,\n>(\n  name: string,\n  formHookResult: FormHookResult | undefined,\n  validationMessages?: ValidationMessages<TErrorCode, TOptionalErrorCode>,\n): HookFieldResolution {\n  const metadataContext = useFormFieldsMetadataContext()\n\n  const metadata = formHookResult?.form.fieldsMetadata ?? metadataContext?.metadata ?? {}\n\n  const control = formHookResult?.form.hookFormInternals.formMethods.control as Control | undefined\n\n  const { errors: formErrors } = useFormState({ control, name })\n\n  const sdkErrors = formHookResult\n    ? formHookResult.errorHandling.errors\n    : (metadataContext?.errors ?? [])\n\n  const errorMessage = resolveFieldError(name, formErrors, sdkErrors, validationMessages)\n\n  const fieldElementRegistry = formHookResult?.form.hookFormInternals._fieldElementRegistry as\n    FieldElementRegistry | undefined\n\n  return { metadata, control, errorMessage, fieldElementRegistry }\n}\n"],"names":["useHookFieldResolution","name","formHookResult","validationMessages","metadataContext","useFormFieldsMetadataContext","metadata","control","formErrors","useFormState","sdkErrors","errorMessage","resolveFieldError","fieldElementRegistry"],"mappings":";;;AAwCO,SAASA,EAIdC,GACAC,GACAC,GACqB;AACrB,QAAMC,IAAkBC,EAAA,GAElBC,IAAWJ,GAAgB,KAAK,kBAAkBE,GAAiB,YAAY,CAAA,GAE/EG,IAAUL,GAAgB,KAAK,kBAAkB,YAAY,SAE7D,EAAE,QAAQM,EAAA,IAAeC,EAAa,EAAE,SAAAF,GAAS,MAAAN,GAAM,GAEvDS,IAAYR,IACdA,EAAe,cAAc,SAC5BE,GAAiB,UAAU,CAAA,GAE1BO,IAAeC,EAAkBX,GAAMO,GAAYE,GAAWP,CAAkB,GAEhFU,IAAuBX,GAAgB,KAAK,kBAAkB;AAGpE,SAAO,EAAE,UAAAI,GAAU,SAAAC,GAAS,cAAAI,GAAc,sBAAAE,EAAA;AAC5C;"}

package/dist/partner-hook-utils/index.d.ts

@@ -1,4 +1,4 @@
 export * from './types';
-export { composeErrorHandler, type MixedErrorSource, type SubmitStateForErrorHandling, } from './composeErrorHandler';
+export { composeErrorHandler, type MixedErrorSource, type SubmitStateForErrorHandling, type QueryWithRefetch, } from './composeErrorHandler';
 export { collectErrors } from './collectErrors';
 export * from './form';

package/dist/partner-hook-utils/types.d.ts

@@ -1,6 +1,5 @@
 import { default as React } from 'react';
 import { UseFormReturn, FieldValues } from 'react-hook-form';
-import { FieldElementRegistry } from '../components/Common/Fields/hooks/fieldElementRegistry';
 import { SDKError } from '../types/sdkError';
 /**
  * Per-field metadata published by a form hook for the matching field component.
@@ -121,9 +120,13 @@ export interface HookFormInternals<TFormData extends FieldValues = FieldValues>
      * focus the visually first invalid field across multiple composed forms.
      * `SDKFormProvider` and the `withFieldElementRegistry` HookField wrapper
      * publish it via context for `useField` to populate.
+     *
+     * Typed `unknown` so the internal `FieldElementRegistry` shape never reaches
+     * the public API surface; the SDK-internal readers cast it back to the
+     * concrete type.
      * @internal
      */
-    _fieldElementRegistry?: FieldElementRegistry;
+    _fieldElementRegistry?: unknown;
 }
 /**
  * Discriminated union member returned by a hook while async data is being fetched.
@@ -270,7 +273,8 @@ export type FormHookResult = {
             formMethods: {
                 control: unknown;
             };
-            _fieldElementRegistry?: FieldElementRegistry;
+            /** @internal */
+            _fieldElementRegistry?: unknown;
         };
     };
 };

package/dist/shared/constants.d.ts

@@ -1,4 +1,4 @@
-import { ContractorOnboardingStatus1 } from '@gusto/embedded-api/models/components/contractor';
+import { OnboardingStatus as ContractorOnboardingStatus1 } from '@gusto/embedded-api/models/components/contractor';
 /**
  * Event keys emitted by employee-related components.
  *
@@ -786,7 +786,7 @@ export declare const EmployeeOnboardingStatus: {
  *
  * @public
  */
-export declare const EmployeeSelfOnboardingStatuses: Set<"self_onboarding_invited" | "self_onboarding_invited_started" | "self_onboarding_invited_overdue">;
+export declare const EmployeeSelfOnboardingStatuses: Set<string>;
 /**
  * Map of contractor onboarding status values returned by the Gusto API.
  *