@lenne.tech/cli 1.21.0 → 1.22.0

package/build/lib/port-registry.js

@@ -1,304 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SLOT_PORT_RANGE_END = exports.SLOT_MAX = exports.SLOT_STEP = exports.SLOT_BASE_API = void 0;
-exports.allocatedSlots = allocatedSlots;
-exports.allocateSlot = allocateSlot;
-exports.checkPortInUse = checkPortInUse;
-exports.clearLocalState = clearLocalState;
-exports.isPidAlive = isPidAlive;
-exports.isValidPid = isValidPid;
-exports.listenSnapshot = listenSnapshot;
-exports.loadLocalState = loadLocalState;
-exports.loadRegistry = loadRegistry;
-exports.localStatePath = localStatePath;
-exports.portsForSlot = portsForSlot;
-exports.projectSlug = projectSlug;
-exports.registryPath = registryPath;
-exports.saveLocalState = saveLocalState;
-exports.saveRegistry = saveRegistry;
-exports.slotFromSlug = slotFromSlug;
-/**
- * Port registry helpers for `lt local` and `lt ports`.
- *
- * Provides:
- * - Deterministic slot allocation from a project slug (hash-based, reproducible across machines)
- * - Persistent registry at ~/.lenneTech/ports.json
- * - Live port introspection via `lsof` (single-call snapshot for batch checks)
- * - Process state tracking under <project>/.lt-local/state.json
- */
-const child_process_1 = require("child_process");
-const fs_1 = require("fs");
-const os_1 = require("os");
-const path_1 = require("path");
-/** Lowest API port: slot 0 maps to 3000/3001, slot 1 to 3010/3011, … */
-exports.SLOT_BASE_API = 3000;
-/** Distance between two adjacent slots' API ports. */
-exports.SLOT_STEP = 10;
-/** Number of slots [0..SLOT_MAX). API range = [SLOT_BASE_API, SLOT_BASE_API + SLOT_MAX*SLOT_STEP). */
-exports.SLOT_MAX = 90;
-/** Highest port (exclusive) covered by the slot range. Useful for live-port sweeps. */
-exports.SLOT_PORT_RANGE_END = exports.SLOT_BASE_API + exports.SLOT_MAX * exports.SLOT_STEP;
-/** All currently allocated slots in the registry. */
-function allocatedSlots(registry) {
-    return new Set(Object.values(registry.projects).map((p) => p.slot));
-}
-/**
- * Allocate a slot for a project. Returns deterministic slot from slug if free,
- * otherwise scans linearly until a free slot is found. Throws if all are taken.
- *
- * The linear scan loops `i in [1, SLOT_MAX)` (not `<=`) because `i = 0` is the
- * preferred slot already checked in the fast path above.
- */
-function allocateSlot(slug, registry) {
-    const taken = allocatedSlots(registry);
-    const preferred = slotFromSlug(slug);
-    if (!taken.has(preferred)) {
-        return preferred;
-    }
-    for (let i = 1; i < exports.SLOT_MAX; i++) {
-        const candidate = (preferred + i) % exports.SLOT_MAX;
-        if (!taken.has(candidate)) {
-            return candidate;
-        }
-    }
-    throw new Error('No free port slot available (all 90 slots are taken).');
-}
-/**
- * Check via `lsof` whether a single TCP port is currently bound by a LISTEN socket.
- *
- * For multi-port checks prefer {@link listenSnapshot} — it issues a single `lsof`
- * call instead of one per port (~50ms vs ~50ms × N).
- *
- * Note: `-iTCP:<port>` selects connections by *service port* — both LISTEN
- * sockets and remote endpoints. We filter explicitly to LISTEN via
- * `-sTCP:LISTEN` AND post-filter the NAME column for `*:<port>` /
- * `<addr>:<port>` (LISTEN) so outgoing connections whose remote port is
- * `<port>` don't trigger a false positive.
- *
- * Returns null if lsof is unavailable.
- */
-function checkPortInUse(port) {
-    return __awaiter(this, void 0, void 0, function* () {
-        return new Promise((resolve) => {
-            var _a;
-            const child = (0, child_process_1.spawn)('lsof', ['-iTCP', `-sTCP:LISTEN`, '-nP', `-iTCP:${port}`], {
-                stdio: ['ignore', 'pipe', 'ignore'],
-            });
-            let out = '';
-            (_a = child.stdout) === null || _a === void 0 ? void 0 : _a.on('data', (chunk) => (out += chunk.toString()));
-            child.on('error', () => resolve(null));
-            child.on('close', () => {
-                const lines = out.trim().split('\n').slice(1); // skip header
-                const portRe = new RegExp(`:${port}\\s+\\(LISTEN\\)\\s*$`);
-                const match = lines.find((l) => portRe.test(l));
-                if (!match) {
-                    resolve({ inUse: false });
-                    return;
-                }
-                const cols = match.split(/\s+/);
-                resolve({ command: cols[0], inUse: true, pid: Number(cols[1]) });
-            });
-        });
-    });
-}
-/** Reset state file to an empty record. Called by `lt local down` after stopping processes. */
-function clearLocalState(projectPath) {
-    const path = localStatePath(projectPath);
-    if ((0, fs_1.existsSync)(path)) {
-        (0, fs_1.writeFileSync)(path, `${JSON.stringify({ pids: {}, ports: { api: 0, app: 0 }, startedAt: '' }, null, 2)}\n`, 'utf8');
-    }
-}
-/**
- * Check whether a PID is still alive without sending any signal.
- * `process.kill(pid, 0)` performs a permission check; ESRCH means dead.
- *
- * Refuses non-positive / non-integer PIDs to prevent accidental probes
- * of process groups (negative PID) or every user-owned process (PID 0/-1).
- */
-function isPidAlive(pid) {
-    if (!Number.isInteger(pid) || pid <= 0)
-        return false;
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch (e) {
-        return e.code === 'EPERM';
-    }
-}
-/**
- * Validate a value parsed from `state.json` as a plausible PID.
- *
- * Accepts: positive integer in [100, 2^31 - 1] or undefined.
- * The lower bound 100 excludes init / kernel / login PIDs that should
- * never be the result of a `pnpm start` spawn.
- */
-function isValidPid(value) {
-    if (value === undefined)
-        return true;
-    if (typeof value !== 'number')
-        return false;
-    return Number.isInteger(value) && value >= 100 && value <= 0x7fffffff;
-}
-/**
- * One-shot listener snapshot for an arbitrary set of ports.
- *
- * Issues a single `lsof -iTCP -sTCP:LISTEN -nP` call and filters in memory.
- * ~50ms total regardless of port count, vs ~50ms × N for sequential
- * {@link checkPortInUse} calls.
- *
- * Returns an empty Map if `lsof` is unavailable.
- */
-function listenSnapshot(ports) {
-    return __awaiter(this, void 0, void 0, function* () {
-        return new Promise((resolve) => {
-            var _a;
-            const child = (0, child_process_1.spawn)('lsof', ['-iTCP', '-sTCP:LISTEN', '-nP'], { stdio: ['ignore', 'pipe', 'ignore'] });
-            let out = '';
-            (_a = child.stdout) === null || _a === void 0 ? void 0 : _a.on('data', (chunk) => (out += chunk.toString()));
-            child.on('error', () => resolve(new Map()));
-            child.on('close', () => {
-                const wanted = new Set(ports);
-                const result = new Map();
-                const lines = out.trim().split('\n').slice(1);
-                const re = /:(\d+)\s+\(LISTEN\)\s*$/;
-                for (const line of lines) {
-                    const m = re.exec(line);
-                    if (!m)
-                        continue;
-                    const port = Number(m[1]);
-                    if (!wanted.has(port))
-                        continue;
-                    if (result.has(port))
-                        continue; // first hit wins (IPv4 before IPv6)
-                    const cols = line.split(/\s+/);
-                    result.set(port, { command: cols[0], pid: Number(cols[1]) });
-                }
-                resolve(result);
-            });
-        });
-    });
-}
-/**
- * Load the local state JSON for a project.
- *
- * Returns null when the file is missing, unreadable, malformed, or contains
- * structurally invalid data (see {@link isValidPid}). The schema validation
- * here is the authoritative gate: it prevents `process.kill(-pid, …)` in
- * `lt local down` from receiving anything but a plausible PID we ourselves
- * could have written.
- */
-function loadLocalState(projectPath) {
-    const path = localStatePath(projectPath);
-    if (!(0, fs_1.existsSync)(path))
-        return null;
-    try {
-        const parsed = JSON.parse((0, fs_1.readFileSync)(path, 'utf8'));
-        if (!parsed || typeof parsed !== 'object')
-            return null;
-        const obj = parsed;
-        const pids = obj.pids;
-        const ports = obj.ports;
-        if (!pids || typeof pids !== 'object' || !ports || typeof ports !== 'object')
-            return null;
-        if (!isValidPid(pids.api) || !isValidPid(pids.app))
-            return null;
-        if (typeof ports.api !== 'number' || typeof ports.app !== 'number')
-            return null;
-        if (typeof obj.startedAt !== 'string')
-            return null;
-        return {
-            pids: { api: pids.api, app: pids.app },
-            ports: { api: ports.api, app: ports.app },
-            startedAt: obj.startedAt,
-        };
-    }
-    catch (_a) {
-        return null;
-    }
-}
-/**
- * Load registry; returns empty if missing or corrupt.
- *
- * Prints a warning when a corrupt or schema-incompatible file is encountered
- * so the user notices the silent reset rather than discovering stale port
- * allocations later.
- */
-function loadRegistry() {
-    const path = registryPath();
-    if (!(0, fs_1.existsSync)(path)) {
-        return { projects: {}, version: 1 };
-    }
-    try {
-        const raw = (0, fs_1.readFileSync)(path, 'utf8');
-        const parsed = JSON.parse(raw);
-        if ((parsed === null || parsed === void 0 ? void 0 : parsed.version) !== 1 || typeof (parsed === null || parsed === void 0 ? void 0 : parsed.projects) !== 'object') {
-            console.warn(`[lt] ports.json has wrong schema (got version=${parsed === null || parsed === void 0 ? void 0 : parsed.version}); starting with empty registry.`);
-            return { projects: {}, version: 1 };
-        }
-        return parsed;
-    }
-    catch (e) {
-        console.warn(`[lt] ports.json was unreadable (${e.message}); starting with empty registry.`);
-        return { projects: {}, version: 1 };
-    }
-}
-/** Path to the local state file inside a project. */
-function localStatePath(projectPath) {
-    return (0, path_1.join)(projectPath, '.lt-local', 'state.json');
-}
-/** Convert a slot to its API+App port pair. */
-function portsForSlot(slot) {
-    const api = exports.SLOT_BASE_API + slot * exports.SLOT_STEP;
-    return { api, app: api + 1 };
-}
-/** Convert any project path → a stable slug (basename, lowercase, alpha-num + dashes). */
-function projectSlug(projectPath) {
-    const base = projectPath.replace(/\/+$/, '').split('/').pop() || 'project';
-    return base
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, '-')
-        .replace(/^-+|-+$/g, '');
-}
-/**
- * Path to the central registry.
- *
- * Honors `LT_PORTS_REGISTRY_PATH` for tests / non-default workspaces;
- * falls back to `~/.lenneTech/ports.json`.
- */
-function registryPath() {
-    return process.env.LT_PORTS_REGISTRY_PATH || (0, path_1.join)((0, os_1.homedir)(), '.lenneTech', 'ports.json');
-}
-/** Persist local state to <project>/.lt-local/state.json (creates the parent directory if needed). */
-function saveLocalState(projectPath, state) {
-    const path = localStatePath(projectPath);
-    (0, fs_1.mkdirSync)((0, path_1.dirname)(path), { recursive: true });
-    (0, fs_1.writeFileSync)(path, `${JSON.stringify(state, null, 2)}\n`, 'utf8');
-}
-/** Save registry, creating parent directory if needed. */
-function saveRegistry(registry) {
-    const path = registryPath();
-    (0, fs_1.mkdirSync)((0, path_1.dirname)(path), { recursive: true });
-    (0, fs_1.writeFileSync)(path, `${JSON.stringify(registry, null, 2)}\n`, 'utf8');
-}
-/**
- * Deterministic slot from project slug — same slug yields the same slot on every machine.
- * Uses the lower 32 bits of FNV-1a then modulo SLOT_MAX.
- */
-function slotFromSlug(slug) {
-    let hash = 2166136261; // FNV-1a 32-bit offset basis
-    for (let i = 0; i < slug.length; i++) {
-        hash ^= slug.charCodeAt(i);
-        hash = Math.imul(hash, 16777619);
-    }
-    return Math.abs(hash | 0) % exports.SLOT_MAX;
-}