stopRecording function exported ✓ 100.0%

export function stopRecording(): RecordingSession | null {
  if (!session) return null;

  // If the network-idle timer is pending or requests were recently active,
  // flush a wait-for-network-idle step now (before the session status changes)
  // so the generated test correctly waits for in-flight requests.
  const recentNetworkActivity =
    lastNetworkActivityTimestamp > 0 &&
    now() - lastNetworkActivityTimestamp < 5_000;
  if (
    networkIdleTimer !== null ||
    pendingNetworkRequests > 0 ||
    recentNetworkActivity
  ) {
    if (networkIdleTimer) {
      clearTimeout(networkIdleTimer);
      networkIdleTimer = null;
    }
    const timeSinceLastAction = now() - lastActionTimestamp;
    if (timeSinceLastAction < 10_000) {
      // Push directly (addStep checks session.status === "recording" which is still true here)
      addStep({
        type: "wait-for-network-idle",
        timestamp: now(),
        label: "Wait for network requests to complete",
        waitTimeout: 10_000,
      });
    }
  }

  // Detach all event listeners
  for (const { target, event, handler } of listeners) {
    target.removeEventListener(event, handler, true);
    target.removeEventListener(event, handler);
  }
  listeners = [];

  // Stop mutation observer
  stopMutationObserver();

  // Stop network monitoring
  stopNetworkMonitoring();

  // Keep a reference (not a copy) to capturedResponses so that XHR loadend events
  // that fire after stop (in-flight at stop time) still populate stoppedResponses.
  // capturedResponses is reset to a fresh array in startRecording().
  stoppedResponses = capturedResponses;

  session.status = "stopped";
  lastActionTimestamp = 0;

  const final = session;
  stoppedSession = final; // preserve for export after recording ends
  session = null;

  // The user intentionally stopped recording — clear any persisted session so it
  // is not accidentally restored on the next page load.
  clearPersistedSession();

  return final;
}