reverse-engineering-anything/src/application/binary/AnalysisSnapshotReplayBinding.ts

import type { Evidence } from "../../domain/evidence.js";

/** Authenticated observation identity and its immediate source records. */
export interface SnapshotReplayBinding {
  readonly evidenceId: string;
  readonly sourceEvidence?: readonly Evidence[];
}

/** Preserve direct links using the snapshot's authenticated immutable records. */
export const snapshotReplayBinding = (
  evidence: Evidence,
  records: ReadonlyMap<string, Evidence>,
): SnapshotReplayBinding | null => {
  if (evidence.evidence_links.length === 0)
    return { evidenceId: evidence.evidence_id };
  const sources: Evidence[] = [];
  for (const id of evidence.evidence_links) {
    const source = records.get(id);
    // An external link without its source cannot be represented by sourceEvidence.
    if (source === undefined) return null;
    sources.push(source);
  }
  return {
    evidenceId: evidence.evidence_id,
    sourceEvidence: Object.freeze(sources),
  };
};