@platformatic/runtime 3.40.0 → 3.42.0

package/index.d.ts

@@ -27,7 +27,7 @@ export interface ApplicationsCommands {
   help: Record<string, string | (() => string)>
 }
 
-export module errors {
+export namespace errors {
   export const RuntimeExitedError: () => FastifyError
   export const UnknownRuntimeAPICommandError: (command: string) => FastifyError
   export const ApplicationNotFoundError: (id: string) => FastifyError
@@ -47,7 +47,7 @@ export module errors {
   export const NodeInspectorFlagsNotSupportedError: () => FastifyError
 }
 
-export module symbols {
+export namespace symbols {
   export declare const kConfig: unique symbol
   export declare const kId: unique symbol
   export declare const kFullId: unique symbol

package/lib/management-api.js

@@ -214,6 +214,15 @@ export async function managementApiPlugin (app, opts) {
     reply.type('application/octet-stream').code(200).send(profileData)
   })
 
+  app.post('/applications/:id/heap-snapshot', async (request, reply) => {
+    const { id } = request.params
+    app.log.debug('take heap snapshot', { id })
+
+    const stream = await runtime.takeApplicationHeapSnapshot(id)
+    reply.type('application/octet-stream').send(stream)
+    return reply
+  })
+
   app.get('/metrics', { logLevel: 'debug' }, async (req, reply) => {
     const config = await runtime.getRuntimeConfig()
 

package/lib/runtime.js

@@ -19,6 +19,7 @@ import { STATUS_CODES } from 'node:http'
 import { createRequire } from 'node:module'
 import { availableParallelism } from 'node:os'
 import { dirname, isAbsolute, join } from 'node:path'
+import { Readable } from 'node:stream'
 import { setImmediate as immediate, setTimeout as sleep } from 'node:timers/promises'
 import { pathToFileURL } from 'node:url'
 import { Worker } from 'node:worker_threads'
@@ -736,6 +737,30 @@ export class Runtime extends EventEmitter {
     return sendViaITC(service, 'stopProfiling', options)
   }
 
+  async takeApplicationHeapSnapshot (id, ensureStarted = true) {
+    const service = await this.#getApplicationById(id, ensureStarted)
+
+    const { port1, port2 } = new MessageChannel()
+
+    const readable = new Readable({ read () {} })
+
+    port2.on('message', (message) => {
+      if (message.type === 'chunk') {
+        readable.push(message.chunk)
+      } else if (message.type === 'error') {
+        readable.destroy(new Error(message.message))
+        port2.close()
+      } else if (message.type === 'end') {
+        readable.push(null)
+        port2.close()
+      }
+    })
+
+    await sendViaITC(service, 'takeHeapSnapshot', port1, [port1])
+
+    return readable
+  }
+
   async startApplicationRepl (id, ensureStarted = true) {
     const service = await this.#getApplicationById(id, ensureStarted)
 

package/lib/worker/itc.js

@@ -342,6 +342,28 @@ export function setupITC (controller, application, dispatcher, sharedContext) {
         messaging.addSource(channel)
       },
 
+      takeHeapSnapshot (port) {
+        const { Session } = createRequire(import.meta.url)('node:inspector')
+        const session = new Session()
+        session.connect()
+
+        session.on('HeapProfiler.addHeapSnapshotChunk', (m) => {
+          port.postMessage({ type: 'chunk', chunk: m.params.chunk })
+        })
+
+        session.post('HeapProfiler.takeHeapSnapshot', null, (err) => {
+          session.disconnect()
+          if (err) {
+            port.postMessage({ type: 'error', message: err.message })
+          } else {
+            port.postMessage({ type: 'end' })
+          }
+          port.close()
+        })
+
+        return { started: true }
+      },
+
       startRepl (port) {
         // Check if running in subprocess mode - forward through ChildManager
         const childManager = controller.capability?.getChildManager?.()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platformatic/runtime",
-  "version": "3.40.0",
+  "version": "3.42.0",
   "description": "",
   "main": "index.js",
   "type": "module",
@@ -35,14 +35,14 @@
     "typescript": "^5.5.4",
     "undici-oidc-interceptor": "^0.5.0",
     "why-is-node-running": "^2.2.2",
-    "@platformatic/composer": "3.40.0",
-    "@platformatic/service": "3.40.0",
-    "@platformatic/gateway": "3.40.0",
-    "@platformatic/db": "3.40.0",
-    "@platformatic/sql-mapper": "3.40.0",
-    "@platformatic/wattpm-pprof-capture": "3.40.0",
-    "@platformatic/sql-graphql": "3.40.0",
-    "@platformatic/node": "3.40.0"
+    "@platformatic/composer": "3.42.0",
+    "@platformatic/db": "3.42.0",
+    "@platformatic/gateway": "3.42.0",
+    "@platformatic/node": "3.42.0",
+    "@platformatic/service": "3.42.0",
+    "@platformatic/sql-graphql": "3.42.0",
+    "@platformatic/sql-mapper": "3.42.0",
+    "@platformatic/wattpm-pprof-capture": "3.42.0"
   },
   "dependencies": {
     "@fastify/accepts": "^5.0.0",
@@ -63,7 +63,7 @@
     "graphql": "^16.8.1",
     "help-me": "^5.0.0",
     "minimist": "^1.2.8",
-    "pino": "^9.9.0",
+    "pino": "^10.1.0",
     "pino-opentelemetry-transport": "^2.0.0",
     "pino-pretty": "^13.0.0",
     "semgrator": "^0.3.0",
@@ -72,12 +72,12 @@
     "undici": "^7.0.0",
     "undici-thread-interceptor": "^1.3.1",
     "ws": "^8.16.0",
-    "@platformatic/foundation": "3.40.0",
-    "@platformatic/generators": "3.40.0",
-    "@platformatic/basic": "3.40.0",
-    "@platformatic/itc": "3.40.0",
-    "@platformatic/metrics": "3.40.0",
-    "@platformatic/telemetry": "3.40.0"
+    "@platformatic/foundation": "3.42.0",
+    "@platformatic/itc": "3.42.0",
+    "@platformatic/basic": "3.42.0",
+    "@platformatic/generators": "3.42.0",
+    "@platformatic/telemetry": "3.42.0",
+    "@platformatic/metrics": "3.42.0"
   },
   "engines": {
     "node": ">=22.19.0"

package/schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://schemas.platformatic.dev/@platformatic/runtime/3.40.0.json",
+  "$id": "https://schemas.platformatic.dev/@platformatic/runtime/3.42.0.json",
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "Platformatic Runtime Config",
   "type": "object",