@gusto/embedded-react-sdk 0.50.0 → 0.51.2

package/dist/components/Employee/Profile/shared/useHomeAddressForm/useHomeAddressForm.js

@@ -1,51 +1,62 @@
-import { useMemo as W } from "react";
+import { useMemo as w } from "react";
 import { useForm as G } from "react-hook-form";
 import { zodResolver as K } from "@hookform/resolvers/zod";
-import { useEmployeeAddressesRetrieveHomeAddress as Q } from "@gusto/embedded-api-v-2025-11-15/react-query/employeeAddressesRetrieveHomeAddress";
-import { useEmployeeAddressesCreateMutation as T } from "@gusto/embedded-api-v-2025-11-15/react-query/employeeAddressesCreate";
-import { useEmployeeAddressesUpdateMutation as _ } from "@gusto/embedded-api-v-2025-11-15/react-query/employeeAddressesUpdate";
-import { RFCDate as j } from "@gusto/embedded-api-v-2025-11-15/types/rfcdate";
+import { useEmployeeAddressesRetrieveHomeAddress as Q } from "@gusto/embedded-api/react-query/employeeAddressesRetrieveHomeAddress";
+import { useEmployeeAddressesCreateMutation as T } from "@gusto/embedded-api/react-query/employeeAddressesCreate";
+import { useEmployeeAddressesUpdateMutation as _ } from "@gusto/embedded-api/react-query/employeeAddressesUpdate";
+import { RFCDate as j } from "@gusto/embedded-api/types/rfcdate";
 import { createHomeAddressSchema as J } from "./homeAddressSchema.js";
 import { EffectiveDateField as N, CourtesyWithholdingField as X, ZipField as Y, StateField as $, CityField as U, Street2Field as ee, Street1Field as te } from "./fields.js";
-import { useDeriveFieldsMetadata as se } from "../../../../../partner-hook-utils/form/useDeriveFieldsMetadata.js";
-import { useHookFormInternals as re } from "../../../../../partner-hook-utils/form/useHookFormInternals.js";
+import { useDeriveFieldsMetadata as re } from "../../../../../partner-hook-utils/form/useDeriveFieldsMetadata.js";
+import { useHookFormInternals as se } from "../../../../../partner-hook-utils/form/useHookFormInternals.js";
 import { createGetFormSubmissionValues as oe } from "../../../../../partner-hook-utils/form/getFormSubmissionValues.js";
 import { withOptions as ie } from "../../../../../partner-hook-utils/form/withOptions.js";
-import { composeErrorHandler as me } from "../../../../../partner-hook-utils/composeErrorHandler.js";
+import { composeErrorHandler as de } from "../../../../../partner-hook-utils/composeErrorHandler.js";
 import { useBaseSubmit as ne } from "../../../../Base/useBaseSubmit.js";
 import { SDKInternalError as u } from "../../../../../types/sdkError.js";
-import { STATES_ABBR as w } from "../../../../../shared/constants.js";
-function We({
-  employeeId: z,
-  homeAddressUuid: s,
+import { STATES_ABBR as z } from "../../../../../shared/constants.js";
+function me(s, { stateOptions: r }) {
+  return {
+    street1: s.street1,
+    street2: s.street2,
+    city: s.city,
+    state: ie(s.state, r, z),
+    zip: s.zip,
+    courtesyWithholding: s.courtesyWithholding,
+    effectiveDate: s.effectiveDate
+  };
+}
+function ze({
+  employeeId: s,
+  homeAddressUuid: r,
   initialAddress: f,
   withEffectiveDateField: i = !0,
   optionalFieldsToRequire: l,
-  defaultValues: r,
+  defaultValues: o,
   validationMode: D = "onSubmit",
   shouldFocusError: C = !0
 }) {
-  const p = !!s && f?.uuid === s, v = Q(
-    { homeAddressUuid: s ?? "" },
-    { enabled: !!s && !p }
-  ), m = !s, e = s ? p ? f : v.data?.employeeAddress : void 0, y = m ? "create" : "update", [h, I] = W(
+  const p = !!r && f?.uuid === r, v = Q(
+    { homeAddressUuid: r ?? "" },
+    { enabled: !!r && !p }
+  ), d = !r, e = r ? p ? f : v.data?.employeeAddress : void 0, y = d ? "create" : "update", [h, b] = w(
     () => J({
       mode: y,
       optionalFieldsToRequire: l,
       withEffectiveDateField: i
     }),
     [y, l, i]
-  ), g = W(
+  ), g = w(
     () => ({
-      street1: e?.street1 ?? r?.street1 ?? "",
-      street2: e?.street2 ?? r?.street2 ?? "",
-      city: e?.city ?? r?.city ?? "",
-      state: e?.state ?? r?.state ?? "",
-      zip: e?.zip ?? r?.zip ?? "",
-      courtesyWithholding: e?.courtesyWithholding ?? r?.courtesyWithholding ?? !1,
-      effectiveDate: e?.effectiveDate?.toString() ?? r?.effectiveDate ?? ""
+      street1: e?.street1 ?? o?.street1 ?? "",
+      street2: e?.street2 ?? o?.street2 ?? "",
+      city: e?.city ?? o?.city ?? "",
+      state: e?.state ?? o?.state ?? "",
+      zip: e?.zip ?? o?.zip ?? "",
+      courtesyWithholding: e?.courtesyWithholding ?? o?.courtesyWithholding ?? !1,
+      effectiveDate: e?.effectiveDate?.toString() ?? o?.effectiveDate ?? ""
     }),
-    [e, r]
+    [e, o]
   ), a = G({
     resolver: K(h),
     mode: D,
@@ -53,31 +64,23 @@ function We({
     defaultValues: g,
     values: g,
     resetOptions: { keepDirtyValues: !0 }
-  }), S = T(), A = _(), q = S.isPending || A.isPending, {
-    baseSubmitHandler: B,
-    error: P,
-    setError: V
-  } = ne("HomeAddressForm"), H = me(s ? [v] : [], { submitError: P, setSubmitError: V }), R = w.map((n) => ({
+  }), S = T(), A = _(), I = S.isPending || A.isPending, {
+    baseSubmitHandler: q,
+    error: B,
+    setError: P
+  } = ne("HomeAddressForm"), H = de(r ? [v] : [], { submitError: B, setSubmitError: P }), V = z.map((n) => ({
     value: n,
     label: n
-  })), o = se(I, a.control), k = {
-    street1: o.street1,
-    street2: o.street2,
-    city: o.city,
-    state: ie(o.state, R, w),
-    zip: o.zip,
-    courtesyWithholding: o.courtesyWithholding,
-    effectiveDate: o.effectiveDate
-  }, O = async (n) => {
+  })), R = re(b, a.control), k = me(R, { stateOptions: V }), O = async (n) => {
     let F;
-    return await new Promise((b) => {
+    return await new Promise((M) => {
       a.handleSubmit(
         async (Z) => {
-          await B(Z, async (t) => {
-            const x = n?.employeeId ?? z, M = i && t.effectiveDate ? t.effectiveDate : n?.effectiveDate ?? (!i && !m ? e?.effectiveDate?.toString() : void 0), E = M ? new j(new Date(M)) : void 0;
+          await q(Z, async (t) => {
+            const x = n?.employeeId ?? s, E = i && t.effectiveDate ? t.effectiveDate : n?.effectiveDate ?? (!i && !d ? e?.effectiveDate?.toString() : void 0), W = E ? new j(new Date(E)) : void 0;
             let c;
-            if (m) {
-              const d = await S.mutateAsync({
+            if (d) {
+              const m = await S.mutateAsync({
                 request: {
                   employeeId: x,
                   requestBody: {
@@ -87,19 +90,19 @@ function We({
                     state: t.state,
                     zip: t.zip,
                     courtesyWithholding: t.courtesyWithholding,
-                    effectiveDate: E
+                    effectiveDate: W
                   }
                 }
               });
-              if (!d.employeeAddress)
+              if (!m.employeeAddress)
                 throw new u("Home address creation failed");
-              c = d.employeeAddress;
+              c = m.employeeAddress;
             } else {
-              if (!e || !s)
+              if (!e || !r)
                 throw new u(
                   "Cannot update home address: no matching address on file"
                 );
-              const d = await A.mutateAsync({
+              const m = await A.mutateAsync({
                 request: {
                   homeAddressUuid: e.uuid,
                   requestBody: {
@@ -110,34 +113,34 @@ function We({
                     state: t.state,
                     zip: t.zip,
                     courtesyWithholding: t.courtesyWithholding,
-                    effectiveDate: E
+                    effectiveDate: W
                   }
                 }
               });
-              if (!d.employeeAddress)
+              if (!m.employeeAddress)
                 throw new u("Home address update failed");
-              c = d.employeeAddress;
+              c = m.employeeAddress;
             }
             F = {
-              mode: m ? "create" : "update",
+              mode: d ? "create" : "update",
               data: c
             };
-          }), b();
+          }), M();
         },
         () => {
-          b();
+          M();
         }
       )();
     }), F;
-  }, L = re(a);
-  return s && !e ? { isLoading: !0, errorHandling: H } : {
+  }, L = se(a);
+  return r && !e ? { isLoading: !0, errorHandling: H } : {
     isLoading: !1,
     data: {
       homeAddress: e ?? null
     },
     status: {
-      isPending: q,
-      mode: m ? "create" : "update"
+      isPending: I,
+      mode: d ? "create" : "update"
     },
     actions: { onSubmit: O },
     errorHandling: H,
@@ -158,6 +161,6 @@ function We({
   };
 }
 export {
-  We as useHomeAddressForm
+  ze as useHomeAddressForm
 };
 //# sourceMappingURL=useHomeAddressForm.js.map

package/dist/components/Employee/Profile/shared/useHomeAddressForm/useHomeAddressForm.js.map

@@ -1 +1 @@
-{"version":3,"file":"useHomeAddressForm.js","sources":["../../../../../../src/components/Employee/Profile/shared/useHomeAddressForm/useHomeAddressForm.tsx"],"sourcesContent":["import { useMemo } from 'react'\nimport { useForm } from 'react-hook-form'\nimport type { UseFormProps } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport type { EmployeeAddress } from '@gusto/embedded-api-v-2025-11-15/models/components/employeeaddress'\nimport { useEmployeeAddressesRetrieveHomeAddress } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeAddressesRetrieveHomeAddress'\nimport { useEmployeeAddressesCreateMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeAddressesCreate'\nimport { useEmployeeAddressesUpdateMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeAddressesUpdate'\nimport { RFCDate } from '@gusto/embedded-api-v-2025-11-15/types/rfcdate'\nimport {\n  createHomeAddressSchema,\n  type HomeAddressOptionalFieldsToRequire,\n  type HomeAddressFormData,\n  type HomeAddressFormOutputs,\n} from './homeAddressSchema'\nimport {\n  Street1Field,\n  Street2Field,\n  CityField,\n  StateField,\n  ZipField,\n  CourtesyWithholdingField,\n  EffectiveDateField,\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'\nimport { STATES_ABBR } from '@/shared/constants'\n\nexport type { HomeAddressOptionalFieldsToRequire } from './homeAddressSchema'\n\n/**\n * Optional overrides passed to {@link UseHomeAddressFormReady.actions.onSubmit | onSubmit}.\n *\n * @public\n */\nexport interface HomeAddressSubmitOptions {\n  /** Override the employee identifier supplied to the hook (e.g. after creating a new employee in the same flow). */\n  employeeId?: string\n  /** Override the effective date submitted with the address. When omitted on update without an effective-date field, the row's `effectiveDate` from the fetched address is used. */\n  effectiveDate?: string\n}\n\n/**\n * Configuration options for {@link useHomeAddressForm}.\n *\n * @remarks\n * Presence or absence of `homeAddressUuid` selects the API verb — see the\n * `homeAddressUuid` field description.\n *\n * @public\n */\nexport interface UseHomeAddressFormProps {\n  /** UUID of the employee whose home address is being created or edited. */\n  employeeId: string\n  /**\n   * When set, loads that home address via GET `/v1/home_addresses/{uuid}` and updates it (PUT).\n   * When omitted, the form is in create mode (POST).\n   */\n  homeAddressUuid?: string\n  /**\n   * Pre-loaded address matching `homeAddressUuid`. When supplied, the form uses it directly\n   * instead of issuing a GET — useful when the parent already has the row from a list query.\n   */\n  initialAddress?: EmployeeAddress\n  /** When `true`, renders `Fields.EffectiveDate`; otherwise it is `undefined`. Defaults to `true`. */\n  withEffectiveDateField?: boolean\n  /** Override fields that are optional on a given mode to be required. See `HomeAddressOptionalFieldsToRequire`. */\n  optionalFieldsToRequire?: HomeAddressOptionalFieldsToRequire\n  /** Pre-fill form values. Server data takes precedence on update. */\n  defaultValues?: Partial<HomeAddressFormData>\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 `useHomeAddressForm().form.Fields`.\n *\n * @remarks\n * `EffectiveDate` is `undefined` when `withEffectiveDateField` is `false`.\n * Always null-check it before rendering.\n *\n * @public\n */\nexport interface HomeAddressFields {\n  /** Street address line 1 text input. Always available. */\n  Street1: typeof Street1Field\n  /** Street address line 2 text input. Always available. */\n  Street2: typeof Street2Field\n  /** City text input. Always available. */\n  City: typeof CityField\n  /** State selector. Always available. */\n  State: typeof StateField\n  /** ZIP code text input. Always available. */\n  Zip: typeof ZipField\n  /** Courtesy withholding checkbox. Always available. */\n  CourtesyWithholding: typeof CourtesyWithholdingField\n  /** Effective-date picker. Only available when `withEffectiveDateField` is `true`. */\n  EffectiveDate: typeof EffectiveDateField | undefined\n}\n\n/**\n * Ready-state shape returned by {@link useHomeAddressForm} once data has loaded.\n *\n * @remarks\n * Discriminated by `isLoading: false`. Extends {@link BaseFormHookReady} with\n * the home-address-specific `data`, `status`, `actions`, and `form.Fields` shape.\n *\n * @public\n */\nexport interface UseHomeAddressFormReady extends BaseFormHookReady<\n  FieldsMetadata,\n  HomeAddressFormData,\n  HomeAddressFields\n> {\n  /** Static entity data resolved from the API. */\n  data: {\n    /** The address row loaded for update; `null` in create mode. */\n    homeAddress: EmployeeAddress | null\n  }\n  /** Reactive status flags. */\n  status: { isPending: boolean; mode: 'create' | 'update' }\n  /** Available actions. */\n  actions: {\n    onSubmit: (\n      options?: HomeAddressSubmitOptions,\n    ) => Promise<HookSubmitResult<EmployeeAddress> | undefined>\n  }\n}\n\n/**\n * Form hook for creating or editing an employee's home address.\n *\n * @remarks\n * When `homeAddressUuid` is supplied the hook loads that address and issues a PUT on submit;\n * when omitted it operates in create mode and issues a POST. Pass `initialAddress` to\n * skip the fetch when the parent already holds the row.\n *\n * @param props - See {@link UseHomeAddressFormProps}.\n * @returns A {@link HookLoadingResult} while loading, or a {@link UseHomeAddressFormReady} once ready.\n * @public\n *\n * @example\n * ```tsx\n * import {\n *   useHomeAddressForm,\n *   SDKFormProvider,\n *   type UseHomeAddressFormReady,\n * } from '@gusto/embedded-react-sdk'\n *\n * function HomeAddressPage({ employeeId }: { employeeId: string }) {\n *   const homeAddress = useHomeAddressForm({ employeeId })\n *\n *   if (homeAddress.isLoading) return <div>Loading...</div>\n *\n *   return <HomeAddressReady homeAddress={homeAddress} />\n * }\n *\n * function HomeAddressReady({ homeAddress }: { homeAddress: UseHomeAddressFormReady }) {\n *   const { Fields } = homeAddress.form\n *\n *   return (\n *     <SDKFormProvider formHookResult={homeAddress}>\n *       <form onSubmit={e => { e.preventDefault(); void homeAddress.actions.onSubmit() }}>\n *         <Fields.Street1 label=\"Street address\" />\n *         <Fields.Street2 label=\"Apt, suite, etc. (optional)\" />\n *         <Fields.City label=\"City\" />\n *         <Fields.State label=\"State\" />\n *         <Fields.Zip label=\"ZIP code\" />\n *         <Fields.CourtesyWithholding label=\"Courtesy withholding\" />\n *         {Fields.EffectiveDate && <Fields.EffectiveDate label=\"Effective date\" />}\n *         <button type=\"submit\" disabled={homeAddress.status.isPending}>Save</button>\n *       </form>\n *     </SDKFormProvider>\n *   )\n * }\n * ```\n */\nexport function useHomeAddressForm({\n  employeeId,\n  homeAddressUuid,\n  initialAddress,\n  withEffectiveDateField = true,\n  optionalFieldsToRequire,\n  defaultValues: partnerDefaults,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n}: UseHomeAddressFormProps): HookLoadingResult | UseHomeAddressFormReady {\n  const hasInitialAddressMatch = !!homeAddressUuid && initialAddress?.uuid === homeAddressUuid\n\n  const retrieveHomeAddressQuery = useEmployeeAddressesRetrieveHomeAddress(\n    { homeAddressUuid: homeAddressUuid ?? '' },\n    { enabled: !!homeAddressUuid && !hasInitialAddressMatch },\n  )\n\n  const isCreateMode = !homeAddressUuid\n\n  const fetchedHomeAddress = homeAddressUuid\n    ? hasInitialAddressMatch\n      ? initialAddress\n      : retrieveHomeAddressQuery.data?.employeeAddress\n    : undefined\n\n  const schemaMode = isCreateMode ? 'create' : 'update'\n\n  const [schema, metadataConfig] = useMemo(\n    () =>\n      createHomeAddressSchema({\n        mode: schemaMode,\n        optionalFieldsToRequire,\n        withEffectiveDateField,\n      }),\n    [schemaMode, optionalFieldsToRequire, withEffectiveDateField],\n  )\n\n  const resolvedDefaults: HomeAddressFormData = useMemo(\n    () => ({\n      street1: fetchedHomeAddress?.street1 ?? partnerDefaults?.street1 ?? '',\n      street2: fetchedHomeAddress?.street2 ?? partnerDefaults?.street2 ?? '',\n      city: fetchedHomeAddress?.city ?? partnerDefaults?.city ?? '',\n      state: fetchedHomeAddress?.state ?? partnerDefaults?.state ?? '',\n      zip: fetchedHomeAddress?.zip ?? partnerDefaults?.zip ?? '',\n      courtesyWithholding:\n        fetchedHomeAddress?.courtesyWithholding ?? partnerDefaults?.courtesyWithholding ?? false,\n      effectiveDate:\n        fetchedHomeAddress?.effectiveDate?.toString() ?? partnerDefaults?.effectiveDate ?? '',\n    }),\n    [fetchedHomeAddress, partnerDefaults],\n  )\n\n  const formMethods = useForm<HomeAddressFormData, unknown, HomeAddressFormOutputs>({\n    resolver: zodResolver(schema),\n    mode: validationMode,\n    shouldFocusError,\n    defaultValues: resolvedDefaults,\n    values: resolvedDefaults,\n    resetOptions: { keepDirtyValues: true },\n  })\n\n  const createHomeAddressMutation = useEmployeeAddressesCreateMutation()\n  const updateHomeAddressMutation = useEmployeeAddressesUpdateMutation()\n\n  const isPending = createHomeAddressMutation.isPending || updateHomeAddressMutation.isPending\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('HomeAddressForm')\n\n  const queriesForErrors = homeAddressUuid ? [retrieveHomeAddressQuery] : []\n  const errorHandling = composeErrorHandler(queriesForErrors, { submitError, setSubmitError })\n\n  const stateOptions = STATES_ABBR.map(abbr => ({\n    value: abbr,\n    label: abbr,\n  }))\n\n  const baseMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n  const fieldsMetadata = {\n    street1: baseMetadata.street1,\n    street2: baseMetadata.street2,\n    city: baseMetadata.city,\n    state: withOptions(baseMetadata.state, stateOptions, STATES_ABBR),\n    zip: baseMetadata.zip,\n    courtesyWithholding: baseMetadata.courtesyWithholding,\n    effectiveDate: baseMetadata.effectiveDate,\n  }\n\n  const onSubmit = async (\n    options?: HomeAddressSubmitOptions,\n  ): Promise<HookSubmitResult<EmployeeAddress> | undefined> => {\n    let submitResult: HookSubmitResult<EmployeeAddress> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: HomeAddressFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            const resolvedEmployeeId = options?.employeeId ?? employeeId\n\n            const resolvedEffectiveDate =\n              withEffectiveDateField && payload.effectiveDate\n                ? payload.effectiveDate\n                : (options?.effectiveDate ??\n                  (!withEffectiveDateField && !isCreateMode\n                    ? fetchedHomeAddress?.effectiveDate?.toString()\n                    : undefined))\n\n            const effectiveDateParam = resolvedEffectiveDate\n              ? new RFCDate(new Date(resolvedEffectiveDate))\n              : undefined\n\n            let updatedHomeAddress: EmployeeAddress\n\n            if (isCreateMode) {\n              const result = await createHomeAddressMutation.mutateAsync({\n                request: {\n                  employeeId: resolvedEmployeeId,\n                  requestBody: {\n                    street1: payload.street1,\n                    street2: payload.street2 || undefined,\n                    city: payload.city,\n                    state: payload.state,\n                    zip: payload.zip,\n                    courtesyWithholding: payload.courtesyWithholding,\n                    effectiveDate: effectiveDateParam,\n                  },\n                },\n              })\n\n              if (!result.employeeAddress) {\n                throw new SDKInternalError('Home address creation failed')\n              }\n\n              updatedHomeAddress = result.employeeAddress\n            } else {\n              if (!fetchedHomeAddress || !homeAddressUuid) {\n                throw new SDKInternalError(\n                  'Cannot update home address: no matching address on file',\n                )\n              }\n\n              const result = await updateHomeAddressMutation.mutateAsync({\n                request: {\n                  homeAddressUuid: fetchedHomeAddress.uuid,\n                  requestBody: {\n                    version: fetchedHomeAddress.version,\n                    street1: payload.street1,\n                    street2: payload.street2 || undefined,\n                    city: payload.city,\n                    state: payload.state,\n                    zip: payload.zip,\n                    courtesyWithholding: payload.courtesyWithholding,\n                    effectiveDate: effectiveDateParam,\n                  },\n                },\n              })\n\n              if (!result.employeeAddress) {\n                throw new SDKInternalError('Home address update failed')\n              }\n\n              updatedHomeAddress = result.employeeAddress\n            }\n\n            submitResult = {\n              mode: isCreateMode ? 'create' : 'update',\n              data: updatedHomeAddress,\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 (homeAddressUuid && !fetchedHomeAddress) {\n    return { isLoading: true as const, errorHandling }\n  }\n\n  return {\n    isLoading: false as const,\n    data: {\n      homeAddress: fetchedHomeAddress ?? null,\n    },\n    status: {\n      isPending,\n      mode: isCreateMode ? ('create' as const) : ('update' as const),\n    },\n    actions: { onSubmit },\n    errorHandling,\n    form: {\n      Fields: {\n        Street1: Street1Field,\n        Street2: Street2Field,\n        City: CityField,\n        State: StateField,\n        Zip: ZipField,\n        CourtesyWithholding: CourtesyWithholdingField,\n        EffectiveDate: withEffectiveDateField ? EffectiveDateField : undefined,\n      },\n      fieldsMetadata,\n      hookFormInternals,\n      getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n    },\n  }\n}\n\n/**\n * Discriminated union returned by {@link useHomeAddressForm}.\n *\n * @public\n */\nexport type UseHomeAddressFormResult = HookLoadingResult | UseHomeAddressFormReady\n/**\n * Type of `form.fieldsMetadata` returned by {@link useHomeAddressForm}.\n *\n * @public\n */\nexport type HomeAddressFieldsMetadata = UseHomeAddressFormReady['form']['fieldsMetadata']\n/**\n * Type of `form.Fields` returned by {@link useHomeAddressForm}.\n *\n * @public\n */\nexport type HomeAddressFormFields = UseHomeAddressFormReady['form']['Fields']\n"],"names":["useHomeAddressForm","employeeId","homeAddressUuid","initialAddress","withEffectiveDateField","optionalFieldsToRequire","partnerDefaults","validationMode","shouldFocusError","hasInitialAddressMatch","retrieveHomeAddressQuery","useEmployeeAddressesRetrieveHomeAddress","isCreateMode","fetchedHomeAddress","schemaMode","schema","metadataConfig","useMemo","createHomeAddressSchema","resolvedDefaults","formMethods","useForm","zodResolver","createHomeAddressMutation","useEmployeeAddressesCreateMutation","updateHomeAddressMutation","useEmployeeAddressesUpdateMutation","isPending","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","stateOptions","STATES_ABBR","abbr","baseMetadata","useDeriveFieldsMetadata","fieldsMetadata","withOptions","onSubmit","options","submitResult","resolve","data","payload","resolvedEmployeeId","resolvedEffectiveDate","effectiveDateParam","RFCDate","updatedHomeAddress","result","SDKInternalError","hookFormInternals","useHookFormInternals","Street1Field","Street2Field","CityField","StateField","ZipField","CourtesyWithholdingField","EffectiveDateField","createGetFormSubmissionValues"],"mappings":"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"}
+{"version":3,"file":"useHomeAddressForm.js","sources":["../../../../../../src/components/Employee/Profile/shared/useHomeAddressForm/useHomeAddressForm.tsx"],"sourcesContent":["import type { ComponentType } from 'react'\nimport { useMemo } from 'react'\nimport { useForm } from 'react-hook-form'\nimport type { UseFormProps } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport type { EmployeeAddress } from '@gusto/embedded-api/models/components/employeeaddress'\nimport { useEmployeeAddressesRetrieveHomeAddress } from '@gusto/embedded-api/react-query/employeeAddressesRetrieveHomeAddress'\nimport { useEmployeeAddressesCreateMutation } from '@gusto/embedded-api/react-query/employeeAddressesCreate'\nimport { useEmployeeAddressesUpdateMutation } from '@gusto/embedded-api/react-query/employeeAddressesUpdate'\nimport { RFCDate } from '@gusto/embedded-api/types/rfcdate'\nimport {\n  createHomeAddressSchema,\n  type HomeAddressOptionalFieldsToRequire,\n  type HomeAddressFormData,\n  type HomeAddressFormOutputs,\n} from './homeAddressSchema'\nimport type {\n  Street1FieldProps,\n  Street2FieldProps,\n  CityFieldProps,\n  StateFieldProps,\n  ZipFieldProps,\n  CourtesyWithholdingFieldProps,\n  EffectiveDateFieldProps,\n} from './fields'\nimport {\n  Street1Field,\n  Street2Field,\n  CityField,\n  StateField,\n  ZipField,\n  CourtesyWithholdingField,\n  EffectiveDateField,\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'\nimport { STATES_ABBR } from '@/shared/constants'\n\nexport type { HomeAddressOptionalFieldsToRequire } from './homeAddressSchema'\n\n/** @internal */\nfunction buildHomeAddressFieldsMetadata(\n  base: Record<keyof HomeAddressFormData, FieldMetadata>,\n  { stateOptions }: { stateOptions: Array<{ label: string; value: string }> },\n) {\n  return {\n    street1: base.street1,\n    street2: base.street2,\n    city: base.city,\n    state: withOptions(base.state, stateOptions, STATES_ABBR),\n    zip: base.zip,\n    courtesyWithholding: base.courtesyWithholding,\n    effectiveDate: base.effectiveDate,\n  } satisfies FieldsMetadata\n}\n\n/**\n * Optional overrides passed to {@link UseHomeAddressFormReady.actions.onSubmit | onSubmit}.\n *\n * @public\n */\nexport interface HomeAddressSubmitOptions {\n  /** Override the employee identifier supplied to the hook (e.g. after creating a new employee in the same flow). */\n  employeeId?: string\n  /** Override the effective date submitted with the address. When omitted on update without an effective-date field, the row's `effectiveDate` from the fetched address is used. */\n  effectiveDate?: string\n}\n\n/**\n * Configuration options for {@link useHomeAddressForm}.\n *\n * @remarks\n * Presence or absence of `homeAddressUuid` selects the API verb — see the\n * `homeAddressUuid` field description.\n *\n * @public\n */\nexport interface UseHomeAddressFormProps {\n  /** UUID of the employee whose home address is being created or edited. */\n  employeeId: string\n  /**\n   * When set, loads that home address via GET `/v1/home_addresses/{uuid}` and updates it (PUT).\n   * When omitted, the form is in create mode (POST).\n   */\n  homeAddressUuid?: string\n  /**\n   * Pre-loaded address matching `homeAddressUuid`. When supplied, the form uses it directly\n   * instead of issuing a GET — useful when the parent already has the row from a list query.\n   */\n  initialAddress?: EmployeeAddress\n  /** When `true`, renders `Fields.EffectiveDate`; otherwise it is `undefined`. Defaults to `true`. */\n  withEffectiveDateField?: boolean\n  /** Override fields that are optional on a given mode to be required. See `HomeAddressOptionalFieldsToRequire`. */\n  optionalFieldsToRequire?: HomeAddressOptionalFieldsToRequire\n  /** Pre-fill form values. Server data takes precedence on update. */\n  defaultValues?: Partial<HomeAddressFormData>\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 `useHomeAddressForm().form.Fields`.\n *\n * @remarks\n * `EffectiveDate` is `undefined` when `withEffectiveDateField` is `false`.\n * Always null-check it before rendering.\n *\n * @public\n */\nexport interface HomeAddressFormFields {\n  /** Bound to `street1`. Street address line 1 text input. Always available. */\n  Street1: ComponentType<Street1FieldProps>\n  /** Bound to `street2`. Street address line 2 text input. Always available. */\n  Street2: ComponentType<Street2FieldProps>\n  /** Bound to `city`. City text input. Always available. */\n  City: ComponentType<CityFieldProps>\n  /** Bound to `state`. State selector. Always available. */\n  State: ComponentType<StateFieldProps>\n  /** Bound to `zip`. ZIP code text input. Always available. */\n  Zip: ComponentType<ZipFieldProps>\n  /** Bound to `courtesyWithholding`. Courtesy withholding checkbox. Always available. */\n  CourtesyWithholding: ComponentType<CourtesyWithholdingFieldProps>\n  /** Bound to `effectiveDate`. Effective-date picker. Only available when `withEffectiveDateField` is `true`. */\n  EffectiveDate: ComponentType<EffectiveDateFieldProps> | undefined\n}\n\n/**\n * Ready-state shape returned by {@link useHomeAddressForm} once data has loaded.\n *\n * @remarks\n * Discriminated by `isLoading: false`. Extends {@link BaseFormHookReady} with\n * the home-address-specific `data`, `status`, `actions`, and `form.Fields` shape.\n *\n * @public\n */\nexport interface UseHomeAddressFormReady extends BaseFormHookReady<\n  HomeAddressFieldsMetadata,\n  HomeAddressFormData,\n  HomeAddressFormFields\n> {\n  /** Static entity data resolved from the API. */\n  data: {\n    /** The address row loaded for update; `null` in create mode. */\n    homeAddress: EmployeeAddress | null\n  }\n  /** Reactive status flags. */\n  status: { isPending: boolean; mode: 'create' | 'update' }\n  /** Available actions. */\n  actions: {\n    onSubmit: (\n      options?: HomeAddressSubmitOptions,\n    ) => Promise<HookSubmitResult<EmployeeAddress> | undefined>\n  }\n}\n\n/**\n * Form hook for creating or editing an employee's home address.\n *\n * @remarks\n * When `homeAddressUuid` is supplied the hook loads that address and issues a PUT on submit;\n * when omitted it operates in create mode and issues a POST. Pass `initialAddress` to\n * skip the fetch when the parent already holds the row.\n *\n * @param props - See {@link UseHomeAddressFormProps}.\n * @returns A {@link HookLoadingResult} while loading, or a {@link UseHomeAddressFormReady} once ready.\n * @public\n *\n * @example\n * ```tsx\n * import {\n *   useHomeAddressForm,\n *   SDKFormProvider,\n *   type UseHomeAddressFormReady,\n * } from '@gusto/embedded-react-sdk'\n *\n * function HomeAddressPage({ employeeId }: { employeeId: string }) {\n *   const homeAddress = useHomeAddressForm({ employeeId })\n *\n *   if (homeAddress.isLoading) return <div>Loading...</div>\n *\n *   return <HomeAddressReady homeAddress={homeAddress} />\n * }\n *\n * function HomeAddressReady({ homeAddress }: { homeAddress: UseHomeAddressFormReady }) {\n *   const { Fields } = homeAddress.form\n *\n *   return (\n *     <SDKFormProvider formHookResult={homeAddress}>\n *       <form onSubmit={e => { e.preventDefault(); void homeAddress.actions.onSubmit() }}>\n *         <Fields.Street1 label=\"Street address\" />\n *         <Fields.Street2 label=\"Apt, suite, etc. (optional)\" />\n *         <Fields.City label=\"City\" />\n *         <Fields.State label=\"State\" />\n *         <Fields.Zip label=\"ZIP code\" />\n *         <Fields.CourtesyWithholding label=\"Courtesy withholding\" />\n *         {Fields.EffectiveDate && <Fields.EffectiveDate label=\"Effective date\" />}\n *         <button type=\"submit\" disabled={homeAddress.status.isPending}>Save</button>\n *       </form>\n *     </SDKFormProvider>\n *   )\n * }\n * ```\n */\nexport function useHomeAddressForm({\n  employeeId,\n  homeAddressUuid,\n  initialAddress,\n  withEffectiveDateField = true,\n  optionalFieldsToRequire,\n  defaultValues: partnerDefaults,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n}: UseHomeAddressFormProps): HookLoadingResult | UseHomeAddressFormReady {\n  const hasInitialAddressMatch = !!homeAddressUuid && initialAddress?.uuid === homeAddressUuid\n\n  const retrieveHomeAddressQuery = useEmployeeAddressesRetrieveHomeAddress(\n    { homeAddressUuid: homeAddressUuid ?? '' },\n    { enabled: !!homeAddressUuid && !hasInitialAddressMatch },\n  )\n\n  const isCreateMode = !homeAddressUuid\n\n  const fetchedHomeAddress = homeAddressUuid\n    ? hasInitialAddressMatch\n      ? initialAddress\n      : retrieveHomeAddressQuery.data?.employeeAddress\n    : undefined\n\n  const schemaMode = isCreateMode ? 'create' : 'update'\n\n  const [schema, metadataConfig] = useMemo(\n    () =>\n      createHomeAddressSchema({\n        mode: schemaMode,\n        optionalFieldsToRequire,\n        withEffectiveDateField,\n      }),\n    [schemaMode, optionalFieldsToRequire, withEffectiveDateField],\n  )\n\n  const resolvedDefaults: HomeAddressFormData = useMemo(\n    () => ({\n      street1: fetchedHomeAddress?.street1 ?? partnerDefaults?.street1 ?? '',\n      street2: fetchedHomeAddress?.street2 ?? partnerDefaults?.street2 ?? '',\n      city: fetchedHomeAddress?.city ?? partnerDefaults?.city ?? '',\n      state: fetchedHomeAddress?.state ?? partnerDefaults?.state ?? '',\n      zip: fetchedHomeAddress?.zip ?? partnerDefaults?.zip ?? '',\n      courtesyWithholding:\n        fetchedHomeAddress?.courtesyWithholding ?? partnerDefaults?.courtesyWithholding ?? false,\n      effectiveDate:\n        fetchedHomeAddress?.effectiveDate?.toString() ?? partnerDefaults?.effectiveDate ?? '',\n    }),\n    [fetchedHomeAddress, partnerDefaults],\n  )\n\n  const formMethods = useForm<HomeAddressFormData, unknown, HomeAddressFormOutputs>({\n    resolver: zodResolver(schema),\n    mode: validationMode,\n    shouldFocusError,\n    defaultValues: resolvedDefaults,\n    values: resolvedDefaults,\n    resetOptions: { keepDirtyValues: true },\n  })\n\n  const createHomeAddressMutation = useEmployeeAddressesCreateMutation()\n  const updateHomeAddressMutation = useEmployeeAddressesUpdateMutation()\n\n  const isPending = createHomeAddressMutation.isPending || updateHomeAddressMutation.isPending\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('HomeAddressForm')\n\n  const queriesForErrors = homeAddressUuid ? [retrieveHomeAddressQuery] : []\n  const errorHandling = composeErrorHandler(queriesForErrors, { submitError, setSubmitError })\n\n  const stateOptions = STATES_ABBR.map(abbr => ({\n    value: abbr,\n    label: abbr,\n  }))\n\n  const baseMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n  const fieldsMetadata = buildHomeAddressFieldsMetadata(baseMetadata, { stateOptions })\n\n  const onSubmit = async (\n    options?: HomeAddressSubmitOptions,\n  ): Promise<HookSubmitResult<EmployeeAddress> | undefined> => {\n    let submitResult: HookSubmitResult<EmployeeAddress> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: HomeAddressFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            const resolvedEmployeeId = options?.employeeId ?? employeeId\n\n            const resolvedEffectiveDate =\n              withEffectiveDateField && payload.effectiveDate\n                ? payload.effectiveDate\n                : (options?.effectiveDate ??\n                  (!withEffectiveDateField && !isCreateMode\n                    ? fetchedHomeAddress?.effectiveDate?.toString()\n                    : undefined))\n\n            const effectiveDateParam = resolvedEffectiveDate\n              ? new RFCDate(new Date(resolvedEffectiveDate))\n              : undefined\n\n            let updatedHomeAddress: EmployeeAddress\n\n            if (isCreateMode) {\n              const result = await createHomeAddressMutation.mutateAsync({\n                request: {\n                  employeeId: resolvedEmployeeId,\n                  requestBody: {\n                    street1: payload.street1,\n                    street2: payload.street2 || undefined,\n                    city: payload.city,\n                    state: payload.state,\n                    zip: payload.zip,\n                    courtesyWithholding: payload.courtesyWithholding,\n                    effectiveDate: effectiveDateParam,\n                  },\n                },\n              })\n\n              if (!result.employeeAddress) {\n                throw new SDKInternalError('Home address creation failed')\n              }\n\n              updatedHomeAddress = result.employeeAddress\n            } else {\n              if (!fetchedHomeAddress || !homeAddressUuid) {\n                throw new SDKInternalError(\n                  'Cannot update home address: no matching address on file',\n                )\n              }\n\n              const result = await updateHomeAddressMutation.mutateAsync({\n                request: {\n                  homeAddressUuid: fetchedHomeAddress.uuid,\n                  requestBody: {\n                    version: fetchedHomeAddress.version,\n                    street1: payload.street1,\n                    street2: payload.street2 || undefined,\n                    city: payload.city,\n                    state: payload.state,\n                    zip: payload.zip,\n                    courtesyWithholding: payload.courtesyWithholding,\n                    effectiveDate: effectiveDateParam,\n                  },\n                },\n              })\n\n              if (!result.employeeAddress) {\n                throw new SDKInternalError('Home address update failed')\n              }\n\n              updatedHomeAddress = result.employeeAddress\n            }\n\n            submitResult = {\n              mode: isCreateMode ? 'create' : 'update',\n              data: updatedHomeAddress,\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 (homeAddressUuid && !fetchedHomeAddress) {\n    return { isLoading: true as const, errorHandling }\n  }\n\n  return {\n    isLoading: false as const,\n    data: {\n      homeAddress: fetchedHomeAddress ?? null,\n    },\n    status: {\n      isPending,\n      mode: isCreateMode ? ('create' as const) : ('update' as const),\n    },\n    actions: { onSubmit },\n    errorHandling,\n    form: {\n      Fields: {\n        Street1: Street1Field,\n        Street2: Street2Field,\n        City: CityField,\n        State: StateField,\n        Zip: ZipField,\n        CourtesyWithholding: CourtesyWithholdingField,\n        EffectiveDate: withEffectiveDateField ? EffectiveDateField : undefined,\n      },\n      fieldsMetadata,\n      hookFormInternals,\n      getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n    },\n  }\n}\n\n/**\n * Discriminated union returned by {@link useHomeAddressForm}.\n *\n * @public\n */\nexport type UseHomeAddressFormResult = HookLoadingResult | UseHomeAddressFormReady\n/**\n * Type of `form.fieldsMetadata` returned by {@link useHomeAddressForm}.\n *\n * @public\n */\nexport type HomeAddressFieldsMetadata = ReturnType<typeof buildHomeAddressFieldsMetadata>\n"],"names":["buildHomeAddressFieldsMetadata","base","stateOptions","withOptions","STATES_ABBR","useHomeAddressForm","employeeId","homeAddressUuid","initialAddress","withEffectiveDateField","optionalFieldsToRequire","partnerDefaults","validationMode","shouldFocusError","hasInitialAddressMatch","retrieveHomeAddressQuery","useEmployeeAddressesRetrieveHomeAddress","isCreateMode","fetchedHomeAddress","schemaMode","schema","metadataConfig","useMemo","createHomeAddressSchema","resolvedDefaults","formMethods","useForm","zodResolver","createHomeAddressMutation","useEmployeeAddressesCreateMutation","updateHomeAddressMutation","useEmployeeAddressesUpdateMutation","isPending","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","abbr","baseMetadata","useDeriveFieldsMetadata","fieldsMetadata","onSubmit","options","submitResult","resolve","data","payload","resolvedEmployeeId","resolvedEffectiveDate","effectiveDateParam","RFCDate","updatedHomeAddress","result","SDKInternalError","hookFormInternals","useHookFormInternals","Street1Field","Street2Field","CityField","StateField","ZipField","CourtesyWithholdingField","EffectiveDateField","createGetFormSubmissionValues"],"mappings":"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"}

package/dist/components/Employee/Profile/shared/useWorkAddressForm/fields.d.ts

@@ -1,4 +1,4 @@
-import { Location } from '@gusto/embedded-api-v-2025-11-15/models/components/location';
+import { Location } from '@gusto/embedded-api/models/components/location';
 import { WorkAddressErrorCodes } from './workAddressSchema';
 import { SelectHookFieldProps } from '../../../../../partner-hook-utils/form/fields/SelectHookField';
 import { DatePickerHookFieldProps } from '../../../../../partner-hook-utils/form/fields/DatePickerHookField';
@@ -19,18 +19,7 @@ export type RequiredValidation = typeof WorkAddressErrorCodes.REQUIRED;
  * @public
  */
 export type LocationFieldProps = HookFieldProps<SelectHookFieldProps<RequiredValidation, Location>>;
-/**
- * Select bound to the `locationUuid` field of {@link useWorkAddressForm}.
- *
- * @remarks
- * Available on the hook result as `form.Fields.Location`. Options are the
- * company's active locations; the hook populates them from the locations
- * query. Required.
- *
- * @param props - {@link LocationFieldProps} — accepts the standard hook field props plus `getOptionLabel` to format location display names.
- * @returns The rendered select bound to `locationUuid`.
- * @public
- */
+/** @internal */
 export declare function LocationField(props: LocationFieldProps): import("react").JSX.Element;
 /**
  * Props accepted by {@link useWorkAddressForm}'s `Fields.EffectiveDate` component.
@@ -38,16 +27,5 @@ export declare function LocationField(props: LocationFieldProps): import("react"
  * @public
  */
 export type EffectiveDateFieldProps = HookFieldProps<DatePickerHookFieldProps<RequiredValidation>>;
-/**
- * Date picker bound to the `effectiveDate` field of {@link useWorkAddressForm}.
- *
- * @remarks
- * Available on the hook result as `form.Fields.EffectiveDate` when
- * `withEffectiveDateField` is `true`; `undefined` otherwise. Always
- * null-check before rendering.
- *
- * @param props - {@link EffectiveDateFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).
- * @returns The rendered date picker bound to `effectiveDate`.
- * @public
- */
+/** @internal */
 export declare function EffectiveDateField(props: EffectiveDateFieldProps): import("react").JSX.Element;

package/dist/components/Employee/Profile/shared/useWorkAddressForm/fields.js

@@ -1,11 +1,11 @@
 import { jsx as o } from "react/jsx-runtime";
-import { SelectHookField as t } from "../../../../../partner-hook-utils/form/fields/SelectHookField.js";
-import { DatePickerHookField as i } from "../../../../../partner-hook-utils/form/fields/DatePickerHookField.js";
+import { DatePickerHookField as t } from "../../../../../partner-hook-utils/form/fields/DatePickerHookField.js";
+import { SelectHookField as i } from "../../../../../partner-hook-utils/form/fields/SelectHookField.js";
 function c(e) {
-  return /* @__PURE__ */ o(t, { ...e, name: "locationUuid" });
+  return /* @__PURE__ */ o(i, { ...e, name: "locationUuid" });
 }
 function m(e) {
-  return /* @__PURE__ */ o(i, { ...e, name: "effectiveDate" });
+  return /* @__PURE__ */ o(t, { ...e, name: "effectiveDate" });
 }
 export {
   m as EffectiveDateField,

package/dist/components/Employee/Profile/shared/useWorkAddressForm/fields.js.map

@@ -1 +1 @@
-{"version":3,"file":"fields.js","sources":["../../../../../../src/components/Employee/Profile/shared/useWorkAddressForm/fields.tsx"],"sourcesContent":["import type { Location } from '@gusto/embedded-api-v-2025-11-15/models/components/location'\nimport type { WorkAddressErrorCodes } from './workAddressSchema'\nimport type { SelectHookFieldProps } from '@/partner-hook-utils/form/fields/SelectHookField'\nimport type { DatePickerHookFieldProps } from '@/partner-hook-utils/form/fields/DatePickerHookField'\nimport { SelectHookField, DatePickerHookField } from '@/partner-hook-utils/form/fields'\nimport type { HookFieldProps } from '@/partner-hook-utils/types'\n\n/**\n * The required-field error code produced by {@link useWorkAddressForm} fields that only emit `REQUIRED`.\n *\n * @remarks\n * Used as the `validationMessages` key for the location and effective date fields.\n * See `WorkAddressErrorCodes`.\n *\n * @public\n */\nexport type RequiredValidation = typeof WorkAddressErrorCodes.REQUIRED\n\n/**\n * Props accepted by {@link useWorkAddressForm}'s `Fields.Location` component.\n *\n * @public\n */\nexport type LocationFieldProps = HookFieldProps<SelectHookFieldProps<RequiredValidation, Location>>\n\n/**\n * Select bound to the `locationUuid` field of {@link useWorkAddressForm}.\n *\n * @remarks\n * Available on the hook result as `form.Fields.Location`. Options are the\n * company's active locations; the hook populates them from the locations\n * query. Required.\n *\n * @param props - {@link LocationFieldProps} — accepts the standard hook field props plus `getOptionLabel` to format location display names.\n * @returns The rendered select bound to `locationUuid`.\n * @public\n */\nexport function LocationField(props: LocationFieldProps) {\n  return <SelectHookField {...props} name=\"locationUuid\" />\n}\n\n/**\n * Props accepted by {@link useWorkAddressForm}'s `Fields.EffectiveDate` component.\n *\n * @public\n */\nexport type EffectiveDateFieldProps = HookFieldProps<DatePickerHookFieldProps<RequiredValidation>>\n\n/**\n * Date picker bound to the `effectiveDate` field of {@link useWorkAddressForm}.\n *\n * @remarks\n * Available on the hook result as `form.Fields.EffectiveDate` when\n * `withEffectiveDateField` is `true`; `undefined` otherwise. Always\n * null-check before rendering.\n *\n * @param props - {@link EffectiveDateFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).\n * @returns The rendered date picker bound to `effectiveDate`.\n * @public\n */\nexport function EffectiveDateField(props: EffectiveDateFieldProps) {\n  return <DatePickerHookField {...props} name=\"effectiveDate\" />\n}\n"],"names":["LocationField","props","jsx","SelectHookField","EffectiveDateField","DatePickerHookField"],"mappings":";;;AAqCO,SAASA,EAAcC,GAA2B;AACvD,SAAO,gBAAAC,EAACC,GAAA,EAAiB,GAAGF,GAAO,MAAK,gBAAe;AACzD;AAqBO,SAASG,EAAmBH,GAAgC;AACjE,SAAO,gBAAAC,EAACG,GAAA,EAAqB,GAAGJ,GAAO,MAAK,iBAAgB;AAC9D;"}
+{"version":3,"file":"fields.js","sources":["../../../../../../src/components/Employee/Profile/shared/useWorkAddressForm/fields.tsx"],"sourcesContent":["import type { Location } from '@gusto/embedded-api/models/components/location'\nimport type { WorkAddressErrorCodes } from './workAddressSchema'\nimport type { SelectHookFieldProps } from '@/partner-hook-utils/form/fields/SelectHookField'\nimport type { DatePickerHookFieldProps } from '@/partner-hook-utils/form/fields/DatePickerHookField'\nimport { SelectHookField, DatePickerHookField } from '@/partner-hook-utils/form/fields'\nimport type { HookFieldProps } from '@/partner-hook-utils/types'\n\n/**\n * The required-field error code produced by {@link useWorkAddressForm} fields that only emit `REQUIRED`.\n *\n * @remarks\n * Used as the `validationMessages` key for the location and effective date fields.\n * See `WorkAddressErrorCodes`.\n *\n * @public\n */\nexport type RequiredValidation = typeof WorkAddressErrorCodes.REQUIRED\n\n/**\n * Props accepted by {@link useWorkAddressForm}'s `Fields.Location` component.\n *\n * @public\n */\nexport type LocationFieldProps = HookFieldProps<SelectHookFieldProps<RequiredValidation, Location>>\n\n/** @internal */\nexport function LocationField(props: LocationFieldProps) {\n  return <SelectHookField {...props} name=\"locationUuid\" />\n}\n\n/**\n * Props accepted by {@link useWorkAddressForm}'s `Fields.EffectiveDate` component.\n *\n * @public\n */\nexport type EffectiveDateFieldProps = HookFieldProps<DatePickerHookFieldProps<RequiredValidation>>\n\n/** @internal */\nexport function EffectiveDateField(props: EffectiveDateFieldProps) {\n  return <DatePickerHookField {...props} name=\"effectiveDate\" />\n}\n"],"names":["LocationField","props","jsx","SelectHookField","EffectiveDateField","DatePickerHookField"],"mappings":";;;AA0BO,SAASA,EAAcC,GAA2B;AACvD,SAAO,gBAAAC,EAACC,GAAA,EAAiB,GAAGF,GAAO,MAAK,gBAAe;AACzD;AAUO,SAASG,EAAmBH,GAAgC;AACjE,SAAO,gBAAAC,EAACG,GAAA,EAAqB,GAAGJ,GAAO,MAAK,iBAAgB;AAC9D;"}

package/dist/components/Employee/Profile/shared/useWorkAddressForm/index.d.ts

@@ -1,8 +1,6 @@
-import "./types/i18next.d.ts"
 export { useWorkAddressForm } from './useWorkAddressForm';
 export { useCurrentWorkAddressForm } from './useCurrentWorkAddressForm';
 export type { UseCurrentWorkAddressFormProps } from './useCurrentWorkAddressForm';
-export type { WorkAddressSubmitCallbacks, WorkAddressSubmitOptions, WorkAddressOptionalFieldsToRequire, UseWorkAddressFormProps, UseWorkAddressFormResult, UseWorkAddressFormReady, WorkAddressFieldsMetadata, WorkAddressFormFields, WorkAddressFields, } from './useWorkAddressForm';
-export { createWorkAddressSchema, WorkAddressErrorCodes, type WorkAddressErrorCode, type WorkAddressFormData, type WorkAddressFormOutputs, type WorkAddressField, } from './workAddressSchema';
-export { LocationField, EffectiveDateField } from './fields';
+export type { WorkAddressSubmitCallbacks, WorkAddressSubmitOptions, WorkAddressOptionalFieldsToRequire, UseWorkAddressFormProps, UseWorkAddressFormResult, UseWorkAddressFormReady, WorkAddressFieldsMetadata, WorkAddressFormFields, } from './useWorkAddressForm';
+export { WorkAddressErrorCodes, type WorkAddressErrorCode, type WorkAddressFormData, type WorkAddressField, } from './workAddressSchema';
 export type { RequiredValidation as WorkAddressRequiredValidation, LocationFieldProps, EffectiveDateFieldProps, } from './fields';

package/dist/components/Employee/Profile/shared/useWorkAddressForm/useCurrentWorkAddressForm.js

@@ -1,4 +1,4 @@
-import { useEmployeeAddressesGetWorkAddresses as a } from "@gusto/embedded-api-v-2025-11-15/react-query/employeeAddressesGetWorkAddresses";
+import { useEmployeeAddressesGetWorkAddresses as a } from "@gusto/embedded-api/react-query/employeeAddressesGetWorkAddresses";
 import { useWorkAddressForm as u } from "./useWorkAddressForm.js";
 import { composeErrorHandler as s } from "../../../../../partner-hook-utils/composeErrorHandler.js";
 function p(d) {

package/dist/components/Employee/Profile/shared/useWorkAddressForm/useCurrentWorkAddressForm.js.map

@@ -1 +1 @@
-{"version":3,"file":"useCurrentWorkAddressForm.js","sources":["../../../../../../src/components/Employee/Profile/shared/useWorkAddressForm/useCurrentWorkAddressForm.tsx"],"sourcesContent":["import { useEmployeeAddressesGetWorkAddresses } from '@gusto/embedded-api-v-2025-11-15/react-query/employeeAddressesGetWorkAddresses'\nimport { useWorkAddressForm } from './useWorkAddressForm'\nimport type { UseWorkAddressFormProps, UseWorkAddressFormResult } from './useWorkAddressForm'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\n\n/**\n * Options for {@link useCurrentWorkAddressForm}.\n *\n * @remarks\n * Same shape as {@link UseWorkAddressFormProps} minus `workAddressUuid` —\n * the hook resolves the current work address itself.\n *\n * @public\n */\nexport type UseCurrentWorkAddressFormProps = Omit<UseWorkAddressFormProps, 'workAddressUuid'>\n\n/**\n * Convenience wrapper around {@link useWorkAddressForm} that auto-resolves the employee's current work address.\n *\n * @remarks\n * Lists the employee's work addresses and selects the active one (or the\n * first when none are active) as the row to edit. When the employee has no\n * work address on file the hook operates in create mode. The returned shape\n * is identical to {@link useWorkAddressForm}, so the same `Fields`,\n * `actions.onSubmit`, and `errorHandling` apply.\n *\n * @param props - See {@link UseCurrentWorkAddressFormProps}.\n * @returns A {@link HookLoadingResult} while loading, or a {@link UseWorkAddressFormReady} once ready.\n * @public\n *\n * @example\n * ```tsx\n * import { useCurrentWorkAddressForm } from '@gusto/embedded-react-sdk'\n *\n * function WorkAddressEditor({ employeeId, companyId }: { employeeId: string; companyId: string }) {\n *   const workAddress = useCurrentWorkAddressForm({ employeeId, companyId })\n *\n *   if (workAddress.isLoading) return <div>Loading...</div>\n *\n *   const { Fields } = workAddress.form\n *   return (\n *     <form onSubmit={e => { e.preventDefault(); void workAddress.actions.onSubmit() }}>\n *       <Fields.Location label=\"Work location\" />\n *       <button type=\"submit\">Save</button>\n *     </form>\n *   )\n * }\n * ```\n */\nexport function useCurrentWorkAddressForm(\n  props: UseCurrentWorkAddressFormProps,\n): UseWorkAddressFormResult {\n  const { employeeId, ...rest } = props\n\n  const listQuery = useEmployeeAddressesGetWorkAddresses({ employeeId }, { enabled: !!employeeId })\n\n  const workAddresses = listQuery.data?.employeeWorkAddressesList\n  const currentWorkAddress = workAddresses?.find(w => w.active) ?? workAddresses?.[0]\n\n  const base = useWorkAddressForm({\n    ...rest,\n    employeeId,\n    workAddressUuid: currentWorkAddress?.uuid,\n  })\n\n  const listInitiallyBlocking = listQuery.isLoading && !listQuery.data\n\n  if (listInitiallyBlocking) {\n    return {\n      isLoading: true as const,\n      errorHandling: composeErrorHandler([listQuery]),\n    }\n  }\n\n  if (base.isLoading) {\n    return {\n      ...base,\n      errorHandling: composeErrorHandler([listQuery, { errorHandling: base.errorHandling }]),\n    }\n  }\n\n  return {\n    ...base,\n    errorHandling: composeErrorHandler([listQuery, { errorHandling: base.errorHandling }]),\n  }\n}\n"],"names":["useCurrentWorkAddressForm","props","employeeId","rest","listQuery","useEmployeeAddressesGetWorkAddresses","workAddresses","currentWorkAddress","w","base","useWorkAddressForm","composeErrorHandler"],"mappings":";;;AAiDO,SAASA,EACdC,GAC0B;AAC1B,QAAM,EAAE,YAAAC,GAAY,GAAGC,EAAA,IAASF,GAE1BG,IAAYC,EAAqC,EAAE,YAAAH,EAAA,GAAc,EAAE,SAAS,CAAC,CAACA,GAAY,GAE1FI,IAAgBF,EAAU,MAAM,2BAChCG,IAAqBD,GAAe,KAAK,CAAAE,MAAKA,EAAE,MAAM,KAAKF,IAAgB,CAAC,GAE5EG,IAAOC,EAAmB;AAAA,IAC9B,GAAGP;AAAA,IACH,YAAAD;AAAA,IACA,iBAAiBK,GAAoB;AAAA,EAAA,CACtC;AAID,SAF8BH,EAAU,aAAa,CAACA,EAAU,OAGvD;AAAA,IACL,WAAW;AAAA,IACX,eAAeO,EAAoB,CAACP,CAAS,CAAC;AAAA,EAAA,IAI9CK,EAAK,YACA;AAAA,IACL,GAAGA;AAAA,IACH,eAAeE,EAAoB,CAACP,GAAW,EAAE,eAAeK,EAAK,eAAe,CAAC;AAAA,EAAA,IAIlF;AAAA,IACL,GAAGA;AAAA,IACH,eAAeE,EAAoB,CAACP,GAAW,EAAE,eAAeK,EAAK,eAAe,CAAC;AAAA,EAAA;AAEzF;"}
+{"version":3,"file":"useCurrentWorkAddressForm.js","sources":["../../../../../../src/components/Employee/Profile/shared/useWorkAddressForm/useCurrentWorkAddressForm.tsx"],"sourcesContent":["import { useEmployeeAddressesGetWorkAddresses } from '@gusto/embedded-api/react-query/employeeAddressesGetWorkAddresses'\nimport { useWorkAddressForm } from './useWorkAddressForm'\nimport type { UseWorkAddressFormProps, UseWorkAddressFormResult } from './useWorkAddressForm'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\n\n/**\n * Options for {@link useCurrentWorkAddressForm}.\n *\n * @remarks\n * Same shape as {@link UseWorkAddressFormProps} minus `workAddressUuid` —\n * the hook resolves the current work address itself.\n *\n * @public\n */\nexport type UseCurrentWorkAddressFormProps = Omit<UseWorkAddressFormProps, 'workAddressUuid'>\n\n/**\n * Convenience wrapper around {@link useWorkAddressForm} that auto-resolves the employee's current work address.\n *\n * @remarks\n * Lists the employee's work addresses and selects the active one (or the\n * first when none are active) as the row to edit. When the employee has no\n * work address on file the hook operates in create mode. The returned shape\n * is identical to {@link useWorkAddressForm}, so the same `Fields`,\n * `actions.onSubmit`, and `errorHandling` apply.\n *\n * @param props - See {@link UseCurrentWorkAddressFormProps}.\n * @returns A {@link HookLoadingResult} while loading, or a {@link UseWorkAddressFormReady} once ready.\n * @public\n *\n * @example\n * ```tsx\n * import { useCurrentWorkAddressForm } from '@gusto/embedded-react-sdk'\n *\n * function WorkAddressEditor({ employeeId, companyId }: { employeeId: string; companyId: string }) {\n *   const workAddress = useCurrentWorkAddressForm({ employeeId, companyId })\n *\n *   if (workAddress.isLoading) return <div>Loading...</div>\n *\n *   const { Fields } = workAddress.form\n *   return (\n *     <form onSubmit={e => { e.preventDefault(); void workAddress.actions.onSubmit() }}>\n *       <Fields.Location label=\"Work location\" />\n *       <button type=\"submit\">Save</button>\n *     </form>\n *   )\n * }\n * ```\n */\nexport function useCurrentWorkAddressForm(\n  props: UseCurrentWorkAddressFormProps,\n): UseWorkAddressFormResult {\n  const { employeeId, ...rest } = props\n\n  const listQuery = useEmployeeAddressesGetWorkAddresses({ employeeId }, { enabled: !!employeeId })\n\n  const workAddresses = listQuery.data?.employeeWorkAddressesList\n  const currentWorkAddress = workAddresses?.find(w => w.active) ?? workAddresses?.[0]\n\n  const base = useWorkAddressForm({\n    ...rest,\n    employeeId,\n    workAddressUuid: currentWorkAddress?.uuid,\n  })\n\n  const listInitiallyBlocking = listQuery.isLoading && !listQuery.data\n\n  if (listInitiallyBlocking) {\n    return {\n      isLoading: true as const,\n      errorHandling: composeErrorHandler([listQuery]),\n    }\n  }\n\n  if (base.isLoading) {\n    return {\n      ...base,\n      errorHandling: composeErrorHandler([listQuery, { errorHandling: base.errorHandling }]),\n    }\n  }\n\n  return {\n    ...base,\n    errorHandling: composeErrorHandler([listQuery, { errorHandling: base.errorHandling }]),\n  }\n}\n"],"names":["useCurrentWorkAddressForm","props","employeeId","rest","listQuery","useEmployeeAddressesGetWorkAddresses","workAddresses","currentWorkAddress","w","base","useWorkAddressForm","composeErrorHandler"],"mappings":";;;AAiDO,SAASA,EACdC,GAC0B;AAC1B,QAAM,EAAE,YAAAC,GAAY,GAAGC,EAAA,IAASF,GAE1BG,IAAYC,EAAqC,EAAE,YAAAH,EAAA,GAAc,EAAE,SAAS,CAAC,CAACA,GAAY,GAE1FI,IAAgBF,EAAU,MAAM,2BAChCG,IAAqBD,GAAe,KAAK,CAAAE,MAAKA,EAAE,MAAM,KAAKF,IAAgB,CAAC,GAE5EG,IAAOC,EAAmB;AAAA,IAC9B,GAAGP;AAAA,IACH,YAAAD;AAAA,IACA,iBAAiBK,GAAoB;AAAA,EAAA,CACtC;AAID,SAF8BH,EAAU,aAAa,CAACA,EAAU,OAGvD;AAAA,IACL,WAAW;AAAA,IACX,eAAeO,EAAoB,CAACP,CAAS,CAAC;AAAA,EAAA,IAI9CK,EAAK,YACA;AAAA,IACL,GAAGA;AAAA,IACH,eAAeE,EAAoB,CAACP,GAAW,EAAE,eAAeK,EAAK,eAAe,CAAC;AAAA,EAAA,IAIlF;AAAA,IACL,GAAGA;AAAA,IACH,eAAeE,EAAoB,CAACP,GAAW,EAAE,eAAeK,EAAK,eAAe,CAAC;AAAA,EAAA;AAEzF;"}

package/dist/components/Employee/Profile/shared/useWorkAddressForm/useWorkAddressForm.d.ts

@@ -1,9 +1,10 @@
+import { ComponentType } from 'react';
 import { UseFormProps } from 'react-hook-form';
-import { Location } from '@gusto/embedded-api-v-2025-11-15/models/components/location';
-import { EmployeeWorkAddress } from '@gusto/embedded-api-v-2025-11-15/models/components/employeeworkaddress';
+import { Location } from '@gusto/embedded-api/models/components/location';
+import { EmployeeWorkAddress } from '@gusto/embedded-api/models/components/employeeworkaddress';
 import { WorkAddressOptionalFieldsToRequire, WorkAddressFormData } from './workAddressSchema';
-import { LocationField, EffectiveDateField } from './fields';
-import { BaseFormHookReady, FieldsMetadata, HookLoadingResult, HookSubmitResult } from '../../../../../partner-hook-utils/types';
+import { LocationFieldProps, EffectiveDateFieldProps } from './fields';
+import { BaseFormHookReady, FieldMetadata, HookLoadingResult, HookSubmitResult } from '../../../../../partner-hook-utils/types';
 export type { WorkAddressOptionalFieldsToRequire } from './workAddressSchema';
 /**
  * Optional callbacks passed to {@link UseWorkAddressFormReady.actions.onSubmit | onSubmit}.
@@ -76,11 +77,11 @@ export interface UseWorkAddressFormProps {
  *
  * @public
  */
-export interface WorkAddressFields {
-    /** Location selector. Always available. */
-    Location: typeof LocationField;
-    /** Effective-date picker. Only available when `withEffectiveDateField` is `true`. */
-    EffectiveDate: typeof EffectiveDateField | undefined;
+export interface WorkAddressFormFields {
+    /** Bound to `locationUuid`. Location selector. Always available. */
+    Location: ComponentType<LocationFieldProps>;
+    /** Bound to `effectiveDate`. Effective-date picker. Only available when `withEffectiveDateField` is `true`. */
+    EffectiveDate: ComponentType<EffectiveDateFieldProps> | undefined;
 }
 /**
  * Ready-state shape returned by {@link useWorkAddressForm} once data has loaded.
@@ -91,7 +92,7 @@ export interface WorkAddressFields {
  *
  * @public
  */
-export interface UseWorkAddressFormReady extends BaseFormHookReady<FieldsMetadata, WorkAddressFormData, WorkAddressFields> {
+export interface UseWorkAddressFormReady extends BaseFormHookReady<WorkAddressFieldsMetadata, WorkAddressFormData, WorkAddressFormFields> {
     /** Static entity data resolved from the API. */
     data: {
         /** The address row loaded for update; `null` in create mode. */
@@ -164,10 +165,4 @@ export type UseWorkAddressFormResult = HookLoadingResult | UseWorkAddressFormRea
  *
  * @public
  */
-export type WorkAddressFieldsMetadata = UseWorkAddressFormReady['form']['fieldsMetadata'];
-/**
- * Type of `form.Fields` returned by {@link useWorkAddressForm}.
- *
- * @public
- */
-export type WorkAddressFormFields = UseWorkAddressFormReady['form']['Fields'];
+export type WorkAddressFieldsMetadata = { locationUuid: import("../../../../../partner-hook-utils/types").FieldMetadataWithOptions<Location>; effectiveDate: FieldMetadata; };