Update CLI format

Author: arjunkomath

packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@changespage/cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "bin": {
     "chp": "./dist/index.js"

packages/cli/src/commands/posts.ts

@@ -1,6 +1,7 @@
 import { Command } from "commander";
 import { ApiClient } from "../client.js";
 import { getSecretKey } from "../config.js";
+import { output } from "../formatter.js";
 
 function readStdin(): Promise<string | null> {
   if (process.stdin.isTTY) {
@@ -31,15 +32,6 @@ function getClient(cmd: Command): ApiClient {
   });
 }
 
-function output(data: unknown, cmd: Command) {
-  const opts = cmd.optsWithGlobals();
-  if (opts.pretty) {
-    console.log(JSON.stringify(data, null, 2));
-  } else {
-    console.log(JSON.stringify(data));
-  }
-}
-
 function parseTags(tags: string): string[] {
   return tags.split(",").map((t) => t.trim());
 }
@@ -51,7 +43,7 @@ export function registerPostsCommand(program: Command) {
     .command("list")
     .description("List posts")
     .option("--status <status>", "Filter by status (draft|published|archived)")
-    .option("--limit <n>", "Max number of posts", "20")
+    .option("--limit <n>", "Max number of posts", "5")
     .option("--offset <n>", "Offset for pagination", "0")
     .action(async function (this: Command) {
       const client = getClient(this);
@@ -145,6 +137,6 @@ export function registerPostsCommand(program: Command) {
     .action(async function (this: Command, id: string) {
       const client = getClient(this);
       await client.deletePost(id);
-      console.log(JSON.stringify({ deleted: true, id }));
+      output({ deleted: true, id }, this);
     });
 }

packages/cli/src/formatter.ts

@@ -0,0 +1,104 @@
+import { Command } from "commander";
+
+const isTTY = process.stdout.isTTY ?? false;
+const BOLD = isTTY ? "\x1b[1m" : "";
+const DIM = isTTY ? "\x1b[2m" : "";
+const CYAN = isTTY ? "\x1b[36m" : "";
+const RESET = isTTY ? "\x1b[0m" : "";
+
+const DATE_KEYS = new Set(["created_at", "updated_at", "publish_at", "publication_date"]);
+
+function formatValue(value: unknown, key?: string): string {
+  if (value === null || value === undefined) return "";
+  if (Array.isArray(value)) return value.join(", ");
+  if (typeof value === "object") return JSON.stringify(value);
+  if (key && DATE_KEYS.has(key) && typeof value === "string") {
+    const d = new Date(value);
+    if (!isNaN(d.getTime())) return d.toLocaleString();
+  }
+  return String(value);
+}
+
+function wrapText(str: string, width: number, indent: number): string {
+  if (width < 10) width = 10;
+  if (str.length <= width) return str;
+
+  const lines: string[] = [];
+  const pad = " ".repeat(indent);
+  let remaining = str;
+
+  while (remaining.length > 0) {
+    const max = lines.length === 0 ? width : width;
+    if (remaining.length <= max) {
+      lines.push(remaining);
+      break;
+    }
+    let breakAt = remaining.lastIndexOf(" ", max);
+    if (breakAt <= 0) breakAt = max;
+    lines.push(remaining.slice(0, breakAt));
+    remaining = remaining.slice(breakAt).trimStart();
+  }
+
+  return lines.join("\n" + pad);
+}
+
+function formatList(rows: Record<string, unknown>[]) {
+  const termWidth = process.stdout.columns ?? 80;
+
+  for (let i = 0; i < rows.length; i++) {
+    const entries = Object.entries(rows[i]).filter(([, v]) => v !== null && v !== undefined && v !== "");
+    const maxKeyLen = entries.reduce((max, [k]) => Math.max(max, k.length), 0);
+    const valueWidth = termWidth - maxKeyLen - 3;
+
+    const indent = maxKeyLen + 3;
+    for (const [key, value] of entries) {
+      const label = `${BOLD}${CYAN}${key.padEnd(maxKeyLen)}${RESET}`;
+      const formatted = wrapText(formatValue(value, key), Math.max(valueWidth, 20), indent);
+      console.log(`${label}${DIM} : ${RESET}${formatted}`);
+    }
+
+    if (i < rows.length - 1) {
+      console.log(`${DIM}${"─".repeat(Math.min(termWidth, 60))}${RESET}`);
+    }
+  }
+}
+
+function formatKeyValue(obj: Record<string, unknown>) {
+  const termWidth = process.stdout.columns ?? 80;
+  const entries = Object.entries(obj).filter(([, v]) => v !== null && v !== undefined && v !== "");
+  const maxKeyLen = entries.reduce((max, [k]) => Math.max(max, k.length), 0);
+  const valueWidth = termWidth - maxKeyLen - 3;
+  const indent = maxKeyLen + 3;
+
+  for (const [key, value] of entries) {
+    const label = `${BOLD}${CYAN}${key.padEnd(maxKeyLen)}${RESET}`;
+    const formatted = wrapText(formatValue(value, key), Math.max(valueWidth, 20), indent);
+    console.log(`${label}${DIM} : ${RESET}${formatted}`);
+  }
+}
+
+export function output(data: unknown, cmd: Command) {
+  const opts = cmd.optsWithGlobals();
+  if (opts.json) {
+    console.log(JSON.stringify(data));
+    return;
+  }
+
+  if (data === null || data === undefined) return;
+
+  if (Array.isArray(data)) {
+    if (data.length === 0) {
+      console.log(DIM + "(no results)" + RESET);
+      return;
+    }
+    formatList(data);
+    return;
+  }
+
+  if (typeof data === "object") {
+    formatKeyValue(data as Record<string, unknown>);
+    return;
+  }
+
+  console.log(String(data));
+}

packages/cli/src/index.ts

@@ -9,7 +9,7 @@ program
   .description("CLI for changes.page")
   .version("0.1.0")
   .option("--secret-key <key>", "Page secret key")
-  .option("--pretty", "Pretty-print JSON output");
+  .option("--json", "Output raw JSON");
 
 registerConfigureCommand(program);
 registerPostsCommand(program);