feat: set/create events

cspell.json

@@ -36,7 +36,8 @@
     "Wcme",
     "WCME",
     "webex",
-    "webrtc"
+    "webrtc",
+    "sdpchange"
   ],
   "flagWords": [],
   "ignorePaths": [

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webex/webrtc-core",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "browser": "dist/umd/index.js",

src/peer-connection.ts

@@ -24,14 +24,22 @@ type IceGatheringStateChangeEvent = {
   target: EventTarget | null;
 };
 
+type SdpChangeEvent = {
+  type: 'offer' | 'answer';
+  munged: boolean;
+  sdp?: string;
+};
+
 enum PeerConnectionEvents {
   IceGatheringStateChange = 'icegatheringstatechange',
   ConnectionStateChange = 'connectionstatechange',
+  SdpChange = 'sdpchange',
 }
 
 interface PeerConnectionEventHandlers extends EventMap {
   [PeerConnectionEvents.IceGatheringStateChange]: (ev: IceGatheringStateChangeEvent) => void;
   [PeerConnectionEvents.ConnectionStateChange]: (state: ConnectionState) => void;
+  [PeerConnectionEvents.SdpChange]: (ev: SdpChangeEvent) => void;
 }
 
 type ConnectionType = 'UDP' | 'TCP' | 'TURN-TLS' | 'TURN-TCP' | 'TURN-UDP' | 'unknown';
@@ -186,7 +194,13 @@ class PeerConnection extends EventEmitter<PeerConnectionEventHandlers> {
    *    That received offer should be delivered through the signaling server to a remote peer.
    */
   async createOffer(options?: RTCOfferOptions): Promise<RTCSessionDescriptionInit> {
-    return this.pc.createOffer(options);
+    const offer = await this.pc.createOffer(options);
+    this.emit(PeerConnection.Events.SdpChange, {
+      type: 'offer',
+      munged: false,
+      sdp: offer.sdp,
+    });
+    return offer;
   }
 
   /**
@@ -215,6 +229,12 @@ class PeerConnection extends EventEmitter<PeerConnectionEventHandlers> {
         });
     }
 
+    this.emit(PeerConnection.Events.SdpChange, {
+      type: 'offer',
+      munged: true,
+      sdp: description?.sdp,
+    });
+
     return this.pc.setLocalDescription(description);
   }
 
@@ -230,6 +250,12 @@ class PeerConnection extends EventEmitter<PeerConnectionEventHandlers> {
   async setRemoteDescription(
     description: RTCSessionDescription | RTCSessionDescriptionInit
   ): Promise<void> {
+    this.emit(PeerConnection.Events.SdpChange, {
+      type: 'answer',
+      munged: true,
+      sdp: description.sdp,
+    });
+
     return this.pc.setRemoteDescription(description);
   }
 
@@ -344,4 +370,4 @@ class PeerConnection extends EventEmitter<PeerConnectionEventHandlers> {
 }
 
 export { ConnectionState } from './connection-state-handler';
-export { MediaStreamTrackKind, RTCDataChannelOptions, PeerConnection };
+export { MediaStreamTrackKind, RTCDataChannelOptions, PeerConnection, SdpChangeEvent };