feat: configurable retry and delay

Author: joao-imi

lib/src/constants.ts

@@ -6,6 +6,7 @@ export const SCRIPT_COMPLETE = 'script-loaded';
 export const SENTRY_TAG = '@hCaptcha/loader';
 
 export const MAX_RETRIES = 2;
+export const RETRY_DELAY = 1000;
 
 export enum SentryContext {
   ANDROID = 'Android',

lib/src/loader.ts

@@ -1,5 +1,5 @@
 import { generateQuery, getFrame, getMountElement } from './utils';
-import { HCAPTCHA_LOAD_FN_NAME, MAX_RETRIES, SCRIPT_ERROR, SCRIPT_ID, SENTRY_TAG } from './constants';
+import { HCAPTCHA_LOAD_FN_NAME, MAX_RETRIES, RETRY_DELAY, SCRIPT_ERROR, SCRIPT_ID, SENTRY_TAG } from './constants';
 import { initSentry } from './sentry';
 import { fetchScript } from './script';
 
@@ -123,8 +123,18 @@ export function hCaptchaApi(params: ILoaderParams = { cleanup: false }, sentry:
   }
 }
 
-export async function loadScript(params, sentry, retries = 0) {
-  const message = retries < MAX_RETRIES ? 'Retry loading hCaptcha Api' : 'Exceeded maximum retries';
+function delay(ms: number): Promise<void> {
+  return new Promise(resolve => setTimeout(resolve, ms));
+}
+
+export async function loadScript(
+  params: ILoaderParams,
+  sentry: SentryHub,
+  retries = 0
+): Promise<any> {
+  const maxRetries = params.maxRetries ?? MAX_RETRIES;
+  const retryDelay = params.retryDelay ?? RETRY_DELAY;
+  const message = retries < maxRetries ? 'Retry loading hCaptcha Api' : 'Exceeded maximum retries';
 
   try {
     const result = await hCaptchaApi(params, sentry);
@@ -139,19 +149,25 @@ export async function loadScript(params, sentry, retries = 0) {
       message,
     });
 
-    if (retries >= MAX_RETRIES) {
+    if (retries >= maxRetries) {
       lastLoadFailed = true;
-      
+
       sentry.captureException(error);
       return Promise.reject(error);
     } else {
+      sentry.addBreadcrumb({
+        category: SENTRY_TAG,
+        message: `Waiting ${retryDelay}ms before retry attempt ${retries + 1}`,
+      });
+
+      await delay(retryDelay);
       retries += 1;
+
       return loadScript(params, sentry, retries);
     }
   }
 }
 
-
 export async function hCaptchaLoader(params: ILoaderParams = {}) {
   const sentry = initSentry(params.sentry);
 

lib/src/types.ts

@@ -23,6 +23,8 @@ export interface ILoaderParams extends IScriptParams {
     hl?: string;
     cleanup?: boolean;
     uj?: boolean;
+    maxRetries?: number;
+    retryDelay?: number;
 }
 
 export interface SentryHub {