bacnet-js / client / 21899787580

83%

push

github

feat: read schedule,calendar and trend (#64)

## Summary
This PR ports schedule/calendar/trend read compatibility from the legacy
`node-bacstack` implementation into `@bacnet-js/client`, and adds read
examples for manual validation.

Source reference:
- https://github.com/EveGun/node-bacstack

## What changed
- Added specialized decode paths in `ReadProperty.decodeAcknowledge`
for:
  - `WEEKLY_SCHEDULE`
  - `EXCEPTION_SCHEDULE`
  - `EFFECTIVE_PERIOD`
  - `DATE_LIST`
- Added BACnet `WEEKNDAY` support in ASN.1 decode flow.
- Added `decodeRange` integration in `ReadRange.decodeAcknowledge`.
- Fixed non-zero offset slicing in `ReadRange` fallback range buffer
handling.
- Fixed closing-tag length consumption in exception schedule decode.
- Added unit tests for schedule/calendar parsing and trend range
decoding.
- Added read examples:
  - `examples/read-schedule-weekly.ts`
  - `examples/read-schedule-exceptions.ts`
  - `examples/read-schedule-period.ts`
  - `examples/read-calendar-datelist.ts`
  - `examples/read-trend.ts`

## Type consistency
- Trend range `timestamp` now returns `Date` (instead of epoch number)
for consistency with other decoded date/time fields.

## Validation
- `npm run lint` ✅
- `npm run test:unit` ✅
- Docker-based compliance tests executed successfully in local
environment ✅
- Manually validated against a WAGO PFC200 device
(schedule/calendar/trend read paths) ✅

## Notes
- Write examples were intentionally removed from this read-focused
branch.
- Write-side porting will follow in a separate branch/PR.
- Parser behavior was validated against real BACnet traffic captures
from WAGO PFC200 communication (Wireshark), then confirmed with live
device reads.

877 of 1362 branches covered (64.39%)

Branch coverage included in aggregate %.

230 of 256 new or added lines in 3 files covered. (89.84%)

5166 of 5923 relevant lines covered (87.22%)

36.67 hits per line