@sfmc-bds/bds-tools 0.2.0-beta.8 → 0.2.0

package/dist/http.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/http.ts"],
-  "sourcesContent": ["/**\n * http.ts \u2014 \u7A33\u5B9A HTTP \u5DE5\u5177 (\u5206\u9636\u6BB5\u8D85\u65F6 + \u81EA\u52A8\u91CD\u5B9A\u5411 + \u6D41\u5F0F\u4E0B\u8F7D)\n *\n * \u6539\u8FDB:\n *  - connect timeout vs total timeout \u5206\u5F00\n *  - \u4E0B\u8F7D\u901A\u8FC7\u6D41\u7BA1\u9053\uFF0C\u907F\u514D\u5927\u6587\u4EF6\u52A0\u8F7D\u5230\u5185\u5B58\n *  - \u5931\u8D25\u540E\u5DF2\u5199\u5165\u7684\u4E34\u65F6\u6587\u4EF6\u53EF\u88AB\u6E05\u7406\n */\n\nimport http from \"node:http\";\nimport https from \"node:https\";\nimport type { Readable } from \"node:stream\";\nimport { pipeline } from \"node:stream/promises\";\nimport { createWriteStream, statSync } from \"node:fs\";\nimport { log } from \"./log.js\";\n\ninterface HttpOptions {\n  method?: \"GET\" | \"HEAD\" | \"POST\";\n  headers?: Record<string, string>;\n  body?: string;\n  connectTimeoutMs?: number;\n  totalTimeoutMs?: number;\n  redirects?: number;\n}\n\nconst MAX_REDIRECTS = 5;\nconst DEFAULT_CONNECT_TIMEOUT = 15_000;\nconst DEFAULT_TOTAL_TIMEOUT = 600_000;\n\nexport async function httpRequest(\n  url: string,\n  opts: HttpOptions = {}\n): Promise<{ statusCode: number; body: Buffer; headers: Record<string, string | string[] | undefined> }> {\n  const redirects = opts.redirects ?? 0;\n  const totalTimeoutMs = opts.totalTimeoutMs ?? DEFAULT_TOTAL_TIMEOUT;\n  const connectTimeoutMs = opts.connectTimeoutMs ?? DEFAULT_CONNECT_TIMEOUT;\n\n  const u = new URL(url);\n  const isHttps = u.protocol === \"https:\";\n  const mod = isHttps ? https : http;\n\n  return new Promise((resolve, reject) => {\n    const req = mod.request(\n      {\n        hostname: u.hostname,\n        port: u.port || (isHttps ? 443 : 80),\n        path: u.pathname + u.search,\n        method: opts.method ?? \"GET\",\n        headers: { \"User-Agent\": \"BDSUpdater/2.0\", ...(opts.headers ?? {}) },\n      },\n      (res) => {\n        const chunks: Buffer[] = [];\n        res.on(\"data\", (c: Buffer) => chunks.push(c));\n        res.on(\"end\", () => {\n          const body = Buffer.concat(chunks);\n          const status = res.statusCode ?? 0;\n          // 3xx \u2192 \u8DDF\u968F Location\n          if (status >= 300 && status < 400 && redirects < MAX_REDIRECTS) {\n            const loc = res.headers.location;\n            if (!loc) return reject(new Error(`HTTP ${status} \u4F46\u7F3A\u5C11 Location`));\n            const next = loc.startsWith(\"http\") ? loc : new URL(loc, url).href;\n            httpRequest(next, { ...opts, redirects: redirects + 1 })\n              .then(resolve)\n              .catch(reject);\n            return;\n          }\n          if (status >= 400) {\n            return reject(new Error(`HTTP ${status} for ${url}`));\n          }\n          resolve({ statusCode: status, body, headers: res.headers });\n        });\n      }\n    );\n\n    const totalTimer = setTimeout(() => {\n      req.destroy(new Error(`HTTP \u603B\u8D85\u65F6 ${totalTimeoutMs}ms: ${url}`));\n    }, totalTimeoutMs);\n    const connectTimer = setTimeout(() => {\n      req.destroy(new Error(`HTTP \u8FDE\u63A5\u8D85\u65F6 ${connectTimeoutMs}ms: ${url}`));\n    }, connectTimeoutMs);\n\n    req.on(\"socket\", () => clearTimeout(connectTimer));\n    req.on(\"error\", (err) => {\n      clearTimeout(totalTimer);\n      clearTimeout(connectTimer);\n      reject(err);\n    });\n\n    if (opts.body) req.write(opts.body);\n    req.end();\n  });\n}\n\nexport async function httpGetJson<T = unknown>(\n  url: string,\n  opts: HttpOptions = {}\n): Promise<T> {\n  const res = await httpRequest(url, opts);\n  try {\n    return JSON.parse(res.body.toString(\"utf-8\")) as T;\n  } catch (e) {\n    throw new Error(`JSON \u89E3\u6790\u5931\u8D25 ${url}: ${(e as Error).message}`);\n  }\n}\n\nexport async function httpGetText(url: string, opts: HttpOptions = {}): Promise<string> {\n  const res = await httpRequest(url, opts);\n  return res.body.toString(\"utf-8\");\n}\n\n/** \u591A\u4E2A\u6E90\u5E76\u53D1\u8BF7\u6C42\uFF0C\u8C01\u5148\u6210\u529F\u8FD4\u56DE\uFF08\u6BCF\u4E2A\u6E90\u90FD\u7528 JSON \u89E3\u6790\uFF0C\u89E3\u6790\u5931\u8D25\u4E5F\u5931\u8D25\uFF09 */\nexport async function fetchJsonWithFallback<T = unknown>(\n  sources: string[],\n  timeoutMs = 15_000\n): Promise<T> {\n  const tasks = sources.map(async (url) => {\n    const res = await httpGetJson<T>(url, { totalTimeoutMs: timeoutMs });\n    return { url, value: res };\n  });\n  const settled = await Promise.allSettled(tasks);\n  for (const r of settled) {\n    if (r.status === \"fulfilled\") return r.value.value;\n  }\n  const errors = settled\n    .filter((r): r is PromiseRejectedResult => r.status === \"rejected\")\n    .map((r) => r.reason?.message ?? \"unknown\")\n    .join(\"; \");\n  throw new Error(`\u6240\u6709\u6E90\u5747\u4E0D\u53EF\u7528: ${errors}`);\n}\n\n/**\n * \u6D41\u5F0F\u4E0B\u8F7D\u5230\u6307\u5B9A\u8DEF\u5F84\uFF0C\u8FD4\u56DE\u5B57\u8282\u6570\u3002\n * - \u5931\u8D25\u65F6\u81EA\u52A8\u6E05\u7406 partial \u6587\u4EF6\n * - \u652F\u6301 progress \u56DE\u8C03\n * - \u652F\u6301 connect/total \u9636\u6BB5\u8D85\u65F6\n */\nexport interface DownloadOptions extends HttpOptions {\n  onProgress?: (downloaded: number, total: number) => void;\n}\n\nexport async function httpDownload(\n  url: string,\n  destPath: string,\n  opts: DownloadOptions = {}\n): Promise<number> {\n  const totalTimeoutMs = opts.totalTimeoutMs ?? DEFAULT_TOTAL_TIMEOUT;\n  const connectTimeoutMs = opts.connectTimeoutMs ?? DEFAULT_CONNECT_TIMEOUT;\n\n  const u = new URL(url);\n  const isHttps = u.protocol === \"https:\";\n  const mod = isHttps ? https : http;\n  let redirects = opts.redirects ?? 0;\n\n  return new Promise((resolve, reject) => {\n    const req = mod.request(\n      {\n        hostname: u.hostname,\n        port: u.port || (isHttps ? 443 : 80),\n        path: u.pathname + u.search,\n        method: \"GET\",\n        headers: { \"User-Agent\": \"BDSUpdater/2.0\", ...(opts.headers ?? {}) },\n      },\n      (res) => {\n        const status = res.statusCode ?? 0;\n        if (status >= 300 && status < 400 && redirects < MAX_REDIRECTS) {\n          const loc = res.headers.location;\n          if (!loc) return reject(new Error(`HTTP ${status} \u7F3A\u5C11 Location`));\n          redirects++;\n          const next = loc.startsWith(\"http\") ? loc : new URL(loc, url).href;\n          res.resume();\n          httpDownload(next, destPath, { ...opts, redirects })\n            .then(resolve)\n            .catch(reject);\n          return;\n        }\n        if (status >= 400) return reject(new Error(`HTTP ${status} for ${url}`));\n\n        const total = parseInt(String(res.headers[\"content-length\"] ?? 0), 10) || 0;\n        const file = createWriteStream(destPath);\n        let downloaded = 0;\n        let failed = false;\n        // \u8282\u6D41\u8FDB\u5EA6\u56DE\u8C03:\u6BCF\u4E2A tick \u6700\u591A 10 \u6B21/\u79D2(100ms \u95F4\u9694),\n        // \u907F\u514D cli-progress \u9891\u7E41\u91CD\u7ED8\u62D6\u6162\u4E0B\u8F7D\n        let lastProgressAt = 0;\n        const PROGRESS_INTERVAL_MS = 100;\n\n        const handleError = (e: Error): void => {\n          if (failed) return;\n          failed = true;\n          file.close();\n          // \u6E05\u7406 partial \u6587\u4EF6\n          import(\"node:fs\").then((fs) => {\n            try { fs.unlinkSync(destPath); } catch {}\n          });\n          reject(e);\n        };\n\n        const stream: Readable = res;\n        stream.on(\"data\", (chunk: Buffer) => {\n          downloaded += chunk.length;\n          if (opts.onProgress) {\n            const now = Date.now();\n            if (now - lastProgressAt >= PROGRESS_INTERVAL_MS) {\n              lastProgressAt = now;\n              /* total=0\uFF08\u65E0 Content-Length\uFF09\u65F6\u4ECD\u56DE\u8C03\uFF0C\u8C03\u7528\u65B9\u53EF\u7528\u5DF2\u4E0B\u8F7D\u5B57\u8282\u66F4\u65B0 UI */\n              opts.onProgress(downloaded, total);\n            }\n          }\n        });\n        stream.on(\"error\", (e) => handleError(e as Error));\n\n        file.on(\"error\", (e) => handleError(e as Error));\n\n        pipeline(stream, file).catch((e) => {\n          if (!failed) handleError(e as Error);\n        });\n\n        // \u4E0D\u80FD\u76F4\u63A5\u76D1\u542C file 'finish' \u56E0\u4E3A\u6211\u4EEC\u5728\u9519\u8BEF\u65F6\u624B\u52A8 handleError\n        file.on(\"finish\", () => {\n          if (failed) return;\n          try {\n            const finalBytes = statSync(destPath).size;\n            // \u6536\u5C3E:\u786E\u4FDD\u6700\u540E\u4E00\u6B21\u56DE\u8C03\u8BA9\u8FDB\u5EA6\u6761\u8D70\u5230 100%(\u5373\u4FBF\u6700\u8FD1\n            // \u4E00\u4E2A tick \u7684\u8282\u6D41\u6CA1\u89E6\u53D1,\u4E5F\u8865\u4E00\u6B21)\u3002\n            // \u65E0 Content-Length\uFF08total=0\uFF09\u65F6\u7528 finalBytes \u4F5C\u603B\u91CF\uFF0C\u4E0E\u4E2D\u9014\u300C\u4ECD\u56DE\u8C03\u300D\u5951\u7EA6\u4E00\u81F4\uFF08LSP\uFF09\u3002\n            if (opts.onProgress) {\n              opts.onProgress(finalBytes, total > 0 ? total : finalBytes);\n            }\n            resolve(finalBytes);\n          } catch (e) {\n            reject(e as Error);\n          }\n        });\n      }\n    );\n\n    const totalTimer = setTimeout(() => {\n      req.destroy(new Error(`\u4E0B\u8F7D\u603B\u8D85\u65F6 ${totalTimeoutMs}ms: ${url}`));\n    }, totalTimeoutMs);\n    const connectTimer = setTimeout(() => {\n      req.destroy(new Error(`\u4E0B\u8F7D\u8FDE\u63A5\u8D85\u65F6 ${connectTimeoutMs}ms: ${url}`));\n    }, connectTimeoutMs);\n\n    req.on(\"socket\", () => clearTimeout(connectTimer));\n    req.on(\"error\", (e) => {\n      clearTimeout(totalTimer);\n      clearTimeout(connectTimer);\n      log.warn(`HTTP \u9519\u8BEF ${url}: ${(e as Error).message}`);\n      reject(e);\n    });\n    req.end();\n  });\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * http.ts \u2014 \u9488\u5BF9\u5927\u6587\u4EF6\u4E0E\u5916\u90E8\u4E0A\u6E38\u8BBE\u8BA1\u7684 HTTP \u7F51\u7EDC\u8BF7\u6C42\u5DE5\u5177\n *\n * \u6838\u5FC3\u673A\u5236\uFF1A\n * - \u5206\u9636\u6BB5\u8D85\u65F6\u63A7\u5236\uFF1A\u533A\u5206\u8FDE\u63A5\u5EFA\u7ACB\u8D85\u65F6\uFF08connectTimeout\uFF09\u4E0E\u5168\u91CF\u4F20\u8F93\u8D85\u65F6\uFF08totalTimeout\uFF09\n * - \u81EA\u52A8\u91CD\u5B9A\u5411\u5904\u7406\uFF1A\u5B89\u5168\u8DDF\u8E2A 3xx \u8DF3\u8F6C\uFF08\u6700\u591A 5 \u6B21\uFF09\n * - \u6D41\u5F0F\u6587\u4EF6\u4E0B\u8F7D\uFF1A\u901A\u8FC7 pipeline \u7BA1\u9053\u76F4\u63A5\u843D\u76D8\uFF0C\u907F\u514D\u5927\u6587\u4EF6\u4E00\u6B21\u6027\u52A0\u8F7D\u81F3\u5185\u5B58\n * - \u5F02\u5E38\u5BB9\u9519\u6E05\u7406\uFF1A\u4E0B\u8F7D\u5931\u8D25\u65F6\u81EA\u52A8\u6E05\u7406\u6B8B\u7559\u7684\u4E34\u65F6\u6587\u4EF6\u788E\u7247\n */\n\nimport http from \"node:http\";\nimport https from \"node:https\";\nimport type { Readable } from \"node:stream\";\nimport { pipeline } from \"node:stream/promises\";\nimport { createWriteStream, statSync } from \"node:fs\";\nimport { log } from \"./log.js\";\n\ninterface HttpOptions {\n  method?: \"GET\" | \"HEAD\" | \"POST\";\n  headers?: Record<string, string>;\n  body?: string;\n  connectTimeoutMs?: number;\n  totalTimeoutMs?: number;\n  redirects?: number;\n}\n\nconst MAX_REDIRECTS = 5;\nconst DEFAULT_CONNECT_TIMEOUT = 15_000;\nconst DEFAULT_TOTAL_TIMEOUT = 600_000;\n\n/**\n * \u53D1\u8D77\u5E95\u5C42 HTTP/HTTPS \u8BF7\u6C42\u3002\n *\n * @param url \u76EE\u6807\u8BF7\u6C42\u5730\u5740\u3002\n * @param opts \u8BF7\u6C42\u53C2\u6570\uFF08\u5305\u542B\u8BF7\u6C42\u65B9\u6CD5\u3001\u8BF7\u6C42\u5934\u3001\u4E3B\u4F53\u3001\u9636\u6BB5\u8D85\u65F6\u65F6\u95F4\u53CA\u91CD\u5B9A\u5411\u6B21\u6570\u7B49\uFF09\u3002\n * @returns \u5305\u542B\u72B6\u6001\u7801\u3001\u54CD\u5E94\u4F53 Buffer \u53CA\u54CD\u5E94\u5934\u5B57\u5178\u7684\u7ED3\u679C\u5BF9\u8C61\u3002\n */\nexport async function httpRequest(\n\n  url: string,\n  opts: HttpOptions = {}\n): Promise<{ statusCode: number; body: Buffer; headers: Record<string, string | string[] | undefined> }> {\n  const redirects = opts.redirects ?? 0;\n  const totalTimeoutMs = opts.totalTimeoutMs ?? DEFAULT_TOTAL_TIMEOUT;\n  const connectTimeoutMs = opts.connectTimeoutMs ?? DEFAULT_CONNECT_TIMEOUT;\n\n  const u = new URL(url);\n  const isHttps = u.protocol === \"https:\";\n  const mod = isHttps ? https : http;\n\n  return new Promise((resolve, reject) => {\n    const req = mod.request(\n      {\n        hostname: u.hostname,\n        port: u.port || (isHttps ? 443 : 80),\n        path: u.pathname + u.search,\n        method: opts.method ?? \"GET\",\n        headers: { \"User-Agent\": \"BDSUpdater/2.0\", ...(opts.headers ?? {}) },\n      },\n      (res) => {\n        const chunks: Buffer[] = [];\n        res.on(\"data\", (c: Buffer) => chunks.push(c));\n        res.on(\"end\", () => {\n          const body = Buffer.concat(chunks);\n          const status = res.statusCode ?? 0;\n          // 3xx \u2192 \u8DDF\u968F Location\n          if (status >= 300 && status < 400 && redirects < MAX_REDIRECTS) {\n            const loc = res.headers.location;\n            if (!loc) return reject(new Error(`HTTP ${status} \u4F46\u7F3A\u5C11 Location`));\n            const next = loc.startsWith(\"http\") ? loc : new URL(loc, url).href;\n            httpRequest(next, { ...opts, redirects: redirects + 1 })\n              .then(resolve)\n              .catch(reject);\n            return;\n          }\n          if (status >= 400) {\n            return reject(new Error(`HTTP ${status} for ${url}`));\n          }\n          resolve({ statusCode: status, body, headers: res.headers });\n        });\n      }\n    );\n\n    const totalTimer = setTimeout(() => {\n      req.destroy(new Error(`HTTP \u603B\u8D85\u65F6 ${totalTimeoutMs}ms: ${url}`));\n    }, totalTimeoutMs);\n    const connectTimer = setTimeout(() => {\n      req.destroy(new Error(`HTTP \u8FDE\u63A5\u8D85\u65F6 ${connectTimeoutMs}ms: ${url}`));\n    }, connectTimeoutMs);\n\n    req.on(\"socket\", () => clearTimeout(connectTimer));\n    req.on(\"error\", (err) => {\n      clearTimeout(totalTimer);\n      clearTimeout(connectTimer);\n      reject(err);\n    });\n\n    if (opts.body) req.write(opts.body);\n    req.end();\n  });\n}\n\n/**\n * \u53D1\u8D77 GET \u8BF7\u6C42\u5E76\u81EA\u52A8\u5C06\u54CD\u5E94\u4F53\u89E3\u6790\u4E3A JSON \u6570\u636E\u5BF9\u8C61\u3002\n *\n * @template T \u9884\u671F\u7684 JSON \u6570\u636E\u7C7B\u578B\u3002\n * @param url \u8BF7\u6C42\u76EE\u6807 URL\u3002\n * @param opts \u8BF7\u6C42\u914D\u7F6E\u9009\u9879\u3002\n * @returns \u89E3\u6790\u540E\u7684 JSON \u5BF9\u8C61\u3002\n */\nexport async function httpGetJson<T = unknown>(\n  url: string,\n  opts: HttpOptions = {}\n): Promise<T> {\n  const res = await httpRequest(url, opts);\n  try {\n    return JSON.parse(res.body.toString(\"utf-8\")) as T;\n  } catch (e) {\n    throw new Error(`JSON \u89E3\u6790\u5931\u8D25 ${url}: ${(e as Error).message}`);\n  }\n}\n\n/**\n * \u53D1\u8D77 GET \u8BF7\u6C42\u5E76\u83B7\u53D6 UTF-8 \u7EAF\u6587\u672C\u54CD\u5E94\u5185\u5BB9\u3002\n *\n * @param url \u8BF7\u6C42\u76EE\u6807 URL\u3002\n * @param opts \u8BF7\u6C42\u914D\u7F6E\u9009\u9879\u3002\n * @returns \u54CD\u5E94\u6587\u672C\u5B57\u7B26\u4E32\u3002\n */\nexport async function httpGetText(url: string, opts: HttpOptions = {}): Promise<string> {\n  const res = await httpRequest(url, opts);\n  return res.body.toString(\"utf-8\");\n}\n\n/**\n * \u9488\u5BF9\u591A\u4E2A\u5907\u9009\u6E90\u5E76\u53D1\u53D1\u8D77\u8BF7\u6C42\uFF0C\u7531\u6700\u5148\u6210\u529F\u8FD4\u56DE\u4E14\u5408\u6CD5\u89E3\u6790 JSON \u7684\u6E90\u63D0\u4F9B\u6570\u636E\uFF08Happy Eyeballs \u673A\u5236\uFF09\u3002\n *\n * @template T \u8FD4\u56DE\u7684 JSON \u6570\u636E\u7C7B\u578B\u3002\n * @param sources \u5019\u9009 URL \u5217\u8868\u3002\n * @param timeoutMs \u8D85\u65F6\u65F6\u95F4\uFF08\u6BEB\u79D2\uFF0C\u9ED8\u8BA4\u4E3A 15000\uFF09\u3002\n * @returns \u6700\u5148\u6210\u529F\u54CD\u5E94\u7684\u6570\u636E\u3002\n * @throws \u5F53\u6240\u6709\u5907\u9009\u6E90\u5747\u5931\u8D25\u65F6\u629B\u51FA\u805A\u5408\u9519\u8BEF\u3002\n */\nexport async function fetchJsonWithFallback<T = unknown>(\n  sources: string[],\n  timeoutMs = 15_000\n): Promise<T> {\n  const tasks = sources.map(async (url) => {\n    const res = await httpGetJson<T>(url, { totalTimeoutMs: timeoutMs });\n    return { url, value: res };\n  });\n  const settled = await Promise.allSettled(tasks);\n  for (const r of settled) {\n    if (r.status === \"fulfilled\") return r.value.value;\n  }\n  const errors = settled\n    .filter((r): r is PromiseRejectedResult => r.status === \"rejected\")\n    .map((r) => r.reason?.message ?? \"unknown\")\n    .join(\"; \");\n  throw new Error(`\u6240\u6709\u6E90\u5747\u4E0D\u53EF\u7528: ${errors}`);\n}\n\n/** \u4E0B\u8F7D\u914D\u7F6E\u9009\u9879\u3002 */\nexport interface DownloadOptions extends HttpOptions {\n  /** \u4E0B\u8F7D\u8FDB\u5EA6\u53D8\u5316\u56DE\u8C03\u51FD\u6570\u3002 */\n  onProgress?: (downloaded: number, total: number) => void;\n}\n\n/**\n * \u6D41\u5F0F\u4E0B\u8F7D\u7F51\u7EDC\u8D44\u6E90\u81F3\u672C\u5730\u6307\u5B9A\u8DEF\u5F84\u3002\n * - \u4F20\u8F93\u5931\u8D25\u65F6\u81EA\u52A8\u5220\u9664\u6B8B\u7559\u7684\u4E34\u65F6\u6587\u4EF6\u788E\u7247\n * - \u652F\u6301\u8282\u6D41\u7684\u8FDB\u5EA6\u901A\u77E5\u56DE\u8C03\n * - \u652F\u6301\u8FDE\u63A5\u5EFA\u7ACB\u4E0E\u5168\u91CF\u4F20\u8F93\u53CC\u9636\u6BB5\u72EC\u7ACB\u8D85\u65F6\n *\n * @param url \u4E0B\u8F7D\u76EE\u6807\u5730\u5740\u3002\n * @param destPath \u672C\u5730\u843D\u76D8\u76EE\u6807\u7EDD\u5BF9\u8DEF\u5F84\u3002\n * @param opts \u4E0B\u8F7D\u53C2\u6570\u9009\u9879\u3002\n * @returns \u6210\u529F\u4E0B\u8F7D\u7684\u603B\u5B57\u8282\u6570\u3002\n */\n\n\nexport async function httpDownload(\n  url: string,\n  destPath: string,\n  opts: DownloadOptions = {}\n): Promise<number> {\n  const totalTimeoutMs = opts.totalTimeoutMs ?? DEFAULT_TOTAL_TIMEOUT;\n  const connectTimeoutMs = opts.connectTimeoutMs ?? DEFAULT_CONNECT_TIMEOUT;\n\n  const u = new URL(url);\n  const isHttps = u.protocol === \"https:\";\n  const mod = isHttps ? https : http;\n  let redirects = opts.redirects ?? 0;\n\n  return new Promise((resolve, reject) => {\n    const req = mod.request(\n      {\n        hostname: u.hostname,\n        port: u.port || (isHttps ? 443 : 80),\n        path: u.pathname + u.search,\n        method: \"GET\",\n        headers: { \"User-Agent\": \"BDSUpdater/2.0\", ...(opts.headers ?? {}) },\n      },\n      (res) => {\n        const status = res.statusCode ?? 0;\n        if (status >= 300 && status < 400 && redirects < MAX_REDIRECTS) {\n          const loc = res.headers.location;\n          if (!loc) return reject(new Error(`HTTP ${status} \u7F3A\u5C11 Location`));\n          redirects++;\n          const next = loc.startsWith(\"http\") ? loc : new URL(loc, url).href;\n          res.resume();\n          httpDownload(next, destPath, { ...opts, redirects })\n            .then(resolve)\n            .catch(reject);\n          return;\n        }\n        if (status >= 400) return reject(new Error(`HTTP ${status} for ${url}`));\n\n        const total = parseInt(String(res.headers[\"content-length\"] ?? 0), 10) || 0;\n        const file = createWriteStream(destPath);\n        let downloaded = 0;\n        let failed = false;\n        // \u8282\u6D41\u8FDB\u5EA6\u56DE\u8C03:\u6BCF\u4E2A tick \u6700\u591A 10 \u6B21/\u79D2(100ms \u95F4\u9694),\n        // \u907F\u514D cli-progress \u9891\u7E41\u91CD\u7ED8\u62D6\u6162\u4E0B\u8F7D\n        let lastProgressAt = 0;\n        const PROGRESS_INTERVAL_MS = 100;\n\n        const handleError = (e: Error): void => {\n          if (failed) return;\n          failed = true;\n          file.close();\n          // \u6E05\u7406 partial \u6587\u4EF6\n          import(\"node:fs\").then((fs) => {\n            try { fs.unlinkSync(destPath); } catch {}\n          });\n          reject(e);\n        };\n\n        const stream: Readable = res;\n        stream.on(\"data\", (chunk: Buffer) => {\n          downloaded += chunk.length;\n          if (opts.onProgress) {\n            const now = Date.now();\n            if (now - lastProgressAt >= PROGRESS_INTERVAL_MS) {\n              lastProgressAt = now;\n              /* total=0\uFF08\u65E0 Content-Length\uFF09\u65F6\u4ECD\u56DE\u8C03\uFF0C\u8C03\u7528\u65B9\u53EF\u7528\u5DF2\u4E0B\u8F7D\u5B57\u8282\u66F4\u65B0 UI */\n              opts.onProgress(downloaded, total);\n            }\n          }\n        });\n        stream.on(\"error\", (e) => handleError(e as Error));\n\n        file.on(\"error\", (e) => handleError(e as Error));\n\n        pipeline(stream, file).catch((e) => {\n          if (!failed) handleError(e as Error);\n        });\n\n        // \u4E0D\u80FD\u76F4\u63A5\u76D1\u542C file 'finish' \u56E0\u4E3A\u6211\u4EEC\u5728\u9519\u8BEF\u65F6\u624B\u52A8 handleError\n        file.on(\"finish\", () => {\n          if (failed) return;\n          try {\n            const finalBytes = statSync(destPath).size;\n            // \u6536\u5C3E:\u786E\u4FDD\u6700\u540E\u4E00\u6B21\u56DE\u8C03\u8BA9\u8FDB\u5EA6\u6761\u8D70\u5230 100%(\u5373\u4FBF\u6700\u8FD1\n            // \u4E00\u4E2A tick \u7684\u8282\u6D41\u6CA1\u89E6\u53D1,\u4E5F\u8865\u4E00\u6B21)\u3002\n            // \u65E0 Content-Length\uFF08total=0\uFF09\u65F6\u7528 finalBytes \u4F5C\u603B\u91CF\uFF0C\u4E0E\u4E2D\u9014\u300C\u4ECD\u56DE\u8C03\u300D\u5951\u7EA6\u4E00\u81F4\uFF08LSP\uFF09\u3002\n            if (opts.onProgress) {\n              opts.onProgress(finalBytes, total > 0 ? total : finalBytes);\n            }\n            resolve(finalBytes);\n          } catch (e) {\n            reject(e as Error);\n          }\n        });\n      }\n    );\n\n    const totalTimer = setTimeout(() => {\n      req.destroy(new Error(`\u4E0B\u8F7D\u603B\u8D85\u65F6 ${totalTimeoutMs}ms: ${url}`));\n    }, totalTimeoutMs);\n    const connectTimer = setTimeout(() => {\n      req.destroy(new Error(`\u4E0B\u8F7D\u8FDE\u63A5\u8D85\u65F6 ${connectTimeoutMs}ms: ${url}`));\n    }, connectTimeoutMs);\n\n    req.on(\"socket\", () => clearTimeout(connectTimer));\n    req.on(\"error\", (e) => {\n      clearTimeout(totalTimer);\n      clearTimeout(connectTimer);\n      log.warn(`HTTP \u9519\u8BEF ${url}: ${(e as Error).message}`);\n      reject(e);\n    });\n    req.end();\n  });\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/level-dat.d.ts

@@ -0,0 +1,105 @@
+/**
+ * level-dat.ts — Minecraft 基岩版世界存档 level.dat 小端序 NBT 解析与实验性玩法安全修改器
+ *
+ * 基岩版 level.dat 规范：
+ * - Header（8 字节）：
+ *   - [0..3] uint32 LE：存储格式版本（当前版本通常为 10）
+ *   - [4..7] uint32 LE：有效 NBT 数据字节长度（data_length）
+ * - Payload：未压缩的小端序（Little-Endian）标准 NBT 复合标签（TAG_Compound）
+ *
+ * 核心能力：
+ * - 原生无外部黑盒依赖，Buffer 级解析与精确字节位移
+ * - 读取世界实验性玩法的开启状态（特别是 Beta APIs / gametest）
+ * - 安全注入或切换实验性开关并自动备份原文件（.bak）与校准 Header data_length
+ */
+export declare const TAG_END = 0;
+export declare const TAG_BYTE = 1;
+export declare const TAG_SHORT = 2;
+export declare const TAG_INT = 3;
+export declare const TAG_LONG = 4;
+export declare const TAG_FLOAT = 5;
+export declare const TAG_DOUBLE = 6;
+export declare const TAG_BYTE_ARRAY = 7;
+export declare const TAG_STRING = 8;
+export declare const TAG_LIST = 9;
+export declare const TAG_COMPOUND = 10;
+export declare const TAG_INT_ARRAY = 11;
+export declare const TAG_LONG_ARRAY = 12;
+export interface NbtTagMeta {
+    type: number;
+    name: string;
+    startOffset: number;
+    nameOffset: number;
+    valueOffset: number;
+    endOffset: number;
+    value?: unknown;
+}
+export interface KnownExperimentDefinition {
+    id: string;
+    nbtKey: string;
+    nameZh: string;
+    nameEn: string;
+    aliases?: string[];
+    isRootTag?: boolean;
+    extraExpTags?: string[];
+}
+export declare const KNOWN_EXPERIMENTS: readonly KnownExperimentDefinition[];
+export declare function resolveExperimentDefinition(query: string): KnownExperimentDefinition | null;
+export interface LevelDatExperimentsInfo {
+    experimentsEverUsed: boolean;
+    savedWithToggledExperiments: boolean;
+    experiments: Record<string, number | boolean>;
+    hasBetaApis: boolean;
+    knownExperiments: Record<string, boolean>;
+}
+export interface LevelDatMutateResult {
+    success: boolean;
+    changed: boolean;
+    backupPath?: string;
+    error?: string;
+    previousBetaApisState?: boolean;
+    enabledExperiments?: string[];
+}
+/**
+ * 遍历并跳过指定类型的 NBT 载荷，返回下一个 tag 的 offset。
+ */
+export declare function skipNbtPayload(buf: Buffer, offset: number, type: number): number;
+/**
+ * 解析复合标签内部所有直接子标签的元数据映射。
+ */
+export declare function parseCompoundChildren(buf: Buffer, compoundValueOffset: number): {
+    children: Map<string, NbtTagMeta>;
+    compoundEndOffset: number;
+};
+/**
+ * 解析基岩版 level.dat 的完整文件结构并定位根 Compound。
+ */
+export declare function parseBedrockLevelDat(buf: Buffer): {
+    version: number;
+    dataLength: number;
+    rootCompoundName: string;
+    rootChildren: Map<string, NbtTagMeta>;
+    rootEndOffset: number;
+};
+/**
+ * 读取世界存档 level.dat 的实验性配置。若解析失败或文件不存在返回 null。
+ */
+export declare function readLevelDatExperiments(levelDatPath: string): LevelDatExperimentsInfo | null;
+/**
+ * 为指定 level.dat 开启指定的实验性开关（若未指定或传 "all" 则开启全部已知实验性开关）。
+ *
+ * 保证：
+ * - 自动备份原文件至 `${levelDatPath}.bak`；
+ * - 自动更新 root 与 experiments 复合标签中的目标 byte tags；
+ * - 自动更新 experiments_ever_used = 1b 与 saved_with_toggled_experiments = 1b；
+ * - 精确校准 8 字节文件头部的 dataLength；
+ * - 原子写操作（.tmp -> rename）；
+ * - 若所请求开关已全部处于开启状态，直接返回 changed: false，不破坏文件。
+ */
+export declare function enableExperimentsInLevelDat(levelDatPath: string, targetExperimentIds?: string[] | "all"): Promise<LevelDatMutateResult>;
+/**
+ * 为指定 level.dat 开启 Beta APIs（gametest）。
+ * 保持向后兼容，委托给 enableExperimentsInLevelDat。
+ */
+export declare function enableBetaApisInLevelDat(levelDatPath: string): Promise<LevelDatMutateResult>;
+//# sourceMappingURL=level-dat.d.ts.map

package/dist/level-dat.d.ts.map

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

package/dist/level-dat.js

@@ -0,0 +1,490 @@
+import fs from "node:fs";
+const TAG_END = 0;
+const TAG_BYTE = 1;
+const TAG_SHORT = 2;
+const TAG_INT = 3;
+const TAG_LONG = 4;
+const TAG_FLOAT = 5;
+const TAG_DOUBLE = 6;
+const TAG_BYTE_ARRAY = 7;
+const TAG_STRING = 8;
+const TAG_LIST = 9;
+const TAG_COMPOUND = 10;
+const TAG_INT_ARRAY = 11;
+const TAG_LONG_ARRAY = 12;
+const KNOWN_EXPERIMENTS = [
+  {
+    id: "gametest",
+    nbtKey: "gametest",
+    nameZh: "\u6D4B\u8BD5\u7248 API",
+    nameEn: "Beta APIs (gametest)",
+    aliases: ["beta", "beta_apis", "betapis", "gametest"]
+  },
+  {
+    id: "upcoming_creator_features",
+    nbtKey: "upcoming_creator_features",
+    nameZh: "\u5373\u5C06\u63A8\u51FA\u7684\u521B\u4F5C\u8005\u529F\u80FD",
+    nameEn: "Upcoming Creator Features",
+    aliases: ["upcoming", "creator_features", "upcoming_features"]
+  },
+  {
+    id: "experimental_creator_cameras",
+    nbtKey: "experimental_creator_cameras",
+    nameZh: "\u521B\u5EFA\u8005\u7167\u76F8\u673A\u7684\u5B9E\u9A8C\u6027\u529F\u80FD",
+    nameEn: "Experimental Creator Cameras",
+    aliases: ["camera", "cameras", "creator_cameras", "creator_camera"]
+  },
+  {
+    id: "voxel_shapes",
+    nbtKey: "voxel_shapes",
+    nameZh: "\u5B9E\u9A8C\u6027Voxel\u5F62\u72B6\u7279\u5F81",
+    nameEn: "Experimental Voxel Shapes",
+    aliases: ["voxel", "voxel_shape", "experimental_voxel_shapes", "voxelshapes"]
+  },
+  {
+    id: "villager_trades_rebalance",
+    nbtKey: "villager_trades_rebalance",
+    nameZh: "\u6751\u6C11\u8D38\u6613\u518D\u5E73\u8861",
+    nameEn: "Villager Trade Rebalance",
+    aliases: ["villager", "trades", "villager_trades", "trade_rebalance"]
+  },
+  {
+    id: "drop_3_2026",
+    nbtKey: "drop_3_2026",
+    nameZh: "2026\u5E74\u7B2C3\u6B21\u66F4\u65B0",
+    nameEn: "Drop 3 of 2026",
+    aliases: [
+      "drop3",
+      "drop_3",
+      "drop_3_2026",
+      "wilderness",
+      "wilderness_bound",
+      "update_2026_drop_3",
+      "update_26_3",
+      "update_drop_3"
+    ],
+    extraExpTags: ["update_2026_drop_3"]
+  },
+  {
+    id: "education",
+    nbtKey: "educationFeaturesEnabled",
+    nameZh: "Minecraft Education \u529F\u80FD",
+    nameEn: "Minecraft Education Features",
+    isRootTag: true,
+    aliases: ["edu", "education", "education_edition", "educationfeatures"],
+    extraExpTags: ["education"]
+  }
+];
+function resolveExperimentDefinition(query) {
+  const q = query.trim().toLowerCase().replace(/[-_]/g, "");
+  for (const def of KNOWN_EXPERIMENTS) {
+    if (def.id.replace(/[-_]/g, "") === q) return def;
+    if (def.nbtKey.replace(/[-_]/g, "") === q) return def;
+    if (def.aliases) {
+      for (const a of def.aliases) {
+        if (a.replace(/[-_]/g, "") === q) return def;
+      }
+    }
+  }
+  return null;
+}
+function skipNbtPayload(buf, offset, type) {
+  switch (type) {
+    case TAG_BYTE:
+      return offset + 1;
+    case TAG_SHORT:
+      return offset + 2;
+    case TAG_INT:
+    case TAG_FLOAT:
+      return offset + 4;
+    case TAG_LONG:
+    case TAG_DOUBLE:
+      return offset + 8;
+    case TAG_BYTE_ARRAY: {
+      if (offset + 4 > buf.length) throw new Error("Unexpected EOF reading TAG_Byte_Array length");
+      const len = buf.readInt32LE(offset);
+      return offset + 4 + Math.max(0, len);
+    }
+    case TAG_STRING: {
+      if (offset + 2 > buf.length) throw new Error("Unexpected EOF reading TAG_String length");
+      const len = buf.readUInt16LE(offset);
+      return offset + 2 + len;
+    }
+    case TAG_LIST: {
+      if (offset + 5 > buf.length) throw new Error("Unexpected EOF reading TAG_List header");
+      const elemType = buf.readUInt8(offset);
+      const count = buf.readInt32LE(offset + 1);
+      let cur = offset + 5;
+      for (let i = 0; i < count; i++) {
+        cur = skipNbtPayload(buf, cur, elemType);
+      }
+      return cur;
+    }
+    case TAG_COMPOUND: {
+      let cur = offset;
+      while (cur < buf.length) {
+        const t = buf.readUInt8(cur);
+        if (t === TAG_END) {
+          return cur + 1;
+        }
+        if (cur + 3 > buf.length) throw new Error("Unexpected EOF reading compound child header");
+        const nameLen = buf.readUInt16LE(cur + 1);
+        const childValOffset = cur + 3 + nameLen;
+        cur = skipNbtPayload(buf, childValOffset, t);
+      }
+      return cur;
+    }
+    case TAG_INT_ARRAY: {
+      if (offset + 4 > buf.length) throw new Error("Unexpected EOF reading TAG_Int_Array length");
+      const len = buf.readInt32LE(offset);
+      return offset + 4 + Math.max(0, len) * 4;
+    }
+    case TAG_LONG_ARRAY: {
+      if (offset + 4 > buf.length) throw new Error("Unexpected EOF reading TAG_Long_Array length");
+      const len = buf.readInt32LE(offset);
+      return offset + 4 + Math.max(0, len) * 8;
+    }
+    default:
+      throw new Error(`Unsupported or unknown NBT tag type: ${type} at offset ${offset}`);
+  }
+}
+function parseCompoundChildren(buf, compoundValueOffset) {
+  const children = /* @__PURE__ */ new Map();
+  let cur = compoundValueOffset;
+  while (cur < buf.length) {
+    const tagType = buf.readUInt8(cur);
+    if (tagType === TAG_END) {
+      return { children, compoundEndOffset: cur + 1 };
+    }
+    if (cur + 3 > buf.length) {
+      throw new Error(`Unexpected EOF reading named tag header at offset ${cur}`);
+    }
+    const nameLen = buf.readUInt16LE(cur + 1);
+    const nameOffset = cur + 3;
+    if (nameOffset + nameLen > buf.length) {
+      throw new Error(`Unexpected EOF reading tag name at offset ${cur}`);
+    }
+    const name = buf.toString("utf8", nameOffset, nameOffset + nameLen);
+    const valOffset = nameOffset + nameLen;
+    const endOffset = skipNbtPayload(buf, valOffset, tagType);
+    let val = void 0;
+    if (tagType === TAG_BYTE) {
+      val = buf.readInt8(valOffset);
+    } else if (tagType === TAG_INT) {
+      val = buf.readInt32LE(valOffset);
+    } else if (tagType === TAG_STRING) {
+      const sLen = buf.readUInt16LE(valOffset);
+      val = buf.toString("utf8", valOffset + 2, valOffset + 2 + sLen);
+    }
+    children.set(name, {
+      type: tagType,
+      name,
+      startOffset: cur,
+      nameOffset,
+      valueOffset: valOffset,
+      endOffset,
+      value: val
+    });
+    cur = endOffset;
+  }
+  return { children, compoundEndOffset: cur };
+}
+function parseBedrockLevelDat(buf) {
+  if (buf.length < 8) {
+    throw new Error("Invalid level.dat: buffer smaller than 8-byte header");
+  }
+  const version = buf.readUInt32LE(0);
+  const dataLength = buf.readUInt32LE(4);
+  if (buf.length < 9 || buf.readUInt8(8) !== TAG_COMPOUND) {
+    throw new Error("Invalid level.dat: root tag is not TAG_Compound");
+  }
+  const rootNameLen = buf.readUInt16LE(9);
+  const rootCompoundName = buf.toString("utf8", 11, 11 + rootNameLen);
+  const rootValueOffset = 11 + rootNameLen;
+  const { children: rootChildren, compoundEndOffset: rootEndOffset } = parseCompoundChildren(buf, rootValueOffset);
+  return {
+    version,
+    dataLength,
+    rootCompoundName,
+    rootChildren,
+    rootEndOffset
+  };
+}
+function readLevelDatExperiments(levelDatPath) {
+  if (!fs.existsSync(levelDatPath)) return null;
+  try {
+    const buf = fs.readFileSync(levelDatPath);
+    const parsed = parseBedrockLevelDat(buf);
+    let experimentsEverUsed = false;
+    const everUsedTag = parsed.rootChildren.get("experiments_ever_used");
+    if (everUsedTag && everUsedTag.type === TAG_BYTE && Number(everUsedTag.value) === 1) {
+      experimentsEverUsed = true;
+    }
+    let savedWithToggledExperiments = false;
+    const savedTag = parsed.rootChildren.get("saved_with_toggled_experiments");
+    if (savedTag && savedTag.type === TAG_BYTE && Number(savedTag.value) === 1) {
+      savedWithToggledExperiments = true;
+    }
+    const experiments = {};
+    let hasBetaApis = false;
+    const expCompoundTag = parsed.rootChildren.get("experiments");
+    if (expCompoundTag && expCompoundTag.type === TAG_COMPOUND) {
+      const expChildren = parseCompoundChildren(buf, expCompoundTag.valueOffset).children;
+      const innerEverUsed = expChildren.get("experiments_ever_used");
+      if (innerEverUsed && Number(innerEverUsed.value) === 1) {
+        experimentsEverUsed = true;
+      }
+      const innerSaved = expChildren.get("saved_with_toggled_experiments");
+      if (innerSaved && Number(innerSaved.value) === 1) {
+        savedWithToggledExperiments = true;
+      }
+      for (const [name, meta] of expChildren.entries()) {
+        if (meta.type === TAG_BYTE) {
+          const num = Number(meta.value);
+          experiments[name] = num;
+          if (name === "gametest" && num === 1) {
+            hasBetaApis = true;
+          }
+        }
+      }
+    }
+    const knownExperiments = {};
+    for (const def of KNOWN_EXPERIMENTS) {
+      let enabled = false;
+      if (def.isRootTag) {
+        const rootTag = parsed.rootChildren.get(def.nbtKey);
+        if (rootTag && Number(rootTag.value) === 1) {
+          enabled = true;
+        }
+      }
+      const keysToCheck = [def.nbtKey, ...def.aliases ?? []];
+      for (const k of keysToCheck) {
+        if (experiments[k] === 1) {
+          enabled = true;
+          break;
+        }
+      }
+      knownExperiments[def.id] = enabled;
+    }
+    return {
+      experimentsEverUsed,
+      savedWithToggledExperiments,
+      experiments,
+      hasBetaApis,
+      knownExperiments
+    };
+  } catch {
+    return null;
+  }
+}
+function createByteTagBuffer(name, value) {
+  const nameBuf = Buffer.from(name, "utf8");
+  const buf = Buffer.alloc(1 + 2 + nameBuf.length + 1);
+  buf.writeUInt8(TAG_BYTE, 0);
+  buf.writeUInt16LE(nameBuf.length, 1);
+  nameBuf.copy(buf, 3);
+  buf.writeInt8(value, 3 + nameBuf.length);
+  return buf;
+}
+function createCompoundTagBuffer(name, byteTags) {
+  const nameBuf = Buffer.from(name, "utf8");
+  const childBuffers = [];
+  for (const [k, v] of Object.entries(byteTags)) {
+    childBuffers.push(createByteTagBuffer(k, v));
+  }
+  childBuffers.push(Buffer.from([TAG_END]));
+  const header = Buffer.alloc(1 + 2 + nameBuf.length);
+  header.writeUInt8(TAG_COMPOUND, 0);
+  header.writeUInt16LE(nameBuf.length, 1);
+  nameBuf.copy(header, 3);
+  return Buffer.concat([header, ...childBuffers]);
+}
+async function enableExperimentsInLevelDat(levelDatPath, targetExperimentIds) {
+  if (!fs.existsSync(levelDatPath)) {
+    return { success: false, changed: false, error: `File not found: ${levelDatPath}` };
+  }
+  try {
+    const raw = await fs.promises.readFile(levelDatPath);
+    const parsed = parseBedrockLevelDat(raw);
+    let targetDefs = [];
+    if (!targetExperimentIds || targetExperimentIds === "all") {
+      targetDefs = [...KNOWN_EXPERIMENTS];
+    } else {
+      const seen = /* @__PURE__ */ new Set();
+      for (const id of targetExperimentIds) {
+        const def = resolveExperimentDefinition(id);
+        if (def && !seen.has(def.id)) {
+          seen.add(def.id);
+          targetDefs.push(def);
+        }
+      }
+      if (targetDefs.length === 0) {
+        return { success: true, changed: false, enabledExperiments: [] };
+      }
+    }
+    const expCompoundTag = parsed.rootChildren.get("experiments");
+    const existingExpChildren = expCompoundTag && expCompoundTag.type === TAG_COMPOUND ? parseCompoundChildren(raw, expCompoundTag.valueOffset).children : /* @__PURE__ */ new Map();
+    let needsChange = false;
+    const enabledIds = [];
+    if (!expCompoundTag) {
+      needsChange = true;
+    } else {
+      const expEverUsed = existingExpChildren.get("experiments_ever_used");
+      if (!expEverUsed || Number(expEverUsed.value) !== 1) needsChange = true;
+      const expSaved = existingExpChildren.get("saved_with_toggled_experiments");
+      if (!expSaved || Number(expSaved.value) !== 1) needsChange = true;
+    }
+    const rootEverUsed = parsed.rootChildren.get("experiments_ever_used");
+    if (rootEverUsed && Number(rootEverUsed.value) !== 1) needsChange = true;
+    const rootSaved = parsed.rootChildren.get("saved_with_toggled_experiments");
+    if (rootSaved && Number(rootSaved.value) !== 1) needsChange = true;
+    let previousBetaApisState = false;
+    const currentGametest = existingExpChildren.get("gametest");
+    if (currentGametest && Number(currentGametest.value) === 1) {
+      previousBetaApisState = true;
+    }
+    for (const def of targetDefs) {
+      enabledIds.push(def.id);
+      if (def.isRootTag) {
+        const rootTag = parsed.rootChildren.get(def.nbtKey);
+        if (!rootTag || Number(rootTag.value) !== 1) {
+          needsChange = true;
+        }
+      }
+      if (!def.isRootTag) {
+        const tag = existingExpChildren.get(def.nbtKey);
+        if (!tag || Number(tag.value) !== 1) {
+          needsChange = true;
+        }
+      }
+      if (def.extraExpTags) {
+        for (const extra of def.extraExpTags) {
+          const tag = existingExpChildren.get(extra);
+          if (!tag || Number(tag.value) !== 1) {
+            needsChange = true;
+          }
+        }
+      }
+    }
+    if (!needsChange) {
+      return {
+        success: true,
+        changed: false,
+        previousBetaApisState,
+        enabledExperiments: enabledIds
+      };
+    }
+    const backupPath = `${levelDatPath}.bak`;
+    await fs.promises.copyFile(levelDatPath, backupPath);
+    let mutatedRaw = Buffer.from(raw);
+    let nbtBody;
+    const requiredExpTags = {
+      experiments_ever_used: 1,
+      saved_with_toggled_experiments: 1
+    };
+    for (const def of targetDefs) {
+      if (!def.isRootTag) {
+        requiredExpTags[def.nbtKey] = 1;
+      }
+      if (def.extraExpTags) {
+        for (const extra of def.extraExpTags) {
+          requiredExpTags[extra] = 1;
+        }
+      }
+    }
+    const rootNeedsEducation = targetDefs.some((d) => d.id === "education");
+    if (rootEverUsed) {
+      mutatedRaw.writeInt8(1, rootEverUsed.valueOffset);
+    }
+    if (rootSaved) {
+      mutatedRaw.writeInt8(1, rootSaved.valueOffset);
+    }
+    if (rootNeedsEducation) {
+      const eduTag = parsed.rootChildren.get("educationFeaturesEnabled");
+      if (eduTag) {
+        mutatedRaw.writeInt8(1, eduTag.valueOffset);
+      }
+      const optOut = parsed.rootChildren.get("has_opted_out_of_education");
+      if (optOut) {
+        mutatedRaw.writeInt8(0, optOut.valueOffset);
+      }
+    }
+    const rootTagsToAppend = [];
+    if (rootNeedsEducation && !parsed.rootChildren.has("educationFeaturesEnabled")) {
+      rootTagsToAppend.push(createByteTagBuffer("educationFeaturesEnabled", 1));
+    }
+    if (!expCompoundTag) {
+      const newExpCompoundBuf = createCompoundTagBuffer("experiments", requiredExpTags);
+      const rootEndTagIndex = parsed.rootEndOffset - 1;
+      const beforeEnd = mutatedRaw.subarray(8, rootEndTagIndex);
+      const afterEnd = mutatedRaw.subarray(rootEndTagIndex);
+      nbtBody = Buffer.concat([beforeEnd, ...rootTagsToAppend, newExpCompoundBuf, afterEnd]);
+    } else {
+      const { compoundEndOffset: expEndOffset } = parseCompoundChildren(raw, expCompoundTag.valueOffset);
+      const expEndTagIndex = expEndOffset - 1;
+      const rootEndTagIndex = parsed.rootEndOffset - 1;
+      const expTagsToAppend = [];
+      for (const [name, val] of Object.entries(requiredExpTags)) {
+        const existing = existingExpChildren.get(name);
+        if (existing) {
+          mutatedRaw.writeInt8(val, existing.valueOffset);
+        } else {
+          expTagsToAppend.push(createByteTagBuffer(name, val));
+        }
+      }
+      const part1 = mutatedRaw.subarray(8, expEndTagIndex);
+      const part2 = Buffer.concat(expTagsToAppend);
+      const part3 = mutatedRaw.subarray(expEndTagIndex, rootEndTagIndex);
+      const part4 = Buffer.concat(rootTagsToAppend);
+      const part5 = mutatedRaw.subarray(rootEndTagIndex);
+      nbtBody = Buffer.concat([part1, part2, part3, part4, part5]);
+    }
+    const newHeader = Buffer.alloc(8);
+    newHeader.writeUInt32LE(parsed.version, 0);
+    newHeader.writeUInt32LE(nbtBody.length, 4);
+    const finalFileBuffer = Buffer.concat([newHeader, nbtBody]);
+    const tmpFile = `${levelDatPath}.${process.pid}.tmp`;
+    await fs.promises.writeFile(tmpFile, finalFileBuffer);
+    await fs.promises.rename(tmpFile, levelDatPath);
+    return {
+      success: true,
+      changed: true,
+      backupPath,
+      previousBetaApisState,
+      enabledExperiments: enabledIds
+    };
+  } catch (err) {
+    return {
+      success: false,
+      changed: false,
+      error: err instanceof Error ? err.message : String(err)
+    };
+  }
+}
+async function enableBetaApisInLevelDat(levelDatPath) {
+  return await enableExperimentsInLevelDat(levelDatPath, ["gametest"]);
+}
+export {
+  KNOWN_EXPERIMENTS,
+  TAG_BYTE,
+  TAG_BYTE_ARRAY,
+  TAG_COMPOUND,
+  TAG_DOUBLE,
+  TAG_END,
+  TAG_FLOAT,
+  TAG_INT,
+  TAG_INT_ARRAY,
+  TAG_LIST,
+  TAG_LONG,
+  TAG_LONG_ARRAY,
+  TAG_SHORT,
+  TAG_STRING,
+  enableBetaApisInLevelDat,
+  enableExperimentsInLevelDat,
+  parseBedrockLevelDat,
+  parseCompoundChildren,
+  readLevelDatExperiments,
+  resolveExperimentDefinition,
+  skipNbtPayload
+};
+//# sourceMappingURL=level-dat.js.map