@platformatic/node 3.33.0 → 3.34.1-alpha.3

package/config.d.ts

@@ -231,6 +231,10 @@ export interface PlatformaticNodeJsConfig {
     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 PlatformaticNodeJsConfig {
              */
             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

@@ -36,10 +36,18 @@ const validFilesBasenames = ['index', 'main', 'app', 'application', 'server', 's
 
 // Paolo: This is kinda hackish but there is no better way. I apologize.
 function isFastify (app) {
+  if (!app) {
+    return false
+  }
+
   return Object.getOwnPropertySymbols(app).some(s => s.description === 'fastify.state')
 }
 
 function isKoa (app) {
+  if (!app) {
+    return false
+  }
+
   return typeof app.callback === 'function'
 }
 
@@ -221,6 +229,30 @@ export class NodeCapability extends BaseCapability {
     return this.config.node?.hasServer !== false && this.#module?.hasServer !== false
   }
 
+  setClosing () {
+    super.setClosing()
+
+    if (!this.#server) return
+
+    const closeConnections = this.runtimeConfig?.gracefulShutdown?.closeConnections !== false
+    if (!closeConnections) return
+
+    // For non-Fastify raw HTTP 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 HTTP/2, send GOAWAY frames
+    if (this.#server.closeHttp2Sessions) {
+      this.#server.closeHttp2Sessions()
+    }
+  }
+
   async stop () {
     await super.stop()
 
@@ -345,6 +377,14 @@ export class NodeCapability extends BaseCapability {
     return this.getDispatchFunc()
   }
 
+  async getDispatchFunc () {
+    if (!this.#hasServer()) {
+      return this.#backgroundServiceInject.bind(this)
+    }
+
+    return super.getDispatchFunc()
+  }
+
   async _listen () {
     // Make this idempotent
     /* c8 ignore next 3 */
@@ -451,4 +491,8 @@ export class NodeCapability extends BaseCapability {
       ignore
     }
   }
+
+  #backgroundServiceInject (_, res) {
+    res.destroy(new Error('Background services cannot receive HTTP requests via the mesh network.'))
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platformatic/node",
-  "version": "3.33.0",
+  "version": "3.34.1-alpha.3",
   "description": "Platformatic Node.js Capability",
   "main": "index.js",
   "type": "module",
@@ -18,9 +18,9 @@
     "@watchable/unpromise": "^1.0.2",
     "json5": "^2.2.3",
     "light-my-request": "^6.0.0",
-    "@platformatic/basic": "3.33.0",
-    "@platformatic/foundation": "3.33.0",
-    "@platformatic/generators": "3.33.0"
+    "@platformatic/basic": "3.34.1-alpha.3",
+    "@platformatic/foundation": "3.34.1-alpha.3",
+    "@platformatic/generators": "3.34.1-alpha.3"
   },
   "devDependencies": {
     "cleaner-spec-reporter": "^0.5.0",
@@ -32,8 +32,8 @@
     "neostandard": "^0.12.0",
     "tsx": "^4.19.0",
     "typescript": "^5.5.4",
-    "@platformatic/service": "3.33.0",
-    "@platformatic/gateway": "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/node/3.33.0.json",
+  "$id": "https://schemas.platformatic.dev/@platformatic/node/3.34.1-alpha.3.json",
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "Platformatic Node.js 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