mockrtc 0.1.0

package/dist/webrtc/rtc-connection.js

@@ -0,0 +1,370 @@
+"use strict";
+/*
+ * SPDX-FileCopyrightText: 2022 Tim Perry <tim@httptoolkit.tech>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RTCConnection = void 0;
+const crypto_1 = require("crypto");
+const events_1 = require("events");
+const SDP = require("sdp-transform");
+const NodeDataChannel = require("node-datachannel");
+const datachannel_stream_1 = require("./datachannel-stream");
+const mediatrack_stream_1 = require("./mediatrack-stream");
+/**
+ * An RTC connection is a single connection. This base class defines the raw connection management and
+ * tracking logic for a generic connection. The MockRTCConnection subclass extends this and adds
+ * logic to support control channels, proxying and other MockRTC-specific additions.
+ */
+class RTCConnection extends events_1.EventEmitter {
+    constructor() {
+        super();
+        this.id = (0, crypto_1.randomUUID)();
+        // Set to null when the connection is closed, as otherwise calling any method (including checking
+        // the connection state) will segfault the process.
+        this.rawConn = new NodeDataChannel.PeerConnection("MockRTCConnection", { iceServers: [] });
+        this.trackedChannels = [];
+        this.trackedMediaTracks = [];
+        this.sessionApi = {
+            sessionId: this.id,
+            createOffer: (options = {}) => __awaiter(this, void 0, void 0, function* () {
+                if (options.mirrorSDP) {
+                    return this.getMirroredLocalOffer(options.mirrorSDP, {
+                        addDataStream: !!options.addDataStream
+                    });
+                }
+                else {
+                    return this.getLocalDescription();
+                }
+            }),
+            completeOffer: (answer) => __awaiter(this, void 0, void 0, function* () {
+                this.setRemoteDescription(answer);
+            }),
+            answerOffer: (offer, options = {}) => __awaiter(this, void 0, void 0, function* () {
+                this.setRemoteDescription(offer);
+                if (options.mirrorSDP) {
+                    return this.getMirroredLocalAnswer(options.mirrorSDP);
+                }
+                else {
+                    return this.getLocalDescription();
+                }
+            })
+        };
+        this.rawConn.onDataChannel((channel) => {
+            if (!this.rawConn)
+                return; // https://github.com/murat-dogan/node-datachannel/issues/103
+            this.trackNewChannel(channel, { isLocal: false });
+        });
+        this.rawConn.onTrack((track) => {
+            if (!this.rawConn)
+                return; // https://github.com/murat-dogan/node-datachannel/issues/103
+            this.trackNewMediaTrack(track, { isLocal: false });
+        });
+        // Important to remember that only node-dc only allows one listener per event. To handle that,
+        // we reemit important events here to use normal node event methods instead:
+        this.rawConn.onStateChange((state) => {
+            this.emit('connection-state-changed', state);
+        });
+        this.on('connection-state-changed', (state) => {
+            if (state === 'closed')
+                this.emit('connection-closed');
+        });
+    }
+    get channels() {
+        return this.trackedChannels
+            .map(channel => channel.stream);
+    }
+    get localChannels() {
+        return this.trackedChannels
+            .filter(channel => channel.isLocal)
+            .map(channel => channel.stream);
+    }
+    get remoteChannels() {
+        return this.trackedChannels
+            .filter(channel => !channel.isLocal)
+            .map(channel => channel.stream);
+    }
+    get mediaTracks() {
+        return this.trackedMediaTracks
+            .map(track => track.stream);
+    }
+    get localMediaTracks() {
+        return this.trackedMediaTracks
+            .filter(track => track.isLocal)
+            .map(track => track.stream);
+    }
+    get remoteMediaTracks() {
+        return this.trackedMediaTracks
+            .filter(track => !track.isLocal)
+            .map(track => track.stream);
+    }
+    createDataChannel(label) {
+        if (!this.rawConn)
+            throw new Error("Can't create data channel after connection is closed");
+        const channel = this.rawConn.createDataChannel(label);
+        return this.trackNewChannel(channel, { isLocal: true });
+    }
+    trackNewChannel(channel, options) {
+        const channelStream = new datachannel_stream_1.DataChannelStream(channel);
+        this.trackedChannels.push({ stream: channelStream, isLocal: options.isLocal });
+        channelStream.on('close', () => {
+            const channelIndex = this.trackedChannels.findIndex(c => c.stream === channelStream);
+            if (channelIndex !== -1) {
+                this.trackedChannels.splice(channelIndex, 1);
+            }
+        });
+        channelStream.on('error', (error) => {
+            console.error('Channel error:', error);
+        });
+        this.emit('channel-open', channelStream);
+        if (options.isLocal) {
+            this.emit('local-channel-open', channelStream);
+        }
+        else {
+            this.emit('remote-channel-open', channelStream);
+        }
+        return channelStream;
+    }
+    trackNewMediaTrack(track, options) {
+        const trackStream = new mediatrack_stream_1.MediaTrackStream(track);
+        this.trackedMediaTracks.push({ stream: trackStream, isLocal: options.isLocal });
+        trackStream.on('close', () => {
+            const trackIndex = this.trackedMediaTracks.findIndex(c => c.stream === trackStream);
+            if (trackIndex !== -1) {
+                this.trackedChannels.splice(trackIndex, 1);
+            }
+        });
+        trackStream.on('error', (error) => {
+            console.error('Media track error:', error);
+        });
+        this.emit('track-open', trackStream);
+        if (options.isLocal) {
+            this.emit('local-track-open', trackStream);
+        }
+        else {
+            this.emit('remote-track-open', trackStream);
+        }
+        return trackStream;
+    }
+    setRemoteDescription(description) {
+        if (!this.rawConn)
+            throw new Error("Can't set remote description after connection is closed");
+        this.remoteDescription = description;
+        const { type: offerType, sdp: offerSdp } = description;
+        if (!offerSdp)
+            throw new Error("Cannot set MockRTC peer description without providing an SDP");
+        this.rawConn.setRemoteDescription(offerSdp, offerType[0].toUpperCase() + offerType.slice(1));
+    }
+    /**
+     * Gets the local description for this connection, waiting until gathering is complete to provide a
+     * full result. Because this waits for gathering, it will not resolve if no DataChannel, other
+     * tracks or remote description have been provided beforehand.
+     */
+    getLocalDescription() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.rawConn)
+                throw new Error("Can't get local description after connection is closed");
+            let setupChannel;
+            if (this.rawConn.gatheringState() === 'new') {
+                // We can't create an offer until we have something to negotiate, but we don't want to
+                // negotiate ourselves when we don't really know what's being negotiated here. To work
+                // around that, we create a channel to trigger gathering & get an offer, and then we
+                // remove it before the offer is delivered, so it's never visible remotely.
+                setupChannel = this.rawConn.createDataChannel('mockrtc.setup-channel');
+            }
+            yield new Promise((resolve) => {
+                this.rawConn.onGatheringStateChange((state) => {
+                    if (state === 'complete')
+                        resolve();
+                });
+                // Handle race conditions where gathering has already completed
+                if (this.rawConn.gatheringState() === 'complete')
+                    resolve();
+            });
+            if (!this.rawConn)
+                throw new Error("Connection was closed while building local description");
+            const sessionDescription = this.rawConn.localDescription();
+            setupChannel === null || setupChannel === void 0 ? void 0 : setupChannel.close(); // Close the temporary setup channel, if we created one
+            return sessionDescription;
+        });
+    }
+    getRemoteDescription() {
+        if (!this.rawConn)
+            throw new Error("Can't get remote description after connection is closed");
+        return this.remoteDescription;
+    }
+    getMirroredLocalOffer(sdpToMirror, options = {}) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.rawConn)
+                throw new Error("Can't get local description after connection is closed");
+            const offerToMirror = SDP.parse(sdpToMirror);
+            const mediaStreamsToMirror = offerToMirror.media.filter(media => media.type !== 'application');
+            const shouldMirrorDataStream = offerToMirror.media.some(media => media.type === 'application');
+            mediaStreamsToMirror.forEach((mediaToMirror) => {
+                var _a, _b;
+                // Skip media tracks that we already have
+                if (this.mediaTracks.find(({ mid }) => mid === mediaToMirror.mid))
+                    return;
+                const mid = mediaToMirror.mid.toString();
+                const direction = sdpDirectionToNDCDirection(mediaToMirror.direction);
+                const media = mediaToMirror.type === 'video'
+                    ? new NodeDataChannel.Video(mid, direction)
+                    : new NodeDataChannel.Audio(mid, direction);
+                // Copy SSRC data (awkward translation between per-attr and full-value structures)
+                const ssrcs = (_b = (_a = mediaToMirror.ssrcs) === null || _a === void 0 ? void 0 : _a.reduce((ssrcs, kv) => {
+                    var _a;
+                    ssrcs[_a = kv.id] || (ssrcs[_a] = {});
+                    ssrcs[kv.id][kv.attribute] = kv.value;
+                    return ssrcs;
+                }, {})) !== null && _b !== void 0 ? _b : {};
+                Object.keys(ssrcs).forEach((id) => {
+                    var _a, _b;
+                    const ssrcAttrs = ssrcs[id];
+                    const [msid, trackId] = (_b = (_a = ssrcAttrs.msid) === null || _a === void 0 ? void 0 : _a.split(' ')) !== null && _b !== void 0 ? _b : [];
+                    if (!msid) {
+                        media.addSSRC(parseInt(id, 10), ssrcAttrs['cname']);
+                    }
+                    else {
+                        media.addSSRC(parseInt(id, 10), ssrcAttrs['cname'], msid, trackId);
+                    }
+                });
+                const track = this.rawConn.addTrack(media);
+                this.trackNewMediaTrack(track, { isLocal: true });
+            });
+            let setupChannel;
+            const channelRequiredForDescription = this.rawConn.gatheringState() === 'new' &&
+                !mediaStreamsToMirror.length;
+            if (shouldMirrorDataStream || channelRequiredForDescription || options.addDataStream) {
+                // See getLocalDescription() above: if we want a description and we have no media, we
+                // need to make a stub channel to allow us to negotiate _something_.
+                // In addition, we might actually have data channels to mirror. In that case, we need
+                // to create a temporary data channel to force that negotiation (which will be closed
+                // again shortly, so that it never actually gets created).
+                setupChannel = this.rawConn.createDataChannel('mockrtc.setup-channel');
+            }
+            this.rawConn.setLocalDescription("Offer" /* Offer */);
+            yield new Promise((resolve) => {
+                this.rawConn.onGatheringStateChange((state) => {
+                    if (state === 'complete')
+                        resolve();
+                });
+                // Handle race conditions where gathering has already completed
+                if (this.rawConn.gatheringState() === 'complete')
+                    resolve();
+            });
+            if (!this.rawConn)
+                throw new Error("Connection was closed while building the local description");
+            const localDesc = this.rawConn.localDescription();
+            setupChannel === null || setupChannel === void 0 ? void 0 : setupChannel.close(); // Close the temporary setup channel, if we created one
+            const offerSDP = SDP.parse(localDesc.sdp);
+            mirrorMediaParams(offerToMirror, offerSDP);
+            localDesc.sdp = SDP.write(offerSDP);
+            return localDesc;
+        });
+    }
+    getMirroredLocalAnswer(sdpToMirror) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const localDesc = this.rawConn.localDescription();
+            const answerToMirror = SDP.parse(sdpToMirror);
+            const answerSDP = SDP.parse(localDesc.sdp);
+            mirrorMediaParams(answerToMirror, answerSDP);
+            localDesc.sdp = SDP.write(answerSDP);
+            return localDesc;
+        });
+    }
+    waitUntilConnected() {
+        return new Promise((resolve, reject) => {
+            if (!this.rawConn)
+                throw new Error("Connection closed while/before waiting until connected");
+            this.on('connection-state-changed', (state) => {
+                if (state === 'connected')
+                    resolve();
+                if (state === 'failed') {
+                    reject(new Error("Connection failed while waiting for connection"));
+                }
+            });
+            if (this.rawConn.state() === 'connected')
+                resolve();
+            if (this.rawConn.state() === 'failed') {
+                reject(new Error("Connection failed while waiting for connection"));
+            }
+        });
+    }
+    close() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.rawConn)
+                return; // Already closed
+            const { rawConn } = this;
+            this.rawConn = null; // Drop the reference, so nothing tries to use it after close
+            if (rawConn.state() === 'closed')
+                return;
+            rawConn.close();
+            this.emit('connection-closed');
+        });
+    }
+}
+exports.RTCConnection = RTCConnection;
+function sdpDirectionToNDCDirection(direction) {
+    if (direction === 'inactive')
+        return "Inactive" /* Inactive */;
+    else if ((direction === null || direction === void 0 ? void 0 : direction.length) === 8) {
+        return direction[0].toUpperCase() +
+            direction.slice(1, 4) +
+            direction[4].toUpperCase() +
+            direction.slice(5);
+    }
+    else {
+        return "Unknown" /* Unknown */;
+    }
+}
+;
+/**
+ * Takes two parsed descriptions (typically a real description we want to mock, and our own current
+ * self-generated description) and modifies the target description sure that the media params for
+ * each stream in the source description match.
+ *
+ * In theory, this should guarantee that RTP packets generated by the source and forwarded through
+ * the target's connection can be interpreted by somebody connected to the target.
+ */
+function mirrorMediaParams(source, target) {
+    target.msidSemantic = source.msidSemantic;
+    const sourceMediaStreams = source.media.filter(m => m.type !== 'application');
+    sourceMediaStreams.forEach((sourceMedia) => {
+        const targetMedia = target.media
+            .find((targetMedia) => targetMedia.mid === sourceMedia.mid);
+        if (!targetMedia) {
+            throw new Error(`Missing mid ${sourceMedia.mid} in target when mirroring media params`);
+        }
+        if (sourceMedia.type !== targetMedia.type) {
+            throw new Error(`Unexpected media type (${targetMedia.type}) for mid ${targetMedia.mid} when mirroring media params`);
+        }
+        // Copy all the semantic parameters of the RTP & RTCP streams themselves, so that RTP packets
+        // can be forwarded correctly, but without copying the fingerprint or similar, so we can still
+        // act as a MitM to intercept the packets:
+        targetMedia.msid = sourceMedia.msid;
+        targetMedia.protocol = sourceMedia.protocol;
+        targetMedia.ext = sourceMedia.ext;
+        targetMedia.payloads = sourceMedia.payloads;
+        targetMedia.rtp = sourceMedia.rtp;
+        targetMedia.fmtp = sourceMedia.fmtp;
+        targetMedia.rtcp = sourceMedia.rtcp;
+        targetMedia.rtcpFb = sourceMedia.rtcpFb;
+        targetMedia.ssrcGroups = sourceMedia.ssrcGroups;
+        // SSRC info is especially important here: this is used to map RTP SSRCs to track mids, so if
+        // this is incorrect, the recipient track will not receive the data we're sending.
+        // Although in some cases we do already have some SSRC info here, for offers where we've already
+        // defined the tracks ourselves, libdatachannel doesn't support all params and it's best to copy
+        // the full definition itself directly to make sure they match:
+        targetMedia.ssrcs = sourceMedia.ssrcs;
+    });
+}
+//# sourceMappingURL=rtc-connection.js.map

package/dist/webrtc/rtc-connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtc-connection.js","sourceRoot":"","sources":["../../src/webrtc/rtc-connection.ts"],"names":[],"mappings":"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"}

package/dist/webrtc-hooks.d.ts

@@ -0,0 +1,30 @@
+import type { MockRTCPeer } from "./mockrtc-peer";
+/**
+ * Hooks a given RTCPeerConnection so that all connections it creates are automatically proxied
+ * through the given MockRTCPeer.
+ *
+ * This allows you to capture traffic without modifying your WebRTC code: you can create
+ * offers/answers and signal them to a remote client as normal, and both the local and remote
+ * connections will connect to MockRTC instead.
+ *
+ * What happens once they connect depends on the configuration of the given peer. This mocked
+ * local connection will follow the steps defined by the peer, so may receive mocked messages
+ * injected there, or delays, or anything else. The remote peer will receive nothing until
+ * a proxy step is reached (if ever), at which point the local & remote peers will be able to
+ * talking directly, although all traffic will still be proxied through MockRTC for logging
+ * and analysis/validation elsewhere.
+ *
+ * It is possible to proxy both real peers in a connection, potentially with different mock
+ * peers so that they experience different behaviours during the connection.
+ *
+ * @category API
+ */
+export declare function hookWebRTCConnection(conn: RTCPeerConnection, mockPeer: MockRTCPeer): void;
+/**
+ * Modifies the global RTCPeerConnection constructor to hook all WebRTC connections
+ * created after this function is called, and redirect all their traffic to the
+ * provided MockRTCPeer.
+ *
+ * @category API
+ */
+export declare function hookAllWebRTC(mockPeer: MockRTCPeer): void;

package/dist/webrtc-hooks.js

@@ -0,0 +1,224 @@
+"use strict";
+/*
+ * SPDX-FileCopyrightText: 2022 Tim Perry <tim@httptoolkit.tech>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hookAllWebRTC = exports.hookWebRTCConnection = void 0;
+const control_channel_1 = require("./webrtc/control-channel");
+/*
+ * In this file, we define hooks which can automatically wrap an RTCPeerConnection so that the
+ * normal calls to initialize a connection instead proxy the connection through MockRTC.
+ *
+ * This is quite complicated and confusing! There's four connection endpoints to be aware of:
+ * - The original RTCPeerConnection that's being hooked here to connect to a mock ('internal')
+ * - A MockRTC connection with an associated MockRTCPeer that it will actually connect to ('mock')
+ * - The original remote peer that we're connecting to ('remote')
+ * - A MockRTC external connection that will connect to the remote peer ('external')
+ *
+ * The connection structure works like so:
+ * INTERNAL <--> MOCK <-?-> EXTERNAL <--> REMOTE
+ *
+ * Internal+Mock and External+Remote are connected via real WebRTC connections. Mock+External are
+ * connected within MockRTC once mockConnection.proxyTrafficTo(externalConnection) is called,
+ * which happens if/when a proxy step is reached (i.e. this depends on the configuration of the
+ * mock peer).
+ *
+ * Note that in extra complicated cases, both peers might be hooked, in which case REMOTE is
+ * actually the EXTERNAL for a second mirrored structure. We can mostly ignore this as it's
+ * handled implicitly.
+ */
+/**
+ * Hooks a given RTCPeerConnection so that all connections it creates are automatically proxied
+ * through the given MockRTCPeer.
+ *
+ * This allows you to capture traffic without modifying your WebRTC code: you can create
+ * offers/answers and signal them to a remote client as normal, and both the local and remote
+ * connections will connect to MockRTC instead.
+ *
+ * What happens once they connect depends on the configuration of the given peer. This mocked
+ * local connection will follow the steps defined by the peer, so may receive mocked messages
+ * injected there, or delays, or anything else. The remote peer will receive nothing until
+ * a proxy step is reached (if ever), at which point the local & remote peers will be able to
+ * talking directly, although all traffic will still be proxied through MockRTC for logging
+ * and analysis/validation elsewhere.
+ *
+ * It is possible to proxy both real peers in a connection, potentially with different mock
+ * peers so that they experience different behaviours during the connection.
+ *
+ * @category API
+ */
+function hookWebRTCConnection(conn, mockPeer) {
+    // Anything that creates signalling data (createOffer/createAnswer) needs to be hooked to
+    // return the params for the external connected.
+    // Anything that sets params (setLocal/RemoteDescription) needs to be hooked to send those
+    // params to the external connection, create new equivalent mock params for the mock connection
+    // and give those to the internal connection.
+    const _createOffer = conn.createOffer.bind(conn);
+    const _createAnswer = conn.createAnswer.bind(conn);
+    const _setLocalDescription = conn.setLocalDescription.bind(conn);
+    const _setRemoteDescription = conn.setRemoteDescription.bind(conn);
+    // The offers/answers we've generated, and the params needed to use them later:
+    let pendingCreatedOffers = {};
+    let pendingCreatedAnswers = {};
+    // The offer/answer we generated that we're actually using, once one is selected:
+    let selectedDescription;
+    // A mirrored offer from the mock conn to the internal conn, mirroring an incoming offer we
+    // received from the remote conn. This is stored so that when we pick an answer it can be
+    // completed, and so that createAnswer can wait until generation is complete before running.
+    let mockOffer;
+    // We create a control channel to communicate with MockRTC once the connection is set up.
+    // That's created immediately, so its in the initial SDP, to avoid later negotation.
+    const controlChannel = conn.createDataChannel(control_channel_1.MOCKRTC_CONTROL_CHANNEL);
+    new Promise((resolve) => {
+        controlChannel.onopen = () => resolve();
+    }).then(() => {
+        controlChannel.send(JSON.stringify({
+            type: 'attach-external',
+            id: selectedDescription.id
+        }));
+    });
+    conn.createOffer = ((options) => __awaiter(this, void 0, void 0, function* () {
+        const realOffer = yield _createOffer(options);
+        const externalOfferParams = yield mockPeer.createExternalOffer({
+            mirrorSDP: realOffer.sdp
+        });
+        const externalOffer = externalOfferParams.offer;
+        pendingCreatedOffers[externalOffer.sdp] = Object.assign(Object.assign({}, externalOfferParams), { realOffer });
+        return externalOffer;
+    }));
+    conn.createAnswer = ((options) => __awaiter(this, void 0, void 0, function* () {
+        yield mockOffer; // If we have a pending offer, wait for that first - we can't answer without it.
+        const realAnswer = yield _createAnswer(options);
+        const pendingAnswerParams = yield mockPeer.answerExternalOffer(conn.pendingRemoteDescription, {
+            mirrorSDP: realAnswer.sdp
+        });
+        const externalAnswer = pendingAnswerParams.answer;
+        pendingCreatedAnswers[externalAnswer.sdp] = Object.assign(Object.assign({}, pendingAnswerParams), { realAnswer });
+        return externalAnswer;
+    }));
+    // Mock all mutations of the connection description:
+    conn.setLocalDescription = ((localDescription) => __awaiter(this, void 0, void 0, function* () {
+        if (!localDescription) {
+            if (["stable", "have-local-offer", "have-remote-pranswer"].includes(conn.signalingState)) {
+                localDescription = yield conn.createOffer();
+            }
+            else {
+                localDescription = yield conn.createAnswer();
+            }
+        }
+        // When we set an offer or answer locally, it must be the external offer/answer we've
+        // generated to send to the other peer. We swap it back for a real equivalent that will
+        // connect us to the mock peer instead:
+        if (localDescription.type === 'offer') {
+            pendingLocalDescription = localDescription;
+            selectedDescription = pendingCreatedOffers[localDescription.sdp];
+            const { realOffer } = selectedDescription;
+            yield _setLocalDescription(realOffer);
+        }
+        else {
+            selectedDescription = pendingCreatedAnswers[localDescription.sdp];
+            const { realAnswer } = selectedDescription;
+            yield Promise.all([
+                // Complete the mock side of the internal connection:
+                (yield mockOffer).setAnswer(realAnswer),
+                // Complete the internal side of the internal connection:
+                _setLocalDescription(realAnswer)
+            ]);
+            currentLocalDescription = localDescription;
+            currentRemoteDescription = pendingRemoteDescription;
+            pendingLocalDescription = null;
+            pendingRemoteDescription = null;
+        }
+    }));
+    conn.setRemoteDescription = ((remoteDescription) => __awaiter(this, void 0, void 0, function* () {
+        if (remoteDescription.type === 'offer') {
+            // We have an offer! Remember it, so we can createAnswer shortly.
+            pendingRemoteDescription = remoteDescription;
+            // We persist the mock offer synchronously, so we can check for it in createAnswer
+            // and avoid race conditions where we fail to create an answer before this method
+            // hasn't yet completed.
+            mockOffer = mockPeer.createOffer({
+                mirrorSDP: remoteDescription.sdp,
+                addDataStream: true
+            });
+            yield _setRemoteDescription((yield mockOffer).offer);
+        }
+        else {
+            // We have an answer - we must've sent an offer, complete & use that:
+            const { setAnswer, realOffer } = selectedDescription;
+            yield Promise.all([
+                // Complete the external <-> remote connection:
+                setAnswer(remoteDescription),
+                // Complete the internal <-> mock connection:
+                mockPeer.answerOffer(realOffer, {
+                    mirrorSDP: remoteDescription.sdp
+                }).then(({ answer }) => _setRemoteDescription(answer))
+            ]);
+            currentLocalDescription = pendingLocalDescription;
+            currentRemoteDescription = remoteDescription;
+            pendingLocalDescription = null;
+            pendingRemoteDescription = null;
+        }
+    }));
+    // Mock various props that expose the connection description:
+    let pendingLocalDescription = null;
+    Object.defineProperty(conn, 'pendingLocalDescription', {
+        get: () => pendingLocalDescription
+    });
+    let currentLocalDescription = null;
+    Object.defineProperty(conn, 'currentLocalDescription', {
+        get: () => currentLocalDescription
+    });
+    Object.defineProperty(conn, 'localDescription', {
+        get: () => { var _a; return (_a = conn.pendingLocalDescription) !== null && _a !== void 0 ? _a : conn.currentLocalDescription; }
+    });
+    let pendingRemoteDescription = null;
+    Object.defineProperty(conn, 'pendingRemoteDescription', {
+        get: () => pendingRemoteDescription
+    });
+    let currentRemoteDescription = null;
+    Object.defineProperty(conn, 'currentRemoteDescription', {
+        get: () => currentRemoteDescription
+    });
+    Object.defineProperty(conn, 'remoteDescription', {
+        get: () => { var _a; return (_a = conn.pendingRemoteDescription) !== null && _a !== void 0 ? _a : conn.currentRemoteDescription; }
+    });
+    Object.defineProperty(conn, 'onicecandidate', {
+        get: () => { },
+        set: () => { } // Ignore this completely - never call the callback
+    });
+    // For now we ignore incoming ice candidates. They're really intended for the external connection,
+    // not us, but also they're rarely necessary since we should be using local connections and MockRTC
+    // itself always waits rather than trickling candidates.
+    conn.addIceCandidate = () => Promise.resolve();
+}
+exports.hookWebRTCConnection = hookWebRTCConnection;
+/**
+ * Modifies the global RTCPeerConnection constructor to hook all WebRTC connections
+ * created after this function is called, and redirect all their traffic to the
+ * provided MockRTCPeer.
+ *
+ * @category API
+ */
+function hookAllWebRTC(mockPeer) {
+    // The original constructor
+    const _RTCPeerConnection = window.RTCPeerConnection;
+    window.RTCPeerConnection = function () {
+        const connection = new _RTCPeerConnection(...arguments);
+        hookWebRTCConnection(connection, mockPeer);
+        return connection;
+    };
+    window.RTCPeerConnection.prototype = _RTCPeerConnection.prototype;
+}
+exports.hookAllWebRTC = hookAllWebRTC;
+//# sourceMappingURL=webrtc-hooks.js.map

package/dist/webrtc-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webrtc-hooks.js","sourceRoot":"","sources":["../src/webrtc-hooks.ts"],"names":[],"mappings":"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"}