homebridge-pitpat-treadmill 0.1.2 → 0.1.4

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to this project will be documented in this file. The project follows Semantic Versioning.
 
+## [0.1.4] - 2026-10-09
+
+### Fixed
+
+- Allow an isolated Homebridge child bridge to use a host BlueZ D-Bus socket via `PITPAT_DBUS_SYSTEM_BUS_ADDRESS` without redirecting Avahi or other container services.
+
+## [0.1.3] - 2026-10-09
+
+### Fixed
+
+- Attempt one controlled HCI controller reset when Noble remains outside the `poweredOn` state after a BLE link timeout.
+- Preserve normal reconnect backoff when the adapter cannot recover.
+
 ## [0.1.2] - 2026-10-09
 
 ### Fixed

package/README.md

@@ -130,6 +130,8 @@ HomeKit does not reliably tell a plugin whether a write came from a person, Siri
 
 The container needs access to the host Bluetooth stack or a dedicated HCI adapter. Device mapping and D-Bus configuration vary by host. Docker operation has not yet been verified and is not currently claimed as supported.
 
+When the plugin runs as an isolated child bridge with Noble's D-Bus binding, set `NOBLE_BINDINGS=dbus` and use `PITPAT_DBUS_SYSTEM_BUS_ADDRESS` for a host socket mounted at a non-default path. The plugin copies this value to `DBUS_SYSTEM_BUS_ADDRESS` inside its child process only, so container services such as Avahi continue using the container's own system bus. The D-Bus binding also requires `dbus-next` to be installed in the Homebridge environment.
+
 ### Common messages
 
 - `treadmill ... was not discovered`: verify the exact identifier, power, range, and that the mobile app is closed.

package/dist/bluetooth/nobleTransport.d.ts

@@ -1,7 +1,12 @@
+import type { Logger } from 'homebridge';
 import type { BleConnection, BleTransport } from './transport.js';
 export declare class NobleTransport implements BleTransport {
+    private readonly log;
     private noble?;
+    constructor(log: Pick<Logger, 'warn'>);
     private loadNoble;
     connect(deviceIdentifier: string, timeoutMs: number): Promise<BleConnection>;
+    private ensurePoweredOn;
     private findPeripheral;
 }
+export declare function configureNobleDbusAddress(env?: NodeJS.ProcessEnv): void;

package/dist/bluetooth/nobleTransport.js

@@ -39,9 +39,14 @@ class NobleConnection {
     }
 }
 export class NobleTransport {
+    log;
     noble;
+    constructor(log) {
+        this.log = log;
+    }
     async loadNoble() {
         if (!this.noble) {
+            configureNobleDbusAddress();
             const module = await import('@stoprocent/noble');
             this.noble = module.default;
         }
@@ -49,7 +54,7 @@ export class NobleTransport {
     }
     async connect(deviceIdentifier, timeoutMs) {
         const noble = await this.loadNoble();
-        await noble.waitForPoweredOnAsync(timeoutMs);
+        await this.ensurePoweredOn(noble, timeoutMs);
         const peripheral = await this.findPeripheral(noble, deviceIdentifier, timeoutMs);
         await peripheral.connectAsync();
         try {
@@ -71,6 +76,25 @@ export class NobleTransport {
             throw error;
         }
     }
+    async ensurePoweredOn(noble, timeoutMs) {
+        try {
+            await noble.waitForPoweredOnAsync(timeoutMs);
+            return;
+        }
+        catch (error) {
+            if (noble.state === 'unauthorized' || noble.state === 'unsupported') {
+                throw error;
+            }
+            this.log.warn(`[PiTPAT] BLE adapter state is ${noble.state}; attempting one controller reset`);
+            noble.reset();
+            try {
+                await noble.waitForPoweredOnAsync(Math.min(timeoutMs, 10_000));
+            }
+            catch (recoveryError) {
+                throw new Error(`BLE adapter did not recover after reset (state ${noble.state}): ${errorMessage(recoveryError)}`, { cause: recoveryError });
+            }
+        }
+    }
     async findPeripheral(noble, configuredIdentifier, timeoutMs) {
         const expected = normalizeIdentifier(configuredIdentifier);
         return await new Promise((resolve, reject) => {
@@ -111,3 +135,12 @@ export class NobleTransport {
         });
     }
 }
+export function configureNobleDbusAddress(env = process.env) {
+    const address = env.PITPAT_DBUS_SYSTEM_BUS_ADDRESS?.trim();
+    if (address) {
+        env.DBUS_SYSTEM_BUS_ADDRESS = address;
+    }
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}

package/dist/platform.js

@@ -40,7 +40,7 @@ export class PitPatPlatform {
             accessory = new this.api.platformAccessory(config.name, uuid, 3 /* this.api.hap.Categories.FAN */);
             this.api.registerPlatformAccessories(PLUGIN_NAME, PLATFORM_NAME, [accessory]);
         }
-        this.bleManager = new BleManager(config, new NobleTransport(), this.log);
+        this.bleManager = new BleManager(config, new NobleTransport(this.log), this.log);
         new TreadmillAccessory(accessory, this.bleManager, config, this.api, this.log);
         void this.bleManager.start().catch(() => undefined);
         const staleAccessories = [...this.cachedAccessories.values()].filter((cached) => cached.UUID !== uuid);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "homebridge-pitpat-treadmill",
   "displayName": "PitPat Treadmill",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Local Homebridge integration for PitPat treadmills over Bluetooth Low Energy.",
   "type": "module",
   "main": "dist/index.js",