/*
 * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
 */

import {
  InvalidateQueryFilters,
  QueryClient,
  useQuery,
  UseQueryResult,
  useSuspenseQuery,
  UseSuspenseQueryResult,
} from "@tanstack/react-query";
import * as components from "../models/components/index.js";
import {
  ConnectionError,
  InvalidRequestError,
  RequestAbortedError,
  RequestTimeoutError,
  UnexpectedClientError,
} from "../models/errors/httpclienterrors.js";
import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
import { SDKError } from "../models/errors/sdkerror.js";
import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
import * as operations from "../models/operations/index.js";
import { useSDKContext } from "./_context.js";
import {
  QueryHookOptions,
  SuspenseQueryHookOptions,
  TupleToPrefixes,
} from "./_types.js";
import {
  buildLlmUsageResponsesQuery,
  LlmUsageResponsesQueryData,
  prefetchLlmUsageResponses,
  queryKeyLlmUsageResponses,
} from "./llmUsageResponses.core.js";
export {
  buildLlmUsageResponsesQuery,
  type LlmUsageResponsesQueryData,
  prefetchLlmUsageResponses,
  queryKeyLlmUsageResponses,
};

export type LlmUsageResponsesQueryError =
  | SDKError
  | ResponseValidationError
  | ConnectionError
  | RequestAbortedError
  | RequestTimeoutError
  | InvalidRequestError
  | UnexpectedClientError
  | SDKValidationError;

/**
 * Get responses usage
 *
 * @remarks
 * Retrieve usage metrics for agent responses, aggregated from the Response table.
 */
export function useLlmUsageResponses(
  request: operations.GetResponsesUsageRequest,
  options?: QueryHookOptions<
    LlmUsageResponsesQueryData,
    LlmUsageResponsesQueryError
  >,
): UseQueryResult<LlmUsageResponsesQueryData, LlmUsageResponsesQueryError> {
  const client = useSDKContext();
  return useQuery({
    ...buildLlmUsageResponsesQuery(
      client,
      request,
      options,
    ),
    ...options,
  });
}

/**
 * Get responses usage
 *
 * @remarks
 * Retrieve usage metrics for agent responses, aggregated from the Response table.
 */
export function useLlmUsageResponsesSuspense(
  request: operations.GetResponsesUsageRequest,
  options?: SuspenseQueryHookOptions<
    LlmUsageResponsesQueryData,
    LlmUsageResponsesQueryError
  >,
): UseSuspenseQueryResult<
  LlmUsageResponsesQueryData,
  LlmUsageResponsesQueryError
> {
  const client = useSDKContext();
  return useSuspenseQuery({
    ...buildLlmUsageResponsesQuery(
      client,
      request,
      options,
    ),
    ...options,
  });
}

export function setLlmUsageResponsesData(
  client: QueryClient,
  queryKeyBase: [
    parameters: {
      startTime: number;
      endTime?: number | undefined;
      bucketWidth?: components.BucketWidth | undefined;
      limit?: number | undefined;
      page?: string | undefined;
      userIds?: Array<string> | undefined;
      externalUserIds?: Array<string> | undefined;
      allOrgs?: string | undefined;
      orgIds?: Array<string> | undefined;
      groupBy?: Array<components.ResponsesGroupBy> | undefined;
      models?: Array<string> | undefined;
      background?: boolean | undefined;
      xOnBehalfOf?: string | undefined;
    },
  ],
  data: LlmUsageResponsesQueryData,
): LlmUsageResponsesQueryData | undefined {
  const key = queryKeyLlmUsageResponses(...queryKeyBase);

  return client.setQueryData<LlmUsageResponsesQueryData>(key, data);
}

export function invalidateLlmUsageResponses(
  client: QueryClient,
  queryKeyBase: TupleToPrefixes<
    [parameters: {
      startTime: number;
      endTime?: number | undefined;
      bucketWidth?: components.BucketWidth | undefined;
      limit?: number | undefined;
      page?: string | undefined;
      userIds?: Array<string> | undefined;
      externalUserIds?: Array<string> | undefined;
      allOrgs?: string | undefined;
      orgIds?: Array<string> | undefined;
      groupBy?: Array<components.ResponsesGroupBy> | undefined;
      models?: Array<string> | undefined;
      background?: boolean | undefined;
      xOnBehalfOf?: string | undefined;
    }]
  >,
  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
): Promise<void> {
  return client.invalidateQueries({
    ...filters,
    queryKey: ["@meetkai/mka1", "usage", "responses", ...queryKeyBase],
  });
}

export function invalidateAllLlmUsageResponses(
  client: QueryClient,
  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
): Promise<void> {
  return client.invalidateQueries({
    ...filters,
    queryKey: ["@meetkai/mka1", "usage", "responses"],
  });
}