@100mslive/hms-video-store 0.15.2-alpha.0 → 0.15.2-alpha.2

package/dist/analytics/AnalyticsEventFactory.d.ts

@@ -51,6 +51,17 @@ export default class AnalyticsEventFactory {
         unproven: boolean;
         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.
+     */
+    static publishAnswerDiscarded(properties: {
+        reason: 'connection_replaced' | 'superseded_offer' | 'unexpected_state';
+        action: string;
+        signaling_state: RTCSignalingState;
+        transport_state: string;
+        epoch: number;
+    }): AnalyticsEvent;
     /** no attempt was answered, so the SFU is left on a state nobody asked for */
     static subscribeRequestUnanswered(properties: {
         method: string;

package/dist/connection/HMSConnection.d.ts

@@ -22,6 +22,8 @@ export default abstract class HMSConnection {
     readonly candidates: RTCIceCandidateInit[];
     sfuNodeId?: string;
     selectedCandidatePair?: RTCIceCandidatePair;
+    /** Monotonic id of the local description this connection is staging. */
+    private localDescriptionEpoch;
     protected constructor(role: HMSConnectionRole, signal: JsonRpcSignal);
     get iceConnectionState(): RTCIceConnectionState;
     get connectionState(): RTCPeerConnectionState;
@@ -31,7 +33,13 @@ export default abstract class HMSConnection {
     addTransceiver(track: MediaStreamTrack, init: RTCRtpTransceiverInit): RTCRtpTransceiver;
     createOffer(tracks?: Map<string, TrackState>, options?: RTCOfferOptions): Promise<RTCSessionDescriptionInit>;
     createAnswer(options?: RTCOfferOptions | undefined): Promise<RTCSessionDescriptionInit>;
-    setLocalDescription(description: RTCSessionDescriptionInit): Promise<void>;
+    /** True while `epoch` is still the newest local description staged on this connection. */
+    isStagingLocalDescription(epoch: number): boolean;
+    /**
+     * Returns the epoch of the offer just staged. Bumped on entry, before the native call is
+     * chained onto the operations queue, so a racer is visible from the moment it starts.
+     */
+    setLocalDescription(description: RTCSessionDescriptionInit): Promise<number>;
     setRemoteDescription(description: RTCSessionDescriptionInit): Promise<void>;
     addIceCandidate(candidate: RTCIceCandidateInit): Promise<void>;
     get remoteDescription(): RTCSessionDescription | null;

package/dist/error/ErrorCodes.d.ts

@@ -36,6 +36,7 @@ export declare const ErrorCodes: {
         ICE_FAILURE: number;
         ICE_DISCONNECTED: number;
         STATS_FAILED: number;
+        PUBLISH_ANSWER_SUPERSEDED: number;
     };
     WebsocketMethodErrors: {
         SERVER_ERRORS: number;

package/dist/error/ErrorFactory.d.ts

@@ -37,6 +37,8 @@ export declare const ErrorFactory: {
         CreateAnswerFailed(action: HMSAction, description?: string): HMSException;
         SetLocalDescriptionFailed(action: HMSAction, description?: string): HMSException;
         SetRemoteDescriptionFailed(action: HMSAction, description?: string): HMSException;
+        /** The offer this answer replies to is no longer staged. Non-terminal: the owner retries. */
+        PublishAnswerSuperseded(action: HMSAction, description?: string): HMSException;
         ICEFailure(action: HMSAction, description?: string, isTerminal?: boolean): HMSException;
         ICEDisconnected(action: HMSAction, description?: string): HMSException;
         StatsFailed(action: HMSAction, description?: string): HMSException;