@gusto/embedded-react-sdk 0.56.4 → 0.56.5

package/dist/src/components/Contractor/Dismissal/useDismissal/useDismissal.d.ts

@@ -0,0 +1,41 @@
+import { Contractor } from '@gusto/embedded-api/models/components/contractor';
+import { BaseHookReady, HookLoadingResult, HookSubmitResult } from '../../../../partner-hook-utils/types';
+/**
+ * Props for {@link useDismissal}.
+ *
+ * @public
+ */
+export interface UseDismissalProps {
+    /** The contractor identifier to dismiss. */
+    contractorId: string;
+}
+/**
+ * Ready state of {@link useDismissal}.
+ *
+ * @public
+ */
+export interface UseDismissalReady extends BaseHookReady<{
+    contractor: Contractor;
+}, {
+    isPending: boolean;
+}> {
+    /** Actions available when the hook has loaded. */
+    actions: {
+        /** Schedules a dismissal effective on `endDate`. */
+        dismiss: (endDate: Date) => Promise<HookSubmitResult<unknown> | undefined>;
+    };
+}
+/**
+ * Return type of {@link useDismissal}.
+ *
+ * @public
+ */
+export type UseDismissalResult = HookLoadingResult | UseDismissalReady;
+/**
+ * Fetches a contractor and exposes an action to schedule their dismissal.
+ *
+ * @param input - The contractor to dismiss.
+ * @returns A {@link HookLoadingResult} while the contractor is being fetched, or a {@link UseDismissalReady} once it has arrived.
+ * @public
+ */
+export declare function useDismissal({ contractorId }: UseDismissalProps): UseDismissalResult;

package/dist/src/components/Contractor/Dismissal/useDismissal/useDismissal.test.d.ts

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

package/dist/src/components/Contractor/exports/contractorManagement.d.ts

@@ -1,5 +1,6 @@
 export { ManagementContractorList as ContractorList, type ManagementContractorListProps, type ContractorTab, } from '../ContractorList/management/ManagementContractorList';
 export { ContractorListFlow, type ContractorListFlowProps } from '../ContractorListFlow';
+export { Dismissal, type DismissalProps } from '../Dismissal/Dismissal';
 export { DashboardFlow, Dashboard } from '../Dashboard';
 export type { DashboardFlowProps, DashboardProps, DashboardTab } from '../Dashboard';
 export { Profile, ProfileCard, ProfileEditForm } from '../Profile/management';

package/dist/src/components/Payroll/PayrollEditEmployee/shared/usePayrollEditEmployeeForm/payrollEditEmployeeSchema.d.ts

@@ -19,7 +19,9 @@ export declare const PAYMENT_METHOD_OPTIONS: {
  */
 export declare const PayrollEditEmployeeErrorCodes: {
     readonly NEGATIVE_AMOUNT: "NEGATIVE_AMOUNT";
+    readonly MAX_HOURS: "MAX_HOURS";
     readonly REIMBURSEMENT_AMOUNT: "REIMBURSEMENT_AMOUNT";
+    readonly MAX_REIMBURSEMENT_AMOUNT: "MAX_REIMBURSEMENT_AMOUNT";
     readonly REQUIRED_WORKWEEK: "REQUIRED_WORKWEEK";
 };
 /**
@@ -28,6 +30,23 @@ export declare const PayrollEditEmployeeErrorCodes: {
  * @public
  */
 export type PayrollEditEmployeeErrorCode = (typeof PayrollEditEmployeeErrorCodes)[keyof typeof PayrollEditEmployeeErrorCodes];
+/**
+ * Mirrors the server's fixed hours cap (`draft_payrolls`' `MAX_HOURS`) so an
+ * over-limit value is caught inline instead of round-tripping to a 422. Also
+ * applied as the hours fields' native `max` so the stepper can't reach it.
+ *
+ * @public
+ */
+export declare const MAX_HOURS = 99999;
+/**
+ * Mirrors the server's fixed reimbursement cap (`payroll_core_data`'s
+ * `Reimbursements::MAX_AMOUNT`) so an over-limit value is caught inline
+ * instead of round-tripping to a 422. Also applied as the amount field's
+ * native `max` so the stepper can't reach it.
+ *
+ * @public
+ */
+export declare const MAX_REIMBURSEMENT_AMOUNT = 1000000;
 /**
  * The single reimbursement validation schema: the "add reimbursement" draft row.
  * Amount must be a number greater than zero, matching the legacy editor's

package/dist/src/contexts/ComponentAdapter/componentAdapterTypes.d.ts

@@ -29,6 +29,7 @@ export type { HeadingProps } from '../../components/Common/UI/Heading/HeadingTyp
 export type { PaginationControlProps, PaginationItemsPerPage, } from '../../components/Common/PaginationControl/PaginationControlTypes';
 export type { PayrollLoadingProps } from '../../components/Common/PayrollLoading/PayrollLoadingTypes';
 export type { FieldCaptionProps } from '../../components/Common/FieldCaption/FieldCaptionTypes';
+export type { DocumentEmbedProps } from '../../components/Common/DocumentEmbed/DocumentEmbedTypes';
 export type { TextProps } from '../../components/Common/UI/Text/TextTypes';
 export type { CalendarPreviewProps } from '../../components/Common/UI/CalendarPreview/CalendarPreviewTypes';
 export type { DialogProps } from '../../components/Common/UI/Dialog/DialogTypes';

package/dist/src/contexts/ComponentAdapter/useComponentContext.d.ts

@@ -39,6 +39,7 @@ import { FormBoxHeaderProps } from '../../components/Common/UI/FormBoxHeader/For
 import { MultiSelectComboBoxProps } from '../../components/Common/UI/MultiSelectComboBox/MultiSelectComboBoxTypes';
 import { PayrollLoadingProps } from '../../components/Common/PayrollLoading/PayrollLoadingTypes';
 import { FieldCaptionProps } from '../../components/Common/FieldCaption/FieldCaptionTypes';
+import { DocumentEmbedProps } from '../../components/Common/DocumentEmbed/DocumentEmbedTypes';
 /**
  * Full map of UI components used by the SDK. Every property is a React component that the
  * SDK renders internally — override any of them to substitute your own design system.
@@ -48,8 +49,8 @@ import { FieldCaptionProps } from '../../components/Common/FieldCaption/FieldCap
  *
  * To take full control of every UI component (and eliminate the React Aria dependency),
  * pass a complete {@link ComponentsContextType} to {@link GustoProviderCustomUIAdapter} instead.
- * All properties are then required except `PaginationControl`, `PayrollLoading`, and `FieldCaption`,
- * which fall back to built-in SDK implementations when omitted.
+ * All properties are then required except `PaginationControl`, `PayrollLoading`, `FieldCaption`,
+ * and `DocumentEmbed`, which fall back to built-in SDK implementations when omitted.
  *
  * @public
  * @group Component adapter
@@ -180,6 +181,8 @@ export interface ComponentsContextType {
     PaginationControl?: FunctionComponent<PaginationControlProps>;
     /** Loading indicator for payroll calculation. Defaults to the SDK's built-in loading state when omitted. */
     PayrollLoading?: FunctionComponent<PayrollLoadingProps>;
+    /** Inline PDF document renderer. Defaults to the SDK's built-in `<embed>`-based viewer when omitted; override to control how PDFs are rendered inline — especially useful if you have strict Content Security Policy directives. */
+    DocumentEmbed?: FunctionComponent<DocumentEmbedProps>;
 }
 /** @internal */
 export declare const ComponentsContext: import('react').Context<ComponentsContextType | null>;

package/dist/src/i18n/en/common.json.d.ts

@@ -6,6 +6,9 @@ declare const _default: {
     "errorEncountered": "There was a problem with your submission",
     "multipleErrorsEncountered": "There were multiple problems with your submission"
   },
+  "documentEmbed": {
+    "defaultTitle": "Document"
+  },
   "selectPlaceholder": "Select an option...",
   "progressBarLabel": "You are on step {{currentStep}} of {{totalSteps}}",
   "back": "Back",

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

@@ -67,6 +67,8 @@ export interface Resources {
   /** */
   'Contractor.Dashboard': Translations.ContractorDashboard
   /** */
+  'Contractor.Dismissal': Translations.ContractorDismissal
+  /** */
   'Contractor.DocumentsList': Translations.ContractorDocumentsList
   /** */
   'Contractor.Landing': Translations.ContractorLanding
@@ -2439,6 +2441,37 @@ export namespace Translations {
       compensationUpdated: string
     }
   }
+  /** Translation keys for the `Contractor.Dismissal` i18n namespace. */
+  export interface ContractorDismissal {
+    /** @defaultValue `"Dismiss {{name}}"` */
+    title: string
+    /** @defaultValue `"Schedule a dismissal date for this contractor."` */
+    subtitle: string
+    alert: {
+      /** @defaultValue `"This can be cancelled"` */
+      label: string
+      /** @defaultValue `"The dismissal can be cancelled from the contractor list any time before the dismissal date takes effect."` */
+      text: string
+    }
+    form: {
+      endDate: {
+        /** @defaultValue `"Dismissal date"` */
+        label: string
+      }
+    }
+    validation: {
+      /** @defaultValue `"Enter a dismissal date"` */
+      endDateRequired: string
+    }
+    actions: {
+      /** @defaultValue `"Cancel"` */
+      cancel: string
+      /** @defaultValue `"Dismiss contractor"` */
+      submit: string
+    }
+    /** @defaultValue `"Dismissal scheduled"` */
+    successMessage: string
+  }
   /** Translation keys for the `Contractor.DocumentsList` i18n namespace. */
   export interface ContractorDocumentsList {
     /** @defaultValue `"Documents"` */
@@ -3471,6 +3504,8 @@ export namespace Translations {
       totalLabel: string
       /** @defaultValue `"Receipt Details"` */
       detailsLabel: string
+      /** @defaultValue `"Receipt ID"` */
+      receiptId: string
       /** @defaultValue `"From"` */
       from: string
       /** @defaultValue `"To"` */
@@ -7749,8 +7784,12 @@ export namespace Translations {
     validations: {
       /** @defaultValue `"Amount must be greater than zero"` */
       reimbursementAmount: string
+      /** @defaultValue `"Amount must be less than or equal to 1,000,000"` */
+      maxReimbursementAmount: string
       /** @defaultValue `"Amount cannot be negative"` */
       negativeAmount: string
+      /** @defaultValue `"Hours must be less than or equal to 99,999"` */
+      maxHours: string
     }
   }
   /** Translation keys for the `Payroll.PayrollFlow` i18n namespace. */
@@ -8635,10 +8674,14 @@ export namespace Translations {
     validations: {
       /** @defaultValue `"Amount must be greater than zero"` */
       reimbursementAmount: string
+      /** @defaultValue `"Amount must be less than or equal to 1,000,000"` */
+      maxReimbursementAmount: string
       /** @defaultValue `"Amount cannot be negative"` */
       negativeAmount: string
       /** @defaultValue `"Enter an amount for every workweek"` */
       requiredWorkweek: string
+      /** @defaultValue `"Hours must be less than or equal to 99,999"` */
+      maxHours: string
     }
   }
   /** Translation keys for the `Payroll.WireInstructions` i18n namespace. */
@@ -8718,6 +8761,10 @@ export namespace Translations {
       /** @defaultValue `"There were multiple problems with your submission"` */
       multipleErrorsEncountered: string
     }
+    documentEmbed: {
+      /** @defaultValue `"Document"` */
+      defaultTitle: string
+    }
     /** @defaultValue `"Select an option..."` */
     selectPlaceholder: string
     /** @defaultValue `"You are on step {{currentStep}} of {{totalSteps}}"` */

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

@@ -212,6 +212,7 @@ export declare const contractorEvents: {
     readonly CONTRACTOR_DISMISS: "contractor/dismiss";
     readonly CONTRACTOR_REHIRE: "contractor/rehire";
     readonly CONTRACTOR_DISMISSAL_CANCELLED: "contractor/dismissal/cancelled";
+    readonly CONTRACTOR_DISMISSAL_SCHEDULED: "contractor/dismissal/scheduled";
     readonly CONTRACTOR_REHIRE_CANCELLED: "contractor/rehire/cancelled";
     readonly CONTRACTOR_MANAGEMENT_PROFILE_EDIT_REQUESTED: "contractor/management/profile/editRequested";
     readonly CONTRACTOR_MANAGEMENT_PROFILE_UPDATED: "contractor/management/profile/updated";
@@ -673,6 +674,7 @@ export declare const componentEvents: {
     readonly CONTRACTOR_DISMISS: "contractor/dismiss";
     readonly CONTRACTOR_REHIRE: "contractor/rehire";
     readonly CONTRACTOR_DISMISSAL_CANCELLED: "contractor/dismissal/cancelled";
+    readonly CONTRACTOR_DISMISSAL_SCHEDULED: "contractor/dismissal/scheduled";
     readonly CONTRACTOR_REHIRE_CANCELLED: "contractor/rehire/cancelled";
     readonly CONTRACTOR_MANAGEMENT_PROFILE_EDIT_REQUESTED: "contractor/management/profile/editRequested";
     readonly CONTRACTOR_MANAGEMENT_PROFILE_UPDATED: "contractor/management/profile/updated";

package/docs/guides/endpoint-inventory.json

@@ -2263,6 +2263,23 @@
         "contractorUuid"
       ]
     },
+    "ContractorManagement.Dismissal": {
+      "endpoints": [
+        {
+          "method": "GET",
+          "path": "/v1/contractors/:contractorUuid",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-contractors-contractor_uuid"
+        },
+        {
+          "method": "POST",
+          "path": "/v1/contractors/:contractorUuid/termination",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/post-v1-contractors-contractor_uuid-termination"
+        }
+      ],
+      "variables": [
+        "contractorUuid"
+      ]
+    },
     "ContractorManagement.DashboardFlow": {
       "endpoints": [
         {
@@ -2566,6 +2583,7 @@
       "blocks": [
         "ContractorManagement.ContractorList",
         "ContractorManagement.DashboardFlow",
+        "ContractorManagement.Dismissal",
         "ContractorOnboarding.OnboardingFlow"
       ]
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gusto/embedded-react-sdk",
-  "version": "0.56.4",
+  "version": "0.56.5",
   "homepage": "https://github.com/Gusto/embedded-react-sdk",
   "bugs": {
     "url": "https://github.com/Gusto/embedded-react-sdk/issues"