@platformatic/watt-extra 0.1.1 → 0.1.3

package/.github/workflows/test.yml

@@ -0,0 +1,58 @@
+name: Test
+on:
+  pull_request:
+    paths-ignore:
+      - "**.md"
+  workflow_dispatch:
+
+concurrency:
+  group: "${{ github.workflow }} @ ${{ github.event.pull_request.head.label || github.head_ref || github.ref }}"
+  cancel-in-progress: true
+
+permissions:
+  packages: write
+  contents: read
+
+jobs:
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+
+    services:
+      valkey:
+        image: "valkey/valkey:9.0"
+        ports:
+          - "6379:6379"
+        options: >-
+          --health-cmd "valkey-cli ping"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
+    strategy:
+      matrix:
+        node-version: [22.x, 24.x]
+
+    steps:
+      - uses: actions/checkout@v5
+      - uses: pnpm/action-setup@v4.1.0
+        with:
+          version: 10
+
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          # https://github.com/actions/setup-node/blob/main/docs/advanced-usage.md#use-private-packages
+          registry-url: "https://registry.npmjs.org"
+
+      - name: Install
+        run: |
+          pnpm install
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Test
+        run: |
+          pnpm run test

package/README.md

@@ -1,10 +1,10 @@
-# WattPro
+# Watt-Extra
 
-WattPro is an enterprise-ready runtime manager for Platformatic applications that provides production-grade capabilities including monitoring, compliance checking, caching, authentication, and integration with Infrastructure Control Center (ICC) services.
+Watt-Extra is an enterprise-ready runtime manager for Platformatic applications that provides production-grade capabilities including monitoring, compliance checking, caching, authentication, and integration with Infrastructure Control Center (ICC) services.
 
 ## Overview
 
-WattPro wraps existing Platformatic applications (Service, Composer, Node, or Next.js) to enhance them with enterprise features without requiring any code changes. It acts as a transparent layer that:
+Watt-Extra wraps existing Platformatic applications (Service, Composer, Node, or Next.js) to enhance them with enterprise features without requiring any code changes. It acts as a transparent layer that:
 
 - **Monitors** application performance and health metrics
 - **Enforces** compliance policies and security rules
@@ -23,7 +23,7 @@ None.
 
 ### Optional
 
-- `PLT_ICC_URL` - Infrastructure Control Center URL for connecting to control plane services. When not set, WattPro runs in standalone mode without ICC integration
+- `PLT_ICC_URL` - Infrastructure Control Center URL for connecting to control plane services. When not set, Watt-Extra runs in standalone mode without ICC integration
 - `PLT_APP_NAME` - Unique identifier for your application instance. Optional when `PLT_ICC_URL` is set - if not provided, it will be automatically determined from Kubernetes labels following these rules:
   1. Uses `app.kubernetes.io/instance` label first
   2. Falls back to ReplicaSet naming convention (`{app-name}-{hash}`)
@@ -34,7 +34,7 @@ None.
 
 ### Standalone Mode
 
-WattPro can run without connecting to an Infrastructure Control Center (ICC). When `PLT_ICC_URL` is not set:
+Watt-Extra can run without connecting to an Infrastructure Control Center (ICC). When `PLT_ICC_URL` is not set:
 
 - No ICC connection attempts are made
 - All ICC-dependent plugins (alerts, compliance, metadata, scheduler) skip their operations
@@ -43,7 +43,7 @@ WattPro can run without connecting to an Infrastructure Control Center (ICC). Wh
 ## Installation
 
 ```bash
-npm install @platformatic/wattpro
+npm install @platformatic/watt-extra
 ```
 
 ## Usage
@@ -52,36 +52,36 @@ Add a script to your package.json:
 
 ```json
 "scripts": {
-  "wattpro": "wattpro start"
+  "watt-extra": "watt-extra start"
 }
 ```
 
 Then run:
 
 ```bash
-npm run wattpro
+npm run watt-extra
 ```
 
 ### Command Line Interface
 
-WattPro provides a command-line interface:
+Watt-Extra provides a command-line interface:
 
 ```bash
 # Show help
-wattpro --help
+watt-extra --help
 
 # Start the runtime manager
-wattpro start
+watt-extra start
 
 # Set log level
-wattpro start --log-level=debug
+watt-extra start --log-level=debug
 
 # Set ICC URL
-wattpro start --icc-url=http://icc-server:3000
+watt-extra start --icc-url=http://icc-server:3000
 
 # Set application name
-wattpro start --app-name=my-application
+watt-extra start --app-name=my-application
 
 # Set application directory. This is useful for development and test
-wattpro start --app-dir=/path/to/application
+watt-extra start --app-dir=/path/to/application
 ```

package/app.js

@@ -34,7 +34,7 @@ async function buildApp (logger) {
     app.log.info('Starting Runtime -app')
     try {
       app.log.info('Spawning the app')
-      await app.wattpro.spawn()
+      await app.watt.spawn()
     } catch (err) {
       app.log.error(err, 'Failed to spawn the app')
       throw new Error('Failed to spawn the app: ' + err.message)
@@ -48,7 +48,7 @@ async function buildApp (logger) {
       return
     }
 
-    if (!app.wattpro.runtime) {
+    if (!app.watt.runtime) {
       throw new Error('Runtime not started, cannot send to ICC')
     }
     try {
@@ -112,8 +112,8 @@ async function buildApp (logger) {
 
   app.close = async function close () {
     app.log.info('Closing runtime')
-    if (app.wattpro.runtime) {
-      await app.wattpro.close()
+    if (app.watt.runtime) {
+      await app.watt.close()
     }
     await app.closeUpdates()
   }

package/lib/{wattpro.js → watt.js}

@@ -26,7 +26,7 @@ async function restartRuntime (runtime) {
   }
 }
 
-class WattPro {
+class Watt {
   #env
   #logger
   #require
@@ -258,7 +258,7 @@ class WattPro {
       this.#instanceConfig.iccServices.trafficante.url
     )
     return {
-      module: this.#require.resolve(
+      module: require.resolve(
         'undici-traffic-interceptor'
       ),
       options: {
@@ -340,7 +340,7 @@ class WattPro {
     }
 
     return {
-      module: this.#require.resolve('@platformatic/slicer-interceptor'),
+      module: require.resolve('undici-slicer-interceptor'),
       options: cacheConfig,
     }
   }
@@ -406,7 +406,7 @@ class WattPro {
     config.httpCache = {
       ...config.httpCache,
       cacheTagsHeader,
-      store: this.#require.resolve('@platformatic/undici-cache-redis'),
+      store: require.resolve('undici-cache-redis'),
       clientOpts: httpCache,
     }
   }
@@ -577,4 +577,4 @@ class WattPro {
   }
 }
 
-export default WattPro
+export default Watt

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platformatic/watt-extra",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "The Platformatic runtime manager",
   "type": "module",
   "scripts": {

package/plugins/alerts.js

@@ -16,7 +16,7 @@ async function alerts (app, _opts) {
     }
 
     const scalerUrl = app.instanceConfig?.iccServices?.scaler?.url
-    const runtime = app.wattpro.runtime
+    const runtime = app.watt.runtime
 
     if (!scalerUrl) {
       app.log.warn(

package/plugins/auth.js

@@ -52,7 +52,7 @@ async function authPlugin (app) {
       app.log.info('JWT token expired, reloading')
       app.token = await loadToken()
 
-      app.wattpro?.updateSharedContext({
+      app.watt?.updateSharedContext({
         iccAuthHeaders: { authorization: `Bearer ${app.token}` }
       }).catch((err) => {
         app.log.error({ err }, 'Failed to update jwt token in shared context')

package/plugins/compliancy.js

@@ -14,7 +14,7 @@ async function compliancy (app, _opts) {
       return
     }
 
-    const runtime = app.wattpro.runtime
+    const runtime = app.watt.runtime
     const applicationId = app.instanceConfig?.applicationId
     const appDir = app.env.PLT_APP_DIR
 

package/plugins/flamegraphs.js

@@ -16,7 +16,7 @@ async function flamegraphs (app, _opts) {
 
     app.log.info('Start profiling services')
 
-    const runtime = app.wattpro.runtime
+    const runtime = app.watt.runtime
     const { applications } = await runtime.getApplications()
 
     const promises = []
@@ -52,7 +52,7 @@ async function flamegraphs (app, _opts) {
     }
 
     const podId = app.instanceId
-    const runtime = app.wattpro.runtime
+    const runtime = app.watt.runtime
 
     if (!serviceIds) {
       const { applications } = await runtime.getApplications()

package/plugins/init.js

@@ -1,4 +1,4 @@
-import WattPro from '../lib/wattpro.js'
+import Watt from '../lib/watt.js'
 import os from 'node:os'
 
 async function initPlugin (app) {
@@ -17,13 +17,13 @@ async function initPlugin (app) {
   }
 
   async function initApplication () {
-    app.log.info('Starting WattPro runtime manager')
+    app.log.info('Starting Watt-Extra runtime manager')
 
     let applicationName = app.env.PLT_APP_NAME
     const applicationDir = app.env.PLT_APP_DIR
     const instanceId = os.hostname()
 
-    app.log.info({ applicationName, applicationDir }, 'Loading wattpro application')
+    app.log.info({ applicationName, applicationDir }, 'Loading watt-extra application')
 
     // Skip ICC initialization if PLT_ICC_URL is not set
     if (!app.env.PLT_ICC_URL) {
@@ -59,12 +59,12 @@ async function initPlugin (app) {
       app.instanceId = os.hostname()
     }
   }
-  const wattpro = new WattPro(app)
-  app.wattpro = wattpro
+  const watt = new Watt(app)
+  app.watt = watt
   app.initApplication = initApplication
 
   const headers = await app.getAuthorizationHeader()
-  await app.wattpro.updateSharedContext({ iccAuthHeaders: headers })
+  await app.watt.updateSharedContext({ iccAuthHeaders: headers })
 }
 
 export default initPlugin

package/plugins/metadata.js

@@ -15,7 +15,7 @@ async function metadata (app, _opts) {
     }
 
     const applicationId = app.instanceConfig?.applicationId
-    const runtime = app.wattpro.runtime
+    const runtime = app.watt.runtime
     if (!applicationId) {
       app.log.warn('Cannot process metadata: no applicationId available')
       throw new MetadataAppIdError()

package/plugins/scheduler.js

@@ -8,7 +8,7 @@ async function scheduler (app, _opts) {
 
     try {
       const applicationId = app.instanceConfig?.applicationId
-      const runtime = app.wattpro.runtime
+      const runtime = app.watt.runtime
       const config = await runtime.getRuntimeConfig()
       const { default: build, setDefaultHeaders } = await import('../clients/cron/cron.mjs')
 

package/plugins/update.js

@@ -112,7 +112,7 @@ async function updatePlugin (app) {
   }
 
   app.updateConfig = async (message) => {
-    await app.wattpro.applyIccConfigUpdates(message.data)
+    await app.watt.applyIccConfigUpdates(message.data)
   }
 
   app.connectToUpdates = connectToUpdates

package/test/alerts.test.js

@@ -82,7 +82,7 @@ test('should send alert when service becomes unhealthy', async (t) => {
     }
   }
 
-  app.wattpro.runtime.emit('health', healthInfo)
+  app.watt.runtime.emit('health', healthInfo)
 
   await sleep(200)
 
@@ -158,7 +158,7 @@ test('should not send alert when service is healthy', async (t) => {
     }
   }
 
-  app.wattpro.runtime.emit('health', healthInfo)
+  app.watt.runtime.emit('health', healthInfo)
 
   await sleep(200)
 
@@ -227,7 +227,7 @@ test('should cache health data and include it in alerts', async (t) => {
       }
     }
 
-    app.wattpro.runtime.emit('health', healthyInfo)
+    app.watt.runtime.emit('health', healthyInfo)
     await sleep(100) // Small delay between events
   }
 
@@ -252,7 +252,7 @@ test('should cache health data and include it in alerts', async (t) => {
     }
   }
 
-  app.wattpro.runtime.emit('health', unhealthyInfo)
+  app.watt.runtime.emit('health', unhealthyInfo)
   await sleep(200)
 
   assert.ok(alertReceived, 'Alert should have been received')
@@ -320,7 +320,7 @@ test('should not fail when health info is missing', async (t) => {
     await icc.close()
   })
 
-  app.wattpro.runtime.emit('health', null)
+  app.watt.runtime.emit('health', null)
 
   await sleep(200)
 
@@ -393,11 +393,11 @@ test('should respect alert retention window', async (t) => {
   })
 
   // Send first unhealthy event - should trigger alert
-  app.wattpro.runtime.emit('health', createHealthInfo(true))
+  app.watt.runtime.emit('health', createHealthInfo(true))
   await sleep(100)
 
   // Send second unhealthy event immediately - should be ignored due to retention window
-  app.wattpro.runtime.emit('health', createHealthInfo(true))
+  app.watt.runtime.emit('health', createHealthInfo(true))
   await sleep(100)
 
   assert.strictEqual(alertsReceived.length, 1, 'Only one alert should be sent within retention window')
@@ -405,7 +405,7 @@ test('should respect alert retention window', async (t) => {
   await sleep(500)
 
   // Send third unhealthy event - should trigger second alert
-  app.wattpro.runtime.emit('health', createHealthInfo(true))
+  app.watt.runtime.emit('health', createHealthInfo(true))
   await sleep(100)
 
   assert.strictEqual(alertsReceived.length, 2, 'Second alert should be sent after retention window expires')
@@ -514,7 +514,7 @@ test('should send alert when flamegraphs are disabled', async (t) => {
     }
   }
 
-  app.wattpro.runtime.emit('health', healthInfo)
+  app.watt.runtime.emit('health', healthInfo)
 
   await sleep(200)
 
@@ -593,7 +593,7 @@ test('should send alert when failed to send a flamegraph', async (t) => {
     }
   }
 
-  app.wattpro.runtime.emit('health', healthInfo)
+  app.watt.runtime.emit('health', healthInfo)
 
   await sleep(200)
 

package/test/health.test.js

@@ -35,7 +35,7 @@ test('check that health is configured in runtime', async (t) => {
     await icc.close()
   })
 
-  const runtimeConfig = await app.wattpro.runtime.getRuntimeConfig()
+  const runtimeConfig = await app.watt.runtime.getRuntimeConfig()
 
   assert.ok(runtimeConfig.health, 'Health configuration should be present')
   assert.strictEqual(runtimeConfig.health.enabled, true, 'Health monitoring should be enabled')

package/test/patch-config.test.js

@@ -35,7 +35,7 @@ test('should spawn a service app settings labels for metrics', async (t) => {
     await icc.close()
   })
 
-  const mainConfig = app.wattpro.runtime.getRuntimeConfig(true)
+  const mainConfig = app.watt.runtime.getRuntimeConfig(true)
 
   const { metrics, telemetry } = mainConfig
 
@@ -122,7 +122,7 @@ test('should configure system resources', async (t) => {
     await app.close()
     await icc.close()
   })
-  const config = await app.wattpro.runtime.getRuntimeConfig(true)
+  const config = await app.watt.runtime.getRuntimeConfig(true)
 
   // Check generic resources
   assert.strictEqual(config.workers, 1)
@@ -162,13 +162,13 @@ test('should remove server https configs', async (t) => {
   })
 
   {
-    const mainConfig = app.wattpro.runtime.getRuntimeConfig(true)
+    const mainConfig = app.watt.runtime.getRuntimeConfig(true)
     const { server } = mainConfig
     assert.strictEqual(server.https, undefined)
   }
 
   {
-    const runtimeConfig = await app.wattpro.runtime.getRuntimeConfig(true)
+    const runtimeConfig = await app.watt.runtime.getRuntimeConfig(true)
 
     const { server } = runtimeConfig
     assert.strictEqual(server.https, undefined)
@@ -199,7 +199,7 @@ test('should configure health options', async (t) => {
     await icc.close()
   })
 
-  const runtimeConfig = await app.wattpro.runtime.getRuntimeConfig(true)
+  const runtimeConfig = await app.watt.runtime.getRuntimeConfig(true)
 
   const { health } = runtimeConfig
   assert.strictEqual(health.enabled, true)
@@ -233,12 +233,12 @@ test('should call updateServicesResources with maxHeapTotal', async (t) => {
 
   const updateCalls = []
   const originalUpdateServicesResources =
-    app.wattpro.runtime.updateServicesResources
-  app.wattpro.runtime.updateServicesResources = async (resourceUpdates) => {
+    app.watt.runtime.updateServicesResources
+  app.watt.runtime.updateServicesResources = async (resourceUpdates) => {
     updateCalls.push(resourceUpdates)
     if (originalUpdateServicesResources) {
       return originalUpdateServicesResources.call(
-        app.wattpro.runtime,
+        app.watt.runtime,
         resourceUpdates
       )
     }
@@ -253,7 +253,7 @@ test('should call updateServicesResources with maxHeapTotal', async (t) => {
     },
   }
 
-  await app.wattpro.applyIccConfigUpdates(config)
+  await app.watt.applyIccConfigUpdates(config)
 
   assert.strictEqual(
     updateCalls.length,
@@ -302,7 +302,7 @@ test('should handle updateServicesResources with different heap sizes', async (t
   })
 
   const updateCalls = []
-  app.wattpro.runtime.updateServicesResources = async (resourceUpdates) => {
+  app.watt.runtime.updateServicesResources = async (resourceUpdates) => {
     updateCalls.push(resourceUpdates)
   }
 
@@ -318,7 +318,7 @@ test('should handle updateServicesResources with different heap sizes', async (t
   ]
 
   for (const config of configs) {
-    await app.wattpro.applyIccConfigUpdates(config)
+    await app.watt.applyIccConfigUpdates(config)
   }
 
   assert.strictEqual(updateCalls.length, 1)
@@ -353,7 +353,7 @@ test('should handle updateServicesResources error gracefully', async (t) => {
   })
 
   let errorThrown = false
-  app.wattpro.runtime.updateServicesResources = async (resourceUpdates) => {
+  app.watt.runtime.updateServicesResources = async (resourceUpdates) => {
     assert.strictEqual(resourceUpdates[0].health.maxHeapTotal, '256MB')
     errorThrown = true
     throw new Error('Mock update error')
@@ -365,7 +365,7 @@ test('should handle updateServicesResources error gracefully', async (t) => {
     },
   }
 
-  await app.wattpro.applyIccConfigUpdates(config)
+  await app.watt.applyIccConfigUpdates(config)
 
   assert.strictEqual(
     errorThrown,

package/test/scheduler.test.js

@@ -42,7 +42,7 @@ test('should spawn a runtime disabling all the scheduler jobs', async (t) => {
     await icc.close()
   })
 
-  const config = await app.wattpro.runtime.getRuntimeConfig()
+  const config = await app.watt.runtime.getRuntimeConfig()
 
   const { scheduler } = config
 

package/test/trigger-flamegraphs.test.js

@@ -36,7 +36,7 @@ function setupMockIccServer (wss, receivedMessages, validateAuth = false) {
 }
 
 function createMockApp (port, includeScalerUrl = true) {
-  const mockWattPro = {
+  const mockWatt = {
     runtime: {
       getApplications: () => ({
         applications: [{ id: 'service-1' }, { id: 'service-2' }],
@@ -65,7 +65,7 @@ function createMockApp (port, includeScalerUrl = true) {
       PLT_DISABLE_FLAMEGRAPHS: false,
       PLT_FLAMEGRAPHS_INTERVAL_SEC: 1
     },
-    wattpro: mockWattPro,
+    watt: mockWatt,
   }
 
   if (includeScalerUrl) {
@@ -102,7 +102,7 @@ test('should handle trigger-flamegraph command and upload flamegraphs from servi
 
   const app = createMockApp(port)
 
-  app.wattpro.runtime.sendCommandToApplication = async (
+  app.watt.runtime.sendCommandToApplication = async (
     serviceId,
     command
   ) => {
@@ -162,7 +162,7 @@ test('should handle trigger-flamegraph when no runtime is available', async (t)
   )
 
   const app = createMockApp(port + 1)
-  app.wattpro.runtime = null
+  app.watt.runtime = null
 
   await updatePlugin(app)
   await app.connectToUpdates()
@@ -195,7 +195,7 @@ test('should handle trigger-flamegraph when flamegraph upload fails', async (t)
 
   const app = createMockApp(port + 2)
 
-  app.wattpro.runtime.sendCommandToApplication = async (
+  app.watt.runtime.sendCommandToApplication = async (
     serviceId,
     command,
     options