@monotykamary/localterm 0.0.15

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aiden Bai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,66 @@
+# localterm
+
+[![version](https://img.shields.io/npm/v/@monotykamary/localterm?style=flat&colorA=000000&colorB=000000)](https://npmjs.com/package/@monotykamary/localterm)
+[![downloads](https://img.shields.io/npm/dt/@monotykamary/localterm.svg?style=flat&colorA=000000&colorB=000000)](https://npmjs.com/package/@monotykamary/localterm)
+
+Your terminal should just be a browser tab.
+
+Run `npx @monotykamary/localterm@latest start` and every browser tab is one shell. Open a new tab to spawn another. Close the tab to kill it. That's the whole product.
+
+![demo](https://www.localterm.dev/demo.png)
+
+## Install
+
+Run this command anywhere:
+
+```bash
+npx @monotykamary/localterm@latest start
+```
+
+This boots a local daemon and opens [`http://localterm.localhost:3417`](http://localterm.localhost:3417) in your browser. (`*.localhost` is reserved by [RFC 6761](https://datatracker.ietf.org/doc/html/rfc6761) and resolves to `127.0.0.1` in every modern browser, so no `/etc/hosts` edit needed.)
+
+To install globally:
+
+```bash
+npm install -g @monotykamary/localterm
+localterm start
+```
+
+## Usage
+
+The mental model is **shell = browser tab**:
+
+- **New tab** → new shell
+- **Close tab** → shell dies immediately
+- **Reload tab** → fresh shell (the prior one is gone)
+
+No session ids, no URL slugs, no reconnects. If you want a long-lived shell that survives reloads, run `tmux` _inside_ localterm.
+
+## CLI
+
+```bash
+localterm start [-p 3417] [-H 127.0.0.1] [--no-open]   # daemonizes by default
+localterm stop
+localterm status
+localterm restart
+```
+
+State lives in `~/.localterm/` (PID, port, server log at `~/.localterm/server.log`).
+
+## Security
+
+- By default, binds loopback hosts only: `127.0.0.1`, `localhost`, `*.localhost`, `::1`, and enforces loopback `Host`/`Origin` headers to defeat DNS-rebinding attacks.
+- Pass `-H 0.0.0.0` (or any non-loopback address) to expose the server on all network interfaces. Loopback header enforcement is disabled in this mode — only use on trusted networks (e.g. Tailscale, a home LAN behind a firewall).
+- One PTY per WebSocket. Closing the tab kills the shell — no orphaned processes.
+
+## Resources & Contributing Back
+
+Looking to contribute back? Check out the [Contributing Guide](https://github.com/millionco/localterm/blob/main/CONTRIBUTING.md) and [`AGENTS.md`](https://github.com/millionco/localterm/blob/main/AGENTS.md) for code style.
+
+Find a bug? Head over to our [issue tracker](https://github.com/millionco/localterm/issues) and we'll do our best to help. We love pull requests, too!
+
+[**→ Start contributing on GitHub**](https://github.com/millionco/localterm/blob/main/CONTRIBUTING.md)
+
+### License
+
+localterm is MIT-licensed open-source software.

package/bin/localterm.mjs

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../dist/index.js";

package/dist/commands/restart.d.ts

@@ -0,0 +1,7 @@
+export interface RestartOptions {
+    port: number;
+    host: string;
+    open: boolean;
+}
+export declare const runRestart: (options: RestartOptions) => Promise<void>;
+//# sourceMappingURL=restart.d.ts.map

package/dist/commands/restart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart.d.ts","sourceRoot":"","sources":["../../src/commands/restart.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf;AAED,eAAO,MAAM,UAAU,GAAU,SAAS,cAAc,KAAG,OAAO,CAAC,IAAI,CAoCtE,CAAC"}

package/dist/commands/restart.js

@@ -0,0 +1,43 @@
+import { openSync } from "node:fs";
+import kleur from "kleur";
+import { DAEMON_PROBE_INTERVAL_MS, DAEMON_PROBE_MAX_WAIT_MS } from "../constants.js";
+import { cliError, exitCodeForCliError } from "../errors.js";
+import { ensureLogFile, isAlive, readPort } from "../state.js";
+import { buildDaemonStartArgs } from "../utils/build-daemon-args.js";
+import { pollForDaemonReady } from "../utils/poll-for-daemon-ready.js";
+import { reportCliError } from "../utils/report-cli-error.js";
+import { sleep } from "../utils/sleep.js";
+import { spawnDaemon } from "../utils/spawn-daemon.js";
+import { runStop } from "./stop.js";
+export const runRestart = async (options) => {
+    await runStop();
+    const portBeforeSpawn = readPort();
+    const logPath = ensureLogFile();
+    const logFd = openSync(logPath, "a");
+    const { pid: childPid } = spawnDaemon({
+        args: buildDaemonStartArgs(options),
+        logFd,
+    });
+    if (childPid === undefined) {
+        const error = cliError.daemonSpawnFailed(process.execPath, logPath);
+        reportCliError(error);
+        process.exit(exitCodeForCliError(error));
+    }
+    const result = await pollForDaemonReady({
+        childPid,
+        initialPort: portBeforeSpawn,
+        intervalMs: DAEMON_PROBE_INTERVAL_MS,
+        maxWaitMs: DAEMON_PROBE_MAX_WAIT_MS,
+        logPath,
+        isAlive,
+        readPort,
+        sleep,
+    });
+    if (result.ok) {
+        console.log(kleur.green(`✔ restarted (pid ${childPid}, port ${result.port}, logs: ${logPath})`));
+        return;
+    }
+    reportCliError(result.error);
+    process.exit(exitCodeForCliError(result.error));
+};
+//# sourceMappingURL=restart.js.map

package/dist/commands/restart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart.js","sourceRoot":"","sources":["../../src/commands/restart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAAE,OAAuB,EAAiB,EAAE;IACzE,MAAM,OAAO,EAAE,CAAC;IAChB,MAAM,eAAe,GAAG,QAAQ,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACrC,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAC;QACpC,IAAI,EAAE,oBAAoB,CAAC,OAAO,CAAC;QACnC,KAAK;KACN,CAAC,CAAC;IAEH,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,QAAQ,CAAC,iBAAiB,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACpE,cAAc,CAAC,KAAK,CAAC,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC;QACtC,QAAQ;QACR,WAAW,EAAE,eAAe;QAC5B,UAAU,EAAE,wBAAwB;QACpC,SAAS,EAAE,wBAAwB;QACnC,OAAO;QACP,OAAO;QACP,QAAQ;QACR,KAAK;KACN,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,KAAK,CAAC,oBAAoB,QAAQ,UAAU,MAAM,CAAC,IAAI,WAAW,OAAO,GAAG,CAAC,CACpF,CAAC;QACF,OAAO;IACT,CAAC;IAED,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AAClD,CAAC,CAAC"}

package/dist/commands/start.d.ts

@@ -0,0 +1,9 @@
+export interface StartOptions {
+    port: number;
+    host: string;
+    open: boolean;
+    foreground: boolean;
+}
+export declare const runStart: (options: StartOptions) => Promise<void>;
+export declare const startDefaults: StartOptions;
+//# sourceMappingURL=start.d.ts.map

package/dist/commands/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/commands/start.ts"],"names":[],"mappings":"AAwCA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;CACrB;AAID,eAAO,MAAM,QAAQ,GAAU,SAAS,YAAY,KAAG,OAAO,CAAC,IAAI,CAMlE,CAAC;AA+IF,eAAO,MAAM,aAAa,EAAE,YAK3B,CAAC"}

package/dist/commands/start.js

@@ -0,0 +1,168 @@
+import { existsSync, openSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { createServer, DEFAULT_HOST, DEFAULT_PORT } from "@monotykamary/localterm-server";
+import kleur from "kleur";
+import open from "open";
+import { DAEMON_CHILD_ENV_FLAG, DAEMON_PROBE_INTERVAL_MS, DAEMON_PROBE_MAX_WAIT_MS, DAEMON_PROCESS_TITLE, EXIT_FAILURE, EXIT_OK, FORCE_EXIT_TIMEOUT_MS, getFriendlyUrl, STOP_COMMAND, } from "../constants.js";
+import { cliError, exitCodeForCliError } from "../errors.js";
+import { clearPid, ensureLogFile, isAlive, readPort, writePid } from "../state.js";
+import { buildDaemonStartArgs } from "../utils/build-daemon-args.js";
+import { pollForDaemonReady } from "../utils/poll-for-daemon-ready.js";
+import { reportCliError } from "../utils/report-cli-error.js";
+import { runStartPreflight } from "../utils/run-start-preflight.js";
+import { sleep } from "../utils/sleep.js";
+import { spawnDaemon } from "../utils/spawn-daemon.js";
+const moduleDir = path.dirname(fileURLToPath(import.meta.url));
+const resolveStaticRoot = () => {
+    const candidates = [
+        path.resolve(moduleDir, "../../../../apps/terminal/dist"),
+        path.resolve(moduleDir, "../../terminal"),
+        path.resolve(moduleDir, "../terminal"),
+    ];
+    for (const candidate of candidates) {
+        if (existsSync(path.join(candidate, "index.html")))
+            return candidate;
+    }
+    return null;
+};
+const isRunningAsDaemonChild = () => process.env[DAEMON_CHILD_ENV_FLAG] === "1";
+export const runStart = async (options) => {
+    if (options.foreground || isRunningAsDaemonChild()) {
+        await runStartInForeground(options);
+        return;
+    }
+    await runStartAsDaemon(options);
+};
+const runStartAsDaemon = async (options) => {
+    const preflightError = runStartPreflight();
+    if (preflightError !== null) {
+        reportCliError(preflightError);
+        process.exit(exitCodeForCliError(preflightError));
+    }
+    const portBeforeSpawn = readPort();
+    const logPath = ensureLogFile();
+    const logFd = openSync(logPath, "a");
+    const { pid: childPid } = spawnDaemon({
+        args: buildDaemonStartArgs(options),
+        logFd,
+    });
+    if (childPid === undefined) {
+        const error = cliError.daemonSpawnFailed(process.execPath, logPath);
+        reportCliError(error);
+        process.exit(exitCodeForCliError(error));
+    }
+    const result = await pollForDaemonReady({
+        childPid,
+        initialPort: portBeforeSpawn,
+        intervalMs: DAEMON_PROBE_INTERVAL_MS,
+        maxWaitMs: DAEMON_PROBE_MAX_WAIT_MS,
+        logPath,
+        isAlive,
+        readPort,
+        sleep,
+    });
+    if (result.ok) {
+        printDaemonStartedBanner(result.port);
+        if (options.open)
+            await openInBrowser(getFriendlyUrl(result.port));
+        return;
+    }
+    if (result.error.kind === "daemon-ready-timeout" && isAlive(childPid)) {
+        const finalPort = readPort();
+        if (finalPort !== null && finalPort !== portBeforeSpawn) {
+            printDaemonStartedBanner(finalPort);
+            if (options.open)
+                await openInBrowser(getFriendlyUrl(finalPort));
+            return;
+        }
+    }
+    reportCliError(result.error);
+    process.exit(exitCodeForCliError(result.error));
+};
+const printDaemonStartedBanner = (port) => {
+    console.log(`${kleur.green("✔")} running at ${kleur.cyan(getFriendlyUrl(port))}`);
+    console.log(`  stop with ${kleur.bold(STOP_COMMAND)}`);
+};
+const openInBrowser = async (url) => {
+    try {
+        await open(url);
+    }
+    catch {
+        /* headless environments (CI, ssh) have no browser to open; not fatal */
+    }
+};
+const runStartInForeground = async (options) => {
+    const preflightError = runStartPreflight();
+    if (preflightError !== null) {
+        reportCliError(preflightError);
+        process.exit(exitCodeForCliError(preflightError));
+    }
+    process.title = DAEMON_PROCESS_TITLE;
+    const staticRoot = resolveStaticRoot();
+    if (!staticRoot) {
+        console.log(kleur.yellow("warning: terminal bundle not found. run 'pnpm build' first or only the API will be served."));
+    }
+    let server;
+    try {
+        server = await createServer({
+            port: options.port,
+            host: options.host,
+            staticRoot,
+        });
+    }
+    catch (caughtError) {
+        const startError = cliError.serverStartFailed(caughtError instanceof Error ? caughtError : new Error(String(caughtError)));
+        reportCliError(startError);
+        process.exit(exitCodeForCliError(startError));
+    }
+    writePid(process.pid, server.port);
+    const namedUrl = getFriendlyUrl(server.port);
+    if (isRunningAsDaemonChild()) {
+        console.log(`${kleur.green("✔")} daemon listening on ${namedUrl} (pid ${process.pid})`);
+    }
+    else {
+        console.log(`${kleur.green("✔")} running at ${kleur.cyan(namedUrl)}`);
+        console.log(`  press ${kleur.bold("Ctrl+C")} to stop`);
+    }
+    if (options.open && !isRunningAsDaemonChild())
+        await openInBrowser(namedUrl);
+    let shuttingDown = false;
+    const shutdown = async (signal) => {
+        if (shuttingDown) {
+            console.log(kleur.red("force exit"));
+            clearPid();
+            process.exit(EXIT_FAILURE);
+        }
+        shuttingDown = true;
+        console.log(`\n${kleur.dim(`received ${signal}, shutting down…`)}`);
+        const forceExit = setTimeout(() => {
+            console.log(kleur.red("forcing exit (server.stop took too long)"));
+            clearPid();
+            process.exit(EXIT_FAILURE);
+        }, FORCE_EXIT_TIMEOUT_MS);
+        forceExit.unref();
+        try {
+            await server.stop();
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.log(kleur.red(`stop error: ${message}`));
+        }
+        finally {
+            clearTimeout(forceExit);
+            clearPid();
+            process.exit(EXIT_OK);
+        }
+    };
+    process.on("SIGINT", () => void shutdown("SIGINT"));
+    process.on("SIGTERM", () => void shutdown("SIGTERM"));
+    process.on("SIGHUP", () => void shutdown("SIGHUP"));
+};
+export const startDefaults = {
+    port: DEFAULT_PORT,
+    host: DEFAULT_HOST,
+    open: false,
+    foreground: false,
+};
+//# sourceMappingURL=start.js.map

package/dist/commands/start.js.map

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

package/dist/commands/status.d.ts

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

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,SAAS,QAAa,OAAO,CAAC,IAAI,CAgC9C,CAAC"}

package/dist/commands/status.js

@@ -0,0 +1,34 @@
+import kleur from "kleur";
+import { healthSchema } from "@monotykamary/localterm-server";
+import { getFriendlyUrl } from "../constants.js";
+import { cliError } from "../errors.js";
+import { isAlive, readPid, readPort } from "../state.js";
+import { reportCliError } from "../utils/report-cli-error.js";
+export const runStatus = async () => {
+    const pid = readPid();
+    const port = readPort();
+    if (!pid || !port) {
+        console.log(kleur.dim("localterm is not running."));
+        return;
+    }
+    if (!isAlive(pid)) {
+        console.log(kleur.yellow(`pid ${pid} is gone (stale state). run 'localterm start'.`));
+        return;
+    }
+    try {
+        const response = await fetch(`http://127.0.0.1:${port}/api/health`);
+        if (!response.ok)
+            throw new Error(`health check failed: ${response.status}`);
+        const health = healthSchema.parse(await response.json());
+        console.log(kleur.green("● running"));
+        console.log(`  pid:      ${pid}`);
+        console.log(`  port:     ${port}`);
+        console.log(`  url:      ${kleur.cyan(getFriendlyUrl(port))}`);
+        console.log(`  raw:      ${kleur.dim(`http://127.0.0.1:${port}`)}`);
+        console.log(`  sessions: ${health.sessions}`);
+    }
+    catch (error) {
+        reportCliError(cliError.healthCheckFailed(pid, port, error instanceof Error ? error : new Error(String(error))));
+    }
+};
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,IAAmB,EAAE;IACjD,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;IAExB,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC,CAAC;QACpD,OAAO;IACT,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,GAAG,gDAAgD,CAAC,CAAC,CAAC;QACtF,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,oBAAoB,IAAI,aAAa,CAAC,CAAC;QACpE,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7E,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,EAAE,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,CAAC,GAAG,CAAC,oBAAoB,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACpE,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,cAAc,CACZ,QAAQ,CAAC,iBAAiB,CACxB,GAAG,EACH,IAAI,EACJ,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAC1D,CACF,CAAC;IACJ,CAAC;AACH,CAAC,CAAC"}

package/dist/commands/stop.d.ts

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

package/dist/commands/stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../../src/commands/stop.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,OAAO,QAAa,OAAO,CAAC,IAAI,CA0C5C,CAAC"}

package/dist/commands/stop.js

@@ -0,0 +1,48 @@
+import kleur from "kleur";
+import { STOP_MAX_WAIT_MS, STOP_POLL_INTERVAL_MS } from "../constants.js";
+import { cliError } from "../errors.js";
+import { clearPid, isAlive, readPid } from "../state.js";
+import { reportCliError } from "../utils/report-cli-error.js";
+import { sleep } from "../utils/sleep.js";
+import { verifyPidIsLocalterm } from "../utils/verify-pid-is-localterm.js";
+export const runStop = async () => {
+    const pid = readPid();
+    if (!pid) {
+        console.log(kleur.dim("localterm is not running."));
+        return;
+    }
+    if (!isAlive(pid)) {
+        clearPid();
+        console.log(kleur.dim("stale pid file removed."));
+        return;
+    }
+    const isOurDaemon = await verifyPidIsLocalterm(pid);
+    if (!isOurDaemon) {
+        reportCliError(cliError.pidNotOurs(pid));
+        clearPid();
+        return;
+    }
+    try {
+        process.kill(pid, "SIGTERM");
+    }
+    catch (error) {
+        reportCliError(cliError.signalFailed(pid, error instanceof Error ? error : new Error(String(error))));
+        return;
+    }
+    let waited = 0;
+    while (isAlive(pid) && waited < STOP_MAX_WAIT_MS) {
+        await sleep(STOP_POLL_INTERVAL_MS);
+        waited += STOP_POLL_INTERVAL_MS;
+    }
+    if (isAlive(pid)) {
+        try {
+            process.kill(pid, "SIGKILL");
+        }
+        catch {
+            /* process exited between SIGTERM and SIGKILL */
+        }
+    }
+    clearPid();
+    console.log(kleur.green(`✔ stopped pid ${pid}`));
+};
+//# sourceMappingURL=stop.js.map

package/dist/commands/stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.js","sourceRoot":"","sources":["../../src/commands/stop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAE3E,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,IAAmB,EAAE;IAC/C,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC,CAAC;QACpD,OAAO;IACT,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAClB,QAAQ,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,CAAC;QAClD,OAAO;IACT,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,oBAAoB,CAAC,GAAG,CAAC,CAAC;IACpD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,cAAc,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QACzC,QAAQ,EAAE,CAAC;QACX,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,cAAc,CACZ,QAAQ,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CACtF,CAAC;QACF,OAAO;IACT,CAAC;IAED,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,MAAM,GAAG,gBAAgB,EAAE,CAAC;QACjD,MAAM,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACnC,MAAM,IAAI,qBAAqB,CAAC;IAClC,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACjB,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,gDAAgD;QAClD,CAAC;IACH,CAAC;IACD,QAAQ,EAAE,CAAC;IACX,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,iBAAiB,GAAG,EAAE,CAAC,CAAC,CAAC;AACnD,CAAC,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,26 @@
+export declare const FORCE_EXIT_TIMEOUT_MS = 3000;
+export declare const STOP_POLL_INTERVAL_MS = 100;
+export declare const STOP_MAX_WAIT_MS = 5000;
+export declare const DAEMON_PROBE_INTERVAL_MS = 100;
+export declare const DAEMON_PROBE_MAX_WAIT_MS = 5000;
+export declare const VERIFY_PID_TIMEOUT_MS = 1000;
+export declare const MIN_TCP_PORT = 0;
+export declare const MAX_TCP_PORT = 65535;
+export declare const FRIENDLY_HOSTNAME = "localterm.localhost";
+export declare const STOP_COMMAND = "npx @monotykamary/localterm@latest stop";
+export declare const DAEMON_CHILD_ENV_FLAG = "LOCALTERM_DAEMON_CHILD";
+/**
+ * Distinctive process name set on the daemon at startup (via `process.title`).
+ * `localterm stop` verifies the recorded pid's kernel-reported comm matches
+ * this exact string before sending SIGTERM, so we never signal an unrelated
+ * process that happens to live at the recycled pid.
+ *
+ * Length stays under 15 chars so Linux's PR_SET_NAME (limited to TASK_COMM_LEN
+ * = 16 including the null) doesn't truncate the value differently than macOS.
+ */
+export declare const DAEMON_PROCESS_TITLE = "localtermd";
+export declare const EXIT_OK = 0;
+export declare const EXIT_FAILURE = 1;
+export declare const EXIT_USAGE_ERROR = 2;
+export declare const getFriendlyUrl: (port: number) => string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAC1C,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAC7C,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,eAAO,MAAM,YAAY,IAAI,CAAC;AAC9B,eAAO,MAAM,YAAY,QAAQ,CAAC;AAElC,eAAO,MAAM,iBAAiB,wBAAwB,CAAC;AACvD,eAAO,MAAM,YAAY,4CAA4C,CAAC;AACtE,eAAO,MAAM,qBAAqB,2BAA2B,CAAC;AAC9D;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,eAAe,CAAC;AAEjD,eAAO,MAAM,OAAO,IAAI,CAAC;AACzB,eAAO,MAAM,YAAY,IAAI,CAAC;AAC9B,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,MAA+C,CAAC"}

package/dist/constants.js

@@ -0,0 +1,26 @@
+export const FORCE_EXIT_TIMEOUT_MS = 3000;
+export const STOP_POLL_INTERVAL_MS = 100;
+export const STOP_MAX_WAIT_MS = 5000;
+export const DAEMON_PROBE_INTERVAL_MS = 100;
+export const DAEMON_PROBE_MAX_WAIT_MS = 5000;
+export const VERIFY_PID_TIMEOUT_MS = 1000;
+export const MIN_TCP_PORT = 0;
+export const MAX_TCP_PORT = 65535;
+export const FRIENDLY_HOSTNAME = "localterm.localhost";
+export const STOP_COMMAND = "npx @monotykamary/localterm@latest stop";
+export const DAEMON_CHILD_ENV_FLAG = "LOCALTERM_DAEMON_CHILD";
+/**
+ * Distinctive process name set on the daemon at startup (via `process.title`).
+ * `localterm stop` verifies the recorded pid's kernel-reported comm matches
+ * this exact string before sending SIGTERM, so we never signal an unrelated
+ * process that happens to live at the recycled pid.
+ *
+ * Length stays under 15 chars so Linux's PR_SET_NAME (limited to TASK_COMM_LEN
+ * = 16 including the null) doesn't truncate the value differently than macOS.
+ */
+export const DAEMON_PROCESS_TITLE = "localtermd";
+export const EXIT_OK = 0;
+export const EXIT_FAILURE = 1;
+export const EXIT_USAGE_ERROR = 2;
+export const getFriendlyUrl = (port) => `http://${FRIENDLY_HOSTNAME}:${port}`;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAC1C,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AACzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AACrC,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAC5C,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAC7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAE1C,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAC9B,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC;AAElC,MAAM,CAAC,MAAM,iBAAiB,GAAG,qBAAqB,CAAC;AACvD,MAAM,CAAC,MAAM,YAAY,GAAG,yCAAyC,CAAC;AACtE,MAAM,CAAC,MAAM,qBAAqB,GAAG,wBAAwB,CAAC;AAC9D;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAAC;AAEjD,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC;AACzB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAC9B,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAElC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,UAAU,iBAAiB,IAAI,IAAI,EAAE,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,101 @@
+interface InvalidPortError {
+    kind: "invalid-port";
+    code: "E_LT_CLI_INVALID_PORT";
+    severity: "error";
+    raw: string;
+    reason: string;
+}
+interface InvalidHostError {
+    kind: "invalid-host";
+    code: "E_LT_CLI_INVALID_HOST";
+    severity: "error";
+    host: string;
+}
+interface AlreadyRunningError {
+    kind: "already-running";
+    code: "E_LT_CLI_ALREADY_RUNNING";
+    severity: "warning";
+    pid: number;
+    port: number;
+}
+interface StalePortFileError {
+    kind: "stale-port-file";
+    code: "E_LT_CLI_STALE_PORT_FILE";
+    severity: "warning";
+    pid: number;
+}
+interface DaemonSpawnFailedError {
+    kind: "daemon-spawn-failed";
+    code: "E_LT_CLI_DAEMON_SPAWN_FAILED";
+    severity: "error";
+    execPath: string;
+    logPath: string;
+}
+interface DaemonDiedError {
+    kind: "daemon-died";
+    code: "E_LT_CLI_DAEMON_DIED";
+    severity: "error";
+    pid: number;
+    logPath: string;
+}
+interface DaemonReadyTimeoutError {
+    kind: "daemon-ready-timeout";
+    code: "E_LT_CLI_DAEMON_READY_TIMEOUT";
+    severity: "warning";
+    pid: number;
+    waitedMs: number;
+    logPath: string;
+}
+interface ServerStartFailedError {
+    kind: "server-start-failed";
+    code: "E_LT_CLI_SERVER_START_FAILED";
+    severity: "error";
+    cause: Error;
+}
+interface PidNotOursError {
+    kind: "pid-not-ours";
+    code: "E_LT_CLI_PID_NOT_OURS";
+    severity: "warning";
+    pid: number;
+}
+interface SignalFailedError {
+    kind: "signal-failed";
+    code: "E_LT_CLI_SIGNAL_FAILED";
+    severity: "error";
+    pid: number;
+    cause: Error;
+}
+interface HealthCheckFailedError {
+    kind: "health-check-failed";
+    code: "E_LT_CLI_HEALTH_CHECK_FAILED";
+    severity: "warning";
+    pid: number;
+    port: number;
+    cause: Error;
+}
+export type CliError = InvalidPortError | InvalidHostError | AlreadyRunningError | StalePortFileError | DaemonSpawnFailedError | DaemonDiedError | DaemonReadyTimeoutError | ServerStartFailedError | PidNotOursError | SignalFailedError | HealthCheckFailedError;
+export type CliErrorCode = CliError["code"];
+export type CliErrorKind = CliError["kind"];
+export declare const cliError: {
+    invalidPort: (raw: string, reason: string) => InvalidPortError;
+    invalidHost: (host: string) => InvalidHostError;
+    alreadyRunning: (pid: number, port: number) => AlreadyRunningError;
+    stalePortFile: (pid: number) => StalePortFileError;
+    daemonSpawnFailed: (execPath: string, logPath: string) => DaemonSpawnFailedError;
+    daemonDied: (pid: number, logPath: string) => DaemonDiedError;
+    daemonReadyTimeout: (pid: number, waitedMs: number, logPath: string) => DaemonReadyTimeoutError;
+    serverStartFailed: (cause: Error) => ServerStartFailedError;
+    pidNotOurs: (pid: number) => PidNotOursError;
+    signalFailed: (pid: number, cause: Error) => SignalFailedError;
+    healthCheckFailed: (pid: number, port: number, cause: Error) => HealthCheckFailedError;
+};
+export declare const formatCliError: (error: CliError) => string;
+export declare const hintForCliError: (error: CliError) => string | null;
+export declare const exitCodeForCliError: (error: CliError) => number;
+export declare class CliErrorException extends Error {
+    readonly error: CliError;
+    constructor(error: CliError);
+}
+export declare const isCliErrorException: (value: unknown) => value is CliErrorException;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

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