[hertzg]

New package @hertzg/reolink-api: a client for Reolink's own TCP protocol, Baichuan (port 9000). It works with cameras and doorbells that have no HTTP API.

const conn = await Deno.connect({ hostname: "192.168.1.10", port: 9000 });
const client = createClient({ readable: conn.readable, writable: conn.writable });
await client.login({ username: "admin", password: "secret" });

for await (const event of await client.subscribe())
  console.log(event); // { channel: 0, motion: true, visitor: false, tamper: false, ai: ["people"] }

const { body } = await client.call(COMMANDS.GET_NTPCFG_V20); // body.Ntp
for await (const push of client.pushes()) console.log(push.name, push.body);

What's in it

• Events: subscribe() streams alarm state (motion, doorbell, tamper, AI types) and keeps idle connections alive with pings. Reconnecting stays with the caller.
• Controls: playSiren / startSiren / stopSiren, privacyMode / setPrivacyMode, snapshot, ptz, ptzPresets, ptzGoToPreset, ptzPosition.
• Every command: call(COMMANDS.X) sends any of the 257 commands the RLC-823A (IPC_523SD10.2898_23110119) and Video Doorbell PoE (DB_566128M5MP_P.4662_2508071283) firmware register, with typed request and reply bodies. Each command lists the firmware that has it.
• Every push: pushes() streams all unsolicited messages, typed for the 9 known ones and raw XML for anything else.
• Layers: header coder, XOR and AES-CFB ciphers, login, message framing streams and 199 XML parameter codecs are each their own entry point.

How it was checked

• Byte-level vectors from reolink_aio's Python implementation and openssl.
• Parameter codecs written from the firmware's own XML serializers and parsers, with a reply-element audit of every command handler.
• A read-only run against a Video Doorbell PoE and a PTZ camera: every reply decoded and no element was left unread. A PTZ move test panned and returned to the start position.

Known limits

• Most reply fields are optional, because one codec serves both requests and replies and the firmware accepts partial elements.
• Enum fields reject values they don't know, so a newer firmware value fails the reply.
• A command answered with an error status rejects without its body.

[github-actions]

Docs preview: https://hertzg.github.io/jsr-monorepo/pr/302/

[github-actions]

Benchmark Results

No significant changes detected. 31 benchmark(s) within their noise floor.

[codecov-commenter]

Codecov Report

❌ Patch coverage is 99.11998% with 30 lines in your changes missing coverage. Please review.
✅ Project coverage is 97.78%. Comparing base (dbc242e) to head (1e729b7).

Files with missing lines	Patch %	Lines
packages/@hertzg/reolink-api/client.ts	91.35%	21 Missing and 9 partials ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #302      +/-   ##
==========================================
+ Coverage   96.79%   97.78%   +0.98%     
==========================================
  Files         159      374     +215     
  Lines        8499    13794    +5295     
  Branches     1300     1458     +158     
==========================================
+ Hits         8227    13489    +5262     
- Misses        152      175      +23     
- Partials      120      130      +10     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.