Function completeOpenCommand

src/daemon/handlers/session-open.ts:136–365

(params: {
  req: DaemonRequest;
  sessionName: string;
  sessionStore: SessionStore;
  logPath: string;
  device: DeviceInfo;
  openTarget?: string;
  openPositionals: string[];
  appName?: string;
  surface: SessionSurface;
  appBundleId?: string;
  runtime: SessionRuntimeHints | undefined;
  existingSession?: SessionState;
})

// fallow-ignore-next-line complexity
async function completeOpenCommand(params: {
  req: DaemonRequest;
  sessionName: string;
  sessionStore: SessionStore;
  logPath: string;
  device: DeviceInfo;
  openTarget?: string;
  openPositionals: string[];
  appName?: string;
  surface: SessionSurface;
  appBundleId?: string;
  runtime: SessionRuntimeHints | undefined;
  existingSession?: SessionState;
}): Promise<DaemonResponse> {
  const {
    req,
    sessionName,
    sessionStore,
    logPath,
    device,
    openTarget,
    openPositionals,
    appName,
    surface,
    appBundleId,
    runtime,
    existingSession,
  } = params;
  const shouldRelaunch = req.flags?.relaunch === true;
  const traceLogPath = existingSession?.trace?.outPath;
  let sessionAppBundleId = appBundleId;
  const openCommandStartedAtMs = Date.now();
  const timing: OpenTiming = {};

  const shouldPrewarmIosRunner =
    isIosFamily(device) &&
    surface === 'app' &&
    openPositionals.length > 0 &&
    Boolean(sessionAppBundleId);
  const runnerPrewarmOptions = buildAppleRunnerSessionOptions({
    req,
    logPath,
    appBundleId: sessionAppBundleId,
    traceLogPath,
  });
  const shouldPrewarmRunnerBeforeOpen = req.flags?.maestro?.prewarmRunnerBeforeOpen === true;
  let runnerPrewarm: Promise<void> | undefined;
  // Tracked separately from `runnerPrewarm`: prewarmIosRunnerSession may
  // return undefined (prewarm unavailable), and one attempt is one attempt.
  let runnerPrewarmScheduled = false;
  let runnerPrewarmAwaited = false;
  const schedulePrewarm = (
    options: Parameters<typeof prewarmIosRunnerSession>[1] = runnerPrewarmOptions,
  ): void => {
    runnerPrewarmScheduled = true;
    timing.runnerPrewarmKind = 'session';
    timing.runnerPrewarmScheduled = true;
    runnerPrewarm = prewarmIosRunnerSession(device, options);