Function handleLinuxInstallFailure

apps/desktop/src/main/updater.ts:429–473

(
  format: LinuxPackageFormat,
  file: string,
  error: unknown
)

}

function handleLinuxInstallFailure(
  format: LinuxPackageFormat,
  file: string,
  error: unknown
): void {
  const code = (error as { code?: string | number }).code
  const hint = manualInstallHint(format, file)

  // pkexec isn't installed (no graphical askpass available).
  if (code === 'ENOENT') {
    revealDownloadedPackage(file)
    setUpdateState(
      nextStateFromInfo(
        'error',
        lastInfo,
        `Couldn't install automatically: pkexec (graphical sudo) isn't available on this system. The update was downloaded to ${file} — install it manually with: ${hint}, then reopen ZenNotes.`
      )
    )
    return
  }

  // pkexec exits 126/127 when the auth dialog is dismissed or not authorized.
  // Keep the update ready so the user can retry.
  if (code === 126 || code === 127) {
    setUpdateState(
      nextStateFromInfo(
        'downloaded',
        lastInfo,
        'Update install was canceled. Click “Install and Relaunch” to try again.'
      )
    )
    return
  }

  // dpkg/apt (or rpm/pacman) failed.
  revealDownloadedPackage(file)
  const detail = error instanceof Error ? error.message.trim() : String(error)
  setUpdateState(
    nextStateFromInfo(
      'error',
      lastInfo,
      `Update install failed: ${detail || 'unknown error'}. The package is at ${file} — you can install it manually with: ${hint}.`
    )
  )
}