@chrisalvir1/camera-ui-homekit-4k 0.6.20 → 0.6.22

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [0.6.22] — Robust H.264 Live Stream & Crystal-Clear Audio Passthrough
+
+- **Fixed IP Version Match in `prepareStream`**: Ensured `addressOverride` strictly matches `request.addressVersion` (IPv4 vs IPv6). When HomeKit connects via IPv6, avoiding incompatible IPv4 override prevents HAP-NodeJS from rejecting the stream with "Incoming and outgoing ip address versions must match!" which previously resulted in "Sin respuesta".
+- **Pure Native Packet Integrity**: Native `node-av` RTP video packets are passed through directly without running `timeline.rewrite`, preserving continuous RFC 6184 NAL fragmentation (FU-A) sequences, exact timestamps, and marker bits.
+- **Opus Negotiation Alignment & Two-Way Audio**: Advertised OPUS exclusively in H.264 streaming options with `twoWayAudio: true`, ensuring iOS always negotiates Opus at 48 kHz.
+- **Audio Return / Talkback Forwarding**: Handled return audio packets from HomeKit controllers and routed them directly to Camera.UI backchannel.
+- **Strict Video Passthrough & 2K Hardware Transcoding**: Cameras $\le$ 1080p (e.g. Tapo C120 configured at 1080p) run in 100% video passthrough with zero re-encoding. Cameras > 1080p (e.g. Tapo C402 in 2K) transcode to 1080p via Apple Silicon Hardware Acceleration (`h264_videotoolbox`).
+- **Atomic Constraints**: Absolutely zero changes to HEVC/HKSV3, recordings, or detection logic.
+
+## [0.6.21] — Non-blocking H.264 live stream startup & multihome IP routing
+
+- Eliminated the blocking media packet wait (`await ready`) inside `handleStreamRequest(start)`:
+  HAP now returns the HTTP 204 success callback immediately once the streaming session starts (<100ms),
+  preventing iOS from timing out and displaying "Sin respuesta" (No response).
+- Added multi-interface UDP socket resilience with 1MB send/recv buffers and automatic fallback
+  from Camera.UI native in-memory RTP to FFmpeg RTP (`-c:v copy`).
+- Used request source address in HAP stream response to ensure HomeKit connects to the exact
+  reachable IP address on multihomed hosts.
+- Preserved pristine 48 kHz RFC 7587 Opus audio timeline without timestamp downscaling,
+  eliminating the loud metallic screeching ("chirrido espantoso") present in the official plugin.
+- Strict atomic rule maintained: zero changes to HEVC/HKSV3, recordings, or detection logic.
+
 ## [0.6.20] — Fix H.264 live Opus RFC 7587 48kHz clock & Baseline profile
 
 - Fixed Opus RTP timestamp clock to maintain the RFC 7587 standard 48,000 Hz

package/README.md

@@ -12,8 +12,10 @@ 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.
 
-**Working version 0.6.20** fixes the H.264 live Opus RTP clock to 48 kHz (RFC 7587),
-aligns RTCP Sender Reports, and enforces Baseline profile for HomeKit live streaming.
+**Working version 0.6.22** resolves the HomeKit live stream "Sin respuesta" issue by
+strictly matching IP address versions in HAP prepareStream, preserving native RFC 6184 NAL unit integrity,
+and delivering crystal-clear 48 kHz Opus audio with video passthrough for $\le$1080p and Apple Silicon 2K hardware transcoding for >1080p.
+**Release 0.6.21** non-blocking H.264 start response.
 **Release 0.6.19** restores standard H.264 resolution choices in the HomeKit offer.
 **Release 0.6.18** added initial Opus negotiation handling. **Release 0.6.17** adds LAN-aware mDNS.
 Runtime behavior was validated on the developer MacBook with Camera.UI 2.3.0;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@chrisalvir1/camera-ui-homekit-4k",
   "displayName": "HOMEKIT 4K — by Chrisalvir",
-  "version": "0.6.20",
+  "version": "0.6.22",
   "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": {
@@ -44,16 +44,16 @@
     "lint": "eslint src tests scripts contract.ts cameraui.config.ts",
     "test": "tsc -p tsconfig.tests.json && node --test .test-dist/tests/*.test.js",
     "test:coverage": "tsc -p tsconfig.tests.json && node --experimental-test-coverage --test-coverage-include='**/.test-dist/src/**' --test-coverage-exclude='**/generated/**' --test .test-dist/tests/*.test.js",
-    "test:media": "pnpm build && node scripts/media-lab/test-controlled-transcode.mjs",
-    "test:fixture-determinism": "pnpm build && node scripts/media-lab/test-fixture-determinism.mjs",
+    "test:media": "npm run build && node scripts/media-lab/test-controlled-transcode.mjs",
+    "test:fixture-determinism": "npm run build && node scripts/media-lab/test-fixture-determinism.mjs",
     "verify:phase3-evidence": "node scripts/media-lab/verify-phase3-evidence.mjs",
     "collect:phase3-evidence": "node scripts/media-lab/collect-phase3-evidence.mjs",
-    "check": "pnpm build && pnpm typecheck && pnpm lint && pnpm test",
+    "check": "npm run build && npm run typecheck && npm run lint && npm test",
     "smoke:bundle": "node scripts/smoke-bundle.mjs",
-    "examples": "pnpm build && node scripts/examples.mjs",
-    "bundle:camera-ui": "pnpm build && cui bundle && node scripts/finalize-camera-ui-bundle.mjs",
-    "publish:camera-ui": "pnpm bundle:camera-ui && npm publish ./bundle --access public --registry=https://registry.npmjs.org/",
-    "test:audio": "pnpm build && node scripts/audio-lab/test-audio.mjs"
+    "examples": "npm run build && node scripts/examples.mjs",
+    "bundle:camera-ui": "npm run build && cui bundle && node scripts/finalize-camera-ui-bundle.mjs",
+    "publish:camera-ui": "npm run bundle:camera-ui && npm publish ./bundle --access public --registry=https://registry.npmjs.org/",
+    "test:audio": "npm run build && node scripts/audio-lab/test-audio.mjs"
   },
   "homekit4k": {
     "releaseChannel": "stable"