chore: deploy api v2 on vercel

apps/api/v2/package.json

@@ -6,7 +6,7 @@
   "license": "UNLICENSED",
   "private": true,
   "scripts": {
-    "build": "yarn dev:build && nest build",
+    "build": "nest build",
     "format": "biome format --write src test",
     "start": "nest start",
     "dev:build:watch": "concurrently --names \"libraries,lru-fix,constants,enums,utils,types\" \"yarn _dev:build:watch:libraries\" \"yarn _dev:build:watch:libraries:lru-fix\" \"yarn _dev:build:watch:constants\" \"yarn _dev:build:watch:enums\" \"yarn _dev:build:watch:utils\" \"yarn _dev:build:watch:types\"",

apps/api/v2/src/bootstrap.ts

@@ -12,7 +12,7 @@ import {
 import type { ValidationError } from "@nestjs/common";
 import { BadRequestException, ValidationPipe, VersioningType } from "@nestjs/common";
 import type { NestExpressApplication } from "@nestjs/platform-express";
-import * as cookieParser from "cookie-parser";
+import cookieParser from "cookie-parser";
 import { Request } from "express";
 import helmet from "helmet";
 import { HttpExceptionFilter } from "@/filters/http-exception.filter";
@@ -22,7 +22,9 @@ import { CalendarServiceExceptionFilter } from "./filters/calendar-service-excep
 import { TRPCExceptionFilter } from "./filters/trpc-exception.filter";
 
 export const bootstrap = (app: NestExpressApplication): NestExpressApplication => {
-  app.enableShutdownHooks();
+  if (!process.env.VERCEL) {
+    app.enableShutdownHooks();
+  }
   app.enableVersioning({
     type: VersioningType.CUSTOM,
     extractor: (request: unknown) => {

apps/api/v2/src/main.ts

@@ -1,26 +1,67 @@
 import "dotenv/config";
 
 import { IncomingMessage, Server, ServerResponse } from "node:http";
+import process from "node:process";
 import { Logger } from "@nestjs/common";
 import { ConfigService } from "@nestjs/config";
 import { NestFactory } from "@nestjs/core";
 import type { NestExpressApplication } from "@nestjs/platform-express";
+import type { Express, Request, Response } from "express";
 import { WinstonModule } from "nest-winston";
 import * as qs from "qs";
+
 import type { AppConfig } from "@/config/type";
+
 import { AppModule } from "./app.module";
 import { bootstrap } from "./bootstrap";
 import { loggerConfig } from "./lib/logger";
 
-run().catch((error: Error) => {
-  console.error("Failed to start Cal Platform API", { error: error.stack });
-  process.exit(1);
-});
+const logger: Logger = new Logger("App");
+
+/**
+ * Singleton Class to manage the NestJS App instance.
+ * Ensures we only initialize the app once per container lifecycle.
+ */
+class NestServer {
+  private static server: Express; // The underlying Express instance
+
+  private constructor() {}
+
+  /**
+   * Returns the cached server instance.
+   * If it doesn't exist, it creates, bootstraps, and initializes it.
+   */
+  public static async getInstance(): Promise<Express> {
+    if (!NestServer.server) {
+      const app = await createNestApp();
+
+      // Execute bootstrap (Pipes, Interceptors, CORS, etc.)
+      bootstrap(app);
+
+      // Initialize the app (connects to DB, resolves modules)
+      await app.init();
+
+      // extract the Express instance to pass to Vercel
+      NestServer.server = app.getHttpAdapter().getInstance();
+    }
+    return NestServer.server;
+  }
+}
+
+// -----------------------------------------------------------------------------
+// LOCAL DEVELOPMENT STARTUP
+// -----------------------------------------------------------------------------
+if (!process.env.VERCEL) {
+  console.log("CALL RUN STARTUP");
+  run().catch((error: Error) => {
+    logger.error("Failed to start Cal Platform API", { error: error.stack });
+    process.exit(1);
+  });
+}
 
 async function run(): Promise<void> {
+  console.log("RUN LOCAL/FlightControl STARTUP");
   const app = await createNestApp();
-  const logger = new Logger("App");
-
   try {
     bootstrap(app);
     const config = app.get(ConfigService<AppConfig, true>);
@@ -32,24 +73,52 @@ async function run(): Promise<void> {
     }
 
     await app.listen(port);
-    logger.log(`Application started on port: ${port}`);
+    logger.log(`Application started locally on port: ${port}`);
   } catch (error) {
-    console.error(error);
-    logger.error("Application crashed", {
-      error,
-    });
+    logger.error("Application crashed during local startup", { error });
   }
 }
 
+// -----------------------------------------------------------------------------
+// VERCEL SERVERLESS HANDLER
+// -----------------------------------------------------------------------------
+export default async (req: Request, res: Response): Promise<void> => {
+  console.log("VERCEL SERVERLESS HANDLER", process.env.VERCEL);
+  try {
+    const server = await NestServer.getInstance();
+
+    // Vercel/AWS specific: Re-parse query strings to support array formats
+    // (e.g., ?ids[]=1&ids[]=2) which Vercel's native parser might simplify.
+    if (req.url) {
+      const [_path, queryString] = req.url.split("?");
+      if (queryString) {
+        req.query = qs.parse(queryString, { arrayLimit: 1000, comma: true });
+      }
+    }
+
+    // Delegate request to the cached Express instance
+    return server(req, res);
+  } catch (error) {
+    console.error("Critical: Failed to initialize NestJS Serverless instance", error);
+    res.statusCode = 500;
+    res.end("Internal Server Error: Initialization Failed");
+  }
+};
+
+// -----------------------------------------------------------------------------
+// APP FACTORY
+// -----------------------------------------------------------------------------
 export async function createNestApp(): Promise<
   NestExpressApplication<Server<typeof IncomingMessage, typeof ServerResponse>>
 > {
   const app = await NestFactory.create<NestExpressApplication>(AppModule, {
     logger: WinstonModule.createLogger(loggerConfig()),
+    // Preserved as requested:
     bodyParser: false,
   });
 
-  app.set("query parser", (str: string) => qs.parse(str, { arrayLimit: 1000 }));
+  // Custom query parser configuration for the underlying Express app
+  app.set("query parser", (str: string) => qs.parse(str, { arrayLimit: 1000, comma: true }));
 
   return app;
 }

biome.json

@@ -164,7 +164,7 @@
     {
       "includes": [
         "apps/api/v2/src/config/app.ts",
-        "apps/api/v2/src/config/bootstrap.ts",
+        "apps/api/v2/src/bootstrap.ts",
         "apps/api/v2/src/config/env.ts",
         "apps/api/v2/src/env.ts",
         "apps/api/v2/test/setEnvVars.ts"
@@ -325,9 +325,7 @@
       }
     },
     {
-      "includes": [
-        "packages/platform/atoms/**/*.{ts,tsx,js,jsx,mts,mjs,cjs,cts}"
-      ],
+      "includes": ["packages/platform/atoms/**/*.{ts,tsx,js,jsx,mts,mjs,cjs,cts}"],
       "linter": {
         "rules": {
           "style": {
@@ -336,17 +334,11 @@
               "options": {
                 "patterns": [
                   {
-                    "group": [
-                      "@calcom/trpc/react",
-                      "@calcom/trpc/react/**"
-                    ],
+                    "group": ["@calcom/trpc/react", "@calcom/trpc/react/**"],
                     "message": "atoms package should not import from @calcom/trpc/react."
                   },
                   {
-                    "group": [
-                      "../../trpc/react",
-                      "../../trpc/react/**"
-                    ],
+                    "group": ["../../trpc/react", "../../trpc/react/**"],
                     "message": "atoms package should not import from trpc/react."
                   }
                 ]

turbo.json

@@ -378,6 +378,7 @@
     },
     "@calcom/api-v2#build": {
       "dependsOn": ["^build"],
+      "outputs": ["dist/**"],
       "env": [
         "NODE_ENV",
         "API_PORT",