feat: async query pager fetch with cache policy

Sources/ApolloPagination/AsyncGraphQLQueryPager.swift

@@ -237,8 +237,12 @@ public class AsyncGraphQLQueryPager<Model>: Publisher {
   }
 
   /// Fetches the first page.
-  public func fetch() async {
-    await pager.fetch()
+  /// - Parameters:
+  ///   - cachePolicy: The Apollo `CachePolicy` to use. Defaults to `returnCacheDataAndFetch`.
+  public func fetch(
+    cachePolicy: CachePolicy = .returnCacheDataAndFetch
+  ) async {
+    await pager.fetch(cachePolicy: cachePolicy)
   }
 
   /// Resets pagination state and cancels in-flight updates from the pager.

Sources/ApolloPagination/AsyncGraphQLQueryPagerCoordinator.swift

@@ -14,7 +14,7 @@ public protocol AsyncPagerType {
   func loadNext(cachePolicy: CachePolicy) async throws
   func loadAll(fetchFromInitialPage: Bool) async throws
   func refetch(cachePolicy: CachePolicy) async
-  func fetch() async
+  func fetch(cachePolicy: CachePolicy) async
 }
 
 actor AsyncGraphQLQueryPagerCoordinator<InitialQuery: GraphQLQuery, PaginatedQuery: GraphQLQuery>: AsyncPagerType {
@@ -123,7 +123,7 @@ actor AsyncGraphQLQueryPagerCoordinator<InitialQuery: GraphQLQuery, PaginatedQue
         reset()
         isLoadingAll = true
         group.addTask { [weak self] in
-          await self?.fetch(cachePolicy: .fetchIgnoringCacheData)
+          await self?.privateFetch(cachePolicy: .fetchIgnoringCacheData)
         }
       } else if initialPageResult == nil {
         // Otherwise, we have to make sure that we have an `initialPageResult`
@@ -186,12 +186,12 @@ actor AsyncGraphQLQueryPagerCoordinator<InitialQuery: GraphQLQuery, PaginatedQue
   func refetch(cachePolicy: CachePolicy = .fetchIgnoringCacheData) async {
     assert(firstPageWatcher != nil, "To create consistent product behaviors, calling `fetch` before calling `refetch` will use cached data while still refreshing.")
     reset()
-    await fetch(cachePolicy: cachePolicy)
+    await privateFetch(cachePolicy: cachePolicy)
   }
 
-  func fetch() async {
+  func fetch(cachePolicy: CachePolicy = .returnCacheDataAndFetch) async {
     reset()
-    await fetch(cachePolicy: .returnCacheDataAndFetch)
+    await privateFetch(cachePolicy: cachePolicy)
   }
 
   /// Cancels any in-flight fetching operations and unsubscribes from the store.
@@ -223,7 +223,7 @@ actor AsyncGraphQLQueryPagerCoordinator<InitialQuery: GraphQLQuery, PaginatedQue
 
   // MARK: - Private
 
-  private func fetch(cachePolicy: CachePolicy = .returnCacheDataAndFetch) async {
+  private func privateFetch(cachePolicy: CachePolicy) async {
     await execute { [weak self] publisher in
       guard let self else { return }
       if await self.firstPageWatcher == nil {