@nebulaos/cli 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,117 @@
+import { Command } from 'commander';
+import { AxiosInstance } from 'axios';
+
+declare function createProgram(): Command;
+
+declare function getApiClient(): AxiosInstance;
+declare function resetApiClient(): void;
+
+interface ContextConfig {
+    name: string;
+    apiUrl: string;
+    token: string;
+    organizationId?: string;
+}
+interface CLIConfig {
+    contexts: Record<string, ContextConfig>;
+    currentContext: string | null;
+    defaults: {
+        output: "table" | "json" | "yaml" | "quiet";
+        pageSize: number;
+    };
+}
+declare function getConfig(): CLIConfig;
+declare function getCurrentContext(): ContextConfig;
+declare function setContext(name: string, context: ContextConfig): void;
+declare function removeContext(name: string): void;
+declare function useContext(name: string): void;
+declare function listContexts(): Array<ContextConfig & {
+    active: boolean;
+}>;
+declare function setDefault<K extends keyof CLIConfig["defaults"]>(key: K, value: CLIConfig["defaults"][K]): void;
+declare function getConfigPath(): string;
+
+type OutputFormat = "table" | "json" | "yaml" | "quiet";
+declare function resolveFormat(flagValue?: string): OutputFormat;
+interface TableOptions {
+    headers: string[];
+    rows: string[][];
+}
+declare function printTable({ headers, rows }: TableOptions): void;
+declare function printJson(data: unknown): void;
+declare function printYaml(data: unknown): void;
+declare function printQuiet(ids: string[]): void;
+interface OutputData {
+    table: TableOptions;
+    data: unknown;
+    ids: string[];
+}
+declare function output(format: OutputFormat, outputData: OutputData): void;
+declare function printSuccess(message: string): void;
+declare function printWarning(message: string): void;
+declare function printDetail(label: string, value: string): void;
+
+declare enum ExitCode {
+    Success = 0,
+    GeneralError = 1,
+    InvalidArgument = 2,
+    AuthenticationError = 3,
+    AuthorizationError = 4,
+    NotFound = 5,
+    ConflictError = 6,
+    ValidationError = 7,
+    NetworkError = 8,
+    TimeoutError = 9,
+    ServerError = 10,
+    ConfigError = 11
+}
+declare class CLIError extends Error {
+    readonly exitCode: ExitCode;
+    readonly hint?: string | undefined;
+    constructor(message: string, exitCode?: ExitCode, hint?: string | undefined);
+}
+declare class AuthenticationError extends CLIError {
+    constructor(message?: string);
+}
+declare class AuthorizationError extends CLIError {
+    constructor(message?: string);
+}
+declare class NotFoundError extends CLIError {
+    constructor(resource: string, identifier: string);
+}
+declare class ValidationError extends CLIError {
+    constructor(message: string);
+}
+declare class NetworkError extends CLIError {
+    constructor(message?: string);
+}
+declare class ConfigError extends CLIError {
+    constructor(message: string);
+}
+declare function handleError(error: unknown): never;
+
+interface PaginationMeta {
+    page: number;
+    pageSize: number;
+    total: number;
+    totalPages: number;
+}
+declare function printPaginationInfo(meta: PaginationMeta): void;
+declare function buildPaginationParams(options: {
+    page?: number;
+    pageSize?: number;
+}): Record<string, number>;
+
+declare function truncate(text: string | null | undefined, maxLength?: number, type?: string): string;
+declare function truncateId(id: string): string;
+declare function formatDate(date: string | null | undefined): string;
+
+declare function addGlobalFlags(program: Command): Command;
+declare function addPaginationFlags(command: Command): Command;
+
+declare function withAuth<T>(fn: (context: ContextConfig) => Promise<T>): () => Promise<T>;
+declare function requireAuth(): ContextConfig;
+
+declare function createAuthCommand(): Command;
+
+export { AuthenticationError, AuthorizationError, type CLIConfig, CLIError, ConfigError, type ContextConfig, ExitCode, NetworkError, NotFoundError, type OutputData, type OutputFormat, type PaginationMeta, type TableOptions, ValidationError, addGlobalFlags, addPaginationFlags, buildPaginationParams, createAuthCommand, createProgram, formatDate, getApiClient, getConfig, getConfigPath, getCurrentContext, handleError, listContexts, output, printDetail, printJson, printPaginationInfo, printQuiet, printSuccess, printTable, printWarning, printYaml, removeContext, requireAuth, resetApiClient, resolveFormat, setContext, setDefault, truncate, truncateId, useContext, withAuth };