feat(javascript): switch api key helper

Author: Fluf22

clients/algoliasearch-client-javascript/packages/client-common/src/createAuth.ts

@@ -7,6 +7,7 @@ export function createAuth(
 ): {
   readonly headers: () => Headers;
   readonly queryParameters: () => QueryParameters;
+  readonly setApiKey: (newApiKey: string) => void;
 } {
   const credentials = {
     'x-algolia-api-key': apiKey,
@@ -21,5 +22,9 @@ export function createAuth(
     queryParameters(): QueryParameters {
       return authMode === 'WithinQueryParameters' ? credentials : {};
     },
+
+    setApiKey(newApiKey: string): void {
+      credentials['x-algolia-api-key'] = newApiKey;
+    },
   };
 }

templates/javascript/clients/api-single.mustache

@@ -75,6 +75,15 @@ export function create{{#lambda.titlecase}}{{apiName}}{{/lambda.titlecase}}({
       transporter.algoliaAgent.add({ segment, version });
     },
 
+    /**
+    * Helper method to switch the API key used to authenticate the requests.
+    *
+    * @param apiKey - The new API Key to use.
+    */
+    setApiKey(apiKey: string): void {
+      auth.setApiKey(apiKey);
+    },
+
     {{#isSearchClient}}
     {{> client/api/helpers}}
     {{/isSearchClient}}