tesla-fleet-api 0.5.0 → 0.6.0

package/README.md

@@ -27,7 +27,6 @@ It needs Node 22 or later, ships ESM and CommonJS, and has one runtime dependenc
 | `tesla-fleet-api/bluetooth` | `TeslaBluetooth`, `VehicleBluetooth`, the `BleTransport` contract, stream glue |
 | `tesla-fleet-api/bluetooth/homey` | Bluetooth through a Homey app |
 | `tesla-fleet-api/bluetooth/noble` | Bluetooth through `@stoprocent/noble` |
-| `tesla-fleet-api/bluetooth/esphome` | Bluetooth through an ESPHome proxy |
 | `tesla-fleet-api/tariff` | `getTariffPeriods`, `unwrapTariffV2`, with no protobuf code |
 | `tesla-fleet-api/const` | Enums, `Models`, `Region`, `SERVERS` |
 | `tesla-fleet-api/types` | Response types |
@@ -135,7 +134,6 @@ Install the backend you want, and pass its transport to `createBluetooth`. Each
 | -- | -- | -- | -- |
 | `./bluetooth/homey` | `HomeyBleTransport` | Nothing. It takes `this.homey.ble`. | A Homey app |
 | `./bluetooth/noble` | `NobleBleTransport` | `@stoprocent/noble`, which is native | Linux, macOS, Windows |
-| `./bluetooth/esphome` | `EsphomeBleTransport` | `@2colors/esphome-native-api` | Anything with a TCP route to a dedicated proxy |
 
 On a computer:
 
@@ -152,19 +150,6 @@ await vehicle.charge_state();
 await vehicle.disconnect();
 ```
 
-Through an ESPHome proxy:
-
-```ts
-import { TeslaBluetooth } from "tesla-fleet-api/bluetooth";
-import { EsphomeBleTransport } from "tesla-fleet-api/bluetooth/esphome";
-
-const transport = new EsphomeBleTransport({ host: proxyHost, encryptionKey });
-const vehicle = new TeslaBluetooth({ privateKey }).vehicles.createBluetooth(vin, { transport });
-await vehicle.door_lock();
-await vehicle.disconnect();
-transport.close();
-```
-
 In a Homey app, which needs the `homey:wireless:ble` permission:
 
 ```ts
@@ -187,7 +172,7 @@ class TeslaApp extends Homey.App {
 export default TeslaApp;
 ```
 
-The Homey adapter's defaults are conservative guesses until the BLE-00 probe has run on a Homey. `confirmation` sets how much proof a command needs: `"optimistic"`, `"ack"` (the default) or `"verify"`. New keys are enrolled with `vehicle.pair()`. [docs/bluetooth_vehicles.md](docs/bluetooth_vehicles.md) has every option and each adapter's limits.
+The Homey adapter's defaults come from a BLE-00 run on a real Homey (one write per frame, a 15 s scan bound). `confirmation` sets how much proof a command needs: `"optimistic"`, `"ack"` (the default) or `"verify"`. New keys are enrolled with `vehicle.pair()`. [docs/bluetooth_vehicles.md](docs/bluetooth_vehicles.md) has every option and each adapter's limits.
 
 ## Local Powerwall
 

package/dist/bluetooth/constants.cjs

@@ -17,8 +17,6 @@ const NAME_UUID = "00002a00-0000-1000-8000-00805f9b34fb";
 const APPEARANCE_UUID = "00002a01-0000-1000-8000-00805f9b34fb";
 /** Generic Access, for a backend that needs a service UUID to reach the two above. */
 const GENERIC_ACCESS_UUID = "00001800-0000-1000-8000-00805f9b34fb";
-/** Client Characteristic Configuration. Only an ESPHome proxy needs it written by hand. */
-const CCCD_UUID = "00002902-0000-1000-8000-00805f9b34fb";
 /** Largest frame accepted, length prefix included. Tesla's Go SDK allows 2 more bytes. */
 const MAX_FRAME_SIZE = 1024;
 /**
@@ -56,7 +54,7 @@ const DEFAULT_PAIR_POLL_INTERVAL_MS = 5e3;
 const DEFAULT_CONNECT_ATTEMPTS = 3;
 /** One connect attempt. Python takes the same figure from `bleak-retry-connector`. */
 const DEFAULT_CONNECT_TIMEOUT_MS = 2e4;
-/** One scan. It must outlast the backend's window, which Homey fixes at about 5 s. */
+/** One scan. It must outlast the backend's window, which Homey fixes at about 10 s: its adapter sets its own bound. */
 const DEFAULT_SCAN_TIMEOUT_MS = 1e4;
 /** Bound on tearing down a link: the failure behind it is what gets reported. */
 const LINK_TEARDOWN_TIMEOUT_MS = 5e3;
@@ -70,7 +68,6 @@ const GATT_WRITE_TIMEOUT_MS = 5e3;
 /** One read call, other than a keepalive's. */
 const GATT_READ_TIMEOUT_MS = 5e3;
 exports.APPEARANCE_UUID = APPEARANCE_UUID;
-exports.CCCD_UUID = CCCD_UUID;
 exports.CHARGE_PORT_VERIFY_INTERVAL_MS = CHARGE_PORT_VERIFY_INTERVAL_MS;
 exports.CHARGE_PORT_VERIFY_TIMEOUT_MS = CHARGE_PORT_VERIFY_TIMEOUT_MS;
 exports.DEFAULT_CONNECT_ATTEMPTS = DEFAULT_CONNECT_ATTEMPTS;

package/dist/bluetooth/constants.d.cts

@@ -16,8 +16,6 @@ export declare const NAME_UUID = "00002a00-0000-1000-8000-00805f9b34fb";
 export declare const APPEARANCE_UUID = "00002a01-0000-1000-8000-00805f9b34fb";
 /** Generic Access, for a backend that needs a service UUID to reach the two above. */
 export declare const GENERIC_ACCESS_UUID = "00001800-0000-1000-8000-00805f9b34fb";
-/** Client Characteristic Configuration. Only an ESPHome proxy needs it written by hand. */
-export declare const CCCD_UUID = "00002902-0000-1000-8000-00805f9b34fb";
 /** Largest frame accepted, length prefix included. Tesla's Go SDK allows 2 more bytes. */
 export declare const MAX_FRAME_SIZE = 1024;
 /**
@@ -55,7 +53,7 @@ export declare const DEFAULT_PAIR_POLL_INTERVAL_MS = 5000;
 export declare const DEFAULT_CONNECT_ATTEMPTS = 3;
 /** One connect attempt. Python takes the same figure from `bleak-retry-connector`. */
 export declare const DEFAULT_CONNECT_TIMEOUT_MS = 20000;
-/** One scan. It must outlast the backend's window, which Homey fixes at about 5 s. */
+/** One scan. It must outlast the backend's window, which Homey fixes at about 10 s: its adapter sets its own bound. */
 export declare const DEFAULT_SCAN_TIMEOUT_MS = 10000;
 /** Bound on tearing down a link: the failure behind it is what gets reported. */
 export declare const LINK_TEARDOWN_TIMEOUT_MS = 5000;

package/dist/bluetooth/constants.d.mts

@@ -16,8 +16,6 @@ export declare const NAME_UUID = "00002a00-0000-1000-8000-00805f9b34fb";
 export declare const APPEARANCE_UUID = "00002a01-0000-1000-8000-00805f9b34fb";
 /** Generic Access, for a backend that needs a service UUID to reach the two above. */
 export declare const GENERIC_ACCESS_UUID = "00001800-0000-1000-8000-00805f9b34fb";
-/** Client Characteristic Configuration. Only an ESPHome proxy needs it written by hand. */
-export declare const CCCD_UUID = "00002902-0000-1000-8000-00805f9b34fb";
 /** Largest frame accepted, length prefix included. Tesla's Go SDK allows 2 more bytes. */
 export declare const MAX_FRAME_SIZE = 1024;
 /**
@@ -55,7 +53,7 @@ export declare const DEFAULT_PAIR_POLL_INTERVAL_MS = 5000;
 export declare const DEFAULT_CONNECT_ATTEMPTS = 3;
 /** One connect attempt. Python takes the same figure from `bleak-retry-connector`. */
 export declare const DEFAULT_CONNECT_TIMEOUT_MS = 20000;
-/** One scan. It must outlast the backend's window, which Homey fixes at about 5 s. */
+/** One scan. It must outlast the backend's window, which Homey fixes at about 10 s: its adapter sets its own bound. */
 export declare const DEFAULT_SCAN_TIMEOUT_MS = 10000;
 /** Bound on tearing down a link: the failure behind it is what gets reported. */
 export declare const LINK_TEARDOWN_TIMEOUT_MS = 5000;

package/dist/bluetooth/constants.mjs

@@ -17,8 +17,6 @@ const NAME_UUID = "00002a00-0000-1000-8000-00805f9b34fb";
 const APPEARANCE_UUID = "00002a01-0000-1000-8000-00805f9b34fb";
 /** Generic Access, for a backend that needs a service UUID to reach the two above. */
 const GENERIC_ACCESS_UUID = "00001800-0000-1000-8000-00805f9b34fb";
-/** Client Characteristic Configuration. Only an ESPHome proxy needs it written by hand. */
-const CCCD_UUID = "00002902-0000-1000-8000-00805f9b34fb";
 /** Largest frame accepted, length prefix included. Tesla's Go SDK allows 2 more bytes. */
 const MAX_FRAME_SIZE = 1024;
 /**
@@ -56,7 +54,7 @@ const DEFAULT_PAIR_POLL_INTERVAL_MS = 5e3;
 const DEFAULT_CONNECT_ATTEMPTS = 3;
 /** One connect attempt. Python takes the same figure from `bleak-retry-connector`. */
 const DEFAULT_CONNECT_TIMEOUT_MS = 2e4;
-/** One scan. It must outlast the backend's window, which Homey fixes at about 5 s. */
+/** One scan. It must outlast the backend's window, which Homey fixes at about 10 s: its adapter sets its own bound. */
 const DEFAULT_SCAN_TIMEOUT_MS = 1e4;
 /** Bound on tearing down a link: the failure behind it is what gets reported. */
 const LINK_TEARDOWN_TIMEOUT_MS = 5e3;
@@ -69,4 +67,4 @@ const LINK_TEARDOWN_TIMEOUT_MS = 5e3;
 const GATT_WRITE_TIMEOUT_MS = 5e3;
 /** One read call, other than a keepalive's. */
 const GATT_READ_TIMEOUT_MS = 5e3;
-export { APPEARANCE_UUID, CCCD_UUID, CHARGE_PORT_VERIFY_INTERVAL_MS, CHARGE_PORT_VERIFY_TIMEOUT_MS, DEFAULT_CONNECT_ATTEMPTS, DEFAULT_CONNECT_TIMEOUT_MS, DEFAULT_KEEPALIVE_INTERVAL_MS, DEFAULT_MAX_WRITE_SIZE, DEFAULT_PAIR_POLL_INTERVAL_MS, DEFAULT_PAIR_TIMEOUT_MS, DEFAULT_SCAN_TIMEOUT_MS, DEFAULT_WAKE_PROBE_TIMEOUT_MS, DEFAULT_WAKE_TIMEOUT_MS, GATT_READ_TIMEOUT_MS, GATT_WRITE_TIMEOUT_MS, GENERIC_ACCESS_UUID, INFOTAINMENT_BOOT_TIMEOUT_MS, LINK_TEARDOWN_TIMEOUT_MS, MAX_FRAME_SIZE, NAME_UUID, READ_UUID, SERVICE_UUID, STALE_CHUNK_TIMEOUT_MS, VEHICLE_NOTIFY_UUID, VEHICLE_WRITE_UUID, VERSION_UUID, WAKE_RESEND_INTERVAL_MS, WRITE_UUID };
+export { APPEARANCE_UUID, CHARGE_PORT_VERIFY_INTERVAL_MS, CHARGE_PORT_VERIFY_TIMEOUT_MS, DEFAULT_CONNECT_ATTEMPTS, DEFAULT_CONNECT_TIMEOUT_MS, DEFAULT_KEEPALIVE_INTERVAL_MS, DEFAULT_MAX_WRITE_SIZE, DEFAULT_PAIR_POLL_INTERVAL_MS, DEFAULT_PAIR_TIMEOUT_MS, DEFAULT_SCAN_TIMEOUT_MS, DEFAULT_WAKE_PROBE_TIMEOUT_MS, DEFAULT_WAKE_TIMEOUT_MS, GATT_READ_TIMEOUT_MS, GATT_WRITE_TIMEOUT_MS, GENERIC_ACCESS_UUID, INFOTAINMENT_BOOT_TIMEOUT_MS, LINK_TEARDOWN_TIMEOUT_MS, MAX_FRAME_SIZE, NAME_UUID, READ_UUID, SERVICE_UUID, STALE_CHUNK_TIMEOUT_MS, VEHICLE_NOTIFY_UUID, VEHICLE_WRITE_UUID, VERSION_UUID, WAKE_RESEND_INTERVAL_MS, WRITE_UUID };

package/dist/bluetooth/homey.cjs

@@ -5,11 +5,19 @@ const require_transport = require("./transport.cjs");
 const require_shared = require("./adapters/shared.cjs");
 // src/bluetooth/adapters/homey.ts
 /**
-* Bytes per write. Homey hides the MTU, so this is the ATT minimum, the one size
-* sure to work. BLE-00 step 6: if a whole 114-byte frame gets a reply, this can
-* become `null`. Otherwise step 7 keeps it, or the MTU estimate less 3 if larger.
+* Bytes per write: `null`, a whole frame in one write. Homey hides the MTU.
+* BLE-00 (HW-0, 2026-11-03) measured a 114-byte frame in one write at 232 ms to
+* a reply, against 562 ms for 6 writes of 20 bytes. Only 114 bytes were tried:
+* a signed frame (about 200 bytes) is confirmed by HW-5. Pass `maxWriteSize: 20`
+* to `HomeyBleTransport` to chunk at the ATT minimum if that run shows a failure.
 */
-const HOMEY_MAX_WRITE_SIZE = 20;
+const HOMEY_MAX_WRITE_SIZE = null;
+/**
+* Bound on one scan. `discover()` takes a fixed 10.04 s when it is not cached
+* (HW-0), so the library's 10 s default would time out about 40 ms early.
+* `VehicleBluetooth` uses this when `scan_timeout_ms` is not set.
+*/
+const HOMEY_SCAN_TIMEOUT_MS = 15e3;
 /**
 * For `connect_timeout_ms` and `max_connect_attempts`, not applied by this
 * adapter: `discover()` caches for 30 s, so a fast retry sees old data, and
@@ -121,10 +129,11 @@ var HomeyBleTransport = class {
 	ble;
 	maxWriteSize;
 	claims = new require_shared.LinkClaims();
+	scanTimeoutMs = HOMEY_SCAN_TIMEOUT_MS;
 	/** @param ble `this.homey.ble`. The app needs the `homey:wireless:ble` permission. */
 	constructor(ble, options = {}) {
 		this.ble = ble;
-		this.maxWriteSize = options.maxWriteSize === void 0 ? 20 : options.maxWriteSize;
+		this.maxWriteSize = options.maxWriteSize === void 0 ? null : options.maxWriteSize;
 	}
 	/** Takes Homey's fixed window, whatever `timeoutMs` says. Never pass `discover` a filter. */
 	async scan({ matches }) {
@@ -149,6 +158,7 @@ var HomeyBleTransport = class {
 	}
 };
 exports.HOMEY_MAX_WRITE_SIZE = HOMEY_MAX_WRITE_SIZE;
+exports.HOMEY_SCAN_TIMEOUT_MS = HOMEY_SCAN_TIMEOUT_MS;
 exports.HOMEY_SETUP_TIMEOUT_MS = HOMEY_SETUP_TIMEOUT_MS;
 exports.HOMEY_UNSUBSCRIBE_TIMEOUT_MS = HOMEY_UNSUBSCRIBE_TIMEOUT_MS;
 exports.HOMEY_VEHICLE_OPTIONS = HOMEY_VEHICLE_OPTIONS;

package/dist/bluetooth/homey.d.cts

@@ -1,10 +1,18 @@
 import { BleConnection, BleDeviceRef, BleLinkHandlers, BleScanOptions, BleTransport } from "./transport.cjs";
 /**
- * Bytes per write. Homey hides the MTU, so this is the ATT minimum, the one size
- * sure to work. BLE-00 step 6: if a whole 114-byte frame gets a reply, this can
- * become `null`. Otherwise step 7 keeps it, or the MTU estimate less 3 if larger.
+ * Bytes per write: `null`, a whole frame in one write. Homey hides the MTU.
+ * BLE-00 (HW-0, 2026-11-03) measured a 114-byte frame in one write at 232 ms to
+ * a reply, against 562 ms for 6 writes of 20 bytes. Only 114 bytes were tried:
+ * a signed frame (about 200 bytes) is confirmed by HW-5. Pass `maxWriteSize: 20`
+ * to `HomeyBleTransport` to chunk at the ATT minimum if that run shows a failure.
  */
-export declare const HOMEY_MAX_WRITE_SIZE = 20;
+export declare const HOMEY_MAX_WRITE_SIZE: null;
+/**
+ * Bound on one scan. `discover()` takes a fixed 10.04 s when it is not cached
+ * (HW-0), so the library's 10 s default would time out about 40 ms early.
+ * `VehicleBluetooth` uses this when `scan_timeout_ms` is not set.
+ */
+export declare const HOMEY_SCAN_TIMEOUT_MS = 15000;
 /**
  * For `connect_timeout_ms` and `max_connect_attempts`, not applied by this
  * adapter: `discover()` caches for 30 s, so a fast retry sees old data, and
@@ -55,7 +63,7 @@ export interface HomeyAdvertisementLike {
 }
 /** What this adapter needs of `this.homey.ble`. */
 export interface HomeyBleManagerLike {
-  /** About 5 s, fixed. Called with no filter, because the vehicle advertises no service. */
+  /** About 10 s, fixed, when not cached (BLE-00 HW-0). Called with no filter, because the vehicle advertises no service. */
   discover(): Promise<HomeyAdvertisementLike[]>;
   find(uuid: string): Promise<HomeyAdvertisementLike>;
 }
@@ -67,6 +75,7 @@ export declare class HomeyBleTransport implements BleTransport {
   private readonly ble;
   private readonly maxWriteSize;
   private readonly claims;
+  readonly scanTimeoutMs = 15000;
   /** @param ble `this.homey.ble`. The app needs the `homey:wireless:ble` permission. */
   constructor(ble: HomeyBleManagerLike, options?: HomeyBleTransportOptions);
   /** Takes Homey's fixed window, whatever `timeoutMs` says. Never pass `discover` a filter. */

package/dist/bluetooth/homey.d.mts

@@ -1,10 +1,18 @@
 import { BleConnection, BleDeviceRef, BleLinkHandlers, BleScanOptions, BleTransport } from "./transport.mjs";
 /**
- * Bytes per write. Homey hides the MTU, so this is the ATT minimum, the one size
- * sure to work. BLE-00 step 6: if a whole 114-byte frame gets a reply, this can
- * become `null`. Otherwise step 7 keeps it, or the MTU estimate less 3 if larger.
+ * Bytes per write: `null`, a whole frame in one write. Homey hides the MTU.
+ * BLE-00 (HW-0, 2026-11-03) measured a 114-byte frame in one write at 232 ms to
+ * a reply, against 562 ms for 6 writes of 20 bytes. Only 114 bytes were tried:
+ * a signed frame (about 200 bytes) is confirmed by HW-5. Pass `maxWriteSize: 20`
+ * to `HomeyBleTransport` to chunk at the ATT minimum if that run shows a failure.
  */
-export declare const HOMEY_MAX_WRITE_SIZE = 20;
+export declare const HOMEY_MAX_WRITE_SIZE: null;
+/**
+ * Bound on one scan. `discover()` takes a fixed 10.04 s when it is not cached
+ * (HW-0), so the library's 10 s default would time out about 40 ms early.
+ * `VehicleBluetooth` uses this when `scan_timeout_ms` is not set.
+ */
+export declare const HOMEY_SCAN_TIMEOUT_MS = 15000;
 /**
  * For `connect_timeout_ms` and `max_connect_attempts`, not applied by this
  * adapter: `discover()` caches for 30 s, so a fast retry sees old data, and
@@ -55,7 +63,7 @@ export interface HomeyAdvertisementLike {
 }
 /** What this adapter needs of `this.homey.ble`. */
 export interface HomeyBleManagerLike {
-  /** About 5 s, fixed. Called with no filter, because the vehicle advertises no service. */
+  /** About 10 s, fixed, when not cached (BLE-00 HW-0). Called with no filter, because the vehicle advertises no service. */
   discover(): Promise<HomeyAdvertisementLike[]>;
   find(uuid: string): Promise<HomeyAdvertisementLike>;
 }
@@ -67,6 +75,7 @@ export declare class HomeyBleTransport implements BleTransport {
   private readonly ble;
   private readonly maxWriteSize;
   private readonly claims;
+  readonly scanTimeoutMs = 15000;
   /** @param ble `this.homey.ble`. The app needs the `homey:wireless:ble` permission. */
   constructor(ble: HomeyBleManagerLike, options?: HomeyBleTransportOptions);
   /** Takes Homey's fixed window, whatever `timeoutMs` says. Never pass `discover` a filter. */

package/dist/bluetooth/homey.mjs

@@ -4,11 +4,19 @@ import { BleNotSubmittedError } from "./transport.mjs";
 import { LinkClaims, compactUuid, quietly } from "./adapters/shared.mjs";
 // src/bluetooth/adapters/homey.ts
 /**
-* Bytes per write. Homey hides the MTU, so this is the ATT minimum, the one size
-* sure to work. BLE-00 step 6: if a whole 114-byte frame gets a reply, this can
-* become `null`. Otherwise step 7 keeps it, or the MTU estimate less 3 if larger.
+* Bytes per write: `null`, a whole frame in one write. Homey hides the MTU.
+* BLE-00 (HW-0, 2026-11-03) measured a 114-byte frame in one write at 232 ms to
+* a reply, against 562 ms for 6 writes of 20 bytes. Only 114 bytes were tried:
+* a signed frame (about 200 bytes) is confirmed by HW-5. Pass `maxWriteSize: 20`
+* to `HomeyBleTransport` to chunk at the ATT minimum if that run shows a failure.
 */
-const HOMEY_MAX_WRITE_SIZE = 20;
+const HOMEY_MAX_WRITE_SIZE = null;
+/**
+* Bound on one scan. `discover()` takes a fixed 10.04 s when it is not cached
+* (HW-0), so the library's 10 s default would time out about 40 ms early.
+* `VehicleBluetooth` uses this when `scan_timeout_ms` is not set.
+*/
+const HOMEY_SCAN_TIMEOUT_MS = 15e3;
 /**
 * For `connect_timeout_ms` and `max_connect_attempts`, not applied by this
 * adapter: `discover()` caches for 30 s, so a fast retry sees old data, and
@@ -120,10 +128,11 @@ var HomeyBleTransport = class {
 	ble;
 	maxWriteSize;
 	claims = new LinkClaims();
+	scanTimeoutMs = HOMEY_SCAN_TIMEOUT_MS;
 	/** @param ble `this.homey.ble`. The app needs the `homey:wireless:ble` permission. */
 	constructor(ble, options = {}) {
 		this.ble = ble;
-		this.maxWriteSize = options.maxWriteSize === void 0 ? 20 : options.maxWriteSize;
+		this.maxWriteSize = options.maxWriteSize === void 0 ? null : options.maxWriteSize;
 	}
 	/** Takes Homey's fixed window, whatever `timeoutMs` says. Never pass `discover` a filter. */
 	async scan({ matches }) {
@@ -147,4 +156,4 @@ var HomeyBleTransport = class {
 		return connection;
 	}
 };
-export { HOMEY_MAX_WRITE_SIZE, HOMEY_SETUP_TIMEOUT_MS, HOMEY_UNSUBSCRIBE_TIMEOUT_MS, HOMEY_VEHICLE_OPTIONS, HomeyBleTransport };
+export { HOMEY_MAX_WRITE_SIZE, HOMEY_SCAN_TIMEOUT_MS, HOMEY_SETUP_TIMEOUT_MS, HOMEY_UNSUBSCRIBE_TIMEOUT_MS, HOMEY_VEHICLE_OPTIONS, HomeyBleTransport };

package/dist/bluetooth/transport.d.cts

@@ -80,6 +80,8 @@ export interface BleScanOptions {
   matches?: (name: string) => boolean;
 }
 export interface BleTransport {
+  /** How long one scan needs, for a backend with a fixed window. `scan_timeout_ms` overrides it. */
+  readonly scanTimeoutMs?: number;
   /** Active, unfiltered scan. Resolves once a match is found, or when the scan ends with what was seen. */
   scan(options: BleScanOptions): Promise<BleDeviceRef[]>;
   /** Connect, discover, subscribe to notify. Resolves only when notifications are live. */

package/dist/bluetooth/transport.d.mts

@@ -80,6 +80,8 @@ export interface BleScanOptions {
   matches?: (name: string) => boolean;
 }
 export interface BleTransport {
+  /** How long one scan needs, for a backend with a fixed window. `scan_timeout_ms` overrides it. */
+  readonly scanTimeoutMs?: number;
   /** Active, unfiltered scan. Resolves once a match is found, or when the scan ends with what was seen. */
   scan(options: BleScanOptions): Promise<BleDeviceRef[]>;
   /** Connect, discover, subscribe to notify. Resolves only when notifications are live. */

package/dist/bluetooth/vehiclebluetooth.cjs

@@ -142,7 +142,7 @@ var VehicleBluetooth = class extends require_broadcast.BroadcastListeners {
 		this.wake_if_asleep = options.wake_if_asleep ?? true;
 		this.maxConnectAttempts = options.max_connect_attempts ?? 3;
 		this.connectTimeoutMs = options.connect_timeout_ms ?? 2e4;
-		this.scanTimeoutMs = options.scan_timeout_ms ?? 1e4;
+		this.scanTimeoutMs = options.scan_timeout_ms ?? options.transport.scanTimeoutMs ?? 1e4;
 		this.wakeProbeTimeoutMs = options.wake_probe_timeout_ms ?? 1e3;
 		if (this.wakeProbeTimeoutMs <= 0) throw new RangeError("wake_probe_timeout_ms must be greater than 0.");
 		this.ble_name = require_names.get_name(vin);

package/dist/bluetooth/vehiclebluetooth.mjs

@@ -140,7 +140,7 @@ var VehicleBluetooth = class extends BroadcastListeners {
 		this.wake_if_asleep = options.wake_if_asleep ?? true;
 		this.maxConnectAttempts = options.max_connect_attempts ?? 3;
 		this.connectTimeoutMs = options.connect_timeout_ms ?? 2e4;
-		this.scanTimeoutMs = options.scan_timeout_ms ?? 1e4;
+		this.scanTimeoutMs = options.scan_timeout_ms ?? options.transport.scanTimeoutMs ?? 1e4;
 		this.wakeProbeTimeoutMs = options.wake_probe_timeout_ms ?? 1e3;
 		if (this.wakeProbeTimeoutMs <= 0) throw new RangeError("wake_probe_timeout_ms must be greater than 0.");
 		this.ble_name = get_name(vin);

package/dist/bluetooth.cjs

@@ -12,7 +12,6 @@ exports.BleBroadcastPublisher = require_streamglue.BleBroadcastPublisher;
 exports.BleBroadcastStreamGlue = require_streamglue.BleBroadcastStreamGlue;
 exports.BleNotSubmittedError = require_transport.BleNotSubmittedError;
 exports.BroadcastListeners = require_broadcast.BroadcastListeners;
-exports.CCCD_UUID = require_constants.CCCD_UUID;
 exports.CHARGE_PORT_VERIFY_INTERVAL_MS = require_constants.CHARGE_PORT_VERIFY_INTERVAL_MS;
 exports.CHARGE_PORT_VERIFY_TIMEOUT_MS = require_constants.CHARGE_PORT_VERIFY_TIMEOUT_MS;
 exports.DEFAULT_CONNECT_ATTEMPTS = require_constants.DEFAULT_CONNECT_ATTEMPTS;

package/dist/bluetooth.d.cts

@@ -1,5 +1,5 @@
 import { BroadcastListeners, Unsubscribe } from "./bluetooth/broadcast.cjs";
-import { APPEARANCE_UUID, CCCD_UUID, CHARGE_PORT_VERIFY_INTERVAL_MS, CHARGE_PORT_VERIFY_TIMEOUT_MS, DEFAULT_CONNECT_ATTEMPTS, DEFAULT_CONNECT_TIMEOUT_MS, DEFAULT_KEEPALIVE_INTERVAL_MS, DEFAULT_MAX_WRITE_SIZE, DEFAULT_PAIR_POLL_INTERVAL_MS, DEFAULT_PAIR_TIMEOUT_MS, DEFAULT_SCAN_TIMEOUT_MS, DEFAULT_WAKE_PROBE_TIMEOUT_MS, DEFAULT_WAKE_TIMEOUT_MS, GATT_READ_TIMEOUT_MS, GATT_WRITE_TIMEOUT_MS, GENERIC_ACCESS_UUID, INFOTAINMENT_BOOT_TIMEOUT_MS, LINK_TEARDOWN_TIMEOUT_MS, MAX_FRAME_SIZE, NAME_UUID, READ_UUID, SERVICE_UUID, STALE_CHUNK_TIMEOUT_MS, VEHICLE_NOTIFY_UUID, VEHICLE_WRITE_UUID, VERSION_UUID, WAKE_RESEND_INTERVAL_MS, WRITE_UUID } from "./bluetooth/constants.cjs";
+import { APPEARANCE_UUID, CHARGE_PORT_VERIFY_INTERVAL_MS, CHARGE_PORT_VERIFY_TIMEOUT_MS, DEFAULT_CONNECT_ATTEMPTS, DEFAULT_CONNECT_TIMEOUT_MS, DEFAULT_KEEPALIVE_INTERVAL_MS, DEFAULT_MAX_WRITE_SIZE, DEFAULT_PAIR_POLL_INTERVAL_MS, DEFAULT_PAIR_TIMEOUT_MS, DEFAULT_SCAN_TIMEOUT_MS, DEFAULT_WAKE_PROBE_TIMEOUT_MS, DEFAULT_WAKE_TIMEOUT_MS, GATT_READ_TIMEOUT_MS, GATT_WRITE_TIMEOUT_MS, GENERIC_ACCESS_UUID, INFOTAINMENT_BOOT_TIMEOUT_MS, LINK_TEARDOWN_TIMEOUT_MS, MAX_FRAME_SIZE, NAME_UUID, READ_UUID, SERVICE_UUID, STALE_CHUNK_TIMEOUT_MS, VEHICLE_NOTIFY_UUID, VEHICLE_WRITE_UUID, VERSION_UUID, WAKE_RESEND_INTERVAL_MS, WRITE_UUID } from "./bluetooth/constants.cjs";
 import { ReassemblingBuffer, parseFrame, prependLength, splitFrame } from "./bluetooth/framing.cjs";
 import { get_name, name_matches_vin, valid_name } from "./bluetooth/names.cjs";
 import TeslaBluetooth, { VehiclesBluetooth } from "./bluetooth/teslabluetooth.cjs";
@@ -7,4 +7,4 @@ import { BleBroadcastPublisher, BleBroadcastStreamGlue, GEAR_STATES, StreamSink,
 import { BleCharacteristic, BleConnection, BleDeviceRef, BleLinkHandlers, BleNotSubmittedError, BleScanOptions, BleTransport } from "./bluetooth/transport.cjs";
 import { BluetoothConfirmation, VerifyPlan } from "./bluetooth/verify.cjs";
 import VehicleBluetooth, { FindVehicleOptions, PairOptions, VehicleBluetoothOptions } from "./bluetooth/vehiclebluetooth.cjs";
-export { APPEARANCE_UUID, BleBroadcastPublisher, BleBroadcastStreamGlue, type BleCharacteristic, type BleConnection, type BleDeviceRef, type BleLinkHandlers, BleNotSubmittedError, type BleScanOptions, type BleTransport, type BluetoothConfirmation, BroadcastListeners, CCCD_UUID, CHARGE_PORT_VERIFY_INTERVAL_MS, CHARGE_PORT_VERIFY_TIMEOUT_MS, DEFAULT_CONNECT_ATTEMPTS, DEFAULT_CONNECT_TIMEOUT_MS, DEFAULT_KEEPALIVE_INTERVAL_MS, DEFAULT_MAX_WRITE_SIZE, DEFAULT_PAIR_POLL_INTERVAL_MS, DEFAULT_PAIR_TIMEOUT_MS, DEFAULT_SCAN_TIMEOUT_MS, DEFAULT_WAKE_PROBE_TIMEOUT_MS, DEFAULT_WAKE_TIMEOUT_MS, type FindVehicleOptions, GATT_READ_TIMEOUT_MS, GATT_WRITE_TIMEOUT_MS, GEAR_STATES, GENERIC_ACCESS_UUID, INFOTAINMENT_BOOT_TIMEOUT_MS, LINK_TEARDOWN_TIMEOUT_MS, MAX_FRAME_SIZE, NAME_UUID, type PairOptions, READ_UUID, ReassemblingBuffer, SERVICE_UUID, STALE_CHUNK_TIMEOUT_MS, type StreamSink, TONNEAU_POSITION_STATES, TeslaBluetooth, type Unsubscribe, VEHICLE_NOTIFY_UUID, VEHICLE_WRITE_UUID, VERSION_UUID, VehicleBluetooth, type VehicleBluetoothOptions, VehiclesBluetooth, type VerifyPlan, WAKE_RESEND_INTERVAL_MS, WRITE_UUID, get_name, name_matches_vin, parseFrame, prependLength, splitFrame, valid_name };
+export { APPEARANCE_UUID, BleBroadcastPublisher, BleBroadcastStreamGlue, type BleCharacteristic, type BleConnection, type BleDeviceRef, type BleLinkHandlers, BleNotSubmittedError, type BleScanOptions, type BleTransport, type BluetoothConfirmation, BroadcastListeners, CHARGE_PORT_VERIFY_INTERVAL_MS, CHARGE_PORT_VERIFY_TIMEOUT_MS, DEFAULT_CONNECT_ATTEMPTS, DEFAULT_CONNECT_TIMEOUT_MS, DEFAULT_KEEPALIVE_INTERVAL_MS, DEFAULT_MAX_WRITE_SIZE, DEFAULT_PAIR_POLL_INTERVAL_MS, DEFAULT_PAIR_TIMEOUT_MS, DEFAULT_SCAN_TIMEOUT_MS, DEFAULT_WAKE_PROBE_TIMEOUT_MS, DEFAULT_WAKE_TIMEOUT_MS, type FindVehicleOptions, GATT_READ_TIMEOUT_MS, GATT_WRITE_TIMEOUT_MS, GEAR_STATES, GENERIC_ACCESS_UUID, INFOTAINMENT_BOOT_TIMEOUT_MS, LINK_TEARDOWN_TIMEOUT_MS, MAX_FRAME_SIZE, NAME_UUID, type PairOptions, READ_UUID, ReassemblingBuffer, SERVICE_UUID, STALE_CHUNK_TIMEOUT_MS, type StreamSink, TONNEAU_POSITION_STATES, TeslaBluetooth, type Unsubscribe, VEHICLE_NOTIFY_UUID, VEHICLE_WRITE_UUID, VERSION_UUID, VehicleBluetooth, type VehicleBluetoothOptions, VehiclesBluetooth, type VerifyPlan, WAKE_RESEND_INTERVAL_MS, WRITE_UUID, get_name, name_matches_vin, parseFrame, prependLength, splitFrame, valid_name };

package/dist/bluetooth.d.mts

@@ -1,5 +1,5 @@
 import { BroadcastListeners, Unsubscribe } from "./bluetooth/broadcast.mjs";
-import { APPEARANCE_UUID, CCCD_UUID, CHARGE_PORT_VERIFY_INTERVAL_MS, CHARGE_PORT_VERIFY_TIMEOUT_MS, DEFAULT_CONNECT_ATTEMPTS, DEFAULT_CONNECT_TIMEOUT_MS, DEFAULT_KEEPALIVE_INTERVAL_MS, DEFAULT_MAX_WRITE_SIZE, DEFAULT_PAIR_POLL_INTERVAL_MS, DEFAULT_PAIR_TIMEOUT_MS, DEFAULT_SCAN_TIMEOUT_MS, DEFAULT_WAKE_PROBE_TIMEOUT_MS, DEFAULT_WAKE_TIMEOUT_MS, GATT_READ_TIMEOUT_MS, GATT_WRITE_TIMEOUT_MS, GENERIC_ACCESS_UUID, INFOTAINMENT_BOOT_TIMEOUT_MS, LINK_TEARDOWN_TIMEOUT_MS, MAX_FRAME_SIZE, NAME_UUID, READ_UUID, SERVICE_UUID, STALE_CHUNK_TIMEOUT_MS, VEHICLE_NOTIFY_UUID, VEHICLE_WRITE_UUID, VERSION_UUID, WAKE_RESEND_INTERVAL_MS, WRITE_UUID } from "./bluetooth/constants.mjs";
+import { APPEARANCE_UUID, CHARGE_PORT_VERIFY_INTERVAL_MS, CHARGE_PORT_VERIFY_TIMEOUT_MS, DEFAULT_CONNECT_ATTEMPTS, DEFAULT_CONNECT_TIMEOUT_MS, DEFAULT_KEEPALIVE_INTERVAL_MS, DEFAULT_MAX_WRITE_SIZE, DEFAULT_PAIR_POLL_INTERVAL_MS, DEFAULT_PAIR_TIMEOUT_MS, DEFAULT_SCAN_TIMEOUT_MS, DEFAULT_WAKE_PROBE_TIMEOUT_MS, DEFAULT_WAKE_TIMEOUT_MS, GATT_READ_TIMEOUT_MS, GATT_WRITE_TIMEOUT_MS, GENERIC_ACCESS_UUID, INFOTAINMENT_BOOT_TIMEOUT_MS, LINK_TEARDOWN_TIMEOUT_MS, MAX_FRAME_SIZE, NAME_UUID, READ_UUID, SERVICE_UUID, STALE_CHUNK_TIMEOUT_MS, VEHICLE_NOTIFY_UUID, VEHICLE_WRITE_UUID, VERSION_UUID, WAKE_RESEND_INTERVAL_MS, WRITE_UUID } from "./bluetooth/constants.mjs";
 import { ReassemblingBuffer, parseFrame, prependLength, splitFrame } from "./bluetooth/framing.mjs";
 import { get_name, name_matches_vin, valid_name } from "./bluetooth/names.mjs";
 import TeslaBluetooth, { VehiclesBluetooth } from "./bluetooth/teslabluetooth.mjs";
@@ -7,4 +7,4 @@ import { BleBroadcastPublisher, BleBroadcastStreamGlue, GEAR_STATES, StreamSink,
 import { BleCharacteristic, BleConnection, BleDeviceRef, BleLinkHandlers, BleNotSubmittedError, BleScanOptions, BleTransport } from "./bluetooth/transport.mjs";
 import { BluetoothConfirmation, VerifyPlan } from "./bluetooth/verify.mjs";
 import VehicleBluetooth, { FindVehicleOptions, PairOptions, VehicleBluetoothOptions } from "./bluetooth/vehiclebluetooth.mjs";
-export { APPEARANCE_UUID, BleBroadcastPublisher, BleBroadcastStreamGlue, type BleCharacteristic, type BleConnection, type BleDeviceRef, type BleLinkHandlers, BleNotSubmittedError, type BleScanOptions, type BleTransport, type BluetoothConfirmation, BroadcastListeners, CCCD_UUID, CHARGE_PORT_VERIFY_INTERVAL_MS, CHARGE_PORT_VERIFY_TIMEOUT_MS, DEFAULT_CONNECT_ATTEMPTS, DEFAULT_CONNECT_TIMEOUT_MS, DEFAULT_KEEPALIVE_INTERVAL_MS, DEFAULT_MAX_WRITE_SIZE, DEFAULT_PAIR_POLL_INTERVAL_MS, DEFAULT_PAIR_TIMEOUT_MS, DEFAULT_SCAN_TIMEOUT_MS, DEFAULT_WAKE_PROBE_TIMEOUT_MS, DEFAULT_WAKE_TIMEOUT_MS, type FindVehicleOptions, GATT_READ_TIMEOUT_MS, GATT_WRITE_TIMEOUT_MS, GEAR_STATES, GENERIC_ACCESS_UUID, INFOTAINMENT_BOOT_TIMEOUT_MS, LINK_TEARDOWN_TIMEOUT_MS, MAX_FRAME_SIZE, NAME_UUID, type PairOptions, READ_UUID, ReassemblingBuffer, SERVICE_UUID, STALE_CHUNK_TIMEOUT_MS, type StreamSink, TONNEAU_POSITION_STATES, TeslaBluetooth, type Unsubscribe, VEHICLE_NOTIFY_UUID, VEHICLE_WRITE_UUID, VERSION_UUID, VehicleBluetooth, type VehicleBluetoothOptions, VehiclesBluetooth, type VerifyPlan, WAKE_RESEND_INTERVAL_MS, WRITE_UUID, get_name, name_matches_vin, parseFrame, prependLength, splitFrame, valid_name };
+export { APPEARANCE_UUID, BleBroadcastPublisher, BleBroadcastStreamGlue, type BleCharacteristic, type BleConnection, type BleDeviceRef, type BleLinkHandlers, BleNotSubmittedError, type BleScanOptions, type BleTransport, type BluetoothConfirmation, BroadcastListeners, CHARGE_PORT_VERIFY_INTERVAL_MS, CHARGE_PORT_VERIFY_TIMEOUT_MS, DEFAULT_CONNECT_ATTEMPTS, DEFAULT_CONNECT_TIMEOUT_MS, DEFAULT_KEEPALIVE_INTERVAL_MS, DEFAULT_MAX_WRITE_SIZE, DEFAULT_PAIR_POLL_INTERVAL_MS, DEFAULT_PAIR_TIMEOUT_MS, DEFAULT_SCAN_TIMEOUT_MS, DEFAULT_WAKE_PROBE_TIMEOUT_MS, DEFAULT_WAKE_TIMEOUT_MS, type FindVehicleOptions, GATT_READ_TIMEOUT_MS, GATT_WRITE_TIMEOUT_MS, GEAR_STATES, GENERIC_ACCESS_UUID, INFOTAINMENT_BOOT_TIMEOUT_MS, LINK_TEARDOWN_TIMEOUT_MS, MAX_FRAME_SIZE, NAME_UUID, type PairOptions, READ_UUID, ReassemblingBuffer, SERVICE_UUID, STALE_CHUNK_TIMEOUT_MS, type StreamSink, TONNEAU_POSITION_STATES, TeslaBluetooth, type Unsubscribe, VEHICLE_NOTIFY_UUID, VEHICLE_WRITE_UUID, VERSION_UUID, VehicleBluetooth, type VehicleBluetoothOptions, VehiclesBluetooth, type VerifyPlan, WAKE_RESEND_INTERVAL_MS, WRITE_UUID, get_name, name_matches_vin, parseFrame, prependLength, splitFrame, valid_name };

package/dist/bluetooth.mjs

@@ -1,9 +1,9 @@
 import { BroadcastListeners } from "./bluetooth/broadcast.mjs";
-import { APPEARANCE_UUID, CCCD_UUID, CHARGE_PORT_VERIFY_INTERVAL_MS, CHARGE_PORT_VERIFY_TIMEOUT_MS, DEFAULT_CONNECT_ATTEMPTS, DEFAULT_CONNECT_TIMEOUT_MS, DEFAULT_KEEPALIVE_INTERVAL_MS, DEFAULT_MAX_WRITE_SIZE, DEFAULT_PAIR_POLL_INTERVAL_MS, DEFAULT_PAIR_TIMEOUT_MS, DEFAULT_SCAN_TIMEOUT_MS, DEFAULT_WAKE_PROBE_TIMEOUT_MS, DEFAULT_WAKE_TIMEOUT_MS, GATT_READ_TIMEOUT_MS, GATT_WRITE_TIMEOUT_MS, GENERIC_ACCESS_UUID, INFOTAINMENT_BOOT_TIMEOUT_MS, LINK_TEARDOWN_TIMEOUT_MS, MAX_FRAME_SIZE, NAME_UUID, READ_UUID, SERVICE_UUID, STALE_CHUNK_TIMEOUT_MS, VEHICLE_NOTIFY_UUID, VEHICLE_WRITE_UUID, VERSION_UUID, WAKE_RESEND_INTERVAL_MS, WRITE_UUID } from "./bluetooth/constants.mjs";
+import { APPEARANCE_UUID, CHARGE_PORT_VERIFY_INTERVAL_MS, CHARGE_PORT_VERIFY_TIMEOUT_MS, DEFAULT_CONNECT_ATTEMPTS, DEFAULT_CONNECT_TIMEOUT_MS, DEFAULT_KEEPALIVE_INTERVAL_MS, DEFAULT_MAX_WRITE_SIZE, DEFAULT_PAIR_POLL_INTERVAL_MS, DEFAULT_PAIR_TIMEOUT_MS, DEFAULT_SCAN_TIMEOUT_MS, DEFAULT_WAKE_PROBE_TIMEOUT_MS, DEFAULT_WAKE_TIMEOUT_MS, GATT_READ_TIMEOUT_MS, GATT_WRITE_TIMEOUT_MS, GENERIC_ACCESS_UUID, INFOTAINMENT_BOOT_TIMEOUT_MS, LINK_TEARDOWN_TIMEOUT_MS, MAX_FRAME_SIZE, NAME_UUID, READ_UUID, SERVICE_UUID, STALE_CHUNK_TIMEOUT_MS, VEHICLE_NOTIFY_UUID, VEHICLE_WRITE_UUID, VERSION_UUID, WAKE_RESEND_INTERVAL_MS, WRITE_UUID } from "./bluetooth/constants.mjs";
 import { ReassemblingBuffer, parseFrame, prependLength, splitFrame } from "./bluetooth/framing.mjs";
 import { get_name, name_matches_vin, valid_name } from "./bluetooth/names.mjs";
 import TeslaBluetooth, { VehiclesBluetooth } from "./bluetooth/teslabluetooth.mjs";
 import { BleBroadcastPublisher, BleBroadcastStreamGlue, GEAR_STATES, TONNEAU_POSITION_STATES } from "./bluetooth/streamglue.mjs";
 import { BleNotSubmittedError } from "./bluetooth/transport.mjs";
 import VehicleBluetooth from "./bluetooth/vehiclebluetooth.mjs";
-export { APPEARANCE_UUID, BleBroadcastPublisher, BleBroadcastStreamGlue, BleNotSubmittedError, BroadcastListeners, CCCD_UUID, CHARGE_PORT_VERIFY_INTERVAL_MS, CHARGE_PORT_VERIFY_TIMEOUT_MS, DEFAULT_CONNECT_ATTEMPTS, DEFAULT_CONNECT_TIMEOUT_MS, DEFAULT_KEEPALIVE_INTERVAL_MS, DEFAULT_MAX_WRITE_SIZE, DEFAULT_PAIR_POLL_INTERVAL_MS, DEFAULT_PAIR_TIMEOUT_MS, DEFAULT_SCAN_TIMEOUT_MS, DEFAULT_WAKE_PROBE_TIMEOUT_MS, DEFAULT_WAKE_TIMEOUT_MS, GATT_READ_TIMEOUT_MS, GATT_WRITE_TIMEOUT_MS, GEAR_STATES, GENERIC_ACCESS_UUID, INFOTAINMENT_BOOT_TIMEOUT_MS, LINK_TEARDOWN_TIMEOUT_MS, MAX_FRAME_SIZE, NAME_UUID, READ_UUID, ReassemblingBuffer, SERVICE_UUID, STALE_CHUNK_TIMEOUT_MS, TONNEAU_POSITION_STATES, TeslaBluetooth, VEHICLE_NOTIFY_UUID, VEHICLE_WRITE_UUID, VERSION_UUID, VehicleBluetooth, VehiclesBluetooth, WAKE_RESEND_INTERVAL_MS, WRITE_UUID, get_name, name_matches_vin, parseFrame, prependLength, splitFrame, valid_name };
+export { APPEARANCE_UUID, BleBroadcastPublisher, BleBroadcastStreamGlue, BleNotSubmittedError, BroadcastListeners, CHARGE_PORT_VERIFY_INTERVAL_MS, CHARGE_PORT_VERIFY_TIMEOUT_MS, DEFAULT_CONNECT_ATTEMPTS, DEFAULT_CONNECT_TIMEOUT_MS, DEFAULT_KEEPALIVE_INTERVAL_MS, DEFAULT_MAX_WRITE_SIZE, DEFAULT_PAIR_POLL_INTERVAL_MS, DEFAULT_PAIR_TIMEOUT_MS, DEFAULT_SCAN_TIMEOUT_MS, DEFAULT_WAKE_PROBE_TIMEOUT_MS, DEFAULT_WAKE_TIMEOUT_MS, GATT_READ_TIMEOUT_MS, GATT_WRITE_TIMEOUT_MS, GEAR_STATES, GENERIC_ACCESS_UUID, INFOTAINMENT_BOOT_TIMEOUT_MS, LINK_TEARDOWN_TIMEOUT_MS, MAX_FRAME_SIZE, NAME_UUID, READ_UUID, ReassemblingBuffer, SERVICE_UUID, STALE_CHUNK_TIMEOUT_MS, TONNEAU_POSITION_STATES, TeslaBluetooth, VEHICLE_NOTIFY_UUID, VEHICLE_WRITE_UUID, VERSION_UUID, VehicleBluetooth, VehiclesBluetooth, WAKE_RESEND_INTERVAL_MS, WRITE_UUID, get_name, name_matches_vin, parseFrame, prependLength, splitFrame, valid_name };

package/dist/teslafleetapi.cjs

@@ -127,7 +127,7 @@ var TeslaFleetApi = class {
 			if (method === "GET") json = null;
 			const headers = {
 				Authorization: `Bearer ${await this.access_token()}`,
-				"X-Library": `node tesla_fleet_api 0.5.0`
+				"X-Library": `node tesla_fleet_api 0.6.0`
 			};
 			const query = new URLSearchParams();
 			if (params) {

package/dist/teslafleetapi.mjs

@@ -127,7 +127,7 @@ var TeslaFleetApi = class {
 			if (method === "GET") json = null;
 			const headers = {
 				Authorization: `Bearer ${await this.access_token()}`,
-				"X-Library": `node tesla_fleet_api 0.5.0`
+				"X-Library": `node tesla_fleet_api 0.6.0`
 			};
 			const query = new URLSearchParams();
 			if (params) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tesla-fleet-api",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "type": "module",
   "repository": {
     "type": "git",
@@ -122,16 +122,6 @@
         "default": "./dist/bluetooth/noble.cjs"
       }
     },
-    "./bluetooth/esphome": {
-      "import": {
-        "types": "./dist/bluetooth/esphome.d.mts",
-        "default": "./dist/bluetooth/esphome.mjs"
-      },
-      "require": {
-        "types": "./dist/bluetooth/esphome.d.cts",
-        "default": "./dist/bluetooth/esphome.cjs"
-      }
-    },
     "./powerwall": {
       "import": {
         "types": "./dist/powerwall.d.mts",
@@ -153,13 +143,9 @@
     "@teslemetry/tesla-protocol": "~6.1.0"
   },
   "peerDependencies": {
-    "@2colors/esphome-native-api": "^1.3.6",
     "@stoprocent/noble": "^2.8.0"
   },
   "peerDependenciesMeta": {
-    "@2colors/esphome-native-api": {
-      "optional": true
-    },
     "@stoprocent/noble": {
       "optional": true
     }

package/dist/bluetooth/esphome.cjs

@@ -1,292 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_async = require("./async.cjs");
-const require_constants = require("./constants.cjs");
-const require_transport = require("./transport.cjs");
-const require_shared = require("./adapters/shared.cjs");
-// src/bluetooth/adapters/esphome.ts
-/** The bytes that turn notifications on in a CCCD. */
-const CCCD_ENABLE_NOTIFICATIONS = Buffer.from([1, 0]);
-/** How long a proxy takes to answer a connect. The package's own wait is the same. */
-const DEVICE_CONNECT_WAIT_MS = 1e4;
-/** How long the API connection to the proxy may take. */
-const API_CONNECT_TIMEOUT_MS = 1e4;
-const ADVERTISEMENT = "message.BluetoothLEAdvertisementResponse";
-const CONNECTION_STATE = "message.BluetoothDeviceConnectionResponse";
-const NOTIFY_DATA = "message.BluetoothGATTNotifyDataResponse";
-/** One queue per proxy, however many transports or links share it. */
-const proxyQueues = /* @__PURE__ */ new WeakMap();
-function queueFor(proxy) {
-	let queue = proxyQueues.get(proxy);
-	if (!queue) {
-		queue = new require_async.AsyncLock();
-		proxyQueues.set(proxy, queue);
-	}
-	return queue;
-}
-/** A proxy's 48-bit address as a MAC, the form a caller would recognize. */
-function formatAddress(address) {
-	return address.toString(16).padStart(12, "0").replace(/(..)(?=.)/g, "$1:").toUpperCase();
-}
-function parseAddress(id) {
-	const hex = id.replace(/:/g, "");
-	if (!/^[0-9a-fA-F]{12}$/.test(hex)) throw new Error("An ESPHome device id must be a 48-bit address.");
-	return Number.parseInt(hex, 16);
-}
-function sameUuid(entry, uuid) {
-	return entry.uuid ? require_shared.compactUuid(entry.uuid) === require_shared.compactUuid(uuid) : (entry.shortUuid ?? 0).toString(16).padStart(4, "0") === require_shared.compactUuid(uuid);
-}
-/** A late reply to an abandoned call can land on the next call of its type. */
-function assertReplyFor(reply, address, handle) {
-	if (reply.address !== address || reply.handle !== handle) throw new Error("The proxy's reply was for another request.");
-}
-var EsphomeConnection = class {
-	proxy;
-	address;
-	id;
-	handlers;
-	claims;
-	lost = false;
-	closed = false;
-	closing;
-	handles = /* @__PURE__ */ new Map();
-	mtu = 0;
-	onLost = () => {
-		if (this.lost) return;
-		this.lost = true;
-		this.stopListening();
-		if (!this.closed) this.handlers.onDisconnect();
-	};
-	onState = (state) => {
-		if (state.address === this.address && !state.connected) this.onLost();
-	};
-	notifyHandle;
-	onNotifyData = (message) => {
-		if (message.address === this.address && message.handle === this.notifyHandle) this.handlers.onNotify(Buffer.from(message.data, "base64"));
-	};
-	constructor(proxy, address, id, handlers, claims) {
-		this.proxy = proxy;
-		this.address = address;
-		this.id = id;
-		this.handlers = handlers;
-		this.claims = claims;
-	}
-	get queue() {
-		return queueFor(this.proxy);
-	}
-	get isConnected() {
-		return !this.lost && !this.closed && this.proxy.connected && this.proxy.authorized;
-	}
-	get maxWriteSize() {
-		return this.mtu > 3 ? this.mtu - 3 : 20;
-	}
-	/** Ask the proxy to connect. The reply is matched here, as a link dropping elsewhere sends the same message type. */
-	requestLink(addressType) {
-		const { proxy, address } = this;
-		return this.queue.run(async () => {
-			let onReply;
-			const reply = new Promise((resolve) => {
-				onReply = (state) => {
-					if (state.address === address) resolve(state);
-				};
-			});
-			proxy.on(CONNECTION_STATE, onReply);
-			try {
-				return await require_async.withTimeout(() => Promise.race([reply, proxy.connectBluetoothDeviceService(address, addressType, false).then(() => reply)]), DEVICE_CONNECT_WAIT_MS);
-			} finally {
-				proxy.off(CONNECTION_STATE, onReply);
-			}
-		});
-	}
-	/** Connect, map the handles, and subscribe. Resolves once the CCCD write is done. */
-	async open(addressType) {
-		const state = await this.requestLink(addressType);
-		if (!state.connected || state.error) {
-			this.lost = true;
-			throw new Error(`The proxy could not connect: error ${state.error}.`);
-		}
-		this.assertCurrent();
-		this.mtu = state.mtu;
-		const { proxy, address } = this;
-		proxy.on(CONNECTION_STATE, this.onState);
-		proxy.on("disconnected", this.onLost);
-		proxy.on("unauthorized", this.onLost);
-		const { servicesList } = await this.queue.run(() => proxy.listBluetoothGATTServicesService(address));
-		const service = servicesList.find((candidate) => sameUuid(candidate, require_constants.SERVICE_UUID));
-		const characteristic = (uuid) => service?.characteristicsList.find((candidate) => sameUuid(candidate, uuid));
-		const write = characteristic(require_constants.VEHICLE_WRITE_UUID);
-		const notify = characteristic(require_constants.VEHICLE_NOTIFY_UUID);
-		const cccd = notify?.descriptorsList.find((descriptor) => sameUuid(descriptor, require_constants.CCCD_UUID));
-		if (!write || !notify || !cccd) throw new Error("The vehicle's write or notify characteristic, or its CCCD, was not found.");
-		this.handles.set("write", write.handle);
-		const version = characteristic(require_constants.VERSION_UUID);
-		if (version) this.handles.set("version", version.handle);
-		const genericAccess = servicesList.find((candidate) => sameUuid(candidate, require_constants.GENERIC_ACCESS_UUID));
-		for (const [name, uuid] of [["deviceName", require_constants.NAME_UUID], ["appearance", require_constants.APPEARANCE_UUID]]) {
-			const entry = genericAccess?.characteristicsList.find((candidate) => sameUuid(candidate, uuid));
-			if (entry) this.handles.set(name, entry.handle);
-		}
-		this.assertCurrent();
-		this.notifyHandle = notify.handle;
-		proxy.on(NOTIFY_DATA, this.onNotifyData);
-		await this.queue.run(() => proxy.notifyBluetoothGATTCharacteristicService(address, notify.handle));
-		await this.queue.run(() => proxy.writeBluetoothGATTDescriptorService(address, cccd.handle, CCCD_ENABLE_NOTIFICATIONS));
-	}
-	/** A superseded attempt stops here, before it changes a link another attempt owns. */
-	assertCurrent() {
-		if (this.claims.superseded(this.id, this)) throw new Error("A newer connect attempt took over this link.");
-	}
-	async write(data) {
-		const { proxy, address } = this;
-		const handle = this.handles.get("write");
-		if (handle === void 0) throw new require_transport.BleNotSubmittedError("The vehicle write characteristic was not found.");
-		const queuedAt = performance.now();
-		await this.queue.run(async () => {
-			if (!this.isConnected) throw new require_transport.BleNotSubmittedError("The link is down.");
-			if (performance.now() - queuedAt >= 5e3) throw new require_transport.BleNotSubmittedError("The write outlasted its timeout in the proxy queue.");
-			assertReplyFor(await proxy.writeBluetoothGATTCharacteristicService(address, handle, Buffer.from(data), true), address, handle);
-		});
-	}
-	async read(characteristic) {
-		const { proxy, address } = this;
-		const handle = this.handles.get(characteristic);
-		if (handle === void 0) throw new require_transport.BleNotSubmittedError(`The ${characteristic} characteristic was not found.`);
-		const reply = await this.queue.run(() => {
-			if (!this.isConnected) throw new require_transport.BleNotSubmittedError("The link is down.");
-			return proxy.readBluetoothGATTCharacteristicService(address, handle);
-		});
-		assertReplyFor(reply, address, handle);
-		return Buffer.from(reply.data, "base64");
-	}
-	stopListening() {
-		const { proxy } = this;
-		proxy.off(CONNECTION_STATE, this.onState);
-		proxy.off("disconnected", this.onLost);
-		proxy.off("unauthorized", this.onLost);
-		proxy.off(NOTIFY_DATA, this.onNotifyData);
-	}
-	disconnect() {
-		this.closing ??= (async () => {
-			this.closed = true;
-			this.stopListening();
-			const { claims, id, proxy, address } = this;
-			const superseded = claims.superseded(id, this);
-			claims.release(id, this);
-			if (!superseded && !this.lost && proxy.authorized) await require_shared.quietly(() => this.queue.run(() => proxy.disconnectBluetoothDeviceService(address)));
-		})();
-		return this.closing;
-	}
-};
-var EsphomeBleTransport = class {
-	options;
-	proxy;
-	ownsProxy;
-	scans = new require_async.AsyncLock();
-	claims = new require_shared.LinkClaims();
-	/** A proxy refuses a connect with no address type, and only an advertisement carries it. */
-	addressTypes = /* @__PURE__ */ new Map();
-	constructor(options) {
-		this.options = options;
-		this.ownsProxy = !("connection" in options);
-		if ("connection" in options) this.proxy = options.connection;
-	}
-	/** The API connection, up and authorized. */
-	async ready() {
-		const proxy = this.proxy ??= await this.buildProxy();
-		if (proxy.authorized) return proxy;
-		if (this.ownsProxy && !proxy.connected) proxy.connect();
-		let onAuthorized;
-		let onError;
-		try {
-			await require_async.withTimeout(() => new Promise((resolve, reject) => {
-				onAuthorized = resolve;
-				onError = reject;
-				proxy.on("authorized", onAuthorized);
-				proxy.on("error", onError);
-			}), API_CONNECT_TIMEOUT_MS);
-		} finally {
-			proxy.off("authorized", onAuthorized);
-			proxy.off("error", onError);
-		}
-		return proxy;
-	}
-	async buildProxy() {
-		if ("connection" in this.options) return this.options.connection;
-		const specifier = "@2colors/esphome-native-api";
-		let module;
-		try {
-			module = await import(specifier);
-		} catch (cause) {
-			throw new Error("EsphomeBleTransport needs @2colors/esphome-native-api, or a `connection` option.", { cause });
-		}
-		const Connection = module.Connection ?? module.default?.Connection;
-		if (!Connection) throw new Error("@2colors/esphome-native-api has no Connection.");
-		const { host, port, encryptionKey, password } = this.options;
-		const proxy = new Connection({
-			host,
-			port,
-			encryptionKey,
-			password
-		});
-		proxy.on("error", () => void 0);
-		return proxy;
-	}
-	async scan({ timeoutMs, matches }) {
-		const proxy = await this.ready();
-		return this.listen(proxy, timeoutMs, (device) => device.name !== void 0 && matches?.(device.name) === true);
-	}
-	/** Listen to advertisements until `done` accepts a device or the window ends. A proxy filters nothing. */
-	listen(proxy, timeoutMs, done) {
-		return this.scans.run(async () => {
-			const seen = /* @__PURE__ */ new Map();
-			let finish;
-			const finished = new Promise((resolve) => {
-				finish = resolve;
-			});
-			const onAdvertisement = (advertisement) => {
-				const id = formatAddress(advertisement.address);
-				this.addressTypes.set(id, advertisement.addressType ?? this.addressTypes.get(id));
-				const device = {
-					id,
-					name: advertisement.name || seen.get(id)?.name,
-					rssi: advertisement.rssi
-				};
-				seen.set(id, device);
-				if (done(device)) finish();
-			};
-			proxy.on(ADVERTISEMENT, onAdvertisement);
-			const timer = setTimeout(finish, Math.max(0, timeoutMs - 250));
-			try {
-				proxy.subscribeBluetoothAdvertisementService();
-				await finished;
-			} finally {
-				clearTimeout(timer);
-				proxy.off(ADVERTISEMENT, onAdvertisement);
-				await require_shared.quietly(() => proxy.unsubscribeBluetoothAdvertisementService());
-			}
-			return [...seen.values()];
-		});
-	}
-	async connect(device, handlers) {
-		const address = parseAddress(device.id);
-		const id = formatAddress(address);
-		const proxy = await this.ready();
-		if (this.addressTypes.get(id) === void 0) await this.listen(proxy, require_constants.DEFAULT_SCAN_TIMEOUT_MS, (seen) => seen.id === id && this.addressTypes.get(id) !== void 0);
-		const connection = new EsphomeConnection(proxy, address, id, handlers, this.claims);
-		this.claims.claim(id, connection);
-		try {
-			await connection.open(this.addressTypes.get(id));
-		} catch (error) {
-			await connection.disconnect();
-			throw error;
-		}
-		return connection;
-	}
-	/** Close the API connection, if this transport opened it. */
-	close() {
-		if (this.ownsProxy) {
-			this.proxy?.disconnect();
-			this.proxy = void 0;
-		}
-	}
-};
-exports.EsphomeBleTransport = EsphomeBleTransport;

package/dist/bluetooth/esphome.d.cts

@@ -1,83 +0,0 @@
-import { BleConnection, BleDeviceRef, BleLinkHandlers, BleScanOptions, BleTransport } from "./transport.cjs";
-export interface EsphomeAdvertisement {
-  address: number;
-  addressType?: number;
-  name?: string;
-  rssi?: number;
-}
-export interface EsphomeConnectionState {
-  address: number;
-  connected: boolean;
-  mtu: number;
-  error: number;
-}
-export interface EsphomeGattDescriptor {
-  uuid?: string;
-  /** Set in place of `uuid` for a short UUID, on API 1.12 and up. */
-  shortUuid?: number;
-  handle: number;
-}
-export interface EsphomeGattCharacteristic extends EsphomeGattDescriptor {
-  descriptorsList: EsphomeGattDescriptor[];
-}
-export interface EsphomeGattService extends EsphomeGattDescriptor {
-  characteristicsList: EsphomeGattCharacteristic[];
-}
-export interface EsphomeGattReply {
-  address: number;
-  handle: number;
-}
-export interface EsphomeGattData extends EsphomeGattReply {
-  data: string;
-}
-/** The parts of the package's `Connection` this adapter uses. */
-export interface EsphomeConnectionLike {
-  connected: boolean;
-  authorized: boolean;
-  connect(): void;
-  disconnect(): void;
-  on(event: string, listener: (...args: any[]) => void): unknown;
-  off(event: string, listener: (...args: any[]) => void): unknown;
-  subscribeBluetoothAdvertisementService(): void;
-  unsubscribeBluetoothAdvertisementService(): void;
-  connectBluetoothDeviceService(address: number, addressType?: number, useCache?: boolean): Promise<unknown>;
-  disconnectBluetoothDeviceService(address: number): Promise<unknown>;
-  listBluetoothGATTServicesService(address: number): Promise<{
-    servicesList: EsphomeGattService[];
-  }>;
-  readBluetoothGATTCharacteristicService(address: number, handle: number): Promise<EsphomeGattData>;
-  writeBluetoothGATTCharacteristicService(address: number, handle: number, value: Uint8Array, response?: boolean): Promise<EsphomeGattReply>;
-  notifyBluetoothGATTCharacteristicService(address: number, handle: number): Promise<unknown>;
-  writeBluetoothGATTDescriptorService(address: number, handle: number, value: Uint8Array): Promise<void>;
-}
-export type EsphomeBleTransportOptions = {
-  /** A `Connection` you own. This adapter never closes it. */
-  connection: EsphomeConnectionLike;
-} | {
-  /** The proxy's address. `@2colors/esphome-native-api` loads on first use. */
-  host: string;
-  /** Defaults to the package's 6053. */
-  port?: number;
-  /** The proxy's Noise key, base64. Never logged. */
-  encryptionKey?: string;
-  password?: string;
-};
-export declare class EsphomeBleTransport implements BleTransport {
-  private readonly options;
-  private proxy;
-  private readonly ownsProxy;
-  private readonly scans;
-  private readonly claims;
-  /** A proxy refuses a connect with no address type, and only an advertisement carries it. */
-  private readonly addressTypes;
-  constructor(options: EsphomeBleTransportOptions);
-  /** The API connection, up and authorized. */
-  private ready;
-  private buildProxy;
-  scan({ timeoutMs, matches }: BleScanOptions): Promise<BleDeviceRef[]>;
-  /** Listen to advertisements until `done` accepts a device or the window ends. A proxy filters nothing. */
-  private listen;
-  connect(device: BleDeviceRef, handlers: BleLinkHandlers): Promise<BleConnection>;
-  /** Close the API connection, if this transport opened it. */
-  close(): void;
-}

package/dist/bluetooth/esphome.d.mts

@@ -1,83 +0,0 @@
-import { BleConnection, BleDeviceRef, BleLinkHandlers, BleScanOptions, BleTransport } from "./transport.mjs";
-export interface EsphomeAdvertisement {
-  address: number;
-  addressType?: number;
-  name?: string;
-  rssi?: number;
-}
-export interface EsphomeConnectionState {
-  address: number;
-  connected: boolean;
-  mtu: number;
-  error: number;
-}
-export interface EsphomeGattDescriptor {
-  uuid?: string;
-  /** Set in place of `uuid` for a short UUID, on API 1.12 and up. */
-  shortUuid?: number;
-  handle: number;
-}
-export interface EsphomeGattCharacteristic extends EsphomeGattDescriptor {
-  descriptorsList: EsphomeGattDescriptor[];
-}
-export interface EsphomeGattService extends EsphomeGattDescriptor {
-  characteristicsList: EsphomeGattCharacteristic[];
-}
-export interface EsphomeGattReply {
-  address: number;
-  handle: number;
-}
-export interface EsphomeGattData extends EsphomeGattReply {
-  data: string;
-}
-/** The parts of the package's `Connection` this adapter uses. */
-export interface EsphomeConnectionLike {
-  connected: boolean;
-  authorized: boolean;
-  connect(): void;
-  disconnect(): void;
-  on(event: string, listener: (...args: any[]) => void): unknown;
-  off(event: string, listener: (...args: any[]) => void): unknown;
-  subscribeBluetoothAdvertisementService(): void;
-  unsubscribeBluetoothAdvertisementService(): void;
-  connectBluetoothDeviceService(address: number, addressType?: number, useCache?: boolean): Promise<unknown>;
-  disconnectBluetoothDeviceService(address: number): Promise<unknown>;
-  listBluetoothGATTServicesService(address: number): Promise<{
-    servicesList: EsphomeGattService[];
-  }>;
-  readBluetoothGATTCharacteristicService(address: number, handle: number): Promise<EsphomeGattData>;
-  writeBluetoothGATTCharacteristicService(address: number, handle: number, value: Uint8Array, response?: boolean): Promise<EsphomeGattReply>;
-  notifyBluetoothGATTCharacteristicService(address: number, handle: number): Promise<unknown>;
-  writeBluetoothGATTDescriptorService(address: number, handle: number, value: Uint8Array): Promise<void>;
-}
-export type EsphomeBleTransportOptions = {
-  /** A `Connection` you own. This adapter never closes it. */
-  connection: EsphomeConnectionLike;
-} | {
-  /** The proxy's address. `@2colors/esphome-native-api` loads on first use. */
-  host: string;
-  /** Defaults to the package's 6053. */
-  port?: number;
-  /** The proxy's Noise key, base64. Never logged. */
-  encryptionKey?: string;
-  password?: string;
-};
-export declare class EsphomeBleTransport implements BleTransport {
-  private readonly options;
-  private proxy;
-  private readonly ownsProxy;
-  private readonly scans;
-  private readonly claims;
-  /** A proxy refuses a connect with no address type, and only an advertisement carries it. */
-  private readonly addressTypes;
-  constructor(options: EsphomeBleTransportOptions);
-  /** The API connection, up and authorized. */
-  private ready;
-  private buildProxy;
-  scan({ timeoutMs, matches }: BleScanOptions): Promise<BleDeviceRef[]>;
-  /** Listen to advertisements until `done` accepts a device or the window ends. A proxy filters nothing. */
-  private listen;
-  connect(device: BleDeviceRef, handlers: BleLinkHandlers): Promise<BleConnection>;
-  /** Close the API connection, if this transport opened it. */
-  close(): void;
-}

package/dist/bluetooth/esphome.mjs

@@ -1,291 +0,0 @@
-import { AsyncLock, withTimeout } from "./async.mjs";
-import { APPEARANCE_UUID, CCCD_UUID, DEFAULT_SCAN_TIMEOUT_MS, GENERIC_ACCESS_UUID, NAME_UUID, SERVICE_UUID, VEHICLE_NOTIFY_UUID, VEHICLE_WRITE_UUID, VERSION_UUID } from "./constants.mjs";
-import { BleNotSubmittedError } from "./transport.mjs";
-import { LinkClaims, compactUuid, quietly } from "./adapters/shared.mjs";
-// src/bluetooth/adapters/esphome.ts
-/** The bytes that turn notifications on in a CCCD. */
-const CCCD_ENABLE_NOTIFICATIONS = Buffer.from([1, 0]);
-/** How long a proxy takes to answer a connect. The package's own wait is the same. */
-const DEVICE_CONNECT_WAIT_MS = 1e4;
-/** How long the API connection to the proxy may take. */
-const API_CONNECT_TIMEOUT_MS = 1e4;
-const ADVERTISEMENT = "message.BluetoothLEAdvertisementResponse";
-const CONNECTION_STATE = "message.BluetoothDeviceConnectionResponse";
-const NOTIFY_DATA = "message.BluetoothGATTNotifyDataResponse";
-/** One queue per proxy, however many transports or links share it. */
-const proxyQueues = /* @__PURE__ */ new WeakMap();
-function queueFor(proxy) {
-	let queue = proxyQueues.get(proxy);
-	if (!queue) {
-		queue = new AsyncLock();
-		proxyQueues.set(proxy, queue);
-	}
-	return queue;
-}
-/** A proxy's 48-bit address as a MAC, the form a caller would recognize. */
-function formatAddress(address) {
-	return address.toString(16).padStart(12, "0").replace(/(..)(?=.)/g, "$1:").toUpperCase();
-}
-function parseAddress(id) {
-	const hex = id.replace(/:/g, "");
-	if (!/^[0-9a-fA-F]{12}$/.test(hex)) throw new Error("An ESPHome device id must be a 48-bit address.");
-	return Number.parseInt(hex, 16);
-}
-function sameUuid(entry, uuid) {
-	return entry.uuid ? compactUuid(entry.uuid) === compactUuid(uuid) : (entry.shortUuid ?? 0).toString(16).padStart(4, "0") === compactUuid(uuid);
-}
-/** A late reply to an abandoned call can land on the next call of its type. */
-function assertReplyFor(reply, address, handle) {
-	if (reply.address !== address || reply.handle !== handle) throw new Error("The proxy's reply was for another request.");
-}
-var EsphomeConnection = class {
-	proxy;
-	address;
-	id;
-	handlers;
-	claims;
-	lost = false;
-	closed = false;
-	closing;
-	handles = /* @__PURE__ */ new Map();
-	mtu = 0;
-	onLost = () => {
-		if (this.lost) return;
-		this.lost = true;
-		this.stopListening();
-		if (!this.closed) this.handlers.onDisconnect();
-	};
-	onState = (state) => {
-		if (state.address === this.address && !state.connected) this.onLost();
-	};
-	notifyHandle;
-	onNotifyData = (message) => {
-		if (message.address === this.address && message.handle === this.notifyHandle) this.handlers.onNotify(Buffer.from(message.data, "base64"));
-	};
-	constructor(proxy, address, id, handlers, claims) {
-		this.proxy = proxy;
-		this.address = address;
-		this.id = id;
-		this.handlers = handlers;
-		this.claims = claims;
-	}
-	get queue() {
-		return queueFor(this.proxy);
-	}
-	get isConnected() {
-		return !this.lost && !this.closed && this.proxy.connected && this.proxy.authorized;
-	}
-	get maxWriteSize() {
-		return this.mtu > 3 ? this.mtu - 3 : 20;
-	}
-	/** Ask the proxy to connect. The reply is matched here, as a link dropping elsewhere sends the same message type. */
-	requestLink(addressType) {
-		const { proxy, address } = this;
-		return this.queue.run(async () => {
-			let onReply;
-			const reply = new Promise((resolve) => {
-				onReply = (state) => {
-					if (state.address === address) resolve(state);
-				};
-			});
-			proxy.on(CONNECTION_STATE, onReply);
-			try {
-				return await withTimeout(() => Promise.race([reply, proxy.connectBluetoothDeviceService(address, addressType, false).then(() => reply)]), DEVICE_CONNECT_WAIT_MS);
-			} finally {
-				proxy.off(CONNECTION_STATE, onReply);
-			}
-		});
-	}
-	/** Connect, map the handles, and subscribe. Resolves once the CCCD write is done. */
-	async open(addressType) {
-		const state = await this.requestLink(addressType);
-		if (!state.connected || state.error) {
-			this.lost = true;
-			throw new Error(`The proxy could not connect: error ${state.error}.`);
-		}
-		this.assertCurrent();
-		this.mtu = state.mtu;
-		const { proxy, address } = this;
-		proxy.on(CONNECTION_STATE, this.onState);
-		proxy.on("disconnected", this.onLost);
-		proxy.on("unauthorized", this.onLost);
-		const { servicesList } = await this.queue.run(() => proxy.listBluetoothGATTServicesService(address));
-		const service = servicesList.find((candidate) => sameUuid(candidate, SERVICE_UUID));
-		const characteristic = (uuid) => service?.characteristicsList.find((candidate) => sameUuid(candidate, uuid));
-		const write = characteristic(VEHICLE_WRITE_UUID);
-		const notify = characteristic(VEHICLE_NOTIFY_UUID);
-		const cccd = notify?.descriptorsList.find((descriptor) => sameUuid(descriptor, CCCD_UUID));
-		if (!write || !notify || !cccd) throw new Error("The vehicle's write or notify characteristic, or its CCCD, was not found.");
-		this.handles.set("write", write.handle);
-		const version = characteristic(VERSION_UUID);
-		if (version) this.handles.set("version", version.handle);
-		const genericAccess = servicesList.find((candidate) => sameUuid(candidate, GENERIC_ACCESS_UUID));
-		for (const [name, uuid] of [["deviceName", NAME_UUID], ["appearance", APPEARANCE_UUID]]) {
-			const entry = genericAccess?.characteristicsList.find((candidate) => sameUuid(candidate, uuid));
-			if (entry) this.handles.set(name, entry.handle);
-		}
-		this.assertCurrent();
-		this.notifyHandle = notify.handle;
-		proxy.on(NOTIFY_DATA, this.onNotifyData);
-		await this.queue.run(() => proxy.notifyBluetoothGATTCharacteristicService(address, notify.handle));
-		await this.queue.run(() => proxy.writeBluetoothGATTDescriptorService(address, cccd.handle, CCCD_ENABLE_NOTIFICATIONS));
-	}
-	/** A superseded attempt stops here, before it changes a link another attempt owns. */
-	assertCurrent() {
-		if (this.claims.superseded(this.id, this)) throw new Error("A newer connect attempt took over this link.");
-	}
-	async write(data) {
-		const { proxy, address } = this;
-		const handle = this.handles.get("write");
-		if (handle === void 0) throw new BleNotSubmittedError("The vehicle write characteristic was not found.");
-		const queuedAt = performance.now();
-		await this.queue.run(async () => {
-			if (!this.isConnected) throw new BleNotSubmittedError("The link is down.");
-			if (performance.now() - queuedAt >= 5e3) throw new BleNotSubmittedError("The write outlasted its timeout in the proxy queue.");
-			assertReplyFor(await proxy.writeBluetoothGATTCharacteristicService(address, handle, Buffer.from(data), true), address, handle);
-		});
-	}
-	async read(characteristic) {
-		const { proxy, address } = this;
-		const handle = this.handles.get(characteristic);
-		if (handle === void 0) throw new BleNotSubmittedError(`The ${characteristic} characteristic was not found.`);
-		const reply = await this.queue.run(() => {
-			if (!this.isConnected) throw new BleNotSubmittedError("The link is down.");
-			return proxy.readBluetoothGATTCharacteristicService(address, handle);
-		});
-		assertReplyFor(reply, address, handle);
-		return Buffer.from(reply.data, "base64");
-	}
-	stopListening() {
-		const { proxy } = this;
-		proxy.off(CONNECTION_STATE, this.onState);
-		proxy.off("disconnected", this.onLost);
-		proxy.off("unauthorized", this.onLost);
-		proxy.off(NOTIFY_DATA, this.onNotifyData);
-	}
-	disconnect() {
-		this.closing ??= (async () => {
-			this.closed = true;
-			this.stopListening();
-			const { claims, id, proxy, address } = this;
-			const superseded = claims.superseded(id, this);
-			claims.release(id, this);
-			if (!superseded && !this.lost && proxy.authorized) await quietly(() => this.queue.run(() => proxy.disconnectBluetoothDeviceService(address)));
-		})();
-		return this.closing;
-	}
-};
-var EsphomeBleTransport = class {
-	options;
-	proxy;
-	ownsProxy;
-	scans = new AsyncLock();
-	claims = new LinkClaims();
-	/** A proxy refuses a connect with no address type, and only an advertisement carries it. */
-	addressTypes = /* @__PURE__ */ new Map();
-	constructor(options) {
-		this.options = options;
-		this.ownsProxy = !("connection" in options);
-		if ("connection" in options) this.proxy = options.connection;
-	}
-	/** The API connection, up and authorized. */
-	async ready() {
-		const proxy = this.proxy ??= await this.buildProxy();
-		if (proxy.authorized) return proxy;
-		if (this.ownsProxy && !proxy.connected) proxy.connect();
-		let onAuthorized;
-		let onError;
-		try {
-			await withTimeout(() => new Promise((resolve, reject) => {
-				onAuthorized = resolve;
-				onError = reject;
-				proxy.on("authorized", onAuthorized);
-				proxy.on("error", onError);
-			}), API_CONNECT_TIMEOUT_MS);
-		} finally {
-			proxy.off("authorized", onAuthorized);
-			proxy.off("error", onError);
-		}
-		return proxy;
-	}
-	async buildProxy() {
-		if ("connection" in this.options) return this.options.connection;
-		const specifier = "@2colors/esphome-native-api";
-		let module;
-		try {
-			module = await import(specifier);
-		} catch (cause) {
-			throw new Error("EsphomeBleTransport needs @2colors/esphome-native-api, or a `connection` option.", { cause });
-		}
-		const Connection = module.Connection ?? module.default?.Connection;
-		if (!Connection) throw new Error("@2colors/esphome-native-api has no Connection.");
-		const { host, port, encryptionKey, password } = this.options;
-		const proxy = new Connection({
-			host,
-			port,
-			encryptionKey,
-			password
-		});
-		proxy.on("error", () => void 0);
-		return proxy;
-	}
-	async scan({ timeoutMs, matches }) {
-		const proxy = await this.ready();
-		return this.listen(proxy, timeoutMs, (device) => device.name !== void 0 && matches?.(device.name) === true);
-	}
-	/** Listen to advertisements until `done` accepts a device or the window ends. A proxy filters nothing. */
-	listen(proxy, timeoutMs, done) {
-		return this.scans.run(async () => {
-			const seen = /* @__PURE__ */ new Map();
-			let finish;
-			const finished = new Promise((resolve) => {
-				finish = resolve;
-			});
-			const onAdvertisement = (advertisement) => {
-				const id = formatAddress(advertisement.address);
-				this.addressTypes.set(id, advertisement.addressType ?? this.addressTypes.get(id));
-				const device = {
-					id,
-					name: advertisement.name || seen.get(id)?.name,
-					rssi: advertisement.rssi
-				};
-				seen.set(id, device);
-				if (done(device)) finish();
-			};
-			proxy.on(ADVERTISEMENT, onAdvertisement);
-			const timer = setTimeout(finish, Math.max(0, timeoutMs - 250));
-			try {
-				proxy.subscribeBluetoothAdvertisementService();
-				await finished;
-			} finally {
-				clearTimeout(timer);
-				proxy.off(ADVERTISEMENT, onAdvertisement);
-				await quietly(() => proxy.unsubscribeBluetoothAdvertisementService());
-			}
-			return [...seen.values()];
-		});
-	}
-	async connect(device, handlers) {
-		const address = parseAddress(device.id);
-		const id = formatAddress(address);
-		const proxy = await this.ready();
-		if (this.addressTypes.get(id) === void 0) await this.listen(proxy, DEFAULT_SCAN_TIMEOUT_MS, (seen) => seen.id === id && this.addressTypes.get(id) !== void 0);
-		const connection = new EsphomeConnection(proxy, address, id, handlers, this.claims);
-		this.claims.claim(id, connection);
-		try {
-			await connection.open(this.addressTypes.get(id));
-		} catch (error) {
-			await connection.disconnect();
-			throw error;
-		}
-		return connection;
-	}
-	/** Close the API connection, if this transport opened it. */
-	close() {
-		if (this.ownsProxy) {
-			this.proxy?.disconnect();
-			this.proxy = void 0;
-		}
-	}
-};
-export { EsphomeBleTransport };