@qbix/q.js 1.0.6 → 1.0.8

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.
package/dist/Metrics.js CHANGED
@@ -19,6 +19,12 @@ Metrics._visitorKey = 'metrics_vid';
19
19
  Metrics._sid = null;
20
20
  Metrics._vid = null;
21
21
 
22
+ /**
23
+ * Get or create a per-tab session ID (sessionStorage).
24
+ * A new ID is generated for each browser tab.
25
+ * @method getSessionId
26
+ * @return {String} The session ID
27
+ */
22
28
  Metrics.getSessionId = function () {
23
29
  if (Metrics._sid) return Metrics._sid;
24
30
  try {
@@ -38,20 +44,14 @@ Metrics.getSessionId = function () {
38
44
  * Get or create a persistent visitor ID that survives across sessions.
39
45
  * Tries localStorage first (persists until cleared).
40
46
  * Falls back to sessionStorage (ITP-safe, but per-tab only).
41
- * Either way, ITP won't block it both are first-party storage
42
- * when the script runs on the page's own domain.
43
- * When loaded cross-origin (e.g. from invites.to CDN onto
44
- * summerfest.com), localStorage may be partitioned by Safari's
45
- * ITP — meaning the same visitor gets different vids on different
46
- * sites. This is fine: the inv_token from the redirect query
47
- * string is what links visits across domains, not the vid.
47
+ * When loaded cross-origin (e.g. from a CDN), localStorage is still
48
+ * first-party to the page's domain ITP won't block it.
48
49
  * @method getVisitorId
49
- * @return {String}
50
+ * @return {String} The visitor ID
50
51
  */
51
52
  Metrics.getVisitorId = function () {
52
53
  if (Metrics._vid) return Metrics._vid;
53
54
  var vid = null;
54
- // Try localStorage first (persistent)
55
55
  try {
56
56
  vid = localStorage.getItem(Metrics._visitorKey);
57
57
  if (!vid) {
@@ -61,8 +61,7 @@ Metrics.getVisitorId = function () {
61
61
  }
62
62
  Metrics._vid = vid;
63
63
  return vid;
64
- } catch (e) { /* localStorage blocked or full */ }
65
- // Fall back to sessionStorage
64
+ } catch (e) {}
66
65
  try {
67
66
  vid = sessionStorage.getItem(Metrics._visitorKey);
68
67
  if (!vid) {
@@ -72,8 +71,7 @@ Metrics.getVisitorId = function () {
72
71
  }
73
72
  Metrics._vid = vid;
74
73
  return vid;
75
- } catch (e) { /* sessionStorage blocked */ }
76
- // Last resort: in-memory only (won't survive page reload)
74
+ } catch (e) {}
77
75
  vid = Math.random().toString(36).slice(2) + Date.now().toString(36)
78
76
  + Math.random().toString(36).slice(2);
79
77
  Metrics._vid = vid;
@@ -82,6 +80,7 @@ Metrics.getVisitorId = function () {
82
80
 
83
81
  // ── Transport (standalone — overridden by Q integration below) ──
84
82
 
83
+ Metrics._defaultEndpoint = 'https://invites.to/metrics';
85
84
  Metrics._endpoint = null;
86
85
  Metrics._page = null;
87
86
  Metrics._extra = null;
@@ -102,6 +101,7 @@ Metrics.send = function (label, data) {
102
101
  session: Metrics.getSessionId(),
103
102
  visitor: Metrics.getVisitorId(),
104
103
  origin: location.origin,
104
+ url: location.pathname + location.search + location.hash,
105
105
  page: Metrics._page || document.title,
106
106
  label: label,
107
107
  t: Date.now()
@@ -251,8 +251,6 @@ function _sendUnload() {
251
251
  * @param {Object} [options.extra] — extra data with every event
252
252
  * @param {Boolean} [options.trackUnload=true] — send unload beacon
253
253
  */
254
- Metrics._defaultEndpoint = 'https://invites.to/metrics';
255
-
256
254
  Metrics.init = function (options) {
257
255
  options = options || {};
258
256
  Metrics._endpoint = options.endpoint || Metrics._defaultEndpoint;
@@ -266,7 +264,27 @@ Metrics.init = function (options) {
266
264
  _bindUnload();
267
265
  }
268
266
 
269
- Metrics.send('loaded');
267
+ // Context snapshot — sent once with the "loaded" event
268
+ var ctx = {
269
+ referrer: document.referrer || '',
270
+ screen: screen.width + 'x' + screen.height,
271
+ viewport: window.innerWidth + 'x' + window.innerHeight,
272
+ dpr: window.devicePixelRatio || 1,
273
+ lang: navigator.language || '',
274
+ touch: ('ontouchstart' in window) || (navigator.maxTouchPoints > 0)
275
+ };
276
+ try { ctx.tz = Intl.DateTimeFormat().resolvedOptions().timeZone; } catch (e) {}
277
+ try {
278
+ if (navigator.connection && navigator.connection.effectiveType) {
279
+ ctx.conn = navigator.connection.effectiveType;
280
+ }
281
+ } catch (e) {}
282
+ try {
283
+ var nav = performance.getEntriesByType('navigation');
284
+ if (nav && nav[0]) ctx.navType = nav[0].type;
285
+ } catch (e) {}
286
+
287
+ Metrics.send('loaded', ctx);
270
288
  return Metrics;
271
289
  };
272
290
 
@@ -866,2347 +884,6 @@ Metrics.ScrollTracker = {
866
884
 
867
885
  })(typeof window !== 'undefined' ? window : this);
868
886
 
869
- /**
870
- * Metrics.ScrollTracker — Section-aware scroll telemetry
871
- *
872
- * Tracks which sections a user reads, how far they scroll,
873
- * and what they click. Delegates transport, session, visibility,
874
- * and unload handling to the core Metrics object.
875
- *
876
- * Usage (standalone):
877
- * Metrics.init({ endpoint: '/telemetry.php', page: 'My Page' });
878
- * Metrics.ScrollTracker.init({
879
- * sections: 'h2[id], h3[id]',
880
- * debounce: 1000
881
- * });
882
- *
883
- * Usage (with Q framework):
884
- * // Auto-initializes from config if endpoint is set
885
- *
886
- * @module Metrics
887
- * @class Metrics.ScrollTracker
888
- */
889
- "use strict";
890
- (function (root) {
891
-
892
- var Metrics = root.Metrics;
893
- if (!Metrics) {
894
- console.warn('Metrics.ScrollTracker: Metrics core not loaded');
895
- return;
896
- }
897
-
898
- var defaults = {
899
- // CSS selector for sections to track
900
- sections: 'h2[id], h3[id], section[id], [data-section]',
901
-
902
- // Minimum pixel height for auto-detected containers
903
- minSectionHeight: 100,
904
-
905
- // Milliseconds to wait after scroll stops before firing
906
- debounce: 1000,
907
-
908
- // Milliseconds to wait on page load (ignores scroll restoration)
909
- initDelay: 800,
910
-
911
- // Milliseconds to suppress tracking after anchor click
912
- anchorCooldown: 1500,
913
-
914
- // Scroll depth milestones (percentage)
915
- depthMilestones: [25, 50, 75, 100],
916
-
917
- // Max px above viewport top to consider a section "current"
918
- sectionLookback: 300,
919
-
920
- // Scroll considered settled if moved less than this (px)
921
- settleTolerance: 2,
922
-
923
- // Recheck interval when not settled (ms)
924
- recheckInterval: 500,
925
-
926
- // Track link/anchor clicks
927
- trackClicks: true,
928
-
929
- // Visual TOC highlighting selector (real-time, not debounced)
930
- tocSelector: null,
931
- tocActiveClass: 'active',
932
- tocSectionSelector: 'h2[id]'
933
- };
934
-
935
- // ── State ──
936
- var state = {
937
- initialized: false,
938
- options: null,
939
- sections: [],
940
- tocSections: [],
941
- seen: {},
942
- depthHit: {},
943
- scrollTimer: null,
944
- anchorCooling: false,
945
- _prevY: -1
946
- };
947
-
948
- // ── Section Discovery ──
949
-
950
- function discoverSections(selector) {
951
- var elements = document.querySelectorAll(selector);
952
- var result = [];
953
- var ordinal = 0;
954
- var minH = (state.options && state.options.minSectionHeight) || 0;
955
-
956
- for (var i = 0; i < elements.length; i++) {
957
- var el = elements[i];
958
- if (el.offsetHeight < minH) continue;
959
-
960
- if (!el.id) {
961
- var text = (el.textContent || '').trim().slice(0, 60);
962
- var slug = text.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
963
- el.id = slug || ('section-' + ordinal);
964
- }
965
-
966
- result.push({
967
- el: el,
968
- id: el.id,
969
- tag: el.tagName.toLowerCase(),
970
- ordinal: ordinal++,
971
- snippet: (el.textContent || '').trim().slice(0, 80)
972
- });
973
- }
974
- return result;
975
- }
976
-
977
- // ── Find Current Section ──
978
-
979
- function findCurrentSection() {
980
- var scrollY = window.scrollY || window.pageYOffset;
981
- var opts = state.options;
982
- var best = null;
983
- var bestDist = Infinity;
984
-
985
- for (var i = 0; i < state.sections.length; i++) {
986
- var sec = state.sections[i];
987
- var top = sec.el.offsetTop;
988
- if (top <= scrollY + opts.sectionLookback) {
989
- var dist = Math.abs(top - scrollY - 180);
990
- if (dist < bestDist) {
991
- bestDist = dist;
992
- best = sec;
993
- }
994
- }
995
- }
996
- return best;
997
- }
998
-
999
- // ── Scroll Settle Detection ──
1000
-
1001
- function onScrollSettle() {
1002
- var opts = state.options;
1003
- var curY = window.scrollY || window.pageYOffset;
1004
-
1005
- if (Math.abs(curY - state._prevY) > opts.settleTolerance) {
1006
- state._prevY = curY;
1007
- state.scrollTimer = setTimeout(onScrollSettle, opts.recheckInterval);
1008
- return;
1009
- }
1010
-
1011
- // Settled — report section
1012
- var current = findCurrentSection();
1013
- if (current && !state.seen[current.id]) {
1014
- state.seen[current.id] = true;
1015
- Metrics.send('section:' + current.id, {
1016
- tag: current.tag,
1017
- ordinal: current.ordinal,
1018
- snippet: current.snippet
1019
- });
1020
- }
1021
-
1022
- // Report depth
1023
- var docH = document.documentElement.scrollHeight - window.innerHeight;
1024
- if (docH > 0) {
1025
- var pct = Math.round((curY / docH) * 100);
1026
- for (var j = 0; j < opts.depthMilestones.length; j++) {
1027
- var m = opts.depthMilestones[j];
1028
- if (pct >= m && !state.depthHit[m]) {
1029
- state.depthHit[m] = true;
1030
- Metrics.send('depth:' + m + '%');
1031
- }
1032
- }
1033
- }
1034
- }
1035
-
1036
- function onScroll() {
1037
- if (state.anchorCooling) return;
1038
- clearTimeout(state.scrollTimer);
1039
- state._prevY = window.scrollY || window.pageYOffset;
1040
- state.scrollTimer = setTimeout(onScrollSettle, state.options.debounce);
1041
- }
1042
-
1043
- // ── TOC Highlighting (real-time) ──
1044
-
1045
- function updateTocHighlight() {
1046
- var opts = state.options;
1047
- if (!opts.tocSelector) return;
1048
-
1049
- var scrollY = window.scrollY || window.pageYOffset;
1050
- var currentId = '';
1051
-
1052
- for (var i = 0; i < state.tocSections.length; i++) {
1053
- if (scrollY >= state.tocSections[i].el.offsetTop - 160) {
1054
- currentId = state.tocSections[i].id;
1055
- }
1056
- }
1057
-
1058
- var links = document.querySelectorAll(opts.tocSelector);
1059
- for (var j = 0; j < links.length; j++) {
1060
- links[j].classList.remove(opts.tocActiveClass);
1061
- if (links[j].getAttribute('href') === '#' + currentId) {
1062
- links[j].classList.add(opts.tocActiveClass);
1063
- }
1064
- }
1065
- }
1066
-
1067
- // ── Click Tracking ──
1068
-
1069
- function onDocumentClick(e) {
1070
- var a = e.target.closest('a[href]');
1071
- if (!a) return;
1072
-
1073
- var href = a.getAttribute('href') || '';
1074
-
1075
- if (href.charAt(0) === '#') {
1076
- // Anchor click — cooldown to suppress scroll tracking
1077
- state.anchorCooling = true;
1078
- setTimeout(function () { state.anchorCooling = false; },
1079
- state.options.anchorCooldown);
1080
- Metrics.send('anchor:' + href.slice(1));
1081
- return;
1082
- }
1083
-
1084
- // External link
1085
- var label = a.dataset.track || 'link:' + href;
1086
- Metrics.send(label);
1087
- }
1088
-
1089
- // ── Pre-mark Initial State ──
1090
-
1091
- function premarkInitialState() {
1092
- var scrollY = window.scrollY || window.pageYOffset;
1093
-
1094
- for (var i = 0; i < state.sections.length; i++) {
1095
- var rect = state.sections[i].el.getBoundingClientRect();
1096
- if (rect.top >= -100 && rect.top < window.innerHeight) {
1097
- state.seen[state.sections[i].id] = true;
1098
- }
1099
- }
1100
-
1101
- var docH = document.documentElement.scrollHeight - window.innerHeight;
1102
- if (docH > 0) {
1103
- var pct = Math.round((scrollY / docH) * 100);
1104
- for (var j = 0; j < state.options.depthMilestones.length; j++) {
1105
- var m = state.options.depthMilestones[j];
1106
- if (pct >= m) state.depthHit[m] = true;
1107
- }
1108
- }
1109
- }
1110
-
1111
- // ── Public API ──
1112
-
1113
- Metrics.ScrollTracker = {
1114
-
1115
- init: function (options) {
1116
- if (state.initialized) {
1117
- console.warn('Metrics.ScrollTracker already initialized');
1118
- return this;
1119
- }
1120
-
1121
- var opts = {};
1122
- var k;
1123
- for (k in defaults) { if (defaults.hasOwnProperty(k)) opts[k] = defaults[k]; }
1124
- for (k in (options || {})) { if (options.hasOwnProperty(k) && options[k] !== undefined) opts[k] = options[k]; }
1125
- state.options = opts;
1126
- state.initialized = true;
1127
-
1128
- // If Metrics core hasn't been initialized yet with an endpoint,
1129
- // initialize it now from our options
1130
- if (!Metrics._endpoint && options && options.endpoint) {
1131
- Metrics.init({
1132
- endpoint: options.endpoint,
1133
- page: options.page,
1134
- sessionKey: options.sessionKey,
1135
- sessionId: options.sessionId,
1136
- extra: options.extra,
1137
- trackUnload: options.trackUnload
1138
- });
1139
- }
1140
-
1141
- // Delayed init — let scroll restoration settle
1142
- setTimeout(function () {
1143
- state.sections = discoverSections(opts.sections);
1144
-
1145
- if (opts.tocSelector && opts.tocSectionSelector) {
1146
- state.tocSections = discoverSections(opts.tocSectionSelector);
1147
- }
1148
-
1149
- premarkInitialState();
1150
-
1151
- window.addEventListener('scroll', onScroll, { passive: true });
1152
-
1153
- if (opts.tocSelector) {
1154
- window.addEventListener('scroll', updateTocHighlight, { passive: true });
1155
- updateTocHighlight();
1156
- }
1157
- }, opts.initDelay);
1158
-
1159
- if (opts.trackClicks) {
1160
- document.addEventListener('click', onDocumentClick);
1161
- }
1162
-
1163
- return this;
1164
- },
1165
-
1166
- send: function (label, data) { Metrics.send(label, data); },
1167
- markSeen: function (id) { state.seen[id] = true; },
1168
- getSessionId: function () { return Metrics.getSessionId(); },
1169
- getSections: function () {
1170
- return state.sections.map(function (s) {
1171
- return { id: s.id, tag: s.tag, ordinal: s.ordinal, snippet: s.snippet };
1172
- });
1173
- },
1174
- getSeen: function () {
1175
- var copy = {};
1176
- for (var k in state.seen) copy[k] = true;
1177
- return copy;
1178
- },
1179
- reset: function () {
1180
- state.seen = {};
1181
- state.depthHit = {};
1182
- state.anchorCooling = false;
1183
- clearTimeout(state.scrollTimer);
1184
- state.sections = discoverSections(state.options.sections);
1185
- premarkInitialState();
1186
- },
1187
- destroy: function () {
1188
- window.removeEventListener('scroll', onScroll);
1189
- window.removeEventListener('scroll', updateTocHighlight);
1190
- document.removeEventListener('click', onDocumentClick);
1191
- clearTimeout(state.scrollTimer);
1192
- state.initialized = false;
1193
- },
1194
-
1195
- defaults: defaults,
1196
- state: state
1197
- };
1198
-
1199
- })(typeof window !== 'undefined' ? window : this);
1200
-
1201
- /**
1202
- * Metrics.NavigationTracker — Track how users navigate and explore content
1203
- *
1204
- * Tracks scroll-based sections, dynamic panels (tabs, columns, expandables,
1205
- * contextual menus), and links that scroll into view in navigation containers.
1206
- * Delegates transport, session, visibility, and unload to Metrics core.
1207
- *
1208
- * Event prefixes:
1209
- * section:id — scroll-based section reached viewport
1210
- * depth:N% — scroll depth milestone
1211
- * anchor:id — clicked an anchor link
1212
- * link:url — clicked an external link
1213
- * tab:name — tab switched to
1214
- * column:name — column opened/closed
1215
- * expandable:id — expandable opened/closed
1216
- * contextual:id — contextual menu shown/hidden
1217
- * contextual-item:action — item selected from contextual menu
1218
- * nav-link:id — link scrolled into view in a nav container
1219
- * opened:prefix:id — first time viewing a dynamic section
1220
- * switched:prefix:id — returned to previously viewed section
1221
- * dwell:prefix:id — time spent in a dynamic section
1222
- *
1223
- * @module Metrics
1224
- * @class Metrics.NavigationTracker
1225
- */
1226
- "use strict";
1227
- (function (root) {
1228
-
1229
- var Metrics = root.Metrics;
1230
- if (!Metrics) {
1231
- console.warn('Metrics.NavigationTracker: Metrics core not loaded');
1232
- return;
1233
- }
1234
-
1235
- var defaults = {
1236
- // ── Scroll-based section tracking ──
1237
- sections: 'h2[id], h3[id], section[id], [data-section]',
1238
- minSectionHeight: 100,
1239
- debounce: 1000,
1240
- initDelay: 800,
1241
- anchorCooldown: 1500,
1242
- depthMilestones: [25, 50, 75, 100],
1243
- sectionLookback: 300,
1244
- settleTolerance: 2,
1245
- recheckInterval: 500,
1246
-
1247
- // ── Dynamic section tracking ──
1248
- observeDom: false,
1249
- observeRoot: null,
1250
- observeSelector: '[data-section], [data-track-section]',
1251
- trackDwell: true,
1252
-
1253
- // ── Navigation container link tracking ──
1254
- // CSS selector for scrollable nav containers whose links should be
1255
- // tracked as they scroll into view
1256
- navContainers: null, // e.g. '.Q_listing_wrapper, .sidebar-nav'
1257
-
1258
- // ── Contextual menu tracking ──
1259
- trackContextuals: true,
1260
-
1261
- // ── Click & TOC ──
1262
- trackClicks: true,
1263
- tocSelector: null,
1264
- tocActiveClass: 'active',
1265
- tocSectionSelector: 'h2[id]'
1266
- };
1267
-
1268
- // ── State ──
1269
- var state = {
1270
- initialized: false,
1271
- options: null,
1272
- sections: [],
1273
- tocSections: [],
1274
- seen: {},
1275
- depthHit: {},
1276
- scrollTimer: null,
1277
- anchorCooling: false,
1278
- _prevY: -1,
1279
- // Dynamic sections
1280
- dynamicSections: {},
1281
- activeSection: null,
1282
- activeSince: null,
1283
- // DOM observer
1284
- _mutationObserver: null,
1285
- // Nav container observers
1286
- _navObservers: [],
1287
- _navLinksSeen: {}
1288
- };
1289
-
1290
- // ── Utilities ──
1291
-
1292
- function slugify(text) {
1293
- return text.toLowerCase()
1294
- .replace(/[^a-z0-9]+/g, '-')
1295
- .replace(/^-|-$/g, '')
1296
- .slice(0, 60);
1297
- }
1298
-
1299
- function snippet(el) {
1300
- return (el.textContent || '').trim().slice(0, 80);
1301
- }
1302
-
1303
- function now() { return Date.now(); }
1304
-
1305
- // ── Section Discovery ──
1306
-
1307
- function discoverSections(selector) {
1308
- var elements = document.querySelectorAll(selector);
1309
- var result = [];
1310
- var ordinal = 0;
1311
- var minH = (state.options && state.options.minSectionHeight) || 0;
1312
- for (var i = 0; i < elements.length; i++) {
1313
- var el = elements[i];
1314
- if (el.offsetHeight < minH) continue;
1315
- if (!el.id) {
1316
- el.id = slugify(el.textContent || '') || ('section-' + ordinal);
1317
- }
1318
- result.push({
1319
- el: el, id: el.id,
1320
- tag: el.tagName.toLowerCase(),
1321
- ordinal: ordinal++,
1322
- snippet: snippet(el)
1323
- });
1324
- }
1325
- return result;
1326
- }
1327
-
1328
- // ── Find Current Section ──
1329
-
1330
- function findCurrentSection() {
1331
- var scrollY = window.scrollY || window.pageYOffset;
1332
- var opts = state.options;
1333
- var best = null, bestDist = Infinity;
1334
- for (var i = 0; i < state.sections.length; i++) {
1335
- var sec = state.sections[i];
1336
- var top = sec.el.offsetTop;
1337
- if (top <= scrollY + opts.sectionLookback) {
1338
- var dist = Math.abs(top - scrollY - 180);
1339
- if (dist < bestDist) { bestDist = dist; best = sec; }
1340
- }
1341
- }
1342
- return best;
1343
- }
1344
-
1345
- // ── Scroll Settle ──
1346
-
1347
- function onScrollSettle() {
1348
- var opts = state.options;
1349
- var curY = window.scrollY || window.pageYOffset;
1350
- if (Math.abs(curY - state._prevY) > opts.settleTolerance) {
1351
- state._prevY = curY;
1352
- state.scrollTimer = setTimeout(onScrollSettle, opts.recheckInterval);
1353
- return;
1354
- }
1355
- var current = findCurrentSection();
1356
- if (current && !state.seen[current.id]) {
1357
- state.seen[current.id] = true;
1358
- Metrics.send('section:' + current.id, {
1359
- tag: current.tag, ordinal: current.ordinal, snippet: current.snippet
1360
- });
1361
- }
1362
- var docH = document.documentElement.scrollHeight - window.innerHeight;
1363
- if (docH > 0) {
1364
- var pct = Math.round((curY / docH) * 100);
1365
- for (var j = 0; j < opts.depthMilestones.length; j++) {
1366
- var m = opts.depthMilestones[j];
1367
- if (pct >= m && !state.depthHit[m]) {
1368
- state.depthHit[m] = true;
1369
- Metrics.send('depth:' + m + '%');
1370
- }
1371
- }
1372
- }
1373
- }
1374
-
1375
- function onScroll() {
1376
- if (state.anchorCooling) return;
1377
- clearTimeout(state.scrollTimer);
1378
- state._prevY = window.scrollY || window.pageYOffset;
1379
- state.scrollTimer = setTimeout(onScrollSettle, state.options.debounce);
1380
- }
1381
-
1382
- // ── TOC Highlighting ──
1383
-
1384
- function updateTocHighlight() {
1385
- var opts = state.options;
1386
- if (!opts.tocSelector) return;
1387
- var scrollY = window.scrollY || window.pageYOffset;
1388
- var currentId = '';
1389
- for (var i = 0; i < state.tocSections.length; i++) {
1390
- if (scrollY >= state.tocSections[i].el.offsetTop - 160) {
1391
- currentId = state.tocSections[i].id;
1392
- }
1393
- }
1394
- var links = document.querySelectorAll(opts.tocSelector);
1395
- for (var j = 0; j < links.length; j++) {
1396
- links[j].classList.remove(opts.tocActiveClass);
1397
- if (links[j].getAttribute('href') === '#' + currentId) {
1398
- links[j].classList.add(opts.tocActiveClass);
1399
- }
1400
- }
1401
- }
1402
-
1403
- // ── Click Tracking ──
1404
-
1405
- function onDocumentClick(e) {
1406
- var a = e.target.closest('a[href]');
1407
- if (!a) return;
1408
- var href = a.getAttribute('href') || '';
1409
- if (href.charAt(0) === '#') {
1410
- state.anchorCooling = true;
1411
- setTimeout(function () { state.anchorCooling = false; },
1412
- state.options.anchorCooldown);
1413
- Metrics.send('anchor:' + href.slice(1));
1414
- return;
1415
- }
1416
- var label = a.dataset.track || 'link:' + href;
1417
- Metrics.send(label);
1418
- }
1419
-
1420
- // ── Dynamic Section Tracking ──
1421
-
1422
- function _closeCurrent() {
1423
- if (!state.activeSection || !state.options.trackDwell) return;
1424
- var elapsed = Math.round((now() - state.activeSince) / 1000);
1425
- if (elapsed > 0) {
1426
- var sec = state.dynamicSections[state.activeSection];
1427
- Metrics.send('dwell:' + state.activeSection, {
1428
- seconds: elapsed,
1429
- name: sec ? sec.name : state.activeSection
1430
- });
1431
- }
1432
- state.activeSection = null;
1433
- state.activeSince = null;
1434
- }
1435
-
1436
- function _observeElement(el, opts) {
1437
- var id = opts.id || el.id || el.getAttribute('data-section')
1438
- || el.getAttribute('data-track-section')
1439
- || slugify(el.textContent || '') || ('dyn-' + Object.keys(state.dynamicSections).length);
1440
- if (!el.id) el.id = id;
1441
- state.dynamicSections[id] = {
1442
- el: el, id: id,
1443
- name: opts.name || el.getAttribute('data-section-name') || el.getAttribute('title') || id,
1444
- snippet: snippet(el), observedAt: now()
1445
- };
1446
- if (window.IntersectionObserver && opts.autoTrack !== false) {
1447
- var io = new IntersectionObserver(function (entries) {
1448
- entries.forEach(function (entry) {
1449
- if (entry.isIntersecting && entry.intersectionRatio > 0.3) {
1450
- NT.opened(id);
1451
- } else if (!entry.isIntersecting && state.activeSection === id) {
1452
- NT.closed(id);
1453
- }
1454
- });
1455
- }, { threshold: [0, 0.3] });
1456
- io.observe(el);
1457
- state.dynamicSections[id]._io = io;
1458
- }
1459
- return id;
1460
- }
1461
-
1462
- // ── Nav Container Link Tracking ──
1463
- // Watches scrollable navigation containers and fires 'nav-link:' events
1464
- // when links scroll into view (like contextual menu items, sidebar nav, etc.)
1465
-
1466
- function _setupNavContainerTracking() {
1467
- var selector = state.options.navContainers;
1468
- if (!selector || !window.IntersectionObserver) return;
1469
-
1470
- var containers = document.querySelectorAll(selector);
1471
- for (var c = 0; c < containers.length; c++) {
1472
- _observeNavContainer(containers[c]);
1473
- }
1474
- }
1475
-
1476
- function _observeNavContainer(container) {
1477
- var links = container.querySelectorAll('a[href], li[data-action], li[data-name]');
1478
- if (!links.length) return;
1479
-
1480
- var io = new IntersectionObserver(function (entries) {
1481
- entries.forEach(function (entry) {
1482
- if (!entry.isIntersecting) return;
1483
- var el = entry.target;
1484
- var linkId = el.getAttribute('data-name')
1485
- || el.getAttribute('data-action')
1486
- || el.getAttribute('href')
1487
- || el.textContent.trim().slice(0, 40);
1488
- var key = 'nav-link:' + linkId;
1489
- if (!state._navLinksSeen[key]) {
1490
- state._navLinksSeen[key] = true;
1491
- Metrics.send(key, { text: el.textContent.trim().slice(0, 60) });
1492
- }
1493
- });
1494
- }, {
1495
- root: container,
1496
- threshold: 0.5
1497
- });
1498
-
1499
- for (var i = 0; i < links.length; i++) {
1500
- io.observe(links[i]);
1501
- }
1502
- state._navObservers.push(io);
1503
- }
1504
-
1505
- // ── DOM Mutation Observer ──
1506
-
1507
- function _startMutationObserver() {
1508
- if (!window.MutationObserver || !state.options.observeDom) return;
1509
- var root = state.options.observeRoot || document.body;
1510
- var selector = state.options.observeSelector;
1511
- state._mutationObserver = new MutationObserver(function (mutations) {
1512
- mutations.forEach(function (mutation) {
1513
- mutation.addedNodes.forEach(function (node) {
1514
- if (node.nodeType !== 1) return;
1515
- if (node.matches && node.matches(selector)) {
1516
- _observeElement(node, {});
1517
- }
1518
- if (node.querySelectorAll) {
1519
- var matches = node.querySelectorAll(selector);
1520
- for (var i = 0; i < matches.length; i++) {
1521
- _observeElement(matches[i], {});
1522
- }
1523
- }
1524
- });
1525
- });
1526
- });
1527
- state._mutationObserver.observe(root, { childList: true, subtree: true });
1528
- }
1529
-
1530
- // ── Pre-mark Initial State ──
1531
-
1532
- function premarkInitialState() {
1533
- var scrollY = window.scrollY || window.pageYOffset;
1534
- for (var i = 0; i < state.sections.length; i++) {
1535
- var rect = state.sections[i].el.getBoundingClientRect();
1536
- if (rect.top >= -100 && rect.top < window.innerHeight) {
1537
- state.seen[state.sections[i].id] = true;
1538
- }
1539
- }
1540
- var docH = document.documentElement.scrollHeight - window.innerHeight;
1541
- if (docH > 0) {
1542
- var pct = Math.round((scrollY / docH) * 100);
1543
- for (var j = 0; j < state.options.depthMilestones.length; j++) {
1544
- var m = state.options.depthMilestones[j];
1545
- if (pct >= m) state.depthHit[m] = true;
1546
- }
1547
- }
1548
- }
1549
-
1550
- // ── Public API ──
1551
-
1552
- var NT = {
1553
-
1554
- init: function (options) {
1555
- if (state.initialized) {
1556
- console.warn('Metrics.NavigationTracker already initialized');
1557
- return this;
1558
- }
1559
- var opts = {};
1560
- var k;
1561
- for (k in defaults) { if (defaults.hasOwnProperty(k)) opts[k] = defaults[k]; }
1562
- for (k in (options || {})) { if (options.hasOwnProperty(k) && options[k] !== undefined) opts[k] = options[k]; }
1563
- state.options = opts;
1564
- state.initialized = true;
1565
-
1566
- if (!Metrics._endpoint && options && options.endpoint) {
1567
- Metrics.init({
1568
- endpoint: options.endpoint, page: options.page,
1569
- sessionKey: options.sessionKey, sessionId: options.sessionId,
1570
- extra: options.extra, trackUnload: options.trackUnload
1571
- });
1572
- }
1573
-
1574
- // Delayed init
1575
- setTimeout(function () {
1576
- state.sections = discoverSections(opts.sections);
1577
- if (opts.tocSelector && opts.tocSectionSelector) {
1578
- state.tocSections = discoverSections(opts.tocSectionSelector);
1579
- }
1580
- premarkInitialState();
1581
- window.addEventListener('scroll', onScroll, { passive: true });
1582
- if (opts.tocSelector) {
1583
- window.addEventListener('scroll', updateTocHighlight, { passive: true });
1584
- updateTocHighlight();
1585
- }
1586
- if (opts.observeDom) _startMutationObserver();
1587
- if (opts.navContainers) _setupNavContainerTracking();
1588
- }, opts.initDelay);
1589
-
1590
- if (opts.trackClicks) {
1591
- document.addEventListener('click', onDocumentClick);
1592
- }
1593
-
1594
- if (opts.trackDwell) {
1595
- Metrics.onVisibilityChange(function (visible) {
1596
- if (!visible) _closeCurrent();
1597
- }, 'NavigationTracker.dwell');
1598
- }
1599
-
1600
- return this;
1601
- },
1602
-
1603
- /**
1604
- * Observe a dynamic element as a trackable section
1605
- */
1606
- observe: function (el, opts) {
1607
- return _observeElement(el, opts || {});
1608
- },
1609
-
1610
- /**
1611
- * Signal a section/panel/tab/contextual was opened or switched to
1612
- */
1613
- opened: function (id) {
1614
- if (state.activeSection === id) return;
1615
- _closeCurrent();
1616
- state.activeSection = id;
1617
- state.activeSince = now();
1618
- if (!state.seen[id]) {
1619
- state.seen[id] = true;
1620
- var sec = state.dynamicSections[id];
1621
- Metrics.send('opened:' + id, {
1622
- name: sec ? sec.name : id,
1623
- snippet: sec ? sec.snippet : ''
1624
- });
1625
- } else {
1626
- Metrics.send('switched:' + id, {
1627
- name: (state.dynamicSections[id] || {}).name || id
1628
- });
1629
- }
1630
- },
1631
-
1632
- /**
1633
- * Signal a section/panel/tab/contextual was closed
1634
- */
1635
- closed: function (id) {
1636
- if (state.activeSection !== id) return;
1637
- _closeCurrent();
1638
- },
1639
-
1640
- /**
1641
- * Track a navigation container — observe its links scrolling into view
1642
- */
1643
- observeNavContainer: function (container) {
1644
- _observeNavContainer(container);
1645
- },
1646
-
1647
- send: function (label, data) { Metrics.send(label, data); },
1648
- markSeen: function (id) { state.seen[id] = true; },
1649
- getSessionId: function () { return Metrics.getSessionId(); },
1650
- getSections: function () {
1651
- return state.sections.map(function (s) {
1652
- return { id: s.id, tag: s.tag, ordinal: s.ordinal, snippet: s.snippet };
1653
- });
1654
- },
1655
- getDynamicSections: function () {
1656
- var result = {};
1657
- for (var id in state.dynamicSections) {
1658
- var s = state.dynamicSections[id];
1659
- result[id] = { id: s.id, name: s.name, snippet: s.snippet };
1660
- }
1661
- return result;
1662
- },
1663
- getSeen: function () {
1664
- var copy = {};
1665
- for (var k in state.seen) copy[k] = true;
1666
- return copy;
1667
- },
1668
- getActive: function () {
1669
- if (!state.activeSection) return null;
1670
- return {
1671
- id: state.activeSection,
1672
- since: state.activeSince,
1673
- elapsed: Math.round((now() - state.activeSince) / 1000)
1674
- };
1675
- },
1676
- reset: function () {
1677
- _closeCurrent();
1678
- state.seen = {};
1679
- state.depthHit = {};
1680
- state.anchorCooling = false;
1681
- state._navLinksSeen = {};
1682
- clearTimeout(state.scrollTimer);
1683
- for (var id in state.dynamicSections) {
1684
- if (state.dynamicSections[id]._io) state.dynamicSections[id]._io.disconnect();
1685
- }
1686
- state.dynamicSections = {};
1687
- state.activeSection = null;
1688
- state.activeSince = null;
1689
- state.sections = discoverSections(state.options.sections);
1690
- premarkInitialState();
1691
- },
1692
- destroy: function () {
1693
- _closeCurrent();
1694
- window.removeEventListener('scroll', onScroll);
1695
- window.removeEventListener('scroll', updateTocHighlight);
1696
- document.removeEventListener('click', onDocumentClick);
1697
- clearTimeout(state.scrollTimer);
1698
- if (state._mutationObserver) {
1699
- state._mutationObserver.disconnect();
1700
- state._mutationObserver = null;
1701
- }
1702
- for (var id in state.dynamicSections) {
1703
- if (state.dynamicSections[id]._io) state.dynamicSections[id]._io.disconnect();
1704
- }
1705
- for (var n = 0; n < state._navObservers.length; n++) {
1706
- state._navObservers[n].disconnect();
1707
- }
1708
- state._navObservers = [];
1709
- state.initialized = false;
1710
- },
1711
-
1712
- defaults: defaults,
1713
- state: state
1714
- };
1715
-
1716
- Metrics.NavigationTracker = NT;
1717
- // Backward compat aliases
1718
- Metrics.SectionTracker = NT;
1719
- Metrics.ScrollTracker = NT;
1720
-
1721
- })(typeof window !== 'undefined' ? window : this);
1722
-
1723
- /**
1724
- * Metrics.MediaTracker — Track video/audio engagement
1725
- *
1726
- * Auto-discovers native <video>/<audio> elements and YouTube/Vimeo
1727
- * iframes. Hooks into play/pause/seek/ended events and sends
1728
- * periodic checkpoints during playback.
1729
- *
1730
- * Events:
1731
- * media-play:id — playback started
1732
- * media-pause:id — playback paused
1733
- * media-checkpoint:id — periodic position update during playback
1734
- * media-ended:id — reached the end
1735
- * media-seeked:id — user jumped to a position
1736
- *
1737
- * Usage:
1738
- * Metrics.init({ endpoint: '/telemetry.php' });
1739
- * Metrics.MediaTracker.init({
1740
- * checkpointInterval: 10, // seconds
1741
- * reloadIframes: false // don't reload to inject API params
1742
- * });
1743
- *
1744
- * @module Metrics
1745
- * @class Metrics.MediaTracker
1746
- */
1747
- "use strict";
1748
- (function (root) {
1749
-
1750
- var Metrics = root.Metrics;
1751
- if (!Metrics) {
1752
- console.warn('Metrics.MediaTracker: Metrics core not loaded');
1753
- return;
1754
- }
1755
-
1756
- var defaults = {
1757
- // Seconds between checkpoint events during playback
1758
- checkpointInterval: 10,
1759
-
1760
- // Auto-discover media elements on init
1761
- autoDiscover: true,
1762
-
1763
- // CSS selector for native media elements
1764
- mediaSelector: 'video, audio',
1765
-
1766
- // Whether to reload YouTube/Vimeo iframes to inject API params
1767
- // Default false: logs a warning instead of disrupting playback
1768
- reloadIframes: false,
1769
-
1770
- // Observe DOM for dynamically added media
1771
- observeDom: true,
1772
-
1773
- // Root element to watch for mutations
1774
- observeRoot: null,
1775
-
1776
- // Debounce checkpoint sends (ms) — prevents burst on rapid seeks
1777
- checkpointDebounce: 1000
1778
- };
1779
-
1780
- // ── State ──
1781
- var state = {
1782
- initialized: false,
1783
- options: null,
1784
- tracked: {}, // id → tracker object
1785
- _counter: 0, // for generating IDs
1786
- _mutationObserver: null,
1787
- _ytApiLoaded: false,
1788
- _ytApiLoading: false,
1789
- _ytPendingPlayers: [], // iframes waiting for API
1790
- _vimeoApiLoaded: false,
1791
- _vimeoApiLoading: false
1792
- };
1793
-
1794
- // ── Utilities ──
1795
-
1796
- function genId(el) {
1797
- if (el.id) return el.id;
1798
- var src = el.src || el.currentSrc || '';
1799
- if (src) {
1800
- // Extract meaningful part of URL
1801
- var match = src.match(/(?:youtu\.be\/|youtube\.com\/embed\/|vimeo\.com\/video\/|vimeo\.com\/)([^?&#]+)/);
1802
- if (match) return match[1];
1803
- // Use filename
1804
- var parts = src.split('/').pop().split('?')[0];
1805
- if (parts && parts.length < 60) return parts;
1806
- }
1807
- return 'media-' + (state._counter++);
1808
- }
1809
-
1810
- function now() { return Date.now(); }
1811
-
1812
- // ── Watched Seconds Tracker ──
1813
- // Tracks unique seconds viewed (handles seeking/rewatching)
1814
-
1815
- function WatchedTracker() {
1816
- this.ranges = []; // [{start, end}] sorted, non-overlapping
1817
- }
1818
-
1819
- WatchedTracker.prototype.add = function (from, to) {
1820
- if (to <= from) return;
1821
- var newRange = { start: Math.floor(from), end: Math.ceil(to) };
1822
- var merged = [];
1823
- var inserted = false;
1824
- for (var i = 0; i < this.ranges.length; i++) {
1825
- var r = this.ranges[i];
1826
- if (r.end < newRange.start) {
1827
- merged.push(r);
1828
- } else if (r.start > newRange.end) {
1829
- if (!inserted) { merged.push(newRange); inserted = true; }
1830
- merged.push(r);
1831
- } else {
1832
- newRange.start = Math.min(newRange.start, r.start);
1833
- newRange.end = Math.max(newRange.end, r.end);
1834
- }
1835
- }
1836
- if (!inserted) merged.push(newRange);
1837
- this.ranges = merged;
1838
- };
1839
-
1840
- WatchedTracker.prototype.total = function () {
1841
- var t = 0;
1842
- for (var i = 0; i < this.ranges.length; i++) {
1843
- t += this.ranges[i].end - this.ranges[i].start;
1844
- }
1845
- return t;
1846
- };
1847
-
1848
- // ── Core Tracker Object (per media element) ──
1849
-
1850
- function createTracker(id, type, el, duration) {
1851
- return {
1852
- id: id,
1853
- type: type, // 'native', 'youtube', 'vimeo'
1854
- el: el,
1855
- duration: duration || 0,
1856
- playing: false,
1857
- lastPosition: 0,
1858
- lastCheckpointAt: 0, // timestamp of last checkpoint send
1859
- watched: new WatchedTracker(),
1860
- checkpointTimer: null,
1861
- _lastTimeUpdate: 0 // position at last timeupdate
1862
- };
1863
- }
1864
-
1865
- function sendEvent(tracker, event, extra) {
1866
- var data = {
1867
- type: tracker.type,
1868
- position: Math.round(tracker.lastPosition),
1869
- duration: Math.round(tracker.duration),
1870
- watched: tracker.watched.total()
1871
- };
1872
- if (extra) {
1873
- for (var k in extra) data[k] = extra[k];
1874
- }
1875
- Metrics.send(event + ':' + tracker.id, data);
1876
- }
1877
-
1878
- // ── Checkpoint Timer ──
1879
-
1880
- function startCheckpoints(tracker) {
1881
- stopCheckpoints(tracker);
1882
- var interval = state.options.checkpointInterval * 1000;
1883
- tracker.checkpointTimer = setInterval(function () {
1884
- if (tracker.playing) {
1885
- sendEvent(tracker, 'media-checkpoint');
1886
- }
1887
- }, interval);
1888
- }
1889
-
1890
- function stopCheckpoints(tracker) {
1891
- if (tracker.checkpointTimer) {
1892
- clearInterval(tracker.checkpointTimer);
1893
- tracker.checkpointTimer = null;
1894
- }
1895
- }
1896
-
1897
- // ── Native <video> / <audio> ──
1898
-
1899
- function trackNative(el) {
1900
- var id = genId(el);
1901
- if (state.tracked[id]) return; // already tracking
1902
-
1903
- var tracker = createTracker(id, 'native', el, el.duration || 0);
1904
- state.tracked[id] = tracker;
1905
-
1906
- el.addEventListener('loadedmetadata', function () {
1907
- tracker.duration = el.duration || 0;
1908
- });
1909
-
1910
- el.addEventListener('play', function () {
1911
- tracker.playing = true;
1912
- tracker.lastPosition = el.currentTime;
1913
- tracker._lastTimeUpdate = el.currentTime;
1914
- sendEvent(tracker, 'media-play');
1915
- startCheckpoints(tracker);
1916
- });
1917
-
1918
- el.addEventListener('pause', function () {
1919
- if (!tracker.playing) return;
1920
- tracker.playing = false;
1921
- tracker.watched.add(tracker._lastTimeUpdate, el.currentTime);
1922
- tracker.lastPosition = el.currentTime;
1923
- stopCheckpoints(tracker);
1924
- sendEvent(tracker, 'media-pause');
1925
- });
1926
-
1927
- el.addEventListener('ended', function () {
1928
- tracker.playing = false;
1929
- tracker.watched.add(tracker._lastTimeUpdate, el.currentTime);
1930
- tracker.lastPosition = el.currentTime;
1931
- stopCheckpoints(tracker);
1932
- sendEvent(tracker, 'media-ended');
1933
- });
1934
-
1935
- el.addEventListener('seeked', function () {
1936
- var from = tracker.lastPosition;
1937
- tracker.lastPosition = el.currentTime;
1938
- tracker._lastTimeUpdate = el.currentTime;
1939
- sendEvent(tracker, 'media-seeked', {
1940
- from: Math.round(from),
1941
- to: Math.round(el.currentTime)
1942
- });
1943
- });
1944
-
1945
- el.addEventListener('timeupdate', function () {
1946
- // Track watched range
1947
- if (tracker.playing && el.currentTime > tracker._lastTimeUpdate) {
1948
- tracker.watched.add(tracker._lastTimeUpdate, el.currentTime);
1949
- }
1950
- tracker._lastTimeUpdate = el.currentTime;
1951
- tracker.lastPosition = el.currentTime;
1952
- });
1953
- }
1954
-
1955
- // ── YouTube Iframe ──
1956
-
1957
- function loadYouTubeAPI(callback) {
1958
- if (state._ytApiLoaded) { callback(); return; }
1959
- if (state._ytApiLoading) {
1960
- state._ytPendingPlayers.push(callback);
1961
- return;
1962
- }
1963
- state._ytApiLoading = true;
1964
-
1965
- var prev = root.onYouTubeIframeAPIReady;
1966
- root.onYouTubeIframeAPIReady = function () {
1967
- state._ytApiLoaded = true;
1968
- state._ytApiLoading = false;
1969
- if (prev) prev();
1970
- callback();
1971
- for (var i = 0; i < state._ytPendingPlayers.length; i++) {
1972
- state._ytPendingPlayers[i]();
1973
- }
1974
- state._ytPendingPlayers = [];
1975
- };
1976
-
1977
- var script = document.createElement('script');
1978
- script.src = 'https://www.youtube.com/iframe_api';
1979
- document.head.appendChild(script);
1980
- }
1981
-
1982
- function trackYouTube(iframe) {
1983
- var src = iframe.src || '';
1984
- var id = genId(iframe);
1985
- if (state.tracked[id]) return;
1986
-
1987
- // Check for enablejsapi=1
1988
- if (src.indexOf('enablejsapi') === -1) {
1989
- if (state.options.reloadIframes) {
1990
- var separator = src.indexOf('?') === -1 ? '?' : '&';
1991
- iframe.src = src + separator + 'enablejsapi=1&origin=' + encodeURIComponent(location.origin);
1992
- // iframe will reload, we'll catch it again via mutation observer or re-scan
1993
- } else {
1994
- console.warn('Metrics.MediaTracker: YouTube iframe missing enablejsapi=1, '
1995
- + 'set reloadIframes:true to auto-fix. iframe:', iframe);
1996
- return;
1997
- }
1998
- }
1999
-
2000
- // Ensure iframe has an id for the YT API
2001
- if (!iframe.id) iframe.id = 'yt-' + id;
2002
-
2003
- loadYouTubeAPI(function () {
2004
- if (state.tracked[id]) return;
2005
- var tracker = createTracker(id, 'youtube', iframe, 0);
2006
- state.tracked[id] = tracker;
2007
-
2008
- var player = new YT.Player(iframe.id, {
2009
- events: {
2010
- onReady: function (e) {
2011
- tracker.duration = player.getDuration() || 0;
2012
- },
2013
- onStateChange: function (e) {
2014
- var pos = player.getCurrentTime() || 0;
2015
- tracker.lastPosition = pos;
2016
-
2017
- switch (e.data) {
2018
- case YT.PlayerState.PLAYING:
2019
- tracker.playing = true;
2020
- tracker._lastTimeUpdate = pos;
2021
- tracker.duration = player.getDuration() || tracker.duration;
2022
- sendEvent(tracker, 'media-play');
2023
- startCheckpoints(tracker);
2024
- // Poll position since YT has no timeupdate
2025
- tracker._pollTimer = setInterval(function () {
2026
- var p = player.getCurrentTime() || 0;
2027
- if (tracker.playing && p > tracker._lastTimeUpdate) {
2028
- tracker.watched.add(tracker._lastTimeUpdate, p);
2029
- }
2030
- tracker._lastTimeUpdate = p;
2031
- tracker.lastPosition = p;
2032
- }, 1000);
2033
- break;
2034
-
2035
- case YT.PlayerState.PAUSED:
2036
- if (!tracker.playing) break;
2037
- tracker.playing = false;
2038
- tracker.watched.add(tracker._lastTimeUpdate, pos);
2039
- stopCheckpoints(tracker);
2040
- clearInterval(tracker._pollTimer);
2041
- sendEvent(tracker, 'media-pause');
2042
- break;
2043
-
2044
- case YT.PlayerState.ENDED:
2045
- tracker.playing = false;
2046
- tracker.watched.add(tracker._lastTimeUpdate, pos);
2047
- stopCheckpoints(tracker);
2048
- clearInterval(tracker._pollTimer);
2049
- sendEvent(tracker, 'media-ended');
2050
- break;
2051
- }
2052
- }
2053
- }
2054
- });
2055
- tracker._player = player;
2056
- });
2057
- }
2058
-
2059
- // ── Vimeo Iframe ──
2060
-
2061
- function loadVimeoAPI(callback) {
2062
- if (state._vimeoApiLoaded) { callback(); return; }
2063
- if (state._vimeoApiLoading) {
2064
- setTimeout(function () { loadVimeoAPI(callback); }, 200);
2065
- return;
2066
- }
2067
- state._vimeoApiLoading = true;
2068
-
2069
- var script = document.createElement('script');
2070
- script.src = 'https://player.vimeo.com/api/player.js';
2071
- script.onload = function () {
2072
- state._vimeoApiLoaded = true;
2073
- state._vimeoApiLoading = false;
2074
- callback();
2075
- };
2076
- document.head.appendChild(script);
2077
- }
2078
-
2079
- function trackVimeo(iframe) {
2080
- var src = iframe.src || '';
2081
- var id = genId(iframe);
2082
- if (state.tracked[id]) return;
2083
-
2084
- loadVimeoAPI(function () {
2085
- if (state.tracked[id]) return;
2086
- var tracker = createTracker(id, 'vimeo', iframe, 0);
2087
- state.tracked[id] = tracker;
2088
-
2089
- var player = new Vimeo.Player(iframe);
2090
- tracker._player = player;
2091
-
2092
- player.getDuration().then(function (d) { tracker.duration = d || 0; });
2093
-
2094
- player.on('play', function (data) {
2095
- tracker.playing = true;
2096
- tracker.lastPosition = data.seconds || 0;
2097
- tracker._lastTimeUpdate = tracker.lastPosition;
2098
- tracker.duration = data.duration || tracker.duration;
2099
- sendEvent(tracker, 'media-play');
2100
- startCheckpoints(tracker);
2101
- });
2102
-
2103
- player.on('pause', function (data) {
2104
- if (!tracker.playing) return;
2105
- tracker.playing = false;
2106
- var pos = data.seconds || 0;
2107
- tracker.watched.add(tracker._lastTimeUpdate, pos);
2108
- tracker.lastPosition = pos;
2109
- stopCheckpoints(tracker);
2110
- sendEvent(tracker, 'media-pause');
2111
- });
2112
-
2113
- player.on('ended', function (data) {
2114
- tracker.playing = false;
2115
- var pos = data.seconds || tracker.duration;
2116
- tracker.watched.add(tracker._lastTimeUpdate, pos);
2117
- tracker.lastPosition = pos;
2118
- stopCheckpoints(tracker);
2119
- sendEvent(tracker, 'media-ended');
2120
- });
2121
-
2122
- player.on('seeked', function (data) {
2123
- var from = tracker.lastPosition;
2124
- tracker.lastPosition = data.seconds || 0;
2125
- tracker._lastTimeUpdate = tracker.lastPosition;
2126
- sendEvent(tracker, 'media-seeked', {
2127
- from: Math.round(from),
2128
- to: Math.round(tracker.lastPosition)
2129
- });
2130
- });
2131
-
2132
- player.on('timeupdate', function (data) {
2133
- var pos = data.seconds || 0;
2134
- if (tracker.playing && pos > tracker._lastTimeUpdate) {
2135
- tracker.watched.add(tracker._lastTimeUpdate, pos);
2136
- }
2137
- tracker._lastTimeUpdate = pos;
2138
- tracker.lastPosition = pos;
2139
- });
2140
- });
2141
- }
2142
-
2143
- // ── Auto-Discovery ──
2144
-
2145
- function discoverMedia() {
2146
- // Native elements
2147
- var natives = document.querySelectorAll(state.options.mediaSelector);
2148
- for (var i = 0; i < natives.length; i++) {
2149
- trackNative(natives[i]);
2150
- }
2151
-
2152
- // Iframes — detect by src URL
2153
- var iframes = document.querySelectorAll('iframe[src]');
2154
- for (var j = 0; j < iframes.length; j++) {
2155
- var src = iframes[j].src || '';
2156
- if (/youtube\.com\/embed|youtube-nocookie\.com\/embed/.test(src)) {
2157
- trackYouTube(iframes[j]);
2158
- } else if (/player\.vimeo\.com/.test(src)) {
2159
- trackVimeo(iframes[j]);
2160
- } else if (/w\.soundcloud\.com\/player/.test(src)) {
2161
- trackSoundCloud(iframes[j]);
2162
- } else if (/dailymotion\.com\/embed/.test(src)) {
2163
- trackDailymotion(iframes[j]);
2164
- } else if (/open\.spotify\.com\/embed/.test(src)) {
2165
- trackSpotify(iframes[j]);
2166
- } else if (/player\.twitch\.tv/.test(src)) {
2167
- trackTwitch(iframes[j]);
2168
- } else if (/muse\.ai\/embed/.test(src)) {
2169
- trackMuseAi(iframes[j]);
2170
- }
2171
- }
2172
-
2173
- // Wistia — detected by class name, not iframe
2174
- var wistias = document.querySelectorAll('[class*="wistia_embed"], [class*="wistia_async_"]');
2175
- for (var k = 0; k < wistias.length; k++) {
2176
- trackWistia(wistias[k]);
2177
- }
2178
-
2179
- // JW Player — detected by container class or data attribute
2180
- var jwContainers = document.querySelectorAll('.jwplayer, [data-jw-id]');
2181
- for (var l = 0; l < jwContainers.length; l++) {
2182
- trackJWPlayer(jwContainers[l]);
2183
- }
2184
- }
2185
-
2186
- // ── DOM Mutation Observer ──
2187
-
2188
- function _startMutationObserver() {
2189
- if (!window.MutationObserver || !state.options.observeDom) return;
2190
- var root = state.options.observeRoot || document.body;
2191
-
2192
- state._mutationObserver = new MutationObserver(function (mutations) {
2193
- mutations.forEach(function (mutation) {
2194
- mutation.addedNodes.forEach(function (node) {
2195
- if (node.nodeType !== 1) return;
2196
- // Check the node itself
2197
- if (node.matches && node.matches('video, audio')) {
2198
- trackNative(node);
2199
- }
2200
- if (node.tagName === 'IFRAME' && node.src) {
2201
- var s = node.src;
2202
- if (/youtube\.com\/embed/.test(s)) trackYouTube(node);
2203
- else if (/player\.vimeo\.com/.test(s)) trackVimeo(node);
2204
- else if (/w\.soundcloud\.com\/player/.test(s)) trackSoundCloud(node);
2205
- else if (/dailymotion\.com\/embed/.test(s)) trackDailymotion(node);
2206
- else if (/open\.spotify\.com\/embed/.test(s)) trackSpotify(node);
2207
- else if (/player\.twitch\.tv/.test(s)) trackTwitch(node);
2208
- else if (/muse\.ai\/embed/.test(s)) trackMuseAi(node);
2209
- }
2210
- // Wistia containers
2211
- if (node.className && /wistia_embed|wistia_async_/.test(node.className)) {
2212
- trackWistia(node);
2213
- }
2214
- // JW Player containers
2215
- if (node.className && /jwplayer/.test(node.className)) {
2216
- trackJWPlayer(node);
2217
- }
2218
- // Check descendants
2219
- if (node.querySelectorAll) {
2220
- var natives = node.querySelectorAll('video, audio');
2221
- for (var i = 0; i < natives.length; i++) trackNative(natives[i]);
2222
- var iframes = node.querySelectorAll('iframe[src]');
2223
- for (var j = 0; j < iframes.length; j++) {
2224
- var s = iframes[j].src || '';
2225
- if (/youtube\.com\/embed/.test(s)) trackYouTube(iframes[j]);
2226
- else if (/player\.vimeo\.com/.test(s)) trackVimeo(iframes[j]);
2227
- else if (/w\.soundcloud\.com\/player/.test(s)) trackSoundCloud(iframes[j]);
2228
- else if (/dailymotion\.com\/embed/.test(s)) trackDailymotion(iframes[j]);
2229
- else if (/open\.spotify\.com\/embed/.test(s)) trackSpotify(iframes[j]);
2230
- else if (/player\.twitch\.tv/.test(s)) trackTwitch(iframes[j]);
2231
- else if (/muse\.ai\/embed/.test(s)) trackMuseAi(iframes[j]);
2232
- }
2233
- var wistias = node.querySelectorAll('[class*="wistia_embed"], [class*="wistia_async_"]');
2234
- for (var k = 0; k < wistias.length; k++) trackWistia(wistias[k]);
2235
- var jws = node.querySelectorAll('.jwplayer, [data-jw-id]');
2236
- for (var l = 0; l < jws.length; l++) trackJWPlayer(jws[l]);
2237
- }
2238
- });
2239
- });
2240
- });
2241
-
2242
- state._mutationObserver.observe(root, { childList: true, subtree: true });
2243
- }
2244
-
2245
- // ── Flush All Playing Media ──
2246
-
2247
- function flushAll() {
2248
- for (var id in state.tracked) {
2249
- var tracker = state.tracked[id];
2250
- if (tracker.playing) {
2251
- // Update watched range one last time
2252
- if (tracker.type === 'native' && tracker.el) {
2253
- tracker.watched.add(tracker._lastTimeUpdate, tracker.el.currentTime || tracker.lastPosition);
2254
- tracker.lastPosition = tracker.el.currentTime || tracker.lastPosition;
2255
- }
2256
- sendEvent(tracker, 'media-checkpoint');
2257
- }
2258
- }
2259
- }
2260
-
2261
- // ── Pre-mark Initial State ──
2262
-
2263
- function premarkInitialState() {
2264
- // Nothing to pre-mark for media — we want to track all plays
2265
- }
2266
-
2267
- // ── Public API ──
2268
-
2269
- var MT = {
2270
-
2271
- /**
2272
- * Initialize media tracking
2273
- */
2274
- init: function (options) {
2275
- if (state.initialized) {
2276
- console.warn('Metrics.MediaTracker already initialized');
2277
- return this;
2278
- }
2279
-
2280
- var opts = {};
2281
- var k;
2282
- for (k in defaults) { if (defaults.hasOwnProperty(k)) opts[k] = defaults[k]; }
2283
- for (k in (options || {})) { if (options.hasOwnProperty(k) && options[k] !== undefined) opts[k] = options[k]; }
2284
- state.options = opts;
2285
- state.initialized = true;
2286
-
2287
- // Auto-init Metrics core if needed
2288
- if (!Metrics._endpoint && options && options.endpoint) {
2289
- Metrics.init({
2290
- endpoint: options.endpoint, page: options.page,
2291
- trackUnload: options.trackUnload
2292
- });
2293
- }
2294
-
2295
- // Discover existing media
2296
- if (opts.autoDiscover) {
2297
- // Slight delay to let page render
2298
- setTimeout(function () {
2299
- discoverMedia();
2300
- }, 500);
2301
- }
2302
-
2303
- // Watch for dynamically added media
2304
- if (opts.observeDom) {
2305
- _startMutationObserver();
2306
- }
2307
-
2308
- // Flush on page exit
2309
- Metrics.onVisibilityChange(function (visible) {
2310
- if (!visible) flushAll();
2311
- }, 'MediaTracker.flush');
2312
-
2313
- return this;
2314
- },
2315
-
2316
- /**
2317
- * Manually track a native video/audio element
2318
- * @param {Element} el — the <video> or <audio> element
2319
- * @param {String} [id] — optional custom ID
2320
- */
2321
- trackNative: function (el, id) {
2322
- if (id) el.id = id;
2323
- trackNative(el);
2324
- },
2325
-
2326
- /**
2327
- * Manually track a YouTube iframe
2328
- * @param {Element} iframe
2329
- * @param {String} [id]
2330
- */
2331
- trackYouTube: function (iframe, id) {
2332
- if (id) iframe.id = id;
2333
- trackYouTube(iframe);
2334
- },
2335
-
2336
- /**
2337
- * Manually track a Vimeo iframe
2338
- * @param {Element} iframe
2339
- * @param {String} [id]
2340
- */
2341
- trackVimeo: function (iframe, id) {
2342
- if (id) iframe.id = id;
2343
- trackVimeo(iframe);
2344
- },
2345
-
2346
- trackSoundCloud: function (iframe, id) {
2347
- if (id) iframe.id = id;
2348
- trackSoundCloud(iframe);
2349
- },
2350
-
2351
- trackWistia: function (container, id) {
2352
- if (id) container.id = id;
2353
- trackWistia(container);
2354
- },
2355
-
2356
- trackJWPlayer: function (container, id) {
2357
- if (id) container.id = id;
2358
- trackJWPlayer(container);
2359
- },
2360
-
2361
- trackDailymotion: function (iframe, id) {
2362
- if (id) iframe.id = id;
2363
- trackDailymotion(iframe);
2364
- },
2365
-
2366
- trackSpotify: function (iframe, id) {
2367
- if (id) iframe.id = id;
2368
- trackSpotify(iframe);
2369
- },
2370
-
2371
- trackTwitch: function (iframe, id) {
2372
- if (id) iframe.id = id;
2373
- trackTwitch(iframe);
2374
- },
2375
-
2376
- trackMuseAi: function (iframe, id) {
2377
- if (id) iframe.id = id;
2378
- trackMuseAi(iframe);
2379
- },
2380
-
2381
- /**
2382
- * Get all tracked media and their current state
2383
- */
2384
- getTracked: function () {
2385
- var result = {};
2386
- for (var id in state.tracked) {
2387
- var t = state.tracked[id];
2388
- result[id] = {
2389
- id: t.id, type: t.type,
2390
- playing: t.playing,
2391
- position: Math.round(t.lastPosition),
2392
- duration: Math.round(t.duration),
2393
- watched: t.watched.total()
2394
- };
2395
- }
2396
- return result;
2397
- },
2398
-
2399
- /**
2400
- * Flush checkpoint for all currently playing media
2401
- */
2402
- flush: flushAll,
2403
-
2404
- /**
2405
- * Re-scan the page for new media elements
2406
- */
2407
- rescan: discoverMedia,
2408
-
2409
- /**
2410
- * Destroy — stop all tracking and remove observers
2411
- */
2412
- destroy: function () {
2413
- for (var id in state.tracked) {
2414
- var t = state.tracked[id];
2415
- stopCheckpoints(t);
2416
- if (t._pollTimer) clearInterval(t._pollTimer);
2417
- }
2418
- state.tracked = {};
2419
- if (state._mutationObserver) {
2420
- state._mutationObserver.disconnect();
2421
- state._mutationObserver = null;
2422
- }
2423
- state.initialized = false;
2424
- },
2425
-
2426
- defaults: defaults,
2427
- state: state
2428
- };
2429
-
2430
- Metrics.MediaTracker = MT;
2431
-
2432
- })(typeof window !== 'undefined' ? window : this);
2433
-
2434
- // ── SoundCloud Widget ──
2435
-
2436
- function loadSoundCloudAPI(callback) {
2437
- if (root.SC && root.SC.Widget) { callback(); return; }
2438
- var script = document.createElement('script');
2439
- script.src = 'https://w.soundcloud.com/player/api.js';
2440
- script.onload = callback;
2441
- document.head.appendChild(script);
2442
- }
2443
-
2444
- function trackSoundCloud(iframe) {
2445
- var id = genId(iframe);
2446
- if (state.tracked[id]) return;
2447
-
2448
- loadSoundCloudAPI(function () {
2449
- if (state.tracked[id]) return;
2450
- var widget = SC.Widget(iframe);
2451
- var tracker = createTracker(id, 'soundcloud', iframe, 0);
2452
- state.tracked[id] = tracker;
2453
-
2454
- widget.bind(SC.Widget.Events.READY, function () {
2455
- widget.getDuration(function (d) { tracker.duration = (d || 0) / 1000; });
2456
- });
2457
- widget.bind(SC.Widget.Events.PLAY, function () {
2458
- tracker.playing = true;
2459
- widget.getPosition(function (p) {
2460
- tracker.lastPosition = (p || 0) / 1000;
2461
- tracker._lastTimeUpdate = tracker.lastPosition;
2462
- sendEvent(tracker, 'media-play');
2463
- startCheckpoints(tracker);
2464
- });
2465
- });
2466
- widget.bind(SC.Widget.Events.PAUSE, function () {
2467
- if (!tracker.playing) return;
2468
- tracker.playing = false;
2469
- widget.getPosition(function (p) {
2470
- var pos = (p || 0) / 1000;
2471
- tracker.watched.add(tracker._lastTimeUpdate, pos);
2472
- tracker.lastPosition = pos;
2473
- stopCheckpoints(tracker);
2474
- sendEvent(tracker, 'media-pause');
2475
- });
2476
- });
2477
- widget.bind(SC.Widget.Events.FINISH, function () {
2478
- tracker.playing = false;
2479
- tracker.watched.add(tracker._lastTimeUpdate, tracker.duration);
2480
- tracker.lastPosition = tracker.duration;
2481
- stopCheckpoints(tracker);
2482
- sendEvent(tracker, 'media-ended');
2483
- });
2484
- widget.bind(SC.Widget.Events.SEEK, function (e) {
2485
- var from = tracker.lastPosition;
2486
- tracker.lastPosition = (e.currentPosition || 0) / 1000;
2487
- tracker._lastTimeUpdate = tracker.lastPosition;
2488
- sendEvent(tracker, 'media-seeked', {
2489
- from: Math.round(from), to: Math.round(tracker.lastPosition)
2490
- });
2491
- });
2492
- widget.bind(SC.Widget.Events.PLAY_PROGRESS, function (e) {
2493
- var pos = (e.currentPosition || 0) / 1000;
2494
- if (tracker.playing && pos > tracker._lastTimeUpdate) {
2495
- tracker.watched.add(tracker._lastTimeUpdate, pos);
2496
- }
2497
- tracker._lastTimeUpdate = pos;
2498
- tracker.lastPosition = pos;
2499
- });
2500
- });
2501
- }
2502
-
2503
- // ── Wistia ──
2504
-
2505
- function trackWistia(container) {
2506
- var id = genId(container);
2507
- if (state.tracked[id]) return;
2508
-
2509
- var handleId = container.getAttribute('data-wistia-id')
2510
- || (container.className.match(/wistia_async_(\w+)/) || [])[1]
2511
- || id;
2512
-
2513
- root._wq = root._wq || [];
2514
- root._wq.push({
2515
- id: handleId,
2516
- onReady: function (video) {
2517
- if (state.tracked[id]) return;
2518
- var tracker = createTracker(id, 'wistia', container, video.duration() || 0);
2519
- state.tracked[id] = tracker;
2520
- tracker._player = video;
2521
-
2522
- video.bind('play', function () {
2523
- tracker.playing = true;
2524
- tracker.lastPosition = video.time();
2525
- tracker._lastTimeUpdate = tracker.lastPosition;
2526
- tracker.duration = video.duration() || tracker.duration;
2527
- sendEvent(tracker, 'media-play');
2528
- startCheckpoints(tracker);
2529
- });
2530
- video.bind('pause', function () {
2531
- if (!tracker.playing) return;
2532
- tracker.playing = false;
2533
- var pos = video.time();
2534
- tracker.watched.add(tracker._lastTimeUpdate, pos);
2535
- tracker.lastPosition = pos;
2536
- stopCheckpoints(tracker);
2537
- sendEvent(tracker, 'media-pause');
2538
- });
2539
- video.bind('end', function () {
2540
- tracker.playing = false;
2541
- tracker.watched.add(tracker._lastTimeUpdate, tracker.duration);
2542
- tracker.lastPosition = tracker.duration;
2543
- stopCheckpoints(tracker);
2544
- sendEvent(tracker, 'media-ended');
2545
- });
2546
- video.bind('seek', function (currentTime, lastTime) {
2547
- tracker.lastPosition = currentTime;
2548
- tracker._lastTimeUpdate = currentTime;
2549
- sendEvent(tracker, 'media-seeked', {
2550
- from: Math.round(lastTime), to: Math.round(currentTime)
2551
- });
2552
- });
2553
- video.bind('secondchange', function (s) {
2554
- var pos = s;
2555
- if (tracker.playing && pos > tracker._lastTimeUpdate) {
2556
- tracker.watched.add(tracker._lastTimeUpdate, pos);
2557
- }
2558
- tracker._lastTimeUpdate = pos;
2559
- tracker.lastPosition = pos;
2560
- });
2561
- }
2562
- });
2563
-
2564
- // Load Wistia E-v1 if not present
2565
- if (!root.Wistia) {
2566
- var script = document.createElement('script');
2567
- script.src = 'https://fast.wistia.com/assets/external/E-v1.js';
2568
- script.async = true;
2569
- document.head.appendChild(script);
2570
- }
2571
- }
2572
-
2573
- // ── JW Player ──
2574
-
2575
- function trackJWPlayer(container) {
2576
- var id = genId(container);
2577
- if (state.tracked[id]) return;
2578
-
2579
- // JW Player instance might already exist
2580
- var playerId = container.id || id;
2581
- function _bind() {
2582
- if (!root.jwplayer || typeof root.jwplayer !== 'function') return false;
2583
- var player;
2584
- try { player = jwplayer(playerId); } catch (e) { return false; }
2585
- if (!player || !player.getState) return false;
2586
-
2587
- var tracker = createTracker(id, 'jwplayer', container, player.getDuration() || 0);
2588
- state.tracked[id] = tracker;
2589
- tracker._player = player;
2590
-
2591
- player.on('play', function () {
2592
- tracker.playing = true;
2593
- tracker.lastPosition = player.getPosition();
2594
- tracker._lastTimeUpdate = tracker.lastPosition;
2595
- tracker.duration = player.getDuration() || tracker.duration;
2596
- sendEvent(tracker, 'media-play');
2597
- startCheckpoints(tracker);
2598
- });
2599
- player.on('pause', function () {
2600
- if (!tracker.playing) return;
2601
- tracker.playing = false;
2602
- var pos = player.getPosition();
2603
- tracker.watched.add(tracker._lastTimeUpdate, pos);
2604
- tracker.lastPosition = pos;
2605
- stopCheckpoints(tracker);
2606
- sendEvent(tracker, 'media-pause');
2607
- });
2608
- player.on('complete', function () {
2609
- tracker.playing = false;
2610
- tracker.watched.add(tracker._lastTimeUpdate, tracker.duration);
2611
- tracker.lastPosition = tracker.duration;
2612
- stopCheckpoints(tracker);
2613
- sendEvent(tracker, 'media-ended');
2614
- });
2615
- player.on('seek', function (e) {
2616
- tracker.lastPosition = e.offset;
2617
- tracker._lastTimeUpdate = e.offset;
2618
- sendEvent(tracker, 'media-seeked', {
2619
- from: Math.round(e.position), to: Math.round(e.offset)
2620
- });
2621
- });
2622
- player.on('time', function (e) {
2623
- var pos = e.position;
2624
- if (tracker.playing && pos > tracker._lastTimeUpdate) {
2625
- tracker.watched.add(tracker._lastTimeUpdate, pos);
2626
- }
2627
- tracker._lastTimeUpdate = pos;
2628
- tracker.lastPosition = pos;
2629
- tracker.duration = e.duration || tracker.duration;
2630
- });
2631
- return true;
2632
- }
2633
-
2634
- // Try immediately, retry after a delay if JW hasn't initialized yet
2635
- if (!_bind()) {
2636
- setTimeout(function () { _bind(); }, 2000);
2637
- }
2638
- }
2639
-
2640
- // ── Dailymotion ──
2641
-
2642
- function trackDailymotion(iframe) {
2643
- var id = genId(iframe);
2644
- if (state.tracked[id]) return;
2645
-
2646
- function _loadAndBind() {
2647
- if (!root.DM || !root.DM.player) {
2648
- var script = document.createElement('script');
2649
- script.src = 'https://api.dmcdn.net/all.js';
2650
- script.onload = function () { _createPlayer(); };
2651
- document.head.appendChild(script);
2652
- } else {
2653
- _createPlayer();
2654
- }
2655
- }
2656
-
2657
- function _createPlayer() {
2658
- if (state.tracked[id]) return;
2659
- var tracker = createTracker(id, 'dailymotion', iframe, 0);
2660
- state.tracked[id] = tracker;
2661
-
2662
- var player = DM.player(iframe, { events: {
2663
- playing: function () {
2664
- tracker.playing = true;
2665
- tracker.lastPosition = player.currentTime || 0;
2666
- tracker._lastTimeUpdate = tracker.lastPosition;
2667
- tracker.duration = player.duration || tracker.duration;
2668
- sendEvent(tracker, 'media-play');
2669
- startCheckpoints(tracker);
2670
- },
2671
- pause: function () {
2672
- if (!tracker.playing) return;
2673
- tracker.playing = false;
2674
- var pos = player.currentTime || 0;
2675
- tracker.watched.add(tracker._lastTimeUpdate, pos);
2676
- tracker.lastPosition = pos;
2677
- stopCheckpoints(tracker);
2678
- sendEvent(tracker, 'media-pause');
2679
- },
2680
- end: function () {
2681
- tracker.playing = false;
2682
- tracker.watched.add(tracker._lastTimeUpdate, tracker.duration);
2683
- tracker.lastPosition = tracker.duration;
2684
- stopCheckpoints(tracker);
2685
- sendEvent(tracker, 'media-ended');
2686
- },
2687
- seeking: function () {
2688
- var from = tracker.lastPosition;
2689
- tracker.lastPosition = player.currentTime || 0;
2690
- tracker._lastTimeUpdate = tracker.lastPosition;
2691
- sendEvent(tracker, 'media-seeked', {
2692
- from: Math.round(from), to: Math.round(tracker.lastPosition)
2693
- });
2694
- },
2695
- timeupdate: function () {
2696
- var pos = player.currentTime || 0;
2697
- if (tracker.playing && pos > tracker._lastTimeUpdate) {
2698
- tracker.watched.add(tracker._lastTimeUpdate, pos);
2699
- }
2700
- tracker._lastTimeUpdate = pos;
2701
- tracker.lastPosition = pos;
2702
- tracker.duration = player.duration || tracker.duration;
2703
- }
2704
- }});
2705
- tracker._player = player;
2706
- }
2707
-
2708
- _loadAndBind();
2709
- }
2710
-
2711
- // ── Spotify Embed (limited — position only via playbackUpdate) ──
2712
-
2713
- function trackSpotify(iframe) {
2714
- var id = genId(iframe);
2715
- if (state.tracked[id]) return;
2716
-
2717
- var tracker = createTracker(id, 'spotify', iframe, 0);
2718
- state.tracked[id] = tracker;
2719
-
2720
- // Spotify Embed API uses window.onSpotifyIframeApiReady + postMessage
2721
- window.addEventListener('message', function (e) {
2722
- if (!e.data || e.source !== iframe.contentWindow) return;
2723
- var data;
2724
- try { data = typeof e.data === 'string' ? JSON.parse(e.data) : e.data; }
2725
- catch (err) { return; }
2726
- if (!data.type) return;
2727
-
2728
- if (data.type === 'playback_update') {
2729
- var pos = (data.payload && data.payload.position) || 0;
2730
- pos = pos / 1000; // ms to seconds
2731
- var dur = (data.payload && data.payload.duration) || 0;
2732
- dur = dur / 1000;
2733
- var isPaused = data.payload && data.payload.isPaused;
2734
-
2735
- tracker.duration = dur || tracker.duration;
2736
-
2737
- if (!isPaused && !tracker.playing) {
2738
- tracker.playing = true;
2739
- tracker.lastPosition = pos;
2740
- tracker._lastTimeUpdate = pos;
2741
- sendEvent(tracker, 'media-play');
2742
- startCheckpoints(tracker);
2743
- } else if (isPaused && tracker.playing) {
2744
- tracker.playing = false;
2745
- tracker.watched.add(tracker._lastTimeUpdate, pos);
2746
- tracker.lastPosition = pos;
2747
- stopCheckpoints(tracker);
2748
- sendEvent(tracker, 'media-pause');
2749
- } else if (!isPaused && tracker.playing && pos > tracker._lastTimeUpdate) {
2750
- tracker.watched.add(tracker._lastTimeUpdate, pos);
2751
- tracker._lastTimeUpdate = pos;
2752
- tracker.lastPosition = pos;
2753
- }
2754
- }
2755
- });
2756
- }
2757
-
2758
- // ── Twitch Player ──
2759
-
2760
- function trackTwitch(iframe) {
2761
- var id = genId(iframe);
2762
- if (state.tracked[id]) return;
2763
-
2764
- function _loadAndBind() {
2765
- if (!root.Twitch || !root.Twitch.Player) {
2766
- var script = document.createElement('script');
2767
- script.src = 'https://player.twitch.tv/js/embed/v1.js';
2768
- script.onload = function () { _createPlayer(); };
2769
- document.head.appendChild(script);
2770
- } else {
2771
- _createPlayer();
2772
- }
2773
- }
2774
-
2775
- function _createPlayer() {
2776
- if (state.tracked[id]) return;
2777
- if (!iframe.id) iframe.id = 'twitch-' + id;
2778
- var tracker = createTracker(id, 'twitch', iframe, 0);
2779
- state.tracked[id] = tracker;
2780
-
2781
- var player = new Twitch.Player(iframe.id, {});
2782
- tracker._player = player;
2783
-
2784
- player.addEventListener(Twitch.Player.PLAY, function () {
2785
- tracker.playing = true;
2786
- tracker.lastPosition = player.getCurrentTime() || 0;
2787
- tracker._lastTimeUpdate = tracker.lastPosition;
2788
- tracker.duration = player.getDuration() || tracker.duration;
2789
- sendEvent(tracker, 'media-play');
2790
- startCheckpoints(tracker);
2791
- tracker._pollTimer = setInterval(function () {
2792
- var p = player.getCurrentTime() || 0;
2793
- if (tracker.playing && p > tracker._lastTimeUpdate) {
2794
- tracker.watched.add(tracker._lastTimeUpdate, p);
2795
- }
2796
- tracker._lastTimeUpdate = p;
2797
- tracker.lastPosition = p;
2798
- }, 1000);
2799
- });
2800
- player.addEventListener(Twitch.Player.PAUSE, function () {
2801
- if (!tracker.playing) return;
2802
- tracker.playing = false;
2803
- var pos = player.getCurrentTime() || 0;
2804
- tracker.watched.add(tracker._lastTimeUpdate, pos);
2805
- tracker.lastPosition = pos;
2806
- stopCheckpoints(tracker);
2807
- clearInterval(tracker._pollTimer);
2808
- sendEvent(tracker, 'media-pause');
2809
- });
2810
- player.addEventListener(Twitch.Player.ENDED, function () {
2811
- tracker.playing = false;
2812
- var pos = player.getCurrentTime() || tracker.duration;
2813
- tracker.watched.add(tracker._lastTimeUpdate, pos);
2814
- tracker.lastPosition = pos;
2815
- stopCheckpoints(tracker);
2816
- clearInterval(tracker._pollTimer);
2817
- sendEvent(tracker, 'media-ended');
2818
- });
2819
- }
2820
-
2821
- _loadAndBind();
2822
- }
2823
-
2824
- // ── Muse.ai (postMessage API) ──
2825
-
2826
- function trackMuseAi(iframe) {
2827
- var id = genId(iframe);
2828
- if (state.tracked[id]) return;
2829
-
2830
- var tracker = createTracker(id, 'museai', iframe, 0);
2831
- state.tracked[id] = tracker;
2832
-
2833
- window.addEventListener('message', function (e) {
2834
- if (!e.data || e.source !== iframe.contentWindow) return;
2835
- var data;
2836
- try { data = typeof e.data === 'string' ? JSON.parse(e.data) : e.data; }
2837
- catch (err) { return; }
2838
-
2839
- if (data.event === 'play') {
2840
- tracker.playing = true;
2841
- tracker.lastPosition = data.currentTime || 0;
2842
- tracker._lastTimeUpdate = tracker.lastPosition;
2843
- tracker.duration = data.duration || tracker.duration;
2844
- sendEvent(tracker, 'media-play');
2845
- startCheckpoints(tracker);
2846
- } else if (data.event === 'pause') {
2847
- if (!tracker.playing) return;
2848
- tracker.playing = false;
2849
- var pos = data.currentTime || 0;
2850
- tracker.watched.add(tracker._lastTimeUpdate, pos);
2851
- tracker.lastPosition = pos;
2852
- stopCheckpoints(tracker);
2853
- sendEvent(tracker, 'media-pause');
2854
- } else if (data.event === 'ended') {
2855
- tracker.playing = false;
2856
- tracker.watched.add(tracker._lastTimeUpdate, tracker.duration);
2857
- tracker.lastPosition = tracker.duration;
2858
- stopCheckpoints(tracker);
2859
- sendEvent(tracker, 'media-ended');
2860
- } else if (data.event === 'timeupdate') {
2861
- var pos = data.currentTime || 0;
2862
- tracker.duration = data.duration || tracker.duration;
2863
- if (tracker.playing && pos > tracker._lastTimeUpdate) {
2864
- tracker.watched.add(tracker._lastTimeUpdate, pos);
2865
- }
2866
- tracker._lastTimeUpdate = pos;
2867
- tracker.lastPosition = pos;
2868
- }
2869
- });
2870
-
2871
- // Request the iframe to emit events
2872
- try { iframe.contentWindow.postMessage({ method: 'addEventListener', value: 'play' }, '*'); } catch(e){}
2873
- try { iframe.contentWindow.postMessage({ method: 'addEventListener', value: 'pause' }, '*'); } catch(e){}
2874
- try { iframe.contentWindow.postMessage({ method: 'addEventListener', value: 'ended' }, '*'); } catch(e){}
2875
- try { iframe.contentWindow.postMessage({ method: 'addEventListener', value: 'timeupdate' }, '*'); } catch(e){}
2876
- }
2877
-
2878
- /**
2879
- * Metrics.ScrollTracker — Section-aware scroll telemetry
2880
- *
2881
- * Tracks which sections a user reads, how far they scroll,
2882
- * and what they click. Delegates transport, session, visibility,
2883
- * and unload handling to the core Metrics object.
2884
- *
2885
- * Usage (standalone):
2886
- * Metrics.init({ endpoint: '/telemetry.php', page: 'My Page' });
2887
- * Metrics.ScrollTracker.init({
2888
- * sections: 'h2[id], h3[id]',
2889
- * debounce: 1000
2890
- * });
2891
- *
2892
- * Usage (with Q framework):
2893
- * // Auto-initializes from config if endpoint is set
2894
- *
2895
- * @module Metrics
2896
- * @class Metrics.ScrollTracker
2897
- */
2898
- "use strict";
2899
- (function (root) {
2900
-
2901
- var Metrics = root.Metrics;
2902
- if (!Metrics) {
2903
- console.warn('Metrics.ScrollTracker: Metrics core not loaded');
2904
- return;
2905
- }
2906
-
2907
- var defaults = {
2908
- // CSS selector for sections to track
2909
- sections: 'h2[id], h3[id], section[id], [data-section]',
2910
-
2911
- // Minimum pixel height for auto-detected containers
2912
- minSectionHeight: 100,
2913
-
2914
- // Milliseconds to wait after scroll stops before firing
2915
- debounce: 1000,
2916
-
2917
- // Milliseconds to wait on page load (ignores scroll restoration)
2918
- initDelay: 800,
2919
-
2920
- // Milliseconds to suppress tracking after anchor click
2921
- anchorCooldown: 1500,
2922
-
2923
- // Scroll depth milestones (percentage)
2924
- depthMilestones: [25, 50, 75, 100],
2925
-
2926
- // Max px above viewport top to consider a section "current"
2927
- sectionLookback: 300,
2928
-
2929
- // Scroll considered settled if moved less than this (px)
2930
- settleTolerance: 2,
2931
-
2932
- // Recheck interval when not settled (ms)
2933
- recheckInterval: 500,
2934
-
2935
- // Track link/anchor clicks
2936
- trackClicks: true,
2937
-
2938
- // Visual TOC highlighting selector (real-time, not debounced)
2939
- tocSelector: null,
2940
- tocActiveClass: 'active',
2941
- tocSectionSelector: 'h2[id]'
2942
- };
2943
-
2944
- // ── State ──
2945
- var state = {
2946
- initialized: false,
2947
- options: null,
2948
- sections: [],
2949
- tocSections: [],
2950
- seen: {},
2951
- depthHit: {},
2952
- scrollTimer: null,
2953
- anchorCooling: false,
2954
- _prevY: -1
2955
- };
2956
-
2957
- // ── Section Discovery ──
2958
-
2959
- function discoverSections(selector) {
2960
- var elements = document.querySelectorAll(selector);
2961
- var result = [];
2962
- var ordinal = 0;
2963
- var minH = (state.options && state.options.minSectionHeight) || 0;
2964
-
2965
- for (var i = 0; i < elements.length; i++) {
2966
- var el = elements[i];
2967
- if (el.offsetHeight < minH) continue;
2968
-
2969
- if (!el.id) {
2970
- var text = (el.textContent || '').trim().slice(0, 60);
2971
- var slug = text.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
2972
- el.id = slug || ('section-' + ordinal);
2973
- }
2974
-
2975
- result.push({
2976
- el: el,
2977
- id: el.id,
2978
- tag: el.tagName.toLowerCase(),
2979
- ordinal: ordinal++,
2980
- snippet: (el.textContent || '').trim().slice(0, 80)
2981
- });
2982
- }
2983
- return result;
2984
- }
2985
-
2986
- // ── Find Current Section ──
2987
-
2988
- function findCurrentSection() {
2989
- var scrollY = window.scrollY || window.pageYOffset;
2990
- var opts = state.options;
2991
- var best = null;
2992
- var bestDist = Infinity;
2993
-
2994
- for (var i = 0; i < state.sections.length; i++) {
2995
- var sec = state.sections[i];
2996
- var top = sec.el.offsetTop;
2997
- if (top <= scrollY + opts.sectionLookback) {
2998
- var dist = Math.abs(top - scrollY - 180);
2999
- if (dist < bestDist) {
3000
- bestDist = dist;
3001
- best = sec;
3002
- }
3003
- }
3004
- }
3005
- return best;
3006
- }
3007
-
3008
- // ── Scroll Settle Detection ──
3009
-
3010
- function onScrollSettle() {
3011
- var opts = state.options;
3012
- var curY = window.scrollY || window.pageYOffset;
3013
-
3014
- if (Math.abs(curY - state._prevY) > opts.settleTolerance) {
3015
- state._prevY = curY;
3016
- state.scrollTimer = setTimeout(onScrollSettle, opts.recheckInterval);
3017
- return;
3018
- }
3019
-
3020
- // Settled — report section
3021
- var current = findCurrentSection();
3022
- if (current && !state.seen[current.id]) {
3023
- state.seen[current.id] = true;
3024
- Metrics.send('section:' + current.id, {
3025
- tag: current.tag,
3026
- ordinal: current.ordinal,
3027
- snippet: current.snippet
3028
- });
3029
- }
3030
-
3031
- // Report depth
3032
- var docH = document.documentElement.scrollHeight - window.innerHeight;
3033
- if (docH > 0) {
3034
- var pct = Math.round((curY / docH) * 100);
3035
- for (var j = 0; j < opts.depthMilestones.length; j++) {
3036
- var m = opts.depthMilestones[j];
3037
- if (pct >= m && !state.depthHit[m]) {
3038
- state.depthHit[m] = true;
3039
- Metrics.send('depth:' + m + '%');
3040
- }
3041
- }
3042
- }
3043
- }
3044
-
3045
- function onScroll() {
3046
- if (state.anchorCooling) return;
3047
- clearTimeout(state.scrollTimer);
3048
- state._prevY = window.scrollY || window.pageYOffset;
3049
- state.scrollTimer = setTimeout(onScrollSettle, state.options.debounce);
3050
- }
3051
-
3052
- // ── TOC Highlighting (real-time) ──
3053
-
3054
- function updateTocHighlight() {
3055
- var opts = state.options;
3056
- if (!opts.tocSelector) return;
3057
-
3058
- var scrollY = window.scrollY || window.pageYOffset;
3059
- var currentId = '';
3060
-
3061
- for (var i = 0; i < state.tocSections.length; i++) {
3062
- if (scrollY >= state.tocSections[i].el.offsetTop - 160) {
3063
- currentId = state.tocSections[i].id;
3064
- }
3065
- }
3066
-
3067
- var links = document.querySelectorAll(opts.tocSelector);
3068
- for (var j = 0; j < links.length; j++) {
3069
- links[j].classList.remove(opts.tocActiveClass);
3070
- if (links[j].getAttribute('href') === '#' + currentId) {
3071
- links[j].classList.add(opts.tocActiveClass);
3072
- }
3073
- }
3074
- }
3075
-
3076
- // ── Click Tracking ──
3077
-
3078
- function onDocumentClick(e) {
3079
- var a = e.target.closest('a[href]');
3080
- if (!a) return;
3081
-
3082
- var href = a.getAttribute('href') || '';
3083
-
3084
- if (href.charAt(0) === '#') {
3085
- // Anchor click — cooldown to suppress scroll tracking
3086
- state.anchorCooling = true;
3087
- setTimeout(function () { state.anchorCooling = false; },
3088
- state.options.anchorCooldown);
3089
- Metrics.send('anchor:' + href.slice(1));
3090
- return;
3091
- }
3092
-
3093
- // External link
3094
- var label = a.dataset.track || 'link:' + href;
3095
- Metrics.send(label);
3096
- }
3097
-
3098
- // ── Pre-mark Initial State ──
3099
-
3100
- function premarkInitialState() {
3101
- var scrollY = window.scrollY || window.pageYOffset;
3102
-
3103
- for (var i = 0; i < state.sections.length; i++) {
3104
- var rect = state.sections[i].el.getBoundingClientRect();
3105
- if (rect.top >= -100 && rect.top < window.innerHeight) {
3106
- state.seen[state.sections[i].id] = true;
3107
- }
3108
- }
3109
-
3110
- var docH = document.documentElement.scrollHeight - window.innerHeight;
3111
- if (docH > 0) {
3112
- var pct = Math.round((scrollY / docH) * 100);
3113
- for (var j = 0; j < state.options.depthMilestones.length; j++) {
3114
- var m = state.options.depthMilestones[j];
3115
- if (pct >= m) state.depthHit[m] = true;
3116
- }
3117
- }
3118
- }
3119
-
3120
- // ── Public API ──
3121
-
3122
- Metrics.ScrollTracker = {
3123
-
3124
- init: function (options) {
3125
- if (state.initialized) {
3126
- console.warn('Metrics.ScrollTracker already initialized');
3127
- return this;
3128
- }
3129
-
3130
- var opts = {};
3131
- var k;
3132
- for (k in defaults) { if (defaults.hasOwnProperty(k)) opts[k] = defaults[k]; }
3133
- for (k in (options || {})) { if (options.hasOwnProperty(k) && options[k] !== undefined) opts[k] = options[k]; }
3134
- state.options = opts;
3135
- state.initialized = true;
3136
-
3137
- // If Metrics core hasn't been initialized yet with an endpoint,
3138
- // initialize it now from our options
3139
- if (!Metrics._endpoint && options && options.endpoint) {
3140
- Metrics.init({
3141
- endpoint: options.endpoint,
3142
- page: options.page,
3143
- sessionKey: options.sessionKey,
3144
- sessionId: options.sessionId,
3145
- extra: options.extra,
3146
- trackUnload: options.trackUnload
3147
- });
3148
- }
3149
-
3150
- // Delayed init — let scroll restoration settle
3151
- setTimeout(function () {
3152
- state.sections = discoverSections(opts.sections);
3153
-
3154
- if (opts.tocSelector && opts.tocSectionSelector) {
3155
- state.tocSections = discoverSections(opts.tocSectionSelector);
3156
- }
3157
-
3158
- premarkInitialState();
3159
-
3160
- window.addEventListener('scroll', onScroll, { passive: true });
3161
-
3162
- if (opts.tocSelector) {
3163
- window.addEventListener('scroll', updateTocHighlight, { passive: true });
3164
- updateTocHighlight();
3165
- }
3166
- }, opts.initDelay);
3167
-
3168
- if (opts.trackClicks) {
3169
- document.addEventListener('click', onDocumentClick);
3170
- }
3171
-
3172
- return this;
3173
- },
3174
-
3175
- send: function (label, data) { Metrics.send(label, data); },
3176
- markSeen: function (id) { state.seen[id] = true; },
3177
- getSessionId: function () { return Metrics.getSessionId(); },
3178
- getSections: function () {
3179
- return state.sections.map(function (s) {
3180
- return { id: s.id, tag: s.tag, ordinal: s.ordinal, snippet: s.snippet };
3181
- });
3182
- },
3183
- getSeen: function () {
3184
- var copy = {};
3185
- for (var k in state.seen) copy[k] = true;
3186
- return copy;
3187
- },
3188
- reset: function () {
3189
- state.seen = {};
3190
- state.depthHit = {};
3191
- state.anchorCooling = false;
3192
- clearTimeout(state.scrollTimer);
3193
- state.sections = discoverSections(state.options.sections);
3194
- premarkInitialState();
3195
- },
3196
- destroy: function () {
3197
- window.removeEventListener('scroll', onScroll);
3198
- window.removeEventListener('scroll', updateTocHighlight);
3199
- document.removeEventListener('click', onDocumentClick);
3200
- clearTimeout(state.scrollTimer);
3201
- state.initialized = false;
3202
- },
3203
-
3204
- defaults: defaults,
3205
- state: state
3206
- };
3207
-
3208
- })(typeof window !== 'undefined' ? window : this);
3209
-
3210
887
  /**
3211
888
  * Metrics.NavigationTracker — Track how users navigate and explore content
3212
889
  *