@sfmc-bds/bds-tools 0.1.0

package/dist/rollback.js

@@ -0,0 +1,87 @@
+/**
+ * rollback.ts — 回滚支持
+ *
+ * 在更新开始前记录: 当前 BDS 目录 + 备份目录。
+ * 主流程任意阶段失败时，尝试反向恢复 preserves 到 BDS_PATH，
+ * 然后从备份重新放回 preserve 内容，恢复旧配置。
+ *
+ * 持久化: ROLLBACK_MARKER (BDSTools/.last_update_rollback.json) 用于跨进程记录。
+ */
+import { readJson, writeJson } from "@sfmc-bds/sdk/node/config";
+import fs from "node:fs";
+import path from "node:path";
+import { ROLLBACK_MARKER } from "./paths.js";
+import { copyDirSync, getDirSize, emptyDirSync } from "./fsx.js";
+import { log } from "./log.js";
+/** 在备份完成后调用: 记录快照指示符。 */
+export function writeRollbackMarker(marker) {
+    try {
+        writeJson(ROLLBACK_MARKER, marker);
+        log.info(`[回滚] 已记录回滚标记 -> ${ROLLBACK_MARKER}`);
+    }
+    catch (e) {
+        log.warn(`[回滚] 无法写入标记: ${e.message}`);
+    }
+}
+export function clearRollbackMarker() {
+    try {
+        if (fs.existsSync(ROLLBACK_MARKER))
+            fs.unlinkSync(ROLLBACK_MARKER);
+    }
+    catch {
+        /* ignore */
+    }
+}
+export function readRollbackMarker() {
+    return readJson(ROLLBACK_MARKER) ?? null;
+}
+/**
+ * 紧急回滚: 把 preserve 项从 backup_dir 拷回 bds_path。
+ * 用法: 在 catch 分支调用，如果主流程失败导致 BDS 目录破坏。
+ */
+export function rollbackFromBackup(marker) {
+    const { bds_path, backup_dir, preserve } = marker;
+    if (!fs.existsSync(backup_dir)) {
+        return { ok: false, reason: `备份目录不存在: ${backup_dir}` };
+    }
+    log.warn(`[回滚] 开始恢复 ${preserve.length} 项到 ${bds_path}`);
+    for (const item of preserve) {
+        const src = path.join(backup_dir, item);
+        const dest = path.join(bds_path, item);
+        if (!fs.existsSync(src)) {
+            log.warn(`[回滚] 跳过 (备份中不存在): ${item}`);
+            continue;
+        }
+        try {
+            // 先确保目标目录存在 (BDS 目录可能已被解压覆盖为空)
+            const destDir = path.dirname(dest);
+            if (!fs.existsSync(destDir))
+                fs.mkdirSync(destDir, { recursive: true });
+            if (fs.statSync(src).isDirectory()) {
+                // 先删除目标，再复制目录
+                if (fs.existsSync(dest))
+                    emptyDirSync(dest);
+                copyDirSync(src, dest);
+            }
+            else {
+                fs.copyFileSync(src, dest);
+            }
+            log.info(`[回滚] 已恢复: ${item}`);
+        }
+        catch (e) {
+            log.warn(`[回滚] 恢复失败 ${item}: ${e.message}`);
+        }
+    }
+    return { ok: true };
+}
+/** 检查 BDS_PATH 中关键文件是否都还在 (更新后完整性 sanity check) */
+export function verifyBdsInstall(bds_path, expected) {
+    const missing = [];
+    for (const f of expected) {
+        if (!fs.existsSync(path.join(bds_path, f)))
+            missing.push(f);
+    }
+    return { ok: missing.length === 0, missing };
+}
+export { getDirSize };
+//# sourceMappingURL=rollback.js.map

package/dist/rollback.js.map

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

package/dist/taskbar.d.ts

@@ -0,0 +1,42 @@
+/**
+ * taskbar.ts — Windows Terminal 任务栏进度 (OSC 9;4)
+ *
+ * 通过 OSC 9;4 转义序列直接驱动 Windows Terminal 任务栏图标上的进度条。
+ * 不需要 native 绑定(ffi / ITaskbarList3),但**仅 Windows Terminal 支持**。
+ * cmd.exe / PowerShell ISE 等老终端会忽略该序列,本模块在不支持的终端
+ * 上静默 no-op。
+ *
+ * 兼容性:
+ *   - Windows Terminal  ✅
+ *   - ConEmu / Cmder   ⚠️ 部分
+ *   - cmd.exe / ISE    ❌(不解析 OSC)
+ *
+ * 检测方式:WT_SESSION 或 TERM_PROGRAM === "Windows Terminal"。
+ *
+ * 序列格式(Windows Terminal 私有):
+ *   \x1b]9;4;0;\x07        清除(隐藏)
+ *   \x1b]9;4;1;<pct>\x07   正常(绿,pct 0-100)
+ *   \x1b]9;4;2;<pct>\x07   错误(红,pct 0-100)
+ *   \x1b]9;4;3;\x07        不确定(动画条纹)
+ *
+ * 幂等:相同 state+pct 不重复输出,避免刷屏。
+ *
+ * 用法:
+ *   setTaskbarProgress(50);              // 50% 绿
+ *   setTaskbarProgress(100, "error");    // 100% 红
+ *   clearTaskbarProgress();              // 隐藏
+ */
+type ProgressState = "normal" | "error" | "indeterminate";
+/**
+ * 设置任务栏进度。
+ * - normal: 绿色 (pct 0-100)
+ * - error: 红色 (pct 0-100)
+ * - indeterminate: 动画条纹(pct 忽略)
+ */
+export declare function setTaskbarProgress(pct: number, state?: ProgressState): void;
+/** 清除任务栏进度(隐藏进度条)。幂等。 */
+export declare function clearTaskbarProgress(): void;
+/** 模块是否启用(Windows Terminal 探测结果)。供日志 / 调试。 */
+export declare function isTaskbarSupported(): boolean;
+export {};
+//# sourceMappingURL=taskbar.d.ts.map

package/dist/taskbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskbar.d.ts","sourceRoot":"","sources":["../src/taskbar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,KAAK,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,eAAe,CAAC;AA2B1D;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,aAAwB,GAAG,IAAI,CAmBrF;AAED,yBAAyB;AACzB,wBAAgB,oBAAoB,IAAI,IAAI,CAM3C;AAED,8CAA8C;AAC9C,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C"}

package/dist/taskbar.js

@@ -0,0 +1,94 @@
+/**
+ * taskbar.ts — Windows Terminal 任务栏进度 (OSC 9;4)
+ *
+ * 通过 OSC 9;4 转义序列直接驱动 Windows Terminal 任务栏图标上的进度条。
+ * 不需要 native 绑定(ffi / ITaskbarList3),但**仅 Windows Terminal 支持**。
+ * cmd.exe / PowerShell ISE 等老终端会忽略该序列,本模块在不支持的终端
+ * 上静默 no-op。
+ *
+ * 兼容性:
+ *   - Windows Terminal  ✅
+ *   - ConEmu / Cmder   ⚠️ 部分
+ *   - cmd.exe / ISE    ❌(不解析 OSC)
+ *
+ * 检测方式:WT_SESSION 或 TERM_PROGRAM === "Windows Terminal"。
+ *
+ * 序列格式(Windows Terminal 私有):
+ *   \x1b]9;4;0;\x07        清除(隐藏)
+ *   \x1b]9;4;1;<pct>\x07   正常(绿,pct 0-100)
+ *   \x1b]9;4;2;<pct>\x07   错误(红,pct 0-100)
+ *   \x1b]9;4;3;\x07        不确定(动画条纹)
+ *
+ * 幂等:相同 state+pct 不重复输出,避免刷屏。
+ *
+ * 用法:
+ *   setTaskbarProgress(50);              // 50% 绿
+ *   setTaskbarProgress(100, "error");    // 100% 红
+ *   clearTaskbarProgress();              // 隐藏
+ */
+function detect() {
+    if (process.platform !== "win32")
+        return false;
+    if (process.env["WT_SESSION"])
+        return true;
+    if (process.env["TERM_PROGRAM"] === "Windows Terminal")
+        return true;
+    return false;
+}
+let supported = detect();
+let active = false;
+let lastPct = -1;
+let lastState = 0;
+function stateCode(s) {
+    switch (s) {
+        case "clear":
+            return 0;
+        case "normal":
+            return 1;
+        case "error":
+            return 2;
+        case "indeterminate":
+            return 3;
+    }
+}
+/**
+ * 设置任务栏进度。
+ * - normal: 绿色 (pct 0-100)
+ * - error: 红色 (pct 0-100)
+ * - indeterminate: 动画条纹(pct 忽略)
+ */
+export function setTaskbarProgress(pct, state = "normal") {
+    if (!supported)
+        return;
+    if (state === "indeterminate") {
+        if (lastState === 3)
+            return; // 已在 indeterminate,不再重发
+        process.stdout.write("\x1b]9;4;3\x07");
+        lastState = 3;
+        lastPct = -1;
+        active = true;
+        return;
+    }
+    const p = Math.max(0, Math.min(100, Math.round(pct)));
+    const sc = stateCode(state);
+    if (lastState === sc && lastPct === p)
+        return; // 无变化,跳过
+    process.stdout.write(`\x1b]9;4;${sc};${p}\x07`);
+    lastPct = p;
+    lastState = sc;
+    active = true;
+}
+/** 清除任务栏进度(隐藏进度条)。幂等。 */
+export function clearTaskbarProgress() {
+    if (!supported || !active)
+        return;
+    process.stdout.write("\x1b]9;4;0\x07");
+    lastPct = -1;
+    lastState = 0;
+    active = false;
+}
+/** 模块是否启用(Windows Terminal 探测结果)。供日志 / 调试。 */
+export function isTaskbarSupported() {
+    return supported;
+}
+//# sourceMappingURL=taskbar.js.map

package/dist/taskbar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskbar.js","sourceRoot":"","sources":["../src/taskbar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH,SAAS,MAAM;IACb,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IAC/C,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,kBAAkB;QAAE,OAAO,IAAI,CAAC;IACpE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,IAAI,SAAS,GAAG,MAAM,EAAE,CAAC;AACzB,IAAI,MAAM,GAAG,KAAK,CAAC;AACnB,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC;AACjB,IAAI,SAAS,GAAkB,CAAC,CAAC;AAEjC,SAAS,SAAS,CAAC,CAA0B;IAC3C,QAAQ,CAAC,EAAE,CAAC;QACV,KAAK,OAAO;YACV,OAAO,CAAC,CAAC;QACX,KAAK,QAAQ;YACX,OAAO,CAAC,CAAC;QACX,KAAK,OAAO;YACV,OAAO,CAAC,CAAC;QACX,KAAK,eAAe;YAClB,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,QAAuB,QAAQ;IAC7E,IAAI,CAAC,SAAS;QAAE,OAAO;IAEvB,IAAI,KAAK,KAAK,eAAe,EAAE,CAAC;QAC9B,IAAI,SAAS,KAAK,CAAC;YAAE,OAAO,CAAC,wBAAwB;QACrD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACvC,SAAS,GAAG,CAAC,CAAC;QACd,OAAO,GAAG,CAAC,CAAC,CAAC;QACb,MAAM,GAAG,IAAI,CAAC;QACd,OAAO;IACT,CAAC;IAED,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACtD,MAAM,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,SAAS,KAAK,EAAE,IAAI,OAAO,KAAK,CAAC;QAAE,OAAO,CAAC,SAAS;IACxD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAChD,OAAO,GAAG,CAAC,CAAC;IACZ,SAAS,GAAG,EAAE,CAAC;IACf,MAAM,GAAG,IAAI,CAAC;AAChB,CAAC;AAED,yBAAyB;AACzB,MAAM,UAAU,oBAAoB;IAClC,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM;QAAE,OAAO;IAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACvC,OAAO,GAAG,CAAC,CAAC,CAAC;IACb,SAAS,GAAG,CAAC,CAAC;IACd,MAAM,GAAG,KAAK,CAAC;AACjB,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,kBAAkB;IAChC,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,56 @@
+/**
+ * types.ts — BDSTools 共享类型
+ */
+export interface BdsUpdaterConfig {
+    bds_path?: string;
+    backup_dir?: string;
+    channel?: "release" | "preview" | string;
+    auto_restart?: boolean;
+    auto_check?: boolean;
+    crash_restart?: boolean;
+    crash_restart_delay?: number;
+    qq_notify?: boolean;
+    qq_config?: string;
+    preserve?: string[];
+    version_mode?: "bedrock-oss" | "endstone";
+    version_versions?: string;
+    version_versions_mirror?: string;
+    version_details?: string;
+    version_details_mirror?: string;
+    download_mirror?: string;
+    cdn_root?: string;
+    download_timeout?: number;
+    compatible_versions?: string[];
+    _hash?: {
+        sha1: string;
+        sha256: string;
+    };
+}
+export interface VersionInfo {
+    version: string;
+    cdnRoot: string;
+}
+export interface VersionDetails {
+    downloadUrl: string;
+    sha1: string;
+    sha256: string;
+    size: number;
+}
+export interface UpdateOutcome {
+    ok: boolean;
+    currentVer: string;
+    latestVer: string;
+    backupPath: string | null;
+    durationMs: number;
+}
+export interface ChangelogPayload {
+    text: string;
+    imageBase64: string | null;
+}
+export type LogLevel = "info" | "warn" | "error";
+export interface Logger {
+    info(msg: string): void;
+    warn(msg: string): void;
+    error(msg: string): void;
+}
+//# 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":"AAAA;;GAEG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IACzC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAGpB,YAAY,CAAC,EAAE,aAAa,GAAG,UAAU,CAAC;IAC1C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAG1B,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAG/B,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEjD,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * types.ts — BDSTools 共享类型
+ */
+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;;GAEG"}

package/dist/upstream.d.ts

@@ -0,0 +1,20 @@
+/**
+ * upstream.ts — 版本源 / 下载源 / 哈希校验
+ *
+ * 改进:
+ *  - 3 次重试 + 指数退避
+ *  - sha1 / sha256 同时校验
+ *  - 流式校验 + 边下边校验
+ */
+import type { BdsUpdaterConfig, VersionDetails, VersionInfo } from "./types.js";
+/** 获取最新版本号 (含 cdn_root)，3 次重试 */
+export declare function getVersionInfo(cfg: BdsUpdaterConfig, channel: string): Promise<VersionInfo>;
+/** 获取 per-version 的下载链接 + 哈希 (fallback GitHub → jsdelivr) */
+export declare function fetchVersionDetails(cfg: BdsUpdaterConfig, channel: string, version: string): Promise<VersionDetails>;
+/** 候选下载 URL (按优先级) */
+export declare function buildDownloadUrls(cfg: BdsUpdaterConfig, channel: string, version: string, details: VersionDetails): string[];
+/** 同步 / 异步校验文件哈希 */
+export declare function verifyFileHash(filePath: string, expectedSha1: string, expectedSha256: string): Promise<boolean>;
+/** 检查版本兼容性 (白名单) */
+export declare function isVersionCompatible(cfg: BdsUpdaterConfig, version: string): boolean;
+//# sourceMappingURL=upstream.d.ts.map

package/dist/upstream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upstream.d.ts","sourceRoot":"","sources":["../src/upstream.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAchF,iCAAiC;AACjC,wBAAsB,cAAc,CAAC,GAAG,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA8BjG;AAED,6DAA6D;AAC7D,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,cAAc,CAAC,CA2BzB;AAED,sBAAsB;AACtB,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,cAAc,GACtB,MAAM,EAAE,CAeV;AAED,oBAAoB;AACpB,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAiBrH;AAED,oBAAoB;AACpB,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAInF"}

package/dist/upstream.js

@@ -0,0 +1,126 @@
+/**
+ * upstream.ts — 版本源 / 下载源 / 哈希校验
+ *
+ * 改进:
+ *  - 3 次重试 + 指数退避
+ *  - sha1 / sha256 同时校验
+ *  - 流式校验 + 边下边校验
+ */
+import crypto from "node:crypto";
+import fs from "node:fs";
+import { fetchJsonWithFallback } from "./http.js";
+import { log } from "./log.js";
+import { toVer3 } from "./version.js";
+const DEFAULT_VERSIONS_API = "https://raw.githubusercontent.com/Bedrock-OSS/BDS-Versions/main/versions.json";
+const DEFAULT_VERSIONS_MIRROR = "https://cdn.jsdelivr.net/gh/Bedrock-OSS/BDS-Versions@main/versions.json";
+function resolveTemplate(tpl, vars) {
+    let s = tpl;
+    for (const [k, v] of Object.entries(vars)) {
+        s = s.replace(new RegExp(`\\{${k}\\}`, "g"), v);
+    }
+    return s;
+}
+/** 获取最新版本号 (含 cdn_root)，3 次重试 */
+export async function getVersionInfo(cfg, channel) {
+    const api = cfg.version_versions || process.env["BDS_VERSIONS_API"] || DEFAULT_VERSIONS_API;
+    const mirror = cfg.version_versions_mirror || process.env["BDS_VERSIONS_MIRROR"] || DEFAULT_VERSIONS_MIRROR;
+    const sources = [api, mirror].filter(Boolean);
+    const versionMode = cfg.version_mode || "bedrock-oss";
+    let lastErr;
+    for (let attempt = 1; attempt <= 3; attempt++) {
+        try {
+            const json = await fetchJsonWithFallback(sources);
+            let ver;
+            if (versionMode === "endstone") {
+                const entry = channel === "preview" ? json.preview : json.release;
+                ver = entry?.latest;
+            }
+            else {
+                const platform = json.windows || json.linux;
+                ver = channel === "preview" ? platform?.preview : platform?.stable;
+            }
+            if (!ver)
+                throw new Error("未找到最新版本号");
+            return { version: ver, cdnRoot: json.cdn_root ?? "" };
+        }
+        catch (e) {
+            lastErr = e;
+            if (attempt < 3) {
+                const wait = attempt * 3000;
+                log.warn(`版本号获取失败 (${attempt}/3): ${e.message}，${wait / 1000}s 后重试...`);
+                await new Promise((r) => setTimeout(r, wait));
+            }
+        }
+    }
+    throw lastErr instanceof Error ? lastErr : new Error("版本号获取失败");
+}
+/** 获取 per-version 的下载链接 + 哈希 (fallback GitHub → jsdelivr) */
+export async function fetchVersionDetails(cfg, channel, version) {
+    const platform = channel === "preview" ? "windows_preview" : "windows";
+    const ch = channel === "preview" ? "preview" : "release";
+    const vars = { version, ver3: toVer3(version), platform, channel: ch };
+    const detailsTpl = cfg.version_details || "https://raw.githubusercontent.com/Bedrock-OSS/BDS-Versions/main/{platform}/{version}.json";
+    const mirrorTpl = cfg.version_details_mirror || "https://cdn.jsdelivr.net/gh/Bedrock-OSS/BDS-Versions@main/{platform}/{version}.json";
+    const sources = [detailsTpl, mirrorTpl].filter(Boolean).map((t) => resolveTemplate(t, vars));
+    const json = await fetchJsonWithFallback(sources);
+    const mode = cfg.version_mode || "bedrock-oss";
+    if (mode === "endstone") {
+        const bw = json.binary?.windows;
+        return {
+            downloadUrl: bw?.url ?? "",
+            sha1: "",
+            sha256: bw?.sha256 ?? "",
+            size: bw?.size_in_bytes ?? 0,
+        };
+    }
+    return {
+        downloadUrl: json.download_url ?? "",
+        sha1: json.sha1 ?? "",
+        sha256: "",
+        size: json.size_in_bytes ?? 0,
+    };
+}
+/** 候选下载 URL (按优先级) */
+export function buildDownloadUrls(cfg, channel, version, details) {
+    const urls = [];
+    if (cfg.download_mirror) {
+        const mirrorVer = channel === "preview" ? `${version}-preview` : version;
+        urls.push(resolveTemplate(cfg.download_mirror, { version: mirrorVer }));
+    }
+    if (details.downloadUrl)
+        urls.push(details.downloadUrl);
+    const cdnRoot = cfg.cdn_root || "https://www.minecraft.net/bedrockdedicatedserver";
+    const suffix = channel === "preview"
+        ? `/bin-win-preview/bedrock-server-${version}-preview.zip`
+        : `/bin-win/bedrock-server-${version}.zip`;
+    urls.push(cdnRoot + suffix);
+    urls.push(`https://minecraft.azureedge.net${suffix}`);
+    return [...new Set(urls)];
+}
+/** 同步 / 异步校验文件哈希 */
+export async function verifyFileHash(filePath, expectedSha1, expectedSha256) {
+    const expected = expectedSha256 || expectedSha1;
+    if (!expected)
+        return true;
+    const algo = expectedSha256 ? "sha256" : "sha1";
+    return new Promise((resolve, reject) => {
+        const h = crypto.createHash(algo);
+        const stream = fs.createReadStream(filePath);
+        stream.on("data", (chunk) => {
+            h.update(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
+        });
+        stream.on("end", () => {
+            const actual = h.digest("hex").toLowerCase();
+            resolve(actual === expected.toLowerCase());
+        });
+        stream.on("error", reject);
+    });
+}
+/** 检查版本兼容性 (白名单) */
+export function isVersionCompatible(cfg, version) {
+    const allow = cfg.compatible_versions;
+    if (!allow || allow.length === 0)
+        return true;
+    return allow.includes(version) || allow.includes(toVer3(version));
+}
+//# sourceMappingURL=upstream.js.map

package/dist/upstream.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,20 @@
+/**
+ * version.ts — 版本号工具 / 版本缓存
+ */
+/** 4段 → 3段 (去尾) */
+export declare function toVer3(v: string): string;
+/** 3段 → 4段 (补 0) */
+export declare function toVer4(v: string): string;
+/** 版本比较 (按 4 段数字排序) */
+export declare function compareVersions(a: string, b: string): number;
+/** 简单的真值校验 (按版本号外形) */
+export declare function isValidVersion(v: string): boolean;
+export declare function saveVersionCache(version: string, sha256: string): void;
+/**
+ * 异步识别当前 BDS 版本
+ * 优先通过 SHA256 反查缓存，失败则回退 `current_version.txt`（如果存在）
+ */
+export declare function getCurrentVersionAsync(exePath: string): Promise<string>;
+/** 同步版本 (兼容旧流程) */
+export declare function getCurrentVersionSync(exePath: string): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,mBAAmB;AACnB,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAExC;AAED,oBAAoB;AACpB,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAIxC;AAED,uBAAuB;AACvB,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAc5D;AAED,uBAAuB;AACvB,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAEjD;AAoBD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAQtE;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAW7E;AAED,mBAAmB;AACnB,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAU7D"}

package/dist/version.js

@@ -0,0 +1,97 @@
+/**
+ * version.ts — 版本号工具 / 版本缓存
+ */
+import { readJson, writeJson } from "@sfmc-bds/sdk/node/config";
+import fs from "node:fs";
+import { VERSION_CACHE } from "./paths.js";
+import { hashFileSync, hashFileAsync } from "./fsx.js";
+import { log } from "./log.js";
+/** 4段 → 3段 (去尾) */
+export function toVer3(v) {
+    return v.split(".").slice(0, 3).join(".");
+}
+/** 3段 → 4段 (补 0) */
+export function toVer4(v) {
+    const p = v.split(".");
+    while (p.length < 4)
+        p.push("0");
+    return p.join(".");
+}
+/** 版本比较 (按 4 段数字排序) */
+export function compareVersions(a, b) {
+    const sa = a.replace(/-preview$/, "");
+    const sb = b.replace(/-preview$/, "");
+    const pa = sa.split(".").map(Number);
+    const pb = sb.split(".").map(Number);
+    for (let i = 0; i < 4; i++) {
+        const ai = pa[i] ?? 0;
+        const bi = pb[i] ?? 0;
+        if (ai !== bi)
+            return ai - bi;
+    }
+    // preview 低于不带 -preview 的同一数字
+    if (a.endsWith("-preview") && !b.endsWith("-preview"))
+        return -1;
+    if (!a.endsWith("-preview") && b.endsWith("-preview"))
+        return 1;
+    return 0;
+}
+/** 简单的真值校验 (按版本号外形) */
+export function isValidVersion(v) {
+    return /^\d+\.\d+\.\d+(\.\d+)?(-preview)?$/.test(v);
+}
+function readCache() {
+    return readJson(VERSION_CACHE) ?? {};
+}
+/** 仅保留最近 3 条版本缓存 (避免无限增长) */
+function trimCache(cache) {
+    const keys = Object.keys(cache).sort(compareVersions).slice(-3);
+    const trimmed = {};
+    for (const k of keys)
+        trimmed[k] = cache[k];
+    return trimmed;
+}
+export function saveVersionCache(version, sha256) {
+    const cache = readCache();
+    cache[version] = { sha256, verified_at: Date.now() };
+    try {
+        writeJson(VERSION_CACHE, trimCache(cache));
+    }
+    catch {
+        /* ignore */
+    }
+}
+/**
+ * 异步识别当前 BDS 版本
+ * 优先通过 SHA256 反查缓存，失败则回退 `current_version.txt`（如果存在）
+ */
+export async function getCurrentVersionAsync(exePath) {
+    if (!fs.existsSync(exePath))
+        return "0.0.0.0";
+    const actual = await hashFileAsync(exePath, "sha256");
+    if (!actual)
+        return "0.0.0.0";
+    const cache = readCache();
+    for (const [ver, entry] of Object.entries(cache)) {
+        if (entry.sha256 === actual)
+            return ver;
+    }
+    log.warn("[BDSUpdater] bedrock_server.exe 哈希未匹配缓存，疑似被改动或首次启动");
+    return "0.0.0.0";
+}
+/** 同步版本 (兼容旧流程) */
+export function getCurrentVersionSync(exePath) {
+    if (!fs.existsSync(exePath))
+        return "0.0.0.0";
+    const actual = hashFileSync(exePath, "sha256");
+    if (!actual)
+        return "0.0.0.0";
+    const cache = readCache();
+    for (const [ver, entry] of Object.entries(cache)) {
+        if (entry.sha256 === actual)
+            return ver;
+    }
+    log.warn("[BDSUpdater] bedrock_server.exe 哈希未匹配缓存");
+    return "0.0.0.0";
+}
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

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