Files
reverse-engineering-anything/src/application/EvidenceFileEnvelope.ts
T

39 lines
1.9 KiB
TypeScript

import { resemblesAnalysisSnapshot } from "../domain/analysisSnapshot.js";
import { EvidenceFileError } from "../domain/evidenceErrors.js";
import { absoluteCallerPath } from "../filesystem/callerPath.js";
import { isRecord } from "../kernel/isRecord.js";
/** Observe the already decoded file envelope before authenticating its contents. */
export const evidenceFileEnvelopeKind = (
value: unknown,
): "evidence-bundle" | "analysis-snapshot" | "other" => {
if (isRecord(value) && Object.hasOwn(value, "records"))
return "evidence-bundle";
return resemblesAnalysisSnapshot(value) ? "analysis-snapshot" : "other";
};
/** Use the same observed kind with recovery for the selected Evidence input. */
export const snapshotWrongEvidenceKind = (
path: string,
operation: string,
expected: "bundle" | "record-or-bundle",
): EvidenceFileError => {
const importing = operation === "import_evidence_bundle";
const explanation =
"This JSON appears to be an analysis snapshot. Its snapshot content has not been validated.";
return new EvidenceFileError("read", "wrong-kind", {
path: absoluteCallerPath(path),
detectedKind: "analysis-snapshot",
related: {
operations: importing
? ["open_binary", "export_evidence_bundle"]
: ["export_evidence_bundle"],
},
userMessage: importing
? `${explanation} To restore it, use a matching target, provider and analysis profile: call open_binary with snapshot_path set to this file to load the snapshot, and close_binary with snapshot_path to save updated state. Alternatively, supply a bundle from export_evidence_bundle.`
: expected === "bundle"
? `${explanation} Supply a standalone Evidence bundle from export_evidence_bundle for this input.`
: `${explanation} Supply a standalone Evidence record or bundle for this input. Use export_evidence_bundle to export a bundle from a session.`,
});
};