/*
 * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
 * @generated-id: 82fa0835d854
 */

import {
  MutationKey,
  useMutation,
  UseMutationResult,
} from "@tanstack/react-query";
import { GleanCore } from "../core.js";
import { clientSearchRecommendations } from "../funcs/clientSearchRecommendations.js";
import { combineSignals } from "../lib/primitives.js";
import { RequestOptions } from "../lib/sdks.js";
import * as components from "../models/components/index.js";
import { GleanBaseError } from "../models/errors/gleanbaseerror.js";
import {
  ConnectionError,
  InvalidRequestError,
  RequestAbortedError,
  RequestTimeoutError,
  UnexpectedClientError,
} from "../models/errors/httpclienterrors.js";
import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
import { unwrapAsync } from "../types/fp.js";
import { useGleanContext } from "./_context.js";
import { MutationHookOptions } from "./_types.js";

export type ClientSearchRecommendationsMutationVariables = {
  recommendationsRequest: components.RecommendationsRequest;
  locale?: string | undefined;
  options?: RequestOptions;
};

export type ClientSearchRecommendationsMutationData =
  | components.ResultsResponse
  | undefined;

export type ClientSearchRecommendationsMutationError =
  | GleanBaseError
  | ResponseValidationError
  | ConnectionError
  | RequestAbortedError
  | RequestTimeoutError
  | InvalidRequestError
  | UnexpectedClientError
  | SDKValidationError;

/**
 * Recommend documents
 *
 * @remarks
 * Retrieve recommended documents for the given URL or Glean Document ID.
 */
export function useClientSearchRecommendationsMutation(
  options?: MutationHookOptions<
    ClientSearchRecommendationsMutationData,
    ClientSearchRecommendationsMutationError,
    ClientSearchRecommendationsMutationVariables
  >,
): UseMutationResult<
  ClientSearchRecommendationsMutationData,
  ClientSearchRecommendationsMutationError,
  ClientSearchRecommendationsMutationVariables
> {
  const client = useGleanContext();
  return useMutation({
    ...buildClientSearchRecommendationsMutation(client, options),
    ...options,
  });
}

export function mutationKeyClientSearchRecommendations(): MutationKey {
  return ["@gleanwork/api-client", "search", "recommendations"];
}

export function buildClientSearchRecommendationsMutation(
  client$: GleanCore,
  hookOptions?: RequestOptions,
): {
  mutationKey: MutationKey;
  mutationFn: (
    variables: ClientSearchRecommendationsMutationVariables,
  ) => Promise<ClientSearchRecommendationsMutationData>;
} {
  return {
    mutationKey: mutationKeyClientSearchRecommendations(),
    mutationFn: function clientSearchRecommendationsMutationFn({
      recommendationsRequest,
      locale,
      options,
    }): Promise<ClientSearchRecommendationsMutationData> {
      const mergedOptions = {
        ...hookOptions,
        ...options,
        fetchOptions: {
          ...hookOptions?.fetchOptions,
          ...options?.fetchOptions,
          signal: combineSignals(
            hookOptions?.fetchOptions?.signal,
            options?.fetchOptions?.signal,
          ),
        },
      };
      return unwrapAsync(clientSearchRecommendations(
        client$,
        recommendationsRequest,
        locale,
        mergedOptions,
      ));
    },
  };
}