feat(javascript): allow overriding all transporter options (#615)

Author: Haroenv

clients/algoliasearch-client-javascript/packages/client-common/src/types/CreateClient.ts

@@ -1,31 +1,23 @@
-import type { Cache } from './Cache';
-import type { Host } from './Host';
-import type { Requester } from './Requester';
-import type {
-  Timeouts,
-  AlgoliaAgentOptions,
-  TransporterOptions,
-} from './Transporter';
+import type { AlgoliaAgentOptions, TransporterOptions } from './Transporter';
 
 export type AuthMode = 'WithinHeaders' | 'WithinQueryParameters';
 
-export type CreateClientOptions = Pick<
+type OverriddenTransporterOptions =
+  | 'baseHeaders'
+  | 'baseQueryParameters'
+  | 'hosts';
+
+export type CreateClientOptions = Omit<
   TransporterOptions,
-  'hostsCache' | 'requestsCache' | 'responsesCache'
-> & {
-  appId: string;
-  apiKey: string;
-  requester: Requester;
-  timeouts: Timeouts;
-  algoliaAgents: AlgoliaAgentOptions[];
-  hosts?: Host[];
-  authMode?: AuthMode;
-};
+  OverriddenTransporterOptions | 'algoliaAgent'
+> &
+  Partial<Pick<TransporterOptions, OverriddenTransporterOptions>> & {
+    appId: string;
+    apiKey: string;
+    authMode?: AuthMode;
+    algoliaAgents: AlgoliaAgentOptions[];
+  };
 
-export type InitClientOptions = Partial<{
-  requester: Requester;
-  hosts: Host[];
-  responsesCache: Cache;
-  requestsCache: Cache;
-  hostsCache: Cache;
-}>;
+export type InitClientOptions = Partial<
+  Omit<CreateClientOptions, 'apiKey' | 'appId'>
+>;

templates/javascript/api-single.mustache

@@ -83,25 +83,31 @@ function getDefaultHosts(region{{#fallbackToAliasHost}}?{{/fallbackToAliasHost}}
 {{/hasRegionalHost}}
 
 // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
-export function create{{capitalizedApiName}}(options: CreateClientOptions{{#hasRegionalHost}} & {region{{#fallbackToAliasHost}}?{{/fallbackToAliasHost}}: Region }{{/hasRegionalHost}}) {
-  const auth = createAuth(options.appId, options.apiKey, options.authMode);
+export function create{{capitalizedApiName}}({
+    appId: appIdOption,
+    apiKey: apiKeyOption,
+    authMode,
+    algoliaAgents,{{#hasRegionalHost}} region: regionOption,{{/hasRegionalHost}}
+    ...options
+  }: CreateClientOptions{{#hasRegionalHost}} & {region{{#fallbackToAliasHost}}?{{/fallbackToAliasHost}}: Region }{{/hasRegionalHost}}) {
+  const auth = createAuth(appIdOption, apiKeyOption, authMode);
   const transporter = createTransporter({
-    hosts: options?.hosts ?? getDefaultHosts({{^hasRegionalHost}}options.appId{{/hasRegionalHost}}{{#hasRegionalHost}}options.region{{/hasRegionalHost}}),
-    hostsCache: options.hostsCache,
-    requestsCache: options.requestsCache,
-    responsesCache: options.responsesCache,
-    baseHeaders: {
-      'content-type': 'text/plain',
-      ...auth.headers(),
-    },
-    baseQueryParameters: auth.queryParameters(),
+    hosts: getDefaultHosts({{^hasRegionalHost}}appIdOption{{/hasRegionalHost}}{{#hasRegionalHost}}regionOption{{/hasRegionalHost}}),
+    ...options,
     algoliaAgent: getAlgoliaAgent({
-      algoliaAgents: options.algoliaAgents,
+      algoliaAgents: algoliaAgents,
       client: '{{{algoliaAgent}}}',
       version: apiClientVersion,
     }),
-    timeouts: options.timeouts,
-    requester: options.requester,
+    baseHeaders: {
+      'content-type': 'text/plain',
+      ...auth.headers(),
+      ...options.baseHeaders,
+    },
+    baseQueryParameters: {
+      ...auth.queryParameters(),
+      ...options.baseQueryParameters,
+    },
   });
 
   function addAlgoliaAgent(segment: string, version?: string): void {

templates/javascript/browser.mustache

@@ -40,12 +40,12 @@ export function {{apiName}}(
       read: 2,
       write: 30,
     },
-    requester: options?.requester ?? createXhrRequester(),
+    requester: createXhrRequester(),
     algoliaAgents: [{ segment: 'Browser' }],
     authMode: 'WithinQueryParameters',
-    responsesCache: options?.responsesCache ?? createMemoryCache(),
-    requestsCache: options?.requestsCache ?? createMemoryCache({ serializable: false }),
-    hostsCache: options?.hostsCache ?? createFallbackableCache({
+    responsesCache: createMemoryCache(),
+    requestsCache: createMemoryCache({ serializable: false }),
+    hostsCache: createFallbackableCache({
       caches: [
         createBrowserLocalStorageCache({ key: `${apiClientVersion}-${appId}` }),
         createMemoryCache(),

templates/javascript/node.mustache

@@ -40,11 +40,11 @@ export function {{apiName}}(
       read: 5,
       write: 30,
     },
-    requester: options?.requester ?? createHttpRequester(),
+    requester: createHttpRequester(),
     algoliaAgents: [{ segment: 'Node.js', version: process.versions.node }],
-    responsesCache: options?.responsesCache ?? createNullCache(),
-    requestsCache: options?.requestsCache ?? createNullCache(),
-    hostsCache: options?.hostsCache ?? createMemoryCache(),
+    responsesCache: createNullCache(),
+    requestsCache: createNullCache(),
+    hostsCache: createMemoryCache(),
     ...options,
   });
 }