@tell-rs/browser 0.2.5 → 0.2.8

package/README.md

@@ -23,7 +23,7 @@ bun add @tell-rs/browser
 ```ts
 import tell from "@tell-rs/browser";
 
-tell.configure("your-api-key");
+tell.configure("feed1e11feed1e11feed1e11feed1e11");
 
 // Track an event
 tell.track("Button Clicked", { button: "signup" });
@@ -44,8 +44,9 @@ Events called before `configure()` are automatically queued and replayed.
 Initialize the SDK. Call once on page load.
 
 ```ts
-tell.configure("your-api-key", {
+tell.configure("feed1e11feed1e11feed1e11feed1e11", {
   // All options below are optional:
+  service: "landing-page",                // stamped on every event and log (defaults to window.location.hostname)
   endpoint: "https://collect.tell.app",  // default
   batchSize: 20,                          // events per batch
   flushInterval: 5_000,                   // ms between auto-flushes
@@ -122,8 +123,8 @@ await tell.close()     // flush + shut down
 ```ts
 import tell, { development, production } from "@tell-rs/browser";
 
-tell.configure("your-api-key", development());  // localhost, debug logging
-tell.configure("your-api-key", production());   // defaults, error-only logging
+tell.configure("feed1e11feed1e11feed1e11feed1e11", development());  // localhost, debug logging
+tell.configure("feed1e11feed1e11feed1e11feed1e11", production());   // defaults, error-only logging
 ```
 
 ## Features
@@ -144,7 +145,7 @@ The browser SDK automatically collects anonymous device context (browser, OS, sc
 ```ts
 import tell, { redact, redactLog, SENSITIVE_PARAMS } from "@tell-rs/browser";
 
-tell.configure("your-api-key", {
+tell.configure("feed1e11feed1e11feed1e11feed1e11", {
   beforeSend: redact({
     dropRoutes: ["/internal", "/health"],
     stripParams: [...SENSITIVE_PARAMS, "session_id"],

package/dist/index.cjs

@@ -435,18 +435,13 @@ function generateId() {
   if (typeof crypto !== "undefined" && crypto.getRandomValues) {
     const bytes = new Uint8Array(16);
     crypto.getRandomValues(bytes);
-    bytes[6] = bytes[6] & 15 | 64;
-    bytes[8] = bytes[8] & 63 | 128;
-    const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join(
-      ""
-    );
-    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+    return Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+  }
+  let hex = "";
+  for (let i = 0; i < 32; i++) {
+    hex += (Math.random() * 16 | 0).toString(16);
   }
-  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
-    const r = Math.random() * 16 | 0;
-    const v = c === "x" ? r : r & 3 | 8;
-    return v.toString(16);
-  });
+  return hex;
 }
 
 // src/bot.ts
@@ -479,13 +474,19 @@ function captureContext() {
     }
     ctx.device_type = inferDeviceType(parsed.os, ua, ctx.touch);
     const conn = navigator.connection;
-    if (conn?.effectiveType) {
-      ctx.connection_type = conn.effectiveType;
+    if (conn) {
+      if (conn.effectiveType) ctx.connection_type = conn.effectiveType;
+      if (typeof conn.downlink === "number") ctx.downlink = conn.downlink;
+      if (typeof conn.rtt === "number") ctx.rtt = conn.rtt;
+      if (conn.saveData) ctx.save_data = true;
     }
+    if (navigator.webdriver) ctx.bot = true;
   }
   if (typeof screen !== "undefined") {
     ctx.screen_width = screen.width;
     ctx.screen_height = screen.height;
+    const orient = screen.orientation;
+    if (orient?.type) ctx.screen_orientation = orient.type;
   }
   if (typeof window !== "undefined") {
     ctx.viewport_width = window.innerWidth;
@@ -506,11 +507,18 @@ function captureContext() {
   }
   if (typeof location !== "undefined") {
     ctx.url = location.href;
+    if (location.pathname) ctx.path = location.pathname;
   }
   try {
     ctx.timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
   } catch {
   }
+  if (typeof window !== "undefined" && window.matchMedia) {
+    try {
+      ctx.dark_mode = window.matchMedia("(prefers-color-scheme: dark)").matches;
+    } catch {
+    }
+  }
   return ctx;
 }
 function inferDeviceType(os, ua, touch) {
@@ -584,7 +592,6 @@ var SessionManager = class {
   timeout;
   onNewSession;
   visibilityHandler;
-  checkTimer;
   lastContextAt = {};
   constructor(config) {
     this.timeout = config.timeout;
@@ -596,10 +603,6 @@ var SessionManager = class {
     if (typeof document !== "undefined") {
       document.addEventListener("visibilitychange", this.visibilityHandler);
     }
-    this.checkTimer = setInterval(() => this.checkTimeout(), 6e4);
-    if (typeof this.checkTimer.unref === "function") {
-      this.checkTimer.unref();
-    }
   }
   get sessionId() {
     return this._sessionId;
@@ -607,14 +610,18 @@ var SessionManager = class {
   set sessionId(id) {
     this._sessionId = id;
   }
+  /** Update activity timestamp; rotates session if idle longer than timeout. */
   touch() {
-    this.lastActivityAt = Date.now();
+    const now = Date.now();
+    if (now - this.lastActivityAt > this.timeout) {
+      this.rotateSession("session_timeout");
+    }
+    this.lastActivityAt = now;
   }
   destroy() {
     if (typeof document !== "undefined") {
       document.removeEventListener("visibilitychange", this.visibilityHandler);
     }
-    clearInterval(this.checkTimer);
   }
   handleVisibility() {
     if (document.visibilityState === "hidden") {
@@ -628,11 +635,6 @@ var SessionManager = class {
       this.lastHiddenAt = 0;
     }
   }
-  checkTimeout() {
-    if (Date.now() - this.lastActivityAt > this.timeout) {
-      this.rotateSession("session_timeout");
-    }
-  }
   rotateSession(reason) {
     this._sessionId = generateId();
     this.lastActivityAt = Date.now();
@@ -836,6 +838,7 @@ var logBatcher;
 var sessionManager;
 var resolvedConfig;
 var _apiKey;
+var resolvedService;
 var deviceId;
 var userId;
 var superProperties = {};
@@ -878,6 +881,7 @@ function onNewSession(reason, sessionId) {
   const ctx = captureContext();
   const event = {
     type: "context",
+    service: resolvedService,
     device_id: deviceId,
     session_id: sessionId,
     user_id: userId,
@@ -912,6 +916,7 @@ var tell = {
     validateApiKey(apiKey);
     _apiKey = apiKey;
     resolvedConfig = resolveConfig(options);
+    resolvedService = options?.service ?? (typeof window !== "undefined" ? window.location?.hostname : void 0) ?? "browser";
     sdkLogLevel = LOG_LEVELS[resolvedConfig.logLevel] ?? 0;
     beforeSend = resolvedConfig.beforeSend;
     beforeSendLog = resolvedConfig.beforeSendLog;
@@ -1021,9 +1026,11 @@ var tell = {
       reportError(err);
       return;
     }
+    sessionManager.touch();
     let event = {
       type: "track",
       event: eventName,
+      service: resolvedService,
       device_id: deviceId,
       session_id: sessionManager.sessionId,
       user_id: userId,
@@ -1035,7 +1042,6 @@ var tell = {
       event = runBeforeSend(event, beforeSend);
       if (event === null) return;
     }
-    sessionManager.touch();
     eventBatcher.add(event);
   },
   identify(newUserId, traits) {
@@ -1056,8 +1062,10 @@ var tell = {
     }
     userId = newUserId;
     storage.set(STORAGE_KEYS.USER_ID, userId);
+    sessionManager.touch();
     let event = {
       type: "identify",
+      service: resolvedService,
       device_id: deviceId,
       session_id: sessionManager.sessionId,
       user_id: userId,
@@ -1068,7 +1076,6 @@ var tell = {
       event = runBeforeSend(event, beforeSend);
       if (event === null) return;
     }
-    sessionManager.touch();
     eventBatcher.add(event);
   },
   group(groupId, properties) {
@@ -1087,8 +1094,10 @@ var tell = {
       reportError(err);
       return;
     }
+    sessionManager.touch();
     let event = {
       type: "group",
+      service: resolvedService,
       device_id: deviceId,
       session_id: sessionManager.sessionId,
       user_id: userId,
@@ -1101,7 +1110,6 @@ var tell = {
       event = runBeforeSend(event, beforeSend);
       if (event === null) return;
     }
-    sessionManager.touch();
     eventBatcher.add(event);
   },
   revenue(amount, currency, orderId, properties) {
@@ -1122,9 +1130,11 @@ var tell = {
       reportError(err);
       return;
     }
+    sessionManager.touch();
     let event = {
       type: "track",
       event: "Order Completed",
+      service: resolvedService,
       device_id: deviceId,
       session_id: sessionManager.sessionId,
       user_id: userId,
@@ -1139,7 +1149,6 @@ var tell = {
       event = runBeforeSend(event, beforeSend);
       if (event === null) return;
     }
-    sessionManager.touch();
     eventBatcher.add(event);
   },
   alias(previousId, newUserId) {
@@ -1160,8 +1169,10 @@ var tell = {
       reportError(err);
       return;
     }
+    sessionManager.touch();
     let event = {
       type: "alias",
+      service: resolvedService,
       device_id: deviceId,
       session_id: sessionManager.sessionId,
       user_id: newUserId,
@@ -1172,7 +1183,6 @@ var tell = {
       event = runBeforeSend(event, beforeSend);
       if (event === null) return;
     }
-    sessionManager.touch();
     eventBatcher.add(event);
   },
   // -----------------------------------------------------------------------
@@ -1198,7 +1208,7 @@ var tell = {
       level,
       message,
       source: resolvedConfig.source,
-      service: service ?? "app",
+      service: service ?? resolvedService,
       session_id: sessionManager.sessionId,
       timestamp: Date.now(),
       data