@tracelog/lib 2.2.0 → 2.2.1-rc.82.7

package/dist/public-api.d.mts

@@ -62,6 +62,21 @@ type MetadataNestedObject = Record<string, MetadataNestedValue>;
  * ```
  */
 type MetadataType = MetadataPrimitive | string[] | MetadataNestedObject | MetadataNestedObject[];
+/**
+ * Result returned by tracelog.init()
+ *
+ * Contains the session identifier generated during initialization.
+ * The sessionId is empty string in edge cases (SSR, disabled, race condition).
+ *
+ * @example
+ * ```typescript
+ * const { sessionId } = await tracelog.init();
+ * console.log('Session started:', sessionId);
+ * ```
+ */
+interface InitResult {
+    sessionId: string;
+}
 
 /**
  * Element configuration for viewport tracking with optional identifiers
@@ -2287,7 +2302,7 @@ type CustomHeadersProvider = () => Record<string, string>;
  */
 interface TraceLogTestBridge {
     readonly initialized: boolean;
-    init(config?: Config): Promise<void>;
+    init(config?: Config): Promise<InitResult>;
     destroy(force?: boolean): void;
     sendCustomEvent(name: string, data?: Record<string, unknown> | Record<string, unknown>[]): void;
     event(name: string, metadata?: Record<string, unknown> | Record<string, unknown>[]): void;
@@ -2425,7 +2440,6 @@ declare const MAX_CUSTOM_EVENT_STRING_SIZE: number;
 declare const MAX_CUSTOM_EVENT_KEYS = 10;
 declare const MAX_CUSTOM_EVENT_ARRAY_SIZE = 10;
 declare const MAX_NESTED_OBJECT_KEYS = 20;
-declare const MAX_METADATA_NESTING_DEPTH = 1;
 declare const MAX_STRING_LENGTH = 1000;
 declare const MAX_STRING_LENGTH_IN_ARRAY = 500;
 declare const MAX_ARRAY_LENGTH = 100;
@@ -2475,7 +2489,7 @@ declare const DEFAULT_WEB_VITALS_MODE: WebVitalsMode;
 declare const getWebVitalsThresholds: (mode?: WebVitalsMode) => Record<WebVitalType, number>;
 
 declare const tracelog: {
-    init: (config?: Config) => Promise<void>;
+    init: (config?: Config) => Promise<InitResult>;
     event: (name: string, metadata?: Record<string, MetadataType> | Record<string, MetadataType>[]) => void;
     on: <K extends keyof EmitterMap>(event: K, callback: EmitterCallback<EmitterMap[K]>) => void;
     off: <K extends keyof EmitterMap>(event: K, callback: EmitterCallback<EmitterMap[K]>) => void;
@@ -2484,10 +2498,11 @@ declare const tracelog: {
     setCustomHeaders: (provider: CustomHeadersProvider) => void;
     removeCustomHeaders: () => void;
     isInitialized: () => boolean;
+    getSessionId: () => string | null;
     destroy: () => void;
     setQaMode: (enabled: boolean) => void;
     updateGlobalMetadata: (metadata: Record<string, MetadataType>) => void;
     mergeGlobalMetadata: (metadata: Record<string, MetadataType>) => void;
 };
 
-export { AppConfigValidationError, type BeforeBatchTransformer, type BeforeSendTransformer, type ClickCoordinates, type ClickData, type ClickTrackingElementData, type Config, type CustomEventData, type CustomHeadersProvider, DEFAULT_SESSION_TIMEOUT, DEFAULT_WEB_VITALS_MODE, type DeviceInfo, DeviceType, type EmitterCallback, EmitterEvent, type EmitterMap, type ErrorData, ErrorType, type EventData, EventType, type EventTypeName, type EventsQueue, InitializationTimeoutError, IntegrationValidationError, MAX_ARRAY_LENGTH, MAX_CUSTOM_EVENT_ARRAY_SIZE, MAX_CUSTOM_EVENT_KEYS, MAX_CUSTOM_EVENT_NAME_LENGTH, MAX_CUSTOM_EVENT_STRING_SIZE, MAX_METADATA_NESTING_DEPTH, MAX_NESTED_OBJECT_KEYS, MAX_STRING_LENGTH, MAX_STRING_LENGTH_IN_ARRAY, type MetadataType, Mode, PII_PATTERNS, type PageViewData, PermanentError, type PersistedEventsQueue, type PrimaryScrollEvent, SamplingRateValidationError, type ScrollData, ScrollDirection, type SecondaryScrollEvent, type SessionEventCounts, SessionTimeoutValidationError, SpecialApiUrl, type State, type TraceLogTestBridge, TraceLogValidationError, type TransformerHook, type TransformerMap, type UTM, type ViewportConfig, type ViewportElement, type ViewportEventData, WEB_VITALS_GOOD_THRESHOLDS, WEB_VITALS_NEEDS_IMPROVEMENT_THRESHOLDS, WEB_VITALS_POOR_THRESHOLDS, type WebVitalType, type WebVitalsData, type WebVitalsMode, getWebVitalsThresholds, isPrimaryScrollEvent, isSecondaryScrollEvent, tracelog };
+export { AppConfigValidationError, type BeforeBatchTransformer, type BeforeSendTransformer, type ClickCoordinates, type ClickData, type ClickTrackingElementData, type Config, type CustomEventData, type CustomHeadersProvider, DEFAULT_SESSION_TIMEOUT, DEFAULT_WEB_VITALS_MODE, type DeviceInfo, DeviceType, type EmitterCallback, EmitterEvent, type EmitterMap, type ErrorData, ErrorType, type EventData, EventType, type EventTypeName, type EventsQueue, type InitResult, InitializationTimeoutError, IntegrationValidationError, MAX_ARRAY_LENGTH, MAX_CUSTOM_EVENT_ARRAY_SIZE, MAX_CUSTOM_EVENT_KEYS, MAX_CUSTOM_EVENT_NAME_LENGTH, MAX_CUSTOM_EVENT_STRING_SIZE, MAX_NESTED_OBJECT_KEYS, MAX_STRING_LENGTH, MAX_STRING_LENGTH_IN_ARRAY, type MetadataType, Mode, PII_PATTERNS, type PageViewData, PermanentError, type PersistedEventsQueue, type PrimaryScrollEvent, SamplingRateValidationError, type ScrollData, ScrollDirection, type SecondaryScrollEvent, type SessionEventCounts, SessionTimeoutValidationError, SpecialApiUrl, type State, type TraceLogTestBridge, TraceLogValidationError, type TransformerHook, type TransformerMap, type UTM, type ViewportConfig, type ViewportElement, type ViewportEventData, WEB_VITALS_GOOD_THRESHOLDS, WEB_VITALS_NEEDS_IMPROVEMENT_THRESHOLDS, WEB_VITALS_POOR_THRESHOLDS, type WebVitalType, type WebVitalsData, type WebVitalsMode, getWebVitalsThresholds, isPrimaryScrollEvent, isSecondaryScrollEvent, tracelog };

package/dist/public-api.d.ts

@@ -62,6 +62,21 @@ type MetadataNestedObject = Record<string, MetadataNestedValue>;
  * ```
  */
 type MetadataType = MetadataPrimitive | string[] | MetadataNestedObject | MetadataNestedObject[];
+/**
+ * Result returned by tracelog.init()
+ *
+ * Contains the session identifier generated during initialization.
+ * The sessionId is empty string in edge cases (SSR, disabled, race condition).
+ *
+ * @example
+ * ```typescript
+ * const { sessionId } = await tracelog.init();
+ * console.log('Session started:', sessionId);
+ * ```
+ */
+interface InitResult {
+    sessionId: string;
+}
 
 /**
  * Element configuration for viewport tracking with optional identifiers
@@ -2287,7 +2302,7 @@ type CustomHeadersProvider = () => Record<string, string>;
  */
 interface TraceLogTestBridge {
     readonly initialized: boolean;
-    init(config?: Config): Promise<void>;
+    init(config?: Config): Promise<InitResult>;
     destroy(force?: boolean): void;
     sendCustomEvent(name: string, data?: Record<string, unknown> | Record<string, unknown>[]): void;
     event(name: string, metadata?: Record<string, unknown> | Record<string, unknown>[]): void;
@@ -2425,7 +2440,6 @@ declare const MAX_CUSTOM_EVENT_STRING_SIZE: number;
 declare const MAX_CUSTOM_EVENT_KEYS = 10;
 declare const MAX_CUSTOM_EVENT_ARRAY_SIZE = 10;
 declare const MAX_NESTED_OBJECT_KEYS = 20;
-declare const MAX_METADATA_NESTING_DEPTH = 1;
 declare const MAX_STRING_LENGTH = 1000;
 declare const MAX_STRING_LENGTH_IN_ARRAY = 500;
 declare const MAX_ARRAY_LENGTH = 100;
@@ -2475,7 +2489,7 @@ declare const DEFAULT_WEB_VITALS_MODE: WebVitalsMode;
 declare const getWebVitalsThresholds: (mode?: WebVitalsMode) => Record<WebVitalType, number>;
 
 declare const tracelog: {
-    init: (config?: Config) => Promise<void>;
+    init: (config?: Config) => Promise<InitResult>;
     event: (name: string, metadata?: Record<string, MetadataType> | Record<string, MetadataType>[]) => void;
     on: <K extends keyof EmitterMap>(event: K, callback: EmitterCallback<EmitterMap[K]>) => void;
     off: <K extends keyof EmitterMap>(event: K, callback: EmitterCallback<EmitterMap[K]>) => void;
@@ -2484,10 +2498,11 @@ declare const tracelog: {
     setCustomHeaders: (provider: CustomHeadersProvider) => void;
     removeCustomHeaders: () => void;
     isInitialized: () => boolean;
+    getSessionId: () => string | null;
     destroy: () => void;
     setQaMode: (enabled: boolean) => void;
     updateGlobalMetadata: (metadata: Record<string, MetadataType>) => void;
     mergeGlobalMetadata: (metadata: Record<string, MetadataType>) => void;
 };
 
-export { AppConfigValidationError, type BeforeBatchTransformer, type BeforeSendTransformer, type ClickCoordinates, type ClickData, type ClickTrackingElementData, type Config, type CustomEventData, type CustomHeadersProvider, DEFAULT_SESSION_TIMEOUT, DEFAULT_WEB_VITALS_MODE, type DeviceInfo, DeviceType, type EmitterCallback, EmitterEvent, type EmitterMap, type ErrorData, ErrorType, type EventData, EventType, type EventTypeName, type EventsQueue, InitializationTimeoutError, IntegrationValidationError, MAX_ARRAY_LENGTH, MAX_CUSTOM_EVENT_ARRAY_SIZE, MAX_CUSTOM_EVENT_KEYS, MAX_CUSTOM_EVENT_NAME_LENGTH, MAX_CUSTOM_EVENT_STRING_SIZE, MAX_METADATA_NESTING_DEPTH, MAX_NESTED_OBJECT_KEYS, MAX_STRING_LENGTH, MAX_STRING_LENGTH_IN_ARRAY, type MetadataType, Mode, PII_PATTERNS, type PageViewData, PermanentError, type PersistedEventsQueue, type PrimaryScrollEvent, SamplingRateValidationError, type ScrollData, ScrollDirection, type SecondaryScrollEvent, type SessionEventCounts, SessionTimeoutValidationError, SpecialApiUrl, type State, type TraceLogTestBridge, TraceLogValidationError, type TransformerHook, type TransformerMap, type UTM, type ViewportConfig, type ViewportElement, type ViewportEventData, WEB_VITALS_GOOD_THRESHOLDS, WEB_VITALS_NEEDS_IMPROVEMENT_THRESHOLDS, WEB_VITALS_POOR_THRESHOLDS, type WebVitalType, type WebVitalsData, type WebVitalsMode, getWebVitalsThresholds, isPrimaryScrollEvent, isSecondaryScrollEvent, tracelog };
+export { AppConfigValidationError, type BeforeBatchTransformer, type BeforeSendTransformer, type ClickCoordinates, type ClickData, type ClickTrackingElementData, type Config, type CustomEventData, type CustomHeadersProvider, DEFAULT_SESSION_TIMEOUT, DEFAULT_WEB_VITALS_MODE, type DeviceInfo, DeviceType, type EmitterCallback, EmitterEvent, type EmitterMap, type ErrorData, ErrorType, type EventData, EventType, type EventTypeName, type EventsQueue, type InitResult, InitializationTimeoutError, IntegrationValidationError, MAX_ARRAY_LENGTH, MAX_CUSTOM_EVENT_ARRAY_SIZE, MAX_CUSTOM_EVENT_KEYS, MAX_CUSTOM_EVENT_NAME_LENGTH, MAX_CUSTOM_EVENT_STRING_SIZE, MAX_NESTED_OBJECT_KEYS, MAX_STRING_LENGTH, MAX_STRING_LENGTH_IN_ARRAY, type MetadataType, Mode, PII_PATTERNS, type PageViewData, PermanentError, type PersistedEventsQueue, type PrimaryScrollEvent, SamplingRateValidationError, type ScrollData, ScrollDirection, type SecondaryScrollEvent, type SessionEventCounts, SessionTimeoutValidationError, SpecialApiUrl, type State, type TraceLogTestBridge, TraceLogValidationError, type TransformerHook, type TransformerMap, type UTM, type ViewportConfig, type ViewportElement, type ViewportEventData, WEB_VITALS_GOOD_THRESHOLDS, WEB_VITALS_NEEDS_IMPROVEMENT_THRESHOLDS, WEB_VITALS_POOR_THRESHOLDS, type WebVitalType, type WebVitalsData, type WebVitalsMode, getWebVitalsThresholds, isPrimaryScrollEvent, isSecondaryScrollEvent, tracelog };

package/dist/public-api.js

@@ -39,12 +39,11 @@ var MAX_CUSTOM_EVENT_STRING_SIZE = 8 * 1024;
 var MAX_CUSTOM_EVENT_KEYS = 10;
 var MAX_CUSTOM_EVENT_ARRAY_SIZE = 10;
 var MAX_NESTED_OBJECT_KEYS = 20;
-var MAX_METADATA_NESTING_DEPTH = 1;
 var MAX_TEXT_LENGTH = 255;
 var MAX_STRING_LENGTH = 1e3;
 var MAX_STRING_LENGTH_IN_ARRAY = 500;
 var MAX_ARRAY_LENGTH = 100;
-var MAX_OBJECT_DEPTH = 3;
+var MAX_OBJECT_DEPTH = 10;
 var PRECISION_TWO_DECIMALS = 2;
 var MAX_BEACON_PAYLOAD_SIZE = 64 * 1024;
 var MAX_FINGERPRINTS = 1500;
@@ -556,7 +555,7 @@ var LONG_TASK_THROTTLE_MS = 1e3;
 var MAX_NAVIGATION_HISTORY = 50;
 
 // package.json
-var version = "2.1.2";
+var version = "2.2.1";
 
 // src/constants/version.constants.ts
 var LIB_VERSION = version;
@@ -847,14 +846,10 @@ var sanitizeString = (value) => {
       }
     });
   }
-  sanitized = sanitized.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#x27;").replaceAll("/", "&#x2F;");
   const result = sanitized.trim();
   return result;
 };
 var sanitizeValue = (value, depth = 0) => {
-  if (depth > MAX_OBJECT_DEPTH) {
-    return null;
-  }
   if (value === null || value === void 0) {
     return null;
   }
@@ -870,6 +865,9 @@ var sanitizeValue = (value, depth = 0) => {
   if (typeof value === "boolean") {
     return value;
   }
+  if (depth > MAX_OBJECT_DEPTH) {
+    return null;
+  }
   if (Array.isArray(value)) {
     const limitedArray = value.slice(0, MAX_ARRAY_LENGTH);
     const sanitizedArray = limitedArray.map((item) => sanitizeValue(item, depth + 1)).filter((item) => item !== null);
@@ -1128,69 +1126,34 @@ var validateAndNormalizeConfig = (config) => {
 };
 
 // src/utils/validations/type-guards.utils.ts
-var isValidArrayItem = (item) => {
-  if (typeof item === "string") {
+var isSerializable = (value, seen = /* @__PURE__ */ new Set()) => {
+  if (value === null || value === void 0) {
     return true;
   }
-  if (typeof item === "object" && item !== null && !Array.isArray(item)) {
-    const entries = Object.entries(item);
-    if (entries.length > MAX_NESTED_OBJECT_KEYS) {
-      return false;
-    }
-    for (const [, value] of entries) {
-      if (value === null || value === void 0) {
-        continue;
-      }
-      const type = typeof value;
-      if (type !== "string" && type !== "number" && type !== "boolean") {
-        return false;
-      }
-    }
+  const type = typeof value;
+  if (type === "string" || type === "number" || type === "boolean") {
     return true;
   }
-  return false;
-};
-var isOnlyPrimitiveFields = (object, depth = 0) => {
-  if (typeof object !== "object" || object === null) {
+  if (type === "function" || type === "symbol" || type === "bigint") {
     return false;
   }
-  if (depth > MAX_METADATA_NESTING_DEPTH) {
+  if (seen.has(value)) {
     return false;
   }
-  for (const value of Object.values(object)) {
-    if (value === null || value === void 0) {
-      continue;
-    }
-    const type = typeof value;
-    if (type === "string" || type === "number" || type === "boolean") {
-      continue;
-    }
-    if (Array.isArray(value)) {
-      if (value.length === 0) {
-        continue;
-      }
-      const firstItem = value[0];
-      const isStringArray = typeof firstItem === "string";
-      if (isStringArray) {
-        if (!value.every((item) => typeof item === "string")) {
-          return false;
-        }
-      } else {
-        if (!value.every((item) => isValidArrayItem(item))) {
-          return false;
-        }
-      }
-      continue;
-    }
-    if (type === "object" && depth === 0) {
-      if (!isOnlyPrimitiveFields(value, depth + 1)) {
-        return false;
-      }
-      continue;
-    }
+  seen.add(value);
+  if (Array.isArray(value)) {
+    return value.every((item) => isSerializable(item, seen));
+  }
+  if (type === "object") {
+    return Object.values(value).every((v) => isSerializable(v, seen));
+  }
+  return false;
+};
+var isOnlyPrimitiveFields = (object) => {
+  if (typeof object !== "object" || object === null) {
     return false;
   }
-  return true;
+  return isSerializable(object);
 };
 
 // src/utils/validations/metadata-validations.utils.ts
@@ -6156,7 +6119,7 @@ var App = class extends StateManager {
    */
   async init(config = {}) {
     if (this.isInitialized) {
-      return;
+      return { sessionId: this.get("sessionId") ?? "" };
     }
     this.managers.storage = new StorageManager();
     try {
@@ -6174,6 +6137,7 @@ var App = class extends StateManager {
         log("warn", "Failed to recover persisted events", { error });
       });
       this.isInitialized = true;
+      return { sessionId: this.get("sessionId") ?? "" };
     } catch (error) {
       this.destroy(true);
       const errorMessage = error instanceof Error ? error.message : String(error);
@@ -6333,6 +6297,15 @@ var App = class extends StateManager {
   getEventManager() {
     return this.managers.event;
   }
+  /**
+   * Returns the current session ID.
+   *
+   * @returns The session ID string, or null if not yet initialized
+   * @internal Used by api.getSessionId()
+   */
+  getSessionId() {
+    return this.get("sessionId");
+  }
   /**
    * Validates metadata object structure and values.
    *
@@ -6445,17 +6418,17 @@ var isInitializing = false;
 var isDestroying = false;
 var init = async (config) => {
   if (typeof window === "undefined" || typeof document === "undefined") {
-    return;
+    return { sessionId: "" };
   }
   isDestroying = false;
   if (window.__traceLogDisabled === true) {
-    return;
+    return { sessionId: "" };
   }
   if (app) {
-    return;
+    return { sessionId: app.getSessionId() ?? "" };
   }
   if (isInitializing) {
-    return;
+    return { sessionId: "" };
   }
   isInitializing = true;
   try {
@@ -6484,8 +6457,9 @@ var init = async (config) => {
           reject(new Error(`[TraceLog] Initialization timeout after ${INITIALIZATION_TIMEOUT_MS}ms`));
         }, INITIALIZATION_TIMEOUT_MS);
       });
-      await Promise.race([initPromise, timeoutPromise]);
+      const result = await Promise.race([initPromise, timeoutPromise]);
       app = instance;
+      return result;
     } catch (error) {
       try {
         instance.destroy(true);
@@ -6611,6 +6585,15 @@ var isInitialized = () => {
   }
   return app !== null;
 };
+var getSessionId = () => {
+  if (typeof window === "undefined" || typeof document === "undefined") {
+    return null;
+  }
+  if (!app) {
+    return null;
+  }
+  return app.getSessionId();
+};
 var destroy = () => {
   if (typeof window === "undefined" || typeof document === "undefined") {
     return;
@@ -6684,12 +6667,13 @@ var tracelog = {
   setCustomHeaders,
   removeCustomHeaders,
   isInitialized,
+  getSessionId,
   destroy,
   setQaMode: setQaMode2,
   updateGlobalMetadata,
   mergeGlobalMetadata
 };
 
-export { AppConfigValidationError, DEFAULT_SESSION_TIMEOUT, DEFAULT_WEB_VITALS_MODE, DeviceType, EmitterEvent, ErrorType, EventType, InitializationTimeoutError, IntegrationValidationError, MAX_ARRAY_LENGTH, MAX_CUSTOM_EVENT_ARRAY_SIZE, MAX_CUSTOM_EVENT_KEYS, MAX_CUSTOM_EVENT_NAME_LENGTH, MAX_CUSTOM_EVENT_STRING_SIZE, MAX_METADATA_NESTING_DEPTH, MAX_NESTED_OBJECT_KEYS, MAX_STRING_LENGTH, MAX_STRING_LENGTH_IN_ARRAY, Mode, PII_PATTERNS, PermanentError, SamplingRateValidationError, ScrollDirection, SessionTimeoutValidationError, SpecialApiUrl, TraceLogValidationError, WEB_VITALS_GOOD_THRESHOLDS, WEB_VITALS_NEEDS_IMPROVEMENT_THRESHOLDS, WEB_VITALS_POOR_THRESHOLDS, getWebVitalsThresholds, isPrimaryScrollEvent, isSecondaryScrollEvent, tracelog };
+export { AppConfigValidationError, DEFAULT_SESSION_TIMEOUT, DEFAULT_WEB_VITALS_MODE, DeviceType, EmitterEvent, ErrorType, EventType, InitializationTimeoutError, IntegrationValidationError, MAX_ARRAY_LENGTH, MAX_CUSTOM_EVENT_ARRAY_SIZE, MAX_CUSTOM_EVENT_KEYS, MAX_CUSTOM_EVENT_NAME_LENGTH, MAX_CUSTOM_EVENT_STRING_SIZE, MAX_NESTED_OBJECT_KEYS, MAX_STRING_LENGTH, MAX_STRING_LENGTH_IN_ARRAY, Mode, PII_PATTERNS, PermanentError, SamplingRateValidationError, ScrollDirection, SessionTimeoutValidationError, SpecialApiUrl, TraceLogValidationError, WEB_VITALS_GOOD_THRESHOLDS, WEB_VITALS_NEEDS_IMPROVEMENT_THRESHOLDS, WEB_VITALS_POOR_THRESHOLDS, getWebVitalsThresholds, isPrimaryScrollEvent, isSecondaryScrollEvent, tracelog };
 //# sourceMappingURL=public-api.js.map
 //# sourceMappingURL=public-api.js.map