mocktp 0.0.1-security → 3.15.3

package/dist/server/http-combo-server.js

@@ -0,0 +1,330 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createComboServer = createComboServer;
+const _ = require("lodash");
+const now = require("performance-now");
+const net = require("net");
+const tls = require("tls");
+const semver = require("semver");
+const destroyable_server_1 = require("destroyable-server");
+const httpolyglot = require("@httptoolkit/httpolyglot");
+const read_tls_client_hello_1 = require("read-tls-client-hello");
+const urlpattern_polyfill_1 = require("urlpattern-polyfill");
+const tls_1 = require("../util/tls");
+const util_1 = require("../util/util");
+const server_utils_1 = require("../util/server-utils");
+const socket_util_1 = require("../util/socket-util");
+// Hardcore monkey-patching: force TLSSocket to link servername & remoteAddress to
+// sockets as soon as they're available, without waiting for the handshake to fully
+// complete, so we can easily access them if the handshake fails.
+const originalSocketInit = tls.TLSSocket.prototype._init;
+tls.TLSSocket.prototype._init = function () {
+    originalSocketInit.apply(this, arguments);
+    const tlsSocket = this;
+    const { _handle } = tlsSocket;
+    if (!_handle)
+        return;
+    const loadSNI = _handle.oncertcb;
+    _handle.oncertcb = function (info) {
+        tlsSocket.servername = info.servername;
+        tlsSocket.initialRemoteAddress = tlsSocket.remoteAddress || // Normal case
+            tlsSocket._parent?.remoteAddress || // For early failing sockets
+            tlsSocket._handle?._parentWrap?.stream?.remoteAddress; // For HTTP/2 CONNECT
+        tlsSocket.initialRemotePort = tlsSocket.remotePort ||
+            tlsSocket._parent?.remotePort ||
+            tlsSocket._handle?._parentWrap?.stream?.remotePort;
+        return loadSNI?.apply(this, arguments);
+    };
+};
+// Takes an established TLS socket, calls the error listener if it's silently closed
+function ifTlsDropped(socket, errorCallback) {
+    new Promise((resolve, reject) => {
+        // If you send data, you trust the TLS connection
+        socket.once('data', resolve);
+        // If you silently close it very quicky, you probably don't trust us
+        socket.once('error', reject);
+        socket.once('close', reject);
+        socket.once('end', reject);
+        // Some clients open later-unused TLS connections for connection pools, preconnect, etc.
+        // Even if these are shut later on, that doesn't mean they're are rejected connections.
+        // To differentiate the two cases, we consider connections OK after waiting 10x longer
+        // than the initial TLS handshake for an unhappy disconnection.
+        const timing = socket.__timingInfo;
+        const tlsSetupDuration = timing
+            ? timing.tlsConnectedTimestamp - (timing.tunnelSetupTimestamp || timing.initialSocketTimestamp)
+            : 0;
+        const maxTlsRejectionTime = !Object.is(tlsSetupDuration, NaN)
+            ? Math.max(tlsSetupDuration * 10, 100) // Ensure a sensible minimum
+            : 2000;
+        (0, util_1.delay)(maxTlsRejectionTime).then(resolve);
+    })
+        .then(() => {
+        // Mark the socket as having completed TLS setup - this ensures that future
+        // errors fire as client errors, not TLS setup errors.
+        socket.tlsSetupCompleted = true;
+    })
+        .catch(() => {
+        // If TLS setup was confirmed in any way, we know we don't have a TLS error.
+        if (socket.tlsSetupCompleted)
+            return;
+        // To get here, the socket must have connected & done the TLS handshake, but then
+        // closed/ended without ever sending any data. We can fairly confidently assume
+        // in that case that it's rejected our certificate.
+        errorCallback();
+    });
+}
+function getCauseFromError(error) {
+    const cause = (/alert certificate/.test(error.message) ||
+        /alert bad certificate/.test(error.message) ||
+        error.code === 'ERR_SSL_SSLV3_ALERT_BAD_CERTIFICATE' ||
+        /alert unknown ca/.test(error.message))
+        // The client explicitly told us it doesn't like the certificate
+        ? 'cert-rejected'
+        : /no shared cipher/.test(error.message)
+            // The client refused to negotiate a cipher. Probably means it didn't like the
+            // cert so refused to continue, but it could genuinely not have a shared cipher.
+            ? 'no-shared-cipher'
+            : (/ECONNRESET/.test(error.message) || error.code === 'ECONNRESET')
+                // The client sent no TLS alert, it just hard RST'd the connection
+                ? 'reset'
+                : error.code === 'ERR_TLS_HANDSHAKE_TIMEOUT'
+                    ? 'handshake-timeout'
+                    : 'unknown'; // Something else.
+    if (cause === 'unknown')
+        console.log('Unknown TLS error:', error);
+    return cause;
+}
+function buildTlsError(socket, cause) {
+    const eventData = (0, socket_util_1.buildSocketEventData)(socket);
+    eventData.failureCause = cause;
+    eventData.timingEvents.failureTimestamp = now();
+    return eventData;
+}
+// The low-level server that handles all the sockets & TLS. The server will correctly call the
+// given handler for both HTTP & HTTPS direct connections, or connections when used as an
+// either HTTP or HTTPS proxy, all on the same port.
+async function createComboServer(options, requestListener, tlsClientErrorListener, tlsPassthroughListener) {
+    let server;
+    if (!options.https) {
+        server = httpolyglot.createServer(requestListener);
+    }
+    else {
+        const ca = await (0, tls_1.getCA)(options.https);
+        const defaultCert = ca.generateCertificate(options.https.defaultDomain ?? 'localhost');
+        const serverProtocolPreferences = options.http2 === true
+            ? ['h2', 'http/1.1', 'http 1.1'] // 'http 1.1' is non-standard, but used by https-proxy-agent
+            : options.http2 === 'fallback'
+                ? ['http/1.1', 'http 1.1', 'h2']
+                // options.http2 === false:
+                : ['http/1.1', 'http 1.1'];
+        const ALPNOption = semver.satisfies(process.version, '>=20.4.0')
+            ? {
+                // In modern Node (20+), ALPNProtocols will reject unknown protocols. To allow those (so we can
+                // at least read the request, and hopefully handle HTTP-like cases - not uncommon) we use the new
+                // ALPNCallback feature instead, which lets us dynamically accept unrecognized protocols:
+                ALPNCallback: ({ protocols: clientProtocols }) => {
+                    const preferredProtocol = serverProtocolPreferences.find(p => clientProtocols.includes(p));
+                    // Wherever possible, we tell the client to use our preferred protocol
+                    if (preferredProtocol)
+                        return preferredProtocol;
+                    // If the client only offers protocols that we don't understand, shrug and accept:
+                    else
+                        return clientProtocols[1];
+                }
+            } : {
+            // In Node versions without ALPNCallback, we just set preferences directly:
+            ALPNProtocols: serverProtocolPreferences
+        };
+        const tlsServer = tls.createServer({
+            key: defaultCert.key,
+            cert: defaultCert.cert,
+            ca: [defaultCert.ca],
+            ...ALPNOption,
+            SNICallback: (domain, cb) => {
+                if (options.debug)
+                    console.log(`Generating certificate for ${domain}`);
+                try {
+                    const generatedCert = ca.generateCertificate(domain);
+                    cb(null, tls.createSecureContext({
+                        key: generatedCert.key,
+                        cert: generatedCert.cert,
+                        ca: generatedCert.ca
+                    }));
+                }
+                catch (e) {
+                    console.error('Cert generation error', e);
+                    cb(e);
+                }
+            }
+        });
+        analyzeAndMaybePassThroughTls(tlsServer, options.https.tlsPassthrough, options.https.tlsInterceptOnly, tlsPassthroughListener);
+        server = httpolyglot.createServer(tlsServer, requestListener);
+    }
+    // In Node v20, this option was added, rejecting all requests with no host header. While that's good, in
+    // our case, we want to handle the garbage requests too, so we disable it:
+    server._httpServer.requireHostHeader = false;
+    server.on('connection', (socket) => {
+        socket.__timingInfo = socket.__timingInfo || (0, socket_util_1.buildSocketTimingInfo)();
+        // All sockets are initially marked as using unencrypted upstream connections.
+        // If TLS is used, this is upgraded to 'true' by secureConnection below.
+        socket.__lastHopEncrypted = false;
+        // For actual sockets, set NODELAY to avoid any buffering whilst streaming. This is
+        // off by default in Node HTTP, but likely to be enabled soon & is default in curl.
+        if ('setNoDelay' in socket)
+            socket.setNoDelay(true);
+    });
+    server.on('secureConnection', (socket) => {
+        const parentSocket = (0, socket_util_1.getParentSocket)(socket);
+        if (parentSocket) {
+            // Sometimes wrapper TLS sockets created by the HTTP/2 server don't include the
+            // underlying socket details, so it's better to make sure we copy them up.
+            copyAddressDetails(parentSocket, socket);
+            copyTimingDetails(parentSocket, socket);
+            // With TLS metadata, we only propagate directly from parent sockets, not through
+            // CONNECT etc - we only want it if the final hop is TLS, previous values don't matter.
+            socket.__tlsMetadata ?? (socket.__tlsMetadata = parentSocket.__tlsMetadata);
+        }
+        else if (!socket.__timingInfo) {
+            socket.__timingInfo = (0, socket_util_1.buildSocketTimingInfo)();
+        }
+        socket.__timingInfo.tlsConnectedTimestamp = now();
+        socket.__lastHopEncrypted = true;
+        ifTlsDropped(socket, () => {
+            tlsClientErrorListener(socket, buildTlsError(socket, 'closed'));
+        });
+    });
+    // Mark HTTP/2 sockets as set up once we receive a first settings frame. This always
+    // happens immediately after the connection preface, as long as the connection is OK.
+    server.on('session', (session) => {
+        session.once('remoteSettings', () => {
+            session.socket.tlsSetupCompleted = true;
+        });
+    });
+    server.on('tlsClientError', (error, socket) => {
+        tlsClientErrorListener(socket, buildTlsError(socket, getCauseFromError(error)));
+    });
+    // If the server receives a HTTP/HTTPS CONNECT request, Pretend to tunnel, then just re-handle:
+    server.addListener('connect', function (req, resOrSocket) {
+        if (resOrSocket instanceof net.Socket) {
+            handleH1Connect(req, resOrSocket);
+        }
+        else {
+            handleH2Connect(req, resOrSocket);
+        }
+    });
+    function handleH1Connect(req, socket) {
+        // Clients may disconnect at this point (for all sorts of reasons), but here
+        // nothing else is listening, so we need to catch errors on the socket:
+        socket.once('error', (e) => {
+            if (options.debug) {
+                console.log('Error on client socket', e);
+            }
+        });
+        const connectUrl = req.url || req.headers['host'];
+        if (!connectUrl) {
+            // If we can't work out where to go, send an error.
+            socket.write('HTTP/' + req.httpVersion + ' 400 Bad Request\r\n\r\n', 'utf-8');
+            return;
+        }
+        if (options.debug)
+            console.log(`Proxying HTTP/1 CONNECT to ${connectUrl}`);
+        socket.write('HTTP/' + req.httpVersion + ' 200 OK\r\n\r\n', 'utf-8', () => {
+            socket.__timingInfo.tunnelSetupTimestamp = now();
+            socket.__lastHopConnectAddress = connectUrl;
+            server.emit('connection', socket);
+        });
+    }
+    function handleH2Connect(req, res) {
+        const connectUrl = req.headers[':authority'];
+        if (!connectUrl) {
+            // If we can't work out where to go, send an error.
+            res.writeHead(400, {});
+            res.end();
+            return;
+        }
+        if (options.debug)
+            console.log(`Proxying HTTP/2 CONNECT to ${connectUrl}`);
+        // Send a 200 OK response, and start the tunnel:
+        res.writeHead(200, {});
+        copyAddressDetails(res.socket, res.stream);
+        copyTimingDetails(res.socket, res.stream);
+        res.stream.__lastHopConnectAddress = connectUrl;
+        // When layering HTTP/2 on JS streams, we have to make sure the JS stream won't autoclose
+        // when the other side does, because the upper HTTP/2 layers want to handle shutdown, so
+        // they end up trying to write a GOAWAY at the same time as the lower stream shuts down,
+        // and we get assertion errors in Node v16.7+.
+        if (res.socket.constructor.name.includes('JSStreamSocket')) {
+            res.socket.allowHalfOpen = true;
+        }
+        server.emit('connection', res.stream);
+    }
+    return (0, destroyable_server_1.makeDestroyable)(server);
+}
+const SOCKET_ADDRESS_METADATA_FIELDS = [
+    'localAddress',
+    'localPort',
+    'remoteAddress',
+    'remotePort',
+    '__lastHopConnectAddress'
+];
+// Update the target socket(-ish) with the address details from the source socket,
+// iff the target has no details of its own.
+function copyAddressDetails(source, target) {
+    Object.defineProperties(target, _.zipObject(SOCKET_ADDRESS_METADATA_FIELDS, _.range(SOCKET_ADDRESS_METADATA_FIELDS.length).map(() => ({ writable: true }))));
+    SOCKET_ADDRESS_METADATA_FIELDS.forEach((fieldName) => {
+        if (target[fieldName] === undefined) {
+            target[fieldName] = source[fieldName];
+        }
+    });
+}
+function copyTimingDetails(source, target) {
+    if (!target.__timingInfo) {
+        // Clone timing info, don't copy it - child sockets get their own independent timing stats
+        target.__timingInfo = Object.assign({}, source.__timingInfo);
+    }
+}
+/**
+ * Takes tls passthrough configuration (may be empty) and reconfigures a given TLS server so that all
+ * client hellos are parsed, matching requests are passed to the given passthrough listener (without
+ * continuing setup) and client hello metadata is attached to all sockets.
+ */
+function analyzeAndMaybePassThroughTls(server, passthroughList, interceptOnlyList, passthroughListener) {
+    if (passthroughList && interceptOnlyList) {
+        throw new Error('Cannot use both tlsPassthrough and tlsInterceptOnly options at the same time.');
+    }
+    const passThroughPatterns = passthroughList?.map(({ hostname }) => new urlpattern_polyfill_1.URLPattern(`https://${hostname}`)) ?? [];
+    const interceptOnlyPatterns = interceptOnlyList?.map(({ hostname }) => new urlpattern_polyfill_1.URLPattern(`https://${hostname}`));
+    const tlsConnectionListener = server.listeners('connection')[0];
+    server.removeListener('connection', tlsConnectionListener);
+    server.on('connection', async (socket) => {
+        try {
+            const helloData = await (0, read_tls_client_hello_1.readTlsClientHello)(socket);
+            const [connectHostname, connectPort] = socket.__lastHopConnectAddress?.split(':') ?? [];
+            const sniHostname = helloData.serverName;
+            socket.__tlsMetadata = {
+                sniHostname,
+                connectHostname,
+                connectPort,
+                clientAlpn: helloData.alpnProtocols,
+                ja3Fingerprint: (0, read_tls_client_hello_1.calculateJa3FromFingerprintData)(helloData.fingerprintData)
+            };
+            if ((0, server_utils_1.shouldPassThrough)(connectHostname, passThroughPatterns, interceptOnlyPatterns)) {
+                const upstreamPort = connectPort ? parseInt(connectPort, 10) : undefined;
+                passthroughListener(socket, connectHostname, upstreamPort);
+                return; // Do not continue with TLS
+            }
+            else if ((0, server_utils_1.shouldPassThrough)(sniHostname, passThroughPatterns, interceptOnlyPatterns)) {
+                passthroughListener(socket, sniHostname); // Can't guess the port - not included in SNI
+                return; // Do not continue with TLS
+            }
+        }
+        catch (e) {
+            if (!(e instanceof read_tls_client_hello_1.NonTlsError)) { // Don't even warn for non-TLS traffic
+                console.warn(`TLS client hello data not available for TLS connection from ${socket.remoteAddress ?? 'unknown address'}: ${e.message ?? e}`);
+            }
+        }
+        // Didn't match a passthrough hostname - continue with TLS setup
+        tlsConnectionListener.call(server, socket);
+    });
+}
+//# sourceMappingURL=http-combo-server.js.map

package/dist/server/http-combo-server.js.map

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

package/dist/server/mocked-endpoint.d.ts

@@ -0,0 +1,14 @@
+import * as util from 'util';
+import type { CompletedRequest, MockedEndpoint } from '../types';
+import type { RequestRule } from '../rules/requests/request-rule';
+import type { WebSocketRule } from '../rules/websockets/websocket-rule';
+export declare class ServerMockedEndpoint implements MockedEndpoint {
+    private rule;
+    constructor(rule: RequestRule | WebSocketRule);
+    get id(): string;
+    getSeenRequests(): Promise<CompletedRequest[]>;
+    isPending(): Promise<boolean>;
+    [util.inspect.custom](): string;
+    toString(withoutExactCompletion?: boolean): string;
+}
+//# sourceMappingURL=mocked-endpoint.d.ts.map

package/dist/server/mocked-endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mocked-endpoint.d.ts","sourceRoot":"","sources":["../../src/server/mocked-endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAExE,qBAAa,oBAAqB,YAAW,cAAc;IAE3C,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,WAAW,GAAG,aAAa;IAIrD,IAAI,EAAE,WAEL;IAED,eAAe,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAKxC,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAenC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAIrB,QAAQ,CAAC,sBAAsB,UAAQ;CAG1C"}

package/dist/server/mocked-endpoint.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServerMockedEndpoint = void 0;
+const util = require("util");
+class ServerMockedEndpoint {
+    constructor(rule) {
+        this.rule = rule;
+        this.getSeenRequests.bind(this);
+    }
+    ;
+    get id() {
+        return this.rule.id;
+    }
+    getSeenRequests() {
+        // Wait for all completed running requests to have all their details available
+        return Promise.all(this.rule.requests);
+    }
+    async isPending() {
+        // We don't actually need to wait for rule.requests to complete, because
+        // completion rules right now only check requestCount, and that is always
+        // updated synchronously when handling starts.
+        const ruleCompletion = this.rule.isComplete();
+        if (ruleCompletion !== null) {
+            // If the rule has a specific completion value, use it
+            return !ruleCompletion;
+        }
+        else {
+            // If not, then it's default "at least one" completion:
+            return this.rule.requestCount === 0;
+        }
+    }
+    [util.inspect.custom]() {
+        return "Mocked endpoint: " + this.toString();
+    }
+    toString(withoutExactCompletion = false) {
+        return this.rule.explain(withoutExactCompletion);
+    }
+}
+exports.ServerMockedEndpoint = ServerMockedEndpoint;
+//# sourceMappingURL=mocked-endpoint.js.map

package/dist/server/mocked-endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mocked-endpoint.js","sourceRoot":"","sources":["../../src/server/mocked-endpoint.ts"],"names":[],"mappings":";;;AAAA,6BAA6B;AAM7B,MAAa,oBAAoB;IAE7B,YAAoB,IAAiC;QAAjC,SAAI,GAAJ,IAAI,CAA6B;QACjD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAAA,CAAC;IAEF,IAAI,EAAE;QACF,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACxB,CAAC;IAED,eAAe;QACX,8EAA8E;QAC9E,OAAO,OAAO,CAAC,GAAG,CAAmB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,SAAS;QACX,wEAAwE;QACxE,yEAAyE;QACzE,8CAA8C;QAE9C,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QAC9C,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;YAC1B,sDAAsD;YACtD,OAAO,CAAC,cAAc,CAAC;QAC3B,CAAC;aAAM,CAAC;YACJ,uDAAuD;YACvD,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,CAAC;QACxC,CAAC;IACL,CAAC;IAED,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QACjB,OAAO,mBAAmB,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IACjD,CAAC;IAED,QAAQ,CAAC,sBAAsB,GAAG,KAAK;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACrD,CAAC;CACJ;AArCD,oDAqCC"}

package/dist/server/mockttp-server.d.ts

@@ -0,0 +1,87 @@
+import { InitiatedRequest, CompletedRequest, CompletedResponse, TlsHandshakeFailure, ClientError, WebSocketMessage, WebSocketClose, TlsPassthroughEvent, RuleEvent } from "../types";
+import { Mockttp, AbstractMockttp, MockttpOptions, PortRange } from "../mockttp";
+import { RequestRuleData } from "../rules/requests/request-rule";
+import { ServerMockedEndpoint } from "./mocked-endpoint";
+import { WebSocketRuleData } from "../rules/websockets/websocket-rule";
+/**
+ * A in-process Mockttp implementation. This starts servers on the local machine in the
+ * current process, and exposes methods to directly manage them.
+ *
+ * This class does not work in browsers, as it expects to be able to start HTTP servers.
+ */
+export declare class MockttpServer extends AbstractMockttp implements Mockttp {
+    private requestRuleSets;
+    private webSocketRuleSets;
+    private httpsOptions;
+    private isHttp2Enabled;
+    private maxBodySize;
+    private app;
+    private server;
+    private eventEmitter;
+    private readonly initialDebugSetting;
+    private readonly defaultWsHandler;
+    constructor(options?: MockttpOptions);
+    start(portParam?: number | PortRange): Promise<void>;
+    stop(): Promise<void>;
+    enableDebug(): void;
+    reset(): void;
+    private get address();
+    get url(): string;
+    get port(): number;
+    private addToRuleSets;
+    setRequestRules: (...ruleData: RequestRuleData[]) => Promise<ServerMockedEndpoint[]>;
+    addRequestRules: (...ruleData: RequestRuleData[]) => Promise<ServerMockedEndpoint[]>;
+    setWebSocketRules: (...ruleData: WebSocketRuleData[]) => Promise<ServerMockedEndpoint[]>;
+    addWebSocketRules: (...ruleData: WebSocketRuleData[]) => Promise<ServerMockedEndpoint[]>;
+    getMockedEndpoints(): Promise<ServerMockedEndpoint[]>;
+    getPendingEndpoints(): Promise<ServerMockedEndpoint[]>;
+    getRuleParameterKeys(): Promise<never[]>;
+    on(event: 'request-initiated', callback: (req: InitiatedRequest) => void): Promise<void>;
+    on(event: 'request', callback: (req: CompletedRequest) => void): Promise<void>;
+    on(event: 'response', callback: (req: CompletedResponse) => void): Promise<void>;
+    on(event: 'abort', callback: (req: InitiatedRequest) => void): Promise<void>;
+    on(event: 'websocket-request', callback: (req: CompletedRequest) => void): Promise<void>;
+    on(event: 'websocket-accepted', callback: (req: CompletedResponse) => void): Promise<void>;
+    on(event: 'websocket-message-received', callback: (req: WebSocketMessage) => void): Promise<void>;
+    on(event: 'websocket-message-sent', callback: (req: WebSocketMessage) => void): Promise<void>;
+    on(event: 'websocket-close', callback: (close: WebSocketClose) => void): Promise<void>;
+    on(event: 'tls-passthrough-opened', callback: (req: TlsPassthroughEvent) => void): Promise<void>;
+    on(event: 'tls-passthrough-closed', callback: (req: TlsPassthroughEvent) => void): Promise<void>;
+    on(event: 'tls-client-error', callback: (req: TlsHandshakeFailure) => void): Promise<void>;
+    on(event: 'client-error', callback: (error: ClientError) => void): Promise<void>;
+    on<T = unknown>(event: 'rule-event', callback: (event: RuleEvent<T>) => void): Promise<void>;
+    private announceInitialRequestAsync;
+    private announceCompletedRequestAsync;
+    private announceResponseAsync;
+    private announceWebSocketRequestAsync;
+    private announceWebSocketUpgradeAsync;
+    private announceWebSocketMessageAsync;
+    private announceWebSocketCloseAsync;
+    private trackWebSocketEvents;
+    private announceAbortAsync;
+    private announceTlsErrorAsync;
+    private announceClientErrorAsync;
+    private announceRuleEventAsync;
+    private preprocessRequest;
+    private handleRequest;
+    private handleWebSocket;
+    /**
+     * To match rules, we find the first rule (by priority then by set order) which matches and which is
+     * either not complete (has a completion check that's false) or which has no completion check defined
+     * and is the last option at that priority (i.e. by the last option at each priority repeats indefinitely.
+     *
+     * We move down the priority list only when either no rules match at all, or when all matching rules
+     * have explicit completion checks defined that are completed.
+     */
+    private findMatchingRule;
+    private getUnmatchedRequestExplanation;
+    private sendUnmatchedRequestError;
+    private sendWebSocketErrorResponse;
+    private explainRequest;
+    private suggestRule;
+    private handleInvalidHttp1Request;
+    private handleInvalidHttp2Request;
+    private outgoingPassthroughSockets;
+    private passthroughSocket;
+}
+//# sourceMappingURL=mockttp-server.d.ts.map

package/dist/server/mockttp-server.d.ts.map

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