@jonnyhoo/ccs 1.0.0

package/dist/utils/port-utils.js

@@ -0,0 +1,217 @@
+"use strict";
+/**
+ * Port utilities for detecting process ownership
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testLocalhostBinding = exports.waitForPortFree = exports.checkWindowsFirewall = exports.isCLIProxyProcess = exports.getPortProcess = void 0;
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const execAsync = (0, util_1.promisify)(child_process_1.exec);
+/**
+ * Get process information for a port
+ * @param port Port number to check
+ * @returns Process info or null if port is free
+ */
+async function getPortProcess(port) {
+    const isWindows = process.platform === 'win32';
+    try {
+        if (isWindows) {
+            return await getPortProcessWindows(port);
+        }
+        else {
+            return await getPortProcessUnix(port);
+        }
+    }
+    catch {
+        // If detection fails, return null (assume port is free)
+        return null;
+    }
+}
+exports.getPortProcess = getPortProcess;
+/**
+ * Unix/Linux/macOS implementation using lsof
+ */
+async function getPortProcessUnix(port) {
+    try {
+        const { stdout } = await execAsync(`lsof -i :${port} -sTCP:LISTEN -F pcn`, {
+            timeout: 3000,
+        });
+        if (!stdout.trim()) {
+            return null; // Port free
+        }
+        // Parse lsof -F output:
+        // p<pid>
+        // c<command>
+        // n<network>
+        const lines = stdout.trim().split('\n');
+        let pid = null;
+        let processName = null;
+        for (const line of lines) {
+            if (line.startsWith('p')) {
+                pid = parseInt(line.substring(1), 10);
+            }
+            else if (line.startsWith('c')) {
+                processName = line.substring(1);
+            }
+        }
+        if (pid && processName) {
+            return { pid, processName };
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Windows implementation using netstat
+ */
+async function getPortProcessWindows(port) {
+    try {
+        // netstat -ano finds PID, then tasklist gets process name
+        const { stdout: netstatOut } = await execAsync(`netstat -ano | findstr :${port} | findstr LISTENING`, { timeout: 3000 });
+        if (!netstatOut.trim()) {
+            return null; // Port free
+        }
+        // Parse netstat output to get PID (last column)
+        const match = netstatOut.match(/\s+(\d+)\s*$/m);
+        if (!match) {
+            return null;
+        }
+        const pid = parseInt(match[1], 10);
+        // Get process name from PID
+        const { stdout: tasklistOut } = await execAsync(`tasklist /FI "PID eq ${pid}" /NH`, {
+            timeout: 3000,
+        });
+        const taskMatch = tasklistOut.match(/^([^\s]+)/);
+        const processName = taskMatch ? taskMatch[1] : `PID-${pid}`;
+        return { pid, processName };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if process is CLIProxy
+ * Uses prefix matching to handle Linux kernel's 15-char process name truncation
+ * (e.g., 'cli-proxy-api-plus' becomes 'cli-proxy-api-p' in lsof/ps output)
+ */
+function isCLIProxyProcess(process) {
+    if (!process) {
+        return false;
+    }
+    const name = process.processName.toLowerCase();
+    // All CLIProxy variants start with 'cli-proxy' or 'cliproxy'
+    return name.startsWith('cli-proxy') || name.startsWith('cliproxy');
+}
+exports.isCLIProxyProcess = isCLIProxyProcess;
+/**
+ * Check if Windows Firewall might block a port
+ * Returns immediately on non-Windows platforms
+ */
+async function checkWindowsFirewall(port) {
+    if (process.platform !== 'win32') {
+        return { checked: false, mayBlock: false, message: 'Not Windows' };
+    }
+    try {
+        // Check for inbound rules allowing our port
+        const { stdout } = await execAsync(`netsh advfirewall firewall show rule name=all dir=in | findstr /C:"LocalPort" | findstr /C:"${port}"`, { timeout: 5000 });
+        // If we find the port in firewall rules, it's likely allowed
+        if (stdout.trim()) {
+            return { checked: true, mayBlock: false, message: `Port ${port} found in firewall rules` };
+        }
+        // Port not in rules - might be blocked
+        return {
+            checked: true,
+            mayBlock: true,
+            message: `Port ${port} may be blocked by Windows Firewall`,
+            fixCommand: `netsh advfirewall firewall add rule name="CCS OAuth" dir=in action=allow protocol=TCP localport=${port}`,
+        };
+    }
+    catch {
+        // Command failed - could be no matching rules, assume might block
+        return {
+            checked: true,
+            mayBlock: true,
+            message: `Could not verify firewall rules for port ${port}`,
+            fixCommand: `netsh advfirewall firewall add rule name="CCS OAuth" dir=in action=allow protocol=TCP localport=${port}`,
+        };
+    }
+}
+exports.checkWindowsFirewall = checkWindowsFirewall;
+/**
+ * Wait for a port to become free (no process listening)
+ * @param port Port number to wait for
+ * @param timeoutMs Maximum time to wait in milliseconds (default: 5000)
+ * @param pollIntervalMs Interval between checks in milliseconds (default: 200)
+ * @returns True if port became free, false if timeout
+ */
+async function waitForPortFree(port, timeoutMs = 5000, pollIntervalMs = 200) {
+    const startTime = Date.now();
+    while (Date.now() - startTime < timeoutMs) {
+        const process = await getPortProcess(port);
+        if (!process) {
+            return true; // Port is free
+        }
+        // Wait before next check
+        await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+    }
+    return false; // Timeout reached
+}
+exports.waitForPortFree = waitForPortFree;
+/**
+ * Test if we can bind to localhost on a specific port
+ * This verifies network stack is working and port is actually available
+ */
+async function testLocalhostBinding(port) {
+    const net = await Promise.resolve().then(() => __importStar(require('net')));
+    return new Promise((resolve) => {
+        const server = net.createServer();
+        server.once('error', (err) => {
+            // H8: Close server to prevent fd leak on error path
+            server.close(() => {
+                if (err.code === 'EADDRINUSE') {
+                    resolve({ success: false, message: `Port ${port} is already in use` });
+                }
+                else if (err.code === 'EACCES') {
+                    resolve({ success: false, message: `Permission denied for port ${port}` });
+                }
+                else {
+                    resolve({ success: false, message: `Cannot bind to port ${port}: ${err.message}` });
+                }
+            });
+        });
+        server.once('listening', () => {
+            server.close(() => {
+                resolve({ success: true, message: `Port ${port} is available` });
+            });
+        });
+        // Try to bind to localhost only (like CLIProxyAPI does)
+        server.listen(port, '127.0.0.1');
+    });
+}
+exports.testLocalhostBinding = testLocalhostBinding;
+//# sourceMappingURL=port-utils.js.map

package/dist/utils/port-utils.js.map

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

package/dist/utils/progress-indicator.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Simple Progress Indicator
+ *
+ * Features:
+ * - ASCII-only spinner frames (cross-platform compatible)
+ * - TTY detection (no spinners in pipes/logs)
+ * - Elapsed time display
+ * - CI environment detection
+ * - Color support via UI system
+ */
+interface ProgressOptions {
+    frames?: string[];
+    interval?: number;
+}
+export declare class ProgressIndicator {
+    private message;
+    private frames;
+    private frameIndex;
+    private interval;
+    private startTime;
+    private isTTY;
+    /**
+     * Create a progress indicator
+     * @param message - Message to display
+     * @param options - Options
+     */
+    constructor(message: string, options?: ProgressOptions);
+    /**
+     * Start the spinner
+     */
+    start(): void;
+    /**
+     * Stop spinner with success message
+     * @param message - Optional success message (defaults to original message)
+     */
+    succeed(message?: string): void;
+    /**
+     * Stop spinner with failure message
+     * @param message - Optional failure message (defaults to original message)
+     */
+    fail(message?: string): void;
+    /**
+     * Update spinner message (while running)
+     * @param newMessage - New message to display
+     */
+    update(newMessage: string): void;
+    /**
+     * Stop the spinner without showing success/failure
+     */
+    stop(): void;
+}
+export default ProgressIndicator;
+//# sourceMappingURL=progress-indicator.d.ts.map

package/dist/utils/progress-indicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-indicator.d.ts","sourceRoot":"","sources":["../../src/utils/progress-indicator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,UAAU,eAAe;IACvB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAU;IAEvB;;;;OAIG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB;IAY1D;;OAEG;IACH,KAAK,IAAI,IAAI;IAgBb;;;OAGG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAc/B;;;OAGG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAa5B;;;OAGG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIhC;;OAEG;IACH,IAAI,IAAI,IAAI;CAWb;AAED,eAAe,iBAAiB,CAAC"}

package/dist/utils/progress-indicator.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * Simple Progress Indicator
+ *
+ * Features:
+ * - ASCII-only spinner frames (cross-platform compatible)
+ * - TTY detection (no spinners in pipes/logs)
+ * - Elapsed time display
+ * - CI environment detection
+ * - Color support via UI system
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProgressIndicator = void 0;
+const colors_1 = require("./ui/colors");
+class ProgressIndicator {
+    /**
+     * Create a progress indicator
+     * @param message - Message to display
+     * @param options - Options
+     */
+    constructor(message, options = {}) {
+        this.message = message;
+        // ASCII-only frames for cross-platform compatibility
+        this.frames = options.frames || ['|', '/', '-', '\\'];
+        this.frameIndex = 0;
+        this.interval = null;
+        this.startTime = Date.now();
+        // TTY detection: only animate if stderr is TTY and not in CI
+        this.isTTY = process.stderr.isTTY === true && !process.env.CI && !process.env.NO_COLOR;
+    }
+    /**
+     * Start the spinner
+     */
+    start() {
+        if (!this.isTTY) {
+            // Non-TTY: just print message once
+            process.stderr.write(`${(0, colors_1.color)('[i]', 'info')} ${this.message}...\n`);
+            return;
+        }
+        // TTY: animate spinner
+        this.interval = setInterval(() => {
+            const frame = this.frames[this.frameIndex];
+            const elapsed = ((Date.now() - this.startTime) / 1000).toFixed(1);
+            process.stderr.write(`\r${(0, colors_1.color)(`[${frame}]`, 'info')} ${this.message}... (${elapsed}s)`);
+            this.frameIndex = (this.frameIndex + 1) % this.frames.length;
+        }, 80); // 12.5fps for smooth animation
+    }
+    /**
+     * Stop spinner with success message
+     * @param message - Optional success message (defaults to original message)
+     */
+    succeed(message) {
+        this.stop();
+        const finalMessage = message || this.message;
+        const elapsed = ((Date.now() - this.startTime) / 1000).toFixed(1);
+        if (this.isTTY) {
+            // Clear spinner line and show success
+            process.stderr.write(`\r${(0, colors_1.color)('[OK]', 'success')} ${finalMessage} (${elapsed}s)\n`);
+        }
+        else {
+            // Non-TTY: just show completion
+            process.stderr.write(`${(0, colors_1.color)('[OK]', 'success')} ${finalMessage}\n`);
+        }
+    }
+    /**
+     * Stop spinner with failure message
+     * @param message - Optional failure message (defaults to original message)
+     */
+    fail(message) {
+        this.stop();
+        const finalMessage = message || this.message;
+        if (this.isTTY) {
+            // Clear spinner line and show failure
+            process.stderr.write(`\r${(0, colors_1.color)('[X]', 'error')} ${finalMessage}\n`);
+        }
+        else {
+            // Non-TTY: just show failure
+            process.stderr.write(`${(0, colors_1.color)('[X]', 'error')} ${finalMessage}\n`);
+        }
+    }
+    /**
+     * Update spinner message (while running)
+     * @param newMessage - New message to display
+     */
+    update(newMessage) {
+        this.message = newMessage;
+    }
+    /**
+     * Stop the spinner without showing success/failure
+     */
+    stop() {
+        if (this.interval) {
+            clearInterval(this.interval);
+            this.interval = null;
+            if (this.isTTY) {
+                // Clear the spinner line
+                process.stderr.write('\r\x1b[K');
+            }
+        }
+    }
+}
+exports.ProgressIndicator = ProgressIndicator;
+exports.default = ProgressIndicator;
+//# sourceMappingURL=progress-indicator.js.map

package/dist/utils/progress-indicator.js.map

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

package/dist/utils/prompt.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Interactive Prompt Utilities (NO external dependencies)
+ *
+ * Features:
+ * - TTY detection (auto-confirm in non-TTY)
+ * - --yes flag support for automation
+ * - --no-input flag support for CI
+ * - Safe defaults (N for destructive actions)
+ * - Input validation with retry
+ */
+interface ConfirmOptions {
+    default?: boolean;
+}
+interface InputOptions {
+    default?: string;
+    validate?: (value: string) => string | null;
+}
+interface PasswordOptions {
+    mask?: string;
+}
+interface SelectOption {
+    id: string;
+    label: string;
+}
+interface SelectOptions {
+    defaultIndex?: number;
+}
+export declare class InteractivePrompt {
+    /**
+     * Ask for confirmation
+     */
+    static confirm(message: string, options?: ConfirmOptions): Promise<boolean>;
+    /**
+     * Get text input from user
+     */
+    static input(message: string, options?: InputOptions): Promise<string>;
+    /**
+     * Get password/secret input (masked)
+     *
+     * Handles bracketed paste mode escape sequences that terminals send:
+     * - Start paste: ESC[200~
+     * - End paste: ESC[201~
+     * These are stripped automatically so pasted API keys work correctly.
+     */
+    static password(message: string, options?: PasswordOptions): Promise<string>;
+    /**
+     * Select from a numbered list
+     *
+     * Displays options with numbers and waits for user selection.
+     * Shows default with asterisk (*) prefix.
+     */
+    static selectFromList(prompt: string, options: SelectOption[], selectOptions?: SelectOptions): Promise<string>;
+}
+export {};
+//# sourceMappingURL=prompt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/utils/prompt.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,YAAY;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CAC7C;AAED,UAAU,eAAe;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,aAAa;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,iBAAiB;IAC5B;;OAEG;WACU,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IA6DrF;;OAEG;WACU,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAwChF;;;;;;;OAOG;WACU,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;IAmGtF;;;;;OAKG;WACU,cAAc,CACzB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,YAAY,EAAE,EACvB,aAAa,GAAE,aAAkB,GAChC,OAAO,CAAC,MAAM,CAAC;CA0EnB"}