Added support for t8531

CLAUDE.md

@@ -0,0 +1,130 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Overview
+
+This is a TypeScript client library for controlling Eufy Security devices by connecting to Eufy cloud servers and local/remote stations over P2P. The library is published to npm as `eufy-security-client`.
+
+**Important:** This project is NOT affiliated with Anker/Eufy Security. It is a personal project maintained in spare time.
+
+## Development Commands
+
+### Build
+```bash
+npm run build          # Full build (compiles TypeScript)
+npm run build:ts       # TypeScript compilation + copy proto files
+```
+
+### Development
+```bash
+npm run watch          # Watch mode (auto-recompile on changes)
+npm run watch:ts       # Watch TypeScript files only
+```
+
+### Linting
+```bash
+npm run lint           # Run ESLint on TypeScript source files
+```
+
+### Testing
+Currently, there are no tests configured (`npm test` exits with error).
+
+## Architecture
+
+### Core Components
+
+The library is organized into four major subsystems, each with its own directory:
+
+1. **HTTP API (`src/http/`)** - Eufy Cloud API communication
+   - `api.ts`: Main HTTPApi class handling authentication and cloud requests
+   - `device.ts`: Device class hierarchy (Camera, Lock, Doorbell, Sensor types, etc.)
+   - `station.ts`: Station/Hub management
+   - Uses encrypted API v2 communication with RSA/ECDH key exchange
+   - Handles authentication including 2FA and captcha
+
+2. **P2P Communication (`src/p2p/`)** - Direct peer-to-peer connection with stations/devices
+   - `session.ts`: P2PClientProtocol handles UDP-based P2P protocol
+   - Supports local and remote connectivity to stations
+   - Handles livestreaming, video download, commands (lock/unlock, enable/disable, etc.)
+   - Complex packet sequencing and encryption handling
+   - Supports multiple encryption types (none, type1, type2)
+
+3. **Push Notifications (`src/push/`)** - Unified push message interface
+   - `service.ts`: PushNotificationService manages FCM-based notifications
+   - `parser.ts`: Normalizes different push notification types
+   - Handles motion, person detection, doorbell ring events, etc.
+
+4. **MQTT (`src/mqtt/`)** - MQTT subscription for certain devices
+   - Supports Smart Lock Touch & Wifi and similar MQTT-enabled devices
+
+### Main Entry Point
+
+- **`src/eufysecurity.ts`**: The `EufySecurity` class is the high-level orchestrator
+  - Must be initialized with `EufySecurity.initialize()` (async factory pattern)
+  - Manages all stations, devices, and houses
+  - Coordinates HTTP API, P2P connections, push notifications, and MQTT
+  - Emits typed events for device/station state changes
+  - Handles persistent data storage for credentials and state
+
+### Key Design Patterns
+
+- **Typed Event Emitters**: Uses `tiny-typed-emitter` throughout for type-safe events
+- **Async Initialization**: Main classes use static `initialize()` factory methods instead of constructors
+- **Persistent Data**: Credentials and session data saved to filesystem (default: `.eufy-security-client/`)
+- **Property System**: Devices/stations have a metadata-driven property system with read-only/write restrictions
+- **Command Queue**: P2P commands are queued and executed sequentially per station
+
+### Communication Layers
+
+```
+EufySecurity (High-level API)
+    ├── HTTPApi (Cloud API for device metadata, authentication)
+    ├── P2PClientProtocol (Direct station communication for commands/streaming)
+    ├── PushNotificationService (Real-time event notifications)
+    └── MQTTService (MQTT-enabled device events)
+```
+
+### Device Hierarchy
+
+All devices inherit from base `Device` class with specialized subclasses:
+- Camera types: `Camera`, `IndoorCamera`, `SoloCamera`, `FloodlightCamera`, `WallLightCam`, `GarageCamera`
+- Doorbell types: `BatteryDoorbellCamera`, `WiredDoorbellCamera`, `DoorbellLock`
+- Lock types: `Lock`, `LockKeypad`
+- Sensors: `EntrySensor`, `MotionSensor`
+- Other: `Keypad`, `SmartSafe`, `SmartDrop`, `Tracker`
+
+Each device type has specific properties and commands based on hardware capabilities.
+
+## TypeScript Configuration
+
+- Target: ES2022
+- Module: Node16 with Node16 resolution
+- Strict mode enabled
+- Build output: `build/` directory
+- Source maps generated
+- Declaration files (`.d.ts`) generated for npm package
+
+## Publishing
+
+- Main entry: `build/index.js`
+- Requires Node.js >= 20.0.0
+- Uses `prepublishOnly` script to ensure build runs before publishing
+- Proto files (`.proto`) and certificates (`.crt`) are copied to build directory
+
+## P2P Protocol Notes
+
+The P2P protocol is UDP-based with custom sequencing and encryption:
+- Supports local (LAN) and remote (through Eufy cloud) connections
+- Uses magic word `0xf1e2d3c4` in packet headers
+- Multiple encryption modes with AES and RSA
+- Handles livestreaming with separate video/audio packet sequencing
+- Energy-saving devices have different keepalive/timeout strategies
+- Smart locks use BLE-style command structures wrapped in P2P
+
+## Logging
+
+Uses `typescript-logging` with category-based logging:
+- Categories: HTTP, P2P, PUSH, MQTT
+- Configurable log levels per category
+- Default logger can be replaced via `EufySecurity.initialize()` config

README.md

@@ -156,7 +156,7 @@ Instructions aimed at maintainers for deploying a new version: [Deployment](docs
 ### 3.0.0 (2024-03-03)
 
 * (bropat) **Breaking Change** New modular logging implementation
-* (bropat) Added support for Video Smart Lock S330 (T8530; #220)
+* (bropat) Added support for Video Smart Lock S330 (T8530/T8531; #220)
 * (bropat) Added support for Smart Lock C210 (T8502; #291)
 * (bropat) Added support for Smart Lock C220 (T8506; #377 #356)
 * (bropat) Added support for Smart Lock S230 (T8510P; #458)

build/http/device.js

@@ -1491,7 +1491,8 @@ class Device extends tiny_typed_emitter_1.TypedEmitter {
             sn.startsWith("T8502") ||
             sn.startsWith("T8504") ||
             sn.startsWith("T8506") ||
-            sn.startsWith("T8530");
+            sn.startsWith("T8530") ||
+            sn.startsWith("T8531");
     }
     static isGarageCameraBySn(sn) {
         return sn.startsWith("T8453") ||

build/http/types.js

@@ -967,7 +967,7 @@ exports.GenericTypeProperty = {
         52: "Lock Basic No Finger",
         53: "Lock Basic Advanced No Finger",
         54: "Retrofit Smart Lock E110 (T8503)",
-        55: "Video Smart Lock S330 (T8530)",
+        55: "Video Smart Lock S330 (T8530/T8531)",
         56: "Lock 85A3",
         57: "Lock 8592",
         58: "Retrofit Smart Lock E130 (T8504)",

docs/supported_devices.md

@@ -65,7 +65,7 @@
 | ![T8510 image](_media/smartlock_touch_t8510_small.jpg) | Smart Lock Touch (T8510) | :x: |  |
 | ![T8510 with Wi-Fi Bridge image](_media/smartlock_touch_t8510_wifibridge_small.jpg) | Smart Lock Touch with Wi-Fi Bridge (T8510) | :heavy_check_mark: :wrench: |  |
 | ![T8520 image](_media/smartlock_touch_and_wifi_t8520_small.jpg) | Smart Lock Touch & Wifi (T8520) | :heavy_check_mark: :wrench: | Firmware: 1.3.6.8 (20220205), 1.3.8.0 (20220816) |
-| ![T8530 image](_media/smartlock_video_t8530_small.jpg) | Video Smart Lock S330 (T8530) | :heavy_check_mark: | Firmware: 1.2.0.2 (20230530) |
+| ![T8530 image](_media/smartlock_video_t8530_small.jpg) | Video Smart Lock S330 (T8530/T8531) | :heavy_check_mark: | Firmware: 1.2.0.2 (20230530) |
 | ![T8502 image](_media/smartlock_touch_and_wifi_t8502_small.jpg) | Smart Lock C210 (T8502; E110) | :heavy_check_mark: | Firmware: 2.1.1.1 (20230913) |
 | ![T8506 image](_media/smartlock_touch_and_wifi_t8506_small.jpg) | Smart Lock C220 (T8506) | :heavy_check_mark: | Firmware: 1.1.3.3 (20231125) |
 | ![T8503 image](_media/smartlock_t8503_small.jpg) | Retrofit Smart Lock E110 (T8503; Smart Lock R10) | :heavy_check_mark: | Firmware: 1.0.7.7 (20230622) |

src/http/device.ts

@@ -1524,7 +1524,8 @@ export class Device extends TypedEmitter<DeviceEvents> {
             sn.startsWith("T8502") ||
             sn.startsWith("T8504") ||
             sn.startsWith("T8506") ||
-            sn.startsWith("T8530");
+            sn.startsWith("T8530") ||
+            sn.startsWith("T8531");
     }
 
     static isGarageCameraBySn(sn: string): boolean {

src/http/types.ts

@@ -986,7 +986,7 @@ export const GenericTypeProperty: PropertyMetadataNumeric = {
         52: "Lock Basic No Finger",
         53: "Lock Basic Advanced No Finger",
         54: "Retrofit Smart Lock E110 (T8503)",
-        55: "Video Smart Lock S330 (T8530)",
+        55: "Video Smart Lock S330 (T8530/T8531)",
         56: "Lock 85A3",
         57: "Lock 8592",
         58: "Retrofit Smart Lock E130 (T8504)",