@eide/foir-cli 0.1.0

package/dist/lib/errors.js

@@ -0,0 +1,62 @@
+import chalk from 'chalk';
+/**
+ * Wrap an async command action with standardized error handling.
+ */
+export function withErrorHandler(optsFn, fn) {
+    return async (...args) => {
+        try {
+            await fn(...args);
+        }
+        catch (error) {
+            const opts = optsFn();
+            const gqlErr = error;
+            // Extract GraphQL error details
+            const gqlErrors = gqlErr?.response?.errors;
+            if (gqlErrors && gqlErrors.length > 0) {
+                const first = gqlErrors[0];
+                const code = first.extensions?.code;
+                if (opts?.json || opts?.jsonl) {
+                    console.error(JSON.stringify({
+                        error: {
+                            message: first.message,
+                            code: code ?? 'GRAPHQL_ERROR',
+                        },
+                    }));
+                }
+                else {
+                    console.error(chalk.red('Error:'), first.message);
+                    if (code === 'UNAUTHENTICATED') {
+                        console.error(chalk.gray('Hint: Run `foir login` to authenticate.'));
+                    }
+                    else if (code === 'FORBIDDEN') {
+                        console.error(chalk.gray('Hint: You may not have permission. Check your API key scopes.'));
+                    }
+                }
+                process.exit(1);
+            }
+            // HTTP-level errors
+            const status = gqlErr?.response?.status;
+            if (status === 401 || status === 403) {
+                if (opts?.json || opts?.jsonl) {
+                    console.error(JSON.stringify({
+                        error: { message: 'Authentication failed', code: 'AUTH_ERROR' },
+                    }));
+                }
+                else {
+                    console.error(chalk.red('Error:'), 'Authentication failed.');
+                    console.error(chalk.gray('Hint: Run `foir login` or set FOIR_API_KEY.'));
+                }
+                process.exit(1);
+            }
+            // Generic errors
+            const message = error instanceof Error ? error.message : String(error);
+            if (opts?.json || opts?.jsonl) {
+                console.error(JSON.stringify({ error: { message } }));
+            }
+            else {
+                console.error(chalk.red('Error:'), message);
+            }
+            process.exit(1);
+        }
+    };
+}

package/dist/lib/input.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Parse input data from --data, --file, or stdin.
+ */
+export declare function parseInputData(opts: {
+    data?: string;
+    file?: string;
+}): Promise<Record<string, unknown>>;
+/**
+ * Detect whether a string is a UUID or CUID (→ ID lookup) vs a natural key.
+ */
+export declare function isUUID(value: string): boolean;
+interface ParsedFilter {
+    field: string;
+    operator: string;
+    value: unknown;
+}
+/**
+ * Parse filter string: "status=active,name~%hello%"
+ */
+export declare function parseFilters(filterStr: string): ParsedFilter[];
+interface ParsedSort {
+    field: string;
+    direction: string;
+}
+/**
+ * Parse sort string: "createdAt:desc"
+ */
+export declare function parseSort(sortStr: string): ParsedSort | undefined;
+/**
+ * Prompt for confirmation unless --confirm flag is set.
+ */
+export declare function confirmAction(message: string, opts?: {
+    confirm?: boolean;
+}): Promise<boolean>;
+export {};
+//# sourceMappingURL=input.d.ts.map

package/dist/lib/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/lib/input.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAyBnC;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAM7C;AAED,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE,CA8B9D;AAWD,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAQjE;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAC3B,OAAO,CAAC,OAAO,CAAC,CAalB"}

package/dist/lib/input.js

@@ -0,0 +1,106 @@
+import { promises as fs } from 'fs';
+import inquirer from 'inquirer';
+/**
+ * Parse input data from --data, --file, or stdin.
+ */
+export async function parseInputData(opts) {
+    if (opts.data) {
+        return JSON.parse(opts.data);
+    }
+    if (opts.file) {
+        const content = await fs.readFile(opts.file, 'utf-8');
+        return JSON.parse(content);
+    }
+    // Check for stdin pipe
+    if (!process.stdin.isTTY) {
+        const chunks = [];
+        for await (const chunk of process.stdin) {
+            chunks.push(chunk);
+        }
+        const stdinContent = Buffer.concat(chunks).toString('utf-8').trim();
+        if (stdinContent) {
+            return JSON.parse(stdinContent);
+        }
+    }
+    throw new Error('No input data provided. Use --data, --file, or pipe via stdin.');
+}
+/**
+ * Detect whether a string is a UUID or CUID (→ ID lookup) vs a natural key.
+ */
+export function isUUID(value) {
+    return (/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(value) || /^c[a-z0-9]{24,}$/.test(value));
+}
+/**
+ * Parse filter string: "status=active,name~%hello%"
+ */
+export function parseFilters(filterStr) {
+    if (!filterStr)
+        return [];
+    return filterStr.split(',').map((part) => {
+        const trimmed = part.trim();
+        // Order matters: check multi-char operators first
+        for (const [op, gqlOp] of [
+            ['!=', 'NE'],
+            ['>=', 'GTE'],
+            ['<=', 'LTE'],
+            ['>', 'GT'],
+            ['<', 'LT'],
+            ['~', 'LIKE'],
+            ['=', 'EQ'],
+        ]) {
+            const idx = trimmed.indexOf(op);
+            if (idx > 0) {
+                const field = trimmed.slice(0, idx);
+                const rawValue = trimmed.slice(idx + op.length);
+                return {
+                    field,
+                    operator: gqlOp,
+                    value: parseFilterValue(rawValue),
+                };
+            }
+        }
+        throw new Error(`Invalid filter expression: "${trimmed}"`);
+    });
+}
+function parseFilterValue(raw) {
+    if (raw === 'true')
+        return true;
+    if (raw === 'false')
+        return false;
+    if (raw === 'null')
+        return null;
+    const num = Number(raw);
+    if (!isNaN(num) && raw !== '')
+        return num;
+    return raw;
+}
+/**
+ * Parse sort string: "createdAt:desc"
+ */
+export function parseSort(sortStr) {
+    if (!sortStr)
+        return undefined;
+    const [field, dir] = sortStr.split(':');
+    if (!field)
+        return undefined;
+    return {
+        field,
+        direction: (dir ?? 'asc').toUpperCase(),
+    };
+}
+/**
+ * Prompt for confirmation unless --confirm flag is set.
+ */
+export async function confirmAction(message, opts) {
+    if (opts?.confirm)
+        return true;
+    const { confirmed } = await inquirer.prompt([
+        {
+            type: 'confirm',
+            name: 'confirmed',
+            message,
+            default: false,
+        },
+    ]);
+    return confirmed;
+}

package/dist/lib/output.d.ts

@@ -0,0 +1,31 @@
+import type { GlobalOptions } from './config.js';
+export interface ColumnDef {
+    key: string;
+    header: string;
+    width?: number;
+    format?: (value: unknown) => string;
+}
+/**
+ * Format a single object for output.
+ */
+export declare function formatOutput(data: unknown, options?: GlobalOptions): void;
+/**
+ * Format a list of items as a table or structured output.
+ */
+export declare function formatList(items: Record<string, unknown>[], options: GlobalOptions | undefined, config: {
+    columns: ColumnDef[];
+    total?: number;
+}): void;
+/**
+ * Format a relative time string ("2h ago", "3d ago", etc.)
+ */
+export declare function timeAgo(dateStr: string | null | undefined): string;
+/**
+ * Print a success message.
+ */
+export declare function success(message: string): void;
+/**
+ * Print a warning message.
+ */
+export declare function warn(message: string): void;
+//# sourceMappingURL=output.d.ts.map

package/dist/lib/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC;CACrC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAYzE;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAChC,OAAO,EAAE,aAAa,GAAG,SAAS,EAClC,MAAM,EAAE;IAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C,IAAI,CAkDN;AASD;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAmBlE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C"}

package/dist/lib/output.js

@@ -0,0 +1,107 @@
+import chalk from 'chalk';
+/**
+ * Format a single object for output.
+ */
+export function formatOutput(data, options) {
+    if (options?.quiet)
+        return;
+    if (options?.json) {
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    if (options?.jsonl) {
+        console.log(JSON.stringify(data));
+        return;
+    }
+    // Human-readable: pretty-print the object
+    console.log(JSON.stringify(data, null, 2));
+}
+/**
+ * Format a list of items as a table or structured output.
+ */
+export function formatList(items, options, config) {
+    if (options?.quiet) {
+        for (const item of items) {
+            console.log(item['id'] ?? '');
+        }
+        return;
+    }
+    if (options?.json) {
+        console.log(JSON.stringify(items, null, 2));
+        return;
+    }
+    if (options?.jsonl) {
+        for (const item of items) {
+            console.log(JSON.stringify(item));
+        }
+        return;
+    }
+    // Human-readable table
+    if (items.length === 0) {
+        console.log(chalk.gray('No results.'));
+        return;
+    }
+    const { columns } = config;
+    // Print header
+    const headerLine = columns
+        .map((col) => chalk.bold(pad(col.header, col.width ?? 20)))
+        .join('  ');
+    console.log(headerLine);
+    console.log(columns.map((col) => '─'.repeat(col.width ?? 20)).join('──'));
+    // Print rows
+    for (const item of items) {
+        const row = columns
+            .map((col) => {
+            const raw = item[col.key];
+            const formatted = col.format ? col.format(raw) : String(raw ?? '');
+            return pad(formatted, col.width ?? 20);
+        })
+            .join('  ');
+        console.log(row);
+    }
+    if (config.total !== undefined) {
+        console.log(chalk.gray(`\n${items.length} of ${config.total} shown`));
+    }
+}
+function pad(str, width) {
+    if (str.length > width) {
+        return str.slice(0, width - 1) + '…';
+    }
+    return str.padEnd(width);
+}
+/**
+ * Format a relative time string ("2h ago", "3d ago", etc.)
+ */
+export function timeAgo(dateStr) {
+    if (!dateStr)
+        return '—';
+    const date = new Date(dateStr);
+    const now = Date.now();
+    const diffMs = now - date.getTime();
+    if (diffMs < 0)
+        return 'future';
+    const minutes = Math.floor(diffMs / 60000);
+    if (minutes < 1)
+        return 'just now';
+    if (minutes < 60)
+        return `${minutes}m ago`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return `${hours}h ago`;
+    const days = Math.floor(hours / 24);
+    if (days < 30)
+        return `${days}d ago`;
+    return date.toLocaleDateString();
+}
+/**
+ * Print a success message.
+ */
+export function success(message) {
+    console.log(chalk.green(`✓ ${message}`));
+}
+/**
+ * Print a warning message.
+ */
+export function warn(message) {
+    console.log(chalk.yellow(`⚠ ${message}`));
+}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@eide/foir-cli",
+  "version": "0.1.0",
+  "description": "Universal platform CLI for EIDE — scriptable, composable resource management",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "foir": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/cli.js",
+      "import": "./dist/cli.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev:cli": "tsx src/cli.ts",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest watch"
+  },
+  "keywords": [
+    "foir",
+    "eide",
+    "cms",
+    "cli",
+    "graphql",
+    "platform"
+  ],
+  "author": "EIDE Team",
+  "license": "UNLICENSED",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "dotenv": "^16.4.5",
+    "graphql-request": "^7.1.2",
+    "inquirer": "^9.2.12",
+    "open": "^10.1.0",
+    "ora": "^8.1.1"
+  },
+  "devDependencies": {
+    "@foir/config": "workspace:*",
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^22.5.0",
+    "tsx": "^4.20.0",
+    "typescript": "5.9.2",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}