@adwait12345/telemetry-core 0.1.2 → 0.1.3

package/dist/index.d.mts

@@ -65,6 +65,18 @@ interface TelemetryConfig {
      * This is required since these requests originate from the server and cannot pass domain validation checks via Origin.
      */
     serverSecret?: string;
+    /**
+     * Fully custom Authorization header value.
+     * Overrides the default "Bearer {serverSecret}" format.
+     * e.g. "Token mytoken" or "Basic dXNlcjpwYXNz"
+     */
+    authorizationHeader?: string;
+    /**
+     * Additional custom headers to send with every telemetry request.
+     * These are merged on top of the defaults and can override them.
+     * e.g. { "x-workspace-id": "abc123" }
+     */
+    headers?: Record<string, string>;
 }
 /** Payload sent to the Telemetry server-side tracking endpoint */
 interface ServerTrackPayload {
@@ -142,7 +154,7 @@ declare const ALL_BOTS: BotDefinition[];
 
 /**
  * Sends a server-side payload to the Telemetry backend.
- * This is meant to be fire-and-forget, so it does not throw errors.
+ * Automatically retries on transient failures with exponential backoff.
  *
  * @param payload The data to track.
  * @param config The Telemetry configuration.

package/dist/index.d.ts

@@ -65,6 +65,18 @@ interface TelemetryConfig {
      * This is required since these requests originate from the server and cannot pass domain validation checks via Origin.
      */
     serverSecret?: string;
+    /**
+     * Fully custom Authorization header value.
+     * Overrides the default "Bearer {serverSecret}" format.
+     * e.g. "Token mytoken" or "Basic dXNlcjpwYXNz"
+     */
+    authorizationHeader?: string;
+    /**
+     * Additional custom headers to send with every telemetry request.
+     * These are merged on top of the defaults and can override them.
+     * e.g. { "x-workspace-id": "abc123" }
+     */
+    headers?: Record<string, string>;
 }
 /** Payload sent to the Telemetry server-side tracking endpoint */
 interface ServerTrackPayload {
@@ -142,7 +154,7 @@ declare const ALL_BOTS: BotDefinition[];
 
 /**
  * Sends a server-side payload to the Telemetry backend.
- * This is meant to be fire-and-forget, so it does not throw errors.
+ * Automatically retries on transient failures with exponential backoff.
  *
  * @param payload The data to track.
  * @param config The Telemetry configuration.

package/dist/index.js

@@ -1112,6 +1112,59 @@ function extractAutomationHeaders(headers) {
 }
 
 // src/index.ts
+function buildHeaders(config) {
+  const headers = {
+    "Content-Type": "application/json"
+  };
+  if (config.authorizationHeader) {
+    headers["Authorization"] = config.authorizationHeader;
+  } else if (config.serverSecret) {
+    headers["Authorization"] = `Bearer ${config.serverSecret}`;
+  }
+  if (config.headers) {
+    Object.assign(headers, config.headers);
+  }
+  return headers;
+}
+async function sendWithRetry(endpoint, payload, config, retries = 2) {
+  const headers = buildHeaders(config);
+  for (let attempt = 0; attempt <= retries; attempt++) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 5e3);
+    try {
+      const response = await fetch(endpoint, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(payload),
+        signal: controller.signal
+      });
+      clearTimeout(timeout);
+      if (response.ok) return;
+      if (config.debug) {
+        const text = await response.text();
+        console.error(
+          `[Telemetry] Attempt ${attempt + 1} failed: ${response.status} \u2014 ${text}`
+        );
+      }
+      if (response.status >= 400 && response.status < 500) return;
+    } catch (error) {
+      clearTimeout(timeout);
+      if (config.debug) {
+        if (error?.name === "AbortError") {
+          console.error(`[Telemetry] Attempt ${attempt + 1} timed out after 5s.`);
+        } else {
+          console.error(`[Telemetry] Attempt ${attempt + 1} error:`, error);
+        }
+      }
+    }
+    if (attempt < retries) {
+      await new Promise((r) => setTimeout(r, 200 * Math.pow(2, attempt)));
+    }
+  }
+  if (config.debug) {
+    console.error("[Telemetry] All retry attempts failed \u2014 giving up.");
+  }
+}
 async function sendToTelemetry(payload, config) {
   if (!config.apiUrl) {
     if (config.debug) {
@@ -1123,34 +1176,7 @@ async function sendToTelemetry(payload, config) {
   if (config.debug) {
     console.log(`[Telemetry] Sending payload to ${endpoint}`, payload);
   }
-  const controller = new AbortController();
-  const timeout = setTimeout(() => controller.abort(), 3e3);
-  try {
-    const response = await fetch(endpoint, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        "Authorization": `Bearer ${config.serverSecret}`
-      },
-      body: JSON.stringify(payload),
-      signal: controller.signal
-    });
-    if (!response.ok && config.debug) {
-      console.error(`[Telemetry] Failed to send payload: ${response.status} ${response.statusText}`);
-      const text = await response.text();
-      console.error(`[Telemetry] Response body:`, text);
-    }
-  } catch (error) {
-    if (config.debug) {
-      if (error?.name === "AbortError") {
-        console.error("[Telemetry] Request timed out after 3s \u2014 skipping.");
-      } else {
-        console.error("[Telemetry] Error sending payload:", error);
-      }
-    }
-  } finally {
-    clearTimeout(timeout);
-  }
+  await sendWithRetry(endpoint, payload, config);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.mjs

@@ -1068,6 +1068,59 @@ function extractAutomationHeaders(headers) {
 }
 
 // src/index.ts
+function buildHeaders(config) {
+  const headers = {
+    "Content-Type": "application/json"
+  };
+  if (config.authorizationHeader) {
+    headers["Authorization"] = config.authorizationHeader;
+  } else if (config.serverSecret) {
+    headers["Authorization"] = `Bearer ${config.serverSecret}`;
+  }
+  if (config.headers) {
+    Object.assign(headers, config.headers);
+  }
+  return headers;
+}
+async function sendWithRetry(endpoint, payload, config, retries = 2) {
+  const headers = buildHeaders(config);
+  for (let attempt = 0; attempt <= retries; attempt++) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 5e3);
+    try {
+      const response = await fetch(endpoint, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(payload),
+        signal: controller.signal
+      });
+      clearTimeout(timeout);
+      if (response.ok) return;
+      if (config.debug) {
+        const text = await response.text();
+        console.error(
+          `[Telemetry] Attempt ${attempt + 1} failed: ${response.status} \u2014 ${text}`
+        );
+      }
+      if (response.status >= 400 && response.status < 500) return;
+    } catch (error) {
+      clearTimeout(timeout);
+      if (config.debug) {
+        if (error?.name === "AbortError") {
+          console.error(`[Telemetry] Attempt ${attempt + 1} timed out after 5s.`);
+        } else {
+          console.error(`[Telemetry] Attempt ${attempt + 1} error:`, error);
+        }
+      }
+    }
+    if (attempt < retries) {
+      await new Promise((r) => setTimeout(r, 200 * Math.pow(2, attempt)));
+    }
+  }
+  if (config.debug) {
+    console.error("[Telemetry] All retry attempts failed \u2014 giving up.");
+  }
+}
 async function sendToTelemetry(payload, config) {
   if (!config.apiUrl) {
     if (config.debug) {
@@ -1079,34 +1132,7 @@ async function sendToTelemetry(payload, config) {
   if (config.debug) {
     console.log(`[Telemetry] Sending payload to ${endpoint}`, payload);
   }
-  const controller = new AbortController();
-  const timeout = setTimeout(() => controller.abort(), 3e3);
-  try {
-    const response = await fetch(endpoint, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        "Authorization": `Bearer ${config.serverSecret}`
-      },
-      body: JSON.stringify(payload),
-      signal: controller.signal
-    });
-    if (!response.ok && config.debug) {
-      console.error(`[Telemetry] Failed to send payload: ${response.status} ${response.statusText}`);
-      const text = await response.text();
-      console.error(`[Telemetry] Response body:`, text);
-    }
-  } catch (error) {
-    if (config.debug) {
-      if (error?.name === "AbortError") {
-        console.error("[Telemetry] Request timed out after 3s \u2014 skipping.");
-      } else {
-        console.error("[Telemetry] Error sending payload:", error);
-      }
-    }
-  } finally {
-    clearTimeout(timeout);
-  }
+  await sendWithRetry(endpoint, payload, config);
 }
 export {
   ACCESSIBILITY_BOTS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adwait12345/telemetry-core",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Framework-agnostic core for Telemetry SDK — bot detection and server-side tracking",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",