ring-client-api 14.1.0 → 14.3.0

package/lib/api.d.ts

@@ -1,7 +1,7 @@
 import type { RefreshTokenAuth, SessionOptions } from './rest-client.ts';
 import { RingRestClient } from './rest-client.ts';
 import { Location } from './location.ts';
-import type { BaseStation, BeamBridge, CameraData, ChimeData, IntercomHandsetAudioData, OnvifCameraData, ProfileResponse, ThirdPartyGarageDoorOpener, UnknownDevice, UserLocation } from './ring-types.ts';
+import type { BaseStation, BeamBridge, CameraData, ChimeData, IntercomHandsetData, OnvifCameraData, ProfileResponse, ThirdPartyGarageDoorOpener, UnknownDevice, UserLocation } from './ring-types.ts';
 import type { AnyCameraData } from './ring-camera.ts';
 import { RingCamera } from './ring-camera.ts';
 import { Subscribed } from './subscribed.ts';
@@ -35,7 +35,7 @@ export declare class RingApi extends Subscribed {
         beamBridges: BeamBridge[];
         onvifCameras: OnvifCameraData[];
         thirdPartyGarageDoorOpeners: ThirdPartyGarageDoorOpener[];
-        intercoms: IntercomHandsetAudioData[];
+        intercoms: IntercomHandsetData[];
         unknownDevices: UnknownDevice[];
     }>;
     private listenForDeviceUpdates;

package/lib/api.js

@@ -39,6 +39,7 @@ export class RingApi extends Subscribed {
                 case RingDeviceType.OnvifCamera:
                     onvifCameras.push(device);
                     break;
+                case RingDeviceType.IntercomHandsetVideo:
                 case RingDeviceType.IntercomHandsetAudio:
                     intercoms.push(device);
                     break;

package/lib/ring-camera.js

@@ -275,6 +275,10 @@ export class RingCamera extends Subscribed {
         return new WebrtcConnection(response.ticket, this, options);
     }
     async startLiveCall(options = {}) {
+        // Check if live view is disabled by camera settings/modes
+        if (this.data.settings?.live_view_disabled === true) {
+            throw new Error(`Live view is currently disabled for ${this.name}. This camera has been disabled via mode settings in the Ring app. Enable live view for this camera in the Ring app to start streaming.`);
+        }
         const connection = await this.createStreamingConnection(options);
         return new StreamingSession(this, connection);
     }

package/lib/ring-chime.d.ts

@@ -33,4 +33,5 @@ export declare class RingChime {
     updateChime(update: ChimeUpdate): Promise<boolean>;
     setVolume(volume: number): Promise<boolean>;
     getHealth(): Promise<ChimeHealth>;
+    setNightlightEnabled(enabled: boolean): Promise<void>;
 }

package/lib/ring-chime.js

@@ -1,5 +1,5 @@
 import { ChimeModel } from "./ring-types.js";
-import { clientApi } from "./rest-client.js";
+import { clientApi, deviceApi } from "./rest-client.js";
 import { BehaviorSubject, Subject } from 'rxjs';
 const settingsWhichRequireReboot = [
     'ding_audio_id',
@@ -107,4 +107,16 @@ export class RingChime {
         });
         return response.device_health;
     }
+    async setNightlightEnabled(enabled) {
+        await this.restClient.request({
+            url: deviceApi(`devices/${this.id}/settings`),
+            method: 'PATCH',
+            json: {
+                night_light_settings: {
+                    light_sensor_enabled: enabled,
+                },
+            },
+        });
+        this.requestUpdate();
+    }
 }

package/lib/ring-intercom.d.ts

@@ -1,20 +1,20 @@
-import type { IntercomHandsetAudioData, PushNotification } from './ring-types.ts';
+import type { IntercomHandsetData, PushNotification } from './ring-types.ts';
 import type { RingRestClient } from './rest-client.ts';
 import { BehaviorSubject, Subject } from 'rxjs';
 export declare class RingIntercom {
     id: number;
-    deviceType: "intercom_handset_audio";
-    onData: BehaviorSubject<IntercomHandsetAudioData>;
+    deviceType: "intercom_handset_audio" | "intercom_handset_video";
+    onData: BehaviorSubject<IntercomHandsetData>;
     onRequestUpdate: Subject<unknown>;
     onBatteryLevel: import("rxjs").Observable<number | null>;
     onDing: Subject<void>;
     onUnlocked: Subject<void>;
     private initialData;
     private restClient;
-    constructor(initialData: IntercomHandsetAudioData, restClient: RingRestClient);
-    updateData(update: IntercomHandsetAudioData): void;
+    constructor(initialData: IntercomHandsetData, restClient: RingRestClient);
+    updateData(update: IntercomHandsetData): void;
     requestUpdate(): void;
-    get data(): IntercomHandsetAudioData;
+    get data(): IntercomHandsetData;
     get name(): string;
     get isOffline(): boolean;
     get batteryLevel(): number | null;

package/lib/ring-types.d.ts

@@ -43,6 +43,7 @@ export declare const RingDeviceType: {
     readonly OnvifCamera: "onvif_camera";
     readonly ThirdPartyGarageDoorOpener: "third_party_gdo";
     readonly IntercomHandsetAudio: "intercom_handset_audio";
+    readonly IntercomHandsetVideo: "intercom_handset_video";
     readonly WaterValve: "valve.water";
     readonly KiddeSmokeCoAlarm: "comp.bluejay.sensor_bluejay_wsc";
 };
@@ -157,10 +158,18 @@ export interface RingDeviceData {
     };
     alarmStatus?: 'active';
     co?: {
-        alarmStatus?: 'active';
+        alarmStatus?: 'active' | 'inactive';
     };
     smoke?: {
-        alarmStatus?: 'active';
+        alarmStatus?: 'active' | 'inactive';
+    };
+    components?: {
+        'alarm.co'?: {
+            alarmStatus?: 'active' | 'inactive';
+        };
+        'alarm.smoke'?: {
+            alarmStatus?: 'active' | 'inactive';
+        };
     };
     flood?: {
         faulted?: boolean;
@@ -257,7 +266,11 @@ export interface ChimeData {
         ding_audio_id: string;
         motion_audio_user_id: string;
         motion_audio_id: string;
+        night_light_settings?: {
+            light_sensor_enabled: boolean;
+        };
     };
+    night_light_state?: string;
     features: {
         ringtones_enabled: boolean;
     };
@@ -291,6 +304,9 @@ export interface ChimeUpdate {
         ding_audio_id?: string;
         motion_audio_user_id?: string;
         motion_audio_id?: string;
+        night_light_settings?: {
+            light_sensor_enabled?: boolean;
+        };
     };
 }
 export interface RingtoneOptions {
@@ -540,11 +556,11 @@ export interface ThirdPartyGarageDoorOpener {
     ring_net_id: null;
     is_sidewalk_gateway: boolean;
 }
-export interface IntercomHandsetAudioData {
+export interface IntercomHandsetData {
     id: number;
     description: string;
     device_id: string;
-    kind: typeof RingDeviceType.IntercomHandsetAudio;
+    kind: typeof RingDeviceType.IntercomHandsetAudio | typeof RingDeviceType.IntercomHandsetVideo;
     function: {
         name: null;
     };
@@ -906,7 +922,7 @@ export interface PushNotificationDingV2 {
         device: {
             e2ee_enabled: boolean;
             id: number;
-            kind: RingCameraKind | typeof RingDeviceType.IntercomHandsetAudio;
+            kind: RingCameraKind | typeof RingDeviceType.IntercomHandsetAudio | typeof RingDeviceType.IntercomHandsetVideo;
             name: string;
         };
         event: {

package/lib/ring-types.js

@@ -42,6 +42,7 @@ export const RingDeviceType = {
     OnvifCamera: 'onvif_camera',
     ThirdPartyGarageDoorOpener: 'third_party_gdo',
     IntercomHandsetAudio: 'intercom_handset_audio',
+    IntercomHandsetVideo: 'intercom_handset_video',
     WaterValve: 'valve.water',
     KiddeSmokeCoAlarm: 'comp.bluejay.sensor_bluejay_wsc',
 };

package/lib/streaming/simple-webrtc-session.js

@@ -11,6 +11,10 @@ export class SimpleWebRtcSession {
         this.restClient = restClient;
     }
     async start(sdp) {
+        // Check if live view is disabled by camera settings/modes
+        if (this.camera.data.settings?.live_view_disabled === true) {
+            throw new Error(`Live view is currently disabled for ${this.camera.name}. This camera has been disabled via mode settings in the Ring app. Enable live view for this camera in the Ring app to start streaming.`);
+        }
         const response = await this.restClient.request({
             method: 'POST',
             url: liveViewUrl('start'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ring-client-api",
-  "version": "14.1.0",
+  "version": "14.3.0",
   "description": "Unofficial API for Ring doorbells, cameras, security alarm system and smart lighting",
   "main": "lib/index.js",
   "type": "module",
@@ -24,22 +24,22 @@
     "debug": "^4.4.3",
     "json-bigint": "^1.0.0",
     "rxjs": "^7.8.2",
-    "systeminformation": "^5.27.10",
-    "undici": "^7.16.0",
+    "systeminformation": "^5.30.7",
+    "undici": "^7.19.2",
     "uuid": "^13.0.0",
-    "werift": "0.22.2"
+    "werift": "0.22.4"
   },
   "devDependencies": {
     "@types/debug": "4.1.12",
     "@types/json-bigint": "^1.0.4",
-    "@types/node": "24.5.2",
+    "@types/node": "25.1.0",
     "@types/uuid": "11.0.0",
     "@types/ws": "^8.18.1",
     "eslint-config-shared": "*",
-    "msw": "^2.11.3",
+    "msw": "^2.12.7",
     "tsconfig": "*",
-    "typescript": "5.9.2",
-    "vitest": "^3.2.4"
+    "typescript": "5.9.3",
+    "vitest": "^4.0.18"
   },
   "engines": {
     "node": "^20 || ^22 || ^24"