wattpm 3.26.0 → 3.28.0-alpha.1

package/index.js

@@ -13,6 +13,7 @@ import { logsCommand } from './lib/commands/logs.js'
 import { applicationsCommand, configCommand, envCommand, psCommand } from './lib/commands/management.js'
 import { metricsCommand } from './lib/commands/metrics.js'
 import { pprofCommand } from './lib/commands/pprof.js'
+import { replCommand } from './lib/commands/repl.js'
 import { version } from './lib/schema.js'
 
 export * from './lib/schema.js'
@@ -106,6 +107,9 @@ export async function main () {
     case 'pprof':
       command = pprofCommand
       break
+    case 'repl':
+      command = replCommand
+      break
     case 'applications:add':
       command = applicationsAddCommand
       break

package/lib/commands/help.js

@@ -19,7 +19,8 @@ async function loadCommands () {
     'logs',
     'inject',
     'metrics',
-    'pprof'
+    'pprof',
+    'repl'
   ]) {
     const category = await import(`./${file}.js`)
     Object.assign(commands, category.help)

package/lib/commands/repl.js

@@ -0,0 +1,107 @@
+import { getMatchingRuntime, RuntimeApiClient } from '@platformatic/control'
+import { ensureLoggableError, logFatalError, parseArgs } from '@platformatic/foundation'
+import { createInterface } from 'node:readline'
+
+export async function replCommand (logger, args) {
+  const { positionals: allPositionals } = parseArgs(args, {}, false)
+
+  const client = new RuntimeApiClient()
+  try {
+    const [runtime, positionals] = await getMatchingRuntime(client, allPositionals)
+    let application = positionals[0]
+
+    if (!application) {
+      const applicationsInfo = await client.getRuntimeApplications(runtime.pid)
+      application = applicationsInfo.entrypoint
+    }
+
+    const ws = client.getRuntimeApplicationRepl(runtime.pid, application)
+
+    await new Promise((resolve, reject) => {
+      ws.on('open', resolve)
+      ws.on('error', reject)
+    })
+
+    // Set up readline for stdin
+    const rl = createInterface({
+      input: process.stdin,
+      output: process.stdout,
+      terminal: process.stdin.isTTY
+    })
+
+    // Forward stdin to WebSocket
+    rl.on('line', (line) => {
+      ws.send(line + '\n')
+    })
+
+    // Forward WebSocket output to stdout
+    ws.on('message', (data) => {
+      process.stdout.write(data.toString())
+    })
+
+    // Handle cleanup
+    function onClose () {
+      rl.close()
+      ws.close()
+      client.close()
+      process.exit(0)
+    }
+
+    process.on('SIGINT', onClose)
+    process.on('SIGTERM', onClose)
+
+    ws.on('close', () => {
+      rl.close()
+      client.close()
+      process.exit(0)
+    })
+
+    ws.on('error', (error) => {
+      logger.error({ error: ensureLoggableError(error) }, 'WebSocket error')
+      rl.close()
+      client.close()
+      process.exit(1)
+    })
+  } catch (error) {
+    if (error.code === 'PLT_CTR_RUNTIME_NOT_FOUND') {
+      return logFatalError(logger, 'Cannot find a matching runtime.')
+    } else if (error.code === 'PLT_CTR_APPLICATION_NOT_FOUND') {
+      return logFatalError(logger, 'Cannot find a matching application.')
+    } else {
+      return logFatalError(
+        logger,
+        { error: ensureLoggableError(error) },
+        `Cannot start REPL: ${error.message}`
+      )
+    }
+  }
+}
+
+export const help = {
+  repl: {
+    usage: 'repl [id] [application]',
+    description: 'Starts a REPL session inside a running application',
+    args: [
+      {
+        name: 'id',
+        description:
+          'The process ID or the name of the application (it can be omitted only if there is a single application running)'
+      },
+      {
+        name: 'application',
+        description: 'The application name (the default is the entrypoint)'
+      }
+    ],
+    footer: `
+The REPL session runs inside the worker thread of the specified application.
+You have access to:
+  - app: The Fastify application instance (for service-based apps)
+  - capability: The application capability object with configuration and methods
+  - platformatic: The global platformatic object
+  - config: The application configuration
+  - logger: The application logger
+
+Press Ctrl+C or type .exit to exit the REPL.
+    `
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wattpm",
-  "version": "3.26.0",
+  "version": "3.28.0-alpha.1",
   "description": "The Node.js Application Server",
   "main": "index.js",
   "type": "module",
@@ -29,9 +29,9 @@
     "pino-pretty": "^13.0.0",
     "split2": "^4.2.0",
     "table": "^6.8.2",
-    "@platformatic/control": "3.26.0",
-    "@platformatic/runtime": "3.26.0",
-    "@platformatic/foundation": "3.26.0"
+    "@platformatic/control": "3.28.0-alpha.1",
+    "@platformatic/foundation": "3.28.0-alpha.1",
+    "@platformatic/runtime": "3.28.0-alpha.1"
   },
   "devDependencies": {
     "cleaner-spec-reporter": "^0.5.0",
@@ -42,7 +42,7 @@
     "neostandard": "^0.12.0",
     "typescript": "^5.5.4",
     "undici": "^7.0.0",
-    "@platformatic/node": "3.26.0"
+    "@platformatic/node": "3.28.0-alpha.1"
   },
   "engines": {
     "node": ">=22.19.0"

package/schema.json

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