@cubeai/dsh-feishu-channels 0.0.0-stage → 0.2.0

package/src/engine/choice-delivery.js

@@ -0,0 +1,20 @@
+/** 平台已拒绝与网络结果未知必须区分，后者不能自动补发相同卡片。 */
+export class ChoiceSendError extends Error {
+    reason;
+    constructor(reason) {
+        super(reason);
+        this.reason = reason;
+        this.name = 'ChoiceSendError';
+    }
+}
+export function choiceSendError(error) {
+    if (error instanceof ChoiceSendError)
+        return error;
+    const value = error;
+    const status = value?.status ?? value?.response?.status;
+    if (status === 401 || status === 403)
+        return new ChoiceSendError('permission-denied');
+    if (value?.rejected || (typeof status === 'number' && status >= 400 && status < 500 && status !== 408))
+        return new ChoiceSendError('rejected');
+    return new ChoiceSendError('delivery-unknown');
+}

package/src/engine/choices.js

@@ -0,0 +1,103 @@
+import { randomUUID } from 'node:crypto';
+import { replyText } from './command-locale.js';
+import { ChoiceSendError } from './choice-delivery.js';
+/** 所有按钮只携带随机索引；服务端保留动作，并绑定账号、聊天、操作者和会话。 */
+export class ChoiceStore {
+    log;
+    entries = new Map();
+    scopes = new Map();
+    constructor(log = () => { }) {
+        this.log = log;
+    }
+    close(entry, text) {
+        if (entry.closedText)
+            return;
+        entry.closedText = text;
+        if (entry.receipt)
+            void Promise.resolve().then(() => entry.receipt.close(text)).catch(() => this.log('[choices] 原卡片更新失败；操作不会重试，请查看后续回复'));
+    }
+    retire(token, text) {
+        const entry = this.entries.get(token);
+        if (!entry)
+            return;
+        this.entries.delete(token);
+        if (this.scopes.get(entry.key) === token)
+            this.scopes.delete(entry.key);
+        this.close(entry, text ?? entry.expiredText);
+    }
+    key(channel, msg) { return JSON.stringify([channel, msg.kind ?? 'dm', msg.chatId, msg.userId ?? '']); }
+    clear(channel) {
+        for (const [token, entry] of this.entries)
+            if (!channel || JSON.parse(entry.key)[0] === channel)
+                this.retire(token);
+    }
+    async show(channel, msg, text, choices, session, valid = () => true, hint = replyText('点击选项或回复序号；15 分钟内有效，普通文字退出菜单。'), allowNumber = true) {
+        const key = this.key(channel.id, msg);
+        const previous = this.scopes.get(key);
+        if (previous)
+            this.retire(previous);
+        for (const [token, entry] of this.entries)
+            if (entry.expires <= Date.now())
+                this.retire(token);
+        if (this.entries.size >= 512)
+            this.retire(this.entries.keys().next().value);
+        const token = randomUUID();
+        // 回调与停用可能发生在语言作用域外，收口文案沿用发送时的卡片语言。
+        const entry = { key, session, expires: Date.now() + 15 * 60_000, choices, valid, allowNumber,
+            expiredText: replyText('此卡片已失效，请打开新的 /menu。'),
+            selectedTexts: choices.map(choice => replyText('已选择：{0}。此卡片已结束，请查看后续操作结果。', choice.label)),
+        };
+        this.entries.set(token, entry);
+        this.scopes.set(key, token);
+        const textHint = allowNumber ? replyText('回复序号或发送对应命令；15 分钟内有效，普通文字退出菜单。') : replyText('发送对应命令即可操作，普通文字继续聊天。');
+        // 只省略调用方已写入正文的选项；新增的多选提交项仍沿用原按钮编号。
+        const textChoices = choices.map((choice, index) => ({ choice, index })).filter(({ choice }) => !choice.textIncluded);
+        const body = [text, textChoices.map(({ choice, index }) => `${allowNumber ? `${index + 1}. ` : ''}${choice.label}${choice.value.startsWith('/') ? ` — ${choice.displayValue ?? choice.value}` : ''}`).join('\n'), textHint].filter(Boolean).join('\n\n');
+        const cardBody = allowNumber ? [text, textChoices.map(({ choice, index }) => `${index + 1}. ${choice.label}`).join('\n'), hint].filter(Boolean).join('\n\n') : text + '\n\n' + replyText('点击下方按钮选择操作；15 分钟内有效，普通文字继续聊天。');
+        if (channel.sendChoices && (!channel.choiceLimits || (choices.length <= channel.choiceLimits.maxButtons && cardBody.length <= channel.choiceLimits.maxTextLength))) {
+            try {
+                const receipt = await channel.sendChoices(msg, cardBody, choices.map((choice, i) => ({ label: choice.label, token: `${token}:${i}` })), { numberedChoicesIncluded: allowNumber });
+                entry.receipt = receipt && typeof receipt.close === 'function' ? receipt : undefined;
+                // 点击可能早于发送回执到达；补齐原卡片的失效状态。
+                if (entry.closedText && entry.receipt)
+                    void Promise.resolve().then(() => entry.receipt.close(entry.closedText)).catch(() => this.log('[choices] 原卡片更新失败；操作不会重试，请查看后续回复'));
+                return '';
+            }
+            catch (error) {
+                const reason = error instanceof ChoiceSendError ? error.reason : 'send-failed';
+                this.log(`[choices] channel=${channel.id} reason=${reason} buttons=${choices.length} chars=${cardBody.length}`);
+                if (reason === 'delivery-unknown')
+                    return replyText('卡片发送状态暂时无法确认。若已收到，请直接使用；未收到可发送 /menu 重试。');
+            }
+        }
+        else {
+            this.log(`[choices] channel=${channel.id} reason=${!channel.sendChoices ? 'native-unavailable' : choices.length > channel.choiceLimits.maxButtons ? 'button-limit' : 'text-limit'} buttons=${choices.length} chars=${cardBody.length}`);
+        }
+        return body;
+    }
+    resolve(channel, msg, session, allowNumber = true) {
+        const key = this.key(channel, msg);
+        const explicit = msg.actionToken;
+        const token = explicit?.split(':')[0] ?? this.scopes.get(key);
+        if (!token)
+            return explicit ? '' : undefined;
+        const entry = this.entries.get(token);
+        const numeric = allowNumber && entry?.allowNumber && /^\d+$/.test(msg.text.trim());
+        if (!explicit && !numeric) {
+            if (!msg.text.startsWith('/'))
+                this.retire(token);
+            return undefined;
+        }
+        if (!entry || entry.key !== key || entry.session !== session)
+            return '';
+        if (entry.expires <= Date.now() || !entry.valid()) {
+            this.retire(token);
+            return '';
+        }
+        const index = explicit ? Number(explicit.split(':')[1]) : Number(msg.text.trim()) - 1;
+        if (!Number.isSafeInteger(index) || index < 0 || !entry.choices[index])
+            return '';
+        this.retire(token, entry.selectedTexts[index]);
+        return entry.choices[index].value;
+    }
+}

package/src/engine/command-locale.js

@@ -0,0 +1,70 @@
+/** 与网页共用宿主保存的语言偏好；IM 无浏览器语言时兼容默认中文。 */
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { commandEnglish } from './command-messages.js';
+const localeScope = new AsyncLocalStorage();
+function isLocaleDocument(row) {
+    const ns = String(row?.ns ?? row?.id ?? row?.namespace ?? '');
+    return ns === 'locale' || /(^|[./-])locale$/i.test(ns);
+}
+function readHostPreference(host) {
+    const settings = host.get('settings');
+    if (typeof settings?.get === 'function') {
+        const preference = settings.get('locale')?.preference;
+        if (preference !== undefined)
+            return preference;
+    }
+    if (typeof settings?.describe === 'function') {
+        for (const row of settings.describe() ?? []) {
+            if (!isLocaleDocument(row))
+                continue;
+            const value = row?.value?.preference ?? row?.value?.locale;
+            if (typeof value === 'string')
+                return value;
+        }
+    }
+    const locale = host.get('locale');
+    return locale?.preference ?? locale?.current;
+}
+export function withReplyLocale(host, run) {
+    let locale = 'zh';
+    try {
+        const preference = readHostPreference(host);
+        if (typeof preference === 'string' && /^en(?:-|$)/i.test(preference))
+            locale = 'en';
+    }
+    catch { /* 语言服务不可用不能阻止命令执行，保留既有中文默认。 */ }
+    return localeScope.run(locale, run);
+}
+export function replyText(key, ...values) {
+    const template = localeScope.getStore() === 'en' ? commandEnglish[key] : key;
+    // 一次替换，用户内容中的占位符、命令和路径不再次解析。
+    return template.replace(/\{(\d+)\}/g, (token, index) => Number(index) < values.length ? String(values[Number(index)]) : token);
+}
+/** 按宿主已保存的全局语言取一条用户可见提示。 */
+export function notice(host, key, ...values) {
+    return withReplyLocale(host, () => replyText(key, ...values));
+}
+/** 渠道没有宿主时保持中文，避免测试夹具改变既有文案。 */
+export function channelNotice(host, key, ...values) {
+    return host ? notice(host, key, ...values) : replyText(key, ...values);
+}
+function isNoticeKey(value) {
+    return Object.prototype.hasOwnProperty.call(commandEnglish, value);
+}
+/** 渠道失败分类是用户可见文案；动态 HTTP 状态单独套模板，未知分类保持原样以免丢信息。 */
+export function localizeReason(host, reason) {
+    const http = /^下载服务器返回 HTTP (\d+)$/.exec(reason);
+    if (http)
+        return channelNotice(host, '下载服务器返回 HTTP {0}', http[1]);
+    const unavailable = /^下载服务器暂时不可用（HTTP (\d+)）$/.exec(reason);
+    if (unavailable)
+        return channelNotice(host, '下载服务器暂时不可用（HTTP {0}）', unavailable[1]);
+    return isNoticeKey(reason) ? channelNotice(host, reason) : reason;
+}
+/** 渠道 status() 仍返回中文，供设置页映射；机器人回复时再按已保存语言翻译。未知状态保持原文。 */
+export function localizeStatus(host, status) {
+    const disconnected = /^已断开（code (\d+)）$/.exec(status);
+    if (disconnected)
+        return channelNotice(host, '已断开（code {0}）', disconnected[1]);
+    return isNoticeKey(status) ? channelNotice(host, status) : status;
+}