@manfred-kunze-dev/backbone-cli 2.6.0-dev.4

package/dist/lib/config.js

@@ -0,0 +1,68 @@
+import Conf from "conf";
+import { readFileSync, existsSync } from "node:fs";
+import { resolve } from "node:path";
+const store = new Conf({
+    projectName: "backbone",
+    projectSuffix: "",
+    schema: {
+        apiKey: { type: "string" },
+        baseUrl: { type: "string" },
+        project: { type: "string" },
+    },
+});
+export { store };
+/**
+ * Read .backbone file from current directory (if it exists).
+ */
+function readLocalFile() {
+    const localPath = resolve(process.cwd(), ".backbone");
+    if (!existsSync(localPath))
+        return {};
+    try {
+        return JSON.parse(readFileSync(localPath, "utf-8"));
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Resolve configuration with priority:
+ *   1. CLI flags (--api-key, --base-url, --project)
+ *   2. Environment variables (BACKBONE_API_KEY, BACKBONE_BASE_URL, BACKBONE_PROJECT)
+ *   3. Local .backbone file
+ *   4. Config store (~/.config/backbone/config.json)
+ */
+export function resolveConfig(command) {
+    const root = getRootCommand(command);
+    const opts = root.opts();
+    const local = readLocalFile();
+    const apiKey = opts.apiKey ??
+        process.env.BACKBONE_API_KEY ??
+        local.apiKey ??
+        store.get("apiKey");
+    const baseUrl = opts.baseUrl ??
+        process.env.BACKBONE_BASE_URL ??
+        local.baseUrl ??
+        store.get("baseUrl") ??
+        "https://backbone.manfred-kunze.dev/api";
+    const project = opts.project ??
+        process.env.BACKBONE_PROJECT ??
+        local.project ??
+        store.get("project");
+    if (!apiKey) {
+        throw new Error('No API key configured. Run "backbone auth login" or set BACKBONE_API_KEY.');
+    }
+    return { apiKey, baseUrl, project };
+}
+/** Walk up Commander's parent chain to find root program */
+function getRootCommand(cmd) {
+    let root = cmd;
+    while (root.parent)
+        root = root.parent;
+    return root;
+}
+/** Check if --json flag is set on root command */
+export function isJsonOutput(command) {
+    return getRootCommand(command).opts().json === true;
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/context.d.ts

@@ -0,0 +1,7 @@
+import type { Command } from "commander";
+/**
+ * Resolve the project ID from --project flag, env var, .backbone file, or config store.
+ * Throws a user-friendly error if no project is configured.
+ */
+export declare function requireProjectId(command: Command): string;
+//# sourceMappingURL=context.d.ts.map

package/dist/lib/context.js

@@ -0,0 +1,14 @@
+import { resolveConfig } from "./config.js";
+/**
+ * Resolve the project ID from --project flag, env var, .backbone file, or config store.
+ * Throws a user-friendly error if no project is configured.
+ */
+export function requireProjectId(command) {
+    const config = resolveConfig(command);
+    if (!config.project) {
+        throw new Error("No project ID configured. Use --project <id>, set BACKBONE_PROJECT, or run:\n" +
+            '  backbone config set project <id>');
+    }
+    return config.project;
+}
+//# sourceMappingURL=context.js.map

package/dist/lib/errors.d.ts

@@ -0,0 +1,14 @@
+export interface ApiErrorBody {
+    status: number;
+    error: string;
+    message: string;
+    timestamp: string;
+}
+export declare class BackboneApiError extends Error {
+    readonly status: number;
+    readonly errorType: string;
+    readonly timestamp: string;
+    constructor(body: ApiErrorBody);
+}
+export declare function handleError(err: unknown, json: boolean): void;
+//# sourceMappingURL=errors.d.ts.map

package/dist/lib/errors.js

@@ -0,0 +1,53 @@
+import chalk from "chalk";
+export class BackboneApiError extends Error {
+    status;
+    errorType;
+    timestamp;
+    constructor(body) {
+        super(body.message);
+        this.name = "BackboneApiError";
+        this.status = body.status;
+        this.errorType = body.error;
+        this.timestamp = body.timestamp;
+    }
+}
+const HINTS = {
+    401: 'Invalid or missing API key. Run "backbone auth login" to configure credentials.',
+    403: "You don't have permission for this action. Check your organization role.",
+    404: "Resource not found. Verify the ID is correct.",
+    409: "Conflict — the resource may already exist or was modified concurrently.",
+    422: "Validation error. Check the input values.",
+    429: "Rate limit exceeded. Wait a moment and try again.",
+};
+export function handleError(err, json) {
+    if (err instanceof BackboneApiError) {
+        if (json) {
+            console.error(JSON.stringify({
+                error: err.errorType,
+                status: err.status,
+                message: err.message,
+                timestamp: err.timestamp,
+            }));
+        }
+        else {
+            console.error(chalk.red(`Error ${err.status}: ${err.message}`));
+            const hint = HINTS[err.status];
+            if (hint) {
+                console.error(chalk.yellow(`Hint: ${hint}`));
+            }
+        }
+    }
+    else if (err instanceof Error) {
+        if (json) {
+            console.error(JSON.stringify({ error: err.name, message: err.message }));
+        }
+        else {
+            console.error(chalk.red(`Error: ${err.message}`));
+        }
+    }
+    else {
+        console.error(chalk.red(`Unknown error: ${String(err)}`));
+    }
+    process.exitCode = 1;
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/multipart.d.ts

@@ -0,0 +1,10 @@
+export declare function getMimeType(filename: string): string;
+/**
+ * Read a local file and return a Blob suitable for FormData.
+ */
+export declare function fileToBlob(filePath: string): {
+    blob: Blob;
+    filename: string;
+    mimeType: string;
+};
+//# sourceMappingURL=multipart.d.ts.map

package/dist/lib/multipart.js

@@ -0,0 +1,57 @@
+import { readFileSync } from "node:fs";
+import { basename, extname } from "node:path";
+const MIME_TYPES = {
+    ".pdf": "application/pdf",
+    ".doc": "application/msword",
+    ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    ".xls": "application/vnd.ms-excel",
+    ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    ".ppt": "application/vnd.ms-powerpoint",
+    ".pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+    ".odt": "application/vnd.oasis.opendocument.text",
+    ".ods": "application/vnd.oasis.opendocument.spreadsheet",
+    ".odp": "application/vnd.oasis.opendocument.presentation",
+    ".rtf": "application/rtf",
+    ".csv": "text/csv",
+    ".tsv": "text/tab-separated-values",
+    ".txt": "text/plain",
+    ".md": "text/markdown",
+    ".html": "text/html",
+    ".xml": "application/xml",
+    ".json": "application/json",
+    ".yaml": "application/yaml",
+    ".yml": "application/yaml",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".bmp": "image/bmp",
+    ".tiff": "image/tiff",
+    ".webp": "image/webp",
+    ".svg": "image/svg+xml",
+    ".eml": "message/rfc822",
+    ".msg": "application/vnd.ms-outlook",
+    ".epub": "application/epub+zip",
+    ".flac": "audio/flac",
+    ".mp3": "audio/mpeg",
+    ".mp4": "audio/mp4",
+    ".m4a": "audio/mp4",
+    ".ogg": "audio/ogg",
+    ".wav": "audio/wav",
+    ".webm": "audio/webm",
+};
+export function getMimeType(filename) {
+    const ext = extname(filename).toLowerCase();
+    return MIME_TYPES[ext] ?? "application/octet-stream";
+}
+/**
+ * Read a local file and return a Blob suitable for FormData.
+ */
+export function fileToBlob(filePath) {
+    const buffer = readFileSync(filePath);
+    const filename = basename(filePath);
+    const mimeType = getMimeType(filename);
+    const blob = new Blob([buffer], { type: mimeType });
+    return { blob, filename, mimeType };
+}
+//# sourceMappingURL=multipart.js.map

package/dist/lib/output.d.ts

@@ -0,0 +1,29 @@
+import type { Command } from "commander";
+type AnyRecord = Record<string, any>;
+/**
+ * Format and display a paginated list (Spring Data Page<T>).
+ */
+export declare function formatPage(page: {
+    content?: AnyRecord[];
+    totalElements?: number;
+    number?: number;
+    totalPages?: number;
+} | undefined, command: Command, columns: string[]): void;
+/**
+ * Format and display a single record as key-value pairs.
+ */
+export declare function formatDetail(record: AnyRecord | undefined, command: Command): void;
+/**
+ * Format and display a list of records (non-paginated).
+ */
+export declare function formatList(items: AnyRecord[] | undefined, command: Command, columns: string[]): void;
+/**
+ * Display a success message.
+ */
+export declare function formatSuccess(message: string, command: Command): void;
+/**
+ * Run an async action with a spinner.
+ */
+export declare function withSpinner<T>(text: string, action: () => Promise<T>): Promise<T>;
+export {};
+//# sourceMappingURL=output.d.ts.map

package/dist/lib/output.js

@@ -0,0 +1,107 @@
+import chalk from "chalk";
+import Table from "cli-table3";
+import ora from "ora";
+import { isJsonOutput } from "./config.js";
+/**
+ * Format and display a paginated list (Spring Data Page<T>).
+ */
+export function formatPage(page, command, columns) {
+    if (!page) {
+        console.error(chalk.yellow("No data returned."));
+        return;
+    }
+    if (isJsonOutput(command)) {
+        console.log(JSON.stringify(page, null, 2));
+        return;
+    }
+    if (!page.content || page.content.length === 0) {
+        console.log(chalk.dim("No results found."));
+        return;
+    }
+    const table = new Table({
+        head: columns.map((c) => chalk.cyan(c)),
+        wordWrap: true,
+    });
+    for (const item of page.content) {
+        table.push(columns.map((col) => formatValue(item[col])));
+    }
+    console.log(table.toString());
+    console.log(chalk.dim(`Page ${(page.number ?? 0) + 1} of ${page.totalPages ?? 0} (${page.totalElements ?? 0} total)`));
+}
+/**
+ * Format and display a single record as key-value pairs.
+ */
+export function formatDetail(record, command) {
+    if (!record) {
+        console.error(chalk.yellow("No data returned."));
+        return;
+    }
+    if (isJsonOutput(command)) {
+        console.log(JSON.stringify(record, null, 2));
+        return;
+    }
+    const table = new Table();
+    for (const [key, value] of Object.entries(record)) {
+        table.push({ [chalk.cyan(key)]: formatValue(value) });
+    }
+    console.log(table.toString());
+}
+/**
+ * Format and display a list of records (non-paginated).
+ */
+export function formatList(items, command, columns) {
+    if (!items) {
+        console.error(chalk.yellow("No data returned."));
+        return;
+    }
+    if (isJsonOutput(command)) {
+        console.log(JSON.stringify(items, null, 2));
+        return;
+    }
+    if (items.length === 0) {
+        console.log(chalk.dim("No results found."));
+        return;
+    }
+    const table = new Table({
+        head: columns.map((c) => chalk.cyan(c)),
+        wordWrap: true,
+    });
+    for (const item of items) {
+        table.push(columns.map((col) => formatValue(item[col])));
+    }
+    console.log(table.toString());
+}
+/**
+ * Display a success message.
+ */
+export function formatSuccess(message, command) {
+    if (isJsonOutput(command)) {
+        console.log(JSON.stringify({ success: true, message }));
+    }
+    else {
+        console.log(chalk.green(message));
+    }
+}
+/**
+ * Run an async action with a spinner.
+ */
+export async function withSpinner(text, action) {
+    const spinner = ora(text).start();
+    try {
+        const result = await action();
+        spinner.succeed();
+        return result;
+    }
+    catch (err) {
+        spinner.fail();
+        throw err;
+    }
+}
+function formatValue(value) {
+    if (value === null || value === undefined)
+        return chalk.dim("—");
+    if (typeof value === "object")
+        return JSON.stringify(value);
+    return String(value);
+}
+//# sourceMappingURL=output.js.map

package/dist/lib/pagination.d.ts

@@ -0,0 +1,21 @@
+import type { Command } from "commander";
+/**
+ * Add standard pagination options to a command.
+ * Spring Data uses page (0-indexed), size, and sort.
+ */
+export declare function addPaginationOptions(cmd: Command): Command;
+/** Parse pagination options into query params.
+ * Spring Data accepts flat page/size/sort params directly. We cast to satisfy
+ * the generated types which expect a nested `pageable` object. */
+export declare function paginationParams(opts: {
+    page?: string;
+    size?: string;
+    sort?: string[];
+}): {
+    pageable: {
+        page?: number;
+        size?: number;
+        sort?: string[];
+    };
+};
+//# sourceMappingURL=pagination.d.ts.map

package/dist/lib/pagination.js

@@ -0,0 +1,21 @@
+/**
+ * Add standard pagination options to a command.
+ * Spring Data uses page (0-indexed), size, and sort.
+ */
+export function addPaginationOptions(cmd) {
+    return cmd
+        .option("-p, --page <number>", "Page number (0-indexed)", "0")
+        .option("--size <number>", "Page size", "20")
+        .option("--sort <fields...>", "Sort fields (e.g., name,asc)");
+}
+/** Parse pagination options into query params.
+ * Spring Data accepts flat page/size/sort params directly. We cast to satisfy
+ * the generated types which expect a nested `pageable` object. */
+export function paginationParams(opts) {
+    return {
+        page: opts.page !== undefined ? parseInt(opts.page, 10) : undefined,
+        size: opts.size !== undefined ? parseInt(opts.size, 10) : undefined,
+        sort: opts.sort,
+    };
+}
+//# sourceMappingURL=pagination.js.map

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@manfred-kunze-dev/backbone-cli",
+  "version": "2.6.0-dev.4",
+  "description": "CLI for the Backbone AI platform",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "backbone": "dist/index.js",
+    "bb": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "generate:spec": "tsx --env-file=.env openapi/scripts/fetch-spec.ts",
+    "generate:types": "openapi-typescript openapi/openapi.json -o src/generated/openapi.d.ts",
+    "generate": "npm run generate:spec && npm run generate:types",
+    "check:spec": "tsx --env-file=.env openapi/scripts/check-drift.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "cli-table3": "^0.6.5",
+    "commander": "^13.1.0",
+    "conf": "^13.1.0",
+    "openapi-fetch": "^0.13.5",
+    "ora": "^8.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.4",
+    "openapi-typescript": "^7.6.1",
+    "tsx": "^4.19.3",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=18.20.8"
+  },
+  "license": "SEE LICENSE IN LICENSE",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/manfred-kunze-dev/backbone.git",
+    "directory": "cli"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts"
+  ]
+}