@cloudglab/yapi-cli 0.0.1

package/dist/tools/yapi/register-auth.js

@@ -0,0 +1,182 @@
+import { z } from 'zod';
+import { CliConfigError, CliValidationError } from '../../core/errors.js';
+import { jsonResult, optionalTrimmedText } from '../shared.js';
+import { saveConfig, hasConfig, loadConfig, YAPI_HOME, YApiAuthService, YApiService, encryptPassword } from '../../services/yapi/index.js';
+export function registerAuthCommands(registry) {
+    // ==================== 配置初始化 ====================
+    registry.tool('config-init', {
+        server: z.string().describe('YApi 服务器地址（如 https://yapi.example.com）'),
+        token: optionalTrimmedText.describe('API Token（可选，也可后续用 login 命令设置）'),
+        projectId: z.coerce.number().optional().describe('默认项目 ID'),
+    }, async (input) => {
+        if (hasConfig()) {
+            throw new CliConfigError('配置文件已存在，如需重新配置请先删除 ~/.yapi/config.json');
+        }
+        const config = {
+            serverUrl: input.server.replace(/\/+$/, ''),
+        };
+        if (input.token)
+            config.token = input.token;
+        if (input.projectId)
+            config.projectId = input.projectId;
+        saveConfig(config);
+        return jsonResult({
+            server: config.serverUrl,
+            hasToken: !!input.token,
+        });
+    }, '初始化 YApi 配置', {
+        costHint: 'low',
+        nextBestTools: ['login', 'whoami'],
+    });
+    // ==================== 登录 ====================
+    registry.tool('login', {
+        token: optionalTrimmedText.describe('YApi API Token'),
+        email: optionalTrimmedText.describe('登录邮箱（需同时提供 --password）'),
+        password: optionalTrimmedText.describe('登录密码（需同时提供 --email）'),
+        uid: optionalTrimmedText.describe('用户 ID（LDAP 模式自动提取，--token 模式可选提供）'),
+        ldap: z.coerce.boolean().optional().default(false).describe('使用 LDAP 登录（需先配置 ldapSalt），此时密码自动 PBKDF2 加密'),
+    }, async (input) => {
+        const config = loadConfig();
+        if (!config) {
+            throw new CliConfigError('请先运行 `yapi config-init` 初始化配置');
+        }
+        if (input.token) {
+            const auth = new YApiAuthService(YAPI_HOME);
+            // JWT token 同时以 Authorization 和 _yapi_token/_yapi_uid cookie 形式保存
+            const uid = input.uid ?? extractJwtUid(input.token);
+            auth.loginWithJwtCookie(input.token, undefined, uid);
+            config.token = input.token;
+            saveConfig(config);
+            return jsonResult({
+                method: 'token',
+                username: null,
+            });
+        }
+        if (input.email && input.password) {
+            const auth = new YApiAuthService(YAPI_HOME);
+            const api = new YApiService(config.serverUrl, () => auth.getAuthHeaders(), () => auth.getToken() ?? config.token ?? '');
+            if (input.ldap || config.authMode === 'ldap') {
+                // LDAP 登录：密码 PBKDF2 加密后发送
+                const salt = config.ldapSalt || 'e6751eadaefc7af085fa0f9e047cfce6d2cce0cb95706ed5f9a0422b28f64407';
+                const encrypted = encryptPassword(input.password, salt);
+                const ldapResult = await api.loginByLdap(input.email, encrypted);
+                auth.loginWithJwtCookie(ldapResult.token, ldapResult.username, ldapResult.uid);
+                config.token = ldapResult.token;
+                saveConfig(config);
+                return jsonResult({
+                    method: 'ldap',
+                    username: ldapResult.username,
+                });
+            }
+            // 标准密码登录
+            const result = await api.loginWithPassword(input.email, input.password);
+            const token = result.data.token;
+            auth.loginWithToken(token, result.data.username);
+            config.token = token;
+            saveConfig(config);
+            return jsonResult({
+                method: 'password',
+                username: result.data.username,
+            });
+        }
+        throw new CliValidationError('请提供 --token 或 --email + --password');
+    }, '登录 YApi', {
+        costHint: 'low',
+        nextBestTools: ['whoami', 'project-list', 'group-list'],
+    });
+    // ==================== 登出 ====================
+    registry.tool('logout', {}, async () => {
+        const auth = new YApiAuthService(YAPI_HOME);
+        let serverLogoutOk = false;
+        let serverLogoutError;
+        // 先调用服务端登出（如果已登录）
+        const config = loadConfig();
+        if (config) {
+            try {
+                const testApi = new YApiService(config.serverUrl, () => auth.getAuthHeaders(), () => auth.getToken() ?? config.token ?? '');
+                const result = await testApi.userLogout();
+                serverLogoutOk = result.errcode === 0;
+                if (!serverLogoutOk) {
+                    serverLogoutError = result.errmsg;
+                }
+            }
+            catch (err) {
+                serverLogoutError = err instanceof Error ? err.message : String(err);
+            }
+        }
+        // 再清理本地认证缓存
+        auth.logout();
+        return jsonResult({
+            message: '已登出',
+            serverLogout: serverLogoutOk,
+            serverLogoutError,
+        });
+    }, '登出 YApi（同时清理本地缓存 + 服务端会话）', {
+        costHint: 'low',
+        nextBestTools: ['login'],
+    });
+    // ==================== 查看当前用户 ====================
+    registry.tool('whoami', {}, async () => {
+        const auth = new YApiAuthService(YAPI_HOME);
+        const config = loadConfig();
+        // 优先尝试服务端验证
+        if (config) {
+            try {
+                const testApi = new YApiService(config.serverUrl, () => auth.getAuthHeaders(), () => auth.getToken() ?? config.token ?? '');
+                const status = await testApi.getLoginStatus();
+                return jsonResult({
+                    loggedIn: true,
+                    username: status.data?.username ?? auth.username,
+                    email: status.data?.email ?? null,
+                    server: config.serverUrl,
+                    authMode: config.authMode ?? 'token',
+                    tokenConfigured: !!config.token,
+                });
+            }
+            catch {
+                // 服务端不可用时降级到局部读取
+            }
+        }
+        // 降级：从本地缓存读取
+        if (auth.isLoggedIn) {
+            return jsonResult({
+                loggedIn: true,
+                username: auth.username,
+                email: null,
+                server: config?.serverUrl ?? null,
+                authMode: config?.authMode ?? 'token',
+                tokenConfigured: !!config?.token,
+            });
+        }
+        if (config?.token) {
+            return jsonResult({
+                loggedIn: false,
+                username: null,
+                email: null,
+                server: config.serverUrl,
+                authMode: config.authMode ?? 'token',
+                tokenConfigured: true,
+                message: 'Token 已配置但未验证。运行 login --token <token> 激活',
+            });
+        }
+        throw new CliConfigError('未配置 YApi', '请先运行 yapi config-init 或 yapi login');
+    }, '查看当前登录状态', {
+        costHint: 'low',
+        nextBestTools: ['group-list', 'project-list'],
+    });
+}
+function extractJwtUid(token) {
+    const parts = token.split('.');
+    if (parts.length < 2)
+        return undefined;
+    try {
+        const payload = JSON.parse(Buffer.from(parts[1], 'base64url').toString('utf-8'));
+        if (payload.uid === undefined || payload.uid === null)
+            return undefined;
+        return String(payload.uid);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=register-auth.js.map

package/dist/tools/yapi/register-auth.js.map

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

package/dist/tools/yapi/register-group.d.ts

@@ -0,0 +1,2 @@
+import type { CliRegistry } from '../../core/cli-registry.js';
+export declare function registerGroupCommands(registry: CliRegistry): void;

package/dist/tools/yapi/register-group.js

@@ -0,0 +1,178 @@
+import { z } from 'zod';
+import { CliError, CliValidationError } from '../../core/errors.js';
+import { jsonResult } from '../shared.js';
+import { createYApiServices } from './utils.js';
+export function registerGroupCommands(registry) {
+    registry.tool('group-list', {}, async () => {
+        const { api } = createYApiServices();
+        const result = await api.listGroups();
+        return jsonResult({
+            groups: result.data.map((g) => ({
+                id: g._id,
+                name: g.group_name,
+                projectCount: g.project_count,
+            })),
+        });
+    }, '列出所有分组', {
+        costHint: 'low',
+        nextBestTools: ['group-get', 'project-list'],
+    });
+    registry.tool('group-get', {
+        id: z.coerce.number().describe('分组 ID'),
+    }, async (input) => {
+        const { api } = createYApiServices();
+        const result = await api.getGroup(input.id);
+        return jsonResult({
+            group: {
+                id: result.data._id,
+                name: result.data.group_name,
+                members: result.data.members,
+            },
+        });
+    }, '查看分组详情', {
+        costHint: 'low',
+        nextBestTools: ['project-list', 'interface-list'],
+    });
+    // ==================== 创建分组 ====================
+    registry.tool('group-create', {
+        name: z.string().describe('分组名称'),
+        desc: z.string().optional().describe('分组描述'),
+    }, async (input) => {
+        if (!input.name.trim()) {
+            throw new CliValidationError('分组名称不能为空');
+        }
+        const { api } = createYApiServices();
+        const result = await api.groupAdd({
+            group_name: input.name.trim(),
+            desc: input.desc,
+        });
+        if (result.errcode !== 0) {
+            throw new CliError(result.errmsg ?? '创建分组失败', 14, 'API_ERROR');
+        }
+        return jsonResult({
+            groupId: result.data._id,
+            message: `分组「${input.name}」创建成功`,
+        });
+    }, '创建新分组', {
+        costHint: 'medium',
+        nextBestTools: ['group-list', 'group-member-add'],
+    });
+    // ==================== 更新分组 ====================
+    registry.tool('group-update', {
+        groupId: z.coerce.number().describe('分组 ID'),
+        name: z.string().optional().describe('分组名称'),
+        desc: z.string().optional().describe('分组描述'),
+    }, async (input) => {
+        if (input.name === undefined && input.desc === undefined) {
+            throw new CliValidationError('至少需要提供 name 或 desc 中的一个');
+        }
+        const { api } = createYApiServices();
+        const result = await api.groupUp({
+            group_id: input.groupId,
+            group_name: input.name,
+            desc: input.desc,
+        });
+        if (result.errcode !== 0) {
+            throw new CliError(result.errmsg ?? '更新分组失败', 14, 'API_ERROR');
+        }
+        return jsonResult({
+            groupId: input.groupId,
+            message: `分组 ${input.groupId} 已更新`,
+        });
+    }, '更新分组信息', {
+        costHint: 'medium',
+        nextBestTools: ['group-get', 'group-list'],
+    });
+    // ==================== 删除分组 ====================
+    registry.tool('group-delete', {
+        groupId: z.coerce.number().describe('分组 ID'),
+    }, async (input) => {
+        const { api } = createYApiServices();
+        const result = await api.groupDel(input.groupId);
+        if (result.errcode !== 0) {
+            throw new CliError(result.errmsg ?? '删除分组失败', 14, 'API_ERROR');
+        }
+        return jsonResult({
+            groupId: input.groupId,
+            message: `分组 ${input.groupId} 已删除`,
+        });
+    }, '删除分组', {
+        costHint: 'medium',
+        nextBestTools: ['group-list'],
+    });
+    // ==================== 添加分组成员 ====================
+    registry.tool('group-member-add', {
+        groupId: z.coerce.number().describe('分组 ID'),
+        uid: z.coerce.number().describe('用户 UID'),
+        role: z.string().optional().describe('成员角色（如 owner/dev/master）'),
+    }, async (input) => {
+        const { api } = createYApiServices();
+        const result = await api.groupAddMember({
+            id: input.groupId,
+            uid: input.uid,
+            role: input.role,
+        });
+        if (result.errcode !== 0) {
+            throw new CliError(result.errmsg ?? '添加分组成员失败', 14, 'API_ERROR');
+        }
+        return jsonResult({
+            groupId: input.groupId,
+            uid: input.uid,
+            message: `用户 ${input.uid} 已加入分组 ${input.groupId}`,
+        });
+    }, '添加分组成员', {
+        costHint: 'medium',
+        nextBestTools: ['group-get', 'group-member-role'],
+    });
+    // ==================== 修改成员角色 ====================
+    registry.tool('group-member-role', {
+        groupId: z.coerce.number().describe('分组 ID'),
+        memberUid: z.coerce.number().describe('成员 UID'),
+        role: z.string().describe('新角色（如 owner/dev/master）'),
+    }, async (input) => {
+        if (!input.role.trim()) {
+            throw new CliValidationError('角色不能为空');
+        }
+        const { api } = createYApiServices();
+        const result = await api.groupChangeMemberRole({
+            group_id: input.groupId,
+            member_uid: input.memberUid,
+            role: input.role.trim(),
+        });
+        if (result.errcode !== 0) {
+            throw new CliError(result.errmsg ?? '修改成员角色失败', 14, 'API_ERROR');
+        }
+        return jsonResult({
+            groupId: input.groupId,
+            memberUid: input.memberUid,
+            role: input.role,
+            message: `成员 ${input.memberUid} 角色已更新为 ${input.role}`,
+        });
+    }, '修改分组成员角色', {
+        costHint: 'medium',
+        nextBestTools: ['group-get', 'group-member-remove'],
+    });
+    // ==================== 移除分组成员 ====================
+    registry.tool('group-member-remove', {
+        groupId: z.coerce.number().describe('分组 ID'),
+        memberUid: z.coerce.number().describe('成员 UID'),
+    }, async (input) => {
+        const { api } = createYApiServices();
+        const result = await api.groupDelMember({
+            group_id: input.groupId,
+            member_uid: input.memberUid,
+        });
+        if (result.errcode !== 0) {
+            throw new CliError(result.errmsg ?? '移除分组成员失败', 14, 'API_ERROR');
+        }
+        return jsonResult({
+            groupId: input.groupId,
+            memberUid: input.memberUid,
+            message: `成员 ${input.memberUid} 已从分组 ${input.groupId} 中移除`,
+        });
+    }, '移除分组成员', {
+        costHint: 'medium',
+        nextBestTools: ['group-get', 'group-member-add'],
+    });
+}
+//# sourceMappingURL=register-group.js.map

package/dist/tools/yapi/register-group.js.map

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

package/dist/tools/yapi/register-interface.d.ts

@@ -0,0 +1,2 @@
+import type { CliRegistry } from '../../core/cli-registry.js';
+export declare function registerInterfaceCommands(registry: CliRegistry): void;