@platformatic/nest 3.33.0 → 3.34.1-alpha.3

package/config.d.ts

@@ -231,6 +231,10 @@ export interface PlatformaticNestJSConfig {
     gracefulShutdown?: {
       runtime: number | string;
       application: number | string;
+      /**
+       * Add Connection: close header to HTTP responses during graceful shutdown
+       */
+      closeConnections?: boolean;
     };
     health?: {
       enabled?: boolean | string;
@@ -394,6 +398,23 @@ export interface PlatformaticNestJSConfig {
              */
             serviceVersion?: string;
           };
+          /**
+           * Custom labels to add to HTTP metrics (http_request_all_duration_seconds). Each label extracts its value from an HTTP request header.
+           */
+          httpCustomLabels?: {
+            /**
+             * The label name to use in metrics
+             */
+            name: string;
+            /**
+             * The HTTP request header to extract the value from
+             */
+            header: string;
+            /**
+             * Default value when header is missing (defaults to "unknown")
+             */
+            default?: string;
+          }[];
         };
     telemetry?: {
       enabled?: boolean | string;

package/lib/capability.js

@@ -103,6 +103,32 @@ export class NestCapability extends BaseCapability {
     return this._closeServer(this.#server)
   }
 
+  setClosing () {
+    super.setClosing()
+
+    if (!this.#server) return
+
+    const closeConnections = this.runtimeConfig?.gracefulShutdown?.closeConnections !== false
+    if (!closeConnections) return
+
+    // For non-Fastify (Express) servers, add request listener to set Connection: close
+    if (!this.#isFastify) {
+      const self = this
+      this.#server.on('request', (req, res) => {
+        if (self.closing && !res.headersSent && req.httpVersionMajor !== 2) {
+          res.setHeader('Connection', 'close')
+        }
+      })
+    }
+
+    // For Fastify, it handles Connection: close via its own hook in ServiceCapability pattern
+    // but we still need to close HTTP/2 sessions
+    const server = this.#isFastify ? this.#server.server : this.#server
+    if (server?.closeHttp2Sessions) {
+      server.closeHttp2Sessions()
+    }
+  }
+
   async build () {
     if (!this.#nestjsCore) {
       await this.init()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platformatic/nest",
-  "version": "3.33.0",
+  "version": "3.34.1-alpha.3",
   "description": "Platformatic Nest.js Capability",
   "main": "index.js",
   "type": "module",
@@ -18,9 +18,9 @@
     "get-port": "^7.1.0",
     "light-my-request": "^6.0.0",
     "pino-http": "^10.2.0",
-    "@platformatic/basic": "3.33.0",
-    "@platformatic/foundation": "3.33.0",
-    "@platformatic/generators": "3.33.0"
+    "@platformatic/basic": "3.34.1-alpha.3",
+    "@platformatic/generators": "3.34.1-alpha.3",
+    "@platformatic/foundation": "3.34.1-alpha.3"
   },
   "devDependencies": {
     "@nestjs/cli": "^11.0.7",
@@ -33,8 +33,8 @@
     "neostandard": "^0.12.0",
     "tsx": "^4.19.0",
     "typescript": "^5.5.4",
-    "@platformatic/gateway": "3.33.0",
-    "@platformatic/service": "3.33.0"
+    "@platformatic/gateway": "3.34.1-alpha.3",
+    "@platformatic/service": "3.34.1-alpha.3"
   },
   "engines": {
     "node": ">=22.19.0"

package/schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://schemas.platformatic.dev/@platformatic/nest/3.33.0.json",
+  "$id": "https://schemas.platformatic.dev/@platformatic/nest/3.34.1-alpha.3.json",
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "Platformatic NestJS Config",
   "type": "object",
@@ -1111,6 +1111,11 @@
                 }
               ],
               "default": 10000
+            },
+            "closeConnections": {
+              "type": "boolean",
+              "default": true,
+              "description": "Add Connection: close header to HTTP responses during graceful shutdown"
             }
           },
           "default": {},
@@ -1651,6 +1656,32 @@
                     "endpoint"
                   ],
                   "additionalProperties": false
+                },
+                "httpCustomLabels": {
+                  "type": "array",
+                  "description": "Custom labels to add to HTTP metrics (http_request_all_duration_seconds). Each label extracts its value from an HTTP request header.",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "name": {
+                        "type": "string",
+                        "description": "The label name to use in metrics"
+                      },
+                      "header": {
+                        "type": "string",
+                        "description": "The HTTP request header to extract the value from"
+                      },
+                      "default": {
+                        "type": "string",
+                        "description": "Default value when header is missing (defaults to \"unknown\")"
+                      }
+                    },
+                    "required": [
+                      "name",
+                      "header"
+                    ],
+                    "additionalProperties": false
+                  }
                 }
               },
               "additionalProperties": false