@sfmc-bds/bds-tools 0.2.0-beta.10 → 0.2.0-beta.12

package/dist/pack-manager.d.ts

@@ -11,6 +11,8 @@
  * - 世界部署与清单激活：将包部署至 BDS `<level>/behavior_packs` 与 `resource_packs`，并同步维护 `world_behavior_packs.json`
  */
 import { copyDirAsync, copyFileAsync } from "./fsx.js";
+import { type PackManifestDependency } from "./dependency-negotiator.js";
+export * from "./dependency-negotiator.js";
 export interface AssembleBehaviorPackOpts {
     /** 已完成打包的 `scripts/main.js` 所在源码目录（即 esbuild 输出目录）。 */
     srcDir: string;
@@ -28,6 +30,8 @@ export interface AssembleBehaviorPackOpts {
     uuid?: string | undefined;
     /** 稳定的 `script module uuid`（缺省时随机生成）。 */
     moduleUuid?: string | undefined;
+    /** 自定义/动态协商后的 dependencies（缺省使用 BASELINE_BEDROCK_DEPENDENCIES）。 */
+    dependencies?: PackManifestDependency[] | undefined;
 }
 export interface AssembleResourcePackOpts {
     /** 需合并资源包目录的模块映射字典（`Record<moduleId, resourcePackDir>`）。 */
@@ -85,11 +89,15 @@ export declare function serverPropertiesPath(bdsRoot: string): string;
 export declare function bdsWorldsDir(bdsRoot: string): string;
 /** `<bdsRoot>/worlds/<level>` */
 export declare function bdsWorldLevelDir(bdsRoot: string, levelName: string): string;
+/** `<bdsRoot>/worlds/<level>/level.dat` — 世界存档权威路径 */
+export declare function levelDatPath(bdsRoot: string, levelName: string): string;
 /** 世界 enable-list JSON 绝对路径（单一权威，供读写两侧） */
 export declare function worldPackListFile(worldsDir: string, levelName: string, kind: "behavior" | "resource"): string;
 /** `<bdsRoot>/config/<bpUuid>/permission.json` — Script API 权限文件权威路径 */
 export declare function configPermissionPath(bdsRoot: string, bpUuid: string): string;
-/** 是否已有 Script API permission.json（只读，供 preflight/status） */
+/** `<bdsRoot>/config/<bpUuid>/permissions.json` — BDS 官方规范复数权限文件路径 */
+export declare function configPermissionsPath(bdsRoot: string, bpUuid: string): string;
+/** 是否已有 Script API permission.json 或 permissions.json（只读，供 preflight/status） */
 export declare function hasConfigPermission(bdsRoot: string, bpUuid: string): boolean;
 /** 随机生成 BP/RP manifest.json header.uuid (RFC 4122 v4) */
 export declare function randomUuid(): string;
@@ -121,17 +129,21 @@ export declare function readLevelName(bdsRoot: string): Promise<string>;
  */
 export declare function deployToBDS(opts: DeployOpts): Promise<DeployResult>;
 /**
- * 确保 BDS Script API 侧 `<bdsRoot>/config/<bpUuid>/permission.json` 存在。
- * 已存在则跳过(不覆盖用户手工改动)。
- * @returns true = 新写入; false = 已存在跳过
+ * 确保 BDS Script API 侧权限文件存在并包含完整的 SFMC 所需模块权限。
+ * - 自动增量合并现有 allowed_modules，自动补齐新增权限（如 @minecraft/diagnostics）
+ * - 同时维护 BDS 官方规范的 permissions.json 与历史兼容的 permission.json
+ * - 同时更新 moduleUuid（若提供）与 config/default/permissions.json 兜底权限
+ * @returns true = 有新增/更新; false = 已是最新无需修改
  */
-export declare function ensureConfigPermission(bdsRoot: string, bpUuid: string): Promise<boolean>;
+export declare function ensureConfigPermission(bdsRoot: string, bpUuid: string, moduleUuid?: string): Promise<boolean>;
 /** 从已装配 BP/RP 目录读取 header.uuid + version;失败返回 null。 */
 export declare function readPackManifestHeader(packDir: string): {
     uuid: string;
     version: [number, number, number];
     moduleUuid?: string;
 } | null;
+/** 从已装配 BP/RP 目录读取 dependencies 列表；若无或失败返回 []。 */
+export declare function readPackManifestDependencies(packDir: string): PackManifestDependency[];
 /**
  * Write `@minecraft/*` allowed_modules into a behavior pack's
  * `permissions.json`. Idempotent: rewrites any pre-existing file.
@@ -151,7 +163,7 @@ export declare function writeBehaviorPackManifest(outDir: string, header: {
     version: [number, number, number];
     description?: string | undefined;
     moduleUuid?: string | undefined;
-}): Promise<void>;
+}, dependencies?: PackManifestDependency[] | undefined): Promise<void>;
 export declare function writeResourcePackManifest(outDir: string, header: {
     name: string;
     uuid: string;

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

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

package/dist/pack-manager.js

@@ -1,6 +1,10 @@
 import fs from "node:fs";
 import path from "node:path";
 import { copyDirAsync, copyFileAsync, readJsonFile } from "./fsx.js";
+import {
+  BASELINE_BEDROCK_DEPENDENCIES
+} from "./dependency-negotiator.js";
+export * from "./dependency-negotiator.js";
 const SFMC_PERMISSIONS = [
   "@minecraft/server",
   "@minecraft/server-ui",
@@ -19,6 +23,9 @@ function bdsWorldsDir(bdsRoot) {
 function bdsWorldLevelDir(bdsRoot, levelName) {
   return path.join(bdsWorldsDir(bdsRoot), levelName);
 }
+function levelDatPath(bdsRoot, levelName) {
+  return path.join(bdsWorldLevelDir(bdsRoot, levelName), "level.dat");
+}
 function worldPackListFile(worldsDir, levelName, kind) {
   const name = kind === "behavior" ? "world_behavior_packs.json" : "world_resource_packs.json";
   return path.join(worldsDir, levelName, name);
@@ -26,8 +33,11 @@ function worldPackListFile(worldsDir, levelName, kind) {
 function configPermissionPath(bdsRoot, bpUuid) {
   return path.join(bdsRoot, "config", bpUuid, "permission.json");
 }
+function configPermissionsPath(bdsRoot, bpUuid) {
+  return path.join(bdsRoot, "config", bpUuid, "permissions.json");
+}
 function hasConfigPermission(bdsRoot, bpUuid) {
-  return fs.existsSync(configPermissionPath(bdsRoot, bpUuid));
+  return fs.existsSync(configPermissionsPath(bdsRoot, bpUuid)) || fs.existsSync(configPermissionPath(bdsRoot, bpUuid));
 }
 function randomUuid() {
   return crypto.randomUUID();
@@ -43,13 +53,17 @@ async function assembleBehaviorPack(opts) {
     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,
-    moduleUuid: opts.moduleUuid
-  });
+  await writeBehaviorPackManifest(
+    opts.outDir,
+    {
+      name: opts.projectName,
+      uuid: bpUuid,
+      version,
+      description: opts.description,
+      moduleUuid: opts.moduleUuid
+    },
+    opts.dependencies
+  );
   if (opts.iconSrc && fs.existsSync(opts.iconSrc)) {
     await copyFileAsync(opts.iconSrc, path.join(opts.outDir, "pack_icon.png"));
   }
@@ -109,16 +123,42 @@ async function deployToBDS(opts) {
   }
   return { bpDir: bpDst, rpDir };
 }
-async function ensureConfigPermission(bdsRoot, bpUuid) {
-  const file = configPermissionPath(bdsRoot, bpUuid);
-  if (fs.existsSync(file)) return false;
-  const dir = path.dirname(file);
-  await fs.promises.mkdir(dir, { recursive: true });
-  const payload = { allowed_modules: [...SFMC_PERMISSIONS] };
-  const tmp = path.join(dir, `.permission.${process.pid}.tmp`);
-  await fs.promises.writeFile(tmp, JSON.stringify(payload, null, 2) + "\n", "utf8");
-  await fs.promises.rename(tmp, file);
-  return true;
+async function ensureConfigPermission(bdsRoot, bpUuid, moduleUuid) {
+  let changed = false;
+  const updateFile = async (filePath) => {
+    let currentModules = [];
+    let restConfig = {};
+    if (fs.existsSync(filePath)) {
+      try {
+        const raw = readJsonFile(filePath);
+        if (Array.isArray(raw.allowed_modules)) {
+          currentModules = raw.allowed_modules;
+        }
+        const { allowed_modules: _, ...rest } = raw;
+        restConfig = rest;
+      } catch {
+      }
+    }
+    const merged = Array.from(/* @__PURE__ */ new Set([...currentModules, ...SFMC_PERMISSIONS]));
+    if (merged.length === currentModules.length && fs.existsSync(filePath)) {
+      return false;
+    }
+    const dir = path.dirname(filePath);
+    await fs.promises.mkdir(dir, { recursive: true });
+    const payload = { allowed_modules: merged, ...restConfig };
+    const tmp = path.join(dir, `.permission.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`);
+    await fs.promises.writeFile(tmp, JSON.stringify(payload, null, 2) + "\n", "utf8");
+    await fs.promises.rename(tmp, filePath);
+    return true;
+  };
+  const uuids = Array.from(/* @__PURE__ */ new Set([bpUuid, ...moduleUuid ? [moduleUuid] : []]));
+  for (const u of uuids) {
+    if (await updateFile(configPermissionsPath(bdsRoot, u))) changed = true;
+    if (await updateFile(configPermissionPath(bdsRoot, u))) changed = true;
+  }
+  const defaultFile = path.join(bdsRoot, "config", "default", "permissions.json");
+  if (await updateFile(defaultFile)) changed = true;
+  return changed;
 }
 function readPackManifestHeader(packDir) {
   const file = path.join(packDir, "manifest.json");
@@ -135,6 +175,16 @@ function readPackManifestHeader(packDir) {
     return null;
   }
 }
+function readPackManifestDependencies(packDir) {
+  const file = path.join(packDir, "manifest.json");
+  if (!fs.existsSync(file)) return [];
+  try {
+    const raw = readJsonFile(file);
+    return Array.isArray(raw.dependencies) ? raw.dependencies : [];
+  } catch {
+    return [];
+  }
+}
 async function writePermissionsJson(bpDir) {
   const payload = { allowed_modules: [...SFMC_PERMISSIONS] };
   await fs.promises.mkdir(bpDir, { recursive: true });
@@ -164,7 +214,7 @@ async function editWorldPackList(opts, mode) {
   await fs.promises.writeFile(tmp, JSON.stringify(entries, null, 2) + "\n", "utf8");
   await fs.promises.rename(tmp, file);
 }
-async function writeBehaviorPackManifest(outDir, header) {
+async function writeBehaviorPackManifest(outDir, header, dependencies) {
   const manifest = {
     format_version: 2,
     header: {
@@ -183,11 +233,7 @@ async function writeBehaviorPackManifest(outDir, header) {
         version: header.version
       }
     ],
-    dependencies: [
-      { module_name: "@minecraft/server", version: "1.18.0" },
-      { module_name: "@minecraft/server-admin", version: "1.0.0-beta" },
-      { module_name: "@minecraft/diagnostics", version: "1.0.0-beta" }
-    ]
+    dependencies: dependencies && dependencies.length > 0 ? dependencies : BASELINE_BEDROCK_DEPENDENCIES
   };
   const file = path.join(outDir, "manifest.json");
   await fs.promises.mkdir(outDir, { recursive: true });
@@ -281,6 +327,7 @@ export {
   bdsWorldLevelDir,
   bdsWorldsDir,
   configPermissionPath,
+  configPermissionsPath,
   copyDirAsync,
   copyFileAsync,
   deployToBDS,
@@ -288,10 +335,12 @@ export {
   enablePackInWorld,
   ensureConfigPermission,
   hasConfigPermission,
+  levelDatPath,
   loadModuleResourcePackMap,
   randomUuid,
   readLevelName,
   readLevelNameSync,
+  readPackManifestDependencies,
   readPackManifestHeader,
   readWorldPackList,
   readWorldPackListResult,

package/dist/pack-manager.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/pack-manager.ts"],
-  "sourcesContent": ["/**\n * pack-manager.ts \u2014 Bedrock \u884C\u4E3A\u5305\uFF08BP\uFF09\u4E0E\u8D44\u6E90\u5305\uFF08RP\uFF09\u7EC4\u88C5\u53CA\u90E8\u7F72\u5F15\u64CE\n *\n * \u6838\u5FC3\u8BBE\u8BA1\u4E0E\u8C03\u7528\u8DEF\u5F84\uFF1A\n * - \u8FDB\u7A0B\u5185\u76F4\u8FDE\uFF08\u63A8\u8350\uFF09\uFF1A`@sfmc-bds/bds-tools/pack-manager-lib` \u4F9B CLI \u7F16\u6392\u4E0E\u751F\u547D\u5468\u671F\u7BA1\u7406\u76F4\u63A5\u8C03\u7528\uFF08\u9075\u5FAA\u4F9D\u8D56\u5012\u7F6E\u539F\u5219\uFF09\n * - \u72EC\u7ACB CLI\uFF1A\u7531 `cli-pack-manager.ts` \u66B4\u9732\u547D\u4EE4\u884C\u5B50\u547D\u4EE4\u4F9B\u811A\u672C\u4E0E\u624B\u5DE5\u8C03\u8BD5\u4F7F\u7528\n *\n * \u6838\u5FC3\u80FD\u529B\uFF1A\n * - \u884C\u4E3A\u5305\u7EC4\u88C5\uFF1A\u5C06 esbuild \u6253\u5305\u540E\u7684 `scripts/main.js`\u3001\u5143\u6570\u636E manifest \u4E0E\u56FE\u6807\u5C01\u88C5\u4E3A BDS \u884C\u4E3A\u5305\u7ED3\u6784\n * - \u8D44\u6E90\u5305\u805A\u5408\uFF1A\u5C06\u5404\u6A21\u5757\u79C1\u6709\u7684 `resource_pack` \u76EE\u5F55\u65E0\u51B2\u7A81\u9012\u5F52\u5408\u5E76\u4E3A\u805A\u5408\u8D44\u6E90\u5305\n * - \u4E16\u754C\u90E8\u7F72\u4E0E\u6E05\u5355\u6FC0\u6D3B\uFF1A\u5C06\u5305\u90E8\u7F72\u81F3 BDS `<level>/behavior_packs` \u4E0E `resource_packs`\uFF0C\u5E76\u540C\u6B65\u7EF4\u62A4 `world_behavior_packs.json`\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { copyDirAsync, copyFileAsync, readJsonFile } from \"./fsx.js\";\n\n/* \u2500\u2500 \u7C7B\u578B\u5B9A\u4E49 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n\nexport interface AssembleBehaviorPackOpts {\n  /** \u5DF2\u5B8C\u6210\u6253\u5305\u7684 `scripts/main.js` \u6240\u5728\u6E90\u7801\u76EE\u5F55\uFF08\u5373 esbuild \u8F93\u51FA\u76EE\u5F55\uFF09\u3002 */\n  srcDir: string;\n  /** \u884C\u4E3A\u5305\u76EE\u6807\u8F93\u51FA\u76EE\u5F55\uFF08\u82E5\u4E0D\u5B58\u5728\u5219\u81EA\u52A8\u521B\u5EFA\uFF09\u3002 */\n  outDir: string;\n  /** BP \u9879\u76EE/\u76EE\u5F55\u540D\uFF08\u9ED8\u8BA4\u4E3A `'sfmc-modules'`\uFF09\u3002 */\n  projectName: string;\n  /** `manifest.json` \u4E2D\u7684 `header.version` `[major, minor, patch]`\uFF08\u9ED8\u8BA4\u4E3A `[1, 0, 0]`\uFF09\u3002 */\n  version?: [number, number, number] | undefined;\n  /** `manifest.json` \u4E2D\u7684\u5305\u63CF\u8FF0\u4FE1\u606F\u3002 */\n  description?: string | undefined;\n  /** `pack_icon.png` \u56FE\u6807\u6E90\u6587\u4EF6\u8DEF\u5F84\uFF08\u53EF\u9009\uFF0C\u672A\u63D0\u4F9B\u5219\u8DF3\u8FC7\uFF09\u3002 */\n  iconSrc?: string | undefined;\n  /** \u7A33\u5B9A\u7684 `header.uuid`\uFF08\u7F3A\u7701\u65F6\u5C06\u5728\u9996\u6B21\u88C5\u914D\u65F6\u968F\u673A\u751F\u6210\uFF09\u3002 */\n  uuid?: string | undefined;\n  /** \u7A33\u5B9A\u7684 `script module uuid`\uFF08\u7F3A\u7701\u65F6\u968F\u673A\u751F\u6210\uFF09\u3002 */\n  moduleUuid?: string | undefined;\n}\n\nexport interface AssembleResourcePackOpts {\n  /** \u9700\u5408\u5E76\u8D44\u6E90\u5305\u76EE\u5F55\u7684\u6A21\u5757\u6620\u5C04\u5B57\u5178\uFF08`Record<moduleId, resourcePackDir>`\uFF09\u3002 */\n  moduleResourceDirs: Record<string, string>;\n  /** \u8D44\u6E90\u5305\u76EE\u6807\u8F93\u51FA\u76EE\u5F55\uFF08\u82E5\u4E0D\u5B58\u5728\u5219\u81EA\u52A8\u521B\u5EFA\uFF09\u3002 */\n  outDir: string;\n  /** RP \u9879\u76EE/\u76EE\u5F55\u540D\u3002 */\n  projectName: string;\n  /** `manifest.json` \u4E2D\u7684 `header.version` `[major, minor, patch]`\uFF08\u9ED8\u8BA4\u4E3A `[1, 0, 0]`\uFF09\u3002 */\n  version?: [number, number, number] | undefined;\n  /** `manifest.json` \u4E2D\u7684\u5305\u63CF\u8FF0\u4FE1\u606F\u3002 */\n  description?: string | undefined;\n  /** \u7A33\u5B9A\u7684 `header.uuid`\uFF08\u7F3A\u7701\u65F6\u968F\u673A\u751F\u6210\uFF09\u3002 */\n  uuid?: string | undefined;\n  /** \u7A33\u5B9A\u7684 `resources module uuid`\uFF08\u7F3A\u7701\u65F6\u968F\u673A\u751F\u6210\uFF09\u3002 */\n  moduleUuid?: string | undefined;\n}\n\n\nexport interface AssembleResult {\n  uuid: string;\n  version: [number, number, number];\n}\n\nexport interface DeployOpts {\n  bdsRoot: string;\n  levelName: string;\n  /** \u5DF2\u7EC4\u88C5\u597D\u7684 BP \u6E90\u76EE\u5F55 */\n  behaviorPackSrc: string;\n  /** \u5DF2\u7EC4\u88C5\u597D\u7684 RP \u6E90\u76EE\u5F55 (\u53EF\u7701\u7565,\u53EA\u7528 BP \u4E5F\u5408\u6CD5) */\n  resourcePackSrc?: string;\n  /** BP \u76EE\u6807\u76EE\u5F55\u540D (worlds/<level>/behavior_packs/<bpName>) */\n  bpName: string;\n  /** RP \u76EE\u6807\u76EE\u5F55\u540D (worlds/<level>/resource_packs/<rpName>);\u7701\u7565\u65F6\u590D\u7528 bpName + '-rp' */\n  rpName?: string;\n  /**\n   * \u65E0 resourcePackSrc \u65F6\u662F\u5426\u5220\u9664\u4E16\u754C\u5185\u5DF2\u6709 RP \u76EE\u5F55\u3002\n   * \u7528\u4E8E\u6A21\u5757\u4E0D\u518D\u63D0\u4F9B RP \u65F6\u6E05\u7406\u805A\u5408\u5305\u6B8B\u7559(\u9ED8\u8BA4 false,\u907F\u514D\u8BEF\u5220\u672A\u58F0\u660E\u7684 RP)\u3002\n   */\n  clearResourcePack?: boolean;\n}\n\nexport interface DeployResult {\n  bpDir: string;\n  rpDir: string | null;\n}\n\nexport interface EnablePackOpts {\n  worldsDir: string;\n  levelName: string;\n  kind: \"behavior\" | \"resource\";\n  packUuid: string;\n  version: [number, number, number];\n}\n\n/* \u2500\u2500 \u8DEF\u5F84\u5E38\u91CF \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n\n/** SFMC \u5408\u6210 BP \u7684\u56FA\u5B9A @minecraft/* permissions,\u6240\u6709\u7528\u5230\u7684\u547D\u540D\u7A7A\u95F4\u90FD\u6253\u5F00\u3002 */\nexport const SFMC_PERMISSIONS = [\n  \"@minecraft/server\",\n  \"@minecraft/server-ui\",\n  \"@minecraft/server-admin\",\n  \"@minecraft/server-gametest\",\n  \"@minecraft/server-net\",\n  \"@minecraft/server-editor\",\n  \"@minecraft/diagnostics\",\n] as const;\n\n/** `<bdsRoot>/server.properties` \u2014 level-name / telemetry \u7B49\u5171\u7528\uFF08DRY\uFF09 */\nexport function serverPropertiesPath(bdsRoot: string): string {\n  return path.join(bdsRoot, \"server.properties\");\n}\n\n/** `<bdsRoot>/worlds` \u2014 enable-list / \u90E8\u7F72\u8C03\u7528\u65B9\u52FF\u518D\u786C\u62FC\uFF08Demeter\uFF09 */\nexport function bdsWorldsDir(bdsRoot: string): string {\n  return path.join(bdsRoot, \"worlds\");\n}\n\n/** `<bdsRoot>/worlds/<level>` */\nexport function bdsWorldLevelDir(bdsRoot: string, levelName: string): string {\n  return path.join(bdsWorldsDir(bdsRoot), levelName);\n}\n\n/** \u4E16\u754C enable-list JSON \u7EDD\u5BF9\u8DEF\u5F84\uFF08\u5355\u4E00\u6743\u5A01\uFF0C\u4F9B\u8BFB\u5199\u4E24\u4FA7\uFF09 */\nexport function worldPackListFile(\n  worldsDir: string,\n  levelName: string,\n  kind: \"behavior\" | \"resource\"\n): string {\n  const name = kind === \"behavior\" ? \"world_behavior_packs.json\" : \"world_resource_packs.json\";\n  return path.join(worldsDir, levelName, name);\n}\n\n/** `<bdsRoot>/config/<bpUuid>/permission.json` \u2014 Script API \u6743\u9650\u6587\u4EF6\u6743\u5A01\u8DEF\u5F84 */\nexport function configPermissionPath(bdsRoot: string, bpUuid: string): string {\n  return path.join(bdsRoot, \"config\", bpUuid, \"permission.json\");\n}\n\n/** \u662F\u5426\u5DF2\u6709 Script API permission.json\uFF08\u53EA\u8BFB\uFF0C\u4F9B preflight/status\uFF09 */\nexport function hasConfigPermission(bdsRoot: string, bpUuid: string): boolean {\n  return fs.existsSync(configPermissionPath(bdsRoot, bpUuid));\n}\n\n/** \u968F\u673A\u751F\u6210 BP/RP manifest.json header.uuid (RFC 4122 v4) */\nexport function randomUuid(): string {\n  /* crypto.randomUUID \u662F Node 19+ \u5185\u7F6E,\u8FD9\u91CC\u76F4\u63A5\u7528 */\n  return crypto.randomUUID();\n}\n\n/* \u2500\u2500 \u9AA8\u67B6\u51FD\u6570 (Commit 5 \u5B9E\u73B0) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n\n/**\n * Assemble a Bedrock behavior pack directory at `outDir` from a prebuilt\n * `srcDir` (which must already contain `scripts/main.js` plus whatever else\n * was bundled by esbuild) and write a fresh `manifest.json` + `permissions.json`.\n *\n * The caller is responsible for running esbuild first; pack-manager does not\n * bundle scripts. That decoupling keeps pack assembly independent of the bundler.\n */\nexport async function assembleBehaviorPack(opts: AssembleBehaviorPackOpts): Promise<AssembleResult> {\n  const version = opts.version ?? [1, 0, 0];\n  const bpUuid = opts.uuid ?? randomUuid();\n  await fs.promises.rm(opts.outDir, { recursive: true, force: true });\n  await fs.promises.mkdir(opts.outDir, { recursive: true });\n  if (fs.existsSync(opts.srcDir)) {\n    await copyDirAsync(opts.srcDir, opts.outDir);\n  } else {\n    await fs.promises.mkdir(path.join(opts.outDir, \"scripts\"), { recursive: true });\n    await fs.promises.writeFile(path.join(opts.outDir, \"scripts\", \"main.js\"), \"/* no scripts */\\n\", \"utf8\");\n  }\n  await writeBehaviorPackManifest(opts.outDir, {\n    name: opts.projectName,\n    uuid: bpUuid,\n    version,\n    description: opts.description,\n    moduleUuid: opts.moduleUuid,\n  });\n  if (opts.iconSrc && fs.existsSync(opts.iconSrc)) {\n    await copyFileAsync(opts.iconSrc, path.join(opts.outDir, \"pack_icon.png\"));\n  }\n  await writePermissionsJson(opts.outDir);\n  return { uuid: bpUuid, version };\n}\n\n/**\n * Merge every enabled module's `resource_pack/**` tree into one RP directory\n * at `outDir`, with a single fresh `manifest.json`. Per-module subfolders are\n * preserved so resource pack authors can disambiguate (e.g. `peace/textures/...`).\n */\nexport async function assembleResourcePack(opts: AssembleResourcePackOpts): Promise<AssembleResult> {\n  const version = opts.version ?? [1, 0, 0];\n  const rpUuid = opts.uuid ?? randomUuid();\n  await fs.promises.rm(opts.outDir, { recursive: true, force: true });\n  await fs.promises.mkdir(opts.outDir, { recursive: true });\n  for (const [moduleId, rpDir] of Object.entries(opts.moduleResourceDirs)) {\n    if (!fs.existsSync(rpDir)) continue;\n    const dst = path.join(opts.outDir, moduleId);\n    await fs.promises.mkdir(dst, { recursive: true });\n    await copyDirAsync(rpDir, dst);\n  }\n  await writeResourcePackManifest(opts.outDir, {\n    name: opts.projectName,\n    uuid: rpUuid,\n    version,\n    description: opts.description,\n    moduleUuid: opts.moduleUuid,\n  });\n  return { uuid: rpUuid, version };\n}\n\n/**\n * Read the `level-name=` value from `<bdsRoot>/server.properties`.\n * Falls back to \"Bedrock level\" (BDS default) when the file is missing or\n * the key is absent.\n */\nfunction parseLevelNameFromProperties(text: string): string {\n  for (const line of text.split(/\\r?\\n/)) {\n    const m = /^\\s*level-name\\s*=\\s*(.+?)\\s*$/.exec(line);\n    if (m && m[1]) return m[1];\n  }\n  return \"Bedrock level\";\n}\n\n/** \u540C\u6B65\u8BFB level-name\uFF08\u4F9B sfmc resolveBdsContext \u7B49\u540C\u8FDB\u7A0B\u8C03\u7528\u65B9\uFF0CDRY\uFF09\u3002 */\nexport function readLevelNameSync(bdsRoot: string): string {\n  const file = serverPropertiesPath(bdsRoot);\n  if (!fs.existsSync(file)) return \"Bedrock level\";\n  return parseLevelNameFromProperties(fs.readFileSync(file, \"utf8\"));\n}\n\n/** \u4E0E sync \u540C\u5951\u7EA6\uFF1BCLI / async \u8C03\u7528\u65B9\u8D70\u6B64\u5165\u53E3\uFF08LSP\uFF09 */\nexport async function readLevelName(bdsRoot: string): Promise<string> {\n  return readLevelNameSync(bdsRoot);\n}\n\n/**\n * Copy BP/RP source dirs into the world's behavior_packs/ + resource_packs/\n * folders, and write a fresh `permissions.json` into the BP target.\n *\n * Does NOT edit world_behavior_packs.json \u2014 that's a separate step the caller\n * must invoke after restart, because BDS only reads that file at startup.\n */\nexport async function deployToBDS(opts: DeployOpts): Promise<DeployResult> {\n  /* levelDir = worlds/<level>\uFF1B\u4E0E EnablePackOpts.worldsDir(=worlds/) \u8BED\u4E49\u4E0D\u540C \u2014 \u52FF\u6DF7\u7528\uFF08LSP\uFF09 */\n  const levelDir = bdsWorldLevelDir(opts.bdsRoot, opts.levelName);\n  const bpDst = path.join(levelDir, \"behavior_packs\", opts.bpName);\n  const rpDst = path.join(levelDir, \"resource_packs\", opts.rpName ?? `${opts.bpName}-rp`);\n  await fs.promises.mkdir(levelDir, { recursive: true });\n  await fs.promises.rm(bpDst, { recursive: true, force: true });\n  await copyDirAsync(opts.behaviorPackSrc, bpDst);\n  await writePermissionsJson(bpDst);\n  let rpDir: string | null = null;\n  if (opts.resourcePackSrc && fs.existsSync(opts.resourcePackSrc)) {\n    await fs.promises.rm(rpDst, { recursive: true, force: true });\n    await copyDirAsync(opts.resourcePackSrc, rpDst);\n    rpDir = rpDst;\n  } else if (opts.clearResourcePack) {\n    /* \u8C03\u7528\u65B9\u663E\u5F0F\u58F0\u660E\u4E0D\u518D\u90E8\u7F72 RP \u2014 \u6E05\u6389\u805A\u5408 RP \u76EE\u5F55\u6B8B\u7559 */\n    await fs.promises.rm(rpDst, { recursive: true, force: true });\n  }\n  return { bpDir: bpDst, rpDir };\n}\n\n/**\n * \u786E\u4FDD BDS Script API \u4FA7 `<bdsRoot>/config/<bpUuid>/permission.json` \u5B58\u5728\u3002\n * \u5DF2\u5B58\u5728\u5219\u8DF3\u8FC7(\u4E0D\u8986\u76D6\u7528\u6237\u624B\u5DE5\u6539\u52A8)\u3002\n * @returns true = \u65B0\u5199\u5165; false = \u5DF2\u5B58\u5728\u8DF3\u8FC7\n */\nexport async function ensureConfigPermission(bdsRoot: string, bpUuid: string): Promise<boolean> {\n  const file = configPermissionPath(bdsRoot, bpUuid);\n  if (fs.existsSync(file)) return false;\n  const dir = path.dirname(file);\n  await fs.promises.mkdir(dir, { recursive: true });\n  const payload = { allowed_modules: [...SFMC_PERMISSIONS] };\n  const tmp = path.join(dir, `.permission.${process.pid}.tmp`);\n  await fs.promises.writeFile(tmp, JSON.stringify(payload, null, 2) + \"\\n\", \"utf8\");\n  await fs.promises.rename(tmp, file);\n  return true;\n}\n\n/** \u4ECE\u5DF2\u88C5\u914D BP/RP \u76EE\u5F55\u8BFB\u53D6 header.uuid + version;\u5931\u8D25\u8FD4\u56DE null\u3002 */\nexport function readPackManifestHeader(\n  packDir: string\n): { uuid: string; version: [number, number, number]; moduleUuid?: string } | null {\n  const file = path.join(packDir, \"manifest.json\");\n  if (!fs.existsSync(file)) return null;\n  try {\n    const raw = readJsonFile<{\n      header?: { uuid?: string; version?: number[] };\n      modules?: Array<{ uuid?: string }>;\n    }>(file);\n    const uuid = raw.header?.uuid;\n    const ver = raw.header?.version;\n    if (typeof uuid !== \"string\" || !Array.isArray(ver) || ver.length < 3) return null;\n    const version: [number, number, number] = [Number(ver[0]), Number(ver[1]), Number(ver[2])];\n    const moduleUuid = raw.modules?.[0]?.uuid;\n    return { uuid, version, ...(typeof moduleUuid === \"string\" ? { moduleUuid } : {}) };\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Write `@minecraft/*` allowed_modules into a behavior pack's\n * `permissions.json`. Idempotent: rewrites any pre-existing file.\n */\nexport async function writePermissionsJson(bpDir: string): Promise<void> {\n  const payload = { allowed_modules: [...SFMC_PERMISSIONS] };\n  await fs.promises.mkdir(bpDir, { recursive: true });\n  const tmp = path.join(bpDir, `.permissions.${process.pid}.tmp`);\n  await fs.promises.writeFile(tmp, JSON.stringify(payload, null, 2) + \"\\n\", \"utf8\");\n  await fs.promises.rename(tmp, path.join(bpDir, \"permissions.json\"));\n}\n\n/**\n * Add `{ pack_id, version }` to `worlds/<level>/world_behavior_packs.json`\n * (or `world_resource_packs.json`). If the pack_id already exists, replace its\n * version. File missing \u2192 initialize as `[]`.\n */\nexport async function enablePackInWorld(opts: EnablePackOpts): Promise<void> {\n  await editWorldPackList(opts, \"enable\");\n}\n\n/** Remove a pack_id from the world's enable-list JSON. */\nexport async function disablePackInWorld(opts: EnablePackOpts): Promise<void> {\n  await editWorldPackList(opts, \"disable\");\n}\n\ninterface WorldPackEntry {\n  pack_id: string;\n  version: [number, number, number];\n}\n\nasync function editWorldPackList(\n  opts: EnablePackOpts,\n  mode: \"enable\" | \"disable\"\n): Promise<void> {\n  const file = worldPackListFile(opts.worldsDir, opts.levelName, opts.kind);\n  /* \u4E0E readWorldPackList \u540C\u6E90\u89E3\u6790,\u518D\u5199\u56DE(DRY);\u5F02\u6B65\u5199\u8DEF\u5F84\u4FDD\u7559\u539F\u8BED\u4E49 */\n  let entries: WorldPackEntry[] = readWorldPackList(opts.worldsDir, opts.levelName, opts.kind);\n  const idx = entries.findIndex((e) => e.pack_id === opts.packUuid);\n  if (mode === \"enable\") {\n    const next: WorldPackEntry = { pack_id: opts.packUuid, version: opts.version };\n    if (idx >= 0) entries[idx] = next;\n    else entries.push(next);\n  } else {\n    if (idx >= 0) entries.splice(idx, 1);\n  }\n  await fs.promises.mkdir(path.dirname(file), { recursive: true });\n  const tmp = `${file}.${process.pid}.tmp`;\n  await fs.promises.writeFile(tmp, JSON.stringify(entries, null, 2) + \"\\n\", \"utf8\");\n  await fs.promises.rename(tmp, file);\n}\n\n/* \u2500\u2500 \u4F4E\u5C42 helpers (Commit 5 \u5B9E\u73B0) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n\nexport async function writeBehaviorPackManifest(\n  outDir: string,\n  header: {\n    name: string;\n    uuid: string;\n    version: [number, number, number];\n    description?: string | undefined;\n    moduleUuid?: string | undefined;\n  }\n): Promise<void> {\n  const manifest = {\n    format_version: 2,\n    header: {\n      name: header.name,\n      uuid: header.uuid,\n      version: header.version,\n      description: header.description ? `${header.description} (behavior pack)` : \"SFMC behavior pack\",\n      min_engine_version: [1, 21, 0],\n    },\n    modules: [\n      {\n        type: \"script\",\n        language: \"javascript\",\n        entry: \"scripts/main.js\",\n        uuid: header.moduleUuid ?? crypto.randomUUID(),\n        version: header.version,\n      },\n    ],\n    dependencies: [\n      { module_name: \"@minecraft/server\", version: \"1.18.0\" },\n      { module_name: \"@minecraft/server-admin\", version: \"1.0.0-beta\" },\n      { module_name: \"@minecraft/diagnostics\", version: \"1.0.0-beta\" },\n    ],\n  };\n  const file = path.join(outDir, \"manifest.json\");\n  await fs.promises.mkdir(outDir, { recursive: true });\n  await fs.promises.writeFile(file, JSON.stringify(manifest, null, 2) + \"\\n\", \"utf8\");\n}\n\nexport async function writeResourcePackManifest(\n  outDir: string,\n  header: {\n    name: string;\n    uuid: string;\n    version: [number, number, number];\n    description?: string | undefined;\n    moduleUuid?: string | undefined;\n  }\n): Promise<void> {\n  const manifest = {\n    format_version: 2,\n    header: {\n      name: header.name,\n      uuid: header.uuid,\n      version: header.version,\n      description: header.description ? `${header.description} (resource pack)` : \"SFMC resource pack\",\n      min_engine_version: [1, 21, 0],\n    },\n    modules: [\n      {\n        type: \"resources\",\n        uuid: header.moduleUuid ?? crypto.randomUUID(),\n        version: header.version,\n      },\n    ],\n  };\n  const file = path.join(outDir, \"manifest.json\");\n  await fs.promises.mkdir(outDir, { recursive: true });\n  await fs.promises.writeFile(file, JSON.stringify(manifest, null, 2) + \"\\n\", \"utf8\");\n}\n\n/* Re-export copyFileAsync so callers can copy icon without\n * pulling in the full fsx surface area. */\nexport { copyFileAsync, copyDirAsync };\n\n/* \u2500\u2500 Discovery \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n\n/**\n * Walk `<modulesDir>/<id>/resource_pack/` for every installed module and\n * return a map { id: absoluteDir }. Modules without a resource_pack folder\n * are silently skipped. Used by `assemble-rp` and the sfmc CLI to know which\n * modules to merge into the resource pack output.\n */\nexport function scanModuleResourcePacks(modulesDir: string): Record<string, string> {\n  const out: Record<string, string> = {};\n  if (!fs.existsSync(modulesDir)) return out;\n  for (const entry of fs.readdirSync(modulesDir, { withFileTypes: true })) {\n    if (entry.name.startsWith(\".\")) continue;\n    // \u8DDF\u968F symlink\uFF08--link \u5B89\u88C5\uFF09\uFF1BDirent.isDirectory() \u5BF9\u94FE\u63A5\u76EE\u5F55\u4E3A false\n    try {\n      if (!fs.statSync(path.join(modulesDir, entry.name)).isDirectory()) continue;\n    } catch {\n      continue;\n    }\n    const rpDir = path.join(modulesDir, entry.name, \"resource_pack\");\n    if (fs.existsSync(rpDir)) {\n      out[entry.name] = rpDir;\n    }\n  }\n  return out;\n}\n\n/**\n * \u4ECE JSON \u6587\u4EF6\u52A0\u8F7D\u663E\u5F0F moduleId \u2192 resource_pack \u76EE\u5F55\u6620\u5C04\u3002\n * \u4F9B assemble-rp --modules-json \u4F7F\u7528,\u907F\u514D\u8C03\u7528\u65B9\u518D\u505A\u4E34\u65F6\u76EE\u5F55\u955C\u50CF(OCP/DRY)\u3002\n */\nexport function loadModuleResourcePackMap(jsonPath: string): Record<string, string> {\n  const raw = JSON.parse(fs.readFileSync(jsonPath, \"utf8\")) as unknown;\n  if (!raw || typeof raw !== \"object\" || Array.isArray(raw)) {\n    throw new Error(`modules-json must be an object: ${jsonPath}`);\n  }\n  const out: Record<string, string> = {};\n  for (const [id, dir] of Object.entries(raw as Record<string, unknown>)) {\n    if (typeof id !== \"string\" || !id || typeof dir !== \"string\" || !dir) continue;\n    const abs = path.resolve(dir);\n    if (!fs.existsSync(abs)) {\n      throw new Error(`modules-json entry missing: ${id} \u2192 ${abs}`);\n    }\n    out[id] = abs;\n  }\n  return out;\n}\n\n/**\n * \u8BFB\u53D6\u4E16\u754C enable-list(\u5355\u4E00\u6743\u5A01,\u4F9B has-pack / list-packs / \u8C03\u7528\u65B9\u590D\u7528 \u2014 DRY)\u3002\n * \u6587\u4EF6\u7F3A\u5931 \u2192 entries=[]\uFF1BJSON \u635F\u574F \u2192 entries=[] \u4E14 parseFailedFile \u6709\u503C\uFF08\u4F9B doctor \u533A\u5206\uFF09\u3002\n */\nexport type WorldPackListReadResult = {\n  entries: Array<{ pack_id: string; version: [number, number, number] }>;\n  /** \u6587\u4EF6\u5B58\u5728\u4F46\u89E3\u6790\u5931\u8D25\u65F6\u4E3A\u8BE5 JSON \u7EDD\u5BF9\u8DEF\u5F84 */\n  parseFailedFile?: string;\n};\n\nexport function readWorldPackListResult(\n  worldsDir: string,\n  levelName: string,\n  kind: \"behavior\" | \"resource\"\n): WorldPackListReadResult {\n  const file = worldPackListFile(worldsDir, levelName, kind);\n  if (!fs.existsSync(file)) return { entries: [] };\n  try {\n    const arr = JSON.parse(fs.readFileSync(file, \"utf8\")) as unknown;\n    if (!Array.isArray(arr)) return { entries: [], parseFailedFile: file };\n    const out: Array<{ pack_id: string; version: [number, number, number] }> = [];\n    for (const e of arr) {\n      if (!e || typeof e !== \"object\") continue;\n      const packId = (e as { pack_id?: unknown }).pack_id;\n      const ver = (e as { version?: unknown }).version;\n      if (typeof packId !== \"string\" || !packId) continue;\n      const version: [number, number, number] =\n        Array.isArray(ver) && ver.length >= 3\n          ? [Number(ver[0]), Number(ver[1]), Number(ver[2])]\n          : [1, 0, 0];\n      out.push({ pack_id: packId, version });\n    }\n    return { entries: out };\n  } catch {\n    return { entries: [], parseFailedFile: file };\n  }\n}\n\n/** \u517C\u5BB9\u8BFB\u4FA7\uFF1A\u53EA\u8981 entries\uFF08\u635F\u574F\u65F6\u4E0E\u7F3A\u5931\u540C\u4E3A []\uFF09\u3002\u8BE6\u7EC6\u7ED3\u679C\u89C1 readWorldPackListResult\u3002 */\nexport function readWorldPackList(\n  worldsDir: string,\n  levelName: string,\n  kind: \"behavior\" | \"resource\"\n): Array<{ pack_id: string; version: [number, number, number] }> {\n  return readWorldPackListResult(worldsDir, levelName, kind).entries;\n}\n\n/** \u4E16\u754C enable-list \u662F\u5426\u5DF2\u542B\u6307\u5B9A pack_id(\u53EA\u8BFB,\u4F9B preflight \u590D\u7528)\u3002 */\nexport function worldPackListHas(\n  worldsDir: string,\n  levelName: string,\n  kind: \"behavior\" | \"resource\",\n  packUuid: string\n): boolean {\n  return readWorldPackList(worldsDir, levelName, kind).some((e) => e.pack_id === packUuid);\n}"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * pack-manager.ts \u2014 Bedrock \u884C\u4E3A\u5305\uFF08BP\uFF09\u4E0E\u8D44\u6E90\u5305\uFF08RP\uFF09\u7EC4\u88C5\u53CA\u90E8\u7F72\u5F15\u64CE\n *\n * \u6838\u5FC3\u8BBE\u8BA1\u4E0E\u8C03\u7528\u8DEF\u5F84\uFF1A\n * - \u8FDB\u7A0B\u5185\u76F4\u8FDE\uFF08\u63A8\u8350\uFF09\uFF1A`@sfmc-bds/bds-tools/pack-manager-lib` \u4F9B CLI \u7F16\u6392\u4E0E\u751F\u547D\u5468\u671F\u7BA1\u7406\u76F4\u63A5\u8C03\u7528\uFF08\u9075\u5FAA\u4F9D\u8D56\u5012\u7F6E\u539F\u5219\uFF09\n * - \u72EC\u7ACB CLI\uFF1A\u7531 `cli-pack-manager.ts` \u66B4\u9732\u547D\u4EE4\u884C\u5B50\u547D\u4EE4\u4F9B\u811A\u672C\u4E0E\u624B\u5DE5\u8C03\u8BD5\u4F7F\u7528\n *\n * \u6838\u5FC3\u80FD\u529B\uFF1A\n * - \u884C\u4E3A\u5305\u7EC4\u88C5\uFF1A\u5C06 esbuild \u6253\u5305\u540E\u7684 `scripts/main.js`\u3001\u5143\u6570\u636E manifest \u4E0E\u56FE\u6807\u5C01\u88C5\u4E3A BDS \u884C\u4E3A\u5305\u7ED3\u6784\n * - \u8D44\u6E90\u5305\u805A\u5408\uFF1A\u5C06\u5404\u6A21\u5757\u79C1\u6709\u7684 `resource_pack` \u76EE\u5F55\u65E0\u51B2\u7A81\u9012\u5F52\u5408\u5E76\u4E3A\u805A\u5408\u8D44\u6E90\u5305\n * - \u4E16\u754C\u90E8\u7F72\u4E0E\u6E05\u5355\u6FC0\u6D3B\uFF1A\u5C06\u5305\u90E8\u7F72\u81F3 BDS `<level>/behavior_packs` \u4E0E `resource_packs`\uFF0C\u5E76\u540C\u6B65\u7EF4\u62A4 `world_behavior_packs.json`\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { copyDirAsync, copyFileAsync, readJsonFile } from \"./fsx.js\";\nimport {\n  BASELINE_BEDROCK_DEPENDENCIES,\n  type PackManifestDependency,\n} from \"./dependency-negotiator.js\";\nexport * from \"./dependency-negotiator.js\";\n\n/* \u2500\u2500 \u7C7B\u578B\u5B9A\u4E49 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n\nexport interface AssembleBehaviorPackOpts {\n  /** \u5DF2\u5B8C\u6210\u6253\u5305\u7684 `scripts/main.js` \u6240\u5728\u6E90\u7801\u76EE\u5F55\uFF08\u5373 esbuild \u8F93\u51FA\u76EE\u5F55\uFF09\u3002 */\n  srcDir: string;\n  /** \u884C\u4E3A\u5305\u76EE\u6807\u8F93\u51FA\u76EE\u5F55\uFF08\u82E5\u4E0D\u5B58\u5728\u5219\u81EA\u52A8\u521B\u5EFA\uFF09\u3002 */\n  outDir: string;\n  /** BP \u9879\u76EE/\u76EE\u5F55\u540D\uFF08\u9ED8\u8BA4\u4E3A `'sfmc-modules'`\uFF09\u3002 */\n  projectName: string;\n  /** `manifest.json` \u4E2D\u7684 `header.version` `[major, minor, patch]`\uFF08\u9ED8\u8BA4\u4E3A `[1, 0, 0]`\uFF09\u3002 */\n  version?: [number, number, number] | undefined;\n  /** `manifest.json` \u4E2D\u7684\u5305\u63CF\u8FF0\u4FE1\u606F\u3002 */\n  description?: string | undefined;\n  /** `pack_icon.png` \u56FE\u6807\u6E90\u6587\u4EF6\u8DEF\u5F84\uFF08\u53EF\u9009\uFF0C\u672A\u63D0\u4F9B\u5219\u8DF3\u8FC7\uFF09\u3002 */\n  iconSrc?: string | undefined;\n  /** \u7A33\u5B9A\u7684 `header.uuid`\uFF08\u7F3A\u7701\u65F6\u5C06\u5728\u9996\u6B21\u88C5\u914D\u65F6\u968F\u673A\u751F\u6210\uFF09\u3002 */\n  uuid?: string | undefined;\n  /** \u7A33\u5B9A\u7684 `script module uuid`\uFF08\u7F3A\u7701\u65F6\u968F\u673A\u751F\u6210\uFF09\u3002 */\n  moduleUuid?: string | undefined;\n  /** \u81EA\u5B9A\u4E49/\u52A8\u6001\u534F\u5546\u540E\u7684 dependencies\uFF08\u7F3A\u7701\u4F7F\u7528 BASELINE_BEDROCK_DEPENDENCIES\uFF09\u3002 */\n  dependencies?: PackManifestDependency[] | undefined;\n}\n\nexport interface AssembleResourcePackOpts {\n  /** \u9700\u5408\u5E76\u8D44\u6E90\u5305\u76EE\u5F55\u7684\u6A21\u5757\u6620\u5C04\u5B57\u5178\uFF08`Record<moduleId, resourcePackDir>`\uFF09\u3002 */\n  moduleResourceDirs: Record<string, string>;\n  /** \u8D44\u6E90\u5305\u76EE\u6807\u8F93\u51FA\u76EE\u5F55\uFF08\u82E5\u4E0D\u5B58\u5728\u5219\u81EA\u52A8\u521B\u5EFA\uFF09\u3002 */\n  outDir: string;\n  /** RP \u9879\u76EE/\u76EE\u5F55\u540D\u3002 */\n  projectName: string;\n  /** `manifest.json` \u4E2D\u7684 `header.version` `[major, minor, patch]`\uFF08\u9ED8\u8BA4\u4E3A `[1, 0, 0]`\uFF09\u3002 */\n  version?: [number, number, number] | undefined;\n  /** `manifest.json` \u4E2D\u7684\u5305\u63CF\u8FF0\u4FE1\u606F\u3002 */\n  description?: string | undefined;\n  /** \u7A33\u5B9A\u7684 `header.uuid`\uFF08\u7F3A\u7701\u65F6\u968F\u673A\u751F\u6210\uFF09\u3002 */\n  uuid?: string | undefined;\n  /** \u7A33\u5B9A\u7684 `resources module uuid`\uFF08\u7F3A\u7701\u65F6\u968F\u673A\u751F\u6210\uFF09\u3002 */\n  moduleUuid?: string | undefined;\n}\n\n\nexport interface AssembleResult {\n  uuid: string;\n  version: [number, number, number];\n}\n\nexport interface DeployOpts {\n  bdsRoot: string;\n  levelName: string;\n  /** \u5DF2\u7EC4\u88C5\u597D\u7684 BP \u6E90\u76EE\u5F55 */\n  behaviorPackSrc: string;\n  /** \u5DF2\u7EC4\u88C5\u597D\u7684 RP \u6E90\u76EE\u5F55 (\u53EF\u7701\u7565,\u53EA\u7528 BP \u4E5F\u5408\u6CD5) */\n  resourcePackSrc?: string;\n  /** BP \u76EE\u6807\u76EE\u5F55\u540D (worlds/<level>/behavior_packs/<bpName>) */\n  bpName: string;\n  /** RP \u76EE\u6807\u76EE\u5F55\u540D (worlds/<level>/resource_packs/<rpName>);\u7701\u7565\u65F6\u590D\u7528 bpName + '-rp' */\n  rpName?: string;\n  /**\n   * \u65E0 resourcePackSrc \u65F6\u662F\u5426\u5220\u9664\u4E16\u754C\u5185\u5DF2\u6709 RP \u76EE\u5F55\u3002\n   * \u7528\u4E8E\u6A21\u5757\u4E0D\u518D\u63D0\u4F9B RP \u65F6\u6E05\u7406\u805A\u5408\u5305\u6B8B\u7559(\u9ED8\u8BA4 false,\u907F\u514D\u8BEF\u5220\u672A\u58F0\u660E\u7684 RP)\u3002\n   */\n  clearResourcePack?: boolean;\n}\n\nexport interface DeployResult {\n  bpDir: string;\n  rpDir: string | null;\n}\n\nexport interface EnablePackOpts {\n  worldsDir: string;\n  levelName: string;\n  kind: \"behavior\" | \"resource\";\n  packUuid: string;\n  version: [number, number, number];\n}\n\n/* \u2500\u2500 \u8DEF\u5F84\u5E38\u91CF \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n\n/** SFMC \u5408\u6210 BP \u7684\u56FA\u5B9A @minecraft/* permissions,\u6240\u6709\u7528\u5230\u7684\u547D\u540D\u7A7A\u95F4\u90FD\u6253\u5F00\u3002 */\nexport const SFMC_PERMISSIONS = [\n  \"@minecraft/server\",\n  \"@minecraft/server-ui\",\n  \"@minecraft/server-admin\",\n  \"@minecraft/server-gametest\",\n  \"@minecraft/server-net\",\n  \"@minecraft/server-editor\",\n  \"@minecraft/diagnostics\",\n] as const;\n\n/** `<bdsRoot>/server.properties` \u2014 level-name / telemetry \u7B49\u5171\u7528\uFF08DRY\uFF09 */\nexport function serverPropertiesPath(bdsRoot: string): string {\n  return path.join(bdsRoot, \"server.properties\");\n}\n\n/** `<bdsRoot>/worlds` \u2014 enable-list / \u90E8\u7F72\u8C03\u7528\u65B9\u52FF\u518D\u786C\u62FC\uFF08Demeter\uFF09 */\nexport function bdsWorldsDir(bdsRoot: string): string {\n  return path.join(bdsRoot, \"worlds\");\n}\n\n/** `<bdsRoot>/worlds/<level>` */\nexport function bdsWorldLevelDir(bdsRoot: string, levelName: string): string {\n  return path.join(bdsWorldsDir(bdsRoot), levelName);\n}\n\n/** `<bdsRoot>/worlds/<level>/level.dat` \u2014 \u4E16\u754C\u5B58\u6863\u6743\u5A01\u8DEF\u5F84 */\nexport function levelDatPath(bdsRoot: string, levelName: string): string {\n  return path.join(bdsWorldLevelDir(bdsRoot, levelName), \"level.dat\");\n}\n\n/** \u4E16\u754C enable-list JSON \u7EDD\u5BF9\u8DEF\u5F84\uFF08\u5355\u4E00\u6743\u5A01\uFF0C\u4F9B\u8BFB\u5199\u4E24\u4FA7\uFF09 */\nexport function worldPackListFile(\n  worldsDir: string,\n  levelName: string,\n  kind: \"behavior\" | \"resource\"\n): string {\n  const name = kind === \"behavior\" ? \"world_behavior_packs.json\" : \"world_resource_packs.json\";\n  return path.join(worldsDir, levelName, name);\n}\n\n/** `<bdsRoot>/config/<bpUuid>/permission.json` \u2014 Script API \u6743\u9650\u6587\u4EF6\u6743\u5A01\u8DEF\u5F84 */\nexport function configPermissionPath(bdsRoot: string, bpUuid: string): string {\n  return path.join(bdsRoot, \"config\", bpUuid, \"permission.json\");\n}\n\n/** `<bdsRoot>/config/<bpUuid>/permissions.json` \u2014 BDS \u5B98\u65B9\u89C4\u8303\u590D\u6570\u6743\u9650\u6587\u4EF6\u8DEF\u5F84 */\nexport function configPermissionsPath(bdsRoot: string, bpUuid: string): string {\n  return path.join(bdsRoot, \"config\", bpUuid, \"permissions.json\");\n}\n\n/** \u662F\u5426\u5DF2\u6709 Script API permission.json \u6216 permissions.json\uFF08\u53EA\u8BFB\uFF0C\u4F9B preflight/status\uFF09 */\nexport function hasConfigPermission(bdsRoot: string, bpUuid: string): boolean {\n  return fs.existsSync(configPermissionsPath(bdsRoot, bpUuid)) || fs.existsSync(configPermissionPath(bdsRoot, bpUuid));\n}\n\n/** \u968F\u673A\u751F\u6210 BP/RP manifest.json header.uuid (RFC 4122 v4) */\nexport function randomUuid(): string {\n  /* crypto.randomUUID \u662F Node 19+ \u5185\u7F6E,\u8FD9\u91CC\u76F4\u63A5\u7528 */\n  return crypto.randomUUID();\n}\n\n/* \u2500\u2500 \u9AA8\u67B6\u51FD\u6570 (Commit 5 \u5B9E\u73B0) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n\n/**\n * Assemble a Bedrock behavior pack directory at `outDir` from a prebuilt\n * `srcDir` (which must already contain `scripts/main.js` plus whatever else\n * was bundled by esbuild) and write a fresh `manifest.json` + `permissions.json`.\n *\n * The caller is responsible for running esbuild first; pack-manager does not\n * bundle scripts. That decoupling keeps pack assembly independent of the bundler.\n */\nexport async function assembleBehaviorPack(opts: AssembleBehaviorPackOpts): Promise<AssembleResult> {\n  const version = opts.version ?? [1, 0, 0];\n  const bpUuid = opts.uuid ?? randomUuid();\n  await fs.promises.rm(opts.outDir, { recursive: true, force: true });\n  await fs.promises.mkdir(opts.outDir, { recursive: true });\n  if (fs.existsSync(opts.srcDir)) {\n    await copyDirAsync(opts.srcDir, opts.outDir);\n  } else {\n    await fs.promises.mkdir(path.join(opts.outDir, \"scripts\"), { recursive: true });\n    await fs.promises.writeFile(path.join(opts.outDir, \"scripts\", \"main.js\"), \"/* no scripts */\\n\", \"utf8\");\n  }\n  await writeBehaviorPackManifest(\n    opts.outDir,\n    {\n      name: opts.projectName,\n      uuid: bpUuid,\n      version,\n      description: opts.description,\n      moduleUuid: opts.moduleUuid,\n    },\n    opts.dependencies\n  );\n  if (opts.iconSrc && fs.existsSync(opts.iconSrc)) {\n    await copyFileAsync(opts.iconSrc, path.join(opts.outDir, \"pack_icon.png\"));\n  }\n  await writePermissionsJson(opts.outDir);\n  return { uuid: bpUuid, version };\n}\n\n/**\n * Merge every enabled module's `resource_pack/**` tree into one RP directory\n * at `outDir`, with a single fresh `manifest.json`. Per-module subfolders are\n * preserved so resource pack authors can disambiguate (e.g. `peace/textures/...`).\n */\nexport async function assembleResourcePack(opts: AssembleResourcePackOpts): Promise<AssembleResult> {\n  const version = opts.version ?? [1, 0, 0];\n  const rpUuid = opts.uuid ?? randomUuid();\n  await fs.promises.rm(opts.outDir, { recursive: true, force: true });\n  await fs.promises.mkdir(opts.outDir, { recursive: true });\n  for (const [moduleId, rpDir] of Object.entries(opts.moduleResourceDirs)) {\n    if (!fs.existsSync(rpDir)) continue;\n    const dst = path.join(opts.outDir, moduleId);\n    await fs.promises.mkdir(dst, { recursive: true });\n    await copyDirAsync(rpDir, dst);\n  }\n  await writeResourcePackManifest(opts.outDir, {\n    name: opts.projectName,\n    uuid: rpUuid,\n    version,\n    description: opts.description,\n    moduleUuid: opts.moduleUuid,\n  });\n  return { uuid: rpUuid, version };\n}\n\n/**\n * Read the `level-name=` value from `<bdsRoot>/server.properties`.\n * Falls back to \"Bedrock level\" (BDS default) when the file is missing or\n * the key is absent.\n */\nfunction parseLevelNameFromProperties(text: string): string {\n  for (const line of text.split(/\\r?\\n/)) {\n    const m = /^\\s*level-name\\s*=\\s*(.+?)\\s*$/.exec(line);\n    if (m && m[1]) return m[1];\n  }\n  return \"Bedrock level\";\n}\n\n/** \u540C\u6B65\u8BFB level-name\uFF08\u4F9B sfmc resolveBdsContext \u7B49\u540C\u8FDB\u7A0B\u8C03\u7528\u65B9\uFF0CDRY\uFF09\u3002 */\nexport function readLevelNameSync(bdsRoot: string): string {\n  const file = serverPropertiesPath(bdsRoot);\n  if (!fs.existsSync(file)) return \"Bedrock level\";\n  return parseLevelNameFromProperties(fs.readFileSync(file, \"utf8\"));\n}\n\n/** \u4E0E sync \u540C\u5951\u7EA6\uFF1BCLI / async \u8C03\u7528\u65B9\u8D70\u6B64\u5165\u53E3\uFF08LSP\uFF09 */\nexport async function readLevelName(bdsRoot: string): Promise<string> {\n  return readLevelNameSync(bdsRoot);\n}\n\n/**\n * Copy BP/RP source dirs into the world's behavior_packs/ + resource_packs/\n * folders, and write a fresh `permissions.json` into the BP target.\n *\n * Does NOT edit world_behavior_packs.json \u2014 that's a separate step the caller\n * must invoke after restart, because BDS only reads that file at startup.\n */\nexport async function deployToBDS(opts: DeployOpts): Promise<DeployResult> {\n  /* levelDir = worlds/<level>\uFF1B\u4E0E EnablePackOpts.worldsDir(=worlds/) \u8BED\u4E49\u4E0D\u540C \u2014 \u52FF\u6DF7\u7528\uFF08LSP\uFF09 */\n  const levelDir = bdsWorldLevelDir(opts.bdsRoot, opts.levelName);\n  const bpDst = path.join(levelDir, \"behavior_packs\", opts.bpName);\n  const rpDst = path.join(levelDir, \"resource_packs\", opts.rpName ?? `${opts.bpName}-rp`);\n  await fs.promises.mkdir(levelDir, { recursive: true });\n  await fs.promises.rm(bpDst, { recursive: true, force: true });\n  await copyDirAsync(opts.behaviorPackSrc, bpDst);\n  await writePermissionsJson(bpDst);\n  let rpDir: string | null = null;\n  if (opts.resourcePackSrc && fs.existsSync(opts.resourcePackSrc)) {\n    await fs.promises.rm(rpDst, { recursive: true, force: true });\n    await copyDirAsync(opts.resourcePackSrc, rpDst);\n    rpDir = rpDst;\n  } else if (opts.clearResourcePack) {\n    /* \u8C03\u7528\u65B9\u663E\u5F0F\u58F0\u660E\u4E0D\u518D\u90E8\u7F72 RP \u2014 \u6E05\u6389\u805A\u5408 RP \u76EE\u5F55\u6B8B\u7559 */\n    await fs.promises.rm(rpDst, { recursive: true, force: true });\n  }\n  return { bpDir: bpDst, rpDir };\n}\n\n/**\n * \u786E\u4FDD BDS Script API \u4FA7\u6743\u9650\u6587\u4EF6\u5B58\u5728\u5E76\u5305\u542B\u5B8C\u6574\u7684 SFMC \u6240\u9700\u6A21\u5757\u6743\u9650\u3002\n * - \u81EA\u52A8\u589E\u91CF\u5408\u5E76\u73B0\u6709 allowed_modules\uFF0C\u81EA\u52A8\u8865\u9F50\u65B0\u589E\u6743\u9650\uFF08\u5982 @minecraft/diagnostics\uFF09\n * - \u540C\u65F6\u7EF4\u62A4 BDS \u5B98\u65B9\u89C4\u8303\u7684 permissions.json \u4E0E\u5386\u53F2\u517C\u5BB9\u7684 permission.json\n * - \u540C\u65F6\u66F4\u65B0 moduleUuid\uFF08\u82E5\u63D0\u4F9B\uFF09\u4E0E config/default/permissions.json \u515C\u5E95\u6743\u9650\n * @returns true = \u6709\u65B0\u589E/\u66F4\u65B0; false = \u5DF2\u662F\u6700\u65B0\u65E0\u9700\u4FEE\u6539\n */\nexport async function ensureConfigPermission(\n  bdsRoot: string,\n  bpUuid: string,\n  moduleUuid?: string\n): Promise<boolean> {\n  let changed = false;\n\n  const updateFile = async (filePath: string): Promise<boolean> => {\n    let currentModules: string[] = [];\n    let restConfig: Record<string, unknown> = {};\n    if (fs.existsSync(filePath)) {\n      try {\n        const raw = readJsonFile<{ allowed_modules?: string[]; [k: string]: unknown }>(filePath);\n        if (Array.isArray(raw.allowed_modules)) {\n          currentModules = raw.allowed_modules;\n        }\n        const { allowed_modules: _, ...rest } = raw;\n        restConfig = rest;\n      } catch {\n        // \u6587\u4EF6\u635F\u574F\u5219\u6309\u5168\u65B0\u5199\u5165\n      }\n    }\n    const merged = Array.from(new Set([...currentModules, ...SFMC_PERMISSIONS]));\n    if (merged.length === currentModules.length && fs.existsSync(filePath)) {\n      return false;\n    }\n    const dir = path.dirname(filePath);\n    await fs.promises.mkdir(dir, { recursive: true });\n    const payload = { allowed_modules: merged, ...restConfig };\n    const tmp = path.join(dir, `.permission.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`);\n    await fs.promises.writeFile(tmp, JSON.stringify(payload, null, 2) + \"\\n\", \"utf8\");\n    await fs.promises.rename(tmp, filePath);\n    return true;\n  };\n\n  const uuids = Array.from(new Set([bpUuid, ...(moduleUuid ? [moduleUuid] : [])]));\n  for (const u of uuids) {\n    if (await updateFile(configPermissionsPath(bdsRoot, u))) changed = true;\n    if (await updateFile(configPermissionPath(bdsRoot, u))) changed = true;\n  }\n\n  const defaultFile = path.join(bdsRoot, \"config\", \"default\", \"permissions.json\");\n  if (await updateFile(defaultFile)) changed = true;\n\n  return changed;\n}\n\n/** \u4ECE\u5DF2\u88C5\u914D BP/RP \u76EE\u5F55\u8BFB\u53D6 header.uuid + version;\u5931\u8D25\u8FD4\u56DE null\u3002 */\nexport function readPackManifestHeader(\n  packDir: string\n): { uuid: string; version: [number, number, number]; moduleUuid?: string } | null {\n  const file = path.join(packDir, \"manifest.json\");\n  if (!fs.existsSync(file)) return null;\n  try {\n    const raw = readJsonFile<{\n      header?: { uuid?: string; version?: number[] };\n      modules?: Array<{ uuid?: string }>;\n    }>(file);\n    const uuid = raw.header?.uuid;\n    const ver = raw.header?.version;\n    if (typeof uuid !== \"string\" || !Array.isArray(ver) || ver.length < 3) return null;\n    const version: [number, number, number] = [Number(ver[0]), Number(ver[1]), Number(ver[2])];\n    const moduleUuid = raw.modules?.[0]?.uuid;\n    return { uuid, version, ...(typeof moduleUuid === \"string\" ? { moduleUuid } : {}) };\n  } catch {\n    return null;\n  }\n}\n\n\n/** \u4ECE\u5DF2\u88C5\u914D BP/RP \u76EE\u5F55\u8BFB\u53D6 dependencies \u5217\u8868\uFF1B\u82E5\u65E0\u6216\u5931\u8D25\u8FD4\u56DE []\u3002 */\nexport function readPackManifestDependencies(packDir: string): PackManifestDependency[] {\n  const file = path.join(packDir, \"manifest.json\");\n  if (!fs.existsSync(file)) return [];\n  try {\n    const raw = readJsonFile<{ dependencies?: PackManifestDependency[] }>(file);\n    return Array.isArray(raw.dependencies) ? raw.dependencies : [];\n  } catch {\n    return [];\n  }\n}\n\n/**\n * Write `@minecraft/*` allowed_modules into a behavior pack's\n * `permissions.json`. Idempotent: rewrites any pre-existing file.\n */\nexport async function writePermissionsJson(bpDir: string): Promise<void> {\n  const payload = { allowed_modules: [...SFMC_PERMISSIONS] };\n  await fs.promises.mkdir(bpDir, { recursive: true });\n  const tmp = path.join(bpDir, `.permissions.${process.pid}.tmp`);\n  await fs.promises.writeFile(tmp, JSON.stringify(payload, null, 2) + \"\\n\", \"utf8\");\n  await fs.promises.rename(tmp, path.join(bpDir, \"permissions.json\"));\n}\n\n/**\n * Add `{ pack_id, version }` to `worlds/<level>/world_behavior_packs.json`\n * (or `world_resource_packs.json`). If the pack_id already exists, replace its\n * version. File missing \u2192 initialize as `[]`.\n */\nexport async function enablePackInWorld(opts: EnablePackOpts): Promise<void> {\n  await editWorldPackList(opts, \"enable\");\n}\n\n/** Remove a pack_id from the world's enable-list JSON. */\nexport async function disablePackInWorld(opts: EnablePackOpts): Promise<void> {\n  await editWorldPackList(opts, \"disable\");\n}\n\ninterface WorldPackEntry {\n  pack_id: string;\n  version: [number, number, number];\n}\n\nasync function editWorldPackList(\n  opts: EnablePackOpts,\n  mode: \"enable\" | \"disable\"\n): Promise<void> {\n  const file = worldPackListFile(opts.worldsDir, opts.levelName, opts.kind);\n  /* \u4E0E readWorldPackList \u540C\u6E90\u89E3\u6790,\u518D\u5199\u56DE(DRY);\u5F02\u6B65\u5199\u8DEF\u5F84\u4FDD\u7559\u539F\u8BED\u4E49 */\n  let entries: WorldPackEntry[] = readWorldPackList(opts.worldsDir, opts.levelName, opts.kind);\n  const idx = entries.findIndex((e) => e.pack_id === opts.packUuid);\n  if (mode === \"enable\") {\n    const next: WorldPackEntry = { pack_id: opts.packUuid, version: opts.version };\n    if (idx >= 0) entries[idx] = next;\n    else entries.push(next);\n  } else {\n    if (idx >= 0) entries.splice(idx, 1);\n  }\n  await fs.promises.mkdir(path.dirname(file), { recursive: true });\n  const tmp = `${file}.${process.pid}.tmp`;\n  await fs.promises.writeFile(tmp, JSON.stringify(entries, null, 2) + \"\\n\", \"utf8\");\n  await fs.promises.rename(tmp, file);\n}\n\n/* \u2500\u2500 \u4F4E\u5C42 helpers (Commit 5 \u5B9E\u73B0) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n\nexport async function writeBehaviorPackManifest(\n  outDir: string,\n  header: {\n    name: string;\n    uuid: string;\n    version: [number, number, number];\n    description?: string | undefined;\n    moduleUuid?: string | undefined;\n  },\n  dependencies?: PackManifestDependency[] | undefined\n): Promise<void> {\n  const manifest = {\n    format_version: 2,\n    header: {\n      name: header.name,\n      uuid: header.uuid,\n      version: header.version,\n      description: header.description ? `${header.description} (behavior pack)` : \"SFMC behavior pack\",\n      min_engine_version: [1, 21, 0],\n    },\n    modules: [\n      {\n        type: \"script\",\n        language: \"javascript\",\n        entry: \"scripts/main.js\",\n        uuid: header.moduleUuid ?? crypto.randomUUID(),\n        version: header.version,\n      },\n    ],\n    dependencies:\n      dependencies && dependencies.length > 0 ? dependencies : BASELINE_BEDROCK_DEPENDENCIES,\n  };\n  const file = path.join(outDir, \"manifest.json\");\n  await fs.promises.mkdir(outDir, { recursive: true });\n  await fs.promises.writeFile(file, JSON.stringify(manifest, null, 2) + \"\\n\", \"utf8\");\n}\n\nexport async function writeResourcePackManifest(\n  outDir: string,\n  header: {\n    name: string;\n    uuid: string;\n    version: [number, number, number];\n    description?: string | undefined;\n    moduleUuid?: string | undefined;\n  }\n): Promise<void> {\n  const manifest = {\n    format_version: 2,\n    header: {\n      name: header.name,\n      uuid: header.uuid,\n      version: header.version,\n      description: header.description ? `${header.description} (resource pack)` : \"SFMC resource pack\",\n      min_engine_version: [1, 21, 0],\n    },\n    modules: [\n      {\n        type: \"resources\",\n        uuid: header.moduleUuid ?? crypto.randomUUID(),\n        version: header.version,\n      },\n    ],\n  };\n  const file = path.join(outDir, \"manifest.json\");\n  await fs.promises.mkdir(outDir, { recursive: true });\n  await fs.promises.writeFile(file, JSON.stringify(manifest, null, 2) + \"\\n\", \"utf8\");\n}\n\n/* Re-export copyFileAsync so callers can copy icon without\n * pulling in the full fsx surface area. */\nexport { copyFileAsync, copyDirAsync };\n\n/* \u2500\u2500 Discovery \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n\n/**\n * Walk `<modulesDir>/<id>/resource_pack/` for every installed module and\n * return a map { id: absoluteDir }. Modules without a resource_pack folder\n * are silently skipped. Used by `assemble-rp` and the sfmc CLI to know which\n * modules to merge into the resource pack output.\n */\nexport function scanModuleResourcePacks(modulesDir: string): Record<string, string> {\n  const out: Record<string, string> = {};\n  if (!fs.existsSync(modulesDir)) return out;\n  for (const entry of fs.readdirSync(modulesDir, { withFileTypes: true })) {\n    if (entry.name.startsWith(\".\")) continue;\n    // \u8DDF\u968F symlink\uFF08--link \u5B89\u88C5\uFF09\uFF1BDirent.isDirectory() \u5BF9\u94FE\u63A5\u76EE\u5F55\u4E3A false\n    try {\n      if (!fs.statSync(path.join(modulesDir, entry.name)).isDirectory()) continue;\n    } catch {\n      continue;\n    }\n    const rpDir = path.join(modulesDir, entry.name, \"resource_pack\");\n    if (fs.existsSync(rpDir)) {\n      out[entry.name] = rpDir;\n    }\n  }\n  return out;\n}\n\n/**\n * \u4ECE JSON \u6587\u4EF6\u52A0\u8F7D\u663E\u5F0F moduleId \u2192 resource_pack \u76EE\u5F55\u6620\u5C04\u3002\n * \u4F9B assemble-rp --modules-json \u4F7F\u7528,\u907F\u514D\u8C03\u7528\u65B9\u518D\u505A\u4E34\u65F6\u76EE\u5F55\u955C\u50CF(OCP/DRY)\u3002\n */\nexport function loadModuleResourcePackMap(jsonPath: string): Record<string, string> {\n  const raw = JSON.parse(fs.readFileSync(jsonPath, \"utf8\")) as unknown;\n  if (!raw || typeof raw !== \"object\" || Array.isArray(raw)) {\n    throw new Error(`modules-json must be an object: ${jsonPath}`);\n  }\n  const out: Record<string, string> = {};\n  for (const [id, dir] of Object.entries(raw as Record<string, unknown>)) {\n    if (typeof id !== \"string\" || !id || typeof dir !== \"string\" || !dir) continue;\n    const abs = path.resolve(dir);\n    if (!fs.existsSync(abs)) {\n      throw new Error(`modules-json entry missing: ${id} \u2192 ${abs}`);\n    }\n    out[id] = abs;\n  }\n  return out;\n}\n\n/**\n * \u8BFB\u53D6\u4E16\u754C enable-list(\u5355\u4E00\u6743\u5A01,\u4F9B has-pack / list-packs / \u8C03\u7528\u65B9\u590D\u7528 \u2014 DRY)\u3002\n * \u6587\u4EF6\u7F3A\u5931 \u2192 entries=[]\uFF1BJSON \u635F\u574F \u2192 entries=[] \u4E14 parseFailedFile \u6709\u503C\uFF08\u4F9B doctor \u533A\u5206\uFF09\u3002\n */\nexport type WorldPackListReadResult = {\n  entries: Array<{ pack_id: string; version: [number, number, number] }>;\n  /** \u6587\u4EF6\u5B58\u5728\u4F46\u89E3\u6790\u5931\u8D25\u65F6\u4E3A\u8BE5 JSON \u7EDD\u5BF9\u8DEF\u5F84 */\n  parseFailedFile?: string;\n};\n\nexport function readWorldPackListResult(\n  worldsDir: string,\n  levelName: string,\n  kind: \"behavior\" | \"resource\"\n): WorldPackListReadResult {\n  const file = worldPackListFile(worldsDir, levelName, kind);\n  if (!fs.existsSync(file)) return { entries: [] };\n  try {\n    const arr = JSON.parse(fs.readFileSync(file, \"utf8\")) as unknown;\n    if (!Array.isArray(arr)) return { entries: [], parseFailedFile: file };\n    const out: Array<{ pack_id: string; version: [number, number, number] }> = [];\n    for (const e of arr) {\n      if (!e || typeof e !== \"object\") continue;\n      const packId = (e as { pack_id?: unknown }).pack_id;\n      const ver = (e as { version?: unknown }).version;\n      if (typeof packId !== \"string\" || !packId) continue;\n      const version: [number, number, number] =\n        Array.isArray(ver) && ver.length >= 3\n          ? [Number(ver[0]), Number(ver[1]), Number(ver[2])]\n          : [1, 0, 0];\n      out.push({ pack_id: packId, version });\n    }\n    return { entries: out };\n  } catch {\n    return { entries: [], parseFailedFile: file };\n  }\n}\n\n/** \u517C\u5BB9\u8BFB\u4FA7\uFF1A\u53EA\u8981 entries\uFF08\u635F\u574F\u65F6\u4E0E\u7F3A\u5931\u540C\u4E3A []\uFF09\u3002\u8BE6\u7EC6\u7ED3\u679C\u89C1 readWorldPackListResult\u3002 */\nexport function readWorldPackList(\n  worldsDir: string,\n  levelName: string,\n  kind: \"behavior\" | \"resource\"\n): Array<{ pack_id: string; version: [number, number, number] }> {\n  return readWorldPackListResult(worldsDir, levelName, kind).entries;\n}\n\n/** \u4E16\u754C enable-list \u662F\u5426\u5DF2\u542B\u6307\u5B9A pack_id(\u53EA\u8BFB,\u4F9B preflight \u590D\u7528)\u3002 */\nexport function worldPackListHas(\n  worldsDir: string,\n  levelName: string,\n  kind: \"behavior\" | \"resource\",\n  packUuid: string\n): boolean {\n  return readWorldPackList(worldsDir, levelName, kind).some((e) => e.pack_id === packUuid);\n}"],
+  "mappings": "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",
   "names": []
 }

package/dist/rollback.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"rollback.d.ts","sourceRoot":"","sources":["../src/rollback.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,EAAiC,UAAU,EAAgB,MAAM,UAAU,CAAC;AAGnF,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"}

package/dist/rollback.js

@@ -2,7 +2,7 @@ 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 { copyDirSync, copyFileSyncSafe, getDirSize, emptyDirSync } from "./fsx.js";
 import { log } from "./log.js";
 function writeRollbackMarker(marker) {
   try {
@@ -41,7 +41,7 @@ function rollbackFromBackup(marker) {
         if (fs.existsSync(dest)) emptyDirSync(dest);
         copyDirSync(src, dest);
       } else {
-        fs.copyFileSync(src, dest);
+        copyFileSyncSafe(src, dest);
       }
       log.info(`[\u56DE\u6EDA] \u5DF2\u6062\u590D: ${item}`);
     } catch (e) {

package/dist/rollback.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/rollback.ts"],
-  "sourcesContent": ["/**\n * rollback.ts \u2014 \u56DE\u6EDA\u652F\u6301\n *\n * \u5728\u66F4\u65B0\u5F00\u59CB\u524D\u8BB0\u5F55: \u5F53\u524D BDS \u76EE\u5F55 + \u5907\u4EFD\u76EE\u5F55\u3002\n * \u4E3B\u6D41\u7A0B\u4EFB\u610F\u9636\u6BB5\u5931\u8D25\u65F6\uFF0C\u5C1D\u8BD5\u53CD\u5411\u6062\u590D preserves \u5230 BDS_PATH\uFF0C\n * \u7136\u540E\u4ECE\u5907\u4EFD\u91CD\u65B0\u653E\u56DE preserve \u5185\u5BB9\uFF0C\u6062\u590D\u65E7\u914D\u7F6E\u3002\n *\n * \u6301\u4E45\u5316: <SFMC_ROOT>/.sfmc/last_update_rollback.json \u7528\u4E8E\u8DE8\u8FDB\u7A0B\u8BB0\u5F55\u3002\n */\n\nimport { readJson, writeJson } from \"@sfmc-bds/sdk/node/config\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { ROLLBACK_MARKER } from \"./paths.js\";\nimport { copyDirSync, getDirSize, emptyDirSync } from \"./fsx.js\";\nimport { log } from \"./log.js\";\n\nexport interface RollbackMarker {\n  timestamp: number;\n  bds_path: string;\n  backup_dir: string;\n  preserve: string[];\n  previous_version: string;\n}\n\n/** \u5728\u5907\u4EFD\u5B8C\u6210\u540E\u8C03\u7528: \u8BB0\u5F55\u5FEB\u7167\u6307\u793A\u7B26\u3002 */\nexport function writeRollbackMarker(marker: RollbackMarker): void {\n  try {\n    writeJson(ROLLBACK_MARKER, marker);\n    log.info(`[\u56DE\u6EDA] \u5DF2\u8BB0\u5F55\u56DE\u6EDA\u6807\u8BB0 -> ${ROLLBACK_MARKER}`);\n  } catch (e) {\n    log.warn(`[\u56DE\u6EDA] \u65E0\u6CD5\u5199\u5165\u6807\u8BB0: ${(e as Error).message}`);\n  }\n}\n\nexport function clearRollbackMarker(): void {\n  try {\n    if (fs.existsSync(ROLLBACK_MARKER)) fs.unlinkSync(ROLLBACK_MARKER);\n  } catch {\n    /* ignore */\n  }\n}\n\nexport function readRollbackMarker(): RollbackMarker | null {\n  return readJson<RollbackMarker>(ROLLBACK_MARKER) ?? null;\n}\n\n/**\n * \u7D27\u6025\u56DE\u6EDA: \u628A preserve \u9879\u4ECE backup_dir \u62F7\u56DE bds_path\u3002\n * \u7528\u6CD5: \u5728 catch \u5206\u652F\u8C03\u7528\uFF0C\u5982\u679C\u4E3B\u6D41\u7A0B\u5931\u8D25\u5BFC\u81F4 BDS \u76EE\u5F55\u7834\u574F\u3002\n */\nexport function rollbackFromBackup(marker: RollbackMarker): { ok: boolean; reason?: string } {\n  const { bds_path, backup_dir, preserve } = marker;\n  if (!fs.existsSync(backup_dir)) {\n    return { ok: false, reason: `\u5907\u4EFD\u76EE\u5F55\u4E0D\u5B58\u5728: ${backup_dir}` };\n  }\n  log.warn(`[\u56DE\u6EDA] \u5F00\u59CB\u6062\u590D ${preserve.length} \u9879\u5230 ${bds_path}`);\n  for (const item of preserve) {\n    const src = path.join(backup_dir, item);\n    const dest = path.join(bds_path, item);\n    if (!fs.existsSync(src)) {\n      log.warn(`[\u56DE\u6EDA] \u8DF3\u8FC7 (\u5907\u4EFD\u4E2D\u4E0D\u5B58\u5728): ${item}`);\n      continue;\n    }\n    try {\n      // \u5148\u786E\u4FDD\u76EE\u6807\u76EE\u5F55\u5B58\u5728 (BDS \u76EE\u5F55\u53EF\u80FD\u5DF2\u88AB\u89E3\u538B\u8986\u76D6\u4E3A\u7A7A)\n      const destDir = path.dirname(dest);\n      if (!fs.existsSync(destDir)) fs.mkdirSync(destDir, { recursive: true });\n      if (fs.statSync(src).isDirectory()) {\n        // \u5148\u5220\u9664\u76EE\u6807\uFF0C\u518D\u590D\u5236\u76EE\u5F55\n        if (fs.existsSync(dest)) emptyDirSync(dest);\n        copyDirSync(src, dest);\n      } else {\n        fs.copyFileSync(src, dest);\n      }\n      log.info(`[\u56DE\u6EDA] \u5DF2\u6062\u590D: ${item}`);\n    } catch (e) {\n      log.warn(`[\u56DE\u6EDA] \u6062\u590D\u5931\u8D25 ${item}: ${(e as Error).message}`);\n    }\n  }\n  return { ok: true };\n}\n\n/** \u68C0\u67E5 BDS_PATH \u4E2D\u5173\u952E\u6587\u4EF6\u662F\u5426\u90FD\u8FD8\u5728 (\u66F4\u65B0\u540E\u5B8C\u6574\u6027 sanity check) */\nexport function verifyBdsInstall(bds_path: string, expected: string[]): { ok: boolean; missing: string[] } {\n  const missing: string[] = [];\n  for (const f of expected) {\n    if (!fs.existsSync(path.join(bds_path, f))) missing.push(f);\n  }\n  return { ok: missing.length === 0, missing };\n}\n\nexport { getDirSize };\n"],
-  "mappings": "AAUA,SAAS,UAAU,iBAAiB;AACpC,OAAO,QAAQ;AACf,OAAO,UAAU;AACjB,SAAS,uBAAuB;AAChC,SAAS,aAAa,YAAY,oBAAoB;AACtD,SAAS,WAAW;AAWb,SAAS,oBAAoB,QAA8B;AAChE,MAAI;AACF,cAAU,iBAAiB,MAAM;AACjC,QAAI,KAAK,gEAAmB,eAAe,EAAE;AAAA,EAC/C,SAAS,GAAG;AACV,QAAI,KAAK,wDAAiB,EAAY,OAAO,EAAE;AAAA,EACjD;AACF;AAEO,SAAS,sBAA4B;AAC1C,MAAI;AACF,QAAI,GAAG,WAAW,eAAe,EAAG,IAAG,WAAW,eAAe;AAAA,EACnE,QAAQ;AAAA,EAER;AACF;AAEO,SAAS,qBAA4C;AAC1D,SAAO,SAAyB,eAAe,KAAK;AACtD;AAMO,SAAS,mBAAmB,QAA0D;AAC3F,QAAM,EAAE,UAAU,YAAY,SAAS,IAAI;AAC3C,MAAI,CAAC,GAAG,WAAW,UAAU,GAAG;AAC9B,WAAO,EAAE,IAAI,OAAO,QAAQ,+CAAY,UAAU,GAAG;AAAA,EACvD;AACA,MAAI,KAAK,2CAAa,SAAS,MAAM,iBAAO,QAAQ,EAAE;AACtD,aAAW,QAAQ,UAAU;AAC3B,UAAM,MAAM,KAAK,KAAK,YAAY,IAAI;AACtC,UAAM,OAAO,KAAK,KAAK,UAAU,IAAI;AACrC,QAAI,CAAC,GAAG,WAAW,GAAG,GAAG;AACvB,UAAI,KAAK,uEAAqB,IAAI,EAAE;AACpC;AAAA,IACF;AACA,QAAI;AAEF,YAAM,UAAU,KAAK,QAAQ,IAAI;AACjC,UAAI,CAAC,GAAG,WAAW,OAAO,EAAG,IAAG,UAAU,SAAS,EAAE,WAAW,KAAK,CAAC;AACtE,UAAI,GAAG,SAAS,GAAG,EAAE,YAAY,GAAG;AAElC,YAAI,GAAG,WAAW,IAAI,EAAG,cAAa,IAAI;AAC1C,oBAAY,KAAK,IAAI;AAAA,MACvB,OAAO;AACL,WAAG,aAAa,KAAK,IAAI;AAAA,MAC3B;AACA,UAAI,KAAK,sCAAa,IAAI,EAAE;AAAA,IAC9B,SAAS,GAAG;AACV,UAAI,KAAK,2CAAa,IAAI,KAAM,EAAY,OAAO,EAAE;AAAA,IACvD;AAAA,EACF;AACA,SAAO,EAAE,IAAI,KAAK;AACpB;AAGO,SAAS,iBAAiB,UAAkB,UAAwD;AACzG,QAAM,UAAoB,CAAC;AAC3B,aAAW,KAAK,UAAU;AACxB,QAAI,CAAC,GAAG,WAAW,KAAK,KAAK,UAAU,CAAC,CAAC,EAAG,SAAQ,KAAK,CAAC;AAAA,EAC5D;AACA,SAAO,EAAE,IAAI,QAAQ,WAAW,GAAG,QAAQ;AAC7C;",
+  "sourcesContent": ["/**\n * rollback.ts \u2014 \u56DE\u6EDA\u652F\u6301\n *\n * \u5728\u66F4\u65B0\u5F00\u59CB\u524D\u8BB0\u5F55: \u5F53\u524D BDS \u76EE\u5F55 + \u5907\u4EFD\u76EE\u5F55\u3002\n * \u4E3B\u6D41\u7A0B\u4EFB\u610F\u9636\u6BB5\u5931\u8D25\u65F6\uFF0C\u5C1D\u8BD5\u53CD\u5411\u6062\u590D preserves \u5230 BDS_PATH\uFF0C\n * \u7136\u540E\u4ECE\u5907\u4EFD\u91CD\u65B0\u653E\u56DE preserve \u5185\u5BB9\uFF0C\u6062\u590D\u65E7\u914D\u7F6E\u3002\n *\n * \u6301\u4E45\u5316: <SFMC_ROOT>/.sfmc/last_update_rollback.json \u7528\u4E8E\u8DE8\u8FDB\u7A0B\u8BB0\u5F55\u3002\n */\n\nimport { readJson, writeJson } from \"@sfmc-bds/sdk/node/config\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { ROLLBACK_MARKER } from \"./paths.js\";\nimport { copyDirSync, copyFileSyncSafe, getDirSize, emptyDirSync } from \"./fsx.js\";\nimport { log } from \"./log.js\";\n\nexport interface RollbackMarker {\n  timestamp: number;\n  bds_path: string;\n  backup_dir: string;\n  preserve: string[];\n  previous_version: string;\n}\n\n/** \u5728\u5907\u4EFD\u5B8C\u6210\u540E\u8C03\u7528: \u8BB0\u5F55\u5FEB\u7167\u6307\u793A\u7B26\u3002 */\nexport function writeRollbackMarker(marker: RollbackMarker): void {\n  try {\n    writeJson(ROLLBACK_MARKER, marker);\n    log.info(`[\u56DE\u6EDA] \u5DF2\u8BB0\u5F55\u56DE\u6EDA\u6807\u8BB0 -> ${ROLLBACK_MARKER}`);\n  } catch (e) {\n    log.warn(`[\u56DE\u6EDA] \u65E0\u6CD5\u5199\u5165\u6807\u8BB0: ${(e as Error).message}`);\n  }\n}\n\nexport function clearRollbackMarker(): void {\n  try {\n    if (fs.existsSync(ROLLBACK_MARKER)) fs.unlinkSync(ROLLBACK_MARKER);\n  } catch {\n    /* ignore */\n  }\n}\n\nexport function readRollbackMarker(): RollbackMarker | null {\n  return readJson<RollbackMarker>(ROLLBACK_MARKER) ?? null;\n}\n\n/**\n * \u7D27\u6025\u56DE\u6EDA: \u628A preserve \u9879\u4ECE backup_dir \u62F7\u56DE bds_path\u3002\n * \u7528\u6CD5: \u5728 catch \u5206\u652F\u8C03\u7528\uFF0C\u5982\u679C\u4E3B\u6D41\u7A0B\u5931\u8D25\u5BFC\u81F4 BDS \u76EE\u5F55\u7834\u574F\u3002\n */\nexport function rollbackFromBackup(marker: RollbackMarker): { ok: boolean; reason?: string } {\n  const { bds_path, backup_dir, preserve } = marker;\n  if (!fs.existsSync(backup_dir)) {\n    return { ok: false, reason: `\u5907\u4EFD\u76EE\u5F55\u4E0D\u5B58\u5728: ${backup_dir}` };\n  }\n  log.warn(`[\u56DE\u6EDA] \u5F00\u59CB\u6062\u590D ${preserve.length} \u9879\u5230 ${bds_path}`);\n  for (const item of preserve) {\n    const src = path.join(backup_dir, item);\n    const dest = path.join(bds_path, item);\n    if (!fs.existsSync(src)) {\n      log.warn(`[\u56DE\u6EDA] \u8DF3\u8FC7 (\u5907\u4EFD\u4E2D\u4E0D\u5B58\u5728): ${item}`);\n      continue;\n    }\n    try {\n      // \u5148\u786E\u4FDD\u76EE\u6807\u76EE\u5F55\u5B58\u5728 (BDS \u76EE\u5F55\u53EF\u80FD\u5DF2\u88AB\u89E3\u538B\u8986\u76D6\u4E3A\u7A7A)\n      const destDir = path.dirname(dest);\n      if (!fs.existsSync(destDir)) fs.mkdirSync(destDir, { recursive: true });\n      if (fs.statSync(src).isDirectory()) {\n        // \u5148\u5220\u9664\u76EE\u6807\uFF0C\u518D\u590D\u5236\u76EE\u5F55\n        if (fs.existsSync(dest)) emptyDirSync(dest);\n        copyDirSync(src, dest);\n      } else {\n        copyFileSyncSafe(src, dest);\n      }\n      log.info(`[\u56DE\u6EDA] \u5DF2\u6062\u590D: ${item}`);\n    } catch (e) {\n      log.warn(`[\u56DE\u6EDA] \u6062\u590D\u5931\u8D25 ${item}: ${(e as Error).message}`);\n    }\n  }\n  return { ok: true };\n}\n\n/** \u68C0\u67E5 BDS_PATH \u4E2D\u5173\u952E\u6587\u4EF6\u662F\u5426\u90FD\u8FD8\u5728 (\u66F4\u65B0\u540E\u5B8C\u6574\u6027 sanity check) */\nexport function verifyBdsInstall(bds_path: string, expected: string[]): { ok: boolean; missing: string[] } {\n  const missing: string[] = [];\n  for (const f of expected) {\n    if (!fs.existsSync(path.join(bds_path, f))) missing.push(f);\n  }\n  return { ok: missing.length === 0, missing };\n}\n\nexport { getDirSize };\n"],
+  "mappings": "AAUA,SAAS,UAAU,iBAAiB;AACpC,OAAO,QAAQ;AACf,OAAO,UAAU;AACjB,SAAS,uBAAuB;AAChC,SAAS,aAAa,kBAAkB,YAAY,oBAAoB;AACxE,SAAS,WAAW;AAWb,SAAS,oBAAoB,QAA8B;AAChE,MAAI;AACF,cAAU,iBAAiB,MAAM;AACjC,QAAI,KAAK,gEAAmB,eAAe,EAAE;AAAA,EAC/C,SAAS,GAAG;AACV,QAAI,KAAK,wDAAiB,EAAY,OAAO,EAAE;AAAA,EACjD;AACF;AAEO,SAAS,sBAA4B;AAC1C,MAAI;AACF,QAAI,GAAG,WAAW,eAAe,EAAG,IAAG,WAAW,eAAe;AAAA,EACnE,QAAQ;AAAA,EAER;AACF;AAEO,SAAS,qBAA4C;AAC1D,SAAO,SAAyB,eAAe,KAAK;AACtD;AAMO,SAAS,mBAAmB,QAA0D;AAC3F,QAAM,EAAE,UAAU,YAAY,SAAS,IAAI;AAC3C,MAAI,CAAC,GAAG,WAAW,UAAU,GAAG;AAC9B,WAAO,EAAE,IAAI,OAAO,QAAQ,+CAAY,UAAU,GAAG;AAAA,EACvD;AACA,MAAI,KAAK,2CAAa,SAAS,MAAM,iBAAO,QAAQ,EAAE;AACtD,aAAW,QAAQ,UAAU;AAC3B,UAAM,MAAM,KAAK,KAAK,YAAY,IAAI;AACtC,UAAM,OAAO,KAAK,KAAK,UAAU,IAAI;AACrC,QAAI,CAAC,GAAG,WAAW,GAAG,GAAG;AACvB,UAAI,KAAK,uEAAqB,IAAI,EAAE;AACpC;AAAA,IACF;AACA,QAAI;AAEF,YAAM,UAAU,KAAK,QAAQ,IAAI;AACjC,UAAI,CAAC,GAAG,WAAW,OAAO,EAAG,IAAG,UAAU,SAAS,EAAE,WAAW,KAAK,CAAC;AACtE,UAAI,GAAG,SAAS,GAAG,EAAE,YAAY,GAAG;AAElC,YAAI,GAAG,WAAW,IAAI,EAAG,cAAa,IAAI;AAC1C,oBAAY,KAAK,IAAI;AAAA,MACvB,OAAO;AACL,yBAAiB,KAAK,IAAI;AAAA,MAC5B;AACA,UAAI,KAAK,sCAAa,IAAI,EAAE;AAAA,IAC9B,SAAS,GAAG;AACV,UAAI,KAAK,2CAAa,IAAI,KAAM,EAAY,OAAO,EAAE;AAAA,IACvD;AAAA,EACF;AACA,SAAO,EAAE,IAAI,KAAK;AACpB;AAGO,SAAS,iBAAiB,UAAkB,UAAwD;AACzG,QAAM,UAAoB,CAAC;AAC3B,aAAW,KAAK,UAAU;AACxB,QAAI,CAAC,GAAG,WAAW,KAAK,KAAK,UAAU,CAAC,CAAC,EAAG,SAAQ,KAAK,CAAC;AAAA,EAC5D;AACA,SAAO,EAAE,IAAI,QAAQ,WAAW,GAAG,QAAQ;AAC7C;",
   "names": []
 }

package/dist/server-properties-i18n.d.ts

@@ -0,0 +1,17 @@
+/**
+ * server-properties-i18n.ts — BDS server.properties 多语言注释字典
+ */
+export interface ServerPropertyDoc {
+    /** 中文功能概述 */
+    desc: string;
+    /** 合法取值与枚举说明 */
+    values?: string;
+    /** 避坑、性能或安全性提示 */
+    tip?: string;
+}
+export declare const SERVER_PROPERTIES_DOCS_ZH_CN: Record<string, ServerPropertyDoc>;
+/**
+ * 根据属性 key 和目标语言获取说明文档
+ */
+export declare function getServerPropertyDoc(key: string, locale?: string): ServerPropertyDoc | undefined;
+//# sourceMappingURL=server-properties-i18n.d.ts.map

package/dist/server-properties-i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-properties-i18n.d.ts","sourceRoot":"","sources":["../src/server-properties-i18n.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,iBAAiB;IAChC,aAAa;IACb,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAuL1E,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAgB,GAAG,iBAAiB,GAAG,SAAS,CAQzG"}