@zhin.js/adapter-qq 5.0.0 → 5.0.2

package/lib/src/index.js

@@ -0,0 +1,194 @@
+/**
+ * QQ 官方适配器入口：类型扩展、导出、注册
+ */
+import path from "node:path";
+import { usePlugin, createSceneManagementTools } from "zhin.js";
+import { QQAdapter } from "./adapter.js";
+import { qqGuildPermitResolver, registerQqPlatformPermitChecker, } from "./platform-permit.js";
+import { disposeQqEndpointProvision } from "./qq-endpoint-manager.js";
+import { setQqAgentDeps } from "./qq-agent-deps.js";
+export * from "./types.js";
+export { QQEndpoint } from "./endpoint.js";
+export { QQAdapter } from "./adapter.js";
+export { startQqBindFlow } from "./qq-bind-flow.js";
+export * from "./qq-bind-api.js";
+export { QqEndpointManager, disposeQqEndpointProvision } from "./qq-endpoint-manager.js";
+const plugin = usePlugin();
+const { provide, useContext, onDispose } = plugin;
+useContext("router", (router) => {
+    provide({
+        name: "qq",
+        description: "QQ Official Endpoint Adapter",
+        mounted: async (p) => {
+            const adapter = new QQAdapter(p, router);
+            await adapter.start();
+            return adapter;
+        },
+        dispose: async (adapter) => {
+            await adapter.stop();
+        },
+    });
+});
+useContext('tool', 'qq', (toolService, qq) => {
+    const disposers = [];
+    disposers.push(registerQqPlatformPermitChecker());
+    setQqAgentDeps({
+        getEndpoint: (endpointId) => {
+            const endpoint = qq.endpoints.get(endpointId);
+            if (!endpoint)
+                throw new Error(`Endpoint ${endpointId} 不存在`);
+            return endpoint;
+        },
+        getAdapter: () => qq,
+    });
+    const sceneTools = createSceneManagementTools(qq, 'qq', { permitResolver: qqGuildPermitResolver, registerChecker: false });
+    disposers.push(...sceneTools.map(t => toolService.addTool(t, plugin.name)));
+    return () => disposers.forEach(d => d());
+});
+// ── Web 控制台 ─────────────────────────────────────────────────────────
+useContext("web", (pageManager) => {
+    pageManager.addEntry({
+        id: "qq",
+        development: path.resolve(import.meta.dirname, "../client/index.tsx"),
+        production: path.resolve(import.meta.dirname, "../dist/index.js"),
+        meta: { name: "QQ" },
+    });
+});
+useContext("router", "qq", (router, qq) => {
+    router.get("/api/qq/endpoints", async (ctx) => {
+        try {
+            const endpoints = Array.from(qq.endpoints.values());
+            const result = await Promise.all(endpoints.map(async (endpoint) => {
+                try {
+                    let guildCount = 0;
+                    try {
+                        const guilds = await endpoint.getGuilds();
+                        guildCount = guilds?.length || 0;
+                    }
+                    catch { }
+                    return {
+                        name: endpoint.$config.name,
+                        connected: endpoint.$connected || false,
+                        guildCount,
+                        status: endpoint.$connected ? "online" : "offline",
+                    };
+                }
+                catch {
+                    return { name: endpoint.$config.name, connected: false, guildCount: 0, status: "error" };
+                }
+            }));
+            ctx.body = { success: true, data: result };
+        }
+        catch {
+            ctx.status = 500;
+            ctx.body = { success: false, error: "获取 Endpoint 数据失败" };
+        }
+    });
+    // Endpoint 连接/断开
+    router.post("/api/qq/endpoints/:name/connect", async (ctx) => {
+        try {
+            const endpoint = qq.endpoints.get(ctx.params.name);
+            if (!endpoint) {
+                ctx.status = 404;
+                ctx.body = { success: false, error: "Endpoint 不存在" };
+                return;
+            }
+            if (endpoint.$connected) {
+                ctx.body = { success: true, message: "已经在线" };
+                return;
+            }
+            await endpoint.$connect();
+            ctx.body = { success: true, message: "连接成功" };
+        }
+        catch (e) {
+            ctx.status = 500;
+            ctx.body = { success: false, error: e instanceof Error ? e.message : "连接失败" };
+        }
+    });
+    router.post("/api/qq/endpoints/:name/disconnect", async (ctx) => {
+        try {
+            const endpoint = qq.endpoints.get(ctx.params.name);
+            if (!endpoint) {
+                ctx.status = 404;
+                ctx.body = { success: false, error: "Endpoint 不存在" };
+                return;
+            }
+            if (!endpoint.$connected) {
+                ctx.body = { success: true, message: "已经离线" };
+                return;
+            }
+            await endpoint.$disconnect();
+            ctx.body = { success: true, message: "已断开" };
+        }
+        catch (e) {
+            ctx.status = 500;
+            ctx.body = { success: false, error: e instanceof Error ? e.message : "断开失败" };
+        }
+    });
+    // 频道列表（QQ 官方 API 返回 guild_id/guild_name，归一化为控制台用的 id/name）
+    router.get("/api/qq/endpoints/:name/guilds", async (ctx) => {
+        try {
+            const endpoint = qq.endpoints.get(ctx.params.name);
+            if (!endpoint) {
+                ctx.status = 404;
+                ctx.body = { success: false, error: "Endpoint 不存在" };
+                return;
+            }
+            if (!endpoint.$connected) {
+                ctx.status = 400;
+                ctx.body = { success: false, error: "Endpoint 未连接" };
+                return;
+            }
+            const raw = await endpoint.getGuilds();
+            const guilds = (raw || []).map((g) => ({
+                id: g.guild_id ?? g.id,
+                name: g.guild_name ?? g.name,
+                icon: g.icon,
+                description: g.description,
+                memberCount: g.member_count,
+                ownerId: g.owner_id,
+                owner: g.owner,
+                joinTime: g.join_time,
+            }));
+            ctx.body = { success: true, data: guilds };
+        }
+        catch (e) {
+            ctx.status = 500;
+            ctx.body = { success: false, error: e instanceof Error ? e.message : "获取频道失败" };
+        }
+    });
+    // 子频道列表（QQ 官方 API 返回 channel_id/channel_name，归一化为 id/name）
+    router.get("/api/qq/endpoints/:name/guilds/:guildId/channels", async (ctx) => {
+        try {
+            const endpoint = qq.endpoints.get(ctx.params.name);
+            if (!endpoint) {
+                ctx.status = 404;
+                ctx.body = { success: false, error: "Endpoint 不存在" };
+                return;
+            }
+            if (!endpoint.$connected) {
+                ctx.status = 400;
+                ctx.body = { success: false, error: "Endpoint 未连接" };
+                return;
+            }
+            const raw = await endpoint.getChannels(ctx.params.guildId);
+            const channels = (raw || []).map((ch) => ({
+                id: ch.channel_id ?? ch.id,
+                name: ch.channel_name ?? ch.name,
+                type: ch.type,
+                subType: ch.sub_type,
+                position: ch.position,
+                parentId: ch.parent_id,
+            }));
+            ctx.body = { success: true, data: channels };
+        }
+        catch (e) {
+            ctx.status = 500;
+            ctx.body = { success: false, error: e instanceof Error ? e.message : "获取子频道失败" };
+        }
+    });
+});
+onDispose(() => {
+    disposeQqEndpointProvision();
+});
+//# sourceMappingURL=index.js.map

package/lib/src/index.js.map

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

package/lib/src/mention-enrich.js

@@ -0,0 +1,52 @@
+function mentionWireId(row) {
+    return String(row.id ?? row.member_openid ?? '').trim();
+}
+function mentionWireName(row) {
+    const name = row.username ?? row.nickname;
+    return typeof name === 'string' && name.trim() ? name.trim() : undefined;
+}
+function endpointLookupIds(endpoint) {
+    const cfg = endpoint.$config;
+    return [
+        endpoint.$platformUserId,
+        cfg.appid,
+        cfg.name,
+        endpoint.$id,
+    ].filter((id) => Boolean(id)).map(String);
+}
+function resolveEndpointDisplayName(endpoint) {
+    const cfg = endpoint.$config;
+    return cfg.nickname?.trim() || cfg.name?.trim() || endpoint.$id;
+}
+/** 为 canonical mention 段补齐展示名（平台 payload / endpoint 配置）。 */
+export function enrichCanonicalMentionNames(segments, adapter, wireMentions) {
+    const nameById = new Map();
+    for (const row of wireMentions ?? []) {
+        const id = mentionWireId(row);
+        const name = mentionWireName(row);
+        if (id && name)
+            nameById.set(id, name);
+    }
+    for (const endpoint of adapter.endpoints.values()) {
+        const display = resolveEndpointDisplayName(endpoint);
+        if (!display)
+            continue;
+        for (const id of endpointLookupIds(endpoint)) {
+            if (!nameById.has(id))
+                nameById.set(id, display);
+        }
+    }
+    return segments.map((seg) => {
+        if (seg.type !== 'mention')
+            return seg;
+        const data = seg.data;
+        const target = String(data.target ?? '').trim();
+        if (!target || data.name)
+            return seg;
+        const name = nameById.get(target);
+        if (!name)
+            return seg;
+        return { ...seg, data: { target, name } };
+    });
+}
+//# sourceMappingURL=mention-enrich.js.map

package/lib/src/mention-enrich.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention-enrich.js","sourceRoot":"","sources":["../../src/mention-enrich.ts"],"names":[],"mappings":"AAgBA,SAAS,aAAa,CAAC,GAAgB;IACrC,OAAO,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1D,CAAC;AAED,SAAS,eAAe,CAAC,GAAgB;IACvC,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,CAAC;IAC1C,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAwB;IACjD,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC;IAC7B,OAAO;QACL,QAAQ,CAAC,eAAe;QACxB,GAAG,CAAC,KAAK;QACT,GAAG,CAAC,IAAI;QACR,QAAQ,CAAC,GAAG;KACb,CAAC,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,0BAA0B,CAAC,QAAwB;IAC1D,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC;IAC7B,OAAO,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,QAAQ,CAAC,GAAG,CAAC;AAClE,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,2BAA2B,CACzC,QAAmB,EACnB,OAAkB,EAClB,YAA4B;IAE5B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,YAAY,IAAI,EAAE,EAAE,CAAC;QACrC,MAAM,EAAE,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,EAAE,IAAI,IAAI;YAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;QAClD,MAAM,OAAO,GAAG,0BAA0B,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,KAAK,MAAM,EAAE,IAAI,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAC1B,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,GAAG,CAAC;QACvC,MAAM,IAAI,GAAG,GAAG,CAAC,IAA0C,CAAC;QAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAChD,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO,GAAG,CAAC;QACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI;YAAE,OAAO,GAAG,CAAC;QACtB,OAAO,EAAE,GAAG,GAAG,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/lib/src/outbound-keyboard.js

@@ -0,0 +1,100 @@
+/**
+ * 将 core keyboard 段转为 qq-official-bot 可识别的 button / markdown 段。
+ * @see https://bot.q.qq.com/wiki/develop/api-v2/server-inter/message/trans/msg-btn.html
+ */
+import { isKeyboardSegment, KeyboardSegment } from 'zhin.js';
+function asKeyboardData(item) {
+    if (item instanceof KeyboardSegment)
+        return item.data;
+    if (item != null && typeof item === "object" && isKeyboardSegment(item)) {
+        return item.data;
+    }
+    return null;
+}
+function coreButtonToQq(btn) {
+    const isCommand = btn.mode === 'command';
+    const action = {
+        type: isCommand ? 2 : 1,
+        permission: { type: 2 },
+        data: btn.payload,
+        click_limit: btn.disabled ? 0 : 10,
+        unsupport_tips: btn.disabled ? "该按钮不可用" : "",
+    };
+    if (isCommand) {
+        if (btn.command?.enter != null)
+            action.enter = btn.command.enter;
+        if (btn.command?.reply != null)
+            action.reply = btn.command.reply;
+    }
+    return {
+        id: btn.id,
+        render_data: {
+            label: btn.label,
+            visited_label: btn.label,
+            style: 0,
+        },
+        action,
+    };
+}
+function keyboardDataToQqSegments(data) {
+    const out = [];
+    for (const row of data.rows) {
+        out.push({
+            type: "button",
+            data: {
+                buttons: row.map(coreButtonToQq),
+            },
+        });
+    }
+    return out;
+}
+/** QQ 官方出站：keyboard → button 行；前置 text 合并为 markdown（按钮消息需带 markdown） */
+export function expandKeyboardSegmentsForQq(content) {
+    const items = Array.isArray(content) ? content : [content];
+    const out = [];
+    const textParts = [];
+    for (const item of items) {
+        if (typeof item === "string") {
+            textParts.push(item);
+            continue;
+        }
+        const keyboardData = asKeyboardData(item);
+        if (keyboardData) {
+            if (textParts.length > 0) {
+                out.push({
+                    type: "markdown",
+                    data: { content: textParts.join("\n") },
+                });
+                textParts.length = 0;
+            }
+            out.push(...keyboardDataToQqSegments(keyboardData));
+            continue;
+        }
+        if (item.type === "text") {
+            const t = item.data?.text ?? item.data?.content ?? "";
+            if (t)
+                textParts.push(String(t));
+            continue;
+        }
+        if (textParts.length > 0) {
+            out.push({
+                type: "markdown",
+                data: { content: textParts.join("\n") },
+            });
+            textParts.length = 0;
+        }
+        out.push(item);
+    }
+    if (textParts.length > 0) {
+        out.push({
+            type: "markdown",
+            data: { content: textParts.join("\n") },
+        });
+    }
+    if (out.length === 0)
+        return { type: "text", data: { text: "" } };
+    if (out.length === 1)
+        return out[0];
+    return out;
+}
+//# sourceMappingURL=outbound-keyboard.js.map

package/lib/src/outbound-keyboard.js.map

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

package/lib/src/outbound-markdown.js

@@ -0,0 +1,189 @@
+/**
+ * 将 AI 出站纯文本段合并为 QQ Markdown 消息（msg_type=2）。
+ * 图文混排时合并为单条 Markdown（图片语法见 QQ 官方文档）。
+ */
+import { segment } from "zhin.js";
+import { resolveMediaFile } from "./outbound-media.js";
+function isMessageSegment(seg) {
+    return typeof seg.type === "string";
+}
+const BLOCKING_RICH_TYPES = new Set([
+    "audio",
+    "video",
+    "file",
+    "markdown",
+    "ark",
+    "embed",
+    "keyboard",
+    "button",
+    "face",
+]);
+const TEXT_IMAGE_MIX_TYPES = new Set(["text", "at", "image"]);
+function textSegment(text) {
+    return { type: "text", data: { text } };
+}
+export function asOutboundSegments(content) {
+    if (typeof content === "string")
+        return [textSegment(content)];
+    if (!Array.isArray(content)) {
+        return isMessageSegment(content) ? [content] : [];
+    }
+    return content.flatMap((item) => typeof item === "string" ? [textSegment(item)] : isMessageSegment(item) ? [item] : []);
+}
+export function splitReplyPrefix(segments) {
+    const prefix = [];
+    let i = 0;
+    while (i < segments.length && segments[i].type === "reply") {
+        prefix.push(segments[i]);
+        i++;
+    }
+    return { prefix, body: segments.slice(i) };
+}
+function textFromSegment(seg) {
+    if (seg.type !== "text")
+        return "";
+    return seg.data.text ?? seg.data.content ?? "";
+}
+function isRemoteUrl(value) {
+    return /^https?:\/\//i.test(value);
+}
+function isInlineMedia(value) {
+    return value.startsWith("base64://")
+        || /^data:[^/]+\/[^;]+;base64,/i.test(value)
+        || value.startsWith("file://")
+        || (value.startsWith("/") && !isRemoteUrl(value));
+}
+/** QQ Markdown 图片语法：![说明 #宽 #高](公网 URL) */
+export function formatQqMarkdownImage(url, data = {}) {
+    const width = typeof data.width === "number" && data.width > 0 ? data.width : 200;
+    const height = typeof data.height === "number" && data.height > 0 ? data.height : width;
+    const label = typeof data.name === "string" && data.name.trim() ? data.name.trim() : "图片";
+    return `![${label} #${width}px #${height}px](${url})`;
+}
+/** 将 image 段解析为 Markdown 可嵌入的 URL（https 或 data URI） */
+export function resolveImageMarkdownUrl(data) {
+    const url = typeof data.url === "string" ? data.url : undefined;
+    const file = resolveMediaFile(data);
+    if (url && isRemoteUrl(url))
+        return url;
+    if (file && isRemoteUrl(file))
+        return file;
+    const inline = file ?? (url && isInlineMedia(url) ? url : undefined);
+    if (!inline)
+        return null;
+    if (inline.startsWith("base64://")) {
+        return `data:image/png;base64,${inline.slice(9)}`;
+    }
+    if (/^data:[^/]+\/[^;]+;base64,/i.test(inline)) {
+        return inline;
+    }
+    return null;
+}
+export function isTextImageMixedBody(body) {
+    if (body.length === 0)
+        return false;
+    if (body.some((seg) => !TEXT_IMAGE_MIX_TYPES.has(seg.type)))
+        return false;
+    const hasImage = body.some((seg) => seg.type === "image");
+    const hasText = body.some((seg) => seg.type === "text" || seg.type === "at");
+    return hasImage && hasText;
+}
+/** 图文混排且含 base64/本地图（无法直接嵌入 Markdown 公网 URL） */
+export function isTextImageMixedWithInlineMedia(body) {
+    if (!isTextImageMixedBody(body))
+        return false;
+    return body.some((seg) => {
+        if (seg.type !== "image")
+            return false;
+        const url = typeof seg.data.url === "string" ? seg.data.url : undefined;
+        const file = resolveMediaFile(seg.data);
+        if (url && isRemoteUrl(url))
+            return false;
+        if (file && isRemoteUrl(file))
+            return false;
+        return Boolean(resolveMediaFile(seg.data) || (url && isInlineMedia(url)));
+    });
+}
+function segmentToMarkdownPart(seg) {
+    if (seg.type === "text")
+        return textFromSegment(seg);
+    if (seg.type === "at")
+        return `<@${String(seg.data.user_id ?? "")}>`;
+    if (seg.type === "image") {
+        const src = resolveImageMarkdownUrl(seg.data);
+        return src ? formatQqMarkdownImage(src, seg.data) : "";
+    }
+    return "";
+}
+function shouldConvertTextOnly(mode, bodyText) {
+    if (mode === false)
+        return false;
+    if (mode === true)
+        return bodyText.trim().length > 0;
+    return hasMarkdownHint(bodyText);
+}
+function hasMarkdownHint(text) {
+    if (text.includes('**') || text.includes('__') || text.includes('`'))
+        return true;
+    if (text.includes('](') || text.includes('|'))
+        return true;
+    return text.split('\n').some((line) => {
+        const trimmed = line.trimStart();
+        return trimmed.startsWith('# ') || trimmed.startsWith('## ')
+            || trimmed.startsWith('> ')
+            || trimmed.startsWith('- ')
+            || trimmed.startsWith('* ')
+            || trimmed.startsWith('+ ');
+    });
+}
+function mergeTextImageToMarkdown(prefix, body) {
+    if (body.some((seg) => seg.type === "image" && !resolveImageMarkdownUrl(seg.data))) {
+        return null;
+    }
+    const merged = body.map(segmentToMarkdownPart).join("");
+    if (!merged.trim())
+        return null;
+    return [...prefix, segment("markdown", { content: merged })];
+}
+/**
+ * 出站归一化：保留 leading `reply`，将连续 text 或 text+image 合并为单条 markdown 段。
+ * 含内联 base64 图的图文混排须走 outbound-mixed-media（msg_type=7），此处不处理。
+ */
+export function normalizeOutboundMarkdown(content, mode = "auto") {
+    const segments = asOutboundSegments(content);
+    if (segments.length === 0)
+        return content;
+    const { prefix, body } = splitReplyPrefix(segments);
+    if (body.length === 0)
+        return content;
+    if (mode === false)
+        return content;
+    if (body.some((seg) => BLOCKING_RICH_TYPES.has(seg.type))) {
+        return content;
+    }
+    if (body.some((seg) => seg.type === "markdown")) {
+        return content;
+    }
+    if (isTextImageMixedBody(body)) {
+        if (isTextImageMixedWithInlineMedia(body)) {
+            return content;
+        }
+        const mixed = mergeTextImageToMarkdown(prefix, body);
+        return mixed ?? content;
+    }
+    if (body.some((seg) => seg.type === "image")) {
+        return content;
+    }
+    if (body.some((seg) => seg.type !== "text" && seg.type !== "at")) {
+        return content;
+    }
+    const merged = body
+        .map((seg) => (seg.type === "at"
+        ? `<@${String(seg.data.user_id ?? "")}>`
+        : textFromSegment(seg)))
+        .join("");
+    if (!shouldConvertTextOnly(mode, merged))
+        return content;
+    return [...prefix, segment("markdown", { content: merged })];
+}
+//# sourceMappingURL=outbound-markdown.js.map

package/lib/src/outbound-markdown.js.map

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

package/lib/{outbound-media.js → src/outbound-media.js}

@@ -8,7 +8,8 @@ function isRemoteUrl(value) {
 function isInlineBase64(value) {
     return value.startsWith("base64://") || /^data:[^/]+\/[^;]+;base64,/i.test(value);
 }
-function resolveMediaFile(data) {
+/** 解析 image/audio/video/file 段的本地或内联 payload（供 mixed-media 上传复用） */
+export function resolveMediaFile(data) {
     const url = typeof data.url === "string" ? data.url : undefined;
     const file = typeof data.file === "string" ? data.file : undefined;
     const base64 = typeof data.base64 === "string" ? data.base64 : undefined;

package/lib/src/outbound-media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-media.js","sourceRoot":"","sources":["../../src/outbound-media.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAEjE,SAAS,gBAAgB,CAAC,GAAmB;IAC3C,OAAO,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC;AACtC,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,OAAO,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,6BAA6B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACpF,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,gBAAgB,CAAC,IAA6B;IAC5D,MAAM,GAAG,GAAG,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IAChE,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACnE,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAEzE,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,IAAI,GAAG,IAAI,cAAc,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAC3C,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAAE,OAAO,GAAG,CAAC;IAC/F,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,MAAM,EAAE,CAAC;IAClF,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,qBAAqB,CAAC,GAAmB;IAChD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC;IAE3C,MAAM,IAAI,GAAG,EAAE,GAAG,GAAG,CAAC,IAAI,EAA6B,CAAC;IACxD,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,IAAI;QAAE,OAAO,GAAG,CAAC;IAEtB,OAAO,IAAI,CAAC,GAAG,CAAC;IAChB,OAAO,IAAI,CAAC,MAAM,CAAC;IACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACjB,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAoB,CAAC;AACpD,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,sBAAsB,CAAC,OAAoB;IACzD,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAC9E,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC1B,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC1C,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACrE,CAAC,CAAC,CAAC;AACL,CAAC"}