@platformatic/runtime 2.74.3 → 2.75.0-alpha.0

package/README.md

@@ -1,6 +1,6 @@
 # @platformatic/runtime
 
-Check out the full documentation for Platformatic Runtime on [our website](https://docs.platformatic.dev/docs/runtime/overview).
+Check out the full documentation for Platformatic Runtime on [our website](https://docs.platformatic.dev/docs/reference/runtime/overview).
 
 ## Install
 

package/config.d.ts

@@ -5,7 +5,7 @@
  * and run json-schema-to-typescript to regenerate this file.
  */
 
-export type HttpsSchemasPlatformaticDevPlatformaticRuntime2743Json = {
+export type HttpsSchemasPlatformaticDevPlatformaticRuntime2750Alpha0Json = {
   [k: string]: unknown;
 } & {
   $schema?: string;

package/lib/config.js

@@ -16,6 +16,33 @@ const { schema } = require('./schema')
 const upgrade = require('./upgrade')
 const { parseArgs } = require('node:util')
 
+function autoDetectPprofCapture (config) {
+  // Check if package is installed
+  try {
+    let pprofCapturePath
+    try {
+      pprofCapturePath = require.resolve('@platformatic/watt-pprof-capture')
+    } catch (err) {
+      pprofCapturePath = require.resolve('../../watt-pprof-capture/index.js')
+    }
+
+    // Add to preload if not already present
+    if (!config.preload) {
+      config.preload = []
+    } else if (typeof config.preload === 'string') {
+      config.preload = [config.preload]
+    }
+
+    if (!config.preload.includes(pprofCapturePath)) {
+      config.preload.push(pprofCapturePath)
+    }
+  } catch (err) {
+    // Package not installed, skip silently
+  }
+
+  return config
+}
+
 async function _transformConfig (configManager, args) {
   const config = configManager.current
 
@@ -90,6 +117,41 @@ async function _transformConfig (configManager, args) {
 
   let hasValidEntrypoint = false
 
+  // Validate and coerce workers values early to avoid runtime hangs when invalid
+  function coercePositiveInteger (value) {
+    if (typeof value === 'number') {
+      if (!Number.isInteger(value) || value < 1) return null
+      return value
+    }
+    if (typeof value === 'string') {
+      // Trim to handle accidental spaces
+      const trimmed = value.trim()
+      if (trimmed.length === 0) return null
+      const num = Number(trimmed)
+      if (!Number.isFinite(num) || !Number.isInteger(num) || num < 1) return null
+      return num
+    }
+    return null
+  }
+
+  function raiseInvalidWorkersError (location, received, hint) {
+    const extra = hint ? ` (${hint})` : ''
+    throw new errors.InvalidArgumentError(
+      `${location} workers must be a positive integer; received "${received}"${extra}`
+    )
+  }
+
+  // Root-level workers
+  if (typeof config.workers !== 'undefined') {
+    const coerced = coercePositiveInteger(config.workers)
+    if (coerced === null) {
+      const raw = configManager.currentRaw?.workers
+      const hint = typeof raw === 'string' && /\{.*\}/.test(raw) ? 'check your environment variable' : ''
+      raiseInvalidWorkersError('Runtime', config.workers, hint)
+    }
+    config.workers = coerced
+  }
+
   for (let i = 0; i < services.length; ++i) {
     const service = services[i]
 
@@ -156,6 +218,17 @@ async function _transformConfig (configManager, args) {
       }
     }
 
+    // Validate and coerce per-service workers
+    if (typeof service.workers !== 'undefined') {
+      const coerced = coercePositiveInteger(service.workers)
+      if (coerced === null) {
+        const raw = configManager.currentRaw?.services?.[i]?.workers
+        const hint = typeof raw === 'string' && /\{.*\}/.test(raw) ? 'check your environment variable' : ''
+        raiseInvalidWorkersError(`Service "${service.id}"`, service.workers, hint)
+      }
+      service.workers = coerced
+    }
+
     service.entrypoint = service.id === config.entrypoint
     service.dependencies = []
     service.localServiceEnvVars = new Map()
@@ -226,6 +299,9 @@ async function _transformConfig (configManager, args) {
       configManager.current.restartOnError = 0
     }
   }
+
+  // Auto-detect and add pprof capture if available
+  autoDetectPprofCapture(configManager.current)
 }
 
 async function platformaticRuntime () {
@@ -358,5 +434,6 @@ function parseInspectorOptions (configManager) {
 module.exports = {
   parseInspectorOptions,
   platformaticRuntime,
-  wrapConfigInRuntimeConfig
+  wrapConfigInRuntimeConfig,
+  autoDetectPprofCapture
 }

package/lib/generator/README.md

@@ -1,11 +1,11 @@
 # Platformatic Runtime API
 
-This is a generated [Platformatic Runtime](https://docs.platformatic.dev/docs/runtime/overview) application.
+This is a generated [Platformatic Runtime](https://docs.platformatic.dev/docs/reference/runtime/overview) application.
 
 ## Requirements
 
-Platformatic supports macOS, Linux and Windows ([WSL](https://docs.microsoft.com/windows/wsl/) recommended).
-You'll need to have [Node.js](https://nodejs.org/) >= v18.8.0 or >= v20.6.0
+Platformatic supports macOS, Linux and Windows ([WSL](https://learn.microsoft.com/en-us/windows/wsl/) recommended).
+You'll need to have [Node.js](https://nodejs.org/) (v20.16.0+ or v22.3.0+)
 
 ## Setup
 

package/lib/generator/runtime-generator.js

@@ -27,7 +27,7 @@ const wrappableProperties = {
 }
 
 const engines = {
-  node: '^18.8.0 || >=20.6.0'
+  node: '^22.14.0 || ^20.6.0'
 }
 
 function getRuntimeBaseEnvVars (config) {

package/lib/management-api.js

@@ -90,6 +90,23 @@ async function managementApiPlugin (app, opts) {
     await runtime.stopService(id)
   })
 
+  app.post('/services/:id/pprof/start', async (request, reply) => {
+    const { id } = request.params
+    app.log.debug('start profiling', { id })
+
+    const options = request.body || {}
+    await runtime.startServiceProfiling(id, options)
+    reply.code(200).send({})
+  })
+
+  app.post('/services/:id/pprof/stop', async (request, reply) => {
+    const { id } = request.params
+    app.log.debug('stop profiling', { id })
+
+    const profileData = await runtime.stopServiceProfiling(id)
+    reply.type('application/octet-stream').code(200).send(profileData)
+  })
+
   app.all('/services/:id/proxy/*', async (request, reply) => {
     const { id, '*': requestUrl } = request.params
     app.log.debug('proxy request', { id, requestUrl })

package/lib/runtime.js

@@ -795,6 +795,18 @@ class Runtime extends EventEmitter {
     return sendViaITC(service, 'getServiceEnv')
   }
 
+  async startServiceProfiling (id, options = {}, ensureStarted = true) {
+    const service = await this.#getServiceById(id, ensureStarted)
+
+    return sendViaITC(service, 'startProfiling', options)
+  }
+
+  async stopServiceProfiling (id, ensureStarted = true) {
+    const service = await this.#getServiceById(id, ensureStarted)
+
+    return sendViaITC(service, 'stopProfiling')
+  }
+
   async getServiceOpenapiSchema (id) {
     const service = await this.#getServiceById(id, true)
 

package/lib/worker/app.js

@@ -1,5 +1,6 @@
 'use strict'
 
+const { getActiveResourcesInfo } = require('node:process')
 const { existsSync } = require('node:fs')
 const { EventEmitter } = require('node:events')
 const { resolve } = require('node:path')
@@ -219,6 +220,7 @@ class PlatformaticApp extends EventEmitter {
         globalThis.platformatic.onHttpStatsSize(url, size || 0)
       }
     }
+    globalThis.platformatic.onActiveResourcesEventLoop(getActiveResourcesInfo().length)
     return this.stackable.getMetrics({ format })
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platformatic/runtime",
-  "version": "2.74.3",
+  "version": "2.75.0-alpha.0",
   "description": "",
   "main": "index.js",
   "bin": {
@@ -33,16 +33,16 @@
     "neostandard": "^0.12.0",
     "pino-abstract-transport": "^2.0.0",
     "split2": "^4.2.0",
-    "tsd": "^0.32.0",
+    "tsd": "^0.33.0",
     "typescript": "^5.5.4",
     "undici-oidc-interceptor": "^0.5.0",
     "why-is-node-running": "^2.2.2",
-    "@platformatic/composer": "2.74.3",
-    "@platformatic/db": "2.74.3",
-    "@platformatic/node": "2.74.3",
-    "@platformatic/service": "2.74.3",
-    "@platformatic/sql-graphql": "2.74.3",
-    "@platformatic/sql-mapper": "2.74.3"
+    "@platformatic/composer": "2.75.0-alpha.0",
+    "@platformatic/db": "2.75.0-alpha.0",
+    "@platformatic/node": "2.75.0-alpha.0",
+    "@platformatic/service": "2.75.0-alpha.0",
+    "@platformatic/sql-graphql": "2.75.0-alpha.0",
+    "@platformatic/sql-mapper": "2.75.0-alpha.0"
   },
   "dependencies": {
     "@fastify/accepts": "^5.0.0",
@@ -76,14 +76,14 @@
     "undici": "^7.0.0",
     "undici-thread-interceptor": "^0.14.0",
     "ws": "^8.16.0",
-    "@platformatic/basic": "2.74.3",
-    "@platformatic/config": "2.74.3",
-    "@platformatic/generators": "2.74.3",
-    "@platformatic/metrics": "2.74.3",
-    "@platformatic/itc": "2.74.3",
-    "@platformatic/telemetry": "2.74.3",
-    "@platformatic/ts-compiler": "2.74.3",
-    "@platformatic/utils": "2.74.3"
+    "@platformatic/basic": "2.75.0-alpha.0",
+    "@platformatic/config": "2.75.0-alpha.0",
+    "@platformatic/generators": "2.75.0-alpha.0",
+    "@platformatic/metrics": "2.75.0-alpha.0",
+    "@platformatic/itc": "2.75.0-alpha.0",
+    "@platformatic/telemetry": "2.75.0-alpha.0",
+    "@platformatic/ts-compiler": "2.75.0-alpha.0",
+    "@platformatic/utils": "2.75.0-alpha.0"
   },
   "scripts": {
     "test": "pnpm run lint && borp --concurrency=1 --timeout=1200000 && tsd",

package/schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://schemas.platformatic.dev/@platformatic/runtime/2.74.3.json",
+  "$id": "https://schemas.platformatic.dev/@platformatic/runtime/2.75.0-alpha.0.json",
   "$schema": "http://json-schema.org/draft-07/schema#",
   "type": "object",
   "properties": {