feat: add VehicleProfile, capability properties, and EU profile fetching

- Add VehicleProfile dataclass (~50 fields) mapping EU /profile endpoint
  response (basic, device, option, serviceOption, batteryType,
  detailInfo, dtcCategory sections)
- Add 13 capability properties on Vehicle (steering_wheel_heater_supported,
  sunroof_supported, is_left_hand_drive, etc.) that read from
  Vehicle.profile — return None when profile is unavailable
- Wire _fetch_vehicle_profiles into login flow via
  VehicleManager.initialize_vehicles() so profiles auto-populate on login
- KiaUvoApiEU override fetches /profile for each vehicle with graceful
  degradation on failure
- No-op base methods on ApiImpl and ApiImplType1 so non-EU regions and
  test DummyApi are unaffected
- 20 unit tests + EU profile fixture

Author: blka

hyundai_kia_connect_api/ApiImpl.py

@@ -140,6 +140,9 @@ class ApiImpl:
     def __init__(self) -> None:
         """Initialize."""
 
+    def _fetch_vehicle_profiles(self, token: Token, vehicles: list[Vehicle]) -> None:
+        """No-op base. Override in region subclasses with profile endpoint."""
+
     def login(
         self,
         username: str,

hyundai_kia_connect_api/ApiImplType1.py

@@ -17,7 +17,7 @@
     POIInfo,
 )
 from .Token import Token
-from .Vehicle import Vehicle
+from .Vehicle import Vehicle, VehicleProfile
 
 from .utils import get_child_value, parse_datetime, get_index_into_hex_temp
 
@@ -197,6 +197,13 @@ def get_vehicles(self, token: Token) -> list[Vehicle]:
             result.append(vehicle)
         return result
 
+    def _fetch_vehicle_profiles(self, token: Token, vehicles: list[Vehicle]) -> None:
+        """No-op base. Override in region subclasses with profile endpoint."""
+
+    def _map_vehicle_profile(self, profile_data: dict) -> VehicleProfile:
+        """Map API profile response dict to VehicleProfile dataclass."""
+        return VehicleProfile()
+
     def _get_time_from_string(self, value, timesection) -> dt.datetime.time:
         if value is not None:
             lastTwo = int(value[-2:])

hyundai_kia_connect_api/KiaUvoApiEU.py

@@ -22,6 +22,7 @@
 from .Token import Token
 from .Vehicle import (
     Vehicle,
+    VehicleProfile,
     DailyDrivingStats,
     MonthTripInfo,
     DayTripInfo,
@@ -152,6 +153,119 @@ def __init__(self, region: int, brand: int, language: str) -> None:
                 "https://accounts-eu.genesis.com/realms/eugenesisidm/ga-api/redirect2"
             )
 
+    @staticmethod
+    def _str(v):
+        """Coerce int-or-string option values to strings for capability comparisons."""
+        if v is None:
+            return None
+        return str(v)
+
+    def _map_vehicle_profile(self, profile_data: dict) -> VehicleProfile:
+        basic = profile_data.get("basic", {})
+        device = profile_data.get("device", {})
+        option = profile_data.get("option", {})
+        service_option = profile_data.get("serviceOption", {})
+        battery_type = profile_data.get("batteryType", {})
+        detail_info = profile_data.get("detailInfo", {})
+        dtc_category = profile_data.get("dtcCategory", [])
+
+        seat_heater_vent = option.get("seatHeaterVent", {})
+
+        # The EU API returns some option fields as integers and others as strings.
+        # Capability properties (steering_wheel_heater_supported, etc.) compare
+        # against string values ("1", "0"), so we coerce integer fields to strings.
+        return VehicleProfile(
+            # basic
+            brand=basic.get("brand"),
+            country=basic.get("country"),
+            ota_update_supported=basic.get("ecuOtaUpdateSupport") == 1,
+            remote_ota_update_supported=basic.get("ecuRemoteOTAUpdateSupport") == 1,
+            # device
+            sim_status=device.get("simStatus"),
+            sim_start_date=device.get("simStartDate"),
+            sim_end_date=device.get("simEndDate"),
+            head_unit_type=device.get("headUnitType"),
+            head_unit_model_name=device.get("headUnitModelName"),
+            head_unit_version=device.get("currentHeadUnitVersion"),
+            platform=device.get("platform"),
+            navi_applied=device.get("naviApplied") == 1,
+            web_manual_url=device.get("webManualUrl"),
+            # option — string fields that may arrive as ints
+            air_control_type=option.get("airControlType"),
+            driver_seat_location=option.get("drvSeatLoc"),
+            remote_control=option.get("remoteControl"),
+            heating1=option.get("heating1"),
+            heating_front_window=option.get("heatingFrontWindow"),
+            steering_wheel_heat_option=option.get("strgWhlHeatOption"),
+            heating_steering_wheel=option.get("heatingSteeringWheel"),
+            heating_side_mirror=option.get("heatingSideMirror"),
+            heating_rear_window=option.get("heatingRearWindow"),
+            light_only_available=self._str(option.get("lightOnlyAvailable")),
+            horn_light_available=self._str(option.get("hornLightAvailable")),
+            hvac_temp_type=option.get("hvacTempType"),
+            remote_control_waiting_time=option.get("remoteControlWaitingTime"),
+            window_safety_option2=option.get("windowSafetyOption2"),
+            sunroof_option=self._str(option.get("sunRoofOption")),
+            digital_key2=self._str(option.get("digitalKey2")),
+            remote_heat_control=option.get("remoteHeatControl"),
+            air_purifier_option=self._str(option.get("airPurifierOption")),
+            dvrs_option=option.get("dvrsOption"),
+            ignition_control_option=self._str(option.get("ignCtrlOption")),
+            seat_heater_vent_front_left=seat_heater_vent.get("flSeatHeat"),
+            seat_heater_vent_front_right=seat_heater_vent.get("frSeatHeat"),
+            seat_heater_vent_rear_left=seat_heater_vent.get("rlSeatHeat"),
+            seat_heater_vent_rear_right=seat_heater_vent.get("rrSeatHeat"),
+            ev_alarm_option_info=self._str(option.get("evAlarmOptionInfo")),
+            remote_air_ctrl_control_option=option.get("remoteAirCtrlControlOption"),
+            # serviceOption
+            battery_warning_service=service_option.get("batteryWarningService") == 1,
+            schedule_link_service=service_option.get("scheduleLinkService") == 1,
+            center_user_profile_option=service_option.get("centerUserProfileOption"),
+            final_destination_noti=service_option.get("finalDestinationNoti") == 1,
+            valet_service_option=service_option.get("valetServiceOption") == 1,
+            notification_support=service_option.get("notificationSupport") == 1,
+            remote_valet_act_option=service_option.get("remoteValetActOption") == 1,
+            alert_service_option=service_option.get("alertServiceOption") == 1,
+            media_streaming_service=service_option.get("mediaStreamingService"),
+            media_streaming_selection_option=service_option.get(
+                "mediaStreamingSelectionOption"
+            )
+            == 1,
+            idle_alert_setting_service=service_option.get("idleAlertSettingService")
+            == 1,
+            engine_idle_time_notification=service_option.get(
+                "engineIdleTimeNotification"
+            )
+            == 1,
+            send2car_option_info=service_option.get("send2CarOptionInfo"),
+            speed_event_support=service_option.get("speedEventSupport") == 1,
+            # batteryType
+            main_battery_type=battery_type.get("mainbatteryType"),
+            aux_battery_type=battery_type.get("auxbatteryType"),
+            # detailInfo
+            sale_model_code=detail_info.get("saleCarmdlCd"),
+            body_type=detail_info.get("bodyType"),
+            interior_color=detail_info.get("inColor"),
+            exterior_color=detail_info.get("outColor"),
+            # dtcCategory
+            dtc_categories=dtc_category if dtc_category else None,
+        )
+
+    def _fetch_vehicle_profiles(self, token: Token, vehicles: list[Vehicle]) -> None:
+        for vehicle in vehicles:
+            try:
+                url = self.SPA_API_URL + f"vehicles/{vehicle.id}/profile"
+                headers = self._get_authenticated_headers(token)
+                response = requests.get(url, headers=headers, timeout=30)
+                _check_response_for_errors(response.json())
+                profile_data = response.json().get("resMsg", {}).get("vinInfo", [])
+                if profile_data:
+                    vehicle.profile = self._map_vehicle_profile(profile_data[0])
+            except Exception:
+                _LOGGER.debug(
+                    f"{DOMAIN} - Vehicle profile fetch failed for {vehicle.id}"
+                )
+
     def login(
         self,
         username: str,

hyundai_kia_connect_api/Vehicle.py

@@ -64,6 +64,83 @@ class DailyDrivingStats:
     distance_unit: str = DISTANCE_UNITS[1]  # set to kms by default
 
 
+@dataclass
+class VehicleProfile:
+    # basic
+    brand: str | None = None
+    country: str | None = None
+    ota_update_supported: bool | None = None
+    remote_ota_update_supported: bool | None = None
+
+    # device
+    sim_status: str | None = None
+    sim_start_date: str | None = None
+    sim_end_date: str | None = None
+    head_unit_type: str | None = None
+    head_unit_model_name: str | None = None
+    head_unit_version: str | None = None
+    platform: str | None = None
+    navi_applied: bool | None = None
+    web_manual_url: str | None = None
+
+    # option (raw API values)
+    air_control_type: str | None = None
+    driver_seat_location: str | None = None
+    remote_control: str | None = None
+    heating1: str | None = None
+    heating_front_window: str | None = None
+    steering_wheel_heat_option: str | None = None
+    heating_steering_wheel: str | None = None
+    heating_side_mirror: str | None = None
+    heating_rear_window: str | None = None
+    light_only_available: str | None = None
+    horn_light_available: str | None = None
+    hvac_temp_type: str | None = None
+    remote_control_waiting_time: int | None = None
+    window_safety_option2: int | None = None
+    sunroof_option: str | None = None
+    digital_key2: str | None = None
+    remote_heat_control: str | None = None
+    air_purifier_option: str | None = None
+    dvrs_option: str | None = None
+    ignition_control_option: str | None = None
+    seat_heater_vent_front_left: int | None = None
+    seat_heater_vent_front_right: int | None = None
+    seat_heater_vent_rear_left: int | None = None
+    seat_heater_vent_rear_right: int | None = None
+    ev_alarm_option_info: str | None = None
+    remote_air_ctrl_control_option: str | None = None
+
+    # serviceOption
+    battery_warning_service: bool | None = None
+    schedule_link_service: bool | None = None
+    center_user_profile_option: int | None = None
+    final_destination_noti: bool | None = None
+    valet_service_option: bool | None = None
+    notification_support: bool | None = None
+    remote_valet_act_option: bool | None = None
+    alert_service_option: bool | None = None
+    media_streaming_service: list[int] | None = None
+    media_streaming_selection_option: bool | None = None
+    idle_alert_setting_service: bool | None = None
+    engine_idle_time_notification: bool | None = None
+    send2car_option_info: int | None = None
+    speed_event_support: bool | None = None
+
+    # batteryType
+    main_battery_type: int | None = None
+    aux_battery_type: int | None = None
+
+    # detailInfo
+    sale_model_code: str | None = None
+    body_type: str | None = None
+    interior_color: str | None = None
+    exterior_color: str | None = None
+
+    # dtcCategory
+    dtc_categories: list | None = None
+
+
 @dataclass
 class Vehicle:
     id: str = None
@@ -362,6 +439,7 @@ def day_trip_info(self, value):
 
     # Debug fields
     data: dict = None
+    profile: VehicleProfile | None = None
 
     @property
     def geocode(self):
@@ -653,3 +731,83 @@ def fuel_driving_range(self, value):
         self._fuel_driving_range_value = value[0]
         self._fuel_driving_range_unit = value[1]
         self._fuel_driving_range = value[0]
+
+    # Capability properties from VehicleProfile (flat, for HA getattr pattern)
+
+    @property
+    def steering_wheel_heater_supported(self) -> bool | None:
+        if self.profile is None:
+            return None
+        return self.profile.heating_steering_wheel == "1"
+
+    @property
+    def side_mirror_heater_supported(self) -> bool | None:
+        if self.profile is None:
+            return None
+        return self.profile.heating_side_mirror == "1"
+
+    @property
+    def rear_window_heater_supported(self) -> bool | None:
+        if self.profile is None:
+            return None
+        return self.profile.heating_rear_window == "1"
+
+    @property
+    def sunroof_supported(self) -> bool | None:
+        if self.profile is None:
+            return None
+        return self.profile.sunroof_option == "1"
+
+    @property
+    def digital_key_supported(self) -> bool | None:
+        if self.profile is None:
+            return None
+        return self.profile.digital_key2 != "0"
+
+    @property
+    def air_purifier_supported(self) -> bool | None:
+        if self.profile is None:
+            return None
+        return self.profile.air_purifier_option == "1"
+
+    @property
+    def remote_heat_control_supported(self) -> bool | None:
+        if self.profile is None:
+            return None
+        return self.profile.remote_heat_control != "0"
+
+    @property
+    def ignition_control_supported(self) -> bool | None:
+        if self.profile is None:
+            return None
+        return self.profile.ignition_control_option == "1"
+
+    @property
+    def horn_light_supported(self) -> bool | None:
+        if self.profile is None:
+            return None
+        return self.profile.horn_light_available == "1"
+
+    @property
+    def light_only_supported(self) -> bool | None:
+        if self.profile is None:
+            return None
+        return self.profile.light_only_available == "1"
+
+    @property
+    def ev_alarm_supported(self) -> bool | None:
+        if self.profile is None:
+            return None
+        return self.profile.ev_alarm_option_info != "0"
+
+    @property
+    def front_window_heating_supported(self) -> bool | None:
+        if self.profile is None:
+            return None
+        return self.profile.heating_front_window == "1"
+
+    @property
+    def is_left_hand_drive(self) -> bool | None:
+        if self.profile is None:
+            return None
+        return self.profile.driver_seat_location == "L"

hyundai_kia_connect_api/VehicleManager.py

@@ -127,6 +127,7 @@ def initialize_vehicles(self):
                 "Vehicles already initialized, this will re-initialize and cause data loss mapping errors"
             )
         vehicles = self.api.get_vehicles(self.token)
+        self.api._fetch_vehicle_profiles(self.token, vehicles)
         for vehicle in vehicles:
             vehicle.supports_window_control = self.api.supports_window_control
             self.vehicles[vehicle.id] = vehicle