@100mslive/hms-video-store 0.15.2-alpha.3 → 0.15.2-alpha.5

package/dist/analytics/AnalyticsEventFactory.d.ts

@@ -6,6 +6,7 @@ import { HMSException } from '../error/HMSException';
 import { DeviceMap, SelectedDevices } from '../interfaces';
 import { HMSTrackSettings } from '../media/settings/HMSTrackSettings';
 import { HMSRemoteVideoTrack } from '../media/tracks/HMSRemoteVideoTrack';
+import { PublishAnswerDiscardReason } from '../transport/models/PublishAnswerDiscardReason';
 export default class AnalyticsEventFactory {
     private static KEY_REQUESTED_AT;
     private static KEY_RESPONDED_AT;
@@ -52,15 +53,27 @@ export default class AnalyticsEventFactory {
         sent: boolean;
     }): AnalyticsEvent;
     /**
-     * A publish answer was dropped because the offer it answers is no longer staged.
-     * `action` names the owner that must re-drive; `reason` separates the three causes.
+     * A migration that did not finish. `reason` separates a deliberate abort — a newer migration
+     * owns the peer — from a genuine failure, which nothing retries.
+     */
+    static sfuMigrationIncomplete({ reason, sfuNodeId, transportState, error, }: {
+        reason: 'superseded' | 'failed';
+        sfuNodeId?: string;
+        transportState: string;
+        error?: HMSException;
+    }): AnalyticsEvent;
+    /**
+     * A publish answer was dropped because the offer it answers is no longer staged, or the waiter
+     * for it was settled without one. `action` names the owner that must re-drive; `reason`
+     * separates the five causes. The two waiter-level ones have no offer in flight, so they carry
+     * no `epoch`/`signaling_state`.
      */
     static publishAnswerDiscarded(properties: {
-        reason: 'connection_replaced' | 'superseded_offer' | 'unexpected_state';
+        reason: PublishAnswerDiscardReason;
         action: string;
-        signaling_state: RTCSignalingState;
+        signaling_state?: RTCSignalingState;
         transport_state: string;
-        epoch: number;
+        epoch?: number;
     }): AnalyticsEvent;
     /** no attempt was answered, so the SFU is left on a state nobody asked for */
     static subscribeRequestUnanswered(properties: {

package/dist/connection/HMSConnection.d.ts

@@ -22,7 +22,7 @@ export default abstract class HMSConnection {
     readonly candidates: RTCIceCandidateInit[];
     sfuNodeId?: string;
     selectedCandidatePair?: RTCIceCandidatePair;
-    /** Monotonic id of the local description this connection is staging. */
+    /** Monotonic id of the most recently requested local description (bumped on entry, not on apply). */
     private localDescriptionEpoch;
     protected constructor(role: HMSConnectionRole, signal: JsonRpcSignal);
     get iceConnectionState(): RTCIceConnectionState;
@@ -31,6 +31,8 @@ export default abstract class HMSConnection {
     private get action();
     setSfuNodeId(nodeId?: string): void;
     addTransceiver(track: MediaStreamTrack, init: RTCRtpTransceiverInit): RTCRtpTransceiver;
+    /** True when the transceiver is still attached to this connection. */
+    hasTransceiver(transceiver?: RTCRtpTransceiver): boolean;
     createOffer(tracks?: Map<string, TrackState>, options?: RTCOfferOptions): Promise<RTCSessionDescriptionInit>;
     createAnswer(options?: RTCOfferOptions | undefined): Promise<RTCSessionDescriptionInit>;
     /** True while `epoch` is still the newest local description staged on this connection. */
@@ -41,6 +43,11 @@ export default abstract class HMSConnection {
      */
     setLocalDescription(description: RTCSessionDescriptionInit): Promise<number>;
     setRemoteDescription(description: RTCSessionDescriptionInit): Promise<void>;
+    /**
+     * Applies the answer, then flushes the candidates onTrickle buffered before any remote
+     * description. Gated on this being the first answer; after it onTrickle adds directly.
+     */
+    setRemoteDescriptionAndDrainCandidates(description: RTCSessionDescriptionInit): Promise<void>;
     addIceCandidate(candidate: RTCIceCandidateInit): Promise<void>;
     get remoteDescription(): RTCSessionDescription | null;
     getSenders(): Array<RTCRtpSender>;