@sfmc-bds/bds-tools 0.1.0 → 0.2.0-beta.0

package/dist/version.js

@@ -1,97 +1,79 @@
-/**
- * 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(".");
+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(".");
+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;
+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;
+  }
+  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 isValidVersion(v) {
+  return /^\d+\.\d+\.\d+(\.\d+)?(-preview)?$/.test(v);
 }
 function readCache() {
-    return readJson(VERSION_CACHE) ?? {};
+  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;
+  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 */
-    }
+function saveVersionCache(version, sha256) {
+  const cache = readCache();
+  cache[version] = { sha256, verified_at: Date.now() };
+  try {
+    writeJson(VERSION_CACHE, trimCache(cache));
+  } catch {
+  }
 }
-/**
- * 异步识别当前 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";
+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 \u54C8\u5E0C\u672A\u5339\u914D\u7F13\u5B58\uFF0C\u7591\u4F3C\u88AB\u6539\u52A8\u6216\u9996\u6B21\u542F\u52A8");
+  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";
+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 \u54C8\u5E0C\u672A\u5339\u914D\u7F13\u5B58");
+  return "0.0.0.0";
 }
-//# sourceMappingURL=version.js.map
+export {
+  compareVersions,
+  getCurrentVersionAsync,
+  getCurrentVersionSync,
+  isValidVersion,
+  saveVersionCache,
+  toVer3,
+  toVer4
+};
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -1 +1,7 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"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"}
+{
+  "version": 3,
+  "sources": ["../src/version.ts"],
+  "sourcesContent": ["/**\n * version.ts \u2014 \u7248\u672C\u53F7\u5DE5\u5177 / \u7248\u672C\u7F13\u5B58\n */\n\nimport { readJson, writeJson } from \"@sfmc-bds/sdk/node/config\";\nimport fs from \"node:fs\";\nimport { VERSION_CACHE } from \"./paths.js\";\nimport { hashFileSync, hashFileAsync } from \"./fsx.js\";\nimport { log } from \"./log.js\";\n\n/** 4\u6BB5 \u2192 3\u6BB5 (\u53BB\u5C3E) */\nexport function toVer3(v: string): string {\n  return v.split(\".\").slice(0, 3).join(\".\");\n}\n\n/** 3\u6BB5 \u2192 4\u6BB5 (\u8865 0) */\nexport function toVer4(v: string): string {\n  const p = v.split(\".\");\n  while (p.length < 4) p.push(\"0\");\n  return p.join(\".\");\n}\n\n/** \u7248\u672C\u6BD4\u8F83 (\u6309 4 \u6BB5\u6570\u5B57\u6392\u5E8F) */\nexport function compareVersions(a: string, b: string): number {\n  const sa = a.replace(/-preview$/, \"\");\n  const sb = b.replace(/-preview$/, \"\");\n  const pa = sa.split(\".\").map(Number);\n  const pb = sb.split(\".\").map(Number);\n  for (let i = 0; i < 4; i++) {\n    const ai = pa[i] ?? 0;\n    const bi = pb[i] ?? 0;\n    if (ai !== bi) return ai - bi;\n  }\n  // preview \u4F4E\u4E8E\u4E0D\u5E26 -preview \u7684\u540C\u4E00\u6570\u5B57\n  if (a.endsWith(\"-preview\") && !b.endsWith(\"-preview\")) return -1;\n  if (!a.endsWith(\"-preview\") && b.endsWith(\"-preview\")) return 1;\n  return 0;\n}\n\n/** \u7B80\u5355\u7684\u771F\u503C\u6821\u9A8C (\u6309\u7248\u672C\u53F7\u5916\u5F62) */\nexport function isValidVersion(v: string): boolean {\n  return /^\\d+\\.\\d+\\.\\d+(\\.\\d+)?(-preview)?$/.test(v);\n}\n\n/** \u7F13\u5B58\u6761\u76EE\u7C7B\u578B */\ninterface CacheEntry {\n  sha256: string;\n  verified_at: number;\n}\n\nfunction readCache(): Record<string, CacheEntry> {\n  return readJson<Record<string, CacheEntry>>(VERSION_CACHE) ?? {};\n}\n\n/** \u4EC5\u4FDD\u7559\u6700\u8FD1 3 \u6761\u7248\u672C\u7F13\u5B58 (\u907F\u514D\u65E0\u9650\u589E\u957F) */\nfunction trimCache(cache: Record<string, CacheEntry>): Record<string, CacheEntry> {\n  const keys = Object.keys(cache).sort(compareVersions).slice(-3);\n  const trimmed: Record<string, CacheEntry> = {};\n  for (const k of keys) trimmed[k] = cache[k]!;\n  return trimmed;\n}\n\nexport function saveVersionCache(version: string, sha256: string): void {\n  const cache = readCache();\n  cache[version] = { sha256, verified_at: Date.now() };\n  try {\n    writeJson(VERSION_CACHE, trimCache(cache));\n  } catch {\n    /* ignore */\n  }\n}\n\n/**\n * \u5F02\u6B65\u8BC6\u522B\u5F53\u524D BDS \u7248\u672C\n * \u4F18\u5148\u901A\u8FC7 SHA256 \u53CD\u67E5\u7F13\u5B58\uFF0C\u5931\u8D25\u5219\u56DE\u9000 `current_version.txt`\uFF08\u5982\u679C\u5B58\u5728\uFF09\n */\nexport async function getCurrentVersionAsync(exePath: string): Promise<string> {\n  if (!fs.existsSync(exePath)) return \"0.0.0.0\";\n  const actual = await hashFileAsync(exePath, \"sha256\");\n  if (!actual) return \"0.0.0.0\";\n\n  const cache = readCache();\n  for (const [ver, entry] of Object.entries(cache)) {\n    if (entry.sha256 === actual) return ver;\n  }\n  log.warn(\"[BDSUpdater] bedrock_server.exe \u54C8\u5E0C\u672A\u5339\u914D\u7F13\u5B58\uFF0C\u7591\u4F3C\u88AB\u6539\u52A8\u6216\u9996\u6B21\u542F\u52A8\");\n  return \"0.0.0.0\";\n}\n\n/** \u540C\u6B65\u7248\u672C (\u517C\u5BB9\u65E7\u6D41\u7A0B) */\nexport function getCurrentVersionSync(exePath: string): string {\n  if (!fs.existsSync(exePath)) return \"0.0.0.0\";\n  const actual = hashFileSync(exePath, \"sha256\");\n  if (!actual) return \"0.0.0.0\";\n  const cache = readCache();\n  for (const [ver, entry] of Object.entries(cache)) {\n    if (entry.sha256 === actual) return ver;\n  }\n  log.warn(\"[BDSUpdater] bedrock_server.exe \u54C8\u5E0C\u672A\u5339\u914D\u7F13\u5B58\");\n  return \"0.0.0.0\";\n}\n"],
+  "mappings": "AAIA,SAAS,UAAU,iBAAiB;AACpC,OAAO,QAAQ;AACf,SAAS,qBAAqB;AAC9B,SAAS,cAAc,qBAAqB;AAC5C,SAAS,WAAW;AAGb,SAAS,OAAO,GAAmB;AACxC,SAAO,EAAE,MAAM,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,KAAK,GAAG;AAC1C;AAGO,SAAS,OAAO,GAAmB;AACxC,QAAM,IAAI,EAAE,MAAM,GAAG;AACrB,SAAO,EAAE,SAAS,EAAG,GAAE,KAAK,GAAG;AAC/B,SAAO,EAAE,KAAK,GAAG;AACnB;AAGO,SAAS,gBAAgB,GAAW,GAAmB;AAC5D,QAAM,KAAK,EAAE,QAAQ,aAAa,EAAE;AACpC,QAAM,KAAK,EAAE,QAAQ,aAAa,EAAE;AACpC,QAAM,KAAK,GAAG,MAAM,GAAG,EAAE,IAAI,MAAM;AACnC,QAAM,KAAK,GAAG,MAAM,GAAG,EAAE,IAAI,MAAM;AACnC,WAAS,IAAI,GAAG,IAAI,GAAG,KAAK;AAC1B,UAAM,KAAK,GAAG,CAAC,KAAK;AACpB,UAAM,KAAK,GAAG,CAAC,KAAK;AACpB,QAAI,OAAO,GAAI,QAAO,KAAK;AAAA,EAC7B;AAEA,MAAI,EAAE,SAAS,UAAU,KAAK,CAAC,EAAE,SAAS,UAAU,EAAG,QAAO;AAC9D,MAAI,CAAC,EAAE,SAAS,UAAU,KAAK,EAAE,SAAS,UAAU,EAAG,QAAO;AAC9D,SAAO;AACT;AAGO,SAAS,eAAe,GAAoB;AACjD,SAAO,qCAAqC,KAAK,CAAC;AACpD;AAQA,SAAS,YAAwC;AAC/C,SAAO,SAAqC,aAAa,KAAK,CAAC;AACjE;AAGA,SAAS,UAAU,OAA+D;AAChF,QAAM,OAAO,OAAO,KAAK,KAAK,EAAE,KAAK,eAAe,EAAE,MAAM,EAAE;AAC9D,QAAM,UAAsC,CAAC;AAC7C,aAAW,KAAK,KAAM,SAAQ,CAAC,IAAI,MAAM,CAAC;AAC1C,SAAO;AACT;AAEO,SAAS,iBAAiB,SAAiB,QAAsB;AACtE,QAAM,QAAQ,UAAU;AACxB,QAAM,OAAO,IAAI,EAAE,QAAQ,aAAa,KAAK,IAAI,EAAE;AACnD,MAAI;AACF,cAAU,eAAe,UAAU,KAAK,CAAC;AAAA,EAC3C,QAAQ;AAAA,EAER;AACF;AAMA,eAAsB,uBAAuB,SAAkC;AAC7E,MAAI,CAAC,GAAG,WAAW,OAAO,EAAG,QAAO;AACpC,QAAM,SAAS,MAAM,cAAc,SAAS,QAAQ;AACpD,MAAI,CAAC,OAAQ,QAAO;AAEpB,QAAM,QAAQ,UAAU;AACxB,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,GAAG;AAChD,QAAI,MAAM,WAAW,OAAQ,QAAO;AAAA,EACtC;AACA,MAAI,KAAK,8IAAoD;AAC7D,SAAO;AACT;AAGO,SAAS,sBAAsB,SAAyB;AAC7D,MAAI,CAAC,GAAG,WAAW,OAAO,EAAG,QAAO;AACpC,QAAM,SAAS,aAAa,SAAS,QAAQ;AAC7C,MAAI,CAAC,OAAQ,QAAO;AACpB,QAAM,QAAQ,UAAU;AACxB,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,GAAG;AAChD,QAAI,MAAM,WAAW,OAAQ,QAAO;AAAA,EACtC;AACA,MAAI,KAAK,4EAAyC;AAClD,SAAO;AACT;",
+  "names": []
+}

package/dist/world-packs.d.ts

@@ -0,0 +1,112 @@
+import { type WorldPackListReadResult } from "./pack-manager.js";
+export type WorldPackKind = "behavior" | "resource";
+export interface PackManifestInfo {
+    name: string;
+    uuid: string;
+    version: [number, number, number];
+    kind: WorldPackKind;
+    description?: string;
+}
+export interface InstalledWorldPack {
+    kind: WorldPackKind;
+    folderName: string;
+    dir: string;
+    name: string;
+    uuid: string;
+    version: [number, number, number];
+    enabled: boolean;
+}
+/** 滤掉 §x（Minecraft 格式码）、残余压缩后缀，加 [BP]/[RP] 前缀 */
+export declare function formatWorldPackFolderName(rawName: string, kind: WorldPackKind): string;
+/** 根据 manifest modules[].type 判定 BP / RP */
+export declare function detectPackKindFromManifest(raw: {
+    modules?: Array<{
+        type?: string;
+    }>;
+}): WorldPackKind | null;
+export declare function readPackManifestInfo(packDir: string): PackManifestInfo | null;
+/** 深度优先找含 manifest.json 的包根（默认 maxDepth=2，root 自身为 depth 0） */
+export declare function discoverPackRoots(root: string, opts?: {
+    maxDepth?: number;
+}): string[];
+export declare function isPackArchive(filePath: string): boolean;
+/** 解压 zip/mcpack/mcaddon 到临时目录，返回该目录（经 zipx 防 zip-slip） */
+export declare function extractArchiveToTemp(filePath: string): Promise<string>;
+/** 扫描世界内已安装 BP/RP 目录 */
+export declare function listInstalledWorldPacks(bdsRoot: string, levelName: string): InstalledWorldPack[];
+/** RP/BP 第三位版本 +1，写回 manifest */
+export declare function bumpPackPatchVersion(packDir: string): [number, number, number];
+/** 写入 header.version（并同步 modules[].version 的 patch） */
+export declare function writePackHeaderVersion(packDir: string, next: [number, number, number]): [number, number, number];
+/** 读取 BP manifest 中依赖的资源包 uuid（非 @minecraft 模块） */
+export declare function readPackDependencyUuids(packDir: string): string[];
+/** 确保版本严格大于 floor（patch/minor 抬一级） */
+export declare function ensureVersionGreaterThan(packDir: string, floor: [number, number, number], component?: "patch" | "minor"): [number, number, number];
+export interface InstallPackResult {
+    ok: boolean;
+    skipped?: boolean;
+    reason?: string;
+    destDir?: string;
+    folderName?: string;
+    info?: PackManifestInfo;
+    conflict?: {
+        existing: PackManifestInfo & {
+            dir: string;
+        };
+        incoming: PackManifestInfo;
+    };
+}
+/**
+ * 将包目录安装到 destParent（behavior_packs 或 resource_packs）。
+ * force=true 时覆盖冲突；否则返回 conflict 供上层询问。
+ */
+export declare function installPackDirectory(opts: {
+    srcDir: string;
+    destParent: string;
+    folderName?: string;
+    force?: boolean;
+}): Promise<InstallPackResult>;
+/** 安装后写入世界 enable 清单 */
+export declare function enableInstalledPack(opts: {
+    bdsRoot: string;
+    levelName: string;
+    info: PackManifestInfo;
+}): Promise<void>;
+/** 从世界 enable 清单移除 */
+export declare function disableInstalledPack(opts: {
+    bdsRoot: string;
+    levelName: string;
+    kind: WorldPackKind;
+    packUuid: string;
+    version: [number, number, number];
+}): Promise<void>;
+export type UninstallPackResult = {
+    action: "trashed";
+    dest: string;
+} | {
+    action: "deleted";
+} | {
+    action: "missing";
+};
+export type UninstallPackAction = UninstallPackResult["action"];
+/**
+ * 卸载已安装世界包：先 disable enable-list，再移入 trashDir 或直接删除目录。
+ * trashDir 跨盘符时 fallback 为 copy + rm。
+ */
+export declare function uninstallInstalledPack(opts: {
+    bdsRoot: string;
+    levelName: string;
+    pack: InstalledWorldPack;
+    /** 提供则移入该目录；null/省略则直接删除 */
+    trashDir?: string | null;
+}): Promise<UninstallPackResult>;
+export declare function worldPackParentDir(bdsRoot: string, levelName: string, kind: WorldPackKind): string;
+/** 世界 enable-list 权威读取 — 委托 pack-manager（供 doctor 等，避免硬编码文件名） */
+export declare function listWorldEnableEntries(bdsRoot: string, levelName: string, kind: WorldPackKind): Array<{
+    pack_id: string;
+    version: [number, number, number];
+}>;
+/** 含 parseFail 信号的 enable-list 快照（doctor 用；不暴露 JSON 路径构造细节） */
+export declare function listWorldEnableListResult(bdsRoot: string, levelName: string, kind: WorldPackKind): WorldPackListReadResult;
+export declare function findInstalledPackById(packs: InstalledWorldPack[], id: string): InstalledWorldPack | null;
+//# sourceMappingURL=world-packs.d.ts.map

package/dist/world-packs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-packs.d.ts","sourceRoot":"","sources":["../src/world-packs.ts"],"names":[],"mappings":"AAOA,OAAO,EAQL,KAAK,uBAAuB,EAC7B,MAAM,mBAAmB,CAAC;AAG3B,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,UAAU,CAAC;AAEpD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;CAClB;AAID,iDAAiD;AACjD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,MAAM,CAStF;AAED,4CAA4C;AAC5C,wBAAgB,0BAA0B,CAAC,GAAG,EAAE;IAC9C,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpC,GAAG,aAAa,GAAG,IAAI,CAKvB;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CA0B7E;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,EAAE,CA6BtF;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED,2DAA2D;AAC3D,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI5E;AAaD,wBAAwB;AACxB,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,kBAAkB,EAAE,CA0ChG;AAED,iCAAiC;AACjC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAW9E;AAED,uDAAuD;AACvD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAC7B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAkB1B;AAED,mDAAmD;AACnD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAajE;AAED,sCAAsC;AACtC,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAC/B,SAAS,GAAE,OAAO,GAAG,OAAiB,GACrC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAmB1B;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,QAAQ,CAAC,EAAE;QAAE,QAAQ,EAAE,gBAAgB,GAAG;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,QAAQ,EAAE,gBAAgB,CAAA;KAAE,CAAC;CACzF;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAwD7B;AAED,wBAAwB;AACxB,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,gBAAgB,CAAC;CACxB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQhB;AAED,sBAAsB;AACtB,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,GAAG,OAAO,CAAC,IAAI,CAAC,CAQhB;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC;AAE1B,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;AAEhE;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,kBAAkB,CAAC;IACzB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAgC/B;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,aAAa,GAClB,MAAM,CAKR;AAED,iEAAiE;AACjE,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,aAAa,GAClB,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CAE/D;AAED,+DAA+D;AAC/D,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,aAAa,GAClB,uBAAuB,CAEzB;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,kBAAkB,EAAE,EAC3B,EAAE,EAAE,MAAM,GACT,kBAAkB,GAAG,IAAI,CAY3B"}

package/dist/world-packs.js

@@ -0,0 +1,335 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { copyDirAsync } from "./fsx.js";
+import {
+  bdsWorldLevelDir,
+  bdsWorldsDir,
+  disablePackInWorld,
+  enablePackInWorld,
+  readPackManifestHeader,
+  readWorldPackList,
+  readWorldPackListResult
+} from "./pack-manager.js";
+import { extractZipFileToDir } from "./zipx.js";
+const ARCHIVE_EXTS = [".zip", ".mcpack", ".mcaddon"];
+function formatWorldPackFolderName(rawName, kind) {
+  let s = String(rawName ?? "");
+  s = s.replace(/§[0-9a-zA-Z]/g, "");
+  s = s.replace(/\.(zip|mcpack|mcaddon)$/i, "");
+  s = s.replace(/\s+/g, " ").trim();
+  if (!s) s = "pack";
+  const prefix = kind === "resource" ? "[RP]" : "[BP]";
+  if (s.startsWith("[RP]") || s.startsWith("[BP]")) return s;
+  return `${prefix} ${s}`;
+}
+function detectPackKindFromManifest(raw) {
+  const types = (raw.modules ?? []).map((m) => String(m.type ?? "").toLowerCase());
+  if (types.includes("resources")) return "resource";
+  if (types.some((t) => t === "script" || t === "data" || t === "javascript")) return "behavior";
+  return null;
+}
+function readPackManifestInfo(packDir) {
+  const file = path.join(packDir, "manifest.json");
+  if (!fs.existsSync(file)) return null;
+  try {
+    const raw = JSON.parse(fs.readFileSync(file, "utf8"));
+    const kind = detectPackKindFromManifest(raw);
+    const uuid = raw.header?.uuid;
+    const ver = raw.header?.version;
+    const name = raw.header?.name;
+    if (!kind || typeof uuid !== "string" || !Array.isArray(ver) || ver.length < 3) return null;
+    if (typeof name !== "string" || !name) return null;
+    const version = [Number(ver[0]), Number(ver[1]), Number(ver[2])];
+    const description = raw.header?.description;
+    return {
+      name,
+      uuid,
+      version,
+      kind,
+      ...typeof description === "string" ? { description } : {}
+    };
+  } catch {
+    return null;
+  }
+}
+function discoverPackRoots(root, opts) {
+  const maxDepth = opts?.maxDepth ?? 2;
+  const out = [];
+  const abs = path.resolve(root);
+  if (!fs.existsSync(abs)) return out;
+  function walk(dir, depth) {
+    const manifest = path.join(dir, "manifest.json");
+    if (fs.existsSync(manifest) && fs.statSync(manifest).isFile()) {
+      out.push(dir);
+      return;
+    }
+    if (depth >= maxDepth) return;
+    let entries;
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const e of entries) {
+      if (!e.isDirectory()) continue;
+      if (e.name.startsWith(".") || e.name === "node_modules") continue;
+      walk(path.join(dir, e.name), depth + 1);
+    }
+  }
+  const st = fs.statSync(abs);
+  if (st.isDirectory()) walk(abs, 0);
+  return out;
+}
+function isPackArchive(filePath) {
+  const lower = filePath.toLowerCase();
+  return ARCHIVE_EXTS.some((ext) => lower.endsWith(ext));
+}
+async function extractArchiveToTemp(filePath) {
+  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), "sfmc-pack-"));
+  await extractZipFileToDir(filePath, tmp);
+  return tmp;
+}
+function listPackDirsIn(parent) {
+  if (!fs.existsSync(parent)) return [];
+  const out = [];
+  for (const e of fs.readdirSync(parent, { withFileTypes: true })) {
+    if (!e.isDirectory()) continue;
+    const dir = path.join(parent, e.name);
+    if (fs.existsSync(path.join(dir, "manifest.json"))) out.push(dir);
+  }
+  return out;
+}
+function listInstalledWorldPacks(bdsRoot, levelName) {
+  const worldRoot = bdsWorldLevelDir(bdsRoot, levelName);
+  const worldsDir = bdsWorldsDir(bdsRoot);
+  const result = [];
+  for (const kind of ["behavior", "resource"]) {
+    const parent = path.join(
+      worldRoot,
+      kind === "behavior" ? "behavior_packs" : "resource_packs"
+    );
+    const enabledList = readWorldPackList(worldsDir, levelName, kind);
+    const enabledMap = new Map(enabledList.map((e) => [e.pack_id, e.version]));
+    for (const dir of listPackDirsIn(parent)) {
+      const info = readPackManifestInfo(dir);
+      if (!info || info.kind !== kind) {
+        const header = readPackManifestHeader(dir);
+        if (!header) continue;
+        result.push({
+          kind,
+          folderName: path.basename(dir),
+          dir,
+          name: path.basename(dir),
+          uuid: header.uuid,
+          version: header.version,
+          enabled: enabledMap.has(header.uuid)
+        });
+        continue;
+      }
+      result.push({
+        kind: info.kind,
+        folderName: path.basename(dir),
+        dir,
+        name: info.name,
+        uuid: info.uuid,
+        version: info.version,
+        enabled: enabledMap.has(info.uuid)
+      });
+    }
+  }
+  return result;
+}
+function bumpPackPatchVersion(packDir) {
+  const file = path.join(packDir, "manifest.json");
+  if (!fs.existsSync(file)) throw new Error(`manifest.json missing: ${packDir}`);
+  const raw = JSON.parse(fs.readFileSync(file, "utf8"));
+  const ver = raw.header?.version;
+  if (!Array.isArray(ver) || ver.length < 3) throw new Error(`invalid header.version in ${file}`);
+  const next = [Number(ver[0]), Number(ver[1]), Number(ver[2]) + 1];
+  return writePackHeaderVersion(packDir, next);
+}
+function writePackHeaderVersion(packDir, next) {
+  const file = path.join(packDir, "manifest.json");
+  if (!fs.existsSync(file)) throw new Error(`manifest.json missing: ${packDir}`);
+  const raw = JSON.parse(fs.readFileSync(file, "utf8"));
+  if (!raw.header) raw.header = {};
+  raw.header.version = next;
+  if (Array.isArray(raw.modules)) {
+    for (const m of raw.modules) {
+      if (Array.isArray(m.version) && m.version.length >= 3) {
+        m.version = [Number(m.version[0]), Number(m.version[1]), next[2]];
+      }
+    }
+  }
+  fs.writeFileSync(file, `${JSON.stringify(raw, null, 2)}
+`, "utf8");
+  return next;
+}
+function readPackDependencyUuids(packDir) {
+  const file = path.join(packDir, "manifest.json");
+  if (!fs.existsSync(file)) return [];
+  try {
+    const raw = JSON.parse(fs.readFileSync(file, "utf8"));
+    return (raw.dependencies ?? []).map((d) => d.uuid).filter((u) => typeof u === "string" && u.length > 0);
+  } catch {
+    return [];
+  }
+}
+function ensureVersionGreaterThan(packDir, floor, component = "patch") {
+  const info = readPackManifestInfo(packDir);
+  if (!info) throw new Error(`cannot read pack version: ${packDir}`);
+  let next = component === "minor" ? [info.version[0], info.version[1] + 1, 0] : [info.version[0], info.version[1], info.version[2] + 1];
+  const cmp = (a, b) => {
+    for (let i = 0; i < 3; i++) {
+      const d = a[i] - b[i];
+      if (d !== 0) return d;
+    }
+    return 0;
+  };
+  while (cmp(next, floor) <= 0) {
+    if (component === "minor") next = [next[0], next[1] + 1, 0];
+    else next = [next[0], next[1], next[2] + 1];
+  }
+  return writePackHeaderVersion(packDir, next);
+}
+async function installPackDirectory(opts) {
+  const info = readPackManifestInfo(opts.srcDir);
+  if (!info) {
+    return { ok: false, reason: "invalid or unrecognized manifest.json" };
+  }
+  const folderName = formatWorldPackFolderName(
+    opts.folderName ?? path.basename(opts.srcDir),
+    info.kind
+  );
+  await fs.promises.mkdir(opts.destParent, { recursive: true });
+  let conflictDir = null;
+  let conflictExisting = null;
+  for (const dir of listPackDirsIn(opts.destParent)) {
+    const existing = readPackManifestInfo(dir);
+    const sameFolder = path.basename(dir) === folderName;
+    const sameUuid = !!existing && existing.uuid === info.uuid;
+    if (!sameFolder && !sameUuid) continue;
+    conflictDir = dir;
+    if (existing) {
+      conflictExisting = existing;
+    } else {
+      const header = readPackManifestHeader(dir);
+      conflictExisting = {
+        name: path.basename(dir),
+        uuid: header?.uuid ?? "(unknown)",
+        version: header?.version ?? [0, 0, 0],
+        kind: info.kind
+      };
+    }
+    break;
+  }
+  if (conflictDir && !opts.force) {
+    return {
+      ok: false,
+      skipped: true,
+      reason: "conflict",
+      conflict: {
+        existing: { ...conflictExisting ?? info, dir: conflictDir },
+        incoming: info
+      }
+    };
+  }
+  const destDir = path.join(opts.destParent, folderName);
+  if (conflictDir && path.resolve(conflictDir) !== path.resolve(destDir)) {
+    await fs.promises.rm(conflictDir, { recursive: true, force: true });
+  }
+  if (fs.existsSync(destDir)) {
+    await fs.promises.rm(destDir, { recursive: true, force: true });
+  }
+  await copyDirAsync(opts.srcDir, destDir);
+  return { ok: true, destDir, folderName, info };
+}
+async function enableInstalledPack(opts) {
+  await enablePackInWorld({
+    worldsDir: bdsWorldsDir(opts.bdsRoot),
+    levelName: opts.levelName,
+    kind: opts.info.kind,
+    packUuid: opts.info.uuid,
+    version: opts.info.version
+  });
+}
+async function disableInstalledPack(opts) {
+  await disablePackInWorld({
+    worldsDir: bdsWorldsDir(opts.bdsRoot),
+    levelName: opts.levelName,
+    kind: opts.kind,
+    packUuid: opts.packUuid,
+    version: opts.version
+  });
+}
+async function uninstallInstalledPack(opts) {
+  await disableInstalledPack({
+    bdsRoot: opts.bdsRoot,
+    levelName: opts.levelName,
+    kind: opts.pack.kind,
+    packUuid: opts.pack.uuid,
+    version: opts.pack.version
+  });
+  if (!fs.existsSync(opts.pack.dir)) {
+    return { action: "missing" };
+  }
+  const trashDir = opts.trashDir?.trim() || null;
+  if (trashDir) {
+    await fs.promises.mkdir(trashDir, { recursive: true });
+    const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+    let dest = path.join(trashDir, opts.pack.folderName);
+    if (fs.existsSync(dest)) {
+      dest = path.join(trashDir, `${opts.pack.folderName}-${stamp}`);
+    }
+    try {
+      await fs.promises.rename(opts.pack.dir, dest);
+    } catch {
+      await copyDirAsync(opts.pack.dir, dest);
+      await fs.promises.rm(opts.pack.dir, { recursive: true, force: true });
+    }
+    return { action: "trashed", dest };
+  }
+  await fs.promises.rm(opts.pack.dir, { recursive: true, force: true });
+  return { action: "deleted" };
+}
+function worldPackParentDir(bdsRoot, levelName, kind) {
+  return path.join(
+    bdsWorldLevelDir(bdsRoot, levelName),
+    kind === "behavior" ? "behavior_packs" : "resource_packs"
+  );
+}
+function listWorldEnableEntries(bdsRoot, levelName, kind) {
+  return listWorldEnableListResult(bdsRoot, levelName, kind).entries;
+}
+function listWorldEnableListResult(bdsRoot, levelName, kind) {
+  return readWorldPackListResult(bdsWorldsDir(bdsRoot), levelName, kind);
+}
+function findInstalledPackById(packs, id) {
+  const q = id.trim().toLowerCase();
+  return packs.find(
+    (p) => p.uuid.toLowerCase() === q || p.folderName.toLowerCase() === q || p.name.toLowerCase() === q || p.folderName.toLowerCase().includes(q) || p.name.toLowerCase().includes(q)
+  ) ?? null;
+}
+export {
+  bumpPackPatchVersion,
+  detectPackKindFromManifest,
+  disableInstalledPack,
+  discoverPackRoots,
+  enableInstalledPack,
+  ensureVersionGreaterThan,
+  extractArchiveToTemp,
+  findInstalledPackById,
+  formatWorldPackFolderName,
+  installPackDirectory,
+  isPackArchive,
+  listInstalledWorldPacks,
+  listWorldEnableEntries,
+  listWorldEnableListResult,
+  readPackDependencyUuids,
+  readPackManifestInfo,
+  uninstallInstalledPack,
+  worldPackParentDir,
+  writePackHeaderVersion
+};
+//# sourceMappingURL=world-packs.js.map