@thecloudseeker/homebridge-skoda 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+## 0.1.0
+
+First release, for the official MyŠkoda Public API (contract 1.1.0).
+
+- **One accessory per vehicle**, with a service for each feature the vehicle supports: battery, charging (outlet), charge limit (lightbulb brightness), air conditioning (heater cooler), auxiliary heating with S-PIN, active ventilation, "Home" occupancy sensor, and contact sensors for doors, windows, trunk, bonnet, sunroof and lock state. An optional humidity sensor mirrors the state of charge for automations.
+- **Within the rate limit:** at most 20 requests per hour per vehicle, following the `RateLimit-*` headers, with four requests kept free for commands. HomeKit reads come from the cache and never reach the API.
+- **Commands** update HomeKit right away and are confirmed by one refresh shortly after. The plugin backs off on `429`, `5xx` and network errors, and stale data shows as a fault on the sensors.
+- **API keys:** an optional second key for commands, a warning seven days before a key expires, and a clear message for expired, invalid or deleted keys. Keys and the S-PIN never appear in the log, the VIN only as its last four characters.
+- **Homebridge UI** settings with password fields for the keys and the S-PIN.
+- The ventilation switch shows the state the API reports, like the MyŠkoda app. A ventilation started through the Public API runs but is not reported as running.

package/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2026 Eike Dreier
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors
+   may be used to endorse or promote products derived from this software
+   without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -1,3 +1,185 @@
-# Temporary Holding Version
+# Homebridge Škoda
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![CI](https://github.com/thecloudseeker/homebridge-skoda/actions/workflows/ci.yml/badge.svg)](https://github.com/thecloudseeker/homebridge-skoda/actions/workflows/ci.yml)
+[![License](https://img.shields.io/badge/license-BSD%203--Clause-blue.svg)](LICENSE)
+
+Homebridge plugin that brings Škoda vehicles into Apple Home through the official
+[MyŠkoda Public API](https://public.api.connect.skoda-auto.cz/docs): state of charge, charging,
+air conditioning, auxiliary heating, "at home" detection, doors, windows and lock state.
+
+> [!IMPORTANT]
+> This is **not an official Škoda project**. It is not affiliated with, endorsed by or supported by
+> ŠKODA AUTO a.s. "Škoda" and "MyŠkoda" are trademarks of their respective owner.
+>
+> Škoda provides the MyŠkoda Public API **for personal end-user use only**. Do not use this plugin
+> to build or operate commercial products or services.
+
+## Features
+
+Each vehicle becomes one HomeKit accessory. A service is only created if it is enabled in the
+config **and** the vehicle reports that it supports it.
+
+| HomeKit service                                                  | Shows                                                          | Controls                                       | Default |
+| ---------------------------------------------------------------- | -------------------------------------------------------------- | ---------------------------------------------- | ------- |
+| Battery                                                          | State of charge, charging state, low battery below a threshold | –                                              | on      |
+| Humidity sensor "State of Charge"                                | State of charge in %, so you can build automations on it       | –                                              | off     |
+| Outlet "Charging"                                                | _On_ = charging, _Outlet In Use_ = cable plugged in            | Start / stop charging                          | on      |
+| Lightbulb "Charge Limit"                                         | Brightness = charging limit (50–100 % in steps of 10)          | Set charging limit                             | on      |
+| Heater Cooler "Climate"                                          | Active, heating / cooling, target temperature                  | Start / stop air conditioning, set temperature | on      |
+| Switch "Auxiliary Heating"                                       | Running                                                        | Start / stop (needs your S-PIN)                | on      |
+| Switch "Ventilation"                                             | Running, as far as the vehicle reports it (see notes)          | Start / stop active ventilation                | off     |
+| Occupancy sensor "Home"                                          | Parked within a radius around your home                        | –                                              | on      |
+| Contact sensors "Doors", "Windows", "Trunk", "Bonnet", "Sunroof" | Open / closed                                                  | –                                              | on      |
+| Contact sensor "Locked"                                          | Closed = locked, open = unlocked                               | – (the API cannot lock or unlock)              | on      |
+
+What the API does **not** offer, and therefore this plugin neither: locking and unlocking, honking
+and flashing, waking the vehicle up, cabin temperature, and push updates.
+
+### HomeKit notes
+
+- **Climate.** The API has no cabin temperature reading, so _Current Temperature_ mirrors the
+  target temperature. The API has no heat or cool mode either, so the mode is fixed to _Auto_ and
+  both thresholds always hold the same value. Temperatures range from 16 to 29.5 °C in steps of
+  0.5 °C. Changing the temperature while the air conditioning is running restarts it (stop,
+  10 s pause, start), which costs two requests. While it is off, the new temperature is used on
+  the next start.
+- **Charge limit.** HomeKit has no control for a percentage setpoint, so the limit is shown as the
+  brightness of a lightbulb. It cannot be switched off. Values snap to 50–100 % in steps of 10,
+  as the vehicles require.
+- **Ventilation.** A ventilation started through the Public API runs, but Škoda does not report it
+  as running: in a live test the API said _off_ during the whole 10-minute run, and the MyŠkoda
+  app showed it the same way. A ventilation started in the app is reported correctly. The switch
+  therefore always shows the reported state: after you switch it on in HomeKit it returns to _off_
+  once the vehicle has accepted the start (see the log), and it shows _on_ when the ventilation
+  was started in the app.
+- **Lock.** Exposed as a read-only contact sensor rather than a lock, because the API cannot
+  lock or unlock. A lock tile in the Home app would suggest otherwise.
+- **Stale data.** If the last successful update is older than three polling intervals, the sensors
+  show a fault (_StatusFault_). Battery, outlet, switches and the heater cooler have no fault
+  indicator in HomeKit.
+
+## Requirements
+
+- A connected Škoda vehicle and a MyŠkoda account
+- Homebridge 1.8 or 2.x
+- Node.js 22, 24 or 26
+
+## Installation
+
+The plugin is not published to npm yet. Once it is, search for `@thecloudseeker/homebridge-skoda`
+in the Homebridge UI, or run:
+
+```sh
+npm install -g @thecloudseeker/homebridge-skoda
+```
+
+## Creating an API key
+
+1. Open the **MyŠkoda app** and go to **Profile › Smart Home**. On your phone you can also open
+   [go.skoda.eu/api-keys](https://go.skoda.eu/api-keys) directly.
+2. Create a new API key and select the vehicle(s) it should cover.
+3. Copy the key into the plugin config together with the vehicle's VIN.
+
+Keys are bound to the vehicles you selected and **they expire**. The plugin warns in the log seven
+days before a key expires. Once it has expired, the plugin logs an error and retries every hour
+(failed authentication does not count against the rate limit). Renew the key in the app and
+update the config.
+
+You may configure a second key for commands only (_Command API key_), for example to keep
+permissions apart. **A second key does not give you more requests**: the rate limit applies per
+vehicle, and both keys share it.
+
+## Configuration
+
+The easiest way is the Homebridge UI. In `config.json` it looks like this:
+
+```json
+{
+  "platform": "Skoda",
+  "vehicles": [
+    {
+      "name": "Enyaq",
+      "vin": "TMBJB9NY5RF999999",
+      "token": "<your API key>",
+      "home": { "lat": 50.4128, "lon": 14.9069, "radiusMeters": 150 },
+      "pollingIntervalMinutes": 5,
+      "features": { "stateOfChargeSensor": true }
+    }
+  ]
+}
+```
+
+| Option                                | Default                 | Description                                                                                                                                                                             |
+| ------------------------------------- | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `name`                                | `Škoda <last 4 of VIN>` | Accessory name in HomeKit                                                                                                                                                               |
+| `vin`                                 | –                       | Vehicle identification number (required)                                                                                                                                                |
+| `token`                               | –                       | API key (required)                                                                                                                                                                      |
+| `commandToken`                        | –                       | Separate API key for commands                                                                                                                                                           |
+| `spin`                                | –                       | S-PIN, only needed for the auxiliary heating                                                                                                                                            |
+| `home.lat`, `home.lon`                | –                       | Home coordinates for the "Home" sensor                                                                                                                                                  |
+| `home.radiusMeters`                   | `150`                   | Radius around home, at least 10 m                                                                                                                                                       |
+| `pollingIntervalMinutes`              | `5`                     | Polling interval, at least 4 (see below)                                                                                                                                                |
+| `commandRefreshDelaySeconds`          | `90`                    | Delay before the refresh after a command (15–600)                                                                                                                                       |
+| `lowBatteryThreshold`                 | `20`                    | Low battery below this state of charge (%)                                                                                                                                              |
+| `climateTemperature`                  | `21`                    | Cabin temperature (°C) until the vehicle reports one                                                                                                                                    |
+| `airConditioningWithoutExternalPower` | –                       | Allow air conditioning on battery; unset keeps the vehicle setting                                                                                                                      |
+| `auxiliaryHeatingDurationMinutes`     | –                       | Auxiliary heating run time; unset keeps the vehicle setting                                                                                                                             |
+| `features.*`                          | see table above         | `battery`, `stateOfChargeSensor`, `charging`, `chargingLimit`, `climate`, `auxiliaryHeating`, `activeVentilation`, `presence`, `doors`, `windows`, `trunk`, `bonnet`, `sunroof`, `lock` |
+
+## Rate limit
+
+The MyŠkoda Public API currently allows **20 requests per hour per vehicle**. Škoda says this value
+is not final, so the plugin follows the `RateLimit-*` headers of every response. Every request
+counts, including commands and failed requests with server errors.
+
+The plugin is built around that limit:
+
+- **One request per update.** A single call returns all vehicle data.
+- **HomeKit never triggers requests.** Opening the Home app reads from the plugin's cache.
+- **Four requests per hour stay free** for commands and their follow-up refresh. That makes 4
+  minutes the shortest polling interval; shorter values are raised with a warning. The default of
+  5 minutes uses 12 requests per hour.
+- **After a command**, HomeKit shows the expected state right away, and the plugin refreshes once
+  after `commandRefreshDelaySeconds` to confirm it. Several commands in a row share one refresh.
+- **When the budget is used up**, commands are rejected ("No Response" in the Home app) instead of
+  being sent, and polling waits until requests are available again.
+- **Errors back off.** On `429` and `503` the plugin waits for `Retry-After`. On other server and
+  network errors it waits one polling interval, then doubles the wait up to 30 minutes.
+
+Vehicles report their state on their own schedule, so data can be older than the polling interval
+suggests, and a command may take a minute or two to show up.
+
+## Privacy and security
+
+- API keys and the S-PIN are never written to the log. The VIN is shortened to its last four
+  characters (`…9999`).
+- The Homebridge UI shows the keys and the S-PIN as password fields. They are still stored in
+  plain text in Homebridge's `config.json`, like all plugin settings. Protect that file.
+- The plugin talks only to `public.api.connect.skoda-auto.cz`.
+
+## Troubleshooting
+
+| Log message                                            | Meaning                                                         |
+| ------------------------------------------------------ | --------------------------------------------------------------- |
+| `The API key has expired`                              | Create or renew a key in the MyŠkoda app and update the config  |
+| `The API key does not cover this vehicle or operation` | The key was created for another vehicle, or the VIN is wrong    |
+| `No vehicle found for the configured VIN`              | Check the VIN                                                   |
+| `rate limit budget exhausted`                          | Too many commands in the last hour; try again later             |
+| `the vehicle declined the request`                     | The vehicle refused for now (e.g. low battery); try again later |
+| `this function is currently disabled for the vehicle`  | Enable the service for the vehicle in the MyŠkoda app           |
+
+## Development
+
+```sh
+npm install
+npm run lint
+npm run typecheck
+npm test
+npm run build
+```
+
+The tests mock the API completely and contain no real keys or vehicle data.
+
+## License
+
+[BSD 3-Clause](LICENSE)

package/config.schema.json

@@ -0,0 +1,275 @@
+{
+  "pluginAlias": "Skoda",
+  "pluginType": "platform",
+  "singular": true,
+  "strictValidation": false,
+  "headerDisplay": "Connects Škoda vehicles through the official **MyŠkoda Public API**. Create an API key in the MyŠkoda app under *Profile › Smart Home* (or open [go.skoda.eu/api-keys](https://go.skoda.eu/api-keys) on your phone). The API allows **20 requests per hour per vehicle**, so data is polled every few minutes and commands take a moment to show up. This is not an official Škoda project.",
+  "footerDisplay": "See the [README](https://github.com/thecloudseeker/homebridge-skoda#readme) for details on each feature.",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "vehicles": {
+        "title": "Vehicles",
+        "type": "array",
+        "items": {
+          "type": "object",
+          "properties": {
+            "name": {
+              "title": "Name",
+              "type": "string",
+              "placeholder": "Enyaq",
+              "description": "Name of the accessory in HomeKit."
+            },
+            "vin": {
+              "title": "VIN",
+              "type": "string",
+              "required": true,
+              "minLength": 17,
+              "maxLength": 17,
+              "pattern": "^[A-HJ-NPR-Za-hj-npr-z0-9]{17}$",
+              "description": "17-character vehicle identification number."
+            },
+            "token": {
+              "title": "API key",
+              "type": "string",
+              "required": true,
+              "description": "API key from the MyŠkoda app. Used for polling, and for commands unless a command key is set."
+            },
+            "commandToken": {
+              "title": "Command API key (optional)",
+              "type": "string",
+              "description": "Separate key for commands, e.g. with different permissions. Both keys share the vehicle's rate limit, so a second key does not allow more requests."
+            },
+            "spin": {
+              "title": "S-PIN (optional)",
+              "type": "string",
+              "description": "Security PIN of your MyŠkoda account. Only needed for the auxiliary heating; it is sent with each start and never logged."
+            },
+            "home": {
+              "title": "Home location",
+              "type": "object",
+              "properties": {
+                "lat": {
+                  "title": "Latitude",
+                  "type": "number",
+                  "minimum": -90,
+                  "maximum": 90
+                },
+                "lon": {
+                  "title": "Longitude",
+                  "type": "number",
+                  "minimum": -180,
+                  "maximum": 180
+                },
+                "radiusMeters": {
+                  "title": "Radius (m)",
+                  "type": "integer",
+                  "minimum": 10,
+                  "placeholder": 150
+                }
+              }
+            },
+            "pollingIntervalMinutes": {
+              "title": "Polling interval (minutes)",
+              "type": "integer",
+              "minimum": 4,
+              "maximum": 1440,
+              "placeholder": 5,
+              "description": "Minimum 4: 20 requests per hour minus 4 kept free for commands and their follow-up refresh."
+            },
+            "commandRefreshDelaySeconds": {
+              "title": "Refresh after command (seconds)",
+              "type": "integer",
+              "minimum": 15,
+              "maximum": 600,
+              "placeholder": 90,
+              "description": "Delay before the single follow-up refresh after a command."
+            },
+            "lowBatteryThreshold": {
+              "title": "Low battery threshold (%)",
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 100,
+              "placeholder": 20
+            },
+            "climateTemperature": {
+              "title": "Default cabin temperature (°C)",
+              "type": "number",
+              "minimum": 16,
+              "maximum": 29.5,
+              "multipleOf": 0.5,
+              "placeholder": 21,
+              "description": "Used until the vehicle reports its own target temperature."
+            },
+            "airConditioningWithoutExternalPower": {
+              "title": "Allow air conditioning on battery",
+              "type": "boolean",
+              "description": "Sent with each start. Leave unset to keep the vehicle's setting."
+            },
+            "auxiliaryHeatingDurationMinutes": {
+              "title": "Auxiliary heating duration (minutes)",
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 60,
+              "description": "Leave empty to use the vehicle's setting."
+            },
+            "features": {
+              "title": "Features",
+              "type": "object",
+              "properties": {
+                "battery": {
+                  "title": "Battery",
+                  "type": "boolean",
+                  "default": true
+                },
+                "stateOfChargeSensor": {
+                  "title": "State of charge as humidity sensor (for automations)",
+                  "type": "boolean",
+                  "default": false
+                },
+                "charging": {
+                  "title": "Charging (outlet)",
+                  "type": "boolean",
+                  "default": true
+                },
+                "chargingLimit": {
+                  "title": "Charge limit (lightbulb brightness)",
+                  "type": "boolean",
+                  "default": true
+                },
+                "climate": {
+                  "title": "Air conditioning (heater cooler)",
+                  "type": "boolean",
+                  "default": true
+                },
+                "auxiliaryHeating": {
+                  "title": "Auxiliary heating (needs S-PIN)",
+                  "type": "boolean",
+                  "default": true
+                },
+                "activeVentilation": {
+                  "title": "Active ventilation",
+                  "type": "boolean",
+                  "default": false
+                },
+                "presence": {
+                  "title": "At home (needs home location)",
+                  "type": "boolean",
+                  "default": true
+                },
+                "doors": {
+                  "title": "Doors",
+                  "type": "boolean",
+                  "default": true
+                },
+                "windows": {
+                  "title": "Windows",
+                  "type": "boolean",
+                  "default": true
+                },
+                "trunk": {
+                  "title": "Trunk",
+                  "type": "boolean",
+                  "default": true
+                },
+                "bonnet": {
+                  "title": "Bonnet",
+                  "type": "boolean",
+                  "default": true
+                },
+                "sunroof": {
+                  "title": "Sunroof",
+                  "type": "boolean",
+                  "default": true
+                },
+                "lock": {
+                  "title": "Locked (read-only)",
+                  "type": "boolean",
+                  "default": true
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "layout": [
+    {
+      "key": "vehicles",
+      "type": "array",
+      "orderable": false,
+      "buttonText": "Add vehicle",
+      "items": [
+        "vehicles[].name",
+        "vehicles[].vin",
+        { "key": "vehicles[].token", "type": "password" },
+        {
+          "type": "fieldset",
+          "title": "Commands",
+          "expandable": true,
+          "expanded": false,
+          "items": [
+            { "key": "vehicles[].commandToken", "type": "password" },
+            { "key": "vehicles[].spin", "type": "password" },
+            "vehicles[].commandRefreshDelaySeconds",
+            "vehicles[].climateTemperature",
+            "vehicles[].airConditioningWithoutExternalPower",
+            "vehicles[].auxiliaryHeatingDurationMinutes"
+          ]
+        },
+        {
+          "type": "fieldset",
+          "title": "Home location",
+          "description": "Used for the \"Home\" occupancy sensor.",
+          "expandable": true,
+          "expanded": false,
+          "items": [
+            {
+              "type": "flex",
+              "flex-flow": "row wrap",
+              "items": [
+                "vehicles[].home.lat",
+                "vehicles[].home.lon",
+                "vehicles[].home.radiusMeters"
+              ]
+            }
+          ]
+        },
+        {
+          "type": "fieldset",
+          "title": "Polling",
+          "expandable": true,
+          "expanded": false,
+          "items": [
+            "vehicles[].pollingIntervalMinutes",
+            "vehicles[].lowBatteryThreshold"
+          ]
+        },
+        {
+          "type": "fieldset",
+          "title": "Features",
+          "description": "Services are only created if the vehicle supports them.",
+          "expandable": true,
+          "expanded": false,
+          "items": [
+            "vehicles[].features.battery",
+            "vehicles[].features.stateOfChargeSensor",
+            "vehicles[].features.charging",
+            "vehicles[].features.chargingLimit",
+            "vehicles[].features.climate",
+            "vehicles[].features.auxiliaryHeating",
+            "vehicles[].features.activeVentilation",
+            "vehicles[].features.presence",
+            "vehicles[].features.doors",
+            "vehicles[].features.windows",
+            "vehicles[].features.trunk",
+            "vehicles[].features.bonnet",
+            "vehicles[].features.sunroof",
+            "vehicles[].features.lock"
+          ]
+        }
+      ]
+    }
+  ]
+}

package/dist/accessory/services/battery.d.ts

@@ -0,0 +1,20 @@
+import type { Service } from "homebridge";
+import type { Vehicle } from "../../api/types.js";
+import { ServiceBinding, type ServiceType } from "./common.js";
+/** Battery: level, charging state and low battery below the configured threshold. */
+export declare class BatteryBinding extends ServiceBinding {
+    readonly feature = "battery";
+    protected readonly serviceType: ServiceType;
+    protected readonly subtype = "battery";
+    protected readonly displayName = "Battery";
+    protected render(_service: Service, vehicle: Vehicle): void;
+}
+/** Humidity sensor that mirrors the state of charge, because HomeKit cannot trigger on battery levels. */
+export declare class StateOfChargeSensorBinding extends ServiceBinding {
+    readonly feature = "stateOfChargeSensor";
+    protected readonly serviceType: ServiceType;
+    protected readonly subtype = "state-of-charge";
+    protected readonly displayName = "State of Charge";
+    protected get hasStatusFault(): boolean;
+    protected render(_service: Service, vehicle: Vehicle): void;
+}

package/dist/accessory/services/battery.js

@@ -0,0 +1,36 @@
+import { batteryValues, stateOfCharge } from "../../vehicle/mapping.js";
+import { ServiceBinding } from "./common.js";
+/** Battery: level, charging state and low battery below the configured threshold. */
+export class BatteryBinding extends ServiceBinding {
+    feature = "battery";
+    serviceType = this.ctx.hap.Service.Battery;
+    subtype = "battery";
+    displayName = "Battery";
+    render(_service, vehicle) {
+        const { BatteryLevel, ChargingState, StatusLowBattery } = this.ctx.hap.Characteristic;
+        const values = batteryValues(vehicle, this.ctx.settings.lowBatteryThreshold);
+        this.set(BatteryLevel, values.level);
+        if (values.charging !== undefined) {
+            this.set(ChargingState, values.charging ? ChargingState.CHARGING : ChargingState.NOT_CHARGING);
+        }
+        if (values.low !== undefined) {
+            this.set(StatusLowBattery, values.low
+                ? StatusLowBattery.BATTERY_LEVEL_LOW
+                : StatusLowBattery.BATTERY_LEVEL_NORMAL);
+        }
+    }
+}
+/** Humidity sensor that mirrors the state of charge, because HomeKit cannot trigger on battery levels. */
+export class StateOfChargeSensorBinding extends ServiceBinding {
+    feature = "stateOfChargeSensor";
+    serviceType = this.ctx.hap.Service.HumiditySensor;
+    subtype = "state-of-charge";
+    displayName = "State of Charge";
+    get hasStatusFault() {
+        return true;
+    }
+    render(_service, vehicle) {
+        this.set(this.ctx.hap.Characteristic.CurrentRelativeHumidity, stateOfCharge(vehicle));
+    }
+}
+//# sourceMappingURL=battery.js.map

package/dist/accessory/services/battery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"battery.js","sourceRoot":"","sources":["../../../src/accessory/services/battery.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,cAAc,EAAoB,MAAM,aAAa,CAAC;AAE/D,qFAAqF;AACrF,MAAM,OAAO,cAAe,SAAQ,cAAc;IACvC,OAAO,GAAG,SAAS,CAAC;IACV,WAAW,GAAgB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC;IACxD,OAAO,GAAG,SAAS,CAAC;IACpB,WAAW,GAAG,SAAS,CAAC;IAEjC,MAAM,CAAC,QAAiB,EAAE,OAAgB;QAClD,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,GACrD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC;QAC9B,MAAM,MAAM,GAAG,aAAa,CAC1B,OAAO,EACP,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CACtC,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,GAAG,CACN,aAAa,EACb,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,YAAY,CACtE,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YAC7B,IAAI,CAAC,GAAG,CACN,gBAAgB,EAChB,MAAM,CAAC,GAAG;gBACR,CAAC,CAAC,gBAAgB,CAAC,iBAAiB;gBACpC,CAAC,CAAC,gBAAgB,CAAC,oBAAoB,CAC1C,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAED,0GAA0G;AAC1G,MAAM,OAAO,0BAA2B,SAAQ,cAAc;IACnD,OAAO,GAAG,qBAAqB,CAAC;IACtB,WAAW,GAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC;IACnB,OAAO,GAAG,iBAAiB,CAAC;IAC5B,WAAW,GAAG,iBAAiB,CAAC;IAEnD,IAAuB,cAAc;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAES,MAAM,CAAC,QAAiB,EAAE,OAAgB;QAClD,IAAI,CAAC,GAAG,CACN,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,uBAAuB,EACnD,aAAa,CAAC,OAAO,CAAC,CACvB,CAAC;IACJ,CAAC;CACF"}

package/dist/accessory/services/body.d.ts

@@ -0,0 +1,33 @@
+import type { Service } from "homebridge";
+import type { Vehicle } from "../../api/types.js";
+import type { FeatureToggles } from "../../config.js";
+import { type BodyValues } from "../../vehicle/mapping.js";
+import { ServiceBinding, type BindingContext, type ServiceType } from "./common.js";
+type BodyFeature = Extract<keyof FeatureToggles, "doors" | "windows" | "trunk" | "bonnet" | "sunroof" | "lock">;
+interface ContactDefinition {
+    feature: BodyFeature;
+    displayName: string;
+    /** `true` means "contact not detected" (open, or unlocked for the lock sensor). */
+    isOpen: (values: BodyValues) => boolean | undefined;
+}
+export declare class ContactBinding extends ServiceBinding {
+    private readonly definition;
+    readonly feature: BodyFeature;
+    protected readonly serviceType: ServiceType;
+    protected readonly subtype: string;
+    protected readonly displayName: string;
+    constructor(ctx: BindingContext, definition: ContactDefinition);
+    protected get hasStatusFault(): boolean;
+    protected render(_service: Service, vehicle: Vehicle): void;
+}
+export declare function contactBindings(ctx: BindingContext): ContactBinding[];
+/** Occupancy sensor "Home": parked within the configured radius around the home coordinates. */
+export declare class PresenceBinding extends ServiceBinding {
+    readonly feature = "presence";
+    protected readonly serviceType: ServiceType;
+    protected readonly subtype = "home";
+    protected readonly displayName = "Home";
+    protected get hasStatusFault(): boolean;
+    protected render(_service: Service, vehicle: Vehicle): void;
+}
+export {};