@nordsym/apiclaw 1.3.6 → 1.3.8

package/dist/ui/spinner.js

@@ -0,0 +1,229 @@
+/**
+ * APIClaw MCP Auto-Setup - Spinner Utilities
+ *
+ * Ora-based spinner wrapper with consistent styling and state management.
+ * Provides a fluent API for progress indication during CLI operations.
+ */
+import ora from 'ora';
+import { colors, icons } from './colors.js';
+/**
+ * Create a task spinner with APIClaw styling
+ */
+export function createSpinner(options = {}) {
+    const { text = '', prefix = '', suffix = '', showInCI = false, spinner = 'dots', } = options;
+    const oraInstance = ora({
+        text,
+        prefixText: prefix,
+        suffixText: suffix,
+        spinner,
+        // Disable spinner in CI by default for cleaner logs
+        isEnabled: showInCI || !process.env.CI,
+    });
+    const wrapper = {
+        start(newText) {
+            if (newText)
+                oraInstance.text = newText;
+            oraInstance.start();
+            return wrapper;
+        },
+        text(newText) {
+            oraInstance.text = newText;
+            return wrapper;
+        },
+        succeed(newText) {
+            oraInstance.succeed(newText);
+            return wrapper;
+        },
+        fail(newText) {
+            oraInstance.fail(newText);
+            return wrapper;
+        },
+        warn(newText) {
+            oraInstance.warn(newText);
+            return wrapper;
+        },
+        info(newText) {
+            oraInstance.info(newText);
+            return wrapper;
+        },
+        stop() {
+            oraInstance.stop();
+            return wrapper;
+        },
+        clear() {
+            oraInstance.stopAndPersist({ symbol: '' });
+            return wrapper;
+        },
+        isSpinning() {
+            return oraInstance.isSpinning;
+        },
+        get ora() {
+            return oraInstance;
+        },
+    };
+    return wrapper;
+}
+/**
+ * Convenience function for common spinner patterns
+ */
+export const spinner = {
+    /**
+     * Create and start a spinner in one call
+     */
+    start(text) {
+        return createSpinner({ text }).start();
+    },
+    /**
+     * Run an async task with spinner, auto-succeed/fail
+     */
+    async task(text, fn, options = {}) {
+        const s = createSpinner({ text }).start();
+        try {
+            const result = await fn(s);
+            const successMsg = typeof options.successText === 'function'
+                ? options.successText(result)
+                : options.successText || text;
+            s.succeed(successMsg);
+            return result;
+        }
+        catch (error) {
+            const failMsg = typeof options.failText === 'function'
+                ? options.failText(error)
+                : options.failText || `${text} - Failed`;
+            s.fail(failMsg);
+            throw error;
+        }
+    },
+    /**
+     * Run multiple tasks in sequence with spinners
+     */
+    async sequence(tasks) {
+        const results = [];
+        for (const { text, task, successText, failText } of tasks) {
+            const result = await this.task(text, task, { successText, failText });
+            results.push(result);
+        }
+        return results;
+    },
+};
+/**
+ * Progress tracker for multi-step operations
+ */
+export class ProgressTracker {
+    current = 0;
+    total;
+    items;
+    taskSpinner;
+    constructor(items) {
+        this.items = items;
+        this.total = items.length;
+        this.taskSpinner = createSpinner();
+    }
+    /**
+     * Start tracking progress
+     */
+    start() {
+        this.current = 0;
+        this.updateText();
+        this.taskSpinner.start();
+    }
+    /**
+     * Move to next item
+     */
+    next() {
+        this.current++;
+        this.updateText();
+    }
+    /**
+     * Mark current item as done and move to next
+     */
+    done(message) {
+        this.taskSpinner.succeed(message || this.items[this.current - 1]);
+        if (this.current < this.total) {
+            this.taskSpinner.start(this.formatProgress());
+        }
+    }
+    /**
+     * Mark as complete
+     */
+    complete(message) {
+        this.taskSpinner.succeed(message);
+    }
+    /**
+     * Mark as failed
+     */
+    fail(message) {
+        this.taskSpinner.fail(message);
+    }
+    updateText() {
+        this.taskSpinner.text(this.formatProgress());
+    }
+    formatProgress() {
+        const item = this.items[this.current] || 'Processing...';
+        return `[${this.current + 1}/${this.total}] ${item}`;
+    }
+}
+/**
+ * Silent spinner for non-interactive/CI environments
+ * Logs plain text instead of animated spinners
+ */
+export function createSilentSpinner(options = {}) {
+    const log = (symbol, text) => {
+        if (text) {
+            console.log(`${symbol} ${text}`);
+        }
+    };
+    let currentText = options.text || '';
+    const wrapper = {
+        start(text) {
+            currentText = text || currentText;
+            log(colors.muted('○'), currentText);
+            return wrapper;
+        },
+        text(text) {
+            currentText = text;
+            return wrapper;
+        },
+        succeed(text) {
+            log(icons.success, text || currentText);
+            return wrapper;
+        },
+        fail(text) {
+            log(icons.error, text || currentText);
+            return wrapper;
+        },
+        warn(text) {
+            log(icons.warning, text || currentText);
+            return wrapper;
+        },
+        info(text) {
+            log(icons.info, text || currentText);
+            return wrapper;
+        },
+        stop() {
+            return wrapper;
+        },
+        clear() {
+            return wrapper;
+        },
+        isSpinning() {
+            return false;
+        },
+        get ora() {
+            // Return a mock for compatibility
+            return {};
+        },
+    };
+    return wrapper;
+}
+/**
+ * Get appropriate spinner based on environment
+ */
+export function getSpinner(options = {}) {
+    // Use silent spinner in CI or when stdout is not a TTY
+    if (process.env.CI || !process.stdout.isTTY) {
+        return createSilentSpinner(options);
+    }
+    return createSpinner(options);
+}
+//# sourceMappingURL=spinner.js.map

package/dist/ui/spinner.js.map

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

package/dist/utils/backup.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Backup System
+ * Handles timestamped backups of config files with automatic cleanup
+ */
+export interface BackupResult {
+    success: boolean;
+    backupPath: string | null;
+    error?: string;
+}
+export interface BackupInfo {
+    path: string;
+    timestamp: number;
+    date: Date;
+    filename: string;
+}
+/**
+ * Create a backup of a config file
+ */
+export declare function createBackup(configPath: string): BackupResult;
+/**
+ * List all backups for a config file
+ */
+export declare function listBackups(configPath: string): BackupInfo[];
+/**
+ * Get the most recent backup
+ */
+export declare function getLatestBackup(configPath: string): BackupInfo | null;
+/**
+ * Cleanup old backups, keeping only MAX_BACKUPS most recent
+ */
+export declare function cleanupOldBackups(configPath: string): number;
+/**
+ * Restore from a backup
+ */
+export declare function restoreBackup(backupPath: string, targetPath: string): BackupResult;
+/**
+ * Restore from the most recent backup
+ */
+export declare function restoreLatestBackup(configPath: string): BackupResult;
+/**
+ * Format backup info for display
+ */
+export declare function formatBackupInfo(backup: BackupInfo): string;
+/**
+ * Delete all backups for a config file
+ */
+export declare function deleteAllBackups(configPath: string): number;
+//# sourceMappingURL=backup.d.ts.map

package/dist/utils/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/utils/backup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB;AAaD;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CAqC7D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,EAAE,CA8B5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAGrE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAiB5D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,CA2BlF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CAYpE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAG3D;AASD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAc3D"}

package/dist/utils/backup.js

@@ -0,0 +1,182 @@
+/**
+ * Backup System
+ * Handles timestamped backups of config files with automatic cleanup
+ */
+import { existsSync, mkdirSync, readdirSync, unlinkSync, copyFileSync } from 'fs';
+import { dirname, basename, join } from 'path';
+const MAX_BACKUPS = 5;
+const BACKUP_PATTERN = /\.backup\.(\d+)\.json$/;
+/**
+ * Generate backup filename with timestamp
+ */
+function generateBackupFilename(originalPath) {
+    const dir = dirname(originalPath);
+    const base = basename(originalPath, '.json');
+    const timestamp = Date.now();
+    return join(dir, `${base}.backup.${timestamp}.json`);
+}
+/**
+ * Create a backup of a config file
+ */
+export function createBackup(configPath) {
+    try {
+        // Check if original file exists
+        if (!existsSync(configPath)) {
+            return {
+                success: true,
+                backupPath: null,
+                // No backup needed if file doesn't exist
+            };
+        }
+        // Ensure backup directory exists
+        const dir = dirname(configPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        // Generate backup path
+        const backupPath = generateBackupFilename(configPath);
+        // Copy file
+        copyFileSync(configPath, backupPath);
+        // Cleanup old backups
+        cleanupOldBackups(configPath);
+        return {
+            success: true,
+            backupPath,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            backupPath: null,
+            error: error instanceof Error ? error.message : 'Unknown error creating backup',
+        };
+    }
+}
+/**
+ * List all backups for a config file
+ */
+export function listBackups(configPath) {
+    const dir = dirname(configPath);
+    const baseName = basename(configPath, '.json');
+    if (!existsSync(dir)) {
+        return [];
+    }
+    const files = readdirSync(dir);
+    const backups = [];
+    for (const file of files) {
+        // Match backup pattern: {basename}.backup.{timestamp}.json
+        const match = file.match(new RegExp(`^${escapeRegex(baseName)}\\.backup\\.(\\d+)\\.json$`));
+        if (match) {
+            const timestamp = parseInt(match[1], 10);
+            const fullPath = join(dir, file);
+            backups.push({
+                path: fullPath,
+                timestamp,
+                date: new Date(timestamp),
+                filename: file,
+            });
+        }
+    }
+    // Sort by timestamp, newest first
+    return backups.sort((a, b) => b.timestamp - a.timestamp);
+}
+/**
+ * Get the most recent backup
+ */
+export function getLatestBackup(configPath) {
+    const backups = listBackups(configPath);
+    return backups[0] || null;
+}
+/**
+ * Cleanup old backups, keeping only MAX_BACKUPS most recent
+ */
+export function cleanupOldBackups(configPath) {
+    const backups = listBackups(configPath);
+    let deleted = 0;
+    // Keep only the first MAX_BACKUPS
+    const toDelete = backups.slice(MAX_BACKUPS);
+    for (const backup of toDelete) {
+        try {
+            unlinkSync(backup.path);
+            deleted++;
+        }
+        catch {
+            // Ignore deletion errors
+        }
+    }
+    return deleted;
+}
+/**
+ * Restore from a backup
+ */
+export function restoreBackup(backupPath, targetPath) {
+    try {
+        if (!existsSync(backupPath)) {
+            return {
+                success: false,
+                backupPath: null,
+                error: `Backup file not found: ${backupPath}`,
+            };
+        }
+        // Backup current file before restoring
+        const preRestoreBackup = createBackup(targetPath);
+        // Copy backup to target
+        copyFileSync(backupPath, targetPath);
+        return {
+            success: true,
+            backupPath: preRestoreBackup.backupPath,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            backupPath: null,
+            error: error instanceof Error ? error.message : 'Unknown error restoring backup',
+        };
+    }
+}
+/**
+ * Restore from the most recent backup
+ */
+export function restoreLatestBackup(configPath) {
+    const latest = getLatestBackup(configPath);
+    if (!latest) {
+        return {
+            success: false,
+            backupPath: null,
+            error: 'No backups found',
+        };
+    }
+    return restoreBackup(latest.path, configPath);
+}
+/**
+ * Format backup info for display
+ */
+export function formatBackupInfo(backup) {
+    const date = backup.date.toLocaleString();
+    return `${backup.filename} (${date})`;
+}
+/**
+ * Escape regex special characters
+ */
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Delete all backups for a config file
+ */
+export function deleteAllBackups(configPath) {
+    const backups = listBackups(configPath);
+    let deleted = 0;
+    for (const backup of backups) {
+        try {
+            unlinkSync(backup.path);
+            deleted++;
+        }
+        catch {
+            // Ignore deletion errors
+        }
+    }
+    return deleted;
+}
+//# sourceMappingURL=backup.js.map

package/dist/utils/backup.js.map

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

package/dist/utils/config.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Config Management
+ * Handles JSON read/write/merge operations for MCP config files
+ */
+export interface MCPServerConfig {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+export interface MCPConfig {
+    mcpServers?: Record<string, MCPServerConfig>;
+    [key: string]: unknown;
+}
+export interface ContinueServerConfig {
+    name: string;
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+export interface ContinueConfig {
+    mcpServers?: ContinueServerConfig[];
+    [key: string]: unknown;
+}
+export interface ConfigReadResult {
+    success: boolean;
+    config: MCPConfig | ContinueConfig | null;
+    error?: string;
+    isNew?: boolean;
+}
+export interface ConfigWriteResult {
+    success: boolean;
+    error?: string;
+    backupPath?: string | null;
+}
+export interface MergeOptions {
+    force?: boolean;
+    workspace?: string;
+    serverName?: string;
+}
+/**
+ * Read and parse a JSON config file
+ */
+export declare function readConfig(configPath: string): ConfigReadResult;
+/**
+ * Write config to file with backup
+ */
+export declare function writeConfig(configPath: string, config: MCPConfig | ContinueConfig, createBackupFirst?: boolean): ConfigWriteResult;
+/**
+ * Deep merge two objects
+ */
+export declare function deepMerge<T extends Record<string, unknown>>(target: T, source: Partial<T>): T;
+/**
+ * Generate APIClaw MCP server configuration
+ */
+export declare function generateApiclawConfig(options?: MergeOptions): MCPServerConfig;
+/**
+ * Generate APIClaw config for Continue (array format)
+ */
+export declare function generateApiclawContinueConfig(options?: MergeOptions): ContinueServerConfig;
+/**
+ * Check if APIClaw is already configured
+ */
+export declare function hasApiclawConfig(config: MCPConfig | ContinueConfig, serverName?: string): boolean;
+/**
+ * Merge APIClaw config into existing config (standard format)
+ */
+export declare function mergeApiclawConfig(existingConfig: MCPConfig, options?: MergeOptions): MCPConfig;
+/**
+ * Merge APIClaw config into Continue config (array format)
+ */
+export declare function mergeApiclawContinueConfig(existingConfig: ContinueConfig, options?: MergeOptions): ContinueConfig;
+/**
+ * Remove APIClaw from config
+ */
+export declare function removeApiclawConfig(config: MCPConfig | ContinueConfig, serverName?: string): MCPConfig | ContinueConfig;
+/**
+ * Detect if config uses Continue's array format
+ */
+export declare function isContinueFormat(config: MCPConfig | ContinueConfig): config is ContinueConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC7C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAGD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACpC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,cAAc,GAAG,IAAI,CAAC;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CA2C/D;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS,GAAG,cAAc,EAClC,iBAAiB,UAAO,GACvB,iBAAiB,CAsCnB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzD,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GACjB,CAAC,CA2BH;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,YAAiB,GAAG,eAAe,CAajF;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,GAAE,YAAiB,GAAG,oBAAoB,CAc9F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc,EAAE,UAAU,SAAY,GAAG,OAAO,CAUpG;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,cAAc,EAAE,SAAS,EACzB,OAAO,GAAE,YAAiB,GACzB,SAAS,CAUX;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,cAAc,EAC9B,OAAO,GAAE,YAAiB,GACzB,cAAc,CAuBhB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,GAAG,cAAc,EAClC,UAAU,SAAY,GACrB,SAAS,GAAG,cAAc,CAkB5B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc,GAAG,MAAM,IAAI,cAAc,CAE7F"}