@chrisalvir1/camera-ui-homekit-4k 0.6.15 → 0.6.17

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## [0.6.17] — LAN-aware HomeKit advertisement
+
+- Bind HomeKit/mDNS publication to detected private IPv4 interfaces, so
+  accessories resolve to the Camera.UI host's LAN address instead of loopback.
+  Interface names are selected dynamically to follow Wi-Fi/Ethernet address
+  changes; when no private IPv4 interface exists, HAP keeps its default
+  interface selection. This changes discovery/advertisement only; video, audio,
+  HKSV/HKSV3, detection, and pairing data are untouched.
+- Validate LAN binding with unit coverage, runtime mDNS resolution, build,
+  typecheck, lint, tests, and Camera.UI bundle smoke checks.
+
+## [0.6.16] — Shared codec profiles for newly assigned cameras
+
+- Removed the embedded loopback npm registry from plugin startup. Public installs
+  leave each user's npm configuration untouched and use Camera.UI/npm's normal
+  package update path.
+
+- Apply codec-specific shared defaults to newly assigned cameras that have a
+  usable source: H.264 selects HKSV and HEVC selects HKSV3. A camera explicitly
+  stopped by its user is not auto-published again. Recording audio is enabled
+  once per codec after HAP restores state; later Home settings are preserved.
+- Keep H.264 and HEVC media paths isolated. Codec and dimensions are re-probed
+  on reconnect; failed source detection leaves the accessory unpublished and
+  can be retried from that camera's settings. Camera.UI still owns OpenCV/CoreML
+  installation and sensor assignment; this plugin forwards assigned sensors.
+
 ## [0.6.15] — Camera.UI platform install targets
 
 - Declare macOS, Windows, and Linux on x64 and ARM64 as npm install targets,
@@ -52,6 +78,7 @@
 
 - H.264 live and HKSV use measured source dimensions: video up to 1920×1080 is passed through; larger sources use a verified H.264 encoder at 1920×1080. Existing negotiated audio routes are retained.
 - Shared Camera.UI detection bridge accepts visual object labels such as car, truck, dog and cat from assigned detectors, including future camera exports. Aggregate event end always releases motion even when closing metadata is empty.
+- Camera.UI sensor/plugin assignments remain host-owned. The plugin forwards events from sensors already assigned to a camera; it cannot install OpenCV/CoreML or assign their sensors on the user's behalf.
 - HEVC/HKSV3 recording audio receives its persistent one-time first-export default after HAP restores state. Later HomeKit audio choices are retained.
 - HEVC video/audio transport, its recording implementation and pairing identities are preserved. A worker reload briefly interrupts every accessory served by that worker.
 
@@ -76,11 +103,13 @@
 
 ## [0.6.3]
 
-- **Universal HEVC & HKSV3 Configuration Parity (IPCAM IPC Blueprint):** All Vimtag cameras (SALA, OFICINA, JARDIN, COCHERA, AREA DE CAFE, RECAMARA) and any newly added HEVC cameras automatically adopt the exact configuration established on IPCAM IPC. Automatically assigns `@chrisalvir/camera-ui-homekit-4k`, `@camera.ui/camera-ui-coreml`, and `@camera.ui/camera-ui-opencv` for full motion, object, face, person, and clip detection.
+> Correction: the automatic detector assignment and automatic export described
+> here were not implemented in 0.6.3. Version 0.6.16 adds automatic HomeKit
+> export for assigned cameras with a usable, confirmed source, but detector
+> plugins and their sensor assignments remain controlled by Camera.UI.
+
 - **Go2RTC Stream Preload & Elimination of Audio Teardown Collision:** Configured persistent Go2RTC stream preloading (`preload: audio=&video=`) and disabled RTSP backchannel handshakes (`backchannelDisabled: true`, `#backchannel=0#noBackchannel`) on Vimtag cloud relay sources, preventing WAN timeout disconnects (`i/o timeout`) and resolving Go2RTC's `error="start from CONN state"`.
 - **RTSP Direct Resolution Fallback for Multiplexed Sources:** Refined `resolveDirectCameraRtspUrl` to strictly return direct URLs only for verified private LAN IP addresses (`192.168.x.x`, `10.x.x.x`, `172.16-31.x.x`). For cloud and plugin cameras, gracefully falls back to Camera.UI multiplexed endpoints with proper query parameters (`?video&audio`), guaranteeing that FFmpeg HDS recordings generate complete `moov` initialization segments containing both video and AAC-LC audio tracks.
-- **Auto-Provisioning on Camera Addition (`CameraAutoConfig`):** Added automated configuration synchronization upon camera addition (`onCameraAdded`) and startup (`configureCameras`). Newly added HEVC cameras immediately receive HKSV3 configuration, continuous recording settings, and automatic HomeKit export without manual intervention.
-- **Permanent H.264 & Tapo Isolation:** Kept Tapo and all existing H.264 logic strictly untouched (`src/h264/*` unchanged); future H.264 cameras automatically inherit Tapo's standard H.264 configuration.
 - **FirmwareRevision Update:** Incremented firmware revision to `0.6.3`.
 
 ## [0.6.2]
@@ -94,7 +123,7 @@
 
 ## [0.6.1]
 
-- **Automatic Camera Export & Removal of Manual Button:** Cameras assigned to the HOMEKIT 4K plugin are now automatically exported to Apple Home upon activation alongside other plugins (CoreML, OpenCV), eliminating the need for manual button clicks. Removed the redundant «Exportar esta cámara» button from the UI. Pre-warmed pairing QR generation renders the branded setup QR code and manual PIN immediately when entering the pairing section.
+> Correction: this release does not automatically assign cameras to detector plugins or export every camera to Apple Home. Camera.UI owns sensor assignments, and export is done from the per-camera HomeKit settings.
 - **HEVC HKSV3 Audio Clock Synchronization (16 kHz):** Scaled Opus RTP timestamps by $16\text{k} / 48\text{k}$ (320 ticks per 20ms frame) to match HomeKit's negotiated 16 kHz audio sample rate (`sampleRate: 1`), eliminating the 3x timestamp forward surge and completely resolving the cyclic 1-second audio / mute stutter.
 - **Parasitic Microphone Whine & Artifact Elimination:** Implemented a specialized Butterworth 2-pole bandpass filter (`highpass=f=150:poles=2,lowpass=f=3500:poles=2`), FFT adaptive noise reduction (`afftdn=nf=-40`), clean gain boost, and switched Opus encoding to `-application voip -b:a 48k -vbr off`, completely eliminating the 6.28 kHz hardware whistle, background cricket buzz, and metallic CELT ringing across all HEVC live streams and recordings.
 - **Independent Audio Jitter Buffer Operation:** Omitted periodic audio RTCP Sender Reports in HKSV3 Multi-Tier RTP so HomeKit plays live audio continuously without inter-stream clock clashes against video.

package/README.md

@@ -6,11 +6,15 @@ HomeKit 4K exports cameras assigned to the plugin in Camera.UI as separate
 Apple Home accessories. Camera.UI remains the source of camera streams,
 capabilities, sensors, and detector configuration.
 
-**Next release prepared: 0.6.15 (not published).** Runtime behavior was
-validated on the developer MacBook with Camera.UI 2.3.0 using package 0.6.12.
-Version 0.6.14 fixed the npm scope to match the owner's npm account and did not
-change camera runtime behavior. Runtime evidence and limits are in
-[`docs/deployment-0.6.12.md`](docs/deployment-0.6.12.md).
+When Camera.UI assigns a camera to this plugin, the plugin probes its available
+source and publishes it automatically once it can confirm H.264 or HEVC. A user
+can stop a camera's export in that camera's settings; this choice persists and
+prevents automatic republication. An unavailable/unknown source is retried a
+few times; selecting a different source in that camera's settings retries it.
+
+**Release 0.6.17** adds LAN-aware HomeKit/mDNS advertisement. Runtime behavior
+was validated on the developer MacBook with Camera.UI 2.3.0; see the changelog
+for the scope of each release and its validation evidence.
 
 ## Current behavior
 
@@ -52,13 +56,11 @@ pnpm smoke:bundle
 
 Automated checks and real-host evidence are different: test results do not
 replace playback, recording, or detection confirmation in Apple Home. See the
-validation documents under [`docs/`](docs/).
+[public codec-profile notes](https://github.com/Chrisalvir1/homekit-4k/blob/main/docs/HKSV3_HEVC_CHANGES.md).
 
 ## Public release status
 
-The package uses a proprietary license: users may download, install, and run an
-unmodified copy; modifying or redistributing it is not permitted without the
-author's written permission. Check npm for the first public release and use
-Camera.UI's supported plugin installer when the package becomes available
-there. See
-[`docs/npm-publication-readiness.md`](docs/npm-publication-readiness.md).
+The package is public on npm under a proprietary license: users may download,
+install, and run an unmodified copy; modifying or redistributing it is not
+permitted without the author's written permission. Version 0.6.17 is the current release.
+Use Camera.UI's supported plugin installer to install the latest public release.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@chrisalvir1/camera-ui-homekit-4k",
   "displayName": "HOMEKIT 4K — by Chrisalvir",
-  "version": "0.6.15",
+  "version": "0.6.17",
   "description": "Exports Camera.UI cameras to Apple Home with H.264/HKSV and HEVC/HKSV3 streaming paths.",
   "homepage": "https://github.com/Chrisalvir1/homekit-4k",
   "repository": {
@@ -12,7 +12,7 @@
     "url": "https://github.com/Chrisalvir1/homekit-4k/issues"
   },
   "author": "Chrisalvir",
-  "license": "SEE LICENSE IN LICENSE",
+  "license": "SEE LICENSE IN LICENSE.md",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"