@gusto/embedded-react-sdk 0.56.5 → 0.56.7-rc.1

package/dist/src/components/Payroll/PayrollList/__fixtures__/payrollListMocks.d.ts

@@ -0,0 +1,67 @@
+import { HttpHandler, HttpResponseResolver } from 'msw';
+/**
+ * Shared, parameterizable mock data + MSW handlers for the PayrollList container tests.
+ *
+ * All shapes are the snake_case JSON the API returns (the SDK client normalizes
+ * to camelCase), so these plug directly into MSW resolvers.
+ */
+export declare const COMPANY_ID = "company-123";
+export declare const createListPayroll: (overrides?: Record<string, unknown>) => {
+    payroll_uuid: string;
+    processed: boolean;
+    off_cycle: boolean;
+    external: boolean;
+    payroll_type: string;
+    check_date: string;
+    payroll_deadline: string;
+    pay_period: {
+        start_date: string;
+        end_date: string;
+        pay_schedule_uuid: string;
+    };
+};
+export declare const createOffCyclePayroll: (offCycleReason: string, overrides?: Record<string, unknown>) => {
+    payroll_uuid: string;
+    processed: boolean;
+    off_cycle: boolean;
+    external: boolean;
+    payroll_type: string;
+    check_date: string;
+    payroll_deadline: string;
+    pay_period: {
+        start_date: string;
+        end_date: string;
+        pay_schedule_uuid: string;
+    };
+};
+export declare const createPaySchedule: (overrides?: Record<string, unknown>) => {
+    uuid: string;
+    frequency: string;
+    anchor_pay_date: string;
+    anchor_end_of_pay_period: string;
+    custom_name: string;
+    active: boolean;
+    version: string;
+};
+export declare const createTransitionPayPeriod: () => {
+    start_date: string;
+    end_date: string;
+    pay_schedule_uuid: string;
+    payroll: {
+        processed: boolean;
+        payroll_type: string;
+    };
+};
+interface PayrollListHandlerOptions {
+    payrolls?: Array<Record<string, unknown>>;
+    payrollsHeaders?: Record<string, string>;
+    payrollsResolver?: HttpResponseResolver;
+    paySchedules?: Array<Record<string, unknown>>;
+    blockers?: Array<Record<string, unknown>>;
+    wireInRequests?: Array<Record<string, unknown>>;
+    payPeriods?: Array<Record<string, unknown>>;
+}
+export declare const buildPayrollListHandlers: ({ payrolls, payrollsHeaders, payrollsResolver, paySchedules, blockers, wireInRequests, payPeriods, }?: PayrollListHandlerOptions) => HttpHandler[];
+export declare const handleSkipPayroll: (resolver: HttpResponseResolver) => HttpHandler;
+export declare const handleDeletePayroll: (resolver: HttpResponseResolver) => HttpHandler;
+export {};

package/dist/src/contexts/ApiProvider/createSdkQueryClient.d.ts

@@ -5,6 +5,8 @@ import { QueryClient } from '@tanstack/react-query';
  * @remarks
  * Defaults applied:
  * - `retry: false` on both queries and mutations.
+ * - `networkMode: 'always'` on both queries and mutations, so requests made while the browser reports offline fail with an error instead of
+ *   staying paused (and showing an indefinite loading state) until connectivity returns.
  * - On any successful mutation, every SDK query under the namespace is invalidated so the next read refetches fresh data.
  *
  * {@link ApiProvider} uses this when no `queryClient` prop is supplied, and `GustoTestProvider` uses it so tests faithfully replicate production

package/dist/src/contexts/ApiProvider/createSdkQueryClient.test.d.ts

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

package/dist/src/contexts/ApiProvider/payrollDeductionAmountHook.d.ts

@@ -0,0 +1,12 @@
+import { AfterSuccessHook } from '../../types/hooks';
+/**
+ * Normalizes string deduction amounts for payroll responses whose generated schema expects numbers.
+ *
+ * @remarks
+ * API version 2026-06-15 returns decimal strings, including percentage deductions. The generated
+ * prepare, update, and off-cycle response schemas still require numbers. Remove this compatibility
+ * hook once those schemas match the API. Invalid amounts remain unchanged so validation rejects them.
+ *
+ * @internal
+ */
+export declare const payrollDeductionAmountHook: AfterSuccessHook;

package/dist/src/contexts/ApiProvider/payrollDeductionAmountHook.test.d.ts

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

package/dist/src/helpers/validations.test.d.ts

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

package/dist/src/i18n/types.d.ts

@@ -29,6 +29,8 @@ export interface Resources {
   /** */
   'Company.Locations': Translations.CompanyLocations
   /** */
+  'Company.Management.AutoPilotDialog': Translations.CompanyManagementAutoPilotDialog
+  /** */
   'Company.Management.PaySchedule': Translations.CompanyManagementPaySchedule
   /** */
   'Company.Management.PayScheduleAssignment': Translations.CompanyManagementPayScheduleAssignment
@@ -375,9 +377,9 @@ export namespace Translations {
       email: string
       /** @defaultValue `"Email addresses must match"` */
       emailMismatch: string
-      /** @defaultValue `"First name is required"` */
+      /** @defaultValue `"Enter a valid first name"` */
       firstName: string
-      /** @defaultValue `"Last name is required"` */
+      /** @defaultValue `"Enter a valid last name"` */
       lastName: string
       /** @defaultValue `"Phone number must be 10 digits"` */
       phone: string
@@ -942,25 +944,120 @@ export namespace Translations {
       phone: string
     }
   }
+  /** Translation keys for the `Company.Management.AutoPilotDialog` i18n namespace. */
+  export interface CompanyManagementAutoPilotDialog {
+    /** @defaultValue `"AutoPilot — {{scheduleName}}"` */
+    title: string
+    /** @defaultValue `"AutoPilot takes care of payroll for you. Payrolls are editable until 1 day before your pay deadline and funds are debited on your pay deadline."` */
+    description: string
+    /** @defaultValue `"Enable AutoPilot"` */
+    toggleLabel: string
+    /** @defaultValue `"Checking AutoPilot eligibility…"` */
+    checkingEligibility: string
+    /** @defaultValue `"Save"` */
+    saveCta: string
+    /** @defaultValue `"Cancel"` */
+    cancelCta: string
+    saveError: {
+      /** @defaultValue `"AutoPilot settings couldn't be saved"` */
+      title: string
+      /** @defaultValue `"Something went wrong saving your AutoPilot changes. Contact support if this continues."` */
+      description: string
+    }
+    blockers: {
+      /** @defaultValue `"AutoPilot isn't available yet"` */
+      heading: string
+      employees_not_on_direct_deposit: {
+        /** @defaultValue `"Some employees aren't on direct deposit"` */
+        title: string
+        /** @defaultValue `"Every employee on this schedule needs to be set up with direct deposit before AutoPilot can run their payroll automatically."` */
+        description: string
+      }
+      employees_not_salaried: {
+        /** @defaultValue `"Some employees aren't salaried"` */
+        title: string
+        /** @defaultValue `"AutoPilot requires every employee on this schedule to be salaried."` */
+        description: string
+      }
+      missing_state_tax_requirements: {
+        /** @defaultValue `"State tax setup is incomplete"` */
+        title: string
+        /** @defaultValue `"Finish state tax setup for every state this schedule's employees work in before enabling AutoPilot."` */
+        description: string
+      }
+      missing_funding_method: {
+        /** @defaultValue `"No funding method on file"` */
+        title: string
+        /** @defaultValue `"Add a verified bank account to use as the default funding method before enabling AutoPilot."` */
+        description: string
+      }
+      one_day_ach_speed_not_supported: {
+        /** @defaultValue `"Payment speed isn't eligible"` */
+        title: string
+        /** @defaultValue `"AutoPilot isn't available for schedules using next-day ACH."` */
+        description: string
+      }
+      company_suspended: {
+        /** @defaultValue `"Company is suspended"` */
+        title: string
+        /** @defaultValue `"Resolve your company's suspension before enabling AutoPilot."` */
+        description: string
+      }
+      earned_fast_ach_not_met: {
+        /** @defaultValue `"Fast ACH threshold not met"` */
+        title: string
+        /** @defaultValue `"This company hasn't yet met the funding history needed to qualify for fast ACH payments."` */
+        description: string
+      }
+      hourly_employees_missing_default_hours: {
+        /** @defaultValue `"Some hourly employees are missing default hours"` */
+        title: string
+        /** @defaultValue `"Set default hours for every hourly employee on this schedule before enabling AutoPilot."` */
+        description: string
+      }
+      generic: {
+        /** @defaultValue `"AutoPilot can't be enabled right now"` */
+        title: string
+        /** @defaultValue `"Something is preventing AutoPilot from being enabled for this schedule. Contact support if this continues."` */
+        description: string
+      }
+    }
+  }
   /** Translation keys for the `Company.Management.PaySchedule` i18n namespace. */
   export interface CompanyManagementPaySchedule {
     /** @defaultValue `"Pay schedule"` */
     title: string
     /** @defaultValue `"You have assigned everyone to be on one pay schedule."` */
     description: string
+    /** @defaultValue `"You have assigned employees to pay schedules by compensation type."` */
+    compensationDescription: string
+    /** @defaultValue `"Pay schedules by compensation type"` */
+    compensationTableLabel: string
     /** @defaultValue `"Manage"` */
     manageCta: string
     /** @defaultValue `"Edit"` */
     editCta: string
+    /** @defaultValue `"Edit schedule"` */
+    editScheduleCta: string
     /** @defaultValue `"Edit pay schedule"` */
     editScheduleAriaLabel: string
     /** @defaultValue `"Edit AutoPilot"` */
     editAutoPilotAriaLabel: string
+    /** @defaultValue `"Pay schedule actions"` */
+    rowMenuTriggerLabel: string
     labels: {
       /** @defaultValue `"Name"` */
       name: string
       /** @defaultValue `"Frequency"` */
       frequency: string
+      /** @defaultValue `"Schedule"` */
+      schedule: string
+    }
+    compensationTypes: {
+      /** @defaultValue `"Hourly"` */
+      hourly: string
+      /** @defaultValue `"Salaried"` */
+      salaried: string
     }
     autoPilot: {
       /** @defaultValue `"AutoPilot"` */
@@ -989,6 +1086,12 @@ export namespace Translations {
           /** @defaultValue `"Choose one pay schedule for all your employees"` */
           description: string
         }
+        hourlySalaried: {
+          /** @defaultValue `"Separate schedules by compensation type"` */
+          label: string
+          /** @defaultValue `"Choose one pay schedule for hourly employees and another for salaried employees"` */
+          description: string
+        }
       }
     }
     scheduleStep: {
@@ -1001,6 +1104,20 @@ export namespace Translations {
       /** @defaultValue `"Add pay schedule"` */
       addPayScheduleCta: string
     }
+    compensationStep: {
+      /** @defaultValue `"Assign employees"` */
+      heading: string
+      /** @defaultValue `"Hourly employees"` */
+      hourlyPayScheduleLabel: string
+      /** @defaultValue `"The pay schedule to use for hourly employees."` */
+      hourlyPayScheduleDescription: string
+      /** @defaultValue `"Salaried employees"` */
+      salariedPayScheduleLabel: string
+      /** @defaultValue `"The pay schedule to use for salaried employees."` */
+      salariedPayScheduleDescription: string
+      /** @defaultValue `"Add pay schedule"` */
+      addPayScheduleCta: string
+    }
     reviewStep: {
       /** @defaultValue `"Review changes"` */
       heading: string

package/dist/src/models/external.d.ts

@@ -306,14 +306,15 @@ export type { PayrollUpdateReimbursements } from '@gusto/embedded-api/models/com
 export type { PayrollUpdateState } from '@gusto/embedded-api/models/components/payrollupdate';
 export type { PayrollUpdateCustomWithholdings, PayrollUpdateDeductions, PayrollUpdateFederal, PayrollUpdateFixedCompensations, PayrollUpdateHourlyCompensations, } from '@gusto/embedded-api/models/components/payrollupdate';
 export { PayrollUpdateAmountType, PayrollUpdateEmployeeCompensationsAmountType, PayrollUpdateEmployeeCompensationsCustomWithholdingsAmountType, PayrollUpdateEmployeeCompensationsOverrideType, PayrollUpdateOverrideType, PayrollUpdatePaymentMethod, } from '@gusto/embedded-api/models/components/payrollupdate';
-/** `Departments` entity from the Gusto Embedded API. */
-export type { Departments } from '@gusto/embedded-api/models/components/payscheduleassignmentbody';
-/** `PayScheduleAssignmentBody` entity from the Gusto Embedded API. */
-export type { PayScheduleAssignmentBody } from '@gusto/embedded-api/models/components/payscheduleassignmentbody';
-/** `PayScheduleAssignmentBodyEmployees` entity from the Gusto Embedded API. */
-export type { PayScheduleAssignmentBodyEmployees } from '@gusto/embedded-api/models/components/payscheduleassignmentbody';
+/** `PayScheduleAssignmentType` entity from the Gusto Embedded API. */
+export { PayScheduleAssignmentType } from '@gusto/embedded-api/models/components/payscheduleassignment';
+export type { PayScheduleAssignment } from '@gusto/embedded-api/models/components/payscheduleassignment';
 /** `PayScheduleAssignmentBodyType` entity from the Gusto Embedded API. */
 export { PayScheduleAssignmentBodyType } from '@gusto/embedded-api/models/components/payscheduleassignmentbody';
+/** `PayScheduleAssignmentDepartment` entity from the Gusto Embedded API. */
+export type { PayScheduleAssignmentDepartment } from '@gusto/embedded-api/models/components/payscheduleassignmentdepartment';
+/** `PayScheduleAssignmentEmployee` entity from the Gusto Embedded API. */
+export type { PayScheduleAssignmentEmployee } from '@gusto/embedded-api/models/components/payscheduleassignmentemployee';
 /** `PayScheduleAssignmentEmployeeChange` entity from the Gusto Embedded API. */
 export type { PayScheduleAssignmentEmployeeChange } from '@gusto/embedded-api/models/components/payscheduleassignmentemployeechange';
 export type { PayScheduleAssignmentPayPeriod } from '@gusto/embedded-api/models/components/payscheduleassignmentpayperiod';

package/dist/src/shared/constants.d.ts

@@ -322,6 +322,9 @@ export declare const payScheduleEvents: {
     readonly PAY_SCHEDULE_DONE: "paySchedule/done";
     readonly PAY_SCHEDULE_MANAGE_ASSIGNMENT: "paySchedule/management/manageAssignment";
     readonly PAY_SCHEDULE_AUTO_PILOT_EDIT: "paySchedule/management/autoPilotEdit";
+    readonly PAY_SCHEDULE_AUTO_PILOT_ENABLED: "paySchedule/management/autoPilotEnabled";
+    readonly PAY_SCHEDULE_AUTO_PILOT_DISABLED: "paySchedule/management/autoPilotDisabled";
+    readonly PAY_SCHEDULE_AUTO_PILOT_DISMISSED: "paySchedule/management/autoPilotDismissed";
     readonly PAY_SCHEDULE_ASSIGNMENT_TYPE_SELECTED: "paySchedule/management/assignment/typeSelected";
     readonly PAY_SCHEDULE_ASSIGNMENT_SCHEDULE_SELECTED: "paySchedule/management/assignment/scheduleSelected";
     readonly PAY_SCHEDULE_ASSIGNMENT_BACK: "paySchedule/management/assignment/back";
@@ -707,6 +710,9 @@ export declare const componentEvents: {
     readonly PAY_SCHEDULE_DONE: "paySchedule/done";
     readonly PAY_SCHEDULE_MANAGE_ASSIGNMENT: "paySchedule/management/manageAssignment";
     readonly PAY_SCHEDULE_AUTO_PILOT_EDIT: "paySchedule/management/autoPilotEdit";
+    readonly PAY_SCHEDULE_AUTO_PILOT_ENABLED: "paySchedule/management/autoPilotEnabled";
+    readonly PAY_SCHEDULE_AUTO_PILOT_DISABLED: "paySchedule/management/autoPilotDisabled";
+    readonly PAY_SCHEDULE_AUTO_PILOT_DISMISSED: "paySchedule/management/autoPilotDismissed";
     readonly PAY_SCHEDULE_ASSIGNMENT_TYPE_SELECTED: "paySchedule/management/assignment/typeSelected";
     readonly PAY_SCHEDULE_ASSIGNMENT_SCHEDULE_SELECTED: "paySchedule/management/assignment/scheduleSelected";
     readonly PAY_SCHEDULE_ASSIGNMENT_BACK: "paySchedule/management/assignment/back";

package/docs/guides/endpoint-inventory.json

@@ -1790,6 +1790,11 @@
           "path": "/v1/companies/:companyId/pay_schedules/assignment_preview",
           "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/post-v1-companies-company_id-pay_schedules-assignment_preview"
         },
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/pay_schedules/assignments",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-companies-company_id-pay_schedules-assignments"
+        },
         {
           "method": "GET",
           "path": "/v1/companies/:companyId/pay_schedules/preview",
@@ -1986,6 +1991,16 @@
           "path": "/v1/companies/:companyId/pay_schedules",
           "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-companies-company_id-pay_schedules"
         },
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/pay_schedules/:payScheduleId",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-companies-company_id-pay_schedules-pay_schedule_id"
+        },
+        {
+          "method": "PUT",
+          "path": "/v1/companies/:companyId/pay_schedules/:payScheduleId",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/put-v1-companies-company_id-pay_schedules-pay_schedule_id"
+        },
         {
           "method": "POST",
           "path": "/v1/companies/:companyId/pay_schedules/assign",
@@ -1995,10 +2010,16 @@
           "method": "POST",
           "path": "/v1/companies/:companyId/pay_schedules/assignment_preview",
           "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/post-v1-companies-company_id-pay_schedules-assignment_preview"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/pay_schedules/assignments",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-companies-company_id-pay_schedules-assignments"
         }
       ],
       "variables": [
-        "companyId"
+        "companyId",
+        "payScheduleId"
       ]
     },
     "CompanyManagement.PayScheduleAssignment": {
@@ -2017,6 +2038,11 @@
           "method": "POST",
           "path": "/v1/companies/:companyId/pay_schedules/assignment_preview",
           "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/post-v1-companies-company_id-pay_schedules-assignment_preview"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/pay_schedules/assignments",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-companies-company_id-pay_schedules-assignments"
         }
       ],
       "variables": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gusto/embedded-react-sdk",
-  "version": "0.56.5",
+  "version": "0.56.7-rc.1",
   "homepage": "https://github.com/Gusto/embedded-react-sdk",
   "bugs": {
     "url": "https://github.com/Gusto/embedded-react-sdk/issues"
@@ -65,7 +65,7 @@
     "pack": "npm run build && npm pack",
     "release": "release-it",
     "postversion": "git push",
-    "prepare": "husky",
+    "prepare": "husky || true",
     "prepublishOnly": "npm run build",
     "preversion": "npm test",
     "test": "vitest",
@@ -100,11 +100,11 @@
     "@commitlint/config-conventional": "^21.2.2",
     "@eslint/js": "^9.39.5",
     "@microsoft/api-extractor": "^7.59.1",
-    "@playwright/test": "^1.63.0",
+    "@playwright/test": "^1.64.0",
     "@release-it/conventional-changelog": "^12.0.2",
     "@storybook/addon-a11y": "^10.6.0",
     "@storybook/addon-docs": "^10.6.0",
-    "@storybook/addon-onboarding": "^10.6.0",
+    "@storybook/addon-onboarding": "^10.6.1",
     "@storybook/react-vite": "^10.6.0",
     "@storybook/test-runner": "^0.24.5",
     "@testing-library/dom": "^10.4.2",
@@ -124,8 +124,8 @@
     "@vitest/coverage-v8": "^5.0.0",
     "ajv": "^8.20.0",
     "axe-core": "^4.13.0",
-    "cspell": "^10.3.3",
-    "dotenv": "^18.0.2",
+    "cspell": "^10.3.6",
+    "dotenv": "^18.0.3",
     "eslint": "^9.39.5",
     "eslint-plugin-import": "^2.31.0",
     "eslint-plugin-jsx-a11y": "^6.10.2",
@@ -133,7 +133,7 @@
     "eslint-plugin-react-hooks": "^7.1.1",
     "eslint-plugin-react-refresh": "^0.4.24",
     "eslint-plugin-storybook": "^10.6.0",
-    "eslint-plugin-tsdoc": "^0.5.3",
+    "eslint-plugin-tsdoc": "^0.5.4",
     "fuse.js": "^7.5.0",
     "globals": "^17.12.0",
     "husky": "^9.1.7",
@@ -147,18 +147,18 @@
     "npm-run-all": "^4.1.5",
     "pixelmatch": "^7.2.0",
     "pngjs": "^7.0.0",
-    "prettier": "^3.9.8",
+    "prettier": "^3.9.9",
     "prism-react-renderer": "^2.4.1",
     "react-dnd": "^16.0.1",
     "react-dnd-html5-backend": "^16.0.1",
     "react-router-dom": "^7.18.4",
-    "release-it": "^21.1.0",
-    "sass-embedded": "^1.104.1",
+    "release-it": "^21.1.1",
+    "sass-embedded": "^1.105.0",
     "storybook": "^10.5.5",
     "stylelint-config-standard": "^40.0.0",
     "ts-morph": "^28.0.0",
     "tsx": "^4.23.15",
-    "typescript-eslint": "^8.70.0",
+    "typescript-eslint": "^8.70.1",
     "vite": "^6.4.3",
     "vite-plugin-checker": "^0.14.5",
     "vite-plugin-circular-dependency": "^0.6.0",
@@ -180,7 +180,7 @@
     "js-yaml": "^4.3.2",
     "uuid": "^11.1.1",
     "@babel/core": "^7.29.6",
-    "markdown-it": "^14.2.0",
+    "markdown-it": "^14.3.2",
     "conventional-commits-parser": "^7.1.0",
     "conventional-commits-filter": "^5.0.0"
   },
@@ -189,10 +189,10 @@
     "@hookform/error-message": "^2.0.1",
     "@hookform/resolvers": "^5.9.1",
     "@internationalized/date": "^3.12.4",
-    "@internationalized/number": "^3.6.8",
+    "@internationalized/number": "^3.6.9",
     "classnames": "^2.5.1",
     "deepmerge": "^4.3.1",
-    "dompurify": "^3.4.15",
+    "dompurify": "^3.4.16",
     "i18next": "^26.4.2",
     "react-aria": "^3.47.0",
     "react-aria-components": "1.16.0",