@sfmc-bds/bds-tools 0.1.0

package/dist/fsx.d.ts

@@ -0,0 +1,25 @@
+/**
+ * fsx.ts — 异步/流式文件操作 (避免大文件加载进内存)
+ */
+/**
+ * 流式计算文件哈希 (sha1 / sha256)，
+ * 用于大文件 (例如 bedrock_server.exe ~80MB)，不会 OOM。
+ */
+export declare function hashFileAsync(filePath: string, algo?: "sha1" | "sha256"): Promise<string>;
+/** 同步版本（用于小文件） */
+export declare function hashFileSync(filePath: string, algo?: "sha1" | "sha256"): string;
+/** 同步流式拷贝单文件 (复制中) */
+export declare function copyFileAsync(src: string, dest: string): Promise<void>;
+/** 同步目录复制 (递归) */
+export declare function copyDirSync(src: string, dest: string): void;
+/** 异步目录复制 (基于流) */
+export declare function copyDirAsync(src: string, dest: string): Promise<void>;
+/** 计算目录大小 (字节) */
+export declare function getDirSize(dir: string): number;
+/** 强制清空目录内容 (但保留目录本身) */
+export declare function emptyDirSync(dir: string): void;
+/** 安全删除整个目录 */
+export declare function rmSafe(path: string): void;
+/** 安全写文件 (原子: 写临时文件 → rename) */
+export declare function writeFileSafe(filePath: string, data: string | Buffer): void;
+//# sourceMappingURL=fsx.d.ts.map

package/dist/fsx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsx.d.ts","sourceRoot":"","sources":["../src/fsx.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;;GAGG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,GAAG,QAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAUzG;AAED,kBAAkB;AAClB,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,GAAG,QAAmB,GAAG,MAAM,CAQzF;AAED,sBAAsB;AACtB,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5E;AAED,kBAAkB;AAClB,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAW3D;AAED,mBAAmB;AACnB,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAc3E;AAED,kBAAkB;AAClB,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAU9C;AAED,yBAAyB;AACzB,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAY9C;AAED,eAAe;AACf,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAMzC;AAED,iCAAiC;AACjC,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM3E"}

package/dist/fsx.js

@@ -0,0 +1,117 @@
+/**
+ * fsx.ts — 异步/流式文件操作 (避免大文件加载进内存)
+ */
+import fs from "node:fs";
+import path from "node:path";
+import crypto from "node:crypto";
+import { pipeline } from "node:stream/promises";
+/**
+ * 流式计算文件哈希 (sha1 / sha256)，
+ * 用于大文件 (例如 bedrock_server.exe ~80MB)，不会 OOM。
+ */
+export async function hashFileAsync(filePath, algo = "sha256") {
+    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", () => resolve(h.digest("hex").toLowerCase()));
+        stream.on("error", reject);
+    });
+}
+/** 同步版本（用于小文件） */
+export function hashFileSync(filePath, algo = "sha256") {
+    try {
+        const h = crypto.createHash(algo);
+        h.update(fs.readFileSync(filePath));
+        return h.digest("hex").toLowerCase();
+    }
+    catch {
+        return "";
+    }
+}
+/** 同步流式拷贝单文件 (复制中) */
+export async function copyFileAsync(src, dest) {
+    await pipeline(fs.createReadStream(src), fs.createWriteStream(dest));
+}
+/** 同步目录复制 (递归) */
+export function copyDirSync(src, dest) {
+    fs.mkdirSync(dest, { recursive: true });
+    for (const entry of fs.readdirSync(src)) {
+        const srcPath = path.join(src, entry);
+        const destPath = path.join(dest, entry);
+        if (fs.statSync(srcPath).isDirectory()) {
+            copyDirSync(srcPath, destPath);
+        }
+        else {
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+/** 异步目录复制 (基于流) */
+export async function copyDirAsync(src, dest) {
+    fs.mkdirSync(dest, { recursive: true });
+    await Promise.all(fs.readdirSync(src).map(async (entry) => {
+        const srcPath = path.join(src, entry);
+        const destPath = path.join(dest, entry);
+        const stat = fs.statSync(srcPath);
+        if (stat.isDirectory()) {
+            await copyDirAsync(srcPath, destPath);
+        }
+        else {
+            await copyFileAsync(srcPath, destPath);
+        }
+    }));
+}
+/** 计算目录大小 (字节) */
+export function getDirSize(dir) {
+    let total = 0;
+    try {
+        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory())
+                total += getDirSize(full);
+            else if (entry.isFile())
+                total += fs.statSync(full).size;
+        }
+    }
+    catch { }
+    return total;
+}
+/** 强制清空目录内容 (但保留目录本身) */
+export function emptyDirSync(dir) {
+    if (!fs.existsSync(dir))
+        return;
+    for (const entry of fs.readdirSync(dir)) {
+        const full = path.join(dir, entry);
+        try {
+            const stat = fs.statSync(full);
+            if (stat.isDirectory())
+                fs.rmSync(full, { recursive: true, force: true });
+            else
+                fs.unlinkSync(full);
+        }
+        catch (e) {
+            // 忽略: 顶层仍保留目录，即使部分子项无法删除
+        }
+    }
+}
+/** 安全删除整个目录 */
+export function rmSafe(path) {
+    try {
+        fs.rmSync(path, { recursive: true, force: true });
+    }
+    catch {
+        /* ignore */
+    }
+}
+/** 安全写文件 (原子: 写临时文件 → rename) */
+export function writeFileSafe(filePath, data) {
+    const dir = path.dirname(filePath);
+    fs.mkdirSync(dir, { recursive: true });
+    const tmp = `${filePath}.${process.pid}.tmp`;
+    fs.writeFileSync(tmp, data);
+    fs.renameSync(tmp, filePath);
+}
+//# sourceMappingURL=fsx.js.map

package/dist/fsx.js.map

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

package/dist/http.d.ts

@@ -0,0 +1,37 @@
+/**
+ * http.ts — 稳定 HTTP 工具 (分阶段超时 + 自动重定向 + 流式下载)
+ *
+ * 改进:
+ *  - connect timeout vs total timeout 分开
+ *  - 下载通过流管道，避免大文件加载到内存
+ *  - 失败后已写入的临时文件可被清理
+ */
+interface HttpOptions {
+    method?: "GET" | "HEAD" | "POST";
+    headers?: Record<string, string>;
+    body?: string;
+    connectTimeoutMs?: number;
+    totalTimeoutMs?: number;
+    redirects?: number;
+}
+export declare function httpRequest(url: string, opts?: HttpOptions): Promise<{
+    statusCode: number;
+    body: Buffer;
+    headers: Record<string, string | string[] | undefined>;
+}>;
+export declare function httpGetJson<T = unknown>(url: string, opts?: HttpOptions): Promise<T>;
+export declare function httpGetText(url: string, opts?: HttpOptions): Promise<string>;
+/** 多个源并发请求，谁先成功返回（每个源都用 JSON 解析，解析失败也失败） */
+export declare function fetchJsonWithFallback<T = unknown>(sources: string[], timeoutMs?: number): Promise<T>;
+/**
+ * 流式下载到指定路径，返回字节数。
+ * - 失败时自动清理 partial 文件
+ * - 支持 progress 回调
+ * - 支持 connect/total 阶段超时
+ */
+export interface DownloadOptions extends HttpOptions {
+    onProgress?: (downloaded: number, total: number) => void;
+}
+export declare function httpDownload(url: string, destPath: string, opts?: DownloadOptions): Promise<number>;
+export {};
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,UAAU,WAAW;IACnB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAA;CAAE,CAAC,CA2DvG;AAED,wBAAsB,WAAW,CAAC,CAAC,GAAG,OAAO,EAC3C,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAGtF;AAED,4CAA4C;AAC5C,wBAAsB,qBAAqB,CAAC,CAAC,GAAG,OAAO,EACrD,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,SAAS,GACjB,OAAO,CAAC,CAAC,CAAC,CAcZ;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1D;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,MAAM,CAAC,CAwGjB"}

package/dist/http.js

@@ -0,0 +1,203 @@
+/**
+ * http.ts — 稳定 HTTP 工具 (分阶段超时 + 自动重定向 + 流式下载)
+ *
+ * 改进:
+ *  - connect timeout vs total timeout 分开
+ *  - 下载通过流管道，避免大文件加载到内存
+ *  - 失败后已写入的临时文件可被清理
+ */
+import http from "node:http";
+import https from "node:https";
+import { pipeline } from "node:stream/promises";
+import { createWriteStream, statSync } from "node:fs";
+import { log } from "./log.js";
+const MAX_REDIRECTS = 5;
+const DEFAULT_CONNECT_TIMEOUT = 15_000;
+const DEFAULT_TOTAL_TIMEOUT = 600_000;
+export async function httpRequest(url, opts = {}) {
+    const redirects = opts.redirects ?? 0;
+    const totalTimeoutMs = opts.totalTimeoutMs ?? DEFAULT_TOTAL_TIMEOUT;
+    const connectTimeoutMs = opts.connectTimeoutMs ?? DEFAULT_CONNECT_TIMEOUT;
+    const u = new URL(url);
+    const isHttps = u.protocol === "https:";
+    const mod = isHttps ? https : http;
+    return new Promise((resolve, reject) => {
+        const req = mod.request({
+            hostname: u.hostname,
+            port: u.port || (isHttps ? 443 : 80),
+            path: u.pathname + u.search,
+            method: opts.method ?? "GET",
+            headers: { "User-Agent": "BDSUpdater/2.0", ...(opts.headers ?? {}) },
+        }, (res) => {
+            const chunks = [];
+            res.on("data", (c) => chunks.push(c));
+            res.on("end", () => {
+                const body = Buffer.concat(chunks);
+                const status = res.statusCode ?? 0;
+                // 3xx → 跟随 Location
+                if (status >= 300 && status < 400 && redirects < MAX_REDIRECTS) {
+                    const loc = res.headers.location;
+                    if (!loc)
+                        return reject(new Error(`HTTP ${status} 但缺少 Location`));
+                    const next = loc.startsWith("http") ? loc : new URL(loc, url).href;
+                    httpRequest(next, { ...opts, redirects: redirects + 1 })
+                        .then(resolve)
+                        .catch(reject);
+                    return;
+                }
+                if (status >= 400) {
+                    return reject(new Error(`HTTP ${status} for ${url}`));
+                }
+                resolve({ statusCode: status, body, headers: res.headers });
+            });
+        });
+        const totalTimer = setTimeout(() => {
+            req.destroy(new Error(`HTTP 总超时 ${totalTimeoutMs}ms: ${url}`));
+        }, totalTimeoutMs);
+        const connectTimer = setTimeout(() => {
+            req.destroy(new Error(`HTTP 连接超时 ${connectTimeoutMs}ms: ${url}`));
+        }, connectTimeoutMs);
+        req.on("socket", () => clearTimeout(connectTimer));
+        req.on("error", (err) => {
+            clearTimeout(totalTimer);
+            clearTimeout(connectTimer);
+            reject(err);
+        });
+        if (opts.body)
+            req.write(opts.body);
+        req.end();
+    });
+}
+export async function httpGetJson(url, opts = {}) {
+    const res = await httpRequest(url, opts);
+    try {
+        return JSON.parse(res.body.toString("utf-8"));
+    }
+    catch (e) {
+        throw new Error(`JSON 解析失败 ${url}: ${e.message}`);
+    }
+}
+export async function httpGetText(url, opts = {}) {
+    const res = await httpRequest(url, opts);
+    return res.body.toString("utf-8");
+}
+/** 多个源并发请求，谁先成功返回（每个源都用 JSON 解析，解析失败也失败） */
+export async function fetchJsonWithFallback(sources, timeoutMs = 15_000) {
+    const tasks = sources.map(async (url) => {
+        const res = await httpGetJson(url, { totalTimeoutMs: timeoutMs });
+        return { url, value: res };
+    });
+    const settled = await Promise.allSettled(tasks);
+    for (const r of settled) {
+        if (r.status === "fulfilled")
+            return r.value.value;
+    }
+    const errors = settled
+        .filter((r) => r.status === "rejected")
+        .map((r) => r.reason?.message ?? "unknown")
+        .join("; ");
+    throw new Error(`所有源均不可用: ${errors}`);
+}
+export async function httpDownload(url, destPath, opts = {}) {
+    const totalTimeoutMs = opts.totalTimeoutMs ?? DEFAULT_TOTAL_TIMEOUT;
+    const connectTimeoutMs = opts.connectTimeoutMs ?? DEFAULT_CONNECT_TIMEOUT;
+    const u = new URL(url);
+    const isHttps = u.protocol === "https:";
+    const mod = isHttps ? https : http;
+    let redirects = opts.redirects ?? 0;
+    return new Promise((resolve, reject) => {
+        const req = mod.request({
+            hostname: u.hostname,
+            port: u.port || (isHttps ? 443 : 80),
+            path: u.pathname + u.search,
+            method: "GET",
+            headers: { "User-Agent": "BDSUpdater/2.0", ...(opts.headers ?? {}) },
+        }, (res) => {
+            const status = res.statusCode ?? 0;
+            if (status >= 300 && status < 400 && redirects < MAX_REDIRECTS) {
+                const loc = res.headers.location;
+                if (!loc)
+                    return reject(new Error(`HTTP ${status} 缺少 Location`));
+                redirects++;
+                const next = loc.startsWith("http") ? loc : new URL(loc, url).href;
+                res.resume();
+                httpDownload(next, destPath, { ...opts, redirects })
+                    .then(resolve)
+                    .catch(reject);
+                return;
+            }
+            if (status >= 400)
+                return reject(new Error(`HTTP ${status} for ${url}`));
+            const total = parseInt(String(res.headers["content-length"] ?? 0), 10) || 0;
+            const file = createWriteStream(destPath);
+            let downloaded = 0;
+            let failed = false;
+            // 节流进度回调:每个 tick 最多 10 次/秒(100ms 间隔),
+            // 避免 cli-progress 频繁重绘拖慢下载
+            let lastProgressAt = 0;
+            const PROGRESS_INTERVAL_MS = 100;
+            const handleError = (e) => {
+                if (failed)
+                    return;
+                failed = true;
+                file.close();
+                // 清理 partial 文件
+                import("node:fs").then((fs) => {
+                    try {
+                        fs.unlinkSync(destPath);
+                    }
+                    catch { }
+                });
+                reject(e);
+            };
+            const stream = res;
+            stream.on("data", (chunk) => {
+                downloaded += chunk.length;
+                if (opts.onProgress && total) {
+                    const now = Date.now();
+                    if (now - lastProgressAt >= PROGRESS_INTERVAL_MS) {
+                        lastProgressAt = now;
+                        opts.onProgress(downloaded, total);
+                    }
+                }
+            });
+            stream.on("error", (e) => handleError(e));
+            file.on("error", (e) => handleError(e));
+            pipeline(stream, file).catch((e) => {
+                if (!failed)
+                    handleError(e);
+            });
+            // 不能直接监听 file 'finish' 因为我们在错误时手动 handleError
+            file.on("finish", () => {
+                if (failed)
+                    return;
+                try {
+                    const finalBytes = statSync(destPath).size;
+                    // 收尾:确保最后一次回调让进度条走到 100%(即便最近
+                    // 一个 tick 的节流没触发,也补一次)
+                    if (opts.onProgress && total)
+                        opts.onProgress(finalBytes, total);
+                    resolve(finalBytes);
+                }
+                catch (e) {
+                    reject(e);
+                }
+            });
+        });
+        const totalTimer = setTimeout(() => {
+            req.destroy(new Error(`下载总超时 ${totalTimeoutMs}ms: ${url}`));
+        }, totalTimeoutMs);
+        const connectTimer = setTimeout(() => {
+            req.destroy(new Error(`下载连接超时 ${connectTimeoutMs}ms: ${url}`));
+        }, connectTimeoutMs);
+        req.on("socket", () => clearTimeout(connectTimer));
+        req.on("error", (e) => {
+            clearTimeout(totalTimer);
+            clearTimeout(connectTimer);
+            log.warn(`HTTP 错误 ${url}: ${e.message}`);
+            reject(e);
+        });
+        req.end();
+    });
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/log.d.ts

@@ -0,0 +1,13 @@
+/**
+ * log.ts — bds-tools 统一日志实例
+ *
+ * 通过 @sfmc-bds/logs 共享包接入,source = "bds-tools"。
+ * 同时输出 stdout + 落盘到 LOG_PATH (update.log)。
+ *
+ * check-update.ts 是独立入口,用 source = "updater" 单独创建 logger,
+ * 见该文件内的 createUpdaterLogger()。
+ */
+export declare const log: import("@sfmc-bds/sdk/logs").Logger;
+/** 关闭文件流 (进程退出前调用,确保缓冲落盘) */
+export declare function closeLog(): void;
+//# 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;AAQH,eAAO,MAAM,GAAG,qCAGd,CAAC;AAEH,6BAA6B;AAC7B,wBAAgB,QAAQ,IAAI,IAAI,CAE/B"}

package/dist/log.js

@@ -0,0 +1,22 @@
+/**
+ * log.ts — bds-tools 统一日志实例
+ *
+ * 通过 @sfmc-bds/logs 共享包接入,source = "bds-tools"。
+ * 同时输出 stdout + 落盘到 LOG_PATH (update.log)。
+ *
+ * check-update.ts 是独立入口,用 source = "updater" 单独创建 logger,
+ * 见该文件内的 createUpdaterLogger()。
+ */
+import { createLogger, createStdoutSink, createFileSink } from "@sfmc-bds/sdk/logs";
+import { LOG_PATH } from "./paths.js";
+const fileSink = createFileSink(LOG_PATH);
+process.on("exit", () => fileSink.close());
+export const log = createLogger({
+    source: "bds-tools",
+    sinks: [createStdoutSink(), fileSink],
+});
+/** 关闭文件流 (进程退出前调用,确保缓冲落盘) */
+export function closeLog() {
+    fileSink.close();
+}
+//# 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,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpF,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;AAC1C,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;AAE3C,MAAM,CAAC,MAAM,GAAG,GAAG,YAAY,CAAC;IAC9B,MAAM,EAAE,WAAW;IACnB,KAAK,EAAE,CAAC,gBAAgB,EAAE,EAAE,QAAQ,CAAC;CACtC,CAAC,CAAC;AAEH,6BAA6B;AAC7B,MAAM,UAAU,QAAQ;IACtB,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,10 @@
+/**
+ * logger.ts — 已废弃,统一改用 log.ts
+ *
+ * 此文件保留仅为向后兼容 (safe-delete 限制无法删除)。
+ * 实际日志逻辑在 log.ts,通过 @sfmc-bds/logs 共享包接入。
+ *
+ * 新代码请直接:import { log } from "./log.js"
+ */
+export { log as logger, closeLog as closeLogger } from "./log.js";
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,GAAG,IAAI,MAAM,EAAE,QAAQ,IAAI,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/dist/logger.js

@@ -0,0 +1,10 @@
+/**
+ * logger.ts — 已废弃,统一改用 log.ts
+ *
+ * 此文件保留仅为向后兼容 (safe-delete 限制无法删除)。
+ * 实际日志逻辑在 log.ts,通过 @sfmc-bds/logs 共享包接入。
+ *
+ * 新代码请直接:import { log } from "./log.js"
+ */
+export { log as logger, closeLog as closeLogger } from "./log.js";
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,GAAG,IAAI,MAAM,EAAE,QAAQ,IAAI,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/dist/pack-manager.d.ts

@@ -0,0 +1,136 @@
+/**
+ * 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 { copyDirAsync, copyFileAsync } from "./fsx.js";
+export interface AssembleBehaviorPackOpts {
+    /** Where the bundled scripts/main.js already exists (esbuild output dir) */
+    srcDir: string;
+    /** Output behavior pack directory (created if missing) */
+    outDir: string;
+    /** BP 目录名 — SEA 固定 'sfmc-modules', npm 自定义 BP 可改名 */
+    projectName: string;
+    /** manifest.json 的 header.version [major, minor, patch]; 默认 [1, 0, 0] */
+    version?: [number, number, number] | undefined;
+    /** manifest.json 的 description */
+    description?: string | undefined;
+    /** pack_icon.png 源文件 (optional, 不提供则跳过) */
+    iconSrc?: string | undefined;
+}
+export interface AssembleResourcePackOpts {
+    /** Modules whose resource_pack/** should be merged. Map<moduleId, resourcePackDir>. */
+    moduleResourceDirs: Record<string, string>;
+    /** Output resource pack directory (created if missing) */
+    outDir: string;
+    /** RP 目录名 */
+    projectName: string;
+    /** manifest.json 的 header.version [major, minor, patch]; 默认 [1, 0, 0] */
+    version?: [number, number, number] | undefined;
+    /** manifest.json 的 description */
+    description?: string | undefined;
+}
+export interface DeployOpts {
+    bdsRoot: string;
+    levelName: string;
+    /** 已组装好的 BP 源目录 */
+    behaviorPackSrc: string;
+    /** 已组装好的 RP 源目录 (可省略,只用 BP 也合法) */
+    resourcePackSrc?: string;
+    /** BP 目标目录名 (worlds/<level>/behavior_packs/<bpName>) */
+    bpName: string;
+    /** RP 目标目录名 (worlds/<level>/resource_packs/<rpName>);省略时复用 bpName + '-rp' */
+    rpName?: string;
+}
+export interface EnablePackOpts {
+    worldsDir: string;
+    levelName: string;
+    kind: "behavior" | "resource";
+    packUuid: string;
+    version: [number, number, number];
+}
+/** SFMC 合成 BP 的固定 @minecraft/* permissions,所有用到的命名空间都打开。 */
+export declare const SFMC_PERMISSIONS: readonly ["@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 declare function randomUuid(): string;
+/**
+ * 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 declare function assembleBehaviorPack(opts: AssembleBehaviorPackOpts): Promise<void>;
+/**
+ * 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 declare function assembleResourcePack(opts: AssembleResourcePackOpts): Promise<void>;
+/**
+ * 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 declare function readLevelName(bdsRoot: string): Promise<string>;
+/**
+ * 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 declare function deployToBDS(opts: DeployOpts): Promise<void>;
+/**
+ * Write the seven `@minecraft/*` allowed_modules into a behavior pack's
+ * `permissions.json`. Idempotent: rewrites any pre-existing file.
+ */
+export declare function writePermissionsJson(bpDir: string): Promise<void>;
+/**
+ * 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 declare function enablePackInWorld(opts: EnablePackOpts): Promise<void>;
+/** Remove a pack_id from the world's enable-list JSON. */
+export declare function disablePackInWorld(opts: EnablePackOpts): Promise<void>;
+export declare function writeBehaviorPackManifest(outDir: string, header: {
+    name: string;
+    uuid: string;
+    version: [number, number, number];
+    description?: string | undefined;
+}): Promise<void>;
+export declare function writeResourcePackManifest(outDir: string, header: {
+    name: string;
+    uuid: string;
+    version: [number, number, number];
+    description?: string | undefined;
+}): Promise<void>;
+export { copyFileAsync, copyDirAsync };
+/**
+ * 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 declare function scanModuleResourcePacks(modulesDir: string): Record<string, string>;
+//# sourceMappingURL=pack-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pack-manager.d.ts","sourceRoot":"","sources":["../src/pack-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAIvD,MAAM,WAAW,wBAAwB;IACvC,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAC/C,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED,MAAM,WAAW,wBAAwB;IACvC,uFAAuF;IACvF,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,aAAa;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAC/C,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,mCAAmC;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,UAAU,GAAG,UAAU,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAID,4DAA4D;AAC5D,eAAO,MAAM,gBAAgB,gMAQnB,CAAC;AAEX,yDAAyD;AACzD,wBAAgB,UAAU,IAAI,MAAM,CAGnC;AAID;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBxF;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBxF;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CASpE;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAYjE;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOvE;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3E;AAED,0DAA0D;AAC1D,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5E;AAyCD,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAC1G,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAC1G,OAAO,CAAC,IAAI,CAAC,CAqBf;AAID,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC;AAIvC;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAWlF"}