weaver-work-cli 0.1.4 → 0.1.5

package/dist/shortcuts/yimiaoban/operations/msg-sync.js

@@ -0,0 +1,519 @@
+import { ymbValidationError } from '../errors.js';
+import { READ, schemaOf, ymbSuccess, } from './types.js';
+import { assertImOk, compact, formatFullTime, makeMinMaxIdByTm, minMsgId, parseMsg, parseTimeToSec, resolveAuthUid, str, todayRange, unwrapInner, } from './shared.js';
+import { collapseNewlines, collectI18nIds, collectPersonIds, extractFiles, extractImgs, extractVideos, parseContent, senderName, } from './msg-parse.js';
+const MAX_MSG_ID = String((1n << 63n) - 1n);
+const DEFAULT_PAGE_SIZE = 20;
+const MAX_PAGE_SIZE = 50;
+/** 时间/最新/游标/显式 id 计算 start/end。 */
+function resolveStartEnd(args, fallback = {}) {
+    // 1) 显式 start/end 最高优先
+    if (args.start !== undefined && args.start !== null && args.start !== '') {
+        const start = String(args.start);
+        const end = args.end !== undefined && args.end !== null && args.end !== '' ? String(args.end) : '0';
+        return { start, end };
+    }
+    if (args.latest === true) {
+        return { start: MAX_MSG_ID, end: '0' };
+    }
+    // 2) 时间范围
+    if ((args.from !== undefined && args.from !== null && args.from !== '')
+        || (args.to !== undefined && args.to !== null && args.to !== '')) {
+        const fromSec = parseTimeToSec(args.from, false);
+        const toSec = parseTimeToSec(args.to, true);
+        if (toSec > 0) {
+            const start = makeMinMaxIdByTm(toSec).max;
+            const end = fromSec > 0 ? makeMinMaxIdByTm(fromSec).min : '0';
+            return { start, end };
+        }
+        return { start: MAX_MSG_ID, end: '0' };
+    }
+    // 3) 默认当天
+    const range = todayRange();
+    const startTm = fallback.toSec || range.toSec;
+    const endTm = fallback.fromSec || range.fromSec;
+    if (startTm > 0)
+        return { start: makeMinMaxIdByTm(startTm).max, end: makeMinMaxIdByTm(endTm).min };
+    return { start: MAX_MSG_ID, end: '0' };
+}
+function pageSizeOf(args) {
+    const raw = args.num;
+    if (raw === undefined || raw === null || raw === '')
+        return DEFAULT_PAGE_SIZE;
+    const n = Number(raw);
+    if (!Number.isInteger(n) || n <= 0)
+        throw ymbValidationError('num_invalid', 'num 必须是正整数');
+    return Math.min(n, MAX_PAGE_SIZE);
+}
+/** `actionMsg.code=1303`（无聊天记录）时按成功空列表返回，并说明本次口径。 */
+function emptyPageNote(args) {
+    if (args.latest === true)
+        return '该会话暂无任何消息记录';
+    const hasRange = (args.from !== undefined && args.from !== '') || (args.to !== undefined && args.to !== '');
+    if (hasRange)
+        return '该时间范围内无消息记录';
+    return '当天无消息（如需最新消息请传 latest:true，或指定 from/to 时间范围）';
+}
+/** 单页返回公共字段：`hasMore` + 下一页锚点 + 去重提示。 */
+function pageMeta(messages, args) {
+    const hasMore = messages.length >= pageSizeOf(args);
+    const nextStart = minMsgId(messages);
+    return {
+        hasMore,
+        ...(hasMore && nextStart
+            ? { nextStart, dedupeHint: '下一页 start 传 nextStart；服务端会重复返回该条（边界消息），请按 msgid 去重' }
+            : {}),
+    };
+}
+/** 富化消息列表：并行取 i18n + 人员姓名，逐条解析 content/sender/media。 */
+async function enrichMessages(rawRows, host, options = {}) {
+    const rows = rawRows.filter(Boolean);
+    if (rows.length === 0)
+        return [];
+    const i18nIds = collectI18nIds(rows);
+    const personIds = collectPersonIds(rows);
+    const fromUids = rows.map((r) => r.from_uid).filter((x) => Boolean(x));
+    for (const uid of fromUids)
+        personIds.push(uid);
+    const [i18nMap, personMap] = await Promise.all([
+        host.fetchI18nLabels(i18nIds),
+        host.resolveUsersByIds([...new Set(personIds)]),
+    ]);
+    const nameMap = {};
+    for (const [uid, p] of Object.entries(personMap))
+        nameMap[uid] = p.name;
+    const enriched = [];
+    for (const row of rows) {
+        const msgObj = parseMsg(row.msg);
+        const parsed = parseContent(msgObj, { i18nMap, nameMap });
+        const imgs = msgObj ? extractImgs(msgObj) : [];
+        const videos = msgObj ? extractVideos(msgObj) : [];
+        const files = msgObj ? extractFiles(msgObj) : [];
+        const imgFormat = options.imgFormat || 'small';
+        const media = [];
+        for (const img of imgs) {
+            media.push({
+                kind: 'img',
+                fileId: img.fileId,
+                name: img.name,
+                w: img.w,
+                h: img.h,
+                previewUrl: await host.buildPreviewUrl({
+                    fileId: img.fileId,
+                    msgid: String(row.ser_msgid ?? ''),
+                    kind: 'img',
+                    imgFormat: imgFormat,
+                    ...(options.groupId ? { groupId: options.groupId } : {}),
+                    ...(options.user ? { user: options.user } : {}),
+                }),
+                downloadUrl: await host.buildDownloadUrl({
+                    fileId: img.fileId,
+                    msgid: String(row.ser_msgid ?? ''),
+                    kind: 'img',
+                    imgFormat: imgFormat,
+                    ...(options.groupId ? { groupId: options.groupId } : {}),
+                    ...(options.user ? { user: options.user } : {}),
+                }),
+            });
+        }
+        for (const v of videos) {
+            media.push({
+                kind: 'video',
+                fileId: v.fileId,
+                name: v.name,
+                ext: v.ext,
+                previewUrl: await host.buildPreviewUrl({
+                    fileId: v.fileId,
+                    msgid: String(row.ser_msgid ?? ''),
+                    kind: 'video',
+                    ...(options.groupId ? { groupId: options.groupId } : {}),
+                    ...(options.user ? { user: options.user } : {}),
+                }),
+                downloadUrl: await host.buildDownloadUrl({
+                    fileId: v.fileId,
+                    msgid: String(row.ser_msgid ?? ''),
+                    kind: 'video',
+                    ...(options.groupId ? { groupId: options.groupId } : {}),
+                    ...(options.user ? { user: options.user } : {}),
+                }),
+            });
+        }
+        for (const f of files) {
+            media.push({
+                kind: 'file',
+                fileId: f.fileId,
+                name: f.name,
+                size: f.size,
+                downloadUrl: await host.buildDownloadUrl({
+                    fileId: f.fileId,
+                    msgid: String(row.ser_msgid ?? ''),
+                    kind: 'img',
+                    imgFormat: imgFormat,
+                    ...(options.groupId ? { groupId: options.groupId } : {}),
+                    ...(options.user ? { user: options.user } : {}),
+                }),
+            });
+        }
+        const sender = senderName(msgObj || {}, row.from_uid, options.authUid, nameMap);
+        enriched.push({
+            msgid: str(row.ser_msgid),
+            sender,
+            from_uid: str(row.from_uid),
+            time: formatFullTime(row.msgtime),
+            msgtime: row.msgtime,
+            type: parsed.type,
+            typeName: parsed.typeName,
+            title: options.titleFirst ? parsed.title : undefined,
+            content: collapseNewlines(parsed.content),
+            must: parsed.must,
+            fileName: parsed.fileName,
+            media,
+            ...(msgObj ? { msg: msgObj } : {}),
+        });
+    }
+    return enriched;
+}
+/** 拉单聊消息（默认当天，单页，倒序）。 */
+const msgSyncSingle = {
+    name: 'yimiaoban.msg.sync.single',
+    resource: 'msg',
+    method: 'msg.sync.single',
+    action: 'yimiaoban.msg.sync.single',
+    summary: '拉取与某人的单聊消息（倒序单页，默认当天；时间范围转消息 id 区间）',
+    capability: 'msg',
+    risk: READ,
+    inputSchema: schemaOf({
+        fromUid: { type: 'string', pattern: '^\\d+$', description: '对方 uid（必填）' },
+        fromCid: { type: 'string', pattern: '^\\d+$', description: '对方 cid（必填）' },
+        num: { type: 'integer', minimum: 1, maximum: 50, description: '单页数量（默认 20，最多 50）' },
+        latest: { type: 'boolean', description: '拉最新不限日期' },
+        from: { type: 'string', description: '起始时间（YYYY-MM-DD 或 YYYY-MM-DD HH:mm:ss 或 unix 秒）' },
+        to: { type: 'string', description: '结束时间' },
+        start: { type: 'string', description: '显式起始消息 id（最高优先）' },
+        end: { type: 'string', description: '显式结束消息 id' },
+        imgFormat: { type: 'string', enum: ['small', 'large', 'original'], description: '预览规格（默认 small）' },
+    }, { required: ['fromUid', 'fromCid'], description: '拉取单聊消息' }),
+    handler: async (args, { host }) => {
+        const fromUid = String(args.fromUid);
+        const fromCid = String(args.fromCid);
+        if (!fromUid || !fromCid || fromUid === '0' || fromCid === '0') {
+            throw ymbValidationError('id_invalid', 'fromUid/fromCid 必须非 0');
+        }
+        const { start, end } = resolveStartEnd(args);
+        const body = {
+            trans_id: 0,
+            dev: 4,
+            enc_type: 0,
+            datas: [{ from_cid: fromCid, from_uid: fromUid, start, end, max_num: pageSizeOf(args) }],
+        };
+        const res = await host.request({
+            method: 'POST',
+            path: '/api/em/msg/executeIm/msg/syncSingleMsg',
+            body,
+            operation: 'yimiaoban.msg.sync.single',
+        });
+        const inner = unwrapInner(res);
+        const outerDatas = inner?.datas || [];
+        const rawRows = [];
+        for (const group of outerDatas) {
+            const list = group?.datas || group?.data || [];
+            if (Array.isArray(list))
+                rawRows.push(...list);
+        }
+        // 1303=无聊天记录：按成功空列表返回（与群聊口径一致），并说明本次口径
+        const actCode = Number(res?.data?.actionMsg?.code ?? -1);
+        if (actCode !== 1303)
+            assertImOk(res, '拉取单聊消息');
+        const authUid = await resolveAuthUid(host);
+        const messages = await enrichMessages(rawRows, host, {
+            authUid,
+            user: { cid: fromCid, uid: fromUid },
+            imgFormat: args.imgFormat,
+        });
+        return ymbSuccess('yimiaoban.msg.sync.single', {
+            total: messages.length,
+            messages,
+            range: { from: args.from, to: args.to, start, end },
+            ...pageMeta(messages, args),
+            ...(actCode === 1303 ? { empty: true, emptyReason: emptyPageNote(args) } : {}),
+        });
+    },
+};
+/** 拉群聊消息。 */
+const msgSyncGroup = {
+    name: 'yimiaoban.msg.sync.group',
+    resource: 'msg',
+    method: 'msg.sync.group',
+    action: 'yimiaoban.msg.sync.group',
+    summary: '拉取某群聊天消息（倒序单页，默认当天；type=0 必传）',
+    capability: 'msg',
+    risk: READ,
+    inputSchema: schemaOf({
+        groupId: { type: 'string', pattern: '^\\d+$', description: '群 id（必填）' },
+        num: { type: 'integer', minimum: 1, maximum: 50, description: '单页数量（默认 20，最多 50）' },
+        latest: { type: 'boolean', description: '拉最新不限日期' },
+        from: { type: 'string', description: '起始时间' },
+        to: { type: 'string', description: '结束时间' },
+        startId: { type: 'string', description: '显式起始消息 id（最高优先）' },
+        endId: { type: 'string', description: '显式结束消息 id' },
+        imgFormat: { type: 'string', enum: ['small', 'large', 'original'], description: '预览规格（默认 small）' },
+    }, { required: ['groupId'], description: '拉取群聊消息' }),
+    handler: async (args, { host }) => {
+        const groupId = String(args.groupId);
+        if (!groupId || groupId === '0')
+            throw ymbValidationError('id_invalid', 'groupId 必须非 0');
+        // 群聊显式 id flag 名为 startId/endId
+        const start = args.startId !== undefined && args.startId !== null && args.startId !== ''
+            ? String(args.startId)
+            : (args.latest === true ? MAX_MSG_ID : resolveStartEnd(args).start);
+        const end = args.endId !== undefined && args.endId !== null && args.endId !== ''
+            ? String(args.endId)
+            : '0';
+        const body = {
+            trans_id: 0,
+            dev: 4,
+            type: 0,
+            enc_type: 0,
+            datas: [{ group_id: groupId, start, end, max_num: pageSizeOf(args) }],
+        };
+        const res = await host.request({
+            method: 'POST',
+            path: '/api/em/msg/executeIm/chat/syncGroupMsg',
+            body,
+            operation: 'yimiaoban.msg.sync.group',
+        });
+        const inner = unwrapInner(res);
+        const outerDatas = inner?.datas || [];
+        const rawRows = [];
+        for (const group of outerDatas) {
+            const list = group?.datas || group?.data || [];
+            if (Array.isArray(list))
+                rawRows.push(...list);
+        }
+        const actCode = Number(res?.data?.actionMsg?.code ?? -1);
+        if (actCode !== 1303)
+            assertImOk(res, '拉取群聊消息');
+        const authUid = await resolveAuthUid(host);
+        const messages = await enrichMessages(rawRows, host, {
+            authUid,
+            groupId,
+            imgFormat: args.imgFormat,
+        });
+        return ymbSuccess('yimiaoban.msg.sync.group', {
+            groupId,
+            total: messages.length,
+            messages,
+            range: { from: args.from, to: args.to, start, end },
+            ...pageMeta(messages, args),
+            ...(actCode === 1303 ? { empty: true, emptyReason: emptyPageNote(args) } : {}),
+        });
+    },
+};
+/** 群置顶消息同步。 */
+const msgTopSync = {
+    name: 'yimiaoban.msg.top.sync',
+    resource: 'msg',
+    method: 'msg.top.sync',
+    action: 'yimiaoban.msg.top.sync',
+    summary: '同步群置顶消息（摘要 + 消息内容）',
+    capability: 'msg',
+    risk: READ,
+    inputSchema: schemaOf({
+        groupId: { type: 'string', pattern: '^\\d+$', description: '群 id（必填）' },
+        msgids: { type: 'array', items: { type: 'string' }, description: '仅同步指定消息 id（缺省=全部置顶）' },
+        encType: { type: 'integer', enum: [0, 1, 2, 3], description: '加密类型（默认 0，不解密）' },
+    }, { required: ['groupId'], description: '同步群置顶消息' }),
+    handler: async (args, { host }) => {
+        const groupId = String(args.groupId);
+        if (!groupId || groupId === '0')
+            throw ymbValidationError('id_invalid', 'groupId 必须非 0');
+        const body = compact({
+            group_id: groupId,
+            enc_type: Number(args.encType ?? 0),
+            msgids: Array.isArray(args.msgids) && args.msgids.length ? args.msgids.map((x) => String(x)) : undefined,
+        });
+        const res = await host.request({
+            method: 'POST',
+            path: '/api/em/msg/executeIm/msg/syncGroupTopMsg',
+            body,
+            operation: 'yimiaoban.msg.top.sync',
+        });
+        assertImOk(res, '同步置顶消息');
+        const inner = unwrapInner(res);
+        const infos = inner?.infos || [];
+        const personIds = infos.map((it) => String(it?.user?.uid ?? '')).filter((x) => x && x !== '0');
+        const personMap = await host.resolveUsersByIds([...new Set(personIds)]);
+        const summary = infos.map((it) => ({
+            msgid: str(it.msgid ?? it.ser_msgid),
+            operator: personMap[str(it.user?.uid)]?.name || str(it.user?.uid),
+            updateTime: formatFullTime(it.update_tm ?? it.time),
+            status: Number(it.status ?? 0),
+            statusNote: Number(it.status) === 1 ? '无权限/已删除' : '正常',
+        }));
+        const topRaw = Array.isArray(inner?.datas) ? inner.datas : [];
+        const messages = await enrichMessages(topRaw, host, {
+            groupId,
+            imgFormat: args.imgFormat,
+            authUid: await resolveAuthUid(host),
+        });
+        return ymbSuccess('yimiaoban.msg.top.sync', {
+            groupId,
+            total: summary.length,
+            infos: summary,
+            messages,
+        });
+    },
+};
+/** 单聊已读状态。 */
+const msgReadSingle = {
+    name: 'yimiaoban.msg.read.single',
+    resource: 'msg',
+    method: 'msg.read.single',
+    action: 'yimiaoban.msg.read.single',
+    summary: '查询单聊消息阅读状态（msgids=自己发出 / recvMsgids=自己接收）',
+    capability: 'msg',
+    risk: READ,
+    inputSchema: schemaOf({
+        toUid: { type: 'string', pattern: '^\\d+$', description: '对方 uid' },
+        toCid: { type: 'string', pattern: '^\\d+$', description: '对方 cid' },
+        msgids: { type: 'array', items: { type: 'string' }, description: '自己发出的消息 id（最多 50）' },
+        recvMsgids: { type: 'array', items: { type: 'string' }, description: '自己接收的消息 id（最多 50）' },
+    }, { required: ['toUid', 'toCid'], description: '查询单聊阅读状态（msgids/recvMsgids 至少其一）' }),
+    handler: async (args, { host }) => {
+        const hasSent = Array.isArray(args.msgids) && args.msgids.length > 0;
+        const hasRecv = Array.isArray(args.recvMsgids) && args.recvMsgids.length > 0;
+        if (!hasSent && !hasRecv)
+            throw ymbValidationError('msgids_required', 'msgids / recvMsgids 至少其一');
+        const body = compact({
+            data: {
+                trans_id: 0,
+                user: { cid: String(args.toCid), uid: String(args.toUid) },
+                msgids: hasSent ? args.msgids.map((x) => String(x)) : undefined,
+                recv_msgids: hasRecv ? args.recvMsgids.map((x) => String(x)) : undefined,
+            },
+        });
+        const res = await host.request({
+            method: 'POST',
+            path: '/api/em/msg/executeIm/msg/getSingleMsgReadStatus',
+            body,
+            operation: 'yimiaoban.msg.read.single',
+        });
+        assertImOk(res, '查询单聊阅读状态');
+        const inner = unwrapInner(res);
+        const datas = inner?.datas || [];
+        const rows = Array.isArray(datas)
+            ? datas.map((d) => ({
+                msgid: str(d.msgid),
+                status: Number(d.status),
+                statusName: Number(d.status) === 1 ? '已读' : '未读',
+                time: formatFullTime(d.time),
+                dev: d.dev,
+            }))
+            : [];
+        return ymbSuccess('yimiaoban.msg.read.single', { total: rows.length, items: rows });
+    },
+};
+/** 群消息已读状态（未读数）。 */
+const msgReadGroup = {
+    name: 'yimiaoban.msg.read.group',
+    resource: 'msg',
+    method: 'msg.read.group',
+    action: 'yimiaoban.msg.read.group',
+    summary: '查询群消息阅读状态汇总（每条消息已读/未读情况，原样输出）',
+    capability: 'msg',
+    risk: READ,
+    inputSchema: schemaOf({
+        groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
+        msgids: { type: 'array', items: { type: 'string' }, description: '自己发出的消息 id（最多 50）' },
+        recvMsgids: { type: 'array', items: { type: 'string' }, description: '别人发出的消息 id（最多 50）' },
+    }, { required: ['groupId'], description: '查询群消息阅读状态' }),
+    handler: async (args, { host }) => {
+        const hasSent = Array.isArray(args.msgids) && args.msgids.length > 0;
+        const hasRecv = Array.isArray(args.recvMsgids) && args.recvMsgids.length > 0;
+        if (!hasSent && !hasRecv)
+            throw ymbValidationError('msgids_required', 'msgids / recvMsgids 至少其一');
+        const body = compact({
+            trans_id: 0,
+            group_id: String(args.groupId),
+            msgids: hasSent ? args.msgids.map((x) => String(x)) : undefined,
+            recv_msgids: hasRecv ? args.recvMsgids.map((x) => String(x)) : undefined,
+        });
+        const res = await host.request({
+            method: 'POST',
+            path: '/api/em/msg/executeIm/msg/getGroupMsgReadStatus',
+            body,
+            operation: 'yimiaoban.msg.read.group',
+        });
+        assertImOk(res, '查询群阅读状态');
+        const inner = unwrapInner(res);
+        return ymbSuccess('yimiaoban.msg.read.group', {
+            groupId: String(args.groupId),
+            raw: Array.isArray(inner) ? inner : inner,
+        });
+    },
+};
+/** 群消息阅读状态详情（谁已读/未读）。 */
+const msgReadGroupDetail = {
+    name: 'yimiaoban.msg.read.group.detail',
+    resource: 'msg',
+    method: 'msg.read.group.detail',
+    action: 'yimiaoban.msg.read.group.detail',
+    summary: '群消息阅读详情（unread/read count + 每人状态），支持分页',
+    capability: 'msg',
+    risk: READ,
+    inputSchema: schemaOf({
+        groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
+        msgid: { type: 'string', pattern: '^\\d+$', description: '消息 id' },
+        pageSize: { type: 'integer', minimum: 1, maximum: 100, description: '分页大小（默认 10）' },
+        pageNum: { type: 'integer', minimum: 1, description: '页码（默认 1）' },
+        ptype: { type: 'integer', description: 'MsgPageType（分页启用时有效）' },
+    }, { required: ['groupId', 'msgid'], description: '群消息阅读详情' }),
+    handler: async (args, { host }) => {
+        const paging = args.pageSize !== undefined || args.pageNum !== undefined;
+        const body = compact({
+            trans_id: 0,
+            group_id: String(args.groupId),
+            msgid: String(args.msgid),
+            page: paging ? { size: Number(args.pageSize ?? 10), num: Number(args.pageNum ?? 1) } : undefined,
+            ptype: paging && args.ptype !== undefined ? Number(args.ptype) : undefined,
+        });
+        const res = await host.request({
+            method: 'POST',
+            path: '/api/em/msg/executeIm/group/syncGroupReadStatus',
+            body,
+            operation: 'yimiaoban.msg.read.group.detail',
+        });
+        assertImOk(res, '同步群阅读详情');
+        const inner = unwrapInner(res);
+        const personIds = (inner?.datas || []).map((d) => String(d?.user?.uid ?? '')).filter((x) => x && x !== '0');
+        const personMap = await host.resolveUsersByIds([...new Set(personIds)]);
+        const rows = (inner?.datas || []).map((d) => ({
+            name: personMap[str(d.user?.uid)]?.name || str(d.user?.uid),
+            uid: str(d.user?.uid),
+            cid: str(d.user?.cid),
+            status: Number(d.status),
+            statusName: Number(d.status) === 1 ? '已读' : '未读',
+            dev: d.dev,
+            time: formatFullTime(d.time),
+        }));
+        return ymbSuccess('yimiaoban.msg.read.group.detail', {
+            groupId: String(args.groupId),
+            msgid: String(args.msgid),
+            unreadCount: inner?.unread_count,
+            readCount: inner?.read_count,
+            endFlag: inner?.end_flag,
+            hasMore: Number(inner?.end_flag) === 1,
+            total: rows.length,
+            items: rows,
+        });
+    },
+};
+export const msgReadOperations = [
+    msgSyncSingle,
+    msgSyncGroup,
+    msgTopSync,
+    msgReadSingle,
+    msgReadGroup,
+    msgReadGroupDetail,
+];
+export { enrichMessages, resolveStartEnd };