@platformatic/control 3.0.0-alpha.6 → 3.0.0-rc.1

package/lib/errors.js

@@ -77,3 +77,23 @@ export const FailedToGetRuntimeMetrics = createError(
   `${ERROR_PREFIX}_FAILED_TO_GET_RUNTIME_METRICS`,
   'Failed to get runtime metrics %s.'
 )
+
+export const ProfilingAlreadyStarted = createError(
+  `${ERROR_PREFIX}_PROFILING_ALREADY_STARTED`,
+  'Profiling is already started for service "%s".'
+)
+
+export const ProfilingNotStarted = createError(
+  `${ERROR_PREFIX}_PROFILING_NOT_STARTED`,
+  'Profiling not started for service "%s".'
+)
+
+export const FailedToStartProfiling = createError(
+  `${ERROR_PREFIX}_FAILED_TO_START_PROFILING`,
+  'Failed to start profiling for service "%s": %s'
+)
+
+export const FailedToStopProfiling = createError(
+  `${ERROR_PREFIX}_FAILED_TO_STOP_PROFILING`,
+  'Failed to stop profiling for service "%s": %s'
+)

package/lib/index.js

@@ -20,8 +20,12 @@ import {
   FailedToGetRuntimeMetrics,
   FailedToGetRuntimeOpenapi,
   FailedToReloadRuntime,
+  FailedToStartProfiling,
+  FailedToStopProfiling,
   FailedToStopRuntime,
   FailedToStreamRuntimeLogs,
+  ProfilingAlreadyStarted,
+  ProfilingNotStarted,
   RuntimeNotFound
 } from './errors.js'
 
@@ -276,6 +280,79 @@ export class RuntimeApiClient {
     return applicationConfig
   }
 
+  async startApplicationProfiling (pid, applicationId, options = {}) {
+    const client = this.#getUndiciClient(pid)
+
+    const { statusCode, body } = await client.request({
+      path: `/api/v1/applications/${applicationId}/pprof/start`,
+      method: 'POST',
+      headers: {
+        'content-type': 'application/json'
+      },
+      body: JSON.stringify(options)
+    })
+
+    if (statusCode !== 200) {
+      const error = await body.text()
+      let jsonError
+      try {
+        jsonError = JSON.parse(error)
+      } catch {
+        // No-op
+      }
+
+      const message = jsonError?.message || error
+      const code = jsonError?.code
+
+      if (code === 'PLT_RUNTIME_APPLICATION_NOT_FOUND' || code === 'PLT_RUNTIME_APPLICATION_WORKER_NOT_FOUND') {
+        throw new ApplicationNotFound(message)
+      }
+
+      if (code === 'PLT_PPROF_PROFILING_ALREADY_STARTED') {
+        throw new ProfilingAlreadyStarted(applicationId)
+      }
+
+      throw new FailedToStartProfiling(applicationId, message)
+    }
+
+    return await body.json()
+  }
+
+  async stopApplicationProfiling (pid, applicationId) {
+    const client = this.#getUndiciClient(pid)
+
+    const { statusCode, body } = await client.request({
+      path: `/api/v1/applications/${applicationId}/pprof/stop`,
+      method: 'POST'
+    })
+
+    if (statusCode !== 200) {
+      const error = await body.text()
+      let jsonError
+      try {
+        jsonError = JSON.parse(error)
+      } catch {
+        // No-op
+      }
+
+      const message = jsonError?.message || error
+      const code = jsonError?.code
+
+      if (code === 'PLT_RUNTIME_APPLICATION_NOT_FOUND' || code === 'PLT_RUNTIME_APPLICATION_WORKER_NOT_FOUND') {
+        throw new ApplicationNotFound(message)
+      }
+
+      if (code === 'PLT_PPROF_PROFILING_NOT_STARTED') {
+        throw new ProfilingNotStarted(applicationId)
+      }
+
+      throw new FailedToStopProfiling(applicationId, message)
+    }
+
+    // Return the binary profile data as ArrayBuffer
+    return await body.arrayBuffer()
+  }
+
   async reloadRuntime (pid, options = {}) {
     const runtime = await this.getMatchingRuntime({ pid })
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platformatic/control",
-  "version": "3.0.0-alpha.6",
+  "version": "3.0.0-rc.1",
   "description": "Platformatic Control",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -21,10 +21,10 @@
     "execa": "^9.0.0",
     "neostandard": "^0.12.0",
     "split2": "^4.2.0",
-    "tsd": "^0.32.0",
+    "tsd": "^0.33.0",
     "typescript": "^5.5.4",
-    "@platformatic/runtime": "3.0.0-alpha.6",
-    "@platformatic/service": "3.0.0-alpha.6"
+    "@platformatic/service": "3.0.0-rc.1",
+    "@platformatic/runtime": "3.0.0-rc.1"
   },
   "dependencies": {
     "@fastify/error": "^4.0.0",
@@ -34,7 +34,7 @@
     "table": "^6.8.1",
     "undici": "^7.0.0",
     "ws": "^8.16.0",
-    "@platformatic/foundation": "3.0.0-alpha.6"
+    "@platformatic/foundation": "3.0.0-rc.1"
   },
   "engines": {
     "node": ">=22.18.0"