Function stopSession

src/utils/video_capture.ts:87–121

(
  simulatorUuid: string,
  options: { timeoutMs?: number } = {},
)

type StopSessionResult = StopSessionSuccess | StopSessionError;

async function stopSession(
  simulatorUuid: string,
  options: { timeoutMs?: number } = {},
): Promise<StopSessionResult> {
  const session = sessions.get(simulatorUuid);
  if (!session) {
    return { error: 'No active video recording session for this simulator' };
  }

  sessions.delete(simulatorUuid);
  const child = session.process as ChildProcess | undefined;

  try {
    child?.kill?.('SIGINT');
  } catch {
    try {
      child?.kill?.();
    } catch {
      // ignore
    }
  }

  await waitForChildToStop(session, options.timeoutMs ?? 5000);

  const combinedOutput = session.buffer;
  const parsedPath = parseLastAbsoluteMp4Path(combinedOutput) ?? undefined;

  session.releaseActivity?.();

  return {
    sessionId: session.sessionId,
    stdout: combinedOutput,
    parsedPath,
  };
}

function ensureSignalHandlersAttached(): void {
  if (signalHandlersAttached) return;