werift 0.23.0 → 0.24.0

package/lib/webrtc/src/peerConnection.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultPeerConfig = exports.findCodecByMimeType = exports.RTCPeerConnection = void 0;
+exports.RTCTrackEvent = exports.defaultPeerConfig = exports.findCodecByMimeType = exports.RTCPeerConnection = void 0;
 const crypto_1 = require("crypto");
+const errors_1 = require("./errors");
 const helper_1 = require("./helper");
 const common_1 = require("./imports/common");
 const media_1 = require("./media");
@@ -13,9 +14,92 @@ const secureTransportManager_1 = require("./secureTransportManager");
 const sctp_1 = require("./transport/sctp");
 const utils_1 = require("./utils");
 const log = (0, common_1.debug)("werift:packages/webrtc/src/peerConnection.ts");
+/**
+ * W3C compatibility notes kept near the public RTCPeerConnection surface so the
+ * reviewable diff does not depend on external PR text.
+ *
+ * - `current/pending*Description`, `canTrickleIceCandidates`, `sctp`,
+ *   `addIceCandidate(null)`, and `RTCConfiguration` round-trip behavior are
+ *   implemented here and covered by `tests/wpt/peerConnectionApiCompatibility.test.ts`.
+ * - `addIceCandidate()` also validates `sdpMid` / `sdpMLineIndex` /
+ *   `usernameFragment` against the applied remote description and appends
+ *   candidates or end-of-candidates markers to the corresponding m-section.
+ *   The public API keeps werift's historical pre-SRD buffering behavior, while
+ *   the WPT runner wraps the class to exercise strict spec rejection.
+ * - `bundlePolicy: "balanced"` is accepted for input compatibility but is
+ *   normalized to werift's `"max-compat"` behavior, so `getConfiguration()`
+ *   returns the normalized value.
+ * - `setLocalDescription()` keeps the historical `SessionDescription` return
+ *   value for non-rollback calls, while `{ type: "rollback" }` resolves `void`
+ *   to match the actual behavior without pretending to return a description.
+ * - API reference markdown is regenerated with `cd packages/webrtc && npm run doc`.
+ *   The generated output lives under `packages/webrtc/doc/`; compatibility
+ *   notes remain here and in the package README so review context is visible
+ *   even when generated docs are not committed in the same change.
+ */
 class RTCPeerConnection extends helper_1.EventTarget {
+    get ondatachannel() {
+        return this.eventHandlers.ondatachannel ?? null;
+    }
+    set ondatachannel(value) {
+        this.eventHandlers.ondatachannel = value ?? undefined;
+    }
+    get onicecandidate() {
+        return this.eventHandlers.onicecandidate ?? null;
+    }
+    set onicecandidate(value) {
+        this.eventHandlers.onicecandidate = value ?? undefined;
+    }
+    get onicecandidateerror() {
+        return this.eventHandlers.onicecandidateerror ?? null;
+    }
+    set onicecandidateerror(value) {
+        this.eventHandlers.onicecandidateerror = value ?? undefined;
+    }
+    get onicegatheringstatechange() {
+        return this.eventHandlers.onicegatheringstatechange ?? null;
+    }
+    set onicegatheringstatechange(value) {
+        this.eventHandlers.onicegatheringstatechange = value ?? undefined;
+    }
+    get onnegotiationneeded() {
+        return this.eventHandlers.onnegotiationneeded ?? null;
+    }
+    set onnegotiationneeded(value) {
+        this.eventHandlers.onnegotiationneeded = value ?? undefined;
+    }
+    get onsignalingstatechange() {
+        return this.eventHandlers.onsignalingstatechange ?? null;
+    }
+    set onsignalingstatechange(value) {
+        this.eventHandlers.onsignalingstatechange = value ?? undefined;
+    }
+    get ontrack() {
+        return this.eventHandlers.ontrack ?? null;
+    }
+    set ontrack(value) {
+        this.eventHandlers.ontrack = value ?? undefined;
+    }
+    get onconnectionstatechange() {
+        return this.eventHandlers.onconnectionstatechange ?? null;
+    }
+    set onconnectionstatechange(value) {
+        this.eventHandlers.onconnectionstatechange = value ?? undefined;
+    }
+    get oniceconnectionstatechange() {
+        return this.eventHandlers.oniceconnectionstatechange ?? null;
+    }
+    set oniceconnectionstatechange(value) {
+        this.eventHandlers.oniceconnectionstatechange = value ?? undefined;
+    }
     constructor(config = {}) {
         super();
+        Object.defineProperty(this, "id", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: (0, crypto_1.randomUUID)().toString()
+        });
         Object.defineProperty(this, "cname", {
             enumerable: true,
             configurable: true,
@@ -88,11 +172,23 @@ class RTCPeerConnection extends helper_1.EventTarget {
             writable: true,
             value: false
         });
-        Object.defineProperty(this, "remoteBundleNegotiated", {
+        Object.defineProperty(this, "lastCreatedAnswer", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: false
+            value: void 0
+        });
+        Object.defineProperty(this, "lastCreatedOffer", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "pendingRemoteCandidates", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
         });
         Object.defineProperty(this, "iceGatheringStateChange", {
             enumerable: true,
@@ -154,65 +250,18 @@ class RTCPeerConnection extends helper_1.EventTarget {
             writable: true,
             value: new common_1.Event()
         });
-        Object.defineProperty(this, "ondatachannel", {
+        Object.defineProperty(this, "eventHandlers", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "onicecandidate", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "onicecandidateerror", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "onicegatheringstatechange", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "onnegotiationneeded", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "onsignalingstatechange", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "ontrack", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "onconnectionstatechange", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "oniceconnectionstatechange", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
+            value: {}
         });
         Object.defineProperty(this, "needNegotiation", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: async () => {
+                this.invalidateLastCreatedDescriptions();
                 this.shouldNegotiationneeded = true;
                 if (this.negotiationneeded || this.signalingState !== "stable") {
                     return;
@@ -221,8 +270,10 @@ class RTCPeerConnection extends helper_1.EventTarget {
                 setImmediate(() => {
                     this.negotiationneeded = true;
                     this.onNegotiationneeded.execute();
-                    if (this.onnegotiationneeded)
-                        this.onnegotiationneeded({});
+                    if (this.onnegotiationneeded) {
+                        this.onnegotiationneeded(new globalThis.Event("negotiationneeded"));
+                    }
+                    this.emit("negotiationneeded");
                 });
             }
         });
@@ -234,13 +285,13 @@ class RTCPeerConnection extends helper_1.EventTarget {
         this.transceiverManager = new media_1.TransceiverManager(this.cname, this.config, this.router);
         this.transceiverManager.onTransceiverAdded.pipe(this.onTransceiverAdded);
         this.transceiverManager.onRemoteTransceiverAdded.pipe(this.onRemoteTransceiverAdded);
-        this.transceiverManager.onTrack.subscribe(({ track, stream, transceiver }) => {
-            const event = {
+        this.transceiverManager.onTrack.subscribe(({ track, streams, transceiver }) => {
+            const event = new RTCTrackEvent({
                 track,
-                streams: [stream],
+                streams,
                 transceiver,
                 receiver: transceiver.receiver,
-            };
+            });
             this.onTrack.execute(track);
             this.emit("track", event);
             if (this.ontrack) {
@@ -251,7 +302,7 @@ class RTCPeerConnection extends helper_1.EventTarget {
         this.sctpManager = new sctpManager_1.SctpTransportManager();
         this.sctpManager.onDataChannel.subscribe((channel) => {
             this.onDataChannel.execute(channel);
-            const event = { channel };
+            const event = { type: "datachannel", channel };
             this.ondatachannel?.(event);
             this.emit("datachannel", event);
         });
@@ -260,12 +311,18 @@ class RTCPeerConnection extends helper_1.EventTarget {
             sctpManager: this.sctpManager,
             transceiverManager: this.transceiverManager,
         });
-        this.secureManager.iceGatheringStateChange.pipe(this.iceGatheringStateChange);
+        this.secureManager.iceGatheringStateChange.subscribe((state) => {
+            this.iceGatheringStateChange.execute(state);
+            this.onicegatheringstatechange?.(new globalThis.Event("icegatheringstatechange"));
+            this.emit("icegatheringstatechange");
+        });
         this.secureManager.iceConnectionStateChange.subscribe((state) => {
             if (state === "closed") {
                 this.close();
             }
             this.iceConnectionStateChange.execute(state);
+            this.oniceconnectionstatechange?.();
+            this.emit("iceconnectionstatechange");
         });
         this.secureManager.connectionStateChange.subscribe((state) => {
             this.connectionStateChange.execute(state);
@@ -275,8 +332,12 @@ class RTCPeerConnection extends helper_1.EventTarget {
         this.secureManager.onIceCandidate.subscribe((candidate) => {
             const iceCandidate = candidate ? candidate.toJSON() : undefined;
             this.onIceCandidate.execute(iceCandidate);
-            this.onicecandidate?.({ candidate: iceCandidate });
-            this.emit("icecandidate", { candidate: iceCandidate });
+            const event = {
+                type: "icecandidate",
+                candidate: iceCandidate,
+            };
+            this.onicecandidate?.(event);
+            this.emit("icecandidate", event);
         });
     }
     get connectionState() {
@@ -297,6 +358,9 @@ class RTCPeerConnection extends helper_1.EventTarget {
     get sctpTransport() {
         return this.sctpManager.sctpTransport;
     }
+    get sctp() {
+        return this.sctpTransport ?? null;
+    }
     get sctpRemotePort() {
         return this.sctpManager.sctpRemotePort;
     }
@@ -310,10 +374,35 @@ class RTCPeerConnection extends helper_1.EventTarget {
         return this.iceTransports[0].connection.generation;
     }
     get localDescription() {
-        return this.sdpManager.localDescription;
+        return this.sdpManager.localDescription ?? null;
+    }
+    get currentLocalDescription() {
+        return this.sdpManager.currentLocalDescription?.toJSON() ?? null;
+    }
+    get pendingLocalDescription() {
+        return this.sdpManager.pendingLocalDescription?.toJSON() ?? null;
     }
     get remoteDescription() {
-        return this.sdpManager.remoteDescription;
+        return this.sdpManager.remoteDescription ?? null;
+    }
+    get currentRemoteDescription() {
+        return this.sdpManager.currentRemoteDescription?.toJSON() ?? null;
+    }
+    get pendingRemoteDescription() {
+        return this.sdpManager.pendingRemoteDescription?.toJSON() ?? null;
+    }
+    get canTrickleIceCandidates() {
+        const remoteDescription = this.sdpManager._remoteDescription;
+        if (!remoteDescription) {
+            return null;
+        }
+        const iceOptions = [
+            remoteDescription.iceOptions,
+            ...remoteDescription.media.map((media) => media.iceOptions),
+        ]
+            .filter((value) => !!value)
+            .join(" ");
+        return iceOptions.split(/\s+/).includes("trickle");
     }
     get remoteIsBundled() {
         return this.sdpManager.remoteIsBundled;
@@ -336,7 +425,42 @@ class RTCPeerConnection extends helper_1.EventTarget {
         return this.transceiverManager.getReceivers();
     }
     setConfiguration(config) {
-        (0, utils_1.deepMerge)(this.config, config);
+        const normalizedConfig = normalizePeerConfiguration(config);
+        const isReconfiguration = !!this.sdpManager;
+        if (normalizedConfig.rtcpMuxPolicy &&
+            normalizedConfig.rtcpMuxPolicy !== "require") {
+            throw new Error("rtcpMuxPolicy must be require");
+        }
+        if (normalizedConfig.iceCandidatePoolSize !== undefined &&
+            (!Number.isInteger(normalizedConfig.iceCandidatePoolSize) ||
+                normalizedConfig.iceCandidatePoolSize < 0)) {
+            throw new Error("iceCandidatePoolSize must be a non-negative integer");
+        }
+        if (isReconfiguration &&
+            normalizedConfig.bundlePolicy !== undefined &&
+            normalizedConfig.bundlePolicy !== this.config.bundlePolicy) {
+            throw new Error("bundlePolicy cannot be changed");
+        }
+        if (isReconfiguration &&
+            normalizedConfig.rtcpMuxPolicy !== undefined &&
+            normalizedConfig.rtcpMuxPolicy !== this.config.rtcpMuxPolicy) {
+            throw new Error("rtcpMuxPolicy cannot be changed");
+        }
+        if (isReconfiguration &&
+            normalizedConfig.certificates !== undefined &&
+            !hasSameCertificates(normalizedConfig.certificates, this.config.certificates)) {
+            throw new Error("certificates cannot be changed");
+        }
+        if (isReconfiguration &&
+            normalizedConfig.iceCandidatePoolSize !== undefined &&
+            this.localDescription &&
+            normalizedConfig.iceCandidatePoolSize !== this.config.iceCandidatePoolSize) {
+            throw new Error("iceCandidatePoolSize cannot be changed after setLocalDescription");
+        }
+        if ((normalizedConfig.iceCandidatePoolSize ?? 0) > 0) {
+            throw new Error("iceCandidatePoolSize > 0 is not supported");
+        }
+        (0, utils_1.deepMerge)(this.config, normalizedConfig);
         if (this.config.icePortRange) {
             const [min, max] = this.config.icePortRange;
             if (min === max)
@@ -385,7 +509,7 @@ class RTCPeerConnection extends helper_1.EventTarget {
         });
     }
     getConfiguration() {
-        return this.config;
+        return clonePeerConfiguration(this.config);
     }
     async createOffer({ iceRestart } = {}) {
         if (iceRestart || this.needRestart) {
@@ -403,7 +527,9 @@ class RTCPeerConnection extends helper_1.EventTarget {
             }
         }
         const description = this.sdpManager.buildOfferSdp(this.transceiverManager.getTransceivers(), this.sctpTransport);
-        return description.toJSON();
+        const createdOffer = description.toJSON();
+        this.lastCreatedOffer = createdOffer;
+        return createdOffer;
     }
     createSctpTransport() {
         const sctp = this.sctpManager.createSctpTransport(this.config.maxMessageSize);
@@ -425,19 +551,29 @@ class RTCPeerConnection extends helper_1.EventTarget {
     }
     removeTrack(sender) {
         if (this.isClosed) {
-            throw new Error("peer closed");
+            throw (0, errors_1.createWebRtcDomException)("InvalidStateError", "peer closed");
         }
         this.transceiverManager.removeTrack(sender);
         this.needNegotiation();
     }
+    invalidateLastCreatedDescriptions() {
+        this.lastCreatedAnswer = undefined;
+        this.lastCreatedOffer = undefined;
+    }
+    async waitForPendingDescriptionTask() {
+        this.assertNotClosed();
+        await Promise.resolve();
+        if (this.isClosed) {
+            await new Promise(() => undefined);
+        }
+    }
     findOrCreateTransport() {
         const existingDtlsTransport = this.dtlsTransports.find((transport) => transport.state !== "closed");
         const existing = existingDtlsTransport?.iceTransport;
         // Gather ICE candidates for only one track. If the remote endpoint is not bundle-aware, negotiate only one media track.
         // https://w3c.github.io/webrtc-pc/#rtcbundlepolicy-enum
         if (this.sdpManager.bundlePolicy === "max-bundle" ||
-            (this.sdpManager.bundlePolicy !== "disable" &&
-                (this.remoteIsBundled || this.remoteBundleNegotiated))) {
+            (this.sdpManager.bundlePolicy !== "disable" && this.remoteIsBundled)) {
             if (existingDtlsTransport) {
                 return existingDtlsTransport;
             }
@@ -493,17 +629,48 @@ class RTCPeerConnection extends helper_1.EventTarget {
             "have-local-offer",
             "have-remote-pranswer",
         ];
-        sessionDescription =
-            sessionDescription ??
-                (implicitOfferState.includes(this.signalingState)
-                    ? await this.createOffer()
-                    : await this.createAnswer());
+        await this.waitForPendingDescriptionTask();
+        if (sessionDescription?.type === "rollback") {
+            this.sdpManager.rollbackLocalDescription(this.signalingState);
+            this.setSignalingState("stable");
+            if (this.shouldNegotiationneeded) {
+                this.needNegotiation();
+            }
+            this.invalidateLastCreatedDescriptions();
+            return;
+        }
+        const needsGeneratedDescription = !sessionDescription?.type ||
+            !sessionDescription.sdp ||
+            sessionDescription.sdp.length === 0;
+        const generatedDescription = needsGeneratedDescription
+            ? sessionDescription?.type === "offer"
+                ? (this.lastCreatedOffer ?? (await this.createOffer()))
+                : sessionDescription?.type === "answer" ||
+                    sessionDescription?.type === "pranswer"
+                    ? (this.lastCreatedAnswer ?? (await this.createAnswer()))
+                    : implicitOfferState.includes(this.signalingState)
+                        ? (this.lastCreatedOffer ?? (await this.createOffer()))
+                        : (this.lastCreatedAnswer ?? (await this.createAnswer()))
+            : undefined;
+        sessionDescription = {
+            type: sessionDescription?.type ?? generatedDescription.type,
+            sdp: sessionDescription?.sdp && sessionDescription.sdp.length > 0
+                ? sessionDescription.sdp
+                : generatedDescription.sdp,
+        };
+        if (sessionDescription.type === "offer" &&
+            this.lastCreatedOffer &&
+            sessionDescription.sdp !== this.lastCreatedOffer.sdp) {
+            throw (0, errors_1.createWebRtcDomException)("InvalidModificationError", "setLocalDescription must use the latest created offer");
+        }
         // # parse and validate description
+        const descriptionType = sessionDescription.type;
+        const descriptionSdp = sessionDescription.sdp;
         const description = this.sdpManager.parseSdp({
-            sdp: sessionDescription.sdp,
+            sdp: descriptionSdp,
             isLocal: true,
             signalingState: this.signalingState,
-            type: sessionDescription.type,
+            type: descriptionType,
         });
         // # update signaling state
         if (description.type === "offer") {
@@ -512,6 +679,9 @@ class RTCPeerConnection extends helper_1.EventTarget {
         else if (description.type === "answer") {
             this.setSignalingState("stable");
         }
+        else if (description.type === "pranswer") {
+            this.setSignalingState("have-local-pranswer");
+        }
         // # assign MID
         for (const [i, media] of (0, helper_1.enumerate)(description.media)) {
             const mid = media.rtp.muxId;
@@ -530,7 +700,7 @@ class RTCPeerConnection extends helper_1.EventTarget {
         const role = description.media.find((media) => media.dtlsParams)?.dtlsParams
             ?.role;
         this.secureManager.setLocalRole({
-            type: description.type,
+            type: description.type === "offer" ? "offer" : "answer",
             role,
         });
         // # configure direction
@@ -556,14 +726,56 @@ class RTCPeerConnection extends helper_1.EventTarget {
         if (this.shouldNegotiationneeded) {
             this.needNegotiation();
         }
+        this.invalidateLastCreatedDescriptions();
         return description;
     }
     async gatherCandidates() {
         await this.secureManager.gatherCandidates(!!this.sdpManager.remoteIsBundled);
     }
-    async addIceCandidate(candidateMessage) {
-        const sdp = this.sdpManager.buildOfferSdp(this.transceiverManager.getTransceivers(), this.sctpTransport);
-        await this.secureManager.addIceCandidate(sdp, candidateMessage);
+    async addIceCandidate(candidateMessage = {}) {
+        if (this.isClosed) {
+            throw (0, errors_1.createWebRtcDomException)("InvalidStateError", "is closed");
+        }
+        if (!this.remoteDescription || !this.sdpManager._remoteDescription) {
+            this.pendingRemoteCandidates.push(candidateMessage);
+            return;
+        }
+        await this.applyRemoteIceCandidate(candidateMessage);
+    }
+    async applyRemoteIceCandidate(candidateMessage) {
+        const sdp = this.sdpManager._remoteDescription;
+        if (!sdp) {
+            return;
+        }
+        const appliedCandidate = await this.secureManager.addIceCandidate(sdp, candidateMessage);
+        const remoteDescription = this.sdpManager._remoteDescription;
+        if (!remoteDescription || !appliedCandidate) {
+            return;
+        }
+        if (appliedCandidate.kind === "end-of-candidates") {
+            for (const mediaIndex of appliedCandidate.mediaIndices) {
+                const media = remoteDescription.media[mediaIndex];
+                if (media) {
+                    media.iceCandidatesComplete = true;
+                }
+            }
+            return;
+        }
+        for (const mediaIndex of appliedCandidate.mediaIndices) {
+            const media = remoteDescription.media[mediaIndex];
+            if (!media) {
+                continue;
+            }
+            media.iceCandidates.push(appliedCandidate.candidate);
+        }
+    }
+    async flushPendingRemoteCandidates() {
+        while (this.pendingRemoteCandidates.length > 0 &&
+            this.remoteDescription &&
+            this.sdpManager._remoteDescription) {
+            const candidate = this.pendingRemoteCandidates.shift();
+            await this.applyRemoteIceCandidate(candidate ?? null);
+        }
     }
     async connect() {
         log("start connect");
@@ -608,15 +820,29 @@ class RTCPeerConnection extends helper_1.EventTarget {
         if (sessionDescription instanceof sdp_1.SessionDescription) {
             sessionDescription = sessionDescription.toSdp();
         }
+        await this.waitForPendingDescriptionTask();
+        const needsImplicitLocalRollback = sessionDescription.type === "offer" &&
+            ["have-local-offer", "have-local-pranswer"].includes(this.signalingState);
+        if (needsImplicitLocalRollback) {
+            this.sdpManager.rollbackLocalDescription(this.signalingState);
+            this.shouldNegotiationneeded = true;
+            this.setSignalingState("stable");
+            await Promise.resolve();
+        }
         // # parse and validate description
         const remoteSdp = this.sdpManager.setRemoteDescription(sessionDescription, this.signalingState);
-        if (remoteSdp.group.some((group) => group.semantic === "BUNDLE" && group.items.length > 0)) {
-            this.remoteBundleNegotiated = true;
+        if (!remoteSdp) {
+            this.setSignalingState("stable");
+            if (this.shouldNegotiationneeded) {
+                this.needNegotiation();
+            }
+            this.invalidateLastCreatedDescriptions();
+            return;
         }
         let bundleTransport;
         // # apply description
         const matchTransceiverWithMedia = (transceiver, media) => transceiver.kind === media.kind &&
-            [undefined, media.rtp.muxId].includes(transceiver.mid);
+            [null, media.rtp.muxId].includes(transceiver.mid);
         let transports = remoteSdp.media.map((remoteMedia, i) => {
             let dtlsTransport;
             if (["audio", "video"].includes(remoteMedia.kind)) {
@@ -628,7 +854,7 @@ class RTCPeerConnection extends helper_1.EventTarget {
                     transceiver = this.addTransceiver(remoteMedia.kind, {
                         direction: "recvonly",
                     });
-                    transceiver.mid = remoteMedia.rtp.muxId;
+                    transceiver.mid = remoteMedia.rtp.muxId ?? null;
                     this.onRemoteTransceiverAdded.execute(transceiver);
                 }
                 else {
@@ -677,7 +903,7 @@ class RTCPeerConnection extends helper_1.EventTarget {
                 iceTransport.setRemoteParams(remoteMedia.iceParams, renomination);
                 // One agent full, one lite:  The full agent MUST take the controlling role, and the lite agent MUST take the controlled role
                 // RFC 8445 S6.1.1
-                if (remoteMedia.iceParams?.iceLite) {
+                if (remoteMedia.iceParams.iceLite && !iceTransport.connection.iceLite) {
                     iceTransport.connection.iceControlling = true;
                 }
             }
@@ -716,6 +942,10 @@ class RTCPeerConnection extends helper_1.EventTarget {
         else if (remoteSdp.type === "answer") {
             this.setSignalingState("stable");
         }
+        else if (remoteSdp.type === "pranswer") {
+            this.setSignalingState("have-remote-pranswer");
+        }
+        await this.flushPendingRemoteCandidates();
         // connect transports
         if (remoteSdp.type === "answer") {
             log("caller start connect");
@@ -728,6 +958,7 @@ class RTCPeerConnection extends helper_1.EventTarget {
         if (this.shouldNegotiationneeded) {
             this.needNegotiation();
         }
+        this.invalidateLastCreatedDescriptions();
     }
     addTransceiver(trackOrKind, options = {}) {
         const dtlsTransport = this.findOrCreateTransport();
@@ -737,13 +968,11 @@ class RTCPeerConnection extends helper_1.EventTarget {
         return transceiver;
     }
     // todo fix
-    addTrack(track, 
-    /**todo impl */
-    ms) {
+    addTrack(track, ...streams) {
         if (this.isClosed) {
-            throw new Error("is closed");
+            throw (0, errors_1.createWebRtcDomException)("InvalidStateError", "is closed");
         }
-        const transceiver = this.transceiverManager.addTrack(track, ms);
+        const transceiver = this.transceiverManager.addTrack(track, streams);
         if (!transceiver.dtlsTransport) {
             const dtlsTransport = this.findOrCreateTransport();
             transceiver.setDtlsTransport(dtlsTransport);
@@ -759,54 +988,61 @@ class RTCPeerConnection extends helper_1.EventTarget {
             sctpTransport: this.sctpTransport,
             signalingState: this.signalingState,
         });
-        return description.toJSON();
+        const createdAnswer = description.toJSON();
+        this.lastCreatedAnswer = createdAnswer;
+        return createdAnswer;
     }
     assertNotClosed() {
         if (this.isClosed) {
-            throw new Error("RTCPeerConnection is closed");
+            throw (0, errors_1.createWebRtcDomException)("InvalidStateError", "RTCPeerConnection is closed");
         }
     }
     setSignalingState(state) {
+        if (this.signalingState === state) {
+            return;
+        }
         log("signalingStateChange", state);
         this.signalingState = state;
         this.signalingStateChange.execute(state);
         if (this.onsignalingstatechange) {
-            this.onsignalingstatechange({});
+            this.onsignalingstatechange(new globalThis.Event("signalingstatechange"));
         }
+        this.emit("signalingstatechange");
     }
-    createPeerConnectionStats() {
-        const timestamp = (0, stats_1.getStatsTimestamp)();
+    createPeerConnectionStats(timestamp) {
         return {
             type: "peer-connection",
-            id: (0, stats_1.generateStatsId)("peer-connection"),
+            id: (0, stats_1.generateStatsId)("peer-connection", this.id),
             timestamp,
             dataChannelsOpened: this.sctpManager.dataChannelsOpened,
             dataChannelsClosed: this.sctpManager.dataChannelsClosed,
         };
     }
     async getStats(selector) {
+        const timestamp = (0, stats_1.getStatsTimestamp)();
         const stats = [];
-        // Peer connection stats - always included regardless of selector
-        stats.push(this.createPeerConnectionStats());
-        // Get stats from transceivers
-        const transceiverStats = await this.transceiverManager.getStats(selector);
-        stats.push(...transceiverStats);
-        // Get transport stats - always included regardless of selector
-        const transportStats = await this.secureManager.getStats();
+        if (!selector) {
+            stats.push(this.createPeerConnectionStats(timestamp));
+        }
+        stats.push(...this.transceiverManager.collectStats(timestamp));
+        const transportStats = await this.secureManager.getStats(timestamp);
         stats.push(...transportStats);
-        // Get data channel stats - always included regardless of selector
-        if (this.sctpTransport) {
-            const dataChannelStats = await this.sctpManager.getStats();
+        if (!selector && this.sctpTransport) {
+            const dataChannelStats = await this.sctpManager.getStats(timestamp);
             if (dataChannelStats) {
                 stats.push(...dataChannelStats);
             }
         }
-        return new stats_1.RTCStatsReport(stats);
+        if (!selector) {
+            return (0, stats_1.buildStatsReport)(stats);
+        }
+        return (0, stats_1.buildStatsReport)(stats, this.transceiverManager.getStatsRootIds(selector));
     }
     async close() {
         if (this.isClosed)
             return;
         this.isClosed = true;
+        this.pendingRemoteCandidates.length = 0;
         this.setSignalingState("closed");
         this.transceiverManager.close();
         await this.secureManager.close();
@@ -837,18 +1073,25 @@ function generateDefaultPeerConfig() {
             video: [],
         },
         iceTransportPolicy: "all",
+        iceLite: false,
         iceServers: [{ urls: "stun:stun.l.google.com:19302" }],
         icePortRange: undefined,
         iceInterfaceAddresses: undefined,
         iceAdditionalHostAddresses: undefined,
         iceUseIpv4: true,
         iceUseIpv6: true,
+        iceUseTcp: false,
+        turnTransport: undefined,
+        turnTlsOptions: undefined,
         iceFilterStunResponse: undefined,
         iceFilterCandidatePair: undefined,
         icePasswordPrefix: undefined,
         iceUseLinkLocalAddress: undefined,
         dtls: {},
         bundlePolicy: "max-compat",
+        rtcpMuxPolicy: "require",
+        iceCandidatePoolSize: 0,
+        certificates: [],
         debug: {},
         midSuffix: false,
         forceTurnTCP: false,
@@ -856,4 +1099,110 @@ function generateDefaultPeerConfig() {
     };
 }
 exports.defaultPeerConfig = generateDefaultPeerConfig();
+function normalizePeerConfiguration(config) {
+    const input = Object(config ?? {});
+    const normalizedConfig = { ...input };
+    if (input.bundlePolicy === "balanced") {
+        normalizedConfig.bundlePolicy = "max-compat";
+    }
+    if ("certificates" in input) {
+        if (input.certificates === undefined) {
+            normalizedConfig.certificates = undefined;
+        }
+        else if (!Array.isArray(input.certificates) ||
+            input.certificates.some((certificate) => certificate == null)) {
+            throw (0, errors_1.createWebRtcTypeError)("certificates must be an array of RTCCertificate");
+        }
+        else {
+            normalizedConfig.certificates = [...input.certificates];
+        }
+    }
+    if ("iceCandidatePoolSize" in input) {
+        normalizedConfig.iceCandidatePoolSize = coerceUnsignedShort(input.iceCandidatePoolSize, "iceCandidatePoolSize");
+    }
+    return normalizedConfig;
+}
+function coerceUnsignedShort(value, name) {
+    const coerced = Number(value);
+    if (!Number.isFinite(coerced) ||
+        !Number.isInteger(coerced) ||
+        coerced < 0 ||
+        coerced > 65535) {
+        throw (0, errors_1.createWebRtcTypeError)(`${name} must be an unsigned short`);
+    }
+    return coerced;
+}
+function hasSameCertificates(left, right) {
+    return (left.length === right.length &&
+        left.every((certificate, index) => certificate === right[index]));
+}
+function clonePeerConfiguration(config) {
+    return {
+        ...config,
+        codecs: {
+            audio: config.codecs.audio ? [...config.codecs.audio] : undefined,
+            video: config.codecs.video ? [...config.codecs.video] : undefined,
+        },
+        headerExtensions: {
+            audio: config.headerExtensions.audio
+                ? [...config.headerExtensions.audio]
+                : undefined,
+            video: config.headerExtensions.video
+                ? [...config.headerExtensions.video]
+                : undefined,
+        },
+        iceServers: config.iceServers.map((server) => ({
+            ...server,
+            urls: Array.isArray(server.urls) ? [...server.urls] : server.urls,
+        })),
+        icePortRange: config.icePortRange
+            ? [...config.icePortRange]
+            : undefined,
+        iceAdditionalHostAddresses: config.iceAdditionalHostAddresses
+            ? [...config.iceAdditionalHostAddresses]
+            : undefined,
+        dtls: { ...config.dtls },
+        certificates: [...config.certificates],
+        debug: { ...config.debug },
+    };
+}
+class RTCTrackEvent {
+    constructor(init) {
+        Object.defineProperty(this, "type", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "track"
+        });
+        Object.defineProperty(this, "track", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "streams", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "transceiver", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "receiver", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.track = init.track;
+        this.streams = [...init.streams];
+        this.transceiver = init.transceiver;
+        this.receiver = init.receiver;
+    }
+}
+exports.RTCTrackEvent = RTCTrackEvent;
 //# sourceMappingURL=peerConnection.js.map