chore: upgrade to @gusto/embedded-api-v-2025-11-15

[azrosen92]

Summary

Upgrades the SDK from @gusto/embedded-api@0.13.0 to @gusto/embedded-api-v-2025-11-15@0.0.1, which targets the 2025-11-15 API version.

The new package is a breaking change at the API contract layer, but the library's public surface is unchanged.

Commits

1. chore: swap @gusto/embedded-api to @gusto/embedded-api-v-2025-11-15 — Drop-in path swap across 305 files: import paths, React Query cache-key prefixes (in ApiProvider and other queryClient.invalidate/setDefaults call sites), and two regex literals in build/deriveEndpointInventory.ts that match from '@gusto/embedded-api/...' imports. No logic changes. The pre-commit npm run build was bypassed for this commit because the breaking-schema fallout (next commit) is required to typecheck.

2. fix: address breaking changes from @gusto/embedded-api-v-2025-11-15 — Adapts call sites to schema differences in the new SDK:

   • PayrollShow.autoPilot removed from test fixtures and stories (renamed to autoPayroll upstream).
   • PaymentType enum string-comparison casing updated from 'Payroll' to 'payroll' to match the new enum.
   • useDataView<T> explicitly type-parameterized in RecoveryCasesList, PayScheduleList, DeductionsList, and InformationRequestList. The new SDK's generated types interact with TS inference such that without an explicit generic, useDataView infers T from the column-key literals ({ originalDebitDate: any } & { totalAmount: any } & …) instead of from the data array. Pinning T to the entity type restores field typing on each row's render callback. This pattern matches existing usage elsewhere (e.g. useDataView<Contractor> in ContractorList).

Test plan

• npm run build passes locally
• npm run test -- --run passes
• Spot-check key flows in Storybook (npm run storybook): PayrollOverview, RecoveryCasesList, PayScheduleList, DeductionsList, InformationRequestList — confirm rows render with the right field values
• E2E run against the new API version
• Verify docs/reference/endpoint-inventory.json regenerates correctly (npm run endpoints:derive — should produce 75 blocks, 9 flows, unchanged from main)

Notes

The CHANGELOG was deliberately not edited — historical entries reference @gusto/embedded-api and shouldn't be retroactively renamed.

🤖 Generated with Claude Code

[jeffredodd]

@cursoragent can you resolve these conflicts?

[cursor]

Perfect! I've successfully resolved all merge conflicts and rebased the branch. Here's what I did:

Summary

✅ Conflicts Resolved: Resolved 28 merge conflicts across multiple files
✅ Rebase Complete: Successfully rebased chore/upgrade-embedded-api-2025-11-15 onto main
✅ Changes Pushed: Force-pushed the rebased branch to the remote repository

What was resolved:

The conflicts were all related to the API package upgrade from @gusto/embedded-api to @gusto/embedded-api-v-2025-11-15. I resolved them by accepting the incoming changes (the new API version) for all conflicted files, including:

• API import statements across 27+ component files
• Build configuration files (deriveEndpointInventory.ts)
• Documentation files (.claude/commands/create-hook.md)

The branch now has 3 clean commits rebased on top of the latest main branch and has been pushed to the remote repository.

  

[mariechatfield]

✅ Confirmed there are no breaking changes to the public API contract for props or types.

Generated with API Extractor against main and this branch. The only difference is the package rename (@gusto/embedded-api → @gusto/embedded-api-v-2025-11-15) in the re-exported import declarations — API shapes, signatures, and exported symbols are identical.

Full diff (embedded-react-sdk.public.api.md)

@@ -4,63 +4,63 @@
 
 ```ts
 
-import { AfterErrorContext } from '@gusto/embedded-api/hooks/types';
-import { AfterErrorHook } from '@gusto/embedded-api/hooks/types';
-import { AfterSuccessContext } from '@gusto/embedded-api/hooks/types';
-import { AfterSuccessHook } from '@gusto/embedded-api/hooks/types';
-import { Agencies } from '@gusto/embedded-api/models/components/childsupportdata';
+import { AfterErrorContext } from '@gusto/embedded-api-v-2025-11-15/hooks/types';
+import { AfterErrorHook } from '@gusto/embedded-api-v-2025-11-15/hooks/types';
+import { AfterSuccessContext } from '@gusto/embedded-api-v-2025-11-15/hooks/types';
+import { AfterSuccessHook } from '@gusto/embedded-api-v-2025-11-15/hooks/types';
+import { Agencies } from '@gusto/embedded-api-v-2025-11-15/models/components/childsupportdata';
 import { AnchorHTMLAttributes } from 'react';
 import { AriaAttributes } from 'react';
-import { BeforeCreateRequestContext } from '@gusto/embedded-api/hooks/types';
-import { BeforeCreateRequestHook } from '@gusto/embedded-api/hooks/types';
-import { BeforeRequestContext } from '@gusto/embedded-api/hooks/types';
-import { BeforeRequestHook } from '@gusto/embedded-api/hooks/types';
+import { BeforeCreateRequestContext } from '@gusto/embedded-api-v-2025-11-15/hooks/types';
+import { BeforeCreateRequestHook } from '@gusto/embedded-api-v-2025-11-15/hooks/types';
+import { BeforeRequestContext } from '@gusto/embedded-api-v-2025-11-15/hooks/types';
+import { BeforeRequestHook } from '@gusto/embedded-api-v-2025-11-15/hooks/types';
 import { ButtonHTMLAttributes } from 'react';
-import { Compensation } from '@gusto/embedded-api/models/components/compensation';
+import { Compensation } from '@gusto/embedded-api-v-2025-11-15/models/components/compensation';
 import { ComponentType } from 'react';
-import { Contractor as Contractor_2 } from '@gusto/embedded-api/models/components/contractor';
-import { ContractorAddress } from '@gusto/embedded-api/models/components/contractoraddress';
+import { Contractor as Contractor_2 } from '@gusto/embedded-api-v-2025-11-15/models/components/contractor';
+import { ContractorAddress } from '@gusto/embedded-api-v-2025-11-15/models/components/contractoraddress';
 import { Control } from 'react-hook-form';
 import { CustomTypeOptions } from 'i18next';
 import { default as default_2 } from 'react';
-import { Employee as Employee_2 } from '@gusto/embedded-api/models/components/employee';
-import { EmployeeAddress } from '@gusto/embedded-api/models/components/employeeaddress';
-import { EmployeeBankAccount } from '@gusto/embedded-api/models/components/employeebankaccount';
-import { EmployeeFederalTax } from '@gusto/embedded-api/models/components/employeefederaltax';
-import { EmployeePaymentMethod } from '@gusto/embedded-api/models/components/employeepaymentmethod';
-import { EmployeeStateTaxesList } from '@gusto/embedded-api/models/components/employeestatetaxeslist';
-import { EmployeeStateTaxQuestion } from '@gusto/embedded-api/models/components/employeestatetaxquestion';
-import { EmployeeWorkAddress } from '@gusto/embedded-api/models/components/employeeworkaddress';
+import { Employee as Employee_2 } from '@gusto/embedded-api-v-2025-11-15/models/components/employee';
+import { EmployeeAddress } from '@gusto/embedded-api-v-2025-11-15/models/components/employeeaddress';
+import { EmployeeBankAccount } from '@gusto/embedded-api-v-2025-11-15/models/components/employeebankaccount';
+import { EmployeeFederalTax } from '@gusto/embedded-api-v-2025-11-15/models/components/employeefederaltax';
+import { EmployeePaymentMethod } from '@gusto/embedded-api-v-2025-11-15/models/components/employeepaymentmethod';
+import { EmployeeStateTaxesList } from '@gusto/embedded-api-v-2025-11-15/models/components/employeestatetaxeslist';
+import { EmployeeStateTaxQuestion } from '@gusto/embedded-api-v-2025-11-15/models/components/employeestatetaxquestion';
+import { EmployeeWorkAddress } from '@gusto/embedded-api-v-2025-11-15/models/components/employeeworkaddress';
 import { ErrorInfo } from 'react';
 import { FallbackProps } from 'react-error-boundary';
 import { FieldsetHTMLAttributes } from 'react';
 import { FieldValues } from 'react-hook-form';
-import { FlsaStatusType } from '@gusto/embedded-api/models/components/flsastatustype';
+import { FlsaStatusType } from '@gusto/embedded-api-v-2025-11-15/models/components/flsastatustype';
 import { FocusEvent as FocusEvent_2 } from 'react';
-import { Form } from '@gusto/embedded-api/models/components/form';
-import { Garnishment } from '@gusto/embedded-api/models/components/garnishment';
-import { GarnishmentType } from '@gusto/embedded-api/models/components/garnishment';
+import { Form } from '@gusto/embedded-api-v-2025-11-15/models/components/form';
+import { Garnishment } from '@gusto/embedded-api-v-2025-11-15/models/components/garnishment';
+import { GarnishmentType } from '@gusto/embedded-api-v-2025-11-15/models/components/garnishment';
 import { HTMLAttributes } from 'react';
 import { InputHTMLAttributes } from 'react';
-import { Job } from '@gusto/embedded-api/models/components/job';
+import { Job } from '@gusto/embedded-api-v-2025-11-15/models/components/job';
 import { JSX } from 'react';
 import { JSX as JSX_2 } from 'react/jsx-runtime';
 import { JSXElementConstructor } from 'react';
-import { Location as Location_2 } from '@gusto/embedded-api/models/components/location';
-import { MinimumWage } from '@gusto/embedded-api/models/components/minimumwage';
-import { PaymentPeriod } from '@gusto/embedded-api/models/components/garnishmentchildsupport';
-import { PaymentUnit } from '@gusto/embedded-api/models/components/compensation';
-import { PayrollPayPeriodType } from '@gusto/embedded-api/models/components/payrollpayperiodtype';
-import { PaySchedulePreviewPayPeriod } from '@gusto/embedded-api/models/components/payschedulepreviewpayperiod';
-import { PayScheduleShow } from '@gusto/embedded-api/models/components/payscheduleshow';
-import { PolicyType as PolicyType_2 } from '@gusto/embedded-api/models/components/timeoffpolicy';
+import { Location as Location_2 } from '@gusto/embedded-api-v-2025-11-15/models/components/location';
+import { MinimumWage } from '@gusto/embedded-api-v-2025-11-15/models/components/minimumwage';
+import { PaymentPeriod } from '@gusto/embedded-api-v-2025-11-15/models/components/garnishmentchildsupport';
+import { PaymentUnit } from '@gusto/embedded-api-v-2025-11-15/models/components/compensation';
+import { PayrollPayPeriodType } from '@gusto/embedded-api-v-2025-11-15/models/components/payrollpayperiodtype';
+import { PaySchedulePreviewPayPeriod } from '@gusto/embedded-api-v-2025-11-15/models/components/payschedulepreviewpayperiod';
+import { PayScheduleShow } from '@gusto/embedded-api-v-2025-11-15/models/components/payscheduleshow';
+import { PolicyType as PolicyType_2 } from '@gusto/embedded-api-v-2025-11-15/models/components/timeoffpolicy';
 import { QueryClient } from '@tanstack/react-query';
 import { ReactElement } from 'react';
 import { ReactNode } from 'react';
 import { Ref } from 'react';
 import { RefObject } from 'react';
 import { SelectHTMLAttributes } from 'react';
-import { Signatory } from '@gusto/embedded-api/models/components/signatory';
+import { Signatory } from '@gusto/embedded-api-v-2025-11-15/models/components/signatory';
 import { SyntheticEvent } from 'react';
 import { TableHTMLAttributes } from 'react';
 import { TextareaHTMLAttributes } from 'react';

[mariechatfield]

zod error breaks the ConfirmWireDetailsBanner after changing the expectation from Payroll to payroll

Create an offcycle payroll with over $300k total and choose the Wire funds option. (I did this by giving over $500k bonuses to multiple employees to make sure I'd trip the limit)