Function handleOpenCommand

src/daemon/handlers/session-open.ts:414–586

(params: {
  req: DaemonRequest;
  sessionName: string;
  logPath: string;
  sessionStore: SessionStore;
})

// fallow-ignore-next-line complexity
export async function handleOpenCommand(params: {
  req: DaemonRequest;
  sessionName: string;
  logPath: string;
  sessionStore: SessionStore;
}): Promise<DaemonResponse> {
  const { req, sessionName, logPath, sessionStore } = params;

  const session = sessionStore.get(sessionName);
  if (session) {
    const shouldRelaunch = req.flags?.relaunch === true;
    const requestedOpenTarget = req.positionals?.[0];
    const openTarget = requestedOpenTarget ?? (shouldRelaunch ? session.appName : undefined);
    const surfaceResult = resolveOpenSurfaceResponse(
      session.device,
      req.flags?.surface,
      openTarget,
      session.surface,
    );
    if (typeof surfaceResult !== 'string') {
      return surfaceResult;
    }
    if (!openTarget && surfaceResult === 'app') {
      return shouldRelaunch
        ? invalidOpenArgs('open --relaunch requires an app name or an active session app.')
        : invalidOpenArgs('Session already active. Close it first or pass a new --session name.');
    }

    const validation = validateResolvedOpenRequest({
      shouldRelaunch,
      openTarget,
      surface: surfaceResult,
      device: session.device,
    });
    if (validation) {
      return validation;
    }

    const device = await refreshSessionDeviceIfNeeded(session.device);
    const details = await prepareOpenCommandDetails({
      req,
      sessionName,
      sessionStore,
      device,
      surface: surfaceResult,
      openTarget,
      existingSession: session,
      onIosSimulatorColdBootStart: createAppleRunnerCacheColdBootPrewarmForOpen({
        req,
        logPath,
        device,
        surface: surfaceResult,
        openTarget,
        traceLogPath: session.trace?.outPath,
      }),
    });
    if (details.type === 'response') {
      return details.response;