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

package/dist/types/observability.d.ts

@@ -1,45 +1,22 @@
+import { SDKError } from './sdkError';
+export type ObservabilityMetricUnit = 'ms' | 'count' | 'bytes' | 'percent';
 /**
- * Observability hook types for error tracking and performance metrics
+ * An `SDKError` enriched with internal component context for observability telemetry.
+ *
+ * Partners receive this type through `ObservabilityHook.onError`. It extends the
+ * core `SDKError` with `timestamp`, `componentName`, and `componentStack` so that
+ * error-tracking tools (e.g. Sentry) can correlate and group errors.
+ *
+ * The base `SDKError` (without these fields) is the type used in partner-facing
+ * hooks like `useEmployeeForm`, keeping the public API clean.
  */
-export type ObservabilityErrorType = 'boundary_error' | 'validation_error' | 'internal_error' | 'api_error';
-export type ObservabilityMetricUnit = 'ms' | 'count' | 'bytes' | 'percent';
-export interface ObservabilityErrorContext {
-    /** Name of the component where error occurred */
-    componentName?: string;
-    /** Props passed to the component (sanitized, no sensitive data) */
-    componentProps?: Record<string, unknown>;
-    /** For validation errors, the schema that failed */
-    validationSchema?: string;
-    /** React component stack trace */
-    componentStack?: string;
-    /** Operation ID for API-related errors */
-    operationId?: string;
-    /** HTTP status code for API errors */
-    statusCode?: number;
-    /** Request details for API errors */
-    request?: {
-        url: string;
-        method: string;
-    };
-    /** Any additional context */
-    metadata?: Record<string, unknown>;
-}
-export interface ObservabilityError {
-    /** Type of error that occurred */
-    type: ObservabilityErrorType;
-    /** Human-readable error message */
-    message: string;
-    /** Error stack trace if available */
-    stack?: string;
-    /** Context about where/how the error occurred */
-    context: ObservabilityErrorContext;
-    /**
-     * The original error object (may be undefined when sanitization.includeOriginalError is false)
-     * Default sanitization removes this to prevent PII leakage
-     */
-    originalError?: unknown;
+export interface ObservabilityError extends SDKError {
     /** When the error occurred (Unix timestamp in milliseconds) */
     timestamp: number;
+    /** SDK component where the error occurred (e.g. "Employee.Profile") */
+    componentName?: string;
+    /** React component stack trace (present only for errors caught by ErrorBoundary) */
+    componentStack?: string;
 }
 export interface ObservabilityMetric {
     /** Metric name (e.g., 'sdk.form.submit_duration', 'sdk.component.loading_duration') */
@@ -62,10 +39,10 @@ export interface SanitizationConfig {
      */
     enabled?: boolean;
     /**
-     * Whether to include the original error object. Default: false
-     * WARNING: Original errors may contain sensitive data from form inputs or API responses
+     * Whether to include the raw error object on SDKError. Default: false
+     * WARNING: Raw errors may contain sensitive data from form inputs or API responses
      */
-    includeOriginalError?: boolean;
+    includeRawError?: boolean;
     /**
      * Custom sanitization function for errors
      */
@@ -82,10 +59,6 @@ export interface SanitizationConfig {
 /**
  * Observability hook interface for SDK consumers to implement
  *
- * This hook enables error tracking and performance monitoring for the SDK.
- * Errors caught by error boundaries and validation failures will be reported through onError.
- * Performance metrics for forms, components, and flows will be reported through onMetric.
- *
  * @example
  * ```tsx
  * import * as Sentry from '@sentry/react'
@@ -95,29 +68,22 @@ export interface SanitizationConfig {
  *   config={{
  *     baseUrl: '/api/',
  *     observability: {
- *       onError: (error) => {
- *         // Create Error from sanitized data (originalError is undefined by default)
- *         const sentryError = new Error(error.message)
- *         sentryError.name = error.type
- *         if (error.stack) {
- *           sentryError.stack = error.stack
- *         }
- *
- *         Sentry.captureException(sentryError, {
- *           level: error.type === 'validation_error' ? 'warning' : 'error',
+ *       onError: (error: ObservabilityError) => {
+ *         Sentry.captureException(error.raw, {
+ *           level: error.category === 'validation_error' ? 'warning' : 'error',
  *           tags: {
- *             error_type: error.type,
- *             component: error.context.componentName,
+ *             error_category: error.category,
+ *             component: error.componentName ?? 'unknown',
+ *             http_status: String(error.httpStatus ?? ''),
  *           },
  *         })
  *       },
  *       onMetric: (metric) => {
- *         // Send to your metrics service
  *         console.log(`[Metric] ${metric.name}: ${metric.value}${metric.unit}`)
  *       },
  *       sanitization: {
  *         enabled: true,
- *         includeOriginalError: false, // Default: originalError will be undefined
+ *         includeRawError: false,
  *       }
  *     }
  *   }}
@@ -128,18 +94,18 @@ export interface SanitizationConfig {
  */
 export interface ObservabilityHook {
     /**
-     * Called when an error is caught by error boundaries or validation fails
-     * These are errors that prevent a component from rendering or operating correctly
+     * Called when an error is caught by error boundaries or form submission fails.
+     * Receives an `ObservabilityError` — an `SDKError` enriched with `componentName`
+     * and (for boundary errors) `componentStack`.
      */
     onError?: (error: ObservabilityError) => void;
     /**
-     * Called to track performance metrics for component operations
-     * Optional - can be used for tracking render times, flow completions, etc.
+     * Called to track performance metrics for component operations.
      */
     onMetric?: (metric: ObservabilityMetric) => void;
     /**
-     * Configuration for sanitizing data before sending to observability tools
-     * Default: { enabled: true, includeOriginalError: false }
+     * Configuration for sanitizing data before sending to observability tools.
+     * Default: { enabled: true, includeRawError: false }
      */
     sanitization?: SanitizationConfig;
 }

package/dist/types/sdkError.d.ts

@@ -0,0 +1,97 @@
+/**
+ * High-level classification of where/how the error originated.
+ *
+ * - `api_error` — HTTP error response from the Gusto API (422, 404, 409, 500, etc.)
+ * - `validation_error` — Client-side Zod schema validation before the request was sent
+ * - `network_error` — Network connectivity failure (connection refused, timeout, abort)
+ * - `internal_error` — Unexpected runtime error (unhandled exception, initialization failure)
+ */
+export declare const SDKErrorCategories: {
+    readonly API_ERROR: "api_error";
+    readonly VALIDATION_ERROR: "validation_error";
+    readonly NETWORK_ERROR: "network_error";
+    readonly INTERNAL_ERROR: "internal_error";
+};
+export type SDKErrorCategory = (typeof SDKErrorCategories)[keyof typeof SDKErrorCategories];
+/**
+ * An error thrown by internal SDK logic that should be caught and normalized
+ * by `baseSubmitHandler` rather than propagating to the ErrorBoundary.
+ *
+ * Use this for guard clauses and data integrity checks inside submit handler
+ * callbacks where the error should surface as an inline banner, not a crash.
+ *
+ * @example
+ * ```typescript
+ * await baseSubmitHandler(data, async () => {
+ *   const response = await createPayroll({ ... })
+ *   if (!response.payrollId) {
+ *     throw new SDKInternalError('Missing payroll ID in response')
+ *   }
+ * })
+ * ```
+ */
+export declare class SDKInternalError extends Error {
+    readonly category: SDKErrorCategory;
+    constructor(message: string, category?: SDKErrorCategory);
+}
+/**
+ * A flattened, field-level error extracted from an API response.
+ *
+ * For API errors with `errors[]`, nested structures are recursively flattened
+ * into leaf entries. The `field` property is the dot-separated camelCase path
+ * (e.g. `"states.CA.filingStatus.value"`).
+ */
+export interface SDKFieldError {
+    /** Dot-separated camelCase field path (e.g. "firstName", "states.CA.filingStatus.value") */
+    field: string;
+    /** API error category (e.g. "invalid_attribute_value", "invalid_operation", "payroll_blocker") */
+    category: string;
+    /** Human-readable error message from the API */
+    message: string;
+    /** Additional metadata from the API (e.g. `{ key: "missing_bank_info" }` for payroll blockers) */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * The unified SDK error type for all error scenarios.
+ *
+ * This is the core error shape exposed through partner-facing hooks. For
+ * observability telemetry (which includes component context), see
+ * `ObservabilityError` in `@/types/observability`.
+ *
+ * @example
+ * ```tsx
+ * const { error } = useEmployeeForm({ employeeId })
+ *
+ * if (error) {
+ *   console.log(error.category)    // 'api_error'
+ *   console.log(error.httpStatus)  // 422
+ *   console.log(error.fieldErrors) // [{ field: 'firstName', ... }]
+ * }
+ * ```
+ */
+export interface SDKError {
+    /** High-level error classification */
+    category: SDKErrorCategory;
+    /** Human-readable error summary */
+    message: string;
+    /** HTTP status code (undefined for non-HTTP errors like network or validation) */
+    httpStatus?: number;
+    /** Flattened field-level errors from API responses. Empty array for non-field errors. */
+    fieldErrors: SDKFieldError[];
+    /**
+     * The original error object for advanced use cases.
+     * May be stripped by sanitization (controlled by `sanitization.includeRawError`).
+     */
+    raw?: unknown;
+}
+/**
+ * Normalizes any caught error into a unified `SDKError`.
+ *
+ * Classification is based purely on the error type:
+ * - `SDKInternalError` → uses the error's own `category` (default: `internal_error`)
+ * - `GustoEmbeddedError` subclasses → `api_error`
+ * - `SDKValidationError` → `validation_error`
+ * - `HTTPClientError` subclasses → `network_error`
+ * - Everything else → `internal_error`
+ */
+export declare function normalizeToSDKError(error: unknown): SDKError;

package/dist/types/sdkError.js

@@ -0,0 +1,95 @@
+import { GustoEmbeddedError as n } from "@gusto/embedded-api/models/errors/gustoembeddederror";
+import { HTTPClientError as o } from "@gusto/embedded-api/models/errors/httpclienterrors";
+import { SDKValidationError as i } from "@gusto/embedded-api/models/errors/sdkvalidationerror";
+import { getFieldErrors as c } from "../helpers/apiErrorToList.js";
+class f extends Error {
+  category;
+  constructor(r, t = "internal_error") {
+    super(r), this.name = "SDKInternalError", this.category = t;
+  }
+}
+function g(e) {
+  return e !== null && typeof e == "object" && "errors" in e && Array.isArray(e.errors);
+}
+function a(e) {
+  return {
+    field: e.errorKey,
+    message: e.message ?? "",
+    category: e.category,
+    metadata: e.metadata
+  };
+}
+function m(e) {
+  const r = e.flatMap((t) => c(t));
+  return r.length > 0 ? r.map(a) : e.filter((t) => t.message).map(a);
+}
+function u(e) {
+  return {
+    errorKey: e.errorKey ?? e.error_key ?? "",
+    category: e.category,
+    message: e.message,
+    metadata: e.metadata
+  };
+}
+function l(e) {
+  if (!e) return [];
+  try {
+    const r = JSON.parse(e);
+    if (r !== null && typeof r == "object" && "errors" in r && Array.isArray(r.errors))
+      return r.errors.filter((s) => s.message).map(u).map(a);
+  } catch {
+  }
+  return [];
+}
+function d(e, r) {
+  return e.length === 0 ? r : e.length === 1 ? "1 field has issues" : `${e.length} fields have issues`;
+}
+function K(e) {
+  if (e instanceof f)
+    return {
+      category: e.category,
+      message: e.message,
+      fieldErrors: [],
+      raw: e
+    };
+  if (e instanceof i)
+    return {
+      category: "validation_error",
+      message: typeof e.rawMessage == "string" ? e.rawMessage : e.message,
+      fieldErrors: [],
+      raw: e
+    };
+  if (e instanceof o)
+    return {
+      category: "network_error",
+      message: e.message,
+      fieldErrors: [],
+      raw: e
+    };
+  if (e instanceof n) {
+    const r = e.httpMeta.response.status, t = g(e) ? m(e.errors) : l(e.httpMeta.body);
+    return {
+      category: "api_error",
+      message: d(t, e.message),
+      httpStatus: r,
+      fieldErrors: t,
+      raw: e
+    };
+  }
+  return e instanceof Error ? {
+    category: "internal_error",
+    message: e.message,
+    fieldErrors: [],
+    raw: e
+  } : {
+    category: "internal_error",
+    message: "An unknown error occurred",
+    fieldErrors: [],
+    raw: e
+  };
+}
+export {
+  f as SDKInternalError,
+  K as normalizeToSDKError
+};
+//# sourceMappingURL=sdkError.js.map

package/dist/types/sdkError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdkError.js","sources":["../../src/types/sdkError.ts"],"sourcesContent":["import type { EntityErrorObject } from '@gusto/embedded-api/models/components/entityerrorobject'\nimport { GustoEmbeddedError } from '@gusto/embedded-api/models/errors/gustoembeddederror'\nimport { HTTPClientError } from '@gusto/embedded-api/models/errors/httpclienterrors'\nimport { SDKValidationError } from '@gusto/embedded-api/models/errors/sdkvalidationerror'\nimport { getFieldErrors } from '@/helpers/apiErrorToList'\n\n/**\n * High-level classification of where/how the error originated.\n *\n * - `api_error` — HTTP error response from the Gusto API (422, 404, 409, 500, etc.)\n * - `validation_error` — Client-side Zod schema validation before the request was sent\n * - `network_error` — Network connectivity failure (connection refused, timeout, abort)\n * - `internal_error` — Unexpected runtime error (unhandled exception, initialization failure)\n */\nexport const SDKErrorCategories = {\n  API_ERROR: 'api_error',\n  VALIDATION_ERROR: 'validation_error',\n  NETWORK_ERROR: 'network_error',\n  INTERNAL_ERROR: 'internal_error',\n} as const\n\nexport type SDKErrorCategory = (typeof SDKErrorCategories)[keyof typeof SDKErrorCategories]\n\n/**\n * An error thrown by internal SDK logic that should be caught and normalized\n * by `baseSubmitHandler` rather than propagating to the ErrorBoundary.\n *\n * Use this for guard clauses and data integrity checks inside submit handler\n * callbacks where the error should surface as an inline banner, not a crash.\n *\n * @example\n * ```typescript\n * await baseSubmitHandler(data, async () => {\n *   const response = await createPayroll({ ... })\n *   if (!response.payrollId) {\n *     throw new SDKInternalError('Missing payroll ID in response')\n *   }\n * })\n * ```\n */\nexport class SDKInternalError extends Error {\n  readonly category: SDKErrorCategory\n\n  constructor(message: string, category: SDKErrorCategory = 'internal_error') {\n    super(message)\n    this.name = 'SDKInternalError'\n    this.category = category\n  }\n}\n\n/**\n * A flattened, field-level error extracted from an API response.\n *\n * For API errors with `errors[]`, nested structures are recursively flattened\n * into leaf entries. The `field` property is the dot-separated camelCase path\n * (e.g. `\"states.CA.filingStatus.value\"`).\n */\nexport interface SDKFieldError {\n  /** Dot-separated camelCase field path (e.g. \"firstName\", \"states.CA.filingStatus.value\") */\n  field: string\n  /** API error category (e.g. \"invalid_attribute_value\", \"invalid_operation\", \"payroll_blocker\") */\n  category: string\n  /** Human-readable error message from the API */\n  message: string\n  /** Additional metadata from the API (e.g. `{ key: \"missing_bank_info\" }` for payroll blockers) */\n  metadata?: Record<string, unknown>\n}\n\n/**\n * The unified SDK error type for all error scenarios.\n *\n * This is the core error shape exposed through partner-facing hooks. For\n * observability telemetry (which includes component context), see\n * `ObservabilityError` in `@/types/observability`.\n *\n * @example\n * ```tsx\n * const { error } = useEmployeeForm({ employeeId })\n *\n * if (error) {\n *   console.log(error.category)    // 'api_error'\n *   console.log(error.httpStatus)  // 422\n *   console.log(error.fieldErrors) // [{ field: 'firstName', ... }]\n * }\n * ```\n */\nexport interface SDKError {\n  /** High-level error classification */\n  category: SDKErrorCategory\n\n  /** Human-readable error summary */\n  message: string\n\n  /** HTTP status code (undefined for non-HTTP errors like network or validation) */\n  httpStatus?: number\n\n  /** Flattened field-level errors from API responses. Empty array for non-field errors. */\n  fieldErrors: SDKFieldError[]\n\n  /**\n   * The original error object for advanced use cases.\n   * May be stripped by sanitization (controlled by `sanitization.includeRawError`).\n   */\n  raw?: unknown\n}\n\ninterface ErrorWithErrors {\n  errors: EntityErrorObject[]\n}\n\nfunction hasErrorsArray(error: unknown): error is ErrorWithErrors {\n  return (\n    error !== null &&\n    typeof error === 'object' &&\n    'errors' in error &&\n    Array.isArray((error as ErrorWithErrors).errors)\n  )\n}\n\nfunction toSDKFieldError(entityError: EntityErrorObject): SDKFieldError {\n  return {\n    field: entityError.errorKey,\n    message: entityError.message ?? '',\n    category: entityError.category,\n    metadata: entityError.metadata as Record<string, unknown> | undefined,\n  }\n}\n\n/**\n * Extracts and flattens field errors from an API error's `errors[]` array.\n *\n * Uses the existing `getFieldErrors` recursive traversal for nested errors,\n * with a fallback for errors in categories that `getFieldErrors` doesn't handle.\n */\nfunction extractFieldErrors(errors: EntityErrorObject[]): SDKFieldError[] {\n  const flattened = errors.flatMap(err => getFieldErrors(err))\n  if (flattened.length > 0) {\n    return flattened.map(toSDKFieldError)\n  }\n\n  return errors.filter(err => err.message).map(toSDKFieldError)\n}\n\ninterface RawAPIFieldError {\n  error_key?: string\n  errorKey?: string\n  category: string\n  message?: string\n  metadata?: Record<string, unknown>\n}\n\nfunction rawToEntityError(raw: RawAPIFieldError): EntityErrorObject {\n  return {\n    errorKey: raw.errorKey ?? raw.error_key ?? '',\n    category: raw.category,\n    message: raw.message,\n    metadata: raw.metadata,\n  }\n}\n\nfunction tryExtractFieldErrorsFromBody(body: string | undefined): SDKFieldError[] {\n  if (!body) return []\n  try {\n    const parsed: unknown = JSON.parse(body)\n    if (\n      parsed !== null &&\n      typeof parsed === 'object' &&\n      'errors' in parsed &&\n      Array.isArray((parsed as { errors: unknown }).errors)\n    ) {\n      const errors = (parsed as { errors: RawAPIFieldError[] }).errors\n      return errors\n        .filter(err => err.message)\n        .map(rawToEntityError)\n        .map(toSDKFieldError)\n    }\n  } catch {\n    // Body isn't valid JSON\n  }\n  return []\n}\n\nfunction buildApiErrorMessage(fieldErrors: SDKFieldError[], fallbackMessage: string): string {\n  if (fieldErrors.length === 0) {\n    return fallbackMessage\n  }\n  return fieldErrors.length === 1\n    ? '1 field has issues'\n    : `${fieldErrors.length} fields have issues`\n}\n\n/**\n * Normalizes any caught error into a unified `SDKError`.\n *\n * Classification is based purely on the error type:\n * - `SDKInternalError` → uses the error's own `category` (default: `internal_error`)\n * - `GustoEmbeddedError` subclasses → `api_error`\n * - `SDKValidationError` → `validation_error`\n * - `HTTPClientError` subclasses → `network_error`\n * - Everything else → `internal_error`\n */\nexport function normalizeToSDKError(error: unknown): SDKError {\n  if (error instanceof SDKInternalError) {\n    return {\n      category: error.category,\n      message: error.message,\n      fieldErrors: [],\n      raw: error,\n    }\n  }\n\n  if (error instanceof SDKValidationError) {\n    return {\n      category: 'validation_error',\n      message: typeof error.rawMessage === 'string' ? error.rawMessage : error.message,\n      fieldErrors: [],\n      raw: error,\n    }\n  }\n\n  if (error instanceof HTTPClientError) {\n    return {\n      category: 'network_error',\n      message: error.message,\n      fieldErrors: [],\n      raw: error,\n    }\n  }\n\n  if (error instanceof GustoEmbeddedError) {\n    const httpStatus = error.httpMeta.response.status\n    const fieldErrors = hasErrorsArray(error)\n      ? extractFieldErrors(error.errors)\n      : tryExtractFieldErrorsFromBody(error.httpMeta.body)\n\n    return {\n      category: 'api_error',\n      message: buildApiErrorMessage(fieldErrors, error.message),\n      httpStatus,\n      fieldErrors,\n      raw: error,\n    }\n  }\n\n  if (error instanceof Error) {\n    return {\n      category: 'internal_error',\n      message: error.message,\n      fieldErrors: [],\n      raw: error,\n    }\n  }\n\n  return {\n    category: 'internal_error',\n    message: 'An unknown error occurred',\n    fieldErrors: [],\n    raw: error,\n  }\n}\n"],"names":["SDKInternalError","message","category","hasErrorsArray","error","toSDKFieldError","entityError","extractFieldErrors","errors","flattened","err","getFieldErrors","rawToEntityError","raw","tryExtractFieldErrorsFromBody","body","parsed","buildApiErrorMessage","fieldErrors","fallbackMessage","normalizeToSDKError","SDKValidationError","HTTPClientError","GustoEmbeddedError","httpStatus"],"mappings":"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"}

package/dist/types/sdkError.test.d.ts

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

package/docs/reference/endpoint-inventory.json

@@ -718,6 +718,55 @@
         "employeeUuid"
       ]
     },
+    "Employee.TerminationFlow": {
+      "endpoints": [
+        {
+          "method": "GET",
+          "path": "/v1/employees/:employeeId"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/employees/:employeeId/terminations"
+        },
+        {
+          "method": "POST",
+          "path": "/v1/employees/:employeeId/terminations"
+        },
+        {
+          "method": "PUT",
+          "path": "/v1/terminations/:employeeId"
+        },
+        {
+          "method": "POST",
+          "path": "/v1/companies/:companyId/payrolls"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/pay_periods/unprocessed_termination_pay_periods"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/payrolls"
+        },
+        {
+          "method": "DELETE",
+          "path": "/v1/employees/:employeeId/terminations"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/employees"
+        },
+        {
+          "method": "PUT",
+          "path": "/v1/companies/:companyId/payrolls/:payrollId/prepare"
+        }
+      ],
+      "variables": [
+        "companyId",
+        "employeeId",
+        "payrollId"
+      ]
+    },
     "InformationRequests": {
       "endpoints": [
         {
@@ -759,6 +808,26 @@
         "wireInRequestUuid"
       ]
     },
+    "Payroll.DismissalFlow": {
+      "endpoints": [
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/payrolls/:payrollId"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/pay_periods/unprocessed_termination_pay_periods"
+        },
+        {
+          "method": "POST",
+          "path": "/v1/companies/:companyId/payrolls"
+        }
+      ],
+      "variables": [
+        "companyId",
+        "payrollId"
+      ]
+    },
     "Payroll.OffCycleFlow": {
       "endpoints": [
         {
@@ -811,10 +880,6 @@
           "method": "GET",
           "path": "/v1/companies/:companyId/payrolls/:payrollId"
         },
-        {
-          "method": "PUT",
-          "path": "/v1/companies/:companyId/payrolls/:payrollId/calculate"
-        },
         {
           "method": "PUT",
           "path": "/v1/companies/:companyId/payrolls/:payrollId"
@@ -827,6 +892,10 @@
           "method": "GET",
           "path": "/v1/companies/:companyUuid/payrolls/blockers"
         },
+        {
+          "method": "PUT",
+          "path": "/v1/companies/:companyId/payrolls/:payrollId/calculate"
+        },
         {
           "method": "GET",
           "path": "/v1/companies/:companyId/employees"
@@ -1003,7 +1072,7 @@
         "recoveryCaseUuid"
       ]
     },
-    "Payroll.UNSTABLE_PayrollHooks": {
+    "Payroll.TransitionFlow": {
       "endpoints": [
         {
           "method": "GET",
@@ -1014,6 +1083,133 @@
         "companyId",
         "payrollId"
       ]
+    },
+    "Payroll.TransitionCreation": {
+      "endpoints": [
+        {
+          "method": "POST",
+          "path": "/v1/companies/:companyId/payrolls"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/pay_schedules"
+        }
+      ],
+      "variables": [
+        "companyId"
+      ]
+    },
+    "Payroll.TransitionPayrollAlert": {
+      "endpoints": [
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/pay_periods"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/pay_schedules"
+        },
+        {
+          "method": "POST",
+          "path": "/v1/companies/:companyUuid/payrolls/skip"
+        }
+      ],
+      "variables": [
+        "companyId",
+        "companyUuid"
+      ]
+    },
+    "UNSTABLE_Hooks.hooks.useCompensationForm": {
+      "endpoints": [
+        {
+          "method": "GET",
+          "path": "/v1/employees/:employeeId/jobs"
+        },
+        {
+          "method": "POST",
+          "path": "/v1/employees/:employeeId/jobs"
+        },
+        {
+          "method": "PUT",
+          "path": "/v1/jobs/:jobId"
+        },
+        {
+          "method": "PUT",
+          "path": "/v1/compensations/:compensationId"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/locations/:locationUuid/minimum_wages"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/employees/:employeeId/work_addresses"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/employees/:employeeId"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/federal_tax_details"
+        }
+      ],
+      "variables": [
+        "companyId",
+        "compensationId",
+        "employeeId",
+        "jobId",
+        "locationUuid"
+      ]
+    },
+    "UNSTABLE_Hooks.hooks.useEmployeeDetailsForm": {
+      "endpoints": [
+        {
+          "method": "GET",
+          "path": "/v1/employees/:employeeId"
+        },
+        {
+          "method": "POST",
+          "path": "/v1/companies/:companyId/employees"
+        },
+        {
+          "method": "PUT",
+          "path": "/v1/employees/:employeeId"
+        },
+        {
+          "method": "PUT",
+          "path": "/v1/employees/:employeeId/onboarding_status"
+        }
+      ],
+      "variables": [
+        "companyId",
+        "employeeId"
+      ]
+    },
+    "UNSTABLE_Hooks.hooks.useWorkAddressForm": {
+      "endpoints": [
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/locations"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/employees/:employeeId/work_addresses"
+        },
+        {
+          "method": "POST",
+          "path": "/v1/employees/:employeeId/work_addresses"
+        },
+        {
+          "method": "PUT",
+          "path": "/v1/work_addresses/:workAddressUuid"
+        }
+      ],
+      "variables": [
+        "companyId",
+        "employeeId",
+        "workAddressUuid"
+      ]
     }
   },
   "flows": {
@@ -1608,12 +1804,14 @@
     "Payroll.PayrollFlow": {
       "blocks": [
         "Payroll.ConfirmWireDetails",
+        "Payroll.OffCycleFlow",
         "Payroll.PayrollBlocker",
         "Payroll.PayrollConfiguration",
         "Payroll.PayrollEditEmployee",
         "Payroll.PayrollLanding",
         "Payroll.PayrollOverview",
-        "Payroll.PayrollReceipts"
+        "Payroll.PayrollReceipts",
+        "Payroll.TransitionFlow"
       ],
       "endpoints": [
         {
@@ -1634,23 +1832,19 @@
         },
         {
           "method": "GET",
-          "path": "/v1/companies/:companyUuid/payrolls/blockers"
+          "path": "/v1/companies/:companyId/payrolls/:payrollId"
         },
         {
           "method": "GET",
-          "path": "/v1/companies/:companyUuid/recovery_cases"
+          "path": "/v1/companies/:companyUuid/payrolls/blockers"
         },
         {
           "method": "GET",
-          "path": "/v1/companies/:companyUuid/information_requests"
+          "path": "/v1/companies/:companyUuid/recovery_cases"
         },
         {
           "method": "GET",
-          "path": "/v1/companies/:companyId/payrolls/:payrollId"
-        },
-        {
-          "method": "PUT",
-          "path": "/v1/companies/:companyId/payrolls/:payrollId/calculate"
+          "path": "/v1/companies/:companyUuid/information_requests"
         },
         {
           "method": "PUT",
@@ -1660,6 +1854,10 @@
           "method": "POST",
           "path": "/v1/payrolls/:payrollUuid/gross_up"
         },
+        {
+          "method": "PUT",
+          "path": "/v1/companies/:companyId/payrolls/:payrollId/calculate"
+        },
         {
           "method": "GET",
           "path": "/v1/companies/:companyId/employees"