fix(web): emit web vitals under the web.vital.* namespace (v0.1.15)

CHANGELOG.md

@@ -7,6 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.15] - 2026-08-10
+
+### Fixed
+
+- Web Vitals now emit their core attributes under the `web.vital.*` namespace.
+  `vital.name`, `vital.value`, `vital.rating`, `vital.id` and
+  `vital.target_selector` were missing the `web.` prefix that every sibling
+  attribute (`web.vital.cls.*`, `web.vital.inp.*`, `web.vital.lcp.*`), the
+  emitted metrics (`web.vital.lcp`, `web.vital.fcp`, …) and the root-span
+  rollups (`web.vital.<name>.value`) already used. Backends projecting
+  `web.vital.name`/`value`/`rating` read empty values, so `web_vital` events
+  rendered without a name or a measurement. The old keys also collided with
+  the mobile `app_vital` schema, which owns `vital.name` and `vital.type`.
+
+  **Breaking for consumers of the old keys:** the previous `vital.*` names are
+  no longer emitted. Telemetry already ingested keeps the old attribute names.
+
 ## [0.1.14] - 2026-08-05
 
 ### Fixed

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base-14/scout-react",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "description": "Zero-config OpenTelemetry RUM for React and React Native. Auto-captures clicks, navigation, errors, lifecycle, network, performance, and web vitals.",
   "license": "MIT",
   "author": "base-14",

src/core/attributes.ts

@@ -231,11 +231,11 @@ export const ATTR = {
   DEVICE_NAME: 'device.name',
   SERVICE_NAME: 'service.name',
   SERVICE_VERSION: 'service.version',
-  WEB_VITAL_NAME: 'vital.name',
-  WEB_VITAL_VALUE: 'vital.value',
-  WEB_VITAL_RATING: 'vital.rating',
-  WEB_VITAL_ID: 'vital.id',
-  WEB_VITAL_TARGET_SELECTOR: 'vital.target_selector',
+  WEB_VITAL_NAME: 'web.vital.name',
+  WEB_VITAL_VALUE: 'web.vital.value',
+  WEB_VITAL_RATING: 'web.vital.rating',
+  WEB_VITAL_ID: 'web.vital.id',
+  WEB_VITAL_TARGET_SELECTOR: 'web.vital.target_selector',
   WEB_VITAL_CLS_PREVIOUS_RECT_X: 'web.vital.cls.previous_rect.x',
   WEB_VITAL_CLS_PREVIOUS_RECT_Y: 'web.vital.cls.previous_rect.y',
   WEB_VITAL_CLS_PREVIOUS_RECT_WIDTH: 'web.vital.cls.previous_rect.width',

src/core/scope.ts

@@ -1,2 +1,2 @@
 export const SCOPE_NAME = 'base14.scout.react';
-export const SCOPE_VERSION = '0.1.14';
+export const SCOPE_VERSION = '0.1.15';

src/web/instrumentations/web-vitals.test.ts

@@ -77,6 +77,27 @@ describe('installWebVitalsTracker', () => {
     expect(spans).toHaveLength(1);
   });
 
+  // Asserted as literal keys, not via ATTR.*, because these strings are the
+  // wire contract the backend projects on: renaming a constant must not be
+  // able to keep this green. `vital.name` in particular belongs to the mobile
+  // app_vital schema — web vitals must not land in that namespace.
+  it('names the core attributes under the web.vital namespace', async () => {
+    await install();
+    fire('LCP', 2400);
+
+    const [span] = recorder.spans().filter((s) => s.name === SPAN.WEB_VITAL);
+    expect(span.attributes).toMatchObject({
+      'web.vital.name': 'LCP',
+      'web.vital.value': 2400,
+      'web.vital.rating': 'good',
+      'web.vital.id': 'v1-LCP',
+    });
+    expect(Object.keys(span.attributes)).not.toContain('vital.name');
+    expect(Object.keys(span.attributes)).not.toContain('vital.value');
+    expect(Object.keys(span.attributes)).not.toContain('vital.rating');
+    expect(Object.keys(span.attributes)).not.toContain('vital.id');
+  });
+
   // The observers cannot be torn down, so reinstalling must reuse the existing
   // registration rather than stacking another one. Without this, a host that
   // mounts the SDK n times reports every subsequent vital n times over.