@pocketenv/cli 0.2.4 → 0.3.0

package/package.json

@@ -4,7 +4,7 @@
   "bin": {
     "pocketenv": "dist/index.js"
   },
-  "version": "0.2.4",
+  "version": "0.3.0",
   "type": "module",
   "keywords": [
     "sandbox",

package/src/cmd/create.ts

@@ -2,8 +2,8 @@ import consola from "consola";
 import { client } from "../client";
 import getAccessToken from "../lib/getAccessToken";
 import type { Sandbox } from "../types/sandbox";
-import chalk from "chalk";
 import connectToSandbox from "./ssh";
+import { c } from "../theme";
 
 async function createSandbox(
   name: string,
@@ -21,7 +21,7 @@ async function createSandbox(
 
   if (["deno", "vercel", "daytona"].includes(provider || "")) {
     consola.error(
-      `This Sandbox Runtime is temporarily disabled. ${chalk.greenBright(provider ?? "")}`,
+      `This Sandbox Runtime is temporarily disabled. ${c.primary(provider ?? "")}`,
     );
     process.exit(1);
   }
@@ -43,7 +43,7 @@ async function createSandbox(
     );
     if (!ssh) {
       consola.success(
-        `Sandbox created successfully: ${chalk.greenBright(sandbox.data.name)}`,
+        `Sandbox created successfully: ${c.primary(sandbox.data.name)}`,
       );
       return;
     }

package/src/cmd/env.ts

@@ -2,11 +2,11 @@ import { client } from "../client";
 import getAccessToken from "../lib/getAccessToken";
 import type { Sandbox } from "../types/sandbox";
 import type { Variable } from "../types/variable";
-import chalk from "chalk";
 import dayjs from "dayjs";
 import consola from "consola";
 import Table from "cli-table3";
 import { env } from "../lib/env";
+import { c } from "../theme";
 
 export async function listEnvs(sandbox: string) {
   const token = await getAccessToken();
@@ -23,7 +23,7 @@ export async function listEnvs(sandbox: string) {
   );
 
   if (!data.sandbox) {
-    consola.error(`Sandbox not found: ${chalk.greenBright(sandbox)}`);
+    consola.error(`Sandbox not found: ${c.primary(sandbox)}`);
     process.exit(1);
   }
 
@@ -43,10 +43,10 @@ export async function listEnvs(sandbox: string) {
 
   const table = new Table({
     head: [
-      chalk.cyan("ID"),
-      chalk.cyan("NAME"),
-      chalk.cyan("VALUE"),
-      chalk.cyan("CREATED AT"),
+      c.primary("ID"),
+      c.primary("NAME"),
+      c.primary("VALUE"),
+      c.primary("CREATED AT"),
     ],
     chars: {
       top: "",
@@ -73,8 +73,8 @@ export async function listEnvs(sandbox: string) {
 
   for (const variable of response.data.variables) {
     table.push([
-      chalk.greenBright(variable.id),
-      chalk.greenBright(variable.name),
+      c.secondary(variable.id),
+      c.highlight(variable.name),
       variable.value,
       dayjs(variable.createdAt).fromNow(),
     ]);

package/src/cmd/expose.ts

@@ -0,0 +1,38 @@
+import consola from "consola";
+import getAccessToken from "../lib/getAccessToken";
+import { client } from "../client";
+import { env } from "../lib/env";
+import { c } from "../theme";
+
+export async function exposePort(
+  sandbox: string,
+  port: number,
+  description?: string,
+) {
+  const token = await getAccessToken();
+  try {
+    const response = await client.post<{ previewUrl?: string }>(
+      `/xrpc/io.pocketenv.sandbox.exposePort`,
+      { port, description },
+      {
+        params: {
+          id: sandbox,
+        },
+        headers: {
+          Authorization: `Bearer ${env.POCKETENV_TOKEN || token}`,
+        },
+      },
+    );
+
+    consola.success(
+      `Port ${c.primary(port)} exposed for sandbox ${c.primary(sandbox)}`,
+    );
+
+    if (response.data.previewUrl) {
+      consola.success(`Preview URL: ${c.secondary(response.data.previewUrl)}`);
+    }
+  } catch (error) {
+    consola.error("Failed to expose port:", error);
+    process.exit(1);
+  }
+}

package/src/cmd/file.ts

@@ -0,0 +1,139 @@
+import consola from "consola";
+import getAccessToken from "../lib/getAccessToken";
+import dayjs from "dayjs";
+import relativeTime from "dayjs/plugin/relativeTime";
+import { client } from "../client";
+import { env } from "../lib/env";
+import CliTable3 from "cli-table3";
+import type { File } from "../types/file";
+import { c } from "../theme";
+import { editor } from "@inquirer/prompts";
+import fs from "fs/promises";
+import path from "path";
+import encrypt from "../lib/sodium";
+
+dayjs.extend(relativeTime);
+
+export async function putFile(
+  sandbox: string,
+  remotePath: string,
+  localPath?: string,
+) {
+  const token = await getAccessToken();
+
+  let content: string;
+  if (!process.stdin.isTTY) {
+    const chunks: Buffer[] = [];
+    for await (const chunk of process.stdin) chunks.push(chunk);
+    content = Buffer.concat(chunks).toString().trim();
+  } else if (localPath) {
+    const resolvedPath = path.resolve(localPath);
+    try {
+      await fs.access(resolvedPath);
+    } catch (err) {
+      consola.error(`No such file: ${c.error(localPath)}`);
+      process.exit(1);
+    }
+    content = await fs.readFile(resolvedPath, "utf-8");
+  } else {
+    content = (
+      await editor({
+        message: "File content (opens in $EDITOR):",
+        waitForUserInput: false,
+      })
+    ).trim();
+  }
+
+  try {
+    await client.post(
+      "/xrpc/io.pocketenv.file.addFile",
+      {
+        file: {
+          sandboxId: sandbox,
+          path: remotePath,
+          content: await encrypt(content),
+        },
+      },
+      {
+        headers: {
+          Authorization: `Bearer ${env.POCKETENV_TOKEN || token}`,
+        },
+      },
+    );
+
+    consola.success(
+      `File ${c.primary(remotePath)} successfully created in sandbox ${c.primary(sandbox)}`,
+    );
+  } catch (error) {
+    consola.error(`Failed to create file: ${error}`);
+  }
+}
+
+export async function listFiles(sandboxId: string) {
+  const token = await getAccessToken();
+
+  const response = await client.get<{ files: File[] }>(
+    "/xrpc/io.pocketenv.file.getFiles",
+    {
+      params: {
+        sandboxId,
+      },
+      headers: {
+        Authorization: `Bearer ${env.POCKETENV_TOKEN || token}`,
+      },
+    },
+  );
+
+  const table = new CliTable3({
+    head: [c.primary("ID"), c.primary("PATH"), c.primary("CREATED AT")],
+    chars: {
+      top: "",
+      "top-mid": "",
+      "top-left": "",
+      "top-right": "",
+      bottom: "",
+      "bottom-mid": "",
+      "bottom-left": "",
+      "bottom-right": "",
+      left: "",
+      "left-mid": "",
+      mid: "",
+      "mid-mid": "",
+      right: "",
+      "right-mid": "",
+      middle: " ",
+    },
+    style: {
+      border: [],
+      head: [],
+    },
+  });
+
+  for (const file of response.data.files) {
+    table.push([
+      c.secondary(file.id),
+      file.path,
+      dayjs(file.createdAt).fromNow(),
+    ]);
+  }
+
+  consola.log(table.toString());
+}
+
+export async function deleteFile(id: string) {
+  const token = await getAccessToken();
+
+  try {
+    await client.post(`/xrpc/io.pocketenv.file.deleteFile`, undefined, {
+      params: {
+        id,
+      },
+      headers: {
+        Authorization: `Bearer ${env.POCKETENV_TOKEN || token}`,
+      },
+    });
+    consola.success(`File ${c.primary(id)} successfully deleted from sandbox`);
+  } catch (error) {
+    consola.error(`Failed to delete file: ${error}`);
+  }
+}

package/src/cmd/list.ts

@@ -1,5 +1,4 @@
 import { client } from "../client";
-import chalk from "chalk";
 import consola from "consola";
 import { env } from "../lib/env";
 import getAccessToken from "../lib/getAccessToken";
@@ -8,6 +7,7 @@ import Table from "cli-table3";
 import dayjs from "dayjs";
 import relativeTime from "dayjs/plugin/relativeTime";
 import type { Profile } from "../types/profile";
+import { c } from "../theme";
 dayjs.extend(relativeTime);
 
 async function listSandboxes() {
@@ -35,10 +35,10 @@ async function listSandboxes() {
 
   const table = new Table({
     head: [
-      chalk.cyan("NAME"),
-      chalk.cyan("BASE"),
-      chalk.cyan("STATUS"),
-      chalk.cyan("CREATED AT"),
+      c.primary("NAME"),
+      c.primary("BASE"),
+      c.primary("STATUS"),
+      c.primary("CREATED AT"),
     ],
     chars: {
       top: "",
@@ -65,10 +65,10 @@ async function listSandboxes() {
 
   for (const sandbox of response.data.sandboxes) {
     table.push([
-      chalk.greenBright(sandbox.name),
+      c.secondary(sandbox.name),
       sandbox.baseSandbox,
       sandbox.status === "RUNNING"
-        ? chalk.greenBright(sandbox.status)
+        ? c.highlight(sandbox.status)
         : sandbox.status,
       dayjs(sandbox.createdAt).fromNow(),
     ]);

package/src/cmd/ports.ts

@@ -0,0 +1,63 @@
+import chalk from "chalk";
+import { client } from "../client";
+import { env } from "../lib/env";
+import getAccessToken from "../lib/getAccessToken";
+import type { Port } from "../types/port";
+import CliTable3 from "cli-table3";
+import consola from "consola";
+import { c } from "../theme";
+
+export async function listPorts(sandbox: string) {
+  const token = await getAccessToken();
+
+  const response = await client.get<{ ports: Port[] }>(
+    "/xrpc/io.pocketenv.sandbox.getExposedPorts",
+    {
+      params: {
+        id: sandbox,
+      },
+      headers: {
+        Authorization: `Bearer ${env.POCKETENV_TOKEN || token}`,
+      },
+    },
+  );
+
+  const table = new CliTable3({
+    head: [
+      c.primary("PORT"),
+      c.primary("DESCRIPTION"),
+      c.primary("PREVIEW URL"),
+    ],
+    chars: {
+      top: "",
+      "top-mid": "",
+      "top-left": "",
+      "top-right": "",
+      bottom: "",
+      "bottom-mid": "",
+      "bottom-left": "",
+      "bottom-right": "",
+      left: "",
+      "left-mid": "",
+      mid: "",
+      "mid-mid": "",
+      right: "",
+      "right-mid": "",
+      middle: " ",
+    },
+    style: {
+      border: [],
+      head: [],
+    },
+  });
+
+  for (const port of response.data.ports) {
+    table.push([
+      c.secondary(port.port),
+      port.description || "-",
+      c.link(port.previewUrl || "-"),
+    ]);
+  }
+
+  consola.log(table.toString());
+}

package/src/cmd/secret.ts

@@ -10,6 +10,7 @@ import dayjs from "dayjs";
 import relativeTime from "dayjs/plugin/relativeTime";
 import { env } from "../lib/env";
 import encrypt from "../lib/sodium";
+import { c } from "../theme";
 
 dayjs.extend(relativeTime);
 
@@ -41,7 +42,7 @@ export async function listSecrets(sandbox: string) {
   );
 
   const table = new Table({
-    head: [chalk.cyan("ID"), chalk.cyan("NAME"), chalk.cyan("CREATED AT")],
+    head: [c.primary("ID"), c.primary("NAME"), c.primary("CREATED AT")],
     chars: {
       top: "",
       "top-mid": "",
@@ -67,8 +68,8 @@ export async function listSecrets(sandbox: string) {
 
   for (const secret of response.data.secrets) {
     table.push([
-      chalk.greenBright(secret.id),
-      chalk.greenBright(secret.name),
+      c.secondary(secret.id),
+      c.highlight(secret.name),
       dayjs(secret.createdAt).fromNow(),
     ]);
   }
@@ -78,7 +79,15 @@ export async function listSecrets(sandbox: string) {
 
 export async function putSecret(sandbox: string, key: string) {
   const token = await getAccessToken();
-  const value = await password({ message: "Enter secret value" });
+  const isStdinPiped = !process.stdin.isTTY;
+  const value = isStdinPiped
+    ? await new Promise<string>((resolve) => {
+        let data = "";
+        process.stdin.setEncoding("utf8");
+        process.stdin.on("data", (chunk) => (data += chunk));
+        process.stdin.on("end", () => resolve(data.trimEnd()));
+      })
+    : await password({ message: "Enter secret value" });
 
   const { data } = await client.get("/xrpc/io.pocketenv.sandbox.getSandbox", {
     params: {
@@ -94,21 +103,27 @@ export async function putSecret(sandbox: string, key: string) {
     process.exit(1);
   }
 
-  await client.post(
-    "/xrpc/io.pocketenv.secret.addSecret",
-    {
-      secret: {
-        sandboxId: data.sandbox.id,
-        name: key,
-        value: await encrypt(value),
+  try {
+    await client.post(
+      "/xrpc/io.pocketenv.secret.addSecret",
+      {
+        secret: {
+          sandboxId: data.sandbox.id,
+          name: key,
+          value: await encrypt(value),
+        },
       },
-    },
-    {
-      headers: {
-        Authorization: `Bearer ${env.POCKETENV_TOKEN || token}`,
+      {
+        headers: {
+          Authorization: `Bearer ${env.POCKETENV_TOKEN || token}`,
+        },
       },
-    },
-  );
+    );
+
+    consola.success("Secret added successfully");
+  } catch (error) {
+    consola.error("Failed to add secret:", error);
+  }
 }
 
 export async function deleteSecret(id: string) {
@@ -125,7 +140,7 @@ export async function deleteSecret(id: string) {
     });
 
     consola.success("Secret deleted successfully");
-  } catch {
-    consola.error("Failed to delete secret");
+  } catch (error) {
+    consola.error("Failed to delete secret:", error);
   }
 }

package/src/cmd/ssh/tty.ts

@@ -129,7 +129,16 @@ async function ssh(sandbox: Sandbox): Promise<void> {
     process.stdin.resume();
 
     // stdin → POST /tty/:id/input
+    // In raw mode the OS never raises SIGINT — Ctrl+C arrives as a raw byte
+    // in the data stream and is forwarded to the remote shell as-is.
+    // We use Ctrl+K (\x0b) as a local-only escape hatch to avoid conflicting
+    // with Ctrl+C semantics inside the remote shell.
     process.stdin.on("data", (chunk: Buffer) => {
+      if (chunk.includes(0x0b)) {
+        // Ctrl+K pressed — tear down immediately without waiting for the server.
+        teardown(0);
+        return;
+      }
       sendInput(ttyUrl, sandbox.id, chunk, authToken);
     });
 
@@ -195,11 +204,18 @@ async function ssh(sandbox: Sandbox): Promise<void> {
   es.onerror = (err: ErrorEvent) => {
     // The eventsource package exposes readyState on the EventSource instance.
     if (es && es.readyState === EventSource.CLOSED) {
-      const detail = err.message ? ` (${err.message})` : "";
-      process.stderr.write(
-        `\r\n${chalk.red(`Terminal connection lost${detail}`)}\r\n`,
-      );
-      teardown(1);
+      // If the shell exited cleanly the server will close the SSE stream with
+      // no error message.  Treat a message-less close as a graceful exit (code
+      // 0) rather than a connection error, so the user isn't shown a red
+      // "connection lost" banner after a normal `exit`.
+      if (!err.message) {
+        teardown(0);
+      } else {
+        process.stderr.write(
+          `\r\n${chalk.red(`Terminal connection lost (${err.message})`)}\r\n`,
+        );
+        teardown(1);
+      }
     }
   };
 

package/src/cmd/start.ts

@@ -3,8 +3,9 @@ import chalk from "chalk";
 import getAccessToken from "../lib/getAccessToken";
 import { client } from "../client";
 import { env } from "../lib/env";
+import connectToSandbox from "./ssh";
 
-async function start(name: string) {
+async function start(name: string, { ssh }: { ssh?: boolean }) {
   const token = await getAccessToken();
 
   try {
@@ -17,6 +18,11 @@ async function start(name: string) {
       },
     });
 
+    if (ssh) {
+      await connectToSandbox(name);
+      return;
+    }
+
     consola.success(`Sandbox ${chalk.greenBright(name)} started`);
     consola.log(
       `Run ${chalk.greenBright(`pocketenv console ${name}`)} to access the sandbox`,

package/src/cmd/tailscale.ts

@@ -3,10 +3,10 @@ import getAccessToken from "../lib/getAccessToken";
 import { client } from "../client";
 import type { Sandbox } from "../types/sandbox";
 import consola from "consola";
-import chalk from "chalk";
 import type { TailscaleAuthKey } from "../types/tailscale-auth-key";
 import { env } from "../lib/env";
 import encrypt from "../lib/sodium";
+import { c } from "../theme";
 
 export async function putAuthKey(sandbox: string) {
   const token = await getAccessToken();
@@ -33,7 +33,7 @@ export async function putAuthKey(sandbox: string) {
   );
 
   if (!data.sandbox) {
-    consola.error(`Sandbox not found: ${chalk.greenBright(sandbox)}`);
+    consola.error(`Sandbox not found: ${c.primary(sandbox)}`);
     process.exit(1);
   }
 
@@ -60,7 +60,7 @@ export async function putAuthKey(sandbox: string) {
 
   consola.success(redacted);
   consola.success(
-    `Tailscale auth key saved for sandbox: ${chalk.greenBright(sandbox)}`,
+    `Tailscale auth key saved for sandbox: ${c.primary(sandbox)}`,
   );
 }
 
@@ -80,7 +80,7 @@ export async function getTailscaleAuthKey(sandbox: string) {
   );
 
   if (!data.sandbox) {
-    consola.error(`Sandbox not found: ${chalk.greenBright(sandbox)}`);
+    consola.error(`Sandbox not found: ${c.primary(sandbox)}`);
     process.exit(1);
   }
 
@@ -96,10 +96,10 @@ export async function getTailscaleAuthKey(sandbox: string) {
         },
       },
     );
-    consola.info(`Tailscale auth key: ${chalk.greenBright(tailscale.authKey)}`);
+    consola.info(`Tailscale auth key: ${c.primary(tailscale.authKey)}`);
   } catch {
     consola.error(
-      `No Tailscale Auth Key found for sandbox: ${chalk.greenBright(sandbox)}`,
+      `No Tailscale Auth Key found for sandbox: ${c.primary(sandbox)}`,
     );
     process.exit(1);
   }

package/src/cmd/unexpose.ts

@@ -0,0 +1,31 @@
+import consola from "consola";
+import getAccessToken from "../lib/getAccessToken";
+import { client } from "../client";
+import { env } from "../lib/env";
+import { c } from "../theme";
+
+export async function unexposePort(sandbox: string, port: number) {
+  const token = await getAccessToken();
+
+  try {
+    await client.post(
+      `/xrpc/io.pocketenv.sandbox.unexposePort`,
+      { port },
+      {
+        params: {
+          id: sandbox,
+        },
+        headers: {
+          Authorization: `Bearer ${env.POCKETENV_TOKEN || token}`,
+        },
+      },
+    );
+
+    consola.success(
+      `Port ${c.primary(port)} unexposed for sandbox ${c.primary(sandbox)}`,
+    );
+  } catch (error) {
+    consola.error(`Failed to unexpose port: ${error}`);
+    process.exit(1);
+  }
+}