mockrtc 0.1.0

package/dist/client/mockrtc-client.js

@@ -0,0 +1,67 @@
+"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.MockRTCClient = void 0;
+const graphql_tag_1 = require("graphql-tag");
+// Long-term, it'd be great to use the 'official' export path of mockttp/pluggable-admin, but
+// if we do so, then TypeScript <4.7 doesn't understand it here or downstream, so we get errors.
+// We don't want to use the main-exported version to avoid bundling all of Mockttp in browsers.
+// For now we have to use the direct import. We can update once TS 4.7 is widely used.
+const BrowserPluggableAdmin = require("mockttp/dist/pluggable-admin-api/pluggable-admin.browser");
+const mockrtc_remote_peer_1 = require("./mockrtc-remote-peer");
+const handler_builder_1 = require("../handling/handler-builder");
+class MockRTCClient {
+    constructor(options = {}) {
+        this.options = options;
+        this.buildPeerFromData = (handlerSteps) => __awaiter(this, void 0, void 0, function* () {
+            const { adminStream } = this.adminClient;
+            const peerData = yield this.adminClient.sendQuery({
+                query: (0, graphql_tag_1.default) `
+                mutation CreatePeer($peerData: RTCHandlerData!) {
+                    createPeer(data: $peerData) {
+                        peerId
+                    }
+                }
+            `,
+                variables: {
+                    peerData: {
+                        steps: handlerSteps.map(step => BrowserPluggableAdmin.Serialization.serialize(step, adminStream))
+                    }
+                },
+                transformResponse: ({ createPeer }) => createPeer
+            });
+            const { peerId } = peerData;
+            return new mockrtc_remote_peer_1.MockRTCRemotePeer(peerId, this.adminClient);
+        });
+        this.adminClient = new BrowserPluggableAdmin.AdminClient(options);
+    }
+    buildPeer() {
+        return new handler_builder_1.MockRTCHandlerBuilder(this.buildPeerFromData);
+    }
+    start() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.adminClient.start({
+                webrtc: this.options
+            });
+        });
+    }
+    stop() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.adminClient.stop();
+        });
+    }
+}
+exports.MockRTCClient = MockRTCClient;
+//# sourceMappingURL=mockrtc-client.js.map

package/dist/client/mockrtc-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mockrtc-client.js","sourceRoot":"","sources":["../../src/client/mockrtc-client.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;AAEH,6CAA8B;AAE9B,6FAA6F;AAC7F,gGAAgG;AAChG,+FAA+F;AAC/F,sFAAsF;AACtF,kGAAkG;AAOlG,+DAA0D;AAC1D,iEAAoE;AAOpE,MAAa,aAAa;IAItB,YACY,UAAgC,EAAE;QAAlC,YAAO,GAAP,OAAO,CAA2B;QAStC,sBAAiB,GAAG,CAAO,YAAqC,EAAwB,EAAE;YAC9F,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC;YAEzC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,CAG/C;gBACE,KAAK,EAAE,IAAA,qBAAG,EAAA;;;;;;aAMT;gBACD,SAAS,EAAE;oBACP,QAAQ,EAAE;wBACN,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAC3B,qBAAqB,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,EAAE,WAAW,CAAC,CACnE;qBACJ;iBACJ;gBACD,iBAAiB,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,UAAU;aACpD,CAAC,CAAC;YAEH,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;YAE5B,OAAO,IAAI,uCAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAC3D,CAAC,CAAA,CAAA;QAlCG,IAAI,CAAC,WAAW,GAAG,IAAI,qBAAqB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACtE,CAAC;IAED,SAAS;QACL,OAAO,IAAI,uCAAqB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC7D,CAAC;IA+BK,KAAK;;YACP,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;gBACzB,MAAM,EAAE,IAAI,CAAC,OAAO;aACvB,CAAC,CAAC;QACP,CAAC;KAAA;IAEK,IAAI;;YACN,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAClC,CAAC;KAAA;CACJ;AApDD,sCAoDC"}

package/dist/client/mockrtc-remote-peer.d.ts

@@ -0,0 +1,15 @@
+/// <reference types="node" />
+import * as PluggableAdmin from 'mockttp/dist/pluggable-admin-api/pluggable-admin.browser';
+import { MockRTCPeer, MockRTCOfferParams, MockRTCExternalOfferParams, MockRTCExternalAnswerParams, MockRTCAnswerParams, MockRTCSession, OfferOptions, AnswerOptions } from "../mockrtc-peer";
+export declare class MockRTCRemotePeer implements MockRTCPeer {
+    readonly peerId: string;
+    private adminClient;
+    constructor(peerId: string, adminClient: PluggableAdmin.AdminClient<{}>);
+    createOffer(options?: OfferOptions): Promise<MockRTCOfferParams>;
+    createExternalOffer(options?: OfferOptions): Promise<MockRTCExternalOfferParams>;
+    answerOffer(offer: RTCSessionDescriptionInit, options?: AnswerOptions): Promise<MockRTCAnswerParams>;
+    answerExternalOffer(offer: RTCSessionDescriptionInit, options?: AnswerOptions): Promise<MockRTCExternalAnswerParams>;
+    getSession(sessionId: string): MockRTCSession;
+    getAllMessages(): Promise<(string | Buffer)[]>;
+    getMessagesOnChannel(channelName: string): Promise<Array<string | Buffer>>;
+}

package/dist/client/mockrtc-remote-peer.js

@@ -0,0 +1,246 @@
+"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.MockRTCRemotePeer = void 0;
+const graphql_tag_1 = require("graphql-tag");
+class MockRTCRemotePeer {
+    constructor(peerId, adminClient) {
+        this.peerId = peerId;
+        this.adminClient = adminClient;
+    }
+    createOffer(options) {
+        return this.adminClient.sendQuery({
+            query: (0, graphql_tag_1.gql) `
+                mutation GetPeerRTCOffer($peerId: ID!, $options: Raw) {
+                    createOffer(peerId: $peerId, options: $options) {
+                        id
+                        description {
+                            type
+                            sdp
+                        }
+                    }
+                }
+            `,
+            variables: { peerId: this.peerId, options },
+            transformResponse: ({ createOffer }) => {
+                const session = this.getSession(createOffer.id);
+                return {
+                    offer: createOffer.description,
+                    session,
+                    setAnswer: session.completeOffer.bind(session)
+                };
+            }
+        });
+    }
+    createExternalOffer(options) {
+        return this.adminClient.sendQuery({
+            query: (0, graphql_tag_1.gql) `
+                mutation GetPeerRTCExternalOffer($peerId: ID!, $options: Raw) {
+                    createExternalOffer(peerId: $peerId, options: $options) {
+                        id
+                        description {
+                            type
+                            sdp
+                        }
+                    }
+                }
+            `,
+            variables: { peerId: this.peerId, options },
+            transformResponse: ({ createExternalOffer }) => {
+                const session = this.getSession(createExternalOffer.id);
+                return {
+                    id: createExternalOffer.id,
+                    offer: createExternalOffer.description,
+                    session,
+                    setAnswer: session.completeOffer.bind(session)
+                };
+            }
+        });
+    }
+    answerOffer(offer, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.adminClient.sendQuery({
+                query: (0, graphql_tag_1.gql) `
+                mutation GetPeerRTCAnswer(
+                    $peerId: ID!,
+                    $offer: SessionDescriptionInput!,
+                    $options: Raw
+                ) {
+                    answerOffer(peerId: $peerId, offer: $offer, options: $options) {
+                        id
+                        description {
+                            type
+                            sdp
+                        }
+                    }
+                }
+            `,
+                variables: { peerId: this.peerId, offer, options },
+                transformResponse: ({ answerOffer }) => ({
+                    answer: answerOffer.description,
+                    session: this.getSession(answerOffer.id)
+                })
+            });
+        });
+    }
+    answerExternalOffer(offer, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.adminClient.sendQuery({
+                query: (0, graphql_tag_1.gql) `
+                mutation GetPeerRTCExternalAnswer(
+                    $peerId: ID!,
+                    $offer: SessionDescriptionInput!,
+                    $options: Raw
+                ) {
+                    answerExternalOffer(peerId: $peerId, offer: $offer, options: $options) {
+                        id
+                        description {
+                            type
+                            sdp
+                        }
+                    }
+                }
+            `,
+                variables: { peerId: this.peerId, offer, options },
+                transformResponse: ({ answerExternalOffer }) => {
+                    const session = this.getSession(answerExternalOffer.id);
+                    return {
+                        id: answerExternalOffer.id,
+                        answer: answerExternalOffer.description,
+                        session
+                    };
+                }
+            });
+        });
+    }
+    getSession(sessionId) {
+        return new RemoteSessionApi(this.adminClient, this.peerId, sessionId);
+    }
+    getAllMessages() {
+        return this.adminClient.sendQuery({
+            query: (0, graphql_tag_1.gql) `
+                query GetPeerSeenMessages($peerId: ID!) {
+                    getSeenMessages(peerId: $peerId)
+                }
+            `,
+            variables: { peerId: this.peerId },
+            transformResponse: ({ getSeenMessages }) => {
+                return getSeenMessages.map((message) => {
+                    if (typeof message === 'string') {
+                        return message;
+                    }
+                    else if (message.type === 'buffer') {
+                        return Buffer.from(message.value, 'base64');
+                    }
+                    else {
+                        throw new Error(`Unparseable message data: ${JSON.stringify(message)}`);
+                    }
+                });
+            }
+        });
+    }
+    getMessagesOnChannel(channelName) {
+        return this.adminClient.sendQuery({
+            query: (0, graphql_tag_1.gql) `
+                query GetPeerSeenMessages($peerId: ID!, $channelName: String) {
+                    getSeenMessages(peerId: $peerId, channelName: $channelName)
+                }
+            `,
+            variables: { peerId: this.peerId, channelName },
+            transformResponse: ({ getSeenMessages }) => {
+                return getSeenMessages.map((message) => {
+                    if (typeof message === 'string') {
+                        return message;
+                    }
+                    else if (message.type === 'buffer') {
+                        return Buffer.from(message.value, 'base64');
+                    }
+                    else {
+                        throw new Error(`Unparseable message data: ${JSON.stringify(message)}`);
+                    }
+                });
+            }
+        });
+    }
+}
+exports.MockRTCRemotePeer = MockRTCRemotePeer;
+class RemoteSessionApi {
+    constructor(adminClient, peerId, sessionId) {
+        this.adminClient = adminClient;
+        this.peerId = peerId;
+        this.sessionId = sessionId;
+    }
+    createOffer(options) {
+        return this.adminClient.sendQuery({
+            query: (0, graphql_tag_1.gql) `
+                mutation GetPeerRTCSessionOffer($peerId: ID!, $sessionId: ID!, $options: Raw) {
+                    createOffer(peerId: $peerId, sessionId: $sessionId, options: $options) {
+                        description {
+                            type
+                            sdp
+                        }
+                    }
+                }
+            `,
+            variables: { peerId: this.peerId, sessionId: this.sessionId, options },
+            transformResponse: ({ createOffer }) => createOffer.description
+        });
+    }
+    completeOffer(answer) {
+        return this.adminClient.sendQuery({
+            query: (0, graphql_tag_1.gql) `
+                mutation CompletePeerRTCOffer(
+                    $peerId: ID!,
+                    $sessionId: ID!,
+                    $answer: SessionDescriptionInput!
+                ) {
+                    completeOffer(peerId: $peerId, sessionId: $sessionId, answer: $answer)
+                }
+            `,
+            variables: {
+                peerId: this.peerId,
+                sessionId: this.sessionId,
+                answer: answer
+            }
+        });
+    }
+    answerOffer(offer, options) {
+        return this.adminClient.sendQuery({
+            query: (0, graphql_tag_1.gql) `
+                mutation GetPeerRTCAnswer(
+                    $peerId: ID!,
+                    $sessionId: ID!,
+                    $offer: SessionDescriptionInput!,
+                    $options: Raw
+                ) {
+                    answerOffer(peerId: $peerId, sessionId: $sessionId, offer: $offer, options: $options) {
+                        description {
+                            type
+                            sdp
+                        }
+                    }
+                }
+            `,
+            variables: {
+                peerId: this.peerId,
+                sessionId: this.sessionId,
+                offer,
+                options
+            },
+            transformResponse: ({ answerOffer }) => answerOffer.description
+        });
+    }
+}
+//# sourceMappingURL=mockrtc-remote-peer.js.map

package/dist/client/mockrtc-remote-peer.js.map

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

package/dist/control-channel.d.ts

@@ -0,0 +1,8 @@
+export declare const MOCKRTC_CONTROL_CHANNEL = "mockrtc.control-channel";
+export declare type MockRTCControLMessage = {
+    type: 'error';
+    error: string;
+} | {
+    type: 'attach-external';
+    id: string;
+};

package/dist/control-channel.js

@@ -0,0 +1,11 @@
+"use strict";
+/*
+ * SPDX-FileCopyrightText: 2022 Tim Perry <tim@httptoolkit.tech>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MOCKRTC_CONTROL_CHANNEL = void 0;
+// The WebRTC control channel name & protocol used when communicating metadata to about client
+// configuration, e.g. the external connection to bridge to.
+exports.MOCKRTC_CONTROL_CHANNEL = "mockrtc.control-channel";
+//# sourceMappingURL=control-channel.js.map

package/dist/control-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-channel.js","sourceRoot":"","sources":["../src/control-channel.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,8FAA8F;AAC9F,4DAA4D;AAC/C,QAAA,uBAAuB,GAAG,yBAAyB,CAAC"}

package/dist/handling/handler-builder.d.ts

@@ -0,0 +1,138 @@
+/// <reference types="node" />
+import { type HandlerStepDefinition } from "./handler-step-definitions";
+/**
+ * The builder logic for composing RTC handling behaviour for both mock peers and rules,
+ * by internally queuing defined actions until a `.thenX()` method is called to compile
+ * the actions into either a peer or a rule (handled by an constructor callback param).
+ */
+export declare class MockRTCHandlerBuilder<R> {
+    private buildCallback;
+    private handlerSteps;
+    constructor(buildCallback: (handlerSteps: HandlerStepDefinition[]) => Promise<R>);
+    /**
+     * Wait for a given duration, in milliseconds
+     *
+     * @category Steps
+     */
+    sleep(duration: number): this;
+    /**
+     * Wait until the remote client has created at least one DataChannel.
+     *
+     * @category Steps
+     */
+    waitForChannel(channelLabel?: string): this;
+    /**
+     * Wait until the remote client has created at least one media track
+     *
+     * @category Steps
+     */
+    waitForTrack(): this;
+    /**
+     * Wait until the remote client next sends a message to us on any DataChannel.
+     *
+     * This looks for new messages, ignoring any messages already consumed by
+     * previous steps.
+     *
+     * @category Steps
+     */
+    waitForNextMessage(): this;
+    /**
+     * Wait until the remote client next sends media data on a media track.
+     *
+     * This waits for new media, ignoring any media already consumed by previous steps.
+     *
+     * @category Steps
+     */
+    waitForNextMedia(): this;
+    /**
+     * Wait until the remote client sends a message to us on a specific DataChannel.
+     *
+     * This looks for new messages, ignoring any messages already consumed by
+     * previous steps.
+     *
+    * @category Steps
+     */
+    waitForNextMessageOnChannel(channelLabel: string): this;
+    /**
+     * Send a message or buffer on the connection's data channels.
+     *
+     * This can take one or two arguments. If only one is provided, it is used
+     * as a message that's sent on all open data channels. If two arguments are
+     * provided, the first must be the data channel label, and the message (the
+     * second) will be sent only to data channel(s) with that label.
+     *
+     * If no matching channels are open, this is a no-op. Use `waitForChannel()`
+     * to ensure the channels you're expecting are open first if necessary.
+     *
+    * @category Steps
+     */
+    send(message: string | Buffer): this;
+    send(channel: string | undefined, message: string | Buffer): this;
+    /**
+     * Immediately close the connection.
+     *
+     * This defines a final step, and will then create a mock peer from the full
+     * set of steps you've defined, and return it wrapped in a promise. As soon
+     * as the promise resolves the peer is ready to use.
+     *
+     * @category Final Steps
+     */
+    thenClose(): Promise<R>;
+    /**
+     * Send a message or buffer on the connection's data channels, then close the
+     * connection. This is equivalent to {@link send `.send()`} then
+     * {@link thenClose `.thenClose()`}.
+     *
+     * This defines a final step, and will then create a mock peer from the full
+     * set of steps you've defined, and return it wrapped in a promise. As soon
+     * as the promise resolves the peer is ready to use.
+     *
+     * @category Final Steps
+     */
+    thenSend(message: string | Buffer): Promise<R>;
+    thenSend(channel: string, message: string | Buffer): Promise<R>;
+    /**
+     * Echo all incoming data channel messages until the other peer closes the
+     * connection.
+     *
+     * This defines a final step, and will then create a mock peer from the full
+     * set of steps you've defined, and return it wrapped in a promise. As soon
+     * as the promise resolves the peer is ready to use.
+     *
+     * @category Final Steps
+     */
+    thenEcho(): Promise<R>;
+    /**
+     * Creates a new external connection to the given remote peer connection,
+     * matching the existing mocked connection, and then proxies all traffic
+     * through to that peer.
+     *
+     * This defines a final step, and will then create a mock peer from the full
+     * set of steps you've defined, and return it wrapped in a promise. As soon
+     * as the promise resolves the peer is ready to use.
+     *
+     * @category Final Steps
+     */
+    thenForwardTo(peer: RTCPeerConnection): Promise<R>;
+    /**
+     * Proxy this connection dynamically to the 'real' target peer, whoever
+     * that may be.
+     *
+     * This assumes that you have an existing external connection already
+     * set up and attached to this mock connection.
+     *
+     * You can do that either by using {@link hookWebRTCConnection} or
+     * {@link hookAllWebRTC} to hook your connection during normal setup to
+     * automatically create an external offer to the real remote peer, or you can
+     * do so manually using {@link MockRTCPeer.createExternalOffer} or
+     * {@link MockRTCPeer.answerExternalOffer} and then passing the connection
+     * id as {@link https://github.com/httptoolkit/mockrtc/blob/d0604f3111e0438c52aa514d00cf04ac0718dfeb/src/webrtc-hooks.ts#L83-L93 here}.
+     *
+     * This defines a final step, and will then create a mock peer from the full
+     * set of steps you've defined, and return it wrapped in a promise. As soon
+     * as the promise resolves the peer is ready to use.
+     *
+     * @category Final Steps
+     */
+    thenPassThrough(): Promise<R>;
+}

package/dist/handling/handler-builder.js

@@ -0,0 +1,164 @@
+"use strict";
+/*
+ * SPDX-FileCopyrightText: 2022 Tim Perry <tim@httptoolkit.tech>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockRTCHandlerBuilder = void 0;
+const handler_step_definitions_1 = require("./handler-step-definitions");
+/**
+ * The builder logic for composing RTC handling behaviour for both mock peers and rules,
+ * by internally queuing defined actions until a `.thenX()` method is called to compile
+ * the actions into either a peer or a rule (handled by an constructor callback param).
+ */
+class MockRTCHandlerBuilder {
+    constructor(buildCallback) {
+        this.buildCallback = buildCallback;
+        this.handlerSteps = [];
+    }
+    /**
+     * Wait for a given duration, in milliseconds
+     *
+     * @category Steps
+     */
+    sleep(duration) {
+        this.handlerSteps.push(new handler_step_definitions_1.WaitForDurationStepDefinition(duration));
+        return this;
+    }
+    /**
+     * Wait until the remote client has created at least one DataChannel.
+     *
+     * @category Steps
+     */
+    waitForChannel(channelLabel) {
+        this.handlerSteps.push(new handler_step_definitions_1.WaitForChannelStepDefinition(channelLabel));
+        return this;
+    }
+    /**
+     * Wait until the remote client has created at least one media track
+     *
+     * @category Steps
+     */
+    waitForTrack() {
+        this.handlerSteps.push(new handler_step_definitions_1.WaitForTrackStepDefinition());
+        return this;
+    }
+    /**
+     * Wait until the remote client next sends a message to us on any DataChannel.
+     *
+     * This looks for new messages, ignoring any messages already consumed by
+     * previous steps.
+     *
+     * @category Steps
+     */
+    waitForNextMessage() {
+        this.handlerSteps.push(new handler_step_definitions_1.WaitForMessageStepDefinition());
+        return this;
+    }
+    /**
+     * Wait until the remote client next sends media data on a media track.
+     *
+     * This waits for new media, ignoring any media already consumed by previous steps.
+     *
+     * @category Steps
+     */
+    waitForNextMedia() {
+        this.handlerSteps.push(new handler_step_definitions_1.WaitForMediaStepDefinition());
+        return this;
+    }
+    /**
+     * Wait until the remote client sends a message to us on a specific DataChannel.
+     *
+     * This looks for new messages, ignoring any messages already consumed by
+     * previous steps.
+     *
+    * @category Steps
+     */
+    waitForNextMessageOnChannel(channelLabel) {
+        this.handlerSteps.push(new handler_step_definitions_1.WaitForMessageStepDefinition(channelLabel));
+        return this;
+    }
+    send(...args) {
+        if (args[1] !== undefined) {
+            const [channel, message] = args;
+            this.handlerSteps.push(new handler_step_definitions_1.SendStepDefinition(channel, message));
+        }
+        else {
+            const [message] = args;
+            this.handlerSteps.push(new handler_step_definitions_1.SendStepDefinition(undefined, message));
+        }
+        return this;
+    }
+    /**
+     * Immediately close the connection.
+     *
+     * This defines a final step, and will then create a mock peer from the full
+     * set of steps you've defined, and return it wrapped in a promise. As soon
+     * as the promise resolves the peer is ready to use.
+     *
+     * @category Final Steps
+     */
+    thenClose() {
+        this.handlerSteps.push(new handler_step_definitions_1.CloseStepDefinition());
+        return this.buildCallback(this.handlerSteps);
+    }
+    thenSend(...args) {
+        return this.send(...args)
+            .buildCallback(this.handlerSteps);
+    }
+    /**
+     * Echo all incoming data channel messages until the other peer closes the
+     * connection.
+     *
+     * This defines a final step, and will then create a mock peer from the full
+     * set of steps you've defined, and return it wrapped in a promise. As soon
+     * as the promise resolves the peer is ready to use.
+     *
+     * @category Final Steps
+     */
+    thenEcho() {
+        this.handlerSteps.push(new handler_step_definitions_1.EchoStepDefinition());
+        return this.buildCallback(this.handlerSteps);
+    }
+    /**
+     * Creates a new external connection to the given remote peer connection,
+     * matching the existing mocked connection, and then proxies all traffic
+     * through to that peer.
+     *
+     * This defines a final step, and will then create a mock peer from the full
+     * set of steps you've defined, and return it wrapped in a promise. As soon
+     * as the promise resolves the peer is ready to use.
+     *
+     * @category Final Steps
+     */
+    thenForwardTo(peer) {
+        this.handlerSteps.push(new handler_step_definitions_1.PeerProxyStepDefinition(peer));
+        return this.buildCallback(this.handlerSteps);
+    }
+    /**
+     * Proxy this connection dynamically to the 'real' target peer, whoever
+     * that may be.
+     *
+     * This assumes that you have an existing external connection already
+     * set up and attached to this mock connection.
+     *
+     * You can do that either by using {@link hookWebRTCConnection} or
+     * {@link hookAllWebRTC} to hook your connection during normal setup to
+     * automatically create an external offer to the real remote peer, or you can
+     * do so manually using {@link MockRTCPeer.createExternalOffer} or
+     * {@link MockRTCPeer.answerExternalOffer} and then passing the connection
+     * id as {@link https://github.com/httptoolkit/mockrtc/blob/d0604f3111e0438c52aa514d00cf04ac0718dfeb/src/webrtc-hooks.ts#L83-L93 here}.
+     *
+     * This defines a final step, and will then create a mock peer from the full
+     * set of steps you've defined, and return it wrapped in a promise. As soon
+     * as the promise resolves the peer is ready to use.
+     *
+     * @category Final Steps
+     */
+    thenPassThrough() {
+        this.handlerSteps.push(new handler_step_definitions_1.DynamicProxyStepDefinition());
+        return this.buildCallback(this.handlerSteps);
+    }
+}
+exports.MockRTCHandlerBuilder = MockRTCHandlerBuilder;
+//# sourceMappingURL=handler-builder.js.map

package/dist/handling/handler-builder.js.map

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