@observertc/observer-js 1.0.0-beta.22 → 1.0.0-beta.23

package/dist/index.d.mts

@@ -141,7 +141,7 @@ type IceCandidatePairStats = {
     /**
     * The checklist state of this candidate pair. Values follow the W3C RTCStatsIceCandidatePairState enum (frozen, waiting, in-progress, failed, succeeded). Two further values are accepted for backward compatibility and are not part of the current spec: `new` (never standardised) and `cancelled` (removed from the spec after 2016).
     */
-    state?: 'new' | 'frozen' | 'in-progress' | 'waiting' | 'failed' | 'succeeded' | 'cancelled' | 'inprogress';
+    state?: "new" | "frozen" | "in-progress" | "waiting" | "failed" | "succeeded" | "cancelled" | "inprogress";
     /**
     * Whether this candidate pair has been nominated.
     */
@@ -1265,9 +1265,9 @@ type OutboundTrackSample = {
     */
     score?: number;
     /**
-    * Details for score calculation
+    * Reasons for the score calculation, mapping each reason to how much it contributed to the score
     */
-    scoreReasons?: string[];
+    scoreReasons?: Record<string, number>;
     /**
     * Additional information attached to this stats
     */
@@ -1294,9 +1294,9 @@ type InboundTrackSample = {
     */
     score?: number;
     /**
-    * Details for score calculation
+    * Reasons for the score calculation, mapping each reason to how much it contributed to the score
     */
-    scoreReasons?: string[];
+    scoreReasons?: Record<string, number>;
     /**
     * Additional information attached to this stats
     */
@@ -1319,9 +1319,9 @@ type PeerConnectionSample = {
     */
     score?: number;
     /**
-    * Details for score calculation
+    * Reasons for the score calculation, mapping each reason to how much it contributed to the score
     */
-    scoreReasons?: string[];
+    scoreReasons?: Record<string, number>;
     /**
     * Inbound Track Stats items
     */
@@ -1408,9 +1408,9 @@ type ClientSample = {
     */
     score?: number;
     /**
-    * Details for score calculation
+    * Reasons for the score calculation, mapping each reason to how much it contributed to the score
     */
-    scoreReasons?: string[];
+    scoreReasons?: Record<string, number>;
     /**
     * Samples taken PeerConnections
     */

package/dist/index.d.ts

@@ -141,7 +141,7 @@ type IceCandidatePairStats = {
     /**
     * The checklist state of this candidate pair. Values follow the W3C RTCStatsIceCandidatePairState enum (frozen, waiting, in-progress, failed, succeeded). Two further values are accepted for backward compatibility and are not part of the current spec: `new` (never standardised) and `cancelled` (removed from the spec after 2016).
     */
-    state?: 'new' | 'frozen' | 'in-progress' | 'waiting' | 'failed' | 'succeeded' | 'cancelled' | 'inprogress';
+    state?: "new" | "frozen" | "in-progress" | "waiting" | "failed" | "succeeded" | "cancelled" | "inprogress";
     /**
     * Whether this candidate pair has been nominated.
     */
@@ -1265,9 +1265,9 @@ type OutboundTrackSample = {
     */
     score?: number;
     /**
-    * Details for score calculation
+    * Reasons for the score calculation, mapping each reason to how much it contributed to the score
     */
-    scoreReasons?: string[];
+    scoreReasons?: Record<string, number>;
     /**
     * Additional information attached to this stats
     */
@@ -1294,9 +1294,9 @@ type InboundTrackSample = {
     */
     score?: number;
     /**
-    * Details for score calculation
+    * Reasons for the score calculation, mapping each reason to how much it contributed to the score
     */
-    scoreReasons?: string[];
+    scoreReasons?: Record<string, number>;
     /**
     * Additional information attached to this stats
     */
@@ -1319,9 +1319,9 @@ type PeerConnectionSample = {
     */
     score?: number;
     /**
-    * Details for score calculation
+    * Reasons for the score calculation, mapping each reason to how much it contributed to the score
     */
-    scoreReasons?: string[];
+    scoreReasons?: Record<string, number>;
     /**
     * Inbound Track Stats items
     */
@@ -1408,9 +1408,9 @@ type ClientSample = {
     */
     score?: number;
     /**
-    * Details for score calculation
+    * Reasons for the score calculation, mapping each reason to how much it contributed to the score
     */
-    scoreReasons?: string[];
+    scoreReasons?: Record<string, number>;
     /**
     * Samples taken PeerConnections
     */

package/dist/index.js

@@ -1547,6 +1547,24 @@ function parseJsonObject(value) {
   const parsed = parseJsonAs(value);
   return typeof parsed === "object" && parsed !== null && !Array.isArray(parsed) ? parsed : void 0;
 }
+function normalizeScoreReasons(value) {
+  if (value === void 0 || value === null) return void 0;
+  const result = {};
+  if (Array.isArray(value)) {
+    for (const entry of value) {
+      if (typeof entry !== "string" || entry.length === 0) continue;
+      result[entry] = 0;
+    }
+  } else if (typeof value === "object") {
+    for (const [key, magnitude] of Object.entries(value)) {
+      if (typeof magnitude !== "number" || !Number.isFinite(magnitude)) continue;
+      result[key] = magnitude;
+    }
+  } else {
+    return void 0;
+  }
+  return Object.keys(result).length === 0 ? void 0 : result;
+}
 
 // src/ObservedOutboundTrack.ts
 var ObservedOutboundTrack = class {
@@ -2827,6 +2845,16 @@ var ObservedClient = class extends import_events2.EventEmitter {
     this.usingTCP = false;
     this.currentMinRttInMs = void 0;
     this.currentMaxRttInMs = void 0;
+    sample.scoreReasons = normalizeScoreReasons(sample.scoreReasons);
+    for (const pcSample of sample.peerConnections ?? []) {
+      pcSample.scoreReasons = normalizeScoreReasons(pcSample.scoreReasons);
+      for (const trackSample of pcSample.inboundTracks ?? []) {
+        trackSample.scoreReasons = normalizeScoreReasons(trackSample.scoreReasons);
+      }
+      for (const trackSample of pcSample.outboundTracks ?? []) {
+        trackSample.scoreReasons = normalizeScoreReasons(trackSample.scoreReasons);
+      }
+    }
     this._mergePendingInjections(sample);
     this._activeSample = sample;
     const clientEventsPostBuffer = [];