matter-all-in-one-addon 1.8.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (244) hide show
  1. package/README.md +183 -0
  2. package/dist/camera/ai/camera-ai-detector.d.ts +44 -0
  3. package/dist/camera/ai/camera-ai-detector.js +329 -0
  4. package/dist/camera/ai/camera-ai-detector.js.map +1 -0
  5. package/dist/camera/camera-capabilities.d.ts +13 -0
  6. package/dist/camera/camera-capabilities.js +186 -0
  7. package/dist/camera/camera-capabilities.js.map +1 -0
  8. package/dist/camera/camera-source-resolver.d.ts +18 -0
  9. package/dist/camera/camera-source-resolver.js +187 -0
  10. package/dist/camera/camera-source-resolver.js.map +1 -0
  11. package/dist/camera/camera-types.d.ts +124 -0
  12. package/dist/camera/camera-types.js +8 -0
  13. package/dist/camera/camera-types.js.map +1 -0
  14. package/dist/camera/cameraui/cameraui-client.d.ts +54 -0
  15. package/dist/camera/cameraui/cameraui-client.js +698 -0
  16. package/dist/camera/cameraui/cameraui-client.js.map +1 -0
  17. package/dist/camera/cameraui/cameraui-homekit-bridge.d.ts +21 -0
  18. package/dist/camera/cameraui/cameraui-homekit-bridge.js +343 -0
  19. package/dist/camera/cameraui/cameraui-homekit-bridge.js.map +1 -0
  20. package/dist/camera/cameraui/cameraui-storage.d.ts +17 -0
  21. package/dist/camera/cameraui/cameraui-storage.js +916 -0
  22. package/dist/camera/cameraui/cameraui-storage.js.map +1 -0
  23. package/dist/camera/cameraui/cameraui-types.d.ts +89 -0
  24. package/dist/camera/cameraui/cameraui-types.js +5 -0
  25. package/dist/camera/cameraui/cameraui-types.js.map +1 -0
  26. package/dist/camera/homekit/ffmpeg-helper.d.ts +88 -0
  27. package/dist/camera/homekit/ffmpeg-helper.js +673 -0
  28. package/dist/camera/homekit/ffmpeg-helper.js.map +1 -0
  29. package/dist/camera/homekit/fmp4-parser.d.ts +48 -0
  30. package/dist/camera/homekit/fmp4-parser.js +156 -0
  31. package/dist/camera/homekit/fmp4-parser.js.map +1 -0
  32. package/dist/camera/homekit/hevc-eligibility.d.ts +16 -0
  33. package/dist/camera/homekit/hevc-eligibility.js +153 -0
  34. package/dist/camera/homekit/hevc-eligibility.js.map +1 -0
  35. package/dist/camera/homekit/homekit-camera-recording.delegate.d.ts +73 -0
  36. package/dist/camera/homekit/homekit-camera-recording.delegate.js +445 -0
  37. package/dist/camera/homekit/homekit-camera-recording.delegate.js.map +1 -0
  38. package/dist/camera/homekit/homekit-camera-stream.delegate.d.ts +47 -0
  39. package/dist/camera/homekit/homekit-camera-stream.delegate.js +833 -0
  40. package/dist/camera/homekit/homekit-camera-stream.delegate.js.map +1 -0
  41. package/dist/camera/homekit/homekit-camera.accessory.d.ts +53 -0
  42. package/dist/camera/homekit/homekit-camera.accessory.js +697 -0
  43. package/dist/camera/homekit/homekit-camera.accessory.js.map +1 -0
  44. package/dist/camera/matter/camera-endpoint.builder.d.ts +7 -0
  45. package/dist/camera/matter/camera-endpoint.builder.js +127 -0
  46. package/dist/camera/matter/camera-endpoint.builder.js.map +1 -0
  47. package/dist/camera/matter/camera-session-manager.d.ts +46 -0
  48. package/dist/camera/matter/camera-session-manager.js +120 -0
  49. package/dist/camera/matter/camera-session-manager.js.map +1 -0
  50. package/dist/camera/matter/camera-webrtc-adapter.d.ts +62 -0
  51. package/dist/camera/matter/camera-webrtc-adapter.js +298 -0
  52. package/dist/camera/matter/camera-webrtc-adapter.js.map +1 -0
  53. package/dist/camera/motion/ffmpeg-motion-detector.d.ts +46 -0
  54. package/dist/camera/motion/ffmpeg-motion-detector.js +200 -0
  55. package/dist/camera/motion/ffmpeg-motion-detector.js.map +1 -0
  56. package/dist/camera/nest/nest-camera-adapter.d.ts +38 -0
  57. package/dist/camera/nest/nest-camera-adapter.js +109 -0
  58. package/dist/camera/nest/nest-camera-adapter.js.map +1 -0
  59. package/dist/camera/scrypted/scrypted-camera-card.d.ts +39 -0
  60. package/dist/camera/scrypted/scrypted-camera-card.js +38 -0
  61. package/dist/camera/scrypted/scrypted-camera-card.js.map +1 -0
  62. package/dist/camera/scrypted/scrypted-camera-detail.d.ts +33 -0
  63. package/dist/camera/scrypted/scrypted-camera-detail.js +34 -0
  64. package/dist/camera/scrypted/scrypted-camera-detail.js.map +1 -0
  65. package/dist/camera/scrypted/scrypted-camera-discovery-adapter.d.ts +17 -0
  66. package/dist/camera/scrypted/scrypted-camera-discovery-adapter.js +24 -0
  67. package/dist/camera/scrypted/scrypted-camera-discovery-adapter.js.map +1 -0
  68. package/dist/camera/scrypted/scrypted-camera-normalizer.d.ts +44 -0
  69. package/dist/camera/scrypted/scrypted-camera-normalizer.js +44 -0
  70. package/dist/camera/scrypted/scrypted-camera-normalizer.js.map +1 -0
  71. package/dist/camera/scrypted/scrypted-camera-policy.d.ts +11 -0
  72. package/dist/camera/scrypted/scrypted-camera-policy.js +13 -0
  73. package/dist/camera/scrypted/scrypted-camera-policy.js.map +1 -0
  74. package/dist/camera/scrypted/scrypted-camera-presentation.d.ts +13 -0
  75. package/dist/camera/scrypted/scrypted-camera-presentation.js +23 -0
  76. package/dist/camera/scrypted/scrypted-camera-presentation.js.map +1 -0
  77. package/dist/camera/scrypted/scrypted-client-discovery-adapter.d.ts +6 -0
  78. package/dist/camera/scrypted/scrypted-client-discovery-adapter.js +12 -0
  79. package/dist/camera/scrypted/scrypted-client-discovery-adapter.js.map +1 -0
  80. package/dist/camera/scrypted/scrypted-client.d.ts +152 -0
  81. package/dist/camera/scrypted/scrypted-client.js +1170 -0
  82. package/dist/camera/scrypted/scrypted-client.js.map +1 -0
  83. package/dist/camera/scrypted/scrypted-crypto.d.ts +21 -0
  84. package/dist/camera/scrypted/scrypted-crypto.js +90 -0
  85. package/dist/camera/scrypted/scrypted-crypto.js.map +1 -0
  86. package/dist/camera/scrypted/scrypted-discovery-provider.d.ts +9 -0
  87. package/dist/camera/scrypted/scrypted-discovery-provider.js +25 -0
  88. package/dist/camera/scrypted/scrypted-discovery-provider.js.map +1 -0
  89. package/dist/camera/scrypted/scrypted-homekit-bridge.d.ts +12 -0
  90. package/dist/camera/scrypted/scrypted-homekit-bridge.js +214 -0
  91. package/dist/camera/scrypted/scrypted-homekit-bridge.js.map +1 -0
  92. package/dist/camera/scrypted/scrypted-matter-bridge.d.ts +36 -0
  93. package/dist/camera/scrypted/scrypted-matter-bridge.js +226 -0
  94. package/dist/camera/scrypted/scrypted-matter-bridge.js.map +1 -0
  95. package/dist/camera/scrypted/scrypted-reconnect-manager.d.ts +40 -0
  96. package/dist/camera/scrypted/scrypted-reconnect-manager.js +353 -0
  97. package/dist/camera/scrypted/scrypted-reconnect-manager.js.map +1 -0
  98. package/dist/camera/scrypted/scrypted-runtime-connector.d.ts +7 -0
  99. package/dist/camera/scrypted/scrypted-runtime-connector.js +17 -0
  100. package/dist/camera/scrypted/scrypted-runtime-connector.js.map +1 -0
  101. package/dist/camera/scrypted/scrypted-runtime-facade.d.ts +13 -0
  102. package/dist/camera/scrypted/scrypted-runtime-facade.js +29 -0
  103. package/dist/camera/scrypted/scrypted-runtime-facade.js.map +1 -0
  104. package/dist/camera/scrypted/scrypted-runtime-ingest.d.ts +5 -0
  105. package/dist/camera/scrypted/scrypted-runtime-ingest.js +54 -0
  106. package/dist/camera/scrypted/scrypted-runtime-ingest.js.map +1 -0
  107. package/dist/camera/scrypted/scrypted-storage.d.ts +95 -0
  108. package/dist/camera/scrypted/scrypted-storage.js +698 -0
  109. package/dist/camera/scrypted/scrypted-storage.js.map +1 -0
  110. package/dist/camera/scrypted/scrypted-stream-validator.d.ts +46 -0
  111. package/dist/camera/scrypted/scrypted-stream-validator.js +412 -0
  112. package/dist/camera/scrypted/scrypted-stream-validator.js.map +1 -0
  113. package/dist/camera/scrypted/scrypted-types.d.ts +354 -0
  114. package/dist/camera/scrypted/scrypted-types.js +6 -0
  115. package/dist/camera/scrypted/scrypted-types.js.map +1 -0
  116. package/dist/converters/binary_sensor.converter.d.ts +18 -0
  117. package/dist/converters/binary_sensor.converter.js +21 -0
  118. package/dist/converters/binary_sensor.converter.js.map +1 -0
  119. package/dist/converters/camera.converter.d.ts +18 -0
  120. package/dist/converters/camera.converter.js +24 -0
  121. package/dist/converters/camera.converter.js.map +1 -0
  122. package/dist/converters/climate.converter.d.ts +21 -0
  123. package/dist/converters/climate.converter.js +55 -0
  124. package/dist/converters/climate.converter.js.map +1 -0
  125. package/dist/converters/cover.converter.d.ts +14 -0
  126. package/dist/converters/cover.converter.js +22 -0
  127. package/dist/converters/cover.converter.js.map +1 -0
  128. package/dist/converters/energy_tariff.converter.d.ts +10 -0
  129. package/dist/converters/energy_tariff.converter.js +12 -0
  130. package/dist/converters/energy_tariff.converter.js.map +1 -0
  131. package/dist/converters/fan.converter.d.ts +233 -0
  132. package/dist/converters/fan.converter.js +353 -0
  133. package/dist/converters/fan.converter.js.map +1 -0
  134. package/dist/converters/index.d.ts +14 -0
  135. package/dist/converters/index.js +15 -0
  136. package/dist/converters/index.js.map +1 -0
  137. package/dist/converters/light.converter.d.ts +26 -0
  138. package/dist/converters/light.converter.js +36 -0
  139. package/dist/converters/light.converter.js.map +1 -0
  140. package/dist/converters/lock.converter.d.ts +20 -0
  141. package/dist/converters/lock.converter.js +29 -0
  142. package/dist/converters/lock.converter.js.map +1 -0
  143. package/dist/converters/sensor.converter.d.ts +18 -0
  144. package/dist/converters/sensor.converter.js +33 -0
  145. package/dist/converters/sensor.converter.js.map +1 -0
  146. package/dist/converters/soil_sensor.converter.d.ts +14 -0
  147. package/dist/converters/soil_sensor.converter.js +21 -0
  148. package/dist/converters/soil_sensor.converter.js.map +1 -0
  149. package/dist/converters/vacuum.converter.d.ts +168 -0
  150. package/dist/converters/vacuum.converter.js +288 -0
  151. package/dist/converters/vacuum.converter.js.map +1 -0
  152. package/dist/device-profiles.d.ts +14 -0
  153. package/dist/device-profiles.js +245 -0
  154. package/dist/device-profiles.js.map +1 -0
  155. package/dist/device-registry.d.ts +58 -0
  156. package/dist/device-registry.js +288 -0
  157. package/dist/device-registry.js.map +1 -0
  158. package/dist/entities/base.entity.d.ts +40 -0
  159. package/dist/entities/base.entity.js +826 -0
  160. package/dist/entities/base.entity.js.map +1 -0
  161. package/dist/entities/camera.entity.d.ts +48 -0
  162. package/dist/entities/camera.entity.js +127 -0
  163. package/dist/entities/camera.entity.js.map +1 -0
  164. package/dist/entities/closure.entity.d.ts +9 -0
  165. package/dist/entities/closure.entity.js +52 -0
  166. package/dist/entities/closure.entity.js.map +1 -0
  167. package/dist/entities/composite-device.entity.d.ts +61 -0
  168. package/dist/entities/composite-device.entity.js +986 -0
  169. package/dist/entities/composite-device.entity.js.map +1 -0
  170. package/dist/entities/cooktop.entity.d.ts +20 -0
  171. package/dist/entities/cooktop.entity.js +59 -0
  172. package/dist/entities/cooktop.entity.js.map +1 -0
  173. package/dist/entities/energy_tariff.entity.d.ts +7 -0
  174. package/dist/entities/energy_tariff.entity.js +32 -0
  175. package/dist/entities/energy_tariff.entity.js.map +1 -0
  176. package/dist/entities/humidifier.entity.d.ts +27 -0
  177. package/dist/entities/humidifier.entity.js +187 -0
  178. package/dist/entities/humidifier.entity.js.map +1 -0
  179. package/dist/entities/lock.entity.d.ts +12 -0
  180. package/dist/entities/lock.entity.js +58 -0
  181. package/dist/entities/lock.entity.js.map +1 -0
  182. package/dist/entities/media-player.entity.d.ts +13 -0
  183. package/dist/entities/media-player.entity.js +52 -0
  184. package/dist/entities/media-player.entity.js.map +1 -0
  185. package/dist/entities/oven.entity.d.ts +20 -0
  186. package/dist/entities/oven.entity.js +112 -0
  187. package/dist/entities/oven.entity.js.map +1 -0
  188. package/dist/entities/pet_feeder.entity.d.ts +28 -0
  189. package/dist/entities/pet_feeder.entity.js +67 -0
  190. package/dist/entities/pet_feeder.entity.js.map +1 -0
  191. package/dist/entities/soil_sensor.entity.d.ts +7 -0
  192. package/dist/entities/soil_sensor.entity.js +40 -0
  193. package/dist/entities/soil_sensor.entity.js.map +1 -0
  194. package/dist/entities/vacuum.entity.d.ts +37 -0
  195. package/dist/entities/vacuum.entity.js +352 -0
  196. package/dist/entities/vacuum.entity.js.map +1 -0
  197. package/dist/frontend/assets/index-DPXu3al2.js +26 -0
  198. package/dist/frontend/assets/index-DalMl4eS.css +1 -0
  199. package/dist/frontend/assets/logo-B_gEBugV.png +0 -0
  200. package/dist/frontend/index.html +14 -0
  201. package/dist/frontend/logo.png +0 -0
  202. package/dist/homeAssistant.d.ts +1268 -0
  203. package/dist/homeAssistant.js +1623 -0
  204. package/dist/homeAssistant.js.map +1 -0
  205. package/dist/homekit.compat.d.ts +40 -0
  206. package/dist/homekit.compat.js +43 -0
  207. package/dist/homekit.compat.js.map +1 -0
  208. package/dist/index.d.ts +7 -0
  209. package/dist/index.js +31 -0
  210. package/dist/index.js.map +1 -0
  211. package/dist/mqtt/mqtt-client.d.ts +33 -0
  212. package/dist/mqtt/mqtt-client.js +138 -0
  213. package/dist/mqtt/mqtt-client.js.map +1 -0
  214. package/dist/mqtt/mqtt.entity.d.ts +30 -0
  215. package/dist/mqtt/mqtt.entity.js +286 -0
  216. package/dist/mqtt/mqtt.entity.js.map +1 -0
  217. package/dist/platform.d.ts +318 -0
  218. package/dist/platform.js +6144 -0
  219. package/dist/platform.js.map +1 -0
  220. package/dist/proxy.d.ts +1 -0
  221. package/dist/proxy.js +226 -0
  222. package/dist/proxy.js.map +1 -0
  223. package/dist/utils/ha-discovery.d.ts +30 -0
  224. package/dist/utils/ha-discovery.js +175 -0
  225. package/dist/utils/ha-discovery.js.map +1 -0
  226. package/dist/utils/ha-state.d.ts +48 -0
  227. package/dist/utils/ha-state.js +21 -0
  228. package/dist/utils/ha-state.js.map +1 -0
  229. package/dist/utils/light-color.d.ts +63 -0
  230. package/dist/utils/light-color.js +213 -0
  231. package/dist/utils/light-color.js.map +1 -0
  232. package/dist/utils/log-buffer.d.ts +13 -0
  233. package/dist/utils/log-buffer.js +50 -0
  234. package/dist/utils/log-buffer.js.map +1 -0
  235. package/dist/utils/matter-attributes.d.ts +13 -0
  236. package/dist/utils/matter-attributes.js +35 -0
  237. package/dist/utils/matter-attributes.js.map +1 -0
  238. package/dist/utils/matter-device-identity.d.ts +22 -0
  239. package/dist/utils/matter-device-identity.js +70 -0
  240. package/dist/utils/matter-device-identity.js.map +1 -0
  241. package/dist/utils/thread-credentials.d.ts +22 -0
  242. package/dist/utils/thread-credentials.js +29 -0
  243. package/dist/utils/thread-credentials.js.map +1 -0
  244. package/package.json +80 -0
@@ -0,0 +1,186 @@
1
+ import { resolveFfmpegPath, } from "./homekit/ffmpeg-helper.js";
2
+ /**
3
+ * Detects real camera capabilities and determines the optimal streaming strategy.
4
+ *
5
+ * Rules:
6
+ * - H.264 streams use passthrough / remux copy mode (no transcoding).
7
+ * - Compatible audio (AAC-LC, AAC-ELD, Opus, PCM) is forwarded; incompatible audio is omitted (video-only).
8
+ * - H.265 or MJPEG streams are flagged as requiring transcoding.
9
+ * - Unknown or invalid stream sources are marked as unsupported.
10
+ */
11
+ export function detectCameraCapabilities(state, resolvedSource, probeResult) {
12
+ const attrs = state.attributes || {};
13
+ const isAvailable = state.state !== "unavailable" && state.state !== "unknown";
14
+ // Determine Source Protocol
15
+ let streamSourceType = "unknown";
16
+ if (resolvedSource?.sourceType) {
17
+ streamSourceType = resolvedSource.sourceType;
18
+ }
19
+ else if (attrs.frontend_stream_type === "webrtc") {
20
+ streamSourceType = "webrtc";
21
+ }
22
+ else if (attrs.frontend_stream_type === "hls") {
23
+ streamSourceType = "hls";
24
+ }
25
+ else if (typeof attrs.stream_source === "string" &&
26
+ attrs.stream_source.startsWith("rtsp")) {
27
+ streamSourceType = "rtsp";
28
+ }
29
+ // Detect Video Codec (prefer probe result if valid)
30
+ let videoCodec = "h264";
31
+ if (probeResult?.videoCodec) {
32
+ const pCode = probeResult.videoCodec.toLowerCase();
33
+ if (pCode.includes("265") || pCode.includes("hevc")) {
34
+ videoCodec = "h265";
35
+ }
36
+ else if (pCode.includes("mjpeg") || pCode.includes("jpeg")) {
37
+ videoCodec = "mjpeg";
38
+ }
39
+ else if (pCode.includes("264") || pCode.includes("avc")) {
40
+ videoCodec = "h264";
41
+ }
42
+ }
43
+ else {
44
+ const rawVideoCodec = (attrs.video_codec || "").toLowerCase();
45
+ if (rawVideoCodec.includes("265") || rawVideoCodec.includes("hevc")) {
46
+ videoCodec = "h265";
47
+ }
48
+ else if (rawVideoCodec.includes("mjpeg") ||
49
+ rawVideoCodec.includes("jpeg")) {
50
+ videoCodec = "mjpeg";
51
+ }
52
+ else if (rawVideoCodec.includes("264") || rawVideoCodec.includes("avc")) {
53
+ videoCodec = "h264";
54
+ }
55
+ }
56
+ // Detect Audio Codec
57
+ let audioCodec = "none";
58
+ let hasAudio = false;
59
+ if (probeResult) {
60
+ hasAudio = probeResult.hasAudio;
61
+ if (probeResult.audioCodec) {
62
+ const pAudio = probeResult.audioCodec.toLowerCase();
63
+ if (pAudio.includes("aac") || pAudio.includes("mp4a")) {
64
+ audioCodec = "aac_lc";
65
+ }
66
+ else if (pAudio.includes("opus")) {
67
+ audioCodec = "opus";
68
+ }
69
+ else if (pAudio.includes("pcm") ||
70
+ pAudio.includes("alaw") ||
71
+ pAudio.includes("ulaw") ||
72
+ pAudio.includes("g711") ||
73
+ pAudio.includes("g722") ||
74
+ pAudio.includes("adpcm")) {
75
+ audioCodec = "pcm";
76
+ }
77
+ else {
78
+ // FFmpeg resamples and transcodes any camera audio codec to AAC-ELD
79
+ audioCodec = "aac_lc";
80
+ }
81
+ }
82
+ else if (hasAudio) {
83
+ audioCodec = "aac_lc";
84
+ }
85
+ }
86
+ else {
87
+ const rawAudioCodec = (attrs.audio_codec || "").toLowerCase();
88
+ // For RTSP cameras without an explicit audio_codec attribute, assume audio is present
89
+ // (AAC-LC is the safest default). FFmpeg will use `-map 0:a:0?` which silently
90
+ // skips the audio track if the stream truly has none. This prevents silent-audio
91
+ // forced mode on cameras that actually do have audio but don't advertise it in HA.
92
+ const isDirectRtsp = streamSourceType === "rtsp" ||
93
+ (resolvedSource?.sourceType === "rtsp" &&
94
+ !resolvedSource?.url?.includes("/api/camera_proxy"));
95
+ hasAudio =
96
+ attrs.has_audio !== false &&
97
+ rawAudioCodec !== "none" &&
98
+ (isDirectRtsp || rawAudioCodec !== "");
99
+ if (hasAudio) {
100
+ if (rawAudioCodec.includes("aac") || rawAudioCodec.includes("mp4a")) {
101
+ audioCodec = "aac_lc";
102
+ }
103
+ else if (rawAudioCodec.includes("opus")) {
104
+ audioCodec = "opus";
105
+ }
106
+ else if (rawAudioCodec.includes("pcm") ||
107
+ rawAudioCodec.includes("alaw") ||
108
+ rawAudioCodec.includes("ulaw") ||
109
+ rawAudioCodec.includes("g711") ||
110
+ rawAudioCodec.includes("g722") ||
111
+ rawAudioCodec.includes("adpcm")) {
112
+ audioCodec = "pcm";
113
+ }
114
+ else if (rawAudioCodec && !isDirectRtsp) {
115
+ // Non-RTSP cameras with unknown codec: skip audio
116
+ audioCodec = "incompatible";
117
+ hasAudio = false;
118
+ }
119
+ else {
120
+ // Empty audio_codec on RTSP → assume AAC (transcoded to AAC-ELD by delegate)
121
+ audioCodec = "aac_lc";
122
+ }
123
+ }
124
+ // Direct RTSP cameras: always treat as having audio unless explicitly disabled.
125
+ // FFmpeg -map 0:a:0? handles streams with no audio track gracefully.
126
+ if (isDirectRtsp && !hasAudio && attrs.has_audio !== false && rawAudioCodec !== "none") {
127
+ hasAudio = true;
128
+ audioCodec = "aac_lc";
129
+ }
130
+ }
131
+ // Determine Dimensions & FPS
132
+ const width = probeResult?.width || Number(attrs.video_width || attrs.width || 1920);
133
+ const height = probeResult?.height || Number(attrs.video_height || attrs.height || 1080);
134
+ const maxFps = probeResult?.fps || Number(attrs.fps || attrs.frame_rate || 30);
135
+ // Strategy Determination
136
+ let strategy = "unsupported";
137
+ let requiresTranscoding = false;
138
+ let transcodingReason;
139
+ // WebRTC cameras (e.g. Google Nest) without a concrete stream URL are unsupported
140
+ // until go2rtc or another bridge provides an RTSP endpoint.
141
+ const isWebRtcWithoutUrl = resolvedSource?.sourceType === "webrtc" && !resolvedSource?.url;
142
+ const hasStreamSource = isWebRtcWithoutUrl
143
+ ? false
144
+ : resolvedSource
145
+ ? Boolean(resolvedSource.url) || resolvedSource.sourceType === "webrtc"
146
+ : streamSourceType !== "unknown" || state.state === "streaming";
147
+ const hasLiveStream = hasStreamSource && isAvailable;
148
+ if (!hasLiveStream) {
149
+ strategy = "unsupported";
150
+ transcodingReason = isWebRtcWithoutUrl
151
+ ? "Google Nest / WebRTC no disponible: configura go2rtc en HA para obtener un stream RTSP local (rtsp://127.0.0.1:8554/nombre_camara)."
152
+ : "Live View no disponible: Home Assistant no expone una fuente reproducible.";
153
+ // camera_proxy_stream is an HTTP multipart/JPEG representation generated by
154
+ // Home Assistant. Camera attributes may say H.264, but copying that proxy
155
+ // response as H.264 produces an invalid RTP stream for Apple Home.
156
+ }
157
+ else if ((videoCodec === "h264" || videoCodec === "h265") &&
158
+ resolvedSource?.sourceType !== "ha_proxy" &&
159
+ !resolvedSource?.url?.includes("/api/camera_proxy")) {
160
+ // Both H.264 and H.265/HEVC (4K, 2K, 1080p) use pure passthrough remuxing (-c:v copy)
161
+ // with zero transcoding CPU overhead.
162
+ strategy = videoCodec === "h265" ? "passthrough_hevc" : "passthrough_h264";
163
+ requiresTranscoding = false;
164
+ }
165
+ else {
166
+ strategy = "transcode_required";
167
+ requiresTranscoding = true;
168
+ transcodingReason = `Video codec is ${videoCodec} and requires ultra-low-latency H.264 transcoding. Audio will be re-encoded to AAC-ELD.`;
169
+ }
170
+ return {
171
+ hasLiveStream,
172
+ streamSourceType,
173
+ videoCodec,
174
+ audioCodec,
175
+ hasAudio,
176
+ resolution: { width, height },
177
+ maxFps,
178
+ strategy,
179
+ requiresTranscoding,
180
+ transcodingReason,
181
+ snapshotSupported: true,
182
+ hksvCapable: hasLiveStream && Boolean(resolveFfmpegPath()),
183
+ snapshotUrl: resolvedSource?.snapshotUrl || `/api/camera_proxy/${state.entity_id}`,
184
+ };
185
+ }
186
+ //# sourceMappingURL=camera-capabilities.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"camera-capabilities.js","sourceRoot":"","sources":["../../src/camera/camera-capabilities.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ import type { HassState } from "../utils/ha-state.js";
2
+ import type { ResolvedStreamSource } from "./camera-types.js";
3
+ export declare class CameraSourceResolver {
4
+ /**
5
+ * Resolves the actual stream source and snapshot URL from Home Assistant in strict order:
6
+ * 1. stream_source attribute
7
+ * 2. Direct RTSP URL (rtsp_url, stream_url, rtsp_stream, rtsp_stream_url)
8
+ * 3. WebRTC / go2rtc source
9
+ * 4. HLS stream (camera/stream or play_stream) ONLY if supported_features has STREAM (bit 2)
10
+ * 5. Home Assistant Continuous Camera Proxy Stream (/api/camera_proxy_stream/{entityId})
11
+ * 6. unknown (if entity is unavailable or no endpoint can be resolved)
12
+ */
13
+ static resolve(platform: any, entityId: string, state: HassState): Promise<ResolvedStreamSource>;
14
+ /**
15
+ * Safely sanitize URLs for logs without printing passwords or authentication tokens.
16
+ */
17
+ static sanitizeUrl(url?: string): string;
18
+ }
@@ -0,0 +1,187 @@
1
+ import { sanitizeUrlCredentials, probeCameraSource, } from "./homekit/ffmpeg-helper.js";
2
+ import { isCameraStreamReachable } from "./cameraui/cameraui-client.js";
3
+ export class CameraSourceResolver {
4
+ /**
5
+ * Resolves the actual stream source and snapshot URL from Home Assistant in strict order:
6
+ * 1. stream_source attribute
7
+ * 2. Direct RTSP URL (rtsp_url, stream_url, rtsp_stream, rtsp_stream_url)
8
+ * 3. WebRTC / go2rtc source
9
+ * 4. HLS stream (camera/stream or play_stream) ONLY if supported_features has STREAM (bit 2)
10
+ * 5. Home Assistant Continuous Camera Proxy Stream (/api/camera_proxy_stream/{entityId})
11
+ * 6. unknown (if entity is unavailable or no endpoint can be resolved)
12
+ */
13
+ static async resolve(platform, entityId, state) {
14
+ const attrs = state?.attributes || {};
15
+ const httpBase = platform?.ha?.getHttpBaseUrl?.() || "";
16
+ const snapshotUrl = httpBase
17
+ ? `${httpBase}/api/camera_proxy/${entityId}`
18
+ : `/api/camera_proxy/${entityId}`;
19
+ const supportedFeatures = Number(attrs.supported_features || 0);
20
+ const hasStreamSupport = (supportedFeatures & 2) !== 0; // CameraEntityFeature.STREAM = 2
21
+ // 1. Check state.attributes.stream_source
22
+ const streamSourceAttr = attrs.stream_source;
23
+ if (typeof streamSourceAttr === "string" &&
24
+ streamSourceAttr.trim().length > 0) {
25
+ let resolvedUrl = streamSourceAttr;
26
+ if (/wyze/i.test(entityId) || /wyze/i.test(resolvedUrl)) {
27
+ if (resolvedUrl.includes("/stream1"))
28
+ resolvedUrl = resolvedUrl.replace("/stream1", "/stream0");
29
+ }
30
+ else if (resolvedUrl.includes("/stream2")) {
31
+ resolvedUrl = resolvedUrl.replace("/stream2", "/stream1");
32
+ }
33
+ const sanitized = sanitizeUrlCredentials(resolvedUrl);
34
+ platform?.log?.debug?.(`[CameraSourceResolver][${entityId}] Resolved from stream_source: ${sanitized}`);
35
+ return {
36
+ sourceType: resolvedUrl.startsWith("rtsp")
37
+ ? "rtsp"
38
+ : resolvedUrl.includes("/api/camera_proxy_stream/")
39
+ ? "ha_proxy"
40
+ : resolvedUrl.includes(".m3u8")
41
+ ? "hls"
42
+ : "rtsp",
43
+ url: resolvedUrl,
44
+ snapshotUrl,
45
+ supportsPassthrough: true,
46
+ requiresBridge: false,
47
+ };
48
+ }
49
+ // 2. Direct RTSP URL (rtsp_url, stream_url, rtsp_stream, rtsp_stream_url)
50
+ const directRtsp = attrs.rtsp_url ||
51
+ attrs.stream_url ||
52
+ attrs.rtsp_stream ||
53
+ attrs.rtsp_stream_url;
54
+ if (typeof directRtsp === "string" && directRtsp.startsWith("rtsp")) {
55
+ let resolvedRtsp = directRtsp;
56
+ if (/wyze/i.test(entityId) || /wyze/i.test(resolvedRtsp)) {
57
+ if (resolvedRtsp.includes("/stream1"))
58
+ resolvedRtsp = resolvedRtsp.replace("/stream1", "/stream0");
59
+ }
60
+ else if (resolvedRtsp.includes("/stream2")) {
61
+ resolvedRtsp = resolvedRtsp.replace("/stream2", "/stream1");
62
+ }
63
+ const sanitized = sanitizeUrlCredentials(resolvedRtsp);
64
+ platform?.log?.debug?.(`[CameraSourceResolver][${entityId}] Resolved direct RTSP stream source: ${sanitized}`);
65
+ return {
66
+ sourceType: "rtsp",
67
+ url: resolvedRtsp,
68
+ snapshotUrl,
69
+ supportsPassthrough: true,
70
+ requiresBridge: false,
71
+ };
72
+ }
73
+ // 3. WebRTC direct URL if provided
74
+ if (typeof attrs.webrtc_url === "string" &&
75
+ attrs.webrtc_url.trim().length > 0) {
76
+ const sanitized = sanitizeUrlCredentials(attrs.webrtc_url);
77
+ platform?.log?.debug?.(`[CameraSourceResolver][${entityId}] Resolved webrtc_url: ${sanitized}`);
78
+ return {
79
+ sourceType: "webrtc",
80
+ url: attrs.webrtc_url,
81
+ snapshotUrl,
82
+ supportsPassthrough: true,
83
+ requiresBridge: false,
84
+ };
85
+ }
86
+ if (attrs.frontend_stream_type === "webrtc") {
87
+ platform?.log?.debug?.(`[CameraSourceResolver][${entityId}] Camera frontend_stream_type is webrtc (Google Nest / WebRTC)`);
88
+ // Check if go2rtc is running in Home Assistant exposing an RTSP bridge
89
+ const rawName = entityId.replace(/^camera\./, "");
90
+ const go2rtcCandidates = [
91
+ `rtsp://127.0.0.1:8554/${entityId}`,
92
+ `rtsp://127.0.0.1:8554/${rawName}`,
93
+ ];
94
+ for (const candidate of go2rtcCandidates) {
95
+ try {
96
+ const reachable = await isCameraStreamReachable(candidate, 800);
97
+ if (reachable) {
98
+ platform?.log?.notice?.(`[CameraSourceResolver][${entityId}] Connected to Go2rtc local RTSP bridge: ${candidate}`);
99
+ return {
100
+ sourceType: "rtsp",
101
+ url: candidate,
102
+ snapshotUrl,
103
+ supportsPassthrough: true,
104
+ requiresBridge: false,
105
+ metadata: { isGo2rtc: true, isNest: entityId.includes("nest") },
106
+ };
107
+ }
108
+ }
109
+ catch { }
110
+ }
111
+ // HA Camera continuous proxy stream fallback
112
+ const fallbackProxyUrl = platform?.ha?.getCameraProxyStreamUrl?.(entityId);
113
+ return {
114
+ sourceType: "webrtc",
115
+ url: fallbackProxyUrl || undefined,
116
+ snapshotUrl,
117
+ supportsPassthrough: true,
118
+ requiresBridge: false,
119
+ metadata: { isNest: entityId.includes("nest"), frontendStreamType: "webrtc" },
120
+ };
121
+ }
122
+ // 4. HA Native stream via WebSocket (camera/stream)
123
+ const canAttemptStream = hasStreamSupport ||
124
+ attrs.frontend_stream_type === "hls";
125
+ if (canAttemptStream && platform?.ha?.requestCameraStream) {
126
+ try {
127
+ const streamUrl = await platform.ha.requestCameraStream(entityId);
128
+ if (streamUrl && typeof streamUrl === "string") {
129
+ const token = platform.ha.getAccessToken?.() || platform.ha.wsAccessToken;
130
+ let isH264 = true;
131
+ try {
132
+ const probe = await probeCameraSource(streamUrl, {
133
+ timeoutMs: 2500,
134
+ httpBearerToken: token,
135
+ });
136
+ if (probe.valid && probe.videoCodec) {
137
+ isH264 = probe.videoCodec === "h264";
138
+ }
139
+ }
140
+ catch { }
141
+ platform?.log?.debug?.(`[CameraSourceResolver][${entityId}] Resolved native HA HLS stream: ${sanitizeUrlCredentials(streamUrl)}`);
142
+ return {
143
+ sourceType: "hls",
144
+ url: streamUrl,
145
+ snapshotUrl,
146
+ supportsPassthrough: isH264,
147
+ requiresBridge: true,
148
+ };
149
+ }
150
+ }
151
+ catch (err) {
152
+ platform?.log?.debug?.(`[CameraSourceResolver][${entityId}] Native camera/stream request returned: ${err}`);
153
+ }
154
+ }
155
+ // 5. HA Camera Proxy Continuous Stream endpoint (/api/camera_proxy_stream/{entityId})
156
+ // For cameras without HLS/RTSP support in HA (Generic MJPEG, Tapo, Tuya, ESP32),
157
+ // Home Assistant provides a continuous multipart video feed consumable by FFmpeg.
158
+ if (platform?.ha?.getCameraProxyStreamUrl) {
159
+ const proxyUrl = platform.ha.getCameraProxyStreamUrl(entityId);
160
+ if (proxyUrl) {
161
+ platform?.log?.debug?.(`[CameraSourceResolver][${entityId}] Resolved HA camera_proxy_stream endpoint: ${sanitizeUrlCredentials(proxyUrl)}`);
162
+ return {
163
+ sourceType: "ha_proxy",
164
+ url: proxyUrl,
165
+ snapshotUrl,
166
+ supportsPassthrough: false,
167
+ requiresBridge: true,
168
+ };
169
+ }
170
+ }
171
+ // 6. Fallback: unknown
172
+ return {
173
+ sourceType: "unknown",
174
+ url: undefined,
175
+ snapshotUrl,
176
+ supportsPassthrough: false,
177
+ requiresBridge: false,
178
+ };
179
+ }
180
+ /**
181
+ * Safely sanitize URLs for logs without printing passwords or authentication tokens.
182
+ */
183
+ static sanitizeUrl(url) {
184
+ return sanitizeUrlCredentials(url || "");
185
+ }
186
+ }
187
+ //# sourceMappingURL=camera-source-resolver.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"camera-source-resolver.js","sourceRoot":"","sources":["../../src/camera/camera-source-resolver.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,124 @@
1
+ /**
2
+ * Unified camera definitions and interfaces for Dual-Track Camera Support.
3
+ *
4
+ * TRACK A (HomeKit/HAP): Primary for Apple Home live view, snapshots, and audio.
5
+ * TRACK B (Matter 1.5/1.6): Experimental backend for Matter camera clusters (0x0551/0x0553).
6
+ */
7
+ export type StreamSourceType = "webrtc" | "rtsp" | "hls" | "mjpeg" | "ha_proxy" | "unknown";
8
+ export type VideoCodecType = "h264" | "h265" | "hevc" | "mjpeg" | "unknown";
9
+ export type AudioCodecType = "aac_eld" | "opus" | "aac_lc" | "pcm" | "incompatible" | "none";
10
+ export type StreamStrategy = "passthrough_h264" | "passthrough_hevc" | "passthrough_video_only" | "transcode_required" | "transcode" | "unsupported";
11
+ export interface CameraCapabilitiesInfo {
12
+ /** True if a live stream source is available and active in Home Assistant. */
13
+ hasLiveStream: boolean;
14
+ /** Resolved source protocol / stream type. */
15
+ streamSourceType: StreamSourceType;
16
+ /** Detected video codec. */
17
+ videoCodec: VideoCodecType;
18
+ /** True if audio is available and compatible with HomeKit / Matter. */
19
+ hasAudio: boolean;
20
+ /** Detected audio codec. */
21
+ audioCodec: AudioCodecType;
22
+ /** Target resolution width and height. */
23
+ resolution: {
24
+ width: number;
25
+ height: number;
26
+ };
27
+ /** Maximum frame rate (FPS). */
28
+ maxFps: number;
29
+ /** Selected stream execution strategy. */
30
+ strategy: StreamStrategy;
31
+ /** True if the stream cannot be forwarded with passthrough and requires ffmpeg transcoding. */
32
+ requiresTranscoding: boolean;
33
+ /** Explanation if transcoding or special handling is required. */
34
+ transcodingReason?: string;
35
+ /** Resolved snapshot image endpoint URL (JPEG). */
36
+ snapshotUrl?: string;
37
+ /** True if snapshot image fetching is supported. */
38
+ snapshotSupported?: boolean;
39
+ /** True if camera and system satisfy all technical requirements for HKSV. */
40
+ hksvCapable?: boolean;
41
+ /** Original Home Assistant frontend_stream_type attribute. */
42
+ frontendStreamType?: string;
43
+ /** Raw supported_features bitmask from Home Assistant. */
44
+ supportedFeatures?: number;
45
+ }
46
+ export interface ResolvedStreamSource {
47
+ sourceType: StreamSourceType;
48
+ url?: string;
49
+ snapshotUrl?: string;
50
+ supportsPassthrough: boolean;
51
+ requiresBridge: boolean;
52
+ metadata?: Record<string, any>;
53
+ }
54
+ export interface HomeKitCameraStorageRecord {
55
+ entityId: string;
56
+ uuid: string;
57
+ username: string;
58
+ pincode: string;
59
+ setupId: string;
60
+ port: number;
61
+ published: boolean;
62
+ strategy: StreamStrategy;
63
+ state: string;
64
+ name: string;
65
+ manufacturer: string;
66
+ model: string;
67
+ serialNumber: string;
68
+ /** Explicit motion sensor for cameras whose HA entities are not co-registered. */
69
+ motionEntityId?: string;
70
+ /** Explicit light entity ID (or 'none') for camera spotlight/floodlight. */
71
+ lightEntityId?: string;
72
+ /** Explicit siren entity ID (or 'none') for camera alarm siren. */
73
+ sirenEntityId?: string;
74
+ isPaired?: boolean;
75
+ hksvCapable?: boolean;
76
+ hksvEnabled?: boolean;
77
+ hksvVerified?: boolean;
78
+ hksvState?: "not_capable" | "configurable" | "waiting_hub" | "ready" | "verified" | "error";
79
+ lastUpdated?: string;
80
+ realEntities?: any[];
81
+ }
82
+ export type CameraActivationPhase = "discovery" | "profile" | "endpoint" | "registration" | "server-start" | "commissioning" | "stream";
83
+ export interface CameraActivationResult {
84
+ entityId: string;
85
+ published: boolean;
86
+ phase: CameraActivationPhase;
87
+ homekit?: {
88
+ published: boolean;
89
+ port: number;
90
+ pincode: string;
91
+ setupUri: string;
92
+ qrCodeText: string;
93
+ username: string;
94
+ strategy: StreamStrategy;
95
+ };
96
+ matter?: {
97
+ published: boolean;
98
+ nodeId?: string;
99
+ pairingCode?: string;
100
+ manualPairingCode?: string;
101
+ qrCode?: string;
102
+ experimental: boolean;
103
+ };
104
+ capabilities: CameraCapabilitiesInfo;
105
+ warnings: string[];
106
+ error?: string;
107
+ }
108
+ export type CameraAiTarget = "person" | "vehicle" | "dog" | "cat" | "bird" | "raccoon" | "snake" | "spider";
109
+ export interface CameraAiDetectionEvent {
110
+ cameraId: string;
111
+ timestamp: number;
112
+ targets: CameraAiTarget[];
113
+ labels: string[];
114
+ confidence: number;
115
+ rawDetails?: string;
116
+ }
117
+ export interface CameraAiConfig {
118
+ enabled: boolean;
119
+ targets: CameraAiTarget[];
120
+ sensitivity: number;
121
+ motionTimeoutSeconds: number;
122
+ publishMqtt: boolean;
123
+ mqttTopic?: string;
124
+ }
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Unified camera definitions and interfaces for Dual-Track Camera Support.
3
+ *
4
+ * TRACK A (HomeKit/HAP): Primary for Apple Home live view, snapshots, and audio.
5
+ * TRACK B (Matter 1.5/1.6): Experimental backend for Matter camera clusters (0x0551/0x0553).
6
+ */
7
+ export {};
8
+ //# sourceMappingURL=camera-types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"camera-types.js","sourceRoot":"","sources":["../../src/camera/camera-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}
@@ -0,0 +1,54 @@
1
+ import type { CameraUiCameraRecord, CameraUiConfig } from "./cameraui-types.js";
2
+ /**
3
+ * Fast TCP socket check to verify if a camera's RTSP or HTTP stream port is reachable.
4
+ */
5
+ export declare function isCameraStreamReachable(streamUrl?: string, timeoutMs?: number): Promise<boolean>;
6
+ /**
7
+ * Universal extractor to parse camera lists from any Camera.UI version response format:
8
+ * - Direct array [...]
9
+ * - Camera.UI v5 standard paginated { result: [...] }
10
+ * - Legacy { cameras: [...] }
11
+ * - Object dictionary { cameras: { "cam1": { ... } } }
12
+ * - Object dictionary { result: { "cam1": { ... } } }
13
+ * - Generic envelope { data: [...] } or { items: [...] }
14
+ * - Top-level dictionary of camera objects { "patio": { name: "patio", ... } }
15
+ */
16
+ export declare function extractRawCameras(json: any): any[];
17
+ export declare class CameraUiClient {
18
+ private readonly config;
19
+ private accessToken?;
20
+ private resolvedBaseUrl?;
21
+ private loginError?;
22
+ constructor(config: CameraUiConfig);
23
+ private getBaseUrl;
24
+ getCandidateUrls(): string[];
25
+ private getHeaders;
26
+ /**
27
+ * Attempts authentication with Camera.UI.
28
+ * Modern Camera.UI may use POST /api/auth/login or session auth.
29
+ * Universal HTTP Basic Auth is also handled transparently via getHeaders().
30
+ */
31
+ login(targetBaseUrl?: string): Promise<{
32
+ ok: boolean;
33
+ message?: string;
34
+ skipped?: boolean;
35
+ }>;
36
+ /**
37
+ * Tests connection to the Camera.UI instance across candidate endpoints and hosts.
38
+ */
39
+ testConnection(): Promise<{
40
+ ok: boolean;
41
+ message: string;
42
+ version?: string;
43
+ activeUrl?: string;
44
+ }>;
45
+ /**
46
+ * Fetches and normalizes camera definitions from Camera.UI.
47
+ */
48
+ fetchCameras(): Promise<CameraUiCameraRecord[]>;
49
+ private cleanStreamUrl;
50
+ /**
51
+ * Fetches recent notifications / OpenCV detections from Camera.UI API.
52
+ */
53
+ getRecentNotifications(): Promise<any[]>;
54
+ }