@streaming-cdn/rtc-web 1.3.20 → 1.3.22

package/README.md

@@ -1,4 +1,4 @@
-# RTC Web SDK 1.3.20
+# RTC Web SDK 1.3.21
 
 The customer package contains compiled ESM/UMD JavaScript and TypeScript declarations. It intentionally excludes implementation source and source maps. Example source remains available under `examples/`.
 
@@ -356,3 +356,14 @@ Abnormal close, reconnect, and recovery duration are also sent as bounded
 operational diagnostics. Tokens, SDP, media, and chat content are never part of
 that report. Set `reportSignalingDiagnostics: false` only when replacing this
 with an application-owned diagnostics pipeline.
+
+## 1.3.21 notes
+
+- Per-peer quality: a `bandwidth` limitation reason counts against a link only
+  when the measured uplink does not comfortably clear the current tier
+  (`bandwidthHeadroomRatio`, default 1.25) — encoder ramp-up during the first
+  minute no longer forces a downgrade.
+- Quality samples carry direction-explicit resolutions:
+  `inboundFrameWidth/Height` (received; equals the historical
+  `frameWidth/Height`) and `outboundFrameWidth/Height` (what your encoder
+  sends).

package/dist/index.d.ts

@@ -101,8 +101,21 @@ export interface RtcQualitySample {
     outboundBitrateBps: number | null;
     availableOutgoingBitrateBps: number | null;
     framesPerSecond: number | null;
+    /**
+     * INBOUND (received) resolution — the remote side's picture, which moves
+     * with THEIR quality tier, not yours (N3: an integrator saw "low" record a
+     * larger frame than "medium" and reasonably read it as a bug). Kept under
+     * the historical names for compatibility; prefer the direction-explicit
+     * fields below.
+     */
     frameWidth: number | null;
     frameHeight: number | null;
+    /** Received (inbound) video resolution — same values as frameWidth/frameHeight. */
+    inboundFrameWidth: number | null;
+    inboundFrameHeight: number | null;
+    /** Sent (outbound) video resolution — what YOUR encoder is producing. */
+    outboundFrameWidth: number | null;
+    outboundFrameHeight: number | null;
     framesDropped: number | null;
     freezeCount: number | null;
     freezeDurationMs: number | null;
@@ -364,4 +377,4 @@ export declare class RtcIncomingClient extends EventTarget {
     private emit;
 }
 export declare function createRtcIncomingClient(options: RtcIncomingClientOptions): RtcIncomingClient;
-export declare const version = "1.3.20";
+export declare const version = "1.3.22";

package/dist/peer-quality.d.ts

@@ -37,6 +37,8 @@ export interface PeerQualityThresholds {
     goodLossPct: number;
     goodRttMs: number;
     sustainRatio: number;
+    /** "bandwidth" counts only when the uplink estimate is below this multiple of the tier target. */
+    bandwidthHeadroomRatio: number;
 }
 export declare const defaultPeerQualityThresholds: PeerQualityThresholds;
 export interface PeerQualitySample {