@guaracloud/cli 0.1.0

package/dist/lib/api-client.js

@@ -0,0 +1,256 @@
+import { createRequire } from 'node:module';
+import { getApiKey, getApiUrl } from './auth.js';
+import { AuthenticationError, CliError, NetworkError } from './errors.js';
+// ─── CLI version (read from package.json at load time) ───────────────────────
+const require = createRequire(import.meta.url);
+const { version: CLI_VERSION } = require('../../package.json');
+/** Default request timeout in milliseconds (30 seconds). */
+const REQUEST_TIMEOUT_MS = 30_000;
+export class ApiError extends Error {
+    statusCode;
+    errorCode;
+    details;
+    requestId;
+    constructor(body) {
+        super(body.message);
+        this.name = 'ApiError';
+        this.statusCode = body.statusCode;
+        this.errorCode = body.errorCode;
+        this.details = body.details;
+        this.requestId = body.requestId;
+    }
+}
+// ─── API Client class ──────────────────────────────────────────────────────
+export class GuaraApiClient {
+    baseUrl;
+    apiKey;
+    fetchFn;
+    constructor(baseUrl, apiKey, fetchFn) {
+        this.baseUrl = baseUrl.replace(/\/+$/, '');
+        this.apiKey = apiKey;
+        this.fetchFn = fetchFn;
+    }
+    /**
+     * Create a client instance, resolving credentials from the auth module.
+     */
+    static async create(options = {}) {
+        const baseUrl = options.baseUrl ?? getApiUrl();
+        const apiKey = options.apiKey ?? (await getApiKey());
+        const fetchFn = options.fetch ?? globalThis.fetch;
+        return new GuaraApiClient(baseUrl, apiKey, fetchFn);
+    }
+    // ─── HTTP primitives ──────────────────────────────────────────────────
+    async request(method, path, body) {
+        if (!this.apiKey) {
+            throw new AuthenticationError();
+        }
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            'X-API-Key': this.apiKey,
+            Accept: 'application/json',
+            'User-Agent': `guara-cli/${CLI_VERSION} (${process.platform}; ${process.arch})`,
+        };
+        if (body !== undefined) {
+            headers['Content-Type'] = 'application/json';
+        }
+        let response;
+        try {
+            response = await this.fetchFn(url, {
+                method,
+                headers,
+                body: body !== undefined ? JSON.stringify(body) : undefined,
+                signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+            });
+        }
+        catch (error) {
+            if (error instanceof DOMException && error.name === 'TimeoutError') {
+                throw new NetworkError(this.baseUrl);
+            }
+            throw new NetworkError(this.baseUrl);
+        }
+        if (!response.ok) {
+            let errorBody;
+            try {
+                errorBody = (await response.json());
+            }
+            catch {
+                errorBody = {
+                    statusCode: response.status,
+                    error: response.statusText || 'Unknown Error',
+                    message: `API returned HTTP ${String(response.status)} with an unparseable response body.`,
+                };
+            }
+            throw new ApiError(errorBody);
+        }
+        // 204 No Content
+        if (response.status === 204) {
+            return undefined;
+        }
+        return (await response.json());
+    }
+    get(path) {
+        return this.request('GET', path);
+    }
+    post(path, body) {
+        return this.request('POST', path, body);
+    }
+    put(path, body) {
+        return this.request('PUT', path, body);
+    }
+    patch(path, body) {
+        return this.request('PATCH', path, body);
+    }
+    del(path) {
+        return this.request('DELETE', path);
+    }
+    // ─── Query string helpers ─────────────────────────────────────────────
+    paginated(path, params) {
+        const qs = new URLSearchParams();
+        if (params?.page !== undefined)
+            qs.set('page', String(params.page));
+        if (params?.limit !== undefined)
+            qs.set('limit', String(params.limit));
+        const query = qs.toString();
+        return query ? `${path}?${query}` : path;
+    }
+    // ─── Slug-to-UUID resolution ─────────────────────────────────────────
+    static UUID_REGEX = /^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/i;
+    /**
+     * Resolve a project identifier (slug or UUID) to a UUID.
+     * If already a UUID, returns it directly. Otherwise lists projects to find the matching slug.
+     */
+    async resolveProjectId(projectIdOrSlug) {
+        if (GuaraApiClient.UUID_REGEX.test(projectIdOrSlug)) {
+            return projectIdOrSlug;
+        }
+        const { data } = await this.listProjects({ limit: 100 });
+        const match = data.find((p) => p.slug === projectIdOrSlug);
+        if (!match) {
+            throw new CliError(`Project "${projectIdOrSlug}" not found.`, 1, 'Check your project slug with `guara projects list`.');
+        }
+        return match.id;
+    }
+    /**
+     * Resolve a service identifier (slug or UUID) to a UUID.
+     */
+    async resolveServiceId(projectId, serviceIdOrSlug) {
+        if (GuaraApiClient.UUID_REGEX.test(serviceIdOrSlug)) {
+            return serviceIdOrSlug;
+        }
+        const { data } = await this.listServices(projectId, { limit: 100 });
+        const match = data.find((s) => s.slug === serviceIdOrSlug);
+        if (!match) {
+            throw new CliError(`Service "${serviceIdOrSlug}" not found.`, 1, 'Check your service slug with `guara services list`.');
+        }
+        return match.id;
+    }
+    // ─── Auth / User ──────────────────────────────────────────────────────
+    whoami() {
+        return this.get('/api/v1/auth/me');
+    }
+    // ─── Projects ─────────────────────────────────────────────────────────
+    listProjects(params) {
+        return this.get(this.paginated('/api/v1/projects', params));
+    }
+    getProject(projectSlug) {
+        return this.get(`/api/v1/projects/${encodeURIComponent(projectSlug)}`);
+    }
+    createProject(dto) {
+        return this.post('/api/v1/projects', dto);
+    }
+    updateProject(projectSlug, dto) {
+        return this.patch(`/api/v1/projects/${encodeURIComponent(projectSlug)}`, dto);
+    }
+    deleteProject(projectSlug) {
+        return this.del(`/api/v1/projects/${encodeURIComponent(projectSlug)}`);
+    }
+    // ─── Services ─────────────────────────────────────────────────────────
+    listServices(projectSlug, params) {
+        return this.get(this.paginated(`/api/v1/projects/${encodeURIComponent(projectSlug)}/services`, params));
+    }
+    getService(projectSlug, serviceSlug) {
+        return this.get(`/api/v1/projects/${encodeURIComponent(projectSlug)}/services/${encodeURIComponent(serviceSlug)}`);
+    }
+    createService(projectSlug, dto) {
+        return this.post(`/api/v1/projects/${encodeURIComponent(projectSlug)}/services`, dto);
+    }
+    updateService(projectSlug, serviceSlug, dto) {
+        return this.patch(`/api/v1/projects/${encodeURIComponent(projectSlug)}/services/${encodeURIComponent(serviceSlug)}`, dto);
+    }
+    deleteService(projectSlug, serviceSlug) {
+        return this.del(`/api/v1/projects/${encodeURIComponent(projectSlug)}/services/${encodeURIComponent(serviceSlug)}`);
+    }
+    restartService(projectSlug, serviceSlug) {
+        return this.post(`/api/v1/projects/${encodeURIComponent(projectSlug)}/services/${encodeURIComponent(serviceSlug)}/restart`);
+    }
+    stopService(projectSlug, serviceSlug) {
+        return this.post(`/api/v1/projects/${encodeURIComponent(projectSlug)}/services/${encodeURIComponent(serviceSlug)}/stop`);
+    }
+    startService(projectSlug, serviceSlug) {
+        return this.post(`/api/v1/projects/${encodeURIComponent(projectSlug)}/services/${encodeURIComponent(serviceSlug)}/start`);
+    }
+    // ─── Deployments ──────────────────────────────────────────────────────
+    listDeployments(projectSlug, serviceSlug, params) {
+        return this.get(this.paginated(`/api/v1/projects/${encodeURIComponent(projectSlug)}/services/${encodeURIComponent(serviceSlug)}/deployments`, params));
+    }
+    createDeployment(projectSlug, serviceSlug, dto) {
+        return this.post(`/api/v1/projects/${encodeURIComponent(projectSlug)}/services/${encodeURIComponent(serviceSlug)}/deployments`, dto);
+    }
+    getDeployment(projectSlug, serviceSlug, deploymentId) {
+        return this.get(`/api/v1/projects/${encodeURIComponent(projectSlug)}/services/${encodeURIComponent(serviceSlug)}/deployments/${encodeURIComponent(deploymentId)}`);
+    }
+    rollbackDeployment(projectSlug, serviceSlug, targetDeploymentId) {
+        return this.post(`/api/v1/projects/${encodeURIComponent(projectSlug)}/services/${encodeURIComponent(serviceSlug)}/deployments/${encodeURIComponent(targetDeploymentId)}/rollback`);
+    }
+    // ─── Domains ──────────────────────────────────────────────────────────
+    listDomains(projectSlug, serviceSlug) {
+        return this.get(`/api/v1/projects/${encodeURIComponent(projectSlug)}/services/${encodeURIComponent(serviceSlug)}/domains`);
+    }
+    createDomain(projectSlug, serviceSlug, dto) {
+        return this.post(`/api/v1/projects/${encodeURIComponent(projectSlug)}/services/${encodeURIComponent(serviceSlug)}/domains`, dto);
+    }
+    deleteDomain(projectSlug, serviceSlug, domainId) {
+        return this.del(`/api/v1/projects/${encodeURIComponent(projectSlug)}/services/${encodeURIComponent(serviceSlug)}/domains/${encodeURIComponent(domainId)}`);
+    }
+    // ─── Environment Variables ────────────────────────────────────────────
+    getEnvVars(projectSlug, serviceSlug) {
+        return this.get(`/api/v1/projects/${encodeURIComponent(projectSlug)}/services/${encodeURIComponent(serviceSlug)}/env`);
+    }
+    updateEnvVars(projectSlug, serviceSlug, dto) {
+        return this.put(`/api/v1/projects/${encodeURIComponent(projectSlug)}/services/${encodeURIComponent(serviceSlug)}/env`, dto);
+    }
+    // ─── Scaling ─────────────────────────────────────────────────────────
+    updateScaling(projectSlug, serviceSlug, dto) {
+        return this.patch(`/api/v1/projects/${encodeURIComponent(projectSlug)}/services/${encodeURIComponent(serviceSlug)}/scaling`, dto);
+    }
+    // ─── Logs ──────────────────────────────────────────────────────────
+    queryLogs(projectSlug, serviceSlug, params = {}) {
+        const qs = new URLSearchParams();
+        if (params.since)
+            qs.set('since', params.since);
+        if (params.until)
+            qs.set('until', params.until);
+        if (params.limit !== undefined)
+            qs.set('limit', String(params.limit));
+        if (params.search)
+            qs.set('search', params.search);
+        if (params.level)
+            qs.set('level', params.level);
+        if (params.direction)
+            qs.set('direction', params.direction);
+        const query = qs.toString();
+        const base = `/api/v1/projects/${encodeURIComponent(projectSlug)}/services/${encodeURIComponent(serviceSlug)}/logs`;
+        return this.get(query ? `${base}?${query}` : base);
+    }
+    // ─── Platform Status ───────────────────────────────────────────────
+    /**
+     * Fetch public platform status.
+     *
+     * Note: This endpoint does not require authentication on the server,
+     * but the client still sends the Bearer token if available.
+     */
+    getPlatformStatus() {
+        return this.get('/api/v1/status');
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/lib/api-client.js.map

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

package/dist/lib/auth.d.ts

@@ -0,0 +1,68 @@
+import Conf from 'conf';
+interface CliConfig {
+    apiUrl: string;
+    apiKey?: string;
+}
+declare const config: Conf<CliConfig>;
+/**
+ * Save an API key.
+ *
+ * Strategy:
+ *  1. Try the OS keychain via `@napi-rs/keyring`.
+ *  2. Fall back to the plain-text `conf` store (XDG config dir).
+ *
+ * Returns `'keychain'` or `'file'` to indicate which backend was used.
+ */
+export declare function saveApiKey(key: string): Promise<'keychain' | 'file'>;
+/**
+ * Resolve the current API key.
+ *
+ * Resolution order:
+ *  1. `GUARA_API_KEY` environment variable (for CI / scripts).
+ *  2. OS keychain.
+ *  3. `conf` file store.
+ */
+export declare function getApiKey(): Promise<string | undefined>;
+/**
+ * Remove stored credentials from all backends.
+ *
+ * Returns `true` if a credential was found and deleted, `false` otherwise.
+ */
+export declare function clearApiKey(): Promise<boolean>;
+/**
+ * Get the configured API base URL.
+ *
+ * Resolution order:
+ *  1. `GUARA_API_URL` environment variable.
+ *  2. `conf` file store (defaults to https://api.guaracloud.com).
+ */
+export declare function getApiUrl(): string;
+/**
+ * Set the API base URL in the config store.
+ */
+export declare function setApiUrl(url: string): void;
+/**
+ * Return the underlying conf path for debugging/diagnostics.
+ */
+export declare function getConfigPath(): string;
+/**
+ * Set a configuration value by key.
+ *
+ * Only user-facing keys (e.g. `apiUrl`) are writable.
+ * The `apiKey` is managed exclusively through {@link saveApiKey} / {@link clearApiKey}.
+ */
+export declare function setConfigValue(key: string, value: string): void;
+/**
+ * Get a single configuration value by key.
+ */
+export declare function getConfigValue(key: string): string | undefined;
+/**
+ * Return all non-sensitive configuration as a plain object.
+ */
+export declare function getAllConfig(): Record<string, string | undefined>;
+/**
+ * Reset configuration to defaults (clears apiUrl override; does NOT clear the API key).
+ */
+export declare function resetConfig(): void;
+export { config as _config };
+//# sourceMappingURL=auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/lib/auth.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAKxB,UAAU,SAAS;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,QAAA,MAAM,MAAM,iBAKV,CAAC;AAgBH;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,MAAM,CAAC,CAmB1E;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAoB7D;AAED;;;;GAIG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAmBpD;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAeD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAU/D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAU9D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAMjE;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAGD,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,CAAC"}

package/dist/lib/auth.js

@@ -0,0 +1,180 @@
+import Conf from 'conf';
+const KEYRING_SERVICE = 'guaracloud-cli';
+const KEYRING_ACCOUNT = 'api-key';
+const config = new Conf({
+    projectName: 'guara',
+    defaults: {
+        apiUrl: 'https://api.guaracloud.com',
+    },
+});
+/**
+ * Attempt to load `@napi-rs/keyring` at runtime.
+ * Returns the Entry class or undefined if the native module is unavailable
+ * (e.g., missing native binary, headless CI, Docker without secrets service).
+ */
+async function loadKeyring() {
+    try {
+        const mod = await import('@napi-rs/keyring');
+        return mod.Entry;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Save an API key.
+ *
+ * Strategy:
+ *  1. Try the OS keychain via `@napi-rs/keyring`.
+ *  2. Fall back to the plain-text `conf` store (XDG config dir).
+ *
+ * Returns `'keychain'` or `'file'` to indicate which backend was used.
+ */
+export async function saveApiKey(key) {
+    const Entry = await loadKeyring();
+    if (Entry) {
+        try {
+            const entry = new Entry(KEYRING_SERVICE, KEYRING_ACCOUNT);
+            entry.setPassword(key);
+            // Clear any stale file-based key so we don't have two sources of truth.
+            config.delete('apiKey');
+            return 'keychain';
+        }
+        catch {
+            // Keychain write failed (e.g., sandbox restriction). Fall through.
+        }
+    }
+    config.set('apiKey', key);
+    return 'file';
+}
+/**
+ * Resolve the current API key.
+ *
+ * Resolution order:
+ *  1. `GUARA_API_KEY` environment variable (for CI / scripts).
+ *  2. OS keychain.
+ *  3. `conf` file store.
+ */
+export async function getApiKey() {
+    const envKey = process.env['GUARA_API_KEY'];
+    if (envKey) {
+        return envKey;
+    }
+    const Entry = await loadKeyring();
+    if (Entry) {
+        try {
+            const entry = new Entry(KEYRING_SERVICE, KEYRING_ACCOUNT);
+            const password = entry.getPassword();
+            if (password !== null) {
+                return password;
+            }
+        }
+        catch {
+            // Keychain read failed — fall through to file.
+        }
+    }
+    return config.get('apiKey');
+}
+/**
+ * Remove stored credentials from all backends.
+ *
+ * Returns `true` if a credential was found and deleted, `false` otherwise.
+ */
+export async function clearApiKey() {
+    let deleted = false;
+    const Entry = await loadKeyring();
+    if (Entry) {
+        try {
+            const entry = new Entry(KEYRING_SERVICE, KEYRING_ACCOUNT);
+            deleted = entry.deleteCredential();
+        }
+        catch {
+            // Ignore — may not exist.
+        }
+    }
+    if (config.has('apiKey')) {
+        config.delete('apiKey');
+        deleted = true;
+    }
+    return deleted;
+}
+/**
+ * Get the configured API base URL.
+ *
+ * Resolution order:
+ *  1. `GUARA_API_URL` environment variable.
+ *  2. `conf` file store (defaults to https://api.guaracloud.com).
+ */
+export function getApiUrl() {
+    return process.env['GUARA_API_URL'] ?? config.get('apiUrl');
+}
+/**
+ * Set the API base URL in the config store.
+ */
+export function setApiUrl(url) {
+    config.set('apiUrl', url);
+}
+/**
+ * Return the underlying conf path for debugging/diagnostics.
+ */
+export function getConfigPath() {
+    return config.path;
+}
+// ─── Config key/value helpers ───────────────────────────────────────────────
+/** Map of user-facing kebab-case keys to internal camelCase keys. */
+const CONFIG_KEY_MAP = {
+    'api-url': 'apiUrl',
+    apiUrl: 'apiUrl',
+};
+/** Resolve a user-facing key (kebab or camel) to the internal config key. */
+function resolveConfigKey(key) {
+    return CONFIG_KEY_MAP[key];
+}
+/**
+ * Set a configuration value by key.
+ *
+ * Only user-facing keys (e.g. `apiUrl`) are writable.
+ * The `apiKey` is managed exclusively through {@link saveApiKey} / {@link clearApiKey}.
+ */
+export function setConfigValue(key, value) {
+    const resolved = resolveConfigKey(key);
+    if (!resolved) {
+        throw new Error(`Unknown config key: ${key}. Allowed keys: ${Object.keys(CONFIG_KEY_MAP)
+            .filter((k) => k.includes('-'))
+            .join(', ')}`);
+    }
+    config.set(resolved, value);
+}
+/**
+ * Get a single configuration value by key.
+ */
+export function getConfigValue(key) {
+    const resolved = resolveConfigKey(key);
+    if (resolved === 'apiUrl') {
+        return config.get('apiUrl');
+    }
+    // apiKey is sensitive — return whether it's set, not the value.
+    if (key === 'apiKey' || key === 'api-key') {
+        return config.has('apiKey') ? '(set)' : undefined;
+    }
+    return undefined;
+}
+/**
+ * Return all non-sensitive configuration as a plain object.
+ */
+export function getAllConfig() {
+    return {
+        'api-url': config.get('apiUrl'),
+        'api-key': config.has('apiKey') ? '(set)' : undefined,
+        'config-path': config.path,
+    };
+}
+/**
+ * Reset configuration to defaults (clears apiUrl override; does NOT clear the API key).
+ */
+export function resetConfig() {
+    config.set('apiUrl', 'https://api.guaracloud.com');
+}
+// Re-export for testing seams.
+export { config as _config };
+//# sourceMappingURL=auth.js.map

package/dist/lib/auth.js.map

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

package/dist/lib/base-command.d.ts

@@ -0,0 +1,94 @@
+import { Command } from '@oclif/core';
+import { GuaraApiClient } from './api-client.js';
+import type { ResolvedContext } from './context.js';
+export declare const globalFlags: {
+    readonly json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    readonly quiet: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    readonly 'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    readonly 'api-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    readonly project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    readonly service: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    readonly yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+};
+export type GlobalFlags = {
+    json: boolean;
+    quiet: boolean;
+    'api-key': string | undefined;
+    'api-url': string | undefined;
+    project: string | undefined;
+    service: string | undefined;
+    yes: boolean;
+};
+/**
+ * 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 declare abstract class BaseCommand extends Command {
+    static baseFlags: {
+        readonly json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        readonly quiet: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        readonly 'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly 'api-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly service: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    /**
+     * 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)
+     */
+    protected initApiClient(flags: GlobalFlags): Promise<GuaraApiClient>;
+    /**
+     * Resolve project/service context from flags, environment, or `.guara.json`.
+     *
+     * Returns `undefined` when no project could be determined from any source.
+     */
+    protected resolveProjectContext(flags: GlobalFlags): Promise<ResolvedContext | undefined>;
+    /**
+     * 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.
+     */
+    protected requireProject(flags: GlobalFlags, client: GuaraApiClient): Promise<string>;
+    /**
+     * 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.
+     */
+    protected requireService(flags: GlobalFlags, client: GuaraApiClient): Promise<[project: string, service: string]>;
+    /**
+     * Print structured JSON to stdout and return it (so oclif's `--json`
+     * envelope can use the value if `enableJsonFlag` is set on the command).
+     */
+    protected outputJson(data: unknown): void;
+    /**
+     * Print a minimal value for `--quiet` mode (e.g. a slug or ID).
+     */
+    protected outputQuiet(value: string | string[]): void;
+    /**
+     * Unified error handler that formats known error types into user-friendly
+     * messages, with optional JSON output.
+     */
+    protected catch(err: Error & {
+        exitCode?: number;
+    }): Promise<void>;
+}
+//# sourceMappingURL=base-command.d.ts.map

package/dist/lib/base-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-command.d.ts","sourceRoot":"","sources":["../../src/lib/base-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAG7C,OAAO,EAAY,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAG3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAMpD,eAAO,MAAM,WAAW;;;;;;;;CAqCd,CAAC;AAIX,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAIF;;;;;;;;;;GAUG;AACH,8BAAsB,WAAY,SAAQ,OAAO;IAC/C,OAAgB,SAAS;;;;;;;;MAAe;IAIxC;;;;;;;;;;OAUG;cACa,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAS1E;;;;OAIG;cACa,qBAAqB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAO/F;;;;;;OAMG;cACa,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAc3F;;;;;;OAMG;cACa,cAAc,CAC5B,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IA0B9C;;;OAGG;IACH,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAIzC;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAMrD;;;OAGG;cAEsB,KAAK,CAAC,GAAG,EAAE,KAAK,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAiDlF"}