@sfmc-bds/qq-bridge 0.1.0

package/README.md

@@ -0,0 +1,21 @@
+# @sfmc-bds/qq-bridge
+
+SFMC QQ ↔ MC 桥接：LLBot OneBot 11 reverse-WS（端口 3002），将群消息转发至 db-server。
+
+## 安装
+
+```bash
+npm install @sfmc-bds/qq-bridge
+node node_modules/@sfmc-bds/qq-bridge/dist/index.js
+```
+
+通常由 `@sfmc-bds/cli` 或 SEA 包统一拉起。
+
+## 依赖
+
+- `@sfmc-bds/sdk` ^0.1.0
+- Node.js >= 22.13
+
+## 仓库
+
+<https://github.com/DogeLakeDev/ScriptsForMinecraftServer/tree/main/qq-bridge>

package/dist/config.d.ts

@@ -0,0 +1,20 @@
+/**
+ * config.ts — 加载 configs/qq_config.json
+ *
+ * 行为与旧 index.js 保持完全一致:
+ *   - 文件不存在或解析失败: 进程退出 (旧版 process.exit(1))
+ *   - 字段缺失: 走默认值
+ *   - reload 时仅覆盖原对象 (mutate), 保留运行时引用的同一份对象
+ */
+import type { QQBridgeConfig } from "./types.js";
+/** 统一通过 SDK 解析项目根:env SFMC_ROOT > __dirname 上溯。SEA / npm 一致。 */
+export declare const ROOT_DIR: string;
+export declare const CFG_PATH: string;
+/** 进程启动时加载一次。失败直接退出,与旧实现一致。 */
+export declare function loadInitialConfig(): QQBridgeConfig;
+/**
+ * 重新读取配置文件,合并到传入对象上 (mutate)。
+ * 旧实现是 Object.assign(cfg, newCfg),保留运行时对原 cfg 对象的引用 — 同样行为。
+ */
+export declare function reloadInto(cfg: QQBridgeConfig): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKjD,gEAAgE;AAChE,eAAO,MAAM,QAAQ,EAAE,MAA2D,CAAC;AACnF,eAAO,MAAM,QAAQ,EAAE,MAA+C,CAAC;AAqBvE,+BAA+B;AAC/B,wBAAgB,iBAAiB,IAAI,cAAc,CAOlD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAQpD"}

package/dist/config.js

@@ -0,0 +1,60 @@
+/**
+ * config.ts — 加载 configs/qq_config.json
+ *
+ * 行为与旧 index.js 保持完全一致:
+ *   - 文件不存在或解析失败: 进程退出 (旧版 process.exit(1))
+ *   - 字段缺失: 走默认值
+ *   - reload 时仅覆盖原对象 (mutate), 保留运行时引用的同一份对象
+ */
+import { configPath, readJson, resolveRuntimeRoot } from "@sfmc-bds/sdk/node/config";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { log } from "./log.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/** 统一通过 SDK 解析项目根:env SFMC_ROOT > __dirname 上溯。SEA / npm 一致。 */
+export const ROOT_DIR = resolveRuntimeRoot(resolve(__dirname, "..", ".."));
+export const CFG_PATH = configPath(ROOT_DIR, "qq_config.json");
+function applyDefaults(raw) {
+    return {
+        qq_enabled: raw.qq_enabled !== false,
+        qq_ws_port: parseInt(String(raw.qq_ws_port ?? "3002"), 10),
+        qq_group_id: String(raw.qq_group_id ?? ""),
+        bridge_channel_id: String(raw.bridge_channel_id ?? ""),
+        db_host: String(raw.db_host ?? "127.0.0.1"),
+        db_port: parseInt(String(raw.db_port ?? "3001"), 10),
+        mctoqq_prefix: String(raw.mctoqq_prefix ?? "[MC]"),
+        ...raw,
+    };
+}
+function readFromDisk() {
+    const raw = readJson(CFG_PATH);
+    if (!raw)
+        throw new Error(`配置文件不存在或无法解析: ${CFG_PATH}`);
+    return applyDefaults(raw);
+}
+/** 进程启动时加载一次。失败直接退出,与旧实现一致。 */
+export function loadInitialConfig() {
+    try {
+        return readFromDisk();
+    }
+    catch (e) {
+        log.error(`无法读取配置: ${CFG_PATH}: ${e.message}`);
+        process.exit(1);
+    }
+}
+/**
+ * 重新读取配置文件,合并到传入对象上 (mutate)。
+ * 旧实现是 Object.assign(cfg, newCfg),保留运行时对原 cfg 对象的引用 — 同样行为。
+ */
+export function reloadInto(cfg) {
+    try {
+        const fresh = readFromDisk();
+        Object.assign(cfg, fresh);
+    }
+    catch (e) {
+        // reload 失败不抛,旧实现也是只 log
+        log.error(`重载配置失败: ${e.message}`);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAG/B,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,gEAAgE;AAChE,MAAM,CAAC,MAAM,QAAQ,GAAW,kBAAkB,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AACnF,MAAM,CAAC,MAAM,QAAQ,GAAW,UAAU,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;AAEvE,SAAS,aAAa,CAAC,GAA4B;IACjD,OAAO;QACL,UAAU,EAAE,GAAG,CAAC,UAAU,KAAK,KAAK;QACpC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QAC1D,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;QAC1C,iBAAiB,EAAE,MAAM,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC;QACtD,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,WAAW,CAAC;QAC3C,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACpD,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,aAAa,IAAI,MAAM,CAAC;QAClD,GAAG,GAAG;KACP,CAAC;AACJ,CAAC;AAED,SAAS,YAAY;IACnB,MAAM,GAAG,GAAG,QAAQ,CAA0B,QAAQ,CAAC,CAAC;IACxD,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC;IACvD,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED,+BAA+B;AAC/B,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC;QACH,OAAO,YAAY,EAAE,CAAC;IACxB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,GAAG,CAAC,KAAK,CAAC,WAAW,QAAQ,KAAM,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,GAAmB;IAC5C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,yBAAyB;QACzB,GAAG,CAAC,KAAK,CAAC,WAAY,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}

package/dist/console.d.ts

@@ -0,0 +1,22 @@
+/**
+ * console.ts — 交互式控制台 (readline)
+ *
+ * 命令:
+ *   help    显示帮助
+ *   reload  重新读取 configs/qq_config.json
+ *   status  显示当前状态
+ *   stop    退出进程
+ *
+ * 行为与旧实现完全一致。
+ */
+import type { QQBridgeConfig } from "./types.js";
+export interface ConsoleOptions {
+    config: QQBridgeConfig;
+    initialEnabled: boolean;
+    wsPort: number;
+    botSelfIdRef: {
+        value: string | null;
+    };
+}
+export declare function startConsole(opts: ConsoleOptions): void;
+//# sourceMappingURL=console.d.ts.map

package/dist/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../src/console.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CACxC;AA8DD,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAKvD"}

package/dist/console.js

@@ -0,0 +1,76 @@
+/**
+ * console.ts — 交互式控制台 (readline)
+ *
+ * 命令:
+ *   help    显示帮助
+ *   reload  重新读取 configs/qq_config.json
+ *   status  显示当前状态
+ *   stop    退出进程
+ *
+ * 行为与旧实现完全一致。
+ */
+import { createInterface } from "node:readline";
+import { log } from "./log.js";
+import { reloadInto } from "./config.js";
+function showHelp() {
+    console.log("可用命令:");
+    console.log("  help    — 显示本帮助");
+    console.log("  reload  — 重新读取 qq_config.json");
+    console.log("  status  — 显示当前状态");
+    console.log("  stop    — 停止服务");
+}
+function showStatus(opts) {
+    const { config: cfg, initialEnabled, wsPort, botSelfIdRef } = opts;
+    console.log("=== QQBridge 状态 ===");
+    console.log(`  启用:        ${initialEnabled}`);
+    console.log(`  WS 端口:     ${wsPort}`);
+    console.log(`  LLBot HTTP:  (db-server 直连,不经过本进程)`);
+    console.log(`  QQ 群:       ${cfg.qq_group_id || "未配置"}`);
+    console.log(`  Channel:     ${cfg.bridge_channel_id || "未配置"}`);
+    console.log(`  db-server:   ${cfg.db_host}:${cfg.db_port}`);
+    console.log(`  Bot self_id: ${botSelfIdRef.value || "未捕获"}`);
+    console.log(`  MC→QQ 前缀:  ${cfg.mctoqq_prefix}`);
+}
+function handleCommand(line, opts, rl) {
+    const cmd = line.trim().toLowerCase();
+    switch (cmd) {
+        case "help":
+            showHelp();
+            return false;
+        case "reload": {
+            const before = {
+                qq_group_id: opts.config.qq_group_id,
+                bridge_channel_id: opts.config.bridge_channel_id,
+                db_host: opts.config.db_host,
+                db_port: opts.config.db_port,
+            };
+            reloadInto(opts.config);
+            log.info(`配置已重载 (qq_group_id=${opts.config.qq_group_id}, channel=${opts.config.bridge_channel_id}, db=${opts.config.db_host}:${opts.config.db_port})`);
+            // 静默消费未使用变量警告
+            void before;
+            return false;
+        }
+        case "status":
+            showStatus(opts);
+            return false;
+        case "stop":
+        case "exit":
+        case "quit":
+            log.info("正在停止...");
+            rl.close();
+            process.exit(0);
+            return true; // 不可达,但满足 noImplicitReturns
+        case "":
+            return false;
+        default:
+            log.info(`未知命令: ${cmd} (输入 help 查看帮助)`);
+            return false;
+    }
+}
+export function startConsole(opts) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    rl.on("line", (line) => {
+        handleCommand(line, opts, rl);
+    });
+}
+//# sourceMappingURL=console.js.map

package/dist/console.js.map

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

package/dist/dbserver.d.ts

@@ -0,0 +1,19 @@
+/**
+ * dbserver.ts — 转发 OneBot 群消息到 db-server /api/sfmc/messages
+ *
+ * 与旧实现保持行为一致: 仅 POST 200 视为成功,否则抛错; 失败不重试 (主流程不阻塞)。
+ * 超时: 与 db-server 内部 HTTP 风格一致,使用 req.on("timeout") + req.destroy。
+ */
+export interface DBServerConfig {
+    host: string;
+    port: number;
+    channelId: string;
+}
+/**
+ * 构造一条 IncomingChatMessage 并 POST 到 db-server。
+ * fromid 形如 `qq_<user_id>`,与旧实现保持完全一致。
+ */
+export declare function forwardGroupMessage(cfg: DBServerConfig, fromId: string, fromName: string, content: string, now?: number): Promise<void>;
+/** 包装 try/catch,失败仅 log (与旧实现一致,不抛给主循环)。 */
+export declare function tryForward(cfg: DBServerConfig, fromId: string, fromName: string, content: string): Promise<void>;
+//# sourceMappingURL=dbserver.d.ts.map

package/dist/dbserver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dbserver.d.ts","sourceRoot":"","sources":["../src/dbserver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AA+CD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,MAAmB,GACvB,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,4CAA4C;AAC5C,wBAAsB,UAAU,CAC9B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/dbserver.js

@@ -0,0 +1,83 @@
+/**
+ * dbserver.ts — 转发 OneBot 群消息到 db-server /api/sfmc/messages
+ *
+ * 与旧实现保持行为一致: 仅 POST 200 视为成功,否则抛错; 失败不重试 (主流程不阻塞)。
+ * 超时: 与 db-server 内部 HTTP 风格一致,使用 req.on("timeout") + req.destroy。
+ */
+import { request as httpRequest } from "node:http";
+import { log } from "./log.js";
+const REQUEST_TIMEOUT_MS = 5_000;
+function postJSON(url, body, timeoutMs) {
+    const payload = JSON.stringify(body);
+    const options = {
+        hostname: url.hostname,
+        port: url.port || "3001",
+        path: url.pathname,
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "Content-Length": Buffer.byteLength(payload),
+        },
+        timeout: timeoutMs,
+    };
+    return new Promise((resolve, reject) => {
+        const req = httpRequest(options, (res) => {
+            let buf = "";
+            res.setEncoding("utf-8");
+            res.on("data", (chunk) => {
+                buf += chunk;
+            });
+            res.on("end", () => {
+                const code = res.statusCode ?? 0;
+                if (code >= 200 && code < 300) {
+                    try {
+                        resolve(JSON.parse(buf));
+                    }
+                    catch {
+                        // 允许返回非 JSON: 仍视为成功,作为 void 抛出
+                        resolve(buf);
+                    }
+                }
+                else {
+                    reject(new Error(`db-server ${code}: ${buf.slice(0, 200)}`));
+                }
+            });
+        });
+        req.on("timeout", () => {
+            req.destroy(new Error(`db-server 超时 ${timeoutMs}ms`));
+        });
+        req.on("error", reject);
+        req.write(payload);
+        req.end();
+    });
+}
+/**
+ * 构造一条 IncomingChatMessage 并 POST 到 db-server。
+ * fromid 形如 `qq_<user_id>`,与旧实现保持完全一致。
+ */
+export async function forwardGroupMessage(cfg, fromId, fromName, content, now = Date.now()) {
+    const message = {
+        id: `${fromId}_${now}`,
+        channelId: cfg.channelId,
+        fromid: fromId,
+        fromName,
+        type: "text",
+        content,
+        showTimestamp: true,
+        timestamp: now,
+    };
+    const body = { messages: [message] };
+    const url = new URL(`http://${cfg.host}:${cfg.port}/api/sfmc/messages`);
+    await postJSON(url, body, REQUEST_TIMEOUT_MS);
+}
+/** 包装 try/catch,失败仅 log (与旧实现一致,不抛给主循环)。 */
+export async function tryForward(cfg, fromId, fromName, content) {
+    try {
+        await forwardGroupMessage(cfg, fromId, fromName, content);
+        log.info(`QQ → MC: ${fromName}: ${content.slice(0, 60)}`);
+    }
+    catch (e) {
+        log.error(`转发到 db-server 失败: ${e.message}`);
+    }
+}
+//# sourceMappingURL=dbserver.js.map

package/dist/dbserver.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+/**
+ * index.ts — QQ ↔ MC 桥接进程入口
+ *
+ * 端口: 3002 (默认) — WebSocket (LLBot reverse-ws)
+ *
+ * 数据流:
+ *   QQ → MC:  LLBot ──WS:3002──→ qq-bridge ──POST──→ db-server:3001/api/sfmc/messages
+ *   MC → QQ:  SAPI ──POST──→ db-server:3001 ──(内部)──→ LLBot:3004/send_group_msg
+ *
+ * 注意: 本进程只做 WS 入口,不再起 HTTP server。MC→QQ 由 db-server 直连 LLBot
+ *       (见 db-server/src/domain/bridge.ts:forwardToQQBridge)
+ *
+ * 循环防护:
+ *   1. 跳过 sender.user_id === botSelfId 的回声
+ *      (botSelfId 通过 LLBot 的 lifecycle 元事件捕获)
+ *   2. 5 秒内同 message_id 短期去重 (防 race)
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/index.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+/**
+ * index.ts — QQ ↔ MC 桥接进程入口
+ *
+ * 端口: 3002 (默认) — WebSocket (LLBot reverse-ws)
+ *
+ * 数据流:
+ *   QQ → MC:  LLBot ──WS:3002──→ qq-bridge ──POST──→ db-server:3001/api/sfmc/messages
+ *   MC → QQ:  SAPI ──POST──→ db-server:3001 ──(内部)──→ LLBot:3004/send_group_msg
+ *
+ * 注意: 本进程只做 WS 入口,不再起 HTTP server。MC→QQ 由 db-server 直连 LLBot
+ *       (见 db-server/src/domain/bridge.ts:forwardToQQBridge)
+ *
+ * 循环防护:
+ *   1. 跳过 sender.user_id === botSelfId 的回声
+ *      (botSelfId 通过 LLBot 的 lifecycle 元事件捕获)
+ *   2. 5 秒内同 message_id 短期去重 (防 race)
+ */
+import { loadInitialConfig } from "./config.js";
+import { OneBotDispatcher } from "./onebot.js";
+import { startWsServer } from "./ws-server.js";
+import { startConsole } from "./console.js";
+import { log } from "./log.js";
+async function main() {
+    const cfg = loadInitialConfig();
+    if (!cfg.qq_enabled) {
+        log.info("已禁用 (qq_enabled = false)");
+        process.exit(0);
+    }
+    // 让控制台 status 命令读到 bot 当前的 self_id
+    const botSelfIdRef = { value: null };
+    const dispatcher = new OneBotDispatcher({
+        qqGroupId: cfg.qq_group_id,
+        db: {
+            host: cfg.db_host,
+            port: cfg.db_port,
+            channelId: cfg.bridge_channel_id,
+        },
+    });
+    // botSelfId 通过 dispatcher 内部维护; 控制台读 self_id 时取最新值
+    Object.defineProperty(botSelfIdRef, "value", {
+        get: () => dispatcher.selfId,
+    });
+    await startWsServer({ port: cfg.qq_ws_port, dispatcher });
+    log.info(`等待 LLBot 连接 (主群: ${cfg.qq_group_id || "未配置"}, channel: ${cfg.bridge_channel_id || "未配置"}, db: ${cfg.db_host}:${cfg.db_port})`);
+    startConsole({
+        config: cfg,
+        initialEnabled: cfg.qq_enabled,
+        wsPort: cfg.qq_ws_port,
+        botSelfIdRef,
+    });
+    log.info("启动完成");
+}
+main().catch((e) => {
+    log.error(`未捕获异常: ${e.message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAG/B,KAAK,UAAU,IAAI;IACjB,MAAM,GAAG,GAAmB,iBAAiB,EAAE,CAAC;IAEhD,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC;QACpB,GAAG,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,mCAAmC;IACnC,MAAM,YAAY,GAA6B,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAE/D,MAAM,UAAU,GAAG,IAAI,gBAAgB,CAAC;QACtC,SAAS,EAAE,GAAG,CAAC,WAAW;QAC1B,EAAE,EAAE;YACF,IAAI,EAAE,GAAG,CAAC,OAAO;YACjB,IAAI,EAAE,GAAG,CAAC,OAAO;YACjB,SAAS,EAAE,GAAG,CAAC,iBAAiB;SACjC;KACF,CAAC,CAAC;IAEH,mDAAmD;IACnD,MAAM,CAAC,cAAc,CAAC,YAAY,EAAE,OAAO,EAAE;QAC3C,GAAG,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM;KAC7B,CAAC,CAAC;IAEH,MAAM,aAAa,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;IAE1D,GAAG,CAAC,IAAI,CACN,oBAAoB,GAAG,CAAC,WAAW,IAAI,KAAK,cAAc,GAAG,CAAC,iBAAiB,IAAI,KAAK,SAAS,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,GAAG,CAC/H,CAAC;IAEF,YAAY,CAAC;QACX,MAAM,EAAE,GAAG;QACX,cAAc,EAAE,GAAG,CAAC,UAAU;QAC9B,MAAM,EAAE,GAAG,CAAC,UAAU;QACtB,YAAY;KACb,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACnB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;IACjB,GAAG,CAAC,KAAK,CAAC,UAAW,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/log.d.ts

@@ -0,0 +1,11 @@
+/**
+ * log.ts — qq-bridge 统一日志实例
+ *
+ * 通过 @sfmc-bds/logs 共享包接入,source = "qq"。
+ * sfmc 主进程通过捕获本进程 stdout 汇聚展示。
+ *
+ * bare 模式: stdout 只输出纯 text,不加时间戳/source/level 前缀
+ * (由 sfmc 的 formatLog 统一添加,避免重复)。error 走 stderr。
+ */
+export declare const log: import("@sfmc-bds/sdk/logs").Logger;
+//# sourceMappingURL=log.d.ts.map

package/dist/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,eAAO,MAAM,GAAG,qCAGd,CAAC"}

package/dist/log.js

@@ -0,0 +1,15 @@
+/**
+ * log.ts — qq-bridge 统一日志实例
+ *
+ * 通过 @sfmc-bds/logs 共享包接入,source = "qq"。
+ * sfmc 主进程通过捕获本进程 stdout 汇聚展示。
+ *
+ * bare 模式: stdout 只输出纯 text,不加时间戳/source/level 前缀
+ * (由 sfmc 的 formatLog 统一添加,避免重复)。error 走 stderr。
+ */
+import { createLogger, createStdoutSink } from "@sfmc-bds/sdk/logs";
+export const log = createLogger({
+    source: "qq",
+    sinks: [createStdoutSink({ bare: true })],
+});
+//# sourceMappingURL=log.js.map

package/dist/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEpE,MAAM,CAAC,MAAM,GAAG,GAAG,YAAY,CAAC;IAC9B,MAAM,EAAE,IAAI;IACZ,KAAK,EAAE,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;CAC1C,CAAC,CAAC"}

package/dist/onebot.d.ts

@@ -0,0 +1,44 @@
+/**
+ * onebot.ts — OneBot 11 事件分发
+ *
+ * 职责:
+ *   1. 维护 botSelfId (从 lifecycle 元事件捕获)
+ *   2. 5s 短期 message_id 去重 (防 LLBot 偶发重发)
+ *   3. 群消息段 → 纯文本 (text / at / image / face / reply / forward / record / video / file)
+ *   4. 命中规则后调用 tryForward 投递
+ *
+ * 行为与旧 index.js 完全一致; 类型上把 sender/message 都收紧为 narrow 类型。
+ */
+import { type DBServerConfig } from "./dbserver.js";
+import type { OneBotGroupMessageEvent } from "./types.js";
+/**
+ * OneBot 11 消息段数组 (或纯字符串) → 纯文本。
+ * 行为与旧实现完全一致:
+ *   - text:   原样拼接
+ *   - at:     "@昵称 " 或 "@qq " (有 name 优先 name)
+ *   - 其它:   [图片]/[表情]/[回复]/[转发]/[语音]/[视频]/[文件]
+ *   - 未知段: 跳过
+ */
+export declare function extractText(message: OneBotGroupMessageEvent["message"]): string;
+export declare class RecentMessageDedup {
+    private readonly map;
+    private lastCleanup;
+    seen(messageId: string | number | undefined): boolean;
+}
+export interface DispatcherOptions {
+    /** 群 ID 字符串,空 = 接收所有群(旧行为:空时不匹配任何群,不会触发) */
+    qqGroupId: string;
+    /** db-server 配置 + 目标 channelId */
+    db: DBServerConfig;
+}
+export declare class OneBotDispatcher {
+    private botSelfId;
+    private readonly opts;
+    private readonly dedup;
+    constructor(opts: DispatcherOptions);
+    /** 测试/调试用 */
+    get selfId(): string | null;
+    /** 收到一条原始 JSON 字符串(已 parse) */
+    handle(rawEvent: unknown): Promise<void>;
+}
+//# sourceMappingURL=onebot.d.ts.map

package/dist/onebot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onebot.d.ts","sourceRoot":"","sources":["../src/onebot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,KAAK,EAMV,uBAAuB,EAQxB,MAAM,YAAY,CAAC;AAwCpB;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,uBAAuB,CAAC,SAAS,CAAC,GAAG,MAAM,CA8B/E;AAMD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA6B;IACjD,OAAO,CAAC,WAAW,CAAK;IAExB,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO;CAetD;AAGD,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,EAAE,EAAE,cAAc,CAAC;CACpB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoB;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4B;gBAEtC,IAAI,EAAE,iBAAiB;IAInC,aAAa;IACb,IAAI,MAAM,IAAI,MAAM,GAAG,IAAI,CAE1B;IAED,+BAA+B;IACzB,MAAM,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAoC/C"}

package/dist/onebot.js

@@ -0,0 +1,172 @@
+/**
+ * onebot.ts — OneBot 11 事件分发
+ *
+ * 职责:
+ *   1. 维护 botSelfId (从 lifecycle 元事件捕获)
+ *   2. 5s 短期 message_id 去重 (防 LLBot 偶发重发)
+ *   3. 群消息段 → 纯文本 (text / at / image / face / reply / forward / record / video / file)
+ *   4. 命中规则后调用 tryForward 投递
+ *
+ * 行为与旧 index.js 完全一致; 类型上把 sender/message 都收紧为 narrow 类型。
+ */
+import { log } from "./log.js";
+import { tryForward } from "./dbserver.js";
+// ── 类型守卫 ────────────────────────────────────────────────────
+function isGroupMessageEvent(e) {
+    return e.post_type === "message" && e.message_type === "group";
+}
+function isLifecycleEvent(e) {
+    return e.post_type === "meta_event" && e.meta_event_type === "lifecycle";
+}
+function isTextSegment(s) {
+    return s?.type === "text";
+}
+function isAtSegment(s) {
+    return s?.type === "at";
+}
+function isImageSegment(s) {
+    return s?.type === "image";
+}
+function isFaceSegment(s) {
+    return s?.type === "face";
+}
+function isReplySegment(s) {
+    return s?.type === "reply";
+}
+function isForwardSegment(s) {
+    return s?.type === "forward";
+}
+function isRecordSegment(s) {
+    return s?.type === "record";
+}
+function isVideoSegment(s) {
+    return s?.type === "video";
+}
+function isFileSegment(s) {
+    return s?.type === "file";
+}
+// ── 消息段 → 纯文本 ─────────────────────────────────────────
+/**
+ * OneBot 11 消息段数组 (或纯字符串) → 纯文本。
+ * 行为与旧实现完全一致:
+ *   - text:   原样拼接
+ *   - at:     "@昵称 " 或 "@qq " (有 name 优先 name)
+ *   - 其它:   [图片]/[表情]/[回复]/[转发]/[语音]/[视频]/[文件]
+ *   - 未知段: 跳过
+ */
+export function extractText(message) {
+    if (typeof message === "string")
+        return message;
+    if (!Array.isArray(message))
+        return "";
+    const parts = [];
+    for (const seg of message) {
+        if (!seg || typeof seg !== "object")
+            continue;
+        if (isTextSegment(seg)) {
+            const text = seg.data.text;
+            if (typeof text === "string")
+                parts.push(text);
+        }
+        else if (isAtSegment(seg)) {
+            const name = seg.data.name ? `@${seg.data.name} ` : `@${seg.data.qq ?? "?"} `;
+            parts.push(name);
+        }
+        else if (isImageSegment(seg)) {
+            parts.push("[图片]");
+        }
+        else if (isFaceSegment(seg)) {
+            parts.push("[表情]");
+        }
+        else if (isReplySegment(seg)) {
+            parts.push("[回复]");
+        }
+        else if (isForwardSegment(seg)) {
+            parts.push("[转发]");
+        }
+        else if (isRecordSegment(seg)) {
+            parts.push("[语音]");
+        }
+        else if (isVideoSegment(seg)) {
+            parts.push("[视频]");
+        }
+        else if (isFileSegment(seg)) {
+            parts.push("[文件]");
+        }
+        // 未知段:跳过
+    }
+    return parts.join("").trim();
+}
+// ── 短期 message_id 去重 (懒清理) ────────────────────────────
+const DEDUP_WINDOW_MS = 5_000;
+const CLEANUP_INTERVAL_MS = 1_000;
+export class RecentMessageDedup {
+    map = new Map();
+    lastCleanup = 0;
+    seen(messageId) {
+        if (messageId === undefined || messageId === null)
+            return false;
+        const key = String(messageId);
+        const now = Date.now();
+        if (now - this.lastCleanup > CLEANUP_INTERVAL_MS) {
+            this.lastCleanup = now;
+            for (const [k, ts] of this.map) {
+                if (now - ts > DEDUP_WINDOW_MS)
+                    this.map.delete(k);
+            }
+        }
+        const prev = this.map.get(key);
+        if (prev !== undefined && now - prev < DEDUP_WINDOW_MS)
+            return true;
+        this.map.set(key, now);
+        return false;
+    }
+}
+export class OneBotDispatcher {
+    botSelfId = null;
+    opts;
+    dedup = new RecentMessageDedup();
+    constructor(opts) {
+        this.opts = opts;
+    }
+    /** 测试/调试用 */
+    get selfId() {
+        return this.botSelfId;
+    }
+    /** 收到一条原始 JSON 字符串(已 parse) */
+    async handle(rawEvent) {
+        const event = rawEvent;
+        if (!event || typeof event !== "object")
+            return;
+        if (isLifecycleEvent(event)) {
+            if (event.self_id !== undefined && this.botSelfId === null) {
+                this.botSelfId = String(event.self_id);
+                log.info(`LLBot self_id = ${this.botSelfId}`);
+            }
+            return;
+        }
+        if (!isGroupMessageEvent(event))
+            return;
+        if (!this.opts.qqGroupId || String(event.group_id) !== this.opts.qqGroupId)
+            return;
+        // 循环防护 1: 跳过 bot 自己发的消息回声
+        if (this.botSelfId && String(event.sender?.user_id) === this.botSelfId)
+            return;
+        // 循环防护 2: 短期去重 (LLBot 偶发重发)
+        if (this.dedup.seen(event.message_id))
+            return;
+        const text = extractText(event.message);
+        if (!text)
+            return;
+        if (!this.opts.db.channelId) {
+            log.warn("bridge_channel_id 未配置,跳过 (可用 reload 重读配置)");
+            return;
+        }
+        const senderCard = event.sender?.card;
+        const senderNick = event.sender?.nickname;
+        const fromName = senderCard || senderNick || `QQ_${event.user_id}`;
+        const fromId = `qq_${String(event.user_id)}`;
+        await tryForward(this.opts.db, fromId, fromName, text);
+    }
+}
+//# sourceMappingURL=onebot.js.map

package/dist/onebot.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,124 @@
+/**
+ * types.ts — OneBot 11 / 配置 / db-server 消息载荷类型
+ *
+ * 只声明本进程真正用到的字段；OneBot 11 完整规范参考
+ * https://github.com/botuniverse/onebot-11
+ */
+export type OneBotSegmentType = "text" | "at" | "image" | "face" | "reply" | "forward" | "record" | "video" | "file" | (string & {});
+export interface OneBotTextSegment {
+    type: "text";
+    data: {
+        text: string;
+    };
+}
+export interface OneBotAtSegment {
+    type: "at";
+    data: {
+        qq: string;
+        name?: string;
+    };
+}
+export interface OneBotImageSegment {
+    type: "image";
+    data: Record<string, unknown>;
+}
+export interface OneBotFaceSegment {
+    type: "face";
+    data: Record<string, unknown>;
+}
+export interface OneBotReplySegment {
+    type: "reply";
+    data: Record<string, unknown>;
+}
+export interface OneBotForwardSegment {
+    type: "forward";
+    data: Record<string, unknown>;
+}
+export interface OneBotRecordSegment {
+    type: "record";
+    data: Record<string, unknown>;
+}
+export interface OneBotVideoSegment {
+    type: "video";
+    data: Record<string, unknown>;
+}
+export interface OneBotFileSegment {
+    type: "file";
+    data: Record<string, unknown>;
+}
+export interface OneBotUnknownSegment {
+    type: string;
+    data: Record<string, unknown>;
+}
+export type OneBotSegment = OneBotTextSegment | OneBotAtSegment | OneBotImageSegment | OneBotFaceSegment | OneBotReplySegment | OneBotForwardSegment | OneBotRecordSegment | OneBotVideoSegment | OneBotFileSegment | OneBotUnknownSegment;
+export interface OneBotSender {
+    user_id: number;
+    nickname: string;
+    card?: string;
+    [k: string]: unknown;
+}
+export interface OneBotGroupMessageEvent {
+    post_type: "message";
+    message_type: "group";
+    sub_type?: string;
+    self_id: number | string;
+    user_id: number;
+    group_id: number;
+    message_id: number | string;
+    sender: OneBotSender;
+    message: OneBotSegment[] | string;
+    raw_message?: string;
+    time?: number;
+    [k: string]: unknown;
+}
+export interface OneBotLifecycleEvent {
+    post_type: "meta_event";
+    meta_event_type: "lifecycle";
+    self_id: number | string;
+    sub_type?: string;
+    [k: string]: unknown;
+}
+export type OneBotMessageEvent = OneBotGroupMessageEvent;
+export type OneBotEvent = OneBotGroupMessageEvent | OneBotLifecycleEvent | {
+    [k: string]: unknown;
+};
+/** 本进程用到的字段全是 required:config 加载时 (config.ts#applyDefaults)
+ *  已经把 optional 字段全部填默认值。本地类型不能放宽 optional,
+ *  否则调用点 (index.ts / dispatcher.ts) 都要补 undefined 兜底。 */
+export interface QQBridgeConfig {
+    qq_enabled: boolean;
+    qq_ws_port: number;
+    qq_group_id: string;
+    bridge_channel_id: string;
+    db_host: string;
+    db_port: number;
+    mctoqq_prefix: string;
+    /** LLBot 字段(由 config.ts#applyDefaults 之外的 raw 透传补齐)。 */
+    llbot_enabled?: boolean;
+    llbot_path?: string;
+    llbot_cwd?: string;
+    llbot_host?: string;
+    llbot_port?: number;
+    llbot_token?: string;
+    llbot_http?: string;
+    [k: string]: unknown;
+}
+export interface IncomingChatMessage {
+    id: string;
+    channelId: string;
+    fromid: string;
+    fromName: string;
+    type: "text";
+    content: string;
+    showTimestamp: boolean;
+    timestamp: number;
+}
+export interface PostMessagesBody {
+    messages: IncomingChatMessage[];
+}
+export interface PostMessagesResponse {
+    ok: boolean;
+    received?: number;
+    [k: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * types.ts — OneBot 11 / 配置 / db-server 消息载荷类型
+ *
+ * 只声明本进程真正用到的字段；OneBot 11 完整规范参考
+ * https://github.com/botuniverse/onebot-11
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/ws-server.d.ts

@@ -0,0 +1,20 @@
+/**
+ * ws-server.ts — WebSocket 服务 (LLBot reverse-ws 入口)
+ *
+ * 端口: 3002 (默认)
+ * 行为与旧实现完全一致:
+ *   - 优先加载本地 node_modules/ws
+ *   - 加载失败时 fallback 到 ../db-server/node_modules/ws
+ *   - 每个连接把消息 JSON.parse 后交给 dispatcher
+ *
+ * fallback 用 createRequire 加载: 避免 TypeScript 在编译期检查
+ * ../db-server/node_modules/ws 的相对路径(不在 tsconfig 包含范围)。
+ */
+import { WebSocketServer } from "ws";
+import type { OneBotDispatcher } from "./onebot.js";
+export interface WsServerOptions {
+    port: number;
+    dispatcher: OneBotDispatcher;
+}
+export declare function startWsServer(opts: WsServerOptions): Promise<WebSocketServer>;
+//# sourceMappingURL=ws-server.d.ts.map

package/dist/ws-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-server.d.ts","sourceRoot":"","sources":["../src/ws-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAa,eAAe,EAAE,MAAM,IAAI,CAAC;AAEhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,gBAAgB,CAAC;CAC9B;AAaD,wBAAsB,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAgCnF"}

package/dist/ws-server.js

@@ -0,0 +1,57 @@
+/**
+ * ws-server.ts — WebSocket 服务 (LLBot reverse-ws 入口)
+ *
+ * 端口: 3002 (默认)
+ * 行为与旧实现完全一致:
+ *   - 优先加载本地 node_modules/ws
+ *   - 加载失败时 fallback 到 ../db-server/node_modules/ws
+ *   - 每个连接把消息 JSON.parse 后交给 dispatcher
+ *
+ * fallback 用 createRequire 加载: 避免 TypeScript 在编译期检查
+ * ../db-server/node_modules/ws 的相对路径(不在 tsconfig 包含范围)。
+ */
+import { createRequire } from "node:module";
+import { WebSocket, WebSocketServer } from "ws";
+import { log } from "./log.js";
+const localRequire = createRequire(import.meta.url);
+async function loadWs() {
+    try {
+        return localRequire("ws");
+    }
+    catch {
+        // 兜底:复用 db-server 的 ws
+        return localRequire("../db-server/node_modules/ws");
+    }
+}
+export async function startWsServer(opts) {
+    const ws = await loadWs();
+    const { WebSocketServer: WSS } = ws;
+    const wss = new WSS({ port: opts.port });
+    log.info(`WebSocket 服务启动 ws://0.0.0.0:${opts.port}`);
+    wss.on("connection", (sock, req) => {
+        const path = req.url ?? "/";
+        log.info(`LLBot 已连接 (${path})`);
+        sock.on("message", (raw) => {
+            try {
+                const text = raw.toString("utf-8");
+                const parsed = JSON.parse(text);
+                // 异步但不阻塞 socket 循环
+                void opts.dispatcher.handle(parsed);
+            }
+            catch (e) {
+                log.error(`解析消息失败: ${e.message}`);
+            }
+        });
+        sock.on("close", () => {
+            log.info("LLBot 已断开");
+        });
+        sock.on("error", (err) => {
+            log.error(`WebSocket 连接错误: ${err.message}`);
+        });
+    });
+    wss.on("error", (err) => {
+        log.error(`WebSocket 服务器错误: ${err.message}`);
+    });
+    return wss;
+}
+//# sourceMappingURL=ws-server.js.map

package/dist/ws-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-server.js","sourceRoot":"","sources":["../src/ws-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,IAAI,CAAC;AAChD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAQ/B,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEpD,KAAK,UAAU,MAAM;IACnB,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,IAAI,CAAwB,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,uBAAuB;QACvB,OAAO,YAAY,CAAC,8BAA8B,CAAwB,CAAC;IAC7E,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAqB;IACvD,MAAM,EAAE,GAAG,MAAM,MAAM,EAAE,CAAC;IAC1B,MAAM,EAAE,eAAe,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IACpC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,GAAG,CAAC,IAAI,CAAC,+BAA+B,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAErD,GAAG,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,IAAe,EAAE,GAAoB,EAAE,EAAE;QAC7D,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC;QAC5B,GAAG,CAAC,IAAI,CAAC,cAAc,IAAI,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE;YACzB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACnC,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACzC,mBAAmB;gBACnB,KAAK,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACtC,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,GAAG,CAAC,KAAK,CAAC,WAAY,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACpB,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxB,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACvB,GAAG,CAAC,KAAK,CAAC,mBAAmB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QACtB,GAAG,CAAC,KAAK,CAAC,oBAAoB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@sfmc-bds/qq-bridge",
+  "version": "0.1.0",
+  "description": "SFMC QQ ↔ MC bridge — LLBot OneBot 11 reverse-WS on port 3002, forwards events to db-server",
+  "author": "Shiroha7z",
+  "type": "module",
+  "license": "ISC",
+  "homepage": "https://github.com/DogeLakeDev/ScriptsForMinecraftServer/tree/main/qq-bridge#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DogeLakeDev/ScriptsForMinecraftServer.git",
+    "directory": "qq-bridge"
+  },
+  "bugs": {
+    "url": "https://github.com/DogeLakeDev/ScriptsForMinecraftServer/issues"
+  },
+  "keywords": [
+    "minecraft-bedrock",
+    "sfmc",
+    "qq",
+    "onebot",
+    "llbot",
+    "scriptsforminecraftserver"
+  ],
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit",
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "format": "prettier --write \"src/**/*.{ts,tsx,js,json}\"",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@sfmc-bds/sdk": "^0.1.0",
+    "ws": "^8.21.1"
+  },
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}