Merge pull request #37 from guendev/feat/use-apollo-clients

feat(core): add `useApolloClients` composable for managing multiple Apollo clients

Author: guendev

packages/core/README.md

@@ -94,14 +94,14 @@ const { error, loading, result } = useQuery(GET_POSTS)
 
 ## 🧠 Composables Overview
 
-| Composable | Description |
-|-------------|--------------|
-| `useQuery` | Reactive GraphQL query |
-| `useLazyQuery` | Run query on demand |
-| `useMutation` | Execute GraphQL mutations |
-| `useSubscription` | Subscribe to GraphQL streams |
-| `useApolloClient` | Access current Apollo client |
-| `provideApolloClients` / `useApolloClients` | Manage multiple clients |
+| Composable         | Description                                    |
+|--------------------|------------------------------------------------|
+| `useQuery`         | Reactive GraphQL query                         |
+| `useMutation`      | Execute GraphQL mutations                      |
+| `useSubscription`  | Subscribe to GraphQL streams                   |
+| `useFragment`      | Retrieve and manage normalized cache fragments |
+| `useApolloClient`  | Access current Apollo client                   |
+| `useApolloClients` | Access Apollo clients                          |
 
 See the [full API reference](https://vue3-apollo.guen.dev/core/composables/use-query) for details.
 

packages/core/src/composables/useApolloClients.ts

@@ -0,0 +1,35 @@
+import { inject } from 'vue'
+
+import { APOLLO_CLIENTS_KEY } from '../constants/apollo'
+
+/**
+ * Get all Apollo client instances
+ *
+ * @returns Object containing all registered Apollo clients
+ *
+ * @example
+ * ```ts
+ * // Get all clients
+ * const clients = useApolloClients()
+ *
+ * // Access specific client
+ * const defaultClient = clients.default
+ * const analyticsClient = clients.analytics
+ *
+ * // Iterate over all clients
+ * Object.entries(clients).forEach(([id, client]) => {
+ *   console.log(`Client ${id}:`, client)
+ * })
+ * ```
+ */
+export function useApolloClients() {
+    const apolloClients = inject(APOLLO_CLIENTS_KEY)
+
+    if (!apolloClients) {
+        throw new Error(
+            '[useApolloClients] Apollo clients registry not found. Did you forget to install ApolloPlugin?'
+        )
+    }
+
+    return apolloClients
+}

packages/core/src/index.ts

@@ -1,4 +1,6 @@
 export * from './composables/useApolloClient'
+export * from './composables/useApolloClients'
+
 export * from './composables/useFragment'
 export * from './composables/useMutation'
 export * from './composables/useQuery'

packages/docs/composables/useApolloClient.md

@@ -14,6 +14,7 @@ const result = await client.query({
     query: GET_USERS,
 })
 ```
+> Use `useApolloClients()` to get all clients.
 
 ## API
 
@@ -22,4 +23,4 @@ const result = await client.query({
   - If omitted, returns the first available client (usually the `default` one).
 
 ### Returns
-- **`ApolloClient`** – the Apollo client instance.
+- **`ApolloClient`** – the Apollo client instance.

packages/nuxt/src/module.ts

@@ -36,6 +36,7 @@ export default defineNuxtModule<ApolloModuleOptions>({
                     from: '@vue3-apollo/core',
                     imports: [
                         // composables
+                        'useApolloClients',
                         'useApolloClient',
                         'useFragment',
                         'useMutation',