npm - @gusto/embedded-react-sdk - Versions diffs - 0.50.0 → 0.51.2 - Mend

@gusto/embedded-react-sdk 0.50.0 → 0.51.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1000) hide show

package/dist/components/Employee/Deductions/shared/useChildSupportGarnishmentForm/useChildSupportGarnishmentForm.d.ts CHANGED Viewed

@@ -1,9 +1,10 @@
+import { ComponentType } from 'react';
 import { UseFormProps } from 'react-hook-form';
-import { Garnishment } from '@gusto/embedded-api-v-2025-11-15/models/components/garnishment';
-import { Agencies } from '@gusto/embedded-api-v-2025-11-15/models/components/childsupportdata';
+import { Garnishment } from '@gusto/embedded-api/models/components/garnishment';
+import { Agencies } from '@gusto/embedded-api/models/components/childsupportdata';
 import { ChildSupportGarnishmentFormData, SupportedRequiredAttrKey } from './childSupportGarnishmentFormSchema';
-import { StateField, FipsCodeField, CaseNumberField, OrderNumberField, RemittanceNumberField, PayPeriodMaximumField, AmountField, PaymentPeriodField, CountyEntry, StateFieldEntry } from './fields';
-import { BaseFormHookReady, FieldsMetadata, HookLoadingResult, HookSubmitResult } from '../../../../../partner-hook-utils/types';
+import { CountyEntry, StateFieldEntry, StateFieldProps, FipsCodeFieldProps, CaseNumberFieldProps, OrderNumberFieldProps, RemittanceNumberFieldProps, PayPeriodMaximumFieldProps, AmountFieldProps, PaymentPeriodFieldProps } from './fields';
+import { BaseFormHookReady, FieldMetadata, HookLoadingResult, HookSubmitResult } from '../../../../../partner-hook-utils/types';
 /**
  * Configuration options for {@link useChildSupportGarnishmentForm}.
  *
@@ -40,23 +41,24 @@ export interface UseChildSupportGarnishmentFormProps {
  * @public
  */
 export interface ChildSupportGarnishmentFormFields {
-    /** Agency (state) select. Always available. */
-    State: typeof StateField;
-    /** Only available when the selected agency has more than one fips code, or the
-     *  sole code is county-scoped (not an "all counties" auto-pick). */
-    FipsCode: typeof FipsCodeField | undefined;
-    /** Only available when the selected agency requires `case_number`. */
-    CaseNumber: typeof CaseNumberField | undefined;
-    /** Only available when the selected agency requires `order_number`. */
-    OrderNumber: typeof OrderNumberField | undefined;
-    /** Only available when the selected agency requires `remittance_number`. */
-    RemittanceNumber: typeof RemittanceNumberField | undefined;
-    /** Per-pay-period currency cap input. Always available. */
-    PayPeriodMaximum: typeof PayPeriodMaximumField;
-    /** Percent-of-paycheck input (0–100). Always available. */
-    Amount: typeof AmountField;
-    /** Payment period select. Always available. */
-    PaymentPeriod: typeof PaymentPeriodField;
+    /** Bound to `state`. Agency (state) select. Always available. */
+    State: ComponentType<StateFieldProps>;
+    /** Bound to `fipsCode`. Only available when the selected agency has more than
+     *  one fips code, or the sole code is county-scoped (not an "all counties"
+     *  auto-pick). */
+    FipsCode: ComponentType<FipsCodeFieldProps> | undefined;
+    /** Bound to `caseNumber`. Only available when the selected agency requires `case_number`. */
+    CaseNumber: ComponentType<CaseNumberFieldProps> | undefined;
+    /** Bound to `orderNumber`. Only available when the selected agency requires `order_number`. */
+    OrderNumber: ComponentType<OrderNumberFieldProps> | undefined;
+    /** Bound to `remittanceNumber`. Only available when the selected agency requires `remittance_number`. */
+    RemittanceNumber: ComponentType<RemittanceNumberFieldProps> | undefined;
+    /** Bound to `payPeriodMaximum`. Per-pay-period currency cap input. Always available. */
+    PayPeriodMaximum: ComponentType<PayPeriodMaximumFieldProps>;
+    /** Bound to `amount`. Percent-of-paycheck input (0–100). Always available. */
+    Amount: ComponentType<AmountFieldProps>;
+    /** Bound to `paymentPeriod`. Payment period select. Always available. */
+    PaymentPeriod: ComponentType<PaymentPeriodFieldProps>;
 }
 /**
  * Ready-state shape returned by {@link useChildSupportGarnishmentForm} once data has loaded.
@@ -69,7 +71,7 @@ export interface ChildSupportGarnishmentFormFields {
  *
  * @public
  */
-export interface UseChildSupportGarnishmentFormReady extends BaseFormHookReady<FieldsMetadata, ChildSupportGarnishmentFormData, ChildSupportGarnishmentFormFields> {
+export interface UseChildSupportGarnishmentFormReady extends BaseFormHookReady<ChildSupportGarnishmentFormFieldsMetadata, ChildSupportGarnishmentFormData, ChildSupportGarnishmentFormFields> {
     /** Child-support-specific data payload: the available agencies, counties for the selected state, and the loaded garnishment for update mode. */
     data: {
         /** Agencies offered as `State` options; raw entries the consumer can use
@@ -185,4 +187,5 @@ export declare function useChildSupportGarnishmentForm({ employeeId, garnishment
  *
  * @public
  */
-export type ChildSupportGarnishmentFormFieldsMetadata = UseChildSupportGarnishmentFormReady['form']['fieldsMetadata'];
+export type ChildSupportGarnishmentFormFieldsMetadata = { state: import("../../../../../partner-hook-utils/types").FieldMetadataWithOptions<StateFieldEntry>; fipsCode: import("../../../../../partner-hook-utils/types").FieldMetadataWithOptions<CountyEntry>; caseNumber: FieldMetadata; orderNumber: FieldMetadata; remittanceNumber: FieldMetadata; payPeriodMaximum: FieldMetadata; amount: FieldMetadata; paymentPeriod: import("../../../../../partner-hook-utils/types").FieldMetadataWithOptions<"Every week" | "Every other week" | "Twice per month" | "Monthly">; };
+export {};

package/dist/components/Employee/Deductions/shared/useChildSupportGarnishmentForm/useChildSupportGarnishmentForm.js CHANGED Viewed

@@ -1,20 +1,20 @@
-import { useMemo as u, useRef as Z, useEffect as q } from "react";
+import { useMemo as s, useRef as Z, useEffect as k } from "react";
 import { useForm as ee, useWatch as te } from "react-hook-form";
 import { zodResolver as re } from "@hookform/resolvers/zod";
-import { PaymentPeriod as r } from "@gusto/embedded-api-v-2025-11-15/models/components/garnishmentchildsupport";
-import { useGarnishmentsCreateMutation as oe } from "@gusto/embedded-api-v-2025-11-15/react-query/garnishmentsCreate";
-import { useGarnishmentsUpdateMutation as ie } from "@gusto/embedded-api-v-2025-11-15/react-query/garnishmentsUpdate";
-import { useGarnishmentsList as ne } from "@gusto/embedded-api-v-2025-11-15/react-query/garnishmentsList";
-import { useGarnishmentsGetChildSupportData as ae } from "@gusto/embedded-api-v-2025-11-15/react-query/garnishmentsGetChildSupportData";
-import { createChildSupportGarnishmentFormSchema as se, getRequiredAttrKeys as ue } from "./childSupportGarnishmentFormSchema.js";
-import { PaymentPeriodField as me, AmountField as de, PayPeriodMaximumField as ce, RemittanceNumberField as le, OrderNumberField as pe, CaseNumberField as he, FipsCodeField as be, StateField as fe } from "./fields.js";
+import { PaymentPeriod as r } from "@gusto/embedded-api/models/components/garnishmentchildsupport";
+import { useGarnishmentsCreateMutation as oe } from "@gusto/embedded-api/react-query/garnishmentsCreate";
+import { useGarnishmentsUpdateMutation as ie } from "@gusto/embedded-api/react-query/garnishmentsUpdate";
+import { useGarnishmentsList as ne } from "@gusto/embedded-api/react-query/garnishmentsList";
+import { useGarnishmentsGetChildSupportData as ae } from "@gusto/embedded-api/react-query/garnishmentsGetChildSupportData";
+import { createChildSupportGarnishmentFormSchema as ue, getRequiredAttrKeys as se } from "./childSupportGarnishmentFormSchema.js";
+import { PaymentPeriodField as me, AmountField as de, PayPeriodMaximumField as ce, RemittanceNumberField as le, OrderNumberField as pe, CaseNumberField as he, FipsCodeField as fe, StateField as be } from "./fields.js";
 import { useDeriveFieldsMetadata as ye } from "../../../../../partner-hook-utils/form/useDeriveFieldsMetadata.js";
 import { useHookFormInternals as Pe } from "../../../../../partner-hook-utils/form/useHookFormInternals.js";
 import { createGetFormSubmissionValues as Ne } from "../../../../../partner-hook-utils/form/getFormSubmissionValues.js";
-import { withOptions as M } from "../../../../../partner-hook-utils/form/withOptions.js";
-import { composeErrorHandler as ge } from "../../../../../partner-hook-utils/composeErrorHandler.js";
-import { useBaseSubmit as Se } from "../../../../Base/useBaseSubmit.js";
-import { SDKInternalError as k } from "../../../../../types/sdkError.js";
+import { withOptions as v } from "../../../../../partner-hook-utils/form/withOptions.js";
+import { composeErrorHandler as Se } from "../../../../../partner-hook-utils/composeErrorHandler.js";
+import { useBaseSubmit as ge } from "../../../../Base/useBaseSubmit.js";
+import { SDKInternalError as V } from "../../../../../types/sdkError.js";
 const Me = [
   { value: r.EveryWeek, label: r.EveryWeek },
   { value: r.EveryOtherWeek, label: r.EveryOtherWeek },
@@ -26,17 +26,38 @@ const Me = [
   r.TwicePerMonth,
   r.Monthly
 ];
-function He({
-  employeeId: C,
-  garnishmentId: P,
+function ve(o, {
+  stateOptions: c,
+  agencies: i,
+  countyOptions: N,
+  counties: S
+}) {
+  return {
+    state: v(o.state, c, i),
+    fipsCode: v(o.fipsCode, N, S),
+    caseNumber: o.caseNumber,
+    orderNumber: o.orderNumber,
+    remittanceNumber: o.remittanceNumber,
+    payPeriodMaximum: o.payPeriodMaximum,
+    amount: o.amount,
+    paymentPeriod: v(
+      o.paymentPeriod,
+      [...Me],
+      [...Ce]
+    )
+  };
+}
+function Ke({
+  employeeId: o,
+  garnishmentId: c,
   defaultValues: i,
-  validationMode: V = "onSubmit",
-  shouldFocusError: W = !0
+  validationMode: N = "onSubmit",
+  shouldFocusError: S = !0
 }) {
-  const o = !P, v = o ? "create" : "update", c = ae({}), d = u(
-    () => c.data?.childSupportData?.agencies ?? [],
-    [c.data]
-  ), h = ne({ employeeId: C }, { enabled: !o }), t = u(() => o ? null : h.data?.garnishments?.find((e) => e.uuid === P) ?? null, [o, P, h.data]), F = u(
+  const n = !c, F = n ? "create" : "update", l = ae({}), d = s(
+    () => l.data?.childSupportData?.agencies ?? [],
+    [l.data]
+  ), f = ne({ employeeId: o }, { enabled: !n }), t = s(() => n ? null : f.data?.garnishments?.find((e) => e.uuid === c) ?? null, [n, c, f.data]), E = s(
     () => ({
       state: t?.childSupport?.state ?? i?.state ?? "",
       fipsCode: t?.childSupport?.fipsCode ?? i?.fipsCode ?? "",
@@ -48,80 +69,72 @@ function He({
       paymentPeriod: t?.childSupport?.paymentPeriod ?? i?.paymentPeriod ?? r.Monthly
     }),
     [t, i]
-  ), [E, L] = u(
-    () => se({ mode: v, agencyList: d }),
-    [v, d]
-  ), n = ee({
-    resolver: re(E),
-    mode: V,
-    shouldFocusError: W,
-    defaultValues: F,
-    values: F,
+  ), [R, W] = s(
+    () => ue({ mode: F, agencyList: d }),
+    [F, d]
+  ), a = ee({
+    resolver: re(R),
+    mode: N,
+    shouldFocusError: S,
+    defaultValues: E,
+    values: E,
     resetOptions: { keepDirtyValues: !0 }
-  }), l = te({ control: n.control, name: "state" }), m = u(
-    () => d.find((e) => e.state === l) ?? null,
-    [d, l]
-  ), R = Z(null);
-  q(() => {
-    const e = R.current;
-    R.current = l, e !== null && e !== "" && e !== l && (n.setValue("caseNumber", ""), n.setValue("orderNumber", ""), n.setValue("remittanceNumber", ""));
-  }, [l]);
-  const N = m?.fipsCodes ?? [], b = N.length === 1 && !N[0]?.county?.length ? N[0]?.code ?? null : null;
-  q(() => {
-    b && n.setValue("fipsCode", b);
+  }), p = te({ control: a.control, name: "state" }), m = s(
+    () => d.find((e) => e.state === p) ?? null,
+    [d, p]
+  ), O = Z(null);
+  k(() => {
+    const e = O.current;
+    O.current = p, e !== null && e !== "" && e !== p && (a.setValue("caseNumber", ""), a.setValue("orderNumber", ""), a.setValue("remittanceNumber", ""));
+  }, [p]);
+  const g = m?.fipsCodes ?? [], b = g.length === 1 && !g[0]?.county?.length ? g[0]?.code ?? null : null;
+  k(() => {
+    b && a.setValue("fipsCode", b);
   }, [b]);
-  const O = oe(), w = ie(), T = O.isPending || w.isPending, {
-    baseSubmitHandler: _,
-    error: I,
-    setError: H
-  } = Se("ChildSupportGarnishmentForm"), g = ge(
-    o ? [c] : [c, h],
-    { submitError: I, setSubmitError: H }
-  ), S = u(
+  const w = oe(), x = ie(), L = w.isPending || x.isPending, {
+    baseSubmitHandler: T,
+    error: _,
+    setError: I
+  } = ge("ChildSupportGarnishmentForm"), M = Se(
+    n ? [l] : [l, f],
+    { submitError: _, setSubmitError: I }
+  ), C = s(
     () => d.map((e) => ({
       state: e.state ?? "",
       name: e.name ?? e.state ?? "",
       manualPaymentRequired: e.manualPaymentRequired ?? !1
     })),
     [d]
-  ), p = u(
+  ), h = s(
     () => (m?.fipsCodes ?? []).filter((e) => typeof e.code == "string").map((e) => ({ fipsCode: e.code, county: e.county ?? null })),
     [m]
-  ), f = u(
-    () => ue(m),
+  ), y = s(
+    () => se(m),
     [m]
-  ), K = p.length > 1 || p.length === 1 && b == null, s = ye(L, n.control), B = S.map((e) => ({ value: e.state, label: e.name })), D = p.map((e) => ({
+  ), H = h.length > 1 || h.length === 1 && b == null, K = ye(W, a.control), B = C.map((e) => ({ value: e.state, label: e.name })), D = h.map((e) => ({
     value: e.fipsCode,
     label: e.county ?? e.fipsCode
-  })), Q = {
-    state: M(s.state, B, S),
-    fipsCode: M(s.fipsCode, D, p),
-    caseNumber: s.caseNumber,
-    orderNumber: s.orderNumber,
-    remittanceNumber: s.remittanceNumber,
-    payPeriodMaximum: s.payPeriodMaximum,
-    amount: s.amount,
-    paymentPeriod: M(
-      s.paymentPeriod,
-      [...Me],
-      [...Ce]
-    )
-  }, Y = async () => {
+  })), Q = ve(K, {
+    stateOptions: B,
+    agencies: C,
+    countyOptions: D,
+    counties: h
+  }), Y = async () => {
     let e;
-    return await new Promise((x) => {
-      n.handleSubmit(
+    return await new Promise((G) => {
+      a.handleSubmit(
         async (U) => {
-          await _(U, async (a) => {
+          await T(U, async (u) => {
             const A = {
-              state: a.state,
-              paymentPeriod: a.paymentPeriod,
-              fipsCode: a.fipsCode,
+              state: u.state,
+              paymentPeriod: u.paymentPeriod,
+              fipsCode: u.fipsCode,
               // Empty strings collapse to null so the API persists "no value
               // declared" rather than an empty case number.
-              caseNumber: a.caseNumber || null,
-              orderNumber: a.orderNumber || null,
-              remittanceNumber: a.remittanceNumber || null
-            }, $ = `Child Support - ${A.caseNumber ?? ""}`, j = String(a.amount), J = a.payPeriodMaximum > 0 ? String(a.payPeriodMaximum) : null, G = {
+              caseNumber: u.caseNumber || null,
+              orderNumber: u.orderNumber || null,
+              remittanceNumber: u.remittanceNumber || null
+            }, $ = `Child Support - ${A.caseNumber ?? ""}`, j = String(u.amount), J = u.payPeriodMaximum > 0 ? String(u.payPeriodMaximum) : null, q = {
               active: !0,
               amount: j,
               description: $,
@@ -133,76 +146,76 @@ function He({
               recurring: !0,
               childSupport: A
             };
-            let y;
-            if (o)
-              y = (await O.mutateAsync({
-                request: { employeeId: C, garnishmentRequest: G }
+            let P;
+            if (n)
+              P = (await w.mutateAsync({
+                request: { employeeId: o, garnishmentRequest: q }
               })).garnishment;
             else {
               if (!t)
-                throw new k(
+                throw new V(
                   "Cannot update child-support deduction: no matching garnishment on file"
                 );
-              y = (await w.mutateAsync({
+              P = (await x.mutateAsync({
                 request: {
                   garnishmentId: t.uuid,
                   updateGarnishmentRequest: {
-                    ...G,
+                    ...q,
                     version: t.version
                   }
                 }
               })).garnishment;
             }
-            if (!y)
-              throw new k(
-                o ? "Child-support deduction creation failed" : "Child-support deduction update failed"
+            if (!P)
+              throw new V(
+                n ? "Child-support deduction creation failed" : "Child-support deduction update failed"
               );
             e = {
-              mode: o ? "create" : "update",
-              data: y
+              mode: n ? "create" : "update",
+              data: P
             };
-          }), x();
+          }), G();
         },
         () => {
-          x();
+          G();
         }
       )();
     }), e;
-  }, z = Pe(n);
-  return c.isLoading ? { isLoading: !0, errorHandling: g } : !o && h.isLoading ? { isLoading: !0, errorHandling: g } : {
+  }, z = Pe(a);
+  return l.isLoading ? { isLoading: !0, errorHandling: M } : !n && f.isLoading ? { isLoading: !0, errorHandling: M } : {
     isLoading: !1,
     data: {
-      agencies: S,
-      counties: p,
+      agencies: C,
+      counties: h,
       deduction: t
     },
     status: {
-      isPending: T,
-      mode: o ? "create" : "update",
+      isPending: L,
+      mode: n ? "create" : "update",
       selectedAgency: m,
       isManualPaymentRequired: m?.manualPaymentRequired ?? !1,
-      requiredAttrKeys: f
+      requiredAttrKeys: y
     },
     actions: { onSubmit: Y },
-    errorHandling: g,
+    errorHandling: M,
     form: {
       Fields: {
-        State: fe,
-        FipsCode: K ? be : void 0,
-        CaseNumber: f.has("case_number") ? he : void 0,
-        OrderNumber: f.has("order_number") ? pe : void 0,
-        RemittanceNumber: f.has("remittance_number") ? le : void 0,
+        State: be,
+        FipsCode: H ? fe : void 0,
+        CaseNumber: y.has("case_number") ? he : void 0,
+        OrderNumber: y.has("order_number") ? pe : void 0,
+        RemittanceNumber: y.has("remittance_number") ? le : void 0,
         PayPeriodMaximum: ce,
         Amount: de,
         PaymentPeriod: me
       },
       fieldsMetadata: Q,
       hookFormInternals: z,
-      getFormSubmissionValues: Ne(n, E)
+      getFormSubmissionValues: Ne(a, R)
     }
   };
 }
 export {
-  He as useChildSupportGarnishmentForm
+  Ke as useChildSupportGarnishmentForm
 };
 //# sourceMappingURL=useChildSupportGarnishmentForm.js.map

package/dist/components/Employee/Deductions/shared/useChildSupportGarnishmentForm/useChildSupportGarnishmentForm.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useChildSupportGarnishmentForm.js","sources":["../../../../../../src/components/Employee/Deductions/shared/useChildSupportGarnishmentForm/useChildSupportGarnishmentForm.tsx"],"sourcesContent":["import { useEffect, useMemo, useRef } from 'react'\nimport { useForm, useWatch } from 'react-hook-form'\nimport type { UseFormProps } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport {\n type Garnishment,\n type GarnishmentType,\n} from '@gusto/embedded-api-v-2025-11-15/models/components/garnishment'\nimport type { Agencies } from '@gusto/embedded-api-v-2025-11-15/models/components/childsupportdata'\nimport { PaymentPeriod } from '@gusto/embedded-api-v-2025-11-15/models/components/garnishmentchildsupport'\nimport { useGarnishmentsCreateMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/garnishmentsCreate'\nimport { useGarnishmentsUpdateMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/garnishmentsUpdate'\nimport { useGarnishmentsList } from '@gusto/embedded-api-v-2025-11-15/react-query/garnishmentsList'\nimport { useGarnishmentsGetChildSupportData } from '@gusto/embedded-api-v-2025-11-15/react-query/garnishmentsGetChildSupportData'\nimport {\n createChildSupportGarnishmentFormSchema,\n getRequiredAttrKeys,\n type ChildSupportGarnishmentFormData,\n type ChildSupportGarnishmentFormOutputs,\n type SupportedRequiredAttrKey,\n} from './childSupportGarnishmentFormSchema'\nimport {\n StateField,\n FipsCodeField,\n CaseNumberField,\n OrderNumberField,\n RemittanceNumberField,\n PayPeriodMaximumField,\n AmountField,\n PaymentPeriodField,\n type CountyEntry,\n type StateFieldEntry,\n} from './fields'\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'\n\nconst PAYMENT_PERIOD_OPTIONS = [\n { value: PaymentPeriod.EveryWeek, label: PaymentPeriod.EveryWeek },\n { value: PaymentPeriod.EveryOtherWeek, label: PaymentPeriod.EveryOtherWeek },\n { value: PaymentPeriod.TwicePerMonth, label: PaymentPeriod.TwicePerMonth },\n { value: PaymentPeriod.Monthly, label: PaymentPeriod.Monthly },\n] as const\n\nconst PAYMENT_PERIOD_ENTRIES = [\n PaymentPeriod.EveryWeek,\n PaymentPeriod.EveryOtherWeek,\n PaymentPeriod.TwicePerMonth,\n PaymentPeriod.Monthly,\n] as const\n\n/*\n Configuration options for {@link useChildSupportGarnishmentForm}.\n \n @remarks\n * Presence or absence of `garnishmentId` selects the API verb — see the\n * `garnishmentId` field description.\n \n @public\n /\nexport interface UseChildSupportGarnishmentFormProps {\n /* UUID of the employee whose child-support garnishment is being created or edited. /\n employeeId: string\n /\n When set, loads that garnishment and updates it (PUT). When omitted, the\n * form is in create mode (POST).\n /\n garnishmentId?: string\n /* Pre-fill form values. Server data takes precedence on update. /\n defaultValues?: Partial<ChildSupportGarnishmentFormData>\n /* Passed through to react-hook-form. Defaults to `'onSubmit'`. /\n validationMode?: UseFormProps['mode']\n /* Auto-focus the first invalid field on submit. Set to `false` when using `composeSubmitHandler` so submit-time focus is coordinated across multiple forms. Defaults to `true`. /\n shouldFocusError?: boolean\n}\n\n/\n Pre-bound field components exposed on `useChildSupportGarnishmentForm().form.Fields`.\n \n @remarks\n * Each property is either the field component or `undefined`. A field is\n * `undefined` when conditions for rendering it aren't met — see each member\n * for its visibility rule. Always null-check conditional fields (e.g.\n * `{Fields.FipsCode && <Fields.FipsCode ... />}`) before rendering.\n \n @public\n /\nexport interface ChildSupportGarnishmentFormFields {\n /* Agency (state) select. Always available. /\n State: typeof StateField\n /* Only available when the selected agency has more than one fips code, or the\n * sole code is county-scoped (not an \"all counties\" auto-pick). /\n FipsCode: typeof FipsCodeField \| undefined\n /* Only available when the selected agency requires `case_number`. /\n CaseNumber: typeof CaseNumberField \| undefined\n /* Only available when the selected agency requires `order_number`. /\n OrderNumber: typeof OrderNumberField \| undefined\n /* Only available when the selected agency requires `remittance_number`. /\n RemittanceNumber: typeof RemittanceNumberField \| undefined\n /* Per-pay-period currency cap input. Always available. /\n PayPeriodMaximum: typeof PayPeriodMaximumField\n /* Percent-of-paycheck input (0–100). Always available. /\n Amount: typeof AmountField\n /* Payment period select. Always available. /\n PaymentPeriod: typeof PaymentPeriodField\n}\n\n/\n Ready-state shape returned by {@link useChildSupportGarnishmentForm} once data has loaded.\n \n @remarks\n * Discriminated by `isLoading: false`. Extends {@link BaseFormHookReady} with\n * the child-support-specific `data`, `status`, `actions`, and `form.Fields`\n * shape. Static, entity-derived values live under `data.`; reactive values\n that flip with form input live under `status.`.\n \n * @public\n /\nexport interface UseChildSupportGarnishmentFormReady extends BaseFormHookReady<\n FieldsMetadata,\n ChildSupportGarnishmentFormData,\n ChildSupportGarnishmentFormFields\n> {\n /* Child-support-specific data payload: the available agencies, counties for the selected state, and the loaded garnishment for update mode. /\n data: {\n /* Agencies offered as `State` options; raw entries the consumer can use\n * with `getOptionLabel` for translated names. /\n agencies: StateFieldEntry[]\n /* Counties for the currently selected state. Empty array when no state\n * is selected. /\n counties: CountyEntry[]\n /* The garnishment loaded for update; `null` in create mode. /\n deduction: Garnishment \| null\n }\n /* Submission state and reactive flags derived from current form input. /\n status: {\n /* `true` while a create or update mutation is in flight. /\n isPending: boolean\n /* Reflects whether the next submit will POST a new garnishment or PUT an existing one. /\n mode: 'create' \| 'update'\n /* The agency record matching the currently selected `state`. /\n selectedAgency: Agencies \| null\n /* Mirrors `selectedAgency.manualPaymentRequired`; convenient for showing\n * a warning alert. /\n isManualPaymentRequired: boolean\n /* Which `required_attributes` keys the selected agency declares. /\n requiredAttrKeys: ReadonlySet<SupportedRequiredAttrKey>\n }\n /* Submission action. /\n actions: {\n /* Submits the form. Returns the saved garnishment + mode on success, or `undefined` when validation fails or the request errored. /\n onSubmit: () => Promise<HookSubmitResult<Garnishment> \| undefined>\n }\n}\n\n/\n Return value of {@link useChildSupportGarnishmentForm}.\n \n @remarks\n * Discriminated union: {@link HookLoadingResult} while the agency catalog (and,\n * in update mode, the existing garnishment) is loading;\n * {@link UseChildSupportGarnishmentFormReady} once data is ready.\n \n @public\n /\nexport type UseChildSupportGarnishmentFormResult =\n HookLoadingResult \| UseChildSupportGarnishmentFormReady\n\n/\n Headless hook for creating or updating a child-support garnishment.\n \n @remarks\n * Unlike standard garnishments, child support requires agency-specific\n * attributes (case number, order number, remittance number) that vary by\n * state, plus an optional county selection when the state has multiple\n * counties. The hook loads the agency catalog from the Gusto API, derives\n * which attributes the selected state requires, and exposes the right Fields\n * conditionally.\n \n Presence or absence of `garnishmentId` selects the API verb: omit it to\n * POST a new garnishment, supply it to PUT updates against the existing row.\n * For non-child-support deductions (court-ordered garnishments and post-tax\n * custom), use {@link useDeductionForm} instead.\n \n @param input - See {@link UseChildSupportGarnishmentFormProps}.\n * @returns A {@link HookLoadingResult} while loading, or a {@link UseChildSupportGarnishmentFormReady} once ready.\n * @public\n \n @example\n * ```tsx\n * import { useChildSupportGarnishmentForm, SDKFormProvider } from '@gusto/embedded-react-sdk'\n \n function ChildSupportPage({ employeeId, garnishmentId }: { employeeId: string; garnishmentId?: string }) {\n * const form = useChildSupportGarnishmentForm({ employeeId, garnishmentId })\n \n if (form.isLoading) return <p>Loading…</p>\n \n const { Fields } = form.form\n \n return (\n * <SDKFormProvider formHookResult={form}>\n * <form\n * onSubmit={e => {\n * e.preventDefault()\n * void form.actions.onSubmit()\n * }}\n * >\n * <Fields.State\n * label=\"Agency\"\n * getOptionLabel={entry => entry.name}\n * validationMessages={{ REQUIRED: 'Required' }}\n * />\n * {Fields.CaseNumber && (\n * <Fields.CaseNumber label=\"Case number\" validationMessages={{ REQUIRED: 'Required' }} />\n * )}\n * <Fields.Amount\n * label=\"Percentage of paycheck\"\n * validationMessages={{\n * REQUIRED: 'Required',\n * PERCENT_OUT_OF_RANGE: 'Must be between 0 and 100',\n * }}\n * />\n * <button type=\"submit\">Save</button>\n * </form>\n * </SDKFormProvider>\n * )\n * }\n * ```\n /\nexport function useChildSupportGarnishmentForm({\n employeeId,\n garnishmentId,\n defaultValues: partnerDefaults,\n validationMode = 'onSubmit',\n shouldFocusError = true,\n}: UseChildSupportGarnishmentFormProps): UseChildSupportGarnishmentFormResult {\n const isCreateMode = !garnishmentId\n const schemaMode = isCreateMode ? 'create' : 'update'\n\n // Agencies + their required-attributes / fips codes come from a single GET.\n const agencyDataQuery = useGarnishmentsGetChildSupportData({})\n const agencyList = useMemo(\n () => agencyDataQuery.data?.childSupportData?.agencies ?? [],\n [agencyDataQuery.data],\n )\n\n // Update mode reads the row from the list endpoint (the garnishments API\n // has no single-row GET).\n const garnishmentsListQuery = useGarnishmentsList({ employeeId }, { enabled: !isCreateMode })\n const fetchedDeduction = useMemo(() => {\n if (isCreateMode) return null\n return garnishmentsListQuery.data?.garnishments?.find(g => g.uuid === garnishmentId) ?? null\n }, [isCreateMode, garnishmentId, garnishmentsListQuery.data])\n\n const resolvedDefaults: ChildSupportGarnishmentFormData = useMemo(\n () => ({\n state: fetchedDeduction?.childSupport?.state ?? partnerDefaults?.state ?? '',\n fipsCode: fetchedDeduction?.childSupport?.fipsCode ?? partnerDefaults?.fipsCode ?? '',\n caseNumber: fetchedDeduction?.childSupport?.caseNumber ?? partnerDefaults?.caseNumber ?? '',\n orderNumber:\n fetchedDeduction?.childSupport?.orderNumber ?? partnerDefaults?.orderNumber ?? '',\n remittanceNumber:\n fetchedDeduction?.childSupport?.remittanceNumber ?? partnerDefaults?.remittanceNumber ?? '',\n amount: fetchedDeduction?.amount\n ? Number(fetchedDeduction.amount)\n : (partnerDefaults?.amount ?? 0),\n payPeriodMaximum: fetchedDeduction?.payPeriodMaximum\n ? Number(fetchedDeduction.payPeriodMaximum)\n : (partnerDefaults?.payPeriodMaximum ?? 0),\n paymentPeriod:\n (fetchedDeduction?.childSupport?.paymentPeriod as PaymentPeriod \| undefined) ??\n partnerDefaults?.paymentPeriod ??\n PaymentPeriod.Monthly,\n }),\n [fetchedDeduction, partnerDefaults],\n )\n\n // Pass the full agency list so requiredness for the agency-attribute fields\n // (`caseNumber`, `orderNumber`, `remittanceNumber`) is derived dynamically\n // from the form's `state` value. The schema doesn't need to rebuild when the\n // user changes states — the predicate runs at validation time and via\n // `useDeriveFieldsMetadata` for the (optional) label.\n const [schema, metadataConfig] = useMemo(\n () => createChildSupportGarnishmentFormSchema({ mode: schemaMode, agencyList }),\n [schemaMode, agencyList],\n )\n\n const formMethods = useForm<\n ChildSupportGarnishmentFormData,\n unknown,\n ChildSupportGarnishmentFormOutputs\n >({\n resolver: zodResolver(schema),\n mode: validationMode,\n shouldFocusError,\n defaultValues: resolvedDefaults,\n values: resolvedDefaults,\n resetOptions: { keepDirtyValues: true },\n })\n\n const liveWatchedState = useWatch({ control: formMethods.control, name: 'state' })\n const liveSelectedAgency = useMemo(\n () => agencyList.find(a => a.state === liveWatchedState) ?? null,\n [agencyList, liveWatchedState],\n )\n\n // The agency-attribute fields stay in sync with the chosen state: when the\n // user switches states, the previous attribute values would otherwise carry\n // over and potentially submit alongside the wrong agency. The ref tracks\n // the previous value so the wipe only fires on user-driven transitions —\n // NOT on the initial sync when an existing garnishment loads (state moves\n // from '' to e.g. 'AK' as a side effect of `values` updating, which would\n // otherwise clobber the loaded case/order/remittance values).\n const previousWatchedStateRef = useRef<string \| null>(null)\n useEffect(() => {\n const previous = previousWatchedStateRef.current\n previousWatchedStateRef.current = liveWatchedState\n // First render (no previous value) → skip the wipe.\n if (previous === null) return\n // Server-side load: previous was '' (initial defaults before the row\n // arrived), now it's the loaded state. That's a sync, not a user toggle.\n if (previous === '') return\n if (previous === liveWatchedState) return\n formMethods.setValue('caseNumber', '')\n formMethods.setValue('orderNumber', '')\n formMethods.setValue('remittanceNumber', '')\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [liveWatchedState])\n\n // When the selected agency has a single \"all counties\" fips code, auto-fill\n // the field so the consumer doesn't have to render the county select.\n const fipsCodes = liveSelectedAgency?.fipsCodes ?? []\n const singleAllCountiesFipsCode =\n fipsCodes.length === 1 && !fipsCodes[0]?.county?.length ? (fipsCodes[0]?.code ?? null) : null\n useEffect(() => {\n if (singleAllCountiesFipsCode) {\n formMethods.setValue('fipsCode', singleAllCountiesFipsCode)\n }\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [singleAllCountiesFipsCode])\n\n const createGarnishmentMutation = useGarnishmentsCreateMutation()\n const updateGarnishmentMutation = useGarnishmentsUpdateMutation()\n const isPending = createGarnishmentMutation.isPending \|\| updateGarnishmentMutation.isPending\n\n const {\n baseSubmitHandler,\n error: submitError,\n setError: setSubmitError,\n } = useBaseSubmit('ChildSupportGarnishmentForm')\n\n const errorHandling = composeErrorHandler(\n isCreateMode ? [agencyDataQuery] : [agencyDataQuery, garnishmentsListQuery],\n { submitError, setSubmitError },\n )\n\n // ── Derived data exposed on the ready branch ─────────────────────────\n\n const agencies: StateFieldEntry[] = useMemo(\n () =>\n agencyList.map(a => ({\n state: a.state ?? '',\n name: a.name ?? a.state ?? '',\n manualPaymentRequired: a.manualPaymentRequired ?? false,\n })),\n [agencyList],\n )\n\n const counties: CountyEntry[] = useMemo(\n () =>\n (liveSelectedAgency?.fipsCodes ?? [])\n .filter(f => typeof f.code === 'string')\n .map(f => ({ fipsCode: f.code as string, county: f.county ?? null })),\n [liveSelectedAgency],\n )\n\n const requiredAttrKeys = useMemo(\n () => getRequiredAttrKeys(liveSelectedAgency),\n [liveSelectedAgency],\n )\n\n const hasSelectableCounties =\n counties.length > 1 \|\| (counties.length === 1 && singleAllCountiesFipsCode == null)\n\n // ── Metadata + field-options wiring ─────────────────────────────────\n\n const baseMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n const stateOptions = agencies.map(a => ({ value: a.state, label: a.name }))\n const countyOptions = counties.map(c => ({\n value: c.fipsCode,\n label: c.county ?? c.fipsCode,\n }))\n\n const fieldsMetadata = {\n state: withOptions(baseMetadata.state, stateOptions, agencies),\n fipsCode: withOptions(baseMetadata.fipsCode, countyOptions, counties),\n caseNumber: baseMetadata.caseNumber,\n orderNumber: baseMetadata.orderNumber,\n remittanceNumber: baseMetadata.remittanceNumber,\n payPeriodMaximum: baseMetadata.payPeriodMaximum,\n amount: baseMetadata.amount,\n paymentPeriod: withOptions(\n baseMetadata.paymentPeriod,\n [...PAYMENT_PERIOD_OPTIONS],\n [...PAYMENT_PERIOD_ENTRIES],\n ),\n }\n\n // ── Submit ───────────────────────────────────────────────────────────\n\n const onSubmit = async (): Promise<HookSubmitResult<Garnishment> \| undefined> => {\n let submitResult: HookSubmitResult<Garnishment> \| undefined\n\n await new Promise<void>(resolve => {\n void formMethods.handleSubmit(\n async (data: ChildSupportGarnishmentFormOutputs) => {\n await baseSubmitHandler(data, async payload => {\n const childSupport = {\n state: payload.state,\n paymentPeriod: payload.paymentPeriod,\n fipsCode: payload.fipsCode,\n // Empty strings collapse to null so the API persists \"no value\n // declared\" rather than an empty case number.\n caseNumber: payload.caseNumber \|\| null,\n orderNumber: payload.orderNumber \|\| null,\n remittanceNumber: payload.remittanceNumber \|\| null,\n }\n\n const description = `Child Support - ${childSupport.caseNumber ?? ''}`\n const amountStr = String(payload.amount)\n const payPeriodMaximumStr =\n payload.payPeriodMaximum > 0 ? String(payload.payPeriodMaximum) : null\n\n const requestBody = {\n active: true,\n amount: amountStr,\n description,\n courtOrdered: true,\n garnishmentType: 'child_support' as GarnishmentType,\n times: null,\n deductAsPercentage: true,\n payPeriodMaximum: payPeriodMaximumStr,\n recurring: true,\n childSupport,\n }\n\n let updated: Garnishment \| undefined\n\n if (isCreateMode) {\n const result = await createGarnishmentMutation.mutateAsync({\n request: { employeeId, garnishmentRequest: requestBody },\n })\n updated = result.garnishment\n } else {\n if (!fetchedDeduction) {\n throw new SDKInternalError(\n 'Cannot update child-support deduction: no matching garnishment on file',\n )\n }\n const result = await updateGarnishmentMutation.mutateAsync({\n request: {\n garnishmentId: fetchedDeduction.uuid,\n updateGarnishmentRequest: {\n ...requestBody,\n version: fetchedDeduction.version as string,\n },\n },\n })\n updated = result.garnishment\n }\n\n if (!updated) {\n throw new SDKInternalError(\n isCreateMode\n ? 'Child-support deduction creation failed'\n : 'Child-support deduction update failed',\n )\n }\n\n submitResult = {\n mode: isCreateMode ? 'create' : 'update',\n data: updated,\n }\n })\n resolve()\n },\n () => {\n resolve()\n },\n )()\n })\n\n return submitResult\n }\n\n const hookFormInternals = useHookFormInternals(formMethods)\n\n if (agencyDataQuery.isLoading) {\n return { isLoading: true as const, errorHandling }\n }\n if (!isCreateMode && garnishmentsListQuery.isLoading) {\n return { isLoading: true as const, errorHandling }\n }\n\n return {\n isLoading: false as const,\n data: {\n agencies,\n counties,\n deduction: fetchedDeduction,\n },\n status: {\n isPending,\n mode: isCreateMode ? 'create' : 'update',\n selectedAgency: liveSelectedAgency,\n isManualPaymentRequired: liveSelectedAgency?.manualPaymentRequired ?? false,\n requiredAttrKeys,\n },\n actions: { onSubmit },\n errorHandling,\n form: {\n Fields: {\n State: StateField,\n FipsCode: hasSelectableCounties ? FipsCodeField : undefined,\n CaseNumber: requiredAttrKeys.has('case_number') ? CaseNumberField : undefined,\n OrderNumber: requiredAttrKeys.has('order_number') ? OrderNumberField : undefined,\n RemittanceNumber: requiredAttrKeys.has('remittance_number')\n ? RemittanceNumberField\n : undefined,\n PayPeriodMaximum: PayPeriodMaximumField,\n Amount: AmountField,\n PaymentPeriod: PaymentPeriodField,\n },\n fieldsMetadata,\n hookFormInternals,\n getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n },\n }\n}\n\n/\n Per-field metadata returned by {@link useChildSupportGarnishmentForm} as `form.fieldsMetadata`.\n \n @remarks\n * Carries per-field `isRequired`, `isDisabled`, label, description, and option\n * entries derived from the schema and form state. Use these to drive UI such\n * as disabled state or option lists when not relying on the pre-bound\n * {@link ChildSupportGarnishmentFormFields} components.\n \n @public\n */\nexport type ChildSupportGarnishmentFormFieldsMetadata =\n UseChildSupportGarnishmentFormReady['form']['fieldsMetadata']\n"],"names":["PAYMENT_PERIOD_OPTIONS","PaymentPeriod","PAYMENT_PERIOD_ENTRIES","useChildSupportGarnishmentForm","employeeId","garnishmentId","partnerDefaults","validationMode","shouldFocusError","isCreateMode","schemaMode","agencyDataQuery","useGarnishmentsGetChildSupportData","agencyList","useMemo","garnishmentsListQuery","useGarnishmentsList","fetchedDeduction","g","resolvedDefaults","schema","metadataConfig","createChildSupportGarnishmentFormSchema","formMethods","useForm","zodResolver","liveWatchedState","useWatch","liveSelectedAgency","a","previousWatchedStateRef","useRef","useEffect","previous","fipsCodes","singleAllCountiesFipsCode","createGarnishmentMutation","useGarnishmentsCreateMutation","updateGarnishmentMutation","useGarnishmentsUpdateMutation","isPending","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","agencies","counties","f","requiredAttrKeys","getRequiredAttrKeys","hasSelectableCounties","baseMetadata","useDeriveFieldsMetadata","stateOptions","countyOptions","c","fieldsMetadata","withOptions","onSubmit","submitResult","resolve","data","payload","childSupport","description","amountStr","payPeriodMaximumStr","requestBody","updated","SDKInternalError","hookFormInternals","useHookFormInternals","StateField","FipsCodeField","CaseNumberField","OrderNumberField","RemittanceNumberField","PayPeriodMaximumField","AmountField","PaymentPeriodField","createGetFormSubmissionValues"],"mappings":"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"}
1	+ {"version":3,"file":"useChildSupportGarnishmentForm.js","sources":["../../../../../../src/components/Employee/Deductions/shared/useChildSupportGarnishmentForm/useChildSupportGarnishmentForm.tsx"],"sourcesContent":["import type { ComponentType } from 'react'\nimport { useEffect, useMemo, useRef } from 'react'\nimport { useForm, useWatch } from 'react-hook-form'\nimport type { UseFormProps } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport {\n type Garnishment,\n type GarnishmentType,\n} from '@gusto/embedded-api/models/components/garnishment'\nimport type { Agencies } from '@gusto/embedded-api/models/components/childsupportdata'\nimport { PaymentPeriod } from '@gusto/embedded-api/models/components/garnishmentchildsupport'\nimport { useGarnishmentsCreateMutation } from '@gusto/embedded-api/react-query/garnishmentsCreate'\nimport { useGarnishmentsUpdateMutation } from '@gusto/embedded-api/react-query/garnishmentsUpdate'\nimport { useGarnishmentsList } from '@gusto/embedded-api/react-query/garnishmentsList'\nimport { useGarnishmentsGetChildSupportData } from '@gusto/embedded-api/react-query/garnishmentsGetChildSupportData'\nimport {\n createChildSupportGarnishmentFormSchema,\n getRequiredAttrKeys,\n type ChildSupportGarnishmentFormData,\n type ChildSupportGarnishmentFormOutputs,\n type SupportedRequiredAttrKey,\n} from './childSupportGarnishmentFormSchema'\nimport {\n StateField,\n FipsCodeField,\n CaseNumberField,\n OrderNumberField,\n RemittanceNumberField,\n PayPeriodMaximumField,\n AmountField,\n PaymentPeriodField,\n type CountyEntry,\n type StateFieldEntry,\n type StateFieldProps,\n type FipsCodeFieldProps,\n type CaseNumberFieldProps,\n type OrderNumberFieldProps,\n type RemittanceNumberFieldProps,\n type PayPeriodMaximumFieldProps,\n type AmountFieldProps,\n type PaymentPeriodFieldProps,\n} from './fields'\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 FieldMetadata,\n FieldsMetadata,\n HookLoadingResult,\n HookSubmitResult,\n} from '@/partner-hook-utils/types'\nimport { useBaseSubmit } from '@/components/Base/useBaseSubmit'\nimport { SDKInternalError } from '@/types/sdkError'\n\nconst PAYMENT_PERIOD_OPTIONS = [\n { value: PaymentPeriod.EveryWeek, label: PaymentPeriod.EveryWeek },\n { value: PaymentPeriod.EveryOtherWeek, label: PaymentPeriod.EveryOtherWeek },\n { value: PaymentPeriod.TwicePerMonth, label: PaymentPeriod.TwicePerMonth },\n { value: PaymentPeriod.Monthly, label: PaymentPeriod.Monthly },\n] as const\n\nconst PAYMENT_PERIOD_ENTRIES = [\n PaymentPeriod.EveryWeek,\n PaymentPeriod.EveryOtherWeek,\n PaymentPeriod.TwicePerMonth,\n PaymentPeriod.Monthly,\n] as const\n\n/*\n Configuration options for {@link useChildSupportGarnishmentForm}.\n \n @remarks\n * Presence or absence of `garnishmentId` selects the API verb — see the\n * `garnishmentId` field description.\n \n @public\n /\nexport interface UseChildSupportGarnishmentFormProps {\n /* UUID of the employee whose child-support garnishment is being created or edited. /\n employeeId: string\n /\n When set, loads that garnishment and updates it (PUT). When omitted, the\n * form is in create mode (POST).\n /\n garnishmentId?: string\n /* Pre-fill form values. Server data takes precedence on update. /\n defaultValues?: Partial<ChildSupportGarnishmentFormData>\n /* Passed through to react-hook-form. Defaults to `'onSubmit'`. /\n validationMode?: UseFormProps['mode']\n /* Auto-focus the first invalid field on submit. Set to `false` when using `composeSubmitHandler` so submit-time focus is coordinated across multiple forms. Defaults to `true`. /\n shouldFocusError?: boolean\n}\n\n/\n Pre-bound field components exposed on `useChildSupportGarnishmentForm().form.Fields`.\n \n @remarks\n * Each property is either the field component or `undefined`. A field is\n * `undefined` when conditions for rendering it aren't met — see each member\n * for its visibility rule. Always null-check conditional fields (e.g.\n * `{Fields.FipsCode && <Fields.FipsCode ... />}`) before rendering.\n \n @public\n /\nexport interface ChildSupportGarnishmentFormFields {\n /* Bound to `state`. Agency (state) select. Always available. /\n State: ComponentType<StateFieldProps>\n /* Bound to `fipsCode`. Only available when the selected agency has more than\n * one fips code, or the sole code is county-scoped (not an \"all counties\"\n * auto-pick). /\n FipsCode: ComponentType<FipsCodeFieldProps> \| undefined\n /* Bound to `caseNumber`. Only available when the selected agency requires `case_number`. /\n CaseNumber: ComponentType<CaseNumberFieldProps> \| undefined\n /* Bound to `orderNumber`. Only available when the selected agency requires `order_number`. /\n OrderNumber: ComponentType<OrderNumberFieldProps> \| undefined\n /* Bound to `remittanceNumber`. Only available when the selected agency requires `remittance_number`. /\n RemittanceNumber: ComponentType<RemittanceNumberFieldProps> \| undefined\n /* Bound to `payPeriodMaximum`. Per-pay-period currency cap input. Always available. /\n PayPeriodMaximum: ComponentType<PayPeriodMaximumFieldProps>\n /* Bound to `amount`. Percent-of-paycheck input (0–100). Always available. /\n Amount: ComponentType<AmountFieldProps>\n /* Bound to `paymentPeriod`. Payment period select. Always available. /\n PaymentPeriod: ComponentType<PaymentPeriodFieldProps>\n}\n\n/\n Ready-state shape returned by {@link useChildSupportGarnishmentForm} once data has loaded.\n \n @remarks\n * Discriminated by `isLoading: false`. Extends {@link BaseFormHookReady} with\n * the child-support-specific `data`, `status`, `actions`, and `form.Fields`\n * shape. Static, entity-derived values live under `data.`; reactive values\n that flip with form input live under `status.`.\n \n * @public\n /\nexport interface UseChildSupportGarnishmentFormReady extends BaseFormHookReady<\n ChildSupportGarnishmentFormFieldsMetadata,\n ChildSupportGarnishmentFormData,\n ChildSupportGarnishmentFormFields\n> {\n /* Child-support-specific data payload: the available agencies, counties for the selected state, and the loaded garnishment for update mode. /\n data: {\n /* Agencies offered as `State` options; raw entries the consumer can use\n * with `getOptionLabel` for translated names. /\n agencies: StateFieldEntry[]\n /* Counties for the currently selected state. Empty array when no state\n * is selected. /\n counties: CountyEntry[]\n /* The garnishment loaded for update; `null` in create mode. /\n deduction: Garnishment \| null\n }\n /* Submission state and reactive flags derived from current form input. /\n status: {\n /* `true` while a create or update mutation is in flight. /\n isPending: boolean\n /* Reflects whether the next submit will POST a new garnishment or PUT an existing one. /\n mode: 'create' \| 'update'\n /* The agency record matching the currently selected `state`. /\n selectedAgency: Agencies \| null\n /* Mirrors `selectedAgency.manualPaymentRequired`; convenient for showing\n * a warning alert. /\n isManualPaymentRequired: boolean\n /* Which `required_attributes` keys the selected agency declares. /\n requiredAttrKeys: ReadonlySet<SupportedRequiredAttrKey>\n }\n /* Submission action. /\n actions: {\n /* Submits the form. Returns the saved garnishment + mode on success, or `undefined` when validation fails or the request errored. /\n onSubmit: () => Promise<HookSubmitResult<Garnishment> \| undefined>\n }\n}\n\n/\n Return value of {@link useChildSupportGarnishmentForm}.\n \n @remarks\n * Discriminated union: {@link HookLoadingResult} while the agency catalog (and,\n * in update mode, the existing garnishment) is loading;\n * {@link UseChildSupportGarnishmentFormReady} once data is ready.\n \n @public\n /\nexport type UseChildSupportGarnishmentFormResult =\n HookLoadingResult \| UseChildSupportGarnishmentFormReady\n\n/* @internal /\nfunction buildChildSupportGarnishmentFieldsMetadata(\n base: Record<keyof ChildSupportGarnishmentFormData, FieldMetadata>,\n {\n stateOptions,\n agencies,\n countyOptions,\n counties,\n }: {\n stateOptions: Array<{ value: string; label: string }>\n agencies: StateFieldEntry[]\n countyOptions: Array<{ value: string; label: string }>\n counties: CountyEntry[]\n },\n) {\n return {\n state: withOptions(base.state, stateOptions, agencies),\n fipsCode: withOptions(base.fipsCode, countyOptions, counties),\n caseNumber: base.caseNumber,\n orderNumber: base.orderNumber,\n remittanceNumber: base.remittanceNumber,\n payPeriodMaximum: base.payPeriodMaximum,\n amount: base.amount,\n paymentPeriod: withOptions(\n base.paymentPeriod,\n [...PAYMENT_PERIOD_OPTIONS],\n [...PAYMENT_PERIOD_ENTRIES],\n ),\n } satisfies FieldsMetadata\n}\n\n/\n Headless hook for creating or updating a child-support garnishment.\n \n @remarks\n * Unlike standard garnishments, child support requires agency-specific\n * attributes (case number, order number, remittance number) that vary by\n * state, plus an optional county selection when the state has multiple\n * counties. The hook loads the agency catalog from the Gusto API, derives\n * which attributes the selected state requires, and exposes the right Fields\n * conditionally.\n \n Presence or absence of `garnishmentId` selects the API verb: omit it to\n * POST a new garnishment, supply it to PUT updates against the existing row.\n * For non-child-support deductions (court-ordered garnishments and post-tax\n * custom), use {@link useDeductionForm} instead.\n \n @param input - See {@link UseChildSupportGarnishmentFormProps}.\n * @returns A {@link HookLoadingResult} while loading, or a {@link UseChildSupportGarnishmentFormReady} once ready.\n * @public\n \n @example\n * ```tsx\n * import { useChildSupportGarnishmentForm, SDKFormProvider } from '@gusto/embedded-react-sdk'\n \n function ChildSupportPage({ employeeId, garnishmentId }: { employeeId: string; garnishmentId?: string }) {\n * const form = useChildSupportGarnishmentForm({ employeeId, garnishmentId })\n \n if (form.isLoading) return <p>Loading…</p>\n \n const { Fields } = form.form\n \n return (\n * <SDKFormProvider formHookResult={form}>\n * <form\n * onSubmit={e => {\n * e.preventDefault()\n * void form.actions.onSubmit()\n * }}\n * >\n * <Fields.State\n * label=\"Agency\"\n * getOptionLabel={entry => entry.name}\n * validationMessages={{ REQUIRED: 'Required' }}\n * />\n * {Fields.CaseNumber && (\n * <Fields.CaseNumber label=\"Case number\" validationMessages={{ REQUIRED: 'Required' }} />\n * )}\n * <Fields.Amount\n * label=\"Percentage of paycheck\"\n * validationMessages={{\n * REQUIRED: 'Required',\n * PERCENT_OUT_OF_RANGE: 'Must be between 0 and 100',\n * }}\n * />\n * <button type=\"submit\">Save</button>\n * </form>\n * </SDKFormProvider>\n * )\n * }\n * ```\n /\nexport function useChildSupportGarnishmentForm({\n employeeId,\n garnishmentId,\n defaultValues: partnerDefaults,\n validationMode = 'onSubmit',\n shouldFocusError = true,\n}: UseChildSupportGarnishmentFormProps): UseChildSupportGarnishmentFormResult {\n const isCreateMode = !garnishmentId\n const schemaMode = isCreateMode ? 'create' : 'update'\n\n // Agencies + their required-attributes / fips codes come from a single GET.\n const agencyDataQuery = useGarnishmentsGetChildSupportData({})\n const agencyList = useMemo(\n () => agencyDataQuery.data?.childSupportData?.agencies ?? [],\n [agencyDataQuery.data],\n )\n\n // Update mode reads the row from the list endpoint (the garnishments API\n // has no single-row GET).\n const garnishmentsListQuery = useGarnishmentsList({ employeeId }, { enabled: !isCreateMode })\n const fetchedDeduction = useMemo(() => {\n if (isCreateMode) return null\n return garnishmentsListQuery.data?.garnishments?.find(g => g.uuid === garnishmentId) ?? null\n }, [isCreateMode, garnishmentId, garnishmentsListQuery.data])\n\n const resolvedDefaults: ChildSupportGarnishmentFormData = useMemo(\n () => ({\n state: fetchedDeduction?.childSupport?.state ?? partnerDefaults?.state ?? '',\n fipsCode: fetchedDeduction?.childSupport?.fipsCode ?? partnerDefaults?.fipsCode ?? '',\n caseNumber: fetchedDeduction?.childSupport?.caseNumber ?? partnerDefaults?.caseNumber ?? '',\n orderNumber:\n fetchedDeduction?.childSupport?.orderNumber ?? partnerDefaults?.orderNumber ?? '',\n remittanceNumber:\n fetchedDeduction?.childSupport?.remittanceNumber ?? partnerDefaults?.remittanceNumber ?? '',\n amount: fetchedDeduction?.amount\n ? Number(fetchedDeduction.amount)\n : (partnerDefaults?.amount ?? 0),\n payPeriodMaximum: fetchedDeduction?.payPeriodMaximum\n ? Number(fetchedDeduction.payPeriodMaximum)\n : (partnerDefaults?.payPeriodMaximum ?? 0),\n paymentPeriod:\n (fetchedDeduction?.childSupport?.paymentPeriod as PaymentPeriod \| undefined) ??\n partnerDefaults?.paymentPeriod ??\n PaymentPeriod.Monthly,\n }),\n [fetchedDeduction, partnerDefaults],\n )\n\n // Pass the full agency list so requiredness for the agency-attribute fields\n // (`caseNumber`, `orderNumber`, `remittanceNumber`) is derived dynamically\n // from the form's `state` value. The schema doesn't need to rebuild when the\n // user changes states — the predicate runs at validation time and via\n // `useDeriveFieldsMetadata` for the (optional) label.\n const [schema, metadataConfig] = useMemo(\n () => createChildSupportGarnishmentFormSchema({ mode: schemaMode, agencyList }),\n [schemaMode, agencyList],\n )\n\n const formMethods = useForm<\n ChildSupportGarnishmentFormData,\n unknown,\n ChildSupportGarnishmentFormOutputs\n >({\n resolver: zodResolver(schema),\n mode: validationMode,\n shouldFocusError,\n defaultValues: resolvedDefaults,\n values: resolvedDefaults,\n resetOptions: { keepDirtyValues: true },\n })\n\n const liveWatchedState = useWatch({ control: formMethods.control, name: 'state' })\n const liveSelectedAgency = useMemo(\n () => agencyList.find(a => a.state === liveWatchedState) ?? null,\n [agencyList, liveWatchedState],\n )\n\n // The agency-attribute fields stay in sync with the chosen state: when the\n // user switches states, the previous attribute values would otherwise carry\n // over and potentially submit alongside the wrong agency. The ref tracks\n // the previous value so the wipe only fires on user-driven transitions —\n // NOT on the initial sync when an existing garnishment loads (state moves\n // from '' to e.g. 'AK' as a side effect of `values` updating, which would\n // otherwise clobber the loaded case/order/remittance values).\n const previousWatchedStateRef = useRef<string \| null>(null)\n useEffect(() => {\n const previous = previousWatchedStateRef.current\n previousWatchedStateRef.current = liveWatchedState\n // First render (no previous value) → skip the wipe.\n if (previous === null) return\n // Server-side load: previous was '' (initial defaults before the row\n // arrived), now it's the loaded state. That's a sync, not a user toggle.\n if (previous === '') return\n if (previous === liveWatchedState) return\n formMethods.setValue('caseNumber', '')\n formMethods.setValue('orderNumber', '')\n formMethods.setValue('remittanceNumber', '')\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [liveWatchedState])\n\n // When the selected agency has a single \"all counties\" fips code, auto-fill\n // the field so the consumer doesn't have to render the county select.\n const fipsCodes = liveSelectedAgency?.fipsCodes ?? []\n const singleAllCountiesFipsCode =\n fipsCodes.length === 1 && !fipsCodes[0]?.county?.length ? (fipsCodes[0]?.code ?? null) : null\n useEffect(() => {\n if (singleAllCountiesFipsCode) {\n formMethods.setValue('fipsCode', singleAllCountiesFipsCode)\n }\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [singleAllCountiesFipsCode])\n\n const createGarnishmentMutation = useGarnishmentsCreateMutation()\n const updateGarnishmentMutation = useGarnishmentsUpdateMutation()\n const isPending = createGarnishmentMutation.isPending \|\| updateGarnishmentMutation.isPending\n\n const {\n baseSubmitHandler,\n error: submitError,\n setError: setSubmitError,\n } = useBaseSubmit('ChildSupportGarnishmentForm')\n\n const errorHandling = composeErrorHandler(\n isCreateMode ? [agencyDataQuery] : [agencyDataQuery, garnishmentsListQuery],\n { submitError, setSubmitError },\n )\n\n // ── Derived data exposed on the ready branch ─────────────────────────\n\n const agencies: StateFieldEntry[] = useMemo(\n () =>\n agencyList.map(a => ({\n state: a.state ?? '',\n name: a.name ?? a.state ?? '',\n manualPaymentRequired: a.manualPaymentRequired ?? false,\n })),\n [agencyList],\n )\n\n const counties: CountyEntry[] = useMemo(\n () =>\n (liveSelectedAgency?.fipsCodes ?? [])\n .filter(f => typeof f.code === 'string')\n .map(f => ({ fipsCode: f.code as string, county: f.county ?? null })),\n [liveSelectedAgency],\n )\n\n const requiredAttrKeys = useMemo(\n () => getRequiredAttrKeys(liveSelectedAgency),\n [liveSelectedAgency],\n )\n\n const hasSelectableCounties =\n counties.length > 1 \|\| (counties.length === 1 && singleAllCountiesFipsCode == null)\n\n // ── Metadata + field-options wiring ─────────────────────────────────\n\n const baseMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n const stateOptions = agencies.map(a => ({ value: a.state, label: a.name }))\n const countyOptions = counties.map(c => ({\n value: c.fipsCode,\n label: c.county ?? c.fipsCode,\n }))\n\n const fieldsMetadata = buildChildSupportGarnishmentFieldsMetadata(baseMetadata, {\n stateOptions,\n agencies,\n countyOptions,\n counties,\n })\n\n // ── Submit ───────────────────────────────────────────────────────────\n\n const onSubmit = async (): Promise<HookSubmitResult<Garnishment> \| undefined> => {\n let submitResult: HookSubmitResult<Garnishment> \| undefined\n\n await new Promise<void>(resolve => {\n void formMethods.handleSubmit(\n async (data: ChildSupportGarnishmentFormOutputs) => {\n await baseSubmitHandler(data, async payload => {\n const childSupport = {\n state: payload.state,\n paymentPeriod: payload.paymentPeriod,\n fipsCode: payload.fipsCode,\n // Empty strings collapse to null so the API persists \"no value\n // declared\" rather than an empty case number.\n caseNumber: payload.caseNumber \|\| null,\n orderNumber: payload.orderNumber \|\| null,\n remittanceNumber: payload.remittanceNumber \|\| null,\n }\n\n const description = `Child Support - ${childSupport.caseNumber ?? ''}`\n const amountStr = String(payload.amount)\n const payPeriodMaximumStr =\n payload.payPeriodMaximum > 0 ? String(payload.payPeriodMaximum) : null\n\n const requestBody = {\n active: true,\n amount: amountStr,\n description,\n courtOrdered: true,\n garnishmentType: 'child_support' as GarnishmentType,\n times: null,\n deductAsPercentage: true,\n payPeriodMaximum: payPeriodMaximumStr,\n recurring: true,\n childSupport,\n }\n\n let updated: Garnishment \| undefined\n\n if (isCreateMode) {\n const result = await createGarnishmentMutation.mutateAsync({\n request: { employeeId, garnishmentRequest: requestBody },\n })\n updated = result.garnishment\n } else {\n if (!fetchedDeduction) {\n throw new SDKInternalError(\n 'Cannot update child-support deduction: no matching garnishment on file',\n )\n }\n const result = await updateGarnishmentMutation.mutateAsync({\n request: {\n garnishmentId: fetchedDeduction.uuid,\n updateGarnishmentRequest: {\n ...requestBody,\n version: fetchedDeduction.version as string,\n },\n },\n })\n updated = result.garnishment\n }\n\n if (!updated) {\n throw new SDKInternalError(\n isCreateMode\n ? 'Child-support deduction creation failed'\n : 'Child-support deduction update failed',\n )\n }\n\n submitResult = {\n mode: isCreateMode ? 'create' : 'update',\n data: updated,\n }\n })\n resolve()\n },\n () => {\n resolve()\n },\n )()\n })\n\n return submitResult\n }\n\n const hookFormInternals = useHookFormInternals(formMethods)\n\n if (agencyDataQuery.isLoading) {\n return { isLoading: true as const, errorHandling }\n }\n if (!isCreateMode && garnishmentsListQuery.isLoading) {\n return { isLoading: true as const, errorHandling }\n }\n\n return {\n isLoading: false as const,\n data: {\n agencies,\n counties,\n deduction: fetchedDeduction,\n },\n status: {\n isPending,\n mode: isCreateMode ? 'create' : 'update',\n selectedAgency: liveSelectedAgency,\n isManualPaymentRequired: liveSelectedAgency?.manualPaymentRequired ?? false,\n requiredAttrKeys,\n },\n actions: { onSubmit },\n errorHandling,\n form: {\n Fields: {\n State: StateField,\n FipsCode: hasSelectableCounties ? FipsCodeField : undefined,\n CaseNumber: requiredAttrKeys.has('case_number') ? CaseNumberField : undefined,\n OrderNumber: requiredAttrKeys.has('order_number') ? OrderNumberField : undefined,\n RemittanceNumber: requiredAttrKeys.has('remittance_number')\n ? RemittanceNumberField\n : undefined,\n PayPeriodMaximum: PayPeriodMaximumField,\n Amount: AmountField,\n PaymentPeriod: PaymentPeriodField,\n },\n fieldsMetadata,\n hookFormInternals,\n getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n },\n }\n}\n\n/\n Per-field metadata returned by {@link useChildSupportGarnishmentForm} as `form.fieldsMetadata`.\n \n @remarks\n * Carries per-field `isRequired`, `isDisabled`, label, description, and option\n * entries derived from the schema and form state. Use these to drive UI such\n * as disabled state or option lists when not relying on the pre-bound\n * {@link ChildSupportGarnishmentFormFields} components.\n \n @public\n */\nexport type ChildSupportGarnishmentFormFieldsMetadata = ReturnType<\n typeof buildChildSupportGarnishmentFieldsMetadata\n>\n"],"names":["PAYMENT_PERIOD_OPTIONS","PaymentPeriod","PAYMENT_PERIOD_ENTRIES","buildChildSupportGarnishmentFieldsMetadata","base","stateOptions","agencies","countyOptions","counties","withOptions","useChildSupportGarnishmentForm","employeeId","garnishmentId","partnerDefaults","validationMode","shouldFocusError","isCreateMode","schemaMode","agencyDataQuery","useGarnishmentsGetChildSupportData","agencyList","useMemo","garnishmentsListQuery","useGarnishmentsList","fetchedDeduction","g","resolvedDefaults","schema","metadataConfig","createChildSupportGarnishmentFormSchema","formMethods","useForm","zodResolver","liveWatchedState","useWatch","liveSelectedAgency","a","previousWatchedStateRef","useRef","useEffect","previous","fipsCodes","singleAllCountiesFipsCode","createGarnishmentMutation","useGarnishmentsCreateMutation","updateGarnishmentMutation","useGarnishmentsUpdateMutation","isPending","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","f","requiredAttrKeys","getRequiredAttrKeys","hasSelectableCounties","baseMetadata","useDeriveFieldsMetadata","c","fieldsMetadata","onSubmit","submitResult","resolve","data","payload","childSupport","description","amountStr","payPeriodMaximumStr","requestBody","updated","SDKInternalError","hookFormInternals","useHookFormInternals","StateField","FipsCodeField","CaseNumberField","OrderNumberField","RemittanceNumberField","PayPeriodMaximumField","AmountField","PaymentPeriodField","createGetFormSubmissionValues"],"mappings":"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"}

package/dist/components/Employee/Deductions/shared/useDeductionForm/deductionFormSchema.d.ts CHANGED Viewed

@@ -23,11 +23,7 @@ export type DeductionFormErrorCode = (typeof DeductionFormErrorCodes)[keyof type
  * @interface
  */
 export type DeductionFormData = { description: string; recurring: boolean; deductAsPercentage: boolean; amount: number; totalAmount: number; annualMaximum: number; garnishmentType: "child_support" | "federal_tax_lien" | "state_tax_lien" | "student_loan" | "creditor_garnishment" | "federal_loan" | "other_garnishment"; };
-/**
- * Shape of the validated values produced by the deduction form on submit.
- *
- * @public
- */
+/** @internal */
 export type DeductionFormOutputs = DeductionFormData;
 /**
  * Keys of optional deduction fields that can be promoted to required via the

package/dist/components/Employee/Deductions/shared/useDeductionForm/deductionFormSchema.js CHANGED Viewed

@@ -1,5 +1,5 @@
 import { z as e } from "zod";
-import { GarnishmentType as a } from "@gusto/embedded-api-v-2025-11-15/models/components/garnishment";
+import { GarnishmentType as a } from "@gusto/embedded-api/models/components/garnishment";
 import { buildFormSchema as c } from "../../../../../partner-hook-utils/form/buildFormSchema.js";
 import { coerceNaN as o, coerceStringBoolean as n } from "../../../../../partner-hook-utils/form/preprocessors.js";
 const r = {

package/dist/components/Employee/Deductions/shared/useDeductionForm/deductionFormSchema.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"deductionFormSchema.js","sources":["../../../../../../src/components/Employee/Deductions/shared/useDeductionForm/deductionFormSchema.ts"],"sourcesContent":["import { z } from 'zod'\nimport { GarnishmentType } from '@gusto/embedded-api~~-v-2025-11-15~~/models/components/garnishment'\nimport {\n buildFormSchema,\n type RequiredFieldConfig,\n type OptionalFieldsToRequire,\n} from '@/partner-hook-utils/form/buildFormSchema'\nimport { coerceNaN, coerceStringBoolean } from '@/partner-hook-utils/form/preprocessors'\n\n// ── Error codes ────────────────────────────────────────────────────────\n\n/*\n Validation error codes emitted by the deduction form schema. Map these\n * codes to localized copy in `validationMessages` when composing the hook.\n \n @public\n /\nexport const DeductionFormErrorCodes = {\n REQUIRED: 'REQUIRED',\n NEGATIVE_AMOUNT: 'NEGATIVE_AMOUNT',\n} as const\n\n/\n Union of validation error code strings emitted by the deduction form schema.\n \n @public\n /\nexport type DeductionFormErrorCode =\n (typeof DeductionFormErrorCodes)[keyof typeof DeductionFormErrorCodes]\n\n// ── Field validators ───────────────────────────────────────────────────\n\nconst fieldValidators = {\n description: z.string(),\n // Radio groups deliver `'true'`/`'false'` strings; coerce to boolean for the\n // submit payload. Matches the useJobForm pattern.\n recurring: z.preprocess(coerceStringBoolean, z.boolean()),\n deductAsPercentage: z.preprocess(coerceStringBoolean, z.boolean()),\n // Currency / percent input. NumberInputField writes `number \| undefined`;\n // coerce to a numeric so .min(0) runs reliably. The number-to-string\n // conversion the garnishment API expects happens inside the hook's onSubmit,\n // so the form value stays a number end-to-end (input === output).\n amount: z.preprocess(\n coerceNaN(0),\n z.number().min(0, { message: DeductionFormErrorCodes.NEGATIVE_AMOUNT }),\n ),\n // Optional caps. The hook drops them to `null` on the wire when 0 — matches\n // the legacy DeductionSchema's \"0 means no cap\" behavior.\n totalAmount: z.preprocess(\n coerceNaN(0),\n z.number().min(0, { message: DeductionFormErrorCodes.NEGATIVE_AMOUNT }),\n ),\n annualMaximum: z.preprocess(\n coerceNaN(0),\n z.number().min(0, { message: DeductionFormErrorCodes.NEGATIVE_AMOUNT }),\n ),\n // Only used when `courtOrdered: true` — see `excludeFields` below.\n garnishmentType: z.enum(GarnishmentType),\n}\n\n/\n Shape of the values managed by the deduction form.\n \n @public\n * @interface\n /\nexport type DeductionFormData = {\n [K in keyof typeof fieldValidators]: z.infer<(typeof fieldValidators)[K]>\n}\n\n~~/\n~~ ~~ Shape of the validated values produced by the deduction form on submit.\n \n ~~ @~~public\n~~ /\nexport type DeductionFormOutputs = DeductionFormData\n\n// ── Required fields config ─────────────────────────────────────────────\n//\n// `description`, `recurring`, `deductAsPercentage`, `amount` are required by\n// default. `garnishmentType` is required only when present in the shape\n// (court-ordered branch). `totalAmount` and `annualMaximum` are caps the\n// partner can leave blank.\n\nconst requiredFieldsConfig = {\n totalAmount: 'never',\n annualMaximum: 'never',\n} satisfies RequiredFieldConfig<typeof fieldValidators>\n\n/\n Keys of optional deduction fields that can be promoted to required via the\n * hook's `optionalFieldsToRequire` option.\n \n @public\n /\nexport type DeductionFormOptionalFieldsToRequire = OptionalFieldsToRequire<\n typeof requiredFieldsConfig\n>\n\n/* @internal /\ninterface DeductionFormSchemaOptions {\n mode?: 'create' \| 'update'\n /\n Court-ordered garnishments require `garnishmentType` (Federal Tax Lien,\n * Student Loan, etc.). Non-court-ordered \"custom\" deductions don't carry a\n * type — the field is excluded from the schema entirely, matching the legacy\n * GarnishmentForm vs CustomDeductionForm split.\n /\n courtOrdered: boolean\n optionalFieldsToRequire?: DeductionFormOptionalFieldsToRequire\n}\n\n/* @internal */\nexport function createDeductionFormSchema(options: DeductionFormSchemaOptions) {\n const { mode = 'create', courtOrdered, optionalFieldsToRequire } = options\n\n return buildFormSchema(fieldValidators, {\n requiredFieldsConfig,\n requiredErrorCode: DeductionFormErrorCodes.REQUIRED,\n mode,\n optionalFieldsToRequire,\n excludeFields: courtOrdered ? [] : ['garnishmentType'],\n })\n}\n"],"names":["DeductionFormErrorCodes","fieldValidators","z","coerceStringBoolean","coerceNaN","GarnishmentType","requiredFieldsConfig","createDeductionFormSchema","options","mode","courtOrdered","optionalFieldsToRequire","buildFormSchema"],"mappings":";;;;AAiBO,MAAMA,IAA0B;AAAA,EACrC,UAAU;AAAA,EACV,iBAAiB;AACnB,GAYMC,IAAkB;AAAA,EACtB,aAAaC,EAAE,OAAA;AAAA;AAAA;AAAA,EAGf,WAAWA,EAAE,WAAWC,GAAqBD,EAAE,SAAS;AAAA,EACxD,oBAAoBA,EAAE,WAAWC,GAAqBD,EAAE,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA,EAKjE,QAAQA,EAAE;AAAA,IACRE,EAAU,CAAC;AAAA,IACXF,EAAE,SAAS,IAAI,GAAG,EAAE,SAASF,EAAwB,gBAAA,CAAiB;AAAA,EAAA;AAAA;AAAA;AAAA,EAIxE,aAAaE,EAAE;AAAA,IACbE,EAAU,CAAC;AAAA,IACXF,EAAE,SAAS,IAAI,GAAG,EAAE,SAASF,EAAwB,gBAAA,CAAiB;AAAA,EAAA;AAAA,EAExE,eAAeE,EAAE;AAAA,IACfE,EAAU,CAAC;AAAA,IACXF,EAAE,SAAS,IAAI,GAAG,EAAE,SAASF,EAAwB,gBAAA,CAAiB;AAAA,EAAA;AAAA;AAAA,EAGxE,iBAAiBE,EAAE,KAAKG,CAAe;AACzC,~~GA0BMC~~,IAAuB;AAAA,EAC3B,aAAa;AAAA,EACb,eAAe;AACjB;AA0BO,SAASC,EAA0BC,GAAqC;AAC7E,QAAM,EAAE,MAAAC,IAAO,UAAU,cAAAC,GAAc,yBAAAC,MAA4BH;AAEnE,SAAOI,EAAgBX,GAAiB;AAAA,IACtC,sBAAAK;AAAA,IACA,mBAAmBN,EAAwB;AAAA,IAC3C,MAAAS;AAAA,IACA,yBAAAE;AAAA,IACA,eAAeD,IAAe,CAAA,IAAK,CAAC,iBAAiB;AAAA,EAAA,CACtD;AACH;"}
1	+ {"version":3,"file":"deductionFormSchema.js","sources":["../../../../../../src/components/Employee/Deductions/shared/useDeductionForm/deductionFormSchema.ts"],"sourcesContent":["import { z } from 'zod'\nimport { GarnishmentType } from '@gusto/embedded-api/models/components/garnishment'\nimport {\n buildFormSchema,\n type RequiredFieldConfig,\n type OptionalFieldsToRequire,\n} from '@/partner-hook-utils/form/buildFormSchema'\nimport { coerceNaN, coerceStringBoolean } from '@/partner-hook-utils/form/preprocessors'\n\n// ── Error codes ────────────────────────────────────────────────────────\n\n/*\n Validation error codes emitted by the deduction form schema. Map these\n * codes to localized copy in `validationMessages` when composing the hook.\n \n @public\n /\nexport const DeductionFormErrorCodes = {\n REQUIRED: 'REQUIRED',\n NEGATIVE_AMOUNT: 'NEGATIVE_AMOUNT',\n} as const\n\n/\n Union of validation error code strings emitted by the deduction form schema.\n \n @public\n /\nexport type DeductionFormErrorCode =\n (typeof DeductionFormErrorCodes)[keyof typeof DeductionFormErrorCodes]\n\n// ── Field validators ───────────────────────────────────────────────────\n\nconst fieldValidators = {\n description: z.string(),\n // Radio groups deliver `'true'`/`'false'` strings; coerce to boolean for the\n // submit payload. Matches the useJobForm pattern.\n recurring: z.preprocess(coerceStringBoolean, z.boolean()),\n deductAsPercentage: z.preprocess(coerceStringBoolean, z.boolean()),\n // Currency / percent input. NumberInputField writes `number \| undefined`;\n // coerce to a numeric so .min(0) runs reliably. The number-to-string\n // conversion the garnishment API expects happens inside the hook's onSubmit,\n // so the form value stays a number end-to-end (input === output).\n amount: z.preprocess(\n coerceNaN(0),\n z.number().min(0, { message: DeductionFormErrorCodes.NEGATIVE_AMOUNT }),\n ),\n // Optional caps. The hook drops them to `null` on the wire when 0 — matches\n // the legacy DeductionSchema's \"0 means no cap\" behavior.\n totalAmount: z.preprocess(\n coerceNaN(0),\n z.number().min(0, { message: DeductionFormErrorCodes.NEGATIVE_AMOUNT }),\n ),\n annualMaximum: z.preprocess(\n coerceNaN(0),\n z.number().min(0, { message: DeductionFormErrorCodes.NEGATIVE_AMOUNT }),\n ),\n // Only used when `courtOrdered: true` — see `excludeFields` below.\n garnishmentType: z.enum(GarnishmentType),\n}\n\n/\n Shape of the values managed by the deduction form.\n \n @public\n * @interface\n /\nexport type DeductionFormData = {\n [K in keyof typeof fieldValidators]: z.infer<(typeof fieldValidators)[K]>\n}\n\n/* @internal /\nexport type DeductionFormOutputs = DeductionFormData\n\n// ── Required fields config ─────────────────────────────────────────────\n//\n// `description`, `recurring`, `deductAsPercentage`, `amount` are required by\n// default. `garnishmentType` is required only when present in the shape\n// (court-ordered branch). `totalAmount` and `annualMaximum` are caps the\n// partner can leave blank.\n\nconst requiredFieldsConfig = {\n totalAmount: 'never',\n annualMaximum: 'never',\n} satisfies RequiredFieldConfig<typeof fieldValidators>\n\n/\n Keys of optional deduction fields that can be promoted to required via the\n * hook's `optionalFieldsToRequire` option.\n \n @public\n /\nexport type DeductionFormOptionalFieldsToRequire = OptionalFieldsToRequire<\n typeof requiredFieldsConfig\n>\n\n/* @internal /\ninterface DeductionFormSchemaOptions {\n mode?: 'create' \| 'update'\n /\n Court-ordered garnishments require `garnishmentType` (Federal Tax Lien,\n * Student Loan, etc.). Non-court-ordered \"custom\" deductions don't carry a\n * type — the field is excluded from the schema entirely, matching the legacy\n * GarnishmentForm vs CustomDeductionForm split.\n /\n courtOrdered: boolean\n optionalFieldsToRequire?: DeductionFormOptionalFieldsToRequire\n}\n\n/* @internal */\nexport function createDeductionFormSchema(options: DeductionFormSchemaOptions) {\n const { mode = 'create', courtOrdered, optionalFieldsToRequire } = options\n\n return buildFormSchema(fieldValidators, {\n requiredFieldsConfig,\n requiredErrorCode: DeductionFormErrorCodes.REQUIRED,\n mode,\n optionalFieldsToRequire,\n excludeFields: courtOrdered ? [] : ['garnishmentType'],\n })\n}\n"],"names":["DeductionFormErrorCodes","fieldValidators","z","coerceStringBoolean","coerceNaN","GarnishmentType","requiredFieldsConfig","createDeductionFormSchema","options","mode","courtOrdered","optionalFieldsToRequire","buildFormSchema"],"mappings":";;;;AAiBO,MAAMA,IAA0B;AAAA,EACrC,UAAU;AAAA,EACV,iBAAiB;AACnB,GAYMC,IAAkB;AAAA,EACtB,aAAaC,EAAE,OAAA;AAAA;AAAA;AAAA,EAGf,WAAWA,EAAE,WAAWC,GAAqBD,EAAE,SAAS;AAAA,EACxD,oBAAoBA,EAAE,WAAWC,GAAqBD,EAAE,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA,EAKjE,QAAQA,EAAE;AAAA,IACRE,EAAU,CAAC;AAAA,IACXF,EAAE,SAAS,IAAI,GAAG,EAAE,SAASF,EAAwB,gBAAA,CAAiB;AAAA,EAAA;AAAA;AAAA;AAAA,EAIxE,aAAaE,EAAE;AAAA,IACbE,EAAU,CAAC;AAAA,IACXF,EAAE,SAAS,IAAI,GAAG,EAAE,SAASF,EAAwB,gBAAA,CAAiB;AAAA,EAAA;AAAA,EAExE,eAAeE,EAAE;AAAA,IACfE,EAAU,CAAC;AAAA,IACXF,EAAE,SAAS,IAAI,GAAG,EAAE,SAASF,EAAwB,gBAAA,CAAiB;AAAA,EAAA;AAAA;AAAA,EAGxE,iBAAiBE,EAAE,KAAKG,CAAe;AACzC,GAsBMC,IAAuB;AAAA,EAC3B,aAAa;AAAA,EACb,eAAe;AACjB;AA0BO,SAASC,EAA0BC,GAAqC;AAC7E,QAAM,EAAE,MAAAC,IAAO,UAAU,cAAAC,GAAc,yBAAAC,MAA4BH;AAEnE,SAAOI,EAAgBX,GAAiB;AAAA,IACtC,sBAAAK;AAAA,IACA,mBAAmBN,EAAwB;AAAA,IAC3C,MAAAS;AAAA,IACA,yBAAAE;AAAA,IACA,eAAeD,IAAe,CAAA,IAAK,CAAC,iBAAiB;AAAA,EAAA,CACtD;AACH;"}