docs: client headers & composables

Author: Diizzayy

docs/content/1.getting-started/2.composables.md

@@ -16,34 +16,52 @@ useGqlCors({ credentials: 'same-origin' })
 Add Authorization header to subsequent requests.
 
 ### Bearer token
+
 ```ts
 useGqlToken('secret_token')
-```
 
-Add `Bearer` token to a specific client
-```ts
+// Add `Bearer` token to a specific client
 useGqlToken('my_github_token', { client: 'github' })
 ```
 
 ### Custom token
+
 ```ts
-useGqlToken('secret_token', {
+useGqlToken({
+  token: 'secret_token',
   config: {
     type: 'Bearer',
     name: 'X-Custom-Auth'
   }
 })
 ```
 
+### Clear token
+
+```ts
+// Clear token from default client
+useGqlToken(null)
+
+// Clear token from a specific client
+useGqlToken({ token: null, client: '<client>' })
+```
+
 ## useGqlHeaders
 
 Add the specified headers to subsequent requests.
 
 ```ts
 useGqlHeaders({ 'X-Custom-Header': 'value' })
+
+// Add headers to a specific client.
+useGqlHeaders({ 'X-CSRF-TOKEN': 'value' }, 'client-name')
 ```
 
-Add headers to a specific client.
+### Reset headers
+
 ```ts
-useGqlHeaders({ 'X-CSRF-TOKEN': 'value' }, 'client-name')
+useGqlHeaders(null)
+
+// Reset headers for a specific client.
+useGqlHeaders({ headers: null, client: '<client>' })
 ```

docs/content/1.getting-started/3.configuration.md

@@ -115,6 +115,8 @@ When enabled, this flag will force tokens set at config-level to be retained cli
 
 By default, tokens set by `runtimeConfig` or `environment variables` only live server-side (for Code Generation & SSR requests).
 
+[More information here](/advanced/authentication#retain-token-on-client-side)
+
 ### `proxyCookies`
 
 Pass cookies from the browser to the GraphQL API in SSR mode.
@@ -123,4 +125,7 @@ Pass cookies from the browser to the GraphQL API in SSR mode.
 Enabled by default.
 ::
 
-[More information here](/advanced/authentication#retain-token-on-client-side)
+### `headers`
+
+Configure default headers to be sent with each request.
+