Utils

1/**
2 * Read a value from a row by dot-separated column path.
3 *
4 * Traverses nested objects segment by segment (e.g. `"meta.score"`
5 * reads `row.meta.score`). Returns `undefined` if any intermediate
6 * segment is missing or not an object.
7 *
8 * @param row - The table row to read from.
9 * @param path - Dot-separated column path (e.g. `"file"` or `"meta.score"`).
10 * @returns The resolved value, or `undefined` if the path is invalid.
11 */
12export function readColumn(
13  row: Record<string, unknown>,
14  path: string,
15): unknown {
16  const segments = path.split(".");
17
18  let current = row;
19  for (let idx = 0; idx < segments.length - 1; idx++) {
20    const next = current[segments[idx]];
21    if (next == null || typeof next !== "object" || Array.isArray(next)) {
22      return undefined;
23    }
24    current = next as Record<string, unknown>;
25  }
26
27  return current[segments[segments.length - 1]];
28}