From 7a2ebb92beaabc823b2a5099edd9029e6c5a12c0 Mon Sep 17 00:00:00 2001
From: Martin Dimitrov <martin3dimitrov@gmail.com>
Date: Tue, 4 Mar 2025 11:35:54 -0800
Subject: [PATCH] add fail fast to the common doorman lambda

---
 bun.lockb                                     | Bin 429472 -> 430304 bytes
 packages/doorman-api/package.json             |   3 +-
 .../doorman-api/src/common/DoormanHandler.ts  |  79 ++++++++++++++++--
 packages/doorman-client/package.json          |   3 +-
 .../src/functions/buzzer-activated.ts         |  30 +++----
 5 files changed, 93 insertions(+), 22 deletions(-)

diff --git a/bun.lockb b/bun.lockb
index 5ca2f056ad98ccb12d217e29d05aec4c31b340bd..12921d98002383fd4b424b382b911aac75d0157f 100755
GIT binary patch
delta 23944
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

delta 23573
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
NR$wjFXjb6r{{!ivW>o+H

diff --git a/packages/doorman-api/package.json b/packages/doorman-api/package.json
index 7707587..6382487 100644
--- a/packages/doorman-api/package.json
+++ b/packages/doorman-api/package.json
@@ -12,10 +12,11 @@
   },
   "dependencies": {
     "@aws-sdk/client-dynamodb": "^3.609.0",
-    "@twilio-labs/serverless-runtime-types": "^3.0.0",
+    "@twilio-labs/serverless-runtime-types": "^4.0.1",
     "@twilio/runtime-handler": "1.3.0",
     "discord.js": "^14.16.3",
     "prom-client": "^15.1.3",
+    "promise.timeout": "^1.2.0",
     "twilio": "^3.56",
     "winston": "^3.17.0",
     "winston-loki": "^6.1.3"
diff --git a/packages/doorman-api/src/common/DoormanHandler.ts b/packages/doorman-api/src/common/DoormanHandler.ts
index e02fa62..764ad68 100644
--- a/packages/doorman-api/src/common/DoormanHandler.ts
+++ b/packages/doorman-api/src/common/DoormanHandler.ts
@@ -4,19 +4,27 @@ import { DoormanLambdaContext } from "./DoormanHandlerContext";
 import { shouldBlockRequest } from "../utils/blockUserAgent";
 import { RequestOptions } from "https";
 import { FastHttpPushgateway } from "../metrics/FastHttpPromGateway";
+import '@twilio-labs/serverless-runtime-types';
+import VoiceResponse from 'twilio/lib/twiml/VoiceResponse';
 
 import { createLogger, format, Logger, transports } from "winston";
 import LokiTransport from "winston-loki";
+import pTimeout, { TimeoutError } from "promise.timeout";
 
 export type BaseEvent = { request: { cookies: {}; headers: {}; }; }
 
+export type CallbackResult = Parameters<ServerlessCallback>;
+export type FailFastCallback = () => CallbackResult;
+
 export type DoormanLambda<T extends DoormanLambdaContext, U extends BaseEvent> = (
   context: Parameters<ServerlessFunctionSignature<T, U>>[0],
   event: Parameters<ServerlessFunctionSignature<T, U>>[1],
   callback: Parameters<ServerlessFunctionSignature<T, U>>[2],
   metricsRegistry: Registry<PrometheusContentType>,
   logger: Logger,
-) => void;
+  // this is optional, but if called this method should provide an alternative callback provider that can fail fast
+  failFastCallback: (fn: FailFastCallback) => void,
+) => Promise<void>;
 
 export enum CommonMetrics {
   RUNTIME = "FunctionRuntime",
@@ -25,6 +33,9 @@ export enum CommonMetrics {
   LOKI_ERROR = "LokiError",
   LOKI_LOG_AFTER_CLOSE = "LokiLogAfterClose",
   TWILIO_ISOLATION_BUSTED = "TwilioIsolationBusted",
+  INNER_HANDLER_TIMEOUT = "InnerHandlerTimeout",
+  INNER_HANDLER_MISSING_FAIL_FAST = "InnerHandlerMissingFailFast",
+  RETURN_FALLBACK_RESPONSE = "ReturnFallbackResponse",
 };
 
 export function getMetricFromRegistry<T>(metricsRegistry: Registry, metric: string): T {
@@ -42,8 +53,15 @@ export function gracefullyEndLogger(logger: Logger): Promise<void> {
   });
 }
 
+// TODO: make this response a voice message?
+const REJECT_RESPONSE = new VoiceResponse();
+REJECT_RESPONSE.reject();
+
+const FALLBACK_CALLBACK: CallbackResult = [null, REJECT_RESPONSE];
+
 const MINIMUM_MS_TO_SEND_RESPONSE: number = 250;
 const FUNCTION_MAXIMUM_DURATION_MS: number = 10_000;
+const INNER_HANDLER_MAXIMUM_DURATION_MS: number = 8_500;
 
 /**
  * A decorator for twilio handlers. It provides a metrics registry and 
@@ -100,6 +118,21 @@ export function withMetrics<T extends DoormanLambdaContext, U extends BaseEvent>
       help: "Twilio invocation lasted longer than 10s",
     }));
 
+    metricsRegistry.registerMetric(new Counter({
+      name: CommonMetrics.INNER_HANDLER_MISSING_FAIL_FAST,
+      help: "Inner handler was timed out and we did not have any fallback response",
+    }));
+
+    metricsRegistry.registerMetric(new Counter({
+      name: CommonMetrics.INNER_HANDLER_TIMEOUT,
+      help: "Inner handler was timed out",
+    }));
+
+    metricsRegistry.registerMetric(new Counter({
+      name: CommonMetrics.RETURN_FALLBACK_RESPONSE,
+      help: "Common handler returned a fallback response",
+    }));
+
     // Create a Winston logger
     const logger = createLogger({
       level: 'info',
@@ -136,6 +169,7 @@ export function withMetrics<T extends DoormanLambdaContext, U extends BaseEvent>
     // Override the base console log with winston
     console.log = function (...args) {
       if (logger.writable) {
+        // @ts-ignore
         return logger.info.apply(logger, [...args]);
       }
       getMetricFromRegistry<Counter>(metricsRegistry, CommonMetrics.LOKI_LOG_AFTER_CLOSE).inc(1);
@@ -143,6 +177,7 @@ export function withMetrics<T extends DoormanLambdaContext, U extends BaseEvent>
     };
     console.error = function (...args) {
       if (logger.writable) {
+        // @ts-ignore
         return logger.error.apply(logger, [...args]);
       }
       getMetricFromRegistry<Counter>(metricsRegistry, CommonMetrics.LOKI_LOG_AFTER_CLOSE).inc(1);
@@ -150,6 +185,7 @@ export function withMetrics<T extends DoormanLambdaContext, U extends BaseEvent>
     };
     console.warn = function (...args) {
       if (logger.writable) {
+        // @ts-ignore
         return logger.warn.apply(logger, [...args]);
       }
       getMetricFromRegistry<Counter>(metricsRegistry, CommonMetrics.LOKI_LOG_AFTER_CLOSE).inc(1);
@@ -157,6 +193,7 @@ export function withMetrics<T extends DoormanLambdaContext, U extends BaseEvent>
     };
     console.info = function (...args) {
       if (logger.writable) {
+        // @ts-ignore
         return logger.info.apply(logger, [...args]);
       }
       getMetricFromRegistry<Counter>(metricsRegistry, CommonMetrics.LOKI_LOG_AFTER_CLOSE).inc(1);
@@ -175,6 +212,12 @@ export function withMetrics<T extends DoormanLambdaContext, U extends BaseEvent>
         callbackResult = [err, payload];
       }
 
+      // intercept the fail fast callback method, if it is provided
+      let failFastCallbackMethod: FailFastCallback | undefined;
+      const failFastCallbackProvider: (fn: FailFastCallback) => void = (fn) => {
+        failFastCallbackMethod = fn;
+      }
+
       // block requests before we even call the handler
       if (shouldBlockRequest(event)) {
         getMetricFromRegistry<Counter>(metricsRegistry, CommonMetrics.BLOCKED_REQUEST).inc(1);
@@ -182,14 +225,34 @@ export function withMetrics<T extends DoormanLambdaContext, U extends BaseEvent>
         response.setStatusCode(200);
         callbackResult = [null, response];
       } else {
-        await handler(context, event, tempCallback, metricsRegistry, logger);
+        // wait for response for up to x ms, otherwise we call the failFastCallbackMethod
+        try {
+          await pTimeout(
+            () => handler(context, event, tempCallback, metricsRegistry, logger, failFastCallbackProvider), 
+            INNER_HANDLER_MAXIMUM_DURATION_MS
+          )();
+        } catch (e) {
+          console.log(e);
+          if (e instanceof TimeoutError) {
+            getMetricFromRegistry<Counter>(metricsRegistry, CommonMetrics.INNER_HANDLER_TIMEOUT).inc(1);
+
+            if (!failFastCallbackMethod) {
+              getMetricFromRegistry<Counter>(metricsRegistry, CommonMetrics.INNER_HANDLER_MISSING_FAIL_FAST).inc(1);
+              reject("Timeout, but no failfast result was given");
+              return;
+            }
+
+            callbackResult = failFastCallbackMethod();
+          }
+        }
       }
 
       if (!callbackResult) {
         reject("No callback was given");
+        return;
       }
 
-      let statusCode: number | undefined = (callbackResult?.[1] as any)?.statusCode;
+      let statusCode: number | undefined = (callbackResult[1] as any)?.statusCode;
 
       if (statusCode && statusCode >= 400) {
         getMetricFromRegistry<Counter>(metricsRegistry, CommonMetrics.HTTP_CLIENT_ERROR).inc({
@@ -197,12 +260,16 @@ export function withMetrics<T extends DoormanLambdaContext, U extends BaseEvent>
         }, 1);
       }
 
-      resolve(callbackResult as Parameters<ServerlessCallback>);
+      resolve(callbackResult);
     });
 
     console.time("[CommonHandler] nested handler time");
 
-    const result = await handlerResponsePromise;
+    const result = await handlerResponsePromise.catch((err) => {
+      console.error("[CommonHandler] inner handler promise was rejected with reason: " + err);
+      getMetricFromRegistry<Counter>(metricsRegistry, CommonMetrics.RETURN_FALLBACK_RESPONSE).inc(1);
+      return FALLBACK_CALLBACK;
+    });
 
     console.timeEnd("[CommonHandler] nested handler time");
 
@@ -214,7 +281,7 @@ export function withMetrics<T extends DoormanLambdaContext, U extends BaseEvent>
       getMetricFromRegistry<Counter>(metricsRegistry, CommonMetrics.TWILIO_ISOLATION_BUSTED).inc(1);
     }
 
-    // abandoning metrics, since there isn't enough time
+    // abandoning metrics/logs, since there isn't enough time
     if (remainingTime <= MINIMUM_MS_TO_SEND_RESPONSE) {
       console.error("[CommonHandler] there is no time to send metrics / logs abandoning them");
       callback(...result);
diff --git a/packages/doorman-client/package.json b/packages/doorman-client/package.json
index 6e4f891..c90d1b9 100644
--- a/packages/doorman-client/package.json
+++ b/packages/doorman-client/package.json
@@ -11,11 +11,12 @@
     "deploy": "twilio-run deploy --load-system-env --env .env.example --service-name buzzer --environment=prod --override-existing-project"
   },
   "dependencies": {
-    "@twilio-labs/serverless-runtime-types": "^3.0.0",
+    "@twilio-labs/serverless-runtime-types": "^4.0.1",
     "@twilio/runtime-handler": "1.3.0",
     "node-fetch": "^2.7.0",
     "prom-client": "^15.1.3",
     "prometheus-remote-write": "^0.5.0",
+    "promise.timeout": "^1.2.0",
     "twilio": "^3.84.1",
     "winston": "^3.17.0",
     "winston-loki": "^6.1.3"
diff --git a/packages/doorman-client/src/functions/buzzer-activated.ts b/packages/doorman-client/src/functions/buzzer-activated.ts
index 1ccf3d7..70fe6a9 100644
--- a/packages/doorman-client/src/functions/buzzer-activated.ts
+++ b/packages/doorman-client/src/functions/buzzer-activated.ts
@@ -19,7 +19,7 @@ import { getMetricFromRegistry, withMetrics } from '../../../doorman-api/src/com
 import { Counter, Summary } from 'prom-client';
 import { BuzzerActivatedMetrics, registerMetrics } from '../metrics/BuzzerActivatedMetrics';
 
-export const handler: ServerlessFunctionSignature<TwilioContext, BuzzerDialEvent> = withMetrics('buzzer-activated', async function(context, event, callback, metricsRegistry) {
+export const handler: ServerlessFunctionSignature<TwilioContext, BuzzerDialEvent> = withMetrics('buzzer-activated', async function(context, event, callback, metricsRegistry, logger, failFastCallback) {
   // metrics
   registerMetrics(metricsRegistry);
   
@@ -58,7 +58,7 @@ export const handler: ServerlessFunctionSignature<TwilioContext, BuzzerDialEvent
 
   await notifyDiscord(context, msgs, config.discordUsers, config.discordUsers.map(() => ""), metricsRegistry);
 
-  let discordLock = false;
+  let responseLock = false;
   let intervals: Timer[] = [];
   let timeouts: Timer[] = [];
 
@@ -79,8 +79,8 @@ export const handler: ServerlessFunctionSignature<TwilioContext, BuzzerDialEvent
             clearInterval(intervals[0]);
             const twiml = doorOpenTwiml(config);
 
-            if (!discordLock) {
-              discordLock = true;
+            if (!responseLock) {
+              responseLock = true;
               console.log(
                 invokeId + " UnlockPromise: I was the fastest, so I will attempt to notify discord users before resolving with unlock"
               );
@@ -103,8 +103,8 @@ export const handler: ServerlessFunctionSignature<TwilioContext, BuzzerDialEvent
     timeouts.push(setTimeout(async () => {
       const twiml = dialFallbackTwiml(config);
 
-      if (!discordLock) {
-        discordLock = true;
+      if (!responseLock) {
+        responseLock = true;
         getMetricFromRegistry<Counter>(metricsRegistry, BuzzerActivatedMetrics.DIAL_THROUGH)
           .inc({ door: config.door }, 1);
 
@@ -120,15 +120,18 @@ export const handler: ServerlessFunctionSignature<TwilioContext, BuzzerDialEvent
         resolve(twiml);
       } else {
         console.log(
-          invokeId + " GracefulFallbackPromise: dropping out of the race, unlock is already notifying discord users"
+          invokeId + " GracefulFallbackPromise: dropping out of the race, another response is already underway"
         );
       }
     }, 7500));
   });
 
-  const ungracefulFallbackPromise = new Promise<VoiceResponse>((resolve, reject) => {
-    timeouts.push(setTimeout(async () => {
-      getMetricFromRegistry<Counter>(metricsRegistry, BuzzerActivatedMetrics.RESULT_NOTIFICATION_FATE_UNKNOWN)
+  // provide a method to the decorator to use as a fast fallback that shouldn't have any await
+  failFastCallback(() => {
+    // prevent other responses
+    responseLock = true;
+
+    getMetricFromRegistry<Counter>(metricsRegistry, BuzzerActivatedMetrics.RESULT_NOTIFICATION_FATE_UNKNOWN)
         .inc({ door: config.door }, 1);
       
       getMetricFromRegistry<Counter>(metricsRegistry, BuzzerActivatedMetrics.DIAL_THROUGH)
@@ -136,13 +139,12 @@ export const handler: ServerlessFunctionSignature<TwilioContext, BuzzerDialEvent
 
       const twiml = dialFallbackTwiml(config);
       console.log(
-        invokeId + " UngracefulFallbackPromise: Cutting it too close to timeout! Skipping notifying users and calling fallback"
+        invokeId + " UngracefulFallback: Cutting it too close to timeout! Skipping notifying users and responding fallback"
       );
-      resolve(twiml);
-    }, 8500));
+      return [null, twiml];
   });
 
-  const twiml = await Promise.race([unlockPromise, gracefulFallbackPromise, ungracefulFallbackPromise]);
+  const twiml = await Promise.race([unlockPromise, gracefulFallbackPromise]);
   console.log(invokeId + " Race ended, clearing residual timers");
   timeouts.forEach(timeout => clearTimeout(timeout));
   intervals.forEach(interval => clearInterval(interval));