fix(javascript): expose clearCache and appId at the root of the client (#892)

Author: shortcuts

clients/algoliasearch-client-javascript/packages/algoliasearch/__tests__/algoliasearch.test.ts

@@ -14,6 +14,14 @@ const client = algoliasearch('APP_ID', 'API_KEY', {
 });
 
 describe('api', () => {
+  it('exposes the `appId` currently in use at the root of the API', () => {
+    expect(client.appId).toEqual('APP_ID');
+  });
+
+  it('provides a `clearCache` method', () => {
+    expect(client.clearCache).not.toBeUndefined();
+  });
+
   it('sets the user agent', async () => {
     const req = (await client.post({
       path: '/test',

templates/javascript/clients/api-single.mustache

@@ -38,6 +38,21 @@ export function create{{capitalizedApiName}}({
   return {
     transporter,
 
+    /**
+     * The `appId` currently in use.
+     */
+    appId: appIdOption,
+
+    /**
+     * Clears the cache of the transporter for the `requestsCache` and `responsesCache` properties.
+     */
+    clearCache(): Promise<void> {
+      return Promise.all([
+        transporter.requestsCache.clear(),
+        transporter.responsesCache.clear(),
+      ]).then(() => undefined);
+    },
+
     /**
      * Get the value of the `algoliaAgent`, used by our libraries internally and telemetry system.
      */