@drocketxx/pm2me 1.1.9 → 1.1.11

package/apps/Delete-Test-App/README.md

@@ -0,0 +1 @@
+# PM2Me-test

package/apps/Delete-Test-App/dist/server.js

@@ -0,0 +1,57 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const dotenv = __importStar(require("dotenv"));
+const http = __importStar(require("http"));
+dotenv.config();
+const port = parseInt(process.env.PORT || '6060', 10);
+const server = http.createServer((req, res) => {
+    if (req.url === '/') {
+        console.log('req.url', req.url, new Date().toISOString());
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({
+            message: 'PM2Me Test App is running!',
+            currentTime: new Date().toISOString(),
+            env: process.env
+        }, null, 2));
+    }
+    else {
+        res.writeHead(404);
+        res.end('Not found');
+    }
+});
+server.listen(port, () => {
+    console.log(`Server listening on port ${port}`);
+});

package/apps/Delete-Test-App/package.json

@@ -0,0 +1,19 @@
+{
+    "name": "pm2me-test",
+    "version": "1.0.12",
+    "description": "A test project for PM2Me deployment",
+    "main": "dist/server.js",
+    "scripts": {
+        "start": "node dist/server.js",
+        "build": "tsc",
+        "dev": "ts-node src/server.ts"
+    },
+    "dependencies": {
+        "dotenv": "^16.4.5"
+    },
+    "devDependencies": {
+        "@types/node": "^20.11.24",
+        "ts-node": "^10.9.2",
+        "typescript": "^5.3.3"
+    }
+}

package/apps/Delete-Test-App/src/server.ts

@@ -0,0 +1,33 @@
+import * as dotenv from 'dotenv';
+import * as http from 'http';
+
+dotenv.config();
+
+//  throw new Error('SIMULATE RUN ERROR: App failed to start during RUN stage');
+// RUN stage rollback test v4 (No Race Condition)
+// Simulate a runtime error for the 'RUN' step visualization
+// if (process.env.SIMULATE_RUN_ERROR === 'true') {
+//     throw new Error('SIMULATE RUN ERROR: App failed to start during RUN stage');
+// }
+
+const port: number = parseInt(process.env.PORT || '6060', 10);
+
+const server = http.createServer((req: http.IncomingMessage, res: http.ServerResponse) => {
+    if (req.url === '/') {
+        console.log('req.url', req.url, new Date().toISOString());
+
+        res.writeHead(200, { 'Content-Type': 'application/json' },);
+        res.end(JSON.stringify({
+            message: 'PM2Me Test App is running!',
+            currentTime: new Date().toISOString(),
+            env: process.env
+        }, null, 2));
+    } else {
+        res.writeHead(404);
+        res.end('Not found');
+    }
+});
+
+server.listen(port, () => {
+    console.log(`Server listening on port ${port}`);
+});

package/apps/Delete-Test-App/tsconfig.json

@@ -0,0 +1,15 @@
+{
+    "compilerOptions": {
+        "target": "es2022",
+        "module": "commonjs",
+        "rootDir": "./src",
+        "outDir": "./dist",
+        "esModuleInterop": true,
+        "forceConsistentCasingInFileNames": true,
+        "strict": true,
+        "skipLibCheck": true
+    },
+    "include": [
+        "src/**/*"
+    ]
+}

package/apps/Delete-Test-App-2/README.md

@@ -0,0 +1 @@
+# PM2Me-test

package/apps/Delete-Test-App-2/dist/server.js

@@ -0,0 +1,57 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const dotenv = __importStar(require("dotenv"));
+const http = __importStar(require("http"));
+dotenv.config();
+const port = parseInt(process.env.PORT || '6060', 10);
+const server = http.createServer((req, res) => {
+    if (req.url === '/') {
+        console.log('req.url', req.url, new Date().toISOString());
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({
+            message: 'PM2Me Test App is running!',
+            currentTime: new Date().toISOString(),
+            env: process.env
+        }, null, 2));
+    }
+    else {
+        res.writeHead(404);
+        res.end('Not found');
+    }
+});
+server.listen(port, () => {
+    console.log(`Server listening on port ${port}`);
+});

package/apps/Delete-Test-App-2/package.json

@@ -0,0 +1,19 @@
+{
+    "name": "pm2me-test",
+    "version": "1.0.12",
+    "description": "A test project for PM2Me deployment",
+    "main": "dist/server.js",
+    "scripts": {
+        "start": "node dist/server.js",
+        "build": "tsc",
+        "dev": "ts-node src/server.ts"
+    },
+    "dependencies": {
+        "dotenv": "^16.4.5"
+    },
+    "devDependencies": {
+        "@types/node": "^20.11.24",
+        "ts-node": "^10.9.2",
+        "typescript": "^5.3.3"
+    }
+}

package/apps/Delete-Test-App-2/src/server.ts

@@ -0,0 +1,33 @@
+import * as dotenv from 'dotenv';
+import * as http from 'http';
+
+dotenv.config();
+
+//  throw new Error('SIMULATE RUN ERROR: App failed to start during RUN stage');
+// RUN stage rollback test v4 (No Race Condition)
+// Simulate a runtime error for the 'RUN' step visualization
+// if (process.env.SIMULATE_RUN_ERROR === 'true') {
+//     throw new Error('SIMULATE RUN ERROR: App failed to start during RUN stage');
+// }
+
+const port: number = parseInt(process.env.PORT || '6060', 10);
+
+const server = http.createServer((req: http.IncomingMessage, res: http.ServerResponse) => {
+    if (req.url === '/') {
+        console.log('req.url', req.url, new Date().toISOString());
+
+        res.writeHead(200, { 'Content-Type': 'application/json' },);
+        res.end(JSON.stringify({
+            message: 'PM2Me Test App is running!',
+            currentTime: new Date().toISOString(),
+            env: process.env
+        }, null, 2));
+    } else {
+        res.writeHead(404);
+        res.end('Not found');
+    }
+});
+
+server.listen(port, () => {
+    console.log(`Server listening on port ${port}`);
+});

package/apps/Delete-Test-App-2/tsconfig.json

@@ -0,0 +1,15 @@
+{
+    "compilerOptions": {
+        "target": "es2022",
+        "module": "commonjs",
+        "rootDir": "./src",
+        "outDir": "./dist",
+        "esModuleInterop": true,
+        "forceConsistentCasingInFileNames": true,
+        "strict": true,
+        "skipLibCheck": true
+    },
+    "include": [
+        "src/**/*"
+    ]
+}

package/apps/Delete-Test-App-2_deploy.log

@@ -0,0 +1,12 @@
+--- Deployment Started at 2026-03-01T18:37:14.708Z ---
+[pm2me] Sync
+[pm2me] Synchronizing Repository
+Git: Cloned repository cleanly on branch main (Commit: ืno error)
+[pm2me] Setting up env
+[pm2me] Starting PM2
+[pm2me] Updating Application in PM2
+[pm2me] Fresh Starting
+[pm2me] Stabilization started. Verifying health for 10s...
+[pm2me] Deployment Online (Health period active)
+[pm2me] App unhealthy after 10s (Status: errored, Restarts: 15 vs 0). Rolling back...
+[pm2me] No stable version to rollback to or already on last good version.

package/apps/Delete-Test-App_deploy.log

@@ -0,0 +1,12 @@
+--- Deployment Started at 2026-03-01T18:34:22.724Z ---
+[pm2me] Sync
+[pm2me] Synchronizing Repository
+Git: Cloned repository cleanly on branch main (Commit: ืno error)
+[pm2me] Setting up env
+[pm2me] Starting PM2
+[pm2me] Updating Application in PM2
+[pm2me] Fresh Starting
+[pm2me] Stabilization started. Verifying health for 10s...
+[pm2me] Deployment Online (Health period active)
+[pm2me] App unhealthy after 10s (Status: errored, Restarts: 15 vs 0). Rolling back...
+[pm2me] No stable version to rollback to or already on last good version.

package/apps/PM2Me-main/README.md

@@ -0,0 +1,236 @@
+# PM2Me 🚀
+
+> A self-hosted, premium web dashboard for deploying and managing Node.js applications via PM2.
+
+PM2Me lets you **deploy apps directly from a GitHub repository**, manage PM2 processes, monitor your server in real-time, and receive webhook-triggered auto-deployments — all from a beautiful, dark-mode UI.
+
+[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-ffdd00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black)](https://buymeacoffee.com/rocketx.x)
+
+![PM2Me Dashboard](screenshot/001.png)
+
+---
+
+## ✨ Features
+
+| Feature | Details |
+|---|---|
+| 🖥 **Dashboard** | View all PM2 apps with real-time status, CPU, memory, uptime |
+| 🚀 **Deploy from GitHub** | Clone & deploy any GitHub repo with PAT authentication |
+| 🔄 **Auto-Sync via Webhook** | Automatically re-deploy on `git push` using GitHub Webhooks |
+| 📊 **Server Monitor** | Real-time CPU, RAM, Disk, Network, and System Uptime via Socket.IO |
+| 📜 **Live Logs** | Stream PM2 app logs in the browser in real-time |
+| 🔔 **Notifications** | Deployment alerts via Discord Webhook or Telegram Bot |
+| 🔐 **Admin Login** | Secure JWT-based authentication with bcrypt hashed passwords |
+| ⚙️ **Settings Page** | Manage GitHub accounts, webhook secrets, and notification integrations |
+| 📋 **Webhook History** | Last 50 webhook events logged and updated in real-time |
+| 🗑 **Delete/Stop/Restart** | Full PM2 lifecycle management with a premium custom UI |
+
+---
+
+## 🧱 Tech Stack
+
+**Backend**
+- [Express.js](https://expressjs.com/) — REST API server
+- [Socket.IO](https://socket.io/) — Real-time log streaming & system stats
+- [PM2](https://pm2.keymetrics.io/) — Process management (`pm2` Node.js API)
+- [LowDB](https://github.com/typicode/lowdb) — Lightweight JSON file database
+- [bcrypt](https://www.npmjs.com/package/bcrypt) — Password hashing
+- [jsonwebtoken](https://www.npmjs.com/package/jsonwebtoken) — JWT Auth
+- [simple-git](https://github.com/steveukx/git-js) — Git operations
+
+**Frontend**
+- [Vue 3](https://vuejs.org/) — Reactive UI
+- [Vite](https://vitejs.dev/) — Build tool
+- [Socket.IO Client](https://socket.io/docs/v4/client-api/) — Real-time updates
+
+---
+
+## 🚀 Getting Started
+
+### Prerequisites
+- [Node.js](https://nodejs.org/) >= 18
+- [PM2](https://pm2.keymetrics.io/) installed globally: `npm install -g pm2`
+- [Git](https://git-scm.com/) installed and accessible in `PATH`
+
+### Installation & Running (Recommended with PM2)
+
+```bash
+# 1. Clone the repository
+git clone https://github.com/drocketxx/PM2Me.git
+cd PM2Me
+
+# 2. Install all dependencies (frontend + backend)
+npm run install:all
+
+# 3. Build the frontend
+npm run build
+
+# 4. Start PM2Me with PM2 ✅ Recommended
+cd backend
+pm2 start app.js --name pm2me
+
+# 5. Auto-start on system reboot
+pm2 save
+pm2 startup
+```
+
+Open your browser at: **http://localhost:12345**
+
+> 💡 **Useful PM2 commands:**
+> ```bash
+> pm2 status          # Check PM2Me status
+> pm2 logs pm2me      # View PM2Me logs
+> pm2 restart pm2me   # Restart PM2Me
+> pm2 stop pm2me      # Stop PM2Me
+> ```
+
+**Development mode** (nodemon auto-restart):
+```bash
+cd /path/to/PM2Me
+npm run dev
+```
+
+---
+
+## 🔐 Default Login & Password Management
+
+On first run, **no password is set**. Use the CLI to set one:
+
+```bash
+# Set or change admin password
+npm run pw -- <your_password>
+
+# Example
+npm run pw -- mySecretPass123
+```
+
+> You can also run it directly from the `backend/` folder:
+> ```bash
+> cd backend && node scripts/change-password.js mySecretPass123
+> ```
+>
+> The password is stored as a **bcrypt hash** (12 rounds) in `backend/db/database.json`.
+
+---
+
+## 🔗 GitHub Webhook Setup
+
+PM2Me supports automatic deployments triggered by `git push`. Here's how to enable it:
+
+1. Go to your GitHub repository → **Settings** → **Webhooks** → **Add webhook**
+2. Set **Payload URL** to: `http://your-server-ip:12345/api/webhook`
+3. Set **Content type** to: **`application/json`** ⚠️
+4. Set **Secret** from the Settings page in PM2Me (generate one if needed)
+5. Select **Just the push event**
+6. Click **Add webhook**
+
+PM2Me will automatically re-deploy any matching app (matched by repo URL + branch) on each push.
+
+> **Webhook History** (last 50 events) is displayed on the Settings page in real-time.
+
+---
+
+## 📂 Project Structure
+
+```
+PM2Me/
+├── backend/
+│   ├── app.js              # Express server + Socket.IO setup
+│   ├── db/
+│   │   ├── index.js        # LowDB initialization
+│   │   └── database.json   # App data, settings, webhook logs
+│   ├── routes/
+│   │   ├── api.js          # Main API routes
+│   │   └── auth.js         # Login / JWT auth
+│   ├── services/
+│   │   ├── gitService.js   # Git clone/pull operations
+│   │   ├── pm2Service.js   # PM2 process management
+│   │   ├── systemService.js# CPU / RAM / Disk / Network stats
+│   │   └── notificationService.js # Discord & Telegram alerts
+│   ├── scripts/
+│   │   └── change-password.js  # CLI tool to change admin password
+│   └── public/             # Built Vue frontend (served statically)
+├── frontend/
+│   ├── src/
+│   │   ├── views/
+│   │   │   ├── Dashboard.vue   # Main app dashboard
+│   │   │   ├── Settings.vue    # Settings & webhook history
+│   │   │   └── Login.vue       # Auth page
+│   │   ├── components/
+│   │   │   ├── DeployModal.vue # New/Edit app deployment modal
+│   │   │   ├── LogViewer.vue   # Real-time log stream
+│   │   │   └── ServerStats.vue # CPU/RAM/Network widget
+│   │   ├── router/             # Vue Router config
+│   │   └── App.vue             # Nav layout
+│   └── vite.config.js
+├── apps/                   # Cloned app repos live here
+└── package.json            # Root scripts (dev, build, pw)
+```
+
+---
+
+## 📝 Available Scripts
+
+Run these from the **root** `PM2Me/` directory:
+
+| Command | Description |
+|---|---|
+| `npm run dev` | Build frontend & start backend dev server |
+| `npm run build` | Build frontend only |
+| `npm run pw -- <password>` | Change admin password |
+| `npm run install:all` | Install all dependencies (root + frontend + backend) |
+
+---
+
+## 📡 API Overview
+
+| Method | Endpoint | Description |
+|---|---|---|
+| `POST` | `/api/auth/login` | Login, returns JWT token |
+| `GET` | `/api/pm2/list` | List all PM2 processes |
+| `POST` | `/api/pm2/:action` | PM2 action: start/stop/restart/delete |
+| `GET` | `/api/apps` | List all deployed apps (DB) |
+| `POST` | `/api/apps` | Register a new app |
+| `PUT` | `/api/apps/:id` | Update app config |
+| `DELETE` | `/api/apps/:id` | Delete app from DB |
+| `POST` | `/api/apps/:id/deploy` | Trigger deployment |
+| `GET` | `/api/apps/:id/sync-status` | Check if branch is behind remote |
+| `GET` | `/api/settings` | Get current settings |
+| `POST` | `/api/settings` | Save settings |
+| `GET` | `/api/settings/webhook-logs` | Get last 50 webhook events |
+| `POST` | `/api/webhook` | GitHub Webhook receiver |
+| `GET` | `/api/system/stats` | Server system stats |
+
+---
+
+## 📦 Deployment (Production)
+
+For production, it's recommended to run the PM2Me backend itself with PM2:
+
+```bash
+# Build the frontend
+npm run build
+
+# Start with PM2
+cd backend
+pm2 start app.js --name pm2me
+
+# Save and set to auto-restart on reboot
+pm2 save
+pm2 startup
+```
+
+---
+
+## 🛡 Security Notes
+
+- Change the default admin password immediately on first run using `npm run pw`.
+- Set a strong `JWT_SECRET` in your `.env` file.
+- Always set a **Webhook Secret** to prevent unauthorized deploys.
+- Consider putting PM2Me behind a reverse proxy (e.g., Nginx) with HTTPS in production.
+
+---
+
+## 📄 License
+
+MIT

package/apps/PM2Me-main/backend/app.js

@@ -0,0 +1,109 @@
+import express from 'express';
+import http from 'http';
+import { Server } from 'socket.io';
+import cors from 'cors';
+import morgan from 'morgan';
+import apiRoutes from './routes/api.js';
+import authRoutes, { authenticateToken } from './routes/auth.js';
+import dotenv from 'dotenv';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import pm2 from 'pm2';
+import db from './db/index.js';
+import { getSystemStats } from './services/systemService.js';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+dotenv.config();
+
+const app = express();
+const server = http.createServer(app);
+const io = new Server(server, {
+    cors: { origin: '*', methods: ['GET', 'POST'] }
+});
+
+app.use(cors());
+app.use(express.json({
+    verify: (req, res, buf) => {
+        req.rawBody = buf;
+    }
+}));
+app.use(morgan('dev'));
+
+// Provide io instance to routes
+app.use((req, res, next) => {
+    req.io = io;
+    next();
+});
+
+// Routes
+app.use('/api/auth', authRoutes);
+app.use('/api', apiRoutes); // optionally add authenticateToken here
+
+import history from 'connect-history-api-fallback';
+
+// Serve Vue Frontend
+app.use(history({
+    index: '/index.html',
+    rewrites: [
+        { from: /^\/api\/.*$/, to: function (context) { return context.parsedUrl.pathname; } }
+    ]
+}));
+app.use(express.static(path.join(__dirname, 'public')));
+
+// Socket.io connection handling
+io.on('connection', (socket) => {
+    console.log('Client connected:', socket.id);
+    socket.on('disconnect', () => {
+        console.log('Client disconnected:', socket.id);
+    });
+});
+
+const PORT = process.env.PORT || 12345;
+server.listen(PORT, () => {
+    console.log(`Backend server running on http://localhost:${PORT}`);
+
+    // Connect to PM2 Event Bus for real-time logs
+    pm2.connect((err) => {
+        if (err) {
+            console.error('Failed to connect to PM2 for log streaming:', err);
+            return;
+        }
+
+        pm2.launchBus((err, pm2_bus) => {
+            if (err) {
+                console.error('Failed to launch PM2 bus:', err);
+                return;
+            }
+
+            console.log('PM2 Event Bus launched successfully');
+
+            const broadcastLog = (type, packet) => {
+                const appName = packet.process.name;
+                const appConfig = db.data.apps.find(a => a.name === appName);
+                if (appConfig) {
+                    const prefix = type === 'out' ? '[out]' : '[err]';
+                    let text = packet.data;
+                    if (typeof text !== 'string') text = text.toString();
+                    io.emit(`deploy-log-${appConfig.id}`, `${prefix} | ${text.trim()}`);
+                }
+            };
+
+            pm2_bus.on('log:out', (packet) => broadcastLog('out', packet));
+            pm2_bus.on('log:err', (packet) => broadcastLog('err', packet));
+        });
+    });
+
+    // Broadcast system stats every 1 second
+    const broadcastStats = async () => {
+        try {
+            const stats = await getSystemStats();
+            io.emit('system-stats', stats);
+        } catch (e) {
+            console.error('Failed to broadcast system stats:', e);
+        } finally {
+            setTimeout(broadcastStats, 1000); // Wait 1 second after completion
+        }
+    };
+    broadcastStats();
+});

package/apps/PM2Me-main/backend/db/index.js

@@ -0,0 +1,40 @@
+import { JSONFilePreset } from 'lowdb/node';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const dbPath = path.join(__dirname, 'database.json');
+
+const defaultData = {
+    apps: [],
+    settings: {
+        webhookSecret: '',
+        discordWebhook: '',
+        telegramBotToken: '',
+        telegramChatId: '',
+    },
+    githubAccounts: [],
+    webhookLogs: [],
+    admin: {
+        passwordHash: '', // Store hashed password
+    }
+};
+
+// Initialize DB with node preset
+const db = await JSONFilePreset(dbPath, defaultData);
+
+// Cleanup stuck deploying status from previous crash/restart
+let needsWrite = false;
+if (db.data && db.data.apps) {
+    db.data.apps.forEach(app => {
+        if (app.status === 'deploying') {
+            app.status = 'failed'; // Reset stuck deploys
+            needsWrite = true;
+        }
+    });
+}
+if (needsWrite) {
+    await db.write();
+}
+
+export default db;