@openapi-qraft/react 1.6.0 → 1.8.0

package/src/ServiceOperation.ts

@@ -1,1404 +1,67 @@
-import {
-  CancelOptions,
-  DefaultError,
-  FetchStatus,
-  InfiniteData,
-  InfiniteQueryPageParamsOptions,
-  InvalidateOptions,
-  Mutation,
-  MutationState,
-  MutationStatus,
-  NoInfer,
-  QueriesPlaceholderDataFunction,
-  Query,
-  QueryClient,
-  FetchQueryOptions,
-  RefetchOptions,
-  ResetOptions,
-  SetDataOptions,
-  Updater,
-  QueryFunction,
-  InitialPageParam,
-  GetNextPageParamFunction,
-  QueryState,
-} from '@tanstack/query-core';
-import type {
-  DefinedInitialDataInfiniteOptions,
-  DefinedInitialDataOptions,
-  DefinedUseInfiniteQueryResult,
-  DefinedUseQueryResult,
-  UndefinedInitialDataInfiniteOptions,
-  UndefinedInitialDataOptions,
-  UseInfiniteQueryResult,
-  UseMutationOptions,
-  UseMutationResult,
-  UseQueryOptions,
-  UseQueryResult,
-  UseSuspenseInfiniteQueryOptions,
-  UseSuspenseInfiniteQueryResult,
-  UseSuspenseQueryOptions,
-  UseSuspenseQueryResult,
-} from '@tanstack/react-query';
-
-import type { RequestFn } from './lib/requestFn.js';
-
-type ServiceOperationBaseQueryKey<
-  S extends { url: string; method: string },
-  Infinite extends boolean,
-  T,
-> = [S & { infinite: Infinite }, T];
-
-export type ServiceOperationQueryKey<
-  S extends { url: string; method: string },
-  T,
-> = ServiceOperationBaseQueryKey<S, false, T>;
-
-export type ServiceOperationInfiniteQueryKey<
-  S extends { url: string; method: string },
-  T,
-> = ServiceOperationBaseQueryKey<S, true, T>;
-
-export type ServiceOperationMutationKey<
-  S extends Record<'url' | 'method', string>,
-  T extends unknown,
-> = NonNullable<T> extends never ? [S] : [S, T];
-
-export interface ServiceOperationQuery<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams,
-  TError = DefaultError,
-> extends ServiceOperationUseQuery<TSchema, TData, TParams, TError>,
-    ServiceOperationUseQueries<TSchema, TData, TParams, TError>,
-    ServiceOperationUseSuspenseQueries<TSchema, TData, TParams, TError>,
-    ServiceOperationUseInfiniteQuery<TSchema, TData, TParams, TError>,
-    ServiceOperationUseSuspenseQueryQuery<TSchema, TData, TParams, TError>,
-    ServiceOperationUseSuspenseInfiniteQuery<TSchema, TData, TParams, TError>,
-    ServiceOperationUseIsFetchingQueries<TSchema, TData, TParams, TError>,
-    ServiceOperationQueryFn<TSchema, TData, TParams>,
-    ServiceOperationFetchQuery<TSchema, TData, TParams, TError>,
-    ServiceOperationFetchInfiniteQuery<TSchema, TData, TParams, TError>,
-    ServiceOperationGetQueryData<TSchema, TData, TParams>,
-    ServiceOperationGetQueryState<TSchema, TData, TParams, TError>,
-    ServiceOperationGetQueriesData<TSchema, TData, TParams, TError>,
-    ServiceOperationGetInfiniteQueryData<TSchema, TData, TParams>,
-    ServiceOperationSetQueryData<TSchema, TData, TParams>,
-    ServiceOperationSetQueriesData<TSchema, TData, TParams, TError>,
-    ServiceOperationSetInfiniteQueryData<TSchema, TData, TParams>,
-    ServiceOperationInvalidateQueries<TSchema, TData, TParams, TError>,
-    ServiceOperationCancelQueries<TSchema, TData, TParams, TError>,
-    ServiceOperationRemoveQueries<TSchema, TData, TParams, TError>,
-    ServiceOperationResetQueries<TSchema, TData, TParams, TError>,
-    ServiceOperationRefetchQueries<TSchema, TData, TParams, TError>,
-    ServiceOperationIsFetchingQueries<TSchema, TData, TParams, TError> {
-  schema: TSchema;
-  types: {
-    parameters: TParams;
-    data: TData;
-    error: TError;
-  };
-}
-
-interface ServiceOperationUseQuery<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-  TError = DefaultError,
-> {
-  getQueryKey<QueryKeyParams extends TParams | undefined = undefined>(
-    parameters?: QueryKeyParams
-  ): ServiceOperationQueryKey<TSchema, QueryKeyParams>;
-
-  useQuery(
-    parameters: TParams | ServiceOperationQueryKey<TSchema, TParams>,
-    options?: Omit<
-      UndefinedInitialDataOptions<
-        TData,
-        TError,
-        TData,
-        ServiceOperationQueryKey<TSchema, TParams>
-      >,
-      'queryKey'
-    >,
-    queryClient?: QueryClient
-  ): UseQueryResult<TData, TError | Error>;
-  useQuery(
-    parameters: TParams | ServiceOperationQueryKey<TSchema, TParams>,
-    options: Omit<
-      DefinedInitialDataOptions<
-        TData,
-        TError,
-        TData,
-        ServiceOperationQueryKey<TSchema, TParams>
-      >,
-      'queryKey'
-    >,
-    queryClient?: QueryClient
-  ): DefinedUseQueryResult<TData, TError | Error>;
-}
-
-type FetchQueryOptionsBase<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-  TError = DefaultError,
-> = Omit<
-  FetchQueryOptions<
-    TData,
-    TError,
-    TData,
-    ServiceOperationQueryKey<TSchema, TParams>
-  >,
-  'queryKey' | 'queryFn'
->;
+import type { DefaultError } from '@tanstack/query-core';
 
-interface FetchQueryOptionsByQueryKey<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-  TError = DefaultError,
-> extends FetchQueryOptionsBase<TSchema, TData, TParams, TError> {
-  /**
-   * Fetch Queries by query key
-   */
-  queryKey?: ServiceOperationQueryKey<TSchema, TParams>;
-}
-
-interface FetchQueryOptionsByParameters<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-  TError = DefaultError,
-> extends FetchQueryOptionsBase<TSchema, TData, TParams, TError> {
-  /**
-   * Fetch Queries by parameters
-   */
-  parameters?: TParams;
-  queryKey?: never;
-}
-
-type FetchQueryOptionsQueryFn<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-> =
-  | {
-      queryFn?: QueryFunction<
-        TData,
-        ServiceOperationQueryKey<TSchema, TParams>
-      >;
-    }
-  | {
-      requestFn: RequestFn<TData>;
-      /**
-       * Base URL to use for the request (used in the `queryFn`)
-       * @example 'https://api.example.com'
-       */
-      baseUrl: string | undefined;
-      queryFn?: never; // Workaround to fix union type error
-    };
-
-interface ServiceOperationFetchQuery<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-  TError = DefaultError,
-> {
-  fetchQuery(
-    options:
-      | (FetchQueryOptionsByQueryKey<TSchema, TData, TParams, TError> &
-          FetchQueryOptionsQueryFn<TSchema, TData, TParams>)
-      | (FetchQueryOptionsByParameters<TSchema, TData, TParams, TError> &
-          FetchQueryOptionsQueryFn<TSchema, TData, TParams>),
-    queryClient: QueryClient
-  ): Promise<TData>;
-  prefetchQuery(
-    options:
-      | (FetchQueryOptionsByQueryKey<TSchema, TData, TParams, TError> &
-          FetchQueryOptionsQueryFn<TSchema, TData, TParams>)
-      | (FetchQueryOptionsByParameters<TSchema, TData, TParams, TError> &
-          FetchQueryOptionsQueryFn<TSchema, TData, TParams>),
-    queryClient: QueryClient
-  ): Promise<void>;
-}
-
-type FetchInfiniteQueryOptionsBase<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-  TPageParam = unknown,
-  TError = DefaultError,
-> = Omit<
-  FetchQueryOptions<
-    TData,
-    TError,
-    InfiniteData<TData, TPageParam>,
-    ServiceOperationQueryKey<TSchema, TParams>,
-    TPageParam
-  >,
-  'queryKey'
-> &
-  InitialPageParam<PartialParameters<TPageParam>> &
-  FetchInfiniteQueryPages<TData, TPageParam>;
-
-type FetchInfiniteQueryPages<TData = unknown, TPageParam = unknown> =
-  | {
-      pages?: never;
-    }
-  | {
-      pages: number;
-      getNextPageParam: GetNextPageParamFunction<
-        PartialParameters<TPageParam>,
-        TData
-      >;
-    };
-
-type FetchInfiniteQueryOptionsByQueryKey<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-  TPageParam = {},
-  TError = DefaultError,
-> = FetchInfiniteQueryOptionsBase<
-  TSchema,
-  TData,
-  TParams,
-  TPageParam,
-  TError
-> & {
-  /**
-   * Fetch Queries by query key
-   */
-  queryKey?: ServiceOperationInfiniteQueryKey<TSchema, TParams>;
-  parameters?: never;
-};
-
-type FetchInfiniteQueryOptionsByParameters<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-  TPageParam = {},
-  TError = DefaultError,
-> = FetchInfiniteQueryOptionsBase<
-  TSchema,
-  TData,
-  TParams,
-  TPageParam,
-  TError
-> & {
-  /**
-   * Fetch Queries by parameters
-   */
-  parameters?: TParams;
-  queryKey?: never;
-};
-
-type FetchInfiniteQueryOptionsQueryFn<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-> =
-  | {
-      queryFn?: QueryFunction<
-        TData,
-        ServiceOperationInfiniteQueryKey<TSchema, TParams>
-      >;
-    }
-  | {
-      requestFn: RequestFn<TData>;
-      /**
-       * Base URL to use for the request (used in the `queryFn`)
-       * @example 'https://api.example.com'
-       */
-      baseUrl: string | undefined;
-      queryFn?: never; // Workaround to fix union type error
-    };
-
-interface ServiceOperationFetchInfiniteQuery<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-  TError = DefaultError,
-> {
-  fetchInfiniteQuery<TPageParam extends TParams>(
-    options:
-      | (FetchInfiniteQueryOptionsByQueryKey<
-          TSchema,
-          TData,
-          TParams,
-          TPageParam,
-          TError
-        > &
-          FetchInfiniteQueryOptionsQueryFn<TSchema, TData, TParams>)
-      | (FetchInfiniteQueryOptionsByParameters<
-          TSchema,
-          TData,
-          TParams,
-          TPageParam,
-          TError
-        > &
-          FetchInfiniteQueryOptionsQueryFn<TSchema, TData, TParams>),
-    queryClient: QueryClient
-  ): Promise<InfiniteData<TData, TPageParam>>;
-
-  prefetchInfiniteQuery<TPageParam extends TParams>(
-    options:
-      | (FetchInfiniteQueryOptionsByQueryKey<
-          TSchema,
-          TData,
-          TParams,
-          TPageParam,
-          TError
-        > &
-          FetchInfiniteQueryOptionsQueryFn<TSchema, TData, TParams>)
-      | (FetchInfiniteQueryOptionsByParameters<
-          TSchema,
-          TData,
-          TParams,
-          TPageParam,
-          TError
-        > &
-          FetchInfiniteQueryOptionsQueryFn<TSchema, TData, TParams>),
-    queryClient: QueryClient
-  ): Promise<void>;
-}
-
-interface ServiceOperationUseQueries<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-  TError = DefaultError,
-> {
-  useQueries<TCombinedResult = Array<UseQueryResult<TData, TError>>>(
-    options: {
-      queries: ReadonlyArray<
-        Omit<
-          UseQueryOptions<
-            TData,
-            TError,
-            TData,
-            ServiceOperationQueryKey<TSchema, TParams>
-          >,
-          'placeholderData' | 'suspense' | 'queryKey'
-        > & {
-          placeholderData?: TData | QueriesPlaceholderDataFunction<TData>;
-        } & (
-            | { parameters: TParams; queryKey?: never }
-            | { queryKey: ServiceOperationQueryKey<TSchema, TParams> }
-          )
-      >;
-      combine?: (
-        results: Array<UseQueryResult<TData, TError>>
-      ) => TCombinedResult;
-    },
-    queryClient?: QueryClient
-  ): TCombinedResult;
-}
-
-type QueryTypeFilter = 'all' | 'active' | 'inactive';
-
-interface QueryFiltersBase<
-  TSchema extends { url: string; method: string },
-  TData,
-  TInfinite extends boolean,
-  TParams = {},
-  TError = DefaultError,
-> {
-  /**
-   * Include queries matching this predicate function
-   */
-  predicate?: TInfinite extends true
-    ? QueryFilterInfinitePredicate<TSchema, TData, TParams, TError>
-    : TInfinite extends false
-      ? QueryFilterRegularPredicate<TSchema, TData, TParams, TError>
-      : (query: string) => boolean;
-  /**
-   * Filter to active queries, inactive queries or all queries
-   */
-  type?: QueryTypeFilter;
-  /**
-   * Match query key exactly
-   */
-  exact?: boolean;
-  /**
-   * Include or exclude stale queries
-   */
-  stale?: boolean;
-  /**
-   * Include queries matching their fetchStatus
-   */
-  fetchStatus?: FetchStatus;
-}
-
-interface QueryFiltersByQueryKey<
-  TSchema extends { url: string; method: string },
-  TData,
-  TInfinite extends boolean,
-  TParams = {},
-  TError = DefaultError,
-> extends QueryFiltersBase<TSchema, TData, TInfinite, TParams, TError> {
-  /**
-   * Include queries matching this query key
-   */
-  queryKey?: ServiceOperationBaseQueryKey<TSchema, TInfinite, TParams>;
-
-  infinite?: never;
-  parameters?: never;
-}
-
-interface QueryFiltersByParameters<
-  TSchema extends { url: string; method: string },
-  TData,
-  TInfinite extends boolean,
-  TParams = {},
-  TError = DefaultError,
-> extends QueryFiltersBase<TSchema, TData, TInfinite, TParams, TError> {
-  /**
-   * Is the query infinite
-   */
-  infinite?: TInfinite;
-
-  /**
-   * Include queries matching parameters
-   */
-  parameters?: TParams;
-
-  queryKey?: never;
-}
-
-interface QueryFilterInfinitePredicate<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-  TError = DefaultError,
-> {
-  /**
-   * Include queries matching this predicate function
-   */
-  (
-    query: Query<
-      InfiniteData<TData, TParams>,
-      TError,
-      InfiniteData<TData, TParams>,
-      ServiceOperationInfiniteQueryKey<TSchema, TParams>
-    >
-  ): boolean;
-}
-
-interface QueryFilterRegularPredicate<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-  TError = DefaultError,
-> {
-  /**
-   * Include queries matching this predicate function
-   */
-  (
-    query: Query<
-      TData,
-      TError,
-      TData,
-      ServiceOperationQueryKey<TSchema, TParams>
-    >
-  ): boolean;
-}
-
-type InvalidateQueryFilters<
-  TSchema extends { url: string; method: string },
-  TData,
-  TInfinite extends boolean,
-  TParams = {},
-  TError = DefaultError,
-> = (
-  | QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError>
-  | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>
-) & {
-  refetchType?: QueryTypeFilter | 'none';
-};
-
-interface ServiceOperationInvalidateQueries<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-  TError = DefaultError,
-> {
-  invalidateQueries<TInfinite extends boolean>(
-    filters: InvalidateQueryFilters<TSchema, TData, TInfinite, TParams, TError>,
-    options: InvalidateOptions,
-    queryClient: QueryClient
-  ): Promise<void>;
-  invalidateQueries<TInfinite extends boolean>(
-    filters: InvalidateQueryFilters<TSchema, TData, TInfinite, TParams, TError>,
-    queryClient: QueryClient
-  ): Promise<void>;
-  invalidateQueries(queryClient: QueryClient): Promise<void>;
-}
-
-/**
- * @internal
- */
-export interface ServiceOperationInvalidateQueriesCallback<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-  TError = DefaultError,
-> extends ServiceOperationInvalidateQueries<TSchema, TData, TParams, TError> {
-  invalidateQueries<TInfinite extends boolean>(
-    filters:
-      | InvalidateQueryFilters<TSchema, TData, TInfinite, TParams, TError>
-      | QueryClient,
-    options?: InvalidateOptions | QueryClient,
-    queryClient?: QueryClient
-  ): Promise<void>;
-}
-
-interface ServiceOperationCancelQueries<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-  TError = DefaultError,
-> {
-  cancelQueries<TInfinite extends boolean>(
-    filters:
-      | QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError>
-      | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>,
-    options: CancelOptions,
-    queryClient: QueryClient
-  ): Promise<void>;
-  cancelQueries<TInfinite extends boolean>(
-    filters:
-      | QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError>
-      | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>,
-    queryClient: QueryClient
-  ): Promise<void>;
-  cancelQueries(queryClient: QueryClient): Promise<void>;
-}
-
-/**
- * @internal
- */
-export interface ServiceOperationCancelQueriesCallback<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-  TError = DefaultError,
-> extends ServiceOperationCancelQueries<TSchema, TData, TParams, TError> {
-  cancelQueries<TInfinite extends boolean>(
-    filters:
-      | QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError>
-      | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>
-      | QueryClient,
-    options?: CancelOptions | QueryClient,
-    queryClient?: QueryClient
-  ): Promise<void>;
-}
-
-interface ServiceOperationRemoveQueries<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-  TError = DefaultError,
-> {
-  removeQueries<TInfinite extends boolean>(
-    filters:
-      | QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError>
-      | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>,
-    queryClient: QueryClient
-  ): void;
-  removeQueries(queryClient: QueryClient): void;
-}
-
-/**
- * @internal
- */
-export interface ServiceOperationRemoveQueriesCallback<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-  TError = DefaultError,
-> extends ServiceOperationRemoveQueries<TSchema, TData, TParams, TError> {
-  removeQueries<TInfinite extends boolean>(
-    filters:
-      | QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError>
-      | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>
-      | QueryClient,
-    queryClient?: QueryClient
-  ): void;
-}
-
-interface ServiceOperationResetQueries<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-  TError = DefaultError,
-> {
-  resetQueries<TInfinite extends boolean>(
-    filters:
-      | QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError>
-      | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>,
-    options: ResetOptions,
-    queryClient: QueryClient
-  ): Promise<void>;
-  resetQueries<TInfinite extends boolean>(
-    filters:
-      | QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError>
-      | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>,
-    queryClient: QueryClient
-  ): Promise<void>;
-  resetQueries(queryClient: QueryClient): Promise<void>;
-}
+import type {
+  ServiceOperationQuery as ServiceOperationQueryBase,
+  ServiceOperationMutation as ServiceOperationMutationBase,
+} from './service-operation/ServiceOperation.js';
+import type {
+  ServiceOperationInfiniteQueryKey as ServiceOperationInfiniteQueryKeyBase,
+  ServiceOperationMutationKey as ServiceOperationMutationKeyBase,
+  ServiceOperationQueryKey as ServiceOperationQueryKeyBase,
+} from './service-operation/ServiceOperationKey.js';
+import type { ServiceOperationMutationFn as ServiceOperationMutationFnBase } from './service-operation/ServiceOperationMutationFn.js';
 
 /**
- * @internal
+ * @deprecated Use `ServiceOperationMutationFn` from `@openapi-qraft/react/service-operation/ServiceOperationMutationFn` instead.
  */
-export interface ServiceOperationResetQueriesCallback<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-  TError = DefaultError,
-> extends ServiceOperationResetQueries<TSchema, TData, TParams, TError> {
-  resetQueries<TInfinite extends boolean>(
-    filters:
-      | QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError>
-      | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>
-      | QueryClient,
-    options?: ResetOptions | QueryClient,
-    queryClient?: QueryClient
-  ): Promise<void>;
-}
-
-interface ServiceOperationRefetchQueries<
+export type ServiceOperationMutationFn<
   TSchema extends { url: string; method: string },
+  TBody,
   TData,
-  TParams = {},
-  TError = DefaultError,
-> {
-  refetchQueries<TInfinite extends boolean>(
-    filters:
-      | QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError>
-      | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>,
-    options: RefetchOptions,
-    queryClient: QueryClient
-  ): Promise<void>;
-  refetchQueries<TInfinite extends boolean>(
-    filters:
-      | QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError>
-      | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>,
-    queryClient: QueryClient
-  ): Promise<void>;
-  refetchQueries(queryClient: QueryClient): Promise<void>;
-}
+  TParams,
+> = ServiceOperationMutationFnBase<TSchema, TBody, TData, TParams>;
 
 /**
- * @internal
+ * @deprecated Use `ServiceOperationQuery` from `@openapi-qraft/react` instead.
  */
-export interface ServiceOperationResetQueriesCallback<
+export type ServiceOperationQuery<
   TSchema extends { url: string; method: string },
   TData,
-  TParams = {},
-  TError = DefaultError,
-> extends ServiceOperationRefetchQueries<TSchema, TData, TParams, TError> {
-  refetchQueries<TInfinite extends boolean>(
-    filters:
-      | QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError>
-      | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>
-      | QueryClient,
-    options?: RefetchOptions | QueryClient,
-    queryClient?: QueryClient
-  ): Promise<void>;
-}
-
-interface ServiceOperationIsFetchingQueries<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
+  TParams,
   TError = DefaultError,
-> {
-  isFetching<TInfinite extends boolean>(
-    filters:
-      | QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError>
-      | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>,
-    queryClient: QueryClient
-  ): number;
-  isFetching(queryClient: QueryClient): number;
-}
+> = ServiceOperationQueryBase<TSchema, TData, TParams, TError>;
 
 /**
- * @internal
+ * @deprecated Use `ServiceOperationMutation` from `@openapi-qraft/react` instead.
  */
-export interface ServiceOperationIsFetchingQueriesCallback<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-  TError = DefaultError,
-> extends ServiceOperationIsFetchingQueries<TSchema, TData, TParams, TError> {
-  refetchQueries<TInfinite extends boolean>(
-    filters:
-      | QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError>
-      | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>
-      | QueryClient,
-    queryClient?: QueryClient
-  ): number;
-}
-
-interface ServiceOperationUseIsFetchingQueries<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-  TError = DefaultError,
-> {
-  useIsFetching<TInfinite extends boolean>(
-    filters?:
-      | QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError>
-      | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>,
-    queryClient?: QueryClient
-  ): number;
-}
-
-interface ServiceOperationUseSuspenseQueries<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-  TError = DefaultError,
-> {
-  useSuspenseQueries<
-    TCombinedResult = Array<UseSuspenseQueryResult<TData, TError>>,
-  >(
-    options: {
-      queries: ReadonlyArray<
-        Omit<
-          UseSuspenseQueryOptions<
-            TData,
-            TError,
-            TData,
-            ServiceOperationQueryKey<TSchema, TParams>
-          >,
-          'queryKey'
-        > &
-          (
-            | { parameters: TParams; queryKey?: never }
-            | { queryKey: ServiceOperationQueryKey<TSchema, TParams> }
-          )
-      >;
-      combine?: (
-        results: Array<UseSuspenseQueryResult<TData, TError>>
-      ) => TCombinedResult;
-    },
-    queryClient?: QueryClient
-  ): TCombinedResult;
-}
-
-interface ServiceOperationUseInfiniteQuery<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-  TError = DefaultError,
-> {
-  getInfiniteQueryKey<TQueryKeyParams extends TParams>(
-    parameters: TQueryKeyParams
-  ): ServiceOperationInfiniteQueryKey<TSchema, TQueryKeyParams>;
-
-  useInfiniteQuery<TPageParam extends TParams>(
-    parameters: TParams | ServiceOperationInfiniteQueryKey<TSchema, TParams>,
-    options: Omit<
-      UndefinedInitialDataInfiniteOptions<
-        TData,
-        TError,
-        InfiniteData<TData, TParams>,
-        ServiceOperationInfiniteQueryKey<TSchema, TParams>,
-        PartialParameters<TPageParam>
-      >,
-      | 'queryKey'
-      | 'getPreviousPageParam'
-      | 'getNextPageParam'
-      | 'initialPageParam'
-    > &
-      InfiniteQueryPageParamsOptions<TData, PartialParameters<TPageParam>>,
-    queryClient?: QueryClient
-  ): UseInfiniteQueryResult<InfiniteData<TData, TParams>, TError | Error>;
-  useInfiniteQuery<TPageParam extends TParams>(
-    parameters: TParams | ServiceOperationInfiniteQueryKey<TSchema, TParams>,
-    options: Omit<
-      DefinedInitialDataInfiniteOptions<
-        TData,
-        TError,
-        InfiniteData<TData, TParams>,
-        ServiceOperationInfiniteQueryKey<TSchema, TParams>,
-        PartialParameters<TPageParam>
-      >,
-      | 'queryKey'
-      | 'getPreviousPageParam'
-      | 'getNextPageParam'
-      | 'initialPageParam'
-    > &
-      InfiniteQueryPageParamsOptions<TData, PartialParameters<TPageParam>>,
-    queryClient?: QueryClient
-  ): DefinedUseInfiniteQueryResult<
-    InfiniteData<TData, TParams>,
-    TError | Error
-  >;
-}
-
-interface ServiceOperationUseSuspenseInfiniteQuery<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-  TError = DefaultError,
-> {
-  useSuspenseInfiniteQuery<TPageParam extends TParams>(
-    parameters: TParams | ServiceOperationInfiniteQueryKey<TSchema, TParams>,
-    options: Omit<
-      UseSuspenseInfiniteQueryOptions<
-        TData,
-        TError,
-        InfiniteData<TData, TParams>,
-        TData,
-        ServiceOperationInfiniteQueryKey<TSchema, TParams>,
-        PartialParameters<TPageParam>
-      >,
-      | 'queryKey'
-      | 'getPreviousPageParam'
-      | 'getNextPageParam'
-      | 'initialPageParam'
-    > &
-      InfiniteQueryPageParamsOptions<TData, PartialParameters<TPageParam>>,
-    queryClient?: QueryClient
-  ): UseSuspenseInfiniteQueryResult<
-    InfiniteData<TData, TParams>,
-    TError | Error
-  >;
-}
-
-interface ServiceOperationUseSuspenseQueryQuery<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-  TError = DefaultError,
-> {
-  useSuspenseQuery(
-    parameters: TParams | ServiceOperationQueryKey<TSchema, TParams>,
-    options?: Omit<
-      UseSuspenseQueryOptions<
-        TData,
-        TError,
-        TData,
-        ServiceOperationQueryKey<TSchema, TParams>
-      >,
-      'queryKey'
-    >,
-    queryClient?: QueryClient
-  ): UseSuspenseQueryResult<TData, TError | Error>;
-}
-
-export interface ServiceOperationMutation<
-  TSchema extends { url: string; method: string },
-  TBody,
-  TData,
-  TParams,
-  TError = DefaultError,
-> extends ServiceOperationUseMutation<TSchema, TBody, TData, TParams, TError>,
-    ServiceOperationUseIsMutating<TSchema, TBody, TData, TParams, TError>,
-    ServiceOperationUseMutationState<TSchema, TBody, TData, TParams, TError>,
-    ServiceOperationIsMutatingQueries<TSchema, TBody, TData, TParams, TError>,
-    ServiceOperationMutationFn<TSchema, TBody, TData, TParams> {
-  schema: TSchema;
-  types: {
-    parameters: TParams;
-    data: TData;
-    error: TError;
-    body: TBody;
-  };
-}
-
-interface ServiceOperationUseMutation<
-  TSchema extends { url: string; method: string },
-  TBody,
-  TData,
-  TParams,
-  TError = DefaultError,
-> {
-  getMutationKey<TMutationKeyParams extends TParams | undefined = undefined>(
-    parameters?: TMutationKeyParams
-  ): ServiceOperationMutationKey<TSchema, TMutationKeyParams>;
-
-  useMutation<
-    TVariables extends MutationVariables<TBody, TParams>,
-    TContext = unknown,
-  >(
-    parameters?: undefined,
-    options?: Omit<
-      UseMutationOptions<TData, TError, TVariables, TContext>,
-      'mutationKey'
-    > & {
-      mutationKey?: ServiceOperationMutationKey<TSchema, TParams>;
-    },
-    queryClient?: QueryClient
-  ): UseMutationResult<TData, TError | Error, TVariables, TContext>;
-
-  useMutation<TVariables extends TBody, TContext = unknown>(
-    parameters: TParams,
-    options?: Omit<
-      UseMutationOptions<TData, TError, TVariables, TContext>,
-      'mutationKey'
-    >,
-    queryClient?: QueryClient
-  ): UseMutationResult<TData, TError | Error, TVariables, TContext>;
-}
-
-interface UseMutationStateFiltersBase<
-  TBody,
-  TData,
-  TParams,
-  TError = DefaultError,
-  TContext = unknown,
-> {
-  /**
-   * Match mutation key exactly
-   */
-  exact?: boolean;
-  /**
-   * Include mutations matching this predicate function
-   */
-  predicate?: (
-    mutation: Mutation<
-      TData,
-      TError,
-      MutationVariables<TBody, TParams>,
-      TContext
-    >
-  ) => boolean;
-
-  /**
-   * Filter by mutation status
-   */
-  status?: MutationStatus;
-}
-
-interface MutationFiltersByParameters<
-  TBody,
-  TData,
-  TParams,
-  TError = DefaultError,
-  TContext = unknown,
-> extends UseMutationStateFiltersBase<TBody, TData, TParams, TError, TContext> {
-  /**
-   * Include mutations matching these parameters
-   */
-  parameters?: PartialParameters<TParams>;
-  mutationKey?: never;
-}
-
-interface MutationFiltersByMutationKey<
-  TSchema extends { url: string; method: string },
-  TBody,
-  TData,
-  TParams,
-  TError = DefaultError,
-  TContext = unknown,
-> extends UseMutationStateFiltersBase<TBody, TData, TParams, TError, TContext> {
-  /**
-   * Include mutations matching this mutation key
-   */
-  mutationKey?: ServiceOperationMutationKey<
-    TSchema,
-    PartialParameters<TParams>
-  >;
-  parameters?: never;
-}
-
-type MutationVariables<TBody, TParams> = {
-  body: TBody;
-} & (NonNullable<TParams> extends never ? {} : TParams);
-
-interface ServiceOperationUseMutationState<
-  TSchema extends { url: string; method: string },
-  TBody,
-  TData,
-  TParams,
-  TError = DefaultError,
-> {
-  useMutationState<
-    TContext = unknown,
-    TResult = MutationState<
-      TData,
-      TError,
-      MutationVariables<TBody, TParams>,
-      TContext
-    >,
-  >(
-    options?: {
-      filters?:
-        | MutationFiltersByParameters<TBody, TData, TParams, TError, TContext>
-        | MutationFiltersByMutationKey<
-            TSchema,
-            TBody,
-            TData,
-            TParams,
-            TError,
-            TContext
-          >;
-      select?: (
-        mutation: Mutation<
-          TData,
-          TError,
-          MutationVariables<TBody, TParams>,
-          TContext
-        >
-      ) => TResult;
-    },
-    queryClient?: QueryClient
-  ): Array<TResult>;
-}
-
-interface ServiceOperationUseIsMutating<
+export type ServiceOperationMutation<
   TSchema extends { url: string; method: string },
   TBody,
   TData,
   TParams,
   TError = DefaultError,
-> {
-  useIsMutating<TContext = unknown>(
-    filters?:
-      | MutationFiltersByParameters<TBody, TData, TParams, TError, TContext>
-      | MutationFiltersByMutationKey<
-          TSchema,
-          TBody,
-          TData,
-          TParams,
-          TError,
-          TContext
-        >,
-    queryClient?: QueryClient
-  ): number;
-}
-
-interface QueryFnOptionsBase<
-  TMeta extends Record<string, any>,
-  TSignal extends AbortSignal = AbortSignal,
-> {
-  signal?: TSignal;
-  meta?: TMeta;
-}
-
-interface QueryFnOptionsByParameters<
-  TParams,
-  TMeta extends Record<string, any>,
-  TSignal extends AbortSignal = AbortSignal,
-> extends QueryFnOptionsBase<TMeta, TSignal> {
-  parameters: TParams;
-  queryKey?: never;
-}
-
-interface QueryFnOptionsByQueryKey<
-  TSchema extends { url: string; method: string },
-  TParams,
-  TMeta extends Record<string, any>,
-  TSignal extends AbortSignal = AbortSignal,
-> extends QueryFnOptionsBase<TMeta, TSignal> {
-  queryKey: ServiceOperationQueryKey<TSchema, TParams>;
-}
-
-interface ServiceOperationQueryFn<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams,
-> {
-  queryFn<
-    TMeta extends Record<string, any>,
-    TSignal extends AbortSignal = AbortSignal,
-  >(
-    options:
-      | QueryFnOptionsByParameters<TParams, TMeta, TSignal>
-      | QueryFnOptionsByQueryKey<TSchema, TParams, TMeta, TSignal>,
-    client: (
-      schema: TSchema,
-      options: {
-        parameters: TParams;
-        signal?: TSignal;
-        meta?: TMeta;
-      }
-    ) => TData
-  ): TData;
-
-  queryFn<
-    TMeta extends Record<string, any>,
-    TSignal extends AbortSignal = AbortSignal,
-  >(
-    options:
-      | QueryFnOptionsByParameters<TParams, TMeta, TSignal>
-      | QueryFnOptionsByQueryKey<TSchema, TParams, TMeta, TSignal>,
-    client: (
-      schema: TSchema,
-      options: {
-        parameters: TParams;
-        signal?: TSignal;
-        meta?: TMeta;
-      }
-    ) => Promise<TData>
-  ): Promise<TData>;
-}
-
-interface ServiceOperationSetQueryData<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {}, // todo::try to replace `TParams = {}` with `TParams = undefined`
-> {
-  setQueryData(
-    parameters: TParams | ServiceOperationQueryKey<TSchema, TParams>,
-    updater: Updater<NoInfer<TData> | undefined, NoInfer<TData> | undefined>,
-    options: SetDataOptions,
-    queryClient: QueryClient
-  ): TData | undefined;
-
-  setQueryData(
-    parameters: TParams | ServiceOperationQueryKey<TSchema, TParams>,
-    updater: Updater<NoInfer<TData> | undefined, NoInfer<TData> | undefined>,
-    queryClient: QueryClient
-  ): TData | undefined;
-}
+> = ServiceOperationMutationBase<TSchema, TBody, TData, TParams, TError>;
 
 /**
- * @internal
+ * @deprecated Use `ServiceOperationQueryKey` from `@openapi-qraft/react/service-operation/ServiceOperationKey` instead.
  */
-export interface ServiceOperationSetQueryDataCallback<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-> extends ServiceOperationSetQueryData<TSchema, TData, TParams> {
-  setQueryData(
-    parameters: TParams | ServiceOperationQueryKey<TSchema, TParams>,
-    updater: Updater<NoInfer<TData> | undefined, NoInfer<TData> | undefined>,
-    options: SetDataOptions | QueryClient,
-    queryClient?: QueryClient
-  ): TData | undefined;
-}
-
-interface ServiceOperationSetQueriesData<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {}, // todo::try to replace `TParams = {}` with `TParams = undefined`
-  TError = DefaultError,
-> {
-  setQueriesData<TInfinite extends boolean>(
-    filters:
-      | QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError>
-      | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>,
-    updater: Updater<NoInfer<TData> | undefined, NoInfer<TData> | undefined>,
-    options: SetDataOptions,
-    queryClient: QueryClient
-  ): Array<TData | undefined>;
-
-  setQueriesData<TInfinite extends boolean>(
-    filters:
-      | QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError>
-      | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>,
-    updater: Updater<NoInfer<TData> | undefined, NoInfer<TData> | undefined>,
-    queryClient: QueryClient
-  ): Array<TData | undefined>;
-}
-
-/**
- * @internal
- */
-export interface ServiceOperationSetQueriesDataCallback<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-  TError = DefaultError,
-> extends ServiceOperationSetQueriesData<TSchema, TData, TParams, TError> {
-  setQueriesData<TInfinite extends boolean>(
-    filters:
-      | QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError>
-      | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>,
-    updater: Updater<NoInfer<TData> | undefined, NoInfer<TData> | undefined>,
-    options: SetDataOptions | QueryClient,
-    queryClient?: QueryClient
-  ): Array<TData | undefined>;
-}
-
-interface ServiceOperationGetQueriesData<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {}, // todo::try to replace `TParams = {}` with `TParams = undefined`
-  TError = DefaultError,
-> {
-  getQueriesData<TInfinite extends boolean>(
-    filters:
-      | QueryFiltersByParameters<TSchema, TData, TInfinite, TParams, TError>
-      | QueryFiltersByQueryKey<TSchema, TData, TInfinite, TParams, TError>,
-    queryClient: QueryClient
-  ): TInfinite extends true
-    ? Array<
-        [
-          queryKey: ServiceOperationInfiniteQueryKey<TSchema, TParams>,
-          data: NoInfer<InfiniteData<TData, TParams>> | undefined,
-        ]
-      >
-    : Array<
-        [
-          queryKey: ServiceOperationQueryKey<TSchema, TParams>,
-          data: TData | undefined,
-        ]
-      >;
-}
-
-interface ServiceOperationSetInfiniteQueryData<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-> {
-  setInfiniteQueryData(
-    parameters: TParams | ServiceOperationInfiniteQueryKey<TSchema, TParams>,
-    updater: Updater<
-      NoInfer<InfiniteData<TData, TParams>> | undefined,
-      NoInfer<InfiniteData<TData, TParams>> | undefined
-    >,
-    queryClient: QueryClient,
-    options?: SetDataOptions
-  ): InfiniteData<TData, TParams> | undefined;
-}
-
-interface ServiceOperationGetQueryData<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-> {
-  getQueryData(
-    parameters: TParams | ServiceOperationQueryKey<TSchema, TParams>,
-    queryClient: QueryClient
-  ): TData | undefined;
-}
-
-interface ServiceOperationGetInfiniteQueryData<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-> {
-  getInfiniteQueryData(
-    parameters: TParams | ServiceOperationInfiniteQueryKey<TSchema, TParams>,
-    queryClient: QueryClient
-  ): InfiniteData<TData, TParams> | undefined;
-}
-
-interface ServiceOperationGetQueryState<
-  TSchema extends { url: string; method: string },
-  TData,
-  TParams = {},
-  TError = DefaultError,
-> {
-  getQueryState(
-    parameters: TParams | ServiceOperationQueryKey<TSchema, TParams>,
-    queryClient: QueryClient
-  ): QueryState<TData, TError> | undefined;
-
-  getInfiniteQueryState(
-    parameters: TParams | ServiceOperationInfiniteQueryKey<TSchema, TParams>,
-    queryClient: QueryClient
-  ):
-    | QueryState<InfiniteData<TData, PartialParameters<TParams>>, TError>
-    | undefined;
-}
-
-export interface ServiceOperationMutationFn<
-  TSchema extends { url: string; method: string },
-  TBody,
-  TData,
-  TParams,
-> {
-  mutationFn(
-    client: (
-      schema: TSchema,
-      options: {
-        parameters: TParams;
-        body: TBody;
-      }
-    ) => TData,
-    options: {
-      parameters: TParams;
-      body: TBody;
-    }
-  ): TData;
-
-  mutationFn(
-    client: (
-      schema: TSchema,
-      options: {
-        parameters: TParams;
-        body: TBody;
-      }
-    ) => Promise<TData>,
-    options: {
-      parameters: TParams;
-      body: TBody;
-    }
-  ): Promise<TData>;
-}
-
-interface ServiceOperationIsMutatingQueries<
-  TSchema extends { url: string; method: string },
-  TBody,
-  TData,
-  TParams = {},
-  TError = DefaultError,
-> {
-  isMutating<TContext>(
-    filters:
-      | MutationFiltersByParameters<TBody, TData, TParams, TError, TContext>
-      | MutationFiltersByMutationKey<
-          TSchema,
-          TBody,
-          TData,
-          TParams,
-          TError,
-          TContext
-        >,
-    queryClient: QueryClient
-  ): number;
-  isMutating(queryClient: QueryClient): number;
-}
+export type ServiceOperationQueryKey<
+  S extends { url: string; method: string },
+  T,
+> = ServiceOperationQueryKeyBase<S, T>;
 
 /**
- * @internal
+ * @deprecated Use `ServiceOperationInfiniteQueryKey` from `@openapi-qraft/react/service-operation/ServiceOperationKey` instead.
  */
-export interface ServiceOperationIsMutatingQueriesCallback<
-  TSchema extends { url: string; method: string },
-  TBody,
-  TData,
-  TParams = {},
-  TError = DefaultError,
-> extends ServiceOperationIsMutatingQueries<
-    TSchema,
-    TBody,
-    TData,
-    TParams,
-    TError
-  > {
-  isMutating<TContext>(
-    filters:
-      | MutationFiltersByParameters<TBody, TData, TParams, TError, TContext>
-      | MutationFiltersByMutationKey<
-          TSchema,
-          TBody,
-          TData,
-          TParams,
-          TError,
-          TContext
-        >
-      | QueryClient,
-    queryClient?: QueryClient
-  ): number;
-}
+export type ServiceOperationInfiniteQueryKey<
+  S extends { url: string; method: string },
+  T,
+> = ServiceOperationInfiniteQueryKeyBase<S, T>;
 
 /**
- * Shallow partial 'parameters'.
- * @example
- * ```ts
- * {query?: {page: number, nested: {still: 'not_partial'}}}
- * // =>
- * {query?: {page?: number, nested?: {still: 'not_partial'}}}
- * ```
+ * @deprecated Use `ServiceOperationMutationKey` from `@openapi-qraft/react/service-operation/ServiceOperationKey` instead.
  */
-type PartialParameters<T> = T extends object
-  ? { [K in keyof T]?: T[K] extends object ? Partial<T[K]> : T[K] }
-  : T;
+export type ServiceOperationMutationKey<
+  S extends Record<'url' | 'method', string>,
+  T,
+> = ServiceOperationMutationKeyBase<S, T>;