homebridge-ring-secure-video 1.0.2 → 1.0.3

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # homebridge-ring-secure-video
 
+## 1.0.3 (2026-11-14)
+
+- README: a doorbell press during a live view (in the Home app, or opened outside the plugin
+  through Ring) is now tested to start a recording with `doorbellPressMotion`.
+- A live view or recording no longer logs `UNKNOWN MESSAGE` and a message as errors when Ring sends
+  `camera_options` (Ring confirming a setting ring-client-api 14.3.0 sends when a video session
+  starts, harmless); it is logged at debug. Any other unknown message is still logged as an error.
+- "Pruning unused service" log lines include the service and device again (only the first words
+  were logged).
+
 ## 1.0.2 (2026-11-14)
 
 - The package declares that it publishes accessories over HAP (the `supports-hap` keyword), as

package/README.md

@@ -179,8 +179,12 @@ no motion event, motion notification or HKSV recording starts during a live view
 Protect, Ring may still save the live view itself). Once the live view is closed, motion is
 reported again. Opening a live view doesn't cut off an HKSV recording that is already running
 (both share one Ring connection), but that recording still ends as usual once its motion ends.
-With `doorbellPressMotion` on, a doorbell press during a live view still starts a recording, as
-long as Ring delivers the press during the live view (not tested yet).
+With `doorbellPressMotion` on, a doorbell press during a live view still starts a recording:
+tested with a Ring Video Doorbell 3 Plus, both with a live view open in the Home app and with one
+opened outside the plugin, through Ring (a Brilliant panel's Ring integration). Ring delivered the
+press each time, and HomeKit asked for the recording 2 to 3 seconds after the press reached the
+plugin. The clip starts only once Ring's video arrives, and the plugin keeps no video from before
+an event, so the moment of the press itself isn't in the clip.
 
 With recording on, the Home app notifies about a camera's motion only after its home hub has
 analysed the clip, which can be late or never. For a notification as soon as Ring reports

package/lib/ring-logger.js

@@ -0,0 +1,39 @@
+/**
+ * Video session messages Ring sends that ring-client-api 14.3.0 doesn't list, so it logs each as
+ * an "UNKNOWN MESSAGE" error followed by the message. camera_options is Ring confirming the
+ * stealth_mode setting the library sends when a session starts: harmless, so debug only.
+ */
+const HARMLESS_SESSION_MESSAGES = new Set(['camera_options']);
+/** The logger ring-client-api uses, writing to the Homebridge log. */
+export function createRingLogger(log) {
+    // ring-client-api logs "UNKNOWN MESSAGE" and then, right after, the message itself.
+    let unknownPending = false;
+    const flushUnknown = () => {
+        if (unknownPending) {
+            unknownPending = false;
+            log.error('UNKNOWN MESSAGE');
+        }
+    };
+    return {
+        // Variadic, as ring-client-api's logInfo is (e.g. "Pruning unused service" with its details).
+        logInfo(...message) {
+            flushUnknown();
+            log.info(...message);
+        },
+        logError(message) {
+            if (message === 'UNKNOWN MESSAGE') {
+                flushUnknown();
+                unknownPending = true;
+                return;
+            }
+            if (unknownPending && HARMLESS_SESSION_MESSAGES.has(message?.method)) {
+                unknownPending = false;
+                // Not the whole message: its session_id is a session token.
+                log.debug(`Ring video session message ignored: ${message.method} (stealth_mode=${message.body?.stealth_mode})`);
+                return;
+            }
+            flushUnknown();
+            log.error(message);
+        },
+    };
+}

package/lib/ring-platform.js

@@ -25,6 +25,7 @@ import { readFileSync } from 'fs';
 import { getSessionRefreshSensorUuid, SessionRefreshSensor, } from "./session-refresh-sensor.js";
 import { PanicButtons } from "./panic-buttons.js";
 import { logError, logInfo, useLogger } from 'ring-client-api/util';
+import { createRingLogger } from "./ring-logger.js";
 import { FloodFreezeSensor } from "./flood-freeze-sensor.js";
 import { FreezeSensor } from "./freeze-sensor.js";
 import { TemperatureSensor } from "./temperature-sensor.js";
@@ -319,14 +320,7 @@ export class RingPlatform {
             return;
         }
         if (!config.disableLogs) {
-            useLogger({
-                logInfo(message) {
-                    log.info(message);
-                },
-                logError(message) {
-                    log.error(message);
-                },
-            });
+            useLogger(createRingLogger(log));
         }
         if (pushReceiverFix.result === 'failed') {
             this.log.warn(`Could not fix Ring push notifications (${pushReceiverFix.detail}); instant motion and doorbell events may not arrive`);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "homebridge-ring-secure-video",
   "displayName": "Ring Secure Video",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Homebridge plugin for Ring devices with HomeKit Secure Video recording, based on homebridge-ring and homebridge-ring-hksv",
   "type": "module",
   "main": "./lib/index.js",