nitro-patcher 0.2.0 → 0.3.0

package/dist/cli.js

@@ -2,25 +2,29 @@
 import {
   patchBuffer,
   readPatchInfo
-} from "./chunk-ZY3OSZCA.js";
-import "./chunk-GFF67HX4.js";
+} from "./chunk-IGURDH5L.js";
+import {
+  NDSFile
+} from "./chunk-GLK3K2HY.js";
 
 // src/cli.ts
-import { mkdtemp, readFile, realpath, rename, rm, stat, writeFile } from "fs/promises";
-import { basename, dirname, join, resolve } from "path";
-import { parseArgs } from "util";
 import { render } from "markdansi";
-var help = `nitro-patcher \u2014 \u539F\u751F Node.js NDS ROM \u8865\u4E01\u5DE5\u5177
+import { mkdir, mkdtemp, readFile, realpath, rename, rm, stat, writeFile } from "fs/promises";
+import { basename, dirname, join, resolve, sep } from "path";
+import { parseArgs } from "util";
+var help = `nitro-patcher \u2014 NDS ROM \u8865\u4E01\u5DE5\u5177
 
 \u7528\u6CD5\uFF1A
   nitro-patcher [--json] [--dry-run] <\u539F\u59CBROM> <\u8865\u4E01ZIP> [\u8F93\u51FAROM]
-  nitro-patcher [--json] [--dry-run] --input <\u539F\u59CBROM> --patch <\u8865\u4E01ZIP> [--output <\u8F93\u51FAROM>]
+  nitro-patcher patch [--json] [--dry-run] --input <\u539F\u59CBROM> --patch <\u8865\u4E01ZIP> [--output <\u8F93\u51FAROM>]
+  nitro-patcher extract [--json] --input <ROM> --output <\u76EE\u5F55>
+  nitro-patcher inspect [--json] --input <ROM>
 
-  --json         \u8F93\u51FA JSON \u72B6\u6001\u548C MD5
+  --json         \u7ED3\u679C\u8F93\u51FA\u4E3A JSON \u683C\u5F0F
   --dry-run      \u5B8C\u6574\u6267\u884C\u8865\u4E01\u6D41\u7A0B\uFF0C\u4F46\u4E0D\u5199\u5165\u8F93\u51FA ROM
-  -i, --input    \u539F\u59CB ROM \u8DEF\u5F84
+  -i, --input    \u8F93\u5165 ROM \u8DEF\u5F84
   -p, --patch    \u8865\u4E01 ZIP \u8DEF\u5F84
-  -o, --output   \u8F93\u51FA ROM \u8DEF\u5F84\uFF1B\u8BD5\u8FD0\u884C\u65F6\u53EF\u7701\u7565
+  -o, --output   \u8F93\u51FA ROM \u6216\u63D0\u53D6\u76EE\u5F55\uFF1B\u8BD5\u8FD0\u884C\u65F6\u53EF\u7701\u7565
   -h, --help     \u663E\u793A\u5E2E\u52A9
   -v, --version  \u663E\u793A\u7248\u672C`;
 var sameFile = async (input, output) => {
@@ -60,6 +64,63 @@ var formatMetadata = (metadata) => {
   }
   return lines.join("\n");
 };
+var extractRom = async (options) => {
+  if (!options.input || !options.output || options.patch !== void 0 || options.dryRun) throw new Error(help);
+  const destination = join(await realpath(dirname(resolve(options.output))), basename(resolve(options.output)));
+  const rom = new NDSFile(await readFile(options.input));
+  const files = rom.listFiles();
+  await mkdir(destination, { recursive: true });
+  for (const { path } of files) {
+    const output = resolve(destination, path);
+    if (!output.startsWith(`${destination}${sep}`)) throw new Error(`ROM \u6587\u4EF6\u8DEF\u5F84\u8D85\u51FA\u8F93\u51FA\u76EE\u5F55\uFF1A${path}`);
+    await mkdir(dirname(output), { recursive: true });
+    await writeFile(output, rom.getFile(path));
+  }
+  if (options.json) {
+    console.log(
+      JSON.stringify({
+        output: destination,
+        fileCount: files.length,
+        files: files.map(({ path }) => path)
+      })
+    );
+  } else {
+    console.log(`\u5DF2\u63D0\u53D6 ${files.length} \u4E2A\u6587\u4EF6\u5230\uFF1A${destination}`);
+  }
+};
+var inspectRom = async (options) => {
+  if (!options.input || options.patch !== void 0 || options.output !== void 0 || options.dryRun)
+    throw new Error(help);
+  const input = await readFile(options.input);
+  const rom = new NDSFile(input);
+  const info = {
+    gameTitle: rom.header.gameTitle.replace(/\0+$/, ""),
+    gameCode: rom.header.gameCode,
+    size: input.length,
+    fileCount: rom.listFiles().length,
+    checksums: {
+      header: rom.header.headerCRC,
+      logo: rom.header.logoCRC,
+      secureArea: rom.header.secureCRC,
+      banner: rom.banner.bannerCRC
+    }
+  };
+  if (options.json) {
+    console.log(JSON.stringify(info));
+    return;
+  }
+  console.log(`ROM \u4FE1\u606F\uFF1A
+
+\u6807\u9898\uFF1A${safeTerminalText(info.gameTitle).replaceAll("\n", " ")}
+\u6E38\u620F\u4EE3\u7801\uFF1A${safeTerminalText(info.gameCode).replaceAll("\n", " ")}
+\u5927\u5C0F\uFF1A${info.size} \u5B57\u8282
+\u6587\u4EF6\u6570\u91CF\uFF1A${info.fileCount}
+\u6821\u9A8C\uFF1A
+- Header\uFF1A${info.checksums.header ? "\u901A\u8FC7" : "\u5931\u8D25"}
+- Logo\uFF1A${info.checksums.logo ? "\u901A\u8FC7" : "\u5931\u8D25"}
+- Secure Area\uFF1A${info.checksums.secureArea ? "\u901A\u8FC7" : "\u5931\u8D25"}
+- Banner\uFF1A${info.checksums.banner ? "\u901A\u8FC7" : "\u5931\u8D25"}`);
+};
 var main = async () => {
   const { values, positionals } = parseArgs({
     allowPositionals: true,
@@ -78,20 +139,37 @@ var main = async () => {
     return;
   }
   if (values.version) {
-    const metadata = JSON.parse(
-      await readFile(new URL("../package.json", import.meta.url), "utf8")
-    );
+    const metadata = JSON.parse(await readFile(new URL("../package.json", import.meta.url), "utf8"));
     if (!metadata || typeof metadata !== "object" || !("version" in metadata) || typeof metadata.version !== "string")
       throw new Error("Invalid package version metadata");
     console.log(metadata.version);
     return;
   }
-  const dryRun = values["dry-run"] ?? false;
-  const usesNamedPaths = values.input !== void 0 || values.patch !== void 0 || values.output !== void 0;
-  if (usesNamedPaths && positionals.length > 0) throw new Error(help);
-  if (usesNamedPaths && (!values.input || !values.patch || !dryRun && !values.output) || !usesNamedPaths && (!dryRun && positionals.length !== 3 || dryRun && (positionals.length < 2 || positionals.length > 3)))
+  const options = {
+    json: values.json ?? false,
+    dryRun: values["dry-run"] ?? false,
+    input: values.input,
+    patch: values.patch,
+    output: values.output
+  };
+  const command = positionals.length === 1 ? positionals[0] : void 0;
+  if (positionals.length !== 0 && positionals.length !== 1 && positionals.length !== 3) throw new Error(help);
+  if (command !== void 0 && command !== "patch" && command !== "extract" && command !== "inspect")
+    throw new Error(help);
+  if (command === "extract") {
+    await extractRom(options);
+    return;
+  }
+  if (command === "inspect") {
+    await inspectRom(options);
+    return;
+  }
+  const dryRun = options.dryRun;
+  const usesLegacyPaths = positionals.length === 3;
+  if (usesLegacyPaths && (values.input !== void 0 || values.patch !== void 0 || values.output !== void 0))
     throw new Error(help);
-  const [original, patch, output] = usesNamedPaths ? [values.input, values.patch, values.output] : positionals;
+  if (!usesLegacyPaths && (!values.input || !values.patch || !dryRun && !values.output)) throw new Error(help);
+  const [original, patch, output] = usesLegacyPaths ? positionals : [values.input, values.patch, values.output];
   if (!original || !patch) throw new Error(help);
   if (!dryRun) {
     if (!output) throw new Error(help);
@@ -114,7 +192,7 @@ var main = async () => {
     }
   }
   const { returnValue, inputMd5, outputMd5 } = result;
-  if (values.json) {
+  if (options.json) {
     console.log(
       JSON.stringify({
         returnValue,
@@ -129,7 +207,7 @@ var main = async () => {
   const sections = [];
   if (info.metadata) {
     const metadata = formatMetadata(info.metadata);
-    if (metadata) sections.push(`\u8865\u4E01\u5143\u6570\u636E\uFF1A
+    if (metadata) sections.push(`\u8865\u4E01\u4FE1\u606F\uFF1A
 
 ${metadata}`);
   }
@@ -142,7 +220,7 @@ ${metadata}`);
     }) : content;
     sections.push(`\u8865\u4E01\u8BF4\u660E\uFF1A
 
-${rendered.trimEnd()}`);
+${rendered.trim()}`);
   }
   if (dryRun) sections.push("\u8BD5\u8FD0\u884C\u5B8C\u6210\uFF0C\u672A\u5199\u5165\u8F93\u51FA ROM\u3002");
   sections.push(`${returnValue}

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { mkdtemp, readFile, realpath, rename, rm, stat, writeFile } from 'node:fs/promises';\nimport { basename, dirname, join, resolve } from 'node:path';\nimport { parseArgs } from 'node:util';\nimport { render } from 'markdansi';\nimport { patchBuffer, readPatchInfo, type PatchMetadata } from './nitro-patch-helper';\n\nconst help = `nitro-patcher — 原生 Node.js NDS ROM 补丁工具\n\n用法：\n  nitro-patcher [--json] [--dry-run] <原始ROM> <补丁ZIP> [输出ROM]\n  nitro-patcher [--json] [--dry-run] --input <原始ROM> --patch <补丁ZIP> [--output <输出ROM>]\n\n  --json         输出 JSON 状态和 MD5\n  --dry-run      完整执行补丁流程，但不写入输出 ROM\n  -i, --input    原始 ROM 路径\n  -p, --patch    补丁 ZIP 路径\n  -o, --output   输出 ROM 路径；试运行时可省略\n  -h, --help     显示帮助\n  -v, --version  显示版本`;\n\nconst sameFile = async (input: string, output: string): Promise<boolean> => {\n  if (resolve(input) === resolve(output)) return true;\n  const original = await stat(input);\n  try {\n    const destination = await stat(output);\n    return original.dev === destination.dev && original.ino === destination.ino;\n  } catch (error) {\n    if (!(error instanceof Error && 'code' in error && error.code === 'ENOENT')) throw error;\n    return false;\n  }\n};\n\nconst safeTerminalText = (value: string): string => {\n  const characters: string[] = [];\n  for (const character of value.replaceAll('\\r\\n', '\\n').replaceAll('\\r', '\\n')) {\n    const code = character.codePointAt(0)!;\n    if (\n      (code < 0x20 && code !== 0x09 && code !== 0x0a) ||\n      (code >= 0x7f && code <= 0x9f) ||\n      (code >= 0x202a && code <= 0x202e) ||\n      (code >= 0x2066 && code <= 0x2069)\n    )\n      continue;\n    characters.push(character);\n  }\n  return characters.join('');\n};\n\nconst formatMetadata = (metadata: PatchMetadata): string => {\n  const labels = {\n    author: '作者',\n    name: '名称',\n    homepage: '主页',\n    version: '版本',\n  } as const;\n  const lines: string[] = [];\n  for (const field of ['author', 'name', 'homepage', 'version'] as const) {\n    const value = metadata[field];\n    if (value === undefined) continue;\n    const suffix = field === 'version' && metadata.isBeta ? '（测试版）' : '';\n    lines.push(`- ${labels[field]}：${safeTerminalText(value).replaceAll('\\n', ' ')}${suffix}`);\n  }\n  return lines.join('\\n');\n};\n\nconst main = async (): Promise<void> => {\n  const { values, positionals } = parseArgs({\n    allowPositionals: true,\n    options: {\n      help: { type: 'boolean', short: 'h' },\n      version: { type: 'boolean', short: 'v' },\n      json: { type: 'boolean' },\n      'dry-run': { type: 'boolean' },\n      input: { type: 'string', short: 'i' },\n      patch: { type: 'string', short: 'p' },\n      output: { type: 'string', short: 'o' },\n    },\n  });\n  if (values.help) {\n    process.stdout.write(help);\n    return;\n  }\n  if (values.version) {\n    const metadata: unknown = JSON.parse(\n      await readFile(new URL('../package.json', import.meta.url), 'utf8'),\n    );\n    if (\n      !metadata ||\n      typeof metadata !== 'object' ||\n      !('version' in metadata) ||\n      typeof metadata.version !== 'string'\n    )\n      throw new Error('Invalid package version metadata');\n    console.log(metadata.version);\n    return;\n  }\n  const dryRun = values['dry-run'] ?? false;\n  const usesNamedPaths =\n    values.input !== undefined || values.patch !== undefined || values.output !== undefined;\n  if (usesNamedPaths && positionals.length > 0) throw new Error(help);\n  if (\n    (usesNamedPaths && (!values.input || !values.patch || (!dryRun && !values.output))) ||\n    (!usesNamedPaths &&\n      ((!dryRun && positionals.length !== 3) ||\n        (dryRun && (positionals.length < 2 || positionals.length > 3))))\n  )\n    throw new Error(help);\n  const [original, patch, output] = usesNamedPaths\n    ? [values.input, values.patch, values.output]\n    : positionals;\n  if (!original || !patch) throw new Error(help);\n  if (!dryRun) {\n    if (!output) throw new Error(help);\n    if ((await sameFile(original, output)) || (await sameFile(patch, output)))\n      throw new Error('输出路径不能覆盖原始 ROM 或补丁包。');\n  }\n  const [originalBytes, patchBytes] = await Promise.all([readFile(original), readFile(patch)]);\n  const info = readPatchInfo(patchBytes);\n  const result = patchBuffer(originalBytes, patchBytes);\n  if (!dryRun) {\n    if (!output) throw new Error(help);\n    const destination = join(await realpath(dirname(resolve(output))), basename(output));\n    const temporary = await mkdtemp(join(dirname(destination), '.nitro-patcher-'));\n    try {\n      const file = join(temporary, 'output.nds');\n      await writeFile(file, result.buffer);\n      await rename(file, destination);\n    } finally {\n      await rm(temporary, { recursive: true, force: true });\n    }\n  }\n  const { returnValue, inputMd5, outputMd5 } = result;\n  if (values.json) {\n    console.log(\n      JSON.stringify({\n        returnValue,\n        inputMd5,\n        outputMd5,\n        ...info,\n        ...(dryRun && { dryRun: true }),\n      }),\n    );\n    return;\n  }\n\n  const sections: string[] = [];\n  if (info.metadata) {\n    const metadata = formatMetadata(info.metadata);\n    if (metadata) sections.push(`补丁元数据：\\n\\n${metadata}`);\n  }\n  if (info.readme) {\n    const content = safeTerminalText(info.readme.content);\n    const rendered =\n      info.readme.format === 'markdown'\n        ? render(content, {\n            width: process.stdout.columns ?? 80,\n            color: Boolean(process.stdout.isTTY),\n            hyperlinks: false,\n          })\n        : content;\n    sections.push(`补丁说明：\\n\\n${rendered.trimEnd()}`);\n  }\n  if (dryRun) sections.push('试运行完成，未写入输出 ROM。');\n  sections.push(`${returnValue}\\n\\n原始 ROM 的 MD5：${inputMd5}\\n生成 ROM 的 MD5：${outputMd5}`);\n  console.log(sections.join('\\n\\n'));\n};\n\nmain().catch((error: unknown) => {\n  console.error(error instanceof Error ? error.message : String(error));\n  process.exitCode = 1;\n});\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { render } from \"markdansi\";\nimport { mkdir, mkdtemp, readFile, realpath, rename, rm, stat, writeFile } from \"node:fs/promises\";\nimport { basename, dirname, join, resolve, sep } from \"node:path\";\nimport { parseArgs } from \"node:util\";\n\nimport { NDSFile } from \"./nitro/nds-file\";\nimport { type PatchMetadata, patchBuffer, readPatchInfo } from \"./nitro-patch-helper\";\n\nconst help = `nitro-patcher — NDS ROM 补丁工具\n\n用法：\n  nitro-patcher [--json] [--dry-run] <原始ROM> <补丁ZIP> [输出ROM]\n  nitro-patcher patch [--json] [--dry-run] --input <原始ROM> --patch <补丁ZIP> [--output <输出ROM>]\n  nitro-patcher extract [--json] --input <ROM> --output <目录>\n  nitro-patcher inspect [--json] --input <ROM>\n\n  --json         结果输出为 JSON 格式\n  --dry-run      完整执行补丁流程，但不写入输出 ROM\n  -i, --input    输入 ROM 路径\n  -p, --patch    补丁 ZIP 路径\n  -o, --output   输出 ROM 或提取目录；试运行时可省略\n  -h, --help     显示帮助\n  -v, --version  显示版本`;\n\ninterface CommandOptions {\n  json: boolean;\n  dryRun: boolean;\n  input: string | undefined;\n  patch: string | undefined;\n  output: string | undefined;\n}\n\nconst sameFile = async (input: string, output: string): Promise<boolean> => {\n  if (resolve(input) === resolve(output)) return true;\n  const original = await stat(input);\n  try {\n    const destination = await stat(output);\n    return original.dev === destination.dev && original.ino === destination.ino;\n  } catch (error) {\n    if (!(error instanceof Error && \"code\" in error && error.code === \"ENOENT\")) throw error;\n    return false;\n  }\n};\n\nconst safeTerminalText = (value: string): string => {\n  const characters: string[] = [];\n  for (const character of value.replaceAll(\"\\r\\n\", \"\\n\").replaceAll(\"\\r\", \"\\n\")) {\n    const code = character.codePointAt(0)!;\n    if (\n      (code < 0x20 && code !== 0x09 && code !== 0x0a) ||\n      (code >= 0x7f && code <= 0x9f) ||\n      (code >= 0x202a && code <= 0x202e) ||\n      (code >= 0x2066 && code <= 0x2069)\n    )\n      continue;\n    characters.push(character);\n  }\n  return characters.join(\"\");\n};\n\nconst formatMetadata = (metadata: PatchMetadata): string => {\n  const labels = {\n    author: \"作者\",\n    name: \"名称\",\n    homepage: \"主页\",\n    version: \"版本\",\n  } as const;\n  const lines: string[] = [];\n  for (const field of [\"author\", \"name\", \"homepage\", \"version\"] as const) {\n    const value = metadata[field];\n    if (value === undefined) continue;\n    const suffix = field === \"version\" && metadata.isBeta ? \"（测试版）\" : \"\";\n    lines.push(`- ${labels[field]}：${safeTerminalText(value).replaceAll(\"\\n\", \" \")}${suffix}`);\n  }\n  return lines.join(\"\\n\");\n};\n\nconst extractRom = async (options: CommandOptions): Promise<void> => {\n  if (!options.input || !options.output || options.patch !== undefined || options.dryRun) throw new Error(help);\n  const destination = join(await realpath(dirname(resolve(options.output))), basename(resolve(options.output)));\n  const rom = new NDSFile(await readFile(options.input));\n  const files = rom.listFiles();\n  await mkdir(destination, { recursive: true });\n  for (const { path } of files) {\n    const output = resolve(destination, path);\n    if (!output.startsWith(`${destination}${sep}`)) throw new Error(`ROM 文件路径超出输出目录：${path}`);\n    await mkdir(dirname(output), { recursive: true });\n    await writeFile(output, rom.getFile(path));\n  }\n\n  if (options.json) {\n    console.log(\n      JSON.stringify({\n        output: destination,\n        fileCount: files.length,\n        files: files.map(({ path }) => path),\n      }),\n    );\n  } else {\n    console.log(`已提取 ${files.length} 个文件到：${destination}`);\n  }\n};\n\nconst inspectRom = async (options: CommandOptions): Promise<void> => {\n  if (!options.input || options.patch !== undefined || options.output !== undefined || options.dryRun)\n    throw new Error(help);\n  const input = await readFile(options.input);\n  const rom = new NDSFile(input);\n  const info = {\n    gameTitle: rom.header.gameTitle.replace(/\\0+$/, \"\"),\n    gameCode: rom.header.gameCode,\n    size: input.length,\n    fileCount: rom.listFiles().length,\n    checksums: {\n      header: rom.header.headerCRC,\n      logo: rom.header.logoCRC,\n      secureArea: rom.header.secureCRC,\n      banner: rom.banner.bannerCRC,\n    },\n  };\n  if (options.json) {\n    console.log(JSON.stringify(info));\n    return;\n  }\n  console.log(`ROM 信息：\n\n标题：${safeTerminalText(info.gameTitle).replaceAll(\"\\n\", \" \")}\n游戏代码：${safeTerminalText(info.gameCode).replaceAll(\"\\n\", \" \")}\n大小：${info.size} 字节\n文件数量：${info.fileCount}\n校验：\n- Header：${info.checksums.header ? \"通过\" : \"失败\"}\n- Logo：${info.checksums.logo ? \"通过\" : \"失败\"}\n- Secure Area：${info.checksums.secureArea ? \"通过\" : \"失败\"}\n- Banner：${info.checksums.banner ? \"通过\" : \"失败\"}`);\n};\n\nconst main = async (): Promise<void> => {\n  const { values, positionals } = parseArgs({\n    allowPositionals: true,\n    options: {\n      help: { type: \"boolean\", short: \"h\" },\n      version: { type: \"boolean\", short: \"v\" },\n      json: { type: \"boolean\" },\n      \"dry-run\": { type: \"boolean\" },\n      input: { type: \"string\", short: \"i\" },\n      patch: { type: \"string\", short: \"p\" },\n      output: { type: \"string\", short: \"o\" },\n    },\n  });\n  if (values.help) {\n    process.stdout.write(help);\n    return;\n  }\n  if (values.version) {\n    const metadata: unknown = JSON.parse(await readFile(new URL(\"../package.json\", import.meta.url), \"utf8\"));\n    if (!metadata || typeof metadata !== \"object\" || !(\"version\" in metadata) || typeof metadata.version !== \"string\")\n      throw new Error(\"Invalid package version metadata\");\n    console.log(metadata.version);\n    return;\n  }\n  const options: CommandOptions = {\n    json: values.json ?? false,\n    dryRun: values[\"dry-run\"] ?? false,\n    input: values.input,\n    patch: values.patch,\n    output: values.output,\n  };\n  const command = positionals.length === 1 ? positionals[0] : undefined;\n  if (positionals.length !== 0 && positionals.length !== 1 && positionals.length !== 3) throw new Error(help);\n  if (command !== undefined && command !== \"patch\" && command !== \"extract\" && command !== \"inspect\")\n    throw new Error(help);\n  if (command === \"extract\") {\n    await extractRom(options);\n    return;\n  }\n  if (command === \"inspect\") {\n    await inspectRom(options);\n    return;\n  }\n\n  const dryRun = options.dryRun;\n  const usesLegacyPaths = positionals.length === 3;\n  if (usesLegacyPaths && (values.input !== undefined || values.patch !== undefined || values.output !== undefined))\n    throw new Error(help);\n  if (!usesLegacyPaths && (!values.input || !values.patch || (!dryRun && !values.output))) throw new Error(help);\n  const [original, patch, output] = usesLegacyPaths ? positionals : [values.input, values.patch, values.output];\n  if (!original || !patch) throw new Error(help);\n  if (!dryRun) {\n    if (!output) throw new Error(help);\n    if ((await sameFile(original, output)) || (await sameFile(patch, output)))\n      throw new Error(\"输出路径不能覆盖原始 ROM 或补丁包。\");\n  }\n  const [originalBytes, patchBytes] = await Promise.all([readFile(original), readFile(patch)]);\n  const info = readPatchInfo(patchBytes);\n  const result = patchBuffer(originalBytes, patchBytes);\n  if (!dryRun) {\n    if (!output) throw new Error(help);\n    const destination = join(await realpath(dirname(resolve(output))), basename(output));\n    const temporary = await mkdtemp(join(dirname(destination), \".nitro-patcher-\"));\n    try {\n      const file = join(temporary, \"output.nds\");\n      await writeFile(file, result.buffer);\n      await rename(file, destination);\n    } finally {\n      await rm(temporary, { recursive: true, force: true });\n    }\n  }\n  const { returnValue, inputMd5, outputMd5 } = result;\n  if (options.json) {\n    console.log(\n      JSON.stringify({\n        returnValue,\n        inputMd5,\n        outputMd5,\n        ...info,\n        ...(dryRun && { dryRun: true }),\n      }),\n    );\n    return;\n  }\n\n  const sections: string[] = [];\n  if (info.metadata) {\n    const metadata = formatMetadata(info.metadata);\n    if (metadata) sections.push(`补丁信息：\\n\\n${metadata}`);\n  }\n  if (info.readme) {\n    const content = safeTerminalText(info.readme.content);\n    const rendered =\n      info.readme.format === \"markdown\"\n        ? render(content, {\n            width: process.stdout.columns ?? 80,\n            color: Boolean(process.stdout.isTTY),\n            hyperlinks: false,\n          })\n        : content;\n    sections.push(`补丁说明：\\n\\n${rendered.trim()}`);\n  }\n  if (dryRun) sections.push(\"试运行完成，未写入输出 ROM。\");\n  sections.push(`${returnValue}\\n\\n原始 ROM 的 MD5：${inputMd5}\\n生成 ROM 的 MD5：${outputMd5}`);\n  console.log(sections.join(\"\\n\\n\"));\n};\n\nmain().catch((error: unknown) => {\n  console.error(error instanceof Error ? error.message : String(error));\n  process.exitCode = 1;\n});\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -1,2 +1,2 @@
 export { Arm9Header, Banner, BinaryWriter, FatEntry, FileAllocationTable, FileNameTable, Header, ModcryptHeader, NDSFile, NitroFile, NitroFolder, OverlayItem, OverlayRange, OverlayTable, RomFileInfo, RomOptions, SignedTwlHeader, TWL, TwlHeader, UnitCode, aes128CtrCrypt, compressArm9, compressBLZ, crc16, crc32, decompressArm9, decompressBLZ, encryptSecureArea, modcryptKey, updateHeaderSignatures } from './nitro-helper.js';
-export { PatchHelper, PatchInfo, PatchMetadata, PatchOptions, PatchReadme, PatchResult, PatchReturnValue, XdeltaOptions, decodeXdelta, patchBuffer, patchIt, readPatchInfo, readPatchInfoFile, readPatchMetadata, readPatchMetadataFile, readPatchReadme, readPatchReadmeFile } from './nitro-patch-helper.js';
+export { PatchHelper, PatchInfo, PatchMetadata, PatchOptions, PatchReadme, PatchResult, PatchReturnValue, XdeltaOptions, decodeXdelta, extractZipEntry, patchBuffer, patchIt, readPatchInfo, readPatchInfoFile, readPatchMetadata, readPatchMetadataFile, readPatchReadme, readPatchReadmeFile } from './nitro-patch-helper.js';

package/dist/index.js

@@ -3,6 +3,7 @@ import {
   PatchHelper,
   PatchReturnValue,
   decodeXdelta,
+  extractZipEntry,
   patchBuffer,
   patchIt,
   readPatchInfo,
@@ -11,7 +12,7 @@ import {
   readPatchMetadataFile,
   readPatchReadme,
   readPatchReadmeFile
-} from "./chunk-ZY3OSZCA.js";
+} from "./chunk-IGURDH5L.js";
 import {
   Banner,
   BinaryWriter,
@@ -32,7 +33,7 @@ import {
   encryptSecureArea,
   modcryptKey,
   updateHeaderSignatures
-} from "./chunk-GFF67HX4.js";
+} from "./chunk-GLK3K2HY.js";
 export {
   Banner,
   BinaryWriter,
@@ -54,6 +55,7 @@ export {
   decompressArm9,
   decompressBLZ,
   encryptSecureArea,
+  extractZipEntry,
   modcryptKey,
   patchBuffer,
   patchIt,

package/dist/nitro-helper.d.ts

@@ -1,3 +1,70 @@
+declare class Banner {
+    version: number;
+    raw: Buffer;
+    bannerCRC: boolean;
+    tileData: Buffer;
+    palette: Buffer;
+    japaneseTitle: string;
+    englishTitle: string;
+    frenchTitle: string;
+    germanTitle: string;
+    italianTitle: string;
+    spanishTitle: string;
+    chineseTitle: string;
+    koreanTitle: string;
+    constructor(input: Uint8Array, offset?: number, hardSize?: number);
+    get titleCount(): 8 | 7 | 6;
+    getDefSize(hardSize?: number): number;
+    toBuffer(): Buffer<ArrayBuffer>;
+}
+
+/** A file in the original ROM, optionally replaced with new bytes. */
+interface NitroFile {
+    name: string;
+    id: number;
+    offset: number;
+    size: number;
+    replacement?: Buffer;
+}
+interface NitroFolder {
+    name: string;
+    id: number;
+    files: NitroFile[];
+    folders: NitroFolder[];
+}
+interface FatEntry {
+    id: number;
+    offset: number;
+    size: number;
+}
+declare class FileAllocationTable {
+    readonly entries: FatEntry[];
+    readonly sortedIDs: number[];
+    constructor(input: Uint8Array, offset: number, size: number);
+}
+declare class FileNameTable {
+    readonly root: NitroFolder;
+    constructor(fat: FileAllocationTable, input: Uint8Array, offset: number, size: number);
+    static findFile(id: number, folder: NitroFolder): NitroFile | undefined;
+}
+interface OverlayItem {
+    overlayId: number;
+    ramAddress: number;
+    ramSize: number;
+    bssSize: number;
+    staticInitialiserStartAddress: number;
+    staticInitialiserEndAddress: number;
+    fileId: number;
+    reserved: number;
+}
+declare class OverlayTable {
+    readonly isArm9: boolean;
+    readonly entries: OverlayItem[];
+    constructor(input: Uint8Array, offset: number, size: number, isArm9: boolean);
+    readBasicOverlays(fat: FileAllocationTable): NitroFile[];
+    toBuffer(): Buffer;
+}
+
 declare const UnitCode: Readonly<{
     NDS: 0;
     NDS_DSi: 2;
@@ -109,73 +176,6 @@ declare class Header {
     toString(): string;
 }
 
-declare class Banner {
-    version: number;
-    raw: Buffer;
-    bannerCRC: boolean;
-    tileData: Buffer;
-    palette: Buffer;
-    japaneseTitle: string;
-    englishTitle: string;
-    frenchTitle: string;
-    germanTitle: string;
-    italianTitle: string;
-    spanishTitle: string;
-    chineseTitle: string;
-    koreanTitle: string;
-    constructor(input: Uint8Array, offset?: number, hardSize?: number);
-    get titleCount(): 8 | 7 | 6;
-    getDefSize(hardSize?: number): number;
-    toBuffer(): Buffer<ArrayBuffer>;
-}
-
-/** A file in the original ROM, optionally replaced with new bytes. */
-interface NitroFile {
-    name: string;
-    id: number;
-    offset: number;
-    size: number;
-    replacement?: Buffer;
-}
-interface NitroFolder {
-    name: string;
-    id: number;
-    files: NitroFile[];
-    folders: NitroFolder[];
-}
-interface FatEntry {
-    id: number;
-    offset: number;
-    size: number;
-}
-declare class FileAllocationTable {
-    readonly entries: FatEntry[];
-    readonly sortedIDs: number[];
-    constructor(input: Uint8Array, offset: number, size: number);
-}
-declare class FileNameTable {
-    readonly root: NitroFolder;
-    constructor(fat: FileAllocationTable, input: Uint8Array, offset: number, size: number);
-    static findFile(id: number, folder: NitroFolder): NitroFile | undefined;
-}
-interface OverlayItem {
-    overlayId: number;
-    ramAddress: number;
-    ramSize: number;
-    bssSize: number;
-    staticInitialiserStartAddress: number;
-    staticInitialiserEndAddress: number;
-    fileId: number;
-    reserved: number;
-}
-declare class OverlayTable {
-    readonly isArm9: boolean;
-    readonly entries: OverlayItem[];
-    constructor(input: Uint8Array, offset: number, size: number, isArm9: boolean);
-    readBasicOverlays(fat: FileAllocationTable): NitroFile[];
-    toBuffer(): Buffer;
-}
-
 /** Seekable, bounded in-memory writer; unwritten gaps have MemoryStream's zero fill. */
 declare class BinaryWriter {
     readonly maxSize: number;
@@ -190,17 +190,6 @@ declare class BinaryWriter {
     toBuffer(): Buffer<ArrayBufferLike>;
 }
 
-interface ModcryptHeader {
-    gameCode: string;
-    gameTitle: string;
-    twlInternalFlags: number;
-    appflags?: Buffer;
-    hmac_arm9i?: Buffer;
-}
-declare const aes128CtrCrypt: (key: Buffer, counter: Buffer, data: Buffer) => Buffer;
-declare const modcryptKey: (header: ModcryptHeader) => Buffer;
-declare const encryptSecureArea: (gameCode: string, input: Buffer) => Buffer;
-
 interface Arm9Header {
     reserved2: Buffer;
     ARM9ramAddress: number;
@@ -214,6 +203,17 @@ declare const decompressArm9: (data: Buffer, header: Arm9Header) => {
 };
 declare const compressArm9: (data: Buffer, header: Arm9Header, postSize?: number) => Buffer;
 
+interface ModcryptHeader {
+    gameCode: string;
+    gameTitle: string;
+    twlInternalFlags: number;
+    appflags?: Buffer;
+    hmac_arm9i?: Buffer;
+}
+declare const aes128CtrCrypt: (key: Buffer, counter: Buffer, data: Buffer) => Buffer;
+declare const modcryptKey: (header: ModcryptHeader) => Buffer;
+declare const encryptSecureArea: (gameCode: string, input: Buffer) => Buffer;
+
 interface TwlHeader extends ModcryptHeader {
     digest_sector_size: number;
     digest_block_sectorcount: number;

package/dist/nitro-helper.js

@@ -19,7 +19,7 @@ import {
   encryptSecureArea,
   modcryptKey,
   updateHeaderSignatures
-} from "./chunk-GFF67HX4.js";
+} from "./chunk-GLK3K2HY.js";
 export {
   Banner,
   BinaryWriter,

package/dist/nitro-patch-helper.d.ts

@@ -42,7 +42,7 @@ interface PatchMetadata {
     isBeta?: boolean;
 }
 interface PatchReadme {
-    format: 'markdown' | 'plaintext';
+    format: "markdown" | "plaintext";
     content: string;
 }
 interface PatchInfo {
@@ -55,6 +55,8 @@ declare const readPatchMetadata: (patch: Uint8Array, options?: PatchOptions) =>
 declare const readPatchReadme: (patch: Uint8Array, options?: PatchOptions) => PatchReadme | null;
 /** Read metadata and README content while parsing the patch package only once. */
 declare const readPatchInfo: (patch: Uint8Array, options?: PatchOptions) => PatchInfo;
+/** Extract one file from a ZIP archive entirely in memory. */
+declare const extractZipEntry: (archive: Uint8Array, entryName: string, options?: PatchOptions) => Buffer;
 /** Read metadata.json from a NitroPatcher ZIP package on disk. */
 declare const readPatchMetadataFile: (patchPath: string, options?: PatchOptions) => Promise<PatchMetadata | null>;
 /** Read a patch README from disk. */
@@ -67,6 +69,7 @@ declare const patchBuffer: (original: Uint8Array, patch: Uint8Array, options?: P
 declare const patchIt: (originalPath: string, patchPath: string, options?: PatchOptions) => Promise<PatchResult>;
 /** Namespaced counterpart of the original C# helper, sharing the same typed functions. */
 declare const PatchHelper: Readonly<{
+    extractZipEntry: (archive: Uint8Array, entryName: string, options?: PatchOptions) => Buffer;
     patchBuffer: (original: Uint8Array, patch: Uint8Array, options?: PatchOptions) => PatchResult;
     patchIt: (originalPath: string, patchPath: string, options?: PatchOptions) => Promise<PatchResult>;
     readPatchInfo: (patch: Uint8Array, options?: PatchOptions) => PatchInfo;
@@ -77,4 +80,4 @@ declare const PatchHelper: Readonly<{
     readPatchReadmeFile: (patchPath: string, options?: PatchOptions) => Promise<PatchReadme | null>;
 }>;
 
-export { PatchHelper, type PatchInfo, type PatchMetadata, type PatchOptions, type PatchReadme, type PatchResult, PatchReturnValue, type XdeltaOptions, decodeXdelta, patchBuffer, patchIt, readPatchInfo, readPatchInfoFile, readPatchMetadata, readPatchMetadataFile, readPatchReadme, readPatchReadmeFile };
+export { PatchHelper, type PatchInfo, type PatchMetadata, type PatchOptions, type PatchReadme, type PatchResult, PatchReturnValue, type XdeltaOptions, decodeXdelta, extractZipEntry, patchBuffer, patchIt, readPatchInfo, readPatchInfoFile, readPatchMetadata, readPatchMetadataFile, readPatchReadme, readPatchReadmeFile };

package/dist/nitro-patch-helper.js

@@ -2,6 +2,7 @@ import {
   PatchHelper,
   PatchReturnValue,
   decodeXdelta,
+  extractZipEntry,
   patchBuffer,
   patchIt,
   readPatchInfo,
@@ -10,12 +11,13 @@ import {
   readPatchMetadataFile,
   readPatchReadme,
   readPatchReadmeFile
-} from "./chunk-ZY3OSZCA.js";
-import "./chunk-GFF67HX4.js";
+} from "./chunk-IGURDH5L.js";
+import "./chunk-GLK3K2HY.js";
 export {
   PatchHelper,
   PatchReturnValue,
   decodeXdelta,
+  extractZipEntry,
   patchBuffer,
   patchIt,
   readPatchInfo,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nitro-patcher",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Native Node.js Nintendo DS ROM reader, repacker and ZIP/Xdelta patcher",
   "type": "module",
   "engines": {
@@ -50,15 +50,19 @@
     "@noble/hashes": "2.4.0",
     "@types/node": "22.20.2",
     "buffer": "6.0.3",
-    "esbuild": "0.27.3",
+    "esbuild": "0.28.1",
     "eslint": "10.9.1",
     "eslint-config-prettier": "10.1.8",
+    "eslint-plugin-import-x": "4.17.1",
+    "eslint-plugin-prettier": "5.5.5",
+    "eslint-plugin-unused-imports": "4.4.1",
     "fflate": "0.8.3",
     "globals": "16.5.0",
     "jiti": "2.7.0",
     "prettier": "3.9.6",
     "tsup": "8.5.1",
     "tsx": "4.23.13",
+    "type-fest": "4.41.0",
     "typescript": "5.9.3",
     "typescript-eslint": "8.70.0"
   },

package/src/browser/buffer.ts

@@ -1 +1 @@
-export { Buffer } from 'buffer';
+export { Buffer } from "buffer";

package/src/browser.ts

@@ -1,10 +1,11 @@
-import { NDSFile } from './nitro/nds-file';
+import { NDSFile } from "./nitro/nds-file";
 import {
+  extractZipEntry as extractEntry,
   patchBuffer as patch,
   readPatchInfo as readInfo,
   readPatchMetadata as readMetadata,
   readPatchReadme as readReadme,
-} from './nitro-patch-helper';
+} from "./nitro-patch-helper";
 
 export interface PatchMetadata {
   id?: string;
@@ -15,7 +16,7 @@ export interface PatchMetadata {
   isBeta?: boolean;
 }
 export interface PatchReadme {
-  format: 'markdown' | 'plaintext';
+  format: "markdown" | "plaintext";
   content: string;
 }
 export interface PatchInfo {
@@ -31,7 +32,7 @@ export interface BrowserPatchOptions {
 }
 export interface BrowserPatchResult {
   buffer: Uint8Array<ArrayBuffer>;
-  returnValue: 'SUCCESS' | 'MD5_MISMATCH';
+  returnValue: "SUCCESS" | "MD5_MISMATCH";
   inputMd5: string;
   outputMd5: string;
 }
@@ -79,20 +80,23 @@ export const patchBuffer = (
   };
 };
 /** Read and validate metadata.json from a patch package entirely in memory. */
-export const readPatchMetadata = (
-  archive: Uint8Array,
-  options: BrowserPatchOptions = {},
-): PatchMetadata | null => readMetadata(archive, options);
+export const readPatchMetadata = (archive: Uint8Array, options: BrowserPatchOptions = {}): PatchMetadata | null =>
+  readMetadata(archive, options);
 /** Read a root README.md or README.txt from a patch package entirely in memory. */
-export const readPatchReadme = (
-  archive: Uint8Array,
-  options: BrowserPatchOptions = {},
-): PatchReadme | null => readReadme(archive, options);
+export const readPatchReadme = (archive: Uint8Array, options: BrowserPatchOptions = {}): PatchReadme | null =>
+  readReadme(archive, options);
 /** Read metadata and README content while parsing the patch package only once. */
 export const readPatchInfo = (archive: Uint8Array, options: BrowserPatchOptions = {}): PatchInfo =>
   readInfo(archive, options);
+/** Extract one file from a ZIP archive entirely in memory. */
+export const extractZipEntry = (
+  archive: Uint8Array,
+  entryName: string,
+  options: BrowserPatchOptions = {},
+): Uint8Array<ArrayBuffer> => new Uint8Array(extractEntry(archive, entryName, options));
 
 export const PatchHelper = Object.freeze({
+  extractZipEntry,
   patchBuffer,
   readPatchInfo,
   readPatchMetadata,