Project Browsers 1.0

This commit is contained in:
Jakub Zych
2026-03-07 23:51:53 +01:00
commit 3f4920a68f
31 changed files with 1433 additions and 0 deletions

241
lib/process-manager.js Normal file
View File

@@ -0,0 +1,241 @@
const { spawn, execSync } = require('child_process');
const net = require('net');
const EventEmitter = require('events');
const processes = new Map();
const events = new EventEmitter();
function key(slug, type) { return `${slug}:${type}`; }
function createEntry() {
return { child: null, status: 'stopped', logs: [], port: null };
}
function getStatus(slug) {
const api = processes.get(key(slug, 'api'));
const frontend = processes.get(key(slug, 'frontend'));
return {
api: api
? { status: api.status, pid: api.child?.pid || null, logs: api.logs }
: { status: 'stopped', pid: null, logs: [] },
frontend: frontend
? { status: frontend.status, pid: frontend.child?.pid || null, logs: frontend.logs }
: null,
};
}
function combinedStatus(slug, hasFrontend) {
const s = getStatus(slug);
if (!hasFrontend) return s.api.status;
// Both must be running for "running"; if either is error, "error"; else worst state
const apiSt = s.api.status;
const feSt = s.frontend?.status || 'stopped';
if (apiSt === 'running' && feSt === 'running') return 'running';
if (apiSt === 'error' || feSt === 'error') return 'error';
if (apiSt === 'starting' || feSt === 'starting') return 'starting';
if (apiSt === 'stopping' || feSt === 'stopping') return 'stopping';
return 'stopped';
}
function setStatus(entry, slug, subtype, status) {
if (entry.status === status) return;
entry.status = status;
events.emit('status', slug, subtype, status);
}
function pushLog(entry, line) {
entry.logs.push(line);
if (entry.logs.length > 50) entry.logs.shift();
}
function spawnProcess(slug, subtype, cmd, args, cwd) {
const k = key(slug, subtype);
const existing = processes.get(k);
if (existing && (existing.status === 'running' || existing.status === 'starting')) {
return existing;
}
const entry = createEntry();
processes.set(k, entry);
const label = `[${slug}:${subtype}]`;
console.log(`${label} Spawning: ${cmd} ${args.join(' ')} (cwd: ${cwd})`);
const child = spawn(cmd, args, {
cwd,
stdio: ['ignore', 'pipe', 'pipe'],
detached: true,
});
entry.child = child;
entry.status = 'starting';
events.emit('status', slug, subtype, 'starting');
child.stdout.on('data', (data) => {
for (const line of data.toString().split('\n').filter(Boolean)) {
pushLog(entry, `[out] ${line}`);
}
});
child.stderr.on('data', (data) => {
for (const line of data.toString().split('\n').filter(Boolean)) {
pushLog(entry, `[err] ${line}`);
console.log(`${label} [err] ${line}`);
}
});
child.on('error', (err) => {
console.error(`${label} Spawn error: ${err.message}`);
setStatus(entry, slug, subtype, 'error');
pushLog(entry, `[sys] Error: ${err.message}`);
});
child.on('exit', (code, signal) => {
console.log(`${label} Exited code=${code} signal=${signal}`);
setStatus(entry, slug, subtype, 'stopped');
pushLog(entry, `[sys] Exited code=${code} signal=${signal}`);
entry.child = null;
});
return entry;
}
function start(slug, projectPath, port, frontend) {
// Start API
const apiEntry = spawnProcess(slug, 'api', 'php',
['artisan', 'serve', `--port=${port}`, '--host=0.0.0.0'],
projectPath
);
apiEntry.port = port;
healthCheck(slug, 'api', port, apiEntry);
let feResult = null;
// Start frontend if present
if (frontend) {
const isExisting = processes.get(key(slug, 'frontend'));
if (isExisting && (isExisting.status === 'running' || isExisting.status === 'starting')) {
feResult = { status: isExisting.status, message: 'Already running' };
} else {
let cmd, args;
if (frontend.packageManager === 'pnpm') {
cmd = 'pnpm';
args = ['dev', '--port', String(frontend.port), '--host', '0.0.0.0'];
} else {
cmd = 'npm';
args = ['run', 'dev', '--', '--port', String(frontend.port), '--host', '0.0.0.0'];
}
const feEntry = spawnProcess(slug, 'frontend', cmd, args, frontend.fullPath);
feEntry.port = frontend.port;
healthCheck(slug, 'frontend', frontend.port, feEntry);
feResult = { status: 'starting', pid: feEntry.child?.pid };
}
}
return {
api: { status: apiEntry.status, pid: apiEntry.child?.pid },
frontend: feResult,
};
}
function healthCheck(slug, subtype, port, entry, attempt = 0) {
const maxAttempts = subtype === 'frontend' ? 60 : 15;
const interval = subtype === 'frontend' ? 3000 : 1000;
if (attempt > maxAttempts) {
if (entry.status === 'starting') setStatus(entry, slug, subtype, 'error');
pushLog(entry, '[sys] Health check timed out');
return;
}
setTimeout(() => {
if (entry.status !== 'starting') return;
// Use TCP connect check instead of HTTP — avoids socket pool exhaustion
const sock = net.connect(port, '127.0.0.1');
sock.setTimeout(2000);
sock.on('connect', () => {
sock.destroy();
setStatus(entry, slug, subtype, 'running');
pushLog(entry, `[sys] Port ${port} responding`);
});
sock.on('error', () => {
sock.destroy();
healthCheck(slug, subtype, port, entry, attempt + 1);
});
sock.on('timeout', () => {
sock.destroy();
healthCheck(slug, subtype, port, entry, attempt + 1);
});
}, interval);
}
function stopEntry(k, slug, subtype) {
const entry = processes.get(k);
if (!entry || !entry.child) {
processes.delete(k);
return Promise.resolve({ status: 'stopped' });
}
return new Promise((resolve) => {
const child = entry.child;
setStatus(entry, slug, subtype, 'stopping');
child.on('exit', () => {
setStatus(entry, slug, subtype, 'stopped');
entry.child = null;
resolve({ status: 'stopped' });
});
try { process.kill(-child.pid, 'SIGTERM'); } catch {}
setTimeout(() => {
if (entry.child) {
try { process.kill(-child.pid, 'SIGKILL'); } catch {}
}
}, 3000);
});
}
function stop(slug) {
return Promise.all([
stopEntry(key(slug, 'api'), slug, 'api'),
stopEntry(key(slug, 'frontend'), slug, 'frontend'),
]);
}
function stopAll() {
const slugsSeen = new Set();
for (const [k] of processes) {
const slug = k.split(':')[0];
slugsSeen.add(slug);
}
return Promise.all([...slugsSeen].map(s => stop(s)));
}
function getAllStatuses() {
const result = {};
for (const [k] of processes) {
const slug = k.split(':')[0];
if (!result[slug]) result[slug] = getStatus(slug);
}
return result;
}
function killAllSync() {
for (const [, entry] of processes) {
if (entry.child) {
try { process.kill(-entry.child.pid, 'SIGTERM'); } catch {}
}
}
// Brief wait then SIGKILL any survivors
try { execSync('sleep 1'); } catch {}
for (const [, entry] of processes) {
if (entry.child) {
try { process.kill(-entry.child.pid, 'SIGKILL'); } catch {}
}
}
processes.clear();
}
module.exports = { start, stop, stopAll, getStatus, combinedStatus, getAllStatuses, events, killAllSync };