@meet-im/lxcli 0.0.1

package/dist/core/config.d.ts

@@ -0,0 +1,76 @@
+import type { AppConfig, UserConfig } from '../types/index.js';
+/**
+ * 生成用户 ID (name@tenant)
+ */
+export declare function getUserId(name: string, tenant: string): string;
+/**
+ * 解析用户 ID
+ */
+export declare function parseUserId(id: string): {
+    name: string;
+    tenant: string;
+} | null;
+/**
+ * 获取配置文件路径
+ */
+export declare function getConfigPath(): string;
+/**
+ * 获取配置目录路径
+ */
+export declare function getConfigDir(): string;
+/**
+ * 加载配置
+ */
+export declare function loadConfig(): AppConfig;
+/**
+ * 保存配置
+ */
+export declare function saveConfig(config: AppConfig): void;
+/**
+ * 添加用户
+ */
+export declare function addUser(user: UserConfig): void;
+/**
+ * 删除用户
+ */
+export declare function removeUser(id: string): boolean;
+/**
+ * 获取用户（支持省略 @tenant）
+ */
+export declare function getUser(idOrName: string): UserConfig | undefined;
+export declare function findUsersByName(name: string): UserConfig[];
+/**
+ * 获取默认用户
+ */
+export declare function getDefaultUser(): UserConfig | null;
+/**
+ * 设置默认用户
+ */
+export declare function setDefaultUser(id: string): boolean;
+/**
+ * 设置当前用户
+ */
+export declare function setCurrentUser(id: string): boolean;
+/**
+ * 禁用用户
+ */
+export declare function disableUser(id: string): boolean;
+/**
+ * 启用用户
+ */
+export declare function enableUser(id: string): boolean;
+/**
+ * 更新用户配置
+ */
+export declare function updateUser(id: string, updates: {
+    token?: string;
+    env?: string;
+}): UserConfig | null;
+/**
+ * 列出所有用户
+ */
+export declare function listUsers(): UserConfig[];
+/**
+ * 重置配置
+ */
+export declare function resetConfig(): void;

package/dist/core/config.js

@@ -0,0 +1,255 @@
+// src/core/config.ts
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { outputCliError } from './error.js';
+const CONFIG_DIR = '.lxcli';
+const CONFIG_FILE = 'config.json';
+const CONFIG_VERSION = '1.0';
+/**
+ * 生成用户 ID (name@tenant)
+ */
+export function getUserId(name, tenant) {
+    return `${name}@${tenant}`;
+}
+/**
+ * 解析用户 ID
+ */
+export function parseUserId(id) {
+    const parts = id.split('@');
+    if (parts.length !== 2)
+        return null;
+    return { name: parts[0], tenant: parts[1] };
+}
+/**
+ * 获取配置文件路径
+ */
+export function getConfigPath() {
+    const configDir = process.env.LXCLI_CONFIG_DIR || path.join(os.homedir(), CONFIG_DIR);
+    return path.join(configDir, CONFIG_FILE);
+}
+/**
+ * 获取配置目录路径
+ */
+export function getConfigDir() {
+    return process.env.LXCLI_CONFIG_DIR || path.join(os.homedir(), CONFIG_DIR);
+}
+/**
+ * 确保用户有 id 字段（兼容旧数据）
+ */
+function ensureUserId(user) {
+    if (!user.id) {
+        user.id = getUserId(user.name, user.tenant);
+    }
+    return user;
+}
+/**
+ * 确保配置目录存在
+ */
+function ensureConfigDir() {
+    const configDir = getConfigDir();
+    if (!fs.existsSync(configDir)) {
+        fs.mkdirSync(configDir, { recursive: true });
+    }
+}
+/**
+ * 加载配置
+ */
+export function loadConfig() {
+    const configPath = getConfigPath();
+    if (!fs.existsSync(configPath)) {
+        return {
+            version: CONFIG_VERSION,
+            users: [],
+        };
+    }
+    try {
+        const content = fs.readFileSync(configPath, 'utf-8');
+        const config = JSON.parse(content);
+        // 兼容旧数据：确保每个用户有 id
+        config.users.forEach(ensureUserId);
+        return config;
+    }
+    catch (error) {
+        outputCliError('CONFIG_READ_ERROR', 'Failed to load config file', {
+            path: configPath,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        });
+    }
+}
+/**
+ * 保存配置
+ */
+export function saveConfig(config) {
+    ensureConfigDir();
+    const configPath = getConfigPath();
+    try {
+        fs.writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
+    }
+    catch (error) {
+        outputCliError('CONFIG_WRITE_ERROR', 'Failed to save config file', {
+            path: configPath,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        });
+    }
+}
+/**
+ * 添加用户
+ */
+export function addUser(user) {
+    const config = loadConfig();
+    // 确保 id
+    ensureUserId(user);
+    // 检查用户是否已存在 (name + tenant)
+    const existingIndex = config.users.findIndex(u => u.id === user.id);
+    if (existingIndex >= 0) {
+        config.users[existingIndex] = user;
+    }
+    else {
+        // 第一个用户自动设为默认
+        if (config.users.length === 0) {
+            user.isDefault = true;
+        }
+        config.users.push(user);
+    }
+    saveConfig(config);
+}
+/**
+ * 删除用户
+ */
+export function removeUser(id) {
+    const config = loadConfig();
+    const index = config.users.findIndex(u => u.id === id);
+    if (index < 0)
+        return false;
+    const removedUser = config.users[index];
+    config.users.splice(index, 1);
+    // 如果删除的是默认用户，将第一个用户设为默认
+    if (removedUser.isDefault && config.users.length > 0) {
+        config.users[0].isDefault = true;
+    }
+    // 如果删除的是当前用户，清除 currentUser
+    if (config.currentUser === id) {
+        delete config.currentUser;
+    }
+    saveConfig(config);
+    return true;
+}
+/**
+ * 获取用户（支持省略 @tenant）
+ */
+export function getUser(idOrName) {
+    const config = loadConfig();
+    // 精确匹配 (name@tenant)
+    const exact = config.users.find(u => u.id === idOrName);
+    if (exact)
+        return exact;
+    // 模糊匹配 (只有 name)
+    const matches = config.users.filter(u => u.name === idOrName);
+    if (matches.length === 0)
+        return undefined;
+    // 只有一个同名用户，直接返回
+    if (matches.length === 1)
+        return matches[0];
+    // 多个同名用户，优先返回默认用户
+    const defaultMatch = matches.find(u => u.isDefault);
+    if (defaultMatch)
+        return defaultMatch;
+    // 返回第一个
+    return matches[0];
+}
+export function findUsersByName(name) {
+    const config = loadConfig();
+    return config.users.filter(user => user.name === name);
+}
+/**
+ * 获取默认用户
+ */
+export function getDefaultUser() {
+    const config = loadConfig();
+    return config.users.find(u => u.isDefault) || config.users[0] || null;
+}
+/**
+ * 设置默认用户
+ */
+export function setDefaultUser(id) {
+    const config = loadConfig();
+    const user = config.users.find(u => u.id === id);
+    if (!user)
+        return false;
+    // 清除其他用户的默认标记
+    config.users.forEach(u => {
+        u.isDefault = u.id === id;
+    });
+    saveConfig(config);
+    return true;
+}
+/**
+ * 设置当前用户
+ */
+export function setCurrentUser(id) {
+    const config = loadConfig();
+    const user = config.users.find(u => u.id === id);
+    if (!user)
+        return false;
+    config.currentUser = id;
+    saveConfig(config);
+    return true;
+}
+/**
+ * 禁用用户
+ */
+export function disableUser(id) {
+    const config = loadConfig();
+    const user = config.users.find(u => u.id === id);
+    if (!user)
+        return false;
+    user.disabled = true;
+    saveConfig(config);
+    return true;
+}
+/**
+ * 启用用户
+ */
+export function enableUser(id) {
+    const config = loadConfig();
+    const user = config.users.find(u => u.id === id);
+    if (!user)
+        return false;
+    user.disabled = false;
+    saveConfig(config);
+    return true;
+}
+/**
+ * 更新用户配置
+ */
+export function updateUser(id, updates) {
+    const config = loadConfig();
+    const user = config.users.find(u => u.id === id);
+    if (!user)
+        return null;
+    if (updates.token !== undefined) {
+        user.token = updates.token;
+    }
+    if (updates.env !== undefined) {
+        user.env = updates.env;
+    }
+    saveConfig(config);
+    return user;
+}
+/**
+ * 列出所有用户
+ */
+export function listUsers() {
+    const config = loadConfig();
+    return config.users;
+}
+/**
+ * 重置配置
+ */
+export function resetConfig() {
+    const configPath = getConfigPath();
+    if (fs.existsSync(configPath)) {
+        fs.unlinkSync(configPath);
+    }
+}

package/dist/core/error.d.ts

@@ -0,0 +1,128 @@
+/**
+ * CLI 退出码（供 shell / CI 使用）
+ */
+export declare const CLI_EXIT_CODES: {
+    readonly GENERAL: 1;
+    readonly PARAM: 2;
+    readonly AUTH: 3;
+    readonly NOT_FOUND: 4;
+    readonly INTERNAL: 5;
+};
+/**
+ * CLI 业务错误码（供 JSON 输出使用）
+ */
+export declare const CLI_ERROR_CODES: {
+    readonly UNKNOWN: {
+        readonly code: 10000;
+        readonly reason: "unknownError";
+        readonly exitCode: 1;
+    };
+    readonly PARAM_MISSING: {
+        readonly code: 10001;
+        readonly reason: "paramMissing";
+        readonly exitCode: 2;
+    };
+    readonly PARAM_INVALID: {
+        readonly code: 10002;
+        readonly reason: "paramInvalid";
+        readonly exitCode: 2;
+    };
+    readonly USER_NOT_FOUND: {
+        readonly code: 20001;
+        readonly reason: "userNotFound";
+        readonly exitCode: 4;
+    };
+    readonly USER_DISABLED: {
+        readonly code: 20002;
+        readonly reason: "userDisabled";
+        readonly exitCode: 3;
+    };
+    readonly TENANT_NOT_FOUND: {
+        readonly code: 30001;
+        readonly reason: "tenantNotFound";
+        readonly exitCode: 4;
+    };
+    readonly SERVICE_NOT_FOUND: {
+        readonly code: 30002;
+        readonly reason: "serviceNotFound";
+        readonly exitCode: 4;
+    };
+    readonly CONFIG_READ_ERROR: {
+        readonly code: 40001;
+        readonly reason: "configReadError";
+        readonly exitCode: 5;
+    };
+    readonly CONFIG_WRITE_ERROR: {
+        readonly code: 40002;
+        readonly reason: "configWriteError";
+        readonly exitCode: 5;
+    };
+    readonly NETWORK_ERROR: {
+        readonly code: 50001;
+        readonly reason: "networkError";
+        readonly exitCode: 5;
+    };
+    readonly UPGRADE_CHECK_FAILED: {
+        readonly code: 50002;
+        readonly reason: "upgradeCheckFailed";
+        readonly exitCode: 5;
+    };
+};
+export type CliErrorKey = keyof typeof CLI_ERROR_CODES;
+export declare function getErrorMeta(key: CliErrorKey): {
+    readonly code: 10000;
+    readonly reason: "unknownError";
+    readonly exitCode: 1;
+} | {
+    readonly code: 10001;
+    readonly reason: "paramMissing";
+    readonly exitCode: 2;
+} | {
+    readonly code: 10002;
+    readonly reason: "paramInvalid";
+    readonly exitCode: 2;
+} | {
+    readonly code: 20001;
+    readonly reason: "userNotFound";
+    readonly exitCode: 4;
+} | {
+    readonly code: 20002;
+    readonly reason: "userDisabled";
+    readonly exitCode: 3;
+} | {
+    readonly code: 30001;
+    readonly reason: "tenantNotFound";
+    readonly exitCode: 4;
+} | {
+    readonly code: 30002;
+    readonly reason: "serviceNotFound";
+    readonly exitCode: 4;
+} | {
+    readonly code: 40001;
+    readonly reason: "configReadError";
+    readonly exitCode: 5;
+} | {
+    readonly code: 40002;
+    readonly reason: "configWriteError";
+    readonly exitCode: 5;
+} | {
+    readonly code: 50001;
+    readonly reason: "networkError";
+    readonly exitCode: 5;
+} | {
+    readonly code: 50002;
+    readonly reason: "upgradeCheckFailed";
+    readonly exitCode: 5;
+};
+/**
+ * 输出错误响应（JSON 格式到 stdout，人类提示到 stderr）
+ */
+export declare function outputError(exitCode: number, code: number, message: string, reason?: string, details?: Record<string, unknown>): never;
+/**
+ * 输出 API 错误响应
+ */
+export declare function outputCliError(errorCode: CliErrorKey, message: string, details?: Record<string, unknown>): never;
+/**
+ * 输出 API 错误响应
+ */
+export declare function outputApiError(code: number, message: string, details?: Record<string, unknown>, httpStatus?: number): never;

package/dist/core/error.js

@@ -0,0 +1,85 @@
+// src/core/error.ts
+/**
+ * CLI 退出码（供 shell / CI 使用）
+ */
+export const CLI_EXIT_CODES = {
+    GENERAL: 1,
+    PARAM: 2,
+    AUTH: 3,
+    NOT_FOUND: 4,
+    INTERNAL: 5,
+};
+/**
+ * CLI 业务错误码（供 JSON 输出使用）
+ */
+export const CLI_ERROR_CODES = {
+    UNKNOWN: { code: 10000, reason: 'unknownError', exitCode: CLI_EXIT_CODES.GENERAL },
+    PARAM_MISSING: { code: 10001, reason: 'paramMissing', exitCode: CLI_EXIT_CODES.PARAM },
+    PARAM_INVALID: { code: 10002, reason: 'paramInvalid', exitCode: CLI_EXIT_CODES.PARAM },
+    USER_NOT_FOUND: { code: 20001, reason: 'userNotFound', exitCode: CLI_EXIT_CODES.NOT_FOUND },
+    USER_DISABLED: { code: 20002, reason: 'userDisabled', exitCode: CLI_EXIT_CODES.AUTH },
+    TENANT_NOT_FOUND: { code: 30001, reason: 'tenantNotFound', exitCode: CLI_EXIT_CODES.NOT_FOUND },
+    SERVICE_NOT_FOUND: { code: 30002, reason: 'serviceNotFound', exitCode: CLI_EXIT_CODES.NOT_FOUND },
+    CONFIG_READ_ERROR: { code: 40001, reason: 'configReadError', exitCode: CLI_EXIT_CODES.INTERNAL },
+    CONFIG_WRITE_ERROR: { code: 40002, reason: 'configWriteError', exitCode: CLI_EXIT_CODES.INTERNAL },
+    NETWORK_ERROR: { code: 50001, reason: 'networkError', exitCode: CLI_EXIT_CODES.INTERNAL },
+    UPGRADE_CHECK_FAILED: { code: 50002, reason: 'upgradeCheckFailed', exitCode: CLI_EXIT_CODES.INTERNAL },
+};
+export function getErrorMeta(key) {
+    return CLI_ERROR_CODES[key];
+}
+/**
+ * 输出人类可读错误提示到 stderr
+ */
+function supportsColor() {
+    return Boolean(process.stderr.isTTY) && !process.env.CI && !process.env.NO_COLOR;
+}
+function printErrorHint(reason, message) {
+    const text = `error[${reason || 'unknown'}]:`;
+    const label = supportsColor() ? `\x1b[1;31m${text}\x1b[0m` : text;
+    console.error(`${label} ${message}`);
+}
+/**
+ * 输出错误响应（JSON 格式到 stdout，人类提示到 stderr）
+ */
+export function outputError(exitCode, code, message, reason, details) {
+    const response = {
+        error: {
+            code,
+            reason,
+            message,
+            details: details || {},
+        },
+    };
+    // JSON 到 stdout（供 AI agent / 管道）
+    console.log(JSON.stringify(response, null, 2));
+    // 人类提示到 stderr
+    printErrorHint(reason, message);
+    process.exit(exitCode);
+    throw new Error('Never reached');
+}
+/**
+ * 输出 API 错误响应
+ */
+export function outputCliError(errorCode, message, details) {
+    const meta = getErrorMeta(errorCode);
+    return outputError(meta.exitCode, meta.code, message, meta.reason, details);
+}
+function getApiExitCode(httpStatus) {
+    if (httpStatus === 400) {
+        return CLI_EXIT_CODES.PARAM;
+    }
+    if (httpStatus === 401 || httpStatus === 403) {
+        return CLI_EXIT_CODES.AUTH;
+    }
+    if (httpStatus === 404) {
+        return CLI_EXIT_CODES.NOT_FOUND;
+    }
+    return CLI_EXIT_CODES.INTERNAL;
+}
+/**
+ * 输出 API 错误响应
+ */
+export function outputApiError(code, message, details, httpStatus) {
+    return outputError(getApiExitCode(httpStatus ?? code), code, message, 'apiError', details);
+}

package/dist/core/help.d.ts

@@ -0,0 +1,6 @@
+import type { Command } from 'commander';
+import type { ServiceCommand } from '../types/index.js';
+/**
+ * 自定义帮助显示，分组展示内置命令和服务命令
+ */
+export declare function configureHelp(program: Command, services: ServiceCommand[]): void;

package/dist/core/help.js

@@ -0,0 +1,15 @@
+// src/core/help.ts
+/**
+ * 自定义帮助显示，分组展示内置命令和服务命令
+ */
+export function configureHelp(program, services) {
+    // 在帮助后添加服务分组
+    program.addHelpText('after', () => {
+        if (services.length === 0)
+            return '';
+        const serviceList = services
+            .map((s) => `  ${s.name.padEnd(15)} ${s.description}`)
+            .join('\n');
+        return `\nServices:\n${serviceList}\n`;
+    });
+}

package/dist/core/http.d.ts

@@ -0,0 +1,28 @@
+export interface RequestOptions {
+    /** gateway 地址（必填） */
+    gateway: string;
+    /** 请求路径（不含域名） */
+    path: string;
+    /** HTTP 方法，默认 GET */
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    /** URL query 参数 */
+    query?: Record<string, string | number | boolean>;
+    /** 请求体 */
+    body?: Record<string, unknown>;
+    /** 自定义 headers（会覆盖默认 headers） */
+    headers?: Record<string, string>;
+    /** User-Agent，默认 lxcli/版本号 */
+    userAgent?: string;
+    /** 最大重试次数，默认 3 */
+    maxRetries?: number;
+}
+/**
+ * 通用请求函数
+ *
+ * 支持灵活传递 gateway、路径、方法、参数、UA 等。
+ *
+ * 支持自动重试：
+ * - 429 (rate limit) 响应时重试，尊重 Retry-After header
+ * - 网络错误时重试，使用指数退避
+ */
+export declare function request<T>(options: RequestOptions): Promise<T>;