htmlhost-cli 1.7.0 → 1.8.0

package/README.md

@@ -70,14 +70,18 @@ Add a `404.html` file and it will be served automatically for missing pages.
 | Option | Description |
 |---|---|
 | `--ttl <value>` | Set expiry: `1d`, `7d`, `30d`, `never` |
-| `--slug <slug>` | Re-deploy to an existing site (single file only) |
-| `--title <title>` | Set the site title (single file only) |
+| `--slug <slug>` | Re-deploy to an existing site |
+| `--title <title>` | Set the site title |
 | `--new` | Force new sites (ignore .htmlhost link) |
 | `--no-assets` | Skip automatic asset uploading |
 | `--pages` | Deploy directory as one multi-page site |
+| `--json` | Output result as JSON (for CI/CD) |
 
 ### `htmlhost list`
-List all your sites with URLs, sizes, and expiry.
+List all your sites with titles, sizes, TTL, and expiry. Multi-page sites are marked with 📄.
+
+### `htmlhost open <slug>`
+Open a deployed site in the default browser.
 
 ### `htmlhost delete <slug>`
 Delete a site. Use `--force` to skip confirmation.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "htmlhost-cli",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "Deploy HTML files from the terminal — htmlhost.co CLI",
   "type": "module",
   "bin": {

package/src/cli.mjs

@@ -4,7 +4,7 @@
 import { bold, dim, cyan, err } from "./ui.mjs";
 import { ApiError } from "./api.mjs";
 
-const VERSION = "1.7.0";
+const VERSION = "1.8.0";
 
 const HELP = `
   ${bold("htmlhost")} ${dim(`v${VERSION}`)} — deploy HTML from the terminal
@@ -17,6 +17,7 @@ const HELP = `
     ${cyan("htmlhost login")}                    Authenticate with an API token
     ${cyan("htmlhost whoami")}                   Show current user
     ${cyan("htmlhost logout")}                   Remove saved token
+    ${cyan("htmlhost open")} <slug>              Open a site in the browser
 
   ${bold("Deploy options:")}
     --ttl <value>     Set TTL: 1d, 7d, 30d, never
@@ -44,6 +45,7 @@ const HELP = `
     ${dim("$")} htmlhost deploy . --pages      ${dim("# multi-page site from dir")}
     ${dim("$")} htmlhost deploy --ttl 30d      ${dim("# deploy with 30-day TTL")}
     ${dim("$")} htmlhost deploy --new          ${dim("# force new sites")}
+    ${dim("$")} htmlhost deploy index.html --json  ${dim("# JSON output for CI/CD")}
     ${dim("$")} htmlhost upload logo.png
     ${dim("$")} htmlhost delete old-project --force
 
@@ -54,6 +56,14 @@ export async function run(argv) {
   const command = argv[0];
   const args = argv.slice(1);
 
+  // Global --json flag — suppress human output, print JSON
+  const jsonMode = args.includes("--json");
+  if (jsonMode) {
+    const filtered = args.filter((a) => a !== "--json");
+    args.length = 0;
+    args.push(...filtered);
+  }
+
   if (!command || command === "help" || command === "--help" || command === "-h") {
     console.log(HELP);
     return;
@@ -83,13 +93,13 @@ export async function run(argv) {
       }
       case "deploy": {
         const { deploy } = await import("./commands/deploy.mjs");
-        await deploy(args);
+        await deploy(args, { json: jsonMode });
         break;
       }
       case "list":
       case "ls": {
         const { list } = await import("./commands/list.mjs");
-        await list();
+        await list({ json: jsonMode });
         break;
       }
       case "delete":
@@ -103,6 +113,11 @@ export async function run(argv) {
         await upload(args);
         break;
       }
+      case "open": {
+        const { open } = await import("./commands/open.mjs");
+        await open(args);
+        break;
+      }
       default:
         err(`Unknown command: ${command}`);
         console.log(`  Run ${cyan("htmlhost --help")} for usage.`);

package/src/commands/deploy.mjs

@@ -58,11 +58,12 @@ function promptChoice(question, options) {
  * - Remembers the site(s) via .htmlhost file (auto re-deploy)
  * - Use --new to force fresh deploys
  */
-export async function deploy(args) {
+export async function deploy(args, { json = false } = {}) {
   let file = args.find((a) => !a.startsWith("--"));
 
   const ttl = getFlag(args, "--ttl");
   const title = getFlag(args, "--title");
+  const slug = getFlag(args, "--slug");
   const forceNew = args.includes("--new");
   const skipAssets = args.includes("--no-assets");
   const multiPage = args.includes("--pages");
@@ -74,7 +75,7 @@ export async function deploy(args) {
       const stat = statSync(filePath);
       if (stat.isDirectory()) {
         if (multiPage) {
-          return deployMultiPage(filePath, { ttl, title, forceNew, skipAssets });
+          return deployMultiPage(filePath, { ttl, title, slug, forceNew, skipAssets, json });
         }
         return deployDirectory(filePath, { ttl, forceNew, skipAssets });
       }
@@ -85,7 +86,7 @@ export async function deploy(args) {
 
   // --pages without explicit dir defaults to cwd
   if (multiPage && !file) {
-    return deployMultiPage(resolve("."), { ttl, title, forceNew, skipAssets });
+    return deployMultiPage(resolve("."), { ttl, title, slug, forceNew, skipAssets, json });
   }
 
   // Default to index.html in the current directory
@@ -102,13 +103,13 @@ export async function deploy(args) {
   }
 
   // Single-file deploy
-  await deploySingleFile(file, { ttl, title, forceNew, skipAssets, slug: getFlag(args, "--slug") });
+  await deploySingleFile(file, { ttl, title, forceNew, skipAssets, slug, json });
 }
 
 /**
  * Deploy a single HTML file.
  */
-async function deploySingleFile(file, { ttl, title, forceNew, skipAssets, slug }) {
+async function deploySingleFile(file, { ttl, title, forceNew, skipAssets, slug, json }) {
   const filePath = resolve(file);
   const projectDir = dirname(filePath);
   const fileName = basename(filePath);
@@ -238,6 +239,11 @@ async function deploySingleFile(file, { ttl, title, forceNew, skipAssets, slug }
     });
   }
 
+  if (json) {
+    console.log(JSON.stringify(data));
+    return;
+  }
+
   console.log("");
   ok(`${bold("Live")} at ${cyan(`https://${data.url}`)}`);
   if (data.version > 1) {
@@ -412,7 +418,7 @@ async function deployDirectory(dirPath, { ttl, forceNew, skipAssets }) {
  *   blog/index.html → /blog
  *   blog/post.html → /blog/post
  */
-async function deployMultiPage(dirPath, { ttl, title, forceNew, skipAssets }) {
+async function deployMultiPage(dirPath, { ttl, title, slug: explicitSlug, forceNew, skipAssets, json }) {
   // Find all .html files (recursive) — skip dotfiles
   const htmlFiles = findHtmlFiles(dirPath, dirPath);
 
@@ -423,7 +429,7 @@ async function deployMultiPage(dirPath, { ttl, title, forceNew, skipAssets }) {
 
   // Read existing link data
   const link = readLink(dirPath);
-  const existingSlug = (!forceNew && link?.multipage?.slug) || null;
+  const existingSlug = explicitSlug || (!forceNew && link?.multipage?.slug) || null;
 
   console.log("");
   info(`Multi-page deploy: ${cyan(bold(String(htmlFiles.length)))} page${htmlFiles.length > 1 ? "s" : ""} in ${cyan(basename(dirPath) || ".")}`);
@@ -484,6 +490,11 @@ async function deployMultiPage(dirPath, { ttl, title, forceNew, skipAssets }) {
       assets: Object.fromEntries(persistedCache),
     });
 
+    if (json) {
+      console.log(JSON.stringify(data));
+      return;
+    }
+
     console.log("");
     console.log(`  ${green("━".repeat(40))}`);
     ok(`${bold("Live")} at ${cyan(`https://${data.url}`)}`);

package/src/commands/list.mjs

@@ -4,8 +4,14 @@ import { dim, cyan, bold, formatBytes, yellow } from "../ui.mjs";
 /**
  * htmlhost list — show all sites.
  */
-export async function list() {
+export async function list({ json = false } = {}) {
   const data = await get("/api/sites");
+
+  if (json) {
+    console.log(JSON.stringify(data));
+    return;
+  }
+
   const sites = data.sites || [];
 
   if (sites.length === 0) {
@@ -17,11 +23,14 @@ export async function list() {
 
   console.log("");
 
-  // Table header
-  const slugW = Math.max(20, ...sites.map((s) => s.slug.length)) + 2;
+  // Compute column widths dynamically
+  const slugW = Math.max(14, ...sites.map((s) => s.slug.length)) + 2;
+  const titleW = Math.max(10, ...sites.map((s) => (s.title || "").length).filter((n) => n < 30)) + 2;
+  const clampedTitleW = Math.min(titleW, 30);
+
   const hdr = [
     pad("SLUG", slugW),
-    pad("URL", 38),
+    pad("TITLE", clampedTitleW),
     pad("SIZE", 10),
     pad("TTL", 8),
     pad("EXPIRES", 14),
@@ -32,8 +41,10 @@ export async function list() {
   for (const s of sites) {
     const expires = s.expiresAt ? relTime(s.expiresAt) : "never";
     const expiresColor = s.expiresAt && new Date(s.expiresAt) < new Date() ? yellow : dim;
+    const multiIndicator = s.isMultiPage ? "📄 " : "";
+    const title = truncate(s.title && s.title !== s.slug ? s.title : "", clampedTitleW - 2);
     console.log(
-      `  ${pad(cyan(s.slug), slugW)}${pad(`${s.slug}.htmlhost.co`, 38)}${pad(s.size, 10)}${pad(s.ttl, 8)}${expiresColor(expires)}`
+      `  ${pad(cyan(multiIndicator + s.slug), slugW + (multiIndicator ? 2 : 0))}${pad(dim(title), clampedTitleW)}${pad(s.size, 10)}${pad(s.ttl, 8)}${expiresColor(expires)}`
     );
   }
 
@@ -48,7 +59,14 @@ export async function list() {
 
 function pad(str, width) {
   const s = String(str);
-  return s + " ".repeat(Math.max(0, width - s.length));
+  // Account for ANSI escape codes in string length
+  const visible = s.replace(/\x1b\[[0-9;]*m/g, "");
+  return s + " ".repeat(Math.max(0, width - visible.length));
+}
+
+function truncate(str, max) {
+  if (str.length <= max) return str;
+  return str.slice(0, max - 1) + "…";
 }
 
 function relTime(iso) {

package/src/commands/open.mjs

@@ -0,0 +1,29 @@
+import { exec } from "node:child_process";
+import { err, cyan, bold, ok } from "../ui.mjs";
+
+/**
+ * htmlhost open <slug> — open a site in the browser.
+ */
+export async function open(args) {
+  const slug = args.find((a) => !a.startsWith("--"));
+  if (!slug) {
+    err("Usage: htmlhost open <slug>");
+    process.exit(1);
+  }
+
+  const url = `https://${slug}.htmlhost.co`;
+  ok(`Opening ${cyan(bold(url))}…`);
+
+  // Cross-platform open command
+  const cmd =
+    process.platform === "darwin" ? "open" :
+    process.platform === "win32" ? "start" :
+    "xdg-open";
+
+  exec(`${cmd} ${url}`, (error) => {
+    if (error) {
+      err(`Could not open browser: ${error.message}`);
+      console.log(`  ${url}`);
+    }
+  });
+}