homebridge-rivian 1.3.0

package/CHANGELOG.md

@@ -0,0 +1,102 @@
+# Changelog
+
+All notable changes to this project are documented here. This project adheres
+to [Semantic Versioning](https://semver.org/).
+
+## 1.3.0
+
+- Front seats are now **Heater/Cooler tiles** (Driver + Passenger) that switch
+  between Off / Heat / Cool, replacing the old front seat-cooling switch
+  (`enableSeatCooling` still works as an alias for `enableFrontSeats`).
+- Add optional **second-row seat heating** and **heated steering wheel** switches
+  (both models).
+- Note: Rivian's unofficial API exposes no suspension/ride-height command, so
+  that can't be controlled.
+
+## 1.2.0
+
+- Add optional **third-row seat heating** switch for the R1S.
+- Add optional **gear tunnel** side-bin controls for the R1T (left/right release
+  switches; open-only, since the API can't close the bins - they reflect actual
+  state). Both are off by default and shown only for the matching model.
+
+## 1.1.0
+
+- R1S support: the rear closure is now model-aware. R1S gets a powered
+  **liftgate (trunk)** Garage Door tile that opens AND closes with state; R1T
+  keeps the drop **tailgate** switch. The **tonneau** control is automatically
+  hidden on the R1S.
+- Frunk, lock, climate, windows, seat cooling, and battery already work on both
+  R1T and R1S.
+
+## 1.0.7
+
+- Pairing is now documented and presented as a laptop-browser step (Chrome/Edge,
+  or Android Chrome). iPhone/iPad browsers can't do Web Bluetooth, so they can't
+  pair - but control works from iPhone normally once paired.
+- Wizard now offers a direct "Open Bluetooth pairing page" link (data pre-filled)
+  in addition to copy/paste, and clearer device guidance.
+
+## 1.0.6
+
+- Add a phone-based Bluetooth pairing flow built into the setup wizard: a
+  "Show pairing steps" panel hands your per-vehicle pairing data to a hosted
+  HTTPS Web Bluetooth page you open on your phone (Bluefy on iOS, Chrome on
+  Android) and tap Pair - no laptop, Raspberry Pi Bluetooth, or Python needed.
+- Add the hosted pairing page (docs/pair.html) and a `/pairing-data` UI server
+  endpoint (looks up vasVehicleId live if not stored).
+- Improve the standalone pairing script's diagnostics (BLE GATT map dump).
+
+## 1.0.5
+
+- Cabin climate is now a Thermostat tile: shows current cabin temperature and
+  lets you pick Off/Heat/Cool/Auto and a target temperature (16-29 C). Maps to
+  Rivian cabin preconditioning + set-temp.
+- Add an optional front Seat Cooling switch (off by default).
+- Revert Windows to a single vent (open all) / close all switch, since Rivian's
+  API has no per-window or partial-vent control.
+- Add `scripts/pair_rivian_ble.py` to perform the one-time Bluetooth pairing of
+  the enrolled phone key. This is REQUIRED for commands to work - an enrolled
+  but unpaired key is accepted by the cloud but ignored by the vehicle.
+- Store the VAS vehicle id at enrollment (used by BLE pairing).
+
+## 1.0.4
+
+- Windows are now a Window tile (slider): 100% opens all windows, 0% closes
+  all (values snap, since Rivian's API has no per-window or partial/vent
+  position). Position reflects the reported open/closed state.
+
+## 1.0.3
+
+- Frunk and tonneau are now exposed as Garage Door tiles (clear Open / Closed
+  with opening/closing state) instead of plain switches. The old switch
+  services are removed automatically on upgrade.
+
+## 1.0.2
+
+- Fix a HomeKit warning by sending `FirmwareRevision` (model year) as a string.
+
+## 1.0.1
+
+- Fix accessory naming so each control shows a proper name in the Home app
+  (e.g. "Preconditioning", "Windows", "Frunk") instead of "Switch 1/2/3", by
+  setting the `ConfiguredName` characteristic on every service.
+- Fix charging detection: `charging_ready` (plugged in, not charging) is no
+  longer reported as actively charging.
+- Refresh a vehicle's state shortly after sending a command so switches
+  reflect the real state quickly instead of waiting for the next poll.
+- Support Node.js 24 in `engines`.
+
+## 1.0.0
+
+Initial release.
+
+- Dynamic platform plugin for Rivian vehicles (R1T / R1S / R2).
+- In-browser setup wizard (no command line): sign in, MFA, vehicle selection,
+  and phone-key enrollment from the plugin's settings page.
+- `rivian-homebridge-auth` CLI as a headless alternative (enroll / status /
+  disenroll).
+- HomeKit accessories: lock/unlock, battery % + charging, cabin
+  preconditioning, all windows, frunk, tailgate/liftgate, powered tonneau.
+- Command signing via secp256r1 ECDH + HKDF-SHA256 + HMAC-SHA256.
+- Per-control enable/disable toggles and configurable polling interval.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 homebridge-rivian contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,233 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/homebridge/branding/latest/logos/homebridge-wordmark-logo-vertical.png" width="120">
+</p>
+
+# Homebridge Rivian
+
+[![npm](https://img.shields.io/npm/v/homebridge-rivian.svg)](https://www.npmjs.com/package/homebridge-rivian)
+[![npm downloads](https://img.shields.io/npm/dt/homebridge-rivian.svg)](https://www.npmjs.com/package/homebridge-rivian)
+[![license](https://img.shields.io/npm/l/homebridge-rivian.svg)](LICENSE)
+
+Control your **Rivian** (R1T, R1S, R2) from the Apple **Home** app and Siri, through [Homebridge](https://homebridge.io).
+
+- Lock / unlock
+- Battery % and charging status
+- Cabin preconditioning (warm up / cool down)
+- Open / close all windows
+- Front trunk (frunk)
+- Tailgate / liftgate
+- Powered tonneau cover (R1T)
+
+> **Unofficial.** This project is not affiliated with, endorsed by, or supported by Rivian. It uses the same private API the Rivian mobile app uses. APIs can change at any time and break the plugin.
+
+---
+
+## Requirements
+
+- A working [Homebridge](https://github.com/homebridge/homebridge/wiki) install (the [Homebridge UI](https://github.com/homebridge/homebridge-config-ui-x) is strongly recommended).
+- Your **Rivian account** email and password (the same one you use in the Rivian app).
+- A free **phone-key slot**. Rivian allows **2 phone keys per vehicle**; this plugin uses one of them. If both are in use, remove one in the Rivian app first (Profile -> your vehicle -> Digital Keys), or remove it later from this plugin.
+- **For the one-time key pairing: a laptop/desktop with Bluetooth running Google Chrome or Microsoft Edge** (or Chrome on Android), that you can bring within Bluetooth range of the vehicle.
+  - This is **required** and is a hard browser limitation: pairing uses the [Web Bluetooth API](https://developer.mozilla.org/docs/Web/API/Web_Bluetooth_API), which **does not work in any iPhone/iPad browser** (Apple does not implement it in iOS WebKit). Safari and Firefox are not supported on any platform.
+  - You only need this once. After the key is paired, all control runs through Rivian's cloud and works from any Apple Home / iPhone normally - no laptop or Bluetooth needed again.
+  - **Gen1 vehicles only** (the BLE pairing protocol for Gen2 has not been reverse-engineered).
+
+---
+
+## Install
+
+### Option A - Homebridge UI (recommended)
+
+1. Open the Homebridge UI in your browser.
+2. Go to the **Plugins** tab and search for **`homebridge-rivian`**.
+3. Click **Install**.
+
+### Option B - Command line
+
+```bash
+sudo hb-service add homebridge-rivian
+# or, for a manual Homebridge install:
+sudo npm install -g homebridge-rivian
+```
+
+---
+
+## Connect your Rivian (the setup wizard)
+
+After installing, you connect your account from the plugin's settings page. **No command line needed.**
+
+1. In the Homebridge UI **Plugins** tab, find **Homebridge Rivian** and click **Settings**.
+2. At the top you'll see the **Sign in & enroll** panel.
+3. Enter your **Rivian email and password**, then click **Continue**.
+   - Your password is sent only to Rivian to log in. It is **never saved** to disk.
+4. If your account uses two-factor authentication, you'll be asked for the **verification code** Rivian texts/emails you. Enter it and click **Verify**.
+5. Pick which **vehicle(s)** you want to control, give the key a name (default `Homebridge`), and click **Enroll & finish**.
+   - This registers a digital "phone key" for each selected vehicle. It will appear in the Rivian app under your vehicle's Digital Keys, and **uses one of your two key slots per vehicle**.
+6. **Restart Homebridge** (or the child bridge) when prompted. Your Rivian accessories now appear in the Home app.
+
+The plugin stores a session token and a key that lives only on your Homebridge machine.
+
+### Step 2 - Pair the key over Bluetooth from a laptop (REQUIRED for commands)
+
+Enrolling registers the key, but Rivian will not execute commands from it until
+it is **paired with the vehicle over Bluetooth** (the key shows `isPaired: false`
+until then). Until you do this, **reads work but lock / climate / windows / etc.
+silently do nothing** (the cloud accepts the command, but the truck ignores it).
+
+This is a **one-time** step. You need a **laptop/desktop with Bluetooth running
+Chrome or Edge** (Android Chrome also works). **iPhones/iPads cannot do this** -
+no iOS browser supports Web Bluetooth (see Requirements).
+
+1. Bring the laptop within Bluetooth range of the vehicle (sitting in or right
+   next to it is best).
+2. In the Homebridge UI, open the plugin **Settings** and click
+   **Show pairing steps** under "Enable vehicle control".
+3. Click **Open Bluetooth pairing page** for your vehicle. It opens a secure
+   page (`https://<your-fork>.github.io/homebridge-rivian/pair.html`) with your
+   data already loaded. (If you opened the Homebridge UI on a different machine,
+   use **Copy pairing data** and paste it into that page on the laptop instead.)
+4. On the **vehicle touchscreen**: Settings -> Drivers & Keys, select the
+   `Homebridge` key and tap **Set Up**.
+5. On the pairing page click **Connect to Bluetooth & pair**, choose
+   **Rivian Phone Key** in the browser's Bluetooth chooser, and approve.
+
+When it shows `SUCCESS`, the key is paired and commands work. From then on
+everything works from your iPhone / Apple Home over the cloud.
+
+### Advanced / headless alternative (Python)
+
+If you'd rather pair from a command line on a Bluetooth-capable computer next to
+the vehicle (instead of a browser):
+
+```bash
+pip install bleak cryptography   # Linux also: pip install dbus-fast
+python scripts/pair_rivian_ble.py --auth /var/lib/homebridge/rivian-auth.json
+```
+
+Tap **Set Up** for the `Homebridge` key on the vehicle screen when it starts
+scanning. It prints `SUCCESS` when paired.
+
+### Headless / Docker alternative (CLI)
+
+If you can't use the UI, run the bundled CLI on the Homebridge host:
+
+```bash
+# enroll (interactive: email, password, MFA code, vehicle selection)
+rivian-homebridge-auth --storage /var/lib/homebridge
+
+# check status
+rivian-homebridge-auth status --storage /var/lib/homebridge
+
+# remove the key from your account and delete local credentials
+rivian-homebridge-auth disenroll --storage /var/lib/homebridge
+```
+
+`--storage` should point at your Homebridge storage directory (where `config.json` lives). It defaults to `~/.homebridge`.
+
+---
+
+## What you get in HomeKit
+
+The plugin creates one accessory per vehicle, with these services (each can be turned off in settings):
+
+| Control | HomeKit type | Notes |
+| --- | --- | --- |
+| Lock / unlock | Lock | Locks/unlocks all closures. State reflects your doors. |
+| Battery % | Humidity sensor + Battery | Shows state of charge as a percentage. |
+| Charging | Contact sensor | "Open" while the vehicle is charging. |
+| Cabin climate | Thermostat | Current cabin temp, Off/Heat/Cool/Auto, and a target temp (16-29 C / ~61-84 F). Maps to Rivian preconditioning. |
+| Front seats | Heater/Cooler (Driver + Passenger) | One tile per seat: Off / Heat / Cool. Off by default. |
+| Second-row seat heat | Switch | Heats both second-row seats. Off by default. |
+| Steering wheel heat | Switch | Off by default. |
+| Windows | Switch | On = open/vent all windows, off = close all (no per-window or partial vent via Rivian's API). |
+| Frunk | Garage Door | Open / close with Open/Closed state (R1T and R1S). |
+| Rear trunk | Garage Door (R1S liftgate) or Switch (R1T tailgate) | Auto-selected by model. R1S powered liftgate opens AND closes with state; R1T tailgate opens/drops (the API can't close it or report its position). |
+| Tonneau | Garage Door | R1T with the powered tonneau only; automatically hidden on R1S. |
+
+### Vehicle differences (auto-detected)
+
+The plugin reads your vehicle's model and adjusts:
+
+- **R1S:** rear closure is a powered **liftgate** (open + close); **no tonneau**.
+- **R1T:** rear closure is the **tailgate** (open/drop); optional **tonneau** if equipped.
+- Frunk, lock, climate, windows, battery, and (optional) front-seat heat/cool, second-row seat heat, and heated steering wheel work the same on both.
+- **R1S only (optional, off by default):** third-row seat heating switch.
+- **R1T only (optional, off by default):** gear tunnel side-bin release (two switches, left/right). The API can only open a bin - you close it by hand - so the switch reflects the bin's actual state.
+
+### Settings
+
+- **Polling interval** - how often vehicle state refreshes (default 60s, minimum 30s). Lower = faster updates but more API calls.
+- **Controls to expose** - enable/disable each accessory above.
+- **Verbose debug logging** - extra logs for troubleshooting.
+
+---
+
+## Important caveats (please read)
+
+These are limits of Rivian's API, not bugs:
+
+- **No partial window "vent."** Rivian's cloud API only supports opening or closing *all* windows together. There is no partial-vent command, so the Windows switch fully opens/closes.
+- **No suspension / ride-height control.** Rivian's unofficial API has no command for ride height (kneel/low/standard/high), so it can't be exposed - even though the official app can do it.
+- **Cabin preconditioning** is exposed as a Thermostat (current temp + target temp + on/off); Rivian decides whether to heat or cool to reach the target. Seat heat/cool and steering heat are simple on/off (level is fixed when on).
+- **The vehicle may be asleep.** Commands first try directly, then wake the vehicle and retry. The first command after a long idle period can take a few extra seconds.
+- **Some controls depend on your vehicle/options** (e.g. powered tonneau is R1T-only; liftgate close is R1S). Unsupported commands simply do nothing on the car.
+
+---
+
+## Security & privacy
+
+- Your **password is never stored**. It's used once to obtain session tokens.
+- The plugin generates a **secp256r1 key pair locally**. Only the *public* half is sent to Rivian (for enrollment). The private key stays on your machine and is used to sign commands.
+- Tokens and the key are saved to `rivian-auth.json` in your Homebridge storage directory, with restrictive file permissions. Keep that file private and never commit it to a repo.
+- To revoke access, click **Disconnect & remove key** in the plugin settings (or run `rivian-homebridge-auth disenroll`). This removes the phone key from your Rivian account and deletes the local credentials. You can also remove it any time from the Rivian app.
+
+---
+
+## Troubleshooting
+
+- **"Not signed in yet" in the logs** - open the plugin settings and complete the Sign in & enroll wizard.
+- **Commands do nothing (reads still work)** - the phone key almost certainly isn't paired yet. Complete "Step 2 - Pair the key over Bluetooth" above. You can confirm in the Rivian app that the `Homebridge` key shows as set up/paired.
+- **"Rivian session expired"** - re-run the sign-in wizard to refresh your session.
+- **Phone key limit reached** - remove an unused key in the Rivian app (Profile -> vehicle -> Digital Keys) and enroll again.
+- **Enable Verbose debug logging** in settings to see detailed request/error logs, then check the Homebridge logs.
+
+---
+
+## How it works
+
+```
+Setup wizard (login + MFA + EnrollPhone)
+        |
+        v
+rivian-auth.json  (session tokens + local key + vehicle ids)
+        |
+        v
+Homebridge platform  --- poll state --->  Rivian GraphQL API
+                     --- signed commands ->
+        |
+        v
+HomeKit accessories (Apple Home app)
+```
+
+Commands are signed exactly like the Rivian app: an ECDH shared secret between your enrolled key and the vehicle's key is run through HKDF-SHA256, then used as the HMAC-SHA256 key over `command + timestamp`.
+
+---
+
+## Credits
+
+- The community that reverse-engineered the Rivian API, especially [bretterer/rivian-python-client](https://github.com/bretterer/rivian-python-client) and the [RivDocs](https://rivian-api.kaedenb.org/) project.
+
+## Contributing
+
+Issues and PRs welcome. Please don't include any tokens, VINs, or the contents of `rivian-auth.json` in bug reports.
+
+## Support this project
+
+This plugin is free and open source. If it's useful to you, a tip is appreciated (entirely optional):
+
+- **Venmo:** [@thomas-whippld](https://venmo.com/u/thomas-whippld)
+- **GitHub Sponsors:** [github.com/sponsors/tvearl](https://github.com/sponsors/tvearl) _(pending approval)_
+
+## License
+
+[MIT](LICENSE)

package/config.schema.json

@@ -0,0 +1,123 @@
+{
+  "pluginAlias": "RivianHomebridge",
+  "pluginType": "platform",
+  "singular": true,
+  "customUi": true,
+  "headerDisplay": "Control your Rivian from Apple Home. Use the **Sign in & enroll** panel above to connect your account, then choose which controls to expose below.",
+  "footerDisplay": "Unofficial plugin - not affiliated with Rivian. Enrolling uses one of your two phone-key slots per vehicle.",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "title": "Name",
+        "type": "string",
+        "default": "Rivian",
+        "required": true
+      },
+      "pollIntervalSeconds": {
+        "title": "Polling interval (seconds)",
+        "type": "integer",
+        "default": 60,
+        "minimum": 30,
+        "maximum": 3600,
+        "description": "How often to refresh vehicle state. Lower values update faster but use more API calls and battery."
+      },
+      "enableLock": {
+        "title": "Lock / unlock (all closures)",
+        "type": "boolean",
+        "default": true
+      },
+      "enableBattery": {
+        "title": "Battery % and charging status",
+        "type": "boolean",
+        "default": true
+      },
+      "enableClimate": {
+        "title": "Cabin climate (thermostat: current temp + preconditioning)",
+        "type": "boolean",
+        "default": true
+      },
+      "enableFrontSeats": {
+        "title": "Front seats heating + cooling (Driver & Passenger tiles)",
+        "type": "boolean",
+        "default": false
+      },
+      "enableRearSeatHeat": {
+        "title": "Second-row seat heating",
+        "type": "boolean",
+        "default": false
+      },
+      "enableSteeringHeat": {
+        "title": "Heated steering wheel",
+        "type": "boolean",
+        "default": false
+      },
+      "enableThirdRowHeat": {
+        "title": "Third-row seat heating (R1S only)",
+        "type": "boolean",
+        "default": false
+      },
+      "enableGearTunnel": {
+        "title": "Gear tunnel side bins (R1T only)",
+        "type": "boolean",
+        "default": false
+      },
+      "enableWindows": {
+        "title": "Open / close all windows",
+        "type": "boolean",
+        "default": true
+      },
+      "enableFrunk": {
+        "title": "Front trunk (frunk)",
+        "type": "boolean",
+        "default": true
+      },
+      "enableTailgate": {
+        "title": "Rear trunk - tailgate (R1T) or powered liftgate (R1S)",
+        "type": "boolean",
+        "default": false
+      },
+      "enableTonneau": {
+        "title": "Powered tonneau cover (R1T only; ignored on R1S)",
+        "type": "boolean",
+        "default": false
+      },
+      "debug": {
+        "title": "Verbose debug logging",
+        "type": "boolean",
+        "default": false
+      }
+    }
+  },
+  "layout": [
+    "name",
+    "pollIntervalSeconds",
+    {
+      "type": "fieldset",
+      "title": "Controls to expose",
+      "expandable": true,
+      "expanded": true,
+      "items": [
+        "enableLock",
+        "enableBattery",
+        "enableClimate",
+        "enableFrontSeats",
+        "enableRearSeatHeat",
+        "enableSteeringHeat",
+        "enableThirdRowHeat",
+        "enableWindows",
+        "enableFrunk",
+        "enableTailgate",
+        "enableTonneau",
+        "enableGearTunnel"
+      ]
+    },
+    {
+      "type": "fieldset",
+      "title": "Advanced",
+      "expandable": true,
+      "expanded": false,
+      "items": ["debug"]
+    }
+  ]
+}

package/dist/accessories/battery.d.ts

@@ -0,0 +1,17 @@
+import type { PlatformAccessory } from 'homebridge';
+import type { RivianHomebridgePlatform, RivianAccessory } from '../platform';
+import type { StoredVehicle } from '../persist';
+import { VehicleStateValues } from '../commands';
+/**
+ * Exposes state of charge as a Humidity sensor (so it shows a readable %),
+ * a Battery service (level + charging + low-battery), and a Contact sensor
+ * that "opens" while charging.
+ */
+export declare class BatteryAccessory implements RivianAccessory {
+    private readonly platform;
+    private readonly humidity;
+    private readonly battery;
+    private readonly charging;
+    constructor(platform: RivianHomebridgePlatform, accessory: PlatformAccessory, vehicle: StoredVehicle);
+    update(values: VehicleStateValues): void;
+}

package/dist/accessories/battery.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BatteryAccessory = void 0;
+const state_1 = require("../state");
+const util_1 = require("./util");
+const LOW_BATTERY_THRESHOLD = 20;
+/**
+ * Exposes state of charge as a Humidity sensor (so it shows a readable %),
+ * a Battery service (level + charging + low-battery), and a Contact sensor
+ * that "opens" while charging.
+ */
+class BatteryAccessory {
+    platform;
+    humidity;
+    battery;
+    charging;
+    constructor(platform, accessory, vehicle) {
+        this.platform = platform;
+        const { Service } = this.platform;
+        this.humidity =
+            accessory.getServiceById(Service.HumiditySensor, 'rivian-soc') ||
+                accessory.addService(Service.HumiditySensor, `${vehicle.name} Battery`, 'rivian-soc');
+        this.battery =
+            accessory.getServiceById(Service.Battery, 'rivian-battery') ||
+                accessory.addService(Service.Battery, `${vehicle.name} Battery Level`, 'rivian-battery');
+        this.charging =
+            accessory.getServiceById(Service.ContactSensor, 'rivian-charging') ||
+                accessory.addService(Service.ContactSensor, `${vehicle.name} Charging`, 'rivian-charging');
+        (0, util_1.nameService)(this.platform, this.humidity, `${vehicle.name} Battery`);
+        (0, util_1.nameService)(this.platform, this.battery, `${vehicle.name} Battery Level`);
+        (0, util_1.nameService)(this.platform, this.charging, `${vehicle.name} Charging`);
+    }
+    update(values) {
+        const { Characteristic } = this.platform;
+        const soc = (0, state_1.toNumber)(values.batteryLevel);
+        const charging = (0, state_1.isCharging)(values.chargerStatus, values.chargerState);
+        if (soc !== undefined) {
+            const clamped = Math.max(0, Math.min(100, Math.round(soc)));
+            this.humidity.updateCharacteristic(Characteristic.CurrentRelativeHumidity, clamped);
+            this.battery.updateCharacteristic(Characteristic.BatteryLevel, clamped);
+            this.battery.updateCharacteristic(Characteristic.StatusLowBattery, clamped <= LOW_BATTERY_THRESHOLD
+                ? Characteristic.StatusLowBattery.BATTERY_LEVEL_LOW
+                : Characteristic.StatusLowBattery.BATTERY_LEVEL_NORMAL);
+        }
+        this.battery.updateCharacteristic(Characteristic.ChargingState, charging ? Characteristic.ChargingState.CHARGING : Characteristic.ChargingState.NOT_CHARGING);
+        this.charging.updateCharacteristic(Characteristic.ContactSensorState, charging
+            ? Characteristic.ContactSensorState.CONTACT_NOT_DETECTED
+            : Characteristic.ContactSensorState.CONTACT_DETECTED);
+    }
+}
+exports.BatteryAccessory = BatteryAccessory;
+//# sourceMappingURL=battery.js.map

package/dist/accessories/battery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"battery.js","sourceRoot":"","sources":["../../src/accessories/battery.ts"],"names":[],"mappings":";;;AAIA,oCAAgD;AAChD,iCAAqC;AAErC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAEjC;;;;GAIG;AACH,MAAa,gBAAgB;IAMR;IALF,QAAQ,CAAU;IAClB,OAAO,CAAU;IACjB,QAAQ,CAAU;IAEnC,YACmB,QAAkC,EACnD,SAA4B,EAC5B,OAAsB;QAFL,aAAQ,GAAR,QAAQ,CAA0B;QAInD,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;QAElC,IAAI,CAAC,QAAQ;YACX,SAAS,CAAC,cAAc,CAAC,OAAO,CAAC,cAAc,EAAE,YAAY,CAAC;gBAC9D,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,UAAU,EAAE,YAAY,CAAC,CAAC;QAExF,IAAI,CAAC,OAAO;YACV,SAAS,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,gBAAgB,CAAC;gBAC3D,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;QAE3F,IAAI,CAAC,QAAQ;YACX,SAAS,CAAC,cAAc,CAAC,OAAO,CAAC,aAAa,EAAE,iBAAiB,CAAC;gBAClE,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,WAAW,EAAE,iBAAiB,CAAC,CAAC;QAE7F,IAAA,kBAAW,EAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,UAAU,CAAC,CAAC;QACrE,IAAA,kBAAW,EAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,gBAAgB,CAAC,CAAC;QAC1E,IAAA,kBAAW,EAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,WAAW,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,CAAC,MAA0B;QAC/B,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;QACzC,MAAM,GAAG,GAAG,IAAA,gBAAQ,EAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC1C,MAAM,QAAQ,GAAG,IAAA,kBAAU,EAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QAEvE,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC5D,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAC,cAAc,CAAC,uBAAuB,EAAE,OAAO,CAAC,CAAC;YACpF,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,cAAc,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACxE,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAC/B,cAAc,CAAC,gBAAgB,EAC/B,OAAO,IAAI,qBAAqB;gBAC9B,CAAC,CAAC,cAAc,CAAC,gBAAgB,CAAC,iBAAiB;gBACnD,CAAC,CAAC,cAAc,CAAC,gBAAgB,CAAC,oBAAoB,CACzD,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAC/B,cAAc,CAAC,aAAa,EAC5B,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,aAAa,CAAC,YAAY,CAC7F,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAChC,cAAc,CAAC,kBAAkB,EACjC,QAAQ;YACN,CAAC,CAAC,cAAc,CAAC,kBAAkB,CAAC,oBAAoB;YACxD,CAAC,CAAC,cAAc,CAAC,kBAAkB,CAAC,gBAAgB,CACvD,CAAC;IACJ,CAAC;CACF;AA1DD,4CA0DC"}

package/dist/accessories/climate.d.ts

@@ -0,0 +1,24 @@
+import type { PlatformAccessory } from 'homebridge';
+import type { RivianHomebridgePlatform, RivianAccessory } from '../platform';
+import type { StoredVehicle } from '../persist';
+import { VehicleStateValues } from '../commands';
+/**
+ * Cabin preconditioning as a Thermostat tile.
+ *
+ * Rivian's cloud API does not expose a true live thermostat: it can enable /
+ * disable preconditioning and set a target temperature, and the vehicle decides
+ * whether to heat or cool to reach it. We therefore map:
+ *   - Off  -> disable preconditioning
+ *   - Heat / Cool / Auto -> enable preconditioning + set target temperature
+ * Current temperature is the reported cabin interior temperature.
+ */
+export declare class ClimateAccessory implements RivianAccessory {
+    private readonly platform;
+    private readonly vehicle;
+    private readonly service;
+    private targetTempC;
+    constructor(platform: RivianHomebridgePlatform, accessory: PlatformAccessory, vehicle: StoredVehicle);
+    private setMode;
+    private setTargetTemp;
+    update(values: VehicleStateValues): void;
+}