Add support for connection reset rules

Author: pimterry

src/components/mock/handler-config.tsx

@@ -30,6 +30,7 @@ import {
     RequestAndResponseBreakpointHandler,
     TimeoutHandler,
     CloseConnectionHandler,
+    ResetConnectionHandler,
     FromFileResponseHandler
 } from '../../model/rules/definitions/http-rule-definitions';
 import {
@@ -153,6 +154,9 @@ export function HandlerConfiguration(props: {
             return <TimeoutHandlerConfig {...configProps} />;
         case 'close-connection':
             return <CloseConnectionHandlerConfig {...configProps} />;
+        case 'reset-connection':
+            return <ResetConnectionHandlerConfig {...configProps} />;
+
         case 'ws-echo':
             return <WebSocketEchoHandlerConfig {...configProps} />;
         case 'ws-reject':
@@ -1320,7 +1324,27 @@ class CloseConnectionHandlerConfig extends HandlerConfig<CloseConnectionHandler>
                     : this.props.ruleType === 'webrtc'
                         ? (() => { throw new Error('Not compatible with WebRTC rules') })
                     : (() => { throw new UnreachableCheck(this.props.ruleType); })()
-                } is received, the connection will be closed, with no response.
+                } is received, the connection will be cleanly closed, with no response.
+            </ConfigExplanation>
+        </ConfigContainer>;
+    }
+}
+
+@observer
+class ResetConnectionHandlerConfig extends HandlerConfig<ResetConnectionHandler> {
+    render() {
+        return <ConfigContainer>
+            <ConfigExplanation>
+                As soon as a matching {
+                    isHttpCompatibleType(this.props.ruleType)
+                        ? 'request'
+                    : this.props.ruleType === 'websocket'
+                        ? 'WebSocket'
+                    : this.props.ruleType === 'webrtc'
+                        ? (() => { throw new Error('Not compatible with WebRTC rules') })
+                    : (() => { throw new UnreachableCheck(this.props.ruleType); })()
+                } is received, the connection will be killed with a TCP RST packet (or a
+                RST_STREAM frame, for HTTP/2 requests).
             </ConfigExplanation>
         </ConfigContainer>;
     }

src/components/mock/handler-selection.tsx

@@ -26,6 +26,7 @@ import {
     PassThroughHandler,
     TimeoutHandler,
     CloseConnectionHandler,
+    ResetConnectionHandler,
     FromFileResponseHandler
 } from '../../model/rules/definitions/http-rule-definitions';
 import {
@@ -112,6 +113,8 @@ const instantiateHandler = (
             return new TimeoutHandler();
         case 'close-connection':
             return new CloseConnectionHandler();
+        case 'reset-connection':
+            return new ResetConnectionHandler();
 
         case 'ws-echo':
             return new EchoWebSocketHandlerDefinition();

src/model/rules/definitions/http-rule-definitions.ts

@@ -301,6 +301,8 @@ export type TimeoutHandler = httpHandlers.TimeoutHandlerDefinition;
 export const TimeoutHandler = httpHandlers.TimeoutHandlerDefinition;
 export type CloseConnectionHandler = httpHandlers.CloseConnectionHandlerDefinition;
 export const CloseConnectionHandler = httpHandlers.CloseConnectionHandlerDefinition;
+export type ResetConnectionHandler = httpHandlers.ResetConnectionHandlerDefinition;
+export const ResetConnectionHandler = httpHandlers.ResetConnectionHandlerDefinition;
 
 export const HttpMatcherLookup = {
     ..._.omit(httpMatchers.MatcherLookup, ['method']), // We skip method to use per-method matchers instead

src/model/rules/rule-descriptions.ts

@@ -125,7 +125,9 @@ export function summarizeHandlerClass(key: HandlerClassKey): string {
         case 'timeout':
             return "Time out with no response";
         case 'close-connection':
-            return "Close the connection immediately";
+            return "Close the connection";
+        case 'reset-connection':
+            return "Forcibly reset the connection";
 
         case 'ws-reject':
             return "Reject the WebSocket setup request";
@@ -186,7 +188,6 @@ export function summarizeHandlerClass(key: HandlerClassKey): string {
         case 'rtc-peer-proxy':
         case 'callback':
         case 'stream':
-        case 'reset-connection':
             throw new Error(`${key} handler should not be used directly`);
         default:
             throw new UnreachableCheck(key);

src/model/rules/rules.ts

@@ -8,14 +8,16 @@ import {
     PASSTHROUGH_TRANSFORMS_RANGE,
     WEBSOCKET_MESSAGING_RULES_SUPPORTED,
     JSONRPC_RESPONSE_RULE_SUPPORTED,
-    RTC_RULES_SUPPORTED
+    RTC_RULES_SUPPORTED,
+    CONNECTION_RESET_SUPPORTED
 } from '../../services/service-versions';
 
 import {
     StaticResponseHandler,
     ForwardToHostHandler,
     TimeoutHandler,
     CloseConnectionHandler,
+    ResetConnectionHandler,
     FromFileResponseHandler,
     TransformingHandler,
     HttpMatcherLookup,
@@ -88,7 +90,8 @@ const PartVersionRequirements: {
     'req-res-transformer': PASSTHROUGH_TRANSFORMS_RANGE,
     'ws-echo': WEBSOCKET_MESSAGING_RULES_SUPPORTED,
     'ws-listen': WEBSOCKET_MESSAGING_RULES_SUPPORTED,
-    'ws-reject': WEBSOCKET_MESSAGING_RULES_SUPPORTED
+    'ws-reject': WEBSOCKET_MESSAGING_RULES_SUPPORTED,
+    'reset-connection': CONNECTION_RESET_SUPPORTED
 };
 
 const serverSupports = (versionRequirement: string | undefined) => {
@@ -298,7 +301,6 @@ const HiddenHandlers = [
     'rtc-peer-proxy', // Not usable interactively
     'callback',
     'stream',
-    'reset-connection', // Not supported in Node version used by current server
     'wait-for-rtc-track' // Not super useful here I think
 ] as const;
 
@@ -408,6 +410,7 @@ const PaidHandlerClasses: HandlerClass[] = [
     TransformingHandler,
     TimeoutHandler,
     CloseConnectionHandler,
+    ResetConnectionHandler,
     EchoWebSocketHandlerDefinition,
     RejectWebSocketHandlerDefinition,
     ListenWebSocketHandlerDefinition

src/services/service-versions.ts

@@ -70,3 +70,4 @@ export const WEBRTC_GLOBALLY_ENABLED = '^1.10.3';
 export const JSONRPC_RESPONSE_RULE_SUPPORTED = '^1.11.0';
 export const RTC_RULES_SUPPORTED = '^1.11.0';
 export const TLS_PASSTHROUGH_SUPPORTED = '^1.12.0';
+export const CONNECTION_RESET_SUPPORTED = '^1.12.0';