@gusto/embedded-react-sdk 0.55.4 → 0.55.6

package/dist/components/Payroll/PayrollConfiguration/useCalculationPoll.d.ts

@@ -0,0 +1,50 @@
+import { PayrollsGetQueryData, PayrollsGetQueryError } from '@gusto/embedded-api/react-query/payrollsGet';
+import { QueryObserverResult } from '@tanstack/react-query';
+import { PayrollProcessingRequest } from '@gusto/embedded-api/models/components/payrollprocessingrequest';
+/** @internal */
+export type PayrollShow = NonNullable<PayrollsGetQueryData['payrollShow']>;
+/**
+ * Per-run state for the calculation poll. Written when a run starts and read only from inside
+ * the poll loop — never during render, which is what made the previous `previousCalculatedAtRef`
+ * completion gate depend on a render arriving.
+ */
+interface CalculationPollRun {
+    /**
+     * Fast calculations may transition directly to `CalculateSuccess` between ticks, without ever
+     * seeing the `Calculating` status.
+     * If we know the previous `calculatedAt` timestamp and it changes, we know our polling can resolve.
+     */
+    baselineCalculatedAt: number | null;
+    /**
+     * The API contract guarantees no relationship between `processingRequest.status` and `calculatedAt` —
+     * a deduped/coalesced calculate can legitimately return `CalculateSuccess` with the exact same
+     * `calculatedAt` as the baseline captured when this run started.
+     * If we have seen `Calculating` status during this run, and it changes to `CalculateSuccess`,
+     * we know our polling can resolve even if the timestamp hasn't changed.
+     */
+    sawCalculatingThisPoll: boolean;
+}
+/** @internal */
+export declare const isCalculatingStatus: (processingRequest?: PayrollProcessingRequest | null) => boolean;
+/** @internal */
+export interface UseCalculationPollOptions {
+    /**
+     * The render-driving payroll query's own `refetch`, reused so the poll's reads land on the
+     * same query the component observes rather than racing a second, independently-built one.
+     */
+    refetch: () => Promise<QueryObserverResult<PayrollsGetQueryData, PayrollsGetQueryError>>;
+    onCalculated: (payroll: PayrollShow | undefined) => void;
+    onProcessingFailed: (payroll: PayrollShow | undefined) => void;
+}
+/** @internal */
+export interface CalculationPoll {
+    start: (props: CalculationPollRun) => void;
+    isPolling: boolean;
+}
+/**
+ * Polls a payroll until its calculation reaches a terminal state, via {@link usePollingTask}.
+ *
+ * @internal
+ */
+export declare function useCalculationPoll({ refetch, onCalculated, onProcessingFailed, }: UseCalculationPollOptions): CalculationPoll;
+export {};

package/dist/components/Payroll/PayrollConfiguration/useCalculationPoll.js

@@ -0,0 +1,52 @@
+import { useRef as p, useCallback as y } from "react";
+import { PayrollProcessingRequestStatus as o } from "@gusto/embedded-api/models/components/payrollprocessingrequest";
+import { usePollingTask as g } from "../../../hooks/usePollingTask/usePollingTask.js";
+const C = (a) => a?.status === o.Calculating, c = (a, l) => l != null && (a?.status === o.CalculateSuccess || a == null), h = (a, l) => {
+  const e = a.payrollShow;
+  if (C(e?.processingRequest))
+    return l && (l.sawCalculatingThisPoll = !0), { done: !1 };
+  if (e?.processingRequest?.status === o.ProcessingFailed)
+    return { done: !0, value: { type: "failed", payroll: e } };
+  const s = e?.calculatedAt;
+  return (l?.sawCalculatingThisPoll === !0 || s?.getTime() !== l?.baselineCalculatedAt) && c(e?.processingRequest, s) ? { done: !0, value: { type: "calculated", payroll: e } } : { done: !1 };
+};
+function S({
+  refetch: a,
+  onCalculated: l,
+  onProcessingFailed: e
+}) {
+  const s = p(null), r = async () => {
+    const t = await a();
+    if (t.status !== "success") throw t.error ?? new Error("Payroll refetch failed");
+    return t.data;
+  }, i = (t) => {
+    if (t.type === "failed") {
+      e(t.payroll);
+      return;
+    }
+    l(t.payroll);
+  }, f = (t) => {
+    const n = t?.payrollShow;
+    if (c(n?.processingRequest, n?.calculatedAt)) {
+      l(n);
+      return;
+    }
+    e(n);
+  }, { start: u, isPolling: d } = g({
+    fetch: r,
+    evaluate: (t) => h(t, s.current),
+    onDone: i,
+    onDeadline: f
+  });
+  return { start: y(
+    (t) => {
+      s.current = t, u();
+    },
+    [u]
+  ), isPolling: d };
+}
+export {
+  C as isCalculatingStatus,
+  S as useCalculationPoll
+};
+//# sourceMappingURL=useCalculationPoll.js.map

package/dist/components/Payroll/PayrollConfiguration/useCalculationPoll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCalculationPoll.js","sources":["../../../../src/components/Payroll/PayrollConfiguration/useCalculationPoll.ts"],"sourcesContent":["import { useCallback, useRef } from 'react'\nimport type {\n  PayrollsGetQueryData,\n  PayrollsGetQueryError,\n} from '@gusto/embedded-api/react-query/payrollsGet'\nimport type { QueryObserverResult } from '@tanstack/react-query'\nimport type { PayrollProcessingRequest } from '@gusto/embedded-api/models/components/payrollprocessingrequest'\nimport { PayrollProcessingRequestStatus } from '@gusto/embedded-api/models/components/payrollprocessingrequest'\nimport { usePollingTask, type PollTickResult } from '@/hooks/usePollingTask/usePollingTask'\n\n/** @internal */\nexport type PayrollShow = NonNullable<PayrollsGetQueryData['payrollShow']>\n\ntype CalculationOutcome =\n  | { type: 'calculated'; payroll: PayrollShow | undefined }\n  | { type: 'failed'; payroll: PayrollShow | undefined }\n\n/**\n * Per-run state for the calculation poll. Written when a run starts and read only from inside\n * the poll loop — never during render, which is what made the previous `previousCalculatedAtRef`\n * completion gate depend on a render arriving.\n */\ninterface CalculationPollRun {\n  /**\n   * Fast calculations may transition directly to `CalculateSuccess` between ticks, without ever\n   * seeing the `Calculating` status.\n   * If we know the previous `calculatedAt` timestamp and it changes, we know our polling can resolve.\n   */\n  baselineCalculatedAt: number | null\n  /**\n   * The API contract guarantees no relationship between `processingRequest.status` and `calculatedAt` —\n   * a deduped/coalesced calculate can legitimately return `CalculateSuccess` with the exact same\n   * `calculatedAt` as the baseline captured when this run started.\n   * If we have seen `Calculating` status during this run, and it changes to `CalculateSuccess`,\n   * we know our polling can resolve even if the timestamp hasn't changed.\n   */\n  sawCalculatingThisPoll: boolean\n}\n\n/** @internal */\nexport const isCalculatingStatus = (processingRequest?: PayrollProcessingRequest | null) =>\n  processingRequest?.status === PayrollProcessingRequestStatus.Calculating\n\nconst isCalculatedStatus = (\n  processingRequest?: PayrollProcessingRequest | null,\n  calculatedAt?: Date | null,\n) =>\n  calculatedAt != null &&\n  (processingRequest?.status === PayrollProcessingRequestStatus.CalculateSuccess ||\n    processingRequest == null)\n\nconst evaluateCalculationOutcome = (\n  data: PayrollsGetQueryData,\n  run: CalculationPollRun | null,\n): PollTickResult<CalculationOutcome> => {\n  const payroll = data.payrollShow\n\n  if (isCalculatingStatus(payroll?.processingRequest)) {\n    if (run) run.sawCalculatingThisPoll = true\n    return { done: false }\n  }\n\n  if (payroll?.processingRequest?.status === PayrollProcessingRequestStatus.ProcessingFailed) {\n    return { done: true, value: { type: 'failed', payroll } }\n  }\n\n  const calculatedAt = payroll?.calculatedAt\n  const isNewCalculation =\n    run?.sawCalculatingThisPoll === true || calculatedAt?.getTime() !== run?.baselineCalculatedAt\n\n  if (isNewCalculation && isCalculatedStatus(payroll?.processingRequest, calculatedAt)) {\n    return { done: true, value: { type: 'calculated', payroll } }\n  }\n\n  return { done: false }\n}\n\n/** @internal */\nexport interface UseCalculationPollOptions {\n  /**\n   * The render-driving payroll query's own `refetch`, reused so the poll's reads land on the\n   * same query the component observes rather than racing a second, independently-built one.\n   */\n  refetch: () => Promise<QueryObserverResult<PayrollsGetQueryData, PayrollsGetQueryError>>\n  onCalculated: (payroll: PayrollShow | undefined) => void\n  onProcessingFailed: (payroll: PayrollShow | undefined) => void\n}\n\n/** @internal */\nexport interface CalculationPoll {\n  start: (props: CalculationPollRun) => void\n  isPolling: boolean\n}\n\n/**\n * Polls a payroll until its calculation reaches a terminal state, via {@link usePollingTask}.\n *\n * @internal\n */\nexport function useCalculationPoll({\n  refetch,\n  onCalculated,\n  onProcessingFailed,\n}: UseCalculationPollOptions): CalculationPoll {\n  const pollRunRef = useRef<CalculationPollRun | null>(null)\n\n  const fetchPayroll = async (): Promise<PayrollsGetQueryData> => {\n    const result = await refetch()\n    if (result.status !== 'success') throw result.error ?? new Error('Payroll refetch failed')\n    return result.data\n  }\n\n  const handleDone = (outcome: CalculationOutcome) => {\n    if (outcome.type === 'failed') {\n      onProcessingFailed(outcome.payroll)\n      return\n    }\n    onCalculated(outcome.payroll)\n  }\n\n  // The server is the source of truth. A calculation that succeeded while we were waiting must\n  // never be reported as a failure — that reported false failures for payrolls that had\n  // calculated fine, and re-armed the prepare that would then wipe the result (SDK-1291).\n  // Advancing on a stale success is the safer of the two wrong answers: the next screen re-reads\n  // the payroll, whereas a false failure destroys real data.\n  const handleDeadline = (lastData: PayrollsGetQueryData | null) => {\n    const payroll = lastData?.payrollShow\n    if (isCalculatedStatus(payroll?.processingRequest, payroll?.calculatedAt)) {\n      onCalculated(payroll)\n      return\n    }\n    onProcessingFailed(payroll)\n  }\n\n  const { start: startPoll, isPolling } = usePollingTask<PayrollsGetQueryData, CalculationOutcome>({\n    fetch: fetchPayroll,\n    evaluate: data => evaluateCalculationOutcome(data, pollRunRef.current),\n    onDone: handleDone,\n    onDeadline: handleDeadline,\n  })\n\n  const start = useCallback(\n    (run: CalculationPollRun) => {\n      pollRunRef.current = run\n      startPoll()\n    },\n    [startPoll],\n  )\n\n  return { start, isPolling }\n}\n"],"names":["isCalculatingStatus","processingRequest","PayrollProcessingRequestStatus","isCalculatedStatus","calculatedAt","evaluateCalculationOutcome","data","run","payroll","useCalculationPoll","refetch","onCalculated","onProcessingFailed","pollRunRef","useRef","fetchPayroll","result","handleDone","outcome","handleDeadline","lastData","startPoll","isPolling","usePollingTask","useCallback"],"mappings":";;;AAwCO,MAAMA,IAAsB,CAACC,MAClCA,GAAmB,WAAWC,EAA+B,aAEzDC,IAAqB,CACzBF,GACAG,MAEAA,KAAgB,SACfH,GAAmB,WAAWC,EAA+B,oBAC5DD,KAAqB,OAEnBI,IAA6B,CACjCC,GACAC,MACuC;AACvC,QAAMC,IAAUF,EAAK;AAErB,MAAIN,EAAoBQ,GAAS,iBAAiB;AAChD,WAAID,QAAS,yBAAyB,KAC/B,EAAE,MAAM,GAAA;AAGjB,MAAIC,GAAS,mBAAmB,WAAWN,EAA+B;AACxE,WAAO,EAAE,MAAM,IAAM,OAAO,EAAE,MAAM,UAAU,SAAAM,IAAQ;AAGxD,QAAMJ,IAAeI,GAAS;AAI9B,UAFED,GAAK,2BAA2B,MAAQH,GAAc,QAAA,MAAcG,GAAK,yBAEnDJ,EAAmBK,GAAS,mBAAmBJ,CAAY,IAC1E,EAAE,MAAM,IAAM,OAAO,EAAE,MAAM,cAAc,SAAAI,IAAQ,IAGrD,EAAE,MAAM,GAAA;AACjB;AAwBO,SAASC,EAAmB;AAAA,EACjC,SAAAC;AAAA,EACA,cAAAC;AAAA,EACA,oBAAAC;AACF,GAA+C;AAC7C,QAAMC,IAAaC,EAAkC,IAAI,GAEnDC,IAAe,YAA2C;AAC9D,UAAMC,IAAS,MAAMN,EAAA;AACrB,QAAIM,EAAO,WAAW,UAAW,OAAMA,EAAO,SAAS,IAAI,MAAM,wBAAwB;AACzF,WAAOA,EAAO;AAAA,EAChB,GAEMC,IAAa,CAACC,MAAgC;AAClD,QAAIA,EAAQ,SAAS,UAAU;AAC7B,MAAAN,EAAmBM,EAAQ,OAAO;AAClC;AAAA,IACF;AACA,IAAAP,EAAaO,EAAQ,OAAO;AAAA,EAC9B,GAOMC,IAAiB,CAACC,MAA0C;AAChE,UAAMZ,IAAUY,GAAU;AAC1B,QAAIjB,EAAmBK,GAAS,mBAAmBA,GAAS,YAAY,GAAG;AACzE,MAAAG,EAAaH,CAAO;AACpB;AAAA,IACF;AACA,IAAAI,EAAmBJ,CAAO;AAAA,EAC5B,GAEM,EAAE,OAAOa,GAAW,WAAAC,EAAA,IAAcC,EAAyD;AAAA,IAC/F,OAAOR;AAAA,IACP,UAAU,CAAAT,MAAQD,EAA2BC,GAAMO,EAAW,OAAO;AAAA,IACrE,QAAQI;AAAA,IACR,YAAYE;AAAA,EAAA,CACb;AAUD,SAAO,EAAE,OARKK;AAAA,IACZ,CAACjB,MAA4B;AAC3B,MAAAM,EAAW,UAAUN,GACrBc,EAAA;AAAA,IACF;AAAA,IACA,CAACA,CAAS;AAAA,EAAA,GAGI,WAAAC,EAAA;AAClB;"}

package/dist/components/Payroll/PayrollEditEmployee/PayrollEditEmployee.js

@@ -1,90 +1,92 @@
-import { jsx as n } from "react/jsx-runtime";
-import { useEmployeesGetSuspense as O } from "@gusto/embedded-api/react-query/employeesGet";
-import { useEmployeePaymentMethodsGetBankAccountsSuspense as v } from "@gusto/embedded-api/react-query/employeePaymentMethodsGetBankAccounts";
-import { usePayrollsUpdateMutation as x } from "@gusto/embedded-api/react-query/payrollsUpdate";
-import { useMemo as B } from "react";
-import { useQueryClient as q } from "@tanstack/react-query";
-import { usePreparedPayrollData as w } from "../usePreparedPayrollData.js";
-import { PREPARE_QUERY_KEY as M } from "../PayrollConfiguration/usePayrollConfigurationData.js";
-import { derivePayrollCategory as N, isOffCyclePayroll as Q } from "../payrollTypes.js";
-import { cleanupReimbursements as z } from "../helpers.js";
+import { jsx as t } from "react/jsx-runtime";
+import { useEmployeesGetSuspense as k } from "@gusto/embedded-api/react-query/employeesGet";
+import { useEmployeePaymentMethodsGetBankAccountsSuspense as B } from "@gusto/embedded-api/react-query/employeePaymentMethodsGetBankAccounts";
+import { usePayrollsUpdateMutation as v } from "@gusto/embedded-api/react-query/payrollsUpdate";
+import { useMemo as x } from "react";
+import { useQueryClient as N } from "@tanstack/react-query";
+import { usePreparedPayrollData as q } from "../usePreparedPayrollData.js";
+import { PREPARE_QUERY_KEY as w } from "../PayrollConfiguration/usePayrollConfigurationData.js";
+import { derivePayrollCategory as M, isOffCyclePayroll as Q } from "../payrollTypes.js";
+import { cleanupReimbursements as T } from "../helpers.js";
+import { UNSTABLE_PayrollEditEmployee as z } from "../UNSTABLE_PayrollEditEmployee/UNSTABLE_PayrollEditEmployee.js";
 import { PayrollEditEmployeePresentation as G } from "./PayrollEditEmployeePresentation.js";
-import { componentEvents as u } from "../../../shared/constants.js";
-import { BaseComponent as H } from "../../Base/Base.js";
-import { useComponentDictionary as K } from "../../../i18n/I18n.js";
-import { useBase as T } from "../../Base/useBase.js";
-function me(e) {
-  return /* @__PURE__ */ n(H, { ...e, children: /* @__PURE__ */ n(j, { ...e, children: e.children }) });
+import { useUnstableFeature as H } from "../../../contexts/UnstableFeaturesProvider/useUnstableFeature.js";
+import { componentEvents as c } from "../../../shared/constants.js";
+import { BaseComponent as K } from "../../Base/Base.js";
+import { useComponentDictionary as j } from "../../../i18n/I18n.js";
+import { useBase as F } from "../../Base/useBase.js";
+function ce(e) {
+  return H("payrollRegularRateOfPay") ? /* @__PURE__ */ t(z, { ...e }) : /* @__PURE__ */ t(K, { ...e, children: /* @__PURE__ */ t(V, { ...e, children: e.children }) });
 }
-const j = ({
+const V = ({
   employeeId: e,
-  companyId: a,
+  companyId: n,
   payrollId: s,
   onEvent: i,
   dictionary: y,
   withReimbursements: d = !0
 }) => {
-  K("Payroll.PayrollEditEmployee", y);
-  const P = q(), { LoadingIndicator: f, baseSubmitHandler: E } = T(), { data: C } = O({ employeeId: e }), { data: A } = v({
+  j("Payroll.PayrollEditEmployee", y);
+  const f = N(), { LoadingIndicator: E, baseSubmitHandler: P } = F(), { data: C } = k({ employeeId: e }), { data: R } = B({
     employeeId: e
-  }), L = B(() => [e], [e]), { preparedPayroll: t, paySchedule: R, isLoading: D } = w({
-    companyId: a,
+  }), A = x(() => [e], [e]), { preparedPayroll: r, paySchedule: L, isLoading: b } = q({
+    companyId: n,
     payrollId: s,
-    employeeUuids: L
-  }), { mutateAsync: S, isPending: _ } = x(), m = C.employee, b = t?.employeeCompensations?.at(0), g = (A.employeeBankAccounts || []).length > 0, l = N(t ?? {}), h = !Q(l), U = ({
+    employeeUuids: A
+  }), { mutateAsync: g, isPending: D } = v(), m = C.employee, S = r?.employeeCompensations?.at(0), _ = (R.employeeBankAccounts || []).length > 0, l = M(r ?? {}), O = !Q(l), U = ({
     paymentMethod: o,
-    reimbursements: r,
+    reimbursements: a,
     customWithholdings: p,
-    ...c
+    ...u
   }) => ({
-    ...c,
+    ...u,
     ...o && o !== "Historical" ? { paymentMethod: o } : {},
-    memo: c.memo || void 0,
+    memo: u.memo || void 0,
     // Off-cycle payrolls write reimbursements via the legacy fixed_compensations field; the
     // itemized array gets rejected by the `emb_off_cycle_disable_named_reimbursements` backend
     // flag (default-on globally, expected removal 2026-09-01).
     // TODO(post-2026-09-01): drop the branch once the flag is gone.
-    ...h && r ? { reimbursements: z(r) } : {}
-  }), Y = async (o) => {
-    const r = U(o);
-    await E(null, async () => {
-      const p = await S({
+    ...O && a ? { reimbursements: T(a) } : {}
+  }), h = async (o) => {
+    const a = U(o);
+    await P(null, async () => {
+      const p = await g({
         request: {
-          companyId: a,
+          companyId: n,
           payrollId: s,
           payrollUpdate: {
-            employeeCompensations: [r]
+            employeeCompensations: [a]
           }
         }
       });
-      await P.invalidateQueries({
-        queryKey: [M, s]
-      }), i(u.RUN_PAYROLL_EMPLOYEE_SAVED, {
+      await f.invalidateQueries({
+        queryKey: [w, s]
+      }), i(c.RUN_PAYROLL_EMPLOYEE_SAVED, {
         payrollPrepared: p.payrollPrepared,
         employee: m
       });
     });
-  }, k = () => {
-    i(u.RUN_PAYROLL_EMPLOYEE_CANCELLED);
+  }, Y = () => {
+    i(c.RUN_PAYROLL_EMPLOYEE_CANCELLED);
   };
-  return D ? /* @__PURE__ */ n(f, {}) : /* @__PURE__ */ n(
+  return b ? /* @__PURE__ */ t(E, {}) : /* @__PURE__ */ t(
     G,
     {
-      onSave: Y,
-      onCancel: k,
+      onSave: h,
+      onCancel: Y,
       employee: m,
-      isPending: _,
-      employeeCompensation: b,
-      fixedCompensationTypes: t?.fixedCompensationTypes || [],
-      payPeriodStartDate: t?.payPeriod?.startDate,
-      paySchedule: R,
+      isPending: D,
+      employeeCompensation: S,
+      fixedCompensationTypes: r?.fixedCompensationTypes || [],
+      payPeriodStartDate: r?.payPeriod?.startDate,
+      paySchedule: L,
       payrollCategory: l,
       withReimbursements: d,
-      hasDirectDepositSetup: g
+      hasDirectDepositSetup: _
     }
   );
 };
 export {
-  me as PayrollEditEmployee
+  ce as PayrollEditEmployee
 };
 //# sourceMappingURL=PayrollEditEmployee.js.map

package/dist/components/Payroll/PayrollEditEmployee/PayrollEditEmployee.js.map

@@ -1 +1 @@
-{"version":3,"file":"PayrollEditEmployee.js","sources":["../../../../src/components/Payroll/PayrollEditEmployee/PayrollEditEmployee.tsx"],"sourcesContent":["import { useEmployeesGetSuspense } from '@gusto/embedded-api/react-query/employeesGet'\nimport { useEmployeePaymentMethodsGetBankAccountsSuspense } from '@gusto/embedded-api/react-query/employeePaymentMethodsGetBankAccounts'\nimport { usePayrollsUpdateMutation } from '@gusto/embedded-api/react-query/payrollsUpdate'\nimport type { PayrollEmployeeCompensationsType } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype'\nimport type { PayrollUpdateEmployeeCompensations } from '@gusto/embedded-api/models/components/payrollupdate'\nimport { useMemo } from 'react'\nimport { useQueryClient } from '@tanstack/react-query'\nimport { usePreparedPayrollData } from '../usePreparedPayrollData'\nimport { PREPARE_QUERY_KEY } from '../PayrollConfiguration/usePayrollConfigurationData'\nimport { derivePayrollCategory, isOffCyclePayroll } from '../payrollTypes'\nimport { cleanupReimbursements } from '../helpers'\nimport { PayrollEditEmployeePresentation } from './PayrollEditEmployeePresentation'\nimport { componentEvents } from '@/shared/constants'\nimport type { BaseComponentInterface } from '@/components/Base/Base'\nimport { BaseComponent } from '@/components/Base/Base'\nimport { useComponentDictionary } from '@/i18n'\nimport { useBase } from '@/components/Base/useBase'\n\n/**\n * Props for {@link PayrollEditEmployee}.\n *\n * @public\n */\nexport interface PayrollEditEmployeeProps extends BaseComponentInterface<'Payroll.PayrollEditEmployee'> {\n  /** The associated employee identifier. */\n  employeeId: string\n  /** The associated company identifier. */\n  companyId: string\n  /** The associated payroll identifier. */\n  payrollId: string\n  /** Whether to show reimbursement fields. Defaults to `true`. */\n  withReimbursements?: boolean\n}\n\n/**\n * Editor for an individual employee's compensation within a payroll run.\n *\n * Allows modification of pay rates, hours, time off, additional earnings,\n * reimbursements, and payment method for a single employee on the specified payroll.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `runPayroll/employee/saved` | Fired when employee payroll compensation changes are saved | `{ payrollPrepared, employee }` |\n * | `runPayroll/employee/cancelled` | Fired when the user cancels editing employee payroll compensation | — |\n *\n * @param props - {@link PayrollEditEmployeeProps} plus base component props.\n * @returns The employee compensation editor.\n * @public\n *\n * @example\n * ```tsx\n * import { Payroll } from '@gusto/embedded-react-sdk'\n *\n * function MyComponent() {\n *   return (\n *     <Payroll.PayrollEditEmployee\n *       employeeId=\"your-employee-id\"\n *       companyId=\"your-company-id\"\n *       payrollId=\"your-payroll-id\"\n *       onEvent={() => {}}\n *     />\n *   )\n * }\n * ```\n */\nexport function PayrollEditEmployee(props: PayrollEditEmployeeProps) {\n  return (\n    <BaseComponent {...props}>\n      <Root {...props}>{props.children}</Root>\n    </BaseComponent>\n  )\n}\n\nconst Root = ({\n  employeeId,\n  companyId,\n  payrollId,\n  onEvent,\n  dictionary,\n  withReimbursements = true,\n}: PayrollEditEmployeeProps) => {\n  useComponentDictionary('Payroll.PayrollEditEmployee', dictionary)\n\n  const queryClient = useQueryClient()\n  const { LoadingIndicator, baseSubmitHandler } = useBase()\n\n  const { data: employeeData } = useEmployeesGetSuspense({ employeeId })\n  const { data: bankAccountsList } = useEmployeePaymentMethodsGetBankAccountsSuspense({\n    employeeId,\n  })\n  const memoizedEmployeeId = useMemo(() => [employeeId], [employeeId])\n  const { preparedPayroll, paySchedule, isLoading } = usePreparedPayrollData({\n    companyId,\n    payrollId,\n    employeeUuids: memoizedEmployeeId,\n  })\n\n  const { mutateAsync: updatePayroll, isPending } = usePayrollsUpdateMutation()\n\n  const employee = employeeData.employee!\n  const employeeCompensation = preparedPayroll?.employeeCompensations?.at(0)\n  const bankAccounts = bankAccountsList.employeeBankAccounts || []\n  const hasDirectDepositSetup = bankAccounts.length > 0\n  const payrollCategory = derivePayrollCategory(preparedPayroll ?? {})\n  const usesItemizedReimbursements = !isOffCyclePayroll(payrollCategory)\n\n  const transformEmployeeCompensation = ({\n    paymentMethod,\n    reimbursements,\n    customWithholdings,\n    ...compensation\n  }: PayrollEmployeeCompensationsType): PayrollUpdateEmployeeCompensations => {\n    return {\n      ...compensation,\n      ...(paymentMethod && paymentMethod !== 'Historical' ? { paymentMethod } : {}),\n      memo: compensation.memo || undefined,\n      // Off-cycle payrolls write reimbursements via the legacy fixed_compensations field; the\n      // itemized array gets rejected by the `emb_off_cycle_disable_named_reimbursements` backend\n      // flag (default-on globally, expected removal 2026-09-01).\n      // TODO(post-2026-09-01): drop the branch once the flag is gone.\n      ...(usesItemizedReimbursements && reimbursements\n        ? { reimbursements: cleanupReimbursements(reimbursements) }\n        : {}),\n    }\n  }\n\n  const onSave = async (updatedCompensation: PayrollEmployeeCompensationsType) => {\n    const transformedCompensation = transformEmployeeCompensation(updatedCompensation)\n    await baseSubmitHandler(null, async () => {\n      const result = await updatePayroll({\n        request: {\n          companyId,\n          payrollId,\n          payrollUpdate: {\n            employeeCompensations: [transformedCompensation],\n          },\n        },\n      })\n\n      await queryClient.invalidateQueries({\n        queryKey: [PREPARE_QUERY_KEY, payrollId],\n      })\n\n      onEvent(componentEvents.RUN_PAYROLL_EMPLOYEE_SAVED, {\n        payrollPrepared: result.payrollPrepared,\n        employee,\n      })\n    })\n  }\n\n  const onCancel = () => {\n    onEvent(componentEvents.RUN_PAYROLL_EMPLOYEE_CANCELLED)\n  }\n\n  if (isLoading) {\n    return <LoadingIndicator />\n  }\n\n  return (\n    <PayrollEditEmployeePresentation\n      onSave={onSave}\n      onCancel={onCancel}\n      employee={employee}\n      isPending={isPending}\n      employeeCompensation={employeeCompensation}\n      fixedCompensationTypes={preparedPayroll?.fixedCompensationTypes || []}\n      payPeriodStartDate={preparedPayroll?.payPeriod?.startDate}\n      paySchedule={paySchedule}\n      payrollCategory={payrollCategory}\n      withReimbursements={withReimbursements}\n      hasDirectDepositSetup={hasDirectDepositSetup}\n    />\n  )\n}\n"],"names":["PayrollEditEmployee","props","jsx","BaseComponent","Root","employeeId","companyId","payrollId","onEvent","dictionary","withReimbursements","useComponentDictionary","queryClient","useQueryClient","LoadingIndicator","baseSubmitHandler","useBase","employeeData","useEmployeesGetSuspense","bankAccountsList","useEmployeePaymentMethodsGetBankAccountsSuspense","memoizedEmployeeId","useMemo","preparedPayroll","paySchedule","isLoading","usePreparedPayrollData","updatePayroll","isPending","usePayrollsUpdateMutation","employee","employeeCompensation","hasDirectDepositSetup","payrollCategory","derivePayrollCategory","usesItemizedReimbursements","isOffCyclePayroll","transformEmployeeCompensation","paymentMethod","reimbursements","customWithholdings","compensation","cleanupReimbursements","onSave","updatedCompensation","transformedCompensation","result","PREPARE_QUERY_KEY","componentEvents","onCancel","PayrollEditEmployeePresentation"],"mappings":";;;;;;;;;;;;;;;AAkEO,SAASA,GAAoBC,GAAiC;AACnE,SACE,gBAAAC,EAACC,GAAA,EAAe,GAAGF,GACjB,UAAA,gBAAAC,EAACE,KAAM,GAAGH,GAAQ,UAAAA,EAAM,SAAA,CAAS,EAAA,CACnC;AAEJ;AAEA,MAAMG,IAAO,CAAC;AAAA,EACZ,YAAAC;AAAA,EACA,WAAAC;AAAA,EACA,WAAAC;AAAA,EACA,SAAAC;AAAA,EACA,YAAAC;AAAA,EACA,oBAAAC,IAAqB;AACvB,MAAgC;AAC9B,EAAAC,EAAuB,+BAA+BF,CAAU;AAEhE,QAAMG,IAAcC,EAAA,GACd,EAAE,kBAAAC,GAAkB,mBAAAC,EAAA,IAAsBC,EAAA,GAE1C,EAAE,MAAMC,EAAA,IAAiBC,EAAwB,EAAE,YAAAb,GAAY,GAC/D,EAAE,MAAMc,EAAA,IAAqBC,EAAiD;AAAA,IAClF,YAAAf;AAAA,EAAA,CACD,GACKgB,IAAqBC,EAAQ,MAAM,CAACjB,CAAU,GAAG,CAACA,CAAU,CAAC,GAC7D,EAAE,iBAAAkB,GAAiB,aAAAC,GAAa,WAAAC,EAAA,IAAcC,EAAuB;AAAA,IACzE,WAAApB;AAAA,IACA,WAAAC;AAAA,IACA,eAAec;AAAA,EAAA,CAChB,GAEK,EAAE,aAAaM,GAAe,WAAAC,EAAA,IAAcC,EAAA,GAE5CC,IAAWb,EAAa,UACxBc,IAAuBR,GAAiB,uBAAuB,GAAG,CAAC,GAEnES,KADeb,EAAiB,wBAAwB,CAAA,GACnB,SAAS,GAC9Cc,IAAkBC,EAAsBX,KAAmB,EAAE,GAC7DY,IAA6B,CAACC,EAAkBH,CAAe,GAE/DI,IAAgC,CAAC;AAAA,IACrC,eAAAC;AAAA,IACA,gBAAAC;AAAA,IACA,oBAAAC;AAAA,IACA,GAAGC;AAAA,EAAA,OAEI;AAAA,IACL,GAAGA;AAAA,IACH,GAAIH,KAAiBA,MAAkB,eAAe,EAAE,eAAAA,EAAA,IAAkB,CAAA;AAAA,IAC1E,MAAMG,EAAa,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA,IAK3B,GAAIN,KAA8BI,IAC9B,EAAE,gBAAgBG,EAAsBH,CAAc,MACtD,CAAA;AAAA,EAAC,IAIHI,IAAS,OAAOC,MAA0D;AAC9E,UAAMC,IAA0BR,EAA8BO,CAAmB;AACjF,UAAM7B,EAAkB,MAAM,YAAY;AACxC,YAAM+B,IAAS,MAAMnB,EAAc;AAAA,QACjC,SAAS;AAAA,UACP,WAAArB;AAAA,UACA,WAAAC;AAAA,UACA,eAAe;AAAA,YACb,uBAAuB,CAACsC,CAAuB;AAAA,UAAA;AAAA,QACjD;AAAA,MACF,CACD;AAED,YAAMjC,EAAY,kBAAkB;AAAA,QAClC,UAAU,CAACmC,GAAmBxC,CAAS;AAAA,MAAA,CACxC,GAEDC,EAAQwC,EAAgB,4BAA4B;AAAA,QAClD,iBAAiBF,EAAO;AAAA,QACxB,UAAAhB;AAAA,MAAA,CACD;AAAA,IACH,CAAC;AAAA,EACH,GAEMmB,IAAW,MAAM;AACrB,IAAAzC,EAAQwC,EAAgB,8BAA8B;AAAA,EACxD;AAEA,SAAIvB,sBACMX,GAAA,EAAiB,IAIzB,gBAAAZ;AAAA,IAACgD;AAAA,IAAA;AAAA,MACC,QAAAP;AAAA,MACA,UAAAM;AAAA,MACA,UAAAnB;AAAA,MACA,WAAAF;AAAA,MACA,sBAAAG;AAAA,MACA,wBAAwBR,GAAiB,0BAA0B,CAAA;AAAA,MACnE,oBAAoBA,GAAiB,WAAW;AAAA,MAChD,aAAAC;AAAA,MACA,iBAAAS;AAAA,MACA,oBAAAvB;AAAA,MACA,uBAAAsB;AAAA,IAAA;AAAA,EAAA;AAGN;"}
+{"version":3,"file":"PayrollEditEmployee.js","sources":["../../../../src/components/Payroll/PayrollEditEmployee/PayrollEditEmployee.tsx"],"sourcesContent":["import { useEmployeesGetSuspense } from '@gusto/embedded-api/react-query/employeesGet'\nimport { useEmployeePaymentMethodsGetBankAccountsSuspense } from '@gusto/embedded-api/react-query/employeePaymentMethodsGetBankAccounts'\nimport { usePayrollsUpdateMutation } from '@gusto/embedded-api/react-query/payrollsUpdate'\nimport type { PayrollEmployeeCompensationsType } from '@gusto/embedded-api/models/components/payrollemployeecompensationstype'\nimport type { PayrollUpdateEmployeeCompensations } from '@gusto/embedded-api/models/components/payrollupdate'\nimport { useMemo } from 'react'\nimport { useQueryClient } from '@tanstack/react-query'\nimport { usePreparedPayrollData } from '../usePreparedPayrollData'\nimport { PREPARE_QUERY_KEY } from '../PayrollConfiguration/usePayrollConfigurationData'\nimport { derivePayrollCategory, isOffCyclePayroll } from '../payrollTypes'\nimport { cleanupReimbursements } from '../helpers'\nimport { UNSTABLE_PayrollEditEmployee } from '../UNSTABLE_PayrollEditEmployee/UNSTABLE_PayrollEditEmployee'\nimport { PayrollEditEmployeePresentation } from './PayrollEditEmployeePresentation'\nimport { useUnstableFeature } from '@/contexts/UnstableFeaturesProvider/useUnstableFeature'\nimport { componentEvents } from '@/shared/constants'\nimport type { BaseComponentInterface } from '@/components/Base/Base'\nimport { BaseComponent } from '@/components/Base/Base'\nimport { useComponentDictionary } from '@/i18n'\nimport { useBase } from '@/components/Base/useBase'\n\n/**\n * Props for {@link PayrollEditEmployee}.\n *\n * @public\n */\nexport interface PayrollEditEmployeeProps extends BaseComponentInterface<'Payroll.PayrollEditEmployee'> {\n  /** The associated employee identifier. */\n  employeeId: string\n  /** The associated company identifier. */\n  companyId: string\n  /** The associated payroll identifier. */\n  payrollId: string\n  /** Whether to show reimbursement fields. Defaults to `true`. */\n  withReimbursements?: boolean\n}\n\n/**\n * Editor for an individual employee's compensation within a payroll run.\n *\n * Allows modification of pay rates, hours, time off, additional earnings,\n * reimbursements, and payment method for a single employee on the specified payroll.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `runPayroll/employee/saved` | Fired when employee payroll compensation changes are saved | `{ payrollPrepared, employee }` |\n * | `runPayroll/employee/cancelled` | Fired when the user cancels editing employee payroll compensation | — |\n *\n * @param props - {@link PayrollEditEmployeeProps} plus base component props.\n * @returns The employee compensation editor.\n * @public\n *\n * @example\n * ```tsx\n * import { Payroll } from '@gusto/embedded-react-sdk'\n *\n * function MyComponent() {\n *   return (\n *     <Payroll.PayrollEditEmployee\n *       employeeId=\"your-employee-id\"\n *       companyId=\"your-company-id\"\n *       payrollId=\"your-payroll-id\"\n *       onEvent={() => {}}\n *     />\n *   )\n * }\n * ```\n */\nexport function PayrollEditEmployee(props: PayrollEditEmployeeProps) {\n  const isRegularRateOfPayEnabled = useUnstableFeature('payrollRegularRateOfPay')\n\n  if (isRegularRateOfPayEnabled) {\n    return <UNSTABLE_PayrollEditEmployee {...props} />\n  }\n\n  return (\n    <BaseComponent {...props}>\n      <Root {...props}>{props.children}</Root>\n    </BaseComponent>\n  )\n}\n\nconst Root = ({\n  employeeId,\n  companyId,\n  payrollId,\n  onEvent,\n  dictionary,\n  withReimbursements = true,\n}: PayrollEditEmployeeProps) => {\n  useComponentDictionary('Payroll.PayrollEditEmployee', dictionary)\n\n  const queryClient = useQueryClient()\n  const { LoadingIndicator, baseSubmitHandler } = useBase()\n\n  const { data: employeeData } = useEmployeesGetSuspense({ employeeId })\n  const { data: bankAccountsList } = useEmployeePaymentMethodsGetBankAccountsSuspense({\n    employeeId,\n  })\n  const memoizedEmployeeId = useMemo(() => [employeeId], [employeeId])\n  const { preparedPayroll, paySchedule, isLoading } = usePreparedPayrollData({\n    companyId,\n    payrollId,\n    employeeUuids: memoizedEmployeeId,\n  })\n\n  const { mutateAsync: updatePayroll, isPending } = usePayrollsUpdateMutation()\n\n  const employee = employeeData.employee!\n  const employeeCompensation = preparedPayroll?.employeeCompensations?.at(0)\n  const bankAccounts = bankAccountsList.employeeBankAccounts || []\n  const hasDirectDepositSetup = bankAccounts.length > 0\n  const payrollCategory = derivePayrollCategory(preparedPayroll ?? {})\n  const usesItemizedReimbursements = !isOffCyclePayroll(payrollCategory)\n\n  const transformEmployeeCompensation = ({\n    paymentMethod,\n    reimbursements,\n    customWithholdings,\n    ...compensation\n  }: PayrollEmployeeCompensationsType): PayrollUpdateEmployeeCompensations => {\n    return {\n      ...compensation,\n      ...(paymentMethod && paymentMethod !== 'Historical' ? { paymentMethod } : {}),\n      memo: compensation.memo || undefined,\n      // Off-cycle payrolls write reimbursements via the legacy fixed_compensations field; the\n      // itemized array gets rejected by the `emb_off_cycle_disable_named_reimbursements` backend\n      // flag (default-on globally, expected removal 2026-09-01).\n      // TODO(post-2026-09-01): drop the branch once the flag is gone.\n      ...(usesItemizedReimbursements && reimbursements\n        ? { reimbursements: cleanupReimbursements(reimbursements) }\n        : {}),\n    }\n  }\n\n  const onSave = async (updatedCompensation: PayrollEmployeeCompensationsType) => {\n    const transformedCompensation = transformEmployeeCompensation(updatedCompensation)\n    await baseSubmitHandler(null, async () => {\n      const result = await updatePayroll({\n        request: {\n          companyId,\n          payrollId,\n          payrollUpdate: {\n            employeeCompensations: [transformedCompensation],\n          },\n        },\n      })\n\n      await queryClient.invalidateQueries({\n        queryKey: [PREPARE_QUERY_KEY, payrollId],\n      })\n\n      onEvent(componentEvents.RUN_PAYROLL_EMPLOYEE_SAVED, {\n        payrollPrepared: result.payrollPrepared,\n        employee,\n      })\n    })\n  }\n\n  const onCancel = () => {\n    onEvent(componentEvents.RUN_PAYROLL_EMPLOYEE_CANCELLED)\n  }\n\n  if (isLoading) {\n    return <LoadingIndicator />\n  }\n\n  return (\n    <PayrollEditEmployeePresentation\n      onSave={onSave}\n      onCancel={onCancel}\n      employee={employee}\n      isPending={isPending}\n      employeeCompensation={employeeCompensation}\n      fixedCompensationTypes={preparedPayroll?.fixedCompensationTypes || []}\n      payPeriodStartDate={preparedPayroll?.payPeriod?.startDate}\n      paySchedule={paySchedule}\n      payrollCategory={payrollCategory}\n      withReimbursements={withReimbursements}\n      hasDirectDepositSetup={hasDirectDepositSetup}\n    />\n  )\n}\n"],"names":["PayrollEditEmployee","props","useUnstableFeature","jsx","UNSTABLE_PayrollEditEmployee","BaseComponent","Root","employeeId","companyId","payrollId","onEvent","dictionary","withReimbursements","useComponentDictionary","queryClient","useQueryClient","LoadingIndicator","baseSubmitHandler","useBase","employeeData","useEmployeesGetSuspense","bankAccountsList","useEmployeePaymentMethodsGetBankAccountsSuspense","memoizedEmployeeId","useMemo","preparedPayroll","paySchedule","isLoading","usePreparedPayrollData","updatePayroll","isPending","usePayrollsUpdateMutation","employee","employeeCompensation","hasDirectDepositSetup","payrollCategory","derivePayrollCategory","usesItemizedReimbursements","isOffCyclePayroll","transformEmployeeCompensation","paymentMethod","reimbursements","customWithholdings","compensation","cleanupReimbursements","onSave","updatedCompensation","transformedCompensation","result","PREPARE_QUERY_KEY","componentEvents","onCancel","PayrollEditEmployeePresentation"],"mappings":";;;;;;;;;;;;;;;;;AAoEO,SAASA,GAAoBC,GAAiC;AAGnE,SAFkCC,EAAmB,yBAAyB,IAGrE,gBAAAC,EAACC,GAAA,EAA8B,GAAGH,EAAA,CAAO,IAIhD,gBAAAE,EAACE,GAAA,EAAe,GAAGJ,GACjB,UAAA,gBAAAE,EAACG,KAAM,GAAGL,GAAQ,UAAAA,EAAM,SAAA,CAAS,EAAA,CACnC;AAEJ;AAEA,MAAMK,IAAO,CAAC;AAAA,EACZ,YAAAC;AAAA,EACA,WAAAC;AAAA,EACA,WAAAC;AAAA,EACA,SAAAC;AAAA,EACA,YAAAC;AAAA,EACA,oBAAAC,IAAqB;AACvB,MAAgC;AAC9B,EAAAC,EAAuB,+BAA+BF,CAAU;AAEhE,QAAMG,IAAcC,EAAA,GACd,EAAE,kBAAAC,GAAkB,mBAAAC,EAAA,IAAsBC,EAAA,GAE1C,EAAE,MAAMC,EAAA,IAAiBC,EAAwB,EAAE,YAAAb,GAAY,GAC/D,EAAE,MAAMc,EAAA,IAAqBC,EAAiD;AAAA,IAClF,YAAAf;AAAA,EAAA,CACD,GACKgB,IAAqBC,EAAQ,MAAM,CAACjB,CAAU,GAAG,CAACA,CAAU,CAAC,GAC7D,EAAE,iBAAAkB,GAAiB,aAAAC,GAAa,WAAAC,EAAA,IAAcC,EAAuB;AAAA,IACzE,WAAApB;AAAA,IACA,WAAAC;AAAA,IACA,eAAec;AAAA,EAAA,CAChB,GAEK,EAAE,aAAaM,GAAe,WAAAC,EAAA,IAAcC,EAAA,GAE5CC,IAAWb,EAAa,UACxBc,IAAuBR,GAAiB,uBAAuB,GAAG,CAAC,GAEnES,KADeb,EAAiB,wBAAwB,CAAA,GACnB,SAAS,GAC9Cc,IAAkBC,EAAsBX,KAAmB,EAAE,GAC7DY,IAA6B,CAACC,EAAkBH,CAAe,GAE/DI,IAAgC,CAAC;AAAA,IACrC,eAAAC;AAAA,IACA,gBAAAC;AAAA,IACA,oBAAAC;AAAA,IACA,GAAGC;AAAA,EAAA,OAEI;AAAA,IACL,GAAGA;AAAA,IACH,GAAIH,KAAiBA,MAAkB,eAAe,EAAE,eAAAA,EAAA,IAAkB,CAAA;AAAA,IAC1E,MAAMG,EAAa,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA,IAK3B,GAAIN,KAA8BI,IAC9B,EAAE,gBAAgBG,EAAsBH,CAAc,MACtD,CAAA;AAAA,EAAC,IAIHI,IAAS,OAAOC,MAA0D;AAC9E,UAAMC,IAA0BR,EAA8BO,CAAmB;AACjF,UAAM7B,EAAkB,MAAM,YAAY;AACxC,YAAM+B,IAAS,MAAMnB,EAAc;AAAA,QACjC,SAAS;AAAA,UACP,WAAArB;AAAA,UACA,WAAAC;AAAA,UACA,eAAe;AAAA,YACb,uBAAuB,CAACsC,CAAuB;AAAA,UAAA;AAAA,QACjD;AAAA,MACF,CACD;AAED,YAAMjC,EAAY,kBAAkB;AAAA,QAClC,UAAU,CAACmC,GAAmBxC,CAAS;AAAA,MAAA,CACxC,GAEDC,EAAQwC,EAAgB,4BAA4B;AAAA,QAClD,iBAAiBF,EAAO;AAAA,QACxB,UAAAhB;AAAA,MAAA,CACD;AAAA,IACH,CAAC;AAAA,EACH,GAEMmB,IAAW,MAAM;AACrB,IAAAzC,EAAQwC,EAAgB,8BAA8B;AAAA,EACxD;AAEA,SAAIvB,sBACMX,GAAA,EAAiB,IAIzB,gBAAAb;AAAA,IAACiD;AAAA,IAAA;AAAA,MACC,QAAAP;AAAA,MACA,UAAAM;AAAA,MACA,UAAAnB;AAAA,MACA,WAAAF;AAAA,MACA,sBAAAG;AAAA,MACA,wBAAwBR,GAAiB,0BAA0B,CAAA;AAAA,MACnE,oBAAoBA,GAAiB,WAAW;AAAA,MAChD,aAAAC;AAAA,MACA,iBAAAS;AAAA,MACA,oBAAAvB;AAAA,MACA,uBAAAsB;AAAA,IAAA;AAAA,EAAA;AAGN;"}