@platformatic/service 3.33.0 → 3.34.1-alpha.3

package/config.d.ts

@@ -423,6 +423,10 @@ export interface PlatformaticServiceConfig {
     gracefulShutdown?: {
       runtime: number | string;
       application: number | string;
+      /**
+       * Add Connection: close header to HTTP responses during graceful shutdown
+       */
+      closeConnections?: boolean;
     };
     health?: {
       enabled?: boolean | string;
@@ -586,6 +590,23 @@ export interface PlatformaticServiceConfig {
              */
             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

@@ -39,6 +39,23 @@ export class ServiceCapability extends BaseCapability {
       }
     })
 
+    // Add hook to set Connection: close during graceful shutdown.
+    // This must be added BEFORE plugins are registered, because if a plugin
+    // calls app.ready() during registration and we add hooks afterwards,
+    // it can cause issues with Fastify's internal promise handling.
+    const closeConnections = this.runtimeConfig?.gracefulShutdown?.closeConnections !== false
+    if (closeConnections) {
+      this.#app.addHook('onRequest', (request, reply, done) => {
+        if (this.closing) {
+          // For HTTP/1.x, set Connection: close
+          if (request.raw.httpVersionMajor !== 2) {
+            reply.header('Connection', 'close')
+          }
+        }
+        done()
+      })
+    }
+
     // This must be done before loading the plugins, so they can inspect if the
     // openTelemetry decorator exists and then configure accordingly.
     // Skip manual telemetry plugin if automatic instrumentation is already active
@@ -93,6 +110,15 @@ export class ServiceCapability extends BaseCapability {
     await this.#app?.close()
   }
 
+  setClosing () {
+    super.setClosing()
+
+    // For HTTP/2, send GOAWAY frames immediately
+    if (this.#app?.server?.closeHttp2Sessions) {
+      this.#app.server.closeHttp2Sessions()
+    }
+  }
+
   async inject (injectParams, onInject) {
     const response = await this.#app.inject(injectParams, onInject)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platformatic/service",
-  "version": "3.33.0",
+  "version": "3.34.1-alpha.3",
   "description": "",
   "main": "index.js",
   "types": "index.d.ts",
@@ -67,12 +67,12 @@
     "rfdc": "^1.3.1",
     "semgrator": "^0.3.0",
     "undici": "^7.0.0",
-    "@platformatic/basic": "3.33.0",
-    "@platformatic/foundation": "3.33.0",
-    "@platformatic/generators": "3.33.0",
-    "@platformatic/metrics": "3.33.0",
-    "@platformatic/scalar-theme": "3.33.0",
-    "@platformatic/telemetry": "3.33.0"
+    "@platformatic/basic": "3.34.1-alpha.3",
+    "@platformatic/foundation": "3.34.1-alpha.3",
+    "@platformatic/generators": "3.34.1-alpha.3",
+    "@platformatic/telemetry": "3.34.1-alpha.3",
+    "@platformatic/metrics": "3.34.1-alpha.3",
+    "@platformatic/scalar-theme": "3.34.1-alpha.3"
   },
   "engines": {
     "node": ">=22.19.0"

package/schema.json

@@ -1,6 +1,6 @@
 {
-  "$id": "https://schemas.platformatic.dev/@platformatic/service/3.33.0.json",
-  "version": "3.33.0",
+  "$id": "https://schemas.platformatic.dev/@platformatic/service/3.34.1-alpha.3.json",
+  "version": "3.34.1-alpha.3",
   "title": "Platformatic Service Config",
   "type": "object",
   "properties": {
@@ -1735,6 +1735,11 @@
                 }
               ],
               "default": 10000
+            },
+            "closeConnections": {
+              "type": "boolean",
+              "default": true,
+              "description": "Add Connection: close header to HTTP responses during graceful shutdown"
             }
           },
           "default": {},
@@ -2275,6 +2280,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