homebridge-ring-hksv 14.3.3 → 14.3.5

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 ## Unreleased
 
+### Patch Changes
+
+- Prevent lock accessories from reporting invalid `LockTargetState` values when Ring reports a jammed or unknown current state. This removes repeated Homebridge warnings while preserving the correct current lock state in HomeKit.
+
+## 14.3.4
+
+### Patch Changes
+
+- Fix Homebridge platform discovery by using the current platform registration API and explicit package entry metadata. This addresses installs where the plugin appeared in Homebridge UI but Homebridge could not resolve the `Homebridge Ring HKSV` platform during boot.
+
 ### Minor Changes
 
 - Add `homeKitAccessoryTag` to append a custom tag to Ring accessory names and generated HomeKit identities. This helps expose the same physical camera/accessory as a distinct HomeKit device for debugging or multi-home testing.

package/lib/index.js

@@ -1,6 +1,6 @@
-import { platformName, pluginName, RingPlatform } from "./ring-platform.js";
+import { platformName, RingPlatform } from "./ring-platform.js";
 import { setHap } from "./hap.js";
-export default function (homebridge) {
-    setHap(homebridge.hap);
-    homebridge.registerPlatform(pluginName, platformName, RingPlatform, true);
+export default function (api) {
+    setHap(api.hap);
+    api.registerPlatform(platformName, RingPlatform);
 }

package/lib/lock.js

@@ -55,6 +55,15 @@ export class Lock extends BaseDeviceAccessory {
         return this.device.sendCommand(`lock.${command}`);
     }
     getTargetState(data) {
-        return this.targetState || getCurrentState(data);
+        if (this.targetState !== undefined) {
+            return this.targetState;
+        }
+        const { Characteristic: { LockCurrentState, LockTargetState }, } = hap;
+        const currentState = getCurrentState(data);
+        if (currentState === LockCurrentState.JAMMED ||
+            currentState === LockCurrentState.UNKNOWN) {
+            return LockTargetState.SECURED;
+        }
+        return currentState;
     }
 }

package/lib/ring-platform.js

@@ -37,7 +37,7 @@ const ignoreHiddenDeviceTypes = [
     RingDeviceType.BeamsDevice,
     RingDeviceType.PanicButton,
 ];
-export const platformName = 'RingHKSV';
+export const platformName = 'Homebridge Ring HKSV';
 export const pluginName = 'homebridge-ring-hksv';
 function getAccessoryClass(device) {
     const { deviceType } = device;
@@ -130,7 +130,7 @@ export class RingPlatform {
             });
         }
         if (!config) {
-            logInfo('No configuration found for platform RingHKSV');
+            logInfo('No configuration found for platform Homebridge Ring HKSV');
             return;
         }
         config.cameraStatusPollingSeconds = config.cameraStatusPollingSeconds ?? 20;

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "homebridge-ring-hksv",
   "displayName": "Homebridge Ring HKSV",
-  "version": "14.3.3",
+  "version": "14.3.5",
   "description": "Homebridge plugin for Ring devices with HomeKit Secure Video support",
   "type": "module",
-  "main": "lib/index.js",
+  "main": "./lib/index.js",
+  "exports": "./lib/index.js",
   "scripts": {
-    "build": "rm -rf lib && tsc && cp -r ./homebridge-ui/public ./lib/homebridge-ui/public/",
+    "build": "node -e \"require('fs').rmSync('lib', { recursive: true, force: true })\" && tsc && node -e \"require('fs').cpSync('./homebridge-ui/public', './lib/homebridge-ui/public', { recursive: true })\"",
     "lint": "eslint .",
+    "prepack": "npm run build",
     "dev": "concurrently -c yellow,blue --kill-others \"npm:dev:build\" \"npm:dev:run\" ",
     "dev:build": "tsc --watch --preserveWatchOutput",
     "dev:run": "RING_DEBUG=true node --watch ./node_modules/.bin/homebridge -U ./.homebridge -P ./node_modules"
@@ -32,6 +34,10 @@
     "node": "^20 || ^22 || ^24",
     "homebridge": ">=1.4.0 || ^2.0.0-beta.0"
   },
+  "homebridge": {
+    "pluginAlias": "Homebridge Ring HKSV",
+    "pluginType": "platform"
+  },
   "author": "trinityhades",
   "license": "MIT",
   "repository": {