@platformatic/runtime 3.54.0 → 3.55.0

package/config.d.ts

@@ -42,6 +42,8 @@ export type PlatformaticRuntimeConfig = {
           maxHeapTotal?: number | string;
           maxYoungGeneration?: number | string;
           codeRangeSize?: number | string;
+          bufferPoolSize?: number | string;
+          defaultHighWaterMark?: number | string;
         };
         dependencies?: string[];
         arguments?: string[];
@@ -238,6 +240,8 @@ export type PlatformaticRuntimeConfig = {
     maxHeapTotal?: number | string;
     maxYoungGeneration?: number | string;
     codeRangeSize?: number | string;
+    bufferPoolSize?: number | string;
+    defaultHighWaterMark?: number | string;
   };
   undici?: {
     agentOptions?: {
@@ -340,6 +344,10 @@ export type PlatformaticRuntimeConfig = {
          * The label name to use for the application identifier in metrics (e.g., applicationId, serviceId)
          */
         applicationLabel?: string;
+        /**
+         * Enable outgoing HTTP client request duration metrics
+         */
+        httpClientMetrics?: boolean | string;
         readiness?:
           | boolean
           | {

package/index.d.ts

@@ -142,7 +142,26 @@ export class WrappedGenerator extends BaseGenerator {}
 
 export declare const schema: JSONSchemaType<PlatformaticRuntimeConfig>
 
-export declare class Runtime {}
+export declare class Runtime {
+  init (): Promise<void>
+  start (silent?: boolean): Promise<string | undefined>
+  stop (silent?: boolean): Promise<void>
+  close (silent?: boolean): Promise<void>
+  restart (applications?: string[]): Promise<string | undefined>
+  inject (id: string, injectParams: InjectParams): Promise<InjectResponse>
+  getUrl (): string | undefined
+  getRuntimeStatus (): string
+  getRuntimeMetadata (): Promise<RuntimeMetadata>
+  getRuntimeEnv (): Record<string, string>
+  getRuntimeConfig (includeMeta?: boolean): Record<string, unknown>
+  getApplicationsIds (): string[]
+  getApplicationDetails (id: string, allowUnloaded?: boolean): Promise<ApplicationDetails>
+  startApplication (id: string, silent?: boolean): Promise<void>
+  stopApplication (id: string, silent?: boolean): Promise<void>
+  restartApplication (id: string): Promise<void>
+  addApplications (applications: unknown[], start?: boolean): Promise<ApplicationDetails[]>
+  removeApplications (applications: string[], silent?: boolean): Promise<ApplicationDetails[]>
+}
 
 export function wrapInRuntimeConfig (
   config: Configuration<unknown>,

package/lib/logger.js

@@ -63,6 +63,7 @@ const colors = [
 function createLoggerContext () {
   const context = {
     colors: {},
+    closeables: [],
     maxLength: 0,
     updatePrefixes (ids) {
       context.colors = {}
@@ -179,28 +180,29 @@ export async function createLogger (config) {
   const multiStream = pino.multistream([{ stream: cliStream, level: loggerConfig.level }])
 
   if (config.telemetry && config.logger.openTelemetryExporter) {
-    multiStream.add(
-      pino.transport({
-        target: 'pino-opentelemetry-transport',
-        options: {
-          resourceAttributes: {
-            'service.name': config.telemetry.applicationName,
-            'service.version': config.telemetry.version
-          },
-          logRecordProcessorOptions: [
-            {
-              recordProcessorType: 'simple',
-              exporterOptions: {
-                protocol: config.logger.openTelemetryExporter.protocol,
-                httpExporterOptions: {
-                  url: config.logger.openTelemetryExporter.url
-                }
+    const openTelemetryTransport = pino.transport({
+      target: 'pino-opentelemetry-transport',
+      options: {
+        resourceAttributes: {
+          'service.name': config.telemetry.applicationName,
+          'service.version': config.telemetry.version
+        },
+        logRecordProcessorOptions: [
+          {
+            recordProcessorType: 'simple',
+            exporterOptions: {
+              protocol: config.logger.openTelemetryExporter.protocol,
+              httpExporterOptions: {
+                url: config.logger.openTelemetryExporter.url
               }
             }
-          ]
-        }
-      })
-    )
+          }
+        ]
+      }
+    })
+
+    context.closeables.push(openTelemetryTransport)
+    multiStream.add(openTelemetryTransport)
   }
 
   const logsFileMb = 5

package/lib/runtime.js

@@ -20,6 +20,7 @@ import { createRequire } from 'node:module'
 import { availableParallelism } from 'node:os'
 import { dirname, isAbsolute, join } from 'node:path'
 import { Readable } from 'node:stream'
+import { finished } from 'node:stream/promises'
 import { setImmediate as immediate, setTimeout as sleep } from 'node:timers/promises'
 import { pathToFileURL } from 'node:url'
 import { Worker } from 'node:worker_threads'
@@ -400,11 +401,22 @@ export class Runtime extends EventEmitter {
     }
 
     if (this.logger) {
-      this.#loggerDestination?.end()
+      const loggerDestination = this.#loggerDestination
+      const loggerCloseables = this.#loggerContext?.closeables ?? []
 
       this.logger = abstractLogger
       this.#loggerDestination = null
       this.#loggerContext = null
+
+      if (loggerDestination) {
+        loggerDestination.end()
+        await finished(loggerDestination).catch(() => {})
+      }
+
+      for (const closeable of loggerCloseables) {
+        closeable.end?.()
+        await finished(closeable).catch(() => {})
+      }
     }
 
     this.#updateStatus('closed')
@@ -3243,6 +3255,15 @@ export class Runtime extends EventEmitter {
       return argv
     }
 
+    // Starting from Node.js 25 the Permission Model also gates network access
+    // (dns.lookup, server.listen, outbound connections and fetch) behind
+    // --allow-net. Applications always need to bind their HTTP server and reach
+    // other applications through the internal mesh, so we always grant it when
+    // available. On older versions the flag does not exist and must be omitted.
+    if (features.node.permission.network) {
+      allows.add('--allow-net')
+    }
+
     // We need to allow read access to the node_modules folder both at the runtime level and at the application level
     allows.add(`--allow-fs-read=${join(this.#root, 'node_modules', '*')}`)
     allows.add(`--allow-fs-read=${join(applicationConfig.path, 'node_modules', '*')}`)

package/lib/worker/controller.js

@@ -5,7 +5,8 @@ import {
   kHandledError,
   listRecognizedConfigurationFiles,
   loadConfiguration,
-  loadConfigurationModule
+  loadConfigurationModule,
+  mirrorGlobalDispatcherForBuiltinFetch
 } from '@platformatic/foundation'
 import debounce from 'debounce'
 import { EventEmitter } from 'node:events'
@@ -326,6 +327,7 @@ export class Controller extends EventEmitter {
     const dispatcher = getGlobalDispatcher().compose(interceptor)
 
     setGlobalDispatcher(dispatcher)
+    mirrorGlobalDispatcherForBuiltinFetch(dispatcher)
   }
 
   #setupHandlers () {

package/lib/worker/interceptors.js

@@ -1,3 +1,4 @@
+import { mirrorGlobalDispatcherForBuiltinFetch } from '@platformatic/foundation'
 import { createTelemetryThreadInterceptorHooks } from '@platformatic/telemetry'
 import { createRequire } from 'node:module'
 import { join } from 'node:path'
@@ -27,9 +28,11 @@ export async function setDispatcher (runtimeConfig) {
 
   const dispatcherOpts = await getDispatcherOpts(runtimeConfig.undici)
 
-  setGlobalDispatcher(
-    new Agent(dispatcherOpts).compose([threadInterceptor, ...userInterceptors, cacheInterceptor].filter(Boolean))
+  const dispatcher = new Agent(dispatcherOpts).compose(
+    [threadInterceptor, ...userInterceptors, cacheInterceptor].filter(Boolean)
   )
+  setGlobalDispatcher(dispatcher)
+  mirrorGlobalDispatcherForBuiltinFetch(dispatcher)
 
   return { threadDispatcher }
 }

package/lib/worker/main.js

@@ -3,15 +3,18 @@ import {
   buildPinoTimestamp,
   disablePinoDirectWrite,
   ensureLoggableError,
-  getPrivateSymbol
+  getPrivateSymbol,
+  parseMemorySize
 } from '@platformatic/foundation'
 import { addPinoInstrumentation } from '@platformatic/telemetry'
+import { Buffer } from 'node:buffer'
 import { subscribe } from 'node:diagnostics_channel'
 import { EventEmitter } from 'node:events'
 import { ServerResponse } from 'node:http'
 import inspector from 'node:inspector'
 import { hostname } from 'node:os'
 import { join, resolve } from 'node:path'
+import { setDefaultHighWaterMark } from 'node:stream'
 import { pathToFileURL } from 'node:url'
 import { threadId, workerData } from 'node:worker_threads'
 import pino from 'pino'
@@ -113,6 +116,36 @@ async function performPreloading (...sources) {
   }
 }
 
+function resolveHealthSize (runtimeConfig, applicationConfig, field, logger) {
+  const raw = applicationConfig.health?.[field] ?? runtimeConfig.health?.[field]
+  if (raw === undefined) {
+    return undefined
+  }
+
+  const size = typeof raw === 'string' ? parseMemorySize(raw) : raw
+
+  if (!Number.isInteger(size) || size < 0) {
+    logger.warn({ [field]: raw }, `Invalid health.${field}, ignoring`)
+    return undefined
+  }
+
+  return size
+}
+
+function setupBufferPool (runtimeConfig, applicationConfig, logger) {
+  const size = resolveHealthSize(runtimeConfig, applicationConfig, 'bufferPoolSize', logger)
+  if (size !== undefined) {
+    Buffer.poolSize = size
+  }
+}
+
+function setupDefaultHighWaterMark (runtimeConfig, applicationConfig, logger) {
+  const size = resolveHealthSize(runtimeConfig, applicationConfig, 'defaultHighWaterMark', logger)
+  if (size !== undefined) {
+    setDefaultHighWaterMark(false, size)
+  }
+}
+
 // Enable compile cache if configured (Node.js 22.1.0+)
 async function setupCompileCache (runtimeConfig, applicationConfig, logger) {
   // Normalize boolean shorthand: true -> { enabled: true }
@@ -177,6 +210,9 @@ async function main () {
   const runtimeConfig = workerData.config
   const applicationConfig = workerData.applicationConfig
 
+  setupBufferPool(runtimeConfig, applicationConfig, globalThis.platformatic.logger)
+  setupDefaultHighWaterMark(runtimeConfig, applicationConfig, globalThis.platformatic.logger)
+
   // Enable compile cache early before loading user modules
   await setupCompileCache(runtimeConfig, applicationConfig, globalThis.platformatic.logger)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platformatic/runtime",
-  "version": "3.54.0",
+  "version": "3.55.0",
   "description": "",
   "main": "index.js",
   "type": "module",
@@ -36,14 +36,14 @@
     "typescript": "^5.5.4",
     "undici-oidc-interceptor": "^0.5.0",
     "why-is-node-running": "^2.2.2",
-    "@platformatic/db": "3.54.0",
-    "@platformatic/gateway": "3.54.0",
-    "@platformatic/node": "3.54.0",
-    "@platformatic/service": "3.54.0",
-    "@platformatic/composer": "3.54.0",
-    "@platformatic/sql-mapper": "3.54.0",
-    "@platformatic/sql-graphql": "3.54.0",
-    "@platformatic/wattpm-pprof-capture": "3.54.0"
+    "@platformatic/db": "3.55.0",
+    "@platformatic/composer": "3.55.0",
+    "@platformatic/node": "3.55.0",
+    "@platformatic/service": "3.55.0",
+    "@platformatic/sql-graphql": "3.55.0",
+    "@platformatic/gateway": "3.55.0",
+    "@platformatic/sql-mapper": "3.55.0",
+    "@platformatic/wattpm-pprof-capture": "3.55.0"
   },
   "dependencies": {
     "@fastify/accepts": "^5.0.0",
@@ -73,12 +73,12 @@
     "undici": "^7.0.0",
     "undici-thread-interceptor": "^1.3.1",
     "ws": "^8.16.0",
-    "@platformatic/basic": "3.54.0",
-    "@platformatic/foundation": "3.54.0",
-    "@platformatic/itc": "3.54.0",
-    "@platformatic/metrics": "3.54.0",
-    "@platformatic/generators": "3.54.0",
-    "@platformatic/telemetry": "3.54.0"
+    "@platformatic/itc": "3.55.0",
+    "@platformatic/foundation": "3.55.0",
+    "@platformatic/metrics": "3.55.0",
+    "@platformatic/basic": "3.55.0",
+    "@platformatic/generators": "3.55.0",
+    "@platformatic/telemetry": "3.55.0"
   },
   "engines": {
     "node": ">=22.19.0"

package/schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://schemas.platformatic.dev/@platformatic/runtime/3.54.0.json",
+  "$id": "https://schemas.platformatic.dev/@platformatic/runtime/3.55.0.json",
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "Platformatic Runtime Config",
   "type": "object",
@@ -208,6 +208,28 @@
                         "type": "string"
                       }
                     ]
+                  },
+                  "bufferPoolSize": {
+                    "anyOf": [
+                      {
+                        "type": "number",
+                        "minimum": 0
+                      },
+                      {
+                        "type": "string"
+                      }
+                    ]
+                  },
+                  "defaultHighWaterMark": {
+                    "anyOf": [
+                      {
+                        "type": "number",
+                        "minimum": 0
+                      },
+                      {
+                        "type": "string"
+                      }
+                    ]
                   }
                 },
                 "additionalProperties": false
@@ -567,6 +589,28 @@
                     "type": "string"
                   }
                 ]
+              },
+              "bufferPoolSize": {
+                "anyOf": [
+                  {
+                    "type": "number",
+                    "minimum": 0
+                  },
+                  {
+                    "type": "string"
+                  }
+                ]
+              },
+              "defaultHighWaterMark": {
+                "anyOf": [
+                  {
+                    "type": "number",
+                    "minimum": 0
+                  },
+                  {
+                    "type": "string"
+                  }
+                ]
               }
             },
             "additionalProperties": false
@@ -924,6 +968,28 @@
                     "type": "string"
                   }
                 ]
+              },
+              "bufferPoolSize": {
+                "anyOf": [
+                  {
+                    "type": "number",
+                    "minimum": 0
+                  },
+                  {
+                    "type": "string"
+                  }
+                ]
+              },
+              "defaultHighWaterMark": {
+                "anyOf": [
+                  {
+                    "type": "number",
+                    "minimum": 0
+                  },
+                  {
+                    "type": "string"
+                  }
+                ]
               }
             },
             "additionalProperties": false
@@ -1281,6 +1347,28 @@
                     "type": "string"
                   }
                 ]
+              },
+              "bufferPoolSize": {
+                "anyOf": [
+                  {
+                    "type": "number",
+                    "minimum": 0
+                  },
+                  {
+                    "type": "string"
+                  }
+                ]
+              },
+              "defaultHighWaterMark": {
+                "anyOf": [
+                  {
+                    "type": "number",
+                    "minimum": 0
+                  },
+                  {
+                    "type": "string"
+                  }
+                ]
               }
             },
             "additionalProperties": false
@@ -1994,6 +2082,30 @@
             }
           ],
           "default": 268435456
+        },
+        "bufferPoolSize": {
+          "anyOf": [
+            {
+              "type": "number",
+              "minimum": 0
+            },
+            {
+              "type": "string"
+            }
+          ],
+          "default": 262144
+        },
+        "defaultHighWaterMark": {
+          "anyOf": [
+            {
+              "type": "number",
+              "minimum": 0
+            },
+            {
+              "type": "string"
+            }
+          ],
+          "default": 262144
         }
       },
       "additionalProperties": false
@@ -2276,6 +2388,18 @@
               "default": "applicationId",
               "description": "The label name to use for the application identifier in metrics (e.g., applicationId, serviceId)"
             },
+            "httpClientMetrics": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "string"
+                }
+              ],
+              "default": false,
+              "description": "Enable outgoing HTTP client request duration metrics"
+            },
             "readiness": {
               "anyOf": [
                 {