portmore 1.0.0

package/README.md

@@ -0,0 +1,52 @@
+# portmore
+
+Local multi-service helper with automatic free ports, `portless` aliases, and a small dashboard.
+
+> Disclaimer: Primarily coded by Codex, worktree/branch naming not supported, https not tested.
+
+## Requirements
+
+- Node.js 22+
+- [`portless`](https://github.com/vercel-labs/portless) installed and available in `PATH`
+
+## Install
+
+```bash
+npm install portmore
+```
+
+## Quick usage
+
+```ts
+import { createServer } from "node:http";
+import { portmore } from "portmore";
+
+await portmore({
+  name: "server-a",
+  title: "Server A",
+  metrics: async () => ({ visits: 42 }),
+  start: async (port) => {
+    const server = createServer((_, res) => {
+      res.statusCode = 200;
+      res.end("Server A\n");
+    });
+
+    return server.listen(port);
+  },
+  stop: async (server) => {
+    await new Promise<void>((resolve, reject) => {
+      server.close((err) => {
+        if (err) {
+          reject(err);
+          return;
+        }
+        resolve();
+      });
+    });
+  },
+});
+```
+
+## Dashboard
+
+![Portmore Dashboard](./docs/dashboard.png)

package/dist/dashboard.d.ts

@@ -0,0 +1,2 @@
+export declare function startDashboard(): Promise<void>;
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../src/dashboard.ts"],"names":[],"mappings":"AAqrBA,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAwDpD"}

package/dist/dashboard.js

@@ -0,0 +1,724 @@
+import { serve } from "@hono/node-server";
+import { Hono } from "hono";
+import { portless } from "./portless.js";
+import { findFreePort } from "./find-free-port.js";
+import { aliases, toggleAlias } from "./index.js";
+function escapeHtml(value) {
+    return value
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&#39;");
+}
+function formatStartTime(input) {
+    return input.toLocaleTimeString("en-US", {
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+        hour12: true,
+    });
+}
+function isSvgMarkup(value) {
+    return /^\s*<svg[\s>]/i.test(value);
+}
+function svgToDataUri(svg) {
+    const encoded = Buffer.from(svg, "utf8").toString("base64");
+    return `data:image/svg+xml;base64,${encoded}`;
+}
+function dashboardFaviconSvg() {
+    return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="Portmore">
+    <rect width="64" height="64" rx="14" fill="#0f1724"/>
+    <circle cx="32" cy="32" r="18" fill="#35b6ff"/>
+    <circle cx="32" cy="32" r="8" fill="#0f1724"/>
+  </svg>`;
+}
+function renderIcon(icon) {
+    if (!icon) {
+        return `<span class="service-icon" aria-hidden="true">◉</span>`;
+    }
+    if (isSvgMarkup(icon)) {
+        const src = escapeHtml(svgToDataUri(icon));
+        return `<img class="service-icon service-icon-svg" src="${src}" alt="" aria-hidden="true" />`;
+    }
+    return `<span class="service-icon" aria-hidden="true">${escapeHtml(icon)}</span>`;
+}
+async function resolveAliasMetrics(alias) {
+    if (!alias.metrics) {
+        return {};
+    }
+    try {
+        return await alias.metrics();
+    }
+    catch {
+        return { Status: "error" };
+    }
+}
+async function renderAliases(aliases) {
+    const renderedRows = await Promise.all(aliases.map(async (alias) => {
+        const escapedName = escapeHtml(alias.name);
+        const escapedTitle = escapeHtml(alias.title);
+        const renderedIcon = renderIcon(alias.icon);
+        const localUrl = await portless.getUrl(alias.name).catch(() => `http://localhost:${alias.port}`);
+        const startedAt = alias.started;
+        const metricsRecord = await resolveAliasMetrics(alias);
+        const metricsCount = Object.keys(metricsRecord).length;
+        let statusClass;
+        let statusText;
+        switch (alias.status) {
+            case "Starting":
+                statusClass = "warning";
+                statusText = "Starting";
+                break;
+            case "Running":
+                statusClass = "running";
+                statusText = "Running";
+                break;
+            case "Stopping":
+                statusClass = "warning";
+                statusText = "Stopping";
+                break;
+            case "Stopped":
+                statusClass = "muted";
+                statusText = "Stopped";
+                break;
+            case "Error":
+                statusClass = "error";
+                statusText = "Error";
+                break;
+            default:
+                statusClass = "muted";
+                statusText = "Unknown";
+                break;
+        }
+        const isBusy = alias.status === "Starting" || alias.status === "Stopping";
+        const toggleLabel = alias.status === "Running" ? "Stop" : "Start";
+        const toggleAttributes = isBusy
+            ? "disabled aria-disabled=\"true\""
+            : "";
+        return {
+            row: `<tr class="service-row" tabindex="0" role="button" data-service-name="${escapedName}" data-service-title="${escapedTitle}" data-metrics-count="${metricsCount}">
+        <td>
+          <div class="service-name">
+            ${renderedIcon}
+            <strong>${escapedTitle}</strong>
+          </div>
+        </td>
+        <td>
+          <span class="pill ${statusClass}">${statusText}</span>
+        </td>
+        <td>${startedAt ? formatStartTime(startedAt) : ""}</td>
+        <td><code>${alias.port}</code></td>
+        <td>
+          <a href="${localUrl}" target="_blank" rel="noopener noreferrer">${localUrl}</a>
+        </td>
+        <td>
+          <div class="actions">
+            <button type="button" class="action-btn" data-toggle-service="${escapedName}" ${toggleAttributes}>${toggleLabel}</button>
+            <a href="${localUrl}" class="action-btn" target="_blank" rel="noopener noreferrer">Open</a>
+          </div>
+        </td>
+        </tr>`,
+        };
+    }));
+    const envPortlessUrl = process.env.PORTLESS_URL?.trim();
+    if (envPortlessUrl) {
+        let envName = "PORTLESS_URL";
+        try {
+            const parsedUrl = new URL(envPortlessUrl);
+            const labels = parsedUrl.hostname.split(".");
+            if (labels.length > 1) {
+                envName = labels.slice(0, -1).join(".");
+            }
+            else if (labels[0]) {
+                envName = labels[0];
+            }
+        }
+        catch {
+            // Keep fallback label when PORTLESS_URL is not a valid absolute URL.
+        }
+        renderedRows.unshift({
+            row: `<tr>
+        <td>
+          <div class="service-name">
+            <strong>${envName}</strong>
+          </div>
+        </td>
+        <td>
+          <span class="pill muted">Main</span>
+        </td>
+        <td></td>
+        <td></td>
+        <td>
+          <a href="${envPortlessUrl}" target="_blank" rel="noopener noreferrer">${envPortlessUrl}</a>
+        </td>
+        <td>
+          <div class="actions">
+            <a href="${envPortlessUrl}" class="action-btn" target="_blank" rel="noopener noreferrer">Open</a>
+          </div>
+        </td>
+      </tr>`,
+        });
+    }
+    const rows = renderedRows.map((entry) => entry.row).join("\n");
+    return `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <link rel="icon" href="/favicon.ico" type="image/svg+xml" />
+    <title>Portmore Dashboard</title>
+    <style>
+      :root {
+        color-scheme: dark;
+        --bg-0: #070a0f;
+        --bg-1: #0c1320;
+        --bg-2: #111a28;
+        --line: #273347;
+        --text-0: #e9edf6;
+        --text-1: #b5bfd2;
+        --accent: #35b6ff;
+        --running-bg: #15372b;
+        --running-fg: #67e6ad;
+        --starting-bg: #3d2b18;
+        --starting-fg: #ffbf73;
+        --muted-bg: #1f2937;
+        --muted-fg: #a7b3c9;
+        --error-bg: #3a1b24;
+        --error-fg: #ff8ba4;
+      }
+
+      * {
+        box-sizing: border-box;
+      }
+
+      body {
+        margin: 0;
+        min-height: 100vh;
+        font-family: "Space Grotesk", "Avenir Next", "Segoe UI", sans-serif;
+        color: var(--text-0);
+        background:
+          radial-gradient(circle at 12% 0%, #133657 0%, transparent 44%),
+          radial-gradient(circle at 88% 100%, #0f3e33 0%, transparent 36%),
+          linear-gradient(180deg, var(--bg-0) 0%, var(--bg-1) 60%, var(--bg-0) 100%);
+      }
+
+      .layout {
+        max-width: 1100px;
+        margin: 0 auto;
+        padding: 44px 20px 70px;
+      }
+
+      .header {
+        display: flex;
+        flex-wrap: wrap;
+        gap: 14px;
+        align-items: end;
+        justify-content: space-between;
+        margin-bottom: 20px;
+      }
+
+      .title {
+        margin: 0;
+        font-size: clamp(1.8rem, 2.4vw, 2.5rem);
+        letter-spacing: 0.02em;
+      }
+
+      .subtitle {
+        margin: 7px 0 0;
+        color: var(--text-1);
+      }
+
+      .kpi {
+        border: 1px solid var(--line);
+        background: linear-gradient(180deg, rgba(255, 255, 255, 0.04), transparent);
+        padding: 10px 14px;
+        border-radius: 12px;
+        min-width: 160px;
+      }
+
+      .kpi-label {
+        display: block;
+        font-size: 0.78rem;
+        text-transform: uppercase;
+        letter-spacing: 0.08em;
+        color: var(--text-1);
+      }
+
+      .kpi-value {
+        display: block;
+        font-size: 1.35rem;
+        margin-top: 4px;
+      }
+
+      .table-shell {
+        border: 1px solid var(--line);
+        border-radius: 16px;
+        overflow: hidden;
+        background: linear-gradient(180deg, rgba(255, 255, 255, 0.04), rgba(255, 255, 255, 0.01));
+        box-shadow: 0 18px 44px rgba(0, 0, 0, 0.35);
+      }
+
+      table {
+        width: 100%;
+        border-collapse: collapse;
+      }
+
+      thead th {
+        text-align: left;
+        font-size: 0.77rem;
+        text-transform: uppercase;
+        letter-spacing: 0.09em;
+        color: var(--text-1);
+        background: var(--bg-2);
+        border-bottom: 1px solid var(--line);
+        padding: 14px 16px;
+      }
+
+      tbody td {
+        border-bottom: 1px solid rgba(74, 91, 118, 0.35);
+        padding: 15px 16px;
+        vertical-align: middle;
+        font-size: 0.95rem;
+      }
+
+      tbody tr:last-child td {
+        border-bottom: none;
+      }
+
+      tbody tr:hover {
+        background: rgba(56, 71, 94, 0.26);
+      }
+
+      .service-name {
+        display: inline-flex;
+        gap: 10px;
+        align-items: center;
+      }
+
+      .service-row {
+        cursor: pointer;
+        outline: none;
+      }
+
+      .service-row:focus,
+      .service-row:focus-visible,
+      .service-row:active {
+        outline: none;
+        box-shadow: none;
+      }
+
+      .service-row:hover .service-name strong {
+        color: #9fdcff;
+        text-decoration: underline;
+        text-underline-offset: 3px;
+      }
+
+      .service-icon {
+        width: 26px;
+        height: 26px;
+        border-radius: 999px;
+        display: inline-flex;
+        align-items: center;
+        justify-content: center;
+        font-size: 0.95rem;
+        line-height: 1;
+      }
+
+      .service-icon-svg {
+        display: inline-block;
+        object-fit: contain;
+      }
+
+      .pill {
+        display: inline-flex;
+        align-items: center;
+        gap: 8px;
+        font-size: 0.84rem;
+        padding: 4px 10px;
+        border-radius: 999px;
+        border: 1px solid transparent;
+      }
+
+      .pill::before {
+        content: "";
+        width: 7px;
+        height: 7px;
+        border-radius: 999px;
+        background: currentColor;
+        opacity: 0.9;
+      }
+
+      .pill.running {
+        color: var(--running-fg);
+        background: var(--running-bg);
+        border-color: rgba(103, 230, 173, 0.22);
+      }
+
+      .pill.warning {
+        color: var(--starting-fg);
+        background: var(--starting-bg);
+        border-color: rgba(255, 191, 115, 0.2);
+      }
+
+      .pill.muted {
+        color: var(--muted-fg);
+        background: var(--muted-bg);
+        border-color: rgba(167, 179, 201, 0.25);
+      }
+
+      .pill.error {
+        color: var(--error-fg);
+        background: var(--error-bg);
+        border-color: rgba(255, 139, 164, 0.28);
+      }
+
+      code {
+        font-family: "Iosevka", "SF Mono", Menlo, monospace;
+        font-size: 0.84rem;
+        color: #c8d3e5;
+      }
+
+      a {
+        color: #7bd0ff;
+      }
+
+      .meta {
+        margin-left: 8px;
+        font-size: 0.78rem;
+        color: var(--text-1);
+        background: rgba(95, 131, 180, 0.2);
+        border: 1px solid rgba(95, 131, 180, 0.35);
+        border-radius: 999px;
+        padding: 2px 7px;
+      }
+
+      .actions {
+        display: inline-flex;
+        gap: 8px;
+      }
+
+      .action-btn {
+        appearance: none;
+        border: 1px solid var(--line);
+        border-radius: 8px;
+        padding: 6px 10px;
+        font: inherit;
+        color: var(--text-0);
+        text-decoration: none;
+        background: rgba(255, 255, 255, 0.03);
+        cursor: pointer;
+      }
+
+      .action-btn:hover {
+        border-color: #4b86ab;
+        background: rgba(53, 182, 255, 0.15);
+      }
+
+      .metrics-dialog {
+        border: 1px solid rgba(95, 131, 180, 0.38);
+        border-radius: 14px;
+        padding: 0;
+        width: min(560px, calc(100vw - 32px));
+        background: #0f1724;
+        color: var(--text-0);
+        box-shadow: 0 26px 50px rgba(0, 0, 0, 0.45);
+      }
+
+      .metrics-dialog::backdrop {
+        background: rgba(2, 7, 12, 0.62);
+        backdrop-filter: blur(2px);
+      }
+
+      .metrics-dialog-header {
+        display: flex;
+        justify-content: space-between;
+        align-items: center;
+        padding: 14px 16px;
+        border-bottom: 1px solid rgba(95, 131, 180, 0.25);
+      }
+
+      .metrics-dialog-title {
+        margin: 0;
+        font-size: 1.02rem;
+        color: #b7ddf4;
+      }
+
+      .metrics-dialog-close {
+        appearance: none;
+        border: 1px solid rgba(95, 131, 180, 0.45);
+        background: rgba(95, 131, 180, 0.14);
+        color: var(--text-0);
+        border-radius: 8px;
+        padding: 4px 9px;
+        cursor: pointer;
+      }
+
+      .metrics-grid {
+        display: grid;
+        gap: 8px;
+        grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));
+        padding: 14px 16px 16px;
+      }
+
+      .metric-item {
+        border: 1px solid rgba(95, 131, 180, 0.28);
+        border-radius: 8px;
+        padding: 8px 10px;
+        background: rgba(95, 131, 180, 0.08);
+      }
+
+      .metric-item span {
+        display: block;
+        color: var(--text-1);
+        font-size: 0.78rem;
+        margin-bottom: 4px;
+      }
+
+      .metric-item strong {
+        font-size: 1rem;
+        color: var(--text-0);
+      }
+
+      .empty {
+        padding: 34px 18px;
+        color: var(--text-1);
+      }
+
+      @media (max-width: 840px) {
+        .layout {
+          padding-top: 24px;
+        }
+
+        .table-shell {
+          overflow-x: auto;
+        }
+
+        table {
+          min-width: 800px;
+        }
+      }
+    </style>
+  </head>
+  <body>
+    <main class="layout">
+      <header class="header">
+        <div>
+          <h1 class="title">Portmore Dashboard</h1>
+          <p class="subtitle">Live alias routing map for local development targets.</p>
+        </div>
+      </header>
+
+      <section class="table-shell">
+        <table>
+          <thead>
+            <tr>
+              <th>Name</th>
+              <th>Status</th>
+              <th>Start Time</th>
+              <th>Port</th>
+              <th>URL</th>
+              <th>Actions</th>
+            </tr>
+          </thead>
+          <tbody>${rows || `<tr><td colspan="6" class="empty">No aliases yet. Start a service with portmore to populate this table.</td></tr>`}</tbody>
+        </table>
+      </section>
+    </main>
+
+    <dialog class="metrics-dialog" id="metrics-dialog">
+      <header class="metrics-dialog-header">
+        <h2 class="metrics-dialog-title" id="metrics-dialog-title">Service metrics</h2>
+        <button type="button" class="metrics-dialog-close" id="metrics-dialog-close">Close</button>
+      </header>
+      <section id="metrics-dialog-content"></section>
+    </dialog>
+
+    <script>
+      const metricsDialog = document.getElementById("metrics-dialog");
+      const metricsDialogTitle = document.getElementById("metrics-dialog-title");
+      const metricsDialogContent = document.getElementById("metrics-dialog-content");
+      const metricsDialogClose = document.getElementById("metrics-dialog-close");
+
+      if (
+        metricsDialog instanceof HTMLDialogElement &&
+        metricsDialogTitle instanceof HTMLElement &&
+        metricsDialogContent instanceof HTMLElement
+      ) {
+        const renderMetricsGrid = (metrics) => {
+          const entries = Object.entries(metrics || {});
+
+          if (entries.length === 0) {
+            return '<div class="metric-item"><span>Status</span><strong>No metrics available</strong></div>';
+          }
+
+          return entries
+            .map(([key, value]) => {
+              const safeKey = String(key)
+                .replace(/&/g, "&amp;")
+                .replace(/</g, "&lt;")
+                .replace(/>/g, "&gt;")
+                .replace(/"/g, "&quot;")
+                .replace(/'/g, "&#39;");
+
+              const normalizedValue = typeof value === "object" && value !== null
+                ? JSON.stringify(value)
+                : String(value);
+
+              const safeValue = normalizedValue
+                .replace(/&/g, "&amp;")
+                .replace(/</g, "&lt;")
+                .replace(/>/g, "&gt;")
+                .replace(/"/g, "&quot;")
+                .replace(/'/g, "&#39;");
+
+              return '<div class="metric-item"><span>' + safeKey + '</span><strong>' + safeValue + '</strong></div>';
+            })
+            .join("");
+        };
+
+        const openMetricsDialog = async (row) => {
+          const serviceName = row.getAttribute("data-service-name") || "Service";
+          const serviceTitle = row.getAttribute("data-service-title") || serviceName;
+
+          metricsDialogTitle.textContent = serviceTitle + " metrics";
+          metricsDialogContent.innerHTML = '<div class="metrics-grid"><div class="metric-item"><span>Status</span><strong>Loading...</strong></div></div>';
+          metricsDialog.showModal();
+
+          try {
+            const response = await fetch("/aliases/" + encodeURIComponent(serviceName) + "/metrics");
+            if (!response.ok) {
+              metricsDialogContent.innerHTML = '<div class="metrics-grid"><div class="metric-item"><span>Status</span><strong>Failed to load metrics</strong></div></div>';
+              return;
+            }
+
+            const payload = await response.json();
+            const metrics = payload && typeof payload === "object" && payload.metrics && typeof payload.metrics === "object"
+              ? payload.metrics
+              : {};
+
+            metricsDialogTitle.textContent = serviceTitle + " metrics";
+            metricsDialogContent.innerHTML = '<div class="metrics-grid">' + renderMetricsGrid(metrics) + '</div>';
+          } catch {
+            metricsDialogContent.innerHTML = '<div class="metrics-grid"><div class="metric-item"><span>Status</span><strong>Failed to load metrics</strong></div></div>';
+          }
+        };
+
+        document.querySelectorAll(".service-row[data-service-name]").forEach((row) => {
+          row.addEventListener("click", (event) => {
+            const target = event.target;
+            if (target instanceof Element && target.closest("a, button")) {
+              return;
+            }
+
+            void openMetricsDialog(row);
+          });
+
+          row.addEventListener("keydown", (event) => {
+            if (event.key !== "Enter" && event.key !== " ") {
+              return;
+            }
+
+            const target = event.target;
+            if (target instanceof Element && target.closest("a, button")) {
+              return;
+            }
+
+            event.preventDefault();
+            void openMetricsDialog(row);
+          });
+        });
+
+        if (metricsDialogClose instanceof HTMLButtonElement) {
+          metricsDialogClose.addEventListener("click", () => {
+            metricsDialog.close();
+          });
+        }
+      }
+
+      document.querySelectorAll(".action-btn[data-toggle-service]").forEach((button) => {
+        button.addEventListener("click", async () => {
+          const serviceName = button.getAttribute("data-toggle-service");
+          if (!serviceName) {
+            return;
+          }
+
+          button.setAttribute("disabled", "true");
+
+          try {
+            const response = await fetch("/aliases/" + encodeURIComponent(serviceName) + "/toggle", {
+              method: "POST",
+            });
+
+            if (!response.ok) {
+              button.textContent = "Failed";
+              setTimeout(() => {
+                window.location.reload();
+              }, 500);
+              return;
+            }
+
+            window.location.reload();
+          } catch {
+            button.textContent = "Failed";
+            setTimeout(() => {
+              window.location.reload();
+            }, 500);
+          }
+        });
+      });
+    </script>
+  </body>
+</html>`;
+}
+export async function startDashboard() {
+    const app = new Hono();
+    app.get("/", async (c) => c.html(await renderAliases(aliases)));
+    app.get("/favicon.ico", () => {
+        return new Response(dashboardFaviconSvg(), {
+            headers: {
+                "content-type": "image/svg+xml; charset=utf-8",
+                "cache-control": "public, max-age=86400",
+            },
+        });
+    });
+    app.get("/aliases", (c) => c.json(aliases));
+    app.get("/aliases/:name/metrics", async (c) => {
+        const name = c.req.param("name");
+        const alias = aliases.find((entry) => entry.name === name);
+        if (!alias) {
+            return c.json({ ok: false, error: `Alias ${name} not found` }, 404);
+        }
+        const metrics = await resolveAliasMetrics(alias);
+        return c.json({ ok: true, metrics });
+    });
+    app.post("/aliases/:name/toggle", async (c) => {
+        const name = c.req.param("name");
+        const alias = aliases.find((entry) => entry.name === name);
+        if (!alias) {
+            return c.json({ ok: false, error: `Alias ${name} not found` }, 404);
+        }
+        try {
+            await toggleAlias(alias);
+            return c.json({ ok: true, status: alias.status });
+        }
+        catch (error) {
+            alias.status = "Error";
+            const message = error instanceof Error ? error.message : "Unknown error";
+            return c.json({ ok: false, error: message }, 500);
+        }
+    });
+    const port = await findFreePort();
+    await portless.alias("portmore", (port));
+    return new Promise((resolve, reject) => {
+        try {
+            serve({ fetch: app.fetch, port }, () => {
+                resolve();
+            });
+        }
+        catch (error) {
+            reject(error);
+        }
+    });
+}
+//# sourceMappingURL=dashboard.js.map

package/dist/dashboard.js.map

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

package/dist/demo.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=demo.d.ts.map

package/dist/demo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo.d.ts","sourceRoot":"","sources":["../src/demo.ts"],"names":[],"mappings":""}

package/dist/demo.js

@@ -0,0 +1,100 @@
+import { createServer, } from "node:http";
+import { serve } from "@hono/node-server";
+import { Hono } from "hono";
+import { portmore } from "./index.js";
+import { openInBrowser } from "./open-in-browser.js";
+let visitsA = 0;
+let visitsB = 0;
+await portmore({
+    name: "server-a",
+    title: "Server A",
+    icon: "🧪",
+    metrics: () => {
+        return Promise.resolve({
+            visits: visitsA,
+            server: "hono",
+        });
+    },
+    start: async (port) => {
+        const app = new Hono();
+        app.get("/", (c) => {
+            visitsA += 1;
+            return c.text("Server A\n");
+        });
+        app.get("/server-b", async (c) => {
+            visitsA += 1;
+            const serverBUrl = await portmore("server-b");
+            if (!serverBUrl) {
+                return c.text("Server B alias not found\n", 404);
+            }
+            try {
+                const upstream = await fetch(serverBUrl);
+                const body = await upstream.text();
+                return new Response(body, {
+                    status: upstream.status,
+                    headers: {
+                        "content-type": upstream.headers.get("content-type") ?? "text/plain; charset=utf-8",
+                    },
+                });
+            }
+            catch {
+                return c.text("Failed to call Server B\n", 502);
+            }
+        });
+        return serve({ fetch: app.fetch, port });
+    },
+    stop: async (server) => {
+        await new Promise((resolve, reject) => {
+            server?.close((err) => {
+                if (err) {
+                    reject(err);
+                    return;
+                }
+                resolve();
+            });
+        });
+    },
+});
+await portmore({
+    name: "server-b",
+    title: "Server B",
+    icon: "<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='#7bd0ff' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'><circle cx='12' cy='12' r='9'/><path d='M3 12h18'/><path d='M12 3c2.5 2.7 2.5 15.3 0 18'/><path d='M12 3c-2.5 2.7-2.5 15.3 0 18'/></svg>",
+    metrics: () => {
+        return Promise.resolve({
+            visits: visitsB,
+            server: "node",
+        });
+    },
+    start: async (port) => {
+        const server = createServer((_, res) => {
+            visitsB += 1;
+            res.statusCode = 200;
+            res.setHeader("Content-Type", "text/plain; charset=utf-8");
+            res.end("Server B\n");
+        });
+        return server?.listen(port);
+    },
+    stop: async (server) => {
+        await new Promise((resolve, reject) => {
+            server?.close((err) => {
+                if (err) {
+                    reject(err);
+                    return;
+                }
+                resolve();
+            });
+        });
+    },
+});
+const port = Number(process.env.PORT) || 3000;
+const server = createServer((_, res) => {
+    res.statusCode = 200;
+    res.setHeader("Content-Type", "text/plain; charset=utf-8");
+    res.end("Hello, World!\n");
+});
+server.listen(port);
+console.log(`Demo running on port: ` + port);
+if (process.env.PORTLESS_URL) {
+    openInBrowser("http://portmore.localhost:1355");
+}
+//# sourceMappingURL=demo.js.map

package/dist/demo.js.map

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

package/dist/find-free-port.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=find-free-port.d.ts.map

package/dist/find-free-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-free-port.d.ts","sourceRoot":"","sources":["../src/find-free-port.ts"],"names":[],"mappings":""}

package/dist/find-free-port.js

@@ -0,0 +1,47 @@
+import * as net from "node:net";
+// From:
+// https://github.com/vercel-labs/portless/blob/28b3f6d807a7c831b80a2a03ab3f38049e5c0653/packages/portless/src/cli-utils.ts#L184
+/** Minimum app port when finding a free port. */
+const MIN_APP_PORT = 4000;
+/** Maximum app port when finding a free port. */
+const MAX_APP_PORT = 4999;
+/** Number of random port attempts before sequential scan. */
+const RANDOM_PORT_ATTEMPTS = 50;
+/**
+ * Find a free port in the given range (default 4000-4999).
+ * Tries random ports first for speed, then falls back to sequential scan.
+ *
+ * Note: There is an inherent TOCTOU race between verifying a port is free
+ * and the child process actually binding to it. The random-first strategy
+ * minimizes the window.
+ * @internal
+ */
+export async function findFreePort(minPort = MIN_APP_PORT, maxPort = MAX_APP_PORT) {
+    if (minPort > maxPort) {
+        throw new Error(`minPort (${minPort}) must be <= maxPort (${maxPort})`);
+    }
+    const tryPort = (port) => {
+        return new Promise((resolve) => {
+            const server = net.createServer();
+            server.listen(port, () => {
+                server.close(() => resolve(true));
+            });
+            server.on("error", () => resolve(false));
+        });
+    };
+    // Try random ports first
+    for (let i = 0; i < RANDOM_PORT_ATTEMPTS; i++) {
+        const port = minPort + Math.floor(Math.random() * (maxPort - minPort + 1));
+        if (await tryPort(port)) {
+            return port;
+        }
+    }
+    // Fall back to sequential
+    for (let port = minPort; port <= maxPort; port++) {
+        if (await tryPort(port)) {
+            return port;
+        }
+    }
+    throw new Error(`No free port found in range ${minPort}-${maxPort}`);
+}
+//# sourceMappingURL=find-free-port.js.map

package/dist/find-free-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-free-port.js","sourceRoot":"","sources":["../src/find-free-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAEhC,QAAQ;AACR,gIAAgI;AAEhI,iDAAiD;AACjD,MAAM,YAAY,GAAG,IAAI,CAAC;AAE1B,iDAAiD;AACjD,MAAM,YAAY,GAAG,IAAI,CAAC;AAE1B,6DAA6D;AAC7D,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEhC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAO,GAAG,YAAY,EACtB,OAAO,GAAG,YAAY;IAEtB,IAAI,OAAO,GAAG,OAAO,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,YAAY,OAAO,yBAAyB,OAAO,GAAG,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,IAAY,EAAoB,EAAE;QACjD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;gBACvB,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;YACpC,CAAC,CAAC,CAAC;YACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,yBAAyB;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,oBAAoB,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;QAC3E,IAAI,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,KAAK,IAAI,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;QACjD,IAAI,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,+BAA+B,OAAO,IAAI,OAAO,EAAE,CAAC,CAAC;AACvE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import type { PortMoreAlias, PortMoreOptions } from "./types/portmore.js";
+export declare const aliases: Array<PortMoreAlias>;
+export declare function startAlias(alias: PortMoreAlias<unknown>): Promise<void>;
+export declare function stopAlias(alias: PortMoreAlias<unknown>): Promise<void>;
+export declare function toggleAlias(alias: PortMoreAlias<unknown>): Promise<void>;
+export declare function portmore<T>(options: PortMoreOptions<T>): Promise<void>;
+export declare function portmore(aliasName: string): Promise<string | undefined>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE1E,eAAO,MAAM,OAAO,EAAE,KAAK,CAAC,aAAa,CAAM,CAAC;AAEhD,wBAAsB,UAAU,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CA2B7E;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB5E;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAO9E;AAGD,wBAAsB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAC9E,wBAAsB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC"}

package/dist/index.js

@@ -0,0 +1,75 @@
+import { findFreePort } from "./find-free-port.js";
+import { startDashboard } from "./dashboard.js";
+import { portless } from "./portless.js";
+export const aliases = [];
+export async function startAlias(alias) {
+    if (alias.status === "Running" || alias.status === "Starting") {
+        return;
+    }
+    alias.status = "Starting";
+    try {
+        alias.server = await alias.start(alias.port);
+        alias.started = new Date();
+        alias.status = "Running";
+        await portless.alias(alias.name, alias.port);
+    }
+    catch (error) {
+        alias.status = "Error";
+        // If alias creation fails after the server started, clean up to avoid orphan listeners.
+        if (alias.server !== undefined) {
+            try {
+                await alias.stop(alias.server);
+            }
+            catch {
+                // Preserve original error path; alias is already marked Error.
+            }
+            alias.server = undefined;
+        }
+        throw error;
+    }
+}
+export async function stopAlias(alias) {
+    if (alias.status === "Stopped" || alias.status === "Stopping") {
+        return;
+    }
+    if (alias.server === undefined) {
+        alias.status = "Stopped";
+        return;
+    }
+    alias.status = "Stopping";
+    try {
+        await alias.stop(alias.server);
+        alias.server = undefined;
+        await portless.removeAlias(alias.name);
+        alias.status = "Stopped";
+    }
+    catch (error) {
+        alias.status = "Error";
+        throw error;
+    }
+}
+export async function toggleAlias(alias) {
+    if (alias.status === "Running" || alias.status === "Starting") {
+        await stopAlias(alias);
+        return;
+    }
+    await startAlias(alias);
+}
+export async function portmore(optionsOrAliasName) {
+    if (typeof optionsOrAliasName === "string") {
+        const alias = aliases.find((entry) => entry.name === optionsOrAliasName);
+        if (!alias) {
+            return undefined;
+        }
+        return portless.getUrl(alias.name).catch(() => `http://localhost:${alias.port}`);
+    }
+    const options = optionsOrAliasName;
+    const port = await findFreePort();
+    const alias = Object.assign({}, { port }, options);
+    aliases.push(alias);
+    if (aliases.length === 1) {
+        await startDashboard();
+    }
+    await startAlias(alias);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/open-in-browser.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=open-in-browser.d.ts.map

package/dist/open-in-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-in-browser.d.ts","sourceRoot":"","sources":["../src/open-in-browser.ts"],"names":[],"mappings":""}

package/dist/open-in-browser.js

@@ -0,0 +1,18 @@
+import { spawn } from "node:child_process";
+/** @internal */
+export function openInBrowser(url) {
+    const openCommand = process.platform === "darwin"
+        ? { command: "open", args: [url] }
+        : process.platform === "win32"
+            ? { command: "cmd", args: ["/c", "start", "", url] }
+            : { command: "xdg-open", args: [url] };
+    const child = spawn(openCommand.command, openCommand.args, {
+        detached: true,
+        stdio: "ignore",
+    });
+    child.on("error", () => {
+        // Ignore failures to open a browser in demo mode.
+    });
+    child.unref();
+}
+//# sourceMappingURL=open-in-browser.js.map

package/dist/open-in-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-in-browser.js","sourceRoot":"","sources":["../src/open-in-browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,gBAAgB;AAChB,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,WAAW,GACf,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAC3B,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE;QAClC,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO;YAC5B,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE;YACpD,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;IAE7C,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,EAAE;QACzD,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,QAAQ;KAChB,CAAC,CAAC;IAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QACrB,kDAAkD;IACpD,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC"}

package/dist/portless.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=portless.d.ts.map

package/dist/portless.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portless.d.ts","sourceRoot":"","sources":["../src/portless.ts"],"names":[],"mappings":""}

package/dist/portless.js

@@ -0,0 +1,17 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+/** @internal */
+export const portless = {
+    async alias(name, port) {
+        await execFileAsync("portless", ["alias", name, String(port)]);
+    },
+    async getUrl(name) {
+        const { stdout } = await execFileAsync("portless", ["get", name, "--no-worktree"]);
+        return stdout.trim();
+    },
+    async removeAlias(name) {
+        await execFileAsync("portless", ["alias", "--remove", name]);
+    },
+};
+//# sourceMappingURL=portless.js.map

package/dist/portless.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portless.js","sourceRoot":"","sources":["../src/portless.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,gBAAgB;AAChB,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,IAAY;QACpC,MAAM,aAAa,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC;QACnF,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAAY;QAC5B,MAAM,aAAa,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;IAC/D,CAAC;CACF,CAAC"}

package/dist/types/portmore.d.ts

@@ -0,0 +1,9 @@
+export type PortMoreOptions<T> = {
+    name: string;
+    title: string;
+    icon?: string;
+    metrics?: () => Promise<Record<string, unknown>>;
+    start: (port: number) => Promise<T>;
+    stop: (server: T) => Promise<void>;
+};
+//# sourceMappingURL=portmore.d.ts.map

package/dist/types/portmore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portmore.d.ts","sourceRoot":"","sources":["../../src/types/portmore.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACjD,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACpC,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC,CAAC"}

package/dist/types/portmore.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=portmore.js.map

package/dist/types/portmore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portmore.js","sourceRoot":"","sources":["../../src/types/portmore.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "portmore",
+  "version": "1.0.0",
+  "description": "A portless process wrapper that assigns and aliases free ports for local in process service orchestration.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/allanhvam/portmore.git"
+  },
+  "files": [
+    "docs",
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "npm run build && portless run --name demo node dist/demo.js",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "clean": "rm -rf dist",
+    "test": "echo \"No tests yet\""
+  },
+  "keywords": [
+    "portless",
+    "ports",
+    "local-development",
+    "service-orchestration",
+    "dashboard"
+  ],
+  "author": "Allan Hvam",
+  "license": "ISC",
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@stylistic/eslint-plugin": "^5.10.0",
+    "@types/node": "^25.4.0",
+    "@typescript-eslint/eslint-plugin": "^8.57.0",
+    "@typescript-eslint/parser": "^8.57.0",
+    "eslint": "^10.0.3",
+    "globals": "^17.4.0",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "@hono/node-server": "^1.19.11",
+    "hono": "^4.12.7"
+  }
+}