@platformatic/basic 3.32.0-alpha.0 → 3.32.0-alpha.1

package/config.d.ts

@@ -31,7 +31,7 @@ export interface PlatformaticBasicConfig {
         };
     workersRestartDelay?: number | string;
     logger?: {
-      level: (
+      level?: (
         | ("fatal" | "error" | "warn" | "info" | "debug" | "trace" | "silent")
         | {
             [k: string]: unknown;
@@ -134,7 +134,6 @@ export interface PlatformaticBasicConfig {
       maxHeapTotal?: number | string;
       maxYoungGeneration?: number | string;
       codeRangeSize?: number | string;
-      noHeapCheck?: boolean | string;
     };
     undici?: {
       agentOptions?: {
@@ -186,6 +185,18 @@ export interface PlatformaticBasicConfig {
           maxSize?: number;
           maxEntrySize?: number;
           maxCount?: number;
+          /**
+           * Whitelist of origins to cache. Supports exact strings and regex patterns (e.g., "/https:\\/\\/.*\\.example\\.com/").
+           */
+          origins?: string[];
+          /**
+           * Default cache duration in seconds for responses without explicit expiration headers.
+           */
+          cacheByDefault?: number;
+          /**
+           * Cache type. "shared" caches may be shared between users, "private" caches are user-specific.
+           */
+          type?: "shared" | "private";
           [k: string]: unknown;
         };
     watch?: boolean | string;
@@ -415,6 +426,18 @@ export interface PlatformaticBasicConfig {
         [k: string]: string | [string, ...string[]];
       };
     };
+    compileCache?:
+      | boolean
+      | {
+          /**
+           * Enable Node.js module compile cache for faster startup
+           */
+          enabled?: boolean;
+          /**
+           * Directory to store compile cache. Defaults to .plt/compile-cache in app root
+           */
+          directory?: string;
+        };
     application?: {
       reuseTcpPorts?: boolean;
       workers?:
@@ -438,7 +461,6 @@ export interface PlatformaticBasicConfig {
         maxHeapTotal?: number | string;
         maxYoungGeneration?: number | string;
         codeRangeSize?: number | string;
-        noHeapCheck?: boolean | string;
       };
       arguments?: string[];
       env?: {
@@ -474,6 +496,18 @@ export interface PlatformaticBasicConfig {
         )[];
         [k: string]: unknown;
       };
+      compileCache?:
+        | boolean
+        | {
+            /**
+             * Enable Node.js module compile cache for faster startup
+             */
+            enabled?: boolean;
+            /**
+             * Directory to store compile cache. Defaults to .plt/compile-cache in app root
+             */
+            directory?: string;
+          };
     };
   };
   [k: string]: unknown;

package/lib/capability.js

@@ -7,7 +7,7 @@ import {
   kMetadata,
   kTimeout
 } from '@platformatic/foundation'
-import { clearRegistry, client, collectMetrics, ensureMetricsGroup, setupOtlpExporter } from '@platformatic/metrics'
+import { clearRegistry, client, collectThreadMetrics, ensureMetricsGroup, setupOtlpExporter } from '@platformatic/metrics'
 import { parseCommandString } from 'execa'
 import { spawn } from 'node:child_process'
 import { tracingChannel } from 'node:diagnostics_channel'
@@ -578,7 +578,8 @@ export class BaseCapability extends EventEmitter {
               backlog: this.serverConfig.backlog
             }
           : {},
-      telemetryConfig: this.telemetryConfig
+      telemetryConfig: this.telemetryConfig,
+      compileCache: this.config.compileCache ?? this.runtimeConfig?.compileCache
     }
   }
 
@@ -739,7 +740,9 @@ export class BaseCapability extends EventEmitter {
       return
     }
 
-    await collectMetrics(this.applicationId, this.workerId, metricsConfig, this.metricsRegistry)
+    // Use thread-specific metrics collection - process-level metrics are collected
+    // by the main runtime thread and duplicated with worker labels
+    await collectThreadMetrics(this.applicationId, this.workerId, metricsConfig, this.metricsRegistry)
   }
 
   #setHttpCacheMetrics () {

package/lib/worker/child-process.js

@@ -5,14 +5,15 @@ import {
   ensureLoggableError
 } from '@platformatic/foundation'
 import { ITC } from '@platformatic/itc/lib/index.js'
-import { clearRegistry, client, collectMetrics } from '@platformatic/metrics'
+import { clearRegistry, client, collectThreadMetrics } from '@platformatic/metrics'
 import diagnosticChannel, { tracingChannel } from 'node:diagnostics_channel'
 import { EventEmitter, once } from 'node:events'
 import { readFile } from 'node:fs/promises'
 import { ServerResponse } from 'node:http'
 import { register } from 'node:module'
 import { hostname, platform, tmpdir } from 'node:os'
-import { basename, resolve } from 'node:path'
+import { basename, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
 import pino from 'pino'
 import { Agent, Pool, setGlobalDispatcher } from 'undici'
 import { WebSocket } from 'ws'
@@ -220,7 +221,9 @@ export class ChildProcess extends ITC {
   }
 
   async #collectMetrics ({ applicationId, workerId, metricsConfig }) {
-    await collectMetrics(applicationId, workerId, metricsConfig, this.#metricsRegistry)
+    // Use thread-specific metrics collection - process-level metrics are collected
+    // by the main runtime thread and duplicated with worker labels
+    await collectThreadMetrics(applicationId, workerId, metricsConfig, this.#metricsRegistry)
     this.#setHttpCacheMetrics()
   }
 
@@ -228,7 +231,9 @@ export class ChildProcess extends ITC {
     clearRegistry(this.#metricsRegistry)
 
     if (metricsConfig.enabled !== false) {
-      await collectMetrics(applicationId, workerId, metricsConfig, this.#metricsRegistry)
+      // Use thread-specific metrics collection - process-level metrics are collected
+      // by the main runtime thread and duplicated with worker labels
+      await collectThreadMetrics(applicationId, workerId, metricsConfig, this.#metricsRegistry)
       this.#setHttpCacheMetrics()
     }
   }
@@ -503,12 +508,60 @@ function stripBasePath (basePath) {
   }
 }
 
+// Enable compile cache if configured (Node.js 22.1.0+)
+async function setupCompileCache (contextData) {
+  const config = contextData?.compileCache
+
+  // Normalize boolean shorthand
+  const normalizeConfig = cfg => {
+    if (cfg === true) return { enabled: true }
+    if (cfg === false) return { enabled: false }
+    return cfg
+  }
+
+  const normalizedConfig = normalizeConfig(config)
+  if (!normalizedConfig?.enabled) {
+    return
+  }
+
+  // Check if API is available (Node.js 22.1.0+)
+  let moduleApi
+  try {
+    moduleApi = await import('node:module')
+    if (typeof moduleApi.enableCompileCache !== 'function') {
+      return
+    }
+  } catch {
+    return
+  }
+
+  // Use root from context data (capability's this.root as URL)
+  const root = contextData?.root ? fileURLToPath(contextData.root) : null
+  if (!root) {
+    return
+  }
+
+  const cacheDir =
+    typeof normalizedConfig === 'object' && normalizedConfig.directory
+      ? normalizedConfig.directory
+      : join(root, '.plt', 'compile-cache')
+
+  try {
+    moduleApi.enableCompileCache(cacheDir)
+  } catch {
+    // Silently ignore - cache is optional optimization
+  }
+}
+
 async function main () {
   const executable = basename(process.argv[1] ?? '')
 
   const dataPath = resolve(tmpdir(), 'platformatic', 'runtimes', `${process.env.PLT_MANAGER_ID}.json`)
   const { data, loader, scripts } = JSON.parse(await readFile(dataPath))
 
+  // Enable compile cache early before loading user modules
+  await setupCompileCache(data)
+
   globalThis.platformatic = Object.assign(globalThis.platformatic ?? {}, data)
   globalThis.platformatic.events = new ForwardingEventEmitter()
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platformatic/basic",
-  "version": "3.32.0-alpha.0",
+  "version": "3.32.0-alpha.1",
   "description": "",
   "main": "index.js",
   "types": "index.d.ts",
@@ -25,10 +25,10 @@
     "split2": "^4.2.0",
     "undici": "^7.0.0",
     "ws": "^8.18.0",
-    "@platformatic/foundation": "3.32.0-alpha.0",
-    "@platformatic/itc": "3.32.0-alpha.0",
-    "@platformatic/telemetry": "3.32.0-alpha.0",
-    "@platformatic/metrics": "3.32.0-alpha.0"
+    "@platformatic/foundation": "3.32.0-alpha.1",
+    "@platformatic/itc": "3.32.0-alpha.1",
+    "@platformatic/metrics": "3.32.0-alpha.1",
+    "@platformatic/telemetry": "3.32.0-alpha.1"
   },
   "devDependencies": {
     "cleaner-spec-reporter": "^0.5.0",

package/schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://schemas.platformatic.dev/@platformatic/basic/3.32.0-alpha.0.json",
+  "$id": "https://schemas.platformatic.dev/@platformatic/basic/3.32.0-alpha.1.json",
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "Platformatic Basic Config",
   "type": "object",
@@ -212,16 +212,6 @@
                         "type": "string"
                       }
                     ]
-                  },
-                  "noHeapCheck": {
-                    "anyOf": [
-                      {
-                        "type": "boolean"
-                      },
-                      {
-                        "type": "string"
-                      }
-                    ]
                   }
                 },
                 "additionalProperties": false
@@ -346,6 +336,28 @@
                     }
                   }
                 }
+              },
+              "compileCache": {
+                "anyOf": [
+                  {
+                    "type": "boolean"
+                  },
+                  {
+                    "type": "object",
+                    "properties": {
+                      "enabled": {
+                        "type": "boolean",
+                        "default": true,
+                        "description": "Enable Node.js module compile cache for faster startup"
+                      },
+                      "directory": {
+                        "type": "string",
+                        "description": "Directory to store compile cache. Defaults to .plt/compile-cache in app root"
+                      }
+                    },
+                    "additionalProperties": false
+                  }
+                ]
               }
             }
           }
@@ -425,7 +437,6 @@
           "properties": {
             "level": {
               "type": "string",
-              "default": "info",
               "oneOf": [
                 {
                   "enum": [
@@ -568,9 +579,6 @@
               "additionalProperties": true
             }
           },
-          "required": [
-            "level"
-          ],
           "default": {},
           "additionalProperties": true
         },
@@ -866,17 +874,6 @@
                 }
               ],
               "default": 268435456
-            },
-            "noHeapCheck": {
-              "anyOf": [
-                {
-                  "type": "boolean"
-                },
-                {
-                  "type": "string"
-                }
-              ],
-              "default": false
             }
           },
           "additionalProperties": false
@@ -1008,6 +1005,26 @@
                 },
                 "maxCount": {
                   "type": "integer"
+                },
+                "origins": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Whitelist of origins to cache. Supports exact strings and regex patterns (e.g., \"/https:\\\\/\\\\/.*\\\\.example\\\\.com/\")."
+                },
+                "cacheByDefault": {
+                  "type": "integer",
+                  "description": "Default cache duration in seconds for responses without explicit expiration headers."
+                },
+                "type": {
+                  "type": "string",
+                  "enum": [
+                    "shared",
+                    "private"
+                  ],
+                  "default": "shared",
+                  "description": "Cache type. \"shared\" caches may be shared between users, \"private\" caches are user-specific."
                 }
               }
             }
@@ -1623,6 +1640,28 @@
           ],
           "additionalProperties": false
         },
+        "compileCache": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "object",
+              "properties": {
+                "enabled": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Enable Node.js module compile cache for faster startup"
+                },
+                "directory": {
+                  "type": "string",
+                  "description": "Directory to store compile cache. Defaults to .plt/compile-cache in app root"
+                }
+              },
+              "additionalProperties": false
+            }
+          ]
+        },
         "application": {
           "type": "object",
           "properties": {
@@ -1770,16 +1809,6 @@
                       "type": "string"
                     }
                   ]
-                },
-                "noHeapCheck": {
-                  "anyOf": [
-                    {
-                      "type": "boolean"
-                    },
-                    {
-                      "type": "string"
-                    }
-                  ]
                 }
               },
               "additionalProperties": false
@@ -1897,6 +1926,28 @@
                   }
                 }
               }
+            },
+            "compileCache": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "enabled": {
+                      "type": "boolean",
+                      "default": true,
+                      "description": "Enable Node.js module compile cache for faster startup"
+                    },
+                    "directory": {
+                      "type": "string",
+                      "description": "Directory to store compile cache. Defaults to .plt/compile-cache in app root"
+                    }
+                  },
+                  "additionalProperties": false
+                }
+              ]
             }
           },
           "additionalProperties": false