Function attachOrProvision

e2e/setup/desktop-vm.ts:59–91

(
  provision: () => Promise<ProvisionedGuest>,
)

 * desktop-packaged without a display.
 */
export const attachOrProvision = async (
  provision: () => Promise<ProvisionedGuest>,
): Promise<(() => Promise<void>) | void> => {
  let ip = process.env.E2E_DESKTOP_VM_IP;
  let teardownVm: (() => Promise<void>) | undefined;

  if (!ip) {
    // oxlint-disable-next-line executor/no-try-catch-or-throw -- boundary: VM/host setup may fail; degrade to a skip
    try {
      const result = await provision();
      ip = result.ip;
      teardownVm = result.teardown;
    } catch (error) {
      console.warn(`[desktop] provision failed, scenario will skip: ${String(error)}`);
      return;
    }
  }

  // oxlint-disable-next-line executor/no-try-catch-or-throw -- boundary: forwarding may fail; degrade to a skip
  try {
    const forward = await guestTunnel(ip, CDP_GUEST_PORT);
    process.env.E2E_DESKTOP_CDP_PORT = String(forward.localPort);
    process.env.E2E_DESKTOP_VM_IP = ip;
    return async () => {
      forward.close();
      await teardownVm?.();
    };
  } catch (error) {
    console.warn(`[desktop] could not forward CDP from ${ip}: ${String(error)}`);
    await teardownVm?.();
    return;
  }
};