prerelease

Author: verheesj

.npmignore

@@ -0,0 +1,44 @@
+# Source files
+src/
+examples/
+tests/
+
+# Config files
+tsconfig.json
+tsconfig.build.json
+tsconfig.cjs.json
+jest.config.ts
+
+# Test and coverage (exclude from dist too)
+coverage/
+*.test.ts
+*.test.js
+*.test.js.map
+*.test.d.ts
+__tests__/
+dist/**/__tests__/
+dist/**/*.test.*
+
+# Development files
+test-*.ts
+test-*.js
+*.log
+.env
+.DS_Store
+
+# Build artifacts (keep dist/)
+node_modules/
+
+# Documentation and misc
+README.md.backup
+VOD_GUIDE.md
+downloads/
+.github/
+SUBMISSION_READY.md
+PUBLISHING.md
+
+# Scripts
+publish.sh
+
+# Example files
+example-*.ts

API_DOCUMENTATION.md

@@ -12,13 +12,13 @@
 ## Installation
 
 ```bash
-npm install reolink-aio-ts
+npm install reolink-aio
 ```
 
 ## Quick Start
 
 ```typescript
-import { Host } from 'reolink-aio-ts';
+import { Host } from 'reolink-aio';
 
 // Create a connection
 const host = new Host('192.168.1.100', 'admin', 'your_password');
@@ -77,13 +77,10 @@ Reolink NVRs support multiple cameras (channels). Most methods accept a channel
 
 ```typescript
 // Single camera (channel 0)
-await host.setIrLights(0, true);
-
 // Multiple channels on NVR
 for (const channel of host.channels) {
   console.log(host.cameraName(channel));
 }
-```
 
 ## API Reference
 

CHANGELOG.md

@@ -0,0 +1,78 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0-alpha.0] - 2025-11-14
+
+### Added - Initial Release
+
+This is the first pre-release of `reolink-aio` - a TypeScript implementation of Reolink's Baichuan API (the same API used by official Reolink iOS/Android apps and CLI).
+
+#### Core Features
+- **Full TypeScript Support** - Complete type safety and IntelliSense
+- **HTTP API Client** - Comprehensive REST API implementation  
+- **Baichuan Protocol** - Real-time push events via TCP
+- **NVR & Camera Support** - Works with both standalone cameras and NVR systems
+- **Session Management** - Automatic token refresh and connection handling
+- **Error Handling** - Rich exception hierarchy for robust error management
+
+#### Real-Time Events
+- Motion Detection - Real-time motion alerts via Baichuan
+- AI Detection - Person, vehicle, pet/animal, face, and package detection
+- Visitor Detection - Doorbell button press events
+- State Monitoring - Continuous monitoring of camera states
+- Event Subscription - Subscribe to push notifications
+
+#### Video & Media
+- VOD File Search - Find recordings by time range and event type
+- Video Download - Download MP4 clips from NVR/cameras
+- Multiple Streams - Support for main and sub streams
+- Stream URLs - Generate FLV, RTMP, and RTSP URLs
+
+#### Device Control
+- IR Lights - Control infrared illumination
+- Spotlight - Toggle camera spotlight with brightness control
+- Siren - Activate camera siren/audio alarm (fully working!)
+- Focus Control - Set camera focus position
+- Zoom Control - Set camera zoom position
+
+#### Device Information
+- Device Discovery - Automatic NVR/camera detection
+- Channel Management - Multi-channel support for NVRs
+- Capability Detection - Automatic feature detection
+- Model Information - Device model, firmware, hardware version
+- Network Settings - Port configuration (RTSP, RTMP, ONVIF)
+
+#### Testing & Documentation
+- Comprehensive JSDoc documentation across all APIs
+- Unit tests for utilities, types, and Baichuan protocol
+- Working examples for common use cases
+- API documentation guide
+
+### Fixed
+- Baichuan TCP protocol XML formatting (critical blank line separator fix for siren/control commands)
+- Response future cleanup to prevent accumulation in long-running sessions
+
+### Known Limitations
+- PTZ control not yet implemented
+- Snapshot capture not yet implemented
+- Advanced configuration management (OSD, schedules, zones) not yet implemented
+- Integration tests pending
+- Code coverage ~30% (baseline established)
+
+### Breaking Changes
+- This is an initial pre-release; APIs may change in future versions
+
+### Notes
+- Based on the Python [reolink-aio](https://github.com/starkillerOG/reolink_aio) library
+- Published under the `next` dist-tag on npm
+- Requires Node.js 18+
+- TypeScript 5.3+
+
+[Unreleased]: https://github.com/verheesj/reolink-aio-ts/compare/v0.1.0-alpha.0...HEAD
+[0.1.0-alpha.0]: https://github.com/verheesj/reolink-aio-ts/releases/tag/v0.1.0-alpha.0

KNOWN_ISSUES.md

@@ -50,7 +50,7 @@ All device control features now work correctly:
 All features work correctly when using proper initialization:
 
 ```typescript
-import { Host } from 'reolink-aio-ts';
+import { Host } from 'reolink-aio';
 
 const host = new Host('192.168.1.100', 'admin', 'password');