@platformatic/runtime 3.69.0 → 3.71.0

package/config.d.ts

@@ -160,13 +160,10 @@ export type PlatformaticRuntimeConfig = {
       };
   workersRestartDelay?: number | string;
   logger?: {
-    level?: (
-      | ("fatal" | "error" | "warn" | "info" | "debug" | "trace" | "silent")
-      | {
-          [k: string]: unknown;
-        }
-    ) &
-      string;
+    /**
+     * The log level. It must be one of the standard pino levels (fatal, error, warn, info, debug, trace, silent) or, when customLevels is set, one of the custom levels.
+     */
+    level?: string;
     transport?:
       | {
           target?: string;
@@ -199,6 +196,10 @@ export type PlatformaticRuntimeConfig = {
     redact?: {
       paths: string[];
       censor?: string;
+      /**
+       * Remove the redacted keys entirely instead of replacing their values with the censor. Defaults to false.
+       */
+      remove?: boolean;
     };
     base?: {
       [k: string]: unknown;
@@ -207,6 +208,46 @@ export type PlatformaticRuntimeConfig = {
     customLevels?: {
       [k: string]: unknown;
     };
+    /**
+     * The numeric value of the level defined in level, when it is not one of the standard pino levels.
+     */
+    levelVal?: number;
+    /**
+     * Only use the levels defined in customLevels and omit the standard pino ones.
+     */
+    useOnlyCustomLevels?: boolean;
+    /**
+     * How log levels are compared to the logger level. Use DESC when lower values are more severe. Defaults to ASC.
+     */
+    levelComparison?: "ASC" | "DESC";
+    /**
+     * A string prefixed to every message, including the ones of child loggers.
+     */
+    msgPrefix?: string;
+    /**
+     * The key under which any logged object is placed.
+     */
+    nestedKey?: string;
+    /**
+     * The key used for the serialized error in the log object. Defaults to err.
+     */
+    errorKey?: string;
+    /**
+     * The stringification limit at a specific nesting depth when logging circular objects. Defaults to 5.
+     */
+    depthLimit?: number;
+    /**
+     * The stringification limit of properties or elements when logging a circular object or array. Defaults to 100.
+     */
+    edgeLimit?: number;
+    /**
+     * Terminate each log line with \r\n instead of \n. Defaults to false.
+     */
+    crlf?: boolean;
+    /**
+     * Set to false to disable logging entirely. Defaults to true.
+     */
+    enabled?: boolean;
     openTelemetryExporter?: {
       protocol: "grpc" | "http";
       url: string;

package/lib/runtime.js

@@ -8,7 +8,8 @@ import {
   kEnvFileFallbackKeys,
   kMetadata,
   kTimeout,
-  parseMemorySize
+  parseMemorySize,
+  scheduleCompileCacheFlush
 } from '@platformatic/foundation'
 import { getExecutable } from '@platformatic/globals'
 import { ITC } from '@platformatic/itc'
@@ -449,6 +450,11 @@ export class Runtime extends EventEmitter {
 
     this.#updateStatus('started')
 
+    // The CLI enables the module compile cache for this process. Node.js would only write it when
+    // the process terminates, so flush it now that the boot is complete to not lose it when the
+    // process is killed abruptly. This is a no-op when the compile cache is not enabled.
+    scheduleCompileCacheFlush()
+
     // Start the global health metrics timer for all workers if needed
     this.#startHealthMetricsCollectionIfNeeded()
 

package/lib/worker/controller.js

@@ -69,7 +69,11 @@ function handleUnhandled (app, event, listeners, timeout, err, ...args) {
     }
   }
 
-  app.stop().catch()
+  // stop() rejects while the controller is not started. Left unobserved, that rejection re-enters
+  // this handler forever and starves the event loop, so the exit scheduled above never runs.
+  app.stop().catch(stopError => {
+    logger.debug({ err: ensureLoggableError(stopError) }, `Stopping the ${label} after the ${event} event failed.`)
+  })
 }
 
 export class Controller extends EventEmitter {

package/lib/worker/main.js

@@ -4,7 +4,8 @@ import {
   disablePinoDirectWrite,
   ensureLoggableError,
   getPrivateSymbol,
-  parseMemorySize
+  parseMemorySize,
+  scheduleCompileCacheFlush
 } from '@platformatic/foundation'
 import { getITC, getLogger, updateGlobals } from '@platformatic/globals'
 import { addPinoInstrumentation } from '@platformatic/telemetry'
@@ -149,6 +150,9 @@ function setupDefaultHighWaterMark (runtimeConfig, applicationConfig, logger) {
   }
 }
 
+// Whether the module compile cache has been enabled in this worker.
+let compileCacheEnabled = false
+
 // Enable compile cache if configured (Node.js 22.1.0+)
 async function setupCompileCache (runtimeConfig, applicationConfig, logger) {
   // Normalize boolean shorthand: true -> { enabled: true }
@@ -187,8 +191,10 @@ async function setupCompileCache (runtimeConfig, applicationConfig, logger) {
     const { compileCacheStatus } = moduleApi.constants ?? {}
 
     if (result.status === compileCacheStatus?.ENABLED) {
+      compileCacheEnabled = true
       logger.debug({ directory: result.directory }, 'Module compile cache enabled')
     } else if (result.status === compileCacheStatus?.ALREADY_ENABLED) {
+      compileCacheEnabled = true
       logger.debug({ directory: result.directory }, 'Module compile cache already enabled')
     } else if (result.status === compileCacheStatus?.FAILED) {
       logger.warn({ message: result.message }, 'Failed to enable module compile cache')
@@ -319,6 +325,14 @@ async function main () {
 
   await controller.init(cleanup)
 
+  // Make the compile cache accumulated while booting durable, as Node.js would otherwise only write
+  // it when the worker terminates.
+  controller.on('started', () => {
+    if (compileCacheEnabled) {
+      scheduleCompileCacheFlush(logger)
+    }
+  })
+
   if (applicationConfig.entrypoint && runtimeConfig.basePath) {
     const meta = await controller.capability.getMeta()
     if (!meta.gateway.wantsAbsoluteUrls) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platformatic/runtime",
-  "version": "3.69.0",
+  "version": "3.71.0",
   "description": "Platformatic runtime",
   "main": "index.js",
   "type": "module",
@@ -39,14 +39,14 @@
     "typescript": "~6.0.3",
     "undici-oidc-interceptor": "^0.9.0",
     "why-is-node-running": "^2.2.2",
-    "@platformatic/composer": "3.69.0",
-    "@platformatic/db": "3.69.0",
-    "@platformatic/gateway": "3.69.0",
-    "@platformatic/node": "3.69.0",
-    "@platformatic/service": "3.69.0",
-    "@platformatic/sql-graphql": "3.69.0",
-    "@platformatic/sql-mapper": "3.69.0",
-    "@platformatic/wattpm-pprof-capture": "3.69.0"
+    "@platformatic/composer": "3.71.0",
+    "@platformatic/db": "3.71.0",
+    "@platformatic/gateway": "3.71.0",
+    "@platformatic/service": "3.71.0",
+    "@platformatic/node": "3.71.0",
+    "@platformatic/sql-graphql": "3.71.0",
+    "@platformatic/wattpm-pprof-capture": "3.71.0",
+    "@platformatic/sql-mapper": "3.71.0"
   },
   "dependencies": {
     "@fastify/accepts": "^5.0.0",
@@ -77,13 +77,13 @@
     "undici": "^7.27.2",
     "undici-thread-interceptor": "^1.3.1",
     "ws": "^8.16.0",
-    "@platformatic/basic": "3.69.0",
-    "@platformatic/foundation": "3.69.0",
-    "@platformatic/globals": "3.69.0",
-    "@platformatic/metrics": "3.69.0",
-    "@platformatic/generators": "3.69.0",
-    "@platformatic/telemetry": "3.69.0",
-    "@platformatic/itc": "3.69.0"
+    "@platformatic/foundation": "3.71.0",
+    "@platformatic/generators": "3.71.0",
+    "@platformatic/basic": "3.71.0",
+    "@platformatic/globals": "3.71.0",
+    "@platformatic/metrics": "3.71.0",
+    "@platformatic/itc": "3.71.0",
+    "@platformatic/telemetry": "3.71.0"
   },
   "engines": {
     "node": ">=22.19.0"

package/schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://schemas.platformatic.dev/@platformatic/runtime/3.69.0.json",
+  "$id": "https://schemas.platformatic.dev/@platformatic/runtime/3.71.0.json",
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "Platformatic Runtime Config",
   "type": "object",
@@ -1894,22 +1894,7 @@
       "properties": {
         "level": {
           "type": "string",
-          "oneOf": [
-            {
-              "enum": [
-                "fatal",
-                "error",
-                "warn",
-                "info",
-                "debug",
-                "trace",
-                "silent"
-              ]
-            },
-            {
-              "pattern": "^\\{.+\\}$"
-            }
-          ]
+          "description": "The log level. It must be one of the standard pino levels (fatal, error, warn, info, debug, trace, silent) or, when customLevels is set, one of the custom levels."
         },
         "transport": {
           "anyOf": [
@@ -2010,6 +1995,10 @@
             "censor": {
               "type": "string",
               "default": "[redacted]"
+            },
+            "remove": {
+              "type": "boolean",
+              "description": "Remove the redacted keys entirely instead of replacing their values with the censor. Defaults to false."
             }
           },
           "required": [
@@ -2035,6 +2024,50 @@
           "type": "object",
           "additionalProperties": true
         },
+        "levelVal": {
+          "type": "integer",
+          "description": "The numeric value of the level defined in level, when it is not one of the standard pino levels."
+        },
+        "useOnlyCustomLevels": {
+          "type": "boolean",
+          "description": "Only use the levels defined in customLevels and omit the standard pino ones."
+        },
+        "levelComparison": {
+          "type": "string",
+          "enum": [
+            "ASC",
+            "DESC"
+          ],
+          "description": "How log levels are compared to the logger level. Use DESC when lower values are more severe. Defaults to ASC."
+        },
+        "msgPrefix": {
+          "type": "string",
+          "description": "A string prefixed to every message, including the ones of child loggers."
+        },
+        "nestedKey": {
+          "type": "string",
+          "description": "The key under which any logged object is placed."
+        },
+        "errorKey": {
+          "type": "string",
+          "description": "The key used for the serialized error in the log object. Defaults to err."
+        },
+        "depthLimit": {
+          "type": "integer",
+          "description": "The stringification limit at a specific nesting depth when logging circular objects. Defaults to 5."
+        },
+        "edgeLimit": {
+          "type": "integer",
+          "description": "The stringification limit of properties or elements when logging a circular object or array. Defaults to 100."
+        },
+        "crlf": {
+          "type": "boolean",
+          "description": "Terminate each log line with \\r\\n instead of \\n. Defaults to false."
+        },
+        "enabled": {
+          "type": "boolean",
+          "description": "Set to false to disable logging entirely. Defaults to true."
+        },
         "openTelemetryExporter": {
           "type": "object",
           "properties": {
@@ -2079,6 +2112,35 @@
           "additionalProperties": false
         }
       },
+      "if": {
+        "not": {
+          "required": [
+            "customLevels"
+          ]
+        }
+      },
+      "then": {
+        "properties": {
+          "level": {
+            "oneOf": [
+              {
+                "enum": [
+                  "fatal",
+                  "error",
+                  "warn",
+                  "info",
+                  "debug",
+                  "trace",
+                  "silent"
+                ]
+              },
+              {
+                "pattern": "^\\{.+\\}$"
+              }
+            ]
+          }
+        }
+      },
       "default": {},
       "additionalProperties": true
     },