feat: Add new method to fetch konnector token in native context

This will allow the flagship app to use a different token on each
connector launch, even from the same slug

docs/api/cozy-stack-client.md

@@ -1248,6 +1248,7 @@ through OAuth.
     * [.getAuthCodeURL(options)](#OAuthClient+getAuthCodeURL) ⇒ <code>string</code>
     * [.getAccessCodeFromURL(pageURL, stateCode)](#OAuthClient+getAccessCodeFromURL) ⇒ <code>string</code>
     * [.fetchAccessToken(accessCode, oauthOptionsArg, uri, codeVerifier)](#OAuthClient+fetchAccessToken) ⇒ <code>Promise</code>
+    * [.fetchKonnectorToken(slug)](#OAuthClient+fetchKonnectorToken) ⇒ <code>Promise.&lt;string&gt;</code>
     * [.fetchSessionCode()](#OAuthClient+fetchSessionCode) ⇒ [<code>Promise.&lt;SessionCodeRes&gt;</code>](#SessionCodeRes)
     * [.fetchSessionCodeWithPassword()](#OAuthClient+fetchSessionCodeWithPassword) ⇒ [<code>Promise.&lt;SessionCodeRes&gt;</code>](#SessionCodeRes)
     * [.loginFlagship()](#OAuthClient+loginFlagship) ⇒ <code>Promise.&lt;(AccessTokenRes\|TwoFactorNeededRes\|SessionCodeRes)&gt;</code>
@@ -1374,6 +1375,20 @@ Exchanges an access code for an access token. This function does **not** update
 | uri | <code>string</code> | — To use when OAuthClient is not yet registered (during login process) |
 | codeVerifier | <code>string</code> | — The PKCE code verifier (see https://docs.cozy.io/en/cozy-stack/auth/#pkce-extension) |
 
+<a name="OAuthClient+fetchKonnectorToken"></a>
+
+### oAuthClient.fetchKonnectorToken(slug) ⇒ <code>Promise.&lt;string&gt;</code>
+Used by the flagship application in order to create a token for the konnector with the given slug.
+This token can then be used by the client-side konnector to make requests to cozy-stack.
+The flagship app will need to use its own access token to request the konnector token.
+
+**Kind**: instance method of [<code>OAuthClient</code>](#OAuthClient)  
+**Returns**: <code>Promise.&lt;string&gt;</code> - - A promise that resolves with a new token  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| slug | <code>string</code> | The slug of the konnector |
+
 <a name="OAuthClient+fetchSessionCode"></a>
 
 ### oAuthClient.fetchSessionCode() ⇒ [<code>Promise.&lt;SessionCodeRes&gt;</code>](#SessionCodeRes)
@@ -2316,6 +2331,7 @@ Document representing a io.cozy.oauth.clients
     * [.getAuthCodeURL(options)](#OAuthClient+getAuthCodeURL) ⇒ <code>string</code>
     * [.getAccessCodeFromURL(pageURL, stateCode)](#OAuthClient+getAccessCodeFromURL) ⇒ <code>string</code>
     * [.fetchAccessToken(accessCode, oauthOptionsArg, uri, codeVerifier)](#OAuthClient+fetchAccessToken) ⇒ <code>Promise</code>
+    * [.fetchKonnectorToken(slug)](#OAuthClient+fetchKonnectorToken) ⇒ <code>Promise.&lt;string&gt;</code>
     * [.fetchSessionCode()](#OAuthClient+fetchSessionCode) ⇒ [<code>Promise.&lt;SessionCodeRes&gt;</code>](#SessionCodeRes)
     * [.fetchSessionCodeWithPassword()](#OAuthClient+fetchSessionCodeWithPassword) ⇒ [<code>Promise.&lt;SessionCodeRes&gt;</code>](#SessionCodeRes)
     * [.loginFlagship()](#OAuthClient+loginFlagship) ⇒ <code>Promise.&lt;(AccessTokenRes\|TwoFactorNeededRes\|SessionCodeRes)&gt;</code>
@@ -2442,6 +2458,20 @@ Exchanges an access code for an access token. This function does **not** update
 | uri | <code>string</code> | — To use when OAuthClient is not yet registered (during login process) |
 | codeVerifier | <code>string</code> | — The PKCE code verifier (see https://docs.cozy.io/en/cozy-stack/auth/#pkce-extension) |
 
+<a name="OAuthClient+fetchKonnectorToken"></a>
+
+### oAuthClient.fetchKonnectorToken(slug) ⇒ <code>Promise.&lt;string&gt;</code>
+Used by the flagship application in order to create a token for the konnector with the given slug.
+This token can then be used by the client-side konnector to make requests to cozy-stack.
+The flagship app will need to use its own access token to request the konnector token.
+
+**Kind**: instance method of [<code>OAuthClient</code>](#OAuthClient)  
+**Returns**: <code>Promise.&lt;string&gt;</code> - - A promise that resolves with a new token  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| slug | <code>string</code> | The slug of the konnector |
+
 <a name="OAuthClient+fetchSessionCode"></a>
 
 ### oAuthClient.fetchSessionCode() ⇒ [<code>Promise.&lt;SessionCodeRes&gt;</code>](#SessionCodeRes)

packages/cozy-stack-client/src/OAuthClient.js

@@ -395,6 +395,24 @@ class OAuthClient extends CozyStackClient {
     return new AccessToken(result)
   }
 
+  /**
+   * Used by the flagship application in order to create a token for the konnector with the given slug.
+   * This token can then be used by the client-side konnector to make requests to cozy-stack.
+   * The flagship app will need to use its own access token to request the konnector token.
+   *
+   * @param {string} slug - The slug of the konnector
+   * @returns {Promise<string>} - A promise that resolves with a new token
+   */
+  async fetchKonnectorToken(slug) {
+    try {
+      return await this.fetchJSON('POST', `/auth/tokens/konnectors/${slug}`)
+    } catch (error) {
+      throw new Error(
+        `oAuthClient.fetchKonnectorToken(): Could not create a token for the konnector with slug "${slug}". \n\n${error}`
+      )
+    }
+  }
+
   /**
    * @typedef SessionCodeRes
    * @property {string} session_code The value of the session code