@throng/cli 0.1.0

package/dist/output.js

@@ -0,0 +1,46 @@
+/**
+ * Output helpers. The rule for the whole CLI: stdout carries only data a
+ * pipeline might consume (`token`, `api`, `org list`); every human-facing
+ * message goes to stderr, so `throng token | pbcopy` stays clean.
+ */
+const MAX_MESSAGE_LENGTH = 2000;
+/**
+ * Make text from a server, a file system or an exception safe to put in a
+ * terminal: control characters (escape sequences, newlines) become `?`, and the
+ * length is bounded. Unlike the 200-character cap `printable` applies to one
+ * server field, the bound here is generous enough for a whole message.
+ */
+export function sanitise(text) {
+    return text.replace(/[\u0000-\u001f\u007f-\u009f]/g, "?").slice(0, MAX_MESSAGE_LENGTH);
+}
+/** The one-line message for an error, with the errno of its cause when that is all that says why. */
+export function describeError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const cause = error instanceof Error ? error.cause : undefined;
+    return typeof cause?.code === "string" ? `${message} (${cause.code})` : message;
+}
+/**
+ * A human-facing line on stderr. Takes ONE line: `sanitise` turns newlines into
+ * `?`, which is right for server text but corrupts a multi-line message. Call it
+ * once per line.
+ */
+export function info(message) {
+    process.stderr.write(`${sanitise(message)}\n`);
+}
+/** Pretty-printed JSON on stdout. */
+export function printJson(value) {
+    process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+}
+/**
+ * A plain aligned table on stdout: a header row of the upper-cased column
+ * names, then one row per entry. Cell text is sanitised, since it comes from
+ * the server. Trailing padding is trimmed so lines compare cleanly.
+ */
+export function printTable(rows, columns) {
+    const cells = rows.map((row) => columns.map((column) => sanitise(row[column] ?? "")));
+    const header = columns.map((column) => column.toUpperCase());
+    const widths = columns.map((_, i) => Math.max(header[i].length, ...cells.map((row) => row[i].length)));
+    const line = (values) => values.map((value, i) => value.padEnd(widths[i])).join("  ").trimEnd();
+    const lines = [line(header), ...cells.map(line)];
+    process.stdout.write(`${lines.join("\n")}\n`);
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@throng/cli",
+  "version": "0.1.0",
+  "description": "Command-line client for Throng",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/col/throngx.git",
+    "directory": "cli"
+  },
+  "homepage": "https://github.com/col/throngx/tree/main/cli#readme",
+  "type": "module",
+  "bin": {
+    "throng": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.test.json",
+    "dev": "tsx src/index.ts"
+  },
+  "dependencies": {
+    "commander": "^14.0.3",
+    "open": "^11.0.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "tsx": "^4.23.15",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.11"
+  }
+}