@gusto/embedded-react-sdk 0.36.0 → 0.37.0-rc.2

package/dist/components/UNSTABLE_Hooks/hooks/useWorkAddressForm/WorkAddressForm.js

@@ -0,0 +1,69 @@
+import { jsx as e, jsxs as E } from "react/jsx-runtime";
+import { useTranslation as p } from "react-i18next";
+import { SDKFormProvider as u } from "../../form/SDKFormProvider.js";
+import { useWorkAddressForm as D } from "./useWorkAddressForm.js";
+import { useComponentContext as A } from "../../../../contexts/ComponentAdapter/useComponentContext.js";
+import { BaseBoundaries as R, BaseLayout as c } from "../../../Base/Base.js";
+import "../../../Base/useBase.js";
+import { Form as L } from "../../../Common/Form/Form.js";
+import { ActionsLayout as S } from "../../../Common/ActionsLayout/ActionsLayout.js";
+import { componentEvents as d } from "../../../../shared/constants.js";
+import { useI18n as W, useComponentDictionary as k } from "../../../../i18n/I18n.js";
+import { addressInline as U } from "../../../../helpers/formattedStrings.js";
+function g({ onEvent: i, dictionary: s, ...l }) {
+  W("UNSTABLE.WorkAddressForm"), k("UNSTABLE.WorkAddressForm", s);
+  const { t: o } = p("UNSTABLE.WorkAddressForm"), m = A(), r = D(l);
+  if (r.isLoading)
+    return /* @__PURE__ */ e(c, { isLoading: !0, error: r.errorHandling.errors });
+  const { Fields: n } = r.form, f = async () => {
+    const t = await r.actions.onSubmit({
+      onWorkAddressCreated: (a) => {
+        i(d.EMPLOYEE_WORK_ADDRESS_CREATED, a);
+      },
+      onWorkAddressUpdated: (a) => {
+        i(d.EMPLOYEE_WORK_ADDRESS_UPDATED, a);
+      }
+    });
+    t && i(d.EMPLOYEE_WORK_ADDRESS, t.data);
+  };
+  return /* @__PURE__ */ e(c, { error: r.errorHandling.errors, children: /* @__PURE__ */ e(u, { formHookResult: r, children: /* @__PURE__ */ E(
+    L,
+    {
+      onSubmit: (t) => {
+        t.preventDefault(), f();
+      },
+      children: [
+        /* @__PURE__ */ e(m.Heading, { as: "h2", children: r.status.mode === "create" ? o("addTitle") : o("editTitle") }),
+        /* @__PURE__ */ e(
+          n.Location,
+          {
+            label: o("locationLabel"),
+            description: o("locationDescription"),
+            getOptionLabel: (t) => U(t),
+            validationMessages: {
+              REQUIRED: o("fieldValidations.locationUuid.REQUIRED")
+            }
+          }
+        ),
+        n.EffectiveDate && /* @__PURE__ */ e(
+          n.EffectiveDate,
+          {
+            label: o("effectiveDateLabel"),
+            description: o("effectiveDateDescription"),
+            validationMessages: {
+              REQUIRED: o("fieldValidations.effectiveDate.REQUIRED")
+            }
+          }
+        ),
+        /* @__PURE__ */ e(S, { children: /* @__PURE__ */ e(m.Button, { type: "submit", isLoading: r.status.isPending, children: r.status.mode === "create" ? o("createCta") : o("updateCta") }) })
+      ]
+    }
+  ) }) });
+}
+function M({ FallbackComponent: i, ...s }) {
+  return /* @__PURE__ */ e(R, { componentName: "UNSTABLE.WorkAddressForm", FallbackComponent: i, children: /* @__PURE__ */ e(g, { ...s }) });
+}
+export {
+  M as WorkAddressForm
+};
+//# sourceMappingURL=WorkAddressForm.js.map

package/dist/components/UNSTABLE_Hooks/hooks/useWorkAddressForm/WorkAddressForm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkAddressForm.js","sources":["../../../../../src/components/UNSTABLE_Hooks/hooks/useWorkAddressForm/WorkAddressForm.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport { SDKFormProvider } from '../../form/SDKFormProvider'\nimport { useWorkAddressForm } from './useWorkAddressForm'\nimport type { UseWorkAddressFormProps } from './useWorkAddressForm'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { BaseBoundaries, BaseLayout, type BaseComponentInterface } from '@/components/Base'\nimport { Form } from '@/components/Common/Form'\nimport { ActionsLayout } from '@/components/Common'\nimport { componentEvents } from '@/shared/constants'\nimport { useComponentDictionary, useI18n } from '@/i18n'\nimport { addressInline } from '@/helpers/formattedStrings'\n\nexport interface WorkAddressFormProps\n  extends UseWorkAddressFormProps, Omit<BaseComponentInterface, 'defaultValues'> {}\n\nfunction WorkAddressFormRoot({ onEvent, dictionary, ...hookProps }: WorkAddressFormProps) {\n  useI18n('UNSTABLE.WorkAddressForm')\n  useComponentDictionary('UNSTABLE.WorkAddressForm', dictionary)\n  const { t } = useTranslation('UNSTABLE.WorkAddressForm')\n  const Components = useComponentContext()\n  const workAddress = useWorkAddressForm(hookProps)\n\n  if (workAddress.isLoading) {\n    return <BaseLayout isLoading error={workAddress.errorHandling.errors} />\n  }\n\n  const { Fields } = workAddress.form\n\n  const handleSubmit = async () => {\n    const result = await workAddress.actions.onSubmit({\n      onWorkAddressCreated: wa => {\n        onEvent(componentEvents.EMPLOYEE_WORK_ADDRESS_CREATED, wa)\n      },\n      onWorkAddressUpdated: wa => {\n        onEvent(componentEvents.EMPLOYEE_WORK_ADDRESS_UPDATED, wa)\n      },\n    })\n    if (result) {\n      onEvent(componentEvents.EMPLOYEE_WORK_ADDRESS, result.data)\n    }\n  }\n\n  return (\n    <BaseLayout error={workAddress.errorHandling.errors}>\n      <SDKFormProvider formHookResult={workAddress}>\n        <Form\n          onSubmit={e => {\n            e.preventDefault()\n            void handleSubmit()\n          }}\n        >\n          <Components.Heading as=\"h2\">\n            {workAddress.status.mode === 'create' ? t('addTitle') : t('editTitle')}\n          </Components.Heading>\n\n          <Fields.Location\n            label={t('locationLabel')}\n            description={t('locationDescription')}\n            getOptionLabel={location => addressInline(location)}\n            validationMessages={{\n              REQUIRED: t('fieldValidations.locationUuid.REQUIRED'),\n            }}\n          />\n\n          {Fields.EffectiveDate && (\n            <Fields.EffectiveDate\n              label={t('effectiveDateLabel')}\n              description={t('effectiveDateDescription')}\n              validationMessages={{\n                REQUIRED: t('fieldValidations.effectiveDate.REQUIRED'),\n              }}\n            />\n          )}\n\n          <ActionsLayout>\n            <Components.Button type=\"submit\" isLoading={workAddress.status.isPending}>\n              {workAddress.status.mode === 'create' ? t('createCta') : t('updateCta')}\n            </Components.Button>\n          </ActionsLayout>\n        </Form>\n      </SDKFormProvider>\n    </BaseLayout>\n  )\n}\n\nexport function WorkAddressForm({ FallbackComponent, ...props }: WorkAddressFormProps) {\n  return (\n    <BaseBoundaries componentName=\"UNSTABLE.WorkAddressForm\" FallbackComponent={FallbackComponent}>\n      <WorkAddressFormRoot {...props} />\n    </BaseBoundaries>\n  )\n}\n"],"names":["WorkAddressFormRoot","onEvent","dictionary","hookProps","useI18n","useComponentDictionary","t","useTranslation","Components","useComponentContext","workAddress","useWorkAddressForm","BaseLayout","Fields","handleSubmit","result","wa","componentEvents","jsx","SDKFormProvider","jsxs","Form","e","location","addressInline","ActionsLayout","WorkAddressForm","FallbackComponent","props","BaseBoundaries"],"mappings":";;;;;;;;;;;;AAeA,SAASA,EAAoB,EAAE,SAAAC,GAAS,YAAAC,GAAY,GAAGC,KAAmC;AACxF,EAAAC,EAAQ,0BAA0B,GAClCC,EAAuB,4BAA4BH,CAAU;AAC7D,QAAM,EAAE,GAAAI,EAAA,IAAMC,EAAe,0BAA0B,GACjDC,IAAaC,EAAA,GACbC,IAAcC,EAAmBR,CAAS;AAEhD,MAAIO,EAAY;AACd,6BAAQE,GAAA,EAAW,WAAS,IAAC,OAAOF,EAAY,cAAc,QAAQ;AAGxE,QAAM,EAAE,QAAAG,MAAWH,EAAY,MAEzBI,IAAe,YAAY;AAC/B,UAAMC,IAAS,MAAML,EAAY,QAAQ,SAAS;AAAA,MAChD,sBAAsB,CAAAM,MAAM;AAC1B,QAAAf,EAAQgB,EAAgB,+BAA+BD,CAAE;AAAA,MAC3D;AAAA,MACA,sBAAsB,CAAAA,MAAM;AAC1B,QAAAf,EAAQgB,EAAgB,+BAA+BD,CAAE;AAAA,MAC3D;AAAA,IAAA,CACD;AACD,IAAID,KACFd,EAAQgB,EAAgB,uBAAuBF,EAAO,IAAI;AAAA,EAE9D;AAEA,SACE,gBAAAG,EAACN,KAAW,OAAOF,EAAY,cAAc,QAC3C,UAAA,gBAAAQ,EAACC,GAAA,EAAgB,gBAAgBT,GAC/B,UAAA,gBAAAU;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,UAAU,CAAAC,MAAK;AACb,QAAAA,EAAE,eAAA,GACGR,EAAA;AAAA,MACP;AAAA,MAEA,UAAA;AAAA,QAAA,gBAAAI,EAACV,EAAW,SAAX,EAAmB,IAAG,MACpB,UAAAE,EAAY,OAAO,SAAS,WAAWJ,EAAE,UAAU,IAAIA,EAAE,WAAW,GACvE;AAAA,QAEA,gBAAAY;AAAA,UAACL,EAAO;AAAA,UAAP;AAAA,YACC,OAAOP,EAAE,eAAe;AAAA,YACxB,aAAaA,EAAE,qBAAqB;AAAA,YACpC,gBAAgB,CAAAiB,MAAYC,EAAcD,CAAQ;AAAA,YAClD,oBAAoB;AAAA,cAClB,UAAUjB,EAAE,wCAAwC;AAAA,YAAA;AAAA,UACtD;AAAA,QAAA;AAAA,QAGDO,EAAO,iBACN,gBAAAK;AAAA,UAACL,EAAO;AAAA,UAAP;AAAA,YACC,OAAOP,EAAE,oBAAoB;AAAA,YAC7B,aAAaA,EAAE,0BAA0B;AAAA,YACzC,oBAAoB;AAAA,cAClB,UAAUA,EAAE,yCAAyC;AAAA,YAAA;AAAA,UACvD;AAAA,QAAA;AAAA,QAIJ,gBAAAY,EAACO,KACC,UAAA,gBAAAP,EAACV,EAAW,QAAX,EAAkB,MAAK,UAAS,WAAWE,EAAY,OAAO,WAC5D,UAAAA,EAAY,OAAO,SAAS,WAAWJ,EAAE,WAAW,IAAIA,EAAE,WAAW,EAAA,CACxE,EAAA,CACF;AAAA,MAAA;AAAA,IAAA;AAAA,EAAA,GAEJ,EAAA,CACF;AAEJ;AAEO,SAASoB,EAAgB,EAAE,mBAAAC,GAAmB,GAAGC,KAA+B;AACrF,SACE,gBAAAV,EAACW,KAAe,eAAc,4BAA2B,mBAAAF,GACvD,UAAA,gBAAAT,EAAClB,GAAA,EAAqB,GAAG4B,EAAA,CAAO,EAAA,CAClC;AAEJ;"}

package/dist/components/UNSTABLE_Hooks/hooks/useWorkAddressForm/fields.d.ts

@@ -0,0 +1,10 @@
+import { Location } from '@gusto/embedded-api/models/components/location';
+import { HookFieldProps } from '../../form/types';
+import { SelectHookFieldProps } from '../../form/fields/SelectHookField';
+import { DatePickerHookFieldProps } from '../../form/fields/DatePickerHookField';
+import { WorkAddressErrorCodes } from './workAddressSchema';
+export type RequiredValidation = typeof WorkAddressErrorCodes.REQUIRED;
+export type LocationFieldProps = HookFieldProps<SelectHookFieldProps<RequiredValidation, Location>>;
+export declare function LocationField(props: LocationFieldProps): import("react/jsx-runtime").JSX.Element;
+export type EffectiveDateFieldProps = HookFieldProps<DatePickerHookFieldProps<RequiredValidation>>;
+export declare function EffectiveDateField(props: EffectiveDateFieldProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/UNSTABLE_Hooks/hooks/useWorkAddressForm/fields.js

@@ -0,0 +1,14 @@
+import { jsx as o } from "react/jsx-runtime";
+import { DatePickerHookField as t } from "../../form/fields/DatePickerHookField.js";
+import { SelectHookField as i } from "../../form/fields/SelectHookField.js";
+function c(e) {
+  return /* @__PURE__ */ o(i, { ...e, name: "locationUuid" });
+}
+function m(e) {
+  return /* @__PURE__ */ o(t, { ...e, name: "effectiveDate" });
+}
+export {
+  m as EffectiveDateField,
+  c as LocationField
+};
+//# sourceMappingURL=fields.js.map

package/dist/components/UNSTABLE_Hooks/hooks/useWorkAddressForm/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","sources":["../../../../../src/components/UNSTABLE_Hooks/hooks/useWorkAddressForm/fields.tsx"],"sourcesContent":["import type { Location } from '@gusto/embedded-api/models/components/location'\nimport type { HookFieldProps } from '../../form/types'\nimport type { SelectHookFieldProps } from '../../form/fields/SelectHookField'\nimport type { DatePickerHookFieldProps } from '../../form/fields/DatePickerHookField'\nimport { SelectHookField, DatePickerHookField } from '../../form/fields'\nimport type { WorkAddressErrorCodes } from './workAddressSchema'\n\nexport type RequiredValidation = typeof WorkAddressErrorCodes.REQUIRED\n\nexport type LocationFieldProps = HookFieldProps<SelectHookFieldProps<RequiredValidation, Location>>\n\nexport function LocationField(props: LocationFieldProps) {\n  return <SelectHookField {...props} name=\"locationUuid\" />\n}\n\nexport type EffectiveDateFieldProps = HookFieldProps<DatePickerHookFieldProps<RequiredValidation>>\n\nexport function EffectiveDateField(props: EffectiveDateFieldProps) {\n  return <DatePickerHookField {...props} name=\"effectiveDate\" />\n}\n"],"names":["LocationField","props","jsx","SelectHookField","EffectiveDateField","DatePickerHookField"],"mappings":";;;AAWO,SAASA,EAAcC,GAA2B;AACvD,SAAO,gBAAAC,EAACC,GAAA,EAAiB,GAAGF,GAAO,MAAK,gBAAe;AACzD;AAIO,SAASG,EAAmBH,GAAgC;AACjE,SAAO,gBAAAC,EAACG,GAAA,EAAqB,GAAGJ,GAAO,MAAK,iBAAgB;AAC9D;"}

package/dist/components/UNSTABLE_Hooks/hooks/useWorkAddressForm/index.d.ts

@@ -0,0 +1,7 @@
+import "./types/i18next.d.ts"
+export { useWorkAddressForm } from './useWorkAddressForm';
+export type { WorkAddressSubmitCallbacks, WorkAddressSubmitOptions, WorkAddressRequiredFields, UseWorkAddressFormProps, UseWorkAddressFormResult, UseWorkAddressFormReady, WorkAddressFieldsMetadata, WorkAddressFormFields, } from './useWorkAddressForm';
+export { WorkAddressForm } from './WorkAddressForm';
+export type { WorkAddressFormProps } from './WorkAddressForm';
+export { createWorkAddressSchema, WorkAddressErrorCodes, type WorkAddressErrorCode, type WorkAddressFormData, type WorkAddressFormOutputs, type WorkAddressField, } from './workAddressSchema';
+export type { RequiredValidation as WorkAddressRequiredValidation, LocationFieldProps, EffectiveDateFieldProps, } from './fields';

package/dist/components/UNSTABLE_Hooks/hooks/useWorkAddressForm/useWorkAddressForm.d.ts

@@ -0,0 +1,68 @@
+import { UseFormProps } from 'react-hook-form';
+import { Location } from '@gusto/embedded-api/models/components/location';
+import { EmployeeWorkAddress } from '@gusto/embedded-api/models/components/employeeworkaddress';
+import { HookSubmitResult } from '../../types';
+import { RequiredFields } from '../../form/resolveRequiredFields';
+import { WorkAddressFormData, WorkAddressField } from './workAddressSchema';
+import { LocationField, EffectiveDateField } from './fields';
+export type WorkAddressRequiredFields = RequiredFields<WorkAddressField>;
+export interface WorkAddressSubmitCallbacks {
+    onWorkAddressCreated?: (workAddress: EmployeeWorkAddress) => void;
+    onWorkAddressUpdated?: (workAddress: EmployeeWorkAddress) => void;
+}
+export interface WorkAddressSubmitOptions {
+    employeeId?: string;
+    effectiveDate?: string;
+}
+export interface UseWorkAddressFormProps {
+    companyId: string;
+    employeeId?: string;
+    withEffectiveDateField?: boolean;
+    requiredFields?: WorkAddressRequiredFields;
+    defaultValues?: Partial<WorkAddressFormData>;
+    validationMode?: UseFormProps['mode'];
+    shouldFocusError?: boolean;
+}
+export declare function useWorkAddressForm({ companyId, employeeId, withEffectiveDateField, requiredFields, defaultValues: partnerDefaults, validationMode, shouldFocusError, }: UseWorkAddressFormProps): {
+    isLoading: true;
+    errorHandling: import('../..').HookErrorHandling;
+    data?: undefined;
+    status?: undefined;
+    actions?: undefined;
+    form?: undefined;
+} | {
+    isLoading: false;
+    data: {
+        workAddress: EmployeeWorkAddress | null;
+        workAddresses: EmployeeWorkAddress[] | undefined;
+        companyLocations: Location[];
+    };
+    status: {
+        isPending: boolean;
+        mode: "create" | "update";
+    };
+    actions: {
+        onSubmit: (callbacks?: WorkAddressSubmitCallbacks, options?: WorkAddressSubmitOptions) => Promise<HookSubmitResult<EmployeeWorkAddress> | undefined>;
+    };
+    errorHandling: import('../..').HookErrorHandling;
+    form: {
+        Fields: {
+            Location: typeof LocationField;
+            EffectiveDate: typeof EffectiveDateField | undefined;
+        };
+        fieldsMetadata: {
+            locationUuid: import('../..').FieldMetadataWithOptions<Location>;
+            effectiveDate: import('../..').FieldMetadata;
+        };
+        hookFormInternals: {
+            formMethods: import('react-hook-form').UseFormReturn<WorkAddressFormData, unknown, WorkAddressFormData>;
+        };
+        getFormSubmissionValues: () => WorkAddressFormData | undefined;
+    };
+};
+export type UseWorkAddressFormResult = ReturnType<typeof useWorkAddressForm>;
+export type UseWorkAddressFormReady = Extract<UseWorkAddressFormResult, {
+    data: object;
+}>;
+export type WorkAddressFieldsMetadata = UseWorkAddressFormReady['form']['fieldsMetadata'];
+export type WorkAddressFormFields = UseWorkAddressFormReady['form']['Fields'];

package/dist/components/UNSTABLE_Hooks/hooks/useWorkAddressForm/useWorkAddressForm.js

@@ -0,0 +1,129 @@
+import { useForm as I } from "react-hook-form";
+import { zodResolver as O } from "@hookform/resolvers/zod";
+import { useLocationsGet as R } from "@gusto/embedded-api/react-query/locationsGet";
+import { useEmployeeAddressesGetWorkAddresses as Q } from "@gusto/embedded-api/react-query/employeeAddressesGetWorkAddresses";
+import { useEmployeeAddressesCreateWorkAddressMutation as x } from "@gusto/embedded-api/react-query/employeeAddressesCreateWorkAddress";
+import { useEmployeeAddressesUpdateWorkAddressMutation as z } from "@gusto/embedded-api/react-query/employeeAddressesUpdateWorkAddress";
+import { RFCDate as K } from "@gusto/embedded-api/types/rfcdate";
+import { useErrorHandling as j } from "../../useErrorHandling.js";
+import { deriveFieldsMetadata as J } from "../../form/deriveFieldsMetadata.js";
+import { createGetFormSubmissionValues as N } from "../../form/getFormSubmissionValues.js";
+import { withOptions as T } from "../../form/withOptions.js";
+import { createWorkAddressSchema as X } from "./workAddressSchema.js";
+import { EffectiveDateField as Y, LocationField as Z } from "./fields.js";
+import { useBaseSubmit as _ } from "../../../Base/useBaseSubmit.js";
+import { SDKInternalError as p } from "../../../../types/sdkError.js";
+import { addressInline as $ } from "../../../../helpers/formattedStrings.js";
+function we({
+  companyId: E,
+  employeeId: o,
+  withEffectiveDateField: u = !0,
+  requiredFields: F,
+  defaultValues: A,
+  validationMode: M = "onSubmit",
+  shouldFocusError: S = !0
+}) {
+  const d = R({ companyId: E }), m = Q(
+    { employeeId: o ?? "" },
+    { enabled: !!o }
+  ), a = d.data?.companyLocationsList, c = m.data?.employeeWorkAddressesList, t = c?.find((e) => e.active), s = !t, f = X({
+    mode: s ? "create" : "update",
+    requiredFields: F,
+    withEffectiveDateField: u
+  }), k = {
+    locationUuid: t?.locationUuid ?? A?.locationUuid ?? "",
+    effectiveDate: t?.effectiveDate ?? A?.effectiveDate ?? ""
+  }, l = I({
+    resolver: O(f),
+    mode: M,
+    shouldFocusError: S,
+    defaultValues: k,
+    values: k,
+    resetOptions: { keepDirtyValues: !0 }
+  }), v = x(), W = z(), h = v.isPending || W.isPending, { baseSubmitHandler: q, error: V, setError: C } = _("WorkAddressForm"), w = j(o ? [d, m] : [d], { error: V, setError: C }), P = (a ?? []).map((e) => ({
+    value: e.uuid,
+    label: $(e)
+  })), y = J(f), B = {
+    locationUuid: T(
+      y.locationUuid,
+      P,
+      a ?? []
+    ),
+    effectiveDate: y.effectiveDate
+  }, G = async (e, D) => {
+    let b;
+    return await new Promise((L) => {
+      l.handleSubmit(
+        async (H) => {
+          await q(H, async (n) => {
+            const g = D?.employeeId ?? o;
+            if (!g)
+              throw new p("employeeId is required to submit work address");
+            let r;
+            if (s) {
+              const i = u && n.effectiveDate ? n.effectiveDate : D?.effectiveDate, U = await v.mutateAsync({
+                request: {
+                  employeeId: g,
+                  requestBody: {
+                    locationUuid: n.locationUuid,
+                    effectiveDate: i ? new K(new Date(i)) : void 0
+                  }
+                }
+              });
+              if (!U.employeeWorkAddress)
+                throw new p("Work address creation failed");
+              r = U.employeeWorkAddress, e?.onWorkAddressCreated?.(r);
+            } else {
+              const i = await W.mutateAsync({
+                request: {
+                  workAddressUuid: t.uuid,
+                  requestBody: {
+                    version: t.version,
+                    locationUuid: n.locationUuid
+                  }
+                }
+              });
+              if (!i.employeeWorkAddress)
+                throw new p("Work address update failed");
+              r = i.employeeWorkAddress, e?.onWorkAddressUpdated?.(r);
+            }
+            b = {
+              mode: s ? "create" : "update",
+              data: r
+            };
+          }), L();
+        },
+        () => {
+          L();
+        }
+      )();
+    }), b;
+  };
+  return d.isLoading || (o ? m.isLoading : !1) || !a || o && !c ? { isLoading: !0, errorHandling: w } : {
+    isLoading: !1,
+    data: {
+      workAddress: t ?? null,
+      workAddresses: c,
+      companyLocations: a
+    },
+    status: {
+      isPending: h,
+      mode: s ? "create" : "update"
+    },
+    actions: { onSubmit: G },
+    errorHandling: w,
+    form: {
+      Fields: {
+        Location: Z,
+        EffectiveDate: u && s ? Y : void 0
+      },
+      fieldsMetadata: B,
+      hookFormInternals: { formMethods: l },
+      getFormSubmissionValues: N(l, f)
+    }
+  };
+}
+export {
+  we as useWorkAddressForm
+};
+//# sourceMappingURL=useWorkAddressForm.js.map

package/dist/components/UNSTABLE_Hooks/hooks/useWorkAddressForm/useWorkAddressForm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkAddressForm.js","sources":["../../../../../src/components/UNSTABLE_Hooks/hooks/useWorkAddressForm/useWorkAddressForm.tsx"],"sourcesContent":["import { useForm } from 'react-hook-form'\nimport type { UseFormProps } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport type { Location } from '@gusto/embedded-api/models/components/location'\nimport type { EmployeeWorkAddress } from '@gusto/embedded-api/models/components/employeeworkaddress'\nimport { useLocationsGet } from '@gusto/embedded-api/react-query/locationsGet'\nimport { useEmployeeAddressesGetWorkAddresses } from '@gusto/embedded-api/react-query/employeeAddressesGetWorkAddresses'\nimport { useEmployeeAddressesCreateWorkAddressMutation } from '@gusto/embedded-api/react-query/employeeAddressesCreateWorkAddress'\nimport { useEmployeeAddressesUpdateWorkAddressMutation } from '@gusto/embedded-api/react-query/employeeAddressesUpdateWorkAddress'\nimport { RFCDate } from '@gusto/embedded-api/types/rfcdate'\nimport type { HookSubmitResult } from '../../types'\nimport { useErrorHandling } from '../../useErrorHandling'\nimport { deriveFieldsMetadata } from '../../form/deriveFieldsMetadata'\nimport { createGetFormSubmissionValues } from '../../form/getFormSubmissionValues'\nimport { withOptions } from '../../form/withOptions'\nimport type { RequiredFields } from '../../form/resolveRequiredFields'\nimport {\n  createWorkAddressSchema,\n  type WorkAddressFormData,\n  type WorkAddressFormOutputs,\n  type WorkAddressField,\n} from './workAddressSchema'\nimport { LocationField, EffectiveDateField } from './fields'\nimport { useBaseSubmit } from '@/components/Base/useBaseSubmit'\nimport { SDKInternalError } from '@/types/sdkError'\nimport { addressInline } from '@/helpers/formattedStrings'\n\nexport type WorkAddressRequiredFields = RequiredFields<WorkAddressField>\n\nexport interface WorkAddressSubmitCallbacks {\n  onWorkAddressCreated?: (workAddress: EmployeeWorkAddress) => void\n  onWorkAddressUpdated?: (workAddress: EmployeeWorkAddress) => void\n}\n\nexport interface WorkAddressSubmitOptions {\n  employeeId?: string\n  effectiveDate?: string\n}\n\nexport interface UseWorkAddressFormProps {\n  companyId: string\n  employeeId?: string\n  withEffectiveDateField?: boolean\n  requiredFields?: WorkAddressRequiredFields\n  defaultValues?: Partial<WorkAddressFormData>\n  validationMode?: UseFormProps['mode']\n  shouldFocusError?: boolean\n}\n\nexport function useWorkAddressForm({\n  companyId,\n  employeeId,\n  withEffectiveDateField = true,\n  requiredFields,\n  defaultValues: partnerDefaults,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n}: UseWorkAddressFormProps) {\n  const locationsQuery = useLocationsGet({ companyId })\n  const workAddressesQuery = useEmployeeAddressesGetWorkAddresses(\n    { employeeId: employeeId ?? '' },\n    { enabled: !!employeeId },\n  )\n\n  const companyLocations = locationsQuery.data?.companyLocationsList\n  const workAddresses = workAddressesQuery.data?.employeeWorkAddressesList\n  const currentWorkAddress = workAddresses?.find(address => address.active)\n\n  const isCreateMode = !currentWorkAddress\n  const mode = isCreateMode ? 'create' : 'update'\n\n  const schema = createWorkAddressSchema({\n    mode,\n    requiredFields,\n    withEffectiveDateField,\n  })\n\n  const resolvedDefaults: WorkAddressFormData = {\n    locationUuid: currentWorkAddress?.locationUuid ?? partnerDefaults?.locationUuid ?? '',\n    effectiveDate: currentWorkAddress?.effectiveDate ?? partnerDefaults?.effectiveDate ?? '',\n  }\n\n  const formMethods = useForm<WorkAddressFormData, unknown, WorkAddressFormOutputs>({\n    resolver: zodResolver(schema),\n    mode: validationMode,\n    shouldFocusError,\n    defaultValues: resolvedDefaults,\n    values: resolvedDefaults,\n    resetOptions: { keepDirtyValues: true },\n  })\n\n  const createWorkAddressMutation = useEmployeeAddressesCreateWorkAddressMutation()\n  const updateWorkAddressMutation = useEmployeeAddressesUpdateWorkAddressMutation()\n\n  const isPending = createWorkAddressMutation.isPending || updateWorkAddressMutation.isPending\n\n  const { baseSubmitHandler, error: submitError, setError } = useBaseSubmit('WorkAddressForm')\n\n  const queries = employeeId ? [locationsQuery, workAddressesQuery] : [locationsQuery]\n  const errorHandling = useErrorHandling(queries, { error: submitError, setError })\n\n  const locationOptions = (companyLocations ?? []).map(location => ({\n    value: location.uuid,\n    label: addressInline(location),\n  }))\n\n  const baseMetadata = deriveFieldsMetadata(schema)\n  const fieldsMetadata = {\n    locationUuid: withOptions<Location>(\n      baseMetadata.locationUuid,\n      locationOptions,\n      companyLocations ?? [],\n    ),\n    effectiveDate: baseMetadata.effectiveDate,\n  }\n\n  const onSubmit = async (\n    callbacks?: WorkAddressSubmitCallbacks,\n    options?: WorkAddressSubmitOptions,\n  ): Promise<HookSubmitResult<EmployeeWorkAddress> | undefined> => {\n    let submitResult: HookSubmitResult<EmployeeWorkAddress> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: WorkAddressFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            const resolvedEmployeeId = options?.employeeId ?? employeeId\n\n            if (!resolvedEmployeeId) {\n              throw new SDKInternalError('employeeId is required to submit work address')\n            }\n\n            let updatedWorkAddress: EmployeeWorkAddress\n\n            if (isCreateMode) {\n              const resolvedEffectiveDate =\n                withEffectiveDateField && payload.effectiveDate\n                  ? payload.effectiveDate\n                  : options?.effectiveDate\n\n              const result = await createWorkAddressMutation.mutateAsync({\n                request: {\n                  employeeId: resolvedEmployeeId,\n                  requestBody: {\n                    locationUuid: payload.locationUuid,\n                    effectiveDate: resolvedEffectiveDate\n                      ? new RFCDate(new Date(resolvedEffectiveDate))\n                      : undefined,\n                  },\n                },\n              })\n\n              if (!result.employeeWorkAddress) {\n                throw new SDKInternalError('Work address creation failed')\n              }\n\n              updatedWorkAddress = result.employeeWorkAddress\n              callbacks?.onWorkAddressCreated?.(updatedWorkAddress)\n            } else {\n              const result = await updateWorkAddressMutation.mutateAsync({\n                request: {\n                  workAddressUuid: currentWorkAddress.uuid,\n                  requestBody: {\n                    version: currentWorkAddress.version,\n                    locationUuid: payload.locationUuid,\n                  },\n                },\n              })\n\n              if (!result.employeeWorkAddress) {\n                throw new SDKInternalError('Work address update failed')\n              }\n\n              updatedWorkAddress = result.employeeWorkAddress\n              callbacks?.onWorkAddressUpdated?.(updatedWorkAddress)\n            }\n\n            submitResult = {\n              mode: isCreateMode ? 'create' : 'update',\n              data: updatedWorkAddress,\n            }\n          })\n          resolve()\n        },\n        () => {\n          resolve()\n        },\n      )()\n    })\n\n    return submitResult\n  }\n\n  const isDataLoading =\n    locationsQuery.isLoading || (employeeId ? workAddressesQuery.isLoading : false)\n\n  if (isDataLoading || !companyLocations || (employeeId && !workAddresses)) {\n    return { isLoading: true as const, errorHandling }\n  }\n\n  return {\n    isLoading: false as const,\n    data: {\n      workAddress: currentWorkAddress ?? null,\n      workAddresses,\n      companyLocations,\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        Location: LocationField,\n        EffectiveDate: withEffectiveDateField && isCreateMode ? EffectiveDateField : undefined,\n      },\n      fieldsMetadata,\n      hookFormInternals: { formMethods },\n      getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n    },\n  }\n}\n\nexport type UseWorkAddressFormResult = ReturnType<typeof useWorkAddressForm>\nexport type UseWorkAddressFormReady = Extract<UseWorkAddressFormResult, { data: object }>\nexport type WorkAddressFieldsMetadata = UseWorkAddressFormReady['form']['fieldsMetadata']\nexport type WorkAddressFormFields = UseWorkAddressFormReady['form']['Fields']\n"],"names":["useWorkAddressForm","companyId","employeeId","withEffectiveDateField","requiredFields","partnerDefaults","validationMode","shouldFocusError","locationsQuery","useLocationsGet","workAddressesQuery","useEmployeeAddressesGetWorkAddresses","companyLocations","workAddresses","currentWorkAddress","address","isCreateMode","schema","createWorkAddressSchema","resolvedDefaults","formMethods","useForm","zodResolver","createWorkAddressMutation","useEmployeeAddressesCreateWorkAddressMutation","updateWorkAddressMutation","useEmployeeAddressesUpdateWorkAddressMutation","isPending","baseSubmitHandler","submitError","setError","useBaseSubmit","errorHandling","useErrorHandling","locationOptions","location","addressInline","baseMetadata","deriveFieldsMetadata","fieldsMetadata","withOptions","onSubmit","callbacks","options","submitResult","resolve","data","payload","resolvedEmployeeId","SDKInternalError","updatedWorkAddress","resolvedEffectiveDate","result","RFCDate","LocationField","EffectiveDateField","createGetFormSubmissionValues"],"mappings":";;;;;;;;;;;;;;;;AAiDO,SAASA,GAAmB;AAAA,EACjC,WAAAC;AAAA,EACA,YAAAC;AAAA,EACA,wBAAAC,IAAyB;AAAA,EACzB,gBAAAC;AAAA,EACA,eAAeC;AAAA,EACf,gBAAAC,IAAiB;AAAA,EACjB,kBAAAC,IAAmB;AACrB,GAA4B;AAC1B,QAAMC,IAAiBC,EAAgB,EAAE,WAAAR,GAAW,GAC9CS,IAAqBC;AAAA,IACzB,EAAE,YAAYT,KAAc,GAAA;AAAA,IAC5B,EAAE,SAAS,CAAC,CAACA,EAAA;AAAA,EAAW,GAGpBU,IAAmBJ,EAAe,MAAM,sBACxCK,IAAgBH,EAAmB,MAAM,2BACzCI,IAAqBD,GAAe,KAAK,CAAAE,MAAWA,EAAQ,MAAM,GAElEC,IAAe,CAACF,GAGhBG,IAASC,EAAwB;AAAA,IACrC,MAHWF,IAAe,WAAW;AAAA,IAIrC,gBAAAZ;AAAA,IACA,wBAAAD;AAAA,EAAA,CACD,GAEKgB,IAAwC;AAAA,IAC5C,cAAcL,GAAoB,gBAAgBT,GAAiB,gBAAgB;AAAA,IACnF,eAAeS,GAAoB,iBAAiBT,GAAiB,iBAAiB;AAAA,EAAA,GAGlFe,IAAcC,EAA8D;AAAA,IAChF,UAAUC,EAAYL,CAAM;AAAA,IAC5B,MAAMX;AAAA,IACN,kBAAAC;AAAA,IACA,eAAeY;AAAA,IACf,QAAQA;AAAA,IACR,cAAc,EAAE,iBAAiB,GAAA;AAAA,EAAK,CACvC,GAEKI,IAA4BC,EAAA,GAC5BC,IAA4BC,EAAA,GAE5BC,IAAYJ,EAA0B,aAAaE,EAA0B,WAE7E,EAAE,mBAAAG,GAAmB,OAAOC,GAAa,UAAAC,EAAA,IAAaC,EAAc,iBAAiB,GAGrFC,IAAgBC,EADN/B,IAAa,CAACM,GAAgBE,CAAkB,IAAI,CAACF,CAAc,GACnC,EAAE,OAAOqB,GAAa,UAAAC,GAAU,GAE1EI,KAAmBtB,KAAoB,CAAA,GAAI,IAAI,CAAAuB,OAAa;AAAA,IAChE,OAAOA,EAAS;AAAA,IAChB,OAAOC,EAAcD,CAAQ;AAAA,EAAA,EAC7B,GAEIE,IAAeC,EAAqBrB,CAAM,GAC1CsB,IAAiB;AAAA,IACrB,cAAcC;AAAA,MACZH,EAAa;AAAA,MACbH;AAAA,MACAtB,KAAoB,CAAA;AAAA,IAAC;AAAA,IAEvB,eAAeyB,EAAa;AAAA,EAAA,GAGxBI,IAAW,OACfC,GACAC,MAC+D;AAC/D,QAAIC;AAEJ,iBAAM,IAAI,QAAc,CAAAC,MAAW;AACjC,MAAKzB,EAAY;AAAA,QACf,OAAO0B,MAAiC;AACtC,gBAAMlB,EAAkBkB,GAAM,OAAMC,MAAW;AAC7C,kBAAMC,IAAqBL,GAAS,cAAczC;AAElD,gBAAI,CAAC8C;AACH,oBAAM,IAAIC,EAAiB,+CAA+C;AAG5E,gBAAIC;AAEJ,gBAAIlC,GAAc;AAChB,oBAAMmC,IACJhD,KAA0B4C,EAAQ,gBAC9BA,EAAQ,gBACRJ,GAAS,eAETS,IAAS,MAAM7B,EAA0B,YAAY;AAAA,gBACzD,SAAS;AAAA,kBACP,YAAYyB;AAAA,kBACZ,aAAa;AAAA,oBACX,cAAcD,EAAQ;AAAA,oBACtB,eAAeI,IACX,IAAIE,EAAQ,IAAI,KAAKF,CAAqB,CAAC,IAC3C;AAAA,kBAAA;AAAA,gBACN;AAAA,cACF,CACD;AAED,kBAAI,CAACC,EAAO;AACV,sBAAM,IAAIH,EAAiB,8BAA8B;AAG3D,cAAAC,IAAqBE,EAAO,qBAC5BV,GAAW,uBAAuBQ,CAAkB;AAAA,YACtD,OAAO;AACL,oBAAME,IAAS,MAAM3B,EAA0B,YAAY;AAAA,gBACzD,SAAS;AAAA,kBACP,iBAAiBX,EAAmB;AAAA,kBACpC,aAAa;AAAA,oBACX,SAASA,EAAmB;AAAA,oBAC5B,cAAciC,EAAQ;AAAA,kBAAA;AAAA,gBACxB;AAAA,cACF,CACD;AAED,kBAAI,CAACK,EAAO;AACV,sBAAM,IAAIH,EAAiB,4BAA4B;AAGzD,cAAAC,IAAqBE,EAAO,qBAC5BV,GAAW,uBAAuBQ,CAAkB;AAAA,YACtD;AAEA,YAAAN,IAAe;AAAA,cACb,MAAM5B,IAAe,WAAW;AAAA,cAChC,MAAMkC;AAAA,YAAA;AAAA,UAEV,CAAC,GACDL,EAAA;AAAA,QACF;AAAA,QACA,MAAM;AACJ,UAAAA,EAAA;AAAA,QACF;AAAA,MAAA,EACF;AAAA,IACF,CAAC,GAEMD;AAAA,EACT;AAKA,SAFEpC,EAAe,cAAcN,IAAaQ,EAAmB,YAAY,OAEtD,CAACE,KAAqBV,KAAc,CAACW,IACjD,EAAE,WAAW,IAAe,eAAAmB,EAAA,IAG9B;AAAA,IACL,WAAW;AAAA,IACX,MAAM;AAAA,MACJ,aAAalB,KAAsB;AAAA,MACnC,eAAAD;AAAA,MACA,kBAAAD;AAAA,IAAA;AAAA,IAEF,QAAQ;AAAA,MACN,WAAAe;AAAA,MACA,MAAMX,IAAgB,WAAsB;AAAA,IAAA;AAAA,IAE9C,SAAS,EAAE,UAAAyB,EAAA;AAAA,IACX,eAAAT;AAAA,IACA,MAAM;AAAA,MACJ,QAAQ;AAAA,QACN,UAAUsB;AAAA,QACV,eAAenD,KAA0Ba,IAAeuC,IAAqB;AAAA,MAAA;AAAA,MAE/E,gBAAAhB;AAAA,MACA,mBAAmB,EAAE,aAAAnB,EAAA;AAAA,MACrB,yBAAyBoC,EAA8BpC,GAAaH,CAAM;AAAA,IAAA;AAAA,EAC5E;AAEJ;"}

package/dist/components/UNSTABLE_Hooks/hooks/useWorkAddressForm/workAddressSchema.d.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import { RequiredFields } from '../../form/resolveRequiredFields';
+export declare const WorkAddressErrorCodes: {
+    readonly REQUIRED: "REQUIRED";
+};
+export type WorkAddressErrorCode = (typeof WorkAddressErrorCodes)[keyof typeof WorkAddressErrorCodes];
+declare const fieldValidators: {
+    locationUuid: z.ZodString;
+    effectiveDate: z.ZodISODate;
+};
+export type WorkAddressField = keyof typeof fieldValidators;
+export type WorkAddressFormData = {
+    [K in keyof typeof fieldValidators]: z.infer<(typeof fieldValidators)[K]>;
+};
+export type WorkAddressFormOutputs = WorkAddressFormData;
+interface WorkAddressSchemaOptions {
+    mode?: 'create' | 'update';
+    requiredFields?: RequiredFields<WorkAddressField>;
+    withEffectiveDateField?: boolean;
+}
+export declare function createWorkAddressSchema(options?: WorkAddressSchemaOptions): z.ZodObject<{
+    locationUuid: z.ZodString;
+    effectiveDate: z.ZodISODate;
+}, z.core.$strip>;
+export {};

package/dist/components/UNSTABLE_Hooks/hooks/useWorkAddressForm/workAddressSchema.js

@@ -0,0 +1,24 @@
+import { z as r } from "zod";
+import { composeFormSchema as c } from "../../form/composeFormSchema.js";
+import { filterRequiredFields as n } from "../../form/resolveRequiredFields.js";
+const t = {
+  REQUIRED: "REQUIRED"
+}, E = {
+  locationUuid: r.string().min(1, { message: t.REQUIRED }),
+  effectiveDate: r.iso.date({ error: () => t.REQUIRED })
+}, a = /* @__PURE__ */ new Set(["locationUuid"]), R = /* @__PURE__ */ new Set(["locationUuid"]);
+function l(i = {}) {
+  const { mode: o = "create", requiredFields: e, withEffectiveDateField: d = !0 } = i, s = d ? e : n(e, "effectiveDate");
+  return c({
+    fieldValidators: E,
+    requiredOnCreate: a,
+    requiredOnUpdate: R,
+    mode: o,
+    requiredFields: s
+  });
+}
+export {
+  t as WorkAddressErrorCodes,
+  l as createWorkAddressSchema
+};
+//# sourceMappingURL=workAddressSchema.js.map

package/dist/components/UNSTABLE_Hooks/hooks/useWorkAddressForm/workAddressSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workAddressSchema.js","sources":["../../../../../src/components/UNSTABLE_Hooks/hooks/useWorkAddressForm/workAddressSchema.ts"],"sourcesContent":["import { z } from 'zod'\nimport { composeFormSchema } from '../../form/composeFormSchema'\nimport { filterRequiredFields, type RequiredFields } from '../../form/resolveRequiredFields'\n\nexport const WorkAddressErrorCodes = {\n  REQUIRED: 'REQUIRED',\n} as const\n\nexport type WorkAddressErrorCode =\n  (typeof WorkAddressErrorCodes)[keyof typeof WorkAddressErrorCodes]\n\nconst fieldValidators = {\n  locationUuid: z.string().min(1, { message: WorkAddressErrorCodes.REQUIRED }),\n  effectiveDate: z.iso.date({ error: () => WorkAddressErrorCodes.REQUIRED }),\n}\n\nexport type WorkAddressField = keyof typeof fieldValidators\n\nexport type WorkAddressFormData = {\n  [K in keyof typeof fieldValidators]: z.infer<(typeof fieldValidators)[K]>\n}\nexport type WorkAddressFormOutputs = WorkAddressFormData\n\nconst REQUIRED_ON_CREATE = new Set<WorkAddressField>(['locationUuid'])\nconst REQUIRED_ON_UPDATE = new Set<WorkAddressField>(['locationUuid'])\n\ninterface WorkAddressSchemaOptions {\n  mode?: 'create' | 'update'\n  requiredFields?: RequiredFields<WorkAddressField>\n  withEffectiveDateField?: boolean\n}\n\nexport function createWorkAddressSchema(options: WorkAddressSchemaOptions = {}) {\n  const { mode = 'create', requiredFields, withEffectiveDateField = true } = options\n\n  const effectiveRequiredFields = withEffectiveDateField\n    ? requiredFields\n    : filterRequiredFields(requiredFields, 'effectiveDate')\n\n  return composeFormSchema({\n    fieldValidators,\n    requiredOnCreate: REQUIRED_ON_CREATE,\n    requiredOnUpdate: REQUIRED_ON_UPDATE,\n    mode,\n    requiredFields: effectiveRequiredFields,\n  })\n}\n"],"names":["WorkAddressErrorCodes","fieldValidators","z","REQUIRED_ON_CREATE","REQUIRED_ON_UPDATE","createWorkAddressSchema","options","mode","requiredFields","withEffectiveDateField","effectiveRequiredFields","filterRequiredFields","composeFormSchema"],"mappings":";;;AAIO,MAAMA,IAAwB;AAAA,EACnC,UAAU;AACZ,GAKMC,IAAkB;AAAA,EACtB,cAAcC,EAAE,OAAA,EAAS,IAAI,GAAG,EAAE,SAASF,EAAsB,UAAU;AAAA,EAC3E,eAAeE,EAAE,IAAI,KAAK,EAAE,OAAO,MAAMF,EAAsB,SAAA,CAAU;AAC3E,GASMG,IAAqB,oBAAI,IAAsB,CAAC,cAAc,CAAC,GAC/DC,IAAqB,oBAAI,IAAsB,CAAC,cAAc,CAAC;AAQ9D,SAASC,EAAwBC,IAAoC,IAAI;AAC9E,QAAM,EAAE,MAAAC,IAAO,UAAU,gBAAAC,GAAgB,wBAAAC,IAAyB,OAASH,GAErEI,IAA0BD,IAC5BD,IACAG,EAAqBH,GAAgB,eAAe;AAExD,SAAOI,EAAkB;AAAA,IACvB,iBAAAX;AAAA,IACA,kBAAkBE;AAAA,IAClB,kBAAkBC;AAAA,IAClB,MAAAG;AAAA,IACA,gBAAgBG;AAAA,EAAA,CACjB;AACH;"}

package/dist/components/UNSTABLE_Hooks/index.d.ts

@@ -0,0 +1,9 @@
+import "./types/i18next.d.ts"
+export type { HookFormInternals, HookLoadingResult, HookSubmitResult, HookErrorHandling, BaseHookReady, BaseFormHookReady, } from './types';
+export { useErrorHandling } from './useErrorHandling';
+export type { FieldMetadata, FieldMetadataWithOptions, FieldsMetadata, FormFieldsMetadataContextValue, ValidationMessages, BaseFieldProps, TextInputHookFieldProps, SelectHookFieldProps, CheckboxHookFieldProps, NumberInputHookFieldProps, DatePickerHookFieldProps, RadioGroupHookFieldProps, TextInputProps, SelectProps, SelectOption, CheckboxProps, NumberInputProps, DatePickerProps, RadioGroupProps, RadioGroupOption, SwitchHookFieldProps, SwitchProps, } from './form';
+export { collectErrors } from './collectErrors';
+export { withOptions, FormFieldsMetadataProvider, SDKFormProvider, useFieldsMetadata, useFieldErrorMessage, deriveFieldsMetadata, composeSubmitHandler, TextInputHookField, SelectHookField, CheckboxHookField, NumberInputHookField, DatePickerHookField, RadioGroupHookField, SwitchHookField, } from './form';
+export { useCompensationForm, CompensationForm, CompensationErrorCodes, createCompensationSchema, type CompensationFormProps, type CompensationSubmitCallbacks, type CompensationSubmitOptions, type CompensationRequiredFields, type UseCompensationFormProps, type UseCompensationFormResult, type UseCompensationFormReady, type CompensationFieldsMetadata, type CompensationFormFields, type CompensationErrorCode, type CompensationField, type CompensationFormData, type CompensationFormOutputs, type RequiredValidation, type RateValidation, type StartDateFieldProps, type JobTitleFieldProps, type FlsaStatusFieldProps, type RateFieldProps, type PaymentUnitFieldProps, type AdjustForMinimumWageFieldProps, type MinimumWageIdFieldProps, type TwoPercentShareholderFieldProps, type StateWcCoveredFieldProps, type StateWcClassCodeFieldProps, } from './hooks/useCompensationForm';
+export { useEmployeeDetailsForm, EmployeeDetailsForm, EmployeeDetailsErrorCodes, createEmployeeDetailsSchema, type EmployeeDetailsFormProps, type EmployeeDetailsSubmitCallbacks, type EmployeeDetailsRequiredFields, type UseEmployeeDetailsFormProps, type UseEmployeeDetailsFormResult, type UseEmployeeDetailsFormReady, type EmployeeDetailsFieldsMetadata, type EmployeeDetailsFormFields, type EmployeeDetailsErrorCode, type EmployeeDetailsFormData, type EmployeeDetailsFormOutputs, type EmployeeDetailsField, type EmployeeDetailsRequiredValidation, type NameValidation, type EmailValidation, type SsnValidation, type FirstNameFieldProps, type MiddleInitialFieldProps, type LastNameFieldProps, type EmailFieldProps, type DateOfBirthFieldProps, type SsnFieldProps, type SelfOnboardingFieldProps, } from './hooks/useEmployeeDetailsForm';
+export { useWorkAddressForm, WorkAddressForm, WorkAddressErrorCodes, createWorkAddressSchema, type WorkAddressFormProps, type WorkAddressSubmitCallbacks, type WorkAddressSubmitOptions, type WorkAddressRequiredFields, type UseWorkAddressFormProps, type UseWorkAddressFormResult, type UseWorkAddressFormReady, type WorkAddressFieldsMetadata, type WorkAddressFormFields, type WorkAddressErrorCode, type WorkAddressFormData, type WorkAddressFormOutputs, type WorkAddressField, type WorkAddressRequiredValidation, type LocationFieldProps, type EffectiveDateFieldProps, } from './hooks/useWorkAddressForm';

package/dist/components/UNSTABLE_Hooks/types.d.ts

@@ -0,0 +1,49 @@
+import { UseFormReturn, FieldValues } from 'react-hook-form';
+import { FieldsMetadata } from './form/types';
+import { SDKError } from '../../types/sdkError';
+/** Exposes react-hook-form internals for SDK utilities and advanced partner use cases. */
+export interface HookFormInternals<TFormData extends FieldValues = FieldValues> {
+    formMethods: UseFormReturn<TFormData>;
+}
+/** Discriminated union member returned while async data is being fetched. */
+export interface HookLoadingResult {
+    isLoading: true;
+    errorHandling: HookErrorHandling;
+}
+/** Result shape returned by a successful form submission. */
+export interface HookSubmitResult<T> {
+    mode: 'create' | 'update';
+    data: T;
+}
+/** Error state and recovery actions returned by all hooks. */
+export interface HookErrorHandling {
+    errors: SDKError[];
+    retryQueries: () => void;
+    clearSubmitError: () => void;
+}
+/** Base shape for non-form hooks. Individual hooks override `data`. */
+export interface BaseHookReady {
+    isLoading: false;
+    data: Record<string, unknown>;
+    status: {
+        isPending: boolean;
+    };
+    errorHandling: HookErrorHandling;
+}
+/** Base shape for form hooks. Individual hooks override `data`, `actions`, and `form`. */
+export interface BaseFormHookReady<TFieldsMetadata extends FieldsMetadata = FieldsMetadata> {
+    isLoading: false;
+    data: Record<string, unknown>;
+    status: {
+        isPending: boolean;
+        mode: 'create' | 'update';
+    };
+    actions: Record<string, unknown>;
+    errorHandling: HookErrorHandling;
+    form: {
+        Fields: Record<string, unknown>;
+        fieldsMetadata: TFieldsMetadata;
+        hookFormInternals: HookFormInternals;
+        getFormSubmissionValues: () => Record<string, unknown> | undefined;
+    };
+}

package/dist/components/UNSTABLE_Hooks/useErrorHandling.d.ts

@@ -0,0 +1,9 @@
+import { UseQueryResult } from '@tanstack/react-query';
+import { HookErrorHandling } from './types';
+import { SDKError } from '../../types/sdkError';
+type QueryWithRefetch = Pick<UseQueryResult, 'error' | 'refetch'>;
+export declare function useErrorHandling(queries: QueryWithRefetch[], submitState: {
+    error: SDKError | null;
+    setError: (error: SDKError | null) => void;
+}): HookErrorHandling;
+export {};

package/dist/components/UNSTABLE_Hooks/useErrorHandling.js

@@ -0,0 +1,12 @@
+import { collectErrors as t } from "./collectErrors.js";
+function i(o, e) {
+  return { errors: t(o, e.error), retryQueries: () => {
+    o.filter((r) => r.error != null).forEach((r) => void r.refetch());
+  }, clearSubmitError: () => {
+    e.setError(null);
+  } };
+}
+export {
+  i as useErrorHandling
+};
+//# sourceMappingURL=useErrorHandling.js.map

package/dist/components/UNSTABLE_Hooks/useErrorHandling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useErrorHandling.js","sources":["../../../src/components/UNSTABLE_Hooks/useErrorHandling.ts"],"sourcesContent":["import type { UseQueryResult } from '@tanstack/react-query'\nimport { collectErrors } from './collectErrors'\nimport type { HookErrorHandling } from './types'\nimport type { SDKError } from '@/types/sdkError'\n\ntype QueryWithRefetch = Pick<UseQueryResult, 'error' | 'refetch'>\n\nexport function useErrorHandling(\n  queries: QueryWithRefetch[],\n  submitState: { error: SDKError | null; setError: (error: SDKError | null) => void },\n): HookErrorHandling {\n  const errors = collectErrors(queries, submitState.error)\n\n  const retryQueries = () => {\n    queries.filter(q => q.error != null).forEach(q => void q.refetch())\n  }\n\n  const clearSubmitError = () => {\n    submitState.setError(null)\n  }\n\n  return { errors, retryQueries, clearSubmitError }\n}\n"],"names":["useErrorHandling","queries","submitState","collectErrors","q"],"mappings":";AAOO,SAASA,EACdC,GACAC,GACmB;AAWnB,SAAO,EAAE,QAVMC,EAAcF,GAASC,EAAY,KAAK,GAUtC,cARI,MAAM;AACzB,IAAAD,EAAQ,OAAO,CAAAG,MAAKA,EAAE,SAAS,IAAI,EAAE,QAAQ,CAAAA,MAAK,KAAKA,EAAE,QAAA,CAAS;AAAA,EACpE,GAM+B,kBAJN,MAAM;AAC7B,IAAAF,EAAY,SAAS,IAAI;AAAA,EAC3B,EAE+B;AACjC;"}

package/dist/components/UNSTABLE_Hooks/useErrorHandling.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/contexts/ApiProvider/ApiProvider.js

@@ -1,8 +1,8 @@
-import { jsx as u } from "react/jsx-runtime";
-import { QueryClient as H, QueryClientProvider as E } from "@tanstack/react-query";
-import { GustoEmbeddedProvider as R } from "@gusto/embedded-api/react-query/_context";
-import { GustoEmbeddedCore as b } from "@gusto/embedded-api/core";
-import { SDKHooks as g } from "@gusto/embedded-api/hooks/hooks";
+import { jsx as c } from "react/jsx-runtime";
+import { QueryClient as H, QueryClientProvider as b } from "@tanstack/react-query";
+import { GustoEmbeddedProvider as g } from "@gusto/embedded-api/react-query/_context";
+import { GustoEmbeddedCore as E } from "@gusto/embedded-api/core";
+import { SDKHooks as R } from "@gusto/embedded-api/hooks/hooks";
 import { useMemo as a } from "react";
 import { apiVersionHook as q } from "./apiVersionHook.js";
 function A({
@@ -13,13 +13,13 @@ function A({
   queryClient: i
 }) {
   const m = a(() => {
-    const r = new b({
+    const r = new E({
       serverURL: f
-    }), t = r._options.hooks || new g();
+    }), t = r._options.hooks || new R();
     if (t.registerBeforeRequestHook(q), s) {
       const o = {
-        beforeRequest: (C, n) => (new Headers(s).forEach((c, l) => {
-          c && n.headers.set(l, c);
+        beforeRequest: (y, n) => (new Headers(s).forEach((u, l) => {
+          u && n.headers.set(l, u);
         }), n)
       };
       t.registerBeforeRequestHook(o);
@@ -37,11 +37,11 @@ function A({
     if (i)
       return i;
     const r = new H(), t = async () => {
-      await r.invalidateQueries();
+      await r.invalidateQueries({ queryKey: ["@gusto/embedded-api"] });
     };
     return r.setQueryDefaults(["@gusto/embedded-api"], { retry: !1 }), r.setMutationDefaults(["@gusto/embedded-api"], { onSuccess: t, retry: !1 }), r;
   }, [i]);
-  return /* @__PURE__ */ u(E, { client: p, children: /* @__PURE__ */ u(R, { client: m, children: d }) });
+  return /* @__PURE__ */ c(b, { client: p, children: /* @__PURE__ */ c(g, { client: m, children: d }) });
 }
 export {
   A as ApiProvider

package/dist/contexts/ApiProvider/ApiProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"ApiProvider.js","sources":["../../../src/contexts/ApiProvider/ApiProvider.tsx"],"sourcesContent":["import { QueryClient, QueryClientProvider } from '@tanstack/react-query'\nimport { GustoEmbeddedProvider } from '@gusto/embedded-api/react-query/_context'\nimport { GustoEmbeddedCore } from '@gusto/embedded-api/core'\nimport { SDKHooks as NativeSDKHooks } from '@gusto/embedded-api/hooks/hooks'\nimport { useMemo } from 'react'\nimport { apiVersionHook } from './apiVersionHook'\nimport type { SDKHooks, BeforeRequestHook } from '@/types/hooks'\n\nexport interface ApiProviderProps {\n  url: string\n  headers?: HeadersInit\n  hooks?: SDKHooks\n  children: React.ReactNode\n  queryClient?: QueryClient\n}\n\nexport function ApiProvider({\n  url,\n  headers,\n  hooks,\n  children,\n  queryClient: queryClientFromProps,\n}: ApiProviderProps) {\n  const gustoClient = useMemo(() => {\n    const client = new GustoEmbeddedCore({\n      serverURL: url,\n    })\n\n    const sdkHooks = client._options.hooks || new NativeSDKHooks()\n\n    sdkHooks.registerBeforeRequestHook(apiVersionHook)\n\n    if (headers) {\n      const defaultHeaderHook: BeforeRequestHook = {\n        beforeRequest: (context, request) => {\n          const headersInstance = new Headers(headers)\n          headersInstance.forEach((headerValue, headerName) => {\n            if (headerValue) {\n              request.headers.set(headerName, headerValue)\n            }\n          })\n          return request\n        },\n      }\n      sdkHooks.registerBeforeRequestHook(defaultHeaderHook)\n    }\n\n    if (hooks?.beforeCreateRequest) {\n      hooks.beforeCreateRequest.forEach(hook => {\n        sdkHooks.registerBeforeCreateRequestHook(hook)\n      })\n    }\n\n    if (hooks?.beforeRequest) {\n      hooks.beforeRequest.forEach(hook => {\n        sdkHooks.registerBeforeRequestHook(hook)\n      })\n    }\n\n    if (hooks?.afterSuccess) {\n      hooks.afterSuccess.forEach(hook => {\n        sdkHooks.registerAfterSuccessHook(hook)\n      })\n    }\n\n    if (hooks?.afterError) {\n      hooks.afterError.forEach(hook => {\n        sdkHooks.registerAfterErrorHook(hook)\n      })\n    }\n\n    if (!client._options.hooks) {\n      client._options.hooks = sdkHooks\n    }\n\n    return client\n  }, [url, headers, hooks])\n\n  const queryClient = useMemo(() => {\n    if (queryClientFromProps) {\n      return queryClientFromProps\n    }\n\n    // Create and configure a new QueryClient for internal SDK use\n    const client = new QueryClient()\n\n    const onSuccess = async () => {\n      await client.invalidateQueries()\n    }\n    client.setQueryDefaults(['@gusto/embedded-api'], { retry: false })\n    client.setMutationDefaults(['@gusto/embedded-api'], { onSuccess, retry: false })\n\n    return client\n  }, [queryClientFromProps])\n\n  return (\n    <QueryClientProvider client={queryClient}>\n      <GustoEmbeddedProvider client={gustoClient}>{children}</GustoEmbeddedProvider>\n    </QueryClientProvider>\n  )\n}\n"],"names":["ApiProvider","url","headers","hooks","children","queryClientFromProps","gustoClient","useMemo","client","GustoEmbeddedCore","sdkHooks","NativeSDKHooks","apiVersionHook","defaultHeaderHook","context","request","headerValue","headerName","hook","queryClient","QueryClient","onSuccess","jsx","QueryClientProvider","GustoEmbeddedProvider"],"mappings":";;;;;;;AAgBO,SAASA,EAAY;AAAA,EAC1B,KAAAC;AAAA,EACA,SAAAC;AAAA,EACA,OAAAC;AAAA,EACA,UAAAC;AAAA,EACA,aAAaC;AACf,GAAqB;AACnB,QAAMC,IAAcC,EAAQ,MAAM;AAChC,UAAMC,IAAS,IAAIC,EAAkB;AAAA,MACnC,WAAWR;AAAA,IAAA,CACZ,GAEKS,IAAWF,EAAO,SAAS,SAAS,IAAIG,EAAA;AAI9C,QAFAD,EAAS,0BAA0BE,CAAc,GAE7CV,GAAS;AACX,YAAMW,IAAuC;AAAA,QAC3C,eAAe,CAACC,GAASC,OACC,IAAI,QAAQb,CAAO,EAC3B,QAAQ,CAACc,GAAaC,MAAe;AACnD,UAAID,KACFD,EAAQ,QAAQ,IAAIE,GAAYD,CAAW;AAAA,QAE/C,CAAC,GACMD;AAAA,MACT;AAEF,MAAAL,EAAS,0BAA0BG,CAAiB;AAAA,IACtD;AAEA,WAAIV,GAAO,uBACTA,EAAM,oBAAoB,QAAQ,CAAAe,MAAQ;AACxC,MAAAR,EAAS,gCAAgCQ,CAAI;AAAA,IAC/C,CAAC,GAGCf,GAAO,iBACTA,EAAM,cAAc,QAAQ,CAAAe,MAAQ;AAClC,MAAAR,EAAS,0BAA0BQ,CAAI;AAAA,IACzC,CAAC,GAGCf,GAAO,gBACTA,EAAM,aAAa,QAAQ,CAAAe,MAAQ;AACjC,MAAAR,EAAS,yBAAyBQ,CAAI;AAAA,IACxC,CAAC,GAGCf,GAAO,cACTA,EAAM,WAAW,QAAQ,CAAAe,MAAQ;AAC/B,MAAAR,EAAS,uBAAuBQ,CAAI;AAAA,IACtC,CAAC,GAGEV,EAAO,SAAS,UACnBA,EAAO,SAAS,QAAQE,IAGnBF;AAAA,EACT,GAAG,CAACP,GAAKC,GAASC,CAAK,CAAC,GAElBgB,IAAcZ,EAAQ,MAAM;AAChC,QAAIF;AACF,aAAOA;AAIT,UAAMG,IAAS,IAAIY,EAAA,GAEbC,IAAY,YAAY;AAC5B,YAAMb,EAAO,kBAAA;AAAA,IACf;AACA,WAAAA,EAAO,iBAAiB,CAAC,qBAAqB,GAAG,EAAE,OAAO,IAAO,GACjEA,EAAO,oBAAoB,CAAC,qBAAqB,GAAG,EAAE,WAAAa,GAAW,OAAO,IAAO,GAExEb;AAAA,EACT,GAAG,CAACH,CAAoB,CAAC;AAEzB,SACE,gBAAAiB,EAACC,KAAoB,QAAQJ,GAC3B,4BAACK,GAAA,EAAsB,QAAQlB,GAAc,UAAAF,EAAA,CAAS,EAAA,CACxD;AAEJ;"}
+{"version":3,"file":"ApiProvider.js","sources":["../../../src/contexts/ApiProvider/ApiProvider.tsx"],"sourcesContent":["import { QueryClient, QueryClientProvider } from '@tanstack/react-query'\nimport { GustoEmbeddedProvider } from '@gusto/embedded-api/react-query/_context'\nimport { GustoEmbeddedCore } from '@gusto/embedded-api/core'\nimport { SDKHooks as NativeSDKHooks } from '@gusto/embedded-api/hooks/hooks'\nimport { useMemo } from 'react'\nimport { apiVersionHook } from './apiVersionHook'\nimport type { SDKHooks, BeforeRequestHook } from '@/types/hooks'\n\nexport interface ApiProviderProps {\n  url: string\n  headers?: HeadersInit\n  hooks?: SDKHooks\n  children: React.ReactNode\n  queryClient?: QueryClient\n}\n\nexport function ApiProvider({\n  url,\n  headers,\n  hooks,\n  children,\n  queryClient: queryClientFromProps,\n}: ApiProviderProps) {\n  const gustoClient = useMemo(() => {\n    const client = new GustoEmbeddedCore({\n      serverURL: url,\n    })\n\n    const sdkHooks = client._options.hooks || new NativeSDKHooks()\n\n    sdkHooks.registerBeforeRequestHook(apiVersionHook)\n\n    if (headers) {\n      const defaultHeaderHook: BeforeRequestHook = {\n        beforeRequest: (context, request) => {\n          const headersInstance = new Headers(headers)\n          headersInstance.forEach((headerValue, headerName) => {\n            if (headerValue) {\n              request.headers.set(headerName, headerValue)\n            }\n          })\n          return request\n        },\n      }\n      sdkHooks.registerBeforeRequestHook(defaultHeaderHook)\n    }\n\n    if (hooks?.beforeCreateRequest) {\n      hooks.beforeCreateRequest.forEach(hook => {\n        sdkHooks.registerBeforeCreateRequestHook(hook)\n      })\n    }\n\n    if (hooks?.beforeRequest) {\n      hooks.beforeRequest.forEach(hook => {\n        sdkHooks.registerBeforeRequestHook(hook)\n      })\n    }\n\n    if (hooks?.afterSuccess) {\n      hooks.afterSuccess.forEach(hook => {\n        sdkHooks.registerAfterSuccessHook(hook)\n      })\n    }\n\n    if (hooks?.afterError) {\n      hooks.afterError.forEach(hook => {\n        sdkHooks.registerAfterErrorHook(hook)\n      })\n    }\n\n    if (!client._options.hooks) {\n      client._options.hooks = sdkHooks\n    }\n\n    return client\n  }, [url, headers, hooks])\n\n  const queryClient = useMemo(() => {\n    if (queryClientFromProps) {\n      return queryClientFromProps\n    }\n\n    // Create and configure a new QueryClient for internal SDK use\n    const client = new QueryClient()\n\n    const onSuccess = async () => {\n      await client.invalidateQueries({ queryKey: ['@gusto/embedded-api'] })\n    }\n    client.setQueryDefaults(['@gusto/embedded-api'], { retry: false })\n    client.setMutationDefaults(['@gusto/embedded-api'], { onSuccess, retry: false })\n\n    return client\n  }, [queryClientFromProps])\n\n  return (\n    <QueryClientProvider client={queryClient}>\n      <GustoEmbeddedProvider client={gustoClient}>{children}</GustoEmbeddedProvider>\n    </QueryClientProvider>\n  )\n}\n"],"names":["ApiProvider","url","headers","hooks","children","queryClientFromProps","gustoClient","useMemo","client","GustoEmbeddedCore","sdkHooks","NativeSDKHooks","apiVersionHook","defaultHeaderHook","context","request","headerValue","headerName","hook","queryClient","QueryClient","onSuccess","jsx","QueryClientProvider","GustoEmbeddedProvider"],"mappings":";;;;;;;AAgBO,SAASA,EAAY;AAAA,EAC1B,KAAAC;AAAA,EACA,SAAAC;AAAA,EACA,OAAAC;AAAA,EACA,UAAAC;AAAA,EACA,aAAaC;AACf,GAAqB;AACnB,QAAMC,IAAcC,EAAQ,MAAM;AAChC,UAAMC,IAAS,IAAIC,EAAkB;AAAA,MACnC,WAAWR;AAAA,IAAA,CACZ,GAEKS,IAAWF,EAAO,SAAS,SAAS,IAAIG,EAAA;AAI9C,QAFAD,EAAS,0BAA0BE,CAAc,GAE7CV,GAAS;AACX,YAAMW,IAAuC;AAAA,QAC3C,eAAe,CAACC,GAASC,OACC,IAAI,QAAQb,CAAO,EAC3B,QAAQ,CAACc,GAAaC,MAAe;AACnD,UAAID,KACFD,EAAQ,QAAQ,IAAIE,GAAYD,CAAW;AAAA,QAE/C,CAAC,GACMD;AAAA,MACT;AAEF,MAAAL,EAAS,0BAA0BG,CAAiB;AAAA,IACtD;AAEA,WAAIV,GAAO,uBACTA,EAAM,oBAAoB,QAAQ,CAAAe,MAAQ;AACxC,MAAAR,EAAS,gCAAgCQ,CAAI;AAAA,IAC/C,CAAC,GAGCf,GAAO,iBACTA,EAAM,cAAc,QAAQ,CAAAe,MAAQ;AAClC,MAAAR,EAAS,0BAA0BQ,CAAI;AAAA,IACzC,CAAC,GAGCf,GAAO,gBACTA,EAAM,aAAa,QAAQ,CAAAe,MAAQ;AACjC,MAAAR,EAAS,yBAAyBQ,CAAI;AAAA,IACxC,CAAC,GAGCf,GAAO,cACTA,EAAM,WAAW,QAAQ,CAAAe,MAAQ;AAC/B,MAAAR,EAAS,uBAAuBQ,CAAI;AAAA,IACtC,CAAC,GAGEV,EAAO,SAAS,UACnBA,EAAO,SAAS,QAAQE,IAGnBF;AAAA,EACT,GAAG,CAACP,GAAKC,GAASC,CAAK,CAAC,GAElBgB,IAAcZ,EAAQ,MAAM;AAChC,QAAIF;AACF,aAAOA;AAIT,UAAMG,IAAS,IAAIY,EAAA,GAEbC,IAAY,YAAY;AAC5B,YAAMb,EAAO,kBAAkB,EAAE,UAAU,CAAC,qBAAqB,GAAG;AAAA,IACtE;AACA,WAAAA,EAAO,iBAAiB,CAAC,qBAAqB,GAAG,EAAE,OAAO,IAAO,GACjEA,EAAO,oBAAoB,CAAC,qBAAqB,GAAG,EAAE,WAAAa,GAAW,OAAO,IAAO,GAExEb;AAAA,EACT,GAAG,CAACH,CAAoB,CAAC;AAEzB,SACE,gBAAAiB,EAACC,KAAoB,QAAQJ,GAC3B,4BAACK,GAAA,EAAsB,QAAQlB,GAAc,UAAAF,EAAA,CAAS,EAAA,CACxD;AAEJ;"}