@guaracloud/cli 0.1.0

package/dist/lib/base-command.js

@@ -0,0 +1,184 @@
+import { Command, Flags } from '@oclif/core';
+import chalk from 'chalk';
+import { ApiError, GuaraApiClient } from './api-client.js';
+import { getApiKey, getApiUrl } from './auth.js';
+import { resolveContext } from './context.js';
+import { CliError, formatApiError, getExitCode } from './errors.js';
+import { errorMessage, formatJson, formatQuiet } from './output.js';
+// ─── Global flag definitions ──────────────────────────────────────────────
+export const globalFlags = {
+    json: Flags.boolean({
+        description: 'Output as JSON.',
+        default: false,
+    }),
+    quiet: Flags.boolean({
+        char: 'q',
+        description: 'Suppress all non-essential output.',
+        default: false,
+    }),
+    'api-key': Flags.string({
+        description: 'Override the API key for this request.',
+        env: 'GUARA_API_KEY',
+        helpGroup: 'GLOBAL',
+    }),
+    'api-url': Flags.string({
+        description: 'Override the API base URL.',
+        env: 'GUARA_API_URL',
+        helpGroup: 'GLOBAL',
+    }),
+    project: Flags.string({
+        char: 'p',
+        description: 'Project slug (overrides .guara.json and $GUARA_PROJECT).',
+        env: 'GUARA_PROJECT',
+        helpGroup: 'GLOBAL',
+    }),
+    service: Flags.string({
+        char: 's',
+        description: 'Service slug (overrides .guara.json and $GUARA_SERVICE).',
+        env: 'GUARA_SERVICE',
+        helpGroup: 'GLOBAL',
+    }),
+    yes: Flags.boolean({
+        char: 'y',
+        description: 'Skip confirmation prompts.',
+        default: false,
+    }),
+};
+// ─── Abstract base command ────────────────────────────────────────────────
+/**
+ * Abstract base class for all GuaraCloud CLI commands.
+ *
+ * Provides:
+ * - Global flags (json, quiet, api-key, api-url, project, service, yes)
+ * - API client initialisation via {@link initApiClient}
+ * - Context resolution via {@link resolveContext}
+ * - Helper methods for project/service requirement enforcement
+ * - Structured JSON and quiet output helpers
+ * - Unified error handling for ApiError, CliError, and unexpected errors
+ */
+export class BaseCommand extends Command {
+    static baseFlags = globalFlags;
+    // ─── API client ────────────────────────────────────────────────────────
+    /**
+     * Create an authenticated {@link GuaraApiClient} using the resolved flags.
+     *
+     * Resolution order for the API key:
+     *  1. `--api-key` flag
+     *  2. Auth module (env -> keychain -> config file)
+     *
+     * Resolution order for the API URL:
+     *  1. `--api-url` flag
+     *  2. Auth module (env -> config file, defaults to https://api.guaracloud.com)
+     */
+    async initApiClient(flags) {
+        const apiKey = flags['api-key'] ?? (await getApiKey());
+        const baseUrl = flags['api-url'] ?? getApiUrl();
+        return GuaraApiClient.create({ apiKey, baseUrl });
+    }
+    // ─── Context resolution ────────────────────────────────────────────────
+    /**
+     * Resolve project/service context from flags, environment, or `.guara.json`.
+     *
+     * Returns `undefined` when no project could be determined from any source.
+     */
+    async resolveProjectContext(flags) {
+        return resolveContext({
+            project: flags.project,
+            service: flags.service,
+        });
+    }
+    /**
+     * Resolve context and fail if no project is available.
+     * Resolves slug to UUID via the API client when needed.
+     *
+     * @returns The resolved project UUID.
+     * @throws {CliError} when no project could be resolved.
+     */
+    async requireProject(flags, client) {
+        const ctx = await this.resolveProjectContext(flags);
+        if (!ctx) {
+            throw new CliError('No project specified.', 1, 'Pass --project <slug>, set $GUARA_PROJECT, or run `guara link` in a project directory.');
+        }
+        return client.resolveProjectId(ctx.project);
+    }
+    /**
+     * Resolve context and fail if no service is available.
+     * Resolves slugs to UUIDs via the API client when needed.
+     *
+     * @returns A tuple of `[projectId, serviceId]` (UUIDs).
+     * @throws {CliError} when project or service could not be resolved.
+     */
+    async requireService(flags, client) {
+        const ctx = await this.resolveProjectContext(flags);
+        if (!ctx) {
+            throw new CliError('No project specified.', 1, 'Pass --project <slug>, set $GUARA_PROJECT, or run `guara link` in a project directory.');
+        }
+        if (!ctx.service) {
+            throw new CliError('No service specified.', 1, 'Pass --service <slug>, set $GUARA_SERVICE, or include "service" in .guara.json.');
+        }
+        const projectId = await client.resolveProjectId(ctx.project);
+        const serviceId = await client.resolveServiceId(projectId, ctx.service);
+        return [projectId, serviceId];
+    }
+    // ─── Output helpers ────────────────────────────────────────────────────
+    /**
+     * Print structured JSON to stdout and return it (so oclif's `--json`
+     * envelope can use the value if `enableJsonFlag` is set on the command).
+     */
+    outputJson(data) {
+        this.log(formatJson(data));
+    }
+    /**
+     * Print a minimal value for `--quiet` mode (e.g. a slug or ID).
+     */
+    outputQuiet(value) {
+        this.log(formatQuiet(value));
+    }
+    // ─── Error handling ────────────────────────────────────────────────────
+    /**
+     * Unified error handler that formats known error types into user-friendly
+     * messages, with optional JSON output.
+     */
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async catch(err) {
+        // ── ApiError from the HTTP client ──────────────────────────────────
+        if (err instanceof ApiError) {
+            const isJson = this.argv.includes('--json');
+            const formatted = formatApiError({
+                statusCode: err.statusCode,
+                error: err.name,
+                message: err.message,
+                errorCode: err.errorCode,
+                details: err.details,
+                requestId: err.requestId,
+            }, isJson);
+            if (isJson && formatted.json) {
+                this.logToStderr(JSON.stringify(formatted.json, null, 2));
+            }
+            else {
+                this.logToStderr(errorMessage(formatted.message));
+                if (formatted.suggestion) {
+                    this.logToStderr(chalk.dim(`  Hint: ${formatted.suggestion}`));
+                }
+            }
+            this.exit(getExitCode(err.statusCode));
+        }
+        // ── CliError (AuthenticationError, NetworkError, etc.) ─────────────
+        if (err instanceof CliError) {
+            const isJson = this.argv.includes('--json');
+            if (isJson) {
+                this.logToStderr(JSON.stringify({ error: { code: err.name, message: err.message } }, null, 2));
+            }
+            else {
+                this.logToStderr(errorMessage(err.message));
+                if (err.suggestion) {
+                    this.logToStderr(chalk.dim(`  Hint: ${err.suggestion}`));
+                }
+            }
+            this.exit(err.exitCode);
+        }
+        // ── Fallback: delegate to oclif's default handler ─────────────────
+        throw err;
+    }
+}
+//# sourceMappingURL=base-command.js.map

package/dist/lib/base-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-command.js","sourceRoot":"","sources":["../../src/lib/base-command.ts"],"names":[],"mappings":"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"}

package/dist/lib/context.d.ts

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+declare const guaraLinkSchema: z.ZodObject<{
+    project: z.ZodString;
+    service: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type GuaraLink = z.infer<typeof guaraLinkSchema>;
+export interface ResolvedContext {
+    /** Project slug (always present when context is resolved). */
+    project: string;
+    /** Service slug (optional — present when service is linked or passed via flag). */
+    service: string | undefined;
+    /** Source of the project value for diagnostics. */
+    projectSource: 'flag' | 'env' | 'link-file';
+    /** Source of the service value for diagnostics. */
+    serviceSource: 'flag' | 'env' | 'link-file' | 'none';
+}
+interface ContextInputs {
+    /** `--project` flag value. */
+    project?: string;
+    /** `--service` flag value. */
+    service?: string;
+    /** Working directory to search for .guara.json (defaults to cwd). */
+    cwd?: string;
+}
+/**
+ * Resolve project and service context from flags, environment, or link file.
+ *
+ * Resolution order for **project**:
+ *  1. `--project` flag
+ *  2. `GUARA_PROJECT` environment variable
+ *  3. `.guara.json` link file (walked upward from cwd)
+ *
+ * Resolution order for **service**:
+ *  1. `--service` flag
+ *  2. `GUARA_SERVICE` environment variable
+ *  3. `.guara.json` link file `service` field (if present)
+ *
+ * Returns `undefined` if no project could be resolved.
+ */
+export declare function resolveContext(inputs?: ContextInputs): Promise<ResolvedContext | undefined>;
+/**
+ * Write a `.guara.json` link file in the given directory.
+ */
+export declare function writeLinkFile(dir: string, link: GuaraLink): Promise<string>;
+/**
+ * Remove the `.guara.json` link file from the given directory.
+ *
+ * Returns `true` if the file was deleted, `false` if it did not exist.
+ */
+export declare function removeLinkFile(dir: string): Promise<boolean>;
+/**
+ * Read and validate a `.guara.json` link file from the given directory.
+ *
+ * Returns `undefined` if the file doesn't exist or is invalid.
+ */
+export declare function readLinkFile(dir: string): Promise<GuaraLink | undefined>;
+export {};
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/lib/context.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,QAAA,MAAM,eAAe;;;iBAGnB,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAIxD,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,mDAAmD;IACnD,aAAa,EAAE,MAAM,GAAG,KAAK,GAAG,WAAW,CAAC;IAC5C,mDAAmD;IACnD,aAAa,EAAE,MAAM,GAAG,KAAK,GAAG,WAAW,GAAG,MAAM,CAAC;CACtD;AAID,UAAU,aAAa;IACrB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AA4CD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CAClC,MAAM,GAAE,aAAkB,GACzB,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAiDtC;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAKjF;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUlE;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAiB9E"}

package/dist/lib/context.js

@@ -0,0 +1,147 @@
+import { readFile, writeFile, unlink, access, constants } from 'node:fs/promises';
+import { resolve, dirname } from 'node:path';
+import { z } from 'zod';
+// ─── Zod schema for .guara.json ────────────────────────────────────────────
+const guaraLinkSchema = z.object({
+    project: z.string().min(1, 'project slug is required'),
+    service: z.string().min(1, 'service slug is required').optional(),
+});
+// ─── Link file I/O ─────────────────────────────────────────────────────────
+const LINK_FILENAME = '.guara.json';
+/**
+ * Walk from `startDir` upward to the filesystem root, looking for `.guara.json`.
+ * Returns the parsed link data or `undefined` if not found.
+ */
+async function findLinkFile(startDir) {
+    let dir = resolve(startDir);
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    while (true) {
+        const candidate = resolve(dir, LINK_FILENAME);
+        try {
+            await access(candidate, constants.R_OK);
+            const raw = await readFile(candidate, 'utf-8');
+            const parsed = JSON.parse(raw);
+            const result = guaraLinkSchema.safeParse(parsed);
+            if (result.success) {
+                return result.data;
+            }
+            // File exists but is invalid — stop searching upward.
+            return undefined;
+        }
+        catch {
+            // File doesn't exist or isn't readable — walk up.
+        }
+        const parent = dirname(dir);
+        if (parent === dir) {
+            // Reached filesystem root.
+            break;
+        }
+        dir = parent;
+    }
+    return undefined;
+}
+/**
+ * Resolve project and service context from flags, environment, or link file.
+ *
+ * Resolution order for **project**:
+ *  1. `--project` flag
+ *  2. `GUARA_PROJECT` environment variable
+ *  3. `.guara.json` link file (walked upward from cwd)
+ *
+ * Resolution order for **service**:
+ *  1. `--service` flag
+ *  2. `GUARA_SERVICE` environment variable
+ *  3. `.guara.json` link file `service` field (if present)
+ *
+ * Returns `undefined` if no project could be resolved.
+ */
+export async function resolveContext(inputs = {}) {
+    const cwd = inputs.cwd ?? process.cwd();
+    // ── Project resolution ──────────────────────────────────────────────
+    let project;
+    let projectSource = 'link-file';
+    if (inputs.project) {
+        project = inputs.project;
+        projectSource = 'flag';
+    }
+    else if (process.env['GUARA_PROJECT']) {
+        project = process.env['GUARA_PROJECT'];
+        projectSource = 'env';
+    }
+    // ── Service resolution ──────────────────────────────────────────────
+    let service;
+    let serviceSource = 'none';
+    if (inputs.service) {
+        service = inputs.service;
+        serviceSource = 'flag';
+    }
+    else if (process.env['GUARA_SERVICE']) {
+        service = process.env['GUARA_SERVICE'];
+        serviceSource = 'env';
+    }
+    // ── Link file fallback ──────────────────────────────────────────────
+    if (!project || (!service && serviceSource === 'none')) {
+        const link = await findLinkFile(cwd);
+        if (link) {
+            if (!project) {
+                project = link.project;
+                projectSource = 'link-file';
+            }
+            if (!service && link.service) {
+                service = link.service;
+                serviceSource = 'link-file';
+            }
+        }
+    }
+    if (!project) {
+        return undefined;
+    }
+    return { project, service, projectSource, serviceSource };
+}
+/**
+ * Write a `.guara.json` link file in the given directory.
+ */
+export async function writeLinkFile(dir, link) {
+    const filePath = resolve(dir, LINK_FILENAME);
+    const content = JSON.stringify(link, null, 2) + '\n';
+    await writeFile(filePath, content, 'utf-8');
+    return filePath;
+}
+/**
+ * Remove the `.guara.json` link file from the given directory.
+ *
+ * Returns `true` if the file was deleted, `false` if it did not exist.
+ */
+export async function removeLinkFile(dir) {
+    const filePath = resolve(dir, LINK_FILENAME);
+    try {
+        await access(filePath, constants.R_OK);
+        await unlink(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Read and validate a `.guara.json` link file from the given directory.
+ *
+ * Returns `undefined` if the file doesn't exist or is invalid.
+ */
+export async function readLinkFile(dir) {
+    const filePath = resolve(dir, LINK_FILENAME);
+    try {
+        await access(filePath, constants.R_OK);
+        const raw = await readFile(filePath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        const result = guaraLinkSchema.safeParse(parsed);
+        if (result.success) {
+            return result.data;
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/lib/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/lib/context.ts"],"names":[],"mappings":"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"}

package/dist/lib/errors.d.ts

@@ -0,0 +1,34 @@
+export interface ApiErrorBody {
+    statusCode: number;
+    error: string;
+    message: string;
+    errorCode?: string;
+    details?: Record<string, unknown>;
+    requestId?: string;
+}
+interface FormattedError {
+    message: string;
+    suggestion: string;
+    json?: {
+        error: {
+            code: string;
+            message: string;
+            status: number;
+        };
+    };
+}
+export declare function formatApiError(body: ApiErrorBody, json?: boolean): FormattedError;
+export declare function getExitCode(statusCode: number): number;
+export declare class CliError extends Error {
+    readonly exitCode: number;
+    readonly suggestion?: string;
+    constructor(message: string, exitCode?: number, suggestion?: string);
+}
+export declare class AuthenticationError extends CliError {
+    constructor(message?: string);
+}
+export declare class NetworkError extends CliError {
+    constructor(apiUrl: string);
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,cAAc;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;CACrE;AAoGD,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,UAAQ,GAAG,cAAc,CA0B/E;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAExB,OAAO,EAAE,MAAM,EAAE,QAAQ,SAAI,EAAE,UAAU,CAAC,EAAE,MAAM;CAM/D;AAED,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,OAAO,SAAgD;CAGpE;AAED,qBAAa,YAAa,SAAQ,QAAQ;gBAC5B,MAAM,EAAE,MAAM;CAO3B"}

package/dist/lib/errors.js

@@ -0,0 +1,143 @@
+const ERROR_MAP = {
+    CONCURRENT_BUILD: {
+        message: 'A build is already in progress.',
+        suggestion: 'Run `guara deployments list` to check current status.',
+    },
+    TIER_LIMIT_EXCEEDED: {
+        message: 'Resource exceeds your tier quota.',
+        suggestion: 'Upgrade your tier at app.guaracloud.com or reduce resources.',
+    },
+    BUILD_QUOTA_EXCEEDED: {
+        message: 'Build minutes quota exceeded.',
+        suggestion: 'Upgrade your tier or wait for the next billing cycle.',
+    },
+    RESOURCE_POOL_EXCEEDED: {
+        message: 'Account resource pool exhausted.',
+        suggestion: 'Scale down other services or upgrade your tier.',
+    },
+    PROJECT_LIMIT_EXCEEDED: {
+        message: 'Maximum number of projects reached for your tier.',
+        suggestion: 'Delete an unused project or upgrade your tier.',
+    },
+    SERVICE_LIMIT_EXCEEDED: {
+        message: 'Maximum number of services reached for this project.',
+        suggestion: 'Delete an unused service or upgrade your tier.',
+    },
+    DOMAIN_LIMIT_EXCEEDED: {
+        message: 'Maximum number of custom domains reached.',
+        suggestion: 'Remove an existing domain or upgrade your tier.',
+    },
+    API_KEY_LIMIT_EXCEEDED: {
+        message: 'Maximum number of API keys reached for your tier.',
+        suggestion: 'Revoke an unused key at app.guaracloud.com or upgrade your tier.',
+    },
+    INVALID_API_KEY: {
+        message: 'Authentication failed. API key is invalid or revoked.',
+        suggestion: 'Run `guara login` to re-authenticate.',
+    },
+    API_KEY_EXPIRED: {
+        message: 'Authentication failed. API key has expired.',
+        suggestion: 'Run `guara login` to generate a new key.',
+    },
+    API_KEY_SCOPE_INSUFFICIENT: {
+        message: 'Your API key lacks the required permission scope.',
+        suggestion: 'Create a new key with write scope at app.guaracloud.com.',
+    },
+    ACCOUNT_SUSPENDED: {
+        message: 'Account is suspended due to billing issues.',
+        suggestion: 'Update payment method at app.guaracloud.com.',
+    },
+    RATE_LIMITED: {
+        message: 'Too many requests. Rate limit exceeded.',
+        suggestion: 'Wait a moment and try again.',
+    },
+    PROJECT_NOT_FOUND: {
+        message: 'Project not found or you do not have access.',
+        suggestion: 'Check project slug with `guara projects list`.',
+    },
+    SERVICE_NOT_FOUND: {
+        message: 'Service not found or you do not have access.',
+        suggestion: 'Check service slug with `guara services list`.',
+    },
+    DEPLOYMENT_NOT_FOUND: {
+        message: 'Deployment not found.',
+        suggestion: 'Check deployment history with `guara deployments list`.',
+    },
+    PAYMENT_FAILED: {
+        message: 'Payment failed.',
+        suggestion: 'Update your payment method at app.guaracloud.com.',
+    },
+    TOS_NOT_ACCEPTED: {
+        message: 'Terms of Service and Privacy Policy must be accepted before using the CLI.',
+        suggestion: 'Accept the Terms of Service at https://app.guaracloud.com and try again.',
+    },
+    ACCOUNT_DELETION_PENDING: {
+        message: 'Account is scheduled for deletion.',
+        suggestion: 'Cancel deletion at https://app.guaracloud.com if this was unintentional.',
+    },
+};
+const STATUS_FALLBACKS = {
+    401: {
+        message: 'Authentication failed.',
+        suggestion: 'Run `guara login` to re-authenticate.',
+    },
+    403: {
+        message: 'You do not have permission for this action.',
+        suggestion: 'Check your role with `guara whoami` or contact the project owner.',
+    },
+    404: {
+        message: 'Resource not found.',
+        suggestion: 'Verify the project and service with `guara projects list`.',
+    },
+    429: {
+        message: 'Too many requests.',
+        suggestion: 'Wait a moment and try again.',
+    },
+};
+export function formatApiError(body, json = false) {
+    const defaultError = {
+        message: 'Something went wrong.',
+        suggestion: 'Run with `--json` for details.',
+    };
+    const byCode = body.errorCode ? ERROR_MAP[body.errorCode] : undefined;
+    const byStatus = STATUS_FALLBACKS[body.statusCode];
+    const mapped = byCode ?? byStatus ?? defaultError;
+    const result = {
+        message: mapped.message,
+        suggestion: mapped.suggestion,
+    };
+    if (json) {
+        result.json = {
+            error: {
+                code: body.errorCode ?? 'UNKNOWN_ERROR',
+                message: mapped.message,
+                status: body.statusCode,
+            },
+        };
+    }
+    return result;
+}
+export function getExitCode(statusCode) {
+    return statusCode === 401 ? 2 : 1;
+}
+export class CliError extends Error {
+    exitCode;
+    suggestion;
+    constructor(message, exitCode = 1, suggestion) {
+        super(message);
+        this.name = 'CliError';
+        this.exitCode = exitCode;
+        this.suggestion = suggestion;
+    }
+}
+export class AuthenticationError extends CliError {
+    constructor(message = 'Not authenticated. Run `guara login` first.') {
+        super(message, 2, 'Run `guara login` to authenticate.');
+    }
+}
+export class NetworkError extends CliError {
+    constructor(apiUrl) {
+        super(`Could not reach GuaraCloud API at ${apiUrl}.`, 1, 'Check your internet connection and API URL (`guara config get api-url`).');
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"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"}

package/dist/lib/output.d.ts

@@ -0,0 +1,19 @@
+interface PaginationMeta {
+    page: number;
+    limit: number;
+    total: number;
+    total_pages: number;
+    has_next: boolean;
+    has_previous: boolean;
+}
+export declare function formatJson(data: unknown, meta?: PaginationMeta): string;
+export declare function formatQuiet(value: string | string[]): string;
+export declare function formatTable(headers: string[], rows: string[][]): string;
+export declare function colorizeLogLevel(level: string): string;
+export declare function formatLogLine(timestamp: string, level: string, message: string): string;
+export declare function statusColor(status: string): string;
+export declare function successMessage(text: string): string;
+export declare function errorMessage(text: string): string;
+export declare function infoBlock(title: string, fields: Array<[string, string]>): string;
+export {};
+//# 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":"AAGA,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,MAAM,CAGvE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAE5D;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CASvE;AAWD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAIvF;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA0BlD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAIhF"}