@sfmc-bds/bds-tools 0.1.0

package/dist/pack-manager.js

@@ -0,0 +1,264 @@
+/**
+ * pack-manager.ts — Bedrock 行为包/资源包 装配 + 部署到 BDS 根。
+ *
+ * 这是 SEA 与 npm 两条用户路径共用的纯函数库:
+ *
+ *   - SEA:用户在 REPL/wizard 里跑 `sfmc behavior-pack build/deploy`
+ *          → sfmc 通过 spawnService 启 `bds-tools/dist/pack-manager.js`,
+ *            SEA 自己跑 esbuild 把脚本 bundle 写到 <modulesDir>/build/sfmc-modules-bp/scripts/main.js,
+ *            然后调 pack-manager#assembleBehaviorPack 装配。
+ *   - npm: 用户跑 `sfmc behavior-pack build`,
+ *          同一 spawnService 路径。或者直接在同进程 import 这个库。
+ *
+ * 关键约束:本文件不允许引 esbuild / 任何 npm-only 包 — SEA 要把它打成 SEA
+ * 的一部分内嵌起来,而 SEA 是个单 exe (除 Node 内置 + bds-tools 已有依赖外)。
+ *
+ * 已有依赖 (bds-tools/package.json):
+ *   - cli-progress: 进度条
+ *   - node-html-parser: changelog 抓取 (本文件用不到)
+ *   - jszip: zip 解压(模块 zip / BDS server.zip),与 sfmc/wizard 共享同一个库
+ *
+ * 没有外部依赖意味着:SEA 静态把 `bds-tools/dist/*` 解压到 exe 旁边即可,
+ *不需把 npm 整棵树带进去。
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { copyDirAsync, copyFileAsync } from "./fsx.js";
+/* ── 路径常量 ─────────────────────────────────────────────────────────── */
+/** SFMC 合成 BP 的固定 @minecraft/* permissions,所有用到的命名空间都打开。 */
+export const SFMC_PERMISSIONS = [
+    "@minecraft/server",
+    "@minecraft/server-ui",
+    "@minecraft/server-admin",
+    "@minecraft/server-gametest",
+    "@minecraft/server-net",
+    "@minecraft/server-editor",
+    "@minecraft/diagnostics",
+];
+/** 随机生成 BP/RP manifest.json header.uuid (RFC 4122 v4) */
+export function randomUuid() {
+    /* crypto.randomUUID 是 Node 19+ 内置,SEA 走 Node 22+,这里直接用 */
+    return crypto.randomUUID();
+}
+/* ── 骨架函数 (Commit 5 实现) ──────────────────────────────────────────── */
+/**
+ * Assemble a Bedrock behavior pack directory at `outDir` from a prebuilt
+ * `srcDir` (which must already contain `scripts/main.js` plus whatever else
+ * was bundled by esbuild) and write a fresh `manifest.json` + `permissions.json`.
+ *
+ * The caller is responsible for running esbuild first; pack-manager does not
+ * bundle scripts. That decoupling is what lets the SEA ship without esbuild.
+ */
+export async function assembleBehaviorPack(opts) {
+    const version = opts.version ?? [1, 0, 0];
+    const bpUuid = randomUuid();
+    await fs.promises.rm(opts.outDir, { recursive: true, force: true });
+    await fs.promises.mkdir(opts.outDir, { recursive: true });
+    if (fs.existsSync(opts.srcDir)) {
+        await copyDirAsync(opts.srcDir, opts.outDir);
+    }
+    else {
+        await fs.promises.mkdir(path.join(opts.outDir, "scripts"), { recursive: true });
+        await fs.promises.writeFile(path.join(opts.outDir, "scripts", "main.js"), "/* no scripts */\n", "utf8");
+    }
+    await writeBehaviorPackManifest(opts.outDir, {
+        name: opts.projectName,
+        uuid: bpUuid,
+        version,
+        description: opts.description,
+    });
+    if (opts.iconSrc && fs.existsSync(opts.iconSrc)) {
+        await copyFileAsync(opts.iconSrc, path.join(opts.outDir, "pack_icon.png"));
+    }
+    await writePermissionsJson(opts.outDir);
+}
+/**
+ * Merge every enabled module's `resource_pack/**` tree into one RP directory
+ * at `outDir`, with a single fresh `manifest.json`. Per-module subfolders are
+ * preserved so resource pack authors can disambiguate (e.g. `peace/textures/...`).
+ */
+export async function assembleResourcePack(opts) {
+    const version = opts.version ?? [1, 0, 0];
+    const rpUuid = randomUuid();
+    await fs.promises.rm(opts.outDir, { recursive: true, force: true });
+    await fs.promises.mkdir(opts.outDir, { recursive: true });
+    for (const [moduleId, rpDir] of Object.entries(opts.moduleResourceDirs)) {
+        if (!fs.existsSync(rpDir))
+            continue;
+        const dst = path.join(opts.outDir, moduleId);
+        await fs.promises.mkdir(dst, { recursive: true });
+        await copyDirAsync(rpDir, dst);
+    }
+    await writeResourcePackManifest(opts.outDir, {
+        name: opts.projectName,
+        uuid: rpUuid,
+        version,
+        description: opts.description,
+    });
+}
+/**
+ * Read the `level-name=` value from `<bdsRoot>/server.properties`.
+ * Falls back to "Bedrock level" (BDS default) when the file is missing or
+ * the key is absent.
+ */
+export async function readLevelName(bdsRoot) {
+    const file = path.join(bdsRoot, "server.properties");
+    if (!fs.existsSync(file))
+        return "Bedrock level";
+    const text = await fs.promises.readFile(file, "utf8");
+    for (const line of text.split(/\r?\n/)) {
+        const m = /^\s*level-name\s*=\s*(.+?)\s*$/.exec(line);
+        if (m && m[1])
+            return m[1];
+    }
+    return "Bedrock level";
+}
+/**
+ * Copy BP/RP source dirs into the world's behavior_packs/ + resource_packs/
+ * folders, and write a fresh `permissions.json` into the BP target.
+ *
+ * Does NOT edit world_behavior_packs.json — that's a separate step the caller
+ * must invoke after restart, because BDS only reads that file at startup.
+ */
+export async function deployToBDS(opts) {
+    const worldsDir = path.join(opts.bdsRoot, "worlds", opts.levelName);
+    const bpDst = path.join(worldsDir, "behavior_packs", opts.bpName);
+    const rpDst = path.join(worldsDir, "resource_packs", opts.rpName ?? `${opts.bpName}-rp`);
+    await fs.promises.mkdir(worldsDir, { recursive: true });
+    await fs.promises.rm(bpDst, { recursive: true, force: true });
+    await copyDirAsync(opts.behaviorPackSrc, bpDst);
+    await writePermissionsJson(bpDst);
+    if (opts.resourcePackSrc && fs.existsSync(opts.resourcePackSrc)) {
+        await fs.promises.rm(rpDst, { recursive: true, force: true });
+        await copyDirAsync(opts.resourcePackSrc, rpDst);
+    }
+}
+/**
+ * Write the seven `@minecraft/*` allowed_modules into a behavior pack's
+ * `permissions.json`. Idempotent: rewrites any pre-existing file.
+ */
+export async function writePermissionsJson(bpDir) {
+    const payload = { allowed_modules: [...SFMC_PERMISSIONS] };
+    await fs.promises.mkdir(bpDir, { recursive: true });
+    const tmp = path.join(bpDir, `.permissions.${process.pid}.tmp`);
+    await fs.promises.writeFile(tmp, JSON.stringify(payload, null, 2) + "\n", "utf8");
+    await fs.promises.rename(tmp, path.join(bpDir, "permissions.json"));
+    void copyDirAsync;
+}
+/**
+ * Add `{ pack_id, version }` to `worlds/<level>/world_behavior_packs.json`
+ * (or `world_resource_packs.json`). If the pack_id already exists, replace its
+ * version. File missing → initialize as `[]`.
+ */
+export async function enablePackInWorld(opts) {
+    await editWorldPackList(opts, "enable");
+}
+/** Remove a pack_id from the world's enable-list JSON. */
+export async function disablePackInWorld(opts) {
+    await editWorldPackList(opts, "disable");
+}
+async function editWorldPackList(opts, mode) {
+    const file = path.join(opts.worldsDir, opts.levelName, opts.kind === "behavior" ? "world_behavior_packs.json" : "world_resource_packs.json");
+    let entries = [];
+    try {
+        const raw = await fs.promises.readFile(file, "utf8");
+        const parsed = JSON.parse(raw);
+        if (Array.isArray(parsed))
+            entries = parsed;
+    }
+    catch {
+        /* missing / corrupt → start with [] */
+        entries = [];
+    }
+    const idx = entries.findIndex((e) => e.pack_id === opts.packUuid);
+    if (mode === "enable") {
+        const next = { pack_id: opts.packUuid, version: opts.version };
+        if (idx >= 0)
+            entries[idx] = next;
+        else
+            entries.push(next);
+    }
+    else {
+        if (idx >= 0)
+            entries.splice(idx, 1);
+    }
+    await fs.promises.mkdir(path.dirname(file), { recursive: true });
+    const tmp = `${file}.${process.pid}.tmp`;
+    await fs.promises.writeFile(tmp, JSON.stringify(entries, null, 2) + "\n", "utf8");
+    await fs.promises.rename(tmp, file);
+}
+/* ── 低层 helpers (Commit 5 实现) ──────────────────────────────────────── */
+export async function writeBehaviorPackManifest(outDir, header) {
+    const manifest = {
+        format_version: 2,
+        header: {
+            name: header.name,
+            uuid: header.uuid,
+            version: header.version,
+            description: header.description ? `${header.description} (behavior pack)` : "SFMC behavior pack",
+            min_engine_version: [1, 21, 0],
+        },
+        modules: [
+            {
+                type: "script",
+                language: "javascript",
+                entry: "scripts/main.js",
+                uuid: crypto.randomUUID(),
+                version: header.version,
+            },
+        ],
+        dependencies: [
+            { module_name: "@minecraft/server", version: "1.18.0" },
+        ],
+    };
+    const file = path.join(outDir, "manifest.json");
+    await fs.promises.mkdir(outDir, { recursive: true });
+    await fs.promises.writeFile(file, JSON.stringify(manifest, null, 2) + "\n", "utf8");
+}
+export async function writeResourcePackManifest(outDir, header) {
+    const manifest = {
+        format_version: 2,
+        header: {
+            name: header.name,
+            uuid: header.uuid,
+            version: header.version,
+            description: header.description ? `${header.description} (resource pack)` : "SFMC resource pack",
+            min_engine_version: [1, 21, 0],
+        },
+        modules: [
+            {
+                type: "resources",
+                uuid: crypto.randomUUID(),
+                version: header.version,
+            },
+        ],
+    };
+    const file = path.join(outDir, "manifest.json");
+    await fs.promises.mkdir(outDir, { recursive: true });
+    await fs.promises.writeFile(file, JSON.stringify(manifest, null, 2) + "\n", "utf8");
+}
+/* Re-export copyFileAsync so callers (e.g. SEA bundle) can copy icon without
+ * pulling in the full fsx surface area. */
+export { copyFileAsync, copyDirAsync };
+/* ── Discovery ─────────────────────────────────────────────────────────── */
+/**
+ * Walk `<modulesDir>/<id>/resource_pack/` for every installed module and
+ * return a map { id: absoluteDir }. Modules without a resource_pack folder
+ * are silently skipped. Used by `assemble-rp` and the sfmc CLI to know which
+ * modules to merge into the resource pack output.
+ */
+export function scanModuleResourcePacks(modulesDir) {
+    const out = {};
+    if (!fs.existsSync(modulesDir))
+        return out;
+    for (const entry of fs.readdirSync(modulesDir, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        const rpDir = path.join(modulesDir, entry.name, "resource_pack");
+        if (fs.existsSync(rpDir)) {
+            out[entry.name] = rpDir;
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=pack-manager.js.map

package/dist/pack-manager.js.map

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

package/dist/paths.d.ts

@@ -0,0 +1,28 @@
+/**
+ * paths.ts — 路径常量 & 加载 bds_updater.json
+ *
+ * ROOT_DIR = 项目根,通过 SDK 统一解析(env SFMC_ROOT > __dirname 上溯)。
+ * SCRIPT_DIR = bds-tools/ 内部 dist 目录,bds 的 PID / log / cache 文件落盘处。
+ */
+import { type BdsUpdaterConfig } from "@sfmc-bds/sdk/node/config";
+/** 项目根目录:bds-tools 的上一级。统一通过 SDK 解析,SEA / npm 一致。 */
+export declare const ROOT_DIR: string;
+export declare const CFG_PATH: string;
+export declare const LOG_PATH: string;
+export declare const VERSION_CACHE: string;
+export declare const PID_FILE: string;
+export declare const ROLLBACK_MARKER: string;
+/** 加载并解析 bds_updater.json。
+ *  启动时 ensure 文件存在,避免 wizard 没跑时 bds_updater.json 缺失导致 loadConfig 抛错。 */
+export declare function loadConfig(): BdsUpdaterConfig;
+/** 解析后的 BDS 路径 / 备份目录 */
+export interface BdsPaths {
+    bds_path: string;
+    backup_dir: string;
+    preserve: string[];
+    cfg: BdsUpdaterConfig;
+}
+export declare function resolvePaths(cfg: BdsUpdaterConfig): BdsPaths;
+/** 删除 PID 文件 */
+export declare function clearPid(): void;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,2BAA2B,CAAC;AAOnC,qDAAqD;AACrD,eAAO,MAAM,QAAQ,EAAE,MAAiE,CAAC;AACzF,eAAO,MAAM,QAAQ,EAAE,MAAiD,CAAC;AACzE,eAAO,MAAM,QAAQ,EAAE,MAA4C,CAAC;AACpE,eAAO,MAAM,aAAa,EAAE,MAAqD,CAAC;AAClF,eAAO,MAAM,QAAQ,EAAE,MAA0C,CAAC;AAClE,eAAO,MAAM,eAAe,EAAE,MAA4D,CAAC;AAE3F;yEACyE;AACzE,wBAAgB,UAAU,IAAI,gBAAgB,CAQ7C;AAED,yBAAyB;AACzB,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,EAAE,gBAAgB,CAAC;CACvB;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,gBAAgB,GAAG,QAAQ,CAS5D;AAED,gBAAgB;AAChB,wBAAgB,QAAQ,IAAI,IAAI,CAM/B"}

package/dist/paths.js

@@ -0,0 +1,47 @@
+/**
+ * paths.ts — 路径常量 & 加载 bds_updater.json
+ *
+ * ROOT_DIR = 项目根,通过 SDK 统一解析(env SFMC_ROOT > __dirname 上溯)。
+ * SCRIPT_DIR = bds-tools/ 内部 dist 目录,bds 的 PID / log / cache 文件落盘处。
+ */
+import { configPath, ensureJsonConfig, resolveRuntimeRoot, } from "@sfmc-bds/sdk/node/config";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const __filename = fileURLToPath(import.meta.url);
+const SCRIPT_DIR = path.dirname(__filename);
+/** 项目根目录:bds-tools 的上一级。统一通过 SDK 解析,SEA / npm 一致。 */
+export const ROOT_DIR = resolveRuntimeRoot(path.resolve(SCRIPT_DIR, "..", ".."));
+export const CFG_PATH = configPath(ROOT_DIR, "bds_updater.json");
+export const LOG_PATH = path.join(SCRIPT_DIR, "update.log");
+export const VERSION_CACHE = path.join(SCRIPT_DIR, ".version_cache.json");
+export const PID_FILE = path.join(SCRIPT_DIR, ".bds.pid");
+export const ROLLBACK_MARKER = path.join(SCRIPT_DIR, ".last_update_rollback.json");
+/** 加载并解析 bds_updater.json。
+ *  启动时 ensure 文件存在,避免 wizard 没跑时 bds_updater.json 缺失导致 loadConfig 抛错。 */
+export function loadConfig() {
+    const cfg = ensureJsonConfig(ROOT_DIR, "bds_updater.json", {});
+    delete cfg._comment;
+    return cfg;
+}
+export function resolvePaths(cfg) {
+    const bds_path = path.resolve(cfg.bds_path || process.cwd());
+    const backup_dir = path.resolve(cfg.backup_dir || path.join(bds_path, "..", "backups"));
+    const relativeBackup = path.relative(bds_path, backup_dir);
+    if (relativeBackup === "" || (!relativeBackup.startsWith("..") && !path.isAbsolute(relativeBackup))) {
+        throw new Error("backup_dir must be outside bds_path so deployment cannot delete the backup");
+    }
+    const preserve = Array.isArray(cfg.preserve) ? cfg.preserve : [];
+    return { bds_path, backup_dir, preserve, cfg };
+}
+/** 删除 PID 文件 */
+export function clearPid() {
+    try {
+        if (fs.existsSync(PID_FILE))
+            fs.unlinkSync(PID_FILE);
+    }
+    catch {
+        /* ignore */
+    }
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,kBAAkB,GAEnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,UAAU,GAAW,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AACpD,qDAAqD;AACrD,MAAM,CAAC,MAAM,QAAQ,GAAW,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AACzF,MAAM,CAAC,MAAM,QAAQ,GAAW,UAAU,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;AACzE,MAAM,CAAC,MAAM,QAAQ,GAAW,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;AACpE,MAAM,CAAC,MAAM,aAAa,GAAW,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC;AAClF,MAAM,CAAC,MAAM,QAAQ,GAAW,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,eAAe,GAAW,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,4BAA4B,CAAC,CAAC;AAE3F;yEACyE;AACzE,MAAM,UAAU,UAAU;IACxB,MAAM,GAAG,GAAG,gBAAgB,CAC1B,QAAQ,EACR,kBAAkB,EAClB,EAAE,CACH,CAAC;IACF,OAAO,GAAG,CAAC,QAAQ,CAAC;IACpB,OAAO,GAAG,CAAC;AACb,CAAC;AAUD,MAAM,UAAU,YAAY,CAAC,GAAqB;IAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7D,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IACxF,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC3D,IAAI,cAAc,KAAK,EAAE,IAAI,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC;QACpG,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAC;IAChG,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;AACjD,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,QAAQ;IACtB,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,YAAY;IACd,CAAC;AACH,CAAC"}

package/dist/qqutil.d.ts

@@ -0,0 +1,13 @@
+/**
+ * qqutil.ts — QQ 通知工具 (基于 LLBot HTTP OneBot 11)
+ *
+ * 改进:
+ *  - sendTimeout 提供总超时，避免通知发送挂死主流程
+ *  - 静默模式 (失败不抛出)，保证主流程不被通知干扰
+ */
+/** 检查 qq-bridge 模块是否启用 */
+export declare function isQqBridgeEnabled(): boolean;
+export declare function sendText(text: string): Promise<void>;
+export declare function sendMixed(segments: unknown[]): Promise<void>;
+export declare function sendWithImage(text: string, base64Img: string): Promise<void>;
+//# sourceMappingURL=qqutil.d.ts.map

package/dist/qqutil.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qqutil.d.ts","sourceRoot":"","sources":["../src/qqutil.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH,0BAA0B;AAC1B,wBAAgB,iBAAiB,IAAI,OAAO,CAQ3C;AA6CD,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAY1D;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAYlE;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMlF"}

package/dist/qqutil.js

@@ -0,0 +1,101 @@
+/**
+ * qqutil.ts — QQ 通知工具 (基于 LLBot HTTP OneBot 11)
+ *
+ * 改进:
+ *  - sendTimeout 提供总超时，避免通知发送挂死主流程
+ *  - 静默模式 (失败不抛出)，保证主流程不被通知干扰
+ */
+import http from "node:http";
+import { configPath, modulePath, readJson } from "@sfmc-bds/sdk/node/config";
+import { ROOT_DIR } from "./paths.js";
+import { log } from "./log.js";
+let cachedCfg = null;
+function getConfig() {
+    if (cachedCfg)
+        return cachedCfg;
+    cachedCfg = (readJson(configPath(ROOT_DIR, "qq_config.json")) ?? {});
+    return cachedCfg;
+}
+/** 检查 qq-bridge 模块是否启用 */
+export function isQqBridgeEnabled() {
+    const catalog = readJson(modulePath(ROOT_DIR, "catalog.json"));
+    const lock = readJson(modulePath(ROOT_DIR, "module-lock.json"));
+    if (!catalog || !lock)
+        return true; // 模块目录缺失则保守视为可用
+    const mod = catalog.modules?.find((m) => m.id === "qq-bridge" || m.configKey === "qq_bridge");
+    return mod ? lock.modules?.[mod.id ?? ""]?.enabled === true : false;
+}
+function sendToLLBot(payload, timeoutMs = 5_000) {
+    const cfg = getConfig();
+    const url = new URL(cfg.llbot_http || "http://127.0.0.1:3000");
+    const data = JSON.stringify(payload);
+    return new Promise((resolve, reject) => {
+        const req = http.request({
+            hostname: url.hostname,
+            port: url.port || 3000,
+            path: "/send_group_msg",
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "Content-Length": Buffer.byteLength(data),
+            },
+            timeout: timeoutMs,
+        }, (res) => {
+            let body = "";
+            res.on("data", (c) => (body += c));
+            res.on("end", () => {
+                if (res.statusCode === 200)
+                    resolve();
+                else
+                    reject(new Error(`LLBot HTTP ${res.statusCode}: ${body.slice(0, 200)}`));
+            });
+        });
+        req.on("timeout", () => {
+            req.destroy(new Error(`LLBot 超时 ${timeoutMs}ms`));
+        });
+        req.on("error", reject);
+        req.write(data);
+        req.end();
+    });
+}
+async function safeSend(label, fn) {
+    try {
+        await fn();
+    }
+    catch (e) {
+        log.warn(`[QQ] ${label} 失败: ${e.message}`);
+    }
+}
+export async function sendText(text) {
+    const cfg = getConfig();
+    if (!isQqBridgeEnabled() || !cfg.qq_group_id) {
+        log.warn("[QQ] qq-bridge 未启用或 qq_group_id 缺失");
+        return;
+    }
+    await safeSend("sendText", () => sendToLLBot({
+        group_id: parseInt(cfg.qq_group_id ?? "0", 10),
+        message: [{ type: "text", data: { text } }],
+    }));
+}
+export async function sendMixed(segments) {
+    const cfg = getConfig();
+    if (!isQqBridgeEnabled() || !cfg.qq_group_id) {
+        log.warn("[QQ] qq-bridge 未启用或 qq_group_id 缺失");
+        return;
+    }
+    await safeSend("sendMixed", () => sendToLLBot({
+        group_id: parseInt(cfg.qq_group_id ?? "0", 10),
+        message: segments,
+    }));
+}
+export async function sendWithImage(text, base64Img) {
+    const segments = [];
+    if (text)
+        segments.push({ type: "text", data: { text } });
+    if (base64Img)
+        segments.push({ type: "image", data: { file: `base64://${base64Img}` } });
+    if (segments.length === 0)
+        return;
+    await sendMixed(segments);
+}
+//# sourceMappingURL=qqutil.js.map

package/dist/qqutil.js.map

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

package/dist/recovery.d.ts

@@ -0,0 +1,8 @@
+/**
+ * recovery.ts — 手动触发回滚
+ *
+ * 用法: node recovery.js
+ * 读取 ROLLBACK_MARKER，然后从备份恢复 preserve 项。
+ */
+export {};
+//# sourceMappingURL=recovery.d.ts.map

package/dist/recovery.d.ts.map

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

package/dist/recovery.js

@@ -0,0 +1,45 @@
+/**
+ * recovery.ts — 手动触发回滚
+ *
+ * 用法: node recovery.js
+ * 读取 ROLLBACK_MARKER，然后从备份恢复 preserve 项。
+ */
+import { readRollbackMarker, rollbackFromBackup } from "./rollback.js";
+import { log, closeLog } from "./log.js";
+import { clearPid } from "./paths.js";
+async function run() {
+    const m = readRollbackMarker();
+    if (!m) {
+        log.warn("未发现回滚标记，无需恢复。");
+        return;
+    }
+    log.info(`发现回滚标记: 时间 ${new Date(m.timestamp).toISOString()}`);
+    log.info(`目标: 从 ${m.backup_dir} 恢复 ${m.preserve.length} 项到 ${m.bds_path}`);
+    const result = rollbackFromBackup(m);
+    if (!result.ok) {
+        log.error(`回滚失败: ${result.reason}`);
+        process.exit(1);
+    }
+    // 清理 pid 文件
+    clearPid();
+    log.info("回滚完成，请手动检查并启动 BDS。");
+}
+function isMain() {
+    if (require.main === module)
+        return true;
+    const entry = process.argv[1] ?? "";
+    return entry.endsWith("recovery.js") || entry.endsWith("recovery.ts");
+}
+if (isMain()) {
+    run()
+        .then(() => {
+        closeLog();
+        process.exit(0);
+    })
+        .catch((e) => {
+        log.error(`未捕获错误: ${e.message}`);
+        closeLog();
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=recovery.js.map

package/dist/recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.js","sourceRoot":"","sources":["../src/recovery.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,KAAK,UAAU,GAAG;IAChB,MAAM,CAAC,GAAG,kBAAkB,EAAE,CAAC;IAC/B,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC1B,OAAO;IACT,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC9D,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,UAAU,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;IAE3E,MAAM,MAAM,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;IACrC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,GAAG,CAAC,KAAK,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,YAAY;IACZ,QAAQ,EAAE,CAAC;IACX,GAAG,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,MAAM;IACb,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACpC,OAAO,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;AACxE,CAAC;AAED,IAAI,MAAM,EAAE,EAAE,CAAC;IACb,GAAG,EAAE;SACF,IAAI,CAAC,GAAG,EAAE;QACT,QAAQ,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;QACX,GAAG,CAAC,KAAK,CAAC,UAAW,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5C,QAAQ,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/rollback.d.ts

@@ -0,0 +1,36 @@
+/**
+ * rollback.ts — 回滚支持
+ *
+ * 在更新开始前记录: 当前 BDS 目录 + 备份目录。
+ * 主流程任意阶段失败时，尝试反向恢复 preserves 到 BDS_PATH，
+ * 然后从备份重新放回 preserve 内容，恢复旧配置。
+ *
+ * 持久化: ROLLBACK_MARKER (BDSTools/.last_update_rollback.json) 用于跨进程记录。
+ */
+import { getDirSize } from "./fsx.js";
+export interface RollbackMarker {
+    timestamp: number;
+    bds_path: string;
+    backup_dir: string;
+    preserve: string[];
+    previous_version: string;
+}
+/** 在备份完成后调用: 记录快照指示符。 */
+export declare function writeRollbackMarker(marker: RollbackMarker): void;
+export declare function clearRollbackMarker(): void;
+export declare function readRollbackMarker(): RollbackMarker | null;
+/**
+ * 紧急回滚: 把 preserve 项从 backup_dir 拷回 bds_path。
+ * 用法: 在 catch 分支调用，如果主流程失败导致 BDS 目录破坏。
+ */
+export declare function rollbackFromBackup(marker: RollbackMarker): {
+    ok: boolean;
+    reason?: string;
+};
+/** 检查 BDS_PATH 中关键文件是否都还在 (更新后完整性 sanity check) */
+export declare function verifyBdsInstall(bds_path: string, expected: string[]): {
+    ok: boolean;
+    missing: string[];
+};
+export { getDirSize };
+//# sourceMappingURL=rollback.d.ts.map

package/dist/rollback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollback.d.ts","sourceRoot":"","sources":["../src/rollback.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,EAAe,UAAU,EAAgB,MAAM,UAAU,CAAC;AAGjE,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,yBAAyB;AACzB,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAOhE;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAM1C;AAED,wBAAgB,kBAAkB,IAAI,cAAc,GAAG,IAAI,CAE1D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CA8B3F;AAED,mDAAmD;AACnD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAMzG;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}