@apocaliss92/nodedreame 1.12.0 → 1.12.2

package/dist/index.cjs

@@ -91,6 +91,7 @@ __export(index_exports, {
   decodeWifiSignalMap: () => decodeWifiSignalMap,
   encodeAiFeatureWrite: () => encodeAiFeatureWrite,
   encodeAutoSwitchWrite: () => encodeAutoSwitchWrite,
+  explainNoCameraChannel: () => explainNoCameraChannel,
   extractMowerConsumableValues: () => extractMowerConsumableValues,
   getAliyunAuthCode: () => getAliyunAuthCode,
   getDeviceVideoProfile: () => getDeviceVideoProfile,
@@ -131,7 +132,7 @@ module.exports = __toCommonJS(index_exports);
 
 // src/support/version.ts
 var LIBRARY_NAME = "nodedreame";
-var LIBRARY_VERSION = "1.12.0";
+var LIBRARY_VERSION = "1.12.2";
 
 // src/transport/errors.ts
 var DreameError = class extends Error {
@@ -2728,6 +2729,26 @@ var DreameVideoSession = class {
   }
 };
 
+// src/video/camera-availability.ts
+function explainNoCameraChannel(profile) {
+  if (profile.iotId) {
+    return null;
+  }
+  const who = `${profile.model || "unknown model"} (${profile.did || "no did"})`;
+  if (!profile.videoCapable) {
+    return `${who} is not a camera: the cloud lists no video permit and no supported video vendor for it, so there is no channel to open.`;
+  }
+  if (!profile.online) {
+    return `${who} is a camera but is OFFLINE. The video binding is published by the device itself, so there is nothing to read until it connects \u2014 this is not a provisioning fault.`;
+  }
+  const supports = profile.supportedVendors.length > 0 ? profile.supportedVendors.join(", ") : "none";
+  if (profile.currentVendor === "tx") {
+    return `${who} is a camera and online, but is provisioned on the TENCENT video vendor (vendor: tx; supports: ${supports}), and this library implements only the Aliyun LinkVisual path \u2014 the channel id it needs lives on Aliyun and a tx device has none. Re-pairing or re-opening the camera in the app will not change this.`;
+  }
+  const on = profile.currentVendor ?? "none";
+  return `${who} is a camera and online, but has no video channel yet (vendor: ${on}; supports: ${supports}). The device has not bound to the video service \u2014 open its camera once in the Dreame app to create the binding, then retry.`;
+}
+
 // src/video/monitor/constants.ts
 var MONITOR_SIID = 10001;
 var MONITOR_AIID = {
@@ -5447,9 +5468,13 @@ var VacuumDevice = class _VacuumDevice extends BaseDevice {
     const session = this.currentSession();
     const region = this.region;
     const relay = opts?.relay ?? new DreameVideoSession({ session, region });
-    const iotId = opts?.iotId ?? (await getDeviceVideoProfile({ session, region, did: this.deviceId })).iotId;
+    let iotId = opts?.iotId ?? null;
     if (!iotId) {
-      throw new DreameError("device has no LinkVisual iotId; not a camera device or not provisioned");
+      const profile = await getDeviceVideoProfile({ session, region, did: this.deviceId });
+      iotId = profile.iotId;
+      if (!iotId) {
+        throw new DreameError(explainNoCameraChannel(profile) ?? "device has no video channel");
+      }
     }
     return new DreameCameraController({
       device: this,
@@ -8542,6 +8567,7 @@ var DreameCameraStream = class extends TypedEmitter {
   decodeWifiSignalMap,
   encodeAiFeatureWrite,
   encodeAutoSwitchWrite,
+  explainNoCameraChannel,
   extractMowerConsumableValues,
   getAliyunAuthCode,
   getDeviceVideoProfile,