@jsonstudio/rcc 0.89.1121 → 0.89.1189

package/dist/cli/server/port-utils.js

@@ -0,0 +1,193 @@
+import { spawnSync as nodeSpawnSync } from 'node:child_process';
+import { API_PATHS, HTTP_PROTOCOLS, LOCAL_HOSTS } from '../../constants/index.js';
+export function killPidBestEffortImpl(args) {
+    const { pid, force, isWindows } = args;
+    const spawnSyncImpl = args.spawnSyncImpl ?? nodeSpawnSync;
+    const processKill = args.processKill ?? process.kill.bind(process);
+    if (!Number.isFinite(pid) || pid <= 0) {
+        return;
+    }
+    if (isWindows) {
+        const taskkillArgs = ['/PID', String(pid), '/T'];
+        if (force) {
+            taskkillArgs.push('/F');
+        }
+        try {
+            spawnSyncImpl('taskkill', taskkillArgs, { stdio: 'ignore', encoding: 'utf8' });
+        }
+        catch {
+            // best-effort
+        }
+        return;
+    }
+    try {
+        processKill(pid, force ? 'SIGKILL' : 'SIGTERM');
+    }
+    catch {
+        // best-effort
+    }
+}
+export function findListeningPidsImpl(args) {
+    const { port, isWindows, logger, parseNetstatListeningPids } = args;
+    const spawnSyncImpl = args.spawnSyncImpl ?? nodeSpawnSync;
+    try {
+        if (isWindows) {
+            const result = spawnSyncImpl('netstat', ['-ano', '-p', 'tcp'], { encoding: 'utf8' });
+            if (result.error) {
+                logger.warning(`netstat not available to inspect port usage: ${result.error.message}`);
+                return [];
+            }
+            return parseNetstatListeningPids(result.stdout || '', port);
+        }
+        // macOS/BSD lsof expects either "-i TCP:port" or "-tiTCP:port" as a single argument.
+        // Use the compact form to avoid treating ":port" as a filename.
+        const result = spawnSyncImpl('lsof', [`-tiTCP:${port}`, '-sTCP:LISTEN'], { encoding: 'utf8' });
+        if (result.error) {
+            logger.warning(`lsof not available to inspect port usage: ${result.error.message}`);
+            return [];
+        }
+        const out = String(result.stdout || '').trim();
+        if (!out) {
+            return [];
+        }
+        return out
+            .split(/\s+/g)
+            .map((s) => Number(String(s).trim()))
+            .filter((n) => Number.isFinite(n) && n > 0);
+    }
+    catch {
+        return [];
+    }
+}
+export async function isServerHealthyQuickImpl(args) {
+    try {
+        const controller = new AbortController();
+        const t = setTimeout(() => {
+            try {
+                controller.abort();
+            }
+            catch {
+                /* ignore */
+            }
+        }, 800);
+        const res = await args.fetchImpl(`${HTTP_PROTOCOLS.HTTP}${LOCAL_HOSTS.IPV4}:${args.port}${API_PATHS.HEALTH}`, {
+            method: 'GET',
+            signal: controller.signal
+        });
+        clearTimeout(t);
+        if (!res.ok) {
+            return false;
+        }
+        const data = await res.json().catch(() => null);
+        return !!data && (data.status === 'healthy' || data.status === 'ready');
+    }
+    catch {
+        return false;
+    }
+}
+export async function ensurePortAvailableImpl(args) {
+    const { port, parentSpinner } = args;
+    const opts = args.opts ?? {};
+    if (!port || Number.isNaN(port)) {
+        return;
+    }
+    // Best-effort HTTP shutdown on common loopback hosts to cover IPv4/IPv6
+    try {
+        const candidates = [LOCAL_HOSTS.IPV4, LOCAL_HOSTS.LOCALHOST];
+        for (const h of candidates) {
+            try {
+                const controller = new AbortController();
+                const t = setTimeout(() => {
+                    try {
+                        controller.abort();
+                    }
+                    catch {
+                        /* ignore */
+                    }
+                }, 700);
+                await args.fetchImpl(`http://${h}:${port}/shutdown`, {
+                    method: 'POST',
+                    signal: controller.signal
+                }).catch(() => { });
+                clearTimeout(t);
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        await args.sleep(300);
+    }
+    catch {
+        /* ignore */
+    }
+    const initialPids = args.findListeningPids(port);
+    if (initialPids.length === 0) {
+        return;
+    }
+    const healthy = await args.isServerHealthyQuick(port);
+    if (healthy && !opts.restart) {
+        parentSpinner.stop();
+        args.logger.success(`RouteCodex is already running on port ${port}.`);
+        args.logger.info(`Use 'rcc stop' or 'rcc start --restart' to restart.`);
+        args.exit(0);
+    }
+    parentSpinner.stop();
+    args.logger.warning(`Port ${port} is in use by PID(s): ${initialPids.join(', ')}`);
+    const stopSpinner = await args.createSpinner(`Port ${port} is in use on 0.0.0.0. Attempting graceful stop...`);
+    const gracefulTimeout = Number(args.env.ROUTECODEX_STOP_TIMEOUT_MS ?? 5000);
+    const killTimeout = Number(args.env.ROUTECODEX_KILL_TIMEOUT_MS ?? 3000);
+    const pollInterval = 150;
+    for (const pid of initialPids) {
+        try {
+            args.killPidBestEffort(pid, { force: false });
+        }
+        catch (error) {
+            stopSpinner.warn(`Failed to send SIGTERM to PID ${pid}: ${error.message}`);
+        }
+    }
+    const gracefulDeadline = Date.now() + gracefulTimeout;
+    while (Date.now() < gracefulDeadline) {
+        if (args.findListeningPids(port).length === 0) {
+            stopSpinner.succeed(`Port ${port} freed after graceful stop.`);
+            args.logger.success(`Port ${port} freed after graceful stop.`);
+            parentSpinner.start('Starting RouteCodex server...');
+            return;
+        }
+        await args.sleep(pollInterval);
+    }
+    let remaining = args.findListeningPids(port);
+    if (remaining.length) {
+        stopSpinner.warn(`Graceful stop timed out, sending SIGKILL to PID(s): ${remaining.join(', ')}`);
+        args.logger.warning(`Graceful stop timed out. Forcing SIGKILL to PID(s): ${remaining.join(', ')}`);
+        for (const pid of remaining) {
+            try {
+                args.killPidBestEffort(pid, { force: true });
+            }
+            catch (error) {
+                const message = error.message;
+                stopSpinner.warn(`Failed to send SIGKILL to PID ${pid}: ${message}`);
+                args.logger.error(`Failed to SIGKILL PID ${pid}: ${message}`);
+            }
+        }
+        const killDeadline = Date.now() + killTimeout;
+        while (Date.now() < killDeadline) {
+            if (args.findListeningPids(port).length === 0) {
+                stopSpinner.succeed(`Port ${port} freed after SIGKILL.`);
+                args.logger.success(`Port ${port} freed after SIGKILL.`);
+                parentSpinner.start('Starting RouteCodex server...');
+                return;
+            }
+            await args.sleep(pollInterval);
+        }
+    }
+    remaining = args.findListeningPids(port);
+    if (remaining.length) {
+        stopSpinner.fail(`Failed to free port ${port}. Still held by PID(s): ${remaining.join(', ')}`);
+        args.logger.error(`Failed to free port ${port}. Still held by PID(s): ${remaining.join(', ')}`);
+        throw new Error(`Failed to free port ${port}`);
+    }
+    stopSpinner.succeed(`Port ${port} freed.`);
+    args.logger.success(`Port ${port} freed.`);
+    parentSpinner.start('Starting RouteCodex server...');
+}
+//# sourceMappingURL=port-utils.js.map

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

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

package/dist/cli/spinner.d.ts

@@ -0,0 +1,10 @@
+export type Spinner = {
+    start(text?: string): Spinner;
+    succeed(text?: string): void;
+    fail(text?: string): void;
+    warn(text?: string): void;
+    info(text?: string): void;
+    stop(): void;
+    text: string;
+};
+export declare function createSpinner(text: string): Promise<Spinner>;

package/dist/cli/spinner.js

@@ -0,0 +1,59 @@
+async function dynamicImport(specifier) {
+    try {
+        return (await import(specifier));
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function createSpinner(text) {
+    const mod = await dynamicImport('ora');
+    const oraFactory = typeof mod?.default === 'function' ? mod.default : undefined;
+    if (oraFactory) {
+        const instance = oraFactory(text);
+        if (typeof instance.start === 'function') {
+            instance.start(text);
+            return instance;
+        }
+    }
+    let currentText = text;
+    const log = (prefix, msg) => {
+        const message = msg ?? currentText;
+        if (!message) {
+            return;
+        }
+        console.log(`${prefix} ${message}`);
+    };
+    const stub = {
+        start(msg) {
+            if (msg) {
+                currentText = msg;
+            }
+            log('...', msg);
+            return stub;
+        },
+        succeed(msg) {
+            log('✓', msg);
+        },
+        fail(msg) {
+            log('✗', msg);
+        },
+        warn(msg) {
+            log('⚠', msg);
+        },
+        info(msg) {
+            log('ℹ', msg);
+        },
+        stop() {
+            /* no-op */
+        },
+        get text() {
+            return currentText;
+        },
+        set text(value) {
+            currentText = value;
+        }
+    };
+    return stub;
+}
+//# sourceMappingURL=spinner.js.map

package/dist/cli/spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../src/cli/spinner.ts"],"names":[],"mappings":"AAcA,KAAK,UAAU,aAAa,CAAI,SAAiB;IAC/C,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAAM,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY;IAC9C,MAAM,GAAG,GAAG,MAAM,aAAa,CAAY,KAAK,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,OAAO,GAAG,EAAE,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAChF,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACzC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACrB,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAED,IAAI,WAAW,GAAG,IAAI,CAAC;IACvB,MAAM,GAAG,GAAG,CAAC,MAAc,EAAE,GAAY,EAAE,EAAE;QAC3C,MAAM,OAAO,GAAG,GAAG,IAAI,WAAW,CAAC;QACnC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC,CAAC;IACtC,CAAC,CAAC;IAEF,MAAM,IAAI,GAAY;QACpB,KAAK,CAAC,GAAY;YAChB,IAAI,GAAG,EAAE,CAAC;gBACR,WAAW,GAAG,GAAG,CAAC;YACpB,CAAC;YACD,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAChB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,CAAC,GAAY;YAClB,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAChB,CAAC;QACD,IAAI,CAAC,GAAY;YACf,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAChB,CAAC;QACD,IAAI,CAAC,GAAY;YACf,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAChB,CAAC;QACD,IAAI,CAAC,GAAY;YACf,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAChB,CAAC;QACD,IAAI;YACF,WAAW;QACb,CAAC;QACD,IAAI,IAAI;YACN,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,IAAI,IAAI,CAAC,KAAa;YACpB,WAAW,GAAG,KAAK,CAAC;QACtB,CAAC;KACF,CAAC;IAEF,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cli/utils/normalize.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizePort(value: unknown): number;
+export declare function normalizeConnectHost(host: unknown, fallback?: string): string;

package/dist/cli/utils/normalize.js

@@ -0,0 +1,22 @@
+import { LOCAL_HOSTS } from '../../constants/index.js';
+export function normalizePort(value) {
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        return value;
+    }
+    if (typeof value === 'string' && value.trim()) {
+        const parsed = Number(value);
+        if (Number.isFinite(parsed)) {
+            return parsed;
+        }
+    }
+    return NaN;
+}
+export function normalizeConnectHost(host, fallback = LOCAL_HOSTS.IPV4) {
+    const raw = typeof host === 'string' ? host : String(host ?? '');
+    const v = raw.trim().toLowerCase();
+    if (v === '0.0.0.0' || v === '::' || v === '::1' || v === 'localhost') {
+        return LOCAL_HOSTS.IPV4;
+    }
+    return raw.trim() || fallback;
+}
+//# sourceMappingURL=normalize.js.map

package/dist/cli/utils/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../../src/cli/utils/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAa,EAAE,WAAmB,WAAW,CAAC,IAAI;IACrF,MAAM,GAAG,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACjE,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACnC,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,WAAW,EAAE,CAAC;QACtE,OAAO,WAAW,CAAC,IAAI,CAAC;IAC1B,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,EAAE,IAAI,QAAQ,CAAC;AAChC,CAAC"}

package/dist/cli/utils/safe-read-json.d.ts

@@ -0,0 +1 @@
+export declare function safeReadJson<T = Record<string, unknown>>(filePath: string): T | null;

package/dist/cli/utils/safe-read-json.js

@@ -0,0 +1,11 @@
+import fs from 'node:fs';
+export function safeReadJson(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=safe-read-json.js.map

package/dist/cli/utils/safe-read-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-read-json.js","sourceRoot":"","sources":["../../../src/cli/utils/safe-read-json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,MAAM,UAAU,YAAY,CAA8B,QAAgB;IACxE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}