@bluecadet/launchpad-monitor

Process monitoring and management for interactive installations. Part of the Launchpad suite of tools.

Documentation

For complete documentation, examples, and API reference, visit: https://bluecadet.github.io/launchpad

Features

• Process management via PM2
• Launchpad plugin integration for custom monitoring behavior
• Process lifecycle hooks
• Built-in logging and error handling
• Window management capabilities

Installation

npm install @bluecadet/launchpad-monitor

Basic Usage

import { defineConfig } from '@bluecadet/launchpad-cli';
import { monitor } from '@bluecadet/launchpad-monitor';

export default defineConfig({
  plugins: [
    monitor({
      apps: [
        {
          pm2: {
            name: 'my-app',
            script: 'app.js',
          },
        },
      ],
    }),
  ],
  workflows: {
    start: ['monitor.connect', 'monitor.start'],
    stop: ['monitor.stop', 'monitor.disconnect'],
  },
});

License

Bluecadet-authored code in this package is licensed under ISC. Third-party dependencies retain their own licenses.

This package depends on PM2, which is licensed under AGPL-3.0. Review PM2's license terms when using, deploying, or redistributing this package.

In practice, PM2's license does not make applications managed by PM2 become AGPL-licensed. The main impact is on compliance for the PM2 dependency itself:

• If you redistribute a bundle, installer, or machine image that includes PM2, preserve PM2's license notices and be prepared to provide PM2 source as required by its license.
• If you modify PM2 itself, expect those PM2 changes to carry AGPL obligations, including source availability for users who interact with the modified PM2 over a network.
• Some organizations restrict AGPL dependencies. If that applies to your project, review the monitor package before adopting it or install only the Launchpad packages you need.

This is a practical summary, not legal advice.