ports-manager 1.0.0

package/dist/bridge/src/extension.js

@@ -0,0 +1,133 @@
+"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 });
+exports.activate = activate;
+exports.deactivate = deactivate;
+const vscode = __importStar(require("vscode"));
+const crypto = __importStar(require("node:crypto"));
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const server_1 = require("./server");
+let bridge;
+let descriptorFile;
+let activeToken;
+function writeDescriptor(port, token) {
+    const directory = path.join(os.homedir(), '.ports-manager');
+    const filename = path.join(directory, 'bridge.json');
+    fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
+    try {
+        fs.chmodSync(directory, 0o700);
+    }
+    catch {
+        // Windows ACLs do not map directly to POSIX modes.
+    }
+    const temporary = path.join(directory, `.bridge-${process.pid}-${crypto.randomBytes(6).toString('hex')}.tmp`);
+    const payload = JSON.stringify({
+        endpoint: `http://127.0.0.1:${port}/`,
+        token,
+        pid: process.pid
+    });
+    fs.writeFileSync(temporary, payload, { encoding: 'utf8', mode: 0o600, flag: 'wx' });
+    try {
+        fs.renameSync(temporary, filename);
+    }
+    catch (error) {
+        if (process.platform !== 'win32') {
+            fs.rmSync(temporary, { force: true });
+            throw error;
+        }
+        fs.rmSync(filename, { force: true });
+        fs.renameSync(temporary, filename);
+    }
+    try {
+        fs.chmodSync(filename, 0o600);
+    }
+    catch {
+        // Best effort on Windows.
+    }
+    return filename;
+}
+function removeOwnDescriptor() {
+    if (!descriptorFile || !activeToken)
+        return;
+    try {
+        const current = JSON.parse(fs.readFileSync(descriptorFile, 'utf8'));
+        if (current.token === activeToken)
+            fs.rmSync(descriptorFile, { force: true });
+    }
+    catch {
+        // Already removed or replaced.
+    }
+}
+async function activate(context) {
+    const token = crypto.randomBytes(32).toString('hex');
+    activeToken = token;
+    const host = {
+        create(spec) {
+            return vscode.window.createTerminal({
+                name: spec.name,
+                cwd: spec.cwd,
+                env: spec.env,
+                isTransient: true
+            });
+        }
+    };
+    bridge = new server_1.BridgeServer(token, host);
+    try {
+        const port = await bridge.listen();
+        descriptorFile = writeDescriptor(port, token);
+    }
+    catch (error) {
+        await bridge.close();
+        bridge = undefined;
+        activeToken = undefined;
+        vscode.window.showErrorMessage(`Ports Manager bridge failed to start: ${error instanceof Error ? error.message : error}`);
+        return;
+    }
+    context.subscriptions.push(vscode.window.onDidCloseTerminal((terminal) => bridge?.forget(terminal)), vscode.commands.registerCommand('ports-manager.stopAll', () => {
+        const count = bridge?.stopAll() || 0;
+        vscode.window.showInformationMessage(`Stopped ${count} Ports Manager terminal${count === 1 ? '' : 's'}.`);
+    }));
+}
+async function deactivate() {
+    removeOwnDescriptor();
+    if (bridge)
+        await bridge.close();
+    bridge = undefined;
+    activeToken = undefined;
+    descriptorFile = undefined;
+}
+//# sourceMappingURL=extension.js.map

package/dist/bridge/src/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../../../bridge/src/extension.ts"],"names":[],"mappings":"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"}

package/dist/bridge/src/server.js

@@ -0,0 +1,202 @@
+"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 });
+exports.BridgeServer = void 0;
+exports.validateLaunchBody = validateLaunchBody;
+const http = __importStar(require("node:http"));
+const node_crypto_1 = require("node:crypto");
+const MAX_BODY = 64 * 1024;
+function plainObject(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+function shortString(value, maximum = 4096) {
+    return typeof value === 'string' && value.length > 0 && value.length <= maximum;
+}
+function validateLaunchBody(value) {
+    if (!plainObject(value) || !shortString(value.tag, 1024) ||
+        !Array.isArray(value.terminals) || value.terminals.length < 1 || value.terminals.length > 8) {
+        throw new Error('invalid terminal launch body');
+    }
+    const terminals = value.terminals.map((candidate) => {
+        if (!plainObject(candidate) || !shortString(candidate.name, 200) ||
+            !shortString(candidate.cwd, 4096) || !shortString(candidate.command, 16384) ||
+            !plainObject(candidate.env)) {
+            throw new Error('invalid terminal specification');
+        }
+        const env = {};
+        for (const [key, item] of Object.entries(candidate.env)) {
+            if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key) || typeof item !== 'string' || item.length > 16384) {
+                throw new Error('invalid terminal environment');
+            }
+            env[key] = item;
+        }
+        return { name: candidate.name, cwd: candidate.cwd, command: candidate.command, env };
+    });
+    return { tag: value.tag, terminals };
+}
+function validateStopBody(value) {
+    if (!plainObject(value) || !shortString(value.tag, 1024))
+        throw new Error('invalid stop body');
+    return { tag: value.tag };
+}
+function isLoopback(address) {
+    return address === '127.0.0.1' || address === '::1' || address === '::ffff:127.0.0.1';
+}
+function authorized(header, token) {
+    if (!header?.startsWith('Bearer '))
+        return false;
+    const supplied = Buffer.from(header.slice(7));
+    const expected = Buffer.from(token);
+    return supplied.length === expected.length && (0, node_crypto_1.timingSafeEqual)(supplied, expected);
+}
+async function readJson(request) {
+    if (!String(request.headers['content-type'] || '').toLowerCase().startsWith('application/json')) {
+        throw new Error('content-type must be application/json');
+    }
+    const chunks = [];
+    let size = 0;
+    for await (const chunk of request) {
+        const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        size += buffer.length;
+        if (size > MAX_BODY)
+            throw new Error('request body too large');
+        chunks.push(buffer);
+    }
+    return JSON.parse(Buffer.concat(chunks).toString('utf8'));
+}
+function send(response, status, body) {
+    const payload = JSON.stringify(body);
+    response.writeHead(status, {
+        'Content-Type': 'application/json',
+        'Content-Length': Buffer.byteLength(payload),
+        'Cache-Control': 'no-store'
+    });
+    response.end(payload);
+}
+class BridgeServer {
+    token;
+    host;
+    server;
+    tracked = new Map();
+    constructor(token, host) {
+        this.token = token;
+        this.host = host;
+    }
+    async listen() {
+        if (this.server)
+            throw new Error('bridge already listening');
+        this.server = http.createServer((request, response) => void this.handle(request, response));
+        await new Promise((resolve, reject) => {
+            this.server.once('error', reject);
+            this.server.listen(0, '127.0.0.1', resolve);
+        });
+        const address = this.server.address();
+        if (!address || typeof address === 'string')
+            throw new Error('bridge failed to bind');
+        return address.port;
+    }
+    async handle(request, response) {
+        try {
+            if (!isLoopback(request.socket.remoteAddress))
+                return send(response, 403, { error: 'loopback only' });
+            if (!authorized(request.headers.authorization, this.token))
+                return send(response, 401, { error: 'unauthorized' });
+            if (request.method !== 'POST')
+                return send(response, 405, { error: 'POST required' });
+            const body = await readJson(request);
+            if (request.url === '/terminals') {
+                const launch = validateLaunchBody(body);
+                this.stopTag(launch.tag);
+                const terminals = new Set();
+                try {
+                    for (const spec of launch.terminals) {
+                        const terminal = this.host.create(spec);
+                        terminals.add(terminal);
+                        terminal.show(true);
+                        terminal.sendText(spec.command, true);
+                    }
+                }
+                catch (error) {
+                    for (const terminal of terminals)
+                        terminal.dispose();
+                    throw error;
+                }
+                this.tracked.set(launch.tag, terminals);
+                return send(response, 201, { created: terminals.size });
+            }
+            if (request.url === '/stop') {
+                const stop = validateStopBody(body);
+                const stopped = this.stopTag(stop.tag);
+                return send(response, 200, { stopped });
+            }
+            return send(response, 404, { error: 'not found' });
+        }
+        catch (error) {
+            return send(response, 400, { error: error instanceof Error ? error.message : 'bad request' });
+        }
+    }
+    forget(terminal) {
+        for (const [tag, terminals] of this.tracked) {
+            terminals.delete(terminal);
+            if (!terminals.size)
+                this.tracked.delete(tag);
+        }
+    }
+    stopTag(tag) {
+        const terminals = this.tracked.get(tag);
+        if (!terminals)
+            return 0;
+        this.tracked.delete(tag);
+        for (const terminal of terminals)
+            terminal.dispose();
+        return terminals.size;
+    }
+    stopAll() {
+        let count = 0;
+        for (const tag of [...this.tracked.keys()])
+            count += this.stopTag(tag);
+        return count;
+    }
+    async close() {
+        this.stopAll();
+        if (!this.server)
+            return;
+        const server = this.server;
+        this.server = undefined;
+        await new Promise((resolve) => server.close(() => resolve()));
+    }
+}
+exports.BridgeServer = BridgeServer;
+//# sourceMappingURL=server.js.map

package/dist/bridge/src/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../bridge/src/server.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "ports-manager",
+  "version": "1.0.0",
+  "displayName": "Ports Manager",
+  "publisher": "SENODROOM",
+  "author": "Muhammad Saad Amin",
+  "description": "Launch paired frontend/backend projects on free ports with CORS handling and optional VS Code/Cursor terminals.",
+  "main": "./dist/bridge/src/extension.js",
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "bin": {
+    "ports-manager": "bin/ports-manager.js"
+  },
+  "type": "commonjs",
+  "engines": {
+    "node": ">=18",
+    "vscode": "^1.85.0"
+  },
+  "categories": [
+    "Other"
+  ],
+  "activationEvents": [
+    "onStartupFinished"
+  ],
+  "contributes": {
+    "commands": [
+      {
+        "command": "ports-manager.stopAll",
+        "title": "Ports Manager: Stop All Managed Terminals"
+      }
+    ]
+  },
+  "scripts": {
+    "compile:bridge": "tsc -p tsconfig.bridge.json",
+    "test": "npm run test:cli && npm run test:bridge",
+    "test:cli": "node --test test/core.test.js test/cors.integration.test.js test/process.integration.test.js",
+    "test:bridge": "npm run compile:bridge && node --test dist/bridge/test/server.test.js",
+    "package:vsix": "npm run compile:bridge && vsce package --allow-missing-repository",
+    "package:ovsx": "npm run package:vsix",
+    "publish:ovsx": "ovsx publish",
+    "prepack": "npm run compile:bridge",
+    "start": "node bin/ports-manager.js"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "cosmiconfig": "^9.0.0",
+    "jsonc-parser": "^3.3.1",
+    "tree-kill": "^1.2.2"
+  },
+  "optionalDependencies": {
+    "http-proxy-middleware": "^3.0.5"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "@types/vscode": "^1.85.0",
+    "@vscode/vsce": "^3.2.2",
+    "ovsx": "^0.10.1",
+    "typescript": "^5.7.2"
+  },
+  "keywords": [
+    "ports",
+    "mern",
+    "cli",
+    "vscode",
+    "cursor",
+    "cors",
+    "dev-server"
+  ],
+  "license": "MIT",
+  "directories": {
+    "test": "test"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SENODROOM/ports-manager.git"
+  },
+  "bugs": {
+    "url": "https://github.com/SENODROOM/ports-manager/issues"
+  },
+  "homepage": "https://github.com/SENODROOM/ports-manager#readme"
+}

package/src/bridge-client.js

@@ -0,0 +1,81 @@
+'use strict';
+
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+const http = require('node:http');
+const { terminalCommand } = require('./ide');
+
+function descriptorPath() {
+  return path.join(os.homedir(), '.ports-manager', 'bridge.json');
+}
+
+function readDescriptor(filename = descriptorPath()) {
+  let descriptor;
+  try {
+    descriptor = JSON.parse(fs.readFileSync(filename, 'utf8'));
+  } catch (error) {
+    throw new Error(`bridge descriptor unavailable at ${filename}: ${error.message}`);
+  }
+  const endpoint = new URL(descriptor.endpoint);
+  if (endpoint.protocol !== 'http:' ||
+      !['127.0.0.1', 'localhost', '[::1]'].includes(endpoint.hostname)) {
+    throw new Error('bridge endpoint must be loopback HTTP');
+  }
+  if (typeof descriptor.token !== 'string' || descriptor.token.length < 32) {
+    throw new Error('bridge descriptor has an invalid token');
+  }
+  return { endpoint, token: descriptor.token };
+}
+
+function requestBridge(route, body, descriptor = readDescriptor()) {
+  const payload = Buffer.from(JSON.stringify(body));
+  return new Promise((resolve, reject) => {
+    const request = http.request(new URL(route, descriptor.endpoint), {
+      method: 'POST',
+      headers: {
+        Authorization: `Bearer ${descriptor.token}`,
+        'Content-Type': 'application/json',
+        'Content-Length': payload.length
+      },
+      timeout: 2500
+    }, (response) => {
+      let output = '';
+      response.setEncoding('utf8');
+      response.on('data', (chunk) => { output += chunk; });
+      response.on('end', () => {
+        if (response.statusCode < 200 || response.statusCode >= 300) {
+          reject(new Error(`bridge returned ${response.statusCode}: ${output}`));
+        } else {
+          resolve(output ? JSON.parse(output) : {});
+        }
+      });
+    });
+    request.on('timeout', () => request.destroy(new Error('bridge request timed out')));
+    request.on('error', (error) => reject(new Error(`bridge unavailable: ${error.message}`)));
+    request.end(payload);
+  });
+}
+
+function toTerminal(spec) {
+  return {
+    name: `Ports Manager ${spec.name}`,
+    cwd: spec.cwd,
+    env: spec.env,
+    command: terminalCommand(spec)
+  };
+}
+
+async function launchInBridge(specs, proxySpec, tag) {
+  const terminals = [toTerminal(specs.backend), toTerminal(specs.frontend)];
+  if (proxySpec) terminals.push(toTerminal(proxySpec));
+  return requestBridge('/terminals', { tag, terminals });
+}
+
+async function stopBridge(tag) {
+  return requestBridge('/stop', { tag });
+}
+
+module.exports = {
+  descriptorPath, launchInBridge, readDescriptor, requestBridge, stopBridge, toTerminal
+};