@gusto/embedded-react-sdk 0.44.2 → 0.45.0

package/dist/components/Employee/PaymentMethod/shared/usePaymentMethodList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePaymentMethodList.js","sources":["../../../../../src/components/Employee/PaymentMethod/shared/usePaymentMethodList.ts"],"sourcesContent":["import type { EmployeeBankAccount } from '@gusto/embedded-api/models/components/employeebankaccount'\nimport type { EmployeePaymentMethod } from '@gusto/embedded-api/models/components/employeepaymentmethod'\nimport { useEmployeePaymentMethodDeleteBankAccountMutation } from '@gusto/embedded-api/react-query/employeePaymentMethodDeleteBankAccount'\nimport { useEmployeePaymentMethodsGetBankAccounts } from '@gusto/embedded-api/react-query/employeePaymentMethodsGetBankAccounts'\nimport { useEmployeePaymentMethodGet } from '@gusto/embedded-api/react-query/employeePaymentMethodGet'\nimport { useEmployeePaymentMethodUpdateMutation } from '@gusto/embedded-api/react-query/employeePaymentMethodUpdate'\nimport { useEffect, useRef } from 'react'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport { useBaseSubmit } from '@/components/Base/useBaseSubmit'\nimport type { BaseHookReady, HookLoadingResult, HookSubmitResult } from '@/partner-hook-utils/types'\nimport { SPLIT_BY } from '@/shared/constants'\n\nexport interface UsePaymentMethodListParams {\n  employeeId: string\n}\n\nexport interface UsePaymentMethodListReady extends BaseHookReady<\n  { paymentMethod: EmployeePaymentMethod; bankAccounts: EmployeeBankAccount[] },\n  { isFetching: boolean; isPending: boolean; deletePendingBankAccountUuid?: string }\n> {\n  actions: {\n    onDelete: (bankAccountUuid: string) => Promise<HookSubmitResult<unknown> | undefined>\n  }\n}\n\nexport type UsePaymentMethodListResult = HookLoadingResult | UsePaymentMethodListReady\n\nexport function usePaymentMethodList({\n  employeeId,\n}: UsePaymentMethodListParams): UsePaymentMethodListResult {\n  const paymentMethodQuery = useEmployeePaymentMethodGet({ employeeId })\n  const bankAccountsQuery = useEmployeePaymentMethodsGetBankAccounts({ employeeId })\n\n  const paymentMethod = paymentMethodQuery.data?.employeePaymentMethod\n  const bankAccounts = bankAccountsQuery.data?.employeeBankAccounts\n\n  const deleteBankAccountMutation = useEmployeePaymentMethodDeleteBankAccountMutation()\n  const { mutateAsync: mutatePaymentMethod } = useEmployeePaymentMethodUpdateMutation()\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('PaymentMethodList')\n\n  const normalizingRef = useRef(false)\n  // Normalise single-account direct deposit to 100% on mount, skipping if already normalized\n  // or if a normalization mutation is already in-flight (prevents version-conflict 409s).\n  useEffect(() => {\n    if (!paymentMethod) return\n    const firstSplit = paymentMethod.splits?.[0]\n    const alreadyNormalized =\n      firstSplit?.splitAmount === 100 && paymentMethod.splitBy === SPLIT_BY.percentage\n    if (\n      paymentMethod.splits?.length === 1 &&\n      paymentMethod.type === 'Direct Deposit' &&\n      !alreadyNormalized &&\n      !normalizingRef.current\n    ) {\n      normalizingRef.current = true\n      void (async () => {\n        try {\n          await mutatePaymentMethod({\n            request: {\n              employeeId,\n              requestBody: {\n                splitBy: SPLIT_BY.percentage,\n                splits: paymentMethod.splits!.map(split => ({\n                  ...split,\n                  splitAmount: 100,\n                  priority: 1,\n                })),\n                version: paymentMethod.version as string,\n                type: 'Direct Deposit',\n              },\n            },\n          })\n        } finally {\n          normalizingRef.current = false\n        }\n      })()\n    }\n  }, [employeeId, paymentMethod, mutatePaymentMethod])\n\n  const errorHandling = composeErrorHandler([paymentMethodQuery, bankAccountsQuery], {\n    submitError,\n    setSubmitError,\n  })\n\n  const onDelete = async (\n    bankAccountUuid: string,\n  ): Promise<HookSubmitResult<unknown> | undefined> => {\n    let submitResult: HookSubmitResult<unknown> | undefined\n    await baseSubmitHandler(bankAccountUuid, async uuid => {\n      const data = await deleteBankAccountMutation.mutateAsync({\n        request: { employeeId, bankAccountUuid: uuid },\n      })\n      submitResult = { mode: 'update', data }\n    })\n    return submitResult\n  }\n\n  const deletePendingBankAccountUuid = deleteBankAccountMutation.isPending\n    ? deleteBankAccountMutation.variables.request.bankAccountUuid\n    : undefined\n\n  if (\n    paymentMethodQuery.isLoading ||\n    bankAccountsQuery.isLoading ||\n    !paymentMethod ||\n    !bankAccounts\n  ) {\n    return { isLoading: true, errorHandling }\n  }\n\n  return {\n    isLoading: false,\n    data: { paymentMethod, bankAccounts },\n    status: {\n      isFetching: paymentMethodQuery.isFetching || bankAccountsQuery.isFetching,\n      isPending: deleteBankAccountMutation.isPending,\n      deletePendingBankAccountUuid,\n    },\n    actions: { onDelete },\n    errorHandling,\n  }\n}\n"],"names":["usePaymentMethodList","employeeId","paymentMethodQuery","useEmployeePaymentMethodGet","bankAccountsQuery","useEmployeePaymentMethodsGetBankAccounts","paymentMethod","bankAccounts","deleteBankAccountMutation","useEmployeePaymentMethodDeleteBankAccountMutation","mutatePaymentMethod","useEmployeePaymentMethodUpdateMutation","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","normalizingRef","useRef","useEffect","alreadyNormalized","SPLIT_BY","split","errorHandling","composeErrorHandler","onDelete","bankAccountUuid","submitResult","uuid","deletePendingBankAccountUuid"],"mappings":";;;;;;;;AA2BO,SAASA,EAAqB;AAAA,EACnC,YAAAC;AACF,GAA2D;AACzD,QAAMC,IAAqBC,EAA4B,EAAE,YAAAF,GAAY,GAC/DG,IAAoBC,EAAyC,EAAE,YAAAJ,GAAY,GAE3EK,IAAgBJ,EAAmB,MAAM,uBACzCK,IAAeH,EAAkB,MAAM,sBAEvCI,IAA4BC,EAAA,GAC5B,EAAE,aAAaC,EAAA,IAAwBC,EAAA,GAEvC;AAAA,IACJ,mBAAAC;AAAA,IACA,OAAOC;AAAA,IACP,UAAUC;AAAA,EAAA,IACRC,EAAc,mBAAmB,GAE/BC,IAAiBC,EAAO,EAAK;AAGnC,EAAAC,EAAU,MAAM;AACd,QAAI,CAACZ,EAAe;AAEpB,UAAMa,IADab,EAAc,SAAS,CAAC,GAE7B,gBAAgB,OAAOA,EAAc,YAAYc,EAAS;AACxE,IACEd,EAAc,QAAQ,WAAW,KACjCA,EAAc,SAAS,oBACvB,CAACa,KACD,CAACH,EAAe,YAEhBA,EAAe,UAAU,KACnB,YAAY;AAChB,UAAI;AACF,cAAMN,EAAoB;AAAA,UACxB,SAAS;AAAA,YACP,YAAAT;AAAA,YACA,aAAa;AAAA,cACX,SAASmB,EAAS;AAAA,cAClB,QAAQd,EAAc,OAAQ,IAAI,CAAAe,OAAU;AAAA,gBAC1C,GAAGA;AAAA,gBACH,aAAa;AAAA,gBACb,UAAU;AAAA,cAAA,EACV;AAAA,cACF,SAASf,EAAc;AAAA,cACvB,MAAM;AAAA,YAAA;AAAA,UACR;AAAA,QACF,CACD;AAAA,MACH,UAAA;AACE,QAAAU,EAAe,UAAU;AAAA,MAC3B;AAAA,IACF,GAAA;AAAA,EAEJ,GAAG,CAACf,GAAYK,GAAeI,CAAmB,CAAC;AAEnD,QAAMY,IAAgBC,EAAoB,CAACrB,GAAoBE,CAAiB,GAAG;AAAA,IACjF,aAAAS;AAAA,IACA,gBAAAC;AAAA,EAAA,CACD,GAEKU,IAAW,OACfC,MACmD;AACnD,QAAIC;AACJ,iBAAMd,EAAkBa,GAAiB,OAAME,MAAQ;AAIrD,MAAAD,IAAe,EAAE,MAAM,UAAU,MAHpB,MAAMlB,EAA0B,YAAY;AAAA,QACvD,SAAS,EAAE,YAAAP,GAAY,iBAAiB0B,EAAA;AAAA,MAAK,CAC9C,EACgC;AAAA,IACnC,CAAC,GACMD;AAAA,EACT,GAEME,IAA+BpB,EAA0B,YAC3DA,EAA0B,UAAU,QAAQ,kBAC5C;AAEJ,SACEN,EAAmB,aACnBE,EAAkB,aAClB,CAACE,KACD,CAACC,IAEM,EAAE,WAAW,IAAM,eAAAe,EAAA,IAGrB;AAAA,IACL,WAAW;AAAA,IACX,MAAM,EAAE,eAAAhB,GAAe,cAAAC,EAAA;AAAA,IACvB,QAAQ;AAAA,MACN,YAAYL,EAAmB,cAAcE,EAAkB;AAAA,MAC/D,WAAWI,EAA0B;AAAA,MACrC,8BAAAoB;AAAA,IAAA;AAAA,IAEF,SAAS,EAAE,UAAAJ,EAAA;AAAA,IACX,eAAAF;AAAA,EAAA;AAEJ;"}

package/dist/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/fields.d.ts

@@ -0,0 +1,6 @@
+import { SplitPaymentsFormErrorCodes, SplitByValue } from './useSplitPaymentsFormSchema';
+import { RadioGroupHookFieldProps } from '../../../../../partner-hook-utils/form/fields/RadioGroupHookField';
+import { HookFieldProps } from '../../../../../partner-hook-utils/types';
+export type RequiredValidation = typeof SplitPaymentsFormErrorCodes.REQUIRED;
+export type SplitByFieldProps = HookFieldProps<RadioGroupHookFieldProps<RequiredValidation, SplitByValue>>;
+export declare function SplitByField(props: SplitByFieldProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/fields.js

@@ -0,0 +1,9 @@
+import { jsx as i } from "react/jsx-runtime";
+import { RadioGroupHookField as r } from "../../../../../partner-hook-utils/form/fields/RadioGroupHookField.js";
+function e(o) {
+  return /* @__PURE__ */ i(r, { ...o, name: "splitBy" });
+}
+export {
+  e as SplitByField
+};
+//# sourceMappingURL=fields.js.map

package/dist/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","sources":["../../../../../../src/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/fields.tsx"],"sourcesContent":["import type { SplitPaymentsFormErrorCodes, SplitByValue } from './useSplitPaymentsFormSchema'\nimport { RadioGroupHookField } from '@/partner-hook-utils/form/fields'\nimport type { RadioGroupHookFieldProps } from '@/partner-hook-utils/form/fields/RadioGroupHookField'\nimport type { HookFieldProps } from '@/partner-hook-utils/types'\n\nexport type RequiredValidation = typeof SplitPaymentsFormErrorCodes.REQUIRED\n\nexport type SplitByFieldProps = HookFieldProps<\n  RadioGroupHookFieldProps<RequiredValidation, SplitByValue>\n>\n\nexport function SplitByField(props: SplitByFieldProps) {\n  return <RadioGroupHookField {...props} name=\"splitBy\" />\n}\n"],"names":["SplitByField","props","jsx","RadioGroupHookField"],"mappings":";;AAWO,SAASA,EAAaC,GAA0B;AACrD,SAAO,gBAAAC,EAACC,GAAA,EAAqB,GAAGF,GAAO,MAAK,WAAU;AACxD;"}

package/dist/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/index.d.ts

@@ -0,0 +1,6 @@
+import "./types/i18next.d.ts"
+export { useSplitPaymentsForm } from './useSplitPaymentsForm';
+export type { UseSplitPaymentsFormProps, UseSplitPaymentsFormResult, UseSplitPaymentsFormReady, SplitPaymentsFormFields, SplitPaymentsFormFieldsMetadata, SplitPaymentsFormFieldsType, WorkingSplit, } from './useSplitPaymentsForm';
+export { SPLIT_BY_VALUES, SplitPaymentsFormErrorCodes, createSplitPaymentsFormSchema, type SplitPaymentsFormErrorCode, type SplitPaymentsFormData, type SplitPaymentsFormField, type SplitPaymentsFormOptionalFieldsToRequire, type SplitPaymentsFormOutputs, type SplitByValue, } from './useSplitPaymentsFormSchema';
+export { SplitByField, type SplitByFieldProps, type RequiredValidation as SplitPaymentsFormRequiredValidation, } from './fields';
+export type { SplitFieldEntry, SplitFieldProps, SplitFieldValidation } from './splitFieldFactory';

package/dist/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/splitFieldFactory.d.ts

@@ -0,0 +1,48 @@
+import { ComponentType, ReactNode } from 'react';
+import { SplitPaymentsFormErrorCodes } from './useSplitPaymentsFormSchema';
+import { NumberInputProps } from '../../../../Common/UI/NumberInput/NumberInputTypes';
+import { FormHookResult, ValidationMessages } from '../../../../../partner-hook-utils/types';
+/**
+ * Validation codes a bound split-amount Field can emit at submit time:
+ * `REQUIRED` (every non-remainder split must have a value), `INVALID_AMOUNT`
+ * (Amount mode, value < 0), `INVALID_PERCENTAGE` (Percentage mode, non-integer
+ * or out of `0..100`). Supply translations for all three via `validationMessages`.
+ * The sum-to-100 invariant is surfaced separately via `status.hasPercentageImbalance`.
+ */
+export type SplitFieldValidation = typeof SplitPaymentsFormErrorCodes.REQUIRED | typeof SplitPaymentsFormErrorCodes.INVALID_AMOUNT | typeof SplitPaymentsFormErrorCodes.INVALID_PERCENTAGE;
+/**
+ * Props accepted by a bound split-amount Field exposed on
+ * `form.Fields.splits[i].Field`. The Field is pre-bound to its split; it
+ * formats values as currency in Amount mode and as a percentage in
+ * Percentage mode. The remainder split is auto-disabled and treated as not
+ * required by the hook; the rest are required.
+ */
+export interface SplitFieldProps {
+    label: string;
+    description?: ReactNode;
+    formHookResult?: FormHookResult;
+    validationMessages?: ValidationMessages<SplitFieldValidation>;
+    min?: NumberInputProps['min'];
+    max?: NumberInputProps['max'];
+    placeholder?: NumberInputProps['placeholder'];
+    FieldComponent?: ComponentType<NumberInputProps>;
+}
+export interface SplitFieldEntry {
+    uuid: string;
+    name: string | null;
+    hiddenAccountNumber: string | null;
+    Field: ComponentType<SplitFieldProps>;
+}
+interface BuildSplitFieldsInput {
+    uuid: string;
+    name: string | null;
+    hiddenAccountNumber: string | null;
+}
+/**
+ * Build the per-split bound Field components. The caller is responsible for
+ * memoizing on the stable set of split uuids so Field identity stays stable
+ * across mode toggles and reorders — those changes are observed inside each
+ * Field rather than baked into the closure.
+ */
+export declare function buildSplitFieldEntries(splits: BuildSplitFieldsInput[]): SplitFieldEntry[];
+export {};

package/dist/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/splitFieldFactory.js

@@ -0,0 +1,46 @@
+import { jsx as a } from "react/jsx-runtime";
+import { useWatch as f } from "react-hook-form";
+import { SPLIT_BY as s } from "../../../../../shared/constants.js";
+import { NumberInputHookField as F } from "../../../../../partner-hook-utils/form/fields/NumberInputHookField.js";
+function B(t) {
+  function n({
+    label: r,
+    description: e,
+    formHookResult: o,
+    validationMessages: i,
+    min: m,
+    max: u,
+    placeholder: c,
+    FieldComponent: d
+  }) {
+    const l = o?.form.hookFormInternals.formMethods.control, p = f({ control: l, name: "splitBy" }) === s.amount ? "currency" : "percent";
+    return /* @__PURE__ */ a(
+      F,
+      {
+        name: `splitAmount.${t}`,
+        formHookResult: o,
+        label: r,
+        description: e,
+        validationMessages: i,
+        format: p,
+        min: m,
+        max: u,
+        placeholder: c,
+        FieldComponent: d
+      }
+    );
+  }
+  return n.displayName = `SplitField(${t})`, n;
+}
+function x(t) {
+  return t.map((n) => ({
+    uuid: n.uuid,
+    name: n.name,
+    hiddenAccountNumber: n.hiddenAccountNumber,
+    Field: B(n.uuid)
+  }));
+}
+export {
+  x as buildSplitFieldEntries
+};
+//# sourceMappingURL=splitFieldFactory.js.map

package/dist/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/splitFieldFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"splitFieldFactory.js","sources":["../../../../../../src/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/splitFieldFactory.tsx"],"sourcesContent":["import type { ComponentType, ReactNode } from 'react'\nimport { useWatch, type Control } from 'react-hook-form'\nimport type {\n  SplitPaymentsFormErrorCodes,\n  SplitPaymentsFormData,\n} from './useSplitPaymentsFormSchema'\nimport { NumberInputHookField } from '@/partner-hook-utils/form/fields'\nimport type { NumberInputProps } from '@/components/Common/UI/NumberInput/NumberInputTypes'\nimport type { FormHookResult, ValidationMessages } from '@/partner-hook-utils/types'\nimport { SPLIT_BY } from '@/shared/constants'\n\n/**\n * Validation codes a bound split-amount Field can emit at submit time:\n * `REQUIRED` (every non-remainder split must have a value), `INVALID_AMOUNT`\n * (Amount mode, value < 0), `INVALID_PERCENTAGE` (Percentage mode, non-integer\n * or out of `0..100`). Supply translations for all three via `validationMessages`.\n * The sum-to-100 invariant is surfaced separately via `status.hasPercentageImbalance`.\n */\nexport type SplitFieldValidation =\n  | typeof SplitPaymentsFormErrorCodes.REQUIRED\n  | typeof SplitPaymentsFormErrorCodes.INVALID_AMOUNT\n  | typeof SplitPaymentsFormErrorCodes.INVALID_PERCENTAGE\n\n/**\n * Props accepted by a bound split-amount Field exposed on\n * `form.Fields.splits[i].Field`. The Field is pre-bound to its split; it\n * formats values as currency in Amount mode and as a percentage in\n * Percentage mode. The remainder split is auto-disabled and treated as not\n * required by the hook; the rest are required.\n */\nexport interface SplitFieldProps {\n  label: string\n  description?: ReactNode\n  formHookResult?: FormHookResult\n  validationMessages?: ValidationMessages<SplitFieldValidation>\n  min?: NumberInputProps['min']\n  max?: NumberInputProps['max']\n  placeholder?: NumberInputProps['placeholder']\n  FieldComponent?: ComponentType<NumberInputProps>\n}\n\nexport interface SplitFieldEntry {\n  uuid: string\n  name: string | null\n  hiddenAccountNumber: string | null\n  Field: ComponentType<SplitFieldProps>\n}\n\ninterface BuildSplitFieldsInput {\n  uuid: string\n  name: string | null\n  hiddenAccountNumber: string | null\n}\n\nfunction createBoundSplitField(uuid: string): ComponentType<SplitFieldProps> {\n  function BoundSplitField({\n    label,\n    description,\n    formHookResult,\n    validationMessages,\n    min,\n    max,\n    placeholder,\n    FieldComponent,\n  }: SplitFieldProps) {\n    const externalControl = formHookResult?.form.hookFormInternals.formMethods.control as\n      | Control<SplitPaymentsFormData>\n      | undefined\n    const splitBy = useWatch({ control: externalControl, name: 'splitBy' })\n    const format: NumberInputProps['format'] = splitBy === SPLIT_BY.amount ? 'currency' : 'percent'\n\n    return (\n      <NumberInputHookField<SplitFieldValidation>\n        name={`splitAmount.${uuid}`}\n        formHookResult={formHookResult}\n        label={label}\n        description={description}\n        validationMessages={validationMessages}\n        format={format}\n        min={min}\n        max={max}\n        placeholder={placeholder}\n        FieldComponent={FieldComponent}\n      />\n    )\n  }\n  BoundSplitField.displayName = `SplitField(${uuid})`\n  return BoundSplitField\n}\n\n/**\n * Build the per-split bound Field components. The caller is responsible for\n * memoizing on the stable set of split uuids so Field identity stays stable\n * across mode toggles and reorders — those changes are observed inside each\n * Field rather than baked into the closure.\n */\nexport function buildSplitFieldEntries(splits: BuildSplitFieldsInput[]): SplitFieldEntry[] {\n  return splits.map(split => ({\n    uuid: split.uuid,\n    name: split.name,\n    hiddenAccountNumber: split.hiddenAccountNumber,\n    Field: createBoundSplitField(split.uuid),\n  }))\n}\n"],"names":["createBoundSplitField","uuid","BoundSplitField","label","description","formHookResult","validationMessages","min","max","placeholder","FieldComponent","externalControl","format","useWatch","SPLIT_BY","jsx","NumberInputHookField","buildSplitFieldEntries","splits","split"],"mappings":";;;;AAsDA,SAASA,EAAsBC,GAA8C;AAC3E,WAASC,EAAgB;AAAA,IACvB,OAAAC;AAAA,IACA,aAAAC;AAAA,IACA,gBAAAC;AAAA,IACA,oBAAAC;AAAA,IACA,KAAAC;AAAA,IACA,KAAAC;AAAA,IACA,aAAAC;AAAA,IACA,gBAAAC;AAAA,EAAA,GACkB;AAClB,UAAMC,IAAkBN,GAAgB,KAAK,kBAAkB,YAAY,SAIrEO,IADUC,EAAS,EAAE,SAASF,GAAiB,MAAM,WAAW,MACfG,EAAS,SAAS,aAAa;AAEtF,WACE,gBAAAC;AAAA,MAACC;AAAA,MAAA;AAAA,QACC,MAAM,eAAef,CAAI;AAAA,QACzB,gBAAAI;AAAA,QACA,OAAAF;AAAA,QACA,aAAAC;AAAA,QACA,oBAAAE;AAAA,QACA,QAAAM;AAAA,QACA,KAAAL;AAAA,QACA,KAAAC;AAAA,QACA,aAAAC;AAAA,QACA,gBAAAC;AAAA,MAAA;AAAA,IAAA;AAAA,EAGN;AACA,SAAAR,EAAgB,cAAc,cAAcD,CAAI,KACzCC;AACT;AAQO,SAASe,EAAuBC,GAAoD;AACzF,SAAOA,EAAO,IAAI,CAAAC,OAAU;AAAA,IAC1B,MAAMA,EAAM;AAAA,IACZ,MAAMA,EAAM;AAAA,IACZ,qBAAqBA,EAAM;AAAA,IAC3B,OAAOnB,EAAsBmB,EAAM,IAAI;AAAA,EAAA,EACvC;AACJ;"}

package/dist/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/useSplitPaymentsForm.d.ts

@@ -0,0 +1,65 @@
+import { ComponentType } from 'react';
+import { UseFormProps } from 'react-hook-form';
+import { EmployeeBankAccount } from '@gusto/embedded-api/models/components/employeebankaccount';
+import { EmployeePaymentMethod } from '@gusto/embedded-api/models/components/employeepaymentmethod';
+import { SplitByValue, SplitPaymentsFormData, SplitPaymentsFormOptionalFieldsToRequire } from './useSplitPaymentsFormSchema';
+import { SplitByFieldProps } from './fields';
+import { SplitFieldEntry } from './splitFieldFactory';
+import { BaseFormHookReady, FieldsMetadata, HookLoadingResult, HookSubmitResult } from '../../../../../partner-hook-utils/types';
+export interface WorkingSplit {
+    uuid: string;
+    name: string | null;
+    hiddenAccountNumber: string | null;
+    splitAmount: number | null;
+    priority: number;
+}
+export interface UseSplitPaymentsFormProps {
+    employeeId: string;
+    optionalFieldsToRequire?: SplitPaymentsFormOptionalFieldsToRequire;
+    validationMode?: UseFormProps['mode'];
+    shouldFocusError?: boolean;
+}
+export interface SplitPaymentsFormFields {
+    SplitBy: ComponentType<SplitByFieldProps>;
+    splits: SplitFieldEntry[];
+}
+export interface UseSplitPaymentsFormReady extends BaseFormHookReady<FieldsMetadata, SplitPaymentsFormData, SplitPaymentsFormFields> {
+    data: {
+        paymentMethod: EmployeePaymentMethod;
+        bankAccounts: EmployeeBankAccount[];
+        splits: WorkingSplit[];
+        /** UUID of the split that absorbs the remainder in Amount mode (always the last by priority). */
+        remainderId: string;
+    };
+    status: {
+        isPending: boolean;
+        mode: 'update';
+        /** Current `splitBy` value, reactively tracked. */
+        splitBy: SplitByValue;
+        /** Live sum of `splitAmount` values; useful for displaying the current total in Percentage mode. */
+        percentageTotal: number;
+        /**
+         * Mirrors the schema-emitted `PERCENTAGE_TOTAL_MISMATCH` error at the
+         * synthetic form path. Tracks `formState.errors` directly and follows
+         * the standard react-hook-form validation lifecycle: with the default
+         * `validationMode: 'onSubmit'`, becomes `true` after the first failed
+         * Save attempt and clears live as the user corrects the total. Only
+         * surfaces in Percentage mode.
+         */
+        hasPercentageImbalance: boolean;
+    };
+    actions: {
+        onSubmit: () => Promise<HookSubmitResult<EmployeePaymentMethod> | undefined>;
+        /**
+         * Reorder splits by uuid (Amount mode). Pass the ordered list of split
+         * uuids; the last uuid becomes the remainder. The hook writes the new
+         * priority map and re-anchors the remainder's `splitAmount` to `null`
+         * (clearing the previous remainder to `0`).
+         */
+        reorderSplits: (orderedUuids: string[]) => void;
+    };
+}
+export declare function useSplitPaymentsForm({ employeeId, optionalFieldsToRequire, validationMode, shouldFocusError, }: UseSplitPaymentsFormProps): HookLoadingResult | UseSplitPaymentsFormReady;
+export type UseSplitPaymentsFormResult = HookLoadingResult | UseSplitPaymentsFormReady;
+export type SplitPaymentsFormFieldsMetadata = UseSplitPaymentsFormReady['form']['fieldsMetadata'];
+export type SplitPaymentsFormFieldsType = UseSplitPaymentsFormReady['form']['Fields'];

package/dist/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/useSplitPaymentsForm.js

@@ -0,0 +1,209 @@
+import { useMemo as f, useEffect as $, useRef as R, useCallback as st } from "react";
+import { useForm as ut, useWatch as L, useFormState as mt } from "react-hook-form";
+import { zodResolver as at } from "@hookform/resolvers/zod";
+import { useEmployeePaymentMethodGet as ct } from "@gusto/embedded-api/react-query/employeePaymentMethodGet";
+import { useEmployeePaymentMethodsGetBankAccounts as lt } from "@gusto/embedded-api/react-query/employeePaymentMethodsGetBankAccounts";
+import { useEmployeePaymentMethodUpdateMutation as pt } from "@gusto/embedded-api/react-query/employeePaymentMethodUpdate";
+import { createSplitPaymentsFormSchema as dt, PERCENTAGE_TOTAL_PATH as j, SplitPaymentsFormErrorCodes as yt, SPLIT_BY_VALUES as Y } from "./useSplitPaymentsFormSchema.js";
+import { SplitByField as ft } from "./fields.js";
+import { buildSplitFieldEntries as At } from "./splitFieldFactory.js";
+import { useDeriveFieldsMetadata as bt } from "../../../../../partner-hook-utils/form/useDeriveFieldsMetadata.js";
+import { useHookFormInternals as ht } from "../../../../../partner-hook-utils/form/useHookFormInternals.js";
+import { createGetFormSubmissionValues as St } from "../../../../../partner-hook-utils/form/getFormSubmissionValues.js";
+import { withOptions as gt } from "../../../../../partner-hook-utils/form/withOptions.js";
+import { composeErrorHandler as Pt } from "../../../../../partner-hook-utils/composeErrorHandler.js";
+import { useBaseSubmit as Et } from "../../../../Base/useBaseSubmit.js";
+import { SDKInternalError as q } from "../../../../../types/sdkError.js";
+import { centsToDollars as Bt, dollarsToCents as Mt } from "../../../../../helpers/currencyHelpers.js";
+import { SPLIT_BY as l, PAYMENT_METHODS as wt } from "../../../../../shared/constants.js";
+const Ft = (p, g) => p.splits && p.splits.length > 0 ? p.splits.map((i) => ({
+  uuid: i.uuid,
+  name: i.name ?? null,
+  hiddenAccountNumber: i.hiddenAccountNumber ?? null,
+  splitAmount: i.splitAmount ?? null,
+  priority: i.priority ?? 0
+})) : g.map((i, M) => ({
+  uuid: i.uuid,
+  name: i.name ?? null,
+  hiddenAccountNumber: i.hiddenAccountNumber ?? null,
+  splitAmount: null,
+  priority: M + 1
+}));
+function zt({
+  employeeId: p,
+  optionalFieldsToRequire: g,
+  validationMode: i = "onSubmit",
+  shouldFocusError: M = !0
+}) {
+  const w = ct({ employeeId: p }), F = lt({ employeeId: p }), s = w.data?.employeePaymentMethod, A = F.data?.employeeBankAccounts, u = f(
+    () => s && A ? Ft(s, A) : [],
+    [s, A]
+  ), [O, z] = f(
+    () => dt({ optionalFieldsToRequire: g }),
+    [g]
+  ), V = f(() => {
+    const t = s?.splitBy === l.amount, e = {}, n = {};
+    return u.forEach((r) => {
+      e[r.uuid] = t ? Bt(r.splitAmount) : r.splitAmount, n[r.uuid] = r.priority;
+    }), {
+      splitBy: s?.splitBy ?? l.percentage,
+      splitAmount: e,
+      priority: n
+    };
+  }, [s, u]), m = ut({
+    resolver: at(O),
+    mode: i,
+    shouldFocusError: M,
+    defaultValues: V,
+    values: V,
+    resetOptions: { keepDirtyValues: !0 }
+  }), C = pt(), Q = C.isPending, {
+    baseSubmitHandler: W,
+    error: K,
+    setError: x
+  } = Et("SplitPaymentsForm"), D = Pt([w, F], {
+    submitError: K,
+    setSubmitError: x
+  }), o = L({ control: m.control, name: "splitBy" }), P = L({ control: m.control, name: "priority" }), T = L({ control: m.control, name: "splitAmount" }), J = f(() => o !== l.percentage ? 0 : Object.values(T).reduce(
+    (t, e) => t + (typeof e == "number" && Number.isFinite(e) ? e : 0),
+    0
+  ), [o, T]), { errors: X, isSubmitted: _ } = mt({
+    control: m.control
+  }), Z = o === l.percentage && X[j]?.message === yt.PERCENTAGE_TOTAL_MISMATCH, { trigger: H } = m;
+  $(() => {
+    _ && o === l.percentage && H(j);
+  }, [_, o, T, H]);
+  const b = f(() => Object.keys(P).length ? Object.entries(P).reduce((t, [e, n]) => {
+    if (!t) return e;
+    const r = P[t] ?? 0;
+    return n > r ? e : t;
+  }, "") : "", [P]), h = R(u);
+  h.current = u;
+  const v = R(b);
+  v.current = b;
+  const E = R(null), { setValue: d, resetField: I } = m;
+  $(() => {
+    if (h.current.length) {
+      if (E.current === null) {
+        E.current = o;
+        return;
+      }
+      if (E.current !== o)
+        if (E.current = o, o === l.amount) {
+          const t = h.current.reduce((e, n) => (e[n.uuid] = n.uuid === v.current ? null : 0, e), {});
+          d("splitAmount", t);
+        } else {
+          const t = h.current.reduce(
+            (e, n, r) => (e[n.uuid] = r === 0 ? 100 : 0, e),
+            {}
+          );
+          d("splitAmount", t);
+        }
+    }
+  }, [o, d]);
+  const U = st(
+    (t) => {
+      const e = h.current, n = new Set(e.map((c) => c.uuid));
+      if (t.length !== n.size || !t.every((c) => n.has(c)))
+        return;
+      const r = t.reduce((c, k, B) => (c[k] = B + 1, c), {}), y = t[t.length - 1];
+      if (!y) return;
+      d("priority", r);
+      const a = v.current;
+      a && a !== y && (I(`splitAmount.${a}`), d(`splitAmount.${a}`, 0)), d(`splitAmount.${y}`, null);
+    },
+    [d, I]
+  ), tt = Y.map((t) => ({ value: t, label: t })), N = bt(z, m.control), et = f(() => {
+    const t = {}, e = o === l.amount;
+    for (const n of u) {
+      const r = `splitAmount.${n.uuid}`, y = e && n.uuid === b;
+      t[r] = {
+        name: r,
+        isRequired: !0,
+        isDisabled: y
+      };
+    }
+    return t;
+  }, [u, o, b]), nt = {
+    splitBy: gt(N.splitBy, tt, [...Y]),
+    splitAmount: N.splitAmount,
+    priority: N.priority,
+    ...et
+  }, rt = f(
+    () => At(
+      u.map((t) => ({
+        uuid: t.uuid,
+        name: t.name,
+        hiddenAccountNumber: t.hiddenAccountNumber
+      }))
+    ),
+    [u]
+  ), ot = async () => {
+    if (!s)
+      throw new q("Cannot submit split payments form before data is loaded");
+    const t = s, e = u;
+    let n;
+    return await new Promise((r) => {
+      m.handleSubmit(
+        async (y) => {
+          await W(y, async (a) => {
+            const c = a.splitBy === l.amount, k = {
+              ...t,
+              version: t.version,
+              splitBy: a.splitBy,
+              splits: e.map((S) => {
+                const G = a.splitAmount[S.uuid] ?? null;
+                return {
+                  uuid: S.uuid,
+                  name: S.name ?? void 0,
+                  hiddenAccountNumber: S.hiddenAccountNumber ?? void 0,
+                  splitAmount: c ? Mt(G) : G,
+                  priority: a.priority[S.uuid]
+                };
+              })
+            }, B = await C.mutateAsync({
+              request: {
+                employeeId: p,
+                requestBody: { ...k, type: wt.directDeposit }
+              }
+            });
+            if (!B.employeePaymentMethod)
+              throw new q("Payment method update failed");
+            n = { mode: "update", data: B.employeePaymentMethod };
+          }), r();
+        },
+        () => {
+          r();
+        }
+      )();
+    }), n;
+  }, it = ht(m);
+  return w.isLoading || F.isLoading || !s || !A ? { isLoading: !0, errorHandling: D } : {
+    isLoading: !1,
+    data: {
+      paymentMethod: s,
+      bankAccounts: A,
+      splits: u,
+      remainderId: b
+    },
+    status: {
+      isPending: Q,
+      mode: "update",
+      splitBy: o,
+      percentageTotal: J,
+      hasPercentageImbalance: Z
+    },
+    actions: { onSubmit: ot, reorderSplits: U },
+    errorHandling: D,
+    form: {
+      Fields: { SplitBy: ft, splits: rt },
+      fieldsMetadata: nt,
+      hookFormInternals: it,
+      getFormSubmissionValues: St(m, O)
+    }
+  };
+}
+export {
+  zt as useSplitPaymentsForm
+};
+//# sourceMappingURL=useSplitPaymentsForm.js.map

package/dist/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/useSplitPaymentsForm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSplitPaymentsForm.js","sources":["../../../../../../src/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/useSplitPaymentsForm.tsx"],"sourcesContent":["import type { ComponentType } from 'react'\nimport { useCallback, useEffect, useMemo, useRef } from 'react'\nimport { useForm, useFormState, useWatch } from 'react-hook-form'\nimport type { UseFormProps } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport type { EmployeeBankAccount } from '@gusto/embedded-api/models/components/employeebankaccount'\nimport type { EmployeePaymentMethod } from '@gusto/embedded-api/models/components/employeepaymentmethod'\nimport { useEmployeePaymentMethodGet } from '@gusto/embedded-api/react-query/employeePaymentMethodGet'\nimport { useEmployeePaymentMethodsGetBankAccounts } from '@gusto/embedded-api/react-query/employeePaymentMethodsGetBankAccounts'\nimport { useEmployeePaymentMethodUpdateMutation } from '@gusto/embedded-api/react-query/employeePaymentMethodUpdate'\nimport {\n  PERCENTAGE_TOTAL_PATH,\n  SPLIT_BY_VALUES,\n  SplitPaymentsFormErrorCodes,\n  type SplitByValue,\n  type SplitPaymentsFormData,\n  type SplitPaymentsFormOptionalFieldsToRequire,\n  type SplitPaymentsFormOutputs,\n  createSplitPaymentsFormSchema,\n} from './useSplitPaymentsFormSchema'\nimport { SplitByField, type SplitByFieldProps } from './fields'\nimport { buildSplitFieldEntries, type SplitFieldEntry } from './splitFieldFactory'\nimport { useDeriveFieldsMetadata } from '@/partner-hook-utils/form/useDeriveFieldsMetadata'\nimport { useHookFormInternals } from '@/partner-hook-utils/form/useHookFormInternals'\nimport { createGetFormSubmissionValues } from '@/partner-hook-utils/form/getFormSubmissionValues'\nimport { withOptions } from '@/partner-hook-utils/form/withOptions'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type {\n  BaseFormHookReady,\n  FieldsMetadata,\n  HookLoadingResult,\n  HookSubmitResult,\n} from '@/partner-hook-utils/types'\nimport { useBaseSubmit } from '@/components/Base/useBaseSubmit'\nimport { SDKInternalError } from '@/types/sdkError'\nimport { centsToDollars, dollarsToCents } from '@/helpers/currencyHelpers'\nimport { PAYMENT_METHODS, SPLIT_BY } from '@/shared/constants'\n\nexport interface WorkingSplit {\n  uuid: string\n  name: string | null\n  hiddenAccountNumber: string | null\n  splitAmount: number | null\n  priority: number\n}\n\nexport interface UseSplitPaymentsFormProps {\n  employeeId: string\n  optionalFieldsToRequire?: SplitPaymentsFormOptionalFieldsToRequire\n  validationMode?: UseFormProps['mode']\n  shouldFocusError?: boolean\n}\n\nexport interface SplitPaymentsFormFields {\n  SplitBy: ComponentType<SplitByFieldProps>\n  splits: SplitFieldEntry[]\n}\n\nexport interface UseSplitPaymentsFormReady extends BaseFormHookReady<\n  FieldsMetadata,\n  SplitPaymentsFormData,\n  SplitPaymentsFormFields\n> {\n  data: {\n    paymentMethod: EmployeePaymentMethod\n    bankAccounts: EmployeeBankAccount[]\n    splits: WorkingSplit[]\n    /** UUID of the split that absorbs the remainder in Amount mode (always the last by priority). */\n    remainderId: string\n  }\n  status: {\n    isPending: boolean\n    mode: 'update'\n    /** Current `splitBy` value, reactively tracked. */\n    splitBy: SplitByValue\n    /** Live sum of `splitAmount` values; useful for displaying the current total in Percentage mode. */\n    percentageTotal: number\n    /**\n     * Mirrors the schema-emitted `PERCENTAGE_TOTAL_MISMATCH` error at the\n     * synthetic form path. Tracks `formState.errors` directly and follows\n     * the standard react-hook-form validation lifecycle: with the default\n     * `validationMode: 'onSubmit'`, becomes `true` after the first failed\n     * Save attempt and clears live as the user corrects the total. Only\n     * surfaces in Percentage mode.\n     */\n    hasPercentageImbalance: boolean\n  }\n  actions: {\n    onSubmit: () => Promise<HookSubmitResult<EmployeePaymentMethod> | undefined>\n    /**\n     * Reorder splits by uuid (Amount mode). Pass the ordered list of split\n     * uuids; the last uuid becomes the remainder. The hook writes the new\n     * priority map and re-anchors the remainder's `splitAmount` to `null`\n     * (clearing the previous remainder to `0`).\n     */\n    reorderSplits: (orderedUuids: string[]) => void\n  }\n}\n\nconst buildWorkingSplits = (\n  paymentMethod: EmployeePaymentMethod,\n  bankAccounts: EmployeeBankAccount[],\n): WorkingSplit[] => {\n  if (paymentMethod.splits && paymentMethod.splits.length > 0) {\n    return paymentMethod.splits.map(split => ({\n      uuid: split.uuid,\n      name: split.name ?? null,\n      hiddenAccountNumber: split.hiddenAccountNumber ?? null,\n      splitAmount: split.splitAmount ?? null,\n      priority: split.priority ?? 0,\n    }))\n  }\n  return bankAccounts.map((account, index) => ({\n    uuid: account.uuid,\n    name: account.name ?? null,\n    hiddenAccountNumber: account.hiddenAccountNumber ?? null,\n    splitAmount: null,\n    priority: index + 1,\n  }))\n}\n\nexport function useSplitPaymentsForm({\n  employeeId,\n  optionalFieldsToRequire,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n}: UseSplitPaymentsFormProps): HookLoadingResult | UseSplitPaymentsFormReady {\n  const paymentMethodQuery = useEmployeePaymentMethodGet({ employeeId })\n  const bankAccountsQuery = useEmployeePaymentMethodsGetBankAccounts({ employeeId })\n\n  const paymentMethod = paymentMethodQuery.data?.employeePaymentMethod\n  const bankAccounts = bankAccountsQuery.data?.employeeBankAccounts\n\n  const splits = useMemo<WorkingSplit[]>(\n    () => (paymentMethod && bankAccounts ? buildWorkingSplits(paymentMethod, bankAccounts) : []),\n    [paymentMethod, bankAccounts],\n  )\n\n  const [schema, metadataConfig] = useMemo(\n    () => createSplitPaymentsFormSchema({ optionalFieldsToRequire }),\n    [optionalFieldsToRequire],\n  )\n\n  const resolvedDefaults: SplitPaymentsFormData = useMemo(() => {\n    const isAmountSplit = paymentMethod?.splitBy === SPLIT_BY.amount\n    const splitAmount: Record<string, number | null> = {}\n    const priority: Record<string, number> = {}\n    splits.forEach(split => {\n      splitAmount[split.uuid] = isAmountSplit\n        ? centsToDollars(split.splitAmount)\n        : split.splitAmount\n      priority[split.uuid] = split.priority\n    })\n    return {\n      splitBy: (paymentMethod?.splitBy ?? SPLIT_BY.percentage) as SplitByValue,\n      splitAmount,\n      priority,\n    }\n  }, [paymentMethod, splits])\n\n  const formMethods = useForm<SplitPaymentsFormData, unknown, SplitPaymentsFormOutputs>({\n    resolver: zodResolver(schema),\n    mode: validationMode,\n    shouldFocusError,\n    defaultValues: resolvedDefaults,\n    values: resolvedDefaults,\n    resetOptions: { keepDirtyValues: true },\n  })\n\n  const updateMutation = useEmployeePaymentMethodUpdateMutation()\n  const isPending = updateMutation.isPending\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('SplitPaymentsForm')\n\n  const errorHandling = composeErrorHandler([paymentMethodQuery, bankAccountsQuery], {\n    submitError,\n    setSubmitError,\n  })\n\n  const watchedSplitBy = useWatch({ control: formMethods.control, name: 'splitBy' })\n  const watchedPriority = useWatch({ control: formMethods.control, name: 'priority' })\n  const watchedSplitAmount = useWatch({ control: formMethods.control, name: 'splitAmount' })\n\n  const percentageTotal = useMemo(() => {\n    if (watchedSplitBy !== SPLIT_BY.percentage) return 0\n    return Object.values(watchedSplitAmount).reduce<number>(\n      (acc, v) => acc + (typeof v === 'number' && Number.isFinite(v) ? v : 0),\n      0,\n    )\n  }, [watchedSplitBy, watchedSplitAmount])\n\n  // Subscribe to the schema-emitted imbalance error. The schema places it at\n  // a synthetic path (`PERCENTAGE_TOTAL_PATH`) so it does not collide with\n  // per-uuid `splitAmount.<uuid>` errors. Following the standard validation\n  // lifecycle means `validationMode` (onSubmit / onChange / onBlur / ...)\n  // controls when the alert can appear. We subscribe to the full errors map\n  // because `name` only tracks registered field paths and our synthetic key\n  // is not a registered field. The derivation is also gated on Percentage\n  // mode so a stale error from a prior Percentage submit can't leak into\n  // Amount mode after a toggle.\n  const { errors: validationErrors, isSubmitted } = useFormState({\n    control: formMethods.control,\n  })\n  const hasPercentageImbalance =\n    watchedSplitBy === SPLIT_BY.percentage &&\n    (validationErrors as Record<string, { message?: string } | undefined>)[PERCENTAGE_TOTAL_PATH]\n      ?.message === SplitPaymentsFormErrorCodes.PERCENTAGE_TOTAL_MISMATCH\n\n  // Re-sync the synthetic PERCENTAGE_TOTAL_PATH error whenever any\n  // `splitAmount` value changes (in Percentage mode, after the first\n  // submit attempt). RHF's per-field reValidate after a failed submit\n  // scopes the resolver merge to the changed field's name, so an error\n  // at our form-level synthetic path is otherwise left stuck once the\n  // user has typed the total back to 100. Targeting the synthetic name\n  // re-runs the resolver and lets RHF set/unset that single path through\n  // its normal merge — preserving per-field error lifecycles unchanged.\n  const { trigger } = formMethods\n  useEffect(() => {\n    if (!isSubmitted) return\n    if (watchedSplitBy !== SPLIT_BY.percentage) return\n    // `trigger`'s type is keyed to registered field paths, but the\n    // synthetic `percentageTotal` resolves through RHF's get/set/unset\n    // helpers at runtime — cast at the boundary to keep the contract\n    // honest above.\n    void trigger(PERCENTAGE_TOTAL_PATH as Parameters<typeof trigger>[0])\n  }, [isSubmitted, watchedSplitBy, watchedSplitAmount, trigger])\n\n  const remainderId = useMemo(() => {\n    if (!Object.keys(watchedPriority).length) return ''\n    return Object.entries(watchedPriority).reduce((maxId, [uuid, priority]) => {\n      if (!maxId) return uuid\n      const currentMax = watchedPriority[maxId] ?? 0\n      return priority > currentMax ? uuid : maxId\n    }, '')\n  }, [watchedPriority])\n\n  // Reset splitAmount values when the user toggles splitBy. Skip the first\n  // post-load run so values loaded from `paymentMethod.splits` are preserved\n  // on mount — only the user's explicit toggle should clear them.\n  const splitsRef = useRef(splits)\n  splitsRef.current = splits\n  const remainderIdRef = useRef(remainderId)\n  remainderIdRef.current = remainderId\n  const previousSplitByRef = useRef<SplitByValue | null>(null)\n  const { setValue, resetField } = formMethods\n\n  useEffect(() => {\n    if (!splitsRef.current.length) return\n    if (previousSplitByRef.current === null) {\n      previousSplitByRef.current = watchedSplitBy as SplitByValue\n      return\n    }\n    if (previousSplitByRef.current === watchedSplitBy) return\n    previousSplitByRef.current = watchedSplitBy as SplitByValue\n\n    if (watchedSplitBy === SPLIT_BY.amount) {\n      const newValues = splitsRef.current.reduce<Record<string, number | null>>((acc, curr) => {\n        acc[curr.uuid] = curr.uuid === remainderIdRef.current ? null : 0\n        return acc\n      }, {})\n      setValue('splitAmount', newValues)\n    } else {\n      const newValues = splitsRef.current.reduce<Record<string, number | null>>(\n        (acc, curr, index) => {\n          acc[curr.uuid] = index === 0 ? 100 : 0\n          return acc\n        },\n        {},\n      )\n      setValue('splitAmount', newValues)\n    }\n  }, [watchedSplitBy, setValue])\n\n  const reorderSplits = useCallback(\n    (orderedUuids: string[]) => {\n      const currentSplits = splitsRef.current\n      const knownUuids = new Set(currentSplits.map(s => s.uuid))\n      if (\n        orderedUuids.length !== knownUuids.size ||\n        !orderedUuids.every(uuid => knownUuids.has(uuid))\n      ) {\n        return\n      }\n\n      const newPriorities = orderedUuids.reduce<Record<string, number>>((acc, uuid, index) => {\n        acc[uuid] = index + 1\n        return acc\n      }, {})\n      const newRemainderId = orderedUuids[orderedUuids.length - 1]\n      if (!newRemainderId) return\n\n      setValue('priority', newPriorities)\n      const previousRemainder = remainderIdRef.current\n      if (previousRemainder && previousRemainder !== newRemainderId) {\n        resetField(`splitAmount.${previousRemainder}`)\n        setValue(`splitAmount.${previousRemainder}`, 0)\n      }\n      setValue(`splitAmount.${newRemainderId}`, null)\n    },\n    [setValue, resetField],\n  )\n\n  const splitByOptions = SPLIT_BY_VALUES.map(value => ({ value, label: value }))\n  const baseMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n  const dynamicSplitMetadata = useMemo<FieldsMetadata>(() => {\n    const entries: FieldsMetadata = {}\n    const isAmountSplit = watchedSplitBy === SPLIT_BY.amount\n    for (const split of splits) {\n      const path = `splitAmount.${split.uuid}`\n      const isRemainder = isAmountSplit && split.uuid === remainderId\n      // Every split — including the remainder — is \"required\" from the\n      // user's perspective: the remainder always carries a value at submit\n      // (the API absorbs leftover). The form-state `null` is a modeling\n      // detail, not a UX choice, so we don't surface it as \"(optional)\" on\n      // the label. `isDisabled` already conveys the non-interactivity.\n      entries[path] = {\n        name: path,\n        isRequired: true,\n        isDisabled: isRemainder,\n      }\n    }\n    return entries\n  }, [splits, watchedSplitBy, remainderId])\n  const fieldsMetadata: FieldsMetadata = {\n    splitBy: withOptions<SplitByValue>(baseMetadata.splitBy, splitByOptions, [...SPLIT_BY_VALUES]),\n    splitAmount: baseMetadata.splitAmount,\n    priority: baseMetadata.priority,\n    ...dynamicSplitMetadata,\n  }\n\n  const splitFieldEntries = useMemo(\n    () =>\n      buildSplitFieldEntries(\n        splits.map(s => ({\n          uuid: s.uuid,\n          name: s.name,\n          hiddenAccountNumber: s.hiddenAccountNumber,\n        })),\n      ),\n    [splits],\n  )\n\n  const onSubmit = async (): Promise<HookSubmitResult<EmployeePaymentMethod> | undefined> => {\n    if (!paymentMethod) {\n      throw new SDKInternalError('Cannot submit split payments form before data is loaded')\n    }\n    const currentPaymentMethod = paymentMethod\n    const currentSplits = splits\n    let submitResult: HookSubmitResult<EmployeePaymentMethod> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: SplitPaymentsFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            const isAmountSplit = payload.splitBy === SPLIT_BY.amount\n            const body = {\n              ...currentPaymentMethod,\n              version: currentPaymentMethod.version as string,\n              splitBy: payload.splitBy,\n              splits: currentSplits.map(split => {\n                const splitAmountValue = payload.splitAmount[split.uuid] ?? null\n                return {\n                  uuid: split.uuid,\n                  name: split.name ?? undefined,\n                  hiddenAccountNumber: split.hiddenAccountNumber ?? undefined,\n                  splitAmount: isAmountSplit ? dollarsToCents(splitAmountValue) : splitAmountValue,\n                  priority: payload.priority[split.uuid],\n                }\n              }),\n            }\n\n            const response = await updateMutation.mutateAsync({\n              request: {\n                employeeId,\n                requestBody: { ...body, type: PAYMENT_METHODS.directDeposit },\n              },\n            })\n\n            if (!response.employeePaymentMethod) {\n              throw new SDKInternalError('Payment method update failed')\n            }\n\n            submitResult = { mode: 'update' as const, data: response.employeePaymentMethod }\n          })\n          resolve()\n        },\n        () => {\n          resolve()\n        },\n      )()\n    })\n\n    return submitResult\n  }\n\n  const hookFormInternals = useHookFormInternals(formMethods)\n\n  if (\n    paymentMethodQuery.isLoading ||\n    bankAccountsQuery.isLoading ||\n    !paymentMethod ||\n    !bankAccounts\n  ) {\n    return { isLoading: true as const, errorHandling }\n  }\n\n  return {\n    isLoading: false as const,\n    data: {\n      paymentMethod,\n      bankAccounts,\n      splits,\n      remainderId,\n    },\n    status: {\n      isPending,\n      mode: 'update' as const,\n      splitBy: watchedSplitBy as SplitByValue,\n      percentageTotal,\n      hasPercentageImbalance,\n    },\n    actions: { onSubmit, reorderSplits },\n    errorHandling,\n    form: {\n      Fields: { SplitBy: SplitByField, splits: splitFieldEntries },\n      fieldsMetadata,\n      hookFormInternals,\n      getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n    },\n  }\n}\n\nexport type UseSplitPaymentsFormResult = HookLoadingResult | UseSplitPaymentsFormReady\nexport type SplitPaymentsFormFieldsMetadata = UseSplitPaymentsFormReady['form']['fieldsMetadata']\nexport type SplitPaymentsFormFieldsType = UseSplitPaymentsFormReady['form']['Fields']\n"],"names":["buildWorkingSplits","paymentMethod","bankAccounts","split","account","index","useSplitPaymentsForm","employeeId","optionalFieldsToRequire","validationMode","shouldFocusError","paymentMethodQuery","useEmployeePaymentMethodGet","bankAccountsQuery","useEmployeePaymentMethodsGetBankAccounts","splits","useMemo","schema","metadataConfig","createSplitPaymentsFormSchema","resolvedDefaults","isAmountSplit","SPLIT_BY","splitAmount","priority","centsToDollars","formMethods","useForm","zodResolver","updateMutation","useEmployeePaymentMethodUpdateMutation","isPending","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","watchedSplitBy","useWatch","watchedPriority","watchedSplitAmount","percentageTotal","acc","v","validationErrors","isSubmitted","useFormState","hasPercentageImbalance","PERCENTAGE_TOTAL_PATH","SplitPaymentsFormErrorCodes","trigger","useEffect","remainderId","maxId","uuid","currentMax","splitsRef","useRef","remainderIdRef","previousSplitByRef","setValue","resetField","newValues","curr","reorderSplits","useCallback","orderedUuids","currentSplits","knownUuids","s","newPriorities","newRemainderId","previousRemainder","splitByOptions","SPLIT_BY_VALUES","value","baseMetadata","useDeriveFieldsMetadata","dynamicSplitMetadata","entries","path","isRemainder","fieldsMetadata","withOptions","splitFieldEntries","buildSplitFieldEntries","onSubmit","SDKInternalError","currentPaymentMethod","submitResult","resolve","data","payload","body","splitAmountValue","dollarsToCents","response","PAYMENT_METHODS","hookFormInternals","useHookFormInternals","SplitByField","createGetFormSubmissionValues"],"mappings":";;;;;;;;;;;;;;;;;;AAmGA,MAAMA,KAAqB,CACzBC,GACAC,MAEID,EAAc,UAAUA,EAAc,OAAO,SAAS,IACjDA,EAAc,OAAO,IAAI,CAAAE,OAAU;AAAA,EACxC,MAAMA,EAAM;AAAA,EACZ,MAAMA,EAAM,QAAQ;AAAA,EACpB,qBAAqBA,EAAM,uBAAuB;AAAA,EAClD,aAAaA,EAAM,eAAe;AAAA,EAClC,UAAUA,EAAM,YAAY;AAAA,EAC5B,IAEGD,EAAa,IAAI,CAACE,GAASC,OAAW;AAAA,EAC3C,MAAMD,EAAQ;AAAA,EACd,MAAMA,EAAQ,QAAQ;AAAA,EACtB,qBAAqBA,EAAQ,uBAAuB;AAAA,EACpD,aAAa;AAAA,EACb,UAAUC,IAAQ;AAAA,EAClB;AAGG,SAASC,GAAqB;AAAA,EACnC,YAAAC;AAAA,EACA,yBAAAC;AAAA,EACA,gBAAAC,IAAiB;AAAA,EACjB,kBAAAC,IAAmB;AACrB,GAA6E;AAC3E,QAAMC,IAAqBC,GAA4B,EAAE,YAAAL,GAAY,GAC/DM,IAAoBC,GAAyC,EAAE,YAAAP,GAAY,GAE3EN,IAAgBU,EAAmB,MAAM,uBACzCT,IAAeW,EAAkB,MAAM,sBAEvCE,IAASC;AAAA,IACb,MAAOf,KAAiBC,IAAeF,GAAmBC,GAAeC,CAAY,IAAI,CAAA;AAAA,IACzF,CAACD,GAAeC,CAAY;AAAA,EAAA,GAGxB,CAACe,GAAQC,CAAc,IAAIF;AAAA,IAC/B,MAAMG,GAA8B,EAAE,yBAAAX,GAAyB;AAAA,IAC/D,CAACA,CAAuB;AAAA,EAAA,GAGpBY,IAA0CJ,EAAQ,MAAM;AAC5D,UAAMK,IAAgBpB,GAAe,YAAYqB,EAAS,QACpDC,IAA6C,CAAA,GAC7CC,IAAmC,CAAA;AACzC,WAAAT,EAAO,QAAQ,CAAAZ,MAAS;AACtB,MAAAoB,EAAYpB,EAAM,IAAI,IAAIkB,IACtBI,GAAetB,EAAM,WAAW,IAChCA,EAAM,aACVqB,EAASrB,EAAM,IAAI,IAAIA,EAAM;AAAA,IAC/B,CAAC,GACM;AAAA,MACL,SAAUF,GAAe,WAAWqB,EAAS;AAAA,MAC7C,aAAAC;AAAA,MACA,UAAAC;AAAA,IAAA;AAAA,EAEJ,GAAG,CAACvB,GAAec,CAAM,CAAC,GAEpBW,IAAcC,GAAkE;AAAA,IACpF,UAAUC,GAAYX,CAAM;AAAA,IAC5B,MAAMR;AAAA,IACN,kBAAAC;AAAA,IACA,eAAeU;AAAA,IACf,QAAQA;AAAA,IACR,cAAc,EAAE,iBAAiB,GAAA;AAAA,EAAK,CACvC,GAEKS,IAAiBC,GAAA,GACjBC,IAAYF,EAAe,WAE3B;AAAA,IACJ,mBAAAG;AAAA,IACA,OAAOC;AAAA,IACP,UAAUC;AAAA,EAAA,IACRC,GAAc,mBAAmB,GAE/BC,IAAgBC,GAAoB,CAAC1B,GAAoBE,CAAiB,GAAG;AAAA,IACjF,aAAAoB;AAAA,IACA,gBAAAC;AAAA,EAAA,CACD,GAEKI,IAAiBC,EAAS,EAAE,SAASb,EAAY,SAAS,MAAM,WAAW,GAC3Ec,IAAkBD,EAAS,EAAE,SAASb,EAAY,SAAS,MAAM,YAAY,GAC7Ee,IAAqBF,EAAS,EAAE,SAASb,EAAY,SAAS,MAAM,eAAe,GAEnFgB,IAAkB1B,EAAQ,MAC1BsB,MAAmBhB,EAAS,aAAmB,IAC5C,OAAO,OAAOmB,CAAkB,EAAE;AAAA,IACvC,CAACE,GAAKC,MAAMD,KAAO,OAAOC,KAAM,YAAY,OAAO,SAASA,CAAC,IAAIA,IAAI;AAAA,IACrE;AAAA,EAAA,GAED,CAACN,GAAgBG,CAAkB,CAAC,GAWjC,EAAE,QAAQI,GAAkB,aAAAC,EAAA,IAAgBC,GAAa;AAAA,IAC7D,SAASrB,EAAY;AAAA,EAAA,CACtB,GACKsB,IACJV,MAAmBhB,EAAS,cAC3BuB,EAAsEI,CAAqB,GACxF,YAAYC,GAA4B,2BAUxC,EAAE,SAAAC,MAAYzB;AACpB,EAAA0B,EAAU,MAAM;AACd,IAAKN,KACDR,MAAmBhB,EAAS,cAK3B6B,EAAQF,CAAsD;AAAA,EACrE,GAAG,CAACH,GAAaR,GAAgBG,GAAoBU,CAAO,CAAC;AAE7D,QAAME,IAAcrC,EAAQ,MACrB,OAAO,KAAKwB,CAAe,EAAE,SAC3B,OAAO,QAAQA,CAAe,EAAE,OAAO,CAACc,GAAO,CAACC,GAAM/B,CAAQ,MAAM;AACzE,QAAI,CAAC8B,EAAO,QAAOC;AACnB,UAAMC,IAAahB,EAAgBc,CAAK,KAAK;AAC7C,WAAO9B,IAAWgC,IAAaD,IAAOD;AAAA,EACxC,GAAG,EAAE,IAL4C,IAMhD,CAACd,CAAe,CAAC,GAKdiB,IAAYC,EAAO3C,CAAM;AAC/B,EAAA0C,EAAU,UAAU1C;AACpB,QAAM4C,IAAiBD,EAAOL,CAAW;AACzC,EAAAM,EAAe,UAAUN;AACzB,QAAMO,IAAqBF,EAA4B,IAAI,GACrD,EAAE,UAAAG,GAAU,YAAAC,EAAA,IAAepC;AAEjC,EAAA0B,EAAU,MAAM;AACd,QAAKK,EAAU,QAAQ,QACvB;AAAA,UAAIG,EAAmB,YAAY,MAAM;AACvC,QAAAA,EAAmB,UAAUtB;AAC7B;AAAA,MACF;AACA,UAAIsB,EAAmB,YAAYtB;AAGnC,YAFAsB,EAAmB,UAAUtB,GAEzBA,MAAmBhB,EAAS,QAAQ;AACtC,gBAAMyC,IAAYN,EAAU,QAAQ,OAAsC,CAACd,GAAKqB,OAC9ErB,EAAIqB,EAAK,IAAI,IAAIA,EAAK,SAASL,EAAe,UAAU,OAAO,GACxDhB,IACN,CAAA,CAAE;AACL,UAAAkB,EAAS,eAAeE,CAAS;AAAA,QACnC,OAAO;AACL,gBAAMA,IAAYN,EAAU,QAAQ;AAAA,YAClC,CAACd,GAAKqB,GAAM3D,OACVsC,EAAIqB,EAAK,IAAI,IAAI3D,MAAU,IAAI,MAAM,GAC9BsC;AAAA,YAET,CAAA;AAAA,UAAC;AAEH,UAAAkB,EAAS,eAAeE,CAAS;AAAA,QACnC;AAAA;AAAA,EACF,GAAG,CAACzB,GAAgBuB,CAAQ,CAAC;AAE7B,QAAMI,IAAgBC;AAAA,IACpB,CAACC,MAA2B;AAC1B,YAAMC,IAAgBX,EAAU,SAC1BY,IAAa,IAAI,IAAID,EAAc,IAAI,CAAAE,MAAKA,EAAE,IAAI,CAAC;AACzD,UACEH,EAAa,WAAWE,EAAW,QACnC,CAACF,EAAa,MAAM,CAAAZ,MAAQc,EAAW,IAAId,CAAI,CAAC;AAEhD;AAGF,YAAMgB,IAAgBJ,EAAa,OAA+B,CAACxB,GAAKY,GAAMlD,OAC5EsC,EAAIY,CAAI,IAAIlD,IAAQ,GACbsC,IACN,CAAA,CAAE,GACC6B,IAAiBL,EAAaA,EAAa,SAAS,CAAC;AAC3D,UAAI,CAACK,EAAgB;AAErB,MAAAX,EAAS,YAAYU,CAAa;AAClC,YAAME,IAAoBd,EAAe;AACzC,MAAIc,KAAqBA,MAAsBD,MAC7CV,EAAW,eAAeW,CAAiB,EAAE,GAC7CZ,EAAS,eAAeY,CAAiB,IAAI,CAAC,IAEhDZ,EAAS,eAAeW,CAAc,IAAI,IAAI;AAAA,IAChD;AAAA,IACA,CAACX,GAAUC,CAAU;AAAA,EAAA,GAGjBY,KAAiBC,EAAgB,IAAI,CAAAC,OAAU,EAAE,OAAAA,GAAO,OAAOA,IAAQ,GACvEC,IAAeC,GAAwB5D,GAAgBQ,EAAY,OAAO,GAC1EqD,KAAuB/D,EAAwB,MAAM;AACzD,UAAMgE,IAA0B,CAAA,GAC1B3D,IAAgBiB,MAAmBhB,EAAS;AAClD,eAAWnB,KAASY,GAAQ;AAC1B,YAAMkE,IAAO,eAAe9E,EAAM,IAAI,IAChC+E,IAAc7D,KAAiBlB,EAAM,SAASkD;AAMpD,MAAA2B,EAAQC,CAAI,IAAI;AAAA,QACd,MAAMA;AAAA,QACN,YAAY;AAAA,QACZ,YAAYC;AAAA,MAAA;AAAA,IAEhB;AACA,WAAOF;AAAA,EACT,GAAG,CAACjE,GAAQuB,GAAgBe,CAAW,CAAC,GAClC8B,KAAiC;AAAA,IACrC,SAASC,GAA0BP,EAAa,SAASH,IAAgB,CAAC,GAAGC,CAAe,CAAC;AAAA,IAC7F,aAAaE,EAAa;AAAA,IAC1B,UAAUA,EAAa;AAAA,IACvB,GAAGE;AAAA,EAAA,GAGCM,KAAoBrE;AAAA,IACxB,MACEsE;AAAA,MACEvE,EAAO,IAAI,CAAAuD,OAAM;AAAA,QACf,MAAMA,EAAE;AAAA,QACR,MAAMA,EAAE;AAAA,QACR,qBAAqBA,EAAE;AAAA,MAAA,EACvB;AAAA,IAAA;AAAA,IAEN,CAACvD,CAAM;AAAA,EAAA,GAGHwE,KAAW,YAA0E;AACzF,QAAI,CAACtF;AACH,YAAM,IAAIuF,EAAiB,yDAAyD;AAEtF,UAAMC,IAAuBxF,GACvBmE,IAAgBrD;AACtB,QAAI2E;AAEJ,iBAAM,IAAI,QAAc,CAAAC,MAAW;AACjC,MAAKjE,EAAY;AAAA,QACf,OAAOkE,MAAmC;AACxC,gBAAM5D,EAAkB4D,GAAM,OAAMC,MAAW;AAC7C,kBAAMxE,IAAgBwE,EAAQ,YAAYvE,EAAS,QAC7CwE,IAAO;AAAA,cACX,GAAGL;AAAA,cACH,SAASA,EAAqB;AAAA,cAC9B,SAASI,EAAQ;AAAA,cACjB,QAAQzB,EAAc,IAAI,CAAAjE,MAAS;AACjC,sBAAM4F,IAAmBF,EAAQ,YAAY1F,EAAM,IAAI,KAAK;AAC5D,uBAAO;AAAA,kBACL,MAAMA,EAAM;AAAA,kBACZ,MAAMA,EAAM,QAAQ;AAAA,kBACpB,qBAAqBA,EAAM,uBAAuB;AAAA,kBAClD,aAAakB,IAAgB2E,GAAeD,CAAgB,IAAIA;AAAA,kBAChE,UAAUF,EAAQ,SAAS1F,EAAM,IAAI;AAAA,gBAAA;AAAA,cAEzC,CAAC;AAAA,YAAA,GAGG8F,IAAW,MAAMpE,EAAe,YAAY;AAAA,cAChD,SAAS;AAAA,gBACP,YAAAtB;AAAA,gBACA,aAAa,EAAE,GAAGuF,GAAM,MAAMI,GAAgB,cAAA;AAAA,cAAc;AAAA,YAC9D,CACD;AAED,gBAAI,CAACD,EAAS;AACZ,oBAAM,IAAIT,EAAiB,8BAA8B;AAG3D,YAAAE,IAAe,EAAE,MAAM,UAAmB,MAAMO,EAAS,sBAAA;AAAA,UAC3D,CAAC,GACDN,EAAA;AAAA,QACF;AAAA,QACA,MAAM;AACJ,UAAAA,EAAA;AAAA,QACF;AAAA,MAAA,EACF;AAAA,IACF,CAAC,GAEMD;AAAA,EACT,GAEMS,KAAoBC,GAAqB1E,CAAW;AAE1D,SACEf,EAAmB,aACnBE,EAAkB,aAClB,CAACZ,KACD,CAACC,IAEM,EAAE,WAAW,IAAe,eAAAkC,EAAA,IAG9B;AAAA,IACL,WAAW;AAAA,IACX,MAAM;AAAA,MACJ,eAAAnC;AAAA,MACA,cAAAC;AAAA,MACA,QAAAa;AAAA,MACA,aAAAsC;AAAA,IAAA;AAAA,IAEF,QAAQ;AAAA,MACN,WAAAtB;AAAA,MACA,MAAM;AAAA,MACN,SAASO;AAAA,MACT,iBAAAI;AAAA,MACA,wBAAAM;AAAA,IAAA;AAAA,IAEF,SAAS,EAAE,UAAAuC,IAAU,eAAAtB,EAAA;AAAA,IACrB,eAAA7B;AAAA,IACA,MAAM;AAAA,MACJ,QAAQ,EAAE,SAASiE,IAAc,QAAQhB,GAAA;AAAA,MACzC,gBAAAF;AAAA,MACA,mBAAAgB;AAAA,MACA,yBAAyBG,GAA8B5E,GAAaT,CAAM;AAAA,IAAA;AAAA,EAC5E;AAEJ;"}

package/dist/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/useSplitPaymentsFormSchema.d.ts

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+import { OptionalFieldsToRequire } from '../../../../../partner-hook-utils/form/buildFormSchema';
+export declare const SplitPaymentsFormErrorCodes: {
+    readonly REQUIRED: "REQUIRED";
+    readonly INVALID_PERCENTAGE: "INVALID_PERCENTAGE";
+    readonly INVALID_AMOUNT: "INVALID_AMOUNT";
+    readonly DUPLICATE_PRIORITIES: "DUPLICATE_PRIORITIES";
+    readonly PERCENTAGE_TOTAL_MISMATCH: "PERCENTAGE_TOTAL_MISMATCH";
+};
+/**
+ * Synthetic form path where the schema emits the percentage-sum-to-100
+ * invariant. The hook subscribes to errors at this path to drive
+ * `status.hasPercentageImbalance`.
+ */
+export declare const PERCENTAGE_TOTAL_PATH: "percentageTotal";
+export type SplitPaymentsFormErrorCode = (typeof SplitPaymentsFormErrorCodes)[keyof typeof SplitPaymentsFormErrorCodes];
+export declare const SPLIT_BY_VALUES: readonly ["Percentage", "Amount"];
+export type SplitByValue = (typeof SPLIT_BY_VALUES)[number];
+declare const fieldValidators: {
+    splitBy: z.ZodEnum<{
+        Percentage: "Percentage";
+        Amount: "Amount";
+    }>;
+    splitAmount: z.ZodRecord<z.ZodString, z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNullable<z.ZodNumber>>>;
+    priority: z.ZodRecord<z.ZodString, z.ZodNumber>;
+};
+export type SplitPaymentsFormField = keyof typeof fieldValidators;
+export type SplitPaymentsFormData = {
+    splitBy: SplitByValue;
+    splitAmount: Record<string, number | null>;
+    priority: Record<string, number>;
+};
+export type SplitPaymentsFormOutputs = SplitPaymentsFormData;
+declare const requiredFieldsConfig: {};
+export type SplitPaymentsFormOptionalFieldsToRequire = OptionalFieldsToRequire<typeof requiredFieldsConfig>;
+interface SplitPaymentsFormSchemaOptions {
+    optionalFieldsToRequire?: SplitPaymentsFormOptionalFieldsToRequire;
+}
+/**
+ * Resolves the remainder uuid (highest priority value) from a priority map.
+ * Exported so the hook can mirror the same selection rule when deriving
+ * dynamic field metadata.
+ */
+export declare function resolveRemainderUuid(priority: Record<string, number>): string;
+export declare function createSplitPaymentsFormSchema(options?: SplitPaymentsFormSchemaOptions): import('../../../../../partner-hook-utils/form/buildFormSchema').BuildFormSchemaResult<{
+    splitBy: z.ZodEnum<{
+        Percentage: "Percentage";
+        Amount: "Amount";
+    }>;
+    splitAmount: z.ZodRecord<z.ZodString, z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNullable<z.ZodNumber>>>;
+    priority: z.ZodRecord<z.ZodString, z.ZodNumber>;
+}>;
+export {};

package/dist/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/useSplitPaymentsFormSchema.js

@@ -0,0 +1,93 @@
+import { z as e } from "zod";
+import { buildFormSchema as l } from "../../../../../partner-hook-utils/form/buildFormSchema.js";
+import { SPLIT_BY as d } from "../../../../../shared/constants.js";
+const u = {
+  REQUIRED: "REQUIRED",
+  INVALID_PERCENTAGE: "INVALID_PERCENTAGE",
+  INVALID_AMOUNT: "INVALID_AMOUNT",
+  DUPLICATE_PRIORITIES: "DUPLICATE_PRIORITIES",
+  PERCENTAGE_TOTAL_MISMATCH: "PERCENTAGE_TOTAL_MISMATCH"
+}, m = "percentageTotal", c = [d.percentage, d.amount], E = e.preprocess(
+  (t) => typeof t == "number" && Number.isNaN(t) ? null : t,
+  e.number().nullable()
+), a = {
+  splitBy: e.enum(c),
+  splitAmount: e.record(e.string(), E),
+  priority: e.record(e.string(), e.number())
+}, p = {};
+function A(t) {
+  return Object.entries(t).reduce((o, [s, i]) => {
+    if (!o) return s;
+    const n = t[o] ?? 0;
+    return i > n ? s : o;
+  }, "");
+}
+function C(t = {}) {
+  return l(a, {
+    requiredFieldsConfig: p,
+    requiredErrorCode: u.REQUIRED,
+    mode: "update",
+    optionalFieldsToRequire: t.optionalFieldsToRequire,
+    superRefine: (o, s) => {
+      if (o.splitBy === d.percentage) {
+        let i = !1, n = 0;
+        for (const [I, r] of Object.entries(o.splitAmount)) {
+          if (r === null) {
+            i = !0, s.addIssue({
+              code: e.ZodIssueCode.custom,
+              path: ["splitAmount", I],
+              message: u.REQUIRED
+            });
+            continue;
+          }
+          if (!Number.isInteger(r) || r < 0 || r > 100) {
+            i = !0, s.addIssue({
+              code: e.ZodIssueCode.custom,
+              path: ["splitAmount", I],
+              message: u.INVALID_PERCENTAGE
+            });
+            continue;
+          }
+          n += r;
+        }
+        !i && n !== 100 && s.addIssue({
+          code: e.ZodIssueCode.custom,
+          path: [m],
+          message: u.PERCENTAGE_TOTAL_MISMATCH
+        });
+      } else {
+        const i = A(o.priority);
+        for (const [I, r] of Object.entries(o.splitAmount)) {
+          if (r === null) {
+            if (I === i) continue;
+            s.addIssue({
+              code: e.ZodIssueCode.custom,
+              path: ["splitAmount", I],
+              message: u.REQUIRED
+            });
+            continue;
+          }
+          r < 0 && s.addIssue({
+            code: e.ZodIssueCode.custom,
+            path: ["splitAmount", I],
+            message: u.INVALID_AMOUNT
+          });
+        }
+        const n = Object.values(o.priority);
+        new Set(n).size !== n.length && s.addIssue({
+          code: e.ZodIssueCode.custom,
+          path: ["priority"],
+          message: u.DUPLICATE_PRIORITIES
+        });
+      }
+    }
+  });
+}
+export {
+  m as PERCENTAGE_TOTAL_PATH,
+  c as SPLIT_BY_VALUES,
+  u as SplitPaymentsFormErrorCodes,
+  C as createSplitPaymentsFormSchema,
+  A as resolveRemainderUuid
+};
+//# sourceMappingURL=useSplitPaymentsFormSchema.js.map