weaver-work-cli 0.1.2 → 0.1.5

package/dist/shortcuts/yimiaoban/operations/group-read.js

@@ -0,0 +1,477 @@
+import { ymbValidationError } from '../errors.js';
+import { READ, schemaOf, ymbSuccess, } from './types.js';
+import { assertImOk, compact, extractGroupMembers, formatFullTime, splitIds, str, toPositiveInt, toUint, unwrapInner, } from './shared.js';
+const SEARCH_TYPE_MASK = {
+    type: 1,
+    key: 2,
+    members: 8,
+    precise: 16,
+    owners: 32,
+    creators: 64,
+    create: 256,
+};
+function requireCidUid(cid, uid) {
+    const c = String(cid ?? '');
+    const u = String(uid ?? '');
+    if (!c || !u || c === '0' || u === '0') {
+        throw ymbValidationError('self_identity_missing', '该查询需要当前登录人的 cid/uid（非 0），请确认登录态完整');
+    }
+    return { cid: c, uid: u };
+}
+/** 群 id 必填校验（非 0 数字，按字符串传输）。 */
+function requireGroupId(value) {
+    const text = String(value ?? '').trim();
+    if (!/^\d+$/.test(text) || text === '0') {
+        throw ymbValidationError('id_invalid', `groupId 必须是非 0 数字 ID（收到：${text || '(空)'}）`);
+    }
+    return text;
+}
+function dayRangeShanghai(offsetDay) {
+    const now = new Date();
+    const tzMs = 8 * 3600 * 1000;
+    const local = new Date(now.getTime() + tzMs);
+    const dayStart = Date.UTC(local.getUTCFullYear(), local.getUTCMonth(), local.getUTCDate() + offsetDay);
+    return { begin: Math.floor((dayStart - tzMs) / 1000), end: Math.floor((dayStart + 86400_000 - tzMs) / 1000) - 1 };
+}
+function maskTypeName(mask) {
+    const names = [
+        [1, '全员群'], [2, '部门群'], [4, '外部群'], [8, '事项群'], [16, '话题群'],
+    ];
+    const hit = names.filter(([bit]) => (mask & bit) !== 0).map(([, name]) => name);
+    return hit.length ? hit.join('|') : String(mask);
+}
+function stateName(state) {
+    if (state === 1)
+        return '正常';
+    if (state === 0)
+        return '已销毁';
+    return `状态${state}`;
+}
+/** 群搜索。 */
+const groupSearch = {
+    name: 'yimiaoban.group.search',
+    resource: 'group',
+    method: 'group.search',
+    action: 'yimiaoban.group.search',
+    summary: '按条件搜索群（cond+mask 全服务端过滤，禁止本地过滤）',
+    capability: 'group',
+    risk: READ,
+    inputSchema: schemaOf({
+        name: { type: 'string', description: '群名关键字' },
+        precise: { type: 'boolean', description: '精确匹配名称' },
+        type: { type: 'integer', description: '群类型筛选（1 普通/6 部门/7 全员等）' },
+        members: { type: 'boolean', description: '我所在的群' },
+        owner: { type: 'boolean', description: '我是群主的群' },
+        creator: { type: 'boolean', description: '我创建的群' },
+        today: { type: 'boolean', description: '今天创建的群' },
+        yesterday: { type: 'boolean', description: '昨天创建的群' },
+        createBegin: { type: 'integer', description: '创建时间下界（unix 秒）' },
+        createEnd: { type: 'integer', description: '创建时间上界（unix 秒）' },
+        pageSize: { type: 'integer', minimum: 1, maximum: 200, description: '每页大小（默认 100）' },
+    }, { description: '至少提供一个搜索条件' }),
+    handler: async (args, { host }) => {
+        const cond = {};
+        let mask = 0;
+        if (args.type !== undefined) {
+            mask |= SEARCH_TYPE_MASK.type;
+            cond.type = toUint(args.type, 'type');
+        }
+        if (args.name !== undefined && args.name !== '') {
+            mask |= SEARCH_TYPE_MASK.key;
+            cond.key = String(args.name);
+        }
+        if (args.members === true) {
+            // 成员身份必须是 IM cid + IM uid（cid 来自 teamsCheck 的 imCid，不能用登录 userId 顶替）
+            const self = await host.getSelfIdentity();
+            const { cid, uid } = requireCidUid(self.cid, self.uid);
+            mask |= SEARCH_TYPE_MASK.members;
+            cond.members = [{ cid, uid }];
+        }
+        if (args.precise === true) {
+            mask |= SEARCH_TYPE_MASK.precise;
+            cond.precise = 1;
+        }
+        if (args.owner === true) {
+            const self = await host.getSelfIdentity();
+            mask |= SEARCH_TYPE_MASK.owners;
+            cond.owners = [{ cid: self.cid, uid: self.uid }];
+        }
+        if (args.creator === true) {
+            const self = await host.getSelfIdentity();
+            mask |= SEARCH_TYPE_MASK.creators;
+            cond.creators = [{ cid: self.cid, uid: self.uid }];
+        }
+        let create;
+        if (args.today === true)
+            create = dayRangeShanghai(0);
+        else if (args.yesterday === true)
+            create = dayRangeShanghai(-1);
+        else if (args.createBegin !== undefined || args.createEnd !== undefined) {
+            create = { begin: Number(args.createBegin ?? 0), end: Number(args.createEnd ?? 0) };
+        }
+        if (create) {
+            mask |= SEARCH_TYPE_MASK.create;
+            cond.create = create;
+        }
+        if (mask === 0)
+            throw ymbValidationError('cond_required', '至少提供一个搜索条件（name/type/members/owner/creator/today/yesterday/create*）');
+        cond.mask = mask;
+        const pageSize = Math.min(toPositiveInt(args.pageSize, 'pageSize') ?? 100, 200);
+        const body = { page: { size: pageSize, num: 1 }, cond };
+        const res = await host.request({
+            method: 'POST',
+            path: '/api/em/msg/executeIm/group/searchGroup',
+            body,
+            operation: 'yimiaoban.group.search',
+        });
+        assertImOk(res, '搜索群');
+        const inner = unwrapInner(res);
+        const datas = inner?.datas || [];
+        return ymbSuccess('yimiaoban.group.search', {
+            total: inner?.total ?? datas.length,
+            groups: datas.map((g) => ({
+                id: str(g.id),
+                name: g.name ?? '',
+                type: g.type,
+                num: g.num,
+                createTime: formatFullTime(g.create),
+            })),
+        });
+    },
+};
+/** 群基础信息（支持多群）。 */
+const groupInfo = {
+    name: 'yimiaoban.group.info',
+    resource: 'group',
+    method: 'group.info',
+    action: 'yimiaoban.group.info',
+    summary: '按群 id 查基础信息（支持批量；类型位组合 + 状态展示）',
+    capability: 'group',
+    risk: READ,
+    inputSchema: schemaOf({
+        groupIds: { type: 'array', items: { type: 'string' }, description: '群 id 列表（逗号串或数组）' },
+        groupId: { type: 'string', description: '单群 id（groupIds 的便捷形式）' },
+    }, { description: 'groupIds / groupId 至少其一' }),
+    handler: async (args, { host }) => {
+        let ids = [];
+        if (Array.isArray(args.groupIds))
+            ids = args.groupIds.map((x) => String(x));
+        else if (args.groupIds)
+            ids = splitIds(args.groupIds, 'groupIds');
+        if (args.groupId)
+            ids.push(String(args.groupId));
+        ids = [...new Set(ids)];
+        if (ids.length === 0)
+            throw ymbValidationError('group_ids_required', 'groupIds / groupId 至少其一');
+        for (const id of ids) {
+            if (!/^\d+$/.test(id) || id === '0')
+                throw ymbValidationError('id_invalid', `群 id 必须非 0 数字：${id}`);
+        }
+        const body = { trans_id: 0, type: 0, mask: 0, group_id: ids, flag: 0 };
+        const res = await host.request({
+            method: 'POST',
+            path: '/api/em/msg/executeIm/group/queryGroupInfo',
+            body,
+            operation: 'yimiaoban.group.info',
+        });
+        assertImOk(res, '查询群信息');
+        const inner = unwrapInner(res);
+        const datas = inner?.datas || [];
+        const groups = datas.map((g) => ({
+            groupId: str(g.group_id ?? g.id),
+            name: g.name ?? '',
+            mask: Number(g.mask ?? 0),
+            maskName: maskTypeName(Number(g.mask ?? 0)),
+            userNum: g.user_num,
+            maxNum: g.max_num,
+            hostUid: str(g.host_uid ?? g.hostUid ?? ''),
+            state: Number(g.state ?? -1),
+            stateName: stateName(Number(g.state ?? -1)),
+            createTime: formatFullTime(g.create_time ?? g.createTime),
+        }));
+        return ymbSuccess('yimiaoban.group.info', { total: groups.length, groups });
+    },
+};
+/** 群成员列表。 */
+const groupUsers = {
+    name: 'yimiaoban.group.users',
+    resource: 'group',
+    method: 'group.users',
+    action: 'yimiaoban.group.users',
+    summary: '拉取群成员列表（姓名一律走 hrm，默认 mask 不含 name 位）',
+    capability: 'group',
+    risk: READ,
+    inputSchema: schemaOf({
+        groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
+        mask: { type: 'integer', description: 'member_mask（默认 142=cid|uid|role|add_time）' },
+        syncType: { type: 'integer', enum: [0, 1], description: '0 全量（默认）/1 增量' },
+        clientUc: { type: 'string', description: '增量游标 server_uc' },
+    }, { required: ['groupId'], description: '拉取群成员' }),
+    handler: async (args, { host }) => {
+        const groupId = requireGroupId(args.groupId);
+        const memberMask = Number(args.mask ?? 142);
+        const body = compact({
+            group_id: groupId,
+            type: 0,
+            sync_type: Number(args.syncType ?? 0),
+            member_mask: memberMask,
+            client_uc: args.clientUc !== undefined ? String(args.clientUc) : '0',
+        });
+        const res = await host.request({
+            method: 'POST',
+            path: '/api/em/msg/executeIm/group/getGroupUsers',
+            body,
+            operation: 'yimiaoban.group.users',
+        });
+        assertImOk(res, '拉取群成员');
+        const inner = unwrapInner(res);
+        const members = extractGroupMembers(inner);
+        const hasRole = (memberMask & 8) !== 0;
+        const hasAddTime = (memberMask & 128) !== 0;
+        const hasCid = (memberMask & 2) !== 0;
+        const hasUid = (memberMask & 4) !== 0;
+        const roleNames = { 0: '不可用', 1: '普通成员', 2: '管理员', 3: '群主', 4: '客户', 5: '负责人', 6: '协助人员' };
+        const personIds = members.map((m) => String(m?.uid ?? '')).filter((x) => x && x !== '0');
+        // 姓名一律走 hrm 解析（不看 member_mask 的 name 位，也不使用 IM 返回的 name 字段）
+        const personMap = personIds.length ? await host.resolveUsersByIds([...new Set(personIds)]) : {};
+        const rows = members.map((m) => ({
+            uid: hasUid ? str(m.uid) : undefined,
+            cid: hasCid ? str(m.cid) : undefined,
+            name: personMap[str(m.uid)]?.name || str(m.uid),
+            role: hasRole ? Number(m.role_type ?? m.role ?? -1) : undefined,
+            roleName: hasRole ? roleNames[Number(m.role_type ?? m.role ?? -1)] ?? '-' : undefined,
+            addTime: hasAddTime ? formatFullTime(m.add_time ?? m.addTime) : undefined,
+        }));
+        return ymbSuccess('yimiaoban.group.users', {
+            groupId,
+            totalNum: inner?.total_num ?? rows.length,
+            endFlag: inner?.end_flag,
+            serverUc: str(inner?.server_uc ?? ''),
+            members: rows,
+        });
+    },
+};
+/** 批量查群管理员/群主。 */
+const groupAdmins = {
+    name: 'yimiaoban.group.admins',
+    resource: 'group',
+    method: 'group.admins',
+    action: 'yimiaoban.group.admins',
+    summary: '批量获取群主/管理员（mask 位 1=群主/负责人 2=管理员，默认 3）',
+    capability: 'group',
+    risk: READ,
+    inputSchema: schemaOf({
+        groupIds: { type: 'array', items: { type: 'string' }, description: '群 id 列表' },
+        mask: { type: 'integer', description: '角色位掩码（默认 3）' },
+    }, { required: ['groupIds'], description: '批量查询群管理员' }),
+    handler: async (args, { host }) => {
+        const ids = Array.isArray(args.groupIds) ? args.groupIds.map((x) => String(x)) : splitIds(args.groupIds, 'groupIds');
+        const body = { group_ids: ids, mask: Number(args.mask ?? 3) };
+        const res = await host.request({
+            method: 'POST',
+            path: '/api/em/msg/executeIm/group/getGroupAdminBatch',
+            body,
+            operation: 'yimiaoban.group.admins',
+        });
+        assertImOk(res, '查询群管理员');
+        const inner = unwrapInner(res);
+        const datas = inner?.datas || [];
+        const roleNames = { 3: '群主', 2: '管理员' };
+        const allUids = new Set();
+        for (const g of datas) {
+            for (const it of g?.datas || []) {
+                if (it?.user?.uid)
+                    allUids.add(String(it.user.uid));
+            }
+        }
+        const personMap = await host.resolveUsersByIds([...allUids]);
+        const groups = datas.map((g) => ({
+            groupId: str(g.group_id),
+            admins: (g?.datas || []).map((it) => ({
+                name: personMap[str(it.user?.uid)]?.name || str(it.user?.uid),
+                uid: str(it.user?.uid),
+                cid: str(it.user?.cid),
+                role: Number(it.role ?? -1),
+                roleName: roleNames[Number(it.role ?? -1)] ?? '-',
+            })),
+        }));
+        return ymbSuccess('yimiaoban.group.admins', { total: groups.length, groups });
+    },
+};
+/** 批量判断群是否存在。 */
+const groupExist = {
+    name: 'yimiaoban.group.exist',
+    resource: 'group',
+    method: 'group.exist',
+    action: 'yimiaoban.group.exist',
+    summary: '批量判断群是否存在（ret=0 存在；1209 不存在）',
+    capability: 'group',
+    risk: READ,
+    inputSchema: schemaOf({
+        groupIds: { type: 'array', items: { type: 'string' }, description: '群 id 列表' },
+    }, { required: ['groupIds'], description: '批量判断群是否存在' }),
+    handler: async (args, { host }) => {
+        const ids = Array.isArray(args.groupIds) ? args.groupIds.map((x) => String(x)) : splitIds(args.groupIds, 'groupIds');
+        for (const id of ids) {
+            if (!/^\d+$/.test(id) || id === '0')
+                throw ymbValidationError('id_invalid', `群 id 必须非 0 数字：${id || '(空)'}`);
+        }
+        const body = { groupIds: ids };
+        const res = await host.request({
+            method: 'POST',
+            path: '/api/em/msg/executeIm/group/checkGroupExist',
+            body,
+            operation: 'yimiaoban.group.exist',
+        });
+        assertImOk(res, '检查群是否存在');
+        const inner = unwrapInner(res);
+        const results = inner?.results || [];
+        return ymbSuccess('yimiaoban.group.exist', {
+            groups: results.map((r) => ({
+                groupId: str(r.group_id),
+                exists: Number(r.ret) === 0,
+                ret: r.ret,
+            })),
+        });
+    },
+};
+/** 检查用户是否在某群内。 */
+const groupUserExist = {
+    name: 'yimiaoban.group.userExist',
+    resource: 'group',
+    method: 'group.userExist',
+    action: 'yimiaoban.group.userExist',
+    summary: '检查用户是否在某群内（tenantKey 自动注入）',
+    capability: 'group',
+    risk: READ,
+    inputSchema: schemaOf({
+        groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
+        users: { type: 'array', items: { type: 'string' }, description: '待检查 uid 列表' },
+    }, { required: ['groupId', 'users'], description: '检查用户是否在群内' }),
+    handler: async (args, { host }) => {
+        const groupId = requireGroupId(args.groupId);
+        const users = Array.isArray(args.users) ? args.users.map((x) => String(x)) : splitIds(args.users, 'users');
+        const session = await host.getSession();
+        if (!session.tenantKey)
+            throw ymbValidationError('tenant_key_missing', '登录态缺少 tenantKey，请重新登录');
+        const body = { tenantKey: session.tenantKey, groupId, users };
+        const res = await host.request({
+            method: 'POST',
+            path: '/api/em/msg/executeIm/group/checkGroupUserExist',
+            body,
+            operation: 'yimiaoban.group.userExist',
+        });
+        assertImOk(res, '检查群成员');
+        const inner = unwrapInner(res);
+        const inGroup = Array.isArray(inner?.users) ? inner.users.map((x) => String(x)) : [];
+        const inSet = new Set(inGroup);
+        const personMap = await host.resolveUsersByIds(users);
+        const rows = users.map((uid) => ({
+            uid,
+            name: personMap[uid]?.name || uid,
+            inGroup: inSet.has(uid),
+        }));
+        return ymbSuccess('yimiaoban.group.userExist', { groupId, total: rows.length, users: rows });
+    },
+};
+/** 群公告：获取单条。 */
+const groupAnnounceGet = {
+    name: 'yimiaoban.group.announce.get',
+    resource: 'group',
+    method: 'group.announce.get',
+    action: 'yimiaoban.group.announce.get',
+    summary: '获取群公告（aid=0/不传=最新公告）',
+    capability: 'group',
+    risk: READ,
+    inputSchema: schemaOf({
+        groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
+        aid: { type: 'string', description: '公告 id（默认 0=最新）' },
+    }, { required: ['groupId'], description: '获取群公告' }),
+    handler: async (args, { host }) => {
+        const body = { groupId: requireGroupId(args.groupId), aid: args.aid !== undefined ? String(args.aid) : '0' };
+        const res = await host.request({
+            method: 'POST',
+            path: '/api/em/msg/executeIm/group/getAnnouce',
+            body,
+            operation: 'yimiaoban.group.announce.get',
+        });
+        assertImOk(res, '获取群公告');
+        const inner = unwrapInner(res);
+        // 公告主体位于 data.data.data（兼容 data.data 直挂 annouce 的形态）
+        const data = inner && typeof inner === 'object' && inner.data && typeof inner.data === 'object' ? inner.data : inner;
+        if (!data || (data.aid === undefined && data.annouce === undefined)) {
+            return ymbSuccess('yimiaoban.group.announce.get', { found: false });
+        }
+        const personMap = await host.resolveUsersByIds(data?.add_user?.uid ? [String(data.add_user.uid)] : []);
+        return ymbSuccess('yimiaoban.group.announce.get', {
+            found: true,
+            aid: str(data.aid),
+            annouce: data.annouce ?? '',
+            addUserName: personMap[str(data.add_user?.uid)]?.name || str(data.add_user?.uid),
+            time: formatFullTime(data.time),
+            updateTime: formatFullTime(data.update_tm ?? data.update_time),
+            fmark: Number(data.fmark ?? 0),
+            mustRead: Number(data.fmark ?? 0) === 1,
+            related: str(data.related ?? ''),
+        });
+    },
+};
+/** 群公告列表。 */
+const groupAnnounceList = {
+    name: 'yimiaoban.group.announce.list',
+    resource: 'group',
+    method: 'group.announce.list',
+    action: 'yimiaoban.group.announce.list',
+    summary: '群公告列表（按 id 降序，end_flag=1 还有下一页）',
+    capability: 'group',
+    risk: READ,
+    inputSchema: schemaOf({
+        groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
+        aid: { type: 'string', description: '分页起始公告 id（默认 0）' },
+        pageSize: { type: 'integer', description: '分页大小（默认服务端最大）' },
+    }, { required: ['groupId'], description: '群公告列表' }),
+    handler: async (args, { host }) => {
+        const body = compact({
+            groupId: requireGroupId(args.groupId),
+            aid: args.aid !== undefined ? String(args.aid) : '0',
+            pageSize: args.pageSize !== undefined ? toUint(args.pageSize, 'pageSize') : undefined,
+        });
+        const res = await host.request({
+            method: 'POST',
+            path: '/api/em/msg/executeIm/group/getAnnouceList',
+            body,
+            operation: 'yimiaoban.group.announce.list',
+        });
+        assertImOk(res, '获取公告列表');
+        const inner = unwrapInner(res);
+        const datas = inner?.datas || inner?.list || [];
+        const personIds = datas.map((d) => String(d?.add_user?.uid ?? '')).filter((x) => x && x !== '0');
+        const personMap = await host.resolveUsersByIds([...new Set(personIds)]);
+        const rows = datas.map((d) => ({
+            aid: str(d.aid),
+            annouce: d.annouce ?? '',
+            deleted: d.annouce === undefined || d.annouce === null || d.annouce === '',
+            addUserName: personMap[str(d.add_user?.uid)]?.name || str(d.add_user?.uid),
+            time: formatFullTime(d.time),
+            updateTime: formatFullTime(d.update_tm ?? d.update_time),
+            mustRead: Number(d.fmark ?? 0) === 1,
+            related: str(d.related ?? ''),
+        }));
+        return ymbSuccess('yimiaoban.group.announce.list', {
+            total: rows.length,
+            endFlag: inner?.end_flag,
+            hasMore: Number(inner?.end_flag) === 1,
+            announcements: rows,
+        });
+    },
+};
+export const groupReadOperations = [
+    groupSearch,
+    groupInfo,
+    groupUsers,
+    groupAdmins,
+    groupExist,
+    groupUserExist,
+    groupAnnounceGet,
+    groupAnnounceList,
+];