mirror of
https://github.com/morluto/rea.git
synced 2026-11-20 05:32:44 +00:00
* refactor(targets): share the resolved target format vocabulary * test(targets): verify each format kind at compile time * refactor(targets): share Evidence and explicit format vocabulary (#12168)
120 lines
3.3 KiB
TypeScript
120 lines
3.3 KiB
TypeScript
import { z } from "zod";
|
|
|
|
import {
|
|
BINARY_ARCHITECTURES,
|
|
HEADER_ARCHITECTURE_EXCLUSIONS,
|
|
RAW_ONLY_ARCHITECTURES,
|
|
} from "./binaryTargetTypes.js";
|
|
import { digestSchema } from "./digests.js";
|
|
import { localPathStringSchema } from "./localPath.js";
|
|
import {
|
|
binaryArchitectureSchema,
|
|
rawBinaryEntryPointSchema,
|
|
} from "./rawBinary.js";
|
|
import { targetFormatsOfKind } from "./targetFormats.js";
|
|
|
|
const architectureSchema = z.enum(BINARY_ARCHITECTURES);
|
|
const headerArchitectureSchema = architectureSchema.exclude(
|
|
HEADER_ARCHITECTURE_EXCLUSIONS,
|
|
);
|
|
const identity = {
|
|
path: z.string(),
|
|
sha256: digestSchema,
|
|
caller_input_path: localPathStringSchema
|
|
.exactOptional()
|
|
.describe(
|
|
"Verbatim selected path when it differs from the inspected file path.",
|
|
),
|
|
};
|
|
const executable = { ...identity, kind: z.literal("executable") };
|
|
|
|
/** Live target classifications; historical Evidence and snapshots retain their own admission. */
|
|
export const liveBinaryTargetSummaryVariants = [
|
|
z.object({
|
|
...executable,
|
|
format: z.literal("elf"),
|
|
architecture: architectureSchema.exclude([
|
|
...RAW_ONLY_ARCHITECTURES,
|
|
"arm64_32",
|
|
]),
|
|
}),
|
|
z.object({
|
|
...executable,
|
|
format: z.literal("mach-o"),
|
|
architecture: z.enum([...headerArchitectureSchema.options, "arm64_32"]),
|
|
}),
|
|
z.object({
|
|
...executable,
|
|
format: z.enum(["mach-o-universal", "pe", "dos-mz", "dos-com"]),
|
|
architecture: headerArchitectureSchema,
|
|
}),
|
|
z.object({
|
|
...executable,
|
|
format: z.literal("raw-binary"),
|
|
architecture: binaryArchitectureSchema,
|
|
entry_point: rawBinaryEntryPointSchema.describe(
|
|
"Canonical caller-selected address where raw file offset 0 is mapped and execution is seeded.",
|
|
),
|
|
}),
|
|
z.object({
|
|
...executable,
|
|
format: z.literal("gamecube-dol"),
|
|
architecture: z.literal("powerpc"),
|
|
entry_point: rawBinaryEntryPointSchema.describe(
|
|
"Canonical entry address taken from the caller-selected DOL header.",
|
|
),
|
|
}),
|
|
z.object({
|
|
...identity,
|
|
kind: z.literal("database"),
|
|
format: z.literal("analysis-database"),
|
|
architecture: z.null(),
|
|
}),
|
|
z.object({
|
|
...identity,
|
|
kind: z.literal("archive"),
|
|
format: z.enum(
|
|
targetFormatsOfKind("archive").filter(
|
|
(format) => format !== "esp-flash-image",
|
|
),
|
|
),
|
|
architecture: z.null(),
|
|
}),
|
|
z.object({
|
|
...identity,
|
|
kind: z.literal("archive"),
|
|
format: z.literal("esp-flash-image"),
|
|
architecture: z.null(),
|
|
flash_offset: z
|
|
.number()
|
|
.int()
|
|
.min(0)
|
|
.max(0xffff_ffff)
|
|
.nullable()
|
|
.describe(
|
|
"Caller-selected flash address of the dump's first byte; null reads it as flash address 0.",
|
|
),
|
|
partition_table_offset: z
|
|
.number()
|
|
.int()
|
|
.min(0)
|
|
.max(0xffff_ffff)
|
|
.nullable()
|
|
.describe(
|
|
"Caller-selected partition table address; null tries 0x8000, then a scan.",
|
|
),
|
|
}),
|
|
z.object({
|
|
...identity,
|
|
kind: z.literal("artifact"),
|
|
format: z.enum(targetFormatsOfKind("artifact")),
|
|
architecture: z.null(),
|
|
}),
|
|
] as const;
|
|
|
|
/** Exact wire projection of the currently admitted canonical target variants. */
|
|
export const liveBinaryTargetSummarySchema = z.discriminatedUnion(
|
|
"format",
|
|
liveBinaryTargetSummaryVariants,
|
|
);
|