@sfmc-bds/cli 0.3.1 → 0.4.0

package/dist/management/config.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/management/config.ts"],
+  "sourcesContent": ["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { createHash, randomUUID } from \"node:crypto\";\nimport Ajv2020 from \"ajv/dist/2020.js\";\nimport { parse, type ParseError } from \"jsonc-parser\";\nimport type { ConfigDocument } from \"@sfmc-bds/management\";\nimport { resolveSdkPackageRoot, ROOT } from \"../runtime.js\";\nimport { resolveBdsContext } from \"../pack-lifecycle.js\";\nimport { readJson, stripBom } from \"./domain.js\";\n\n/** \u78C1\u76D8\u4E0A\u7684\u771F\u5B9E\u6587\u4EF6\u540D\u3002schema \u6587\u4EF6\u4ECD\u7528\u4E0B\u5212\u7EBF\uFF08log_filter.schema.json\uFF09\u3002 */\nconst CORE_FILES = [\"runtime.json\", \"db_config.json\", \"qq_config.json\", \"bds_updater.json\", \"permissions.json\", \"log-filter.json\", \"module-update.json\", \"pack-update.json\"];\nconst SCHEMA_STEM: Record<string, string> = {\n  \"log-filter.json\": \"log_filter\",\n  \"module-update.json\": \"module_update\",\n  \"pack-update.json\": \"pack_update\",\n};\nconst ajv = new Ajv2020.default({ allErrors: true, strict: false });\nconst validators = new Map<string, ReturnType<typeof ajv.compile>>();\nexport function configFiles(): Map<string, string> {\n  const files = new Map(CORE_FILES.map(name => [`core/${name}`, path.join(ROOT, \"configs\", name)]));\n  files.set(\"bds/server.properties\", path.join(resolveBdsContext().bdsRoot, \"server.properties\"));\n  const modules = path.join(ROOT, \"modules\", \"packages\");\n  if (fs.existsSync(modules)) for (const entry of fs.readdirSync(modules, { withFileTypes: true })) {\n    if (!entry.isDirectory() && !entry.isSymbolicLink()) continue;\n    const configDir = path.join(modules, entry.name, \"configs\");\n    if (!fs.existsSync(configDir)) continue;\n    for (const filename of fs.readdirSync(configDir)) if (/^[\\w.-]+\\.jsonc?$/.test(filename)) files.set(`module/${entry.name}/${filename}`, path.join(configDir, filename));\n  }\n  // \u771F\u5B9E\u5B9E\u4F8B\u7684\u6A21\u5757\u914D\u7F6E\u5199\u5728 <SFMC_ROOT>/configs/<configKey>.json\uFF0C\u76EE\u5F55\u540D\u6765\u81EA catalog.configKey\u3002\n  const catalog = readJson<{ modules?: { id?: string; configKey?: string }[] }>(path.join(ROOT, \"modules\", \"catalog.json\"), {});\n  const taken = new Set([...files.values()].map(file => path.resolve(file)));\n  for (const row of catalog.modules ?? []) {\n    if (!row.id || !row.configKey || !/^[\\w.-]+$/.test(row.id) || !/^[\\w.-]+$/.test(row.configKey)) continue;\n    const filename = `${row.configKey}.json`;\n    const file = path.join(ROOT, \"configs\", filename);\n    if (!fs.existsSync(file) || taken.has(path.resolve(file))) continue;\n    files.set(`module/${row.id}/${filename}`, file);\n    taken.add(path.resolve(file));\n  }\n  return files;\n}\nexport function configPath(key: string): string {\n  const file = configFiles().get(key);\n  if (!file) throw Object.assign(new Error(\"\u914D\u7F6E\u4E0D\u5728\u5141\u8BB8\u7F16\u8F91\u7684\u5217\u8868\u4E2D\"), { code: \"validation\" });\n  if (fs.existsSync(file) && fs.lstatSync(file).isSymbolicLink()) throw new Error(\"\u4E0D\u80FD\u901A\u8FC7\u914D\u7F6E\u6587\u4EF6\u94FE\u63A5\u5199\u5165\u5176\u4ED6\u6587\u4EF6\");\n  return file;\n}\nexport function revision(text: string) { return createHash(\"sha256\").update(text).digest(\"hex\"); }\nexport function readDocument(key: string): ConfigDocument {\n  const file = configPath(key);\n  const text = fs.existsSync(file) ? stripBom(fs.readFileSync(file, \"utf8\")) : \"\";\n  let schema: object | undefined;\n  if (key.startsWith(\"core/\")) {\n    const name = SCHEMA_STEM[path.basename(file)] ?? path.basename(file, \".json\");\n    const schemaFile = path.join(resolveSdkPackageRoot(), \"schemas\", `${name}.schema.json`);\n    if (fs.existsSync(schemaFile)) schema = JSON.parse(fs.readFileSync(schemaFile, \"utf8\")) as object;\n  } else if (key.startsWith(\"module/\")) {\n    const schemaFile = path.join(path.dirname(file), `${path.basename(file).replace(/\\.jsonc?$/, \"\")}.schema.json`);\n    if (fs.existsSync(schemaFile)) schema = JSON.parse(fs.readFileSync(schemaFile, \"utf8\")) as object;\n  }\n  return { key, text, revision: revision(text), ...(schema ? { schema } : {}), format: file.endsWith(\".properties\") ? \"properties\" : file.endsWith(\".jsonc\") ? \"jsonc\" : \"json\", affectedServices: [\"db\", \"tunnel\", \"qq\", \"llbot\", \"bds\"] };\n}\nexport function validateDocument(document: ConfigDocument, text: string) {\n  if (Buffer.byteLength(text) > 2 * 1024 * 1024) throw new Error(\"\u914D\u7F6E\u6587\u4EF6\u8FC7\u5927\");\n  if (document.format === \"properties\") {\n    for (const line of text.split(/\\r?\\n/)) if (line.trim() && !line.trim().startsWith(\"#\") && !/^[^=\\r\\n]+=.*$/.test(line)) throw new Error(\"server.properties \u5305\u542B\u975E\u6CD5\u914D\u7F6E\u884C\");\n    return;\n  }\n  const errors: ParseError[] = [];\n  const value: unknown = parse(text, errors, { allowTrailingComma: document.format === \"jsonc\", disallowComments: document.format === \"json\" });\n  if (errors.length) throw Object.assign(new Error(\"\u914D\u7F6E\u8BED\u6CD5\u9519\u8BEF\"), { code: \"validation\", details: errors });\n  if (document.schema) {\n    // \u4FDD\u7559\u5DF2\u6709\u672A\u77E5\u5B57\u6BB5\uFF1B\u53EA\u4ECE\u6821\u9A8C\u526F\u672C\u6392\u9664\u672A\u4FEE\u6539\u7684\u672A\u77E5\u5B57\u6BB5\uFF0C\u4FDD\u5B58\u7684\u539F\u6587\u4ECD\u5B8C\u5168\u4FDD\u7559\u3002\n    const schemaObject = document.schema as { additionalProperties?: boolean; properties?: Record<string, unknown> };\n    if (schemaObject.additionalProperties === false && value && typeof value === \"object\" && !Array.isArray(value)) {\n      const previous = parse(document.text || \"{}\") as Record<string, unknown>;\n      for (const key of Object.keys(value)) if (!(key in (schemaObject.properties ?? {})) && previous && key in previous && JSON.stringify(previous[key]) === JSON.stringify((value as Record<string, unknown>)[key])) delete (value as Record<string, unknown>)[key];\n    }\n    const hash = revision(JSON.stringify(document.schema));\n    let validator = validators.get(hash);\n    if (!validator) { const schema = { ...document.schema } as Record<string, unknown>; delete schema.$id; validator = ajv.compile(schema); validators.set(hash, validator); }\n    if (!validator(value)) throw Object.assign(new Error(\"\u914D\u7F6E\u4E0D\u7B26\u5408 Schema\"), { code: \"validation\", details: validator.errors });\n  }\n}\nexport function saveDocument(key: string, expected: string, text: string) {\n  const document = readDocument(key);\n  if (document.revision !== expected) throw Object.assign(new Error(\"\u914D\u7F6E\u5DF2\u88AB\u5176\u4ED6\u64CD\u4F5C\u4FEE\u6539\uFF0C\u8BF7\u91CD\u65B0\u8BFB\u53D6\"), { code: \"conflict\" });\n  validateDocument(document, text);\n  const file = configPath(key); const temp = `${file}.${randomUUID()}.tmp`;\n  fs.mkdirSync(path.dirname(file), { recursive: true });\n  fs.writeFileSync(temp, text, { mode: 0o600 }); fs.renameSync(temp, file);\n  return document;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/management/deployment.d.ts

@@ -0,0 +1,7 @@
+export declare function deploymentPort(value: unknown, fallback: number): number;
+export declare function deploymentPreflight(ports: {
+    db: number;
+    bds: number;
+    bds6: number;
+}): Promise<void>;
+//# sourceMappingURL=deployment.d.ts.map

package/dist/management/deployment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment.d.ts","sourceRoot":"","sources":["../../src/management/deployment.ts"],"names":[],"mappings":"AAKA,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,UAI9D;AACD,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,iBAgBzF"}

package/dist/management/deployment.js

@@ -0,0 +1,36 @@
+import fs from "node:fs";
+import path from "node:path";
+import net from "node:net";
+import dgram from "node:dgram";
+import { ROOT } from "../runtime.js";
+function deploymentPort(value, fallback) {
+  const port = value === void 0 ? fallback : Number(value);
+  if (!Number.isInteger(port) || port < 1 || port > 65535) throw new Error("\u7AEF\u53E3\u5FC5\u987B\u4E3A 1 \u5230 65535 \u7684\u6574\u6570");
+  return port;
+}
+async function deploymentPreflight(ports) {
+  if (path.resolve(ROOT) === path.parse(ROOT).root) throw new Error("\u4E0D\u80FD\u5728\u78C1\u76D8\u6839\u76EE\u5F55\u521B\u5EFA\u90E8\u7F72");
+  for (const file of ["BDS/bedrock_server.exe", "BDS/bedrock_server", "data/sfmc_data.db"]) if (fs.existsSync(path.join(ROOT, file))) throw new Error("\u5DF2\u6709 BDS \u6216\u6570\u636E\u5E93\uFF0C\u8BF7\u63A5\u5165\u73B0\u6709\u90E8\u7F72\uFF0C\u4E0D\u8986\u76D6\u6570\u636E");
+  const space = fs.statfsSync(ROOT);
+  if (space.bavail * space.bsize < 1024 ** 3) throw new Error("\u53EF\u7528\u7A7A\u95F4\u4E0D\u8DB3 1 GiB\uFF0C\u65E0\u6CD5\u51C6\u5907\u8FD0\u884C\u65F6\u3001BDS \u548C\u7EF4\u62A4\u5907\u4EFD");
+  await new Promise((resolve, reject) => {
+    const server = net.createServer();
+    server.once("error", (error) => reject(new Error(`DB \u7AEF\u53E3 ${ports.db} \u4E0D\u53EF\u7528: ${error.message}`)));
+    server.listen(ports.db, "0.0.0.0", () => server.close((error) => error ? reject(error) : resolve()));
+  });
+  for (const [port, type, address] of [[ports.bds, "udp4", "0.0.0.0"], [ports.bds6, "udp6", "::"]]) {
+    await new Promise((resolve, reject) => {
+      const socket = dgram.createSocket(type);
+      socket.once("error", (error) => {
+        socket.close();
+        reject(new Error(`BDS \u7AEF\u53E3 ${port} \u4E0D\u53EF\u7528: ${error.message}`));
+      });
+      socket.bind(port, address, () => socket.close(() => resolve()));
+    });
+  }
+}
+export {
+  deploymentPort,
+  deploymentPreflight
+};
+//# sourceMappingURL=deployment.js.map

package/dist/management/deployment.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/management/deployment.ts"],
+  "sourcesContent": ["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport net from \"node:net\";\nimport dgram from \"node:dgram\";\nimport { ROOT } from \"../runtime.js\";\nexport function deploymentPort(value: unknown, fallback: number) {\n  const port = value === undefined ? fallback : Number(value);\n  if (!Number.isInteger(port) || port < 1 || port > 65535) throw new Error(\"\u7AEF\u53E3\u5FC5\u987B\u4E3A 1 \u5230 65535 \u7684\u6574\u6570\");\n  return port;\n}\nexport async function deploymentPreflight(ports: { db: number; bds: number; bds6: number }) {\n  if (path.resolve(ROOT) === path.parse(ROOT).root) throw new Error(\"\u4E0D\u80FD\u5728\u78C1\u76D8\u6839\u76EE\u5F55\u521B\u5EFA\u90E8\u7F72\");\n  for (const file of [\"BDS/bedrock_server.exe\", \"BDS/bedrock_server\", \"data/sfmc_data.db\"]) if (fs.existsSync(path.join(ROOT, file))) throw new Error(\"\u5DF2\u6709 BDS \u6216\u6570\u636E\u5E93\uFF0C\u8BF7\u63A5\u5165\u73B0\u6709\u90E8\u7F72\uFF0C\u4E0D\u8986\u76D6\u6570\u636E\");\n  const space = fs.statfsSync(ROOT);\n  if (space.bavail * space.bsize < 1024 ** 3) throw new Error(\"\u53EF\u7528\u7A7A\u95F4\u4E0D\u8DB3 1 GiB\uFF0C\u65E0\u6CD5\u51C6\u5907\u8FD0\u884C\u65F6\u3001BDS \u548C\u7EF4\u62A4\u5907\u4EFD\");\n  await new Promise<void>((resolve, reject) => {\n    const server = net.createServer(); server.once(\"error\", error => reject(new Error(`DB \u7AEF\u53E3 ${ports.db} \u4E0D\u53EF\u7528: ${error.message}`)));\n    server.listen(ports.db, \"0.0.0.0\", () => server.close(error => error ? reject(error) : resolve()));\n  });\n  for (const [port, type, address] of [[ports.bds, \"udp4\", \"0.0.0.0\"], [ports.bds6, \"udp6\", \"::\"]] as const) {\n    await new Promise<void>((resolve, reject) => {\n      const socket = dgram.createSocket(type);\n      socket.once(\"error\", error => { socket.close(); reject(new Error(`BDS \u7AEF\u53E3 ${port} \u4E0D\u53EF\u7528: ${error.message}`)); });\n      socket.bind(port, address, () => socket.close(() => resolve()));\n    });\n  }\n}\n"],
+  "mappings": "AAAA,OAAO,QAAQ;AACf,OAAO,UAAU;AACjB,OAAO,SAAS;AAChB,OAAO,WAAW;AAClB,SAAS,YAAY;AACd,SAAS,eAAe,OAAgB,UAAkB;AAC/D,QAAM,OAAO,UAAU,SAAY,WAAW,OAAO,KAAK;AAC1D,MAAI,CAAC,OAAO,UAAU,IAAI,KAAK,OAAO,KAAK,OAAO,MAAO,OAAM,IAAI,MAAM,kEAAqB;AAC9F,SAAO;AACT;AACA,eAAsB,oBAAoB,OAAkD;AAC1F,MAAI,KAAK,QAAQ,IAAI,MAAM,KAAK,MAAM,IAAI,EAAE,KAAM,OAAM,IAAI,MAAM,0EAAc;AAChF,aAAW,QAAQ,CAAC,0BAA0B,sBAAsB,mBAAmB,EAAG,KAAI,GAAG,WAAW,KAAK,KAAK,MAAM,IAAI,CAAC,EAAG,OAAM,IAAI,MAAM,+HAA2B;AAC/K,QAAM,QAAQ,GAAG,WAAW,IAAI;AAChC,MAAI,MAAM,SAAS,MAAM,QAAQ,QAAQ,EAAG,OAAM,IAAI,MAAM,oIAAgC;AAC5F,QAAM,IAAI,QAAc,CAAC,SAAS,WAAW;AAC3C,UAAM,SAAS,IAAI,aAAa;AAAG,WAAO,KAAK,SAAS,WAAS,OAAO,IAAI,MAAM,mBAAS,MAAM,EAAE,wBAAS,MAAM,OAAO,EAAE,CAAC,CAAC;AAC7H,WAAO,OAAO,MAAM,IAAI,WAAW,MAAM,OAAO,MAAM,WAAS,QAAQ,OAAO,KAAK,IAAI,QAAQ,CAAC,CAAC;AAAA,EACnG,CAAC;AACD,aAAW,CAAC,MAAM,MAAM,OAAO,KAAK,CAAC,CAAC,MAAM,KAAK,QAAQ,SAAS,GAAG,CAAC,MAAM,MAAM,QAAQ,IAAI,CAAC,GAAY;AACzG,UAAM,IAAI,QAAc,CAAC,SAAS,WAAW;AAC3C,YAAM,SAAS,MAAM,aAAa,IAAI;AACtC,aAAO,KAAK,SAAS,WAAS;AAAE,eAAO,MAAM;AAAG,eAAO,IAAI,MAAM,oBAAU,IAAI,wBAAS,MAAM,OAAO,EAAE,CAAC;AAAA,MAAG,CAAC;AAC5G,aAAO,KAAK,MAAM,SAAS,MAAM,OAAO,MAAM,MAAM,QAAQ,CAAC,CAAC;AAAA,IAChE,CAAC;AAAA,EACH;AACF;",
+  "names": []
+}

package/dist/management/domain.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 去掉 UTF-8 BOM。
+ * 使用场景：编辑器或 BDS 写出的 JSON（例如 configs/permissions.json）常带 BOM，直接 JSON.parse 会失败。
+ */
+export declare function stripBom(text: string): string;
+export declare function readJson<T>(file: string, fallback: T): T;
+export declare function identifier(value: unknown): string;
+export declare function listModules(): Promise<{
+    modules: {
+        id: string;
+        folder: string;
+        name: string;
+        version: string;
+        enabled: boolean;
+        linked: boolean;
+    }[];
+}>;
+export declare function searchModules(query: string): Promise<{
+    modules: {
+        npm?: string;
+        version?: string;
+        sdk?: string;
+        repo?: string;
+        tag?: string;
+        id: string;
+    }[];
+    stale: boolean;
+}>;
+export declare function runFetch(args: string[]): Promise<{
+    changed: boolean;
+}>;
+export declare function runProcess(command: string, args: string[], cwd: string, onLine?: (text: string) => void): Promise<void>;
+export declare function modulePlan(ids?: string[]): Promise<unknown>;
+export declare function applyModulePlan(ids: string[]): Promise<{
+    failed: {
+        id: string;
+        message: string;
+    }[];
+}>;
+export declare function listPacks(): {
+    packs: {
+        id: string;
+        name: string;
+        kind: import("@sfmc-bds/bds-tools/world-packs").WorldPackKind;
+        enabled: boolean;
+        version: string;
+    }[];
+};
+export declare function togglePack(id: string, enabled: boolean): Promise<{
+    changed: boolean;
+    restartRequired: boolean;
+}>;
+export declare function importPack(filename: string): Promise<{
+    changed: boolean;
+    restartRequired: boolean;
+}>;
+export declare function playerFiles(): {
+    allowlist: string;
+    permissions: string;
+    sfmcPermissions: string;
+};
+export declare function savePlayerPermissions(kind: string, entries: unknown): {
+    saved: boolean;
+};
+//# sourceMappingURL=domain.d.ts.map

package/dist/management/domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../src/management/domain.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AACD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAGxD;AACD,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGjD;AACD,wBAAsB,WAAW;;;;;;;;;GAMhC;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM;;;;;;;;;;GAGhD;AACD,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE;;GAG5C;AACD,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAOvH;AACD,wBAAsB,UAAU,CAAC,GAAG,GAAE,MAAM,EAAO,oBAIlD;AACD,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE;YAI+B;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE;GAQlH;AACD,wBAAgB,SAAS;IAEd,KAAK;;;;;;;EACf;AACD,wBAAsB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;;;GAO5D;AACD,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM;;;GAiBhD;AACD,wBAAgB,WAAW;IAEhB,SAAS;IAAoC,WAAW;IAAsC,eAAe;EACvH;AACD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAWzD,KAAK;EACf"}

package/dist/management/domain.js

@@ -0,0 +1,137 @@
+import fs from "node:fs";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { spawn } from "node:child_process";
+import { resolveRegistryIndex } from "../registry.js";
+import { ROOT, resolveFetchModule } from "../runtime.js";
+import { resolveBdsContext, scanLocalModules } from "../pack-lifecycle.js";
+import { listInstalledWorldPacks, resolvePackRoots, readPackManifestInfo, installPackDirectory, enableInstalledPack, disableInstalledPack, worldPackParentDir } from "@sfmc-bds/bds-tools/world-packs";
+import { atomicJson } from "./tasks.js";
+import { isRetiredPlatformModule } from "@sfmc-bds/sdk/contracts";
+function stripBom(text) {
+  return text.charCodeAt(0) === 65279 ? text.slice(1) : text;
+}
+function readJson(file, fallback) {
+  try {
+    return JSON.parse(stripBom(fs.readFileSync(file, "utf8")));
+  } catch (error) {
+    if (error.code === "ENOENT") return fallback;
+    throw error;
+  }
+}
+function identifier(value) {
+  if (typeof value !== "string" || !/^[a-zA-Z0-9][a-zA-Z0-9_.-]{0,127}$/.test(value) || value.includes("..")) throw new Error("\u975E\u6CD5\u6807\u8BC6\u7B26");
+  return value;
+}
+async function listModules() {
+  const rows = (await scanLocalModules()).filter((row) => !isRetiredPlatformModule(row.logicalId));
+  const catalog = readJson(path.join(ROOT, "modules", "catalog.json"), {});
+  const titles = new Map((catalog.modules ?? []).filter((row) => row.id && row.name).map((row) => [row.id, row.name]));
+  return { modules: rows.map((row) => ({ id: row.logicalId, folder: row.folderId, name: titles.get(row.logicalId) || row.logicalId, version: row.version ?? "unknown", enabled: row.enabled, linked: fs.lstatSync(path.join(ROOT, "modules", "packages", row.folderId)).isSymbolicLink() })) };
+}
+function fetchEntry() {
+  const entry = resolveFetchModule();
+  if (!entry) throw new Error("\u627E\u4E0D\u5230\u6A21\u5757\u5B89\u88C5\u5668");
+  return entry;
+}
+async function searchModules(query) {
+  const result = await resolveRegistryIndex();
+  return { modules: Object.entries(result.index).filter(([id]) => !isRetiredPlatformModule(id) && id.includes(query)).map(([id, metadata]) => ({ id, ...metadata })), stale: result.stale };
+}
+async function runFetch(args) {
+  await runProcess(process.execPath, [fetchEntry(), ...args], ROOT);
+  return { changed: true };
+}
+function runProcess(command, args, cwd, onLine) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(command, args, { cwd, env: { ...process.env, SFMC_ROOT: ROOT, FORCE_COLOR: "0" }, windowsHide: true, stdio: ["ignore", "pipe", "pipe"] });
+    let diagnostic = "";
+    for (const stream of [child.stdout, child.stderr]) stream.on("data", (chunk) => {
+      const text = chunk.toString();
+      diagnostic = (diagnostic + text).slice(-6e3);
+      onLine?.(text);
+    });
+    child.on("error", reject);
+    child.on("close", (code) => code === 0 ? resolve() : reject(new Error(`\u5B50\u8FDB\u7A0B\u5931\u8D25 (${code}): ${diagnostic}`)));
+  });
+}
+async function modulePlan(ids = []) {
+  const url = pathToFileURL(path.join(path.dirname(fetchEntry()), "lib", "module-update.mjs")).href;
+  const api = await import(url);
+  return api.planModuleUpdates({ root: ROOT, ids });
+}
+async function applyModulePlan(ids) {
+  const directory = path.dirname(fetchEntry());
+  const api = await import(pathToFileURL(path.join(directory, "lib", "module-update.mjs")).href);
+  const fetchApi = await import(pathToFileURL(fetchEntry()).href);
+  const plan = await api.planModuleUpdates({ root: ROOT, ids });
+  const result = await api.applyModuleUpgrades(plan.upgrades, { root: ROOT, failMode: plan.failMode, install: fetchApi.installPreservingLock, resync: api.resyncInstalledCatalog });
+  if (result.failed.length) throw new Error(JSON.stringify(result.failed));
+  return result;
+}
+function listPacks() {
+  const context = resolveBdsContext();
+  return { packs: listInstalledWorldPacks(context.bdsRoot, context.levelName).map((pack) => ({ id: pack.uuid, name: pack.name, kind: pack.kind, enabled: pack.enabled, version: pack.version.join(".") })) };
+}
+async function togglePack(id, enabled) {
+  const context = resolveBdsContext();
+  const pack = listInstalledWorldPacks(context.bdsRoot, context.levelName).find((row) => row.uuid === id);
+  if (!pack) throw new Error("\u627E\u4E0D\u5230\u4E16\u754C\u5305");
+  if (enabled) await enableInstalledPack({ ...context, info: { uuid: pack.uuid, version: pack.version, kind: pack.kind, name: pack.name } });
+  else await disableInstalledPack({ ...context, kind: pack.kind, packUuid: pack.uuid, version: pack.version });
+  return { changed: true, restartRequired: true };
+}
+async function importPack(filename) {
+  const inbox = path.resolve(ROOT, "packs", "_desktop-inbox");
+  const file = path.resolve(inbox, identifier(filename));
+  if (!file.startsWith(inbox + path.sep) || !fs.existsSync(file)) throw new Error("\u4E16\u754C\u5305\u5C1A\u672A\u4E0A\u4F20\u5230\u5B9E\u4F8B\u6536\u4EF6\u7BB1");
+  const context = resolveBdsContext();
+  const resolved = await resolvePackRoots(file);
+  try {
+    if (!resolved.roots.length) throw new Error("\u5F52\u6863\u4E0D\u542B\u53EF\u8BC6\u522B\u7684\u4E16\u754C\u5305");
+    for (const root of resolved.roots) {
+      const info = readPackManifestInfo(root);
+      if (!info) throw new Error("\u4E16\u754C\u5305 manifest \u65E0\u6548");
+      const result = await installPackDirectory({ srcDir: root, destParent: worldPackParentDir(context.bdsRoot, context.levelName, info.kind) });
+      if (!result.ok) throw new Error(result.reason ?? "\u5B89\u88C5\u5931\u8D25\uFF1B\u53EF\u80FD\u4E0E\u5DF2\u6709\u5305\u51B2\u7A81");
+      await enableInstalledPack({ ...context, info });
+    }
+  } finally {
+    resolved.dispose?.();
+  }
+  return { changed: true, restartRequired: true };
+}
+function playerFiles() {
+  const bds = resolveBdsContext().bdsRoot;
+  return { allowlist: path.join(bds, "allowlist.json"), permissions: path.join(bds, "permissions.json"), sfmcPermissions: path.join(ROOT, "configs", "permissions.json") };
+}
+function savePlayerPermissions(kind, entries) {
+  const files = playerFiles();
+  if (!(kind in files) || !Array.isArray(entries)) throw new Error("\u975E\u6CD5\u73A9\u5BB6\u6743\u9650\u7C7B\u578B\u6216\u5185\u5BB9");
+  for (const entry of entries) {
+    if (!entry || typeof entry !== "object") throw new Error("\u6743\u9650\u6761\u76EE\u5FC5\u987B\u4E3A\u5BF9\u8C61");
+    const row = entry;
+    if (kind === "allowlist" && (typeof row.name !== "string" || /[\r\n]/.test(row.name))) throw new Error("\u5141\u8BB8\u540D\u5355\u9700\u63D0\u4F9B\u5408\u6CD5\u73A9\u5BB6\u540D\u79F0");
+    if (kind === "permissions" && (typeof row.xuid !== "string" || !/^\d+$/.test(row.xuid) || !["visitor", "member", "operator"].includes(String(row.permission)))) throw new Error("BDS \u6743\u9650\u9700\u6709\u6548 XUID \u548C\u6743\u9650\u7B49\u7EA7");
+    if (kind === "sfmcPermissions" && (typeof row.player_name !== "string" || !row.player_name.trim() || /[\r\n\0]/.test(row.player_name) || !Number.isInteger(row.level) || Number(row.level) < 0 || Number(row.level) > 3)) throw new Error("SFMC \u6743\u9650\u9700\u5408\u6CD5\u73A9\u5BB6\u540D\u53CA 0 \u5230 3 \u7684\u6574\u6570\u7B49\u7EA7");
+  }
+  atomicJson(files[kind], entries);
+  return { saved: true };
+}
+export {
+  applyModulePlan,
+  identifier,
+  importPack,
+  listModules,
+  listPacks,
+  modulePlan,
+  playerFiles,
+  readJson,
+  runFetch,
+  runProcess,
+  savePlayerPermissions,
+  searchModules,
+  stripBom,
+  togglePack
+};
+//# sourceMappingURL=domain.js.map

package/dist/management/domain.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/management/domain.ts"],
+  "sourcesContent": ["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { spawn } from \"node:child_process\";\nimport { resolveRegistryIndex } from \"../registry.js\";\nimport { ROOT, resolveFetchModule } from \"../runtime.js\";\nimport { resolveBdsContext, scanLocalModules } from \"../pack-lifecycle.js\";\nimport { listInstalledWorldPacks, resolvePackRoots, readPackManifestInfo, installPackDirectory, enableInstalledPack, disableInstalledPack, worldPackParentDir } from \"@sfmc-bds/bds-tools/world-packs\";\nimport { atomicJson } from \"./tasks.js\";\nimport { isRetiredPlatformModule } from \"@sfmc-bds/sdk/contracts\";\n\n/**\n * \u53BB\u6389 UTF-8 BOM\u3002\n * \u4F7F\u7528\u573A\u666F\uFF1A\u7F16\u8F91\u5668\u6216 BDS \u5199\u51FA\u7684 JSON\uFF08\u4F8B\u5982 configs/permissions.json\uFF09\u5E38\u5E26 BOM\uFF0C\u76F4\u63A5 JSON.parse \u4F1A\u5931\u8D25\u3002\n */\nexport function stripBom(text: string): string {\n  return text.charCodeAt(0) === 0xfeff ? text.slice(1) : text;\n}\nexport function readJson<T>(file: string, fallback: T): T {\n  try { return JSON.parse(stripBom(fs.readFileSync(file, \"utf8\"))) as T; }\n  catch (error) { if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return fallback; throw error; }\n}\nexport function identifier(value: unknown): string {\n  if (typeof value !== \"string\" || !/^[a-zA-Z0-9][a-zA-Z0-9_.-]{0,127}$/.test(value) || value.includes(\"..\")) throw new Error(\"\u975E\u6CD5\u6807\u8BC6\u7B26\");\n  return value;\n}\nexport async function listModules() {\n  const rows = (await scanLocalModules()).filter(row => !isRetiredPlatformModule(row.logicalId));\n  // \u76EE\u5F55\u91CC\u7684\u5C55\u793A\u540D\u6765\u81EA modules/catalog.json\uFF1B\u6CA1\u6709\u4E2D\u6587\u540D\u65F6\u4ECD\u7528\u903B\u8F91 id\uFF0C\u907F\u514D\u754C\u9762\u53EA\u5269\u6587\u4EF6\u5939\u540D\u3002\n  const catalog = readJson<{ modules?: { id?: string; name?: string }[] }>(path.join(ROOT, \"modules\", \"catalog.json\"), {});\n  const titles = new Map((catalog.modules ?? []).filter(row => row.id && row.name).map(row => [row.id!, row.name!]));\n  return { modules: rows.map(row => ({ id: row.logicalId, folder: row.folderId, name: titles.get(row.logicalId) || row.logicalId, version: row.version ?? \"unknown\", enabled: row.enabled, linked: fs.lstatSync(path.join(ROOT, \"modules\", \"packages\", row.folderId)).isSymbolicLink() })) };\n}\nfunction fetchEntry() { const entry = resolveFetchModule(); if (!entry) throw new Error(\"\u627E\u4E0D\u5230\u6A21\u5757\u5B89\u88C5\u5668\"); return entry; }\nexport async function searchModules(query: string) {\n  const result = await resolveRegistryIndex();\n  return { modules: Object.entries(result.index).filter(([id]) => !isRetiredPlatformModule(id) && id.includes(query)).map(([id, metadata]) => ({ id, ...metadata })), stale: result.stale };\n}\nexport async function runFetch(args: string[]) {\n  await runProcess(process.execPath, [fetchEntry(), ...args], ROOT);\n  return { changed: true };\n}\nexport function runProcess(command: string, args: string[], cwd: string, onLine?: (text: string) => void): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const child = spawn(command, args, { cwd, env: { ...process.env, SFMC_ROOT: ROOT, FORCE_COLOR: \"0\" }, windowsHide: true, stdio: [\"ignore\", \"pipe\", \"pipe\"] });\n    let diagnostic = \"\";\n    for (const stream of [child.stdout, child.stderr]) stream.on(\"data\", (chunk: Buffer) => { const text = chunk.toString(); diagnostic = (diagnostic + text).slice(-6000); onLine?.(text); });\n    child.on(\"error\", reject); child.on(\"close\", code => code === 0 ? resolve() : reject(new Error(`\u5B50\u8FDB\u7A0B\u5931\u8D25 (${code}): ${diagnostic}`)));\n  });\n}\nexport async function modulePlan(ids: string[] = []) {\n  const url = pathToFileURL(path.join(path.dirname(fetchEntry()), \"lib\", \"module-update.mjs\")).href;\n  const api = await import(url) as { planModuleUpdates: (options: { root: string; ids: string[] }) => Promise<unknown> };\n  return api.planModuleUpdates({ root: ROOT, ids });\n}\nexport async function applyModulePlan(ids: string[]) {\n  const directory = path.dirname(fetchEntry());\n  const api = await import(pathToFileURL(path.join(directory, \"lib\", \"module-update.mjs\")).href) as {\n    planModuleUpdates: (options: { root: string; ids: string[] }) => Promise<{ upgrades: { id: string; spec: string }[]; failMode: \"abort\" | \"continue\" }>;\n    applyModuleUpgrades: (upgrades: unknown[], deps: object) => Promise<{ failed: { id: string; message: string }[] }>;\n    resyncInstalledCatalog: (id: string) => void;\n  };\n  const fetchApi = await import(pathToFileURL(fetchEntry()).href) as { installPreservingLock: (id: string, spec: string) => Promise<void> };\n  const plan = await api.planModuleUpdates({ root: ROOT, ids });\n  const result = await api.applyModuleUpgrades(plan.upgrades, { root: ROOT, failMode: plan.failMode, install: fetchApi.installPreservingLock, resync: api.resyncInstalledCatalog });\n  if (result.failed.length) throw new Error(JSON.stringify(result.failed));\n  return result;\n}\nexport function listPacks() {\n  const context = resolveBdsContext();\n  return { packs: listInstalledWorldPacks(context.bdsRoot, context.levelName).map(pack => ({ id: pack.uuid, name: pack.name, kind: pack.kind, enabled: pack.enabled, version: pack.version.join(\".\") })) };\n}\nexport async function togglePack(id: string, enabled: boolean) {\n  const context = resolveBdsContext();\n  const pack = listInstalledWorldPacks(context.bdsRoot, context.levelName).find(row => row.uuid === id);\n  if (!pack) throw new Error(\"\u627E\u4E0D\u5230\u4E16\u754C\u5305\");\n  if (enabled) await enableInstalledPack({ ...context, info: { uuid: pack.uuid, version: pack.version, kind: pack.kind, name: pack.name } });\n  else await disableInstalledPack({ ...context, kind: pack.kind, packUuid: pack.uuid, version: pack.version });\n  return { changed: true, restartRequired: true };\n}\nexport async function importPack(filename: string) {\n  const inbox = path.resolve(ROOT, \"packs\", \"_desktop-inbox\");\n  const file = path.resolve(inbox, identifier(filename));\n  if (!file.startsWith(inbox + path.sep) || !fs.existsSync(file)) throw new Error(\"\u4E16\u754C\u5305\u5C1A\u672A\u4E0A\u4F20\u5230\u5B9E\u4F8B\u6536\u4EF6\u7BB1\");\n  const context = resolveBdsContext();\n  const resolved = await resolvePackRoots(file);\n  try {\n    if (!resolved.roots.length) throw new Error(\"\u5F52\u6863\u4E0D\u542B\u53EF\u8BC6\u522B\u7684\u4E16\u754C\u5305\");\n    for (const root of resolved.roots) {\n      const info = readPackManifestInfo(root);\n      if (!info) throw new Error(\"\u4E16\u754C\u5305 manifest \u65E0\u6548\");\n      const result = await installPackDirectory({ srcDir: root, destParent: worldPackParentDir(context.bdsRoot, context.levelName, info.kind) });\n      if (!result.ok) throw new Error(result.reason ?? \"\u5B89\u88C5\u5931\u8D25\uFF1B\u53EF\u80FD\u4E0E\u5DF2\u6709\u5305\u51B2\u7A81\");\n      await enableInstalledPack({ ...context, info });\n    }\n  } finally { resolved.dispose?.(); }\n  return { changed: true, restartRequired: true };\n}\nexport function playerFiles() {\n  const bds = resolveBdsContext().bdsRoot;\n  return { allowlist: path.join(bds, \"allowlist.json\"), permissions: path.join(bds, \"permissions.json\"), sfmcPermissions: path.join(ROOT, \"configs\", \"permissions.json\") };\n}\nexport function savePlayerPermissions(kind: string, entries: unknown) {\n  const files = playerFiles();\n  if (!(kind in files) || !Array.isArray(entries)) throw new Error(\"\u975E\u6CD5\u73A9\u5BB6\u6743\u9650\u7C7B\u578B\u6216\u5185\u5BB9\");\n  for (const entry of entries) {\n    if (!entry || typeof entry !== \"object\") throw new Error(\"\u6743\u9650\u6761\u76EE\u5FC5\u987B\u4E3A\u5BF9\u8C61\");\n    const row = entry as Record<string, unknown>;\n    if (kind === \"allowlist\" && (typeof row.name !== \"string\" || /[\\r\\n]/.test(row.name))) throw new Error(\"\u5141\u8BB8\u540D\u5355\u9700\u63D0\u4F9B\u5408\u6CD5\u73A9\u5BB6\u540D\u79F0\");\n    if (kind === \"permissions\" && (typeof row.xuid !== \"string\" || !/^\\d+$/.test(row.xuid) || ![\"visitor\", \"member\", \"operator\"].includes(String(row.permission)))) throw new Error(\"BDS \u6743\u9650\u9700\u6709\u6548 XUID \u548C\u6743\u9650\u7B49\u7EA7\");\n    if (kind === \"sfmcPermissions\" && (typeof row.player_name !== \"string\" || !row.player_name.trim() || /[\\r\\n\\0]/.test(row.player_name) || !Number.isInteger(row.level) || Number(row.level) < 0 || Number(row.level) > 3)) throw new Error(\"SFMC \u6743\u9650\u9700\u5408\u6CD5\u73A9\u5BB6\u540D\u53CA 0 \u5230 3 \u7684\u6574\u6570\u7B49\u7EA7\");\n  }\n  atomicJson(files[kind as keyof typeof files], entries);\n  return { saved: true };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/management/maintenance.d.ts

@@ -0,0 +1,18 @@
+import { type ServiceName } from "../services.js";
+import { type TaskContext, type TaskStore } from "./tasks.js";
+import type { AttachmentPlan } from "@sfmc-bds/management";
+export declare function platformVersion(): string;
+export declare function attachmentPlan(): Promise<AttachmentPlan>;
+export declare function stopForMaintenance(names: ServiceName[], phase: TaskContext["phase"]): Promise<ServiceName[]>;
+export declare function restoreRunning(names: ServiceName[], phase: TaskContext["phase"]): Promise<void>;
+export declare function verifyRunning(names: ServiceName[]): Promise<void>;
+export declare function createSnapshot(id: string, phase: TaskContext["phase"]): Promise<string>;
+export declare function restoreSnapshot(id: string, phase: TaskContext["phase"]): Promise<{
+    restored: string;
+}>;
+export declare function withStoppedServices<T>(context: TaskContext, names: ServiceName[], action: () => Promise<T>, backup?: boolean, rollbackPrograms?: "modules" | "bds"): Promise<T>;
+export declare function launchPlatformUpdate(store: TaskStore, context: TaskContext, target: string): Promise<{
+    detached: boolean;
+}>;
+export declare function runPnpm(args: string[], cwd: string): Promise<void>;
+//# sourceMappingURL=maintenance.d.ts.map

package/dist/management/maintenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintenance.d.ts","sourceRoot":"","sources":["../../src/management/maintenance.ts"],"names":[],"mappings":"AAMA,OAAO,EAAoD,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEpG,OAAO,EAAc,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAE1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAY3D,wBAAgB,eAAe,IAAI,MAAM,CASxC;AACD,wBAAsB,cAAc,IAAI,OAAO,CAAC,cAAc,CAAC,CAkB9D;AACD,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAUlH;AACD,wBAAsB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,iBAOrF;AACD,wBAAsB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,iBAWvD;AAMD,wBAAsB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,mBAc3E;AACD,wBAAsB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC;;GAiB5E;AAuBD,wBAAsB,mBAAmB,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,UAAO,EAAE,gBAAgB,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAqBlL;AACD,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM;;GAmBhG;AACD,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,iBASxD"}

package/dist/management/maintenance.js

@@ -0,0 +1,214 @@
+import fs from "node:fs";
+import path from "node:path";
+import { createRequire } from "node:module";
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { ROOT, isMonorepoLayout, isSourceCheckout } from "../runtime.js";
+import { queryServicesRuntimeLocal, services, START_ORDER } from "../services.js";
+import { resolveBdsContext } from "../pack-lifecycle.js";
+import { atomicJson } from "./tasks.js";
+import { readJson, runProcess } from "./domain.js";
+import { isDaemonServer } from "../daemon/role.js";
+import { callDaemon } from "../daemon/client.js";
+async function runtimeRows() {
+  if (isDaemonServer()) return queryServicesRuntimeLocal();
+  const result = await callDaemon("status");
+  if (result.kind !== "status") throw new Error("\u65E0\u6CD5\u8BFB\u53D6\u5B88\u62A4\u8FDB\u7A0B\u670D\u52A1\u72B6\u6001");
+  return result.rows;
+}
+const require2 = createRequire(import.meta.url);
+function platformVersion() {
+  if (isMonorepoLayout(ROOT)) return readJson(path.join(ROOT, "packages", "meta", "package.json"), { version: "unknown" }).version;
+  if (process.env.SFMC_PLATFORM_VERSION) return process.env.SFMC_PLATFORM_VERSION;
+  const active = readJson(path.join(ROOT, ".sfmc", "runtime", "active.json"), {});
+  if (active.version) return active.version;
+  const deployed = readJson(path.join(ROOT, "node_modules", "@sfmc-bds", "sfmc", "package.json"), {});
+  if (deployed.version) return deployed.version;
+  try {
+    return require2("@sfmc-bds/sfmc/package.json").version;
+  } catch {
+    return readJson(path.join(fileURLToPath(new URL("../../..", import.meta.url)), "package.json"), { version: "unknown" }).version;
+  }
+}
+async function attachmentPlan() {
+  const development = isMonorepoLayout(ROOT) || isSourceCheckout();
+  const currentVersion = platformVersion();
+  let targetVersion = currentVersion;
+  if (!development) {
+    const response = await fetch("https://registry.npmjs.org/@sfmc-bds%2fsfmc/latest", { signal: AbortSignal.timeout(15e3) });
+    if (!response.ok) throw new Error(`\u5E73\u53F0\u7248\u672C\u68C0\u67E5\u5931\u8D25 (${response.status})`);
+    const metadata = await response.json();
+    if (!metadata.version || !/^\d+\.\d+\.\d+$/.test(metadata.version)) throw new Error("latest \u6CA1\u6709\u6307\u5411\u6709\u6548\u7684\u7A33\u5B9A\u5E73\u53F0\u7248\u672C");
+    const currentBase = /^(\d+)\.(\d+)\.(\d+)(?:-[\w.-]+)?$/.exec(currentVersion);
+    const latest = metadata.version.split(".").map(Number);
+    const current = currentBase?.slice(1).map(Number);
+    const difference = current && latest.map((value, index) => value - current[index]).find((value) => value !== 0);
+    if (!current || difference === void 0 || difference >= 0) targetVersion = metadata.version;
+  }
+  const rows = await runtimeRows();
+  return { currentVersion, targetVersion, development, upgradeRequired: !development && targetVersion !== currentVersion, externalServices: rows.filter((row) => row.running && row.ownership === "external").map((row) => row.name), steps: development ? ["\u4FDD\u7559\u6E90\u7801\u5DE5\u4F5C\u533A\uFF0C\u8FDE\u63A5\u5F53\u524D\u5F00\u53D1\u90E8\u7F72"] : ["\u4E0B\u8F7D\u56FA\u5B9A\u7248\u672C\u7684\u5E73\u53F0\u4F9D\u8D56\u7EC4\u5408", "\u505C\u6B62\u53D7\u5F71\u54CD\u670D\u52A1\u5E76\u786E\u8BA4\u8FDB\u7A0B\u9000\u51FA", "\u5907\u4EFD\u914D\u7F6E\u3001\u6A21\u5757\u3001\u6570\u636E\u5E93\u4E0E\u4E16\u754C", "\u5207\u6362\u5E73\u53F0\u5E76\u9A8C\u8BC1", "\u6062\u590D\u6B64\u524D\u8FD0\u884C\u7684\u670D\u52A1"] };
+}
+async function stopForMaintenance(names, phase) {
+  const before = await queryServicesRuntimeLocal();
+  const affected = before.filter((row) => names.includes(row.name) && row.running);
+  if (affected.some((row) => row.ownership === "external")) throw Object.assign(new Error("\u5B58\u5728\u65E0\u6CD5\u901A\u8FC7\u5F53\u524D\u5B88\u62A4\u8FDB\u7A0B\u4F18\u96C5\u505C\u6B62\u7684\u5916\u90E8\u670D\u52A1\uFF1B\u8BF7\u5148\u901A\u8FC7\u539F\u7BA1\u7406\u5668\u505C\u6B62\u540E\u91CD\u65B0\u63A5\u5165"), { code: "conflict" });
+  phase("stop-services", "\u4F18\u96C5\u505C\u6B62\u5E76\u786E\u8BA4\u8FDB\u7A0B\u9000\u51FA");
+  const running = affected.map((row) => row.name);
+  for (const name of [...START_ORDER].reverse().filter((name2) => names.includes(name2))) await services[name].stop(false, false);
+  const after = await queryServicesRuntimeLocal();
+  if (after.some((row) => names.includes(row.name) && row.running)) throw new Error("\u670D\u52A1\u672A\u5B8C\u5168\u9000\u51FA\uFF0C\u5DF2\u4E2D\u6B62\u6587\u4EF6\u64CD\u4F5C");
+  return running;
+}
+async function restoreRunning(names, phase) {
+  phase("restore", "\u6062\u590D\u7EF4\u62A4\u524D\u8FD0\u884C\u7684\u670D\u52A1");
+  for (const name of START_ORDER.filter((name2) => names.includes(name2))) {
+    const result = await services[name].start();
+    if (result.status === "skipped") throw new Error(`\u6062\u590D ${name} \u5931\u8D25: ${result.reason}`);
+  }
+  await verifyRunning(names);
+}
+async function verifyRunning(names) {
+  if (!names.length) return;
+  await new Promise((resolve) => setTimeout(resolve, 2e3));
+  for (const name of names) {
+    if (!services[name].running || !services[name].pid) throw new Error(`${name} \u542F\u52A8\u540E\u5DF2\u9000\u51FA`);
+  }
+  if (names.includes("db")) {
+    const cfg = readJson(path.join(ROOT, "configs", "db_config.json"), {});
+    const response = await fetch(`http://127.0.0.1:${cfg.db_port ?? 3001}/api/sfmc/status`, { headers: cfg.http_auth ? { authorization: `Bearer ${cfg.http_auth}` } : {}, signal: AbortSignal.timeout(5e3) });
+    if (!response.ok) throw new Error(`DB \u5065\u5EB7\u68C0\u67E5\u5931\u8D25 (${response.status})`);
+  }
+}
+function snapshotTargets() {
+  const db = readJson(path.join(ROOT, "configs", "db_config.json"), {});
+  const bds = resolveBdsContext().bdsRoot;
+  return { configs: path.join(ROOT, "configs"), modules: path.join(ROOT, "modules"), data: path.dirname(path.resolve(ROOT, db.dbDir ?? "data/sfmc_data.db")), bds };
+}
+async function createSnapshot(id, phase) {
+  phase("backup", "\u521B\u5EFA\u5DF2\u505C\u670D\u7684\u4E00\u81F4\u5907\u4EFD");
+  const destination = path.join(ROOT, ".sfmc", "backups", id);
+  fs.mkdirSync(destination, { recursive: true });
+  const targets = snapshotTargets();
+  for (const target of Object.values(targets)) {
+    const absolute = path.resolve(target);
+    if (absolute === path.parse(absolute).root || absolute === path.resolve(ROOT) || destination.startsWith(absolute + path.sep)) throw new Error("\u5907\u4EFD\u76EE\u6807\u5305\u542B\u5B9E\u4F8B\u6839\u76EE\u5F55\u6216\u5907\u4EFD\u76EE\u5F55\uFF0C\u5DF2\u4E2D\u6B62");
+  }
+  for (const [key, target] of Object.entries(targets)) {
+    if (fs.existsSync(target)) await fs.promises.cp(target, path.join(destination, key), { recursive: true, dereference: false });
+  }
+  atomicJson(path.join(destination, "manifest.json"), { createdAt: (/* @__PURE__ */ new Date()).toISOString(), targets, complete: true });
+  return destination;
+}
+async function restoreSnapshot(id, phase) {
+  if (!/^[a-zA-Z0-9-]{1,80}$/.test(id)) throw new Error("\u975E\u6CD5\u5907\u4EFD\u7F16\u53F7");
+  const source = path.join(ROOT, ".sfmc", "backups", id);
+  const manifest = readJson(path.join(source, "manifest.json"), { complete: false, targets: {} });
+  if (!manifest.complete) throw new Error("\u5907\u4EFD\u4E0D\u5B8C\u6574\uFF0C\u7981\u6B62\u6062\u590D");
+  const targets = snapshotTargets();
+  phase("restore-data", "\u6309\u7528\u6237\u660E\u786E\u9009\u62E9\u6062\u590D\u914D\u7F6E\u3001\u6A21\u5757\u3001\u6570\u636E\u5E93\u548C\u4E16\u754C");
+  for (const [key, target] of Object.entries(targets)) {
+    if (path.resolve(manifest.targets[key] ?? "") !== path.resolve(target)) throw new Error("\u5907\u4EFD\u76EE\u6807\u4E0E\u5F53\u524D\u90E8\u7F72\u4E0D\u4E00\u81F4");
+    const saved = path.join(source, key);
+    if (!fs.existsSync(saved)) continue;
+    const absolute = path.resolve(target);
+    if (absolute === path.parse(absolute).root || absolute === path.resolve(ROOT) || fs.lstatSync(saved).isSymbolicLink()) throw new Error("\u4E0D\u5B89\u5168\u7684\u6062\u590D\u76EE\u6807");
+    await fs.promises.rm(absolute, { recursive: true, force: true });
+    await fs.promises.cp(saved, absolute, { recursive: true, dereference: false });
+  }
+  return { restored: id };
+}
+async function restoreProgramSnapshot(id, kind) {
+  const source = path.join(ROOT, ".sfmc", "backups", id);
+  const manifest = readJson(path.join(source, "manifest.json"), { complete: false, targets: {} });
+  const targets = snapshotTargets();
+  if (!manifest.complete || path.resolve(manifest.targets[kind] ?? "") !== path.resolve(targets[kind])) throw new Error("\u7A0B\u5E8F\u5907\u4EFD\u4E0D\u5B8C\u6574\u6216\u76EE\u6807\u4E0D\u5339\u914D");
+  const saved = path.join(source, kind);
+  if (kind === "modules") {
+    if (!fs.existsSync(saved)) return;
+    await fs.promises.rm(targets.modules, { recursive: true, force: true });
+    await fs.promises.cp(saved, targets.modules, { recursive: true, dereference: false });
+    return;
+  }
+  const cfg = readJson(path.join(ROOT, "configs", "bds_updater.json"), {});
+  const preserved = /* @__PURE__ */ new Set(["worlds", "config", "server.properties", "allowlist.json", "whitelist.json", "permissions.json", ...(cfg.preserve ?? []).map((name) => name.split(/[\\/]/)[0])]);
+  if (!fs.existsSync(saved)) throw new Error("\u7F3A\u5C11\u539F BDS \u7A0B\u5E8F\u5907\u4EFD");
+  const target = path.resolve(targets.bds);
+  if (target === path.parse(target).root || target === path.resolve(ROOT)) throw new Error("\u4E0D\u5B89\u5168\u7684\u7A0B\u5E8F\u56DE\u9000\u76EE\u6807");
+  fs.mkdirSync(target, { recursive: true });
+  for (const entry of fs.readdirSync(target)) if (!preserved.has(entry)) await fs.promises.rm(path.join(target, entry), { recursive: true, force: true });
+  for (const entry of fs.readdirSync(saved)) if (!preserved.has(entry)) await fs.promises.cp(path.join(saved, entry), path.join(target, entry), { recursive: true, dereference: false });
+}
+async function withStoppedServices(context, names, action, backup = true, rollbackPrograms) {
+  const running = await stopForMaintenance(names, context.phase);
+  try {
+    if (backup) await createSnapshot(context.id, context.phase);
+    context.phase("execute");
+    const result = await action();
+    context.phase("verify");
+    await restoreRunning(running, context.phase);
+    return result;
+  } catch (error) {
+    for (const name of [...START_ORDER].reverse().filter((name2) => running.includes(name2))) await services[name].stop(false, false).catch(() => {
+    });
+    let programRolledBack = false;
+    let rollbackError;
+    if (rollbackPrograms) {
+      context.phase("rollback-program", "\u56DE\u9000\u7A0B\u5E8F\u7248\u672C\uFF0C\u4FDD\u7559\u5F53\u524D\u73A9\u5BB6\u6570\u636E");
+      try {
+        await restoreProgramSnapshot(context.id, rollbackPrograms);
+        programRolledBack = true;
+      } catch (failure) {
+        rollbackError = String(failure);
+      }
+    }
+    throw Object.assign(new Error(`\u7EF4\u62A4\u5931\u8D25\uFF0C\u670D\u52A1\u4FDD\u6301\u505C\u6B62\uFF1B\u5907\u4EFD\u7F16\u53F7 ${context.id}: ${error instanceof Error ? error.message : String(error)}`), { code: "io", details: { backupId: context.id, programRolledBack, dataRestoreRequired: Boolean(rollbackPrograms), ...rollbackError ? { rollbackError } : {}, ...error.details ?? {} } });
+  }
+}
+async function launchPlatformUpdate(store, context, target) {
+  if (isMonorepoLayout(ROOT)) throw new Error("\u6E90\u7801\u90E8\u7F72\u4E0D\u8986\u76D6\u5DE5\u4F5C\u533A\uFF1B\u8BF7\u4F7F\u7528\u6B63\u5E38\u5F00\u53D1\u53D1\u5E03\u6D41\u7A0B");
+  if (!/^\d+\.\d+\.\d+$/.test(target)) throw new Error("\u9700\u8981\u56FA\u5B9A\u7A33\u5B9A\u7248\u672C");
+  const rows = await runtimeRows();
+  if (rows.some((row) => row.running && row.ownership === "external")) throw new Error("\u5916\u90E8\u670D\u52A1\u5FC5\u987B\u5148\u901A\u8FC7\u539F\u7BA1\u7406\u5668\u4F18\u96C5\u505C\u6B62");
+  const request = path.join(ROOT, ".sfmc", "operations", `${context.id}.request.json`);
+  const previous = readJson(path.join(ROOT, ".sfmc", "runtime", "active.json"), { entry: fs.existsSync(path.join(ROOT, "node_modules", "@sfmc-bds", "sfmc", "bin", "sfmc.mjs")) ? path.join(ROOT, "node_modules", "@sfmc-bds", "sfmc", "bin", "sfmc.mjs") : process.env.SFMC_DAEMON_ENTRY, version: platformVersion() });
+  atomicJson(request, { root: ROOT, id: context.id, target, running: rows.filter((row) => row.running).map((row) => row.name), previous });
+  const entry = fileURLToPath(new URL("./platform-worker.js", import.meta.url));
+  fs.mkdirSync(path.join(ROOT, ".sfmc", "logs"), { recursive: true });
+  const fd = fs.openSync(path.join(ROOT, ".sfmc", "logs", "maintenance.log"), "a");
+  const child = spawn(process.execPath, [entry, request], { cwd: ROOT, env: { ...process.env, SFMC_ROOT: ROOT }, detached: true, windowsHide: true, stdio: ["ignore", fd, fd] });
+  fs.closeSync(fd);
+  await new Promise((resolve, reject) => {
+    child.once("spawn", resolve);
+    child.once("error", reject);
+  });
+  child.unref();
+  const record = store.get(context.id);
+  record.status = "running";
+  if (child.pid) record.workerPid = child.pid;
+  store.save(record);
+  return { detached: true };
+}
+async function runPnpm(args, cwd) {
+  const script = process.env.SFMC_PNPM_ENTRY;
+  if (script) return runProcess(process.execPath, [script, ...args], cwd);
+  const command = process.platform === "win32" ? "pnpm.cmd" : "pnpm";
+  const crossSpawn = require2("cross-spawn");
+  await new Promise((resolve, reject) => {
+    const child = crossSpawn(command, args, { cwd, env: process.env, windowsHide: true, stdio: "ignore" });
+    child.on("error", reject);
+    child.on("close", (code) => code === 0 ? resolve() : reject(new Error(`pnpm \u6267\u884C\u5931\u8D25 (${code})`)));
+  });
+}
+export {
+  attachmentPlan,
+  createSnapshot,
+  launchPlatformUpdate,
+  platformVersion,
+  restoreRunning,
+  restoreSnapshot,
+  runPnpm,
+  stopForMaintenance,
+  verifyRunning,
+  withStoppedServices
+};
+//# sourceMappingURL=maintenance.js.map