Pass debug state through to step implementations

We don't actually use this yet, but we probably should in future,
particularly to manage logging levels within step implementations.

Author: pimterry

src/rules/requests/request-rule.ts

@@ -21,6 +21,7 @@ export interface RequestRule extends Explainable {
     matches(request: OngoingRequest): MaybePromise<boolean>;
     handle(request: OngoingRequest, response: OngoingResponse, options: {
         record: boolean,
+        debug: boolean,
         emitEventCallback?: (type: string, event: unknown) => void
     }): Promise<void>;
     isComplete(): boolean | null;
@@ -76,12 +77,14 @@ export class RequestRule implements RequestRule {
 
     handle(req: OngoingRequest, res: OngoingResponse, options: {
         record?: boolean,
+        debug: boolean,
         emitEventCallback?: (type: string, event: unknown) => void
     }): Promise<void> {
         let stepsPromise = (async () => {
             for (let step of this.steps) {
                 const result = await step.handle(req, res, {
-                    emitEventCallback: options.emitEventCallback
+                    emitEventCallback: options.emitEventCallback,
+                    debug: options.debug
                 });
 
                 if (!result || result.continue === false) break;

src/rules/requests/request-step-impls.ts

@@ -164,6 +164,7 @@ export interface RequestStepImpl extends RequestStepDefinition {
 
 export interface RequestStepOptions {
     emitEventCallback?: (type: string, event: unknown) => void;
+    debug: boolean;
 }
 
 export class FixedResponseStepImpl extends FixedResponseStep {

src/rules/websockets/websocket-rule.ts

@@ -31,6 +31,7 @@ export interface WebSocketRule extends Explainable {
         head: Buffer,
         options: {
             record: boolean,
+            debug: boolean,
             emitEventCallback?: (type: string, event: unknown) => void
         }
     ): Promise<void>;
@@ -91,6 +92,7 @@ export class WebSocketRule implements WebSocketRule {
         head: Buffer,
         options: {
             record: boolean,
+            debug: boolean,
             emitEventCallback?: (type: string, event: unknown) => void
         }
     ): Promise<void> {

src/server/mockttp-server.ts

@@ -776,6 +776,7 @@ export class MockttpServer extends AbstractMockttp implements Mockttp {
                 if (this.debug) console.log(`Request matched rule: ${nextRule.explain()}`);
                 await nextRule.handle(request, response, {
                     record: this.recordTraffic,
+                    debug: this.debug,
                     emitEventCallback: (this.eventEmitter.listenerCount('rule-event') !== 0)
                         ? (type, event) => this.announceRuleEventAsync(request.id, nextRule!.id, type, event)
                         : undefined
@@ -849,6 +850,7 @@ export class MockttpServer extends AbstractMockttp implements Mockttp {
                 if (this.debug) console.log(`Websocket matched rule: ${nextRule.explain()}`);
                 await nextRule.handle(request, socket, head, {
                     record: this.recordTraffic,
+                    debug: this.debug,
                     emitEventCallback: (this.eventEmitter.listenerCount('rule-event') !== 0)
                         ? (type, event) => this.announceRuleEventAsync(request.id, nextRule!.id, type, event)
                         : undefined