nitro-patcher 0.2.0 → 0.2.1

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 { mkdtemp, readFile, realpath, rename, rm, stat, writeFile } from \"node:fs/promises\";\nimport { basename, dirname, join, resolve } from \"node:path\";\nimport { parseArgs } from \"node:util\";\n\nimport { type PatchMetadata, patchBuffer, readPatchInfo } 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(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 dryRun = values[\"dry-run\"] ?? false;\n  const usesNamedPaths = 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) || (dryRun && (positionals.length < 2 || positionals.length > 3))))\n  )\n    throw new Error(help);\n  const [original, patch, output] = usesNamedPaths ? [values.input, values.patch, values.output] : 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.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.2.1",
   "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,

package/src/cli.ts

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
-import { mkdtemp, readFile, realpath, rename, rm, stat, writeFile } from 'node:fs/promises';
-import { basename, dirname, join, resolve } from 'node:path';
-import { parseArgs } from 'node:util';
-import { render } from 'markdansi';
-import { patchBuffer, readPatchInfo, type PatchMetadata } from './nitro-patch-helper';
+import { render } from "markdansi";
+import { mkdtemp, readFile, realpath, rename, rm, stat, writeFile } from "node:fs/promises";
+import { basename, dirname, join, resolve } from "node:path";
+import { parseArgs } from "node:util";
+
+import { type PatchMetadata, patchBuffer, readPatchInfo } from "./nitro-patch-helper";
 
 const help = `nitro-patcher — 原生 Node.js NDS ROM 补丁工具
 
@@ -26,14 +27,14 @@ const sameFile = async (input: string, output: string): Promise<boolean> => {
     const destination = await stat(output);
     return original.dev === destination.dev && original.ino === destination.ino;
   } catch (error) {
-    if (!(error instanceof Error && 'code' in error && error.code === 'ENOENT')) throw error;
+    if (!(error instanceof Error && "code" in error && error.code === "ENOENT")) throw error;
     return false;
   }
 };
 
 const safeTerminalText = (value: string): string => {
   const characters: string[] = [];
-  for (const character of value.replaceAll('\r\n', '\n').replaceAll('\r', '\n')) {
+  for (const character of value.replaceAll("\r\n", "\n").replaceAll("\r", "\n")) {
     const code = character.codePointAt(0)!;
     if (
       (code < 0x20 && code !== 0x09 && code !== 0x0a) ||
@@ -44,37 +45,37 @@ const safeTerminalText = (value: string): string => {
       continue;
     characters.push(character);
   }
-  return characters.join('');
+  return characters.join("");
 };
 
 const formatMetadata = (metadata: PatchMetadata): string => {
   const labels = {
-    author: '作者',
-    name: '名称',
-    homepage: '主页',
-    version: '版本',
+    author: "作者",
+    name: "名称",
+    homepage: "主页",
+    version: "版本",
   } as const;
   const lines: string[] = [];
-  for (const field of ['author', 'name', 'homepage', 'version'] as const) {
+  for (const field of ["author", "name", "homepage", "version"] as const) {
     const value = metadata[field];
     if (value === undefined) continue;
-    const suffix = field === 'version' && metadata.isBeta ? '（测试版）' : '';
-    lines.push(`- ${labels[field]}：${safeTerminalText(value).replaceAll('\n', ' ')}${suffix}`);
+    const suffix = field === "version" && metadata.isBeta ? "（测试版）" : "";
+    lines.push(`- ${labels[field]}：${safeTerminalText(value).replaceAll("\n", " ")}${suffix}`);
   }
-  return lines.join('\n');
+  return lines.join("\n");
 };
 
 const main = async (): Promise<void> => {
   const { values, positionals } = parseArgs({
     allowPositionals: true,
     options: {
-      help: { type: 'boolean', short: 'h' },
-      version: { type: 'boolean', short: 'v' },
-      json: { type: 'boolean' },
-      'dry-run': { type: 'boolean' },
-      input: { type: 'string', short: 'i' },
-      patch: { type: 'string', short: 'p' },
-      output: { type: 'string', short: 'o' },
+      help: { type: "boolean", short: "h" },
+      version: { type: "boolean", short: "v" },
+      json: { type: "boolean" },
+      "dry-run": { type: "boolean" },
+      input: { type: "string", short: "i" },
+      patch: { type: "string", short: "p" },
+      output: { type: "string", short: "o" },
     },
   });
   if (values.help) {
@@ -82,38 +83,27 @@ const main = async (): Promise<void> => {
     return;
   }
   if (values.version) {
-    const metadata: unknown = 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');
+    const metadata: unknown = 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 !== undefined || values.patch !== undefined || values.output !== undefined;
+  const dryRun = values["dry-run"] ?? false;
+  const usesNamedPaths = values.input !== undefined || values.patch !== undefined || values.output !== undefined;
   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))))
+      ((!dryRun && positionals.length !== 3) || (dryRun && (positionals.length < 2 || positionals.length > 3))))
   )
     throw new Error(help);
-  const [original, patch, output] = usesNamedPaths
-    ? [values.input, values.patch, values.output]
-    : positionals;
+  const [original, patch, output] = usesNamedPaths ? [values.input, values.patch, values.output] : positionals;
   if (!original || !patch) throw new Error(help);
   if (!dryRun) {
     if (!output) throw new Error(help);
     if ((await sameFile(original, output)) || (await sameFile(patch, output)))
-      throw new Error('输出路径不能覆盖原始 ROM 或补丁包。');
+      throw new Error("输出路径不能覆盖原始 ROM 或补丁包。");
   }
   const [originalBytes, patchBytes] = await Promise.all([readFile(original), readFile(patch)]);
   const info = readPatchInfo(patchBytes);
@@ -121,9 +111,9 @@ const main = async (): Promise<void> => {
   if (!dryRun) {
     if (!output) throw new Error(help);
     const destination = join(await realpath(dirname(resolve(output))), basename(output));
-    const temporary = await mkdtemp(join(dirname(destination), '.nitro-patcher-'));
+    const temporary = await mkdtemp(join(dirname(destination), ".nitro-patcher-"));
     try {
-      const file = join(temporary, 'output.nds');
+      const file = join(temporary, "output.nds");
       await writeFile(file, result.buffer);
       await rename(file, destination);
     } finally {
@@ -152,18 +142,18 @@ const main = async (): Promise<void> => {
   if (info.readme) {
     const content = safeTerminalText(info.readme.content);
     const rendered =
-      info.readme.format === 'markdown'
+      info.readme.format === "markdown"
         ? render(content, {
             width: process.stdout.columns ?? 80,
             color: Boolean(process.stdout.isTTY),
             hyperlinks: false,
           })
         : content;
-    sections.push(`补丁说明：\n\n${rendered.trimEnd()}`);
+    sections.push(`补丁说明：\n\n${rendered.trim()}`);
   }
-  if (dryRun) sections.push('试运行完成，未写入输出 ROM。');
+  if (dryRun) sections.push("试运行完成，未写入输出 ROM。");
   sections.push(`${returnValue}\n\n原始 ROM 的 MD5：${inputMd5}\n生成 ROM 的 MD5：${outputMd5}`);
-  console.log(sections.join('\n\n'));
+  console.log(sections.join("\n\n"));
 };
 
 main().catch((error: unknown) => {

package/src/index.ts

@@ -1,2 +1,2 @@
-export * from './nitro-helper';
-export * from './nitro-patch-helper';
+export * from "./nitro-helper";
+export * from "./nitro-patch-helper";