@devvit/web-view-scripts 0.13.7-next-2026-07-06-22-55-50-e17da017f.0 → 0.13.7

package/telemetry.js

@@ -2,7 +2,7 @@ import { EffectType } from '@devvit/protos/json/devvit/ui/effects/v1alpha/effect
 import { emitEffect } from '@devvit/shared-types/client/emit-effect.js';
 import { emitTelemetryClickEffect } from '@devvit/shared-types/client/telemetry.js';
 let telemetryMetrics;
-/** startTime (UTC milliseconds) is provided by the client within the bridge context for native-clock metrics. */
+/** startTime (UTC milliseconds) is provided by the client within the bridge context, to be used for all metrics */
 let startTime;
 // Render duration still needs an emit guard because both FCP and navigation callbacks can attempt it.
 let renderDurationSent = false;
@@ -56,10 +56,27 @@ function measureTtfb() {
         timeEnd: startTime + navigationTiming.responseStart,
     };
 }
-function buildTimeOriginMetric(spanName, offset) {
+/**
+ * Builds both the legacy v1 metric and the clock-aligned v2 metric for a span.
+ *
+ * The v1 metric keeps its historical (flawed) anchoring of the native `startTime`
+ * clock against a `performance.timeOrigin`-relative offset, preserving the existing
+ * series. The v2 metric anchors `timeStart` to `performance.timeOrigin`, the same
+ * clock the offset is measured from, so its absolute timestamps are correct while
+ * the duration stays identical to v1.
+ */
+function buildMetricPair(spanName, offset) {
+    if (!startTime) {
+        return [];
+    }
     return [
         {
             spanName,
+            timeStart: startTime,
+            timeEnd: startTime + offset,
+        },
+        {
+            spanName: `${spanName}_v2`,
             timeStart: performance.timeOrigin,
             timeEnd: performance.timeOrigin + offset,
         },
@@ -103,13 +120,16 @@ function maybeMeasureRenderDuration() {
 function measureFcp() {
     const paintEntries = performance.getEntriesByType('paint');
     const fcpEntry = paintEntries.find((entry) => entry.name === 'first-contentful-paint');
-    if (!fcpEntry) {
+    if (!fcpEntry || !startTime) {
         return [];
     }
-    return buildTimeOriginMetric('web_view_first_contentful_paint', fcpEntry.startTime);
+    return buildMetricPair('web_view_first_contentful_paint', fcpEntry.startTime);
 }
 function measureLoad() {
-    return buildTimeOriginMetric('web_view_load', performance.now());
+    if (!startTime) {
+        return [];
+    }
+    return buildMetricPair('web_view_load', performance.now());
 }
 function measureLoadEventEnd(navigationTiming = getNavigationTiming()) {
     return navigationTiming && navigationTiming.loadEventEnd > 0
@@ -138,16 +158,19 @@ function emitRenderDuration() {
  */
 function measureTti() {
     const navTiming = getNavigationTiming();
-    const ttiTime = navTiming?.domInteractive;
-    if (!ttiTime) {
+    const ttiTime = navTiming.domInteractive;
+    if (!startTime || !ttiTime) {
         return [];
     }
-    return buildTimeOriginMetric('web_view_time_to_interactive', ttiTime);
+    return buildMetricPair('web_view_time_to_interactive', ttiTime);
 }
 function initPerformanceMonitoring() {
     telemetryMetrics = [];
     startTime = globalThis.devvit?.startTime;
     renderDurationSent = false;
+    if (!startTime) {
+        return;
+    }
     const initialization = measureWebViewInitialization();
     if (initialization)
         telemetryMetrics.push(initialization);