@telemetry-tracker/core 1.4.0 → 1.5.0

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import { SDK_VERSION } from "./version.js";
 export { SDK_VERSION };
+export { toReportableError } from "./to-reportable-error.js";
 export { scrubPiiText, scrubPiiRecord } from "./pii-scrub.js";
 export { WEB_VITAL_EVENT_NAME, installWebVitals, rateWebVital, buildWebVitalProperties, setWebVitalsCaptureEnabled, isWebVitalsCaptureEnabled, type WebVitalEventProperties, type WebVitalMetricName, type WebVitalRating, } from "./web-vitals.js";
 export declare function getAnonymousId(): string;
@@ -49,10 +50,9 @@ declare function resolveClientPiiScrub(cfg: TelemetryConfig | null): {
 /** @internal exported for tests */
 export { resolveClientPiiScrub };
 export declare function trackEvent(name: string, properties?: Record<string, unknown>): void;
-export declare function trackError(error: Error | {
-    message: string;
-    stack?: string;
-}, context?: Record<string, unknown>): void;
+export declare function trackError(error: unknown, context?: Record<string, unknown>): void;
+/** Send an error and resolve after the ingest request settles. Fatal handlers await this. */
+export declare function ingestError(error: unknown, context?: Record<string, unknown>): Promise<void>;
 export declare function screen(name: string): void;
 export declare function getUserId(): string | null;
 export declare function getConfigOrNull(): TelemetryConfig | null;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACZ,uBAAuB,EACvB,0BAA0B,EAC1B,yBAAyB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AAmBzB,wBAAgB,cAAc,IAAI,MAAM,CAkBvC;AAED,MAAM,MAAM,uBAAuB,GAC/B,OAAO,GACP;IACE,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEN,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,uBAAuB,CAAC;CACpC,CAAC;AA0HF,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAE5C;AAED,kEAAkE;AAClE,wBAAgB,UAAU,IAAI,IAAI,CAOjC;AA4CD,wBAAgB,IAAI,CAAC,CAAC,EAAE,eAAe,GAAG,IAAI,CAwB7C;AAED;;;GAGG;AACH,wBAAgB,QAAQ,IAAI,IAAI,CAS/B;AAQD,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,CASzE;AAYD,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO/F;AA6ED,iBAAS,qBAAqB,CAC5B,GAAG,EAAE,eAAe,GAAG,IAAI,GAC1B;IAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAahC;AAED,mCAAmC;AACnC,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAWjC,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,IAAI,CAsBN;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,KAAK,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAClD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAwBN;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEzC;AAED,wBAAgB,SAAS,IAAI,MAAM,GAAG,IAAI,CAEzC;AAED,wBAAgB,eAAe,IAAI,eAAe,GAAG,IAAI,CAExD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,EAAE,WAAW,EAAE,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACZ,uBAAuB,EACvB,0BAA0B,EAC1B,yBAAyB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AAyCzB,wBAAgB,cAAc,IAAI,MAAM,CAkBvC;AAED,MAAM,MAAM,uBAAuB,GAC/B,OAAO,GACP;IACE,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEN,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,uBAAuB,CAAC;CACpC,CAAC;AA0HF,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAE5C;AAED,kEAAkE;AAClE,wBAAgB,UAAU,IAAI,IAAI,CAOjC;AA4CD,wBAAgB,IAAI,CAAC,CAAC,EAAE,eAAe,GAAG,IAAI,CAwB7C;AAED;;;GAGG;AACH,wBAAgB,QAAQ,IAAI,IAAI,CAS/B;AAQD,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,CASzE;AAYD,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO/F;AA6ED,iBAAS,qBAAqB,CAC5B,GAAG,EAAE,eAAe,GAAG,IAAI,GAC1B;IAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAahC;AAED,mCAAmC;AACnC,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAWjC,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,IAAI,CAsBN;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAEN;AAED,6FAA6F;AAC7F,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC,CA+Cf;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEzC;AAED,wBAAgB,SAAS,IAAI,MAAM,GAAG,IAAI,CAEzC;AAED,wBAAgB,eAAe,IAAI,eAAe,GAAG,IAAI,CAExD"}

package/dist/index.js

@@ -2,21 +2,43 @@ import { readDeviceContext } from "./device-context.js";
 import { installWebVitals, setWebVitalsCaptureEnabled, WEB_VITAL_EVENT_NAME, } from "./web-vitals.js";
 import { scrubPiiRecord, scrubPiiText } from "./pii-scrub.js";
 import { SDK_VERSION } from "./version.js";
+import { toReportableError } from "./to-reportable-error.js";
 export { SDK_VERSION };
+export { toReportableError } from "./to-reportable-error.js";
 export { scrubPiiText, scrubPiiRecord } from "./pii-scrub.js";
 export { WEB_VITAL_EVENT_NAME, installWebVitals, rateWebVital, buildWebVitalProperties, setWebVitalsCaptureEnabled, isWebVitalsCaptureEnabled, } from "./web-vitals.js";
-const REPORTED = Symbol.for("telemetry.reported");
 const ANON_STORAGE_KEY = "tacko_telemetry_anon_id";
+/** In-flight ingest promises so a later fatal flush can await trackError(e); throw e. */
+const inFlightIngest = new WeakMap();
+/** Completed error reports — WeakSet so we never mutate frozen/sealed Error objects. */
+const reportedErrors = new WeakSet();
 let anonymousId = null;
+let fallbackIdSeq = 0;
+function bytesToUuid(bytes) {
+    bytes[6] = (bytes[6] & 0x0f) | 0x40;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    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)}`;
+}
+/** Prefer Web Crypto; fall back for Node/RN hosts without a global crypto polyfill. */
 function generateUUID() {
-    if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
-        return crypto.randomUUID();
+    const webCrypto = typeof globalThis !== "undefined" ? globalThis.crypto : undefined;
+    if (webCrypto && typeof webCrypto.randomUUID === "function") {
+        return webCrypto.randomUUID();
     }
-    return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
-        const r = (Math.random() * 16) | 0;
-        const v = c === "x" ? r : (r & 0x3) | 0x8;
-        return v.toString(16);
-    });
+    if (webCrypto && typeof webCrypto.getRandomValues === "function") {
+        const bytes = new Uint8Array(16);
+        webCrypto.getRandomValues(bytes);
+        return bytesToUuid(bytes);
+    }
+    // Constrained runtimes: unique analytics IDs without Math.random (CodeQL insecure-randomness).
+    const bytes = new Uint8Array(16);
+    let n = (Date.now() ^ (++fallbackIdSeq * 0x9e3779b9)) >>> 0;
+    for (let i = 0; i < 16; i++) {
+        n = (Math.imul(n, 1664525) + 1013904223) >>> 0;
+        bytes[i] = n & 0xff;
+    }
+    return bytesToUuid(bytes);
 }
 export function getAnonymousId() {
     if (anonymousId)
@@ -390,33 +412,53 @@ export function trackEvent(name, properties) {
     }
 }
 export function trackError(error, context) {
-    const cfg = getConfigOrNull();
-    if (!cfg)
-        return;
-    const err = error instanceof Error ? error : { message: error.message, stack: error.stack };
-    if (err && typeof err === "object" && err[REPORTED])
-        return;
-    let message = err instanceof Error ? err.message : err.message;
-    let stack = err instanceof Error ? err.stack : err.stack;
-    let scrubbedContext = context ?? undefined;
-    const scrubOpts = resolveClientPiiScrub(cfg);
-    if (scrubOpts) {
-        message = scrubPiiText(message);
-        if (stack != null)
-            stack = scrubPiiText(stack);
-        if (scrubbedContext != null) {
-            scrubbedContext = scrubPiiRecord(scrubbedContext, scrubOpts);
+    void ingestError(error, context);
+}
+/** Send an error and resolve after the ingest request settles. Fatal handlers await this. */
+export function ingestError(error, context) {
+    try {
+        const cfg = getConfigOrNull();
+        if (!cfg)
+            return Promise.resolve();
+        const err = toReportableError(error);
+        const existing = inFlightIngest.get(err);
+        if (existing)
+            return existing;
+        if (reportedErrors.has(err)) {
+            return Promise.resolve();
+        }
+        let message = err.message;
+        let stack = err.stack;
+        let scrubbedContext = context ?? undefined;
+        const scrubOpts = resolveClientPiiScrub(cfg);
+        if (scrubOpts) {
+            message = scrubPiiText(message);
+            if (stack != null)
+                stack = scrubPiiText(stack);
+            if (scrubbedContext != null) {
+                scrubbedContext = scrubPiiRecord(scrubbedContext, scrubOpts);
+            }
         }
+        // Non-mutating dedupe — safe for Object.freeze / seal / preventExtensions.
+        reportedErrors.add(err);
+        const pending = send("/ingest/error", {
+            message,
+            stack: stack ?? undefined,
+            context: scrubbedContext,
+            user_id: userId ?? undefined,
+            session_id: sessionId ?? undefined,
+        })
+            .catch(() => { })
+            .finally(() => {
+            inFlightIngest.delete(err);
+        });
+        inFlightIngest.set(err, pending);
+        return pending;
+    }
+    catch {
+        // Never let telemetry-internal failures escape into the caller's crash path.
+        return Promise.resolve();
     }
-    if (err instanceof Error)
-        err[REPORTED] = true;
-    send("/ingest/error", {
-        message,
-        stack: stack ?? undefined,
-        context: scrubbedContext,
-        user_id: userId ?? undefined,
-        session_id: sessionId ?? undefined,
-    }).catch(() => { });
 }
 export function screen(name) {
     trackEvent("$screen", { name });

package/dist/to-reportable-error.d.ts

@@ -0,0 +1,3 @@
+/** Normalize any thrown/rejected value into a reportable Error. */
+export declare function toReportableError(value: unknown): Error;
+//# sourceMappingURL=to-reportable-error.d.ts.map

package/dist/to-reportable-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-reportable-error.d.ts","sourceRoot":"","sources":["../src/to-reportable-error.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAuBvD"}

package/dist/to-reportable-error.js

@@ -0,0 +1,30 @@
+/** Normalize any thrown/rejected value into a reportable Error. */
+export function toReportableError(value) {
+    if (value instanceof Error)
+        return value;
+    if (value === null)
+        return new Error("null");
+    if (value === undefined)
+        return new Error("undefined");
+    if (typeof value === "string")
+        return new Error(value);
+    if (typeof value === "number" ||
+        typeof value === "boolean" ||
+        typeof value === "bigint") {
+        return new Error(String(value));
+    }
+    if (typeof value === "symbol")
+        return new Error(value.toString());
+    if (typeof value === "object") {
+        try {
+            const json = JSON.stringify(value);
+            if (typeof json === "string")
+                return new Error(json);
+        }
+        catch {
+            // circular / non-serializable
+        }
+        return new Error(Object.prototype.toString.call(value));
+    }
+    return new Error(String(value));
+}

package/dist/version.d.ts

@@ -1,3 +1,3 @@
 /** Injected at build time from package.json. Do not edit manually. */
-export declare const SDK_VERSION = "1.4.0";
+export declare const SDK_VERSION = "1.5.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,2 +1,2 @@
 /** Injected at build time from package.json. Do not edit manually. */
-export const SDK_VERSION = "1.4.0";
+export const SDK_VERSION = "1.5.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telemetry-tracker/core",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "Lightweight telemetry client: events, errors, sessions. Framework-agnostic core.",
   "license": "MIT",
   "repository": {
@@ -34,6 +34,7 @@
   "dependencies": {
     "web-vitals": "^4.2.4"
   },
+  "gitHead": "886d9f8e0b92a78471f27b87365fc40ba7043ce1",
   "scripts": {
     "build": "node scripts/inject-version.cjs && rm -rf dist && tsc",
     "dev": "tsc --watch",