mirror of
https://github.com/morluto/rea.git
synced 2026-11-16 11:43:20 +00:00
Inventory classification and binary target resolution each kept their own ordered chain of container sniffers (iNES, ZIP, Godot PCK, UnityFS, wxapkg, uImage, HEX/S-record, UF2, DfuSe, ESP flash and image, FIT, NTFS MFT, binary plist). Both now walk ARTIFACT_FORMAT_RECOGNIZERS in src/domain/artifactFormatRecognition.ts. A recognizer reports recognized, refused (the header names a format this file cannot be read as) or needs-input (the DFU trailer or an ESP flash layout). Each route keeps only its policy: resolution reads the trailer or locates the flash layout on demand and refuses with file_format_rejected; inventory falls through on a refusal or a missing input, as before.
88 lines
2.7 KiB
TypeScript
88 lines
2.7 KiB
TypeScript
import { expect, it } from "vitest";
|
|
|
|
import {
|
|
ESP32C3_APP_SEGMENTS,
|
|
esp8266Image,
|
|
espImage,
|
|
} from "../../tests/fixtures/espImage.js";
|
|
import { recognizeArtifactFormat } from "./artifactFormatRecognition.js";
|
|
import { dfuseFile } from "./firmware/dfuse.fixture.js";
|
|
import { DFUSE_SUFFIX_BYTES } from "./firmware/dfuse.js";
|
|
import { ESP8266_REFUSAL } from "./firmware/espImage.js";
|
|
|
|
/** A classic iNES header declaring one 16 KiB PRG bank, with no bank bytes. */
|
|
const headerOnlyInes = (): Buffer => {
|
|
const bytes = Buffer.alloc(16);
|
|
bytes.set([0x4e, 0x45, 0x53, 0x1a, 1, 0]);
|
|
return bytes;
|
|
};
|
|
|
|
const recognize = (bytes: Buffer, extra: { suffix?: Uint8Array } = {}) =>
|
|
recognizeArtifactFormat({
|
|
prefix: bytes,
|
|
fileSize: bytes.length,
|
|
espFlashLayout: false,
|
|
...extra,
|
|
});
|
|
|
|
// Binary target resolution refuses these files and inventory keeps them as
|
|
// plain files; both now act on this one refusal instead of their own checks.
|
|
it.each([
|
|
{
|
|
label: "a header-only iNES region",
|
|
bytes: headerOnlyInes(),
|
|
format: "ines",
|
|
reason: expect.stringContaining("iNES"),
|
|
},
|
|
{
|
|
label: "an ESP8266 image",
|
|
bytes: esp8266Image(),
|
|
format: "esp-image",
|
|
reason: ESP8266_REFUSAL,
|
|
},
|
|
])("refuses $label in one place", (row) => {
|
|
expect(recognize(row.bytes)).toEqual({
|
|
state: "refused",
|
|
format: row.format,
|
|
reason: row.reason,
|
|
index: expect.any(Number),
|
|
});
|
|
});
|
|
|
|
it("asks for the DFU trailer only when the prefix claims DfuSe", () => {
|
|
const bytes = dfuseFile({
|
|
targets: [{ alternateSetting: 0, elements: [{ address: 0, data: [1] }] }],
|
|
});
|
|
const claim = recognize(bytes);
|
|
expect(claim).toMatchObject({ state: "needs-input", format: "dfuse" });
|
|
expect(
|
|
recognize(bytes, { suffix: bytes.subarray(-DFUSE_SUFFIX_BYTES) }),
|
|
).toEqual({ state: "recognized", format: "dfuse", index: claim?.index });
|
|
});
|
|
|
|
it("decides an ESP flash layout before the bootloader image it begins with", () => {
|
|
const bytes = espImage({ segments: ESP32C3_APP_SEGMENTS });
|
|
const pending = recognizeArtifactFormat({
|
|
prefix: bytes,
|
|
fileSize: bytes.length,
|
|
});
|
|
expect(pending).toMatchObject({
|
|
state: "needs-input",
|
|
format: "esp-flash-image",
|
|
});
|
|
const input = { prefix: bytes, fileSize: bytes.length };
|
|
expect(
|
|
recognizeArtifactFormat({ ...input, espFlashLayout: true }, pending?.index),
|
|
).toMatchObject({ state: "recognized", format: "esp-flash-image" });
|
|
expect(
|
|
recognizeArtifactFormat(
|
|
{ ...input, espFlashLayout: false },
|
|
pending?.index,
|
|
),
|
|
).toMatchObject({ state: "recognized", format: "esp-image" });
|
|
});
|
|
|
|
it("leaves bytes no recognizer claims to the native and named-format routes", () => {
|
|
expect(recognize(Buffer.from("plain text content\n"))).toBeUndefined();
|
|
});
|