@tracelog/lib 0.3.0 → 0.4.1

package/dist/cjs/api.d.ts

@@ -28,14 +28,14 @@ export declare const event: (name: string, metadata?: Record<string, MetadataTyp
  * @param event - Event name to listen to
  * @param callback - Function to call when event is emitted
  * @example
- * // Listen for real-time events
- * tracelog.on('realtime', (data) => {
- *   console.log('Event tracked:', data.type, data.data);
+ * // Listen for tracked events
+ * tracelog.on('event', (data) => {
+ *   console.log('Event tracked:', data.type);
  * });
  *
- * // Listen for sent events
- * tracelog.on('sent', (data) => {
- *   console.log('Events sent:', data.eventCount);
+ * // Listen for event queues being sent
+ * tracelog.on('queue', (data) => {
+ *   console.log('Events sent:', data.events.length);
  * });
  */
 export declare const on: <K extends keyof EmitterMap>(event: K, callback: EmitterCallback<EmitterMap[K]>) => void;
@@ -45,7 +45,7 @@ export declare const on: <K extends keyof EmitterMap>(event: K, callback: Emitte
  * @param callback - The same function reference that was used in on()
  * @example
  * // Remove a specific listener
- * tracelog.off('realtime', myCallback);
+ * tracelog.off('event', myCallback);
  */
 export declare const off: <K extends keyof EmitterMap>(event: K, callback: EmitterCallback<EmitterMap[K]>) => void;
 /**

package/dist/cjs/api.js

@@ -96,14 +96,14 @@ exports.event = event;
  * @param event - Event name to listen to
  * @param callback - Function to call when event is emitted
  * @example
- * // Listen for real-time events
- * tracelog.on('realtime', (data) => {
- *   console.log('Event tracked:', data.type, data.data);
+ * // Listen for tracked events
+ * tracelog.on('event', (data) => {
+ *   console.log('Event tracked:', data.type);
  * });
  *
- * // Listen for sent events
- * tracelog.on('sent', (data) => {
- *   console.log('Events sent:', data.eventCount);
+ * // Listen for event queues being sent
+ * tracelog.on('queue', (data) => {
+ *   console.log('Events sent:', data.events.length);
  * });
  */
 const on = (event, callback) => {
@@ -119,7 +119,7 @@ exports.on = on;
  * @param callback - The same function reference that was used in on()
  * @example
  * // Remove a specific listener
- * tracelog.off('realtime', myCallback);
+ * tracelog.off('event', myCallback);
  */
 const off = (event, callback) => {
     if (!app) {

package/dist/cjs/app.types.d.ts

@@ -1,2 +1,2 @@
 export { Mode, EventType, DeviceType, ScrollDirection, ErrorType, TagConditionOperator, TagLogicalOperator, TagConditionType, } from './types';
-export type { ScrollData, ClickData, CustomEventData, MetadataType, WebVitalsData, ErrorData, PageViewData, UTM, EventData, AppConfig, ApiConfig, ExtendedEventsQueueDto, TagConfig, BaseEventsQueueDto, WebVitalType, SessionEndReason, } from './types';
+export type { ScrollData, ClickData, CustomEventData, MetadataType, WebVitalsData, ErrorData, PageViewData, UTM, EventLocation, EventData, AppConfig, ApiConfig, ExtendedEventsQueueDto, TagConfig, BaseEventsQueueDto, WebVitalType, SessionEndReason, } from './types';

package/dist/cjs/handlers/scroll.handler.d.ts

@@ -10,6 +10,7 @@ export declare class ScrollHandler extends StateManager {
     constructor(eventManager: EventManager);
     startTracking(): void;
     stopTracking(): void;
+    private trySetupContainers;
     private setupScrollContainer;
     private processScrollEvent;
     private shouldEmitScrollEvent;

package/dist/cjs/handlers/scroll.handler.js

@@ -21,14 +21,11 @@ class ScrollHandler extends state_manager_1.StateManager {
         this.set('scrollEventCount', 0);
         const raw = this.get('config').scrollContainerSelectors;
         const selectors = Array.isArray(raw) ? raw : typeof raw === 'string' ? [raw] : [];
-        const elements = selectors
-            .map((sel) => this.safeQuerySelector(sel))
-            .filter((element) => element instanceof HTMLElement);
-        if (elements.length === 0) {
-            elements.push(window);
+        if (selectors.length === 0) {
+            this.setupScrollContainer(window);
         }
-        for (const element of elements) {
-            this.setupScrollContainer(element);
+        else {
+            this.trySetupContainers(selectors, 0);
         }
     }
     stopTracking() {
@@ -45,6 +42,27 @@ class ScrollHandler extends state_manager_1.StateManager {
         this.set('scrollEventCount', 0);
         this.limitWarningLogged = false;
     }
+    trySetupContainers(selectors, attempt) {
+        const elements = selectors
+            .map((sel) => this.safeQuerySelector(sel))
+            .filter((element) => element instanceof HTMLElement);
+        if (elements.length > 0) {
+            for (const element of elements) {
+                const isAlreadyTracking = this.containers.some((c) => c.element === element);
+                if (!isAlreadyTracking) {
+                    this.setupScrollContainer(element);
+                }
+            }
+            return;
+        }
+        if (attempt < 5) {
+            setTimeout(() => this.trySetupContainers(selectors, attempt + 1), 200);
+            return;
+        }
+        if (this.containers.length === 0) {
+            this.setupScrollContainer(window);
+        }
+    }
     setupScrollContainer(element) {
         // Skip setup for non-scrollable elements
         if (element !== window && !this.isElementScrollable(element)) {

package/dist/cjs/managers/event.manager.d.ts

@@ -30,7 +30,7 @@ export declare class EventManager extends StateManager {
     /**
      * Track user events with automatic deduplication and queueing
      */
-    track({ type, page_url, from_page_url, scroll_data, click_data, custom_event, web_vitals, error_data, session_end_reason, session_start_recovered, }: Partial<EventData>): void;
+    track({ type, page_url, from_page_url, scroll_data, click_data, custom_event, web_vitals, error_data, session_end_reason, }: Partial<EventData>): void;
     stop(): void;
     /**
      * Flush all queued events immediately (async)

package/dist/cjs/managers/event.manager.js

@@ -47,7 +47,7 @@ class EventManager extends state_manager_1.StateManager {
     /**
      * Track user events with automatic deduplication and queueing
      */
-    track({ type, page_url, from_page_url, scroll_data, click_data, custom_event, web_vitals, error_data, session_end_reason, session_start_recovered, }) {
+    track({ type, page_url, from_page_url, scroll_data, click_data, custom_event, web_vitals, error_data, session_end_reason, }) {
         if (!type) {
             utils_1.debugLog.warn('EventManager', 'Event type is required');
             return;
@@ -68,7 +68,6 @@ class EventManager extends state_manager_1.StateManager {
             web_vitals,
             error_data,
             session_end_reason,
-            session_start_recovered,
         });
         // Check URL exclusions
         if (this.isEventExcluded(payload)) {
@@ -235,7 +234,6 @@ class EventManager extends state_manager_1.StateManager {
             ...(data.web_vitals && { web_vitals: data.web_vitals }),
             ...(data.error_data && { error_data: data.error_data }),
             ...(data.session_end_reason && { session_end_reason: data.session_end_reason }),
-            ...(data.session_start_recovered && { session_start_recovered: data.session_start_recovered }),
             ...(isSessionStart && (0, utils_1.getUTMParameters)() && { utm: (0, utils_1.getUTMParameters)() }),
         };
         // Add project tags

package/dist/cjs/managers/session.manager.js

@@ -153,11 +153,12 @@ class SessionManager extends state_manager_1.StateManager {
         try {
             this.set('sessionId', sessionId);
             this.persistSession(sessionId);
-            // Track session start event
-            this.eventManager.track({
-                type: types_1.EventType.SESSION_START,
-                ...(isRecovered && { session_start_recovered: true }),
-            });
+            // Track session start event only for new sessions
+            if (!isRecovered) {
+                this.eventManager.track({
+                    type: types_1.EventType.SESSION_START,
+                });
+            }
             // Initialize components
             this.initCrossTabSync();
             this.shareSession(sessionId);
@@ -250,7 +251,7 @@ class SessionManager extends state_manager_1.StateManager {
             }
         };
         this.beforeUnloadHandler = () => {
-            this.eventManager.flushImmediatelySync();
+            this.endSession('page_unload');
         };
         // Handle tab visibility changes
         document.addEventListener('visibilitychange', this.visibilityChangeHandler);

package/dist/cjs/types/event.types.d.ts

@@ -75,6 +75,10 @@ export interface PageViewData {
     search?: string;
     hash?: string;
 }
+export interface EventLocation {
+    country: string;
+    country_code: string;
+}
 export interface VitalSample {
     type: WebVitalType;
     value: number;
@@ -90,10 +94,10 @@ export interface EventData {
     custom_event?: CustomEventData;
     web_vitals?: WebVitalsData;
     page_view?: PageViewData;
-    session_start_recovered?: boolean;
     session_end_reason?: SessionEndReason;
     error_data?: ErrorData;
     utm?: UTM;
+    location?: EventLocation;
     tags?: string[] | {
         id: string;
         key: string;

package/dist/esm/api.d.ts

@@ -28,14 +28,14 @@ export declare const event: (name: string, metadata?: Record<string, MetadataTyp
  * @param event - Event name to listen to
  * @param callback - Function to call when event is emitted
  * @example
- * // Listen for real-time events
- * tracelog.on('realtime', (data) => {
- *   console.log('Event tracked:', data.type, data.data);
+ * // Listen for tracked events
+ * tracelog.on('event', (data) => {
+ *   console.log('Event tracked:', data.type);
  * });
  *
- * // Listen for sent events
- * tracelog.on('sent', (data) => {
- *   console.log('Events sent:', data.eventCount);
+ * // Listen for event queues being sent
+ * tracelog.on('queue', (data) => {
+ *   console.log('Events sent:', data.events.length);
  * });
  */
 export declare const on: <K extends keyof EmitterMap>(event: K, callback: EmitterCallback<EmitterMap[K]>) => void;
@@ -45,7 +45,7 @@ export declare const on: <K extends keyof EmitterMap>(event: K, callback: Emitte
  * @param callback - The same function reference that was used in on()
  * @example
  * // Remove a specific listener
- * tracelog.off('realtime', myCallback);
+ * tracelog.off('event', myCallback);
  */
 export declare const off: <K extends keyof EmitterMap>(event: K, callback: EmitterCallback<EmitterMap[K]>) => void;
 /**

package/dist/esm/api.js

@@ -91,14 +91,14 @@ export const event = (name, metadata) => {
  * @param event - Event name to listen to
  * @param callback - Function to call when event is emitted
  * @example
- * // Listen for real-time events
- * tracelog.on('realtime', (data) => {
- *   console.log('Event tracked:', data.type, data.data);
+ * // Listen for tracked events
+ * tracelog.on('event', (data) => {
+ *   console.log('Event tracked:', data.type);
  * });
  *
- * // Listen for sent events
- * tracelog.on('sent', (data) => {
- *   console.log('Events sent:', data.eventCount);
+ * // Listen for event queues being sent
+ * tracelog.on('queue', (data) => {
+ *   console.log('Events sent:', data.events.length);
  * });
  */
 export const on = (event, callback) => {
@@ -113,7 +113,7 @@ export const on = (event, callback) => {
  * @param callback - The same function reference that was used in on()
  * @example
  * // Remove a specific listener
- * tracelog.off('realtime', myCallback);
+ * tracelog.off('event', myCallback);
  */
 export const off = (event, callback) => {
     if (!app) {

package/dist/esm/app.types.d.ts

@@ -1,2 +1,2 @@
 export { Mode, EventType, DeviceType, ScrollDirection, ErrorType, TagConditionOperator, TagLogicalOperator, TagConditionType, } from './types';
-export type { ScrollData, ClickData, CustomEventData, MetadataType, WebVitalsData, ErrorData, PageViewData, UTM, EventData, AppConfig, ApiConfig, ExtendedEventsQueueDto, TagConfig, BaseEventsQueueDto, WebVitalType, SessionEndReason, } from './types';
+export type { ScrollData, ClickData, CustomEventData, MetadataType, WebVitalsData, ErrorData, PageViewData, UTM, EventLocation, EventData, AppConfig, ApiConfig, ExtendedEventsQueueDto, TagConfig, BaseEventsQueueDto, WebVitalType, SessionEndReason, } from './types';

package/dist/esm/handlers/scroll.handler.d.ts

@@ -10,6 +10,7 @@ export declare class ScrollHandler extends StateManager {
     constructor(eventManager: EventManager);
     startTracking(): void;
     stopTracking(): void;
+    private trySetupContainers;
     private setupScrollContainer;
     private processScrollEvent;
     private shouldEmitScrollEvent;

package/dist/esm/handlers/scroll.handler.js

@@ -18,14 +18,11 @@ export class ScrollHandler extends StateManager {
         this.set('scrollEventCount', 0);
         const raw = this.get('config').scrollContainerSelectors;
         const selectors = Array.isArray(raw) ? raw : typeof raw === 'string' ? [raw] : [];
-        const elements = selectors
-            .map((sel) => this.safeQuerySelector(sel))
-            .filter((element) => element instanceof HTMLElement);
-        if (elements.length === 0) {
-            elements.push(window);
+        if (selectors.length === 0) {
+            this.setupScrollContainer(window);
         }
-        for (const element of elements) {
-            this.setupScrollContainer(element);
+        else {
+            this.trySetupContainers(selectors, 0);
         }
     }
     stopTracking() {
@@ -42,6 +39,27 @@ export class ScrollHandler extends StateManager {
         this.set('scrollEventCount', 0);
         this.limitWarningLogged = false;
     }
+    trySetupContainers(selectors, attempt) {
+        const elements = selectors
+            .map((sel) => this.safeQuerySelector(sel))
+            .filter((element) => element instanceof HTMLElement);
+        if (elements.length > 0) {
+            for (const element of elements) {
+                const isAlreadyTracking = this.containers.some((c) => c.element === element);
+                if (!isAlreadyTracking) {
+                    this.setupScrollContainer(element);
+                }
+            }
+            return;
+        }
+        if (attempt < 5) {
+            setTimeout(() => this.trySetupContainers(selectors, attempt + 1), 200);
+            return;
+        }
+        if (this.containers.length === 0) {
+            this.setupScrollContainer(window);
+        }
+    }
     setupScrollContainer(element) {
         // Skip setup for non-scrollable elements
         if (element !== window && !this.isElementScrollable(element)) {

package/dist/esm/managers/event.manager.d.ts

@@ -30,7 +30,7 @@ export declare class EventManager extends StateManager {
     /**
      * Track user events with automatic deduplication and queueing
      */
-    track({ type, page_url, from_page_url, scroll_data, click_data, custom_event, web_vitals, error_data, session_end_reason, session_start_recovered, }: Partial<EventData>): void;
+    track({ type, page_url, from_page_url, scroll_data, click_data, custom_event, web_vitals, error_data, session_end_reason, }: Partial<EventData>): void;
     stop(): void;
     /**
      * Flush all queued events immediately (async)

package/dist/esm/managers/event.manager.js

@@ -44,7 +44,7 @@ export class EventManager extends StateManager {
     /**
      * Track user events with automatic deduplication and queueing
      */
-    track({ type, page_url, from_page_url, scroll_data, click_data, custom_event, web_vitals, error_data, session_end_reason, session_start_recovered, }) {
+    track({ type, page_url, from_page_url, scroll_data, click_data, custom_event, web_vitals, error_data, session_end_reason, }) {
         if (!type) {
             debugLog.warn('EventManager', 'Event type is required');
             return;
@@ -65,7 +65,6 @@ export class EventManager extends StateManager {
             web_vitals,
             error_data,
             session_end_reason,
-            session_start_recovered,
         });
         // Check URL exclusions
         if (this.isEventExcluded(payload)) {
@@ -232,7 +231,6 @@ export class EventManager extends StateManager {
             ...(data.web_vitals && { web_vitals: data.web_vitals }),
             ...(data.error_data && { error_data: data.error_data }),
             ...(data.session_end_reason && { session_end_reason: data.session_end_reason }),
-            ...(data.session_start_recovered && { session_start_recovered: data.session_start_recovered }),
             ...(isSessionStart && getUTMParameters() && { utm: getUTMParameters() }),
         };
         // Add project tags

package/dist/esm/managers/session.manager.js

@@ -150,11 +150,12 @@ export class SessionManager extends StateManager {
         try {
             this.set('sessionId', sessionId);
             this.persistSession(sessionId);
-            // Track session start event
-            this.eventManager.track({
-                type: EventType.SESSION_START,
-                ...(isRecovered && { session_start_recovered: true }),
-            });
+            // Track session start event only for new sessions
+            if (!isRecovered) {
+                this.eventManager.track({
+                    type: EventType.SESSION_START,
+                });
+            }
             // Initialize components
             this.initCrossTabSync();
             this.shareSession(sessionId);
@@ -247,7 +248,7 @@ export class SessionManager extends StateManager {
             }
         };
         this.beforeUnloadHandler = () => {
-            this.eventManager.flushImmediatelySync();
+            this.endSession('page_unload');
         };
         // Handle tab visibility changes
         document.addEventListener('visibilitychange', this.visibilityChangeHandler);

package/dist/esm/types/event.types.d.ts

@@ -75,6 +75,10 @@ export interface PageViewData {
     search?: string;
     hash?: string;
 }
+export interface EventLocation {
+    country: string;
+    country_code: string;
+}
 export interface VitalSample {
     type: WebVitalType;
     value: number;
@@ -90,10 +94,10 @@ export interface EventData {
     custom_event?: CustomEventData;
     web_vitals?: WebVitalsData;
     page_view?: PageViewData;
-    session_start_recovered?: boolean;
     session_end_reason?: SessionEndReason;
     error_data?: ErrorData;
     utm?: UTM;
+    location?: EventLocation;
     tags?: string[] | {
         id: string;
         key: string;

package/package.json

@@ -2,7 +2,7 @@
   "name": "@tracelog/lib",
   "description": "JavaScript library for web analytics and real-time event tracking",
   "license": "MIT",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "main": "./dist/cjs/public-api.js",
   "module": "./dist/esm/public-api.js",
   "types": "./dist/esm/public-api.d.ts",