/* * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT. */ import { MutationKey, useMutation, UseMutationResult, } from "@tanstack/react-query"; import { GustoEmbeddedCore } from "../core.js"; import { companiesFinishOnboarding } from "../funcs/companiesFinishOnboarding.js"; import { combineSignals } from "../lib/primitives.js"; import { RequestOptions } from "../lib/sdks.js"; import { GustoEmbeddedError } from "../models/errors/gustoembeddederror.js"; import { ConnectionError, InvalidRequestError, RequestAbortedError, RequestTimeoutError, UnexpectedClientError, } from "../models/errors/httpclienterrors.js"; import { NotFoundErrorObject } from "../models/errors/notfounderrorobject.js"; import { ResponseValidationError } from "../models/errors/responsevalidationerror.js"; import { SDKValidationError } from "../models/errors/sdkvalidationerror.js"; import { UnprocessableEntityError } from "../models/errors/unprocessableentityerror.js"; import { GetV1CompanyFinishOnboardingRequest, GetV1CompanyFinishOnboardingResponse, } from "../models/operations/getv1companyfinishonboarding.js"; import { unwrapAsync } from "../types/fp.js"; import { useGustoEmbeddedContext } from "./_context.js"; import { MutationHookOptions } from "./_types.js"; export type CompaniesFinishOnboardingMutationVariables = { request: GetV1CompanyFinishOnboardingRequest; options?: RequestOptions; }; export type CompaniesFinishOnboardingMutationData = GetV1CompanyFinishOnboardingResponse; export type CompaniesFinishOnboardingMutationError = | NotFoundErrorObject | UnprocessableEntityError | GustoEmbeddedError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError; /** * Finish company onboarding * * @remarks * Finalize a company's onboarding process. * * ### Approve a company in demo * * After a company is finished onboarding, Gusto requires an additional step to review and approve that company. * The company onboarding status is "onboarding_completed": false, until the API call is made to finish company * onboarding. In production environments, this step is required for risk-analysis purposes. * * We provide the endpoint `PUT '/v1/companies/{company_uuid}/approve'` to facilitate company approvals in the demo environment. * * ```shell * PUT '/v1/companies/89771af8-b964-472e-8064-554dfbcb56d9/approve' * * # Response: Company object, with company_status: 'Approved' * ``` * * scope: `companies:write` */ export function useCompaniesFinishOnboardingMutation( options?: MutationHookOptions< CompaniesFinishOnboardingMutationData, CompaniesFinishOnboardingMutationError, CompaniesFinishOnboardingMutationVariables >, ): UseMutationResult< CompaniesFinishOnboardingMutationData, CompaniesFinishOnboardingMutationError, CompaniesFinishOnboardingMutationVariables > { const client = useGustoEmbeddedContext(); return useMutation({ ...buildCompaniesFinishOnboardingMutation(client, options), ...options, }); } export function mutationKeyCompaniesFinishOnboarding(): MutationKey { return ["@gusto/embedded-api", "Companies", "finishOnboarding"]; } export function buildCompaniesFinishOnboardingMutation( client$: GustoEmbeddedCore, hookOptions?: RequestOptions, ): { mutationKey: MutationKey; mutationFn: ( variables: CompaniesFinishOnboardingMutationVariables, ) => Promise; } { return { mutationKey: mutationKeyCompaniesFinishOnboarding(), mutationFn: function companiesFinishOnboardingMutationFn({ request, options, }): Promise { const mergedOptions = { ...hookOptions, ...options, fetchOptions: { ...hookOptions?.fetchOptions, ...options?.fetchOptions, signal: combineSignals( hookOptions?.fetchOptions?.signal, options?.fetchOptions?.signal, ), }, }; return unwrapAsync(companiesFinishOnboarding( client$, request, mergedOptions, )); }, }; }