localpreview 0.2.3 → 0.2.4

package/README.md

@@ -8,8 +8,9 @@ server to a public URL.
 ```sh
 localpreview connect 3000
 localpreview connect https://localhost:3000
-localpreview connect 3000 --name proyecto
+localpreview connect 3000 --name my-app
 localpreview connect 3000 -l
+localpreview connect 5173 --capture localhost:4000
 ```
 
 `localpreview <target>` is still accepted as a deprecated compatibility alias and
@@ -21,6 +22,38 @@ Targets are parsed by `@localpreview/protocol`:
 - URLs must use `http` or `https`.
 - URL targets must include an explicit port.
 
+Run `localpreview -h` for public help. When `LOCALPREVIEW_ADMIN_TOKEN` is set in
+the environment, global help also lists admin commands.
+
+## Admin commands
+
+Subdomain cleanup is an admin-only operation. Export `LOCALPREVIEW_ADMIN_TOKEN`
+before running `clean`:
+
+```sh
+export LOCALPREVIEW_ADMIN_TOKEN=your-token
+localpreview clean my-app --force
+localpreview clean --all --force -l
+```
+
+Admin authorization is read from the environment only.
+
+`localpreview clean -h` and `localpreview list -h` show full admin help only when
+`LOCALPREVIEW_ADMIN_TOKEN` is set. Without it, you get public help plus a note
+that admin commands require the variable.
+
+Inspect active tunnels, Redis inventory drift, and sandbox leftovers without
+printing tokens or preview URLs:
+
+```sh
+localpreview list
+localpreview list --limit 20 --skip 20 -l
+```
+
+The list view prints a compact summary, page details, and a practical table with
+subdomain, short tunnel/sandbox ids, age, relay health, sandbox status, and the
+control-plane note for each row.
+
 ## Runtime Flow
 
 1. The CLI validates the target and optional `--name`.
@@ -42,6 +75,7 @@ browser -> control-plane -> relay -> CLI WebSocket -> local target
 The package is structured as small Effect-backed services:
 
 - `src/command.ts`: command parsing, legacy alias handling, and top-level flow.
+- `src/cli-ui.ts`: help text, terminal styling, and log formatting.
 - `src/config.ts`: runtime defaults and environment-derived limits.
 - `src/control-plane.ts`: tunnel create/delete HTTP adapter.
 - `src/relay-client.ts`: WebSocket lifecycle, signals, and relay event handling.
@@ -55,7 +89,8 @@ Effect.
 ## Defaults and Limits
 
 - Control-plane URL precedence:
-  `-l|--local` > `https://localpreview.dev`
+  `-l` / `--local` (shorthand for `--control-plane http://localhost:3000`) >
+  `https://localpreview.dev`
 - Request body limit: `10 MB`
 - Response body limit: `50 MB`
 - Local request timeout: `30 seconds`
@@ -66,6 +101,7 @@ Effect.
 Optional environment overrides:
 
 ```sh
+LOCALPREVIEW_ADMIN_TOKEN=...          # required for `clean` and `list`
 LOCALPREVIEW_REQUEST_BODY_LIMIT_BYTES=10485760
 LOCALPREVIEW_RESPONSE_BODY_LIMIT_BYTES=52428800
 LOCALPREVIEW_REQUEST_TIMEOUT_MS=30000
@@ -110,5 +146,6 @@ For a local end-to-end run, start the relay and control-plane first:
 ```sh
 pnpm dev:relay
 pnpm dev:web
+export LOCALPREVIEW_ADMIN_TOKEN=your-local-token
 pnpm localpreview connect 3000 -l
 ```

package/dist/cli-ui.d.ts

@@ -0,0 +1,22 @@
+import type { ListTunnelsResponse } from "@localpreview/protocol";
+export declare const ADMIN_TOKEN_ENV = "LOCALPREVIEW_ADMIN_TOKEN";
+export declare const hasAdminTokenInEnv: (env?: NodeJS.ProcessEnv) => boolean;
+export declare const formatWarning: (message: string) => string;
+export declare const formatCliError: (message: string) => string;
+export declare const formatStatus: (message: string) => string;
+export declare const formatRelayReconnect: (message: string) => string;
+export declare const formatRequestOutbound: (method: string, path: string) => string;
+export declare const formatRequestInbound: (status: number, path: string, durationMs: number) => string;
+export declare const formatRequestError: (path: string, message: string) => string;
+export declare const removedAdminTokenFlagMessage: () => string;
+export declare const adminTokenRequiredMessage: () => string;
+export type HelpRenderOptions = {
+    readonly env?: NodeJS.ProcessEnv;
+};
+export declare const renderGlobalHelp: (options?: HelpRenderOptions) => string;
+export declare const renderConnectHelp: () => string;
+export declare const renderCleanHelp: (options?: HelpRenderOptions) => string;
+export declare const renderListHelp: (options?: HelpRenderOptions) => string;
+export declare const formatListTunnelsOutput: (response: ListTunnelsResponse) => string;
+export declare const formatCompactAge: (activeForMs: number | undefined) => string;
+//# sourceMappingURL=cli-ui.d.ts.map

package/dist/cli-ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-ui.d.ts","sourceRoot":"","sources":["../src/cli-ui.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAkB,MAAM,wBAAwB,CAAC;AAIlF,eAAO,MAAM,eAAe,6BAA6B,CAAC;AAE1D,eAAO,MAAM,kBAAkB,GAAI,MAAK,MAAM,CAAC,UAAwB,KAAG,OAGzE,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,KAAG,MAQ/C,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,KAAG,MAQhD,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,KAAG,MAM9C,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,SAAS,MAAM,KAAG,MACT,CAAC;AAE/C,eAAO,MAAM,qBAAqB,GAAI,QAAQ,MAAM,EAAE,MAAM,MAAM,KAAG,MASpE,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,MAAM,EACd,MAAM,MAAM,EACZ,YAAY,MAAM,KACjB,MAWF,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,EAAE,SAAS,MAAM,KAAG,MASlE,CAAC;AAKF,eAAO,MAAM,4BAA4B,QAAO,MAA0C,CAAC;AAE3F,eAAO,MAAM,yBAAyB,QAAO,MACkD,CAAC;AAEhG,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAClC,CAAC;AAiDF,eAAO,MAAM,gBAAgB,GAAI,UAAS,iBAAsB,KAAG,MASlE,CAAC;AAEF,eAAO,MAAM,iBAAiB,QAAO,MAuBjC,CAAC;AAEL,eAAO,MAAM,eAAe,GAAI,UAAS,iBAAsB,KAAG,MAmCjE,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,UAAS,iBAAsB,KAAG,MAiChE,CAAC;AAaF,eAAO,MAAM,uBAAuB,GAAI,UAAU,mBAAmB,KAAG,MA0DvE,CAAC;AAwCF,eAAO,MAAM,gBAAgB,GAAI,aAAa,MAAM,GAAG,SAAS,KAAG,MA0BlE,CAAC"}

package/dist/cli-ui.js

@@ -0,0 +1,304 @@
+import pc from "picocolors";
+import { LOCAL_CONTROL_PLANE_URL } from "./config.js";
+import { CLI_PACKAGE_VERSION } from "./version.js";
+export const ADMIN_TOKEN_ENV = "LOCALPREVIEW_ADMIN_TOKEN";
+export const hasAdminTokenInEnv = (env = process.env) => {
+    const token = env[ADMIN_TOKEN_ENV];
+    return token !== undefined && token.length > 0;
+};
+export const formatWarning = (message) => {
+    const prefix = "Warning:";
+    if (!pc.isColorSupported) {
+        return `${prefix} ${message}`;
+    }
+    return `${pc.yellow(prefix)} ${message}`;
+};
+export const formatCliError = (message) => {
+    const prefix = "Error:";
+    if (!pc.isColorSupported) {
+        return `${prefix} ${message}`;
+    }
+    return `${pc.red(prefix)} ${message}`;
+};
+export const formatStatus = (message) => {
+    if (!pc.isColorSupported) {
+        return message;
+    }
+    return pc.cyan(message);
+};
+export const formatRelayReconnect = (message) => formatWarning(`${message}; reconnecting...`);
+export const formatRequestOutbound = (method, path) => {
+    const arrow = "→";
+    const line = `${arrow} ${method} ${path}`;
+    if (!pc.isColorSupported) {
+        return line;
+    }
+    return `${pc.dim(arrow)} ${pc.bold(method)} ${path}`;
+};
+export const formatRequestInbound = (status, path, durationMs) => {
+    const arrow = "←";
+    const line = `${arrow} ${status} ${path} ${durationMs}ms`;
+    if (!pc.isColorSupported) {
+        return line;
+    }
+    const statusText = status >= 500 ? pc.red(String(status)) : status >= 400 ? pc.yellow(String(status)) : pc.green(String(status));
+    return `${pc.dim(arrow)} ${statusText} ${path} ${pc.dim(`${durationMs}ms`)}`;
+};
+export const formatRequestError = (path, message) => {
+    const arrow = "←";
+    const line = `${arrow} error ${path} ${message}`;
+    if (!pc.isColorSupported) {
+        return line;
+    }
+    return `${pc.dim(arrow)} ${pc.red("error")} ${path} ${pc.red(message)}`;
+};
+const REMOVED_ADMIN_TOKEN_FLAG_MESSAGE = "The --admin-token flag was removed. Set the LOCALPREVIEW_ADMIN_TOKEN environment variable instead.";
+export const removedAdminTokenFlagMessage = () => REMOVED_ADMIN_TOKEN_FLAG_MESSAGE;
+export const adminTokenRequiredMessage = () => `Admin commands require ${ADMIN_TOKEN_ENV}. Export it in your shell, then rerun the command.`;
+const heading = (text) => (pc.isColorSupported ? pc.bold(text) : text);
+const commandName = (text) => (pc.isColorSupported ? pc.cyan(text) : text);
+const flagName = (text) => (pc.isColorSupported ? pc.yellow(text) : text);
+const dim = (text) => (pc.isColorSupported ? pc.dim(text) : text);
+const localFlagHelpLine = () => `  ${flagName("-l")}, ${flagName("--local")}              Shorthand for ${flagName("--control-plane")} ${dim(LOCAL_CONTROL_PLANE_URL)}`;
+const joinLines = (lines) => lines.join("\n");
+const publicUsageLines = () => [
+    heading("localpreview — expose local dev servers through a public preview URL"),
+    "",
+    heading("Usage"),
+    `  ${commandName("localpreview")} ${commandName("connect")} <port|target-url> [options]`,
+    `  ${commandName("localpreview")} ${flagName("--version")}`,
+    `  ${commandName("localpreview")} ${flagName("-h")} | ${flagName("--help")}`,
+    "",
+    heading("Commands"),
+    `  ${commandName("connect")}    Start a tunnel to your local target`,
+    "",
+    heading("Global options"),
+    `  ${flagName("-h")}, ${flagName("--help")}     Show help`,
+    `  ${flagName("--version")}      Show version (${CLI_PACKAGE_VERSION})`,
+];
+const publicExamplesLines = () => [
+    "",
+    heading("Examples"),
+    `  ${dim("localpreview connect 3000")}`,
+    `  ${dim("localpreview connect 5173 --capture localhost:4000")}`,
+    `  ${dim("localpreview connect https://localhost:3000 --name my-app")}`,
+    `  ${dim("localpreview connect 3000 -l")}`,
+    `  ${dim("localpreview connect 3000 --control-plane https://staging.localpreview.dev")}`,
+];
+const adminSectionLines = () => [
+    "",
+    heading("Admin commands"),
+    `  ${dim(`Requires ${ADMIN_TOKEN_ENV} in the environment.`)}`,
+    `  ${commandName("clean")}       Remove subdomains from the control plane`,
+    `  ${commandName("list")}        List active tunnels and inventory orphans`,
+];
+export const renderGlobalHelp = (options = {}) => {
+    const env = options.env ?? process.env;
+    const lines = [...publicUsageLines(), ...publicExamplesLines()];
+    if (hasAdminTokenInEnv(env)) {
+        lines.push(...adminSectionLines());
+    }
+    return joinLines(lines);
+};
+export const renderConnectHelp = () => joinLines([
+    heading("localpreview connect — start a tunnel to a local target"),
+    "",
+    heading("Usage"),
+    `  ${commandName("localpreview")} ${commandName("connect")} <port|target-url> [options]`,
+    `  ${commandName("localpreview")} <port|target-url> [options]    ${dim("(deprecated alias)")}`,
+    "",
+    heading("Arguments"),
+    `  <port|target-url>    Local port (e.g. 3000) or full http(s) URL with explicit port`,
+    "",
+    heading("Options"),
+    `  ${flagName("--name")} <subdomain>       Request a public subdomain`,
+    `  ${flagName("--capture")} <host:port>     Expose an extra loopback backend through the preview URL`,
+    localFlagHelpLine(),
+    `  ${flagName("--control-plane")} <url>    Remote control plane base URL (HTTPS required off localhost)`,
+    `  ${flagName("-h")}, ${flagName("--help")}               Show this help`,
+    "",
+    heading("Examples"),
+    `  ${dim("localpreview connect 3000")}`,
+    `  ${dim("localpreview connect 5173 --capture localhost:4000")}`,
+    `  ${dim("localpreview connect https://localhost:3000 --name my-app")}`,
+    `  ${dim("localpreview connect 3000 -l")}`,
+]);
+export const renderCleanHelp = (options = {}) => {
+    const env = options.env ?? process.env;
+    if (!hasAdminTokenInEnv(env)) {
+        return joinLines([
+            renderGlobalHelp(options),
+            "",
+            adminTokenRequiredMessage(),
+        ]);
+    }
+    return joinLines([
+        heading("localpreview clean — admin subdomain cleanup"),
+        "",
+        heading("Usage"),
+        `  ${commandName("localpreview")} ${commandName("clean")} <subdomain> [options]`,
+        `  ${commandName("localpreview")} ${commandName("clean")} ${flagName("--all")} ${flagName("--force")} [options]`,
+        "",
+        heading("Arguments"),
+        `  <subdomain>          Subdomain to remove from the control plane`,
+        "",
+        heading("Options"),
+        `  ${flagName("--force")}               Force cleanup when relays are still connected`,
+        `  ${flagName("--all")}                 Bulk cleanup (requires ${flagName("--force")})`,
+        localFlagHelpLine(),
+        `  ${flagName("--control-plane")} <url>    Control plane base URL`,
+        `  ${flagName("-h")}, ${flagName("--help")}               Show this help`,
+        "",
+        dim(`Authorization uses ${ADMIN_TOKEN_ENV} from the environment.`),
+        "",
+        heading("Examples"),
+        `  ${dim("localpreview clean my-app --force")}`,
+        `  ${dim("localpreview clean --all --force -l")}`,
+        `  ${dim("localpreview clean demo --control-plane https://staging.localpreview.dev --force")}`,
+    ]);
+};
+export const renderListHelp = (options = {}) => {
+    const env = options.env ?? process.env;
+    if (!hasAdminTokenInEnv(env)) {
+        return joinLines([
+            renderGlobalHelp(options),
+            "",
+            adminTokenRequiredMessage(),
+        ]);
+    }
+    return joinLines([
+        heading("localpreview list — inspect tunnel inventory"),
+        "",
+        heading("Usage"),
+        `  ${commandName("localpreview")} ${commandName("list")} [options]`,
+        "",
+        dim("Shows active tunnels, Redis inventory drift, and sandbox leftovers without revealing tokens or preview URLs."),
+        "",
+        heading("Options"),
+        `  ${flagName("--limit")} <n>             Page size (default 100)`,
+        `  ${flagName("--skip")} <n>              Offset into the sorted inventory (default 0)`,
+        localFlagHelpLine(),
+        `  ${flagName("--control-plane")} <url>    Control plane base URL`,
+        `  ${flagName("-h")}, ${flagName("--help")}               Show this help`,
+        "",
+        dim(`Authorization uses ${ADMIN_TOKEN_ENV} from the environment.`),
+        "",
+        heading("Examples"),
+        `  ${dim("localpreview list")}`,
+        `  ${dim("localpreview list --limit 20 --skip 20 -l")}`,
+        `  ${dim("localpreview list --control-plane <control-plane-url>")}`,
+    ]);
+};
+const LIST_COLUMNS = [
+    "kind",
+    "subdomain",
+    "tunnel",
+    "age",
+    "relay",
+    "sandbox",
+    "sandbox id",
+    "note",
+];
+export const formatListTunnelsOutput = (response) => {
+    const lines = [];
+    lines.push(heading("Tunnel inventory"));
+    lines.push("");
+    for (const warning of response.warnings ?? []) {
+        lines.push(formatWarning(warning));
+    }
+    if ((response.warnings?.length ?? 0) > 0) {
+        lines.push("");
+    }
+    lines.push(heading("Summary"));
+    lines.push(`  tracked: ${response.counts.tracked}   redis orphans: ${response.counts["redis-orphan"]}   sandbox orphans: ${response.counts["sandbox-orphan"]}`);
+    lines.push("");
+    lines.push(heading("Page"));
+    lines.push(`  showing: ${response.items.length} of ${response.total}   skip: ${response.skip}   limit: ${response.limit}`);
+    const nextSkip = response.skip + response.limit;
+    if (nextSkip < response.total) {
+        lines.push(`  next: localpreview list --skip ${nextSkip} --limit ${response.limit}`);
+    }
+    if (response.items.length === 0) {
+        lines.push("");
+        lines.push(dim("No active tunnels or inventory orphans on this page."));
+        return joinLines(lines);
+    }
+    const rows = response.items.map(formatListTunnelRow);
+    const widths = LIST_COLUMNS.map((column, index) => Math.max(column.length, ...rows.map((row) => row[index]?.length ?? 0)));
+    lines.push("");
+    lines.push(heading("Items"));
+    lines.push(LIST_COLUMNS.map((column, index) => column.padEnd(widths[index] ?? column.length)).join("  "));
+    lines.push(widths.map((width) => "-".repeat(width)).join("  "));
+    for (const row of rows) {
+        lines.push(row
+            .map((cell, index) => cell.padEnd(widths[index] ?? cell.length))
+            .join("  "));
+    }
+    if (response.items.some((item) => item.relayHealthWarning !== undefined && item.relayHealthWarning.length > 0)) {
+        lines.push("");
+        lines.push(dim("Relay values ending in ! include a health warning from the control plane."));
+    }
+    return joinLines(lines);
+};
+const formatListTunnelRow = (item) => [
+    formatListItemKind(item.kind),
+    item.subdomain ?? "-",
+    formatShortId(item.tunnelId),
+    formatCompactAge(item.activeForMs),
+    formatRelayHealth(item),
+    item.sandboxStatus ?? "-",
+    formatShortId(item.sandboxId),
+    item.reason ?? item.orphanReason ?? "-",
+];
+const formatListItemKind = (kind) => {
+    switch (kind) {
+        case "tracked-tunnel":
+            return "tracked";
+        case "redis-orphan":
+            return "redis-orphan";
+        case "redis-index-orphan":
+            return "redis-index";
+        case "sandbox-orphan":
+            return "sandbox-orphan";
+        default: {
+            const unreachable = kind;
+            throw new Error(`Unhandled tunnel list item kind: ${String(unreachable)}`);
+        }
+    }
+};
+const formatRelayHealth = (item) => {
+    const base = item.relayHealth;
+    if (item.relayHealthWarning !== undefined && item.relayHealthWarning.length > 0) {
+        return `${base}!`;
+    }
+    return base;
+};
+export const formatCompactAge = (activeForMs) => {
+    if (activeForMs === undefined) {
+        return "unknown";
+    }
+    const totalMinutes = Math.floor(activeForMs / 60_000);
+    if (totalMinutes < 1) {
+        return `${Math.max(1, Math.floor(activeForMs / 1_000))}s`;
+    }
+    if (totalMinutes < 60) {
+        return `${totalMinutes}m`;
+    }
+    const totalHours = Math.floor(totalMinutes / 60);
+    const minutes = totalMinutes % 60;
+    if (totalHours < 24) {
+        return minutes === 0 ? `${totalHours}h` : `${totalHours}h ${minutes}m`;
+    }
+    const days = Math.floor(totalHours / 24);
+    const hours = totalHours % 24;
+    return hours === 0 ? `${days}d` : `${days}d ${hours}h`;
+};
+const formatShortId = (value) => {
+    if (value === undefined || value.length === 0) {
+        return "-";
+    }
+    if (value.length <= 12) {
+        return value;
+    }
+    return `${value.slice(0, 8)}…`;
+};

package/dist/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAQA,OAAO,EAAW,MAAM,EAAiB,MAAM,QAAQ,CAAC;AAOxD,OAAO,EAAE,aAAa,EAAgB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AA8BhF,eAAO,MAAM,MAAM,GACjB,MAAM,aAAa,CAAC,MAAM,CAAC,KAC1B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,aAAa,CAkBrD,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,MAAM,aAAa,CAAC,MAAM,CAAC,KAAG,aAAa,CAAC,MAAM,CAC1C,CAAC"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAQA,OAAO,EAAW,MAAM,EAAiB,MAAM,QAAQ,CAAC;AAkBxD,OAAO,EAAE,aAAa,EAAgB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAwChF,eAAO,MAAM,MAAM,GACjB,MAAM,aAAa,CAAC,MAAM,CAAC,KAC1B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,aAAa,CAmBrD,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,MAAM,aAAa,CAAC,MAAM,CAAC,KAAG,aAAa,CAAC,MAAM,CAC1C,CAAC"}

package/dist/command.js

@@ -1,17 +1,20 @@
 import { formatCaptureOrigin, parseCaptureHostPort, parseTarget, validateRequestedSubdomain, } from "@localpreview/protocol";
 import { Console, Effect, Layer, Option } from "effect";
+import { adminTokenRequiredMessage, formatStatus, formatWarning, formatListTunnelsOutput, renderCleanHelp, renderConnectHelp, renderGlobalHelp, renderListHelp, removedAdminTokenFlagMessage, } from "./cli-ui.js";
 import { CliConfig, CliConfigLive, LOCAL_CONTROL_PLANE_URL, normalizeControlPlaneUrl } from "./config.js";
 import { ControlPlaneClient, ControlPlaneClientLive, } from "./control-plane.js";
 import { CliUsageError, errorMessage } from "./errors.js";
 import { LocalProxyLive } from "./local-proxy.js";
 import { RelayClient, RelayClientLive } from "./relay-client.js";
+import { CLI_PACKAGE_VERSION } from "./version.js";
 export const runCli = (argv) => {
     const normalized = normalizeCliArgs(argv);
-    if (isHelpInvocation(normalized)) {
-        return printHelp();
+    const helpKind = resolveHelpKind(normalized);
+    if (helpKind !== null) {
+        return printHelp(helpKind);
     }
     if (isVersionInvocation(normalized)) {
-        return Console.log("0.0.0");
+        return Console.log(CLI_PACKAGE_VERSION);
     }
     const parsed = parseCommand(normalized);
     if (!parsed.ok) {
@@ -20,7 +23,29 @@ export const runCli = (argv) => {
     return runSubcommand(parsed.command);
 };
 export const normalizeCliArgs = (argv) => argv[0] === "--" ? argv.slice(1) : argv;
-const isHelpInvocation = (argv) => argv.length === 0 || argv.includes("--help") || argv.includes("-h");
+const hasHelpFlag = (argv) => argv.includes("--help") || argv.includes("-h");
+const resolveHelpKind = (argv) => {
+    if (argv.length === 0) {
+        return "global";
+    }
+    if (!hasHelpFlag(argv)) {
+        return null;
+    }
+    const first = argv[0];
+    if (first === "clean") {
+        return "clean";
+    }
+    if (first === "list") {
+        return "list";
+    }
+    if (first === "connect") {
+        return "connect";
+    }
+    if (first !== undefined && !first.startsWith("-")) {
+        return "connect";
+    }
+    return "global";
+};
 const isVersionInvocation = (argv) => argv.includes("--version");
 const isLegacyConnectInvocation = (argv) => {
     const first = argv[0];
@@ -29,21 +54,16 @@ const isLegacyConnectInvocation = (argv) => {
     }
     return first !== "connect" && !first.startsWith("-");
 };
-const printHelp = () => Console.log([
-    "Usage: localpreview connect <port|target-url> [--name subdomain] [--capture host:port] [-l|--local] [--control-plane url]",
-    "       localpreview clean <subdomain> [--force] [-l|--local] [--control-plane url] [--admin-token token]",
-    "       localpreview clean --all --force [-l|--local] [--control-plane url] [--admin-token token]",
-    "",
-    "Examples:",
-    "  localpreview connect 3000",
-    "  localpreview connect 5173 --capture localhost:4000",
-    "  localpreview connect https://localhost:3000 --name proyecto",
-    "  localpreview connect 3000 -l",
-    "  localpreview connect 3000 --control-plane https://staging.localpreview.dev",
-    "  localpreview clean proyecto --force",
-    "  localpreview clean --all --force",
-    "  localpreview clean demo --control-plane https://staging.localpreview.dev --admin-token ...",
-].join("\n"));
+const printHelp = (kind) => {
+    const text = kind === "global"
+        ? renderGlobalHelp()
+        : kind === "connect"
+            ? renderConnectHelp()
+            : kind === "clean"
+                ? renderCleanHelp()
+                : renderListHelp();
+    return Console.log(text);
+};
 const parseCommand = (argv) => {
     if (argv[0] === "clean") {
         const parsed = parseCleanArgs(argv.slice(1));
@@ -58,6 +78,19 @@ const parseCommand = (argv) => {
             ok: true,
         };
     }
+    if (argv[0] === "list") {
+        const parsed = parseListArgs(argv.slice(1));
+        if (!parsed.ok) {
+            return parsed;
+        }
+        return {
+            command: {
+                config: parsed.config,
+                kind: "list",
+            },
+            ok: true,
+        };
+    }
     const legacy = isLegacyConnectInvocation(argv);
     const args = legacy ? argv : argv[0] === "connect" ? argv.slice(1) : argv;
     const parsed = parseConnectArgs(args);
@@ -152,7 +185,6 @@ const parseConnectArgs = (argv) => {
 };
 const parseCleanArgs = (argv) => {
     const rest = [...argv];
-    let adminToken;
     let all = false;
     let controlPlane;
     let force = false;
@@ -165,13 +197,10 @@ const parseCleanArgs = (argv) => {
             continue;
         }
         if (arg === "--admin-token") {
-            const value = readRequiredOptionValue(rest, index, "--admin-token");
-            if (!value.ok) {
-                return value;
-            }
-            adminToken = value.value;
-            index += 1;
-            continue;
+            return {
+                message: removedAdminTokenFlagMessage(),
+                ok: false,
+            };
         }
         if (arg === "--all") {
             all = true;
@@ -222,14 +251,13 @@ const parseCleanArgs = (argv) => {
     }
     if (!all && subdomain === undefined) {
         return {
-            message: "Usage: localpreview clean <subdomain> [--force] [-l|--local] [--control-plane url] [--admin-token token]\n       localpreview clean --all --force [-l|--local] [--control-plane url] [--admin-token token]",
+            message: "Usage: localpreview clean <subdomain> [--force] [-l|--local] [--control-plane url]\n       localpreview clean --all --force [-l|--local] [--control-plane url]",
             ok: false,
         };
     }
     return {
         config: {
             all,
-            adminToken: toOption(adminToken),
             controlPlane: toOption(controlPlane),
             force,
             subdomain: toOption(subdomain),
@@ -237,6 +265,119 @@ const parseCleanArgs = (argv) => {
         ok: true,
     };
 };
+const parseListArgs = (argv) => {
+    const rest = [...argv];
+    let controlPlane;
+    let limit = 100;
+    let skip = 0;
+    let usedLocalControlPlane = false;
+    let usedControlPlaneFlag = false;
+    for (let index = 0; index < rest.length; index += 1) {
+        const arg = rest[index];
+        if (arg === undefined) {
+            continue;
+        }
+        if (arg === "--admin-token") {
+            return {
+                message: removedAdminTokenFlagMessage(),
+                ok: false,
+            };
+        }
+        if (arg === "--limit") {
+            const value = readRequiredOptionValue(rest, index, "--limit");
+            if (!value.ok) {
+                return value;
+            }
+            const parsedLimit = parsePositiveIntegerOption(value.value, "--limit");
+            if (!parsedLimit.ok) {
+                return parsedLimit;
+            }
+            limit = parsedLimit.value;
+            index += 1;
+            continue;
+        }
+        if (arg === "--skip") {
+            const value = readRequiredOptionValue(rest, index, "--skip");
+            if (!value.ok) {
+                return value;
+            }
+            const parsedSkip = parseNonNegativeIntegerOption(value.value, "--skip");
+            if (!parsedSkip.ok) {
+                return parsedSkip;
+            }
+            skip = parsedSkip.value;
+            index += 1;
+            continue;
+        }
+        const controlPlaneFlag = readControlPlaneFlag(rest, index, arg, {
+            usedControlPlaneFlag,
+            usedLocalControlPlane,
+        });
+        if (!controlPlaneFlag.ok) {
+            return controlPlaneFlag;
+        }
+        if (controlPlaneFlag.handled) {
+            if (controlPlaneFlag.usedLocalControlPlane) {
+                usedLocalControlPlane = true;
+            }
+            if (controlPlaneFlag.usedControlPlaneFlag) {
+                usedControlPlaneFlag = true;
+            }
+            controlPlane = controlPlaneFlag.controlPlane ?? controlPlane;
+            index = controlPlaneFlag.nextIndex;
+            continue;
+        }
+        if (arg !== undefined && !arg.startsWith("-")) {
+            return {
+                message: `Unexpected argument: ${arg}`,
+                ok: false,
+            };
+        }
+        return {
+            message: `Unknown option: ${arg}`,
+            ok: false,
+        };
+    }
+    return {
+        config: {
+            controlPlane: toOption(controlPlane),
+            limit,
+            skip,
+        },
+        ok: true,
+    };
+};
+const parsePositiveIntegerOption = (value, option) => {
+    if (!/^\d+$/.test(value)) {
+        return {
+            message: `${option} must be a positive integer.`,
+            ok: false,
+        };
+    }
+    const parsed = Number.parseInt(value, 10);
+    if (parsed <= 0) {
+        return {
+            message: `${option} must be a positive integer.`,
+            ok: false,
+        };
+    }
+    return {
+        ok: true,
+        value: parsed,
+    };
+};
+const parseNonNegativeIntegerOption = (value, option) => {
+    if (!/^\d+$/.test(value)) {
+        return {
+            message: `${option} must be a non-negative integer.`,
+            ok: false,
+        };
+    }
+    return {
+        ok: true,
+        value: Number.parseInt(value, 10),
+    };
+};
 const readControlPlaneFlag = (argv, index, arg, state) => {
     if (arg === "-l" || arg === "--local") {
         if (state.usedControlPlaneFlag) {
@@ -302,7 +443,9 @@ const runSubcommand = (command) => {
     const controlPlane = Option.getOrUndefined(command.config.controlPlane);
     const effect = command.kind === "connect"
         ? runConnect(command.config, command.legacy)
-        : runClean(command.config);
+        : command.kind === "clean"
+            ? runClean(command.config)
+            : runList(command.config);
     return effect.pipe(Effect.provide(makeCommandLayer(makeConfigInput(controlPlane))));
 };
 const makeConfigInput = (controlPlaneUrl) => controlPlaneUrl === undefined ? {} : { controlPlaneUrl };
@@ -314,7 +457,7 @@ const makeCommandLayer = (input) => {
 };
 const runConnect = (config, legacy) => Effect.scoped(Effect.gen(function* () {
     if (legacy) {
-        yield* Console.error("Warning: `localpreview <target>` is deprecated. Use `localpreview connect <target>`.");
+        yield* Console.error(formatWarning("`localpreview <target>` is deprecated. Use `localpreview connect <target>`."));
     }
     const target = parseTarget(config.target);
     if (!target.ok) {
@@ -325,11 +468,11 @@ const runConnect = (config, legacy) => Effect.scoped(Effect.gen(function* () {
     const relay = yield* RelayClient;
     const cliConfig = yield* CliConfig;
     const tunnel = yield* Effect.acquireRelease(controlPlane.createTunnel(cliConfig.controlPlaneUrl, requestedSubdomain === undefined ? {} : { requestedSubdomain }), (tunnel) => closeTunnelBestEffort(controlPlane, cliConfig.controlPlaneUrl, tunnel));
-    yield* Console.log(`Tunnel ready: ${tunnel.publicUrl}`);
-    yield* Console.log(`Forwarding to ${target.target.protocol}://${target.target.hostname}:${target.target.port}`);
+    yield* Console.log(formatStatus(`Tunnel ready: ${tunnel.publicUrl}`));
+    yield* Console.log(formatStatus(`Forwarding to ${target.target.protocol}://${target.target.hostname}:${target.target.port}`));
     if (config.captures.length > 0) {
         const origins = config.captures.map((capture) => formatCaptureOrigin(capture)).join(", ");
-        yield* Console.error(`Warning: captured local backends (${origins}) are exposed through this preview URL. Anyone with the link can reach them.`);
+        yield* Console.error(formatWarning(`Captured local backends (${origins}) are exposed through this preview URL. Anyone with the link can reach them.`));
     }
     yield* relay.connectAndServe(tunnel, target.target, config.captures);
 }));
@@ -354,10 +497,11 @@ const runClean = (config) => Effect.gen(function* () {
     }
     const controlPlane = yield* ControlPlaneClient;
     const cliConfig = yield* CliConfig;
-    const adminToken = Option.getOrUndefined(config.adminToken) ?? cliConfig.cleanupAdminToken;
+    const adminToken = cliConfig.adminToken;
     if (adminToken === undefined || adminToken.length === 0) {
+        yield* Console.log(renderGlobalHelp());
         return yield* Effect.fail(new CliUsageError({
-            message: "Subdomain cleanup requires an admin token. Set LOCALPREVIEW_CLEANUP_TOKEN or pass --admin-token.",
+            message: adminTokenRequiredMessage(),
         }));
     }
     if (config.all) {
@@ -380,7 +524,7 @@ const runClean = (config) => Effect.gen(function* () {
     }
     if (subdomain === undefined) {
         return yield* Effect.fail(new CliUsageError({
-            message: "Usage: localpreview clean <subdomain> [--force] [-l|--local] [--control-plane url] [--admin-token token]",
+            message: "Usage: localpreview clean <subdomain> [--force] [-l|--local] [--control-plane url]",
         }));
     }
     const validation = validateRequestedSubdomain(subdomain);
@@ -403,6 +547,23 @@ const runClean = (config) => Effect.gen(function* () {
         : ` Tunnel ${result.tunnelId} was ${result.relayStopped ? "stopped" : "removed from the store"}.`;
     yield* Console.log(`Subdomain "${result.subdomain}" cleaned.${suffix}`);
 });
+const runList = (config) => Effect.gen(function* () {
+    const controlPlane = yield* ControlPlaneClient;
+    const cliConfig = yield* CliConfig;
+    const adminToken = cliConfig.adminToken;
+    if (adminToken === undefined || adminToken.length === 0) {
+        yield* Console.log(renderGlobalHelp());
+        return yield* Effect.fail(new CliUsageError({
+            message: adminTokenRequiredMessage(),
+        }));
+    }
+    const result = yield* controlPlane.listTunnels(cliConfig.controlPlaneUrl, {
+        adminToken,
+        limit: config.limit,
+        skip: config.skip,
+    });
+    yield* Console.log(formatListTunnelsOutput(result));
+});
 const closeTunnelBestEffort = (controlPlane, controlPlaneUrl, tunnel) => controlPlane
     .closeTunnel(controlPlaneUrl, tunnel)
-    .pipe(Effect.catch((error) => Console.error(`Warning: ${errorMessage(error)}`)));
+    .pipe(Effect.catch((error) => Console.error(formatWarning(errorMessage(error)))));

package/dist/config.d.ts

@@ -1,6 +1,6 @@
 import { Context, Effect, Layer } from "effect";
 export type CliConfigShape = {
-    readonly cleanupAdminToken: string | undefined;
+    readonly adminToken: string | undefined;
     readonly controlPlaneUrl: string;
     readonly maxInFlightRequests: number;
     readonly relayConnectTimeoutMs: number;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAEhD,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;CACzC,CAAC;;AAEF,qBAAa,SAAU,SAAQ,cAAyD;CAAG;AAE3F,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AACnE,eAAO,MAAM,uBAAuB,0BAA0B,CAAC;AAE/D,MAAM,MAAM,8BAA8B,GACtC;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,GACD;IACE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;CACpB,CAAC;AAEN,gFAAgF;AAChF,eAAO,MAAM,wBAAwB,GAAI,OAAO,MAAM,KAAG,8BA4DxD,CAAC;AA2BF,eAAO,MAAM,aAAa,GAAI,OAAO;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAClC,KAAG,cAoBH,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,OAAO;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAClC,yCAAmD,CAAC;AAWrD,eAAO,MAAM,aAAa,GAAI,OAAO;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAClC,KAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAA4C,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAEhD,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;CACzC,CAAC;;AAEF,qBAAa,SAAU,SAAQ,cAAyD;CAAG;AAE3F,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AACnE,eAAO,MAAM,uBAAuB,0BAA0B,CAAC;AAE/D,MAAM,MAAM,8BAA8B,GACtC;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,GACD;IACE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;CACpB,CAAC;AAEN,gFAAgF;AAChF,eAAO,MAAM,wBAAwB,GAAI,OAAO,MAAM,KAAG,8BA4DxD,CAAC;AA2BF,eAAO,MAAM,aAAa,GAAI,OAAO;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAClC,KAAG,cAkBH,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,OAAO;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAClC,yCAAmD,CAAC;AAWrD,eAAO,MAAM,aAAa,GAAI,OAAO;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAClC,KAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAA4C,CAAC"}

package/dist/config.js

@@ -78,10 +78,9 @@ const isIpv4LoopbackAddress = (hostname) => {
 export const makeCliConfig = (input) => {
     const env = input.env ?? process.env;
     const controlPlaneUrl = input.controlPlaneUrl ?? PUBLIC_CONTROL_PLANE_URL;
-    const cleanupAdminToken = env.LOCALPREVIEW_CLEANUP_TOKEN ??
-        (controlPlaneUrl === LOCAL_CONTROL_PLANE_URL ? "local-dev-cleanup-token" : undefined);
+    const adminToken = env.LOCALPREVIEW_ADMIN_TOKEN;
     return {
-        cleanupAdminToken,
+        adminToken,
         controlPlaneUrl,
         maxInFlightRequests: readNumber(env.LOCALPREVIEW_MAX_IN_FLIGHT_REQUESTS, 100),
         relayConnectTimeoutMs: readNumber(env.LOCALPREVIEW_RELAY_CONNECT_TIMEOUT_MS, 10_000),

package/dist/control-plane.d.ts

@@ -1,4 +1,4 @@
-import { type CreateTunnelResponse } from "@localpreview/protocol";
+import { type CreateTunnelResponse, type ListTunnelsResponse } from "@localpreview/protocol";
 import { Context, Effect, Layer } from "effect";
 import { ControlPlaneError } from "./errors.js";
 export type ControlPlaneClientShape = {
@@ -15,6 +15,11 @@ export type ControlPlaneClientShape = {
     readonly createTunnel: (controlPlaneUrl: string, body: {
         readonly requestedSubdomain?: string;
     }) => Effect.Effect<CreateTunnelResponse, ControlPlaneError>;
+    readonly listTunnels: (controlPlaneUrl: string, input: {
+        readonly adminToken: string;
+        readonly limit: number;
+        readonly skip: number;
+    }) => Effect.Effect<ListTunnelsResponse, ControlPlaneError>;
 };
 export type CleanSubdomainResponse = {
     readonly cleaned: boolean;
@@ -55,5 +60,10 @@ export declare const cleanAllSubdomains: (controlPlaneUrl: string, input: {
     readonly adminToken: string;
     readonly force: boolean;
 }) => Promise<CleanAllSubdomainsResponse>;
+export declare const listTunnels: (controlPlaneUrl: string, input: {
+    readonly adminToken: string;
+    readonly limit: number;
+    readonly skip: number;
+}) => Promise<ListTunnelsResponse>;
 export {};
 //# sourceMappingURL=control-plane.d.ts.map

package/dist/control-plane.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"control-plane.d.ts","sourceRoot":"","sources":["../src/control-plane.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,oBAAoB,EAE1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAY,MAAM,QAAQ,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,kBAAkB,EAAE,CAC3B,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE;QACL,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;KACzB,KACE,MAAM,CAAC,MAAM,CAAC,0BAA0B,EAAE,iBAAiB,CAAC,CAAC;IAClE,QAAQ,CAAC,cAAc,EAAE,CACvB,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE;QACL,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;QACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC5B,KACE,MAAM,CAAC,MAAM,CAAC,sBAAsB,EAAE,iBAAiB,CAAC,CAAC;IAC9D,QAAQ,CAAC,WAAW,EAAE,CACpB,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,aAAa,GAAG,UAAU,CAAC,KAC3D,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IAC5C,QAAQ,CAAC,YAAY,EAAE,CACrB,eAAe,EAAE,MAAM,EACvB,IAAI,EAAE;QACJ,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;KACtC,KACE,MAAM,CAAC,MAAM,CAAC,oBAAoB,EAAE,iBAAiB,CAAC,CAAC;CAC7D,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAC;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,eAAe,CAAC,EAAE;QACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;YAC9B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;YAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;SAC5B,CAAC,CAAC;QACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;KACxB,CAAC;CACH,CAAC;;AAEF,qBAAa,kBAAmB,SAAQ,uBAGf;CAAG;AAE5B,eAAO,MAAM,sBAAsB,+CAWjC,CAAC;AAEH,eAAO,MAAM,YAAY,GACvB,iBAAiB,MAAM,EACvB,MAAM;IACJ,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC,KACA,OAAO,CAAC,oBAAoB,CAAiE,CAAC;AAEjG,eAAO,MAAM,WAAW,GACtB,iBAAiB,MAAM,EACvB,QAAQ,IAAI,CAAC,oBAAoB,EAAE,aAAa,GAAG,UAAU,CAAC,KAC7D,OAAO,CAAC,IAAI,CAAkE,CAAC;AAElF,eAAO,MAAM,cAAc,GACzB,iBAAiB,MAAM,EACvB,OAAO;IACL,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,KACA,OAAO,CAAC,sBAAsB,CACgC,CAAC;AAElE,eAAO,MAAM,kBAAkB,GAC7B,iBAAiB,MAAM,EACvB,OAAO;IACL,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,KACA,OAAO,CAAC,0BAA0B,CACgC,CAAC"}
+{"version":3,"file":"control-plane.d.ts","sourceRoot":"","sources":["../src/control-plane.ts"],"names":[],"mappings":"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"}

package/dist/control-plane.js

@@ -11,11 +11,13 @@ export const ControlPlaneClientLive = Layer.succeed(ControlPlaneClient)({
         while: (error) => error.retryable === true,
     })),
     createTunnel: (controlPlaneUrl, body) => createTunnelEffect(controlPlaneUrl, body),
+    listTunnels: (controlPlaneUrl, input) => listTunnelsEffect(controlPlaneUrl, input),
 });
 export const createTunnel = (controlPlaneUrl, body) => Effect.runPromise(createTunnelEffect(controlPlaneUrl, body));
 export const closeTunnel = (controlPlaneUrl, tunnel) => Effect.runPromise(closeTunnelEffect(controlPlaneUrl, tunnel));
 export const cleanSubdomain = (controlPlaneUrl, input) => Effect.runPromise(cleanSubdomainEffect(controlPlaneUrl, input));
 export const cleanAllSubdomains = (controlPlaneUrl, input) => Effect.runPromise(cleanAllSubdomainsEffect(controlPlaneUrl, input));
+export const listTunnels = (controlPlaneUrl, input) => Effect.runPromise(listTunnelsEffect(controlPlaneUrl, input));
 const createTunnelEffect = (controlPlaneUrl, body) => Effect.promise(async () => {
     let response;
     try {
@@ -31,7 +33,7 @@ const createTunnelEffect = (controlPlaneUrl, body) => Effect.promise(async () =>
         throw new ControlPlaneError({
             message: [
                 `Could not reach localpreview control-plane at ${controlPlaneUrl}.`,
-                'Use "-l" or "--local" to target a local control-plane at http://localhost:3000.',
+                'Use "-l" or "--local" as shorthand for --control-plane http://localhost:3000.',
             ].join("\n"),
             retryable: false,
         });
@@ -136,6 +138,59 @@ const cleanAllSubdomainsEffect = (controlPlaneUrl, input) => Effect.promise(asyn
     }
     return json;
 });
+const listTunnelsEffect = (controlPlaneUrl, input) => Effect.promise(async () => {
+    let response;
+    const url = new URL("/api/tunnels", controlPlaneUrl);
+    url.searchParams.set("limit", String(input.limit));
+    url.searchParams.set("skip", String(input.skip));
+    try {
+        response = await fetch(url, {
+            headers: {
+                [LOCALPREVIEW_ADMIN_TOKEN_HEADER]: input.adminToken,
+            },
+            method: "GET",
+        });
+    }
+    catch {
+        throw new ControlPlaneError({
+            message: `Could not reach localpreview control-plane at ${controlPlaneUrl}.`,
+            retryable: false,
+        });
+    }
+    const json = await readJson(response, "Tunnel listing");
+    if (!response.ok) {
+        if (response.status === 404) {
+            throw new ControlPlaneError({
+                message: [
+                    "The control-plane does not support tunnel listing yet.",
+                    "Deploy the updated control-plane, then rerun `localpreview list`.",
+                ].join(" "),
+            });
+        }
+        throw new ControlPlaneError({
+            message: json.error?.message ?? `Tunnel listing failed with HTTP ${response.status}.`,
+        });
+    }
+    return validateListTunnelsResponse(json);
+});
+const validateListTunnelsResponse = (json) => {
+    if (typeof json.total !== "number" ||
+        typeof json.skip !== "number" ||
+        typeof json.limit !== "number" ||
+        !Array.isArray(json.items) ||
+        json.counts === undefined ||
+        typeof json.counts.tracked !== "number" ||
+        typeof json.counts["redis-orphan"] !== "number" ||
+        typeof json.counts["sandbox-orphan"] !== "number") {
+        throw new ControlPlaneError({
+            message: [
+                "Tunnel listing returned an invalid response.",
+                "This usually means the control-plane is running an older LocalPreview protocol.",
+            ].join(" "),
+        });
+    }
+    return json;
+};
 const requiredCreateTunnelStringFields = [
     "tunnelId",
     "subdomain",

package/dist/index.js

@@ -2,9 +2,10 @@
 import * as NodeRuntime from "@effect/platform-node/NodeRuntime";
 import { Console, Effect } from "effect";
 import { runCli } from "./command.js";
+import { formatCliError } from "./cli-ui.js";
 import { errorMessage } from "./errors.js";
 const argv = process.argv.slice(2);
-const program = runCli(argv).pipe(Effect.catch((error) => Console.error(errorMessage(error)).pipe(Effect.andThen(Effect.sync(() => {
+const program = runCli(argv).pipe(Effect.catch((error) => Console.error(formatCliError(errorMessage(error))).pipe(Effect.andThen(Effect.sync(() => {
     process.exitCode =
         typeof error === "object" &&
             error !== null &&

package/dist/local-proxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-proxy.d.ts","sourceRoot":"","sources":["../src/local-proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,WAAW,EAEhB,KAAK,YAAY,EAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAW,OAAO,EAAE,MAAM,EAAS,KAAK,EAAO,MAAM,QAAQ,CAAC;AACrE,OAAO,KAAK,SAAS,MAAM,IAAI,CAAC;AAahC,OAAO,EAAE,SAAS,EAAuB,MAAM,aAAa,CAAC;AAC7D,OAAO,EAEL,kBAAkB,EAGnB,MAAM,aAAa,CAAC;AAWrB,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,aAAa,EAAE,CACtB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,MAAM,KACV,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;CAC9C,CAAC;;AAEF,qBAAa,UAAW,SAAQ,eAA4D;CAAG;AAE/F,eAAO,MAAM,cAAc,2CAU1B,CAAC;AA4UF,eAAO,MAAM,uBAAuB,GAAI,QAAQ,MAAM,EAAE,YAAY,MAAM,KAAG,MAqC5E,CAAC;AA0BF,eAAO,MAAM,0BAA0B,GAAI,SAAS,OAAO,KAAG,WAqB7D,CAAC"}
+{"version":3,"file":"local-proxy.d.ts","sourceRoot":"","sources":["../src/local-proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,WAAW,EAEhB,KAAK,YAAY,EAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAW,OAAO,EAAE,MAAM,EAAS,KAAK,EAAO,MAAM,QAAQ,CAAC;AACrE,OAAO,KAAK,SAAS,MAAM,IAAI,CAAC;AAchC,OAAO,EAAE,SAAS,EAAuB,MAAM,aAAa,CAAC;AAC7D,OAAO,EAEL,kBAAkB,EAGnB,MAAM,aAAa,CAAC;AAWrB,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,aAAa,EAAE,CACtB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,MAAM,KACV,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;CAC9C,CAAC;;AAEF,qBAAa,UAAW,SAAQ,eAA4D;CAAG;AAE/F,eAAO,MAAM,cAAc,2CAU1B,CAAC;AAgVF,eAAO,MAAM,uBAAuB,GAAI,QAAQ,MAAM,EAAE,YAAY,MAAM,KAAG,MAqC5E,CAAC;AA0BF,eAAO,MAAM,0BAA0B,GAAI,SAAS,OAAO,KAAG,WAqB7D,CAAC"}

package/dist/local-proxy.js

@@ -2,6 +2,7 @@ import { decodeServerRelayMessage, encodeRelayMessage, filterEndToEndHeaderPairs
 import { Console, Context, Effect, Fiber, Layer, Ref } from "effect";
 import { buildCaptureCookiePathPrefix, resolveRoute, } from "./capture-route.js";
 import { buildCaptureShimScript, buildFrontendOrigin, injectCaptureShim, isHtmlResponse, stripContentSecurityPolicy, } from "./capture-shim.js";
+import { formatRequestError, formatRequestInbound, formatRequestOutbound } from "./cli-ui.js";
 import { CliConfig } from "./config.js";
 import { LocalRequestError, RelayProtocolError, RequestLimitError, errorMessage, } from "./errors.js";
 export class LocalProxy extends Context.Service()("LocalProxy") {
@@ -51,7 +52,7 @@ const handleRequestStart = (config, requests, socket, message) => Effect.gen(fun
         totalBytes: 0,
     });
     yield* Ref.set(requests, next);
-    yield* Console.log(`-> ${message.method} ${logPath(message.path)}`);
+    yield* Console.log(formatRequestOutbound(message.method, logPath(message.path)));
 });
 const handleRequestChunk = (config, requests, socket, message) => Effect.gen(function* () {
     const current = yield* Ref.get(requests);
@@ -94,7 +95,7 @@ const handleRequestEnd = (config, requests, socket, session, message) => Effect.
         message: error.message,
         requestId: message.requestId,
         type: "response-error",
-    }).pipe(Effect.andThen(Console.log(`<- error ${logPath(request.path)} ${error.message}`)))), Effect.ensuring(Ref.update(requests, (map) => {
+    }).pipe(Effect.andThen(Console.log(formatRequestError(logPath(request.path), error.message))))), Effect.ensuring(Ref.update(requests, (map) => {
         const next = new Map(map);
         next.delete(message.requestId);
         return next;
@@ -202,7 +203,7 @@ const proxyRequest = (config, socket, session, requestId, request) => Effect.gen
         requestId,
         type: "response-end",
     });
-    yield* Console.log(`<- ${response.status} ${logPath(request.path)} ${Date.now() - startedAt}ms`);
+    yield* Console.log(formatRequestInbound(response.status, logPath(request.path), Date.now() - startedAt));
 });
 const rewriteCaptureResponseHeaders = (headers, capturePath) => {
     const pathPrefix = buildCaptureCookiePathPrefix(capturePath);

package/dist/relay-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relay-client.d.ts","sourceRoot":"","sources":["../src/relay-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAChG,OAAO,EAAW,OAAO,EAAY,MAAM,EAAE,KAAK,EAAY,MAAM,QAAQ,CAAC;AAE7E,OAAO,EAAE,SAAS,EAAuB,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAgB,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,UAAU,EAAwB,MAAM,kBAAkB,CAAC;AAEpE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,eAAe,EAAE,CACxB,MAAM,EAAE,oBAAoB,EAC5B,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,aAAa,CAAC,aAAa,CAAC,KACnC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,kBAAkB,CAAC,CAAC;CACrE,CAAC;;AAEF,qBAAa,WAAY,SAAQ,gBAA+D;CAAG;AAEnG,eAAO,MAAM,eAAe,yDAU3B,CAAC;AA6LF,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,KAAG,OAAwB,CAAC"}
+{"version":3,"file":"relay-client.d.ts","sourceRoot":"","sources":["../src/relay-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAChG,OAAO,EAAW,OAAO,EAAY,MAAM,EAAE,KAAK,EAAY,MAAM,QAAQ,CAAC;AAG7E,OAAO,EAAE,SAAS,EAAuB,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAgB,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,UAAU,EAAwB,MAAM,kBAAkB,CAAC;AAEpE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,eAAe,EAAE,CACxB,MAAM,EAAE,oBAAoB,EAC5B,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,aAAa,CAAC,aAAa,CAAC,KACnC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,kBAAkB,CAAC,CAAC;CACrE,CAAC;;AAEF,qBAAa,WAAY,SAAQ,gBAA+D;CAAG;AAEnG,eAAO,MAAM,eAAe,yDAU3B,CAAC;AA6LF,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,KAAG,OAAwB,CAAC"}

package/dist/relay-client.js

@@ -1,5 +1,6 @@
 import { Console, Context, Deferred, Effect, Layer, Schedule } from "effect";
 import WebSocket from "ws";
+import { formatRelayReconnect, formatStatus } from "./cli-ui.js";
 import { CliConfig } from "./config.js";
 import { RelayConnectionError, RelayProtocolError, errorMessage } from "./errors.js";
 import { LocalProxy } from "./local-proxy.js";
@@ -15,7 +16,7 @@ export const RelayClientLive = Layer.effect(RelayClient)(Effect.gen(function* ()
 const connectAndServe = (config, localProxy, tunnel, target, captures) => serveWithReconnect(config, localProxy, tunnel, target, captures);
 const serveWithReconnect = (config, localProxy, tunnel, target, captures) => serveOnce(config, localProxy, tunnel, target, captures).pipe(Effect.catch((error) => {
     if (error instanceof RelayConnectionError && error.retryable === true) {
-        return Console.error(`${error.message}; reconnecting...`).pipe(Effect.andThen(Effect.sleep("1 second")), Effect.andThen(serveWithReconnect(config, localProxy, tunnel, target, captures)));
+        return Console.error(formatRelayReconnect(error.message)).pipe(Effect.andThen(Effect.sleep("1 second")), Effect.andThen(serveWithReconnect(config, localProxy, tunnel, target, captures)));
     }
     return Effect.fail(error);
 }));
@@ -23,7 +24,7 @@ const serveOnce = (config, localProxy, tunnel, target, captures) => Effect.gen(f
     const socket = yield* openSocket(tunnel).pipe(Effect.retry({
         schedule: Schedule.recurs(Math.ceil(config.relayConnectTimeoutMs / 250)),
     }));
-    yield* Console.log("Connected to relay.");
+    yield* Console.log(formatStatus("Connected to relay."));
     const session = { captures, target };
     const done = yield* Deferred.make();
     const handleSignal = () => {

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const CLI_PACKAGE_VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB,QAAsB,CAAC"}

package/dist/version.js

@@ -0,0 +1,2 @@
+import packageJson from "../package.json" with { type: "json" };
+export const CLI_PACKAGE_VERSION = packageJson.version;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "localpreview",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "bin": {
     "localpreview": "./dist/index.js"
   },
@@ -10,27 +10,26 @@
     "README.md"
   ],
   "types": "./dist/index.d.ts",
+  "dependencies": {
+    "@effect/platform-node": "beta",
+    "effect": "beta",
+    "picocolors": "^1.1.1",
+    "ws": "latest",
+    "@localpreview/protocol": "0.2.2"
+  },
+  "devDependencies": {
+    "@effect/vitest": "beta",
+    "@types/node": "latest",
+    "@types/ws": "latest",
+    "tsx": "latest",
+    "typescript": "latest",
+    "vitest": "latest"
+  },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
     "dev": "tsx src/index.ts",
     "lint": "oxlint .",
-    "prepack": "pnpm build",
-    "prepublishOnly": "pnpm test && pnpm typecheck && pnpm build",
     "test": "vitest run --passWithNoTests",
     "typecheck": "tsc -p tsconfig.json --noEmit"
-  },
-  "dependencies": {
-    "@effect/platform-node": "beta",
-    "@localpreview/protocol": "^0.2.1",
-    "effect": "beta",
-    "ws": "latest"
-  },
-  "devDependencies": {
-    "@effect/vitest": "catalog:",
-    "@types/node": "catalog:",
-    "@types/ws": "catalog:",
-    "tsx": "catalog:",
-    "typescript": "catalog:",
-    "vitest": "catalog:"
   }
-}
+}