feat: add VehicleProfile and capability properties for EU API

- VehicleProfile dataclass (~50 fields) mapping EU /api/v1/spa/vehicles/{id}/profile
- 13 capability properties on Vehicle reading from Vehicle.profile (HA getattr pattern, None when no profile)
- str_or_none utility for int-or-string option coercion
- supports_vehicle_profile flag on ApiImpl (False by default), True on KiaUvoApiEU
- _fetch_vehicle_profiles + _map_vehicle_profile in ApiImplType1, piggybacked on get_vehicles (login only, not per poll)
- Graceful degradation: profile fetch failure leaves vehicle.profile = None
- 21 unit tests + EU profile fixture

Non-supporting regions (CA, USA, BR) make zero extra calls. AU/IN/CN stay off until their /profile schema is verified.

Author: blka

hyundai_kia_connect_api/ApiImpl.py

@@ -164,6 +164,7 @@ class ApiImpl:
     previous_longitude: float = None
     supports_window_control: bool = False
     supports_valet_mode: bool = False
+    supports_vehicle_profile: bool = False
 
     def __init__(self) -> None:
         """Initialize."""

hyundai_kia_connect_api/ApiImplType1.py

@@ -18,7 +18,7 @@
     POIInfo,
 )
 from .Token import Token
-from .Vehicle import Vehicle
+from .Vehicle import Vehicle, VehicleProfile
 
 from .utils import (
     bool_or_none,
@@ -27,6 +27,7 @@
     normalize_battery_soc,
     parse_datetime,
     pressure_or_none,
+    str_or_none,
     window_is_open,
 )
 
@@ -232,8 +233,117 @@ def get_vehicles(self, token: Token) -> list[Vehicle]:
                 ccu_ccs2_protocol_support=entry["ccuCCS2ProtocolSupport"],
             )
             result.append(vehicle)
+        if self.supports_vehicle_profile:
+            self._fetch_vehicle_profiles(token, result)
         return result
 
+    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 = self.session.get(url, headers=headers)
+                _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 _map_vehicle_profile(self, profile_data: dict) -> VehicleProfile:
+        """Map API profile response dict to VehicleProfile dataclass."""
+        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 API returns some option fields as integers and others as strings.
+        # Capability properties compare against string values ("1", "0"), so
+        # coerce integer fields to strings via str_or_none (None-safe).
+        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=str_or_none(option.get("lightOnlyAvailable")),
+            horn_light_available=str_or_none(option.get("hornLightAvailable")),
+            hvac_temp_type=option.get("hvacTempType"),
+            remote_control_waiting_time=option.get("remoteControlWaitingTime"),
+            window_safety_option2=option.get("windowSafetyOption2"),
+            sunroof_option=str_or_none(option.get("sunRoofOption")),
+            digital_key2=str_or_none(option.get("digitalKey2")),
+            remote_heat_control=option.get("remoteHeatControl"),
+            air_purifier_option=str_or_none(option.get("airPurifierOption")),
+            dvrs_option=option.get("dvrsOption"),
+            ignition_control_option=str_or_none(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=str_or_none(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 _get_time_from_string(self, value, timesection) -> dt.time | None:
         if value is None:
             return None

hyundai_kia_connect_api/KiaUvoApiEU.py

@@ -80,6 +80,7 @@
 class KiaUvoApiEU(ApiImplType1):
     data_timezone = ZoneInfo("Europe/Berlin")
     temperature_range = [x * 0.5 for x in range(28, 60)]
+    supports_vehicle_profile: bool = True
 
     def __init__(self, region: int, brand: int, language: str) -> None:
         language = language.lower()

hyundai_kia_connect_api/Vehicle.py

@@ -63,6 +63,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
@@ -390,6 +467,7 @@ def day_trip_info(self, value):
 
     # Debug fields
     data: dict = None
+    profile: VehicleProfile | None = None
 
     @property
     def geocode(self):
@@ -730,3 +808,83 @@ def fuel_driving_range(self, value):
         self._fuel_driving_range = value[0]
         if value[1] is not None:
             self._fuel_driving_range_unit = value[1]
+
+    # 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/utils.py

@@ -61,6 +61,16 @@ def window_is_open(
     return bool(open_value) or bool(open_level)
 
 
+def str_or_none(v):
+    """Coerce an int-or-string option value to a string for capability comparisons.
+
+    Returns None when the value is None (capability stays None = unknown/unsupported).
+    """
+    if v is None:
+        return None
+    return str(v)
+
+
 def get_float(value):
     if value is None:
         return None