feat(config): add support for timeout and retry config

- introduces two new extension parameters:
  - `TYPESENSE_CONNECTION_TIMEOUT_SECONDS`
  - `TYPESENSE_RETRY_INTERVAL_SECONDS`
- updates `config.js` to parse values from environment variables
- replaces random timeout values with user-defined config in `createTypesenseClient.js`
- improves predictability and customizability of Typesense client behavior

Author: tharropoulos

extension.yaml

@@ -348,3 +348,19 @@ params:
         value: true
     default: false
     required: false
+  - param: TYPESENSE_CONNECTION_TIMEOUT_SECONDS
+    label: Typesense Connection Timeout (seconds)
+    description: >-
+      The timeout in seconds for connections to Typesense. This applies to both connection timeout.
+    type: string
+    example: "60"
+    default: "60"
+    required: false
+  - param: TYPESENSE_RETRY_INTERVAL_SECONDS
+    label: Typesense Retry Interval (seconds)
+    description: >-
+      The retry interval in seconds for connections to Typesense. This applies to both connection timeout.
+    type: string
+    example: "60"
+    default: "60"
+    required: false

functions/src/config.js

@@ -11,6 +11,8 @@ module.exports = {
   typesenseProtocol: process.env.TYPESENSE_PROTOCOL || "https",
   typesenseCollectionName: process.env.TYPESENSE_COLLECTION_NAME,
   typesenseAPIKey: process.env.TYPESENSE_API_KEY,
+  typesenseConnectionTimeoutSeconds: parseInt(process.env.TYPESENSE_CONNECTION_TIMEOUT_SECONDS || "60", 10),
+  typesenseRetryIntervalSeconds: parseInt(process.env.TYPESENSE_RETRY_INTERVAL_SECONDS || "60", 10),
   typesenseBackfillTriggerDocumentInFirestore: "typesense_sync/backfill",
   typesenseBackfillBatchSize: 1000,
 };

functions/src/createTypesenseClient.js

@@ -1,11 +1,6 @@
 const config = require("./config.js");
 const Typesense = require("typesense");
 
-// eslint-disable-next-line require-jsdoc
-function getRandomNumber(min, max) {
-  return Math.floor(Math.random() * (max - min + 1)) + min;
-}
-
 module.exports = function () {
   return new Typesense.Client({
     nodes: config.typesenseHosts.map((h) => {
@@ -16,7 +11,7 @@ module.exports = function () {
       };
     }),
     apiKey: config.typesenseAPIKey,
-    connectionTimeoutSeconds: getRandomNumber(60, 90),
-    retryIntervalSeconds: getRandomNumber(60, 120),
+    connectionTimeoutSeconds: config.typesenseConnectionTimeoutSeconds,
+    retryIntervalSeconds: config.typesenseRetryIntervalSeconds,
   });
 };