@sfmc-bds/bds-tools 0.1.0

package/README.md

@@ -0,0 +1,18 @@
+# @sfmc-bds/bds-tools
+
+SFMC BDS 工具集：自动更新、进程管理、行为包装配（pack-manager）。
+
+## 安装
+
+```bash
+npm install @sfmc-bds/bds-tools
+```
+
+## 依赖
+
+- `@sfmc-bds/sdk` ^0.1.0
+- Node.js >= 22.13
+
+## 仓库
+
+<https://github.com/DogeLakeDev/ScriptsForMinecraftServer/tree/main/bds-tools>

package/dist/bds-manager.d.ts

@@ -0,0 +1,27 @@
+/**
+ * bds-manager.ts — BDS 进程管理器
+ *
+ * 改进:
+ *  - 优雅 stop (发送 stop 命令 → 等待退出 → SIGTERM → SIGKILL)
+ *  - watchdog (崩溃自动重启)
+ *  - 单例事件发射器
+ *  - 完全异步 (fs/promises)
+ */
+import { EventEmitter } from "node:events";
+export interface BdsManager {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    status(): Promise<boolean>;
+    sendCommand(cmd: string): boolean;
+    watch(): Promise<void>;
+    events: EventEmitter;
+    isManualStop: boolean;
+    getPid(): number;
+}
+export interface BdsManagerOptions {
+    detached?: boolean;
+}
+export declare function createBdsManager(options?: BdsManagerOptions): BdsManager;
+export declare const bdsEvents: EventEmitter;
+export declare const bdsEvents_enabled: () => void;
+//# sourceMappingURL=bds-manager.d.ts.map

package/dist/bds-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bds-manager.d.ts","sourceRoot":"","sources":["../src/bds-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAM3C,MAAM,WAAW,UAAU;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,IAAI,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAoED,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,UAAU,CAuK5E;AAED,eAAO,MAAM,SAAS,EAAE,YAAiC,CAAC;AAC1D,eAAO,MAAM,iBAAiB,QAAO,IAA2C,CAAC"}

package/dist/bds-manager.js

@@ -0,0 +1,294 @@
+/**
+ * bds-manager.ts — BDS 进程管理器
+ *
+ * 改进:
+ *  - 优雅 stop (发送 stop 命令 → 等待退出 → SIGTERM → SIGKILL)
+ *  - watchdog (崩溃自动重启)
+ *  - 单例事件发射器
+ *  - 完全异步 (fs/promises)
+ */
+import { spawn, exec } from "node:child_process";
+import { promisify } from "node:util";
+import fs from "node:fs";
+import path from "node:path";
+import { EventEmitter } from "node:events";
+import { loadConfig, PID_FILE } from "./paths.js";
+import { log } from "./log.js";
+const execAsync = promisify(exec);
+let cached = null;
+function readPid() {
+    try {
+        return parseInt(fs.readFileSync(PID_FILE, "utf-8").trim(), 10) || 0;
+    }
+    catch {
+        return 0;
+    }
+}
+function writePid(pid) {
+    try {
+        fs.writeFileSync(PID_FILE, String(pid));
+    }
+    catch {
+        /* ignore */
+    }
+}
+function clearPid() {
+    try {
+        if (fs.existsSync(PID_FILE))
+            fs.unlinkSync(PID_FILE);
+    }
+    catch {
+        /* ignore */
+    }
+}
+async function isAlive(pid) {
+    if (!pid)
+        return false;
+    try {
+        if (process.platform === "win32") {
+            const { stdout } = await execAsync(`tasklist /fi "PID eq ${pid}" /nh`, { windowsHide: true });
+            return stdout.includes(String(pid));
+        }
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function ensureProc() {
+    if (cached)
+        return cached;
+    const cfg = loadConfig();
+    const bds_path = path.resolve(cfg.bds_path || process.cwd());
+    const exePath = path.join(bds_path, "bedrock_server.exe");
+    cached = {
+        process: null,
+        isManualStop: false,
+        crashRestart: cfg.crash_restart !== false,
+        crashDelayMs: (cfg.crash_restart_delay ?? 5) * 1000,
+        exePath,
+        bdsPath: bds_path,
+    };
+    return cached;
+}
+export function createBdsManager(options = {}) {
+    const events = new EventEmitter();
+    events.setMaxListeners(100);
+    const sendCommand = (cmd) => {
+        const p = ensureProc();
+        const pid = readPid();
+        if (!pid || !isAlive(pid)) {
+            log.warn("BDS 未运行");
+            return false;
+        }
+        if (p.process && p.process.pid === pid && p.process.stdin) {
+            try {
+                p.process.stdin.write(cmd + "\n");
+                log.info(`已发送命令: ${cmd}`);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        }
+        log.warn("BDS 由外部启动，无法发送命令到 stdin");
+        return false;
+    };
+    const stop = async () => {
+        const p = ensureProc();
+        const pid = readPid();
+        if (!pid || !(await isAlive(pid))) {
+            log.info("BDS 未运行");
+            clearPid();
+            return;
+        }
+        if (p.process && p.process.pid === pid && p.process.stdin) {
+            p.isManualStop = true;
+            log.info("正在关闭 BDS...");
+            try {
+                p.process.stdin.write("stop\n");
+            }
+            catch (e) {
+                log.warn(`发送 stop 命令失败: ${e.message}`);
+            }
+            await Promise.race([
+                new Promise((resolve) => p.process?.once("exit", () => resolve())),
+                new Promise((resolve) => setTimeout(() => {
+                    log.warn("30s 超时，强制终止...");
+                    try {
+                        p.process?.kill("SIGTERM");
+                    }
+                    catch { }
+                    setTimeout(resolve, 5000);
+                }, 30_000)),
+            ]);
+            if (p.process && p.process.exitCode === null) {
+                log.warn("强制结束进程...");
+                try {
+                    p.process.kill("SIGKILL");
+                }
+                catch { }
+            }
+        }
+        else {
+            // 外部启动的 BDS — fallback 使用 taskkill / pkill
+            log.info("BDS 由外部启动，使用 taskkill...");
+            try {
+                if (process.platform === "win32") {
+                    await execAsync("taskkill /f /im bedrock_server.exe", { windowsHide: true });
+                }
+                else {
+                    await execAsync("pkill -f bedrock_server", { windowsHide: true });
+                }
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        clearPid();
+        p.process = null;
+        log.info("BDS 已停止");
+    };
+    const start = async () => {
+        const p = ensureProc();
+        const existing = readPid();
+        if (existing && (await isAlive(existing))) {
+            log.info("BDS 已在运行中");
+            return;
+        }
+        if (!fs.existsSync(p.exePath)) {
+            log.error(`未找到 ${p.exePath}`);
+            throw new Error(`bedrock_server.exe 不存在: ${p.exePath}`);
+        }
+        log.info("正在启动 BDS...");
+        const child = spawn(p.exePath, [], {
+            cwd: p.bdsPath,
+            stdio: options.detached ? "ignore" : ["pipe", "pipe", "pipe"],
+            detached: options.detached,
+            windowsHide: true,
+        });
+        if (options.detached)
+            child.unref();
+        p.process = child;
+        writePid(child.pid ?? 0);
+        log.info(`BDS 已启动 (PID: ${child.pid})`);
+        child.stdout?.on("data", (chunk) => {
+            const text = chunk.toString();
+            events.emit("output", text);
+            if (require.main === module)
+                process.stdout.write(text);
+        });
+        child.stderr?.on("data", (chunk) => {
+            const text = `[STDERR] ${chunk.toString()}`;
+            events.emit("output", text);
+            if (require.main === module)
+                process.stderr.write(text);
+        });
+        child.on("exit", (code) => {
+            log.info(`BDS 已退出 (code: ${code})`);
+            clearPid();
+            p.process = null;
+            if (!p.isManualStop && p.crashRestart && isMain()) {
+                log.info(`BDS 意外退出，${p.crashDelayMs / 1000}s 后自动重启...`);
+                setTimeout(() => {
+                    start().catch((e) => log.error(`自动重启失败: ${e.message}`));
+                }, p.crashDelayMs);
+            }
+            p.isManualStop = false;
+        });
+    };
+    const status = async () => {
+        const pid = readPid();
+        const alive = pid > 0 && (await isAlive(pid));
+        if (alive) {
+            console.log(`BDS 运行中 (PID: ${pid})`);
+        }
+        else {
+            console.log("BDS 未运行");
+            clearPid();
+        }
+        return alive;
+    };
+    const watch = async () => {
+        log.info("启动监护模式...");
+        while (true) {
+            const pid = readPid();
+            if (!pid || !(await isAlive(pid))) {
+                try {
+                    await start();
+                }
+                catch (e) {
+                    log.error(`自动启动失败: ${e.message}`);
+                }
+            }
+            await new Promise((r) => setTimeout(r, 5_000));
+        }
+    };
+    const getPid = () => {
+        const p = ensureProc();
+        return p.process?.pid ?? readPid();
+    };
+    return {
+        start,
+        stop,
+        status,
+        sendCommand,
+        watch,
+        events,
+        isManualStop: false,
+        getPid,
+    };
+}
+export const bdsEvents = new EventEmitter();
+export const bdsEvents_enabled = () => { bdsEvents.setMaxListeners(100); };
+bdsEvents_enabled();
+/** 判断当前是否作为 CLI 主入口运行 */
+function isMain() {
+    if (require.main === module)
+        return true;
+    // 兼容 CJS 编译产物的 require.main 不等于当前 module 场景
+    // 若 process.argv[1] 指向本文件 → 主入口
+    const entry = process.argv[1] ?? "";
+    return entry.endsWith("bds-manager.js") || entry.endsWith("bds-manager.ts");
+}
+// CLI 入口
+if (isMain()) {
+    const cmd = process.argv[2];
+    const bds = createBdsManager();
+    const args = process.argv.slice(3);
+    switch (cmd) {
+        case "start":
+            bds.start().catch((e) => log.error(`启动失败: ${e.message}`));
+            break;
+        case "stop":
+            bds.stop().catch((e) => log.error(`停止失败: ${e.message}`));
+            break;
+        case "restart":
+            bds.stop()
+                .then(() => bds.start())
+                .catch((e) => log.error(`重启失败: ${e.message}`));
+            break;
+        case "status":
+            bds.status();
+            break;
+        case "send":
+            if (args[0])
+                bds.sendCommand(args.join(" "));
+            else
+                console.log("用法: node bds-manager.js send <command>");
+            break;
+        case "watch":
+            bds.watch().catch((e) => log.error(`监护异常: ${e.message}`));
+            break;
+        default:
+            console.log(`用法:
+  start         启动 BDS
+  stop          停止
+  restart       重启
+  status        检查状态
+  send <cmd>    发送命令
+  watch         监护模式（崩溃自动重启）`);
+    }
+}
+//# sourceMappingURL=bds-manager.js.map

package/dist/bds-manager.js.map

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

package/dist/changelog.d.ts

@@ -0,0 +1,9 @@
+/**
+ * changelog.ts — 更新日志抓取 (官方页面)
+ */
+import type { ChangelogPayload } from "./types.js";
+declare const CHANGELOG_BASE = "https://feedback.minecraft.net/hc/en-us/sections/360001186971";
+/** 抓取当前版本的更新说明 (文本 + 首张图 base64) */
+export declare function fetchChangelog(channel: string): Promise<ChangelogPayload | null>;
+export { CHANGELOG_BASE };
+//# sourceMappingURL=changelog.d.ts.map

package/dist/changelog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.d.ts","sourceRoot":"","sources":["../src/changelog.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGnD,QAAA,MAAM,cAAc,kEAAkE,CAAC;AAUvF,oCAAoC;AACpC,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAwCtF;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/changelog.js

@@ -0,0 +1,59 @@
+/**
+ * changelog.ts — 更新日志抓取 (官方页面)
+ */
+import { parse as parseHtml } from "node-html-parser";
+import { fetchJsonWithFallback, httpGetText } from "./http.js";
+import { log } from "./log.js";
+const CHANGELOG_BASE = "https://feedback.minecraft.net/hc/en-us/sections/360001186971";
+/**
+ * node-html-parser 的 API 与 cheerio 略不同:它没有 first/length 链式判断,
+ * 而是用 querySelector + 节点属性。这里包一层小工具让选择子语义集中。
+ */
+function firstElement(root, selector) {
+    return root.querySelector(selector);
+}
+/** 抓取当前版本的更新说明 (文本 + 首张图 base64) */
+export async function fetchChangelog(channel) {
+    try {
+        const url = `https://www.minecraft.net/en-us/article/${channel === "preview" ? "bedrock-beta" : "bedrock"}-update`;
+        const html = await httpGetText(url);
+        const root = parseHtml(html);
+        const article = firstElement(root, "article")
+            ?? firstElement(root, ".article-content")
+            ?? firstElement(root, '[class*="content"]');
+        if (!article)
+            return null;
+        const paragraphs = [];
+        for (const el of article.querySelectorAll("p, h2, h3, li")) {
+            const t = el.text.trim();
+            if (t)
+                paragraphs.push(t);
+        }
+        const text = paragraphs.join("\n").slice(0, 2000);
+        let imageBase64 = null;
+        const firstImg = article.querySelector("img");
+        if (firstImg) {
+            const imgSrc = firstImg.getAttribute("src") ?? firstImg.getAttribute("data-src") ?? undefined;
+            if (imgSrc) {
+                try {
+                    const imgUrl = imgSrc.startsWith("http") ? imgSrc : `https://www.minecraft.net${imgSrc}`;
+                    const res = await fetchJsonWithFallback([], 15_000).catch(() => null);
+                    void res;
+                    const { httpRequest } = await import("./http.js");
+                    const img = await httpRequest(imgUrl);
+                    imageBase64 = img.body.toString("base64");
+                }
+                catch (e) {
+                    log.warn(`获取图片失败: ${e.message}`);
+                }
+            }
+        }
+        return { text: text.slice(0, 2000), imageBase64 };
+    }
+    catch (e) {
+        log.warn(`获取更新日志失败: ${e.message}`);
+        return null;
+    }
+}
+export { CHANGELOG_BASE };
+//# sourceMappingURL=changelog.js.map

package/dist/changelog.js.map

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

package/dist/check-update.d.ts

@@ -0,0 +1,12 @@
+/**
+ * check-update.ts — BDS 自动更新器 (主流程)
+ *
+ *   1. 临时 staging 目录 (mkdtempSync) - 避免污染 SCRIPT_DIR
+ *   2. 下载/解压失败 → 自动从备份回滚 preserves
+ *   3. 流式 SHA256 校验 - 不把 250MB 文件读入内存
+ *   4. 兼容版本白名单 - 不匹配则跳过升级
+ *   5. QQ 通知统一加 5s 超时 - 永远不阻塞主流程
+ *   6. Rollback marker 落盘 - 跨进程 / 跨重启可恢复
+ */
+export declare function runUpdate(): Promise<number>;
+//# sourceMappingURL=check-update.d.ts.map

package/dist/check-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-update.d.ts","sourceRoot":"","sources":["../src/check-update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA8JH,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAuSjD"}