Recorder

static async start(
  url: string,
  options?: RecorderOptions
): Promise<Recording>

import { Recorder } from "@vulcn/engine";

const recording = await Recorder.start("https://example.com", {
  browser: "chromium",
  headless: false,
  viewport: { width: 1280, height: 720 },
});

// Browser is now open and recording
// User interacts with the page...

const session = await recording.stop();

interface RecorderOptions {
  /** Browser to use (default: "chromium") */
  browser?: "chromium" | "firefox" | "webkit";

  /** Viewport size */
  viewport?: { width: number; height: number };

  /** Run headless (default: false for recording) */
  headless?: boolean;
}

async stop(): Promise<Session>

const session = await recording.stop();

console.log(`Recorded ${session.steps.length} steps`);
console.log(`Start URL: ${session.startUrl}`);

async abort(): Promise<void>

getSteps(): Step[]

addStep(step: Step): void

recording.addStep({
  id: "custom_step_001",
  type: "navigate",
  url: "https://example.com/page",
  timestamp: Date.now(),
});

interface Session {
  name: string;
  startUrl: string;
  browser: BrowserType;
  steps: Step[];
}

interface Step {
  id: string;
  type: "navigate" | "click" | "fill" | "select" | "check";
  timestamp: number;
  url?: string;
  selector?: string;
  value?: string;
}

import { parseSession, stringifySession } from "@vulcn/engine";

// Session to YAML
const yaml = stringifySession(session);
await fs.writeFile("session.vulcn.yml", yaml);

// YAML to Session
const content = await fs.readFile("session.vulcn.yml", "utf-8");
const session = parseSession(content);

import { Recorder, stringifySession } from "@vulcn/engine";
import fs from "fs/promises";

async function recordSession(url: string, outputPath: string) {
  console.log(`Recording session from ${url}...`);

  const recording = await Recorder.start(url, {
    browser: "chromium",
    headless: false,
  });

  console.log("Browser opened. Interact with the page, then close it.");

  // Wait for browser to close
  const session = await recording.stop();

  console.log(`Recorded ${session.steps.length} steps`);

  // Save to file
  const yaml = stringifySession(session);
  await fs.writeFile(outputPath, yaml);

  console.log(`Saved to ${outputPath}`);
}

recordSession("https://example.com", "session.vulcn.yml");