@tracelog/lib 0.1.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (228) hide show
  1. package/README.md +58 -24
  2. package/dist/browser/tracelog.js +1928 -3297
  3. package/dist/cjs/api.d.ts +33 -19
  4. package/dist/cjs/api.js +111 -156
  5. package/dist/cjs/app.constants.d.ts +74 -1
  6. package/dist/cjs/app.constants.js +77 -3
  7. package/dist/cjs/app.d.ts +29 -44
  8. package/dist/cjs/app.js +114 -212
  9. package/dist/cjs/app.types.d.ts +2 -7
  10. package/dist/cjs/app.types.js +10 -21
  11. package/dist/cjs/constants/api.constants.js +11 -5
  12. package/dist/cjs/constants/config.constants.d.ts +75 -0
  13. package/dist/cjs/constants/config.constants.js +178 -0
  14. package/dist/cjs/constants/error.constants.d.ts +29 -0
  15. package/dist/cjs/constants/error.constants.js +50 -0
  16. package/dist/cjs/constants/index.d.ts +3 -6
  17. package/dist/cjs/constants/index.js +3 -6
  18. package/dist/cjs/constants/performance.constants.d.ts +28 -0
  19. package/dist/cjs/constants/performance.constants.js +43 -0
  20. package/dist/cjs/handlers/click.handler.d.ts +1 -0
  21. package/dist/cjs/handlers/click.handler.js +30 -49
  22. package/dist/cjs/handlers/error.handler.d.ts +11 -6
  23. package/dist/cjs/handlers/error.handler.js +91 -51
  24. package/dist/cjs/handlers/page-view.handler.js +38 -29
  25. package/dist/cjs/handlers/performance.handler.d.ts +3 -0
  26. package/dist/cjs/handlers/performance.handler.js +76 -37
  27. package/dist/cjs/handlers/scroll.handler.d.ts +16 -10
  28. package/dist/cjs/handlers/scroll.handler.js +119 -185
  29. package/dist/cjs/handlers/session.handler.d.ts +6 -20
  30. package/dist/cjs/handlers/session.handler.js +38 -326
  31. package/dist/cjs/integrations/google-analytics.integration.d.ts +0 -1
  32. package/dist/cjs/integrations/google-analytics.integration.js +27 -98
  33. package/dist/cjs/listeners/input-listener-managers.d.ts +18 -9
  34. package/dist/cjs/listeners/input-listener-managers.js +24 -33
  35. package/dist/cjs/listeners/touch-listener-manager.d.ts +1 -3
  36. package/dist/cjs/listeners/touch-listener-manager.js +1 -23
  37. package/dist/cjs/listeners/visibility-listener-manager.d.ts +1 -4
  38. package/dist/cjs/listeners/visibility-listener-manager.js +6 -42
  39. package/dist/cjs/managers/api.manager.d.ts +13 -3
  40. package/dist/cjs/managers/api.manager.js +35 -5
  41. package/dist/cjs/managers/config.manager.d.ts +53 -3
  42. package/dist/cjs/managers/config.manager.js +131 -62
  43. package/dist/cjs/managers/event.manager.d.ts +57 -36
  44. package/dist/cjs/managers/event.manager.js +266 -417
  45. package/dist/cjs/managers/sender.manager.d.ts +40 -22
  46. package/dist/cjs/managers/sender.manager.js +200 -198
  47. package/dist/cjs/managers/session.manager.d.ts +80 -66
  48. package/dist/cjs/managers/session.manager.js +267 -522
  49. package/dist/cjs/managers/state.manager.d.ts +33 -0
  50. package/dist/cjs/managers/state.manager.js +79 -6
  51. package/dist/cjs/managers/storage.manager.d.ts +26 -2
  52. package/dist/cjs/managers/storage.manager.js +67 -34
  53. package/dist/cjs/managers/tags.manager.d.ts +31 -7
  54. package/dist/cjs/managers/tags.manager.js +123 -241
  55. package/dist/cjs/managers/user.manager.d.ts +14 -5
  56. package/dist/cjs/managers/user.manager.js +17 -9
  57. package/dist/cjs/public-api.d.ts +10 -1
  58. package/dist/cjs/public-api.js +18 -24
  59. package/dist/cjs/test-bridge.d.ts +48 -0
  60. package/dist/cjs/test-bridge.js +110 -0
  61. package/dist/cjs/types/api.types.d.ts +21 -6
  62. package/dist/cjs/types/api.types.js +21 -6
  63. package/dist/cjs/types/config.types.d.ts +22 -84
  64. package/dist/cjs/types/emitter.types.d.ts +11 -0
  65. package/dist/cjs/types/emitter.types.js +8 -0
  66. package/dist/cjs/types/event.types.d.ts +8 -11
  67. package/dist/cjs/types/index.d.ts +3 -1
  68. package/dist/cjs/types/index.js +3 -1
  69. package/dist/cjs/types/queue.types.d.ts +1 -0
  70. package/dist/cjs/types/session.types.d.ts +0 -64
  71. package/dist/cjs/types/state.types.d.ts +1 -0
  72. package/dist/cjs/types/test-bridge.types.d.ts +38 -0
  73. package/dist/cjs/types/validation-error.types.d.ts +7 -0
  74. package/dist/cjs/types/validation-error.types.js +11 -1
  75. package/dist/cjs/types/window.types.d.ts +1 -8
  76. package/dist/cjs/utils/data/uuid.utils.d.ts +1 -1
  77. package/dist/cjs/utils/data/uuid.utils.js +7 -5
  78. package/dist/cjs/utils/emitter.utils.d.ts +8 -0
  79. package/dist/cjs/utils/emitter.utils.js +33 -0
  80. package/dist/cjs/utils/index.d.ts +1 -0
  81. package/dist/cjs/utils/index.js +1 -0
  82. package/dist/cjs/utils/logging/debug-logger.utils.d.ts +10 -51
  83. package/dist/cjs/utils/logging/debug-logger.utils.js +36 -127
  84. package/dist/cjs/utils/network/fetch-with-timeout.utils.d.ts +4 -0
  85. package/dist/cjs/utils/network/fetch-with-timeout.utils.js +25 -0
  86. package/dist/cjs/utils/network/index.d.ts +1 -0
  87. package/dist/cjs/utils/network/index.js +1 -0
  88. package/dist/cjs/utils/network/url.utils.js +2 -42
  89. package/dist/cjs/utils/security/sanitize.utils.d.ts +1 -8
  90. package/dist/cjs/utils/security/sanitize.utils.js +7 -41
  91. package/dist/cjs/utils/validations/config-validations.utils.d.ts +7 -0
  92. package/dist/cjs/utils/validations/config-validations.utils.js +77 -22
  93. package/dist/esm/api.d.ts +33 -19
  94. package/dist/esm/api.js +105 -118
  95. package/dist/esm/app.constants.d.ts +74 -1
  96. package/dist/esm/app.constants.js +76 -1
  97. package/dist/esm/app.d.ts +29 -44
  98. package/dist/esm/app.js +115 -213
  99. package/dist/esm/app.types.d.ts +2 -7
  100. package/dist/esm/app.types.js +1 -7
  101. package/dist/esm/constants/api.constants.js +10 -4
  102. package/dist/esm/constants/config.constants.d.ts +75 -0
  103. package/dist/esm/constants/config.constants.js +174 -0
  104. package/dist/esm/constants/error.constants.d.ts +29 -0
  105. package/dist/esm/constants/error.constants.js +47 -0
  106. package/dist/esm/constants/index.d.ts +3 -6
  107. package/dist/esm/constants/index.js +3 -6
  108. package/dist/esm/constants/performance.constants.d.ts +28 -0
  109. package/dist/esm/constants/performance.constants.js +40 -0
  110. package/dist/esm/handlers/click.handler.d.ts +1 -0
  111. package/dist/esm/handlers/click.handler.js +30 -49
  112. package/dist/esm/handlers/error.handler.d.ts +11 -6
  113. package/dist/esm/handlers/error.handler.js +91 -51
  114. package/dist/esm/handlers/page-view.handler.js +38 -29
  115. package/dist/esm/handlers/performance.handler.d.ts +3 -0
  116. package/dist/esm/handlers/performance.handler.js +71 -32
  117. package/dist/esm/handlers/scroll.handler.d.ts +16 -10
  118. package/dist/esm/handlers/scroll.handler.js +120 -186
  119. package/dist/esm/handlers/session.handler.d.ts +6 -20
  120. package/dist/esm/handlers/session.handler.js +38 -326
  121. package/dist/esm/integrations/google-analytics.integration.d.ts +0 -1
  122. package/dist/esm/integrations/google-analytics.integration.js +27 -98
  123. package/dist/esm/listeners/input-listener-managers.d.ts +18 -9
  124. package/dist/esm/listeners/input-listener-managers.js +23 -32
  125. package/dist/esm/listeners/touch-listener-manager.d.ts +1 -3
  126. package/dist/esm/listeners/touch-listener-manager.js +1 -23
  127. package/dist/esm/listeners/visibility-listener-manager.d.ts +1 -4
  128. package/dist/esm/listeners/visibility-listener-manager.js +6 -42
  129. package/dist/esm/managers/api.manager.d.ts +13 -3
  130. package/dist/esm/managers/api.manager.js +34 -3
  131. package/dist/esm/managers/config.manager.d.ts +53 -3
  132. package/dist/esm/managers/config.manager.js +133 -64
  133. package/dist/esm/managers/event.manager.d.ts +57 -36
  134. package/dist/esm/managers/event.manager.js +268 -419
  135. package/dist/esm/managers/sender.manager.d.ts +40 -22
  136. package/dist/esm/managers/sender.manager.js +201 -199
  137. package/dist/esm/managers/session.manager.d.ts +80 -66
  138. package/dist/esm/managers/session.manager.js +269 -524
  139. package/dist/esm/managers/state.manager.d.ts +33 -0
  140. package/dist/esm/managers/state.manager.js +78 -6
  141. package/dist/esm/managers/storage.manager.d.ts +26 -2
  142. package/dist/esm/managers/storage.manager.js +66 -33
  143. package/dist/esm/managers/tags.manager.d.ts +31 -7
  144. package/dist/esm/managers/tags.manager.js +124 -242
  145. package/dist/esm/managers/user.manager.d.ts +14 -5
  146. package/dist/esm/managers/user.manager.js +17 -9
  147. package/dist/esm/public-api.d.ts +10 -1
  148. package/dist/esm/public-api.js +14 -1
  149. package/dist/esm/test-bridge.d.ts +48 -0
  150. package/dist/esm/test-bridge.js +106 -0
  151. package/dist/esm/types/api.types.d.ts +21 -6
  152. package/dist/esm/types/api.types.js +21 -6
  153. package/dist/esm/types/config.types.d.ts +22 -84
  154. package/dist/esm/types/emitter.types.d.ts +11 -0
  155. package/dist/esm/types/emitter.types.js +5 -0
  156. package/dist/esm/types/event.types.d.ts +8 -11
  157. package/dist/esm/types/index.d.ts +3 -1
  158. package/dist/esm/types/index.js +3 -1
  159. package/dist/esm/types/queue.types.d.ts +1 -0
  160. package/dist/esm/types/session.types.d.ts +0 -64
  161. package/dist/esm/types/state.types.d.ts +1 -0
  162. package/dist/esm/types/test-bridge.types.d.ts +38 -0
  163. package/dist/esm/types/validation-error.types.d.ts +7 -0
  164. package/dist/esm/types/validation-error.types.js +9 -0
  165. package/dist/esm/types/window.types.d.ts +1 -8
  166. package/dist/esm/utils/data/uuid.utils.d.ts +1 -1
  167. package/dist/esm/utils/data/uuid.utils.js +7 -5
  168. package/dist/esm/utils/emitter.utils.d.ts +8 -0
  169. package/dist/esm/utils/emitter.utils.js +29 -0
  170. package/dist/esm/utils/index.d.ts +1 -0
  171. package/dist/esm/utils/index.js +1 -0
  172. package/dist/esm/utils/logging/debug-logger.utils.d.ts +10 -51
  173. package/dist/esm/utils/logging/debug-logger.utils.js +36 -127
  174. package/dist/esm/utils/network/fetch-with-timeout.utils.d.ts +4 -0
  175. package/dist/esm/utils/network/fetch-with-timeout.utils.js +22 -0
  176. package/dist/esm/utils/network/index.d.ts +1 -0
  177. package/dist/esm/utils/network/index.js +1 -0
  178. package/dist/esm/utils/network/url.utils.js +2 -42
  179. package/dist/esm/utils/security/sanitize.utils.d.ts +1 -8
  180. package/dist/esm/utils/security/sanitize.utils.js +6 -39
  181. package/dist/esm/utils/validations/config-validations.utils.d.ts +7 -0
  182. package/dist/esm/utils/validations/config-validations.utils.js +76 -22
  183. package/package.json +23 -16
  184. package/dist/browser/web-vitals-CCnqwnC8.mjs +0 -198
  185. package/dist/cjs/constants/browser.constants.d.ts +0 -3
  186. package/dist/cjs/constants/browser.constants.js +0 -41
  187. package/dist/cjs/constants/initialization.constants.d.ts +0 -40
  188. package/dist/cjs/constants/initialization.constants.js +0 -48
  189. package/dist/cjs/constants/limits.constants.d.ts +0 -27
  190. package/dist/cjs/constants/limits.constants.js +0 -43
  191. package/dist/cjs/constants/security.constants.d.ts +0 -1
  192. package/dist/cjs/constants/security.constants.js +0 -12
  193. package/dist/cjs/constants/timing.constants.d.ts +0 -22
  194. package/dist/cjs/constants/timing.constants.js +0 -34
  195. package/dist/cjs/constants/validation.constants.d.ts +0 -13
  196. package/dist/cjs/constants/validation.constants.js +0 -31
  197. package/dist/cjs/handlers/network.handler.d.ts +0 -16
  198. package/dist/cjs/handlers/network.handler.js +0 -136
  199. package/dist/cjs/managers/cross-tab-session.manager.d.ts +0 -170
  200. package/dist/cjs/managers/cross-tab-session.manager.js +0 -730
  201. package/dist/cjs/managers/sampling.manager.d.ts +0 -8
  202. package/dist/cjs/managers/sampling.manager.js +0 -53
  203. package/dist/cjs/managers/session-recovery.manager.d.ts +0 -65
  204. package/dist/cjs/managers/session-recovery.manager.js +0 -237
  205. package/dist/cjs/types/web-vitals.types.d.ts +0 -6
  206. package/dist/esm/constants/browser.constants.d.ts +0 -3
  207. package/dist/esm/constants/browser.constants.js +0 -38
  208. package/dist/esm/constants/initialization.constants.d.ts +0 -40
  209. package/dist/esm/constants/initialization.constants.js +0 -45
  210. package/dist/esm/constants/limits.constants.d.ts +0 -27
  211. package/dist/esm/constants/limits.constants.js +0 -40
  212. package/dist/esm/constants/security.constants.d.ts +0 -1
  213. package/dist/esm/constants/security.constants.js +0 -9
  214. package/dist/esm/constants/timing.constants.d.ts +0 -22
  215. package/dist/esm/constants/timing.constants.js +0 -31
  216. package/dist/esm/constants/validation.constants.d.ts +0 -13
  217. package/dist/esm/constants/validation.constants.js +0 -28
  218. package/dist/esm/handlers/network.handler.d.ts +0 -16
  219. package/dist/esm/handlers/network.handler.js +0 -132
  220. package/dist/esm/managers/cross-tab-session.manager.d.ts +0 -170
  221. package/dist/esm/managers/cross-tab-session.manager.js +0 -726
  222. package/dist/esm/managers/sampling.manager.d.ts +0 -8
  223. package/dist/esm/managers/sampling.manager.js +0 -49
  224. package/dist/esm/managers/session-recovery.manager.d.ts +0 -65
  225. package/dist/esm/managers/session-recovery.manager.js +0 -233
  226. package/dist/esm/types/web-vitals.types.d.ts +0 -6
  227. /package/dist/cjs/types/{web-vitals.types.js → test-bridge.types.js} +0 -0
  228. /package/dist/esm/types/{web-vitals.types.js → test-bridge.types.js} +0 -0
@@ -1,357 +1,69 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.SessionHandler = void 0;
4
- const constants_1 = require("../constants");
5
- const types_1 = require("../types");
6
4
  const session_manager_1 = require("../managers/session.manager");
7
- const session_recovery_manager_1 = require("../managers/session-recovery.manager");
8
- const cross_tab_session_manager_1 = require("../managers/cross-tab-session.manager");
9
5
  const state_manager_1 = require("../managers/state.manager");
10
6
  const logging_1 = require("../utils/logging");
11
7
  class SessionHandler extends state_manager_1.StateManager {
12
- get crossTabSessionManager() {
13
- if (!this._crossTabSessionManager && !this._isInitializingCrossTab && this.shouldUseCrossTabs()) {
14
- this._isInitializingCrossTab = true;
15
- try {
16
- const projectId = this.get('config')?.id;
17
- if (projectId) {
18
- this.initializeCrossTabSessionManager(projectId);
19
- }
20
- }
21
- catch (error) {
22
- logging_1.debugLog.error('SessionHandler', 'Failed to initialize cross-tab session manager', {
23
- error: error instanceof Error ? error.message : 'Unknown error',
24
- });
25
- }
26
- finally {
27
- this._isInitializingCrossTab = false;
28
- }
29
- }
30
- return this._crossTabSessionManager;
31
- }
32
- shouldUseCrossTabs() {
33
- // Only initialize if BroadcastChannel is supported (indicates potential for multiple tabs)
34
- // and ServiceWorker is available (better cross-tab coordination)
35
- return typeof BroadcastChannel !== 'undefined' && typeof navigator !== 'undefined' && 'serviceWorker' in navigator;
36
- }
37
8
  constructor(storageManager, eventManager) {
38
9
  super();
39
10
  this.sessionManager = null;
40
- this.recoveryManager = null;
41
- this._crossTabSessionManager = null;
42
- this.heartbeatInterval = null;
43
- this._isInitializingCrossTab = false;
11
+ this.destroyed = false;
44
12
  this.eventManager = eventManager;
45
13
  this.storageManager = storageManager;
46
- this.sessionStorageKey = (0, constants_1.SESSION_STORAGE_KEY)(this.get('config')?.id);
47
- const projectId = this.get('config')?.id;
48
- if (projectId) {
49
- this.initializeSessionRecoveryManager(projectId);
50
- // CrossTabSessionManager will be initialized lazily when needed via the getter
51
- }
52
14
  }
53
- startTracking() {
54
- if (this.sessionManager) {
55
- logging_1.debugLog.debug('SessionHandler', 'Session tracking already active');
15
+ async startTracking() {
16
+ if (this.isActive()) {
56
17
  return;
57
18
  }
58
- logging_1.debugLog.debug('SessionHandler', 'Starting session tracking');
59
- this.checkOrphanedSessions();
60
- const onActivity = async () => {
61
- if (this.crossTabSessionManager) {
62
- this.crossTabSessionManager.updateSessionActivity();
63
- }
64
- if (this.get('sessionId')) {
65
- return;
66
- }
67
- try {
68
- const sessionResult = await this.createOrJoinSession();
69
- this.set('sessionId', sessionResult.sessionId);
70
- logging_1.debugLog.info('SessionHandler', '🏁 Session started', {
71
- sessionId: sessionResult.sessionId,
72
- recovered: sessionResult.recovered,
73
- crossTabActive: !!this.crossTabSessionManager,
74
- });
75
- this.trackSession(types_1.EventType.SESSION_START, sessionResult.recovered);
76
- this.persistSession(sessionResult.sessionId);
77
- this.startHeartbeat();
78
- }
79
- catch (error) {
80
- logging_1.debugLog.error('SessionHandler', `Session creation failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
81
- this.forceCleanupSession();
82
- }
83
- };
84
- const onInactivity = () => {
85
- if (!this.get('sessionId')) {
86
- return;
87
- }
88
- if (this.crossTabSessionManager && this.crossTabSessionManager.getEffectiveSessionTimeout() > 0) {
89
- if (this.get('config')?.mode === 'qa' || this.get('config')?.mode === 'debug') {
90
- logging_1.debugLog.debug('SessionHandler', 'Session kept alive by cross-tab activity');
91
- }
92
- return;
93
- }
94
- this.sessionManager.endSessionManaged('inactivity')
95
- .then((result) => {
96
- logging_1.debugLog.info('SessionHandler', '🛑 Session ended by inactivity', {
97
- sessionId: this.get('sessionId'),
98
- reason: result.reason,
99
- success: result.success,
100
- eventsFlushed: result.eventsFlushed,
101
- });
102
- if (this.crossTabSessionManager) {
103
- this.crossTabSessionManager.endSession('inactivity');
104
- }
105
- this.clearPersistedSession();
106
- this.stopHeartbeat();
107
- })
108
- .catch((error) => {
109
- logging_1.debugLog.error('SessionHandler', `Session end failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
110
- this.forceCleanupSession();
111
- });
112
- };
113
- const sessionEndConfig = {
114
- enablePageUnloadHandlers: true,
115
- debugMode: (this.get('config')?.mode === 'qa' || this.get('config')?.mode === 'debug') ?? false,
116
- syncTimeoutMs: constants_1.SESSION_SYNC_CONSTANTS.SYNC_TIMEOUT_MS,
117
- maxRetries: constants_1.SESSION_SYNC_CONSTANTS.MAX_RETRY_ATTEMPTS,
118
- };
119
- this.sessionManager = new session_manager_1.SessionManager(onActivity, onInactivity, this.eventManager, this.storageManager, sessionEndConfig);
120
- logging_1.debugLog.debug('SessionHandler', 'Session manager initialized');
121
- this.startInitialSession();
122
- }
123
- stopTracking() {
124
- logging_1.debugLog.info('SessionHandler', 'Stopping session tracking');
125
- if (this.sessionManager) {
126
- if (this.get('sessionId')) {
19
+ if (this.destroyed) {
20
+ logging_1.debugLog.warn('SessionHandler', 'Cannot start tracking on destroyed handler');
21
+ return;
22
+ }
23
+ try {
24
+ this.sessionManager = new session_manager_1.SessionManager(this.storageManager, this.eventManager);
25
+ await this.sessionManager.startTracking();
26
+ }
27
+ catch (error) {
28
+ // Cleanup on failure
29
+ if (this.sessionManager) {
127
30
  try {
128
- this.sessionManager.endSessionSafely('manual_stop', { forceSync: true });
129
- this.clearPersistedSession();
130
- this.stopHeartbeat();
31
+ this.sessionManager.destroy();
131
32
  }
132
- catch (error) {
133
- logging_1.debugLog.error('SessionHandler', `Manual session stop failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
134
- this.forceCleanupSession();
33
+ catch {
34
+ // Ignore cleanup errors
135
35
  }
36
+ this.sessionManager = null;
136
37
  }
137
- this.sessionManager.destroy();
138
- this.sessionManager = null;
139
- }
140
- if (this._crossTabSessionManager) {
141
- this._crossTabSessionManager.destroy();
142
- this._crossTabSessionManager = null;
143
- }
144
- // Reset cross-tab initialization flag
145
- this._isInitializingCrossTab = false;
146
- if (this.recoveryManager) {
147
- this.recoveryManager.cleanupOldRecoveryAttempts();
148
- this.recoveryManager = null;
38
+ logging_1.debugLog.error('SessionHandler', 'Failed to start session tracking', {
39
+ error: error instanceof Error ? error.message : 'Unknown error',
40
+ });
41
+ throw error;
149
42
  }
150
43
  }
151
- initializeSessionRecoveryManager(projectId) {
152
- this.recoveryManager = new session_recovery_manager_1.SessionRecoveryManager(this.storageManager, projectId, this.eventManager);
153
- logging_1.debugLog.debug('SessionHandler', 'Session recovery manager initialized', { projectId });
154
- }
155
- initializeCrossTabSessionManager(projectId) {
156
- const config = {
157
- debugMode: (this.get('config')?.mode === 'qa' || this.get('config')?.mode === 'debug') ?? false,
158
- };
159
- const onSessionStart = (sessionId) => {
160
- if (this.get('config')?.mode === 'qa' || this.get('config')?.mode === 'debug') {
161
- logging_1.debugLog.debug('SessionHandler', `Cross-tab session started: ${sessionId}`);
162
- }
163
- this.set('sessionId', sessionId);
164
- this.trackSession(types_1.EventType.SESSION_START, false);
165
- this.persistSession(sessionId);
166
- this.startHeartbeat();
167
- };
168
- const onSessionEnd = (reason) => {
169
- if (this.get('config')?.mode === 'qa' || this.get('config')?.mode === 'debug') {
170
- logging_1.debugLog.debug('SessionHandler', `Cross-tab session ended: ${reason}`);
171
- }
172
- this.clearPersistedSession();
173
- this.trackSession(types_1.EventType.SESSION_END, false, reason);
174
- };
175
- const onTabActivity = () => {
176
- if (this.get('config')?.mode === 'qa' || this.get('config')?.mode === 'debug') {
177
- logging_1.debugLog.debug('SessionHandler', 'Cross-tab activity detected');
178
- }
179
- };
180
- const onCrossTabConflict = () => {
181
- if (this.get('config')?.mode === 'qa' || this.get('config')?.mode === 'debug') {
182
- logging_1.debugLog.warn('SessionHandler', 'Cross-tab conflict detected');
183
- }
184
- // Track cross-tab conflict in session health
185
- if (this.sessionManager) {
186
- this.sessionManager.trackSessionHealth('conflict');
187
- }
188
- };
189
- const callbacks = {
190
- onSessionStart,
191
- onSessionEnd,
192
- onTabActivity,
193
- onCrossTabConflict,
194
- };
195
- this._crossTabSessionManager = new cross_tab_session_manager_1.CrossTabSessionManager(this.storageManager, projectId, config, callbacks);
196
- logging_1.debugLog.debug('SessionHandler', 'Cross-tab session manager initialized', { projectId });
197
- }
198
- async createOrJoinSession() {
199
- if (this.crossTabSessionManager) {
200
- const existingSessionId = this.crossTabSessionManager.getSessionId();
201
- if (existingSessionId) {
202
- return { sessionId: existingSessionId, recovered: false };
203
- }
204
- // If cross-tab manager exists but no session, create one through regular session manager
205
- // The cross-tab manager will coordinate with other tabs automatically
206
- const sessionResult = this.sessionManager.startSession();
207
- return { sessionId: sessionResult.sessionId, recovered: sessionResult.recovered ?? false };
208
- }
209
- // Fallback: create regular session when no cross-tab manager
210
- const sessionResult = this.sessionManager.startSession();
211
- return { sessionId: sessionResult.sessionId, recovered: sessionResult.recovered ?? false };
44
+ isActive() {
45
+ return this.sessionManager !== null && !this.destroyed;
212
46
  }
213
- forceCleanupSession() {
214
- // Clear session state
215
- this.set('sessionId', null);
216
- // Clear persisted session data
217
- this.clearPersistedSession();
218
- // Stop heartbeat timer
219
- this.stopHeartbeat();
220
- // Clean up cross-tab session if exists
221
- if (this.crossTabSessionManager) {
222
- try {
223
- this.crossTabSessionManager.endSession('orphaned_cleanup');
224
- }
225
- catch (error) {
226
- // Silent cleanup - we're already in error recovery
227
- if (this.get('config')?.mode === 'qa' || this.get('config')?.mode === 'debug') {
228
- logging_1.debugLog.warn('SessionHandler', `Cross-tab cleanup failed during force cleanup: ${error instanceof Error ? error.message : 'Unknown error'}`);
229
- }
230
- }
231
- }
232
- // Track session end for analytics
233
- try {
234
- this.trackSession(types_1.EventType.SESSION_END, false, 'orphaned_cleanup');
235
- }
236
- catch (error) {
237
- // Silent tracking failure - we're already in error recovery
238
- if (this.get('config')?.mode === 'qa' || this.get('config')?.mode === 'debug') {
239
- logging_1.debugLog.warn('SessionHandler', `Session tracking failed during force cleanup: ${error instanceof Error ? error.message : 'Unknown error'}`);
240
- }
241
- }
242
- if (this.get('config')?.mode === 'qa' || this.get('config')?.mode === 'debug') {
243
- logging_1.debugLog.debug('SessionHandler', 'Forced session cleanup completed');
47
+ async cleanupSessionManager() {
48
+ if (this.sessionManager) {
49
+ await this.sessionManager.stopTracking();
50
+ this.sessionManager.destroy();
51
+ this.sessionManager = null;
244
52
  }
245
53
  }
246
- trackSession(eventType, sessionStartRecovered = false, sessionEndReason) {
247
- this.eventManager.track({
248
- type: eventType,
249
- ...(eventType === types_1.EventType.SESSION_START &&
250
- sessionStartRecovered && { session_start_recovered: sessionStartRecovered }),
251
- ...(eventType === types_1.EventType.SESSION_END && { session_end_reason: sessionEndReason ?? 'orphaned_cleanup' }),
252
- });
54
+ async stopTracking() {
55
+ await this.cleanupSessionManager();
253
56
  }
254
- startInitialSession() {
255
- if (this.get('sessionId')) {
256
- logging_1.debugLog.debug('SessionHandler', 'Session already exists, skipping initial session creation');
57
+ destroy() {
58
+ if (this.destroyed) {
257
59
  return;
258
60
  }
259
- logging_1.debugLog.debug('SessionHandler', 'Starting initial session');
260
- // Check if there's already a cross-tab session active
261
- if (this.crossTabSessionManager) {
262
- const existingSessionId = this.crossTabSessionManager.getSessionId();
263
- if (existingSessionId) {
264
- // Join existing cross-tab session
265
- this.set('sessionId', existingSessionId);
266
- this.persistSession(existingSessionId);
267
- this.startHeartbeat();
268
- return;
269
- }
270
- // No existing cross-tab session, so trigger activity to potentially create one
271
- // The cross-tab session manager will handle session creation when activity occurs
272
- return;
273
- }
274
- // Fallback: no cross-tab session manager, start regular session
275
- logging_1.debugLog.debug('SessionHandler', 'Starting regular session (no cross-tab)');
276
- const sessionResult = this.sessionManager.startSession();
277
- this.set('sessionId', sessionResult.sessionId);
278
- this.trackSession(types_1.EventType.SESSION_START, sessionResult.recovered);
279
- this.persistSession(sessionResult.sessionId);
280
- this.startHeartbeat();
281
- }
282
- checkOrphanedSessions() {
283
- const storedSessionData = this.storageManager.getItem(this.sessionStorageKey);
284
- if (storedSessionData) {
285
- try {
286
- const session = JSON.parse(storedSessionData);
287
- const now = Date.now();
288
- const timeSinceLastHeartbeat = now - session.lastHeartbeat;
289
- const sessionTimeout = this.get('config')?.sessionTimeout ?? constants_1.DEFAULT_SESSION_TIMEOUT_MS;
290
- if (timeSinceLastHeartbeat > sessionTimeout) {
291
- const canRecover = this.recoveryManager?.hasRecoverableSession();
292
- if (canRecover) {
293
- if (this.recoveryManager) {
294
- const sessionContext = {
295
- sessionId: session.sessionId,
296
- startTime: session.startTime,
297
- lastActivity: session.lastHeartbeat,
298
- tabCount: 1,
299
- recoveryAttempts: 0,
300
- metadata: {
301
- userAgent: navigator.userAgent,
302
- pageUrl: this.get('pageUrl'),
303
- },
304
- };
305
- this.recoveryManager.storeSessionContextForRecovery(sessionContext);
306
- if (this.get('config')?.mode === 'qa' || this.get('config')?.mode === 'debug') {
307
- logging_1.debugLog.debug('SessionHandler', `Orphaned session stored for recovery: ${session.sessionId}`);
308
- }
309
- }
310
- }
311
- this.trackSession(types_1.EventType.SESSION_END);
312
- this.clearPersistedSession();
313
- if (this.get('config')?.mode === 'qa' || this.get('config')?.mode === 'debug') {
314
- logging_1.debugLog.debug('SessionHandler', `Orphaned session ended: ${session.sessionId}, recovery available: ${canRecover}`);
315
- }
316
- }
317
- }
318
- catch {
319
- this.clearPersistedSession();
320
- }
321
- }
322
- }
323
- persistSession(sessionId) {
324
- const sessionData = {
325
- sessionId,
326
- startTime: Date.now(),
327
- lastHeartbeat: Date.now(),
328
- };
329
- this.storageManager.setItem(this.sessionStorageKey, JSON.stringify(sessionData));
330
- }
331
- clearPersistedSession() {
332
- this.storageManager.removeItem(this.sessionStorageKey);
333
- }
334
- startHeartbeat() {
335
- this.stopHeartbeat();
336
- this.heartbeatInterval = setInterval(() => {
337
- const storedSessionData = this.storageManager.getItem(this.sessionStorageKey);
338
- if (storedSessionData) {
339
- try {
340
- const session = JSON.parse(storedSessionData);
341
- session.lastHeartbeat = Date.now();
342
- this.storageManager.setItem(this.sessionStorageKey, JSON.stringify(session));
343
- }
344
- catch {
345
- this.clearPersistedSession();
346
- }
347
- }
348
- }, constants_1.SESSION_HEARTBEAT_INTERVAL_MS);
349
- }
350
- stopHeartbeat() {
351
- if (this.heartbeatInterval) {
352
- clearInterval(this.heartbeatInterval);
353
- this.heartbeatInterval = null;
61
+ if (this.sessionManager) {
62
+ this.sessionManager.destroy();
63
+ this.sessionManager = null;
354
64
  }
65
+ this.destroyed = true;
66
+ this.set('hasStartSession', false);
355
67
  }
356
68
  }
357
69
  exports.SessionHandler = SessionHandler;
@@ -8,7 +8,6 @@ declare global {
8
8
  }
9
9
  export declare class GoogleAnalyticsIntegration extends StateManager {
10
10
  private isInitialized;
11
- constructor();
12
11
  initialize(): Promise<void>;
13
12
  trackEvent(eventName: string, metadata: Record<string, MetadataType>): void;
14
13
  cleanup(): void;
@@ -1,11 +1,11 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.GoogleAnalyticsIntegration = void 0;
4
- const logging_1 = require("../utils/logging");
4
+ const utils_1 = require("../utils");
5
5
  const state_manager_1 = require("../managers/state.manager");
6
6
  class GoogleAnalyticsIntegration extends state_manager_1.StateManager {
7
7
  constructor() {
8
- super();
8
+ super(...arguments);
9
9
  this.isInitialized = false;
10
10
  }
11
11
  async initialize() {
@@ -13,69 +13,35 @@ class GoogleAnalyticsIntegration extends state_manager_1.StateManager {
13
13
  return;
14
14
  }
15
15
  const measurementId = this.get('config').integrations?.googleAnalytics?.measurementId;
16
- if (!measurementId?.trim()) {
17
- logging_1.debugLog.clientWarn('GoogleAnalytics', 'Google Analytics integration disabled - measurementId not configured', {
18
- hasIntegrations: !!this.get('config').integrations,
19
- hasGoogleAnalytics: !!this.get('config').integrations?.googleAnalytics,
20
- });
21
- return;
22
- }
23
16
  const userId = this.get('userId');
24
- if (!userId?.trim()) {
25
- logging_1.debugLog.warn('GoogleAnalytics', 'Google Analytics initialization delayed - userId not available', {
26
- measurementId: measurementId.substring(0, 8) + '...',
27
- });
17
+ if (!measurementId?.trim() || !userId?.trim()) {
28
18
  return;
29
19
  }
30
20
  try {
31
21
  if (this.isScriptAlreadyLoaded()) {
32
- logging_1.debugLog.info('GoogleAnalytics', 'Google Analytics script already loaded', { measurementId });
33
22
  this.isInitialized = true;
34
23
  return;
35
24
  }
36
25
  await this.loadScript(measurementId);
37
26
  this.configureGtag(measurementId, userId);
38
27
  this.isInitialized = true;
39
- logging_1.debugLog.info('GoogleAnalytics', 'Google Analytics integration initialized successfully', {
40
- measurementId,
41
- userId,
42
- });
43
28
  }
44
29
  catch (error) {
45
- logging_1.debugLog.error('GoogleAnalytics', 'Google Analytics initialization failed', {
30
+ utils_1.debugLog.error('GoogleAnalyticsIntegration', 'Initialization failed', {
46
31
  error: error instanceof Error ? error.message : 'Unknown error',
47
- measurementId,
48
- userId,
49
32
  });
50
33
  }
51
34
  }
52
35
  trackEvent(eventName, metadata) {
53
- if (!eventName?.trim()) {
54
- logging_1.debugLog.clientWarn('GoogleAnalytics', 'Event tracking skipped - invalid event name provided', {
55
- eventName,
56
- hasMetadata: !!metadata && Object.keys(metadata).length > 0,
57
- });
58
- return;
59
- }
60
- if (!this.isInitialized) {
61
- return;
62
- }
63
- if (typeof window.gtag !== 'function') {
64
- logging_1.debugLog.warn('GoogleAnalytics', 'Event tracking failed - gtag function not available', {
65
- eventName,
66
- hasGtag: typeof window.gtag,
67
- hasDataLayer: Array.isArray(window.dataLayer),
68
- });
36
+ if (!eventName?.trim() || !this.isInitialized || typeof window.gtag !== 'function') {
69
37
  return;
70
38
  }
71
39
  try {
72
40
  window.gtag('event', eventName, metadata);
73
41
  }
74
42
  catch (error) {
75
- logging_1.debugLog.error('GoogleAnalytics', 'Event tracking failed', {
76
- eventName,
43
+ utils_1.debugLog.error('GoogleAnalyticsIntegration', 'Event tracking failed', {
77
44
  error: error instanceof Error ? error.message : 'Unknown error',
78
- metadataKeys: Object.keys(metadata || {}),
79
45
  });
80
46
  }
81
47
  }
@@ -85,75 +51,38 @@ class GoogleAnalyticsIntegration extends state_manager_1.StateManager {
85
51
  if (script) {
86
52
  script.remove();
87
53
  }
88
- logging_1.debugLog.info('GoogleAnalytics', 'Google Analytics integration cleanup completed');
89
54
  }
90
55
  isScriptAlreadyLoaded() {
91
- const tracelogScript = document.getElementById('tracelog-ga-script');
92
- if (tracelogScript) {
56
+ // Check if we already loaded the script
57
+ if (document.getElementById('tracelog-ga-script')) {
93
58
  return true;
94
59
  }
60
+ // Check if GA is already loaded by another source
95
61
  const existingGAScript = document.querySelector('script[src*="googletagmanager.com/gtag/js"]');
96
- if (existingGAScript) {
97
- logging_1.debugLog.clientWarn('GoogleAnalytics', 'Google Analytics script already loaded from external source', {
98
- scriptSrc: existingGAScript.getAttribute('src'),
99
- hasGtag: typeof window.gtag === 'function',
100
- });
101
- return true;
102
- }
103
- return false;
62
+ return !!existingGAScript;
104
63
  }
105
64
  async loadScript(measurementId) {
106
65
  return new Promise((resolve, reject) => {
107
- try {
108
- const script = document.createElement('script');
109
- script.id = 'tracelog-ga-script';
110
- script.async = true;
111
- script.src = `https://www.googletagmanager.com/gtag/js?id=${measurementId}`;
112
- script.onload = () => {
113
- resolve();
114
- };
115
- script.onerror = () => {
116
- const error = new Error('Failed to load Google Analytics script');
117
- logging_1.debugLog.error('GoogleAnalytics', 'Google Analytics script load failed', {
118
- measurementId,
119
- error: error.message,
120
- scriptSrc: script.src,
121
- });
122
- reject(error);
123
- };
124
- document.head.appendChild(script);
125
- }
126
- catch (error) {
127
- const errorMsg = error instanceof Error ? error : new Error(String(error));
128
- logging_1.debugLog.error('GoogleAnalytics', 'Error creating Google Analytics script', {
129
- measurementId,
130
- error: errorMsg.message,
131
- });
132
- reject(errorMsg);
133
- }
66
+ const script = document.createElement('script');
67
+ script.id = 'tracelog-ga-script';
68
+ script.async = true;
69
+ script.src = `https://www.googletagmanager.com/gtag/js?id=${measurementId}`;
70
+ script.onload = () => resolve();
71
+ script.onerror = () => reject(new Error('Failed to load Google Analytics script'));
72
+ document.head.appendChild(script);
134
73
  });
135
74
  }
136
75
  configureGtag(measurementId, userId) {
137
- try {
138
- const gaScriptConfig = document.createElement('script');
139
- gaScriptConfig.innerHTML = `
140
- window.dataLayer = window.dataLayer || [];
141
- function gtag(){dataLayer.push(arguments);}
142
- gtag('js', new Date());
143
- gtag('config', '${measurementId}', {
144
- 'user_id': '${userId}'
145
- });
146
- `;
147
- document.head.appendChild(gaScriptConfig);
148
- }
149
- catch (error) {
150
- logging_1.debugLog.error('GoogleAnalytics', 'Failed to configure Google Analytics', {
151
- measurementId,
152
- userId,
153
- error: error instanceof Error ? error.message : 'Unknown error',
154
- });
155
- throw error;
156
- }
76
+ const gaScriptConfig = document.createElement('script');
77
+ gaScriptConfig.innerHTML = `
78
+ window.dataLayer = window.dataLayer || [];
79
+ function gtag(){dataLayer.push(arguments);}
80
+ gtag('js', new Date());
81
+ gtag('config', '${measurementId}', {
82
+ 'user_id': '${userId}'
83
+ });
84
+ `;
85
+ document.head.appendChild(gaScriptConfig);
157
86
  }
158
87
  }
159
88
  exports.GoogleAnalyticsIntegration = GoogleAnalyticsIntegration;
@@ -1,15 +1,24 @@
1
1
  import { EventListenerManager } from './listeners.types';
2
- export declare class MouseListenerManager implements EventListenerManager {
3
- private readonly onActivity;
4
- private readonly options;
2
+ /**
3
+ * Base class for input listener managers to reduce code duplication
4
+ */
5
+ declare abstract class BaseInputListenerManager implements EventListenerManager {
6
+ protected readonly onActivity: () => void;
7
+ protected readonly options: {
8
+ passive: boolean;
9
+ };
10
+ protected abstract readonly events: string[];
11
+ protected abstract readonly logPrefix: string;
5
12
  constructor(onActivity: () => void);
6
13
  setup(): void;
7
14
  cleanup(): void;
8
15
  }
9
- export declare class KeyboardListenerManager implements EventListenerManager {
10
- private readonly onActivity;
11
- private readonly options;
12
- constructor(onActivity: () => void);
13
- setup(): void;
14
- cleanup(): void;
16
+ export declare class MouseListenerManager extends BaseInputListenerManager {
17
+ protected readonly events: string[];
18
+ protected readonly logPrefix = "MouseListenerManager";
19
+ }
20
+ export declare class KeyboardListenerManager extends BaseInputListenerManager {
21
+ protected readonly events: string[];
22
+ protected readonly logPrefix = "KeyboardListenerManager";
15
23
  }
24
+ export {};