Function addUserFrameFromFile

src/frames-registry.ts:167–178

(filePath: string)

 * The file must contain a single frame object (not wrapped in `{ frames: [...] }`).
 */
export function addUserFrameFromFile(filePath: string): AddUserFrameResult {
  const resolved = path.resolve(filePath);
  let raw: unknown;
  try {
    const text = fs.readFileSync(resolved, 'utf-8');
    raw = JSON.parse(text);
  } catch (err) {
    throw new Error(`Could not read frame file ${resolved}: ${(err as Error).message}`);
  }
  const frame = parseFrame(raw);
  return addUserFrame(frame);
}

/**
 * Validate an optional frame id from user input (CLI flag, API field, etc).