homebridge-pitpat-treadmill 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 All notable changes to this project will be documented in this file. The project follows Semantic Versioning.
 
+## [0.1.2] - 2026-10-09
+
+### Fixed
+
+- Always use the hardware-validated 1.5 km/h minimum for remote starts.
+- Prevent `RotationSpeed` changes from starting a stopped treadmill.
+- Debounce HomeKit speed-slider updates to avoid BLE command floods.
+- Handle disconnects during command confirmation without unhandled HomeKit write errors.
+- Remove the unsupported `StatusFault` characteristic from the `Fanv2` service.
+
+## [0.1.1] - 2026-10-09
+
+### Changed
+
+- Publish releases through GitHub Actions and npm Trusted Publishing with OIDC provenance.
+- Document the automated release procedure.
+
 ## [0.1.0] - 2026-10-09
 
 ### Added

package/README.md

@@ -176,7 +176,7 @@ The initial packet structure was reimplemented from the MIT-licensed [`azmke/pit
 
 ## Publishing
 
-The npm name `homebridge-pitpat-treadmill` was unregistered when checked on 9 October 2026. Publication is manual and must not occur until hardware validation and release review are complete. No release workflow in this repository publishes automatically.
+The package is published on [npm](https://www.npmjs.com/package/homebridge-pitpat-treadmill). Future releases use npm Trusted Publishing from GitHub Actions, without a stored npm token. See [docs/PUBLISHING.md](docs/PUBLISHING.md).
 
 ## License
 

package/dist/accessories/treadmillAccessory.d.ts

@@ -11,14 +11,20 @@ export declare class TreadmillAccessory {
     private readonly fanService;
     private readonly telemetryService;
     private targetSpeedKph;
+    private activeCommand;
+    private pendingSpeedKph;
+    private speedUpdateTimer;
     constructor(accessory: PlatformAccessory, bleManager: BleManager, config: ValidatedConfig, api: API, log: Logger);
     private isActive;
     private currentSpeedPercentage;
     private currentFanState;
-    private statusFault;
     private setActive;
     private setSpeed;
+    private applyActive;
+    private scheduleSpeedUpdate;
+    private cancelPendingSpeedUpdate;
     private updateStatus;
     private updateConnectionState;
+    private refreshControlCharacteristics;
     private effectiveMaximumSpeed;
 }

package/dist/accessories/treadmillAccessory.js

@@ -10,6 +10,9 @@ export class TreadmillAccessory {
     fanService;
     telemetryService;
     targetSpeedKph = MINIMUM_COMMAND_SPEED_KPH;
+    activeCommand;
+    pendingSpeedKph;
+    speedUpdateTimer;
     constructor(accessory, bleManager, config, api, log) {
         this.accessory = accessory;
         this.bleManager = bleManager;
@@ -34,7 +37,6 @@ export class TreadmillAccessory {
             .onGet(() => this.currentSpeedPercentage())
             .onSet(async (value) => this.setSpeed(value));
         this.fanService.getCharacteristic(Characteristic.CurrentFanState).onGet(() => this.currentFanState());
-        this.fanService.getCharacteristic(Characteristic.StatusFault).onGet(() => this.statusFault());
         accessory
             .getService(Service.AccessoryInformation)
             ?.setCharacteristic(Characteristic.Manufacturer, 'PitPat (unofficial integration)')
@@ -63,40 +65,81 @@ export class TreadmillAccessory {
         }
         return this.api.hap.Characteristic.CurrentFanState.INACTIVE;
     }
-    statusFault() {
-        return this.bleManager.state === 'ready'
-            ? this.api.hap.Characteristic.StatusFault.NO_FAULT
-            : this.api.hap.Characteristic.StatusFault.GENERAL_FAULT;
-    }
     async setActive(value) {
         const active = Number(value) === this.api.hap.Characteristic.Active.ACTIVE;
-        if (!active) {
-            await this.bleManager.stopTreadmill();
+        if (this.activeCommand) {
+            await this.activeCommand;
             return;
         }
-        if (!this.config.allowRemoteStart) {
-            throw new this.api.hap.HapStatusError(-70412 /* this.api.hap.HAPStatus.NOT_ALLOWED_IN_CURRENT_STATE */);
-        }
-        await this.bleManager.startTreadmill(this.targetSpeedKph);
+        this.activeCommand = this.applyActive(active)
+            .catch((error) => {
+            this.log.warn(`[PiTPAT] HomeKit ${active ? 'start' : 'stop'} request was not applied: ${errorMessage(error)}`);
+            this.refreshControlCharacteristics();
+        })
+            .finally(() => {
+            this.activeCommand = undefined;
+        });
+        await this.activeCommand;
     }
     async setSpeed(value) {
         const percentage = Number(value);
         if (percentage === 0) {
-            await this.bleManager.stopTreadmill();
+            await this.setActive(this.api.hap.Characteristic.Active.INACTIVE);
             return;
         }
         const deviceMaximum = this.bleManager.status?.maximumSpeedKph ?? this.config.maximumSpeedKph;
         const requested = percentageToSpeed(percentage, this.effectiveMaximumSpeed(deviceMaximum));
         this.targetSpeedKph = Math.max(MINIMUM_COMMAND_SPEED_KPH, requested);
         if (this.bleManager.status?.runningState === RunningState.Running) {
-            await this.bleManager.setSpeed(this.targetSpeedKph);
-        }
-        else if (this.config.allowRemoteStart) {
-            await this.bleManager.startTreadmill(this.targetSpeedKph);
+            this.scheduleSpeedUpdate(this.targetSpeedKph);
         }
         else {
-            throw new this.api.hap.HapStatusError(-70412 /* this.api.hap.HAPStatus.NOT_ALLOWED_IN_CURRENT_STATE */);
+            // RotationSpeed must never start a stopped treadmill. Active is the only
+            // HomeKit control allowed to request a remote start.
+            this.refreshControlCharacteristics();
+        }
+    }
+    async applyActive(active) {
+        if (!active) {
+            this.cancelPendingSpeedUpdate();
+            if (this.bleManager.status?.runningState === RunningState.Stopped) {
+                return;
+            }
+            await this.bleManager.stopTreadmill();
+            return;
         }
+        if (!this.config.allowRemoteStart) {
+            throw new Error('remote start is disabled by configuration');
+        }
+        if (this.isActive() === this.api.hap.Characteristic.Active.ACTIVE) {
+            return;
+        }
+        // A remote start always uses the hardware-validated minimum. A separate,
+        // confirmed speed request may increase it only after Running is reported.
+        this.targetSpeedKph = MINIMUM_COMMAND_SPEED_KPH;
+        await this.bleManager.startTreadmill(MINIMUM_COMMAND_SPEED_KPH);
+    }
+    scheduleSpeedUpdate(speedKph) {
+        this.pendingSpeedKph = speedKph;
+        clearTimeout(this.speedUpdateTimer);
+        this.speedUpdateTimer = setTimeout(() => {
+            this.speedUpdateTimer = undefined;
+            const pendingSpeedKph = this.pendingSpeedKph;
+            this.pendingSpeedKph = undefined;
+            if (pendingSpeedKph === undefined || this.bleManager.status?.runningState !== RunningState.Running) {
+                return;
+            }
+            void this.bleManager.setSpeed(pendingSpeedKph).catch((error) => {
+                this.log.warn(`[PiTPAT] HomeKit speed request was not applied: ${errorMessage(error)}`);
+                this.refreshControlCharacteristics();
+            });
+        }, 750);
+        this.speedUpdateTimer.unref();
+    }
+    cancelPendingSpeedUpdate() {
+        clearTimeout(this.speedUpdateTimer);
+        this.speedUpdateTimer = undefined;
+        this.pendingSpeedKph = undefined;
     }
     updateStatus({ status }) {
         const { Characteristic } = this.api.hap;
@@ -105,19 +148,28 @@ export class TreadmillAccessory {
         this.fanService.updateCharacteristic(Characteristic.Active, this.isActive());
         this.fanService.updateCharacteristic(Characteristic.RotationSpeed, this.currentSpeedPercentage());
         this.fanService.updateCharacteristic(Characteristic.CurrentFanState, this.currentFanState());
-        this.fanService.updateCharacteristic(Characteristic.StatusFault, Characteristic.StatusFault.NO_FAULT);
         this.telemetryService.updateStatus(status);
         if (this.config.debug) {
             this.log.debug(`[PiTPAT] Speed updated: ${status.currentSpeedKph.toFixed(1)} km/h, state ${status.runningState}`);
         }
     }
     updateConnectionState(state) {
-        this.fanService.updateCharacteristic(this.api.hap.Characteristic.StatusFault, state === 'ready'
-            ? this.api.hap.Characteristic.StatusFault.NO_FAULT
-            : this.api.hap.Characteristic.StatusFault.GENERAL_FAULT);
+        if (state !== 'ready') {
+            this.cancelPendingSpeedUpdate();
+            this.refreshControlCharacteristics();
+        }
         this.telemetryService.updateConnection(state);
     }
+    refreshControlCharacteristics() {
+        const { Characteristic } = this.api.hap;
+        this.fanService.updateCharacteristic(Characteristic.Active, this.isActive());
+        this.fanService.updateCharacteristic(Characteristic.RotationSpeed, this.currentSpeedPercentage());
+        this.fanService.updateCharacteristic(Characteristic.CurrentFanState, this.currentFanState());
+    }
     effectiveMaximumSpeed(deviceMaximumSpeedKph) {
         return Math.min(this.config.maximumSpeedKph, deviceMaximumSpeedKph);
     }
 }
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}

package/dist/bluetooth/bleManager.js

@@ -172,15 +172,23 @@ export class BleManager extends EventEmitter {
                     resolve(event.status);
                 }
             };
+            const onConnectionState = (state) => {
+                if (state === 'disconnected' || state === 'disconnecting') {
+                    cleanup();
+                    reject(new Error('BLE disconnected while waiting for treadmill confirmation'));
+                }
+            };
             const cleanup = () => {
                 clearTimeout(timer);
                 this.removeListener('status', onStatus);
+                this.removeListener('connectionState', onConnectionState);
             };
             const timer = setTimeout(() => {
                 cleanup();
                 reject(new Error('timed out waiting for treadmill confirmation'));
             }, timeoutMs);
             this.on('status', onStatus);
+            this.on('connectionState', onConnectionState);
         });
     }
     scheduleReconnect() {

package/docs/PUBLISHING.md

@@ -0,0 +1,43 @@
+# Publishing
+
+Releases are published to npm through GitHub Actions and npm Trusted Publishing. No npm token is stored in GitHub.
+
+## One-time npm configuration
+
+Configure a GitHub Actions trusted publisher for `homebridge-pitpat-treadmill` with:
+
+- Organization or user: `Alexxanddr`
+- Repository: `homebridge-pitpat-treadmill`
+- Workflow filename: `release.yml`
+- Environment: leave empty
+
+The workflow path is `.github/workflows/release.yml`. npm matches the filename, repository, and owner exactly.
+
+## Release procedure
+
+1. Update `CHANGELOG.md`.
+2. Run the complete local check:
+
+   ```bash
+   npm run check
+   npm pack --dry-run
+   ```
+
+3. Create the version commit and tag:
+
+   ```bash
+   npm version patch
+   git push origin master --follow-tags
+   ```
+
+   Use `minor` or `major` instead of `patch` when appropriate.
+
+4. Create and publish the matching GitHub release, for example `v0.1.1`.
+5. The `Publish to npm` workflow verifies that the release tag equals `v` plus the package version, reruns all checks, and publishes with OIDC credentials.
+6. Verify the registry:
+
+   ```bash
+   npm view homebridge-pitpat-treadmill version dist-tags
+   ```
+
+Trusted Publishing automatically adds npm provenance. Draft releases do not publish until they are changed to published. Re-running a failed workflow is safe only when that version does not already exist on npm; npm versions are immutable.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "homebridge-pitpat-treadmill",
   "displayName": "PitPat Treadmill",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Local Homebridge integration for PitPat treadmills over Bluetooth Low Energy.",
   "type": "module",
   "main": "dist/index.js",
@@ -47,6 +47,9 @@
   "bugs": {
     "url": "https://github.com/Alexxanddr/homebridge-pitpat-treadmill/issues"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "dependencies": {
     "@stoprocent/noble": "2.8.0"
   },