@zeegme/cli 0.1.0

package/dist/errors.js

@@ -0,0 +1,69 @@
+export const ExitCode = {
+    Ok: 0,
+    Usage: 1,
+    Auth: 2,
+    Api: 3,
+};
+export class CliError extends Error {
+    exitCode;
+    constructor(message, exitCode) {
+        super(message);
+        this.exitCode = exitCode;
+        this.name = new.target.name;
+    }
+}
+export class UsageError extends CliError {
+    constructor(message) {
+        super(message, ExitCode.Usage);
+    }
+}
+export class AuthError extends CliError {
+    constructor(message) {
+        super(message, ExitCode.Auth);
+    }
+}
+export class ApiError extends CliError {
+    constructor(message) {
+        super(message, ExitCode.Api);
+    }
+}
+/** Commander's own errors carry a `code` such as `commander.unknownOption`. */
+export function isCommanderError(error) {
+    return typeof error === 'object' && error !== null && typeof error.code === 'string'
+        && error.code.startsWith('commander.');
+}
+export function exitCodeFor(error) {
+    if (error instanceof CliError) {
+        return error.exitCode;
+    }
+    if (isCommanderError(error)) {
+        // --help and --version end through the same path with exit code 0.
+        return error.exitCode === 0 ? ExitCode.Ok : ExitCode.Usage;
+    }
+    return ExitCode.Usage;
+}
+/**
+ * The v2 API answers errors as `{ message, errors? }`; validation errors list messages per
+ * field. A 401 means the token was revoked or expired server-side, so it asks for a new login.
+ */
+export function apiErrorFrom(status, body) {
+    if (status === 401) {
+        return new AuthError('Your Zeeg session is no longer valid. Run `zeeg login` to sign in again.');
+    }
+    const record = typeof body === 'object' && body !== null ? body : {};
+    const message = typeof record.message === 'string' && record.message !== '' ? record.message : `The Zeeg API answered HTTP ${status}.`;
+    const details = record.errors && typeof record.errors === 'object'
+        ? Object.values(record.errors).flat().filter((item) => typeof item === 'string')
+        : [];
+    const unique = details.filter((detail) => detail !== message);
+    return new ApiError(unique.length > 0 ? `${message}\n- ${unique.join('\n- ')}` : message);
+}
+/** `fetch`, with a network failure reported as an ApiError that names the origin. */
+export async function fetchFrom(fetchImpl, baseUrl, input, init) {
+    try {
+        return await fetchImpl(input, init);
+    }
+    catch (error) {
+        throw new ApiError(`Could not reach ${baseUrl}: ${error.message}`);
+    }
+}

package/dist/output.js

@@ -0,0 +1,66 @@
+/** JSON when asked for, or when stdout is not a terminal (piped into jq, a file, an agent). */
+export function selectOutputMode(options) {
+    return options.json === true || options.isTTY !== true ? 'json' : 'table';
+}
+const MAX_CELL = 60;
+function cell(value, full = false) {
+    if (value === null || value === undefined || value === '') {
+        return '-';
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => cell(item, full)).join(', ');
+    }
+    if (typeof value === 'object') {
+        return JSON.stringify(value);
+    }
+    const text = String(value).replace(/\s+/g, ' ').trim();
+    return !full && text.length > MAX_CELL ? `${text.slice(0, MAX_CELL - 1)}…` : text;
+}
+export function renderTable(rows, columns) {
+    const body = rows.map((row) => columns.map((column) => cell(column.value(row), column.full)));
+    const widths = columns.map((column, index) => Math.max(column.header.length, ...body.map((line) => line[index]?.length ?? 0)));
+    const format = (line) => line.map((text, index) => text.padEnd(widths[index] ?? 0)).join('  ').trimEnd();
+    return [format(columns.map((column) => column.header.toUpperCase())), ...body.map(format)].join('\n');
+}
+/** A single record as aligned `key  value` lines, nested objects flattened to dotted keys. */
+export function renderRecord(record) {
+    const lines = [];
+    const walk = (value, path) => {
+        if (value !== null && typeof value === 'object' && !Array.isArray(value) && Object.keys(value).length > 0) {
+            for (const [key, child] of Object.entries(value)) {
+                walk(child, path === '' ? key : `${path}.${key}`);
+            }
+            return;
+        }
+        lines.push([path, cell(value)]);
+    };
+    walk(record, '');
+    const width = Math.max(0, ...lines.map(([key]) => key.length));
+    return lines.map(([key, value]) => `${key.padEnd(width)}  ${value}`).join('\n');
+}
+export function createPrinter(mode, write = (text) => process.stdout.write(text)) {
+    const json = (data) => write(`${JSON.stringify(data ?? null, null, 2)}\n`);
+    return {
+        list(data, rows, columns, footer) {
+            if (mode === 'json') {
+                return json(data);
+            }
+            write(rows.length === 0 ? 'Nothing found.\n' : `${renderTable(rows, columns)}\n`);
+            if (footer) {
+                write(`${footer}\n`);
+            }
+        },
+        record(data, record) {
+            if (mode === 'json') {
+                return json(data);
+            }
+            write(`${renderRecord(record)}\n`);
+        },
+        message(data, text) {
+            if (mode === 'json') {
+                return json(data);
+            }
+            write(`${text}\n`);
+        },
+    };
+}

package/dist/version.js

@@ -0,0 +1,3 @@
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+export const VERSION = require('../package.json').version;

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@zeegme/cli",
+  "version": "0.1.0",
+  "description": "The Zeeg command line: bookings, availability, notes, CRM, routing forms and AI phone calls from your terminal.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "zeeg": "dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "check-types": "tsc --noEmit",
+    "generate:api": "openapi-typescript ../../apps/backend/tools/api-docs/openapi.yaml -o src/api/schema.d.ts",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@napi-rs/keyring": "^2.1.0",
+    "commander": "^13.1.0",
+    "openapi-fetch": "^0.17.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "openapi-typescript": "^7.13.0",
+    "typescript": "5.9.2",
+    "vitest": "^4.1.8"
+  }
+}