Add skip condition on endpoint definition

Author: SYoder1

packages/toolkit/src/query/core/buildThunks.ts

@@ -919,6 +919,14 @@ In the case of an unhandled error, no tags will be "provided" or "invalidated".`
           return true
         }
 
+        if (
+          isQueryDefinition(endpointDefinition) &&
+          endpointDefinition?.skipCondition &&
+          endpointDefinition?.skipCondition(state)
+        ) {
+          return false
+        }
+
         if (
           isQueryDefinition(endpointDefinition) &&
           endpointDefinition?.forceRefetch?.({

packages/toolkit/src/query/endpointDefinitions.ts

@@ -612,6 +612,18 @@ export interface QueryExtraOptions<
    */
   invalidatesTags?: never
 
+  /**
+   * Can be provided to skip the query if the condition is met.
+   *
+   * It's the equivalent of the `skip` option on the query hook but for the endpoint definition.
+   *
+   * @example
+   * ```ts
+   * skipCondition: (state) => state.user.isLoggedIn === false
+   * ```
+   */
+  skipCondition?: (state: RootState<any, string, ReducerPath>) => boolean
+
   /**
    * Can be provided to return a custom cache key value based on the query arguments.
    *

packages/toolkit/src/query/react/buildHooks.ts

@@ -64,7 +64,10 @@ import type { ReactHooksModuleOptions } from './module'
 import { useStableQueryArgs } from './useSerializedStableValue'
 import { useShallowStableValue } from './useShallowStableValue'
 import type { InfiniteQueryDirection } from '../core/apiState'
-import { isInfiniteQueryDefinition } from '../endpointDefinitions'
+import {
+  isInfiniteQueryDefinition,
+  isQueryDefinition,
+} from '../endpointDefinitions'
 import type { StartInfiniteQueryActionCreator } from '../core/buildInitiate'
 
 // Copy-pasted from React-Redux
@@ -1992,9 +1995,17 @@ export function buildHooks<Definitions extends EndpointDefinitions>({
       },
       useQuery(arg, options) {
         const querySubscriptionResults = useQuerySubscription(arg, options)
+        const store = useStore<RootState<Definitions, any, any>>()
+
+        const endpointDefinition = context.endpointDefinitions[endpointName]
+        const shouldSkipFromCondition =
+          isQueryDefinition(endpointDefinition) &&
+          endpointDefinition?.skipCondition &&
+          endpointDefinition?.skipCondition(store.getState())
+
         const queryStateResults = useQueryState(arg, {
           selectFromResult:
-            arg === skipToken || options?.skip
+            arg === skipToken || options?.skip || shouldSkipFromCondition
               ? undefined
               : noPendingQueryStateSelector,
           ...options,