@gusto/embedded-react-sdk 0.44.1 → 0.45.0

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":"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"}

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"useSplitPaymentsFormSchema.js","sources":["../../../../../../src/components/Employee/PaymentMethod/shared/useSplitPaymentsForm/useSplitPaymentsFormSchema.ts"],"sourcesContent":["import { z } from 'zod'\nimport {\n  buildFormSchema,\n  type OptionalFieldsToRequire,\n  type RequiredFieldConfig,\n} from '@/partner-hook-utils/form/buildFormSchema'\nimport { SPLIT_BY } from '@/shared/constants'\n\nexport const SplitPaymentsFormErrorCodes = {\n  REQUIRED: 'REQUIRED',\n  INVALID_PERCENTAGE: 'INVALID_PERCENTAGE',\n  INVALID_AMOUNT: 'INVALID_AMOUNT',\n  DUPLICATE_PRIORITIES: 'DUPLICATE_PRIORITIES',\n  PERCENTAGE_TOTAL_MISMATCH: 'PERCENTAGE_TOTAL_MISMATCH',\n} as const\n\n/**\n * Synthetic form path where the schema emits the percentage-sum-to-100\n * invariant. The hook subscribes to errors at this path to drive\n * `status.hasPercentageImbalance`.\n */\nexport const PERCENTAGE_TOTAL_PATH = 'percentageTotal' as const\n\nexport type SplitPaymentsFormErrorCode =\n  (typeof SplitPaymentsFormErrorCodes)[keyof typeof SplitPaymentsFormErrorCodes]\n\nexport const SPLIT_BY_VALUES = [SPLIT_BY.percentage, SPLIT_BY.amount] as const\nexport type SplitByValue = (typeof SPLIT_BY_VALUES)[number]\n\n// Cleared NumberInput emits `NaN`. Normalize NaN to `null` at the schema\n// boundary so it (a) doesn't trip Zod's built-in \"expected number, received\n// NaN\" message, and (b) flows through the same REQUIRED branch in\n// `superRefine` as an explicitly null value.\nconst splitAmountValueSchema = z.preprocess(\n  v => (typeof v === 'number' && Number.isNaN(v) ? null : v),\n  z.number().nullable(),\n)\n\nconst fieldValidators = {\n  splitBy: z.enum(SPLIT_BY_VALUES),\n  splitAmount: z.record(z.string(), splitAmountValueSchema),\n  priority: z.record(z.string(), z.number()),\n}\n\nexport type SplitPaymentsFormField = keyof typeof fieldValidators\n\nexport type SplitPaymentsFormData = {\n  splitBy: SplitByValue\n  splitAmount: Record<string, number | null>\n  priority: Record<string, number>\n}\nexport type SplitPaymentsFormOutputs = SplitPaymentsFormData\n\nconst requiredFieldsConfig = {} satisfies RequiredFieldConfig<typeof fieldValidators>\n\nexport type SplitPaymentsFormOptionalFieldsToRequire = OptionalFieldsToRequire<\n  typeof requiredFieldsConfig\n>\n\ninterface SplitPaymentsFormSchemaOptions {\n  optionalFieldsToRequire?: SplitPaymentsFormOptionalFieldsToRequire\n}\n\n/**\n * Resolves the remainder uuid (highest priority value) from a priority map.\n * Exported so the hook can mirror the same selection rule when deriving\n * dynamic field metadata.\n */\nexport function resolveRemainderUuid(priority: Record<string, number>): string {\n  return Object.entries(priority).reduce<string>((maxId, [uuid, value]) => {\n    if (!maxId) return uuid\n    const currentMax = priority[maxId] ?? 0\n    return value > currentMax ? uuid : maxId\n  }, '')\n}\n\nexport function createSplitPaymentsFormSchema(options: SplitPaymentsFormSchemaOptions = {}) {\n  return buildFormSchema(fieldValidators, {\n    requiredFieldsConfig,\n    requiredErrorCode: SplitPaymentsFormErrorCodes.REQUIRED,\n    mode: 'update',\n    optionalFieldsToRequire: options.optionalFieldsToRequire,\n    superRefine: (data, ctx) => {\n      if (data.splitBy === SPLIT_BY.percentage) {\n        let anyInvalid = false\n        let total = 0\n        for (const [uuid, value] of Object.entries(data.splitAmount)) {\n          if (value === null) {\n            anyInvalid = true\n            ctx.addIssue({\n              code: z.ZodIssueCode.custom,\n              path: ['splitAmount', uuid],\n              message: SplitPaymentsFormErrorCodes.REQUIRED,\n            })\n            continue\n          }\n          if (!Number.isInteger(value) || value < 0 || value > 100) {\n            anyInvalid = true\n            ctx.addIssue({\n              code: z.ZodIssueCode.custom,\n              path: ['splitAmount', uuid],\n              message: SplitPaymentsFormErrorCodes.INVALID_PERCENTAGE,\n            })\n            continue\n          }\n          total += value\n        }\n        // Only enforce sum-to-100 when every split is otherwise valid. While\n        // any value is missing or out of range, the per-field error is the\n        // right thing to surface; an additional sum mismatch would be noise.\n        // Emitted at the synthetic form path so the hook can drive a\n        // form-level alert via `status.hasPercentageImbalance` without\n        // polluting per-field errors.\n        if (!anyInvalid && total !== 100) {\n          ctx.addIssue({\n            code: z.ZodIssueCode.custom,\n            path: [PERCENTAGE_TOTAL_PATH],\n            message: SplitPaymentsFormErrorCodes.PERCENTAGE_TOTAL_MISMATCH,\n          })\n        }\n      } else {\n        const remainderUuid = resolveRemainderUuid(data.priority)\n        for (const [uuid, value] of Object.entries(data.splitAmount)) {\n          if (value === null) {\n            if (uuid === remainderUuid) continue\n            ctx.addIssue({\n              code: z.ZodIssueCode.custom,\n              path: ['splitAmount', uuid],\n              message: SplitPaymentsFormErrorCodes.REQUIRED,\n            })\n            continue\n          }\n          if (value < 0) {\n            ctx.addIssue({\n              code: z.ZodIssueCode.custom,\n              path: ['splitAmount', uuid],\n              message: SplitPaymentsFormErrorCodes.INVALID_AMOUNT,\n            })\n          }\n        }\n        const priorities = Object.values(data.priority)\n        if (new Set(priorities).size !== priorities.length) {\n          ctx.addIssue({\n            code: z.ZodIssueCode.custom,\n            path: ['priority'],\n            message: SplitPaymentsFormErrorCodes.DUPLICATE_PRIORITIES,\n          })\n        }\n      }\n    },\n  })\n}\n"],"names":["SplitPaymentsFormErrorCodes","PERCENTAGE_TOTAL_PATH","SPLIT_BY_VALUES","SPLIT_BY","splitAmountValueSchema","z","v","fieldValidators","requiredFieldsConfig","resolveRemainderUuid","priority","maxId","uuid","value","currentMax","createSplitPaymentsFormSchema","options","buildFormSchema","data","ctx","anyInvalid","total","remainderUuid","priorities"],"mappings":"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"}