@safaricom-mxl/web-sdk 0.1.1 → 0.1.3

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 (154) hide show
  1. package/UPGRADING.md +25 -0
  2. package/dist/api-logs/manager/types.d.cts +6 -1
  3. package/dist/api-logs/manager/types.d.cts.map +1 -1
  4. package/dist/api-logs/manager/types.d.ts +6 -1
  5. package/dist/api-logs/manager/types.d.ts.map +1 -1
  6. package/dist/api-sessions/manager/NoOpUserSessionManager/NoOpUserSessionManager.cjs +5 -0
  7. package/dist/api-sessions/manager/NoOpUserSessionManager/NoOpUserSessionManager.cjs.map +1 -1
  8. package/dist/api-sessions/manager/NoOpUserSessionManager/NoOpUserSessionManager.d.cts +3 -1
  9. package/dist/api-sessions/manager/NoOpUserSessionManager/NoOpUserSessionManager.d.cts.map +1 -1
  10. package/dist/api-sessions/manager/NoOpUserSessionManager/NoOpUserSessionManager.d.ts +3 -1
  11. package/dist/api-sessions/manager/NoOpUserSessionManager/NoOpUserSessionManager.d.ts.map +1 -1
  12. package/dist/api-sessions/manager/NoOpUserSessionManager/NoOpUserSessionManager.js +5 -0
  13. package/dist/api-sessions/manager/NoOpUserSessionManager/NoOpUserSessionManager.js.map +1 -1
  14. package/dist/api-sessions/manager/ProxyUserSessionManager/ProxyUserSessionManager.cjs +6 -0
  15. package/dist/api-sessions/manager/ProxyUserSessionManager/ProxyUserSessionManager.cjs.map +1 -1
  16. package/dist/api-sessions/manager/ProxyUserSessionManager/ProxyUserSessionManager.d.cts +3 -1
  17. package/dist/api-sessions/manager/ProxyUserSessionManager/ProxyUserSessionManager.d.cts.map +1 -1
  18. package/dist/api-sessions/manager/ProxyUserSessionManager/ProxyUserSessionManager.d.ts +3 -1
  19. package/dist/api-sessions/manager/ProxyUserSessionManager/ProxyUserSessionManager.d.ts.map +1 -1
  20. package/dist/api-sessions/manager/ProxyUserSessionManager/ProxyUserSessionManager.js +6 -0
  21. package/dist/api-sessions/manager/ProxyUserSessionManager/ProxyUserSessionManager.js.map +1 -1
  22. package/dist/index.cjs +2 -0
  23. package/dist/index.d.cts +3 -2
  24. package/dist/index.d.ts +3 -2
  25. package/dist/index.js +2 -1
  26. package/dist/instrumentations/document-load/DocumentLoadInstrumentation/DocumentLoadInstrumentation.cjs +21 -20
  27. package/dist/instrumentations/document-load/DocumentLoadInstrumentation/DocumentLoadInstrumentation.cjs.map +1 -1
  28. package/dist/instrumentations/document-load/DocumentLoadInstrumentation/DocumentLoadInstrumentation.js +17 -16
  29. package/dist/instrumentations/document-load/DocumentLoadInstrumentation/DocumentLoadInstrumentation.js.map +1 -1
  30. package/dist/instrumentations/document-load/DocumentLoadInstrumentation/enums/PerformanceTimingNames.cjs +32 -0
  31. package/dist/instrumentations/document-load/DocumentLoadInstrumentation/enums/PerformanceTimingNames.cjs.map +1 -0
  32. package/dist/instrumentations/document-load/DocumentLoadInstrumentation/enums/PerformanceTimingNames.d.cts +29 -0
  33. package/dist/instrumentations/document-load/DocumentLoadInstrumentation/enums/PerformanceTimingNames.d.cts.map +1 -0
  34. package/dist/instrumentations/document-load/DocumentLoadInstrumentation/enums/PerformanceTimingNames.d.ts +29 -0
  35. package/dist/instrumentations/document-load/DocumentLoadInstrumentation/enums/PerformanceTimingNames.d.ts.map +1 -0
  36. package/dist/instrumentations/document-load/DocumentLoadInstrumentation/enums/PerformanceTimingNames.js +31 -0
  37. package/dist/instrumentations/document-load/DocumentLoadInstrumentation/enums/PerformanceTimingNames.js.map +1 -0
  38. package/dist/instrumentations/document-load/DocumentLoadInstrumentation/networkEvents.cjs +34 -0
  39. package/dist/instrumentations/document-load/DocumentLoadInstrumentation/networkEvents.cjs.map +1 -0
  40. package/dist/instrumentations/document-load/DocumentLoadInstrumentation/networkEvents.d.cts +34 -0
  41. package/dist/instrumentations/document-load/DocumentLoadInstrumentation/networkEvents.d.cts.map +1 -0
  42. package/dist/instrumentations/document-load/DocumentLoadInstrumentation/networkEvents.d.ts +34 -0
  43. package/dist/instrumentations/document-load/DocumentLoadInstrumentation/networkEvents.d.ts.map +1 -0
  44. package/dist/instrumentations/document-load/DocumentLoadInstrumentation/networkEvents.js +31 -0
  45. package/dist/instrumentations/document-load/DocumentLoadInstrumentation/networkEvents.js.map +1 -0
  46. package/dist/instrumentations/document-load/DocumentLoadInstrumentation/utils.cjs +5 -5
  47. package/dist/instrumentations/document-load/DocumentLoadInstrumentation/utils.cjs.map +1 -1
  48. package/dist/instrumentations/document-load/DocumentLoadInstrumentation/utils.d.cts +1 -1
  49. package/dist/instrumentations/document-load/DocumentLoadInstrumentation/utils.d.cts.map +1 -1
  50. package/dist/instrumentations/document-load/DocumentLoadInstrumentation/utils.d.ts +1 -1
  51. package/dist/instrumentations/document-load/DocumentLoadInstrumentation/utils.d.ts.map +1 -1
  52. package/dist/instrumentations/document-load/DocumentLoadInstrumentation/utils.js +2 -1
  53. package/dist/instrumentations/document-load/DocumentLoadInstrumentation/utils.js.map +1 -1
  54. package/dist/instrumentations/replay/events/startEventCapture.cjs +2 -1
  55. package/dist/instrumentations/replay/events/startEventCapture.cjs.map +1 -1
  56. package/dist/instrumentations/replay/events/startEventCapture.d.cts +2 -0
  57. package/dist/instrumentations/replay/events/startEventCapture.d.cts.map +1 -1
  58. package/dist/instrumentations/replay/events/startEventCapture.d.ts +2 -0
  59. package/dist/instrumentations/replay/events/startEventCapture.d.ts.map +1 -1
  60. package/dist/instrumentations/replay/events/startEventCapture.js +2 -1
  61. package/dist/instrumentations/replay/events/startEventCapture.js.map +1 -1
  62. package/dist/instrumentations/replay/recorder/startRecording.cjs +2 -4
  63. package/dist/instrumentations/replay/recorder/startRecording.cjs.map +1 -1
  64. package/dist/instrumentations/replay/recorder/startRecording.d.cts +2 -0
  65. package/dist/instrumentations/replay/recorder/startRecording.d.cts.map +1 -1
  66. package/dist/instrumentations/replay/recorder/startRecording.d.ts +2 -0
  67. package/dist/instrumentations/replay/recorder/startRecording.d.ts.map +1 -1
  68. package/dist/instrumentations/replay/recorder/startRecording.js +2 -4
  69. package/dist/instrumentations/replay/recorder/startRecording.js.map +1 -1
  70. package/dist/instrumentations/replay/recorder/types.d.cts +0 -1
  71. package/dist/instrumentations/replay/recorder/types.d.cts.map +1 -1
  72. package/dist/instrumentations/replay/recorder/types.d.ts +0 -1
  73. package/dist/instrumentations/replay/recorder/types.d.ts.map +1 -1
  74. package/dist/instrumentations/replay/session-recording/SessionRecording.cjs +16 -1
  75. package/dist/instrumentations/replay/session-recording/SessionRecording.cjs.map +1 -1
  76. package/dist/instrumentations/replay/session-recording/SessionRecording.d.cts +2 -0
  77. package/dist/instrumentations/replay/session-recording/SessionRecording.d.cts.map +1 -1
  78. package/dist/instrumentations/replay/session-recording/SessionRecording.d.ts +2 -0
  79. package/dist/instrumentations/replay/session-recording/SessionRecording.d.ts.map +1 -1
  80. package/dist/instrumentations/replay/session-recording/SessionRecording.js +16 -1
  81. package/dist/instrumentations/replay/session-recording/SessionRecording.js.map +1 -1
  82. package/dist/instrumentations/replay/session-recording/lifecycle.cjs +6 -4
  83. package/dist/instrumentations/replay/session-recording/lifecycle.cjs.map +1 -1
  84. package/dist/instrumentations/replay/session-recording/lifecycle.d.cts +4 -3
  85. package/dist/instrumentations/replay/session-recording/lifecycle.d.cts.map +1 -1
  86. package/dist/instrumentations/replay/session-recording/lifecycle.d.ts +4 -3
  87. package/dist/instrumentations/replay/session-recording/lifecycle.d.ts.map +1 -1
  88. package/dist/instrumentations/replay/session-recording/lifecycle.js +6 -4
  89. package/dist/instrumentations/replay/session-recording/lifecycle.js.map +1 -1
  90. package/dist/managers/MXLLogManager/MXLLogManager.cjs +3 -1
  91. package/dist/managers/MXLLogManager/MXLLogManager.cjs.map +1 -1
  92. package/dist/managers/MXLLogManager/MXLLogManager.d.cts +2 -1
  93. package/dist/managers/MXLLogManager/MXLLogManager.d.cts.map +1 -1
  94. package/dist/managers/MXLLogManager/MXLLogManager.d.ts +2 -1
  95. package/dist/managers/MXLLogManager/MXLLogManager.d.ts.map +1 -1
  96. package/dist/managers/MXLLogManager/MXLLogManager.js +4 -2
  97. package/dist/managers/MXLLogManager/MXLLogManager.js.map +1 -1
  98. package/dist/managers/MXLPageManager/MXLPageManager.cjs +1 -1
  99. package/dist/managers/MXLPageManager/MXLPageManager.js +1 -1
  100. package/dist/managers/MXLUserManager/MXLUserManager.cjs +1 -1
  101. package/dist/managers/MXLUserManager/MXLUserManager.js +1 -1
  102. package/dist/managers/MXLUserSessionManager/MXLUserSessionManager.cjs +17 -3
  103. package/dist/managers/MXLUserSessionManager/MXLUserSessionManager.cjs.map +1 -1
  104. package/dist/managers/MXLUserSessionManager/MXLUserSessionManager.d.cts +3 -1
  105. package/dist/managers/MXLUserSessionManager/MXLUserSessionManager.d.cts.map +1 -1
  106. package/dist/managers/MXLUserSessionManager/MXLUserSessionManager.d.ts +3 -1
  107. package/dist/managers/MXLUserSessionManager/MXLUserSessionManager.d.ts.map +1 -1
  108. package/dist/managers/MXLUserSessionManager/MXLUserSessionManager.js +17 -3
  109. package/dist/managers/MXLUserSessionManager/MXLUserSessionManager.js.map +1 -1
  110. package/dist/managers/MXLUserSessionManager/constants.cjs +1 -1
  111. package/dist/managers/MXLUserSessionManager/constants.cjs.map +1 -1
  112. package/dist/managers/MXLUserSessionManager/constants.d.cts +1 -1
  113. package/dist/managers/MXLUserSessionManager/constants.d.ts +1 -1
  114. package/dist/managers/MXLUserSessionManager/constants.js +1 -1
  115. package/dist/managers/MXLUserSessionManager/constants.js.map +1 -1
  116. package/dist/managers/MXLUserSessionManager/types.d.cts +10 -1
  117. package/dist/managers/MXLUserSessionManager/types.d.cts.map +1 -1
  118. package/dist/managers/MXLUserSessionManager/types.d.ts +10 -1
  119. package/dist/managers/MXLUserSessionManager/types.d.ts.map +1 -1
  120. package/dist/managers/MXLUserSessionManager/utils/state.cjs +19 -6
  121. package/dist/managers/MXLUserSessionManager/utils/state.cjs.map +1 -1
  122. package/dist/managers/MXLUserSessionManager/utils/state.d.cts +3 -2
  123. package/dist/managers/MXLUserSessionManager/utils/state.d.cts.map +1 -1
  124. package/dist/managers/MXLUserSessionManager/utils/state.d.ts +3 -2
  125. package/dist/managers/MXLUserSessionManager/utils/state.d.ts.map +1 -1
  126. package/dist/managers/MXLUserSessionManager/utils/state.js +19 -7
  127. package/dist/managers/MXLUserSessionManager/utils/state.js.map +1 -1
  128. package/dist/managers/MXLUserSessionManager/utils/tabTracking.cjs +1 -1
  129. package/dist/managers/MXLUserSessionManager/utils/tabTracking.js +1 -1
  130. package/dist/mxl-web-sdk.js +2 -2
  131. package/dist/mxl-web-sdk.js.map +1 -1
  132. package/dist/processors/UserSessionLogRecordProcessor/UserSessionLogRecordProcessor.cjs +1 -1
  133. package/dist/processors/UserSessionLogRecordProcessor/UserSessionLogRecordProcessor.js +1 -1
  134. package/dist/resources/sdkConstants.cjs +1 -1
  135. package/dist/resources/sdkConstants.cjs.map +1 -1
  136. package/dist/resources/sdkConstants.d.cts +1 -1
  137. package/dist/resources/sdkConstants.d.ts +1 -1
  138. package/dist/resources/sdkConstants.js +1 -1
  139. package/dist/resources/sdkConstants.js.map +1 -1
  140. package/dist/sdk/initSDK.cjs +4 -2
  141. package/dist/sdk/initSDK.cjs.map +1 -1
  142. package/dist/sdk/initSDK.d.cts.map +1 -1
  143. package/dist/sdk/initSDK.d.ts.map +1 -1
  144. package/dist/sdk/initSDK.js +4 -2
  145. package/dist/sdk/initSDK.js.map +1 -1
  146. package/dist/sdk/responseSpanContext.cjs +34 -0
  147. package/dist/sdk/responseSpanContext.cjs.map +1 -0
  148. package/dist/sdk/responseSpanContext.d.cts +16 -0
  149. package/dist/sdk/responseSpanContext.d.cts.map +1 -0
  150. package/dist/sdk/responseSpanContext.d.ts +16 -0
  151. package/dist/sdk/responseSpanContext.d.ts.map +1 -0
  152. package/dist/sdk/responseSpanContext.js +31 -0
  153. package/dist/sdk/responseSpanContext.js.map +1 -0
  154. package/package.json +14 -15
@@ -1,6 +1,11 @@
1
1
  import { generateUUID } from "../../../utils/generateUUID.js";
2
2
  import { MXL_PERMANENT_PROPERTIES_KEY, MXL_USER_SESSION_STATE_KEY } from "../constants.js";
3
3
  //#region src/managers/MXLUserSessionManager/utils/state.ts
4
+ const EMPTY_REPLAY_COUNTS = {
5
+ clicks: 0,
6
+ errors: 0,
7
+ pageViews: 0
8
+ };
4
9
  /**
5
10
  * True when the stored state is no longer trustworthy: the device clock
6
11
  * jumped backwards past the recorded start, the max-duration deadline has
@@ -15,9 +20,10 @@ const createUserSessionState = ({ now, previousUserSessionId, maxUserSessionDura
15
20
  inactivityTimeoutSeconds,
16
21
  maxUserSessionDurationSeconds,
17
22
  previousUserSessionId,
23
+ replayCounts: EMPTY_REPLAY_COUNTS,
18
24
  replayMetaVersion: 0,
19
25
  replaySampled: null,
20
- schemaVersion: 3,
26
+ schemaVersion: 4,
21
27
  userSessionId: generateUUID(),
22
28
  userSessionMaxEndTs: now + maxUserSessionDurationSeconds * 1e3,
23
29
  userSessionNumber,
@@ -26,14 +32,19 @@ const createUserSessionState = ({ now, previousUserSessionId, maxUserSessionDura
26
32
  userSessionStartTs: now
27
33
  });
28
34
  const storedSchemaVersion = (state) => state !== null && typeof state === "object" ? state.schemaVersion : void 0;
35
+ /** v3 predates replay counts; the session's earlier page loads never reported any. */
36
+ const upgradeV3UserSessionState = (state) => ({
37
+ ...state,
38
+ replayCounts: EMPTY_REPLAY_COUNTS,
39
+ schemaVersion: 4
40
+ });
29
41
  /**
30
42
  * v2 predates the foreground inactivity timeout; its live timer ran on the
31
43
  * inactivity timeout, which the upgraded session keeps.
32
44
  */
33
- const upgradeV2UserSessionState = (state) => ({
45
+ const upgradeV2UserSessionState = (state) => upgradeV3UserSessionState({
34
46
  ...state,
35
- foregroundInactivityTimeoutSeconds: state.inactivityTimeoutSeconds,
36
- schemaVersion: 3
47
+ foregroundInactivityTimeoutSeconds: state.inactivityTimeoutSeconds
37
48
  });
38
49
  /**
39
50
  * v1 predates the replay fields. Its page loads posted replay meta versions 1
@@ -48,11 +59,12 @@ const upgradeV1UserSessionState = (state) => upgradeV2UserSessionState({
48
59
  * Treats the schemaVersion stamp as the contract. Every field is written
49
60
  * by createUserSessionState (and userSessionProperties is validated at
50
61
  * addProperty time), so a matching version means the blob came from this
51
- * code path and we trust the rest of its shape. v1 and v2 blobs are upgraded.
62
+ * code path and we trust the rest of its shape. v1, v2 and v3 blobs are upgraded.
52
63
  */
53
64
  const toCurrentUserSessionState = (state) => {
54
65
  switch (storedSchemaVersion(state)) {
55
- case 3: return state;
66
+ case 4: return state;
67
+ case 3: return upgradeV3UserSessionState(state);
56
68
  case 2: return upgradeV2UserSessionState(state);
57
69
  case 1: return upgradeV1UserSessionState(state);
58
70
  default: return null;
@@ -97,6 +109,6 @@ const storePermanentProperties = (storage, properties) => {
97
109
  return storage.setItem(MXL_PERMANENT_PROPERTIES_KEY, JSON.stringify(properties));
98
110
  };
99
111
  //#endregion
100
- export { createUserSessionState, isUserSessionExpired, readPermanentProperties, readUserSessionState, storePermanentProperties };
112
+ export { EMPTY_REPLAY_COUNTS, createUserSessionState, isUserSessionExpired, readPermanentProperties, readUserSessionState, storePermanentProperties };
101
113
 
102
114
  //# sourceMappingURL=state.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"state.js","names":[],"sources":["../../../../src/managers/MXLUserSessionManager/utils/state.ts"],"sourcesContent":["import type { DiagLogger } from '@opentelemetry/api';\nimport { generateUUID } from '../../../utils/generateUUID';\nimport type { NamespacedStorage } from '../../../utils/NamespacedStorage/NamespacedStorage';\nimport {\n MXL_PERMANENT_PROPERTIES_KEY,\n MXL_USER_SESSION_STATE_KEY,\n USER_SESSION_STATE_SCHEMA_VERSION,\n} from '../constants';\nimport type { UserSessionState } from '../types';\n\n/**\n * True when the stored state is no longer trustworthy: the device clock\n * jumped backwards past the recorded start, the max-duration deadline has\n * passed, or an inactivity deadline (set when the last part ended) has\n * passed. Inactivity only applies between parts; the deadline is null\n * while a part is active.\n */\nexport const isUserSessionExpired = (\n state: UserSessionState,\n now: number,\n): boolean =>\n now < state.userSessionStartTs ||\n now >= state.userSessionMaxEndTs ||\n (state.inactivityDeadlineTs !== null && now >= state.inactivityDeadlineTs);\n\nexport interface CreateUserSessionStateArgs {\n now: number;\n previousUserSessionId: string | null;\n maxUserSessionDurationSeconds: number;\n inactivityTimeoutSeconds: number;\n foregroundInactivityTimeoutSeconds: number;\n userSessionNumber: number;\n}\n\nexport const createUserSessionState = ({\n now,\n previousUserSessionId,\n maxUserSessionDurationSeconds,\n inactivityTimeoutSeconds,\n foregroundInactivityTimeoutSeconds,\n userSessionNumber,\n}: CreateUserSessionStateArgs): UserSessionState => ({\n foregroundInactivityTimeoutSeconds,\n inactivityDeadlineTs: null,\n inactivityTimeoutSeconds,\n maxUserSessionDurationSeconds,\n previousUserSessionId,\n replayMetaVersion: 0,\n replaySampled: null,\n schemaVersion: USER_SESSION_STATE_SCHEMA_VERSION,\n userSessionId: generateUUID(),\n userSessionMaxEndTs: now + maxUserSessionDurationSeconds * 1000,\n userSessionNumber,\n userSessionPartIndex: 0,\n userSessionProperties: {},\n userSessionStartTs: now,\n});\n\nconst storedSchemaVersion = (state: unknown): unknown =>\n state !== null && typeof state === 'object'\n ? (state as { schemaVersion?: unknown }).schemaVersion\n : undefined;\n\ntype V2UserSessionState = Omit<\n UserSessionState,\n 'foregroundInactivityTimeoutSeconds'\n>;\n\n/**\n * v2 predates the foreground inactivity timeout; its live timer ran on the\n * inactivity timeout, which the upgraded session keeps.\n */\nconst upgradeV2UserSessionState = (\n state: V2UserSessionState,\n): UserSessionState => ({\n ...state,\n foregroundInactivityTimeoutSeconds: state.inactivityTimeoutSeconds,\n schemaVersion: USER_SESSION_STATE_SCHEMA_VERSION,\n});\n\n/**\n * v1 predates the replay fields. Its page loads posted replay meta versions 1\n * and 2 for the session, so the counter resumes above them.\n */\nconst upgradeV1UserSessionState = (\n state: Omit<V2UserSessionState, 'replaySampled' | 'replayMetaVersion'>,\n): UserSessionState =>\n upgradeV2UserSessionState({\n ...state,\n replayMetaVersion: 2,\n replaySampled: null,\n });\n\n/**\n * Treats the schemaVersion stamp as the contract. Every field is written\n * by createUserSessionState (and userSessionProperties is validated at\n * addProperty time), so a matching version means the blob came from this\n * code path and we trust the rest of its shape. v1 and v2 blobs are upgraded.\n */\nconst toCurrentUserSessionState = (state: unknown): UserSessionState | null => {\n switch (storedSchemaVersion(state)) {\n case USER_SESSION_STATE_SCHEMA_VERSION:\n return state as UserSessionState;\n case 2:\n return upgradeV2UserSessionState(state as V2UserSessionState);\n case 1:\n return upgradeV1UserSessionState(\n state as Omit<\n V2UserSessionState,\n 'replaySampled' | 'replayMetaVersion'\n >,\n );\n default:\n return null;\n }\n};\n\nexport const readUserSessionState = (\n storage: NamespacedStorage,\n diag: DiagLogger,\n): UserSessionState | null => {\n const raw = storage.getItem(MXL_USER_SESSION_STATE_KEY);\n if (!raw) {\n return null;\n }\n try {\n const state = toCurrentUserSessionState(JSON.parse(raw));\n if (!state) {\n throw new Error('stored user session state failed structural validation');\n }\n return state;\n } catch (error) {\n diag.error(\n 'User session state in storage is corrupt; discarding it',\n error,\n );\n storage.removeItem(MXL_USER_SESSION_STATE_KEY);\n return null;\n }\n};\n\nexport const readPermanentProperties = (\n storage: NamespacedStorage,\n diag: DiagLogger,\n): Record<string, string> => {\n const raw = storage.getItem(MXL_PERMANENT_PROPERTIES_KEY);\n if (!raw) {\n return {};\n }\n try {\n const parsed = JSON.parse(raw) as unknown;\n if (\n parsed === null ||\n typeof parsed !== 'object' ||\n Array.isArray(parsed)\n ) {\n throw new Error('permanent properties blob is not a plain object');\n }\n const validated: Record<string, string> = {};\n for (const [key, value] of Object.entries(parsed)) {\n if (typeof value === 'string') {\n validated[key] = value;\n }\n }\n return validated;\n } catch (error) {\n diag.error(\n 'Permanent properties in storage are corrupt; discarding',\n error,\n );\n storage.removeItem(MXL_PERMANENT_PROPERTIES_KEY);\n return {};\n }\n};\n\n/**\n * Empty blobs are removed rather than written so storage stays tidy when\n * the last property is cleared. Returns false on a failed write; callers\n * gate cross-scope flips on this so a failed permanent write doesn't\n * strip the previously-visible user-session-scoped value.\n */\nexport const storePermanentProperties = (\n storage: NamespacedStorage,\n properties: Record<string, string>,\n): boolean => {\n if (Object.keys(properties).length === 0) {\n return storage.removeItem(MXL_PERMANENT_PROPERTIES_KEY);\n }\n return storage.setItem(\n MXL_PERMANENT_PROPERTIES_KEY,\n JSON.stringify(properties),\n );\n};\n"],"mappings":";;;;;;;;;;AAiBA,MAAa,wBACX,OACA,QAEA,MAAM,MAAM,sBACZ,OAAO,MAAM,uBACZ,MAAM,yBAAyB,QAAQ,OAAO,MAAM;AAWvD,MAAa,0BAA0B,EACrC,KACA,uBACA,+BACA,0BACA,oCACA,yBACmD;CACnD;CACA,sBAAsB;CACtB;CACA;CACA;CACA,mBAAmB;CACnB,eAAe;CACf,eAAA;CACA,eAAe,cAAc;CAC7B,qBAAqB,MAAM,gCAAgC;CAC3D;CACA,sBAAsB;CACtB,uBAAuB,EAAE;CACzB,oBAAoB;CACrB;AAED,MAAM,uBAAuB,UAC3B,UAAU,QAAQ,OAAO,UAAU,WAC9B,MAAsC,gBACvC,KAAA;;;;;AAWN,MAAM,6BACJ,WACsB;CACtB,GAAG;CACH,oCAAoC,MAAM;CAC1C,eAAA;CACD;;;;;AAMD,MAAM,6BACJ,UAEA,0BAA0B;CACxB,GAAG;CACH,mBAAmB;CACnB,eAAe;CAChB,CAAC;;;;;;;AAQJ,MAAM,6BAA6B,UAA4C;AAC7E,SAAQ,oBAAoB,MAAM,EAAlC;EACE,KAAA,EACE,QAAO;EACT,KAAK,EACH,QAAO,0BAA0B,MAA4B;EAC/D,KAAK,EACH,QAAO,0BACL,MAID;EACH,QACE,QAAO;;;AAIb,MAAa,wBACX,SACA,SAC4B;CAC5B,MAAM,MAAM,QAAQ,QAAQ,2BAA2B;AACvD,KAAI,CAAC,IACH,QAAO;AAET,KAAI;EACF,MAAM,QAAQ,0BAA0B,KAAK,MAAM,IAAI,CAAC;AACxD,MAAI,CAAC,MACH,OAAM,IAAI,MAAM,yDAAyD;AAE3E,SAAO;UACA,OAAO;AACd,OAAK,MACH,2DACA,MACD;AACD,UAAQ,WAAW,2BAA2B;AAC9C,SAAO;;;AAIX,MAAa,2BACX,SACA,SAC2B;CAC3B,MAAM,MAAM,QAAQ,QAAQ,6BAA6B;AACzD,KAAI,CAAC,IACH,QAAO,EAAE;AAEX,KAAI;EACF,MAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,MACE,WAAW,QACX,OAAO,WAAW,YAClB,MAAM,QAAQ,OAAO,CAErB,OAAM,IAAI,MAAM,kDAAkD;EAEpE,MAAM,YAAoC,EAAE;AAC5C,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,CAC/C,KAAI,OAAO,UAAU,SACnB,WAAU,OAAO;AAGrB,SAAO;UACA,OAAO;AACd,OAAK,MACH,2DACA,MACD;AACD,UAAQ,WAAW,6BAA6B;AAChD,SAAO,EAAE;;;;;;;;;AAUb,MAAa,4BACX,SACA,eACY;AACZ,KAAI,OAAO,KAAK,WAAW,CAAC,WAAW,EACrC,QAAO,QAAQ,WAAW,6BAA6B;AAEzD,QAAO,QAAQ,QACb,8BACA,KAAK,UAAU,WAAW,CAC3B"}
1
+ {"version":3,"file":"state.js","names":[],"sources":["../../../../src/managers/MXLUserSessionManager/utils/state.ts"],"sourcesContent":["import type { DiagLogger } from '@opentelemetry/api';\nimport { generateUUID } from '../../../utils/generateUUID';\nimport type { NamespacedStorage } from '../../../utils/NamespacedStorage/NamespacedStorage';\nimport {\n MXL_PERMANENT_PROPERTIES_KEY,\n MXL_USER_SESSION_STATE_KEY,\n USER_SESSION_STATE_SCHEMA_VERSION,\n} from '../constants';\nimport type { ReplayCounts, UserSessionState } from '../types';\n\nexport const EMPTY_REPLAY_COUNTS: ReplayCounts = {\n clicks: 0,\n errors: 0,\n pageViews: 0,\n};\n\n/**\n * True when the stored state is no longer trustworthy: the device clock\n * jumped backwards past the recorded start, the max-duration deadline has\n * passed, or an inactivity deadline (set when the last part ended) has\n * passed. Inactivity only applies between parts; the deadline is null\n * while a part is active.\n */\nexport const isUserSessionExpired = (\n state: UserSessionState,\n now: number,\n): boolean =>\n now < state.userSessionStartTs ||\n now >= state.userSessionMaxEndTs ||\n (state.inactivityDeadlineTs !== null && now >= state.inactivityDeadlineTs);\n\nexport interface CreateUserSessionStateArgs {\n now: number;\n previousUserSessionId: string | null;\n maxUserSessionDurationSeconds: number;\n inactivityTimeoutSeconds: number;\n foregroundInactivityTimeoutSeconds: number;\n userSessionNumber: number;\n}\n\nexport const createUserSessionState = ({\n now,\n previousUserSessionId,\n maxUserSessionDurationSeconds,\n inactivityTimeoutSeconds,\n foregroundInactivityTimeoutSeconds,\n userSessionNumber,\n}: CreateUserSessionStateArgs): UserSessionState => ({\n foregroundInactivityTimeoutSeconds,\n inactivityDeadlineTs: null,\n inactivityTimeoutSeconds,\n maxUserSessionDurationSeconds,\n previousUserSessionId,\n replayCounts: EMPTY_REPLAY_COUNTS,\n replayMetaVersion: 0,\n replaySampled: null,\n schemaVersion: USER_SESSION_STATE_SCHEMA_VERSION,\n userSessionId: generateUUID(),\n userSessionMaxEndTs: now + maxUserSessionDurationSeconds * 1000,\n userSessionNumber,\n userSessionPartIndex: 0,\n userSessionProperties: {},\n userSessionStartTs: now,\n});\n\nconst storedSchemaVersion = (state: unknown): unknown =>\n state !== null && typeof state === 'object'\n ? (state as { schemaVersion?: unknown }).schemaVersion\n : undefined;\n\ntype V3UserSessionState = Omit<UserSessionState, 'replayCounts'>;\n\ntype V2UserSessionState = Omit<\n V3UserSessionState,\n 'foregroundInactivityTimeoutSeconds'\n>;\n\n/** v3 predates replay counts; the session's earlier page loads never reported any. */\nconst upgradeV3UserSessionState = (\n state: V3UserSessionState,\n): UserSessionState => ({\n ...state,\n replayCounts: EMPTY_REPLAY_COUNTS,\n schemaVersion: USER_SESSION_STATE_SCHEMA_VERSION,\n});\n\n/**\n * v2 predates the foreground inactivity timeout; its live timer ran on the\n * inactivity timeout, which the upgraded session keeps.\n */\nconst upgradeV2UserSessionState = (\n state: V2UserSessionState,\n): UserSessionState =>\n upgradeV3UserSessionState({\n ...state,\n foregroundInactivityTimeoutSeconds: state.inactivityTimeoutSeconds,\n });\n\n/**\n * v1 predates the replay fields. Its page loads posted replay meta versions 1\n * and 2 for the session, so the counter resumes above them.\n */\nconst upgradeV1UserSessionState = (\n state: Omit<V2UserSessionState, 'replaySampled' | 'replayMetaVersion'>,\n): UserSessionState =>\n upgradeV2UserSessionState({\n ...state,\n replayMetaVersion: 2,\n replaySampled: null,\n });\n\n/**\n * Treats the schemaVersion stamp as the contract. Every field is written\n * by createUserSessionState (and userSessionProperties is validated at\n * addProperty time), so a matching version means the blob came from this\n * code path and we trust the rest of its shape. v1, v2 and v3 blobs are upgraded.\n */\nconst toCurrentUserSessionState = (state: unknown): UserSessionState | null => {\n switch (storedSchemaVersion(state)) {\n case USER_SESSION_STATE_SCHEMA_VERSION:\n return state as UserSessionState;\n case 3:\n return upgradeV3UserSessionState(state as V3UserSessionState);\n case 2:\n return upgradeV2UserSessionState(state as V2UserSessionState);\n case 1:\n return upgradeV1UserSessionState(\n state as Omit<\n V2UserSessionState,\n 'replaySampled' | 'replayMetaVersion'\n >,\n );\n default:\n return null;\n }\n};\n\nexport const readUserSessionState = (\n storage: NamespacedStorage,\n diag: DiagLogger,\n): UserSessionState | null => {\n const raw = storage.getItem(MXL_USER_SESSION_STATE_KEY);\n if (!raw) {\n return null;\n }\n try {\n const state = toCurrentUserSessionState(JSON.parse(raw));\n if (!state) {\n throw new Error('stored user session state failed structural validation');\n }\n return state;\n } catch (error) {\n diag.error(\n 'User session state in storage is corrupt; discarding it',\n error,\n );\n storage.removeItem(MXL_USER_SESSION_STATE_KEY);\n return null;\n }\n};\n\nexport const readPermanentProperties = (\n storage: NamespacedStorage,\n diag: DiagLogger,\n): Record<string, string> => {\n const raw = storage.getItem(MXL_PERMANENT_PROPERTIES_KEY);\n if (!raw) {\n return {};\n }\n try {\n const parsed = JSON.parse(raw) as unknown;\n if (\n parsed === null ||\n typeof parsed !== 'object' ||\n Array.isArray(parsed)\n ) {\n throw new Error('permanent properties blob is not a plain object');\n }\n const validated: Record<string, string> = {};\n for (const [key, value] of Object.entries(parsed)) {\n if (typeof value === 'string') {\n validated[key] = value;\n }\n }\n return validated;\n } catch (error) {\n diag.error(\n 'Permanent properties in storage are corrupt; discarding',\n error,\n );\n storage.removeItem(MXL_PERMANENT_PROPERTIES_KEY);\n return {};\n }\n};\n\n/**\n * Empty blobs are removed rather than written so storage stays tidy when\n * the last property is cleared. Returns false on a failed write; callers\n * gate cross-scope flips on this so a failed permanent write doesn't\n * strip the previously-visible user-session-scoped value.\n */\nexport const storePermanentProperties = (\n storage: NamespacedStorage,\n properties: Record<string, string>,\n): boolean => {\n if (Object.keys(properties).length === 0) {\n return storage.removeItem(MXL_PERMANENT_PROPERTIES_KEY);\n }\n return storage.setItem(\n MXL_PERMANENT_PROPERTIES_KEY,\n JSON.stringify(properties),\n );\n};\n"],"mappings":";;;AAUA,MAAa,sBAAoC;CAC/C,QAAQ;CACR,QAAQ;CACR,WAAW;CACZ;;;;;;;;AASD,MAAa,wBACX,OACA,QAEA,MAAM,MAAM,sBACZ,OAAO,MAAM,uBACZ,MAAM,yBAAyB,QAAQ,OAAO,MAAM;AAWvD,MAAa,0BAA0B,EACrC,KACA,uBACA,+BACA,0BACA,oCACA,yBACmD;CACnD;CACA,sBAAsB;CACtB;CACA;CACA;CACA,cAAc;CACd,mBAAmB;CACnB,eAAe;CACf,eAAA;CACA,eAAe,cAAc;CAC7B,qBAAqB,MAAM,gCAAgC;CAC3D;CACA,sBAAsB;CACtB,uBAAuB,EAAE;CACzB,oBAAoB;CACrB;AAED,MAAM,uBAAuB,UAC3B,UAAU,QAAQ,OAAO,UAAU,WAC9B,MAAsC,gBACvC,KAAA;;AAUN,MAAM,6BACJ,WACsB;CACtB,GAAG;CACH,cAAc;CACd,eAAA;CACD;;;;;AAMD,MAAM,6BACJ,UAEA,0BAA0B;CACxB,GAAG;CACH,oCAAoC,MAAM;CAC3C,CAAC;;;;;AAMJ,MAAM,6BACJ,UAEA,0BAA0B;CACxB,GAAG;CACH,mBAAmB;CACnB,eAAe;CAChB,CAAC;;;;;;;AAQJ,MAAM,6BAA6B,UAA4C;AAC7E,SAAQ,oBAAoB,MAAM,EAAlC;EACE,KAAA,EACE,QAAO;EACT,KAAK,EACH,QAAO,0BAA0B,MAA4B;EAC/D,KAAK,EACH,QAAO,0BAA0B,MAA4B;EAC/D,KAAK,EACH,QAAO,0BACL,MAID;EACH,QACE,QAAO;;;AAIb,MAAa,wBACX,SACA,SAC4B;CAC5B,MAAM,MAAM,QAAQ,QAAQ,2BAA2B;AACvD,KAAI,CAAC,IACH,QAAO;AAET,KAAI;EACF,MAAM,QAAQ,0BAA0B,KAAK,MAAM,IAAI,CAAC;AACxD,MAAI,CAAC,MACH,OAAM,IAAI,MAAM,yDAAyD;AAE3E,SAAO;UACA,OAAO;AACd,OAAK,MACH,2DACA,MACD;AACD,UAAQ,WAAW,2BAA2B;AAC9C,SAAO;;;AAIX,MAAa,2BACX,SACA,SAC2B;CAC3B,MAAM,MAAM,QAAQ,QAAQ,6BAA6B;AACzD,KAAI,CAAC,IACH,QAAO,EAAE;AAEX,KAAI;EACF,MAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,MACE,WAAW,QACX,OAAO,WAAW,YAClB,MAAM,QAAQ,OAAO,CAErB,OAAM,IAAI,MAAM,kDAAkD;EAEpE,MAAM,YAAoC,EAAE;AAC5C,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,CAC/C,KAAI,OAAO,UAAU,SACnB,WAAU,OAAO;AAGrB,SAAO;UACA,OAAO;AACd,OAAK,MACH,2DACA,MACD;AACD,UAAQ,WAAW,6BAA6B;AAChD,SAAO,EAAE;;;;;;;;;AAUb,MAAa,4BACX,SACA,eACY;AACZ,KAAI,OAAO,KAAK,WAAW,CAAC,WAAW,EACrC,QAAO,QAAQ,WAAW,6BAA6B;AAEzD,QAAO,QAAQ,QACb,8BACA,KAAK,UAAU,WAAW,CAC3B"}
@@ -1,7 +1,7 @@
1
1
  Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
2
  const require_utils_generateUUID = require("../../../utils/generateUUID.cjs");
3
- const require_resources_appInstanceId = require("../../../resources/appInstanceId.cjs");
4
3
  const require_managers_MXLUserSessionManager_constants = require("../constants.cjs");
4
+ const require_resources_appInstanceId = require("../../../resources/appInstanceId.cjs");
5
5
  //#region src/managers/MXLUserSessionManager/utils/tabTracking.ts
6
6
  const processReferrer = (referrer) => {
7
7
  if (!referrer) return {
@@ -1,6 +1,6 @@
1
1
  import { generateUUID } from "../../../utils/generateUUID.js";
2
- import { getAppInstanceId } from "../../../resources/appInstanceId.js";
3
2
  import { MXL_TAB_ACTIVITY_STORAGE_KEY, MXL_TAB_STORAGE_KEY } from "../constants.js";
3
+ import { getAppInstanceId } from "../../../resources/appInstanceId.js";
4
4
  //#region src/managers/MXLUserSessionManager/utils/tabTracking.ts
5
5
  const processReferrer = (referrer) => {
6
6
  if (!referrer) return {