@caoruhua/open-claude-remote 0.1.0

package/dist/push/push-service.js

@@ -0,0 +1,301 @@
+import { logger } from '../logger/logger.js';
+import { promises as fs } from 'fs';
+import { join } from 'path';
+import { withFileLockAsync } from '../utils/file-lock.js';
+/**
+ * Web Push notification service.
+ * Manages VAPID keys, subscriptions, and notification delivery.
+ *
+ * 多实例支持：订阅数据通过文件持久化并跨实例共享。
+ * subscribe/unsubscribe 使用最终一致性语义——内存立即更新，
+ * 文件持久化异步执行（不阻塞调用方）。如果进程在持久化完成前崩溃，
+ * 该订阅需客户端重新注册。
+ */
+export class PushService {
+    subscriptions = new Map();
+    vapidPublicKey;
+    vapidPrivateKey;
+    vapidSubject;
+    vapidInitPromise;
+    vapidKeysFile;
+    vapidLockPath;
+    subscriptionsFile;
+    subscriptionsLockPath;
+    dataDir;
+    constructor(baseDir) {
+        this.dataDir = baseDir;
+        this.vapidKeysFile = join(baseDir, 'vapid-keys.json');
+        this.vapidLockPath = this.vapidKeysFile + '.lock';
+        this.subscriptionsFile = join(baseDir, 'push-subscriptions.json');
+        this.subscriptionsLockPath = this.subscriptionsFile + '.lock';
+        this.vapidSubject = process.env['VAPID_SUBJECT'] ?? 'mailto:noreply@localhost';
+        const envPublic = process.env['VAPID_PUBLIC_KEY'];
+        const envPrivate = process.env['VAPID_PRIVATE_KEY'];
+        if (envPublic && envPrivate) {
+            this.vapidPublicKey = envPublic;
+            this.vapidPrivateKey = envPrivate;
+            logger.info('Using VAPID keys from environment variables');
+            // 即使使用环境变量，也要加载持久化的订阅
+            this.vapidInitPromise = this.loadSubscriptions();
+        }
+        else {
+            // Lazy init — 加载或生成 VAPID 密钥，然后加载订阅
+            this.vapidPublicKey = '';
+            this.vapidPrivateKey = '';
+            this.vapidInitPromise = this.initVapidAndSubscriptions();
+        }
+    }
+    /**
+     * 确保数据目录存在
+     */
+    async ensureDataDir() {
+        try {
+            await fs.mkdir(this.dataDir, { recursive: true });
+        }
+        catch (err) {
+            logger.error({ err, path: this.dataDir }, 'Failed to create data directory');
+            throw err;
+        }
+    }
+    /**
+     * 从文件加载 VAPID 密钥
+     */
+    async loadVapidKeys() {
+        try {
+            const content = await fs.readFile(this.vapidKeysFile, 'utf-8');
+            const keys = JSON.parse(content);
+            if (keys.publicKey && keys.privateKey) {
+                return keys;
+            }
+        }
+        catch {
+            // 文件不存在或解析失败
+        }
+        return null;
+    }
+    /**
+     * 保存 VAPID 密钥到文件
+     */
+    async saveVapidKeys(keys) {
+        await this.ensureDataDir();
+        await fs.writeFile(this.vapidKeysFile, JSON.stringify(keys, null, 2), { encoding: 'utf-8', mode: 0o600 });
+    }
+    /**
+     * 从文件加载订阅数据
+     */
+    async loadSubscriptions() {
+        try {
+            const content = await fs.readFile(this.subscriptionsFile, 'utf-8');
+            const data = JSON.parse(content);
+            for (const sub of data) {
+                this.subscriptions.set(sub.endpoint, sub);
+            }
+            logger.info({ count: this.subscriptions.size }, 'Loaded push subscriptions from file');
+        }
+        catch {
+            // 文件不存在或解析失败，不加载任何订阅
+            logger.debug('No existing push subscriptions file found');
+        }
+    }
+    /**
+     * 从文件读取所有订阅（包含其他实例写入的）。
+     * 通过文件锁保护，防止读到半写的 JSON。
+     */
+    async readSubscriptionsFromFile() {
+        try {
+            return await withFileLockAsync(this.subscriptionsLockPath, async () => {
+                const content = await fs.readFile(this.subscriptionsFile, 'utf-8');
+                return JSON.parse(content);
+            });
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * 锁定读-合并-写订阅变更。
+     * type='add': 将 sub 合并到文件中（按 endpoint 去重）
+     * type='remove': 从文件中移除一个或多个 endpoints
+     */
+    async persistSubscriptionChange(type, endpoints, sub) {
+        await withFileLockAsync(this.subscriptionsLockPath, async () => {
+            await this.ensureDataDir();
+            let fileSubs = [];
+            try {
+                const content = await fs.readFile(this.subscriptionsFile, 'utf-8');
+                fileSubs = JSON.parse(content);
+            }
+            catch { /* 文件不存在 */ }
+            const merged = new Map();
+            // 先加载文件中的
+            for (const s of fileSubs) {
+                merged.set(s.endpoint, s);
+            }
+            // 再合并内存中的
+            for (const s of this.subscriptions.values()) {
+                merged.set(s.endpoint, s);
+            }
+            if (type === 'add' && sub) {
+                merged.set(sub.endpoint, sub);
+            }
+            else if (type === 'remove') {
+                for (const ep of endpoints) {
+                    merged.delete(ep);
+                }
+            }
+            const data = Array.from(merged.values());
+            await fs.writeFile(this.subscriptionsFile, JSON.stringify(data, null, 2), 'utf-8');
+            logger.debug({ count: data.length, type }, 'Persisted subscription change to file');
+        });
+    }
+    /**
+     * 初始化 VAPID 密钥和订阅数据。
+     * VAPID 密钥生成通过文件锁保护，防止多实例并发生成不同密钥对。
+     */
+    async initVapidAndSubscriptions() {
+        // 确保数据目录存在（锁目录在 baseDir 下，必须先创建父目录）
+        await this.ensureDataDir();
+        // 使用文件锁保护 VAPID 密钥的 check-then-generate 操作
+        await withFileLockAsync(this.vapidLockPath, async () => {
+            // 锁内 double-check：先读文件，另一个实例可能已写入
+            const savedKeys = await this.loadVapidKeys();
+            if (savedKeys) {
+                this.vapidPublicKey = savedKeys.publicKey;
+                this.vapidPrivateKey = savedKeys.privateKey;
+                logger.info('Loaded VAPID keys from file');
+                return;
+            }
+            // 生成新的 VAPID 密钥
+            try {
+                const webpush = (await import('web-push')).default;
+                const keys = webpush.generateVAPIDKeys();
+                this.vapidPublicKey = keys.publicKey;
+                this.vapidPrivateKey = keys.privateKey;
+                await this.saveVapidKeys(keys);
+                logger.info('Generated and saved VAPID keys to file');
+            }
+            catch (err) {
+                logger.warn({ err }, 'web-push not available, push notifications disabled');
+            }
+        });
+        // 加载持久化的订阅
+        await this.loadSubscriptions();
+    }
+    getVapidPublicKey() {
+        return this.vapidPublicKey;
+    }
+    async waitForVapidPublicKey(timeoutMs = 2000) {
+        if (this.vapidPublicKey)
+            return this.vapidPublicKey;
+        const timeoutPromise = new Promise((resolve) => {
+            setTimeout(() => resolve('timeout'), timeoutMs);
+        });
+        const result = await Promise.race([
+            this.vapidInitPromise.then(() => 'ready'),
+            timeoutPromise,
+        ]);
+        if (result === 'timeout') {
+            return this.vapidPublicKey || null;
+        }
+        return this.vapidPublicKey || null;
+    }
+    /**
+     * 添加推送订阅。
+     * 内存立即更新，文件持久化异步执行（最终一致性）。
+     */
+    subscribe(subscription) {
+        this.subscriptions.set(subscription.endpoint, subscription);
+        logger.info({ endpoint: subscription.endpoint }, 'Push subscription added');
+        this.persistSubscriptionChange('add', [subscription.endpoint], subscription).catch((err) => {
+            logger.error({ err }, 'Failed to persist push subscription add');
+        });
+    }
+    /**
+     * 移除推送订阅。
+     * 内存立即更新，文件持久化异步执行（最终一致性）。
+     */
+    unsubscribe(endpoint) {
+        const deleted = this.subscriptions.delete(endpoint);
+        if (deleted) {
+            logger.info({ endpoint }, 'Push subscription removed');
+            this.persistSubscriptionChange('remove', [endpoint]).catch((err) => {
+                logger.error({ err }, 'Failed to persist push subscription remove');
+            });
+        }
+        return deleted;
+    }
+    get subscriberCount() {
+        return this.subscriptions.size;
+    }
+    /**
+     * 验证订阅数据是否有效。
+     * p256dh 是 65 字节的 ECDH 公钥，Base64 URL-safe 编码后约 87 字符。
+     */
+    isValidSubscription(sub) {
+        const P256DH_MIN_LENGTH = 64;
+        return !!(sub.keys?.p256dh && sub.keys.p256dh.length >= P256DH_MIN_LENGTH);
+    }
+    async notifyAll(payload) {
+        if (!this.vapidPublicKey || !this.vapidPrivateKey) {
+            logger.warn('VAPID keys not ready, skipping push notification');
+            return;
+        }
+        // 发送前从文件重新加载所有订阅（获取其他实例添加的订阅），使用文件锁防止读到半写 JSON
+        const fileSubs = await this.readSubscriptionsFromFile();
+        for (const sub of fileSubs) {
+            if (!this.subscriptions.has(sub.endpoint)) {
+                // 只加载有效的订阅数据
+                if (this.isValidSubscription(sub)) {
+                    this.subscriptions.set(sub.endpoint, sub);
+                }
+                else {
+                    logger.warn({ endpoint: sub.endpoint }, 'Skipping subscription with invalid p256dh from file');
+                }
+            }
+        }
+        if (this.subscriptions.size === 0) {
+            logger.debug('No push subscribers, skipping notification');
+            return;
+        }
+        let webpush;
+        try {
+            webpush = (await import('web-push')).default;
+        }
+        catch {
+            logger.warn('web-push not available, skipping notification');
+            return;
+        }
+        webpush.setVapidDetails(this.vapidSubject, this.vapidPublicKey, this.vapidPrivateKey);
+        const body = JSON.stringify(payload);
+        const promises = [];
+        const expiredEndpoints = [];
+        for (const [endpoint, sub] of this.subscriptions) {
+            // 跳过无效订阅（防御性检查）
+            if (!this.isValidSubscription(sub)) {
+                logger.warn({ endpoint }, 'Skipping subscription with invalid p256dh');
+                continue;
+            }
+            const p = webpush.sendNotification({ endpoint, keys: sub.keys }, body).catch((err) => {
+                // 410 Gone = subscription expired, remove it
+                if (err.statusCode === 410) {
+                    this.subscriptions.delete(endpoint);
+                    expiredEndpoints.push(endpoint);
+                    logger.info({ endpoint }, 'Removed expired push subscription');
+                }
+                else {
+                    logger.error({ err, endpoint }, 'Failed to send push notification');
+                }
+            });
+            promises.push(p);
+        }
+        await Promise.allSettled(promises);
+        // 有过期订阅被删除时，从内存和文件中同时移除（锁定写）
+        if (expiredEndpoints.length > 0) {
+            this.persistSubscriptionChange('remove', expiredEndpoints).catch((err) => {
+                logger.error({ err }, 'Failed to persist push subscription cleanup');
+            });
+        }
+        logger.info({ count: this.subscriptions.size }, 'Push notifications sent');
+    }
+}
+//# sourceMappingURL=push-service.js.map

package/dist/push/push-service.js.map

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

package/dist/registry/instance-registry.d.ts

@@ -0,0 +1,32 @@
+import type { InstanceInfo } from '@claude-remote/shared';
+/**
+ * 实例注册表管理器。
+ * 操作 ~/.claude-remote/instances.json 实现多实例发现。
+ * 所有公共方法通过 mkdir-based 文件锁保护 read-modify-write 操作。
+ */
+export declare class InstanceRegistryManager {
+    private readonly registryPath;
+    private readonly lockPath;
+    private readonly baseDir;
+    constructor(baseDir: string);
+    /**
+     * 注册实例信息（如已存在同 ID 则替换）。
+     */
+    register(info: InstanceInfo): void;
+    /**
+     * 注销实例。
+     */
+    unregister(instanceId: string): void;
+    /**
+     * 列出所有存活实例，自动清理僵尸进程。
+     * 使用异步文件锁，避免在 API 请求路径上阻塞事件循环。
+     */
+    list(): Promise<InstanceInfo[]>;
+    /**
+     * 更新实例的 host 字段（用于 IP 变化时更新）。
+     */
+    updateHost(instanceId: string, newHost: string): void;
+    private readRegistry;
+    private writeRegistry;
+}
+//# sourceMappingURL=instance-registry.d.ts.map

package/dist/registry/instance-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-registry.d.ts","sourceRoot":"","sources":["../../src/registry/instance-registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,uBAAuB,CAAC;AAgB5E;;;;GAIG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,MAAM;IAM3B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAUlC;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAYpC;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAgBrC;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAYrD,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,aAAa;CAStB"}

package/dist/registry/instance-registry.js

@@ -0,0 +1,115 @@
+import { readFileSync, writeFileSync, renameSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { REGISTRY_FILENAME } from '../../shared-dist/index.js';
+import { logger } from '../logger/logger.js';
+import { withFileLock, withFileLockAsync } from '../utils/file-lock.js';
+/**
+ * 检查进程是否存活。
+ */
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 实例注册表管理器。
+ * 操作 ~/.claude-remote/instances.json 实现多实例发现。
+ * 所有公共方法通过 mkdir-based 文件锁保护 read-modify-write 操作。
+ */
+export class InstanceRegistryManager {
+    registryPath;
+    lockPath;
+    baseDir;
+    constructor(baseDir) {
+        this.baseDir = baseDir;
+        this.registryPath = join(baseDir, REGISTRY_FILENAME);
+        this.lockPath = this.registryPath + '.lock';
+    }
+    /**
+     * 注册实例信息（如已存在同 ID 则替换）。
+     */
+    register(info) {
+        withFileLock(this.lockPath, () => {
+            const data = this.readRegistry();
+            data.instances = data.instances.filter(i => i.instanceId !== info.instanceId);
+            data.instances.push(info);
+            this.writeRegistry(data);
+            logger.info({ instanceId: info.instanceId, name: info.name, port: info.port }, 'Instance registered');
+        });
+    }
+    /**
+     * 注销实例。
+     */
+    unregister(instanceId) {
+        withFileLock(this.lockPath, () => {
+            const data = this.readRegistry();
+            const before = data.instances.length;
+            data.instances = data.instances.filter(i => i.instanceId !== instanceId);
+            if (data.instances.length < before) {
+                this.writeRegistry(data);
+                logger.info({ instanceId }, 'Instance unregistered');
+            }
+        });
+    }
+    /**
+     * 列出所有存活实例，自动清理僵尸进程。
+     * 使用异步文件锁，避免在 API 请求路径上阻塞事件循环。
+     */
+    async list() {
+        return withFileLockAsync(this.lockPath, async () => {
+            const data = this.readRegistry();
+            const alive = data.instances.filter(i => isProcessAlive(i.pid));
+            if (alive.length < data.instances.length) {
+                const removed = data.instances.length - alive.length;
+                logger.info({ removed }, 'Cleaned up zombie instances');
+                data.instances = alive;
+                this.writeRegistry(data);
+            }
+            return alive;
+        });
+    }
+    /**
+     * 更新实例的 host 字段（用于 IP 变化时更新）。
+     */
+    updateHost(instanceId, newHost) {
+        withFileLock(this.lockPath, () => {
+            const data = this.readRegistry();
+            const instance = data.instances.find(i => i.instanceId === instanceId);
+            if (instance && instance.host !== newHost) {
+                instance.host = newHost;
+                this.writeRegistry(data);
+                logger.info({ instanceId, newHost }, 'Instance host updated');
+            }
+        });
+    }
+    readRegistry() {
+        if (!existsSync(this.registryPath)) {
+            return { version: 1, instances: [] };
+        }
+        try {
+            const content = readFileSync(this.registryPath, 'utf-8');
+            const data = JSON.parse(content);
+            if (!data.instances || !Array.isArray(data.instances)) {
+                return { version: 1, instances: [] };
+            }
+            return data;
+        }
+        catch (err) {
+            logger.warn({ err, path: this.registryPath }, 'Failed to read registry, starting fresh');
+            return { version: 1, instances: [] };
+        }
+    }
+    writeRegistry(data) {
+        if (!existsSync(this.baseDir)) {
+            mkdirSync(this.baseDir, { recursive: true, mode: 0o700 });
+        }
+        const tmpPath = `${this.registryPath}.tmp.${process.pid}`;
+        writeFileSync(tmpPath, JSON.stringify(data, null, 2), { mode: 0o600 });
+        renameSync(tmpPath, this.registryPath);
+    }
+}
+//# sourceMappingURL=instance-registry.js.map

package/dist/registry/instance-registry.js.map

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

package/dist/registry/instance-spawner.d.ts

@@ -0,0 +1,33 @@
+export interface SpawnOptions {
+    /** 工作目录 */
+    cwd: string;
+    /** 实例名称 */
+    name?: string;
+    /** Claude 额外参数 */
+    claudeArgs?: string[];
+    /** 是否为 headless 模式（无终端） */
+    headless?: boolean;
+    /** 指定端口（可选，默认自动分配） */
+    port?: number;
+}
+export interface SpawnResult {
+    /** 进程 PID */
+    pid: number;
+    /** 工作目录 */
+    cwd: string;
+    /** 实例名称 */
+    name: string;
+}
+/**
+ * 实例创建服务。
+ * 通过 spawn 子进程启动新的 claude-remote 实例。
+ */
+export declare class InstanceSpawner {
+    private readonly entryScript;
+    constructor();
+    /**
+     * 创建新实例。
+     */
+    spawn(options: SpawnOptions): Promise<SpawnResult>;
+}
+//# sourceMappingURL=instance-spawner.d.ts.map

package/dist/registry/instance-spawner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-spawner.d.ts","sourceRoot":"","sources":["../../src/registry/instance-spawner.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,YAAY;IAC3B,WAAW;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;;IAcrC;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;CAkFzD"}

package/dist/registry/instance-spawner.js

@@ -0,0 +1,91 @@
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { logger } from '../logger/logger.js';
+/**
+ * 实例创建服务。
+ * 通过 spawn 子进程启动新的 claude-remote 实例。
+ */
+export class InstanceSpawner {
+    entryScript;
+    constructor() {
+        // 获取当前模块所在目录
+        const currentDir = dirname(fileURLToPath(import.meta.url));
+        // 入口脚本路径（CLI 入口）
+        this.entryScript = resolve(currentDir, '../cli.js');
+        // 验证入口脚本存在
+        if (!existsSync(this.entryScript)) {
+            throw new Error(`Entry script not found: ${this.entryScript}`);
+        }
+    }
+    /**
+     * 创建新实例。
+     */
+    async spawn(options) {
+        const { cwd, name, claudeArgs = [], headless = true, port, } = options;
+        logger.info({
+            cwd,
+            name,
+            headless,
+            port,
+        }, 'InstanceSpawner: spawning new instance');
+        // 构建子进程参数
+        const args = [];
+        // 禁用 CLI 模式输出，改用环境变量控制
+        // headless 模式下传递 --no-terminal 标志
+        if (headless) {
+            args.push('--no-terminal');
+        }
+        if (name) {
+            args.push('--name', name);
+        }
+        if (port) {
+            args.push('--port', String(port));
+        }
+        // 添加 Claude 参数分隔符
+        if (claudeArgs.length > 0) {
+            args.push('--', ...claudeArgs);
+        }
+        return new Promise((resolve, reject) => {
+            const child = spawn(process.execPath, [this.entryScript, ...args], {
+                cwd,
+                detached: true, // 与父进程解绑，允许父进程退出后继续运行
+                stdio: 'ignore', // headless 模式忽略 stdio
+                // 继承父进程的环境变量，并添加自定义变量
+                env: {
+                    ...process.env,
+                    // 设置 headless 标志供 index.ts 使用
+                    NO_TERMINAL: headless ? 'true' : 'false',
+                },
+            });
+            const childPid = child.pid;
+            child.on('error', (err) => {
+                logger.error({ err, cwd, name }, 'InstanceSpawner: failed to spawn');
+                reject(err);
+            });
+            // 子进程启动后立即 unref，让父进程可以独立退出
+            child.unref();
+            // 给子进程一点启动时间，然后检查是否存活
+            setTimeout(() => {
+                try {
+                    process.kill(childPid, 0); // 检查进程是否存在
+                    logger.info({
+                        pid: childPid,
+                        cwd,
+                        name,
+                    }, 'InstanceSpawner: instance spawned successfully');
+                    resolve({
+                        pid: childPid,
+                        cwd,
+                        name: name ?? cwd.split('/').pop() ?? 'unknown',
+                    });
+                }
+                catch {
+                    reject(new Error('Spawned process exited immediately'));
+                }
+            }, 500);
+        });
+    }
+}
+//# sourceMappingURL=instance-spawner.js.map

package/dist/registry/instance-spawner.js.map

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

package/dist/registry/port-finder.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 从 preferredPort 开始递增查找可用端口。
+ * @param preferredPort 首选端口
+ * @param host 绑定地址
+ * @param maxAttempts 最大尝试次数（默认 100）
+ */
+export declare function findAvailablePort(preferredPort: number, host: string, maxAttempts?: number): Promise<number>;
+//# sourceMappingURL=port-finder.d.ts.map

package/dist/registry/port-finder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-finder.d.ts","sourceRoot":"","sources":["../../src/registry/port-finder.ts"],"names":[],"mappings":"AAgBA;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,EACZ,WAAW,GAAE,MAAY,GACxB,OAAO,CAAC,MAAM,CAAC,CAcjB"}

package/dist/registry/port-finder.js

@@ -0,0 +1,35 @@
+import { createServer } from 'node:net';
+import { logger } from '../logger/logger.js';
+/**
+ * 检测指定端口是否可用。
+ */
+function isPortAvailable(port, host) {
+    return new Promise((resolve) => {
+        const server = createServer();
+        server.once('error', () => resolve(false));
+        server.listen(port, host, () => {
+            server.close(() => resolve(true));
+        });
+    });
+}
+/**
+ * 从 preferredPort 开始递增查找可用端口。
+ * @param preferredPort 首选端口
+ * @param host 绑定地址
+ * @param maxAttempts 最大尝试次数（默认 100）
+ */
+export async function findAvailablePort(preferredPort, host, maxAttempts = 100) {
+    for (let i = 0; i < maxAttempts; i++) {
+        const port = preferredPort + i;
+        if (port > 65535)
+            break;
+        if (await isPortAvailable(port, host)) {
+            if (i > 0) {
+                logger.info({ preferredPort, assignedPort: port }, 'Preferred port occupied, using alternative');
+            }
+            return port;
+        }
+    }
+    throw new Error(`No available port found starting from ${preferredPort} after ${maxAttempts} attempts`);
+}
+//# sourceMappingURL=port-finder.js.map